fix: PyPI package name MertCapkin_GraphStack (graphstack taken)

Align pyproject.toml with pending PyPI publisher. CLI command remains graphstack. v4.5.1.

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.1] — 2026-06-11
+
+### Changed
+- **PyPI distribution name** — `MertCapkin_GraphStack` (the name `graphstack` is taken on PyPI). CLI command remains `graphstack`.
+- Bootstrap scripts and docs updated for the new pip package name.
+
+---
+
 ## [v4.5.0] — 2026-06-11
 
 ### Added

README.md

@@ -7,7 +7,7 @@ One prompt starts the entire lifecycle — from blank repo to production.
 
 [![CI](https://github.com/MertCapkin/graphstack/actions/workflows/ci.yml/badge.svg)](https://github.com/MertCapkin/graphstack/actions)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-v4.5.0-blue)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-v4.5.1-blue)](CHANGELOG.md)
 [![Platforms](https://img.shields.io/badge/platforms-Windows%20%7C%20macOS%20%7C%20Linux-success)](#compatibility)
 [![Works with Cursor](https://img.shields.io/badge/Works%20with-Cursor-blue)](https://cursor.sh)
 [![Works with Claude Code](https://img.shields.io/badge/Works%20with-Claude%20Code-orange)](https://claude.ai/code)
@@ -33,8 +33,11 @@ curl -fsSL https://raw.githubusercontent.com/MertCapkin/GraphStack/main/scripts/
 ```
 
 **After [PyPI publish](docs/PYPI.md):**
+
+> PyPI package name is **`MertCapkin_GraphStack`** (`graphstack` was already taken). The CLI command is still `graphstack`.
+
 ```bash
-pip install "graphstack[graphify]" && graphstack init . -y --install-deps
+pip install "MertCapkin_GraphStack[graphify]" && graphstack init . -y --install-deps
 ```
 
 This installs GraphStack + Graphify, copies workflow files into **the current project**, refreshes the code graph, and runs `doctor`. Then describe your task in Cursor chat — rules load automatically.

docs/PYPI.md

@@ -1,48 +1,41 @@
 # Publishing GraphStack to PyPI
 
+## Package name
+
+PyPI distribution: **`MertCapkin_GraphStack`** (the name `graphstack` is taken on PyPI).
+
+- `pip install MertCapkin_GraphStack[graphify]`
+- CLI command after install: **`graphstack`** (unchanged)
+
+Pending publisher on PyPI must use project name **`MertCapkin_GraphStack`** — must match `pyproject.toml` `name`.
+
 ## One-time setup (maintainer)
 
-1. Create a [PyPI](https://pypi.org) account and project **`graphstack`** (check name availability first).
-2. Enable [Trusted Publishing](https://docs.pypi.org/trusted-publishers/) on PyPI:
-   - GitHub repo: `MertCapkin/GraphStack`
+1. PyPI account → **Publishing** → pending publisher:
+   - Pending project name: `MertCapkin_GraphStack`
+   - Owner: `MertCapkin`
+   - Repository name: `GraphStack`
    - Workflow: `publish.yml`
-   - Environment name: `pypi`
-3. In GitHub → Settings → Environments → **pypi** → add protection rules if desired.
+   - Environment: `pypi`
+2. GitHub → Settings → Environments → create **`pypi`**
+3. Trusted Publishing linked to `MertCapkin/GraphStack`
 
 ## Release flow
 
 1. Bump version in `pyproject.toml` and `scripts/graphstack/__init__.py`.
-2. Update `CHANGELOG.md`.
-3. Sync bundled assets:
-   ```bash
-   python scripts/sync_assets.py
-   ```
-4. Commit, tag, and push:
-   ```bash
-   git tag v4.5.0
-   git push origin v4.5.0
-   ```
-5. Create a **GitHub Release** from the tag — this triggers `.github/workflows/publish.yml`.
-
-Or run **Publish to PyPI** workflow manually (`workflow_dispatch`).
-
-## Local dry-run (no upload)
-
-```bash
-python scripts/sync_assets.py
-python -m pip install build
-python -m build
-python -m pip install dist/graphstack-*.whl
-graphstack --version
-graphstack init /tmp/test-project -y --install-deps
-```
+2. `python scripts/sync_assets.py`
+3. Commit, tag, push, **Publish GitHub Release** (triggers `publish.yml`).
 
 ## User install (after publish)
 
 ```bash
-pip install "graphstack[graphify]"
+pip install "MertCapkin_GraphStack[graphify]"
 cd /path/to/your-project
 graphstack init . -y --install-deps
 ```
 
-Workflow markdown files ship **inside the wheel** under `graphstack/assets/` — no git clone required.
+Or one-liner bootstrap (Cursor terminal):
+
+```powershell
+irm https://raw.githubusercontent.com/MertCapkin/GraphStack/main/scripts/bootstrap.ps1 | iex
+```

pyproject.toml

@@ -3,8 +3,8 @@ requires = ["setuptools>=61", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
-name = "graphstack"
-version = "4.5.0"
+name = "MertCapkin_GraphStack"
+version = "4.5.1"
 description = "Graph-first AI development workflow — board, gate, graph queries, one-shot init"
 readme = "README.md"
 license = { text = "MIT" }

scripts/bootstrap.ps1

@@ -6,7 +6,8 @@
 #
 # Or after PyPI publish:
 #   irm ... | iex
-# Same as:  py -3 -m pip install -U "graphstack[graphify]" ; py -3 -m graphstack init . -y
+$Pkg = "MertCapkin_GraphStack[graphify]"
+# Same as:  py -3 -m pip install -U $Pkg ; py -3 -m graphstack init . -y
 
 $ErrorActionPreference = 'Stop'
 
@@ -35,11 +36,11 @@ Write-Host ''
 
 & $python.Exe @($python.PreArgs) -m pip install --upgrade pip --quiet 2>$null
 
-Write-Host 'Step 1/2: Installing graphstack + graphify from PyPI...'
-& $python.Exe @($python.PreArgs) -m pip install --upgrade "graphstack[graphify]"
+Write-Host "Step 1/2: Installing MertCapkin_GraphStack + graphify from PyPI..."
+& $python.Exe @($python.PreArgs) -m pip install --upgrade $Pkg
 if ($LASTEXITCODE -ne 0) {
     Write-Host 'PyPI install failed — trying GitHub source...' -ForegroundColor Yellow
-    & $python.Exe @($python.PreArgs) -m pip install --upgrade "graphstack[graphify] @ git+https://github.com/MertCapkin/GraphStack.git"
+    & $python.Exe @($python.PreArgs) -m pip install --upgrade "MertCapkin_GraphStack[graphify] @ git+https://github.com/MertCapkin/GraphStack.git"
     if ($LASTEXITCODE -ne 0) {
         Write-Error 'Could not install graphstack. Check network and Python pip.'
         exit 1

scripts/bootstrap.sh

@@ -34,10 +34,10 @@ echo ""
 
 $PY -m pip install --upgrade pip --quiet 2>/dev/null || true
 
-echo "Step 1/2: Installing graphstack + graphify from PyPI..."
-if ! $PY -m pip install --upgrade "graphstack[graphify]"; then
+echo "Step 1/2: Installing MertCapkin_GraphStack + graphify from PyPI..."
+if ! $PY -m pip install --upgrade "MertCapkin_GraphStack[graphify]"; then
   echo "PyPI install failed — trying GitHub source..." >&2
-  $PY -m pip install --upgrade "graphstack[graphify] @ git+https://github.com/MertCapkin/GraphStack.git"
+  $PY -m pip install --upgrade "MertCapkin_GraphStack[graphify] @ git+https://github.com/MertCapkin/GraphStack.git"
 fi
 
 echo ""

scripts/graphstack/__init__.py

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

scripts/graphstack/bootstrap.py

@@ -3,10 +3,15 @@
 from __future__ import annotations
 
 import subprocess
-import sys
 
 from .platform_utils import echo, find_python, graphify_available
 
+# PyPI distribution name (``graphstack`` was taken). CLI command remains ``graphstack``.
+PIP_SPEC = "MertCapkin_GraphStack[graphify]"
+PIP_SPEC_GIT = (
+    "MertCapkin_GraphStack[graphify] @ git+https://github.com/MertCapkin/GraphStack.git"
+)
+
 
 def pip_install(*specs: str, quiet: bool = True) -> int:
     """Install packages with the same Python running graphstack."""
@@ -27,16 +32,14 @@ def ensure_graphify(*, install: bool = True) -> bool:
         return False
     echo("")
     echo("Installing Graphify (graphifyy)...")
-    rc = pip_install('graphifyy>=0.7,<0.9')
+    rc = pip_install("graphifyy>=0.7,<0.9")
     return rc == 0 and graphify_available()
 
 
 def ensure_graphstack_from_git() -> int:
     """Fallback when PyPI package is not published yet."""
     echo("Trying GitHub install (PyPI fallback)...")
-    return pip_install(
-        "graphstack[graphify] @ git+https://github.com/MertCapkin/GraphStack.git"
-    )
+    return pip_install(PIP_SPEC_GIT)
 
 
 def run_graphify_cursor_install() -> int:

scripts/graphstack/installer.py

@@ -31,7 +31,7 @@ def install_source_root() -> Path:
         return bundled
     raise FileNotFoundError(
         "GraphStack workflow files not found. "
-        "Reinstall with: pip install --upgrade graphstack"
+        "Reinstall with: pip install --upgrade MertCapkin_GraphStack"
     )