@mrtrinhvn/ag-kit 1.4.0 → 1.4.3

package/README.md

@@ -21,6 +21,9 @@ npx @mrtrinhvn/ag-kit@latest brain
 
 # 3. Tra cứu Vector Memory (Xem các node đã lưu)
 npx @mrtrinhvn/ag-kit@latest memory
+
+# 4. Kiểm tra cửa ngõ IDE, Telegram Bot (Dành cho project dùng bot)
+npx @mrtrinhvn/ag-kit@latest gateway
 ```
 
 ---
@@ -33,6 +36,7 @@ npx @mrtrinhvn/ag-kit@latest memory
 | `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 gateway` | **Bot Test** | (Tùy chọn) Quét cổng CDP (IDE), Ollama và Telegram Bot Token cho các dự án dùng Agentic bot. |
 | `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. |
 

package/bin/cli.js

@@ -120,6 +120,52 @@ program.command('memory')
     }
   });
 
+program.command('gateway')
+  .description('Kiểm tra trạng thái Agentic Gateway (IDE, Ollama, Telegram)')
+  .action(() => {
+    console.log('\x1b[36m🤖 Đang kiểm tra hệ sinh thái Agentic Gateway...\x1b[0m');
+    if (!fs.existsSync(TARGET_AGENT_DIR)) {
+      console.log('\x1b[31m❌ Chưa cấy ghép .agent.\x1b[0m');
+      return;
+    }
+    const envPath = path.join(process.cwd(), '.env');
+    let targetPort = null;
+    if (fs.existsSync(envPath)) {
+      const match = fs.readFileSync(envPath, 'utf-8').match(/IDE_PORT=(\d+)/);
+      if (match) targetPort = parseInt(match[1]);
+    }
+    
+    if (targetPort) {
+      try { 
+        execSync(`curl -s --max-time 2 http://127.0.0.1:${targetPort}/json/version`, { stdio: 'ignore' }); 
+        console.log(`\x1b[32m✅ IDE CDP: Cổng riêng của dự án (${targetPort}) đang Online!\x1b[0m`); 
+      } catch (e) {
+        console.log(`\x1b[31m❌ IDE CDP: Cổng dự án (${targetPort}) Offline. Hãy chạy IDE với port này.\x1b[0m`);
+      }
+    } else {
+      console.log(`\x1b[33m⚠️ IDE CDP: Không tìm thấy IDE_PORT trong .env. Khuyên dùng "ag-kit init" để cấp port.\x1b[0m`);
+    }
+    
+    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'); 
+      } catch (e) { 
+        console.log('\x1b[31m❌ Ollama Service: Offline\x1b[0m'); 
+      }
+    } catch(e) { 
+      console.log('\x1b[33m⚠️ Ollama: Chưa cài đặt.\x1b[0m'); 
+    }
+    
+    if (fs.existsSync(envPath) && fs.readFileSync(envPath, 'utf-8').includes('TELEGRAM_BOT_TOKEN=')) {
+      console.log('\x1b[32m✅ Telegram Token: Có trong .env\x1b[0m');
+    } else {
+      console.log('\x1b[33m⚠️ Telegram Token: Chưa cấu hình\x1b[0m');
+    }
+  });
+
 program.command('status')
   .description('Xem trạng thái cài đặt')
   .action(() => {
@@ -166,6 +212,7 @@ async function runInteractiveMenu() {
   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: `🤖 Kiểm tra Agentic Gateway (gateway) - Test IDE/Bot`, value: 'gateway' },
     { 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(),

package/package.json

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

package/template/.agent/skills/telegram-agentic-gateway/templates/start.sh.template

@@ -1,12 +1,37 @@
 #!/bin/bash
-# 🏢 Agentic Gateway - Startup Orchestrator
-# Golden Combo Edition (V3)
+# start.sh - Hệ thống Quản trị Khởi động (Agentic Port Fusion)
 
 # 1. Load config
 if [ -f .env ]; then
     source .env
+else
+    echo "❌ Lỗi: Không tìm thấy file .env. Vui lòng tạo dựa trên .env.example"
+    exit 1
 fi
 
-# 2. Khởi động Giao diện & Agent (Agent-Defined)
-echo "🚀 Activating Agentic Gateway Portal..."
+PORT=${IDE_PORT:-9555}
+
+echo "🔍 Đang kiểm tra IDE tại cổng $PORT..."
+
+# 2. Logic Hợp thể & Mở mới linh hoạt
+if nc -z 127.0.0.1 $PORT &>/dev/null; then
+    echo "✅ [HỢP THỂ]: Đã tìm thấy một IDE đang chạy riêng cho dự án ở cổng $PORT. Đang cắm ngầm Bot vào..."
+else
+    echo "⚠️ [MỞ MỚI]: Không tìm thấy IDE ở cổng $PORT. Đang tự động phóng một IDE mới chuyên biệt cho dự án này..."
+    
+    if command -v cursor &> /dev/null; then
+        cursor --remote-debugging-port=$PORT . &
+    elif command -v code &> /dev/null; then
+        code --remote-debugging-port=$PORT . &
+    else
+        echo "❌ Lỗi: Không tìm thấy lệnh 'cursor' hoặc 'code' trong cửa sổ lệnh."
+        echo "👉 Hãy tự mở IDE bằng tay cho thư mục này bằng lệnh: cursor --remote-debugging-port=$PORT ."
+    fi
+    
+    echo "⏳ Đang đợi IDE kích hoạt cổng CDP..."
+    sleep 4
+fi
+
+# 3. Khởi động Giao diện & Agent (Receptionist)
+echo "🚀 Đang đánh thức bộ não Agentic Gateway..."
 bash .agent/scripts/receptionist_up.sh

package/template/start.sh

@@ -1,22 +1,37 @@
 #!/bin/bash
-# start.sh - Khởi động Cổng Agentic (Remoat + LazyGravity standard)
+# start.sh - Hệ thống Quản trị Khởi động (Agentic Port Fusion)
 
-# 1. Kiểm tra .env
-if [ ! -f .env ]; then
+# 1. Load config
+if [ -f .env ]; then
+    source .env
+else
     echo "❌ Lỗi: Không tìm thấy file .env. Vui lòng tạo dựa trên .env.example"
     exit 1
 fi
 
-# 2. Đọc cấu hình
-source .env
+PORT=${IDE_PORT:-9555}
 
-# 3. Khởi động IDE ở chế độ Debug (nếu chưa chạy)
-# Lưu ý: User nên chạy ./launch_remote_ide.sh trước hoặc script này sẽ kiểm tra port
-nc -z localhost ${IDE_PORT:-9555}
-if [ $? -ne 0 ]; then
-    echo "⚠️ Cảnh báo: Cổng CDP ${IDE_PORT:-9555} chưa mở. Đang chờ Antigravity khởi động..."
+echo "🔍 Đang kiểm tra IDE tại cổng $PORT..."
+
+# 2. Logic Hợp thể & Mở mới linh hoạt
+if nc -z 127.0.0.1 $PORT &>/dev/null; then
+    echo "✅ [HỢP THỂ]: Đã tìm thấy một IDE đang chạy riêng cho dự án ở cổng $PORT. Đang cắm ngầm Bot vào..."
+else
+    echo "⚠️ [MỞ MỚI]: Không tìm thấy IDE ở cổng $PORT. Đang tự động phóng một IDE mới chuyên biệt cho dự án này..."
+    
+    if command -v cursor &> /dev/null; then
+        cursor --remote-debugging-port=$PORT . &
+    elif command -v code &> /dev/null; then
+        code --remote-debugging-port=$PORT . &
+    else
+        echo "❌ Lỗi: Không tìm thấy lệnh 'cursor' hoặc 'code' trong Terminal này."
+        echo "👉 Hãy tự mở IDE bằng tay cho thư mục này bằng lệnh: \cursor --remote-debugging-port=$PORT .\ "
+    fi
+    
+    echo "⏳ Đang đợi IDE kích hoạt cổng CDP..."
+    sleep 4
 fi
 
-# 4. Khởi động Bridge và Bot (Agent-Defined)
-echo "🚀 Khởi động Lễ tân trực chiến (Agentic Gateway)..."
+# 3. Khởi động Giao diện & Agent (Receptionist)
+echo "🚀 Đang đánh thức bộ não Agentic Gateway..."
 bash .agent/scripts/receptionist_up.sh