fix: include .cursor assets in PyPI wheel (bootstrap exit 1)

setuptools skipped dot-directories under assets/**; bootstrap installed CLI but init left projects without Cursor rules. v4.5.3

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: MertCapkin

CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to GraphStack are documented here.
 
 ---
 
+## [v4.5.3] — 2026-06-11
+
+### Fixed
+- **PyPI wheel** — `.cursor/` rules, commands, and skills were omitted from the wheel (setuptools skips dot-directories under `assets/**/*`). Bootstrap `irm … | iex` installed the CLI but `graphstack init` left the project without Cursor rules; doctor exited 1.
+- Explicit `package-data` entries + `MANIFEST.in` graft; wheel asset test added.
+
+---
+
 ## [v4.5.2] — 2026-06-11
 
 ### Changed

MANIFEST.in

@@ -0,0 +1,2 @@
+# Dot-directories under assets/ must be grafted for sdist + wheel discovery.
+graft scripts/graphstack/assets

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "MertCapkin_GraphStack"
-version = "4.5.2"
+version = "4.5.3"
 description = "Graph-first AI development workflow — board, gate, graph queries, one-shot init"
 readme = "README.md"
 license = { text = "MIT" }
@@ -42,8 +42,24 @@ graphstack = "graphstack.cli:main"
 [tool.setuptools.packages.find]
 where = ["scripts"]
 
+[tool.setuptools]
+include-package-data = true
+
+# setuptools ``assets/**/*`` skips dot-directories (``.cursor/``) — list explicitly.
 [tool.setuptools.package-data]
-graphstack = ["assets/**/*", "compact/**/*"]
+graphstack = [
+    "assets/.cursor/rules/graphstack.mdc",
+    "assets/.cursor/commands/graphstack.md",
+    "assets/.cursor/skills/architect/ARCHITECT.md",
+    "assets/.cursor/skills/builder/BUILDER.md",
+    "assets/.cursor/skills/reviewer/REVIEWER.md",
+    "assets/.cursor/skills/qa/QA.md",
+    "assets/.cursor/skills/ship/SHIP.md",
+    "assets/.cursor/skills/bootstrapper/BOOTSTRAPPER.md",
+    "assets/.graphstack-assets-version",
+    "assets/**/*",
+    "compact/**/*",
+]
 
 [tool.pytest.ini_options]
 testpaths = ["scripts/graphstack/tests"]

scripts/bootstrap.ps1

@@ -48,4 +48,12 @@ if ($LASTEXITCODE -ne 0) {
 Write-Host ''
 Write-Host 'Step 2/2: Initializing GraphStack in this project...'
 & $python.Exe @($python.PreArgs) -m graphstack init . -y --install-deps
-exit $LASTEXITCODE
+$initRc = $LASTEXITCODE
+if ($initRc -ne 0) {
+    Write-Host ''
+    Write-Host 'Bootstrap finished with errors (exit ' $initRc ').' -ForegroundColor Yellow
+    Write-Host 'PyPI package may be installed, but project init or doctor failed.'
+    Write-Host 'Check output above, then run:  py -3 -m graphstack doctor'
+    Write-Host 'If .cursor/rules/graphstack.mdc is missing, upgrade:  pip install -U MertCapkin_GraphStack[graphify]'
+}
+exit $initRc

scripts/graphstack/__init__.py

@@ -8,5 +8,5 @@
 ``gate``, ``state``, ``graph``
 """
 
-__version__ = "4.5.2"
+__version__ = "4.5.3"
 __all__ = ["__version__"]

scripts/graphstack/tests/test_assets.py

@@ -1,35 +1,40 @@
-"""Tests for bundled assets and install source resolution."""
+"""PyPI wheel must ship ``.cursor`` workflow files inside ``graphstack/assets``."""
 
 from __future__ import annotations
 
+import zipfile
 from pathlib import Path
 
-from graphstack.installer import PACKAGE_ROOT, install_source_root
-
-
-def test_install_source_root_from_dev_repo() -> None:
-    root = install_source_root()
-    assert (root / "orchestrator" / "ORCHESTRATOR.md").is_file()
-
-
-def test_bundled_assets_exist_in_package() -> None:
-    assets = PACKAGE_ROOT / "assets"
-    assert (assets / "orchestrator" / "ORCHESTRATOR.md").is_file()
-    assert (assets / ".cursor" / "rules" / "graphstack.mdc").is_file()
-
-
-def test_install_from_bundled_assets_only(tmp_path: Path, monkeypatch) -> None:
-    from graphstack import installer
-
-    assets = PACKAGE_ROOT / "assets"
-    monkeypatch.setattr(
-        installer,
-        "_source_root",
-        lambda: assets,
-    )
-    target = tmp_path / "consumer"
-    target.mkdir()
-    assert installer.install(target, non_interactive=True) == 0
-    assert (target / "orchestrator" / "ORCHESTRATOR.md").is_file()
-    assert (target / ".cursor" / "rules" / "graphstack.mdc").is_file()
-    assert (target / "handoff" / "BRIEF.md").is_file()
+import pytest
+
+REPO_ROOT = Path(__file__).resolve().parents[3]
+WHEEL_GLOB = "mertcapkin_graphstack-*.whl"
+
+REQUIRED_ASSET_PATHS = (
+    "graphstack/assets/.cursor/rules/graphstack.mdc",
+    "graphstack/assets/.cursor/commands/graphstack.md",
+    "graphstack/assets/.cursor/skills/architect/ARCHITECT.md",
+    "graphstack/assets/.cursor/skills/builder/BUILDER.md",
+)
+
+
+def _latest_wheel(dist_dir: Path) -> Path | None:
+    wheels = sorted(dist_dir.glob(WHEEL_GLOB), key=lambda p: p.stat().st_mtime)
+    return wheels[-1] if wheels else None
+
+
+@pytest.mark.parametrize("member", REQUIRED_ASSET_PATHS)
+def test_wheel_includes_cursor_assets(member: str) -> None:
+    for dist_name in ("dist", "dist_test"):
+        dist_dir = REPO_ROOT / dist_name
+        wheel = _latest_wheel(dist_dir)
+        if wheel is None:
+            continue
+        with zipfile.ZipFile(wheel) as archive:
+            names = set(archive.namelist())
+        assert member in names, (
+            f"{member} missing from {wheel.name}; "
+            "dot-directories under assets/ need explicit package-data"
+        )
+        return
+    pytest.skip("no built wheel in dist/ or dist_test/ — run python -m build first")