@musashishao/agent-kit 1.2.2 → 1.4.0

package/docs/PLAN-universal-intelligence.md

@@ -0,0 +1,48 @@
+# PLAN: Universal Intelligence Engine (UIE)
+
+> Mục tiêu: Nâng cấp Agent Kit để hỗ trợ mọi loại folder làm việc (Docs, Research, Code) với khả năng thấu hiểu tri thức toàn diện.
+
+## Phase 1: Universal RAG (Smart Chunking cho mọi định dạng) ✅ COMPLETED
+- [x] **Nâng cấp `chunk_code.py` thành Universal Chunker**:
+    - [x] Thêm `MarkdownChunker`: Cắt segment theo Heading (`#`, `##`, `###`).
+    - [x] Thêm `TextChunker`: Cắt theo đoạn văn (Paragraph).
+    - [x] Giữ nguyên khả năng cắt Code (TS, Python) sử dụng AST.
+- [x] **Contextual Metadata cho Docs**:
+    - [x] Tự động trích xuất tiêu đề chính của file làm context cho từng chunk bên trong.
+    - [x] Ghi nhận `context_path` (Parent > Child heading) để AI biết ngữ cảnh.
+
+## Phase 2: Knowledge Graph cho Tài liệu (Relationship Mapping) ✅ COMPLETED
+- [x] **Nâng cấp `generate_graph.py`**:
+    - [x] Thêm `MarkdownAnalyzer`: Quét link nội bộ `[text](file.md)` và wikilink `[[file]]`.
+    - [x] Nhận diện heading exports (H1, H2) làm "API" của tài liệu.
+    - [x] Chế độ `universal`: Kết hợp Code + Markdown trong cùng một graph.
+
+## Phase 3: MCP Gateway Enhancements
+- [ ] **Content-Type Awareness**:
+    - [ ] Tool `analyze_dependencies` trả về "References" thay vì "Imports" cho docs.
+    - [ ] Tool `search_code_logic` alias thành `search_knowledge`.
+- [ ] **Auto-Detection**: gateway báo cáo loại dự án (Creative, Tech, Mixed).
+
+## Phase 4: CLI Evolution (`ak` command)
+- [ ] **`ak init` thông minh**:
+    - [ ] Không ép buộc phải có `src` hay `app`.
+    - [ ] Tự động tạo `AGENTS.md` theo template "General Knowledge" nếu không phát hiện code.
+- [ ] **`ak sync` toàn diện**:
+    - [ ] Quét mọi file (ngo trừ ignore list) để đảm bảo không bỏ sót tri thức nào.
+
+## Phase 5: Verification & Beta Test
+- [ ] **Test Case 1**: Dự án chỉ gồm 100 file Markdown (Hướng dẫn sử dụng).
+- [ ] **Test Case 2**: Dự án hỗn hợp (Next.js + Docs + API Specs).
+- [ ] **Test Case 3**: Dự án nghiên cứu (Nhiều file .txt và ghi chú rời rạc).
+
+---
+
+## Agent Assignments
+- **Python Specialist**: Xử lý logic Chunker và Graph Mapper (Phase 1 & 2).
+- **TypeScript Expert**: Cập nhật MCP Gateway (Phase 3).
+- **Orchestrator**: Cập nhật CLI và hoàn thiện Docs (Phase 4).
+
+## Verification Checklist
+- [ ] `ai status` hiển thị ✅ RAG và ✅ Graph ngay cả trong folder không có code.
+- [ ] AI có thể tìm thấy thông tin nằm sâu trong một sub-section của file Markdown dài.
+- [ ] Dependency graph hiển thị được mối liên kết giữa các file tài liệu.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@musashishao/agent-kit",
-  "version": "1.2.2",
-  "description": "AI Agent templates - Skills, Agents, Workflows, and MCP servers for enhanced coding assistance",
+  "version": "1.4.0",
+  "description": "AI Agent templates - Skills, Agents, Workflows, and AI-Ready Data Infrastructure Gateway",
   "main": "index.js",
   "bin": {
     "agent-kit": "./bin/cli.js",
@@ -9,9 +9,14 @@
   },
   "files": [
     "bin",
+    "docs",
     ".agent/agents",
     ".agent/mcp",
+    ".agent/mcp-gateway/dist",
+    ".agent/mcp-gateway/package.json",
+    ".agent/mcp-gateway/src",
     ".agent/rules",
+    ".agent/scripts",
     ".agent/skills",
     ".agent/templates",
     ".agent/workflows",