MertCapkin-GraphCraft 0.1.1__tar.gz

mertcapkin_graphcraft-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GraphStack Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mertcapkin_graphcraft-0.1.1/MANIFEST.in

@@ -0,0 +1,2 @@
+# GraphCraft overlay assets for PyPI wheels (GraphStack comes from dependency).
+graft scripts/graphcraft/assets

mertcapkin_graphcraft-0.1.1/PKG-INFO

@@ -0,0 +1,237 @@
+Metadata-Version: 2.4
+Name: MertCapkin_GraphCraft
+Version: 0.1.1
+Summary: Mobile game/app design layer on GraphStack — design graph, style packs, aesthetic engine
+Author: GraphCraft contributors
+License: MIT
+Project-URL: Homepage, https://github.com/MertCapkin/GraphCraft
+Project-URL: Repository, https://github.com/MertCapkin/GraphCraft
+Project-URL: Documentation, https://github.com/MertCapkin/GraphCraft#readme
+Keywords: graphcraft,graphstack,mobile,ui,design-system,cursor,ai
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6
+Provides-Extra: graphstack
+Requires-Dist: MertCapkin_GraphStack[graphify]<5,>=4.7; extra == "graphstack"
+Provides-Extra: graphify
+Requires-Dist: graphifyy<0.9,>=0.7; extra == "graphify"
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Provides-Extra: full
+Requires-Dist: MertCapkin_GraphCraft[dev,graphify,graphstack]; extra == "full"
+Dynamic: license-file
+
+<div align="center">
+
+# GraphCraft 🎨📱
+
+**Mobile game & app design layer on GraphStack.**  
+Design graph · style packs · aesthetic engine · Stitch import · wide mobile stack support.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![Works with Cursor](https://img.shields.io/badge/Works%20with-Cursor-blue)](https://cursor.sh)
+
+</div>
+
+GraphCraft is the **product you install and use**. [GraphStack](https://github.com/MertCapkin/GraphStack) is a **dependency** that provides orchestration (cycle, gate, roles, code graph). GraphCraft adds the **design layer** without forking or patching GraphStack.
+
+```
+Graphify     → code graph        (graphify-out/)
+GraphStack   → orchestration     (cycle, gate, roles)     ← dependency
+GraphCraft   → design layer      (graphcraft-out/, design-system/)
+```
+
+> **Important:** GraphCraft never modifies GraphStack source. Integration is **overlay-only**: extra rules, skills, `orchestrator/GRAPHCRAFT.md`, and `graphcraft` CLI. GraphStack files come from the `MertCapkin_GraphStack` package unchanged.
+
+---
+
+## Quick Start
+
+**Requirements:** Python 3.8+, Git, [Cursor](https://cursor.sh)
+
+### Install (PyPI — after v0.1.1 release)
+
+```powershell
+pip install "MertCapkin_GraphCraft[graphstack]"
+```
+
+### Install (GitHub — works now)
+
+```powershell
+pip install "MertCapkin_GraphCraft[graphstack] @ git+https://github.com/MertCapkin/GraphCraft.git@v0.1.1"
+```
+
+GraphStack + Graphify install automatically via the `[graphstack]` extra from PyPI.
+
+### 2. Initialize your project
+
+Open your **app/game repo** in Cursor, then in terminal:
+
+```powershell
+graphcraft init . -y --install-deps
+```
+
+This runs **`graphstack init`** first (GraphStack overlay), then **`graphcraft install`** (GraphCraft overlay). Both rule sets load in Cursor automatically.
+
+### 3. Build graphs
+
+```powershell
+graphcraft design update .          # design graph
+# In Cursor chat: /graphify .       # code graph (or: graphstack graph update .)
+graphcraft doctor .
+```
+
+### 4. Start working
+
+Describe your mobile app or game in Cursor chat. GraphCraft orchestrator activates first; GraphStack handles cycle/gate mechanics.
+
+---
+
+## Install from source (this repo — contributors)
+
+```powershell
+git clone https://github.com/MertCapkin/GraphCraft.git
+cd GraphCraft
+pip install -e ".[full]"
+```
+
+Initialize a **consumer project** (not this framework repo):
+
+```powershell
+cd C:\path\to\your-mobile-app
+graphcraft init . -y --install-deps
+```
+
+See [docs/GRAPHSTACK.md](docs/GRAPHSTACK.md) for dependency details.
+
+---
+
+## What runs when you open a task?
+
+GraphCraft uses an **overlay orchestrator** — GraphStack is not edited, but GraphCraft is not skipped.
+
+| Step | What loads | Purpose |
+|------|------------|---------|
+| 1 | `.cursor/rules/graphcraft.mdc` | **Primary** greeting, design routing |
+| 2 | `.cursor/rules/graphstack.mdc` | Cycle, gate, token discipline (unchanged) |
+| 3 | `orchestrator/GRAPHCRAFT.md` | Design lifecycle extension |
+| 4 | `orchestrator/ORCHESTRATOR.md` | GraphStack cycle mechanics |
+| 5 | `graphcraft-out/DESIGN_REPORT.md` | Design graph summary |
+| 6 | `graphify-out/GRAPH_REPORT.md` | Code graph summary |
+
+### User request flow (UI/mobile task)
+
+```
+User goal in chat
+    → [GRAPHCRAFT] greet + read design context
+    → ARCHITECT (GraphStack cycle start + BRIEF.md)
+    → DESIGN STRATEGIST (AESTHETIC_BRIEF.md)     ← GraphCraft adds
+    → DESIGNER (design graph, screens, tokens)   ← GraphCraft adds
+    → DESIGN AUDIT (validate + harmony)          ← GraphCraft adds
+    → BUILDER (GraphStack — requires brief + design ready)
+    → VISUAL REVIEW                              ← GraphCraft adds
+    → REVIEWER → QA → SHIP (GraphStack unchanged)
+```
+
+Pure backend tasks (no UI): GraphStack flow only — design phases skipped.
+
+Full detail: [docs/FLOW.md](docs/FLOW.md) · [orchestrator/GRAPHCRAFT.md](orchestrator/GRAPHCRAFT.md)
+
+---
+
+## Commands
+
+| Command | Layer | Purpose |
+|---------|-------|---------|
+| `graphcraft init .` | GraphCraft | GraphStack init + GraphCraft overlay |
+| `graphcraft doctor .` | GraphCraft | Health check (both layers) |
+| `graphcraft design update .` | GraphCraft | Build design graph |
+| `graphcraft design query "screens"` | GraphCraft | Query design graph |
+| `graphcraft design validate` | GraphCraft | Validate design graph |
+| `graphcraft design harmony` | GraphCraft | Component harmony check |
+| `graphcraft stitch import .` | GraphCraft | Import Stitch prototype |
+| `python -m graphstack cycle start …` | GraphStack | Start dev cycle |
+| `python -m graphstack graph query "…"` | GraphStack | Query code graph |
+
+---
+
+## Configuration
+
+Edit `graphcraft.config.yaml`:
+
+```yaml
+profile: mobile-app          # mobile-app | mobile-game
+design_source: native        # native | stitch | hybrid
+active_stack: react-native   # see packs/mobile-app/STACKS.md
+```
+
+---
+
+## Mobile stacks
+
+| Profile | Targets |
+|---------|---------|
+| **mobile-app** | React Native, Expo, Flutter, SwiftUI, Jetpack Compose, KMP, Ionic, Capacitor |
+| **mobile-game** | Unity UGUI, Unity UI Toolkit, Godot, Unreal UMG, Defold, Cocos |
+
+Pack docs: `packs/mobile-app/STACKS.md` · `packs/mobile-game/STACKS.md`
+
+---
+
+## Project layout (after init)
+
+```
+your-project/
+├── graphcraft.config.yaml
+├── design-system/           # tokens, components
+├── design/screens/          # screen specs
+├── graphcraft-out/          # design-graph.json
+├── graphify-out/            # code graph (Graphify)
+├── handoff/                 # BRIEF, DESIGN_BRIEF, AESTHETIC_BRIEF
+├── orchestrator/
+│   ├── GRAPHCRAFT.md        # GraphCraft extension
+│   └── ORCHESTRATOR.md      # GraphStack (from dependency)
+├── .cursor/rules/
+│   ├── graphcraft.mdc       # GraphCraft overlay (primary)
+│   └── graphstack.mdc       # GraphStack (from dependency)
+└── scripts/
+    ├── graphcraft/          # GraphCraft CLI copy
+    └── graphstack/          # GraphStack CLI copy
+```
+
+---
+
+## Design sources
+
+| Mode | Use when |
+|------|----------|
+| `native` | YAML design-system + screens from scratch |
+| `stitch` | Google [Stitch](https://stitch.withgoogle.com/) prototype import |
+| `hybrid` | Stitch visual reference + native refinement |
+
+---
+
+## Documentation
+
+| Doc | Content |
+|-----|---------|
+| [docs/GRAPHSTACK.md](docs/GRAPHSTACK.md) | GraphStack dependency — install, what it provides |
+| [docs/FLOW.md](docs/FLOW.md) | Orchestrator overlay — who runs first |
+| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | Layer model — why GraphStack is untouched |
+| [CHANGELOG_GRAPHCRAFT.md](CHANGELOG_GRAPHCRAFT.md) | GraphCraft releases |
+| [docs/PYPI.md](docs/PYPI.md) | PyPI publish + install |
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+GraphStack is © its contributors, installed as a separate dependency under MIT.

mertcapkin_graphcraft-0.1.1/README.md

@@ -0,0 +1,207 @@
+<div align="center">
+
+# GraphCraft 🎨📱
+
+**Mobile game & app design layer on GraphStack.**  
+Design graph · style packs · aesthetic engine · Stitch import · wide mobile stack support.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![Works with Cursor](https://img.shields.io/badge/Works%20with-Cursor-blue)](https://cursor.sh)
+
+</div>
+
+GraphCraft is the **product you install and use**. [GraphStack](https://github.com/MertCapkin/GraphStack) is a **dependency** that provides orchestration (cycle, gate, roles, code graph). GraphCraft adds the **design layer** without forking or patching GraphStack.
+
+```
+Graphify     → code graph        (graphify-out/)
+GraphStack   → orchestration     (cycle, gate, roles)     ← dependency
+GraphCraft   → design layer      (graphcraft-out/, design-system/)
+```
+
+> **Important:** GraphCraft never modifies GraphStack source. Integration is **overlay-only**: extra rules, skills, `orchestrator/GRAPHCRAFT.md`, and `graphcraft` CLI. GraphStack files come from the `MertCapkin_GraphStack` package unchanged.
+
+---
+
+## Quick Start
+
+**Requirements:** Python 3.8+, Git, [Cursor](https://cursor.sh)
+
+### Install (PyPI — after v0.1.1 release)
+
+```powershell
+pip install "MertCapkin_GraphCraft[graphstack]"
+```
+
+### Install (GitHub — works now)
+
+```powershell
+pip install "MertCapkin_GraphCraft[graphstack] @ git+https://github.com/MertCapkin/GraphCraft.git@v0.1.1"
+```
+
+GraphStack + Graphify install automatically via the `[graphstack]` extra from PyPI.
+
+### 2. Initialize your project
+
+Open your **app/game repo** in Cursor, then in terminal:
+
+```powershell
+graphcraft init . -y --install-deps
+```
+
+This runs **`graphstack init`** first (GraphStack overlay), then **`graphcraft install`** (GraphCraft overlay). Both rule sets load in Cursor automatically.
+
+### 3. Build graphs
+
+```powershell
+graphcraft design update .          # design graph
+# In Cursor chat: /graphify .       # code graph (or: graphstack graph update .)
+graphcraft doctor .
+```
+
+### 4. Start working
+
+Describe your mobile app or game in Cursor chat. GraphCraft orchestrator activates first; GraphStack handles cycle/gate mechanics.
+
+---
+
+## Install from source (this repo — contributors)
+
+```powershell
+git clone https://github.com/MertCapkin/GraphCraft.git
+cd GraphCraft
+pip install -e ".[full]"
+```
+
+Initialize a **consumer project** (not this framework repo):
+
+```powershell
+cd C:\path\to\your-mobile-app
+graphcraft init . -y --install-deps
+```
+
+See [docs/GRAPHSTACK.md](docs/GRAPHSTACK.md) for dependency details.
+
+---
+
+## What runs when you open a task?
+
+GraphCraft uses an **overlay orchestrator** — GraphStack is not edited, but GraphCraft is not skipped.
+
+| Step | What loads | Purpose |
+|------|------------|---------|
+| 1 | `.cursor/rules/graphcraft.mdc` | **Primary** greeting, design routing |
+| 2 | `.cursor/rules/graphstack.mdc` | Cycle, gate, token discipline (unchanged) |
+| 3 | `orchestrator/GRAPHCRAFT.md` | Design lifecycle extension |
+| 4 | `orchestrator/ORCHESTRATOR.md` | GraphStack cycle mechanics |
+| 5 | `graphcraft-out/DESIGN_REPORT.md` | Design graph summary |
+| 6 | `graphify-out/GRAPH_REPORT.md` | Code graph summary |
+
+### User request flow (UI/mobile task)
+
+```
+User goal in chat
+    → [GRAPHCRAFT] greet + read design context
+    → ARCHITECT (GraphStack cycle start + BRIEF.md)
+    → DESIGN STRATEGIST (AESTHETIC_BRIEF.md)     ← GraphCraft adds
+    → DESIGNER (design graph, screens, tokens)   ← GraphCraft adds
+    → DESIGN AUDIT (validate + harmony)          ← GraphCraft adds
+    → BUILDER (GraphStack — requires brief + design ready)
+    → VISUAL REVIEW                              ← GraphCraft adds
+    → REVIEWER → QA → SHIP (GraphStack unchanged)
+```
+
+Pure backend tasks (no UI): GraphStack flow only — design phases skipped.
+
+Full detail: [docs/FLOW.md](docs/FLOW.md) · [orchestrator/GRAPHCRAFT.md](orchestrator/GRAPHCRAFT.md)
+
+---
+
+## Commands
+
+| Command | Layer | Purpose |
+|---------|-------|---------|
+| `graphcraft init .` | GraphCraft | GraphStack init + GraphCraft overlay |
+| `graphcraft doctor .` | GraphCraft | Health check (both layers) |
+| `graphcraft design update .` | GraphCraft | Build design graph |
+| `graphcraft design query "screens"` | GraphCraft | Query design graph |
+| `graphcraft design validate` | GraphCraft | Validate design graph |
+| `graphcraft design harmony` | GraphCraft | Component harmony check |
+| `graphcraft stitch import .` | GraphCraft | Import Stitch prototype |
+| `python -m graphstack cycle start …` | GraphStack | Start dev cycle |
+| `python -m graphstack graph query "…"` | GraphStack | Query code graph |
+
+---
+
+## Configuration
+
+Edit `graphcraft.config.yaml`:
+
+```yaml
+profile: mobile-app          # mobile-app | mobile-game
+design_source: native        # native | stitch | hybrid
+active_stack: react-native   # see packs/mobile-app/STACKS.md
+```
+
+---
+
+## Mobile stacks
+
+| Profile | Targets |
+|---------|---------|
+| **mobile-app** | React Native, Expo, Flutter, SwiftUI, Jetpack Compose, KMP, Ionic, Capacitor |
+| **mobile-game** | Unity UGUI, Unity UI Toolkit, Godot, Unreal UMG, Defold, Cocos |
+
+Pack docs: `packs/mobile-app/STACKS.md` · `packs/mobile-game/STACKS.md`
+
+---
+
+## Project layout (after init)
+
+```
+your-project/
+├── graphcraft.config.yaml
+├── design-system/           # tokens, components
+├── design/screens/          # screen specs
+├── graphcraft-out/          # design-graph.json
+├── graphify-out/            # code graph (Graphify)
+├── handoff/                 # BRIEF, DESIGN_BRIEF, AESTHETIC_BRIEF
+├── orchestrator/
+│   ├── GRAPHCRAFT.md        # GraphCraft extension
+│   └── ORCHESTRATOR.md      # GraphStack (from dependency)
+├── .cursor/rules/
+│   ├── graphcraft.mdc       # GraphCraft overlay (primary)
+│   └── graphstack.mdc       # GraphStack (from dependency)
+└── scripts/
+    ├── graphcraft/          # GraphCraft CLI copy
+    └── graphstack/          # GraphStack CLI copy
+```
+
+---
+
+## Design sources
+
+| Mode | Use when |
+|------|----------|
+| `native` | YAML design-system + screens from scratch |
+| `stitch` | Google [Stitch](https://stitch.withgoogle.com/) prototype import |
+| `hybrid` | Stitch visual reference + native refinement |
+
+---
+
+## Documentation
+
+| Doc | Content |
+|-----|---------|
+| [docs/GRAPHSTACK.md](docs/GRAPHSTACK.md) | GraphStack dependency — install, what it provides |
+| [docs/FLOW.md](docs/FLOW.md) | Orchestrator overlay — who runs first |
+| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | Layer model — why GraphStack is untouched |
+| [CHANGELOG_GRAPHCRAFT.md](CHANGELOG_GRAPHCRAFT.md) | GraphCraft releases |
+| [docs/PYPI.md](docs/PYPI.md) | PyPI publish + install |
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+GraphStack is © its contributors, installed as a separate dependency under MIT.

mertcapkin_graphcraft-0.1.1/pyproject.toml

@@ -0,0 +1,62 @@
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "MertCapkin_GraphCraft"
+version = "0.1.1"
+description = "Mobile game/app design layer on GraphStack — design graph, style packs, aesthetic engine"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.8"
+authors = [{ name = "GraphCraft contributors" }]
+keywords = ["graphcraft", "graphstack", "mobile", "ui", "design-system", "cursor", "ai"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Build Tools",
+]
+dependencies = ["pyyaml>=6"]
+
+[project.optional-dependencies]
+graphstack = ["MertCapkin_GraphStack[graphify]>=4.7,<5"]
+graphify = ["graphifyy>=0.7,<0.9"]
+dev = ["pytest>=7"]
+full = ["MertCapkin_GraphCraft[graphstack,graphify,dev]"]
+
+[project.urls]
+Homepage = "https://github.com/MertCapkin/GraphCraft"
+Repository = "https://github.com/MertCapkin/GraphCraft"
+Documentation = "https://github.com/MertCapkin/GraphCraft#readme"
+
+[project.scripts]
+graphcraft = "graphcraft.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["scripts"]
+include = ["graphcraft*"]
+exclude = ["graphcraft.tests*"]
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.package-data]
+graphcraft = [
+    "assets/.cursor/rules/graphcraft.mdc",
+    "assets/.cursor/commands/graphcraft.md",
+    "assets/.cursor/skills/designer/DESIGNER.md",
+    "assets/.cursor/skills/design-strategist/DESIGN_STRATEGIST.md",
+    "assets/.cursor/skills/stitch-import/STITCH_IMPORT.md",
+    "assets/.cursor/skills/visual-review/VISUAL_REVIEW.md",
+    "assets/.cursor/skills/mobile-app/MOBILE_APP.md",
+    "assets/.cursor/skills/mobile-game/MOBILE_GAME.md",
+    "assets/.graphcraft-assets-version",
+    "assets/**/*",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["scripts/graphstack/tests", "scripts/graphcraft/tests"]
+pythonpath = ["scripts"]