@mrtrinhvn/ag-kit 1.1.4 → 1.1.5

package/README.md

@@ -4,8 +4,14 @@ A generic, institutional-grade AI programming framework for automating scaffoldi
 
 ## 📦 Quick Start
 
-The best way to inject AG-Kit into any project is via `npx`:
+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**:
 
+```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ẻ:
 ```bash
 # 1. Khởi tạo bộ não (Inject .agent folder)
 npx @mrtrinhvn/ag-kit@latest init
@@ -23,6 +29,7 @@ npx @mrtrinhvn/ag-kit@latest status
 
 | Lệnh | Ý nghĩa | Chi tiết |
 |---|---|---|
+| `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. |
@@ -66,7 +73,8 @@ npx @mrtrinhvn/ag-kit@latest update
 
 **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 hoặc chạy `sudo npm install -g @mrtrinhvn/ag-kit@latest`.
+- 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`.

package/bin/cli.js

@@ -90,7 +90,18 @@ program.command('init')
         }
       }
     } else {
-      console.log('\x1b[33m⚠️ Thư mục .agent đã tồn tại. Hãy dùng lệnh "update" để cập nhật.\x1b[0m');
+      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`);
+        } 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');
@@ -127,6 +138,12 @@ program.command('check')
   .action(async () => {
     const { execSync } = require('child_process');
     console.log('\x1b[36m🔍 Đang kiểm tra hệ sinh thái Antigravity...\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');
+      return;
+    }
 
     // 1. Check .env
     const envPath = path.join(process.cwd(), '.env');
@@ -203,8 +220,9 @@ program.command('status')
       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)) {
-        const installedVersion = fs.readFileSync(vPath, 'utf-8').trim();
+        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)`);
@@ -212,10 +230,41 @@ program.command('status')
 
       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`);
+      }
+      
     } else {
-      console.log('\x1b[31m❌ Trạng thái  : Chưa có gì. Gõ "ag-kit init" để Setup.\x1b[0m');
+      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}`);
     }
   });
 
-program.parse(process.argv);
+
+if (process.argv.length <= 2) {
+  const inquirer = require('inquirer');
+  console.log('\x1b[35m\n🧠 ANTIGRAVITY KIT - BẢNG ĐIỀU KHIỂN TÁC VỤ\x1b[0m');
+  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' }
+      ]
+    }
+  ]).then(answers => {
+    if (answers.action !== 'exit') {
+      program.parse([process.argv[0], process.argv[1], answers.action]);
+    }
+  });
+} else {
+  program.parse(process.argv);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrtrinhvn/ag-kit",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "description": "Antigravity Kit Base Framework - Generic Agentic AI Programming Core",
   "main": "index.js",
   "bin": {
@@ -29,6 +29,7 @@
     "package.json"
   ],
   "dependencies": {
-    "commander": "^14.0.3"
+    "commander": "^14.0.3",
+    "inquirer": "^8.2.5"
   }
 }