@nghiapt/kit 1.0.3 → 1.1.0

package/bin/index.js

@@ -12,7 +12,7 @@ if (process.stdin.isTTY) {
 
 const HEADER = `
 ==========================================
-    Antigravity Kit Setup
+    Antigravity Kit Setup by NghiaPT
 ==========================================
 `;
 
@@ -26,17 +26,14 @@ const LOCAL_DEST = path.join(process.cwd(), '.agent', 'workflows');
 const OPTIONS = [
     {
         label: 'Install Global (Recommended)',
-        desc: 'Copies to ~/.gemini/antigravity/global_workflows',
         action: async () => await installWorkflows(GLOBAL_DEST, 'Global')
     },
     {
-        label: 'Install Only on Context Project',
-        desc: 'Copies to ./.agent/workflows',
+        label: 'Install Only on Current Project',
         action: async () => await installWorkflows(LOCAL_DEST, 'Local Project')
     },
     {
         label: 'Exit',
-        desc: 'Close the setup wizard',
         action: () => process.exit(0)
     }
 ];

package/index.js

@@ -26,17 +26,20 @@ const LOCAL_DEST = path.join(process.cwd(), '.agent', 'workflows');
 const OPTIONS = [
     {
         label: 'Install Global (Recommended)',
-        desc: 'Copies to ~/.gemini/antigravity/global_workflows',
-        action: async () => await installWorkflows(GLOBAL_DEST, 'Global')
+        action: async () => {
+            await installWorkflows(GLOBAL_DEST, 'Global');
+            process.exit(0);
+        }
     },
     {
         label: 'Install Only on Context Project',
-        desc: 'Copies to ./.agent/workflows',
-        action: async () => await installWorkflows(LOCAL_DEST, 'Local Project')
+        action: async () => {
+            await installWorkflows(LOCAL_DEST, 'Local Project');
+            process.exit(0);
+        }
     },
     {
         label: 'Exit',
-        desc: 'Close the setup wizard',
         action: () => process.exit(0)
     }
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nghiapt/kit",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "The 'Native Gemini' Agentic Framework. Turn your IDE into an autonomous coding partner.",
   "main": "./bin/index.js",
   "bin": {

package/core/check_workflows.py

@@ -1,32 +0,0 @@
-import os
-import re
-from pathlib import Path
-
-def check_workflows():
-    workflows_dir = Path(r"d:\antigravity-kit\workflows")
-    print(f"Checking workflows in {workflows_dir}...")
-    
-    passed = 0
-    failed = 0
-    
-    for f in workflows_dir.glob("*.md"):
-        content = f.read_text(encoding='utf-8', errors='ignore')
-        
-        # Check for Frontmatter
-        has_frontmatter = content.strip().startswith("---")
-        
-        # Check for Role/Task (Antigravity Native indicators)
-        has_role = "# Role" in content or "Role:" in content
-        has_task = "# Task" in content or "Task:" in content or "# Process" in content
-        
-        if has_frontmatter:
-            # print(f"✅ {f.name}: Valid Frontmatter")
-            passed += 1
-        else:
-            print(f"⚠️  {f.name}: MISSING Frontmatter (Legacy?)")
-            failed += 1
-            
-    print(f"\nSummary: {passed} Passed, {failed} Potential Legacy Format")
-
-if __name__ == "__main__":
-    check_workflows()

package/core/context.py

@@ -1,70 +0,0 @@
-import os
-from pathlib import Path
-from typing import List, Set
-# No external deps if possible, or use standard lib
-
-# Default ignores
-IGNORED_DIRS = {
-    '.git', '.idea', '.vscode', '__pycache__', 'node_modules', 
-    'venv', 'env', 'dist', 'build', 'coverage', '.next', '.nuxt',
-    '.output', 'target', 'bin', 'obj'
-}
-
-IGNORED_EXTS = {
-    '.pyc', '.pyo', '.pyd', '.so', '.dll', '.exe', '.bin', 
-    '.jpg', '.jpeg', '.png', '.gif', '.ico', '.svg', '.mp4', 
-    '.mp3', '.pdf', '.zip', '.tar', '.gz', '.7z', '.rar',
-    '.db', '.sqlite', '.sqlite3', '.pkl', '.lock'
-}
-
-IGNORED_FILES = {
-    'package-lock.json', 'yarn.lock', 'pnpm-lock.yaml', 'poetry.lock',
-    'Gemfile.lock', 'composer.lock', 'cargo.lock'
-}
-
-def is_ignored(path: Path) -> bool:
-    if path.name in IGNORED_FILES:
-        return True
-    if path.suffix in IGNORED_EXTS:
-        return True
-    # Check parts for ignored dirs
-    if any(part in IGNORED_DIRS for part in path.parts):
-        return True
-    return False
-
-def get_project_files(root_dir: str) -> List[Path]:
-    """Scans the project for text files, respecting ignore rules."""
-    root = Path(root_dir)
-    files = []
-    
-    # Simple walk
-    for dirpath, dirnames, filenames in os.walk(root):
-        # Modify dirnames in-place to prune ignored dirs
-        dirnames[:] = [d for d in dirnames if d not in IGNORED_DIRS and not d.startswith('.')]
-        
-        for f in filenames:
-            p = Path(dirpath) / f
-            if not is_ignored(p):
-                files.append(p)
-                
-    return files
-
-def get_context_string(root_dir: str) -> str:
-    """Generates a massive string containing all project code."""
-    files = get_project_files(root_dir)
-    context = []
-    
-    context.append(f"Project Context (Root: {root_dir})\n")
-    context.append("="*50 + "\n")
-    
-    for f in files:
-        try:
-            relative_path = f.relative_to(root_dir)
-            content = f.read_text(encoding='utf-8', errors='ignore')
-            
-            context.append(f"\n--- FILE: {relative_path} ---\n")
-            context.append(content)
-        except Exception:
-            pass # Skip unreadable
-            
-    return "\n".join(context)

package/core/engine.py

@@ -1,173 +0,0 @@
-import re
-import json
-import os
-import argparse
-from google import genai
-from google.genai import types
-from pathlib import Path
-
-try:
-    from .context import get_context_string
-    from .ops import read_file, write_file
-except ImportError:
-    from context import get_context_string
-    from ops import read_file, write_file
-
-def clean_json(text: str) -> str:
-    # Remove markdown fences ```json ... ```
-    text = re.sub(r"^```json\s*", "", text, flags=re.MULTILINE)
-    text = re.sub(r"^```\s*", "", text, flags=re.MULTILINE)
-    text = re.sub(r"```$", "", text, flags=re.MULTILINE)
-    return text.strip()
-
-
-# Load Config
-CONFIG_PATH = Path(__file__).parent.parent / ".antigravity" / "config.json"
-try:
-    with open(CONFIG_PATH, 'r') as f:
-        CONFIG = json.load(f)
-    API_KEY = CONFIG.get("api_key") or os.getenv("GEMINI_API_KEY")
-    MODEL_NAME = CONFIG.get("model", "gemini-2.0-flash-exp")
-except Exception:
-    API_KEY = os.getenv("GEMINI_API_KEY")
-    MODEL_NAME = "gemini-2.0-flash-exp"
-
-def parse_workflow(content: str) -> tuple[dict, str]:
-    if content.startswith("---"):
-        parts = re.split(r"^---$", content, maxsplit=2, flags=re.MULTILINE)
-        if len(parts) >= 3:
-            try:
-                metadata = {}
-                for line in parts[1].strip().split('\n'):
-                    if ':' in line:
-                        k, v = line.split(':', 1)
-                        metadata[k.strip()] = v.strip()
-                return metadata, parts[2].strip()
-            except Exception:
-                pass
-    return {}, content.strip()
-
-
-# RUNTIME INJECTION: Turns Docs into Agents
-ANTIGRAVITY_PROTOCOL = """
-# ANTIGRAVITY AGENT PROTOCOL (SYSTEM OVERRIDE)
-
-You are an autonomous AI Agent running inside the Antigravity Kit.
-The text below is not just documentation; it is your **OPERATIONAL MANUAL**.
-
-## YOUR MANDATE:
-1.  **ACT, DON'T JUST READ**: If the user instruction is a command (e.g., "Build this"), execute it using the Manual's best practices.
-2.  **CONTEXT ACCESS**: You have full access to `[PROJECT CONTEXT]`. Read it to understand the codebase.
-    - **Do NOT** ask for file permissions.
-    - **Do NOT** hallucinate paths. Use `list_dir` to confirm.
-3.  **TOOLS**: Use `run_command` to install/build, `write_to_file` to code.
-4.  **CHAINING**: If a task is too complex, output a request to chain another agent using `python core/engine.py [workflow]`.
-
-## MANUAL CONTENT START
---------------------------------------------------
-{workflow_content}
---------------------------------------------------
-## MANUAL CONTENT END
-"""
-
-def load_workflow(name: str) -> tuple[dict, str]:
-    base_dir = Path(__file__).parent.parent
-    path = base_dir / "workflows" / f"{name}.md"
-    if not path.exists():
-        return {}, f"Error: Workflow '{name}' not found."
-    
-    raw_content = read_file(str(path))
-    metadata, stripped_content = parse_workflow(raw_content)
-    
-    # INJECT PROTOCOL
-    system_prompt = ANTIGRAVITY_PROTOCOL.format(workflow_content=stripped_content)
-    
-    return metadata, system_prompt
-
-
-def call_gemini(system_instruction: str, user_prompt: str, json_mode: bool = False) -> str:
-    if not API_KEY:
-        return "Error: GEMINI_API_KEY environment variable not set."
-    try:
-        client = genai.Client(api_key=API_KEY)
-        
-        config = types.GenerateContentConfig(
-            system_instruction=system_instruction
-        )
-        
-        if json_mode:
-            config.response_mime_type = "application/json"
-
-        response = client.models.generate_content(
-            model=MODEL_NAME,
-            contents=user_prompt,
-            config=config
-        )
-        return response.text
-    except Exception as e:
-        return f"Error calling Gemini: {e}"
-
-def execute_workflow(workflow_name: str, user_request: str, project_context: str) -> str:
-    print(f"\n🚀 Executing Workflow: {workflow_name}...")
-    metadata, system_prompt = load_workflow(workflow_name)
-    if "Error" in system_prompt:
-        return system_prompt
-
-    full_prompt = f"""
-    [PROJECT CONTEXT]
-    {project_context}
-    
-    [USER REQUEST]
-    {user_request}
-    """
-    
-    json_mode = metadata.get("output", "").lower() == "json"
-    response = call_gemini(system_prompt, full_prompt, json_mode=json_mode)
-    print(f"✅ {workflow_name} Completed.")
-    return response
-
-def main():
-    parser = argparse.ArgumentParser(description="Antigravity Universal Runner")
-    parser.add_argument("workflow", help="Name of the workflow (or 'orchestrator')")
-    parser.add_argument("prompt", help="User Input")
-    args = parser.parse_args()
-    
-    cwd = os.getcwd()
-    print(f"Loading Context from {cwd}...")
-    context = get_context_string(cwd)
-    
-    # ORCHESTRATOR LOGIC
-    if args.workflow == "orchestrator":
-        plan_json = execute_workflow("orchestrator", args.prompt, context)
-        try:
-            # Clean before parsing
-            cleaned_json = clean_json(plan_json)
-            plan = json.loads(cleaned_json)
-            
-            print(f"\n📋 Orchestrator Plan: {plan.get('thought_process', '')}")
-            
-            # Chain Execution
-            previous_output = ""
-            for step in plan.get("steps", []):
-
-                step_workflow = step.get("workflow")
-                step_instruction = step.get("instruction")
-                
-                # Append previous output to history/instruction
-                if previous_output:
-                    step_instruction += f"\n\n[PREVIOUS AGENT OUTPUT]\n{previous_output}"
-                
-                output = execute_workflow(step_workflow, step_instruction, context)
-                previous_output = output # Chain it
-                
-                print(f"\n--- Output of {step_workflow} ---\n{output[:500]}...\n")
-                
-        except json.JSONDecodeError:
-            print("Error: Orchestrator failed to return valid JSON.")
-            print(plan_json)
-    else:
-        # SINGLE RUN
-        print(execute_workflow(args.workflow, args.prompt, context))
-
-if __name__ == "__main__":
-    main()

package/core/ops.py

@@ -1,39 +0,0 @@
-import os
-import subprocess
-from pathlib import Path
-
-def read_file(path: str) -> str:
-    """Reads a file and returns its content. Returns error string if failed."""
-    try:
-        with open(path, 'r', encoding='utf-8') as f:
-            return f.read()
-    except Exception as e:
-        return f"Error reading {path}: {e}"
-
-def write_file(path: str, content: str) -> bool:
-    """Writes content to a file. Creates parent directories if needed."""
-    try:
-        p = Path(path)
-        p.parent.mkdir(parents=True, exist_ok=True)
-        with open(p, 'w', encoding='utf-8') as f:
-            f.write(content)
-        return True
-    except Exception as e:
-        print(f"Error writing {path}: {e}")
-        return False
-
-def run_command(command: str, cwd: str = ".") -> tuple[str, str, int]:
-    """Runs a shell command and returns (stdout, stderr, return_code)."""
-    try:
-        result = subprocess.run(
-            command,
-            cwd=cwd,
-            shell=True,
-            capture_output=True,
-            text=True,
-            encoding='utf-8',
-            errors='replace'
-        )
-        return result.stdout, result.stderr, result.returncode
-    except Exception as e:
-        return "", str(e), -1

package/core/optimize_workflows_bulk.py

@@ -1,45 +0,0 @@
-import os
-import re
-from pathlib import Path
-
-def optimize_file(path: Path):
-    content = path.read_text(encoding='utf-8', errors='ignore')
-    original_content = content
-    
-    # 1. Branding Replacement
-    content = content.replace("Claude" + "Kit", "Antigravity Kit")
-    content = content.replace("ported from Claude Kit", "Native Gemini Framework")
-    content = content.replace(".claude/", ".antigravity/")
-    
-    # 2. Frontmatter Injection
-    if not content.strip().startswith("---"):
-        # Synthesize frontmatter
-        description = "Antigravity Workflow"
-        # Try to grab first line description if available
-        lines = content.strip().split('\n')
-        if lines and lines[0].startswith('# '):
-             # Skip title
-             pass
-        
-        content = f"---\ndescription: {description}\noutput: markdown\n---\n\n" + content
-    
-    # 3. Role Injection (If missing)
-    if not ("# Role" in content or "Role:" in content):
-        content = content.replace("---\n\n", "---\n\n# Role\nYou are an expert AI agent specializing in this workflow.\n\n")
-
-    # 4. Save if changed
-    if content != original_content:
-        path.write_text(content, encoding='utf-8')
-        print(f"✅ Optimized: {path.name}")
-    else:
-        print(f"Start: {path.name} (No changes)")
-
-def main():
-    workflows_dir = Path(r"d:\antigravity-kit\workflows")
-    print("Starting Bulk Optimization...")
-    for f in workflows_dir.glob("*.md"):
-        optimize_file(f)
-    print("Optimization Complete.")
-
-if __name__ == "__main__":
-    main()

package/core/state_manager.py

@@ -1,38 +0,0 @@
-import os
-import json
-import tempfile
-from pathlib import Path
-
-STATE_FILE = Path(tempfile.gettempdir()) / "antigravity_state.json"
-
-def load_state():
-    if not STATE_FILE.exists():
-        return {}
-    try:
-        with open(STATE_FILE, 'r') as f:
-            return json.load(f)
-    except:
-        return {}
-
-def save_state(state):
-    with open(STATE_FILE, 'w') as f:
-        json.dump(state, f, indent=2)
-
-def set_active_plan(plan_path):
-    state = load_state()
-    state["active_plan"] = str(Path(plan_path).resolve())
-    save_state(state)
-    print(f"Active plan set to: {state['active_plan']}")
-
-def get_active_plan():
-    state = load_state()
-    return state.get("active_plan")
-
-if __name__ == "__main__":
-    import sys
-    if len(sys.argv) > 2 and sys.argv[1] == "set":
-        set_active_plan(sys.argv[2])
-    elif len(sys.argv) > 1 and sys.argv[1] == "get":
-        print(get_active_plan() or "None")
-    else:
-        print("Usage: python state_manager.py [set <path> | get]")

package/core/upgrade_workflows_batch.py

@@ -1,50 +0,0 @@
-import os
-from pathlib import Path
-
-# The Header that turns any doc into an Agent
-ANTIGRAVITY_HEADER = """
-# Antigravity Native Protocol
-> **SYSTEM OVERRIDE**: Use the following rules as your Primary Directive.
-
-1.  **Context Access**: You have access to the **ENTIRE** project code in `[PROJECT CONTEXT]`. Read it to understand the codebase. Do not ask for files.
-2.  **Agentic Behavior**: You are NOT a documentation reader. You are an **ACTOR**.
-    - If the user asks for code, **WRITE IT**.
-    - If the user asks for a fix, **RUN THE TEST** and **FIX IT**.
-3.  **Automation**: Use `run_command` freely to install, build, and test.
-4.  **Chaining**: If you need to switch modes (e.g., from Planning to Coding), use `python core/engine.py [workflow_name]`.
-
----
-"""
-
-def upgrade_workflows():
-    workflows_dir = Path(r"d:\antigravity-kit\workflows")
-    
-    # Files we already manually fixed or shouldn't touch
-    skip_list = ["template_agent.md", "backend-development.md", "fix-bugs.md", "orchestrator.md", "planning.md", "router.md"]
-
-    for f in workflows_dir.glob("*.md"):
-        if f.name in skip_list:
-            continue
-            
-        content = f.read_text(encoding='utf-8', errors='ignore')
-        
-        # Avoid double injection
-        if "# Antigravity Native Protocol" in content:
-            print(f"Skipping {f.name} (Already Upgraded)")
-            continue
-        
-        # Inject after Frontmatter
-        if content.startswith("---"):
-            # Find end of frontmatter
-            parts = content.split("---", 2)
-            if len(parts) >= 3:
-                new_content = f"---{parts[1]}---\n{ANTIGRAVITY_HEADER}\n{parts[2]}"
-                f.write_text(new_content, encoding='utf-8')
-                print(f"🚀 Upgraded: {f.name}")
-        else:
-            # No frontmatter? Just prepend.
-            f.write_text(ANTIGRAVITY_HEADER + content, encoding='utf-8')
-            print(f"🚀 Upgraded: {f.name}")
-
-if __name__ == "__main__":
-    upgrade_workflows()

package/rules/.clinerules

@@ -1,17 +0,0 @@
-# Antigravity Kit - Default Rules
-
-This file defines the operating procedures for this project, powered by Antigravity Kit.
-
-## 1. Context Intelligence
-- **Rule:** Before reading any massive folder, run `context-optimizer`.
-- **Action:** Use `python ~/.gemini/antigravity/antigravity-kit/core/context_scout.py .` to see what you are dealing with.
-
-## 2. Smart Routing
-- **Rule:** If unsure which workflow to use, use the router.
-- **Action:** `/router`
-
-## 3. State Management
-- **Rule:** Always check if there is an active plan before starting.
-- **Action:** `python ~/.gemini/antigravity/antigravity-kit/core/state_manager.py get`
-- **Rule:** When creating a plan, register it.
-- **Action:** `python ~/.gemini/antigravity/antigravity-kit/core/state_manager.py set "path/to/plan.md"`

package/rules/antigravity_global.md

@@ -1,45 +0,0 @@
-# Antigravity Global Rules
-
-I am an Antigravity Agent, powered by Gemini. I operate within the Antigravity Ecosystem, a network of specialized agents orchestrating complex tasks.
-
-## 1. Identity & Context
-- **I am "Antigravity Native":** I prioritize Gemini's strengths (Long Context, Multimodality).
-- **I am a Node:** I may be working alone or as part of a chain (orchestrated by `workflows/orchestrator.md`).
-- **Context Awareness:** 
-    - Always check for `memory-bank/activeContext.md` to understand the bigger picture.
-    - If I see `[PREVIOUS AGENT OUTPUT]` in my prompt, I treat it as the absolute source of truth for my inputs.
-
-## 2. Multi-Agent Coordination Protocol
-When working on a complex task, I do NOT try to do everything at once. I Delegate.
-
-### Using the Engine
-To perform specialized tasks, I use the Antigravity Engine:
-```bash
-python core/engine.py [workflow] "[instruction]"
-```
-
-**Common Workflows:**
-- `orchestrator`: For complex, multi-step goals. ("Build a X feature")
-- `planner`: For architectural decisions. ("How should we structure X?")
-- `builder`: For implementation. ("Write the code for X plan")
-- `code-review`: For auditing. ("Check this file for bugs")
-
-### The "Chain" Mindset
-- **Output:** My final response should be clear and structured so the *next* agent can parse it.
-- **State:** I verify `memory-bank/progress.md` before claiming a task is done.
-
-## 3. Tech Stack & Best Practices
-- **Frontend:** React, Tailwind CSS, Shadcn UI (unless specified otherwise).
-- **Backend:** Python (FastAPI) or Node.js (Next.js API Routes).
-- **Files:**
-    - verify file existence before editing.
-    - use `python core/engine.py builder` for large-scale scaffolding.
-
-## 4. "One Shot" reliability
-- **Think before acting:** If a user request is vague, use `/research` or `/planner` first.
-- **Verify:** Always run a quick test (or `python core/engine.py debugging`) after writing code.
-- **No Hallucinations:** I do not guess file paths. I use `list_dir` or `view_file` to confirm.
-
-## 5. Security & IP
-- I NEVER output code containing proprietary markers from the legacy port.
-- I maintain strict adherence to the **Antigravity Native** architecture.