antigravity-ide 4.2.1 → 4.3.3

package/cli/tools/browser.js

@@ -0,0 +1,75 @@
+const { chromium } = require('playwright');
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * 🤖 Browser Subagent Core
+ * Module gốc phục vụ cho hệ thống Antigravity Agent-First
+ * Hỗ trợ giao tiếp trực tiếp với DOM và Vision.
+ */
+class BrowserSubagent {
+    constructor() {
+        this.browser = null;
+        this.page = null;
+    }
+
+    async init(headless = true) {
+        if (!this.browser) {
+            // Sử dụng Chromium core từ Playwright cho Sandbox mặc định
+            this.browser = await chromium.launch({ headless });
+            this.page = await this.browser.newPage();
+            // Thiết lập tỷ lệ màn hình tiêu chuẩn cho Vision check
+            await this.page.setViewportSize({ width: 1280, height: 800 });
+        }
+    }
+
+    async goto(url) {
+        await this.init();
+        const response = await this.page.goto(url, { waitUntil: 'networkidle' });
+        return {
+            status: response.status(),
+            url: this.page.url()
+        };
+    }
+
+    async readDOM(selector = 'body') {
+        if (!this.page) throw new Error('Trình duyệt chưa được Agent khởi tạo. Gọi goto() trước.');
+        // Rút trích DOM thành văn bản thuần, lược bỏ các tag thừa
+        const domContent = await this.page.$eval(selector, el => el.innerText);
+        return domContent.trim();
+    }
+
+    async type(selector, text) {
+        if (!this.page) throw new Error('Trình duyệt chưa được khởi tạo.');
+        await this.page.fill(selector, text);
+        return `✅ Đã nhập text vào [${selector}]`;
+    }
+
+    async click(selector) {
+        if (!this.page) throw new Error('Trình duyệt chưa được khởi tạo.');
+        await this.page.click(selector);
+        await this.page.waitForLoadState('networkidle');
+        return `✅ Đã tương tác click vào [${selector}]`;
+    }
+
+    async captureScreenshot(name = 'vision-check') {
+        if (!this.page) throw new Error('Trình duyệt chưa được khởi tạo.');
+        
+        const outDir = path.join(process.cwd(), '.agent', 'vision');
+        if (!fs.existsSync(outDir)) fs.mkdirSync(outDir, { recursive: true });
+        
+        const filePath = path.join(outDir, `${name}-${Date.now()}.png`);
+        await this.page.screenshot({ path: filePath, fullPage: true });
+        return filePath;
+    }
+
+    async close() {
+        if (this.browser) {
+            await this.browser.close();
+            this.browser = null;
+            this.page = null;
+        }
+    }
+}
+
+module.exports = { BrowserSubagent };

package/cli/ui/dashboard.js

@@ -0,0 +1,48 @@
+const chalk = require('chalk');
+const boxen = require('boxen');
+
+async function launchManagerView(projectDir) {
+    console.clear();
+    
+    const title = chalk.cyan.bold('🌌 Antigravity IDE • Manager View (Agent-First Mode)');
+    
+    // Giả lập trạng thái các Agent đang hoạt động
+    const agents = [
+        { name: 'orchestrator', status: chalk.green('IDLE'), task: '-' },
+        { name: 'frontend-specialist', status: chalk.blue('WORKING'), task: 'TSK-001: Lên khung Dashboard' },
+        { name: 'browser-subagent', status: chalk.yellow('WAITING'), task: 'DOM Analysis (Pending)' },
+        { name: 'security-auditor', status: chalk.green('IDLE'), task: '-' }
+    ];
+
+    const render = () => {
+        console.clear();
+        console.log(boxen(title, { padding: 1, borderColor: 'cyan', borderStyle: 'double', textAlignment: 'center', width: 70 }));
+        console.log('\n' + chalk.bold.white('👥 Active Agent Swarm:\n'));
+
+        agents.forEach(a => {
+            console.log(`  [${a.status.padEnd(18)}] ${chalk.bold(a.name.padEnd(20))} | ${chalk.gray(a.task)}`);
+        });
+
+        console.log('\n' + chalk.gray('──────────────────────────────────────────────────────────────────────'));
+        console.log(chalk.gray('  Press Ctrl+C to exit Manager View'));
+    };
+
+    render();
+
+    // Vòng lặp giả lập realtime
+    const interval = setInterval(() => {
+        const statuses = [chalk.green('IDLE'), chalk.blue('WORKING'), chalk.yellow('WAITING'), chalk.magenta('THINKING')];
+        agents[0].status = statuses[Math.floor(Math.random() * statuses.length)];
+        agents[1].task = 'TSK-001: Tích hợp cli-table3';
+        render();
+    }, 2000);
+
+    // Xử lý luồng dừng
+    process.on('SIGINT', () => {
+        clearInterval(interval);
+        console.log(chalk.yellow('\nManager View disconnected.'));
+        process.exit(0);
+    });
+}
+
+module.exports = { launchManagerView };

package/docs/AGENTS_GUIDE.vi.md

@@ -1,55 +1,49 @@
 # 🕵️ Hướng Dẫn Về "Hệ Thống Agent" (Digital Employees)
 
-> **Antigravity** vận hành như một công ty phần mềm thu nhỏ, với **42 nhân viên số (AI Agents)** chuyên trách từng mảng.
+> **Antigravity** không chỉ là công cụ, mà là một **Hệ điều hành Nhân sự AI**. Mọi Agent đều đã được nâng cấp lên chuẩn **Senior Principal Personnel** với khả năng phối hợp hệ sinh thái và kỷ luật vận hành tuyệt đối.
 
 ---
 
 ## 1. Biệt Đội Chuyên Gia (The Squad)
 
-Dưới đây là danh sách các nhân viên ảo chủ chốt sẽ phục vụ bạn:
-
-### 🏗️ Ban Kiến Trúc & Kế Hoạch
-*   **`project-planner`**:
-    *   *Vai trò*: PM (Product Manager).
-    *   *Nhiệm vụ*: Lên kế hoạch, chia nhỏ đầu việc, viết PRD.
-    *   *Khi nào gọi*: Khi dùng `/plan`.
-*   **`orchestrator`**:
-    *   *Vai trò*: Tech Lead / Thư ký.
-    *   *Nhiệm vụ*: Điều phối các agent khác, tổng hợp báo cáo.
-    *   *Khi nào gọi*: Khi dùng `/orchestrate`.
-
-### 💻 Ban Kỹ Thuật (Engineer)
-*   **`frontend-specialist`**:
-    *   *Vai trò*: Senior Frontend Dev.
-    *   *Kỹ năng*: React, Vue, CSS Animation, Responsive.
-*   **`backend-specialist`**:
-    *   *Vai trò*: Senior Backend Dev.
-    *   *Kỹ năng*: API Design, Database, Auth, Logic.
-*   **`database-architect`**:
-    *   *Vai trò*: DBA (Database Administrator).
-    *   *Nhiệm vụ*: Thiết kế Schema, tối ưu câu Query.
-*   **`mobile-developer`**:
-    *   *Vai trò*: Mobile Dev.
-    *   *Task*: Code iOS/Android (React Native/Flutter).
-
-### 🛡️ Ban Chất Lượng & Vận Hành
-*   **`security-auditor`**:
-    *   *Vai trò*: Chuyên gia bảo mật.
-    *   *Nhiệm vụ*: Tìm lỗ hổng, rà soát key lộ.
-*   **`test-engineer`**:
-    *   *Vai trò*: QA/QC.
-    *   *Nhiệm vụ*: Viết test case, chạy kiểm thử tự động.
-*   **`devops-engineer`**:
-    *   *Vai trò*: SysAdmin.
-    *   *Nhiệm vụ*: Cấu hình Server, Docker, Deploy.
-
-### 🎨 Ban Sáng Tạo & Growth
-*   **`ui-ux-designer`**:
-    *   *Vai trò*: Designer.
-    *   *Nhiệm vụ*: Phối màu, chọn font, thiết kế trải nghiệm.
-*   **`seo-specialist`**:
-    *   *Vai trò*: SEO Marketing.
-    *   *Nhiệm vụ*: Tối ưu từ khóa, đẩy Top Google.
+Dưới đây là danh sách các nhân viên ảo sẽ phục vụ bạn:
+
+### 1. Nhóm Kỹ Thuật Cốt Lõi (Engineering Core)
+*   **`backend-specialist`**: Chuyên gia xây dựng API, System Architecture và xử lý Logic Server.
+*   **`frontend-specialist`**: Chuyên gia UI/UX, React/Next.js và tối ưu trải nghiệm người dùng.
+*   **`database-architect`**: Thiết kế Schema, tối ưu truy vấn SQL/NoSQL và Data Modeling.
+*   **`mobile-developer`**: Phát triển ứng dụng iOS/Android đa nền tảng (React Native/Flutter).
+*   **`devops-engineer`**: Quản lý Docker, CI/CD Pipeline, Kubernetes và hạ tầng Cloud.
+*   **`cloud-architect`**: Thiết kế kiến trúc đám mây (AWS/Azure), Serverless và Scalability.
+*   **`performance-optimizer`**: Chuyên gia tối ưu tốc độ tải trang, giảm độ trễ và Memory Leak.
+
+### 2. Nhóm Sản Phẩm & Chiến Lược (Product & Strategy)
+*   **`orchestrator`**: Tổng chỉ huy, điều phối các Agent khác phối hợp nhịp nhàng.
+*   **`product-manager`**: Quản lý lộ trình sản phẩm (Roadmap), ưu tiên tính năng.
+*   **`product-owner`**: Đại diện tiếng nói người dùng, định nghĩa yêu cầu nghiệp vụ (User Stories).
+*   **`project-planner`**: Lập kế hoạch thực thi, chia nhỏ task và ước lượng thời gian.
+
+### 3. Nhóm Chất Lượng & Bảo Mật (Quality & Security)
+*   **`security-auditor`**: Rà soát mã nguồn, phát hiện lỗ hổng bảo mật (OWASP) và tuân thủ đạo đức AI (Fabric).
+*   **`penetration-tester`**: Tấn công thử nghiệm (Red Team) để tìm điểm yếu hệ thống.
+*   **`quality-inspector`**: Kiểm tra tiêu chuẩn code (Linting, Convention) và độ ổn định.
+*   **`test-engineer`**: Viết và chạy các kịch bản kiểm thử (Unit/Integration Test).
+*   **`qa-automation-engineer`**: Tự động viết và chạy kịch bản kiểm thử E2E (Playwright MCP).
+
+### 4. Nhóm Hỗ Trợ & Phân Tích (Support & Analysis)
+*   **`browser-subagent`**: Chuyên gia trinh sát mạng (Recon), tự động bật trình duyệt cào dữ liệu, xử lý DOM và chụp ảnh Vision.
+*   **`documentation-writer`**: Soạn thảo tài liệu kỹ thuật, API Docs và Hướng dẫn sử dụng.
+*   **`seo-specialist`**: Tối ưu hóa công cụ tìm kiếm, Meta tags và cấu trúc nội dung.
+*   **`game-developer`**: Chuyên gia phát triển Logic Game, Physics và Đồ họa.
+*   **`explorer-agent`**: Thám hiểm các công nghệ mới, tìm kiếm giải pháp sáng tạo.
+*   **`code-archaeologist`**: "Nhà khảo cổ" chuyên đọc và giải thích các mã nguồn cũ (Legacy Code).
+*   **`debugger`**: Thám tử điều tra lỗi, phân tích Log và tìm nguyên nhân gốc rễ.
+
+### 🤝 Giao thức Phối hợp (Ecosystem Protocol)
+Mỗi Agent hiện nay không làm việc cô lập. Họ tuân thủ:
+- **Handoff**: Chuyển giao ngữ cảnh (API docs, PRD, Test logs) cho Agent tiếp theo.
+- **Socratic Gatekeeping**: Biết dừng lại hỏi ý kiến người dùng hoặc đồng nghiệp khi thấy rủi ro.
+- **DNA Linkage**: Luôn kiểm tra `GEMINI.md` và `MASTER_GUIDE.md` trước khi hành động.
 
 ---
 

package/docs/CONTRIBUTING.vi.md

@@ -1,6 +1,9 @@
 # Hướng Dẫn Đóng Góp (Contributing)
 
-Cảm ơn bạn đã quan tâm đến dự án Antigravity IDE! Chúng tôi luôn chào đón mọi sự đóng góp từ cộng đồng.
+Cảm ơn bạn đã quan tâm đến dự án AntiGravity IDE! Chúng tôi luôn chào đón mọi sự đóng góp từ cộng đồng để cùng xây dựng một hệ sinh thái mã nguồn mở vững mạnh. 
+
+> [!NOTE]
+> Khi đóng góp, vui lòng tôn trọng bản quyền và các nguồn tham khảo (References) chính của dự án.
 
 ## 🤝 Quy Tắc Ứng Xử
 Khi tham gia dự án, vui lòng giữ thái độ tôn trọng, lịch sự và chuyên nghiệp.
@@ -26,12 +29,18 @@ Khi tham gia dự án, vui lòng giữ thái độ tôn trọng, lịch sự và
 -   **Kiểm thử**: Đảm bảo chạy `npm test` thành công.
 -   **Lint Code**: Chạy `npm run lint` để code sạch đẹp.
 
+### 4. Quy trình đăng ký Skill/Workflow mới
+Để một Skill hoặc Workflow mới xuất hiện trong Setup Wizard, bạn cần:
+1.  **Skill**: Thêm định dạng vào `cli/logic/skill-definitions.js`.
+2.  **Workflow**: Thêm tên vào `cli/logic/workflow-manager.js`.
+3.  **Lựa chọn (Scale)**: Cấu hình quy mô xuất hiện (Instant/SME/Creative) trong `cli/logic/manifest-manager.js`.
+
 ## 🛠️ Cài Đặt Môi Trường Dev
 
 1.  Clone fork của bạn:
     ```bash
-    git clone https://github.com/your-username/google-antigravity.git
-    cd google-antigravity
+    git clone https://github.com/your-username/antigravity-ide.git
+    cd antigravity-ide
     ```
 2.  Cài đặt thư viện:
     ```bash

package/docs/{GEMINI_GUIDE.md → GEMINI_USAGE.md}

@@ -1,6 +1,6 @@
 # Using Antigravity IDE with Google Gemini
 
-**All 550+ skills are fully compatible with Google Gemini AI!**
+**All 72 Master Skills (600+ AI Patterns) are fully compatible with Google Gemini AI!**
 
 ## Why Antigravity IDE + Gemini?
 
@@ -8,7 +8,7 @@
 
 | Feature | Benefit for Gemini |
 |---------|-------------------|
-| **550+ Skills** | Instant expertise in 8 domains |
+| **72 Master Skills** | Instant expertise in 8 domains (Standard v4.0.8) |
 | **Universal Format** | No vendor lock-in, works with any Gemini model |
 | **Large Context** | Gemini 1.5 Pro (2M tokens) loads multiple skills easily |
 | **Multimodal Support** | Skills cover text, vision, audio - all Gemini capabilities |
@@ -108,7 +108,7 @@ If a workflow/skill is found in Global, use it as the default.
 ## 📊 Skill Categories Breakdown
 
 ```
-Total: 550+ skills across 8 categories
+Total: 27 Master Skills (600+ capabilities) across 8 categories
 
 Development (180+ skills)
 ├── Frontend (React, Next.js, Vue, Svelte)
@@ -187,7 +187,7 @@ Tools (10+ skills)
 **Option 1: Load All (Gemini Pro)**
 ```javascript
 // Gemini 1.5 Pro has 2M token context
-// Can load ALL 550 skills!
+// Can load multiple Master Skills!
 const allSkills = loadAllSkills(".agent/skills");
 ```
 
@@ -259,7 +259,7 @@ const skills = [
 ## 📚 Resources
 
 - **All Skills**: See [SKILLS.md](./SKILLS.md)
-- **Skill Source**: [antigravity-awesome-skills](https://github.com/Dokhacgiakhoa/google-antigravity)
+- **Skill Source**: [antigravity-awesome-skills](https://github.com/Dokhacgiakhoa/antigravity-ide)
 - **Gemini Docs**: [Google AI Studio](https://ai.google.dev/)
 - **Examples**: Check `/lab` directory
 
@@ -291,4 +291,4 @@ console.log(result.response.text());
 
 ---
 
-**Ready to build with Gemini + 550 skills? Let's go! 🚀**
+**Ready to build with Gemini + 27 Master Skills? Let's go! 🚀**

package/docs/GLOSSARY.vi.md

@@ -12,21 +12,33 @@ Hãy dùng các từ khóa này để giao tiếp chính xác với AI.
 | :--- | :--- | :--- |
 | `/audit` | **Kiểm toán chất lượng** | Trước khi bàn giao, cần rà soát lỗi bảo mật/hiệu năng. |
 | `/brainstorm` | **Bão não ý tưởng** | Bí ý tưởng, cần AI gợi ý giải pháp/kiến trúc. |
-| `/create` | **Khởi tạo dự án** | Bắt đầu một dự án mới từ con số 0. |
-| `/debug` | **Gỡ lỗi** | Khi code chạy sai, quăng log lỗi cho AI phân tích. |
-| `/deploy` | **Triển khai** | Đóng gói và đẩy ứng dụng lên Server/Cloud. |
+| `/create` | **Khởi tạo tính năng** | Xây dựng module mới (FE + BE + DB). |
+| `/debug` | **Gỡ lỗi** | Phân tích log lỗi và tìm nguyên nhân. |
+| `/deploy` | **Triển khai** | Đẩy ứng dụng lên Server/Cloud. |
 | `/document` | **Viết tài liệu** | Tự động viết README, API Docs từ code. |
-| `/enhance` | **Nâng cấp** | Muốn sửa UI đẹp hơn, hoặc tối ưu code cũ. |
-| `/monitor` | **Giám sát** | Cài đặt công cụ theo dõi Server/Logs. |
-| `/onboard` | **Dẫn nhập** | Tạo tài liệu hướng dẫn cho thành viên mới (Newbie). |
-| `/orchestrate` | **Điều phối** | Gọi "Hội đồng chuyên gia" giải quyết bài toán lớn. |
-| `/plan` | **Lập kế hoạch** | Phân tích yêu cầu -> Ra file `implementation_plan.md`. |
-| `/preview` | **Xem trước** | Chạy thử web/app để xem giao diện. |
-| `/security` | **Quét bảo mật** | Kiểm tra lỗ hổng chuyên sâu (Penetration Test). |
-| `/seo` | **Tối ưu tìm kiếm** | Giúp web lên Top Google (Meta tags, Sitemap). |
-| `/status` | **Trạng thái** | Xem báo cáo tiến độ dự án. |
-| `/test` | **Kiểm thử** | Viết và chạy Unit Test/E2E Test. |
-| `/ui-ux-pro-max`| **Giao diện Đỉnh cao**| Thiết kế UI đẹp như tranh vẽ (Magic UI/Linear). |
+| `/enhance` | **Nâng cấp** | Thay đổi UI hoặc tối ưu logic nhỏ. |
+| `/monitor` | **Giám sát** | Setup công cụ theo dõi hệ thống. |
+| `/onboard` | **Dẫn nhập** | Hướng dẫn cho thành viên mới gia nhập team. |
+| `/orchestrate` | **Điều phối** | Phối hợp nhiều Agent cho task lớn. |
+| `/plan` | **Lập kế hoạch** | Phân tích yêu cầu và thiết kế giải pháp. |
+| `/preview` | **Xem trước** | Chạy thử sản phẩm trong sandbox. |
+| `/security` | **Quét bảo mật** | Kiểm tra lỗ hổng chuyên sâu. |
+| `/seo` | **Tối ưu tìm kiếm** | Đưa web lên Top Search Google/AI. |
+| `/status` | **Trạng thái** | Dashboard tiến độ thực hiện task. |
+| `/test` | **Kiểm thử** | Chạy Unit Test, E2E Test. |
+| `/ui-ux-pro-max`| **Giao diện Đỉnh cao**| Thiết kế UI Premium (Magic UI). |
+| `/update-docs` | **Đồng bộ tài liệu** | Tự động cập nhật /docs sau khi thay đổi code. |
+| `/release-version`| **Phát hành bản mới**| Chốt phiên bản, update stats và chuẩn bị release. |
+| `/api` | **Master API** | Thiết kế chuẩn OpenAPI 3.1. |
+| `/realtime` | **Thời gian thực** | Socket.io, WebRTC, SSE. |
+| `/compliance` | **Pháp lý** | Kiểm tra chuẩn GDPR/HIPAA. |
+| `/mobile` | **Di động** | Phát triển Native App & Optimization. |
+| `/portfolio` | **Trang cá nhân** | Xây dựng Landing Page cá nhân. |
+| `/blog` | **Hệ thống Blog** | Xây dựng module tin tức. |
+| `/visually` | **Trực quan hóa** | Vẽ biểu đồ, sơ đồ luồng. |
+| `/explain` | **Giải thích code** | Tìm hiểu logic sâu của từng module. |
+| `/update` | **Cập nhật Agent** | Tải bộ não mới nhất cho Agent. |
+| `/log-error` | **Nhật ký lỗi** | Tự động ghi lỗi vào ERRORS.md. |
 
 ---
 
@@ -47,23 +59,30 @@ Hãy dùng các từ khóa này để giao tiếp chính xác với AI.
 ---
 
 ## 3. Agents (Những nhân cách AI)
-*AI có thể tự đóng các vai này trong quá trình làm việc, hoặc bạn yêu cầu.*
-
-*   **Orchestrator**: Nhạc trưởng, tổng chỉ huy.
-*   **Project Planner**: Người lập kế hoạch, chia việc.
-*   **Backend Specialist**: Chuyên Back-end.
-*   **Frontend Specialist**: Chuyên Front-end.
-*   **Mobile Developer**: Chuyên App (iOS/Android).
-*   **Game Developer**: Chuyên làm Game.
-*   **Cloud Architect**: Kiến trúc sư Cloud (AWS/GCP).
+*Mỗi dự án v4.0 có 22 vai diễn chuyên gia:*
+
+*   **Orchestrator**: Nhạc trưởng điều phối đa agent.
+*   **Project Planner**: Lập kế hoạch & quản lý Backlog.
+*   **Product Manager**: Quản lý sản phẩm & lộ trình.
+*   **Product Owner**: Đại diện giá trị nghiệp vụ.
+*   **Backend Specialist**: Lập trình viên phía máy chủ.
+*   **Frontend Specialist**: Kiến trúc sư giao diện.
+*   **Mobile Developer**: Phát triển ứng dụng di động.
+*   **Game Developer**: Phát triển Game & Logic đồ họa.
+*   **Cloud Architect**: Kiến trúc sư hạ tầng đám mây.
+*   **DevOps Engineer**: Kỹ sư vận hành & CI/CD.
+*   **Database Architect**: Chuyên gia thiết kế dữ liệu.
+*   **Security Auditor**: Chuyên gia kiểm tra bảo mật.
+*   **Penetration Tester**: Hacker mũ trắng (Pentest).
+*   **Quality Inspector**: Giám sát tiêu chuẩn chất lượng.
+*   **QA Automation Engineer**: Kỹ sư kiểm thử tự động.
+*   **Test Engineer**: Kỹ sư kiểm tra tính năng.
 *   **Performance Optimizer**: Chuyên gia tối ưu tốc độ.
-*   **Security Auditor**: Chuyên gia rà soát bảo mật.
-*   **SEO Specialist**: Chuyên gia Marketing/SEO.
-*   **Quality Inspector**: Người kiểm tra chất lượng (QA).
-*   **Documentation Writer**: Thư ký viết tài liệu.
-*   **Test Engineer**: Kỹ sư kiểm thử.
-*   **Debugger**: Thám tử săn lỗi.
-*   **Codebase Expert**: Cuốn từ điển sống của dự án.
+*   **SEO Specialist**: Chuyên gia tối ưu tìm kiếm.
+*   **Documentation Writer**: Chuyên gia viết tài liệu.
+*   **Explorer Agent**: Agent nghiên cứu & thám hiểm code.
+*   **Code Archaeologist**: Chuyên gia phân tích code cũ.
+*   **Debugger**: Thám tử săn lỗi (Sherlock Holmes).
 
 ---
 

package/docs/HOW_ANTIGRAVITY_THINKS.vi.md

@@ -16,7 +16,7 @@ Khi user bắt đầu một phiên làm việc:
     *   *Luật lệ*: Tôi biết những gì ĐƯỢC làm và CẤM làm (ví dụ: cấm xóa DB).
 2.  **Nạp Kỹ năng (Skill Injection)**:
     *   Dựa vào yêu cầu user (ví dụ: "Code React"), tôi tự động vào kho `.agent/skills` để lôi cổ thằng `nextjs-react-expert` ra dùng.
-    *   Tôi không nạp hết 550 skill (tràn bộ nhớ), chỉ nạp cái cần thiết (Lazy Loading).
+    *   Tôi không nạp hết 72 Master Skills (tràn bộ nhớ), chỉ nạp cái cần thiết (Lazy Loading).
 
 ## 2. Quy Trình Xử Lý Một Yêu Cầu (The Thinking Process)
 

package/docs/OPERATIONAL_FLOW.vi.md

@@ -4,6 +4,15 @@
 
 ---
 
+## 🛡️ Cơ chế Bảo vệ & Tự học (The Watchdog v4.0.8)
+
+Dự án v4.0.8 tích hợp sẵn hệ thống giám sát cấp cao:
+- **Chống Treo & Lặp**: Agent tự ngắt các tác vụ bị kẹt và báo cáo cho User.
+- **Học Từ Sai Lầm**: Mọi lỗi (Test fail, Agent hiểu sai) đều được ghi vào `ERRORS.md` để rút kinh nghiệm cho lần sau.
+- **Kỷ Luật PDCA**: Mọi task đều đi qua chu kỳ Lập kế hoạch -> Thực thi -> Kiểm tra -> Cải tiến.
+
+---
+
 ## 🎯 Case Study 1: Sàn Thương mại Điện tử (Web Fullstack) 🛒
 **Độ khó**: Cao | **Thời gian**: 2 tuần quy đổi | **Trọng tâm**: Database, API, State Management.
 
@@ -145,3 +154,9 @@
     *   Vòng 2: "Thêm CSS cho đẹp."
     *   Vòng 3: "Tối ưu code cho gọn."
     *   *(Đừng bắt AI làm hoàn hảo ngay từ lệnh đầu tiên)*.
+
+4.  **Mô hình "Bảo trì Thần tốc"**:
+    *   Khi thấy Agent chạy chệch hướng hoặc Rules bị cũ: "Chạy `npx antigravity-ide` để **Repair & Sync** toàn bộ hệ thống ngay lập tức."
+
+---
+*Cẩm nang này sẽ được cập nhật liên tục theo các phiên bản mới của Antigravity IDE.*

package/docs/{PUBLISHING.md → PUBLISHING_GUIDE.md}

@@ -3,13 +3,16 @@
 ## ✅ Published Successfully!
 
 **Package:** `antigravity-ide`  
-**Version:** `4.2.1`  
-**Published:** 2026-02-16  
+**Version:** `4.0.8`  
+**Published:** 2026-02-08  
 **Link:** https://www.npmjs.com/package/antigravity-ide
 
 ---
 
-## Pre-publish Checklist
+
+> **⚠️ QUAN TRỌNG**: Chỉ thực hiện quy trình này khi **ĐƯỢC NGƯỜI DÙNG YÊU CẦU**. Tuyệt đối không tự ý release.
+
+## 1. Pre-flight Checklist (Tự động)
 
 All steps completed:
 
@@ -176,3 +179,28 @@ npm owner add <username> antigravity-ide
 ---
 
 **Congratulations! Your package is now live on npm! 🎉**
+
+---
+
+## GitHub Packages Support
+
+This project is configured to **Dual Publish**:
+1. **npm Registry**: `antigravity-ide` (Public, Unscoped)
+2. **GitHub Packages**: `@Dokhacgiakhoa/antigravity-ide` (Scoped to repository owner)
+
+### How it works
+The `release.yml` workflow automatically renames the package to `@Dokhacgiakhoa/antigravity-ide` *only* during the GitHub Packages publishing step. This ensures the source code remains `antigravity-ide` for npm compatibility.
+
+### Installing from GitHub Packages
+To install the scoped version from GitHub:
+
+1. Create a `.npmrc` file in your project:
+   ```ini
+   @Dokhacgiakhoa:registry=https://npm.pkg.github.com
+   //npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN
+   ```
+
+2. Install:
+   ```bash
+   npm install @Dokhacgiakhoa/antigravity-ide
+   ```

package/docs/RULES_GUIDE.vi.md

@@ -1,60 +1,96 @@
-# 📜 Hướng Dẫn Sử Dụng "Luật Hệ Thống" (Rules System)
+# 📜 Hướng Dẫn Sử Dụng "Luật Hệ Thống" (Rules System) v4.0.8
 
-> **Cơ chế hoạt động**: Antigravity sử dụng cơ chế **Hybrid Trigger** (Kết hợp Tự động & Gọi tên) để đảm bảo code vừa nhanh vừa chuẩn.
+> **Cơ chế hoạt động**: Antigravity sử dụng cơ chế **Hybrid Language Protocol** (Song ngữ Anh-Việt) để tối ưu hóa cả khả năng hiểu của AI và sự tiện lợi cho đội ngũ phát triển.
 
 ---
 
-## 1. Phân Loại Rules
+## 0. Triết lý "Mục đích kép" (Dual Audience)
+
+Các file trong thư mục `.agent/rules/` được thiết kế để phục vụ cùng lúc 2 đối tượng:
+
+1.  **🤖 AI Agent (Constraint Layer)**:
+    -   Đóng vai trò là "Rào chắn" (Guardrails).
+    -   Ví dụ: Khi Agent đọc rule `code-quality.md`, nó biết ngay lệnh cấm: *"No console.log in production"*.
+    -   Agent hiểu hoàn hảo cả Tiếng Anh (Keyword) và Tiếng Việt (Context).
+
+2.  **👨‍💻 Human Team (Standard Layer)**:
+    -   Đóng vai trò là "Cẩm nang phát triển" (Wiki).
+    -   Thành viên mới gia nhập dự án có thể đọc để nắm bắt Coding Style, Quy trình Git, Bảo mật.
+    -   Sử dụng Tiếng Việt giúp anh em dev nắm bắt nhanh hơn, tránh rào cản ngôn ngữ.
+
+3.  **🏢 Professional Protocol (Compliance Layer)**:
+    -   Mọi Rule hiện nay đều được liên kết trực tiếp vào các Phase của **Unified Protocol** (Discovery, Planning, Execution, Audit).
+    -   Agent không thể bỏ qua Rule nếu muốn pass qua giai đoạn **Audit**.
+
+---
+
+## 1. Giao thức Ngôn ngữ Lai (Hybrid Language Protocol)
+
+Để đạt hiệu quả tối đa, hệ thống áp dụng quy tắc ngôn ngữ sau:
+
+| Thành phần | Ngôn ngữ | Lý do | Ví dụ |
+| :--- | :--- | :--- | :--- |
+| **Logic Cốt lõi** | 🇬🇧 **Tiếng Anh** | Chính xác cho máy, keyword chuẩn quốc tế. | `Metadata`, `Variable Name`, `Anti-Patterns` |
+| **Giải thích/Ngữ cảnh** | 🇻🇳 **Tiếng Việt** | Tự nhiên, dễ hiểu cho người Việt. | "Mục tiêu: Đảm bảo mã nguồn sạch..." |
+| **Cấu hình (Config)** | 🇬🇧 **Tiếng Anh** | Bắt buộc do cú pháp hệ thống. | `json`, `yaml`, `regex` |
+
+---
+
+## 2. Phân Loại Rules
 
 ### 🤖 Nhóm Tự Động (Auto-Active)
 *Luôn chạy ngầm, bạn không cần gọi.*
 
-| Rule | Kích hoạt khi | Chức năng |
+| Rule | Chức năng | Ngôn ngữ |
 | :--- | :--- | :--- |
-| **`security`** | **Luôn luôn** | Chặn hardcode API Key, SQL Injection, XSS. |
-| **`frontend`** | File `.js`, `.css`, `.tsx` | Chuẩn hóa UI, Spacing, Responsive. |
-| **`backend`** | File `.py`, `.go`, `.sql` | Chuẩn Clean Architecture, API Response. |
-| **`gemini`** | **Luôn luôn** | Cấu hình lõi, tính cách Agent. |
+| **`GEMINI.md`** | **Hiến pháp lõi**: Định hình nhân dạng, tính cách và các mode vận hành (Solo/Team/Factory). | Hybrid |
+| **`security.md`** | **Bảo mật**: Chặn hardcode API Key, SQL Injection, XSS. | Hybrid |
+| **`code-quality.md`** | **Chất lượng**: Quy định về Naming, Comments, Error Handling. | Hybrid |
+| **`frontend.md`** | **Giao diện**: Chuẩn hóa UI/UX, Responsive, Performance. | Hybrid |
+| **`backend.md`** | **Hệ thống**: Chuẩn Clean Architecture, API Response, DB Schema. | Hybrid |
+| **`testing-standard.md`** | **Kiểm thử**: Quy chuẩn Pyramid, Naming, Mocking & Coverage. | Hybrid |
+| **`malware-protection`** | **An toàn**: Chống virus, link độc hại và kiểm soát package. | English |
+| **`error-logging`** | **Học tập**: Tự động ghi lại lỗi vào ERRORS.md. | Hybrid |
+| **`docs-update`** | **Tài liệu**: Checklist tự động cập nhật docs khi có tính năng mới. | Hybrid |
+| **`system-update`** | **Hệ thống**: Tự động kiểm tra và nâng cấp Antigravity IDE. | Hybrid |
+| **`runtime-watchdog`** | **An toàn**: Chống treo, vòng lặp vô hạn và lỗi Agent phản hồi chậm. | Hybrid |
 
 ### 🛠️ Nhóm Theo Yêu Cầu (On-Demand / @Tags)
 *Chỉ chạy khi có ngữ cảnh phù hợp hoặc được bạn gọi đích danh.*
 
 | Tag Gọi | Tên Rule | Chức năng |
 | :--- | :--- | :--- |
-| **`@biz`** | `business` | Kiểm tra logic nghiệp vụ, tính tiền, quyền hạn. |
-| **`@legal`** | `compliance` | Rà soát GDPR, bảo mật dữ liệu, Logging chuẩn. |
-| **`@arch`** | `architecture-review` | Đánh giá khả năng chịu tải, HA, Microservices. |
-| **`@debug`** | `debug` | Kích hoạt quy trình 4 bước: Điều tra -> Test -> Sửa -> Báo cáo. |
+| **`@biz`** | `business.md` | Kiểm tra logic nghiệp vụ, tính tiền, quyền hạn. |
+| **`@legal`** | `compliance.md` | Rà soát GDPR, bảo mật dữ liệu, Logging chuẩn. |
+| **`@arch`** | `architecture-review.md` | Đánh giá khả năng chịu tải, HA, Microservices. |
+| **`@debug`** | `debug.md` | Kích hoạt quy trình 4 bước: Điều tra -> Test -> Sửa -> Báo cáo. |
 
 ---
 
-## 2. Cách Sử Dụng Semantic Tags (@)
+## 3. Cách Sử Dụng Semantic Tags (@)
 
 Bạn có thể dùng ký tự `@` trong lệnh chat để **ép buộc** Agent tập trung vào một khía cạnh cụ thể.
 
-### Ví dụ thực tế:
-
-**1. Khi Review Logic Tính Tiền:**
-> "Agent, hãy `@biz` check lại hàm tính thuế này xem có bị lỗi làm tròn số (Float) không?"
-*(Agent sẽ lôi `rules/business.md` ra để soi kỹ vấn đề Decimal vs Float)*
+**Ví dụ thực tế:**
 
-**2. Khi Audit Bảo Mật Dữ Liệu:**
-> "Code này `@legal` có vi phạm quy tắc log email người dùng không?"
-*(Agent sẽ đối chiếu với `rules/compliance.md` về PII masking)*
+1.  **Khi Review Logic Tính Tiền:**
+    > "Agent, hãy `@biz` check lại hàm tính thuế này xem có bị lỗi làm tròn số (Float) không?"
+    *(Agent sẽ lôi `rules/business.md` ra để soi kỹ vấn đề Decimal vs Float)*
 
-**3. Khi Sửa Lỗi Khó:**
-> "Hệ thống đang bị lỗi 500, `@debug` điều tra giúp tôi."
-*(Agent kích hoạt chế độ Sherlock Holmes)*
+2.  **Khi Audit Bảo Mật Dữ Liệu:**
+    > "Code này `@legal` có vi phạm quy tắc log email người dùng không?"
+    *(Agent sẽ đối chiếu với `rules/compliance.md` về PII masking)*
 
-**4. Khi Thiết Kế Hệ Thống Lớn:**
-> "Tôi muốn xây dựng module Payment, `@arch` tư vấn giải pháp chịu tải cao."
-*(Agent dùng `rules/architecture-review.md` để tư vấn Redis/Queue)*
+3.  **Khi Sửa Lỗi Khó:**
+    > "Hệ thống đang bị lỗi 500, `@debug` điều tra giúp tôi."
+    *(Agent kích hoạt chế độ Sherlock Holmes)*
 
 ---
 
-## 3. Tại sao cần chia ra như vậy?
+## 4. Tại sao cần chia ra như vậy?
 
-*   Nếu nạp **tất cả** luật cùng lúc: Agent sẽ bị "quá tải" (Cognitive Overload), dẫn đến xử lý chậm và hay quên các chi tiết nhỏ.
-*   Cơ chế **@Tags** giúp bạn điều hướng sự tập trung của Agent vào đúng chỗ cần thiết nhất tại thời điểm đó.
+*   **Tránh Overload**: Nếu nạp **tất cả** luật cùng lúc, Agent sẽ bị "quá tải" (Cognitive Overload).
+*   **Tăng độ chính xác**: Cơ chế **@Tags** giúp bạn điều hướng sự tập trung của Agent vào đúng chỗ cần thiết nhất.
+*   **Thân thiện**: Cách viết Hybrid giúp Rule trở nên "có hồn" hơn, giống như một người mentor đang hướng dẫn team.
 
-> **Mẹo**: Hãy coi các Rule này là các "Cố vấn chuyên môn". Khi cần ai, hãy gọi tên người đó!
+> **Lời khuyên**: Hãy coi `rules/` là thư viện luật pháp của dự án. Khi cần ban hành luật mới, hãy tạo file mới hoặc sửa file cũ theo chuẩn Hybrid này.