@leejungkiin/awkit 1.1.7 → 1.1.9

package/README.md

@@ -23,13 +23,29 @@ AWKit (Antigravity v12+) thực thi 8 nguyên tắc lõi (Gstack-inspired) nhằ
 
 ## 🚀 Quick Start
 
-### Cài đặt nhanh qua NPM (Khuyên dùng)
+### Cài đặt (3 bước)
+
 ```bash
+# 1. AWKit Core (CLI + workflows + skills)
 npm install -g @leejungkiin/awkit
 awkit install
+
+# 2. Symphony (Task Management & Multi-Agent Orchestration)
+npm install -g @leejungkiin/awkit-symphony
+
+# 3. NeuralMemory (AI Memory Engine — requires Python >= 3.11)
+pip install neural-memory
+nmem init
+
+# Verify
 awkit doctor
+symphony --version
+nmem --version
 ```
 
+> 💡 **Bước 2 & 3 được tự động cài khi chạy `awkit install`** nếu môi trường đầy đủ.
+> AI agent cũng tự detect và cài các dependency thiếu khi init session.
+
 
 ## 📦 Commands
 
@@ -147,6 +163,25 @@ awkit tg send "Hello from AWKit!"
 awkit tg send "Hello" --chat -100123456789 --topic 1234
 ```
 
+## 🧠 GitNexus Code Intelligence
+
+AWKit (từ bản cập nhật tích hợp mới) sử dụng **GitNexus** làm engine cung cấp Code Intelligence & Knowledge Graph cho AI Agent. Sau khi chạy `npm install` AWKit, GitNexus sẽ sẵn sàng để dùng ngay.
+
+Để kích hoạt GitNexus trên bất kỳ project nào anh/chị đang code:
+
+```bash
+# 1. Quét toàn bộ project để tạo knowledge graph (chỉ cần chạy lần đầu hoặc khi cấu trúc code thay đổi lớn)
+npx gitnexus analyze
+
+# 2. Sử dụng CLI để phân tích code hoặc explore codebase:
+gitnexus query "điểm thực thi workflow"      # Tìm các file/class liên quan theo ngữ nghĩa
+gitnexus impact "tên_hàm_cần_sửa"            # Xem mức độ ảnh hưởng (blast radius) trước khi edit code!
+gitnexus context "tên_class"                 # Góc nhìn 360 độ (Ai gọi nó? Nó gọi ai?)
+gitnexus rename "tên_cũ" "tên_mới" --dry-run # Đổi tên an toàn qua biểu đồ
+```
+
+AI agent của hệ thống cũng tự động gọi qua cổng GitNexus bằng MCP Tools để tự phân tích rủi ro trước khi commit!
+
 ## 📦 Skill Packs
 
 ```bash

package/bin/awk.js

@@ -283,7 +283,7 @@ function checkSymphony({ silent = false } = {}) {
         return true;
     } catch (_) {
         if (!silent) warn('Symphony CLI not found. Please install it manually:');
-        if (!silent) dim('  npm install -g awkit-symphony');
+        if (!silent) dim('  npm install -g @leejungkiin/awkit-symphony');
         return false;
     }
 }
@@ -1797,7 +1797,7 @@ function cmdInit(forceFlag = false) {
         
         const symReady = checkSymphony({ silent: true });
         if (!symReady) {
-            dim('Symphony CLI is not installed. Run: npm i -g awkit-symphony');
+            dim('Symphony CLI is not installed. Run: npm i -g @leejungkiin/awkit-symphony');
         }
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leejungkiin/awkit",
-  "version": "1.1.7",
+  "version": "1.1.9",
   "description": "Antigravity Workflow Kit. Unified AI agent orchestration system.",
   "main": "bin/awk.js",
   "bin": {
@@ -33,9 +33,12 @@
     "schemas/",
     "templates/",
     "docs/",
-    "symphony/",
     "README.md",
     "CHANGELOG.md",
     "VERSION"
-  ]
+  ],
+  "dependencies": {
+    "@leejungkiin/awkit-symphony": "^0.1.0",
+    "gitnexus": "^1.4.7"
+  }
 }

package/skill-packs/neural-memory/skills/nm-memory-sync/SKILL.md

@@ -165,9 +165,22 @@ This surfaces memories that a keyword search would miss.
 
 ---
 
+## Auto-Install Protocol (New Machine)
+
+If `nmem` CLI is not available:
+```
+1. AI detects: command not found: nmem
+2. AI auto-runs: pip install neural-memory (or python3 -m pip install neural-memory)
+   → Requires Python >= 3.11
+3. After install: nmem init (initialize brain DB)
+4. Verify: nmem --version
+5. If Python < 3.11 or pip fails:
+   → Show user: "⚠️ NeuralMemory requires Python >= 3.11. Install via: brew install python@3.12"
+```
+
 ## Fallback Mode (NeuralMemory Not Installed)
 
-If `nmem` is not available, falls back to flat-file behavior:
+If `nmem` is not available AND auto-install fails, falls back to flat-file behavior:
 ```
 - Reads from brain/decisions/, brain/solutions/
 - Keyword overlap matching (legacy behavior)

package/skills/gitnexus-intelligence/SKILL.md

@@ -0,0 +1,224 @@
+---
+name: gitnexus-intelligence
+description: >-
+  Code intelligence via GitNexus knowledge graph. Auto-triggers on refactoring,
+  debugging, impact analysis, pre-commit checks, and codebase exploration.
+  Requires project to be indexed with `npx gitnexus analyze`.
+metadata:
+  stage: core
+  version: "1.0"
+  tags: [gitnexus, code-intelligence, knowledge-graph, impact-analysis, refactoring]
+agent: Orchestrator
+trigger: auto
+invocation-type: auto
+priority: 5
+---
+
+# GitNexus Intelligence v1.0 — Code-Aware Agent Skill
+
+> **Purpose:** Cung cấp architectural awareness cho AI agent thông qua knowledge graph.
+> GitNexus index codebase thành graph (symbols, relationships, execution flows),
+> expose qua MCP tools để agent hiểu blast radius TRƯỚC khi edit.
+
+---
+
+## ⚡ Prerequisites
+
+```
+CHECK: Project đã được index chưa?
+  → Tìm thư mục `.gitnexus/` trong project root
+  → Hoặc chạy: `npx gitnexus status`
+
+CHƯA INDEX:
+  → Gợi ý user: "Project chưa được GitNexus index. Chạy `npx gitnexus analyze` trước nhé."
+  → KHÔNG dùng GitNexus tools khi chưa index.
+
+INDEX STALE (tool trả warning):
+  → Cảnh báo: "GitNexus index đã cũ. Chạy `npx gitnexus analyze` để cập nhật."
+```
+
+---
+
+## 🎯 When to Activate
+
+| Trigger | Action |
+|---------|--------|
+| Trước khi edit bất kỳ function/class/method | `gitnexus_impact` → check blast radius |
+| Debug error / trace bug | `gitnexus_query` + `gitnexus_context` |
+| Explore unfamiliar code | `gitnexus_query` → execution flows |
+| Rename symbol | `gitnexus_rename` (dry_run trước) |
+| Trước commit | `gitnexus_detect_changes` |
+| Refactor / extract / split | `gitnexus_context` + `gitnexus_impact` |
+
+---
+
+## 🔧 Tools Reference (7 MCP Tools)
+
+| Tool | Purpose | When |
+|------|---------|------|
+| `gitnexus_query` | Process-grouped hybrid search (BM25 + semantic) | Tìm code theo concept |
+| `gitnexus_context` | 360° symbol view: callers, callees, processes | Deep dive vào 1 symbol |
+| `gitnexus_impact` | Blast radius analysis: d=1/2/3 with confidence | Trước khi sửa code |
+| `gitnexus_detect_changes` | Git-diff impact: mapped to affected processes | Trước commit |
+| `gitnexus_rename` | Multi-file coordinated rename via graph | Rename symbols an toàn |
+| `gitnexus_cypher` | Raw Cypher graph queries | Custom analysis |
+| `gitnexus_list_repos` | List all indexed repositories | Discover repos |
+
+> **Multi-repo:** Khi có nhiều repos indexed, thêm `repo` param: `gitnexus_query({query: "auth", repo: "my-app"})`
+
+---
+
+## 📚 Resources Reference
+
+| Resource | Content | Tokens |
+|----------|---------|--------|
+| `gitnexus://repos` | All indexed repos | ~50 |
+| `gitnexus://repo/{name}/context` | Stats + staleness check | ~150 |
+| `gitnexus://repo/{name}/clusters` | Functional areas + cohesion | ~300 |
+| `gitnexus://repo/{name}/cluster/{name}` | Area members + files | ~500 |
+| `gitnexus://repo/{name}/processes` | All execution flows | ~200 |
+| `gitnexus://repo/{name}/process/{name}` | Step-by-step trace | ~200 |
+| `gitnexus://repo/{name}/schema` | Graph schema for Cypher | ~200 |
+
+---
+
+## 📋 Workflow: Impact Analysis (Trước khi edit)
+
+```
+1. gitnexus_impact({target: "symbolName", direction: "upstream"})
+   → Xem ai depend vào symbol này
+2. READ gitnexus://repo/{name}/processes
+   → Check execution flows bị ảnh hưởng
+3. Đánh giá risk level:
+   - d=1 → WILL BREAK (direct callers) → PHẢI update
+   - d=2 → LIKELY AFFECTED → Nên test
+   - d=3 → MAY NEED TESTING → Test nếu critical path
+4. Report risk cho user trước khi sửa
+```
+
+### Risk Assessment
+
+| Affected | Risk |
+|----------|------|
+| <5 symbols, ít processes | LOW |
+| 5-15 symbols, 2-5 processes | MEDIUM |
+| >15 symbols hoặc nhiều processes | HIGH |
+| Critical path (auth, payments) | CRITICAL |
+
+---
+
+## 📋 Workflow: Debugging
+
+```
+1. gitnexus_query({query: "<error hoặc symptom>"})
+   → Tìm execution flows liên quan
+2. gitnexus_context({name: "<suspect function>"})
+   → Xem callers, callees, process participation
+3. READ gitnexus://repo/{name}/process/{processName}
+   → Trace full execution flow step-by-step
+4. gitnexus_detect_changes({scope: "compare", base_ref: "main"})
+   → Nếu là regression: xem branch đã thay đổi gì
+```
+
+---
+
+## 📋 Workflow: Exploring Code
+
+```
+1. READ gitnexus://repo/{name}/context      → Overview + staleness
+2. READ gitnexus://repo/{name}/clusters     → Functional areas
+3. gitnexus_query({query: "<concept>"})     → Execution flows
+4. gitnexus_context({name: "<symbol>"})     → Deep dive
+5. READ gitnexus://repo/{name}/process/{name} → Full trace
+```
+
+---
+
+## 📋 Workflow: Safe Refactoring
+
+### Rename Symbol
+```
+1. gitnexus_rename({symbol_name: "old", new_name: "new", dry_run: true})
+   → Preview tất cả edits (graph edits = safe, text_search = review)
+2. Review kết quả, đặc biệt text_search edits
+3. gitnexus_rename({..., dry_run: false})   → Apply
+4. gitnexus_detect_changes()                → Verify scope
+```
+
+### Extract / Split
+```
+1. gitnexus_context({name: "target"})       → All incoming/outgoing refs
+2. gitnexus_impact({target, direction: "upstream"}) → External callers
+3. Plan update order: interfaces → implementations → callers → tests
+4. Execute changes
+5. gitnexus_detect_changes()                → Verify affected scope
+```
+
+---
+
+## 📋 Workflow: Pre-Commit Check
+
+```
+1. gitnexus_detect_changes({scope: "staged"})
+   → Changed symbols, affected processes, risk level
+2. Nếu risk HIGH/CRITICAL → Cảnh báo user
+3. Verify tất cả d=1 dependents đã được update
+```
+
+---
+
+## 🚫 Rules
+
+```yaml
+always_do:
+  - PHẢI chạy gitnexus_impact TRƯỚC khi edit bất kỳ symbol nào
+  - PHẢI chạy gitnexus_detect_changes TRƯỚC khi commit
+  - PHẢI cảnh báo user khi risk = HIGH hoặc CRITICAL
+  - Ưu tiên gitnexus_query thay vì grep khi explore code
+  - PHẢI dùng gitnexus_rename (dry_run trước) khi rename
+
+never_do:
+  - KHÔNG edit function/class mà chưa check impact
+  - KHÔNG ignore HIGH/CRITICAL risk warnings
+  - KHÔNG rename bằng find-and-replace → dùng gitnexus_rename
+  - KHÔNG commit mà chưa detect_changes
+  - KHÔNG dùng GitNexus tools khi project chưa index
+```
+
+---
+
+## 🔗 Skill Relationships
+
+```
+WORKS WITH:
+  orchestrator (Gate 4 — search before building, Layer 0)
+  systematic-debugging (bổ sung structural context)
+  code-review (pre-commit blast radius check)
+  verification-gate (detect_changes = evidence)
+
+DOES NOT:
+  Tự index project (user phải chạy npx gitnexus analyze)
+  Sửa code trực tiếp (chỉ cung cấp context)
+```
+
+---
+
+## 🔍 Graph Schema Reference
+
+**Nodes:** File, Function, Class, Interface, Method, Community, Process
+
+**Edges (CodeRelation.type):** CALLS, IMPORTS, EXTENDS, IMPLEMENTS, DEFINES, MEMBER_OF, STEP_IN_PROCESS
+
+```cypher
+-- Find all callers of a function
+MATCH (caller)-[:CodeRelation {type: 'CALLS'}]->(f:Function {name: "myFunc"})
+RETURN caller.name, caller.filePath
+
+-- Find what a function calls
+MATCH (f:Function {name: "myFunc"})-[:CodeRelation {type: 'CALLS'}]->(callee)
+RETURN callee.name, callee.filePath
+```
+
+---
+
+*gitnexus-intelligence v1.0 — Code Intelligence for Antigravity*

package/skills/orchestrator/SKILL.md

@@ -166,6 +166,10 @@ CHECK: Có ticket đang In Progress?
   → symphony_available_tasks(filter="in_progress")
 
 🔍 SEARCH BEFORE BUILDING (BẮT BUỘC trước khi viết code mới):
+  Layer 0 — Structural (GitNexus, CHỈ khi .gitnexus/ tồn tại):
+    → gitnexus_impact: Check blast radius của symbol cần sửa
+    → gitnexus_context: Xem 360° callers/callees trước khi code
+    → gitnexus_query: Tìm execution flows liên quan
   Layer 1 — Tried-and-True:
     → nmem_recall: Tìm similar problems đã giải quyết trong brain
     → grep_search: Tìm existing utils/patterns trong codebase
@@ -241,6 +245,10 @@ brainstorm_intent:
 context_intent:
   keywords: ["remember", "save", "continue", "where was I", "nhớ", "tiếp"]
   action: Suggest /recap or /save-brain
+
+refactor_intent:
+  keywords: ["refactor", "rename", "extract", "split", "move", "restructure", "blast radius", "impact"]
+  action: gitnexus-intelligence skill (impact analysis + safe refactoring)
 ```
 
 ---
@@ -305,6 +313,7 @@ WORKS WITH:
   nm-memory-sync (đọc context từ NeuralMemory)
   awf-session-restore (restore state)
   symphony-orchestrator (đảm bảo Symphony server running)
+  gitnexus-intelligence (architectural awareness trước khi code)
 
 DOES NOT:
   Execute code trực tiếp (delegates to workflows)

package/skills/symphony-orchestrator/SKILL.md

@@ -8,7 +8,7 @@ metadata:
   stage: core
   version: "3.0"
   replaces: null
-  requires: awkit-symphony (npm i -g awkit-symphony)
+  requires: "@leejungkiin/awkit-symphony" (npm i -g @leejungkiin/awkit-symphony)
   tags: [symphony, setup, server, orchestration, core, preflight, multi-project, agent]
 agent: Symphony Conductor
 allowed-tools:
@@ -50,13 +50,12 @@ QUAN TRỌNG:
 ### Bước 1: Install Global
 
 ```bash
-cd ~/Dev/NodeJS/main-awf/symphony
-npm link
+npm i -g @leejungkiin/awkit-symphony
 ```
 
-> Hoặc khi publish npm:
+> Dev mode (từ source):
 > ```bash
-> npm i -g awkit-symphony
+> cd ~/Dev/NodeJS/main-awf/symphony && npm link
 > ```
 
 ### Bước 2: Verify
@@ -127,9 +126,12 @@ symphony preflight --json   # JSON cho AI parsing
    → symphony start -p 3100 &
    → Đợi 3-5 giây
    → Retry preflight
-3. Nếu vẫn FAIL:
+3. Nếu vẫn FAIL (command not found):
+   → AI tự chạy: npm i -g @leejungkiin/awkit-symphony
+   → Retry symphony start
+4. Nếu vẫn FAIL:
    → "⚠️ Symphony không khởi động được"
-   → Hướng dẫn: cd ~/Dev/NodeJS/main-awf/symphony && npm link && symphony start
+   → Hướng dẫn user cài thủ công
 ```
 
 ---

package/workflows/gitnexus.md

@@ -0,0 +1,123 @@
+---
+description: 🔍 GitNexus Code Intelligence — Index, explore, và analyze codebase qua knowledge graph
+---
+
+# /gitnexus Workflow
+
+> GitNexus cung cấp code intelligence qua knowledge graph. Index codebase → query qua MCP tools.
+
+## Sub-commands
+
+### `/gitnexus init` — Index project hiện tại
+
+// turbo
+1. Kiểm tra Node.js >= 18:
+```bash
+node --version
+```
+
+2. Index project:
+```bash
+npx -y gitnexus@latest analyze
+```
+
+3. Verify index:
+```bash
+npx gitnexus status
+```
+
+4. (Optional) Generate embeddings cho semantic search tốt hơn:
+```bash
+npx gitnexus analyze --embeddings
+```
+
+---
+
+### `/gitnexus status` — Kiểm tra index
+
+// turbo
+1. Xem trạng thái index:
+```bash
+npx gitnexus status
+```
+
+2. Nếu stale → suggest re-index:
+```bash
+npx gitnexus analyze
+```
+
+---
+
+### `/gitnexus impact <symbol>` — Quick impact analysis
+
+1. Chạy impact analysis:
+```
+gitnexus_impact({target: "<symbol>", direction: "upstream"})
+```
+
+2. Đọc processes bị ảnh hưởng:
+```
+READ gitnexus://repo/{name}/processes
+```
+
+3. Report risk level cho user:
+   - d=1 → WILL BREAK (PHẢI update)
+   - d=2 → LIKELY AFFECTED (nên test)
+   - d=3 → MAY NEED TESTING
+
+---
+
+### `/gitnexus explore` — Architecture overview
+
+1. Đọc context overview:
+```
+READ gitnexus://repo/{name}/context
+```
+
+2. Xem functional areas:
+```
+READ gitnexus://repo/{name}/clusters
+```
+
+3. Liệt kê execution flows:
+```
+READ gitnexus://repo/{name}/processes
+```
+
+4. Present tổng quan cho user:
+   - Số symbols, relationships
+   - Functional clusters
+   - Key execution flows
+
+---
+
+### `/gitnexus list` — Liệt kê repos đã index
+
+// turbo
+1. Liệt kê tất cả repos:
+```bash
+npx gitnexus list
+```
+
+---
+
+### `/gitnexus clean` — Xóa index
+
+1. Xóa index project hiện tại:
+```bash
+npx gitnexus clean
+```
+
+2. Xóa tất cả indexes (cẩn thận!):
+```bash
+npx gitnexus clean --all --force
+```
+
+---
+
+## Notes
+
+- GitNexus lưu index trong `.gitnexus/` (đã gitignored)
+- Registry toàn cục ở `~/.gitnexus/registry.json`
+- Hỗ trợ 13 ngôn ngữ: TypeScript, JavaScript, Python, Java, Kotlin, C#, Go, Rust, PHP, Ruby, Swift, C, C++
+- MCP server serve TẤT CẢ repos đã index (không cần config per-project)

package/symphony/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 AWKit
-
-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.