antigravity-ide 4.2.1 → 4.3.3

package/.agent/mcp_config.json

@@ -1,24 +0,0 @@
-{
-    "mcpServers": {
-        "context7": {
-            "command": "npx",
-            "args": [
-                "-y",
-                "@upstash/context7-mcp",
-                "--api-key",
-                "YOUR_API_KEY"
-            ]
-        },
-        "shadcn": {
-            "command": "npx",
-            "args": [
-                "shadcn@latest",
-                "mcp"
-            ]
-        }
-        //other mcp servers
-    }
-}
-
-// setup mcp server in  ~/.gemini\antigravity\mcp_config.json
-

package/.agent/rules/GEMINI.eco.md

@@ -1,37 +0,0 @@
----
-trigger: always_on
----
-
-# GEMINI.md - MVP Constitution (Luật MVP)
-
-> **Mục tiêu**: Tối ưu hóa tốc độ và tính linh hoạt để đưa sản phẩm MVP ra mắt nhanh nhất.
-
----
-
-## 🚀 1. TƯ DUY MVP (MVP Mindset)
-
-- **Danh tính**: Antigravity MVP Orchestrator.
-- **Tâm thế**: 
-  - **Fast-Track (Tốc độ)**: Ưu tiên hoàn thành tính năng cốt lõi.
-  - **Pragmatic (Thực dụng)**: Giải pháp đơn giản, hiệu quả.
-  - **Clean MVP**: Code gọn gàng nhưng không quá phức tạp hóa.
-
----
-
-## 🔄 2. CHU TRÌNH GỌN NHẸ (Lightweight PDCA)
-
-1. **PLAN**: Lập kế hoạch nhanh (Atomic Tasks).
-2. **DO**: Thực thi bởi các Đội ngũ Đa năng (Multi-taskers).
-3. **VERIFY**: Kiểm tra tính đúng đắn cơ bản.
-
----
-
-## 🛑 3. QUY TẮC CỐT LÕI
-
-1. **Ask to Execute**: Nếu yêu cầu rõ ràng, hãy thực hiện ngay.
-2. **Simple is Best**: Tránh Over-engineering.
-3. **Safety First**: Vẫn tuân thủ nghiêm ngặt bảo mật (Secrets, SQLi).
-
----
-
-*Hệ thống được thiết kế để sáng tạo và triển khai tức thì.*

package/.agent/rules/GEMINI.instant.md

@@ -1,37 +0,0 @@
----
-trigger: always_on
----
-
-# GEMINI.md - MVP Constitution (Luật MVP)
-
-> **Mục tiêu**: Tối ưu hóa tốc độ và tính linh hoạt để đưa sản phẩm MVP ra mắt nhanh nhất.
-
----
-
-## 🚀 1. TƯ DUY MVP (MVP Mindset)
-
-- **Danh tính**: Antigravity MVP Orchestrator.
-- **Tâm thế**: 
-  - **Fast-Track (Tốc độ)**: Ưu tiên hoàn thành tính năng cốt lõi.
-  - **Pragmatic (Thực dụng)**: Giải pháp đơn giản, hiệu quả.
-  - **Clean MVP**: Code gọn gàng nhưng không quá phức tạp hóa.
-
----
-
-## 🔄 2. CHU TRÌNH GỌN NHẸ (Lightweight PDCA)
-
-1. **PLAN**: Lập kế hoạch nhanh (Atomic Tasks).
-2. **DO**: Thực thi bởi các Đội ngũ Đa năng (Multi-taskers).
-3. **VERIFY**: Kiểm tra tính đúng đắn cơ bản.
-
----
-
-## 🛑 3. QUY TẮC CỐT LÕI
-
-1. **Ask to Execute**: Nếu yêu cầu rõ ràng, hãy thực hiện ngay.
-2. **Simple is Best**: Tránh Over-engineering.
-3. **Safety First**: Vẫn tuân thủ nghiêm ngặt bảo mật (Secrets, SQLi).
-
----
-
-*Hệ thống được thiết kế để sáng tạo và triển khai tức thì.*

package/.agent/rules/api-spec.md

@@ -1,28 +0,0 @@
----
-trigger: glob
-glob: "**/*.{yaml,yml,json,proto}"
----
-
-# API-SPEC.MD - Contract & Interface Standards
-
-> **Mục tiêu**: Đảm bảo hợp đồng dữ liệu giữa các hệ thống (Frontend-Backend, Microservices) luôn nhất quán và minh bạch.
-
-## 📜 1. SPECIFICATION (OPENAPI/SWAGGER)
-1. **Source of Truth**: File Spec là nguồn chân lý duy nhất. Code phải tuân thủ Spec hoặc Spec được sinh ra từ code một cách tự động.
-2. **Versioning**: Luôn có version trong URL (ví dụ: `/api/v1/...`). Không bao giờ tạo breaking changes ở version hiện tại.
-3. **Documentation**: Mọi Endpoint phải có mô tả rõ ràng về Params, Request Body và Response Schema.
-
-## 🛠️ 2. DESIGN BEST PRACTICES
-1. **Naming**: Dùng `kebab-case` cho URL. Dùng danh từ số nhiều (ví dụ: `/orders`).
-2. **Methods**: Dùng đúng ý nghĩa của HTTP Verbs (GET, POST, PUT, PATCH, DELETE).
-3. **Status Codes**: 
-   - 200/201: Success.
-   - 400: Bad Request (Client error).
-   - 401/403: Auth error.
-   - 404: Not Found.
-   - 500: Server error.
-
-## 🛡️ 3. SECURITY & VALIDATION
-1. **Input Sanitization**: Mọi dữ liệu đầu vào phải được validate schema trước khi xử lý.
-2. **Rate Limiting**: Giới hạn số lượng request để tránh brute-force và DDoS.
-3. **CORS**: Cấu hình chính xác Origin, không dùng `*` ở Production.

package/.agent/rules/database.md

@@ -1,24 +0,0 @@
----
-trigger: glob
-glob: "**/*.{sql,prisma,mongodb,json}"
----
-
-# DATABASE.MD - Data Integrity & Schema Mastery
-
-> **Mục tiêu**: Đảm bảo cấu trúc dữ liệu chuẩn mực, hiệu năng truy vấn cao và an toàn dữ liệu tuyệt đối.
-
-## 🏗️ 1. SCHEMA DESIGN
-1. **Normalization**: Tuân thủ chuẩn 3NF. Tránh dư thừa dữ liệu.
-2. **Naming**: Dùng `snake_case` cho Table và Column.
-3. **Auditing**: Mọi bảng nghiệp vụ phải có `created_at` (timestamp) và `updated_at` (timestamp).
-4. **Soft Delete**: Ưu tiên dùng `deleted_at` thay vì xóa vật lý cho dữ liệu quan trọng.
-
-## ⚡ 2. PERFORMANCE & INDEXING
-1. **Indexes**: Đánh Index cho Foreign Keys và các cột thường xuyên nằm trong điều kiện `WHERE`.
-2. **Explain Plan**: Phải kiểm tra chi phí truy vấn trước khi triển khai các câu lệnh phức tạp.
-3. **Pagination**: Luôn dùng con trỏ (Cursor) hoặc Limit/Offset để tránh tải quá nhiều dữ liệu.
-
-## 🛡️ 3. MIGRATION PROTOCOL
-1. **Atomic Changes**: Mỗi migration chỉ thực hiện một thay đổi logic duy nhất.
-2. **Rollback**: Luôn phải có phương án hạ cấp (Down) cho mọi bản nâng cấp (Up).
-3. **Production Safety**: Tuyệt đối không xóa/sửa cột có dữ liệu mà không có bước backup/migrate dữ liệu trung gian.

package/.agent/rules/devops.md

@@ -1,23 +0,0 @@
----
-trigger: glob
-glob: "**/dockerfile,**/docker-compose.yml,**/.github/workflows/*.yml,**/jenkinsfile,**/terraform/**/*,**/k8s/**/*"
----
-
-# DEVOPS.MD - Deployment & Infrastructure Mastery
-
-> **Mục tiêu**: Tự động hóa tối đa, triển khai an toàn và hạ tầng có khả năng mở rộng (Scalability).
-
-## 🚀 1. CONTAINERIZATION (DOCKER)
-1. **Multi-stage Builds**: Giảm thiểu kích thước Image bằng cách chỉ giữ lại Artifact cuối cùng.
-2. **Non-root User**: Chạy ứng dụng dưới quyền user thường để đảm bảo bảo mật.
-3. **Environment**: Dùng `.env` và không bao giờ hardcode cấu hình vào Image.
-
-## 🛠️ 2. CI/CD PIPELINE
-1. **Automated Testing**: Pipeline phải chạy Unit Test, Integration Test trước khi Build.
-2. **Security Scan**: Tích hợp các công cụ quét mã độc (Snyk, Trivy) vào pipeline.
-3. **Zero-downtime**: Triển khai theo chiến lược Canary hoặc Blue/Green.
-
-## 🏗️ 3. INFRASTRUCTURE AS CODE (IaC)
-1. **Declarative**: Ưu tiên Terraform hoặc CloudFormation.
-2. **State Management**: Quản lý State tập trung (Remote State) và có khóa (Locking).
-3. **Modularity**: Chia nhỏ hạ tầng thành các Module tái sử dụng.

package/.agent/rules/growth-strategy.md

@@ -1,22 +0,0 @@
----
-trigger: always_on
----
-
-# GROWTH-STRATEGY.MD - Business & Market Dominance
-
-> **Mục tiêu**: Biến sản phẩm kỹ thuật thành một sản phẩm kinh doanh thành công rực rỡ.
-
-## 🚀 1. SEO & VISIBILITY Mastery
-1. **Semantic HTML**: Cấu trúc heading (H1-H6) chuẩn SEO.
-2. **Meta Data**: Dynamic meta tags cho từng trang, hỗ trợ OpenGraph và Twitter Cards.
-3. **Schema Markup**: Nhúng JSON-LD để Google hiểu rõ nội dung website.
-
-## 💰 2. CONVERSION RATE OPTIMIZATION (CRO)
-1. **Call to Action (CTA)**: Nút bấm phải nổi bật, copy thu hút và đặt ở vị trí "vàng".
-2. **Friction Reduction**: Tối giản số bước trong quy trình đăng ký/thanh toán.
-3. **Social Proof**: Tích hợp testimonial, review và số liệu thực tế để tạo lòng tin.
-
-## 📊 3. ANALYTICS & RETENTION
-1. **Event Tracking**: Theo dõi hành vi người dùng bằng GA4, Mixpanel hoặc PostHog.
-2. **Retention Loops**: Xây dựng các tính năng nhắc nhở, email marketing hoặc thông báo để giữ chân người dùng.
-3. **Virality**: Tích hợp các cơ chế chia sẻ, mời bạn bè để phát triển người dùng tự nhiên.

package/.agent/rules/logging-monitoring.md

@@ -1,22 +0,0 @@
----
-trigger: always_on
----
-
-# LOGGING-MONITORING.MD - System Observability Standards
-
-> **Mục tiêu**: Mọi sự kiện đều phải được theo dõi, mọi lỗi đều phải được cảnh báo trước khi người dùng phát hiện.
-
-## 📝 1. STRUCTURED LOGGING
-1. **JSON Format**: Log phải ở định dạng JSON để dễ dàng parse bằng ELK/Splunk.
-2. **Levels**: Dùng đúng cấp độ: `DEBUG`, `INFO`, `WARN`, `ERROR`, `FATAL`.
-3. **Context**: Mỗi log phải đi kèm `request_id`, `user_id` và `timestamp` ISO 8601.
-
-## 📊 2. METRICS & TELEMETRY
-1. **Business Metrics**: Theo dõi tỷ lệ chuyển đổi, số lượng đơn hàng, v.v.
-2. **System Metrics**: CPU, Memory, Disk I/O, Network Latency.
-3. **Tracing**: Triển khai Distributed Tracing (OpenTelemetry) cho hệ thống Microservices.
-
-## 🚨 3. ALERTING PROTOCOL
-1. **Thresholds**: Thiết lập ngưỡng cảnh báo thông minh, tránh "Alert Fatigue".
-2. **Channels**: Gửi cảnh báo về Slack, Discord hoặc PagerDuty tùy mức độ nghiêm trọng.
-3. **Post-mortem**: Mọi lỗi `FATAL` đều phải có tài liệu phân tích nguyên nhân gốc rễ.

package/.agent/rules/quality-assurance.md

@@ -1,22 +0,0 @@
----
-trigger: always_on
----
-
-# QUALITY-ASSURANCE.MD - Zero-Bug Tolerance Standards
-
-> **Mục tiêu**: Đảm bảo sản phẩm ra đời với chất lượng cao nhất thông qua quy trình kiểm thử nghiêm ngặt.
-
-## 🧪 1. TESTING PYRAMID
-1. **Unit Tests**: Phải bao phủ > 80% logic nghiệp vụ.
-2. **Integration Tests**: Kiểm tra sự phối hợp giữa các module và database.
-3. **E2E Tests**: Kiểm tra các luồng đi quan trọng (Critical Paths) từ góc nhìn người dùng.
-
-## 📉 2. AUTOMATION & CI
-1. **Regression Testing**: Mọi bug mới được phát hiện phải có một bản test đi kèm để tránh lặp lại.
-2. **Performance Testing**: Kiểm tra ngưỡng chịu tải của hệ thống (Load test, Stress test).
-3. **Visual Regression**: Kiểm tra sự thay đổi của giao diện qua các bản build.
-
-## 📋 3. MANUAL REVIEW PROTOCOL
-1. **Double-Check**: Task quan trọng phải được review bởi ít nhất 2 agent khác nhau.
-2. **Edge Cases**: Luôn liệt kê và test các trường hợp biên, dữ liệu rác, mất kết nối mạng.
-3. **Acceptance Criteria**: Chỉ hoàn thành task khi đạt 100% tiêu chí nghiệm thu (AC).

package/.agent/rules/system-reasoning.md

@@ -1,20 +0,0 @@
----
-trigger: always_on
----
-
-# SYSTEM-REASONING.MD - Advanced Logical Standards
-
-> **Mục tiêu**: Nâng tầm tư duy của AI lên cấp độ "Deep Think", đảm bảo các quyết định kỹ thuật luôn dựa trên sự phân tích đa chiều và dài hạn.
-
-## 🧠 1. REASONING PROTOCOLS
-1. **Multi-Perspective Analysis**: Trước khi sửa code, AI phải phân tích tác động dưới góc nhìn: Security, Performance, UI/UX và Maintainability.
-2. **Mental Simulation**: Giả lập các kịch bản lỗi (Edge Cases) và cách hệ thống tự khôi phục trước khi thực thi.
-3. **Long-Horizon Planning**: Mọi giải pháp phải bền vững trong ít nhất 12 tháng phát triển tiếp theo.
-
-## 🛠️ 2. AGENTIC EXECUTION (GLM-5 Style)
-1. **Self-Monitoring**: Agent phải liên tục kiểm tra trạng thái của chính mình và sửa sai ngay khi phát hiện bước trước đó không tối ưu.
-2. **Adaptive Goal Setting**: Nếu mục tiêu ban đầu bị chặn bởi hạ tầng, Agent phải tự tìm con đường thay thế (Alternative Paths).
-
-## 🛡️ 3. ZERO-COMPROMISE ARCHITECTURE
-1. **Modular Sovereignty**: Cấm tuyệt đối code "vòng vo" hay phụ thuộc chéo (Circular Dependencies).
-2. **Contract Compliance**: Chỉ tin vào Hợp đồng dữ liệu (Spec/Interface), không tin vào "phỏng đoán".

package/.agent/rules/ui-design.md

@@ -1,23 +0,0 @@
----
-trigger: glob
-glob: "**/*.{css,scss,less,styled.ts,tailwind.config.js}"
----
-
-# UI-DESIGN.MD - Visual Excellence & Aesthetics
-
-> **Mục tiêu**: Kiến tạo giao diện đẳng cấp, giàu tính nghệ thuật và đồng nhất về ngôn ngữ thiết kế.
-
-## 🎨 1. TYPOGRAPHY & SPACING
-1. **Scale**: Dùng hệ thống lưới 4px hoặc 8px cho mọi khoảng cách (Margin/Padding).
-2. **Hierarchy**: Định nghĩa rõ ràng H1-H6, Body, Label với trọng số (Weight) và kích thước (Line-height) chuẩn.
-3. **Font**: Ưu tiên các Variable Fonts cho web hiện đại để tối ưu hiệu suất.
-
-## 🌈 2. COLOR SYSTEM
-1. **Semantic Colors**: `primary`, `secondary`, `success`, `error`, `warning` phải có độ tương phản (WCAG) tốt.
-2. **Dark Mode**: Mọi giao diện đều phải hỗ trợ Dark Mode một cách tự nhiên (không chỉ đảo ngược màu).
-3. **Glassmorphism**: Dùng hiệu ứng mờ (Blur) và độ trong suốt (Opacity) một cách tinh tế.
-
-## ✨ 3. MICRO-ANIMATIONS
-1. **Transitions**: Mọi trạng thái Hover, Focus đều phải có hiệu ứng mượt mà (Ease-in-out).
-2. **Lottie/SVG**: Dùng các hiệu ứng vector cho các loading hoặc icon tương tác.
-3. **Performance**: Không dùng animation gây giật (jank), ưu tiên dùng `transform` và `opacity`.

package/.agent/rules/ux-patterns.md

@@ -1,23 +0,0 @@
----
-trigger: glob
-glob: "**/*.{js,jsx,ts,tsx}"
----
-
-# UX-PATTERNS.MD - User Experience & Flow Standards
-
-> **Mục tiêu**: Tối ưu hóa hành trình người dùng, giảm thiểu ma sát (friction) và tăng cường sự hài lòng.
-
-## ⚓ 1. NAVIGATION & LAYOUT
-1. **Predictability**: Các thành phần điều hướng (Navbar, Sidebar) phải nằm ở vị trí người dùng mong đợi.
-2. **Breadcrumbs**: Luôn cung cấp đường dẫn cho các trang sâu > 2 cấp.
-3. **Responsiveness**: Tuân thủ Mobile-first, đảm bảo trải nghiệm trên mọi kích thước màn hình.
-
-## ⚡ 2. INTERACTION & FEEDBACK
-1. **Skeleton Screens**: Dùng Skeleton thay cho spinner xoay tròn để tạo cảm giác tốc độ.
-2. **Optimistic UI**: Cập nhật trạng thái ngay lập tức trên UI và đồng bộ với server ngầm.
-3. **Error Prevention**: Validate dữ liệu ngay khi người dùng nhập (Inline validation).
-
-## 🧠 3. ACCESSIBILITY (A11Y)
-1. **Keyboard**: Phải điều hướng được toàn bộ trang bằng phím Tab.
-2. **Screen Readers**: Dùng Semantic HTML (`<header>`, `<main>`, `<footer>`, `aria-label`).
-3. **Focus States**: Trạng thái Focus phải rõ ràng, không được ẩn đi.

package/.agent/scripts/auto_preview.py

@@ -1,148 +0,0 @@
-#!/usr/bin/env python3
-"""
-Auto Preview - Antigravity Kit
-==============================
-Manages (start/stop/status) the local development server for previewing the application.
-
-Usage:
-    python .agent/scripts/auto_preview.py start [port]
-    python .agent/scripts/auto_preview.py stop
-    python .agent/scripts/auto_preview.py status
-"""
-
-import os
-import sys
-import time
-import json
-import signal
-import argparse
-import subprocess
-from pathlib import Path
-
-AGENT_DIR = Path(".agent")
-PID_FILE = AGENT_DIR / "preview.pid"
-LOG_FILE = AGENT_DIR / "preview.log"
-
-def get_project_root():
-    return Path(".").resolve()
-
-def is_running(pid):
-    try:
-        os.kill(pid, 0)
-        return True
-    except OSError:
-        return False
-
-def get_start_command(root):
-    pkg_file = root / "package.json"
-    if not pkg_file.exists():
-        return None
-    
-    with open(pkg_file, 'r') as f:
-        data = json.load(f)
-    
-    scripts = data.get("scripts", {})
-    if "dev" in scripts:
-        return ["npm", "run", "dev"]
-    elif "start" in scripts:
-        return ["npm", "start"]
-    return None
-
-def start_server(port=3000):
-    if PID_FILE.exists():
-        try:
-            pid = int(PID_FILE.read_text().strip())
-            if is_running(pid):
-                print(f"⚠️  Preview already running (PID: {pid})")
-                return
-        except:
-            pass # Invalid PID file
-
-    root = get_project_root()
-    cmd = get_start_command(root)
-    
-    if not cmd:
-        print("❌ No 'dev' or 'start' script found in package.json")
-        sys.exit(1)
-    
-    # Add port env var if needed (simple heuristic)
-    env = os.environ.copy()
-    env["PORT"] = str(port)
-    
-    print(f"🚀 Starting preview on port {port}...")
-    
-    with open(LOG_FILE, "w") as log:
-        process = subprocess.Popen(
-            cmd,
-            cwd=str(root),
-            stdout=log,
-            stderr=log,
-            env=env,
-            shell=True # Required for npm on windows often, or consistent path handling
-        )
-    
-    PID_FILE.write_text(str(process.pid))
-    print(f"✅ Preview started! (PID: {process.pid})")
-    print(f"   Logs: {LOG_FILE}")
-    print(f"   URL: http://localhost:{port}")
-
-def stop_server():
-    if not PID_FILE.exists():
-        print("ℹ️  No preview server found.")
-        return
-
-    try:
-        pid = int(PID_FILE.read_text().strip())
-        if is_running(pid):
-            # Try gentle kill first
-            os.kill(pid, signal.SIGTERM) if sys.platform != 'win32' else subprocess.call(['taskkill', '/F', '/T', '/PID', str(pid)])
-            print(f"🛑 Preview stopped (PID: {pid})")
-        else:
-            print("ℹ️  Process was not running.")
-    except Exception as e:
-        print(f"❌ Error stopping server: {e}")
-    finally:
-        if PID_FILE.exists():
-            PID_FILE.unlink()
-
-def status_server():
-    running = False
-    pid = None
-    url = "Unknown"
-    
-    if PID_FILE.exists():
-        try:
-            pid = int(PID_FILE.read_text().strip())
-            if is_running(pid):
-                running = True
-                # Heuristic for URL, strictly we should save it
-                url = "http://localhost:3000" 
-        except:
-            pass
-            
-    print("\n=== Preview Status ===")
-    if running:
-        print(f"✅ Status: Running")
-        print(f"🔢 PID: {pid}")
-        print(f"🌐 URL: {url} (Likely)")
-        print(f"📝 Logs: {LOG_FILE}")
-    else:
-        print("⚪ Status: Stopped")
-    print("===================\n")
-
-def main():
-    parser = argparse.ArgumentParser()
-    parser.add_argument("action", choices=["start", "stop", "status"])
-    parser.add_argument("port", nargs="?", default="3000")
-    
-    args = parser.parse_args()
-    
-    if args.action == "start":
-        start_server(int(args.port))
-    elif args.action == "stop":
-        stop_server()
-    elif args.action == "status":
-        status_server()
-
-if __name__ == "__main__":
-    main()