@leejungkiin/awkit 1.3.8 → 1.4.2

package/skills/ai-sprite-maker/scripts/process_sprites.py

@@ -0,0 +1,140 @@
+import sys
+import os
+import math
+
+try:
+    from PIL import Image
+except ImportError:
+    print("Error: Module 'Pillow' is not installed. Vui lòng chạy: pip install Pillow")
+    sys.exit(1)
+
+def is_green_screen(r, g, b, tolerance=100):
+    """
+    Thuật toán nhận biết màu nền xanh (green screen / chroma key).
+    Bản gốc màu lý tưởng: #00FF00 (0, 255, 0).
+    """
+    dist = math.sqrt((r - 0)**2 + (g - 255)**2 + (b - 0)**2)
+    if dist < tolerance:
+        return True
+    if g > r + 40 and g > b + 40 and g > 130:
+        return True
+    return False
+
+def align_grid(img, cols, rows):
+    width, height = img.size
+    orig_cell_w = width // cols
+    orig_cell_h = height // rows
+    
+    frames = []
+    for r in range(rows):
+        for c in range(cols):
+            box = (c * orig_cell_w, r * orig_cell_h, c * orig_cell_w + orig_cell_w, r * orig_cell_h + orig_cell_h)
+            frames.append(img.crop(box))
+            
+    contents = []
+    valid_w = []
+    valid_h = []
+    
+    for frame in frames:
+        bbox = frame.getbbox()
+        if bbox:
+            content = frame.crop(bbox)
+            w = bbox[2] - bbox[0]
+            h = bbox[3] - bbox[1]
+            valid_w.append(w)
+            valid_h.append(h)
+            contents.append((content, w, h))
+        else:
+            contents.append(None)
+            
+    if not valid_w:
+        return img
+        
+    valid_w.sort()
+    valid_h.sort()
+    # Dùng median thay vì max để loại trừ khung bị lỗi do AI vẽ quá dài (outliers)
+    median_w = valid_w[len(valid_w) // 2]
+    median_h = valid_h[len(valid_h) // 2]
+            
+    padding = 20
+    cell_w = median_w + padding * 2
+    cell_h = median_h + padding * 2
+    
+    aligned_frames = []
+    for item in contents:
+        new_frame = Image.new("RGBA", (cell_w, cell_h), (0,0,0,0))
+        if item:
+            content, content_w, content_h = item
+            shift_x = (cell_w - content_w) // 2
+            shift_y = (cell_h - padding) - content_h
+            if shift_y < 0: shift_y = 0
+            new_frame.paste(content, (shift_x, shift_y))
+        aligned_frames.append(new_frame)
+        
+    out_img = Image.new("RGBA", (cell_w * cols, cell_h * rows), (0,0,0,0))
+    for i, frame in enumerate(aligned_frames):
+        row = i // cols
+        col = i % cols
+        out_img.paste(frame, (col * cell_w, row * cell_h))
+        
+    return out_img
+
+def remove_green_screen(input_path, output_path, align_cols=0, align_rows=0):
+    print(f"[*] Bắt đầu đọc tệp ảnh: {input_path}")
+    try:
+        img = Image.open(input_path).convert("RGBA")
+    except Exception as e:
+        print(f"[!] Không thể mở file ảnh gốc: {e}")
+        sys.exit(1)
+        
+    data = img.getdata()
+    new_data = []
+    
+    # Lặp qua các mảng Pixels và lọc màu Chroma-key
+    for r, g, b, a in data:
+        if a > 0 and is_green_screen(r, g, b, tolerance=110):
+            # Các viền pixel ám xanh sẽ được hạ alpha xuống trong suốt tuyệt đối (0)
+            new_data.append((255, 255, 255, 0))
+        else:
+            new_data.append((r, g, b, a))
+            
+    img.putdata(new_data)
+    
+    # Căn chỉnh lưới (Auto-Align) hoặc cắt gọn (Auto-Crop)
+    if align_cols > 0 and align_rows > 0:
+        print(f"[*] Đang căn chỉnh tự động các frame theo lưới {align_cols}x{align_rows} (đáy chạm đất, giữa tâm)...")
+        img = align_grid(img, align_cols, align_rows)
+    else:
+        bbox = img.getbbox()
+        if bbox:
+            img = img.crop(bbox)
+        
+    # Tạo cấu trúc thư mục nếu chưa tồn tại
+    os.makedirs(os.path.dirname(os.path.abspath(output_path)), exist_ok=True)
+    img.save(output_path, "PNG")
+    print(f"[*] Thành công! Đã xoá nền và lưu Sprite thành phẩm tại: {output_path}")
+
+if __name__ == "__main__":
+    if len(sys.argv) < 3:
+        print("Cú pháp: python process_sprites.py <file_raw.png> <file_output.png> [--align CxR]")
+        sys.exit(1)
+        
+    input_file = sys.argv[1]
+    output_file = sys.argv[2]
+    
+    align_c = 0
+    align_r = 0
+    
+    if len(sys.argv) >= 5 and sys.argv[3] == "--align":
+        try:
+            dims = sys.argv[4].lower().split('x')
+            align_c = int(dims[0])
+            align_r = int(dims[1])
+        except:
+            print("[!] Lỗi tham số --align. Ví dụ đúng: --align 3x2")
+    
+    if not os.path.exists(input_file):
+        print(f"[!] Lỗi: Không tìm thấy đường dẫn file ảnh gốc! ({input_file})")
+        sys.exit(1)
+        
+    remove_green_screen(input_file, output_file, align_c, align_r)

package/skills/awf-session-restore/SKILL.md

@@ -6,8 +6,8 @@ description: |
   Enforces Project ID → Brain Switch → Memory Read order to prevent cross-project contamination.
 metadata:
   stage: core
-  version: "7.0"
-  replaces: "v6.4"
+  version: "7.1"
+  replaces: "v7.0"
   requires: symphony-orchestrator
   tags: [session, restore, context, symphony, neuralmemory, silent, multi-project]
 trigger: session_start
@@ -99,6 +99,16 @@ Hoặc nếu dùng cấu trúc brain khác:
 cat CODEBASE.md 2>/dev/null | head -5
 ```
 
+#### 3d. Legacy Artifact Detection (v7.1)
+```bash
+# Detect stale JSON task files — Symphony uses SQLite only
+test -f .symphony/tasks.json && echo "LEGACY_TASKS_JSON_FOUND" || echo "CLEAN"
+```
+
+Nếu phát hiện `LEGACY_TASKS_JSON_FOUND`:
+→ Ghi vào silent context: `legacy_artifacts: ["tasks.json"]`
+→ `symphony-enforcer` Step 0.5 sẽ warn user.
+
 #### 3c. Symphony Task State
 ```bash
 symphony task list -P <projectId> -s in_progress --json 2>/dev/null

package/skills/brainstorm-agent/SKILL.md

@@ -131,21 +131,24 @@ Trước khi bắt đầu, LUÔN:
 ### Phase 2: Idea Exploration (One Question at a Time)
 
 **Rules:**
-- Hỏi **một câu hỏi mỗi lần** — không overwhelm user
+- Hỏi **một câu hỏi mỗi lần** — không overwhelm user.
+- **CHỦ ĐỘNG KHAI THÁC & MỞ RỘNG:** Thay vì chỉ nhận ý tưởng thụ động, AI cần **chủ động đặt câu hỏi gợi mở, giả định tình huống hoặc các edge cases** để giúp user tự suy nghĩ sâu hơn và mở rộng ý tưởng của họ (Socratic questioning).
 - Dùng câu hỏi mở đầu thân thiện:
 
 ```
-"💡 Kể em nghe ý tưởng của anh đi! Anh muốn làm gì?"
+"💡 Kể em nghe chi tiết ý tưởng của anh đi! Anh đang muốn giải quyết bài toán gì?"
 
-Sau khi nghe, hỏi thêm:
-• "App/tính năng này giải quyết vấn đề gì?"
-• "Ai sẽ dùng nó?"
-• "Anh nghĩ điều gì làm cho nó khác biệt?"
+Sau khi nghe, hãy chủ động probe sâu hơn. Thay vì hỏi chung chung, hãy hỏi cụ thể dựa trên ý tưởng của user:
+• "Nếu user làm [hành động X], hệ thống nên xử lý thế nào?"
+• "Điểm khác biệt lớn nhất giữa app của anh và các app hiện có là gì?"
+• "Ai sẽ là người dùng cốt lõi nhất, và họ gặp pain point gì nghiêm trọng nhất?"
+• "Anh có nghĩ đến việc thêm [Gợi ý góc nhìn mới/tính năng mở rộng] không, vì nó sẽ giúp [lợi ích]?"
 ```
 
-**Active Listening:**
+**Active Listening & Expanding:**
 - Tóm tắt lại: "Em hiểu là anh muốn [X] để giải quyết [Y], đúng không?"
-- KHÔNG vội đưa ra giải pháp — hiểu vấn đề trước
+- **Đào sâu:** "Em thấy phần [Z] khá thú vị, anh định triển khai nó theo hướng manual hay chạy auto?"
+- KHÔNG vội đưa ra giải pháp hoàn chỉnh — hãy giúp user tự làm rõ ý tưởng của mình trước.
 
 ---
 

package/skills/code-review/SKILL.md

@@ -24,47 +24,35 @@ Review early, review often. Catch issues before they cascade.
 - Before refactoring (baseline check)
 - After fixing complex bug
 
-## The Review Process
+## The Review Process (Execution via Codex CLI)
 
-### Step 1: Prepare Context
+Thay vì tự đọc diff và đánh giá, Antigravity **BẮT BUỘC** gọi `codex` CLI để thực hiện Code Review nhằm mở rộng Context Window và sử dụng subagent chuyên dụng.
 
-Gather what the reviewer needs:
+Có 3 chế độ review chính tùy theo bối cảnh:
 
+### 1. Review Toàn Bộ Codebase (Full Review)
+Sử dụng khi cần đánh giá tổng thể dự án, review architecture, security, hoặc chuẩn bị big release.
 ```bash
-# Get the diff scope
-git diff main..HEAD --stat
-git log main..HEAD --oneline
-
-# OR for specific task
-git diff HEAD~1..HEAD --stat
+codex -p "Review toàn bộ codebase. Tập trung kiểm tra tính nhất quán kiến trúc (architecture), rủi ro bảo mật (security) và hiệu suất (performance)." --approval-mode auto
 ```
 
-### Step 2: Construct Review Request
-
-Every review request needs:
-
-| Field | Description | Example |
-|-------|-------------|---------|
-| **WHAT** | What was implemented | "Water reminder notification system" |
-| **SPEC** | What it should do | "Send notification every 2h between 8am-10pm" |
-| **FILES** | Changed files | `WaterReminderManager.swift`, `NotificationService.swift` |
-| **SCOPE** | Review focus | "Logic correctness + thread safety" |
-
-### Step 3: Classify Findings
-
-| Severity | Action | Example |
-|----------|--------|---------|
-| 🔴 **Critical** | BLOCK — fix immediately | Thread-unsafe shared state, data loss risk |
-| 🟡 **Important** | Fix before proceeding | Missing error handling, incomplete validation |
-| 🟢 **Minor** | Note for later | Naming convention, code style preference |
-| ℹ️ **Suggestion** | Consider but optional | Performance optimization, alternative approach |
+### 2. Review Những Thay Đổi (Changes / Diff Review)
+Sử dụng khi vừa hoàn thành xong code một tính năng hoặc fix bug (các thay đổi workspace, stashed, unstaged, hoặc dải diff ngắn).
+```bash
+codex -p "Review những thay đổi hiện tại (git diff/staged). Tập trung kiểm tra logic, edge cases và conventions." --approval-mode auto
+```
 
-### Step 4: Act on Feedback
+### 3. Review Commit Cụ Thể (Specific Commit)
+Sử dụng khi cần review một nhánh git, PR, hoặc một commit hash cụ thể.
+```bash
+codex -p "Review commit <commit_hash> (hoặc range main..HEAD). Tập trung đánh giá xem code có giải quyết đúng vấn đề và compliance với Spec không." --approval-mode auto
+```
 
-1. Fix 🔴 Critical issues IMMEDIATELY
-2. Fix 🟡 Important issues before proceeding to next task
-3. Log 🟢 Minor issues — fix in refactoring pass
-4. Evaluate ℹ️ Suggestions — adopt if clear improvement
+### Cách Xử Lý Output Từ Codex
+1. Fix 🔴 **Critical** issues NGAY LẬP TỨC.
+2. Fix 🟡 **Important** issues trước khi kết thúc task hoặc chuyển sang Phase mới.
+3. Log 🟢 **Minor** issues để cấu trúc lại sau.
+4. Proceed nếu Subagent Codex báo "LGTM" hoặc không có issue nào nghiêm trọng.
 
 ## Two-Stage Review (Subagent-Driven)
 

package/skills/gitnexus/gitnexus-cli/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: gitnexus-cli
+description: "Use when the user needs to run GitNexus CLI commands like analyze/index a repo, check status, clean the index, generate a wiki, or list indexed repos. Examples: \"Index this repo\", \"Reanalyze the codebase\", \"Generate a wiki\""
+---
+
+# GitNexus CLI Commands
+
+All commands work via `npx` — no global install required.
+
+## Commands
+
+### analyze — Build or refresh the index
+
+```bash
+npx gitnexus analyze
+```
+
+Run from the project root. This parses all source files, builds the knowledge graph, writes it to `.gitnexus/`, and generates CLAUDE.md / AGENTS.md context files.
+
+| Flag           | Effect                                                           |
+| -------------- | ---------------------------------------------------------------- |
+| `--force`      | Force full re-index even if up to date                           |
+| `--embeddings` | Enable embedding generation for semantic search (off by default) |
+
+**When to run:** First time in a project, after major code changes, or when `gitnexus://repo/{name}/context` reports the index is stale. In Claude Code, a PostToolUse hook runs `analyze` automatically after `git commit` and `git merge`, preserving embeddings if previously generated.
+
+### status — Check index freshness
+
+```bash
+npx gitnexus status
+```
+
+Shows whether the current repo has a GitNexus index, when it was last updated, and symbol/relationship counts. Use this to check if re-indexing is needed.
+
+### clean — Delete the index
+
+```bash
+npx gitnexus clean
+```
+
+Deletes the `.gitnexus/` directory and unregisters the repo from the global registry. Use before re-indexing if the index is corrupt or after removing GitNexus from a project.
+
+| Flag      | Effect                                            |
+| --------- | ------------------------------------------------- |
+| `--force` | Skip confirmation prompt                          |
+| `--all`   | Clean all indexed repos, not just the current one |
+
+### wiki — Generate documentation from the graph
+
+```bash
+npx gitnexus wiki
+```
+
+Generates repository documentation from the knowledge graph using an LLM. Requires an API key (saved to `~/.gitnexus/config.json` on first use).
+
+| Flag                | Effect                                    |
+| ------------------- | ----------------------------------------- |
+| `--force`           | Force full regeneration                   |
+| `--model <model>`   | LLM model (default: minimax/minimax-m2.5) |
+| `--base-url <url>`  | LLM API base URL                          |
+| `--api-key <key>`   | LLM API key                               |
+| `--concurrency <n>` | Parallel LLM calls (default: 3)           |
+| `--gist`            | Publish wiki as a public GitHub Gist      |
+
+### list — Show all indexed repos
+
+```bash
+npx gitnexus list
+```
+
+Lists all repositories registered in `~/.gitnexus/registry.json`. The MCP `list_repos` tool provides the same information.
+
+## After Indexing
+
+1. **Read `gitnexus://repo/{name}/context`** to verify the index loaded
+2. Use the other GitNexus skills (`exploring`, `debugging`, `impact-analysis`, `refactoring`) for your task
+
+## Troubleshooting
+
+- **"Not inside a git repository"**: Run from a directory inside a git repo
+- **Index is stale after re-analyzing**: Restart Claude Code to reload the MCP server
+- **Embeddings slow**: Omit `--embeddings` (it's off by default) or set `OPENAI_API_KEY` for faster API-based embedding

package/skills/gitnexus/gitnexus-debugging/SKILL.md

@@ -0,0 +1,89 @@
+---
+name: gitnexus-debugging
+description: "Use when the user is debugging a bug, tracing an error, or asking why something fails. Examples: \"Why is X failing?\", \"Where does this error come from?\", \"Trace this bug\""
+---
+
+# Debugging with GitNexus
+
+## When to Use
+
+- "Why is this function failing?"
+- "Trace where this error comes from"
+- "Who calls this method?"
+- "This endpoint returns 500"
+- Investigating bugs, errors, or unexpected behavior
+
+## Workflow
+
+```
+1. gitnexus_query({query: "<error or symptom>"})            → Find related execution flows
+2. gitnexus_context({name: "<suspect>"})                    → See callers/callees/processes
+3. READ gitnexus://repo/{name}/process/{name}                → Trace execution flow
+4. gitnexus_cypher({query: "MATCH path..."})                 → Custom traces if needed
+```
+
+> If "Index is stale" → run `npx gitnexus analyze` in terminal.
+
+## Checklist
+
+```
+- [ ] Understand the symptom (error message, unexpected behavior)
+- [ ] gitnexus_query for error text or related code
+- [ ] Identify the suspect function from returned processes
+- [ ] gitnexus_context to see callers and callees
+- [ ] Trace execution flow via process resource if applicable
+- [ ] gitnexus_cypher for custom call chain traces if needed
+- [ ] Read source files to confirm root cause
+```
+
+## Debugging Patterns
+
+| Symptom              | GitNexus Approach                                          |
+| -------------------- | ---------------------------------------------------------- |
+| Error message        | `gitnexus_query` for error text → `context` on throw sites |
+| Wrong return value   | `context` on the function → trace callees for data flow    |
+| Intermittent failure | `context` → look for external calls, async deps            |
+| Performance issue    | `context` → find symbols with many callers (hot paths)     |
+| Recent regression    | `detect_changes` to see what your changes affect           |
+
+## Tools
+
+**gitnexus_query** — find code related to error:
+
+```
+gitnexus_query({query: "payment validation error"})
+→ Processes: CheckoutFlow, ErrorHandling
+→ Symbols: validatePayment, handlePaymentError, PaymentException
+```
+
+**gitnexus_context** — full context for a suspect:
+
+```
+gitnexus_context({name: "validatePayment"})
+→ Incoming calls: processCheckout, webhookHandler
+→ Outgoing calls: verifyCard, fetchRates (external API!)
+→ Processes: CheckoutFlow (step 3/7)
+```
+
+**gitnexus_cypher** — custom call chain traces:
+
+```cypher
+MATCH path = (a)-[:CodeRelation {type: 'CALLS'}*1..2]->(b:Function {name: "validatePayment"})
+RETURN [n IN nodes(path) | n.name] AS chain
+```
+
+## Example: "Payment endpoint returns 500 intermittently"
+
+```
+1. gitnexus_query({query: "payment error handling"})
+   → Processes: CheckoutFlow, ErrorHandling
+   → Symbols: validatePayment, handlePaymentError
+
+2. gitnexus_context({name: "validatePayment"})
+   → Outgoing calls: verifyCard, fetchRates (external API!)
+
+3. READ gitnexus://repo/my-app/process/CheckoutFlow
+   → Step 3: validatePayment → calls fetchRates (external)
+
+4. Root cause: fetchRates calls external API without proper timeout
+```

package/skills/gitnexus/gitnexus-exploring/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: gitnexus-exploring
+description: "Use when the user asks how code works, wants to understand architecture, trace execution flows, or explore unfamiliar parts of the codebase. Examples: \"How does X work?\", \"What calls this function?\", \"Show me the auth flow\""
+---
+
+# Exploring Codebases with GitNexus
+
+## When to Use
+
+- "How does authentication work?"
+- "What's the project structure?"
+- "Show me the main components"
+- "Where is the database logic?"
+- Understanding code you haven't seen before
+
+## Workflow
+
+```
+1. READ gitnexus://repos                          → Discover indexed repos
+2. READ gitnexus://repo/{name}/context             → Codebase overview, check staleness
+3. gitnexus_query({query: "<what you want to understand>"})  → Find related execution flows
+4. gitnexus_context({name: "<symbol>"})            → Deep dive on specific symbol
+5. READ gitnexus://repo/{name}/process/{name}      → Trace full execution flow
+```
+
+> If step 2 says "Index is stale" → run `npx gitnexus analyze` in terminal.
+
+## Checklist
+
+```
+- [ ] READ gitnexus://repo/{name}/context
+- [ ] gitnexus_query for the concept you want to understand
+- [ ] Review returned processes (execution flows)
+- [ ] gitnexus_context on key symbols for callers/callees
+- [ ] READ process resource for full execution traces
+- [ ] Read source files for implementation details
+```
+
+## Resources
+
+| Resource                                | What you get                                            |
+| --------------------------------------- | ------------------------------------------------------- |
+| `gitnexus://repo/{name}/context`        | Stats, staleness warning (~150 tokens)                  |
+| `gitnexus://repo/{name}/clusters`       | All functional areas with cohesion scores (~300 tokens) |
+| `gitnexus://repo/{name}/cluster/{name}` | Area members with file paths (~500 tokens)              |
+| `gitnexus://repo/{name}/process/{name}` | Step-by-step execution trace (~200 tokens)              |
+
+## Tools
+
+**gitnexus_query** — find execution flows related to a concept:
+
+```
+gitnexus_query({query: "payment processing"})
+→ Processes: CheckoutFlow, RefundFlow, WebhookHandler
+→ Symbols grouped by flow with file locations
+```
+
+**gitnexus_context** — 360-degree view of a symbol:
+
+```
+gitnexus_context({name: "validateUser"})
+→ Incoming calls: loginHandler, apiMiddleware
+→ Outgoing calls: checkToken, getUserById
+→ Processes: LoginFlow (step 2/5), TokenRefresh (step 1/3)
+```
+
+## Example: "How does payment processing work?"
+
+```
+1. READ gitnexus://repo/my-app/context       → 918 symbols, 45 processes
+2. gitnexus_query({query: "payment processing"})
+   → CheckoutFlow: processPayment → validateCard → chargeStripe
+   → RefundFlow: initiateRefund → calculateRefund → processRefund
+3. gitnexus_context({name: "processPayment"})
+   → Incoming: checkoutHandler, webhookHandler
+   → Outgoing: validateCard, chargeStripe, saveTransaction
+4. Read src/payments/processor.ts for implementation details
+```

package/skills/gitnexus/gitnexus-guide/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: gitnexus-guide
+description: "Use when the user asks about GitNexus itself — available tools, how to query the knowledge graph, MCP resources, graph schema, or workflow reference. Examples: \"What GitNexus tools are available?\", \"How do I use GitNexus?\""
+---
+
+# GitNexus Guide
+
+Quick reference for all GitNexus MCP tools, resources, and the knowledge graph schema.
+
+## Always Start Here
+
+For any task involving code understanding, debugging, impact analysis, or refactoring:
+
+1. **Read `gitnexus://repo/{name}/context`** — codebase overview + check index freshness
+2. **Match your task to a skill below** and **read that skill file**
+3. **Follow the skill's workflow and checklist**
+
+> If step 1 warns the index is stale, run `npx gitnexus analyze` in the terminal first.
+
+## Skills
+
+| Task                                         | Skill to read       |
+| -------------------------------------------- | ------------------- |
+| Understand architecture / "How does X work?" | `gitnexus-exploring`         |
+| Blast radius / "What breaks if I change X?"  | `gitnexus-impact-analysis`   |
+| Trace bugs / "Why is X failing?"             | `gitnexus-debugging`         |
+| Rename / extract / split / refactor          | `gitnexus-refactoring`       |
+| Tools, resources, schema reference           | `gitnexus-guide` (this file) |
+| Index, status, clean, wiki CLI commands      | `gitnexus-cli`               |
+
+## Tools Reference
+
+| Tool             | What it gives you                                                        |
+| ---------------- | ------------------------------------------------------------------------ |
+| `query`          | Process-grouped code intelligence — execution flows related to a concept |
+| `context`        | 360-degree symbol view — categorized refs, processes it participates in  |
+| `impact`         | Symbol blast radius — what breaks at depth 1/2/3 with confidence         |
+| `detect_changes` | Git-diff impact — what do your current changes affect                    |
+| `rename`         | Multi-file coordinated rename with confidence-tagged edits               |
+| `cypher`         | Raw graph queries (read `gitnexus://repo/{name}/schema` first)           |
+| `list_repos`     | Discover indexed repos                                                   |
+
+## Resources Reference
+
+Lightweight reads (~100-500 tokens) for navigation:
+
+| Resource                                       | Content                                   |
+| ---------------------------------------------- | ----------------------------------------- |
+| `gitnexus://repo/{name}/context`               | Stats, staleness check                    |
+| `gitnexus://repo/{name}/clusters`              | All functional areas with cohesion scores |
+| `gitnexus://repo/{name}/cluster/{clusterName}` | Area members                              |
+| `gitnexus://repo/{name}/processes`             | All execution flows                       |
+| `gitnexus://repo/{name}/process/{processName}` | Step-by-step trace                        |
+| `gitnexus://repo/{name}/schema`                | Graph schema for Cypher                   |
+
+## Graph Schema
+
+**Nodes:** File, Function, Class, Interface, Method, Community, Process
+**Edges (via CodeRelation.type):** CALLS, IMPORTS, EXTENDS, IMPLEMENTS, DEFINES, MEMBER_OF, STEP_IN_PROCESS
+
+```cypher
+MATCH (caller)-[:CodeRelation {type: 'CALLS'}]->(f:Function {name: "myFunc"})
+RETURN caller.name, caller.filePath
+```