MertCapkin-GraphStack 4.5.1__tar.gz → 4.5.3__tar.gz

mertcapkin_graphstack-4.5.3/MANIFEST.in

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

{mertcapkin_graphstack-4.5.1/scripts/MertCapkin_GraphStack.egg-info → mertcapkin_graphstack-4.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: MertCapkin_GraphStack
-Version: 4.5.1
+Version: 4.5.3
 Summary: Graph-first AI development workflow — board, gate, graph queries, one-shot init
 Author: GraphStack contributors
 License: MIT
@@ -8,6 +8,7 @@ Project-URL: Homepage, https://github.com/MertCapkin/GraphStack
 Project-URL: Repository, https://github.com/MertCapkin/GraphStack
 Project-URL: Documentation, https://github.com/MertCapkin/GraphStack#readme
 Project-URL: Bug Tracker, https://github.com/MertCapkin/GraphStack/issues
+Project-URL: PyPI, https://pypi.org/project/MertCapkin_GraphStack/
 Keywords: graphstack,cursor,graphify,ai,workflow,agent
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
@@ -35,15 +36,15 @@ Dynamic: license-file
 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)
+[![PyPI](https://img.shields.io/pypi/v/MertCapkin_GraphStack)](https://pypi.org/project/MertCapkin_GraphStack/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
-[![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)
 
 </div>
 
-> **v4.5 highlights:** One-command bootstrap (`bootstrap.ps1` / `bootstrap.sh`), PyPI-ready packaging, `board reopen` / `list-done`. Plus v4.4 `graph query` + `init`, v4.3 gate. See [CHANGELOG.md](CHANGELOG.md).
+> **v4.5 highlights:** Published on [PyPI](https://pypi.org/project/MertCapkin_GraphStack/) as **`MertCapkin_GraphStack`**, one-command bootstrap, `board reopen` / `list-done`. Plus v4.4 `graph query` + `init`, v4.3 gate. See [CHANGELOG.md](CHANGELOG.md).
 
 ---
 
@@ -51,22 +52,23 @@ One prompt starts the entire lifecycle — from blank repo to production.
 
 Open your **project folder** in Cursor, open the integrated terminal, and run:
 
-**Windows (PowerShell):**
+**Windows (PowerShell) — recommended:**
 ```powershell
-irm https://raw.githubusercontent.com/MertCapkin/GraphStack/main/scripts/bootstrap.ps1 | iex
+irm https://raw.githubusercontent.com/MertCapkin/GraphStack/master/scripts/bootstrap.ps1 | iex
 ```
 
 **macOS / Linux:**
 ```bash
-curl -fsSL https://raw.githubusercontent.com/MertCapkin/GraphStack/main/scripts/bootstrap.sh | bash
+curl -fsSL https://raw.githubusercontent.com/MertCapkin/GraphStack/master/scripts/bootstrap.sh | bash
 ```
 
-**After [PyPI publish](docs/PYPI.md):**
+**Or install from PyPI directly:**
 
-> PyPI package name is **`MertCapkin_GraphStack`** (`graphstack` was already taken). The CLI command is still `graphstack`.
+> Package: **`MertCapkin_GraphStack`** on [PyPI](https://pypi.org/project/MertCapkin_GraphStack/) (`graphstack` name was taken). CLI command: **`graphstack`**.
 
 ```bash
-pip install "MertCapkin_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.
@@ -75,67 +77,55 @@ This installs GraphStack + Graphify, copies workflow files into **the current pr
 
 ## Quick Start
 
-### Step 1 — Install prerequisites
+### Step 1 — Install GraphStack (PyPI)
 
-**Python 3.8+** and **Git** are required. Check if you have them:
+**Python 3.8+** and **Git** are required.
 
 ```bash
-py -3 --version   # need 3.8 or higher
-git --version       # any recent version is fine
+py -3 --version
+git --version
 ```
 
-**Install Graphify** — the knowledge graph engine GraphStack is built on. The version range is pinned in [`requirements.txt`](requirements.txt):
+Install GraphStack + Graphify from PyPI, then initialize **your project** (run inside your project folder):
 
 ```bash
-pip install -r requirements.txt
-# or, equivalently, install Graphify directly with the same pin:
-pip install "graphifyy>=0.7,<0.9"
-
-# Optional: install GraphStack CLI from a clone (board / validate / doctor / run)
-pip install -e /path/to/graphstack
-# or with Graphify in one step:
-pip install -e "/path/to/graphstack[graphify]"
+pip install "MertCapkin_GraphStack[graphify]"
+graphstack init . -y --install-deps
 ```
 
-After installation, register the Cursor slash command (one-time):
-
-```bash
-graphify cursor install
-```
+Or use the [one-command bootstrap](#one-command-cursor-terminal) above (same result; installs from PyPI, falls back to GitHub if needed).
 
-Verify it worked:
+Verify:
 
 ```bash
+graphstack --version
+graphstack doctor
 pip show graphifyy
 ```
 
-If `graphify` is not found after install, try:
-
-```bash
-pip install --user "graphifyy>=0.7,<0.9"
-# then add ~/.local/bin to your PATH, or use:
-python3 -m graphify --version
-```
+> **PyPI:** [pypi.org/project/MertCapkin_GraphStack](https://pypi.org/project/MertCapkin_GraphStack/)  
+> **CLI name:** `graphstack` (unchanged — only the pip package name differs)
 
-> Graphify runs **entirely locally** — no API calls, no data sent anywhere.
-> It uses tree-sitter to parse your code and builds the graph on your machine.
+Graphify runs **entirely locally** — tree-sitter AST, no API calls for code graphs.
 
 ---
 
-### Step 2 — Install GraphStack into your project
+### Step 1 (alternative) — Manual Graphify only
 
-GraphStack now works natively on Windows, macOS, and Linux. The installer runs through Python (which you already have for Graphify), so no shell-specific tooling is required.
-
-#### One command (recommended)
+If you prefer to install Graphify separately first:
 
 ```bash
-git clone https://github.com/MertCapkin/graphstack /path/to/graphstack
-cd /path/to/your-project
-/path/to/graphstack/install.ps1 .          # Windows
-# or: python -m graphstack init . -y       # any OS — install + graph refresh + doctor
+pip install "graphifyy>=0.7,<0.9"
+graphify cursor install
+pip install "MertCapkin_GraphStack[graphify]"
+graphstack init . -y --install-deps
 ```
 
-#### macOS / Linux (bash / zsh)
+---
+
+### Step 2 — Install from source (contributors / offline)
+
+For hacking on GraphStack itself or air-gapped installs, clone the repo instead of PyPI:
 
 ```bash
 git clone https://github.com/MertCapkin/graphstack /tmp/graphstack
@@ -199,7 +189,9 @@ What happens:
 
 Run this once. After that, use `/graphify --update` — it only re-scans changed files and takes a few seconds.
 
-**New project with no code yet?** Skip this step — GraphStack's Bootstrap Mode handles it. Just go to Step 4.
+**New project with no code yet?** Skip this step — GraphStack's Bootstrap Mode handles it.
+
+**Already ran `graphstack init --install-deps`?** You have a code-only graph in `graphify-out/`; run `/graphify .` in Cursor for the full semantic graph when ready.
 
 ---
 
@@ -373,7 +365,7 @@ GraphStack is a **workflow protocol** (markdown + handoff files), not a runtime
 | Role automation | Prompts alone cannot guarantee discipline. v4.3+ **`graphstack gate`** + v4.4 Cursor **`preToolUse`**. Hooks block commits and (on Cursor/Claude) code writes without a claimed task; `afterFileEdit` on Cursor remains advisory-only backup. |
 | Token savings | The table above is **estimated**, not guaranteed. Small repos or undisciplined sessions may use **more** tokens than unstructured chat. |
 | Knowledge graph | Value appears on **20+ file** codebases with module boundaries. Meta-repos full of markdown produce noisy graphs — use `.graphifyignore` (included in this repo). |
-| Setup | Graphify + GraphStack install + `/graphify` + Cursor — four steps, not zero-config. |
+| Setup | Graphify + `pip install MertCapkin_GraphStack` + `graphstack init` — or one bootstrap command. See [PyPI](https://pypi.org/project/MertCapkin_GraphStack/). |
 
 **v4.1 helpers:** `graphstack doctor` (health report) and `graphstack validate` (exit code for CI). Use `--strict` before Builder handoff; use `--fail-stale-graph` in CI after code changes.
 

{mertcapkin_graphstack-4.5.1 → mertcapkin_graphstack-4.5.3}/README.md

@@ -6,15 +6,15 @@
 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)
+[![PyPI](https://img.shields.io/pypi/v/MertCapkin_GraphStack)](https://pypi.org/project/MertCapkin_GraphStack/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
-[![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)
 
 </div>
 
-> **v4.5 highlights:** One-command bootstrap (`bootstrap.ps1` / `bootstrap.sh`), PyPI-ready packaging, `board reopen` / `list-done`. Plus v4.4 `graph query` + `init`, v4.3 gate. See [CHANGELOG.md](CHANGELOG.md).
+> **v4.5 highlights:** Published on [PyPI](https://pypi.org/project/MertCapkin_GraphStack/) as **`MertCapkin_GraphStack`**, one-command bootstrap, `board reopen` / `list-done`. Plus v4.4 `graph query` + `init`, v4.3 gate. See [CHANGELOG.md](CHANGELOG.md).
 
 ---
 
@@ -22,22 +22,23 @@ One prompt starts the entire lifecycle — from blank repo to production.
 
 Open your **project folder** in Cursor, open the integrated terminal, and run:
 
-**Windows (PowerShell):**
+**Windows (PowerShell) — recommended:**
 ```powershell
-irm https://raw.githubusercontent.com/MertCapkin/GraphStack/main/scripts/bootstrap.ps1 | iex
+irm https://raw.githubusercontent.com/MertCapkin/GraphStack/master/scripts/bootstrap.ps1 | iex
 ```
 
 **macOS / Linux:**
 ```bash
-curl -fsSL https://raw.githubusercontent.com/MertCapkin/GraphStack/main/scripts/bootstrap.sh | bash
+curl -fsSL https://raw.githubusercontent.com/MertCapkin/GraphStack/master/scripts/bootstrap.sh | bash
 ```
 
-**After [PyPI publish](docs/PYPI.md):**
+**Or install from PyPI directly:**
 
-> PyPI package name is **`MertCapkin_GraphStack`** (`graphstack` was already taken). The CLI command is still `graphstack`.
+> Package: **`MertCapkin_GraphStack`** on [PyPI](https://pypi.org/project/MertCapkin_GraphStack/) (`graphstack` name was taken). CLI command: **`graphstack`**.
 
 ```bash
-pip install "MertCapkin_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.
@@ -46,67 +47,55 @@ This installs GraphStack + Graphify, copies workflow files into **the current pr
 
 ## Quick Start
 
-### Step 1 — Install prerequisites
+### Step 1 — Install GraphStack (PyPI)
 
-**Python 3.8+** and **Git** are required. Check if you have them:
+**Python 3.8+** and **Git** are required.
 
 ```bash
-py -3 --version   # need 3.8 or higher
-git --version       # any recent version is fine
+py -3 --version
+git --version
 ```
 
-**Install Graphify** — the knowledge graph engine GraphStack is built on. The version range is pinned in [`requirements.txt`](requirements.txt):
+Install GraphStack + Graphify from PyPI, then initialize **your project** (run inside your project folder):
 
 ```bash
-pip install -r requirements.txt
-# or, equivalently, install Graphify directly with the same pin:
-pip install "graphifyy>=0.7,<0.9"
-
-# Optional: install GraphStack CLI from a clone (board / validate / doctor / run)
-pip install -e /path/to/graphstack
-# or with Graphify in one step:
-pip install -e "/path/to/graphstack[graphify]"
+pip install "MertCapkin_GraphStack[graphify]"
+graphstack init . -y --install-deps
 ```
 
-After installation, register the Cursor slash command (one-time):
-
-```bash
-graphify cursor install
-```
+Or use the [one-command bootstrap](#one-command-cursor-terminal) above (same result; installs from PyPI, falls back to GitHub if needed).
 
-Verify it worked:
+Verify:
 
 ```bash
+graphstack --version
+graphstack doctor
 pip show graphifyy
 ```
 
-If `graphify` is not found after install, try:
-
-```bash
-pip install --user "graphifyy>=0.7,<0.9"
-# then add ~/.local/bin to your PATH, or use:
-python3 -m graphify --version
-```
+> **PyPI:** [pypi.org/project/MertCapkin_GraphStack](https://pypi.org/project/MertCapkin_GraphStack/)  
+> **CLI name:** `graphstack` (unchanged — only the pip package name differs)
 
-> Graphify runs **entirely locally** — no API calls, no data sent anywhere.
-> It uses tree-sitter to parse your code and builds the graph on your machine.
+Graphify runs **entirely locally** — tree-sitter AST, no API calls for code graphs.
 
 ---
 
-### Step 2 — Install GraphStack into your project
+### Step 1 (alternative) — Manual Graphify only
 
-GraphStack now works natively on Windows, macOS, and Linux. The installer runs through Python (which you already have for Graphify), so no shell-specific tooling is required.
-
-#### One command (recommended)
+If you prefer to install Graphify separately first:
 
 ```bash
-git clone https://github.com/MertCapkin/graphstack /path/to/graphstack
-cd /path/to/your-project
-/path/to/graphstack/install.ps1 .          # Windows
-# or: python -m graphstack init . -y       # any OS — install + graph refresh + doctor
+pip install "graphifyy>=0.7,<0.9"
+graphify cursor install
+pip install "MertCapkin_GraphStack[graphify]"
+graphstack init . -y --install-deps
 ```
 
-#### macOS / Linux (bash / zsh)
+---
+
+### Step 2 — Install from source (contributors / offline)
+
+For hacking on GraphStack itself or air-gapped installs, clone the repo instead of PyPI:
 
 ```bash
 git clone https://github.com/MertCapkin/graphstack /tmp/graphstack
@@ -170,7 +159,9 @@ What happens:
 
 Run this once. After that, use `/graphify --update` — it only re-scans changed files and takes a few seconds.
 
-**New project with no code yet?** Skip this step — GraphStack's Bootstrap Mode handles it. Just go to Step 4.
+**New project with no code yet?** Skip this step — GraphStack's Bootstrap Mode handles it.
+
+**Already ran `graphstack init --install-deps`?** You have a code-only graph in `graphify-out/`; run `/graphify .` in Cursor for the full semantic graph when ready.
 
 ---
 
@@ -344,7 +335,7 @@ GraphStack is a **workflow protocol** (markdown + handoff files), not a runtime
 | Role automation | Prompts alone cannot guarantee discipline. v4.3+ **`graphstack gate`** + v4.4 Cursor **`preToolUse`**. Hooks block commits and (on Cursor/Claude) code writes without a claimed task; `afterFileEdit` on Cursor remains advisory-only backup. |
 | Token savings | The table above is **estimated**, not guaranteed. Small repos or undisciplined sessions may use **more** tokens than unstructured chat. |
 | Knowledge graph | Value appears on **20+ file** codebases with module boundaries. Meta-repos full of markdown produce noisy graphs — use `.graphifyignore` (included in this repo). |
-| Setup | Graphify + GraphStack install + `/graphify` + Cursor — four steps, not zero-config. |
+| Setup | Graphify + `pip install MertCapkin_GraphStack` + `graphstack init` — or one bootstrap command. See [PyPI](https://pypi.org/project/MertCapkin_GraphStack/). |
 
 **v4.1 helpers:** `graphstack doctor` (health report) and `graphstack validate` (exit code for CI). Use `--strict` before Builder handoff; use `--fail-stale-graph` in CI after code changes.
 

{mertcapkin_graphstack-4.5.1 → mertcapkin_graphstack-4.5.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "MertCapkin_GraphStack"
-version = "4.5.1"
+version = "4.5.3"
 description = "Graph-first AI development workflow — board, gate, graph queries, one-shot init"
 readme = "README.md"
 license = { text = "MIT" }
@@ -34,6 +34,7 @@ Homepage = "https://github.com/MertCapkin/GraphStack"
 Repository = "https://github.com/MertCapkin/GraphStack"
 Documentation = "https://github.com/MertCapkin/GraphStack#readme"
 "Bug Tracker" = "https://github.com/MertCapkin/GraphStack/issues"
+PyPI = "https://pypi.org/project/MertCapkin_GraphStack/"
 
 [project.scripts]
 graphstack = "graphstack.cli:main"
@@ -41,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"]

{mertcapkin_graphstack-4.5.1 → mertcapkin_graphstack-4.5.3/scripts/MertCapkin_GraphStack.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: MertCapkin_GraphStack
-Version: 4.5.1
+Version: 4.5.3
 Summary: Graph-first AI development workflow — board, gate, graph queries, one-shot init
 Author: GraphStack contributors
 License: MIT
@@ -8,6 +8,7 @@ Project-URL: Homepage, https://github.com/MertCapkin/GraphStack
 Project-URL: Repository, https://github.com/MertCapkin/GraphStack
 Project-URL: Documentation, https://github.com/MertCapkin/GraphStack#readme
 Project-URL: Bug Tracker, https://github.com/MertCapkin/GraphStack/issues
+Project-URL: PyPI, https://pypi.org/project/MertCapkin_GraphStack/
 Keywords: graphstack,cursor,graphify,ai,workflow,agent
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
@@ -35,15 +36,15 @@ Dynamic: license-file
 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)
+[![PyPI](https://img.shields.io/pypi/v/MertCapkin_GraphStack)](https://pypi.org/project/MertCapkin_GraphStack/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
-[![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)
 
 </div>
 
-> **v4.5 highlights:** One-command bootstrap (`bootstrap.ps1` / `bootstrap.sh`), PyPI-ready packaging, `board reopen` / `list-done`. Plus v4.4 `graph query` + `init`, v4.3 gate. See [CHANGELOG.md](CHANGELOG.md).
+> **v4.5 highlights:** Published on [PyPI](https://pypi.org/project/MertCapkin_GraphStack/) as **`MertCapkin_GraphStack`**, one-command bootstrap, `board reopen` / `list-done`. Plus v4.4 `graph query` + `init`, v4.3 gate. See [CHANGELOG.md](CHANGELOG.md).
 
 ---
 
@@ -51,22 +52,23 @@ One prompt starts the entire lifecycle — from blank repo to production.
 
 Open your **project folder** in Cursor, open the integrated terminal, and run:
 
-**Windows (PowerShell):**
+**Windows (PowerShell) — recommended:**
 ```powershell
-irm https://raw.githubusercontent.com/MertCapkin/GraphStack/main/scripts/bootstrap.ps1 | iex
+irm https://raw.githubusercontent.com/MertCapkin/GraphStack/master/scripts/bootstrap.ps1 | iex
 ```
 
 **macOS / Linux:**
 ```bash
-curl -fsSL https://raw.githubusercontent.com/MertCapkin/GraphStack/main/scripts/bootstrap.sh | bash
+curl -fsSL https://raw.githubusercontent.com/MertCapkin/GraphStack/master/scripts/bootstrap.sh | bash
 ```
 
-**After [PyPI publish](docs/PYPI.md):**
+**Or install from PyPI directly:**
 
-> PyPI package name is **`MertCapkin_GraphStack`** (`graphstack` was already taken). The CLI command is still `graphstack`.
+> Package: **`MertCapkin_GraphStack`** on [PyPI](https://pypi.org/project/MertCapkin_GraphStack/) (`graphstack` name was taken). CLI command: **`graphstack`**.
 
 ```bash
-pip install "MertCapkin_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.
@@ -75,67 +77,55 @@ This installs GraphStack + Graphify, copies workflow files into **the current pr
 
 ## Quick Start
 
-### Step 1 — Install prerequisites
+### Step 1 — Install GraphStack (PyPI)
 
-**Python 3.8+** and **Git** are required. Check if you have them:
+**Python 3.8+** and **Git** are required.
 
 ```bash
-py -3 --version   # need 3.8 or higher
-git --version       # any recent version is fine
+py -3 --version
+git --version
 ```
 
-**Install Graphify** — the knowledge graph engine GraphStack is built on. The version range is pinned in [`requirements.txt`](requirements.txt):
+Install GraphStack + Graphify from PyPI, then initialize **your project** (run inside your project folder):
 
 ```bash
-pip install -r requirements.txt
-# or, equivalently, install Graphify directly with the same pin:
-pip install "graphifyy>=0.7,<0.9"
-
-# Optional: install GraphStack CLI from a clone (board / validate / doctor / run)
-pip install -e /path/to/graphstack
-# or with Graphify in one step:
-pip install -e "/path/to/graphstack[graphify]"
+pip install "MertCapkin_GraphStack[graphify]"
+graphstack init . -y --install-deps
 ```
 
-After installation, register the Cursor slash command (one-time):
-
-```bash
-graphify cursor install
-```
+Or use the [one-command bootstrap](#one-command-cursor-terminal) above (same result; installs from PyPI, falls back to GitHub if needed).
 
-Verify it worked:
+Verify:
 
 ```bash
+graphstack --version
+graphstack doctor
 pip show graphifyy
 ```
 
-If `graphify` is not found after install, try:
-
-```bash
-pip install --user "graphifyy>=0.7,<0.9"
-# then add ~/.local/bin to your PATH, or use:
-python3 -m graphify --version
-```
+> **PyPI:** [pypi.org/project/MertCapkin_GraphStack](https://pypi.org/project/MertCapkin_GraphStack/)  
+> **CLI name:** `graphstack` (unchanged — only the pip package name differs)
 
-> Graphify runs **entirely locally** — no API calls, no data sent anywhere.
-> It uses tree-sitter to parse your code and builds the graph on your machine.
+Graphify runs **entirely locally** — tree-sitter AST, no API calls for code graphs.
 
 ---
 
-### Step 2 — Install GraphStack into your project
+### Step 1 (alternative) — Manual Graphify only
 
-GraphStack now works natively on Windows, macOS, and Linux. The installer runs through Python (which you already have for Graphify), so no shell-specific tooling is required.
-
-#### One command (recommended)
+If you prefer to install Graphify separately first:
 
 ```bash
-git clone https://github.com/MertCapkin/graphstack /path/to/graphstack
-cd /path/to/your-project
-/path/to/graphstack/install.ps1 .          # Windows
-# or: python -m graphstack init . -y       # any OS — install + graph refresh + doctor
+pip install "graphifyy>=0.7,<0.9"
+graphify cursor install
+pip install "MertCapkin_GraphStack[graphify]"
+graphstack init . -y --install-deps
 ```
 
-#### macOS / Linux (bash / zsh)
+---
+
+### Step 2 — Install from source (contributors / offline)
+
+For hacking on GraphStack itself or air-gapped installs, clone the repo instead of PyPI:
 
 ```bash
 git clone https://github.com/MertCapkin/graphstack /tmp/graphstack
@@ -199,7 +189,9 @@ What happens:
 
 Run this once. After that, use `/graphify --update` — it only re-scans changed files and takes a few seconds.
 
-**New project with no code yet?** Skip this step — GraphStack's Bootstrap Mode handles it. Just go to Step 4.
+**New project with no code yet?** Skip this step — GraphStack's Bootstrap Mode handles it.
+
+**Already ran `graphstack init --install-deps`?** You have a code-only graph in `graphify-out/`; run `/graphify .` in Cursor for the full semantic graph when ready.
 
 ---
 
@@ -373,7 +365,7 @@ GraphStack is a **workflow protocol** (markdown + handoff files), not a runtime
 | Role automation | Prompts alone cannot guarantee discipline. v4.3+ **`graphstack gate`** + v4.4 Cursor **`preToolUse`**. Hooks block commits and (on Cursor/Claude) code writes without a claimed task; `afterFileEdit` on Cursor remains advisory-only backup. |
 | Token savings | The table above is **estimated**, not guaranteed. Small repos or undisciplined sessions may use **more** tokens than unstructured chat. |
 | Knowledge graph | Value appears on **20+ file** codebases with module boundaries. Meta-repos full of markdown produce noisy graphs — use `.graphifyignore` (included in this repo). |
-| Setup | Graphify + GraphStack install + `/graphify` + Cursor — four steps, not zero-config. |
+| Setup | Graphify + `pip install MertCapkin_GraphStack` + `graphstack init` — or one bootstrap command. See [PyPI](https://pypi.org/project/MertCapkin_GraphStack/). |
 
 **v4.1 helpers:** `graphstack doctor` (health report) and `graphstack validate` (exit code for CI). Use `--strict` before Builder handoff; use `--fail-stale-graph` in CI after code changes.
 

{mertcapkin_graphstack-4.5.1 → mertcapkin_graphstack-4.5.3}/scripts/MertCapkin_GraphStack.egg-info/SOURCES.txt

@@ -1,4 +1,5 @@
 LICENSE
+MANIFEST.in
 README.md
 pyproject.toml
 scripts/MertCapkin_GraphStack.egg-info/PKG-INFO
@@ -22,6 +23,15 @@ scripts/graphstack/platform_utils.py
 scripts/graphstack/run.py
 scripts/graphstack/state.py
 scripts/graphstack/validate.py
+scripts/graphstack/assets/.graphstack-assets-version
+scripts/graphstack/assets/.cursor/commands/graphstack.md
+scripts/graphstack/assets/.cursor/rules/graphstack.mdc
+scripts/graphstack/assets/.cursor/skills/architect/ARCHITECT.md
+scripts/graphstack/assets/.cursor/skills/bootstrapper/BOOTSTRAPPER.md
+scripts/graphstack/assets/.cursor/skills/builder/BUILDER.md
+scripts/graphstack/assets/.cursor/skills/qa/QA.md
+scripts/graphstack/assets/.cursor/skills/reviewer/REVIEWER.md
+scripts/graphstack/assets/.cursor/skills/ship/SHIP.md
 scripts/graphstack/assets/docs/CURSOR_PROMPTS.md
 scripts/graphstack/assets/handoff/BOOTSTRAP.md
 scripts/graphstack/assets/handoff/BRIEF.md

{mertcapkin_graphstack-4.5.1 → mertcapkin_graphstack-4.5.3}/scripts/graphstack/__init__.py

@@ -8,5 +8,5 @@ Commands: ``board``, ``install``, ``init``, ``hook``, ``validate``, ``doctor``,
 ``gate``, ``state``, ``graph``
 """
 
-__version__ = "4.5.1"
+__version__ = "4.5.3"
 __all__ = ["__version__"]

mertcapkin_graphstack-4.5.3/scripts/graphstack/assets/.cursor/commands/graphstack.md

@@ -0,0 +1,5 @@
+# GraphStack — start Orchestrator
+
+1. Execute **Activation** in `orchestrator/ORCHESTRATOR.md` exactly as written (including step **1a**).
+2. Greet using the scripted format from that section.
+3. Wait for user input (`Activation` wait step). If the user already embedded their goal in the same message as this command, proceed with that goal immediately after greeting.