MertCapkin-GraphCraft 0.1.1__py3-none-any.whl

graphcraft/__init__.py

@@ -0,0 +1,8 @@
+"""GraphCraft — mobile game/app design layer on GraphStack.
+
+Entry point: ``python -m graphcraft <command>``
+Commands: ``init``, ``install``, ``doctor``, ``design``, ``stitch``
+"""
+
+__version__ = "0.1.1"
+__all__ = ["__version__"]

graphcraft/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

graphcraft/assets/.cursor/commands/graphcraft.md

@@ -0,0 +1,24 @@
+# GraphCraft slash command
+
+You are in a **GraphCraft** project. GraphStack is the **dependency** (cycle/gate).
+
+## Read first (parallel)
+
+- `orchestrator/GRAPHCRAFT.md` — design lifecycle (primary)
+- `orchestrator/ORCHESTRATOR.md` — GraphStack cycle (dependency, unchanged)
+- `graphcraft.config.yaml`
+- `docs/FLOW.md` — who runs first
+
+## Greet
+
+`GraphCraft ready.` — not GraphStack ready.
+
+## Quick commands
+
+```bash
+graphcraft doctor .
+graphcraft design update .
+python -m graphstack cycle start <id> "<title>"
+```
+
+UI tasks: Architect → Design Strategist → Designer → Design Audit → Builder → Visual Review → Reviewer → QA → Ship

graphcraft/assets/.cursor/rules/graphcraft.mdc

@@ -0,0 +1,106 @@
+---
+description: GraphCraft primary orchestrator overlay — mobile design layer on GraphStack (dependency). Loads WITH graphstack.mdc; overrides greeting and design routing only.
+globs:
+alwaysApply: true
+---
+
+# GraphCraft Rules (v0.1) — Primary Orchestrator Overlay
+
+This project is **GraphCraft**. GraphStack is a **dependency** (orchestration only).  
+GraphStack rules (`graphstack.mdc`) remain active for cycle, gate, and token discipline.  
+**Do not skip GraphCraft design phases for UI/mobile tasks.**
+
+---
+
+## Activation (GraphCraft projects — run WITH GraphStack activation)
+
+After GraphStack reads `TOKEN_OPTIMIZER.md` and `GRAPH_REPORT.md`, also read (same session, once):
+
+```
+- orchestrator/GRAPHCRAFT.md          ← design lifecycle (GraphCraft)
+- graphcraft-out/DESIGN_REPORT.md     ← if exists
+- graphcraft.config.yaml              ← profile, design_source, stack
+- handoff/AESTHETIC_BRIEF.md          ← if design task active
+- handoff/DESIGN_BRIEF.md             ← if design task active
+```
+
+Then greet with **GraphCraft format** (replaces GraphStack step-8 greeting):
+
+```
+GraphCraft ready.
+Profile: [mobile-app|mobile-game] | Stack: [active_stack] | Design: [native|stitch|hybrid]
+Design graph: [N nodes] | Code graph: [N nodes] | Board: [N todo / N doing / N done]
+[If doing/]: In progress: [task-id] — resume?
+What are we building?
+```
+
+---
+
+## First-turn routing (GraphCraft override)
+
+| User intent | Action |
+|-------------|--------|
+| Greeting only | GraphCraft greet → wait |
+| Task with **UI, screens, design, mobile UX, Stitch, style** | GraphCraft greet → GraphStack `cycle start` + ARCHITECT → **then Design Strategist** (do not jump to Builder) |
+| Task **without UI** (API, scripts, docs) | GraphStack flow only — skip design phases |
+
+**Embedded goal ≠ build now.** Architect writes BRIEF first (GraphStack contract unchanged).
+
+---
+
+## Design phases (GraphCraft — required for UI tasks)
+
+After Architect BRIEF, before Builder:
+
+1. **Design Strategist** → `handoff/AESTHETIC_BRIEF.md` + `research/INSPIRATION.md`
+2. **Designer** → `design/`, `design-system/`, run `python -m graphcraft design update .`
+3. **Design Audit** → `design validate` + `design harmony` → `DESIGN_BRIEF.md` **Ready for Builder**
+4. GraphStack **`cycle enter-builder`** (only after design ready)
+
+After Builder, before Code Reviewer:
+
+5. **Visual Review** → `.cursor/skills/visual-review/VISUAL_REVIEW.md`
+
+Announce: `[GRAPHCRAFT]` when entering design phases. Announce GraphStack roles as usual.
+
+---
+
+## Graph queries
+
+| Question type | Command |
+|---------------|---------|
+| Code structure | `python -m graphstack graph query "…"` |
+| Design (screens, tokens, style) | `python -m graphcraft design query "…"` |
+
+---
+
+## Role skills (GraphCraft)
+
+| Role | Skill |
+|------|-------|
+| Design Strategist | `.cursor/skills/design-strategist/DESIGN_STRATEGIST.md` |
+| Designer | `.cursor/skills/designer/DESIGNER.md` |
+| Stitch import | `.cursor/skills/stitch-import/STITCH_IMPORT.md` |
+| Visual Review | `.cursor/skills/visual-review/VISUAL_REVIEW.md` |
+| Mobile app | `.cursor/skills/mobile-app/MOBILE_APP.md` |
+| Mobile game | `.cursor/skills/mobile-game/MOBILE_GAME.md` |
+
+GraphStack role skills (Architect, Builder, etc.) unchanged.
+
+---
+
+## Before UI code edits
+
+1. `python -m graphcraft design update .` if design files changed
+2. Screen must exist in design graph
+3. GraphStack: `role=builder` + task in `doing/` (gate unchanged)
+
+---
+
+## Forbidden
+
+- Editing `orchestrator/ORCHESTRATOR.md` or `graphstack.mdc` for GraphCraft features
+- Skipping design phases when task touches UI/mobile screens
+- Greeting with "GraphStack ready" in GraphCraft projects
+
+See `docs/FLOW.md` and `docs/ARCHITECTURE.md`.

graphcraft/assets/.cursor/skills/design-strategist/DESIGN_STRATEGIST.md

@@ -0,0 +1,23 @@
+# DESIGN STRATEGIST Role
+
+You research, brainstorm, and select aesthetic direction before Designer works.
+
+## Activation
+
+1. Read `handoff/BRIEF.md` (functional scope)
+2. Write `handoff/AESTHETIC_BRIEF.md`
+3. Web research → `research/INSPIRATION.md` (patterns, not copies)
+
+## Workflow
+
+1. Define project identity + target audience
+2. Run ≤5 focused research queries
+3. Propose ≤3 style directions with marketing + usability notes
+4. User selects direction → update `graphcraft.config.yaml` `design.style`
+5. Set AESTHETIC_BRIEF **Ready for Designer**
+
+## Output quality
+
+- Reference **patterns** (shop layout, onboarding flow), not pixel clones
+- Note accessibility floors (contrast, touch targets)
+- Flag trademark/clone risks explicitly

graphcraft/assets/.cursor/skills/designer/DESIGNER.md

@@ -0,0 +1,26 @@
+# DESIGNER Role
+
+You implement design specs — screens, components, tokens. You do not write app logic.
+
+## Activation
+
+1. Read `graphcraft-out/DESIGN_REPORT.md`
+2. Read `handoff/DESIGN_BRIEF.md` and `graphcraft.config.yaml`
+3. Run `python -m graphcraft design update .`
+
+## Do
+
+- Write/update `design/screens/*.yaml`, `design-system/components/*.yaml`
+- Normalize tokens in `design-system/tokens.json`
+- Run `design validate` and `design harmony` before handoff
+- Set DESIGN_BRIEF **Status: Ready for Builder**
+
+## Don't
+
+- Implement platform code (Builder job)
+- Hardcode colors in specs — use token references
+- Skip harmony check on multi-component screens
+
+## Stitch mode
+
+When `design_source: stitch|hybrid`: curate imported screens, set status approved/rejected in YAML.

graphcraft/assets/.cursor/skills/mobile-app/MOBILE_APP.md

@@ -0,0 +1,15 @@
+# MOBILE APP Skill
+
+Active when `graphcraft.config.yaml` → `profile: mobile-app`.
+
+Read `packs/mobile-app/STACKS.md` for stack-specific guidance.
+
+## Defaults
+
+- Safe area + touch targets enforced
+- Navigation: follow design graph `navigates_to`
+- Prefer `active_stack` from config for Builder
+
+## Stacks
+
+react-native · expo · flutter · swiftui · jetpack-compose · kotlin-multiplatform · ionic · capacitor

graphcraft/assets/.cursor/skills/mobile-game/MOBILE_GAME.md

@@ -0,0 +1,19 @@
+# MOBILE GAME Skill
+
+Active when `graphcraft.config.yaml` → `profile: mobile-game`.
+
+Read `packs/mobile-game/STACKS.md`.
+
+## Scope
+
+Meta-UI only: menus, HUD, shop, inventory, dialogs.
+
+Gameplay canvas is out of design graph scope for v0.1.
+
+## Stacks
+
+unity-ugui · unity-ui-toolkit · godot · unreal-umg · defold · cocos
+
+## Visual mode
+
+Prefer Stitch PNG reference. Token → USS / ScriptableObject themes.

graphcraft/assets/.cursor/skills/stitch-import/STITCH_IMPORT.md

@@ -0,0 +1,25 @@
+# STITCH IMPORT Skill
+
+Import Google Stitch prototypes into GraphCraft design graph.
+
+## When
+
+`graphcraft.config.yaml` → `design_source: stitch|hybrid`
+
+## Steps
+
+1. Export from Stitch: DESIGN.md + screens → `.stitch/designs/` (PNG/HTML)
+2. Copy/fill `.stitch/metadata.json` from `metadata.template.json`
+3. `python -m graphcraft stitch import .`
+4. `python -m graphcraft stitch report`
+5. Curator approves screens in design specs
+
+## MCP (optional)
+
+Configure `@keeponfirst/kof-stitch-mcp` for automated fetch.
+
+## Rules
+
+- `.stitch/` is read-only reference after import
+- Refinements go in `design/screens/` (hybrid mode)
+- Visual ground truth = PNG files

graphcraft/assets/.cursor/skills/visual-review/VISUAL_REVIEW.md

@@ -0,0 +1,20 @@
+# VISUAL REVIEW Role
+
+Compare implementation against design ground truth.
+
+## Checklist
+
+- [ ] Stitch PNG match (if `.stitch/designs/` exists)
+- [ ] Token usage matches design graph (no random hex)
+- [ ] Touch targets ≥ config `design.touch_target_min`
+- [ ] Safe area respected on mobile
+- [ ] `graphcraft design harmony` PASS for reviewed screens
+
+## Marketing + usability rubric
+
+| Screen type | Marketing weight | Usability weight |
+|-------------|------------------|------------------|
+| shop, onboarding | high | medium |
+| settings, forms | medium | high |
+
+Report in `handoff/REVIEW.md` under `## Visual Review`.

graphcraft/assets/.graphcraft-assets-version

@@ -0,0 +1 @@
+0.1.1

graphcraft/assets/.stitch/metadata.template.json

@@ -0,0 +1,20 @@
+{
+  "project_id": "your-stitch-project-id",
+  "screens": {
+    "login": {
+      "id": "screen:login",
+      "title": "Login",
+      "png": "login.png",
+      "status": "imported"
+    },
+    "home": {
+      "id": "screen:home",
+      "title": "Home",
+      "png": "home.png",
+      "status": "imported"
+    }
+  },
+  "flows": [
+    { "from": "screen:login", "to": "screen:home", "trigger": "login_success" }
+  ]
+}

graphcraft/assets/design/screens/login.example.yaml

@@ -0,0 +1,14 @@
+id: screen:login
+title: Login
+platform: mobile-app
+status: example
+components:
+  - component:button-primary
+tokens:
+  - spacing.screen.padding
+navigation:
+  success: screen:home
+  forgot_password: screen:forgot-password
+acceptance:
+  touch_target_min: 44
+  safe_area: true

graphcraft/assets/design-system/components/button.example.yaml

@@ -0,0 +1,20 @@
+id: component:button-primary
+label: Button Primary
+collection: buttons
+style_compatibility:
+  - style:minimal-dark
+uses_tokens:
+  - color.action.primary
+  - spacing.button.padding
+  - radius.default
+alternatives:
+  - component:button-secondary
+when_to_use: Primary CTA, max one per screen
+when_not_to_use: Secondary actions, destructive flows
+harmony_score_with:
+  component:card-elevated: 0.9
+states:
+  - default
+  - pressed
+  - disabled
+  - loading

graphcraft/assets/design-system/tokens.base.json

@@ -0,0 +1,27 @@
+{
+  "color": {
+    "action": {
+      "primary": { "$value": "#6366F1", "$type": "color" },
+      "secondary": { "$value": "#8B5CF6", "$type": "color" }
+    },
+    "bg": {
+      "default": { "$value": "#0F172A", "$type": "color" },
+      "elevated": { "$value": "#1E293B", "$type": "color" }
+    },
+    "text": {
+      "primary": { "$value": "#F8FAFC", "$type": "color" },
+      "muted": { "$value": "#94A3B8", "$type": "color" }
+    }
+  },
+  "spacing": {
+    "screen": {
+      "padding": { "$value": "16px", "$type": "dimension" }
+    },
+    "button": {
+      "padding": { "$value": "12px", "$type": "dimension" }
+    }
+  },
+  "radius": {
+    "default": { "$value": "8px", "$type": "dimension" }
+  }
+}

graphcraft/assets/design-system/tokens.json

@@ -0,0 +1,27 @@
+{
+  "color": {
+    "action": {
+      "primary": { "$value": "#6366F1", "$type": "color" },
+      "secondary": { "$value": "#8B5CF6", "$type": "color" }
+    },
+    "bg": {
+      "default": { "$value": "#0F172A", "$type": "color" },
+      "elevated": { "$value": "#1E293B", "$type": "color" }
+    },
+    "text": {
+      "primary": { "$value": "#F8FAFC", "$type": "color" },
+      "muted": { "$value": "#94A3B8", "$type": "color" }
+    }
+  },
+  "spacing": {
+    "screen": {
+      "padding": { "$value": "16px", "$type": "dimension" }
+    },
+    "button": {
+      "padding": { "$value": "12px", "$type": "dimension" }
+    }
+  },
+  "radius": {
+    "default": { "$value": "8px", "$type": "dimension" }
+  }
+}

graphcraft/assets/graphcraft.config.yaml

@@ -0,0 +1,47 @@
+# GraphCraft configuration
+# Docs: README_GRAPHCRAFT.md
+
+profile: mobile-app          # mobile-app | mobile-game
+design_source: native        # native | stitch | hybrid
+
+stacks:
+  mobile_app:
+    - react-native
+    - expo
+    - flutter
+    - swiftui
+    - jetpack-compose
+    - kotlin-multiplatform
+    - ionic
+    - capacitor
+  mobile_game:
+    - unity-ugui
+    - unity-ui-toolkit
+    - godot
+    - unreal-umg
+    - defold
+    - cocos
+
+active_stack: react-native    # pick one from lists above
+
+design:
+  style: style:minimal-dark
+  token_file: design-system/tokens.json
+  touch_target_min: 44
+  safe_area: true
+
+aesthetic:
+  priority: balanced           # marketing | usability | balanced
+  research_enabled: true
+  max_style_directions: 3
+  hard_floors:
+    contrast_min: 4.5
+
+stitch:
+  enabled: false
+  project_id: ""
+  reference_mode: visual       # visual | code
+
+gates:
+  require_design_approval: true
+  require_visual_qa: true

graphcraft/assets/handoff/AESTHETIC_BRIEF.md

@@ -0,0 +1,52 @@
+# Aesthetic Brief
+
+**Date:** YYYY-MM-DD  
+**Status:** Draft | Ready for Designer | Complete
+
+---
+
+## Project identity
+
+> One sentence: who is this for, what feeling should it evoke?
+
+---
+
+## Research scope
+
+### Queries (max 5)
+- 
+
+### References (URLs, patterns — not assets to copy)
+- 
+
+### Avoid
+- clone / trademark risk
+- 
+
+---
+
+## Style directions (max 3)
+
+| ID | Name | Mood | Marketing fit | Usability fit |
+|----|------|------|---------------|---------------|
+| 1 | | | | |
+| 2 | | | | |
+| 3 | | | | |
+
+**Selected:** style:...
+
+---
+
+## Aesthetic priority
+
+- [ ] balanced
+- [ ] marketing-first (hero screens)
+- [ ] usability-first (forms, settings)
+
+---
+
+## Acceptance
+
+- [ ] Research saved to `research/INSPIRATION.md`
+- [ ] Style pack chosen in `graphcraft.config.yaml`
+- [ ] Ready for Designer

graphcraft/assets/handoff/DESIGN_BRIEF.md

@@ -0,0 +1,47 @@
+# Design Brief
+
+**Date:** YYYY-MM-DD  
+**Status:** Draft | Ready for Builder | In Review
+
+---
+
+## Screens in scope
+
+| Screen ID | Title | Status | Source |
+|-----------|-------|--------|--------|
+| screen:login | Login | approved | native / stitch |
+
+---
+
+## Style pack
+
+- Active: `style:minimal-dark`
+- Tokens: `design-system/tokens.json`
+
+---
+
+## Component collections
+
+- buttons: component:button-primary (alternatives documented in design graph)
+
+---
+
+## Design graph
+
+- Last update: YYYY-MM-DD
+- `graphcraft design validate` → PASS
+- `graphcraft design harmony` → PASS
+
+---
+
+## Visual ground truth
+
+- Stitch PNG: `.stitch/designs/` (if applicable)
+
+---
+
+## Acceptance (Design Audit)
+
+- [ ] All in-scope screens in design graph
+- [ ] No unresolved clashes_with edges on approved screens
+- [ ] DESIGN_BRIEF status → Ready for Builder

graphcraft/assets/orchestrator/GRAPHCRAFT.md

@@ -0,0 +1,87 @@
+# GRAPHCRAFT Orchestrator Extension
+
+**GraphCraft overlay on GraphStack (dependency).**  
+GraphStack's `orchestrator/ORCHESTRATOR.md` is **not modified** — read it for cycle/gate mechanics.  
+This file extends the lifecycle for **mobile game/app design**.
+
+Load order: `TOKEN_OPTIMIZER.md` → `GRAPHCRAFT.md` (this file) → `ORCHESTRATOR.md`
+
+Announce: `[GRAPHCRAFT]` when entering design phases.
+
+---
+
+## Primary greeting (overrides GraphStack step 8)
+
+```
+GraphCraft ready.
+Profile: … | Design graph: … | Code graph: … | Board: …
+```
+
+---
+
+## Extended Lifecycle (UI/mobile tasks)
+
+```
+ARCHITECT          → BRIEF.md (functional)              [GraphStack]
+DESIGN STRATEGIST  → AESTHETIC_BRIEF.md                 [GraphCraft]
+DESIGNER/CURATOR   → design/, design-system/, .stitch/  [GraphCraft]
+DESIGN AUDIT       → validate + harmony → DESIGN_BRIEF  [GraphCraft]
+BUILDER            → design graph + UI packages         [GraphStack + GraphCraft context]
+VISUAL REVIEW      → PNG reference vs code              [GraphCraft]
+REVIEWER → QA → SHIP                                     [GraphStack unchanged]
+```
+
+Non-UI tasks: skip GraphCraft phases → GraphStack only.
+
+---
+
+## Mechanical commands
+
+```bash
+# GraphCraft
+python -m graphcraft design update .
+python -m graphcraft design validate
+python -m graphcraft design harmony
+python -m graphcraft stitch import .
+python -m graphcraft doctor .
+
+# GraphStack (dependency — unchanged)
+python -m graphstack cycle start <id> "<title>"
+python -m graphstack cycle enter-builder <id>
+python -m graphstack cycle enter-reviewer <id>
+python -m graphstack cycle enter-qa <id>
+python -m graphstack cycle enter-ship <id>
+python -m graphstack cycle close <id>
+```
+
+---
+
+## Design Graph First (UI tasks)
+
+```bash
+python -m graphcraft design query "screens"
+python -m graphcraft design query "tokens"
+python -m graphstack graph query "…"    # code structure
+```
+
+---
+
+## Profiles & packs
+
+| Profile | Config | Pack doc |
+|---------|--------|----------|
+| mobile-app | `profile: mobile-app` | `packs/mobile-app/STACKS.md` |
+| mobile-game | `profile: mobile-game` | `packs/mobile-game/STACKS.md` |
+
+`graphcraft.config.yaml` → `design_source`, `active_stack`, `aesthetic`, `stitch`
+
+---
+
+## Integration principle
+
+GraphCraft **never patches GraphStack**. Overlay files only.  
+See `docs/ARCHITECTURE.md` · `docs/FLOW.md` · `docs/GRAPHSTACK.md`
+
+---
+
+*GraphCraft v0.1 — mobile game & app design layer on GraphStack*

graphcraft/assets/packages/assets/README.md

@@ -0,0 +1,22 @@
+# Asset Library
+
+Icons, sprites, fonts, audio UI cues.
+
+## Manifest example
+
+```yaml
+id: assets:icons-minimal
+style_compatibility:
+  - style:minimal-dark
+files:
+  - path: home.svg
+    tags: [navigation, 24px]
+```
+
+## Rules
+
+- Link assets to components via design graph `uses_asset` edges
+- Keep style compatibility in manifest
+- Game sprites: separate atlas pipeline (future)
+
+v0.1: scaffold — add asset sets per style pack in future cycles.

graphcraft/assets/packages/ui-core/README.md

@@ -0,0 +1,23 @@
+# UI Core Library
+
+Shared UI primitives consumed by mobile app/game implementations.
+
+## Structure (expand per cycle)
+
+```
+ui-core/
+├── tokens/          # re-export from design-system
+├── rn/
+├── flutter/
+├── swiftui/
+├── compose/
+└── unity/
+```
+
+## Rules
+
+- No hardcoded colors — use semantic tokens
+- Each component maps to design graph `component:*` id
+- Register new components in `design-system/components/*.yaml`
+
+v0.1: scaffold only — implement stack modules in future cycles.