@mrtrinhvn/ag-kit 1.3.1 → 1.4.0

package/README.md

@@ -1,83 +1,69 @@
-# Antigravity Kit Core (`@mrtrinhvn/ag-kit`) 🚀
+# Antigravity Kit (`@mrtrinhvn/ag-kit`) 🧠
 
-A generic, institutional-grade AI programming framework for automating scaffolding, architecture, and coding directly inside your software projects.
+**Universal Memory System** - Trái tim nhận thức và ghi nhớ cho mọi dự án AI Agentic.
+Cấy ghép Lõi Bộ Nhớ 3 Tầng (.agent) vào bất kỳ dự án nào để cung cấp khả năng lưu trữ Context, cấu trúc Codebase, và Vector Semantic Search (nhờ `Ollama` + `nomic-embed-text`) cho các tác tử AI.
 
 ## 📦 Quick Start
 
-The best way to inject AG-Kit into any project is via `npx`. Bạn có thể chạy trực tiếp để vào **Menu tương tác**:
+Cách tốt nhất để cấy ghép AG-Kit vào dự án là dùng `npx`. Chạy lệnh sau để mở **Bảng điều khiển Tương tác**:
 
 ```bash
-# DASHBOARD - Menu chọn tất cả tác vụ (Khuyên dùng)
 npx @mrtrinhvn/ag-kit@latest
 ```
 
-Hoặc chạy các lệnh đơn lẻ:
+Hoặc chạy các lệnh đơn lẻ nếu bạn đã nhớ cú pháp:
 ```bash
-# 1. Khởi tạo bộ não (Inject .agent folder)
+# 1. Khởi tạo / Cấy ghép Lõi (.agent folder)
 npx @mrtrinhvn/ag-kit@latest init
 
-# 2. Kiểm tra sức khỏe hệ thống (CDP, Ollama, Models)
-npx @mrtrinhvn/ag-kit@latest check
+# 2. Xây dựng Bộ não (Quét Codebase & Vector hóa ký ức)
+npx @mrtrinhvn/ag-kit@latest brain
 
-# 3. Kiểm tra trạng thái và phiên bản
-npx @mrtrinhvn/ag-kit@latest status
+# 3. Tra cứu Vector Memory (Xem các node đã lưu)
+npx @mrtrinhvn/ag-kit@latest memory
 ```
 
 ---
 
-## 🛠 Lệnh CLI & Cách sử dụng
+## 🛠 Lệnh CLI & Hệ sinh thái Bộ Não
 
-| Lệnh | Ý nghĩa | Chi tiết |
+| Lệnh | Ý nghĩa | Chi tiết tác vụ |
 |---|---|---|
-| `ag-kit` | **Dashboard** | (Không tham số) Mở menu chọn tương tác cực kỳ tiện lợi. |
-| `ag-kit init` | **Khởi tạo** | Cài đặt tủy não `.agent` và tạo file `.env` mẫu. |
-| `ag-kit check` | **Kiểm tra** | Quét cổng CDP (mặc định 9555), kiểm tra Ollama và AI Models. |
-| `ag-kit update` | **Cập nhật** | Nâng cấp Agents/Skills/Workflows mới nhất mà không làm mất dữ liệu Ký ức. |
-| `ag-kit status` | **Trạng thái** | Hiển thị rõ: Phiên bản Tool (CLI) và Phiên bản Core (Brain) đang dùng. |
+| `ag-kit` | **Dashboard** | Mở menu tương tác trực quan. Khuyên dùng. |
+| `ag-kit init` | **Khởi tạo** | Cấy ghép toàn bộ tủy não `.agent` vào dự án trắng. |
+| `ag-kit brain` | **Bộ Não** | Tự động gọi `brain_builder.py` để quét Codebase, trích xuất Vector Memory và viết Báo cáo Nhận thức `summary.md`. |
+| `ag-kit memory` | **Ký ức** | Hiển thị các Mảnh ký ức (Hot/Cold Nodes) đang được lưu trong Không gian Vector `graph.db`. |
+| `ag-kit update` | **Cập nhật** | Nâng cấp Agents/Skills/Workflows mới nhất từ NPM mà không làm mất dữ liệu Ký ức hoặc Knowledge của dự án. |
+| `ag-kit status` | **Trạng thái** | Hiển thị phiên bản Tool và kiểm tra xem Bộ Não (`summary.md`) đã được hình thành chưa. |
 
-### ⚙️ Cấu hình Cổng (Custom Port)
+---
 
-Mặc định AG-Kit quét cổng **9555** và **9222**. Nếu bạn muốn dùng một cổng riêng cho từng dự án (để tránh xung đột khi mở nhiều IDE), hãy sửa file `.env`:
+## 🏗 Kiến trúc Trí nhớ 3 Tầng (3-Tier Memory)
 
-```env
-CDP_PORT=12345
-```
-Lệnh `ag-kit check` sẽ tự động ưu tiên cổng này để kết nối với IDE.
+Sau khi chạy `init` và `brain`, dự án của bạn sẽ vận hành theo mô hình:
 
----
+1. **Lớp L1 (Working Index):** `repomap.json` - Sơ đồ hàm, class của toàn bộ codebase.
+2. **Lớp L2 (Graph Vector Memory):** `graph.db` - Cơ sở dữ liệu đồ thị + Vector Embeddings. Hệ thống ngầm gọi **Ollama (nomic-embed-text)** để mã hóa mọi lệnh `memory_save` thành toán học, cho phép RAG tìm kiếm theo ý nghĩa (Semantic Search) với độ trễ 0ms và chi phí API $0.
+3. **Lớp L3 (Knowledge Base):** Báo cáo `summary.md` + file markdown gốc của dự án.
 
-## 🏗 Cấu trúc hệ thống (.agent)
+## 🤖 Dual-Model Coordination
 
-Sau khi chạy `init`, dự án của bạn sẽ có bộ khung tiêu chuẩn:
+Gói `ag-kit` khuyến khích nguyên lý kết hợp 2 AI:
+- **Local AI (Ollama):** Đảm nhiệm việc đánh chỉ mục Vector (Embedding) lặng lẽ ở background.
+- **Cloud AI (Gemini/Claude):** Dùng để suy luận logic và viết code dựa trên Context mớm từ Local AI.
 
-- **`GEMINI.md`**: "Hiến pháp" tối cao của Agent, đảm bảo tư duy hệ thống và an toàn.
-- **`agents/`**: Các đặc vụ chuyên trách (Orchestrator, Frontend, Backend, Debugger).
-- **`skills/`**: Các thuật toán tác chiến (Clean code, TDD, React Expert, Rust Pro...).
-- **`workflows/`**: Các lệnh gõ tắt (slash commands) như `/create`, `/plan`, `/debug`.
-- **`knowledge/`**: Nơi lưu giữ giao thức v3 và các kiến thức tự chữa lành (`self-healing`).
+> Vui lòng tải model: `ollama pull nomic-embed-text` để kích hoạt tính năng Semantic Search của `ag-kit`.
 
 ---
 
 ## 🔄 Cập nhật & Bảo trì
 
-Chúng tôi liên tục cập nhật các kỹ năng mới từ dự án `ag-orchestrator`. Để đảm bảo "bộ não" của bạn luôn thông minh nhất:
+Chúng tôi liên tục nâng cấp kỹ năng cho Agent (Skills, Workflows). Để bộ não dự án của bạn luôn thông minh nhất:
 
 ```bash
-# Luôn dùng @latest để lấy những tinh hoa mới nhất từ NPM
+# Luôn dùng @latest để lấy bộ kỹ năng mới nhất
 npx @mrtrinhvn/ag-kit@latest update
 ```
 
 ---
-
-## ❌ Xử lý lỗi thường gặp (Troubleshooting)
-
-**1. Lỗi phiên bản không khớp (Version ghosting):**
-Nếu `status` báo phiên bản cũ hơn bản trên NPM, đó là do cache của `npx` hoặc bạn đã cài global. 
-- Cách giải quyết: Luôn thêm `@latest` sau tên gói (`npx @mrtrinhvn/ag-kit@latest`) hoặc cập nhật bộ não bằng lệnh `ag-kit update`.
-- Giờ đây, các lệnh `init` và `status` sẽ tự động phát hiện và nhắc bạn chạy `update` nếu phát hiện lệch phiên bản.
-
-**2. Lỗi EACCES (Quyền truy cập):**
-Nếu cài global bị báo lỗi quyền, hãy dùng `npx` (Khuyên dùng) hoặc dùng `sudo`.
-
----
-*Built with ❤️ to enforce Institutional-Grade Software Standards.*
+*Built with ❤️ to enforce Institutional-Grade AI Memory Standards.*

package/bin/cli.js

@@ -2,31 +2,11 @@
 const { program } = require('commander');
 const fs = require('fs');
 const path = require('path');
-const net = require('net');
+const { execSync } = require('child_process');
 
 const TEMPLATE_DIR = path.join(__dirname, '..', 'template');
 const TARGET_AGENT_DIR = path.join(process.cwd(), '.agent');
 
-function isPortAvailable(port) {
-  return new Promise((resolve) => {
-    const server = net.createServer();
-    server.once('error', () => resolve(false));
-    server.once('listening', () => {
-      server.close();
-      resolve(true);
-    });
-    server.listen(port, '127.0.0.1');
-  });
-}
-
-async function findNextAvailablePort(startPort) {
-  let port = startPort;
-  while (!(await isPortAvailable(port))) {
-    port++;
-  }
-  return port;
-}
-
 // Helper copy đệ quy
 function copyRecursiveSync(src, dest) {
   const exists = fs.existsSync(src);
@@ -44,108 +24,42 @@ function copyRecursiveSync(src, dest) {
   }
 }
 
-
-function migrateLegacyMemories() {
-  const legacyDir = path.join(process.cwd(), 'data', 'memories');
-  if (!fs.existsSync(legacyDir)) return;
-  
-  let migratedCount = 0;
-  try {
-    const files = fs.readdirSync(legacyDir).filter(f => f.endsWith('.jsonl'));
-    for (const file of files) {
-      const filePath = path.join(legacyDir, file);
-      const lines = fs.readFileSync(filePath, 'utf-8').split('\n');
-      let changed = false;
-      const newLines = lines.map(line => {
-        if (!line.trim()) return line;
-        try {
-          const item = JSON.parse(line);
-          if (item.content && !item.content.includes('[Node:')) {
-            item.content = `[Node:Legacy_Knowledge] => ${item.content}`;
-            changed = true;
-            return JSON.stringify(item);
-          }
-        } catch(e) {}
-        return line;
-      });
-      if (changed) {
-        fs.writeFileSync(filePath, newLines.join('\n'));
-        migratedCount++;
-      }
-    }
-    if (migratedCount > 0) {
-      console.log(`\x1b[35m🧠 TỰ ĐỘNG: Đã băm ${migratedCount} tệp Ký ức cũ thành Tiền-Đồ-Thị (Pseudo-Graph) để tương thích chuẩn mới!\x1b[0m`);
-    }
-  } catch(e) { /* ignore errors during migration */ }
-}
-
 const pkg = require('../package.json');
 program
   .name('ag-kit')
-  .description('Trí khôn Lập trình Phổ quát - AI Agent Initialization Framework')
+  .description('Antigravity Kit - Hệ thống Trí nhớ và Nhận thức AI Phổ quát')
   .version(pkg.version);
 
 program.command('init')
-  .description('Install .agent folder into your project')
+  .description('Cấy ghép Lõi Trí Nhớ (.agent) vào dự án này')
   .action(() => {
     console.log('\x1b[36m🚀 Đang khởi tạo bộ Tủy Não Lập Trình AI (AG-Kit)...\x1b[0m');
     
     const srcAgent = path.join(TEMPLATE_DIR, '.agent');
     if (!fs.existsSync(TARGET_AGENT_DIR)) {
       copyRecursiveSync(srcAgent, TARGET_AGENT_DIR);
-      // Ghi lại version vào .agent/.version
       fs.writeFileSync(path.join(TARGET_AGENT_DIR, '.version'), pkg.version);
-      console.log(`\x1b[32m✅ Đã cài ráp thành công thư mục .agent (phiên bản v${pkg.version}) vào Project!\x1b[0m`);
+      console.log(`\x1b[32m✅ Đã cấy ghép thành công thư mục .agent (v${pkg.version}) vào Project!\x1b[0m`);
       
-      // Khởi động .env nếu chưa có
-      const envPath = path.join(process.cwd(), '.env');
-      (async () => {
-        const idePort = await findNextAvailablePort(9555);
-        const bridgePort = await findNextAvailablePort(idePort + 1);
-
-        if (!fs.existsSync(envPath)) {
-          const envTemplate = `# --- Remote Orchestration (Golden Combo) ---\nIDE_PORT=${idePort}\nBRIDGE_PORT=${bridgePort}\n\nPROJECT_NAME=ag-project\n`;
-          fs.writeFileSync(envPath, envTemplate);
-          console.log(`\x1b[34mℹ️  Đã tạo .env với IDE_PORT=${idePort} và BRIDGE_PORT=${bridgePort}\x1b[0m`);
-        } else {
-          let envContent = fs.readFileSync(envPath, 'utf-8');
-          let changed = false;
-          if (!envContent.includes('IDE_PORT=')) {
-            envContent += `\nIDE_PORT=${idePort}\n`;
-            changed = true;
-          }
-          if (!envContent.includes('BRIDGE_PORT=')) {
-            envContent += `BRIDGE_PORT=${bridgePort}\n`;
-            changed = true;
-          }
-          if (changed) {
-            fs.writeFileSync(envPath, envContent);
-            console.log(`\x1b[34mℹ️  Đã bổ sung cổng tự động: IDE_PORT=${idePort}, BRIDGE_PORT=${bridgePort}\x1b[0m`);
-          }
-        }
-      })();
+      console.log('\x1b[35m👉 Bước tiếp theo: Hãy chọn menu "Build Bộ Não" để quét dự án.\x1b[0m');
     } else {
       console.log('\x1b[33m⚠️ Thư mục .agent đã tồn tại.\x1b[0m');
       const vPath = path.join(TARGET_AGENT_DIR, '.version');
       if (fs.existsSync(vPath)) {
         const installedVersion = fs.readFileSync(vPath, 'utf-8').trim();
         if (installedVersion !== pkg.version) {
-          console.log(`\x1b[35m👉 Phát hiện phiên bản cũ (v${installedVersion}). Hãy dùng lệnh "ag-kit update" để cập nhật lên v${pkg.version}.\x1b[0m`);
+          console.log(`\x1b[35m👉 Phát hiện phiên bản cũ (v${installedVersion}). Hãy dùng lệnh "ag-kit update".\x1b[0m`);
         } else {
           console.log(`\x1b[34mℹ️  Bạn đang sử dụng phiên bản khớp với bộ công cụ (v${pkg.version}).\x1b[0m`);
         }
-      } else {
-        console.log('\x1b[35m👉 Hãy dùng lệnh "ag-kit update" để đồng bộ cấu trúc mới.\x1b[0m');
       }
     }
-
-    console.log('\x1b[35m\n🎉 Hoàn tất! Vui lòng copy luật GEMINI vào file GEMINI.md của dự án nếu chưa có.\x1b[0m');
   });
 
 program.command('update')
-  .description('Update to the latest version')
+  .description('Nâng cấp các kỹ năng AI lên phiên bản mới nhất')
   .action(() => {
-    console.log('\x1b[36m🔄 Đang cập nhật siêu luân xa Lập trình (AG-Kit)...\x1b[0m');
+    console.log('\x1b[36m🔄 Đang nâng cấp Kỹ năng AI (AG-Kit)...\x1b[0m');
     const srcAgent = path.join(TEMPLATE_DIR, '.agent');
     const vPath = path.join(TARGET_AGENT_DIR, '.version');
     let oldVersion = '0.0.0';
@@ -153,9 +67,8 @@ program.command('update')
       oldVersion = fs.readFileSync(vPath, 'utf-8').trim();
     }
 
-    // Chỉ cập nhật não bộ chuẩn (Agents, Skills, Workflows, Scripts, Rules)
-    // Tôn trọng dữ liệu Knowledge của dự án đang có
-    ['agents', 'skills', 'workflows', 'scripts', 'rules'].forEach(folder => {
+    // Chỉ cập nhật các thư mục chuẩn, KHÔNG chạm vào .agent/brain, .agent/cache, .agent/memory
+    ['agents', 'skills', 'workflows', 'scripts', 'rules', 'knowledge'].forEach(folder => {
         const src = path.join(srcAgent, folder);
         const dest = path.join(TARGET_AGENT_DIR, folder);
         if (fs.existsSync(src)) {
@@ -163,119 +76,73 @@ program.command('update')
         }
     });
 
-    migrateLegacyMemories();
-    // Cập nhật version vào .agent/.version
     fs.writeFileSync(vPath, pkg.version);
-    console.log(`\x1b[32m✅ Cập nhật thành công! Phiên bản hiện tại: v${oldVersion} -> v${pkg.version}\x1b[0m`);
-    console.log('\x1b[34m⚡️ Toàn bộ cấu trúc kỹ năng đã được đồng bộ.\x1b[0m');
+    console.log(`\x1b[32m✅ Nâng cấp thành công! Phiên bản hiện tại: v${oldVersion} -> v${pkg.version}\x1b[0m`);
   });
 
-program.command('check')
-  .description('Verify environment health (CDP, Tokens, Ollama)')
-  .action(async () => {
-    const { execSync } = require('child_process');
-    console.log('\x1b[36m🔍 Đang kiểm tra hệ sinh thái Antigravity...\x1b[0m');
-    
+program.command('brain')
+  .description('Quét Repo và Xây dựng/Cập nhật Bộ não (3-Tier Memory)')
+  .action(() => {
+    console.log('\x1b[36m🧠 Đang khởi động tiến trình Tổng hợp Bộ Não...\x1b[0m');
     if (!fs.existsSync(TARGET_AGENT_DIR)) {
-      console.log('\x1b[31m❌ Hệ thống chưa được khởi tạo. Thư mục .agent không tồn tại.\x1b[0m');
-      console.log('\x1b[35m👉 Hãy chạy "ag-kit init" trước khi thực hiện kiểm tra này.\x1b[0m');
+      console.log('\x1b[31m❌ Chưa cấy ghép .agent. Hãy chạy "ag-kit init" trước.\x1b[0m');
       return;
     }
 
-    // 1. Check .env
-    const envPath = path.join(process.cwd(), '.env');
-    if (fs.existsSync(envPath)) {
-      console.log('\x1b[32m✅ .env: OK\x1b[0m');
-    } else {
-      console.log('\x1b[33m⚠️ .env: Không tìm thấy. Hãy tạo file .env từ template.\x1b[0m');
-    }
-
-    // 2. Check CDP Port (Prioritize CDP_PORT from .env)
-    let ports = [9555, 9222];
-    if (fs.existsSync(envPath)) {
-      const content = fs.readFileSync(envPath, 'utf-8');
-      const match = content.match(/CDP_PORT=(\d+)/);
-      if (match) {
-        const customPort = parseInt(match[1]);
-        ports = [customPort, ...ports.filter(p => p !== customPort)];
-        console.log(`\x1b[34mℹ️  Sử dụng cổng CDP tùy chỉnh từ .env: ${customPort}\x1b[0m`);
-      }
+    try {
+      // Gọi Python script brain_builder với cờ --update
+      console.log('\x1b[35m[1/3] Quét cấu trúc Codebase...\x1b[0m');
+      console.log('\x1b[35m[2/3] Trích xuất Vector Memory...\x1b[0m');
+      console.log('\x1b[35m[3/3] Viết báo cáo Nhận thức...\x1b[0m\n');
+      
+      const scriptPath = path.join(TARGET_AGENT_DIR, 'scripts', 'brain_builder.py');
+      execSync(`python3 ${scriptPath} --update`, { stdio: 'inherit' });
+      
+      console.log('\n\x1b[32m✅ Bộ Não đã được tổng hợp thành công tại .agent/brain/summary.md!\x1b[0m');
+    } catch (e) {
+      console.log('\n\x1b[31m❌ Lỗi khi xây dựng Bộ Não. Hãy chắc chắn máy bạn có Python 3.\x1b[0m');
     }
+  });
 
-    let cdpOk = false;
-    for (const port of ports) {
-      try {
-        execSync(`curl -s --max-time 2 http://127.0.0.1:${port}/json/version`, { stdio: 'ignore' });
-        console.log(`\x1b[32m✅ IDE CDP: Phát hiện tại cổng ${port}\x1b[0m`);
-        cdpOk = true;
-        break;
-      } catch (e) {}
+program.command('memory')
+  .description('Tra cứu Bộ nhớ Thực (Vector Memory)')
+  .action(() => {
+    console.log('\x1b[36m🕸️ Tra cứu Trí nhớ Semantic (graph.db)...\x1b[0m');
+    if (!fs.existsSync(TARGET_AGENT_DIR)) {
+      console.log('\x1b[31m❌ Chưa cấy ghép .agent. Hãy chạy "ag-kit init" trước.\x1b[0m');
+      return;
     }
-    if (!cdpOk) console.log(`\x1b[31m❌ IDE CDP: Không tìm thấy IDE đang chạy ở các cổng: ${ports.join(', ')}\x1b[0m`);
-
-    // 3. Check Ollama
     try {
-      execSync('ollama --version', { stdio: 'ignore' });
-      console.log('\x1b[32m✅ Ollama: Đã cài đặt\x1b[0m');
-      try {
-        execSync('curl -s --max-time 2 http://127.0.0.1:11434/api/tags', { stdio: 'ignore' });
-        console.log('\x1b[32m✅ Ollama Service: Online\x1b[0m');
-        
-        // Kiểm tra model mặc định
-        const models = execSync('curl -s http://127.0.0.1:11434/api/tags').toString();
-        if (models.includes('nvidia_Orchestrator')) {
-          console.log('\x1b[32m✅ Default Model: nvidia_Orchestrator (Sẵn sàng)\x1b[0m');
-        } else {
-          console.log('\x1b[33m⚠️ Default Model: nvidia_Orchestrator (Chưa tải - Khuyên dùng "ollama run hf.co/bartowski/nvidia_Orchestrator-8B-GGUF:Q4_K_M")\x1b[0m');
-        }
-      } catch (e) {
-        console.log('\x1b[31m❌ Ollama Service: Offline (Gõ "ollama serve")\x1b[0m');
-      }
+      const scriptPath = path.join(TARGET_AGENT_DIR, 'scripts', 'memory_tool.py');
+      execSync(`python3 ${scriptPath} list --limit 10`, { stdio: 'inherit' });
     } catch (e) {
-      console.log('\x1b[33m⚠️ Ollama: Chưa cài đặt. Khuyên dùng để chạy model local.\x1b[0m');
+      console.log('\n\x1b[31m❌ Không thể đọc memory. Đã build brain chưa?\x1b[0m');
     }
-
-    // 4. Check Telegram Token (if in .env)
-    if (fs.existsSync(envPath)) {
-      const content = fs.readFileSync(envPath, 'utf-8');
-      if (content.includes('TELEGRAM_BOT_TOKEN') && !content.includes('YOUR_TOKEN_HERE')) {
-        console.log('\x1b[32m✅ Telegram Token: Đã cấu hình\x1b[0m');
-      } else {
-        console.log('\x1b[33m⚠️ Telegram Token: Chưa cấu hình hoặc dùng giá trị mặc định.\x1b[0m');
-      }
-    }
-
-    console.log('\n\x1b[35m✨ Kiểm tra hoàn tất. Hãy đảm bảo IDE và Bot cùng tần số!\x1b[0m');
   });
 
 program.command('status')
-  .description('Check installation status')
+  .description('Xem trạng thái cài đặt')
   .action(() => {
-    console.log('\x1b[36m📊 Trạng thái AG-Kit trong dự án hiện tại:\x1b[0m');
+    console.log('\x1b[36m📊 Trạng thái AG-Kit:\x1b[0m');
     if (fs.existsSync(TARGET_AGENT_DIR)) {
       console.log('\x1b[32m✅ Trạng thái  : Đã Cài Đặt (Active)\x1b[0m');
-      console.log(`📁 Đường dẫn    : ${TARGET_AGENT_DIR}`);
       
       const vPath = path.join(TARGET_AGENT_DIR, '.version');
       let installedVersion = '0.0.0';
       if (fs.existsSync(vPath)) {
         installedVersion = fs.readFileSync(vPath, 'utf-8').trim();
         console.log(`🧠 Bản cài đặt  : v${installedVersion}`);
-      } else {
-        console.log(`🧠 Bản cài đặt  : Không rõ (Legacy)`);
       }
-
-      console.log(`🏷  Bản Tool     : v${pkg.version}`);
       
-      if (installedVersion !== pkg.version) {
-        console.log('\n\x1b[33m⚠️  CẢNH BÁO: Phiên bản bộ não (.agent) đang lệch với bộ công cụ (ag-kit)!\x1b[0m');
-        console.log(`\x1b[35m👉 Hãy chạy "ag-kit update" để đồng bộ ngay.\x1b[0m`);
+      const brainPath = path.join(TARGET_AGENT_DIR, 'brain', 'summary.md');
+      if (fs.existsSync(brainPath)) {
+        console.log(`📚 Nhận thức   : Đã có não (summary.md)`);
+      } else {
+        console.log(`📚 Nhận thức   : \x1b[33mChưa có não. Gõ "ag-kit brain" để tạo.\x1b[0m`);
       }
       
     } else {
-      console.log('\x1b[31m❌ Trạng thái  : Chưa có gì.\x1b[0m');
-      console.log('\x1b[35m👉 Gõ "ag-kit init" để biến thư mục này thành một Agentic Workspace!\x1b[0m');
-      console.log(`🏷  Bản Tool     : v${pkg.version}`);
+      console.log('\x1b[31m❌ Trạng thái  : Dự án Trắng.\x1b[0m');
     }
   });
 
@@ -283,38 +150,49 @@ program.command('status')
 async function runInteractiveMenu() {
   const inquirer = require('inquirer');
   console.clear();
-  console.log('\x1b[35m\n🧠 ANTIGRAVITY KIT - BẢNG ĐIỀU KHIỂN TÁC VỤ\x1b[0m');
+  console.log('\x1b[35m\n🧠 AG-KIT - BẢNG ĐIỀU KHIỂN HỆ SINH THÁI AI\x1b[0m');
   console.log('\x1b[34m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\x1b[0m');
 
+  const hasAgent = fs.existsSync(TARGET_AGENT_DIR);
+  const vPath = path.join(TARGET_AGENT_DIR, '.version');
+  let updateTag = '';
+  if (hasAgent && fs.existsSync(vPath)) {
+    const installed = fs.readFileSync(vPath, 'utf-8').trim();
+    if (installed !== pkg.version) {
+      updateTag = `\x1b[31m(Có bản mới: v${pkg.version})\x1b[0m `;
+    }
+  }
+
+  const choices = hasAgent ? [
+    { name: `🧠 Xây dựng / Cập nhật Bộ Não (build brain) - Thu thập Context`, value: 'brain' },
+    { name: `🕸️ Khám phá Ký ức (memory) - Xem dữ liệu Vector`, value: 'memory' },
+    { name: `🔄 Nâng cấp Kiến thức (update) ${updateTag}`, value: 'update' },
+    { name: '📊 Trạng thái (status) - Xem version & độ nhận thức', value: 'status' },
+    new inquirer.Separator(),
+    { name: '❌ Thoát', value: 'exit' }
+  ] : [
+    { name: '🚀 Khởi tạo (init) - Cấy ghép Tủy Não .agent vào thư mục này', value: 'init' },
+    new inquirer.Separator(),
+    { name: '❌ Thoát', value: 'exit' }
+  ];
+
   const { action } = await inquirer.prompt([
     {
-      type: 'list',
-      name: 'action',
-      message: 'Chọn một tác vụ để thực hiện:',
-      choices: [
-        { name: '🚀 Khởi tạo (init) - Cài đặt .agent', value: 'init' },
-        { name: '🔄 Cập nhật (update) - Nâng cấp bộ não', value: 'update' },
-        { name: '🔍 Kiểm tra (check) - Test môi trường', value: 'check' },
-        { name: '📊 Trạng thái (status) - Xem version', value: 'status' },
-        new inquirer.Separator(),
-        { name: '❌ Thoát', value: 'exit' }
-      ]
+       type: 'list',
+       name: 'action',
+       message: hasAgent ? 'Lõi .agent đã sẵn sàng. Bạn muốn làm gì?' : 'Thư mục trống. Hãy chọn thao tác:',
+       choices: choices
     }
   ]);
 
   if (action === 'exit') {
-    console.log('\x1b[36m👋 Tạm biệt! Hợp tác vui vẻ.\x1b[0m\n');
+    console.log('\x1b[36m👋 Tạm biệt!\x1b[0m\n');
     process.exit(0);
   }
 
-  // Thực thi command
-  console.log('\n\x1b[34m--- ĐANG THỰC THI ---\x1b[0m');
-  
-  // Chúng ta parse lại command với action đã chọn
-  // Lưu ý: commander parse() trả về promise với parseAsync
+  console.log('\n\x1b[34m--- ĐANG THỰC THI ---\x1b[0m\n');
   await program.parseAsync([process.argv[0], process.argv[1], action]);
-  
-  console.log('\n\x1b[34m--- HOÀN TẤT TÁC VỤ ---\x1b[0m');
+  console.log('\n\x1b[34m--- HOÀN TẤT ---\x1b[0m\n');
   
   const { resume } = await inquirer.prompt([
     {
@@ -329,7 +207,7 @@ async function runInteractiveMenu() {
 
 if (process.argv.length <= 2) {
   runInteractiveMenu().catch(err => {
-    console.error('\x1b[31m❌ Lỗi thực thi Menu:\x1b[0m', err);
+    console.error('\x1b[31m❌ Lỗi:\x1b[0m', err);
     process.exit(1);
   });
 } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrtrinhvn/ag-kit",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "Antigravity Kit Base Framework - Generic Agentic AI Programming Core",
   "main": "index.js",
   "bin": {

package/template/.agent/knowledge/USER.md

@@ -0,0 +1,4 @@
+# Shared User Identity & Preferences
+
+This file contains shared knowledge across all projects (coding style, hardware, UI preferences).
+