@mrtrinhvn/ag-kit 1.1.9 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrtrinhvn/ag-kit",
-  "version": "1.1.9",
+  "version": "1.2.0",
   "description": "Antigravity Kit Base Framework - Generic Agentic AI Programming Core",
   "main": "index.js",
   "bin": {
@@ -32,4 +32,4 @@
     "commander": "^14.0.3",
     "inquirer": "^8.2.5"
   }
-}
+}

package/template/.agent/scripts/port_utils.sh

@@ -1,11 +1,13 @@
 #!/bin/bash
 
-# --- Port Management Utility (Golden V4) ---
-# Finds free ports and updates .env to ensure consistent project-wide communication.
+# --- Port Management Utility (Golden V6 - High Precision) ---
+# Tự động quét và thu nạp cổng IDE theo từng dự án.
+# Đảm bảo "Chính chủ" mới dùng, "Người lạ" thì né.
 
 ENV_FILE=".env"
+PROJECT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
 
-# Logic tìm cổng trống
+# 1. Tìm cổng trống dựa trên netstat
 function find_free_port() {
     local port=$1
     while netstat -atn | grep -q ":$port "; do
@@ -14,13 +16,11 @@ function find_free_port() {
     echo $port
 }
 
-# Cập nhật hoặc thêm cổng vào .env
+# 2. Cập nhật .env (Dùng sed tương thích đa hệ điều hành)
 function update_env_port() {
     local key=$1
     local value=$2
-    
     if grep -q "^${key}=" "$ENV_FILE"; then
-        # OS-compatible sed (Linux/macOS)
         if [[ "$OSTYPE" == "darwin"* ]]; then
             sed -i '' "s/^${key}=.*/${key}=${value}/" "$ENV_FILE"
         else
@@ -31,37 +31,75 @@ function update_env_port() {
     fi
 }
 
+# 3. Quét dải cổng để tìm IDE của chính dự án này
+function scan_project_ide() {
+    local start_p=$1
+    local end_p=$2
+    for ((p=start_p; p<=end_p; p++)); do
+        if netstat -atn | grep -q ":$p "; then
+            # Kiểm tra xem có đúng là IDE của dự án này đang ở cổng p không
+            if curl -s "http://127.0.0.1:$p/json" | grep -q "$PROJECT_DIR" > /dev/null 2>&1; then
+                echo $p
+                return 0
+            fi
+        fi
+    done
+    echo ""
+    return 1
+}
+
 # --- Main Logic ---
-# 1. Đọc cổng hiện tại
+
+# Nạp config cũ
 if [ -f "$ENV_FILE" ]; then
     source "$ENV_FILE"
 fi
 
-ORIGINAL_IDE_PORT=${IDE_PORT:-9555}
-ORIGINAL_BRIDGE_PORT=${BRIDGE_PORT:-9556}
+DEFAULT_IDE_START=9555
+IDE_RANGE_END=9655
+BRIDGE_OFFSET=101  # IDE 9555 -> Bridge 9656
 
-# 2. Kiểm tra xung đột (IDE_PORT)
-# Nếu cổng IDE bận, và không phải là do IDE của chính dự án này chiếm giữ (kiểm tra qua /json endpoint)
-PORT_TAKEN=false
-if netstat -atn | grep -q ":$ORIGINAL_IDE_PORT "; then
-    # Kiểm tra xem folder dự án hiện tại có nằm trong danh sách tab/window của IDE không
-    if ! curl -s "http://127.0.0.1:$ORIGINAL_IDE_PORT/json" | grep -q "$PROJECT_DIR" > /dev/null 2>&1; then
-        PORT_TAKEN=true
-    fi
-fi
+CURRENT_CONFIG_IDE=${IDE_PORT:-$DEFAULT_IDE_START}
 
-if [ "$PORT_TAKEN" = true ]; then
-    echo "⚠️  Xung đột PORT phaát hieện! Đang tìm cổng mới..."
-    NEW_IDE_PORT=$(find_free_port $ORIGINAL_IDE_PORT)
-    NEW_BRIDGE_PORT=$(find_free_port $((NEW_IDE_PORT + 1)))
-    
-    update_env_port "IDE_PORT" "$NEW_IDE_PORT"
-    update_env_port "BRIDGE_PORT" "$NEW_BRIDGE_PORT"
+echo "🔍 Đang rà soát "Brain Portal" (Dải 100 cổng) cho dự án: $(basename "$PROJECT_DIR")..."
+
+# Bước 1: Quét xem có IDE nào đang mở dự án này không (Dải 9555 - 9655)
+FOUND_PORT=$(scan_project_ide $DEFAULT_IDE_START $IDE_RANGE_END)
+
+if [ ! -z "$FOUND_PORT" ]; then
+    echo "✅ Phát hiện IDE đang chạy tại cổng: $FOUND_PORT"
+    export IDE_PORT=$FOUND_PORT
+    export BRIDGE_PORT=$((FOUND_PORT + BRIDGE_OFFSET))
     
-    echo "✅ Đã cập nhật .env: IDE_PORT=$NEW_IDE_PORT, BRIDGE_PORT=$NEW_BRIDGE_PORT"
-    export IDE_PORT=$NEW_IDE_PORT
-    export BRIDGE_PORT=$NEW_BRIDGE_PORT
+    # Cập nhật .env nếu có thay đổi
+    if [ "$FOUND_PORT" != "$CURRENT_CONFIG_IDE" ]; then
+        echo "📝 Cập nhật cổng mới vào .env..."
+        update_env_port "IDE_PORT" "$FOUND_PORT"
+        update_env_port "BRIDGE_PORT" "$BRIDGE_PORT"
+    fi
 else
-    export IDE_PORT=$ORIGINAL_IDE_PORT
-    export BRIDGE_PORT=$ORIGINAL_BRIDGE_PORT
+    # Bước 2: Không thấy IDE cũ, kiểm tra cổng trong .env có bị "người lạ" chiếm không
+    echo "❓ Không tìm thấy IDE đang chạy. Tiến hành rà soát cổng khả dụng..."
+    
+    # Nếu cổng hiện tại bị "người lạ" chiếm
+    if netstat -atn | grep -q ":$CURRENT_CONFIG_IDE "; then
+        echo "⚠️  Cổng mặc định $CURRENT_CONFIG_IDE đã bị dự án khác chiếm."
+        # Tìm IDE trống trong dải
+        FREE_IDE=$(find_free_port $DEFAULT_IDE_START)
+        FREE_BRIDGE=$(find_free_port $((FREE_IDE + BRIDGE_OFFSET)))
+        
+        echo "🚀 Đã phân bổ cặp cổng trống mới: IDE=$FREE_IDE, BRIDGE=$FREE_BRIDGE"
+        update_env_port "IDE_PORT" "$FREE_IDE"
+        update_env_port "BRIDGE_PORT" "$FREE_BRIDGE"
+        
+        export IDE_PORT=$FREE_IDE
+        export BRIDGE_PORT=$FREE_BRIDGE
+    else
+        # Cổng trong .env vẫn trống, dùng luôn
+        export IDE_PORT=$CURRENT_CONFIG_IDE
+        # Đảm bảo BRIDGE_PORT tương ứng
+        export BRIDGE_PORT=$((CURRENT_CONFIG_IDE + BRIDGE_OFFSET))
+        update_env_port "BRIDGE_PORT" "$BRIDGE_PORT"
+        echo "✅ Sử dụng cổng cấu hình: $IDE_PORT (Bridge: $BRIDGE_PORT)"
+    fi
 fi

package/template/.agent/scripts/receptionist_down.sh

@@ -1,7 +1,7 @@
 #!/bin/bash
 
-# --- Antigravity Unified Shutdown (Agent-Defined V3) ---
-# Dọn dẹp trạm gác theo Port Isolation.
+# --- Antigravity Unified Shutdown (Golden V6 - High Precision) ---
+# Dọn dẹp trạm gác Agentic.
 
 PROJECT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
 cd "$PROJECT_DIR"
@@ -13,25 +13,27 @@ fi
 BRIDGE_PORT=${BRIDGE_PORT:-9556}
 
 echo "════════════════════════════════════════════════════"
-echo "  🚑 SHUTTING DOWN GATEWAY [$BRIDGE_PORT]..."
+echo "  🛑 SHUTTING DOWN GATEWAY [$BRIDGE_PORT]..."
 echo "════════════════════════════════════════════════════"
 
-# 1. Tắt Portal Bridge (HUD)
+# 1. Tắt Sentinel Monitor
+SENTINEL_PID_FILE=".sentinel_${BRIDGE_PORT}.pid"
+if [ -f "$SENTINEL_PID_FILE" ]; then
+    kill $(cat "$SENTINEL_PID_FILE") 2>/dev/null && rm "$SENTINEL_PID_FILE"
+    echo "✅ Sentinel stopped."
+fi
+
+# 2. Tắt Portal Bridge
 BRIDGE_PID_FILE=".portal_bridge_${BRIDGE_PORT}.pid"
 if [ -f "$BRIDGE_PID_FILE" ]; then
-    PID=$(cat "$BRIDGE_PID_FILE")
-    echo "[1/2] 🧪 Stopping Portal Bridge [$BRIDGE_PORT] (PID: $PID)..."
-    kill $PID 2>/dev/null && rm "$BRIDGE_PID_FILE"
-    echo "      ✅ Bridge stopped."
-else
-    echo "[1/2] 🧪 Portal Bridge on port $BRIDGE_PORT not running."
+    kill $(cat "$BRIDGE_PID_FILE") 2>/dev/null && rm "$BRIDGE_PID_FILE"
+    echo "✅ HUD Bridge stopped."
 fi
 
-# 2. Tắt Docker Backend (Bot)
-echo "[2/2] 🤖 Stopping Receptionist (Docker)..."
-docker compose -f docker-compose.dev.yml stop ck-backend-dev
-echo "      ✅ Bot stopped."
+# 3. Tắt Bot (Tùy chỉnh theo dự án)
+# echo "[3/3] 🤖 Stopping Bot..."
+# [TEMPLATE_NOTE]: Sếp hãy gõ lệnh dừng Bot của mình vào đây.
 
 echo "════════════════════════════════════════════════════"
-echo "✅ SYSTEM IDLE."
+echo "✅ PROJECT IS IDLE."
 echo "════════════════════════════════════════════════════"

package/template/.agent/scripts/receptionist_up.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
 
-# --- Antigravity Unified Receptionist (Agent-Defined V4) ---
+# --- Antigravity Unified Receptionist (Golden V6 - High Precision) ---
 # Trạm gác hợp nhất: Bot + Portal Bridge (HUD) + Monitor Dashboard.
 # Hỗ trợ Đa dự án & Tự động xử lý Cổng (Smart Port Orchestration).
 
@@ -20,16 +20,23 @@ echo "════════════════════════
 echo "  🚑 AGENTIC GATEWAY - PORTAL [$BRIDGE_PORT]"
 echo "════════════════════════════════════════════════════"
 
-# 1. Kiểm tra Cổng IDE (CDP)
+# 2. Kiểm tra/Khởi động IDE (CDP)
 echo -n "[1/4] 🛰️  Checking IDE Portal (Port $IDE_PORT)... "
 if curl -s http://127.0.0.1:$IDE_PORT/json/version > /dev/null; then
     echo "✅ READY."
 else
     echo "❌ NOT FOUND."
-    echo "      👉 Please start Antigravity in Debug mode on port $IDE_PORT"
+    echo "      🚀 Launching Antigravity with CDP on port $IDE_PORT..."
+    nohup antigravity --remote-debugging-port=$IDE_PORT "$PROJECT_DIR" > /dev/null 2>&1 &
+    sleep 3
+    if curl -s http://127.0.0.1:$IDE_PORT/json/version > /dev/null; then
+        echo "      ✅ IDE Launched successfully."
+    else
+        echo "      ⚠️  Could not launch IDE automatically. Please open it manually."
+    fi
 fi
 
-# 2. Khởi động Portal Bridge (HUD Injector)
+# 3. Khởi động Portal Bridge (HUD Injector)
 echo "[2/4] 🧪 Injected Golden HUD Bridge... "
 BRIDGE_PID_FILE=".portal_bridge_${BRIDGE_PORT}.pid"
 
@@ -42,12 +49,37 @@ nohup node scripts/ag_portal_bridge.js > ".portal_bridge_${BRIDGE_PORT}.log" 2>&
 echo $! > "$BRIDGE_PID_FILE"
 echo "      ✅ Bridge running (PID: $(cat "$BRIDGE_PID_FILE") on Port $BRIDGE_PORT)"
 
-# 3. Khởi động Bot (Tùy chỉnh theo dự án)
+# 4. Khởi động Bot (Tùy chỉnh theo dự án)
 echo "[3/4] 🤖 Waking up Agent Bot... "
 # [TEMPLATE_NOTE]: Sếp hãy gõ lệnh khởi động Bot của mình vào đây.
-# Ví dụ: docker compose up -d (nếu dùng docker) hoặc npx tsx src/index.ts (nếu dùng local)
 echo "      ⚠️  Vui lòng cấu hình lệnh khởi động Bot trong .agent/scripts/receptionist_up.sh"
 
-# 4. Monitor
-echo "[4/4] 📊 Ready."
+# 5. Sentinel Monitor (Giám sát Trí não)
+echo "[4/4] 🛡️  Sentinel Active: Auto-shutdown if IDE connection lost."
+SENTINEL_PID_FILE=".sentinel_${BRIDGE_PORT}.pid"
+
+function start_sentinel() {
+    (
+        local fail_count=0
+        while true; do
+            sleep 30
+            if ! curl -s "http://127.0.0.1:$IDE_PORT/json" | grep -q "$PROJECT_DIR" > /dev/null 2>&1; then
+                fail_count=$((fail_count + 1))
+                if [ $fail_count -ge 3 ]; then
+                    echo "$(date): ⚠️ IDE Lost. Auto-shutting down project..." >> .sentinel_crash.log
+                    bash .agent/scripts/receptionist_down.sh
+                    exit 0
+                fi
+            else
+                fail_count=0
+            fi
+        done
+    ) &
+    echo $! > "$SENTINEL_PID_FILE"
+}
+start_sentinel
+
+# Monitor
 echo "----------------------------------------------------"
+echo "✅ SYNC COMPLETE. PORTAL IS BROADCASTING."
+# tail -f interaction_final.log