@mrtrinhvn/ag-kit 1.1.9 → 1.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrtrinhvn/ag-kit",
-  "version": "1.1.9",
+  "version": "1.3.1",
   "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/.version

@@ -0,0 +1 @@
+1.1.5

package/template/.agent/agents/orchestrator.md

@@ -30,8 +30,6 @@ You are the master orchestrator agent. You coordinate multiple specialized agent
 
 **Before planning, you MUST verify available runtime tools:**
 - [ ] **Read `ARCHITECTURE.md`** to see full list of Scripts & Skills
-- [ ] **Check `tele-agentic-standard.md`** for Remote Golden Loop awareness.
-- [ ] **Verify IDE HUD status**: If `ag_portal_bridge.js` is active, use it for real-time reporting.
 - [ ] **Identify relevant scripts** (e.g., `playwright_runner.py` for web, `security_scan.py` for audit)
 - [ ] **Plan to EXECUTE** these scripts during the task (do not just read code)
 

package/template/.agent/knowledge/ag-kit-elite.md

@@ -0,0 +1,22 @@
+# Ag-Kit Elite: Next-Generation Agentic Standards
+
+This document defines the advanced agentic standards for Antigravity, synthesized from global top-rated repositories (Aider, OpenHands, Eigent, Continue).
+
+## 1. Context & Search Layer (The "Eyes")
+- **Repo Mapping**: Use `.agent/scripts/repomap.py` to get a structural skeleton of the codebase. This is MANDATORY for large-scale refactoring.
+- **Semantic Search**: Use the `semantic-search` skill for conceptual discovery when keywords aren't enough.
+
+## 2. Orchestration & Thinking (The "Brain")
+- **8-Stage Pipeline**: Follow the **INTAKE → RESEARCH → PLANNING → GENERATION → INTEGRATION → VERIFICATION → REFINEMENT → SHIP** cycle for all `/create` tasks.
+- **AgentResult**: Every skill and agent MUST return a standardized JSON result for inter-agent reliability.
+
+## 3. Autonomous Execution (The "Hands")
+- **CodeAct Paradigm**: Use `codeact-executor` to write and run scripts in `/tmp` to resolve complex diagnostics before applying fixes.
+- **TDD Loop**: Always run tests and fix autonomously using the 8-stage refinement loop.
+
+## 4. Infrastructure & Accessibility (The "Command Center")
+- **Headless Mode**: Run Antigravity in the background for purely agentic workloads.
+- **Remote QR Access**: Use the Cloudflare Tunnel and QR auto-login for 0-config mobile/remote control.
+
+---
+> *Antigravity Elite: Synthesized Intelligence for High-Precision Development.*

package/template/.agent/knowledge/model-switching-vfs.md

@@ -1,22 +1,22 @@
-# Tiết Kiệm Token & Chiến Lược Mô Hình (Model & VFS)
+78# Tiết Kiệm Token & Quản Lý Mô Hình (Model & VFS Knowledge)
 
-Tiết kiệm tài nguyên là yếu tố sống còn khi vận hành AI Agentic lâu dài. Hệ thống tuân thủ nghiêm ngặt các nguyên tắc sau:
+## 1. Cơ Chế Tiết Kiệm Token
+Trong môi trường điều khiển từ xa (Telegram), việc tối ưu hóa token là cực kỳ quan trọng để duy trì hiệu suất và chi phí.
 
-## 1. Giao Thức VFS (Virtual File System)
-Dựa trên sáng kiến [VFS của TrNgTien](https://github.com/TrNgTien/vfs), chúng ta thay đổi cách AI tiếp cận mã nguồn:
-- **Tác dụng**: Giảm lượng token tiêu thụ lên đến **98%** khi khám phá project lớn.
-- **Quyết định**: AI KHÔNG ĐƯỢC đọc toàn bộ file ngay lập tức. Thay vào đó, AI dùng công cụ `vfs` để quét các "chữ ký" (signatures - tên hàm, lớp, kiểu dữ liệu) trước.
-- **Thứ tự thực hiện**: `vfs search` -> `vfs read signature` -> `read file (chỉ vùng code cần thiết)`.
+### VFS (Virtual File System)
+- **Tác dụng**: Giảm 98% lượng token khi khám phá mã nguồn.
+- **Cách hoạt động**: Thay vì đọc toàn bộ file, AI sử dụng công cụ `vfs` để chỉ lấy chữ ký (signatures) của hàm và lớp.
+- **Quy tắc**: Phải luôn sử dụng `vfs` trước khi dùng `grep` hoặc đọc file đầy đủ. (Xem `GEMINI.md`).
 
-## 2. Phân Tầng Lựa Chọn Mô Hình (Model Hierarchy)
-Hệ thống sử dụng model phù hợp với "độ khó" của bệnh:
+## 2. Chiến Lược Lựa Chọn Mô Hình (Model Strategy)
+Hệ thống sử dụng cơ chế "Phân tầng độ khó" để chọn model:
 
-| Cấp độ | Tác vụ | Mô hình khuyến nghị | Ưu điểm |
+| Độ khó | Tác vụ | Mô hình khuyến nghị | Lý do |
 | :--- | :--- | :--- | :--- |
-| **Sơ cấp** | Giải thích code, Chat hỏi đáp, Refactor nhỏ | **Ollama (Local)** | 0 token cost, Bảo mật, Phản hồi tức thì. |
-| **Trung cấp** | Fix lỗi thông thường, Thêm tính năng đơn giản | **Gemini 3 Flash** | Chi phí thấp, Context window cực lớn. |
-| **Nâng cao** | Thiết kế kiến trúc phức tạp, Debug lỗi logic sâu | **Claude 3.5 Sonnet / Gemini 1.5 Pro** | Độ chính xác và khả năng suy luận mạnh nhất. |
+| **Thấp** | Giải thích code, Refactor nhỏ, Chat thông thường | **Ollama (Local)** | Không tốn quota, phản hồi nhanh cho tác vụ đơn giản. |
+| **Trung bình** | Fix lỗi, Thêm tính năng mới | **Gemini 3 Flash** | Cân bằng giữa chi phí và độ thông minh. |
+| **Cao** | Thiết kế kiến trúc, Debug lỗi phức tạp | **Claude 3.5 Sonnet / Gemini 1.5 Pro** | Độ chính xác cao nhất cho các vấn đề hóc búa. |
 
-## 3. Tích Hợp Local LLM (Ollama)
-- Cho phép Bot kết nối trực tiếp với Ollama (thường ở `http://localhost:11434`).
-- Thường sử dụng các model nhẹ nhưng hiệu quả như `nemotron`, `llama3`, `qwen2.5`.
+## 3. Tích Hợp Local Model (Ollama)
+- Bot kết nối trực tiếp với Ollama API tại `http://localhost:11434`.
+- Người dùng có thể chọn dùng model local qua lệnh `/model` để "đóng băng" quota Google khi không cần thiết.

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,76 @@ 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
+            PROJECT_NAME=$(basename "$PROJECT_DIR")
+            if curl -s "http://127.0.0.1:$p/json" | grep -q "$PROJECT_NAME" > /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 CEOgravity.
 
 PROJECT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
 cd "$PROJECT_DIR"
@@ -10,28 +10,36 @@ if [ -f .env ]; then
     source .env
 fi
 
-BRIDGE_PORT=${BRIDGE_PORT:-9556}
+BRIDGE_PORT=${BRIDGE_PORT:-9558}
 
 echo "════════════════════════════════════════════════════"
-echo "  🚑 SHUTTING DOWN GATEWAY [$BRIDGE_PORT]..."
+echo "  🛑 SHUTTING DOWN CEOGRAVITY [$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
+BOT_PID_FILE=".ceogravity_bot.pid"
+if [ -f "$BOT_PID_FILE" ]; then
+    PID=$(cat "$BOT_PID_FILE")
+    # Kill the whole process group for the bash loop
+    pkill -P $PID
+    kill $PID 2>/dev/null && rm "$BOT_PID_FILE"
+    echo "✅ CEOgravity Bot stopped."
+fi
 
 echo "════════════════════════════════════════════════════"
-echo "✅ SYSTEM IDLE."
+echo "✅ CEOGRAVITY IS IDLE."
 echo "════════════════════════════════════════════════════"

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

@@ -1,8 +1,8 @@
 #!/bin/bash
 
-# --- Antigravity Unified Receptionist (Agent-Defined V4) ---
-# 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).
+# --- Antigravity Unified Receptionist (Golden V6 - High Precision) ---
+# Trạm gác hợp nhất: CEOgravity Bot + Portal Bridge (HUD)
+# Dự án: CEOgravity — Startup Orchestrator
 
 # 1. Load Cấu hình & Xử lý Cổng Thông minh
 PROJECT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
@@ -12,42 +12,145 @@ if [ -f .agent/scripts/port_utils.sh ]; then
     source .agent/scripts/port_utils.sh
 else
     source .env
-    export IDE_PORT=${IDE_PORT:-9555}
-    export BRIDGE_PORT=${BRIDGE_PORT:-9556}
+    export IDE_PORT=${IDE_PORT:-9557}
+    export BRIDGE_PORT=${BRIDGE_PORT:-9658}
 fi
 
 echo "════════════════════════════════════════════════════"
-echo "  🚑 AGENTIC GATEWAY - PORTAL [$BRIDGE_PORT]"
+echo "  🏢 CEOGRAVITY GATEWAY - PORTAL [$BRIDGE_PORT]"
 echo "════════════════════════════════════════════════════"
 
-# 1. Kiểm tra Cổng IDE (CDP)
-echo -n "[1/4] 🛰️  Checking IDE Portal (Port $IDE_PORT)... "
+# 2. Xử lý Chế độ Headless & Cloudflare Tunnel
+HEADLESS=false
+TUNNEL=false
+for arg in "$@"; do
+    if [ "$arg" == "--headless" ]; then HEADLESS=true; fi
+    if [ "$arg" == "--tunnel" ]; then TUNNEL=true; fi
+done
+
+# 3. Kiểm tra/Khởi động IDE
+echo -n "[2/4] 🛰️  Checking IDE Portal (Port $IDE_PORT)... "
 if curl -s http://127.0.0.1:$IDE_PORT/json/version > /dev/null; then
     echo "✅ READY."
+    if [ "$HEADLESS" != true ]; then
+        echo "      🔄 Attempting to wake/focus UI..."
+        # Cố gắng push UI lên (nếu đang ngầm)
+        antigravity "$PROJECT_DIR" > /dev/null 2>&1 &
+        
+        if [ -t 0 ]; then
+            echo -n "      🤔 Did the IDE window appear? [Y/n] (Auto-yes in 5s): "
+            read -t 5 -n 1 user_input
+            echo ""
+            user_input=${user_input:-Y}
+        else
+            user_input="Y"
+        fi
+        
+        if [[ "$user_input" =~ ^[Nn]$ ]]; then
+            echo "      💀 UI Failed. Killing specific phantom instance for this project..."
+            # Chỉ kill những process chứa flag remote và project hiện tại
+            pkill -f "antigravity.*--remote-debugging-port=$IDE_PORT"
+            pkill -f "antigravity.*$PROJECT_DIR"
+            sleep 2
+            echo "      🚀 Launching fresh Antigravity with UI on port $IDE_PORT..."
+            nohup antigravity --remote-debugging-port=$IDE_PORT "$PROJECT_DIR" > /dev/null 2>&1 &
+            sleep 5
+        fi
+    fi
 else
     echo "❌ NOT FOUND."
-    echo "      👉 Please start Antigravity in Debug mode on port $IDE_PORT"
+    if [ "$HEADLESS" = true ]; then
+        echo "      🚀 Launching Antigravity in HEADLESS mode on port $IDE_PORT..."
+        nohup antigravity --server --remote-debugging-port=$IDE_PORT "$PROJECT_DIR" > /dev/null 2>&1 &
+    else
+        echo "      🚀 Launching Antigravity with UI on port $IDE_PORT..."
+        nohup antigravity --remote-debugging-port=$IDE_PORT "$PROJECT_DIR" > /dev/null 2>&1 &
+    fi
+    sleep 5
 fi
 
-# 2. Khởi động Portal Bridge (HUD Injector)
-echo "[2/4] 🧪 Injected Golden HUD Bridge... "
-BRIDGE_PID_FILE=".portal_bridge_${BRIDGE_PORT}.pid"
+# 4. Cloudflare Tunnel & QR Code (If requested)
+if [ "$TUNNEL" = true ]; then
+    echo "[T] 🌐 Starting Cloudflare Tunnel..."
+    if ! command -v cloudflared &> /dev/null; then
+        echo "      ❌ Error: cloudflared not installed."
+    else
+        nohup cloudflared tunnel --url http://127.0.0.1:$BRIDGE_PORT > .tunnel.log 2>&1 &
+        sleep 5
+        TUNNEL_URL=$(grep -o 'https://.*\.trycloudflare\.com' .tunnel.log | head -n 1)
+        if [ -n "$TUNNEL_URL" ]; then
+            echo "      ✅ Tunnel Active: $TUNNEL_URL"
+            echo "      📱 Generating QR Code..."
+            python3 -c "import qrcode; qr = qrcode.QRCode(); qr.add_data('$TUNNEL_URL'); qr.print_ascii()"
+        else
+            echo "      ⚠️  Could not extract tunnel URL. Check .tunnel.log"
+        fi
+    fi
+fi
+echo "✅ READY."
 
-# Tắt bridge cũ nếu đang chạy trên port này
+# 3. Khởi động Portal Bridge (HUD Injector)
+echo "[3/4] 🧪 Injected Golden HUD Bridge... "
+BRIDGE_PID_FILE=".portal_bridge_${BRIDGE_PORT}.pid"
 if [ -f "$BRIDGE_PID_FILE" ]; then
     kill $(cat "$BRIDGE_PID_FILE") 2>/dev/null
 fi
-
 nohup node scripts/ag_portal_bridge.js > ".portal_bridge_${BRIDGE_PORT}.log" 2>&1 &
 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)
-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. Khởi động CEOgravity Bot (Local TSX)
+echo "[4/4] 🤖 Waking up CEOgravity Bot... "
+BOT_PID_FILE=".ceogravity_bot.pid"
+
+# Kill loop AND all tsx/node processes belonging to this token/project
+pkill -f "tsx src/index.ts" 2>/dev/null
+pkill -f "node src/index.ts" 2>/dev/null
+pkill -f "interaction_final.log" 2>/dev/null
+if [ -f "$BOT_PID_FILE" ]; then
+    kill -9 $(cat "$BOT_PID_FILE") 2>/dev/null
+fi
+sleep 2
+
+# Start the bot with a more robust monitor
+nohup bash -c "while true; do 
+    echo \"\$(date): Starting Bot...\" >> interaction_final.log
+    npx tsx src/index.ts >> interaction_final.log 2>&1
+    EXIT_CODE=\$?
+    if [ \$EXIT_CODE -eq 0 ]; then break; fi # Exit loop if deliberate stop
+    echo \"\$(date): Bot crashed (Code: \$EXIT_CODE). Restarting in 5s...\" >> interaction_final.log
+    sleep 5
+done" &
+echo $! > "$BOT_PID_FILE"
+echo "      ✅ Bot active (PID: $(cat "$BOT_PID_FILE"))"
+
+# 5. Sentinel Monitor (Giám sát Trí não)
+echo "🛡️  Sentinel Active: Auto-shutdown if IDE connection lost."
+SENTINEL_PID_FILE=".sentinel_${BRIDGE_PORT}.pid"
+
+function start_sentinel() {
+    (
+        local fail_count=0
+        local PROJ_NAME=$(basename "$PROJECT_DIR")
+        # Give more time for the first check
+        sleep 60
+        while true; do
+            if ! curl -s "http://127.0.0.1:$IDE_PORT/json" | grep -q "$PROJ_NAME" > /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
 
-# 4. Monitor
-echo "[4/4] 📊 Ready."
+# Monitor
 echo "----------------------------------------------------"
+tail -f interaction_final.log

package/template/.agent/scripts/repomap.py

@@ -0,0 +1,126 @@
+import os
+import sys
+from pathlib import Path
+from tree_sitter_languages import get_language, get_parser
+
+class RepoMapper:
+    def __init__(self, root_dir):
+        self.root_dir = Path(root_dir).absolute()
+        self.parsers = {}
+        self.languages = {}
+
+    def get_parser(self, lang_name):
+        if lang_name not in self.parsers:
+            try:
+                lang = get_language(lang_name)
+                parser = get_parser(lang_name)
+                self.parsers[lang_name] = parser
+                self.languages[lang_name] = lang
+            except Exception as e:
+                return None
+        return self.parsers[lang_name]
+
+    def get_lang_from_ext(self, ext):
+        mapping = {
+            '.py': 'python',
+            '.js': 'javascript',
+            '.ts': 'typescript',
+            '.tsx': 'typescript',
+            '.jsx': 'javascript',
+            '.go': 'go',
+            '.rs': 'rust',
+            '.java': 'java',
+            '.cpp': 'cpp',
+            '.c': 'c',
+            '.sh': 'bash'
+        }
+        return mapping.get(ext)
+
+    def extract_symbols(self, file_path):
+        ext = Path(file_path).suffix
+        lang_name = self.get_lang_from_ext(ext)
+        if not lang_name: return []
+
+        parser = self.get_parser(lang_name)
+        if not parser: return []
+
+        try:
+            with open(file_path, 'r', encoding='utf-8') as f:
+                content = f.read()
+        except: return []
+
+        tree = parser.parse(bytes(content, 'utf-8'))
+        
+        # Simple query for definitions (classes, functions)
+        # Standard tree-sitter tags usually include:
+        # (class_definition name: (identifier) @name)
+        # (function_definition name: (identifier) @name)
+        
+        symbols = []
+        
+        # This is a very simplified query. In production, we'd use language-specific SCM files.
+        query_text = """
+            (class_definition name: (identifier) @name) @cap
+            (function_definition name: (identifier) @name) @cap
+            (method_definition name: (property_identifier) @name) @cap
+            (arrow_function) @cap
+        """
+        if lang_name == 'typescript' or lang_name == 'javascript':
+            query_text = """
+                (class_definition name: [(identifier) (type_identifier)] @name) @cap
+                (function_definition name: (identifier) @name) @cap
+                (method_definition name: (property_identifier) @name) @cap
+                (variable_declarator name: (identifier) @name value: [(arrow_function) (function_expression)]) @cap
+            """
+        elif lang_name == 'python':
+            query_text = """
+                (class_definition name: (identifier) @name) @cap
+                (function_definition name: (identifier) @name) @cap
+            """
+
+        try:
+            query = self.languages[lang_name].query(query_text)
+            captures = query.captures(tree.root_node)
+            
+            for node, tag in captures:
+                if tag == 'name':
+                    line = node.start_point[0] + 1
+                    symbols.append(f"{node.text.decode('utf-8')} (L{line})")
+        except:
+            pass
+            
+        return symbols
+
+    def generate_map(self, max_files=100):
+        repo_map = []
+        count = 0
+        for root, dirs, files in os.walk(self.root_dir):
+            if any(p in root for p in ['.git', 'node_modules', '__pycache__', '.aider']):
+                continue
+            
+            rel_root = os.path.relpath(root, self.root_dir)
+            if rel_root == '.': rel_root = ''
+            
+            for file in files:
+                if count >= max_files: break
+                if file.startswith('.') or file.endswith(('.pyc', '.o', '.a', '.so')): continue
+                
+                full_path = Path(root) / file
+                rel_path = os.path.join(rel_root, file)
+                
+                symbols = self.extract_symbols(full_path)
+                if symbols:
+                    repo_map.append(f"|-- {rel_path}")
+                    for sym in symbols[:10]: # Limit symbols per file
+                        repo_map.append(f"|   |-- {sym}")
+                else:
+                    repo_map.append(f"|-- {rel_path}")
+                
+                count += 1
+                    
+        return "\n".join(repo_map)
+
+if __name__ == "__main__":
+    root = sys.argv[1] if len(sys.argv) > 1 else "."
+    mapper = RepoMapper(root)
+    print(mapper.generate_map())