anchi-kit 1.2.7 → 1.2.9

package/.agent/workflows/add.md

@@ -0,0 +1,9 @@
+---
+description: ➕ Add new skills or agents to the project
+---
+
+This command installs new components into your project.
+
+1. Run add command
+   // turbo
+   $ npx anchi-kit add {{args}}

package/.agent/workflows/analytics.md

@@ -0,0 +1,9 @@
+---
+description: 📈 View project analytics and metrics
+---
+
+This command shows project statistics and velocity metrics.
+
+1. Run analytics
+   // turbo
+   $ npx anchi-kit analytics

package/.agent/workflows/analyze.md

@@ -0,0 +1,9 @@
+---
+description: 🔍 Analyze impact of changes
+---
+
+This command analyzes the potential impact of changes or specific files.
+
+1. Run analyze
+   // turbo
+   $ npx anchi-kit brain analyze {{args}}

package/.agent/workflows/audit.md

@@ -0,0 +1,9 @@
+---
+description: 📝 Audit AI decision logs
+---
+
+This command reviews the AI's past decisions and execution logs.
+
+1. Run audit
+   // turbo
+   $ npx anchi-kit brain audit

package/.agent/workflows/brain.md

@@ -0,0 +1,9 @@
+---
+description: 🧠 Interact with the AI Brain
+---
+
+This command is the entry point for all cognitive functions (memory, learn, etc).
+
+1. Run brain command
+   // turbo
+   $ npx anchi-kit brain {{args}}

package/.agent/workflows/clean.md

@@ -0,0 +1,59 @@
+---
+description: 🧹 Clean up memory, logs, or reset context
+---
+
+# /clean Workflow for Antigravity
+
+Reset AI context and clean up temporary files.
+
+## Usage
+
+```
+/clean              # Basic context reset
+/clean --memory     # Clear AI memory
+/clean --audit      # Clear audit logs
+/clean --all        # Full cleanup
+```
+
+## Execution Flow
+
+// turbo-all
+
+1. Read @ANTIGRAVITY.md to ensure context
+2. Determine cleanup scope from flags
+3. Execute cleanup:
+   - Default: Reset current session context
+   - --memory: Clear `.ai-memory/` contents
+   - --audit: Clear `.ai-audit/` logs
+   - --all: Both memory and audit
+4. Confirm cleanup completed
+5. Ready for fresh `/start`
+
+## When to Use
+
+| Situation              | Command           |
+| ---------------------- | ----------------- |
+| AI seems confused      | `/clean`          |
+| AI repeating mistakes  | `/clean`          |
+| Starting fresh project | `/clean --all`    |
+| Privacy cleanup        | `/clean --memory` |
+| Disk space             | `/clean --audit`  |
+
+## Output Format
+
+```
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃  🧹 CLEANUP COMPLETE                  ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃  ✓ Session context cleared            ┃
+┃  ✓ [Additional items if --flags]      ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃  Run /start to begin fresh session    ┃
+┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+```
+
+## Safety
+
+- Memory cleanup is NON-REVERSIBLE
+- Consider `/memory snapshot` before cleaning
+- Audit logs may be needed for compliance

package/.agent/workflows/commit.md

@@ -0,0 +1,58 @@
+---
+description: 📝 Git commit with conventional message
+---
+
+# /commit Workflow for Antigravity
+
+Create conventional commits easily.
+
+## Usage
+
+```
+/commit "message"              # Auto-detect type
+/commit "feat: add login"      # Explicit type
+/commit --amend                # Amend last commit
+```
+
+## Execution Flow
+
+// turbo-all
+
+1. Read @ANTIGRAVITY.md for context
+2. Stage changed files
+3. Parse commit message
+4. Apply conventional commit format
+5. Execute git commit
+6. Report result
+
+## Commit Types
+
+| Type       | Description   | Example                    |
+| ---------- | ------------- | -------------------------- |
+| `feat`     | New feature   | `feat: add user dashboard` |
+| `fix`      | Bug fix       | `fix: resolve login error` |
+| `docs`     | Documentation | `docs: update readme`      |
+| `refactor` | Code refactor | `refactor: extract utils`  |
+| `test`     | Add tests     | `test: add user tests`     |
+| `chore`    | Maintenance   | `chore: update deps`       |
+
+## Output Format
+
+```
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃  📝 COMMIT CREATED                    ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃  Type: feat                           ┃
+┃  Message: add user authentication     ┃
+┃  Hash: abc1234                        ┃
+┃  Files: 4 changed                     ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃  Ready to push: git push origin main  ┃
+┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+```
+
+## Safety
+
+- Always shows changed files before commit
+- Requires confirmation for large commits (>10 files)
+- Never auto-pushes without explicit command

package/.agent/workflows/dashboard.md

@@ -0,0 +1,9 @@
+---
+description: 📊 Open the Pulse Dashboard
+---
+
+This command launches the interactive web dashboard.
+
+1. Launch dashboard
+   // turbo
+   $ npx anchi-kit dashboard

package/.agent/workflows/do.md

@@ -0,0 +1,53 @@
+---
+description: 🎯 Execute any task with AI orchestration
+---
+
+# /do Workflow for Antigravity
+
+Universal command that routes to the right agent and skills.
+
+## Usage
+
+```
+/do "Mô tả task của bạn"
+/do "Task" --careful    # Extra validation
+/do "Task" --fast       # Skip reviews
+```
+
+## Execution Flow
+
+// turbo-all
+
+1. **ORCHESTRATION**: Parse intent, analyze risk (Low/Medium/High).
+2. **GROUNDING**: Auto-scan Knowledge Graph for related files (`/scout`).
+3. **PACKS**: Load domain context (Backend, Quality, Blockchain...).
+4. **AGENTS**: Select specialized role (Fullstack, Tester, Architect...).
+5. **SKILLS**: Execute using canonical patterns.
+6. **REPORT**: Verify results overlap with audit logs.
+7. **TRANSPARENCY**: Explain decisions via `/why`.
+
+## Agent Selection
+
+| Keywords                | Primary Agent         |
+| ----------------------- | --------------------- |
+| UI, design, style       | ui-ux-designer        |
+| API, backend, database  | fullstack-developer   |
+| test, spec, coverage    | tester                |
+| bug, error, fix         | debugger              |
+| docs, readme            | docs-manager          |
+| security, auth, payment | security-auditor      |
+| performance, optimize   | performance-optimizer |
+
+## Output Format
+
+```
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃  📋 /do "Task Description"            ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃  Agent: [selected-agent]              ┃
+┃  Skills: [activated-skills]           ┃
+┃  Risk: [LOW/MEDIUM/HIGH]              ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃  [Execution steps and results]        ┃
+┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+```

package/.agent/workflows/doctor.md

@@ -0,0 +1,9 @@
+---
+description: 🚑 Check system health and diagnose issues
+---
+
+This command runs a full system diagnostic to find issues.
+
+1. Run doctor
+   // turbo
+   $ npx anchi-kit doctor

package/.agent/workflows/help.md

@@ -0,0 +1,90 @@
+---
+description: ❓ Show available commands and usage
+---
+
+# /help Workflow for Antigravity
+
+Display available commands and quick reference.
+
+## Usage
+
+```
+/help              # Show all commands
+/help do           # Help for specific command
+/help agents       # List available agents
+/help skills       # List available skills
+```
+
+## Execution Flow
+
+// turbo-all
+
+1. Read @ANTIGRAVITY.md for command reference
+2. Display requested help section
+3. Format as structured table
+
+## Command Reference
+
+### Core Trinity
+
+| Command     | Description                      |
+| ----------- | -------------------------------- |
+| `/start`    | Initialize session, load context |
+| `/do "..."` | Execute any task                 |
+| `/clean`    | Reset context, cleanup           |
+
+### Development
+
+| Command     | Description                    |
+| ----------- | ------------------------------ |
+| `/generate` | Generate code from description |
+| `/test`     | Run tests                      |
+| `/review`   | Code review                    |
+| `/commit`   | Git commit with message        |
+
+### Discovery
+
+| Command  | Description                 |
+| -------- | --------------------------- |
+| `/scout` | Semantic search in codebase |
+| `/why`   | Explain AI's decisions      |
+| `/audit` | View decision history       |
+
+### Design
+
+| Command   | Description           |
+| --------- | --------------------- |
+| `/design` | UI/UX design tasks    |
+| `/theme`  | Theme/styling changes |
+| `/docs`   | Documentation tasks   |
+
+### System
+
+| Command   | Description         |
+| --------- | ------------------- |
+| `/status` | Project status      |
+| `/memory` | Memory management   |
+| `/config` | Configuration       |
+| `/health` | System health check |
+
+## CLI Commands
+
+```bash
+npx anchi-kit              # Setup wizard
+npx anchi-kit doctor       # Health check
+npx anchi-kit dashboard    # Web dashboard
+npx anchi-kit brain        # Memory management
+npx anchi-kit scout        # Semantic search
+```
+
+## Output Format
+
+```
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃  📖 ANCHI-KIT HELP v1.2.0             ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃  23 Commands | 22 Agents | 61 Skills  ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃  [Command tables as above]            ┃
+┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+```

package/.agent/workflows/learn.md

@@ -0,0 +1,9 @@
+---
+description: 📚 Learn from other projects
+---
+
+This command enables cross-project learning and pattern ingestion.
+
+1. Run learn
+   // turbo
+   $ npx anchi-kit brain learn

package/.agent/workflows/memory.md

@@ -0,0 +1,9 @@
+---
+description: 🧠 Manage AI memory and context
+---
+
+This command manages the AI's long-term memory and context storage.
+
+1. Execute the memory command
+   // turbo
+   $ npx anchi-kit memory {{args}}

package/.agent/workflows/patterns.md

@@ -0,0 +1,9 @@
+---
+description: 🧩 Detect and manage code patterns
+---
+
+This command identifies recurring code patterns and architectural violations.
+
+1. Run patterns
+   // turbo
+   $ npx anchi-kit patterns

package/.agent/workflows/scout.md

@@ -0,0 +1,78 @@
+---
+description: 🔍 Semantic search and codebase exploration
+---
+
+# /scout Workflow for Antigravity
+
+Find code by meaning, not just text.
+
+## Usage
+
+```
+/scout "query"           # Semantic search
+/scout --ingest          # Index codebase into graph
+/scout --stats           # Show index statistics
+```
+
+## Execution Flow
+
+// turbo-all
+
+1. Read @ANTIGRAVITY.md for context
+2. Parse search query or flags
+3. Execute:
+   - Query mode: Search vector store
+   - Ingest mode: Scan and index files
+   - Stats mode: Show graph statistics
+4. Return results with file locations
+
+## Examples
+
+```
+/scout "function that handles user login"
+/scout "where is the payment processing logic"
+/scout "component that displays user profile"
+/scout "database connection setup"
+```
+
+## Output Format
+
+### Search Results
+
+```
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃  🔍 SCOUT: "payment processing"       ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃  Found 3 matches:                     ┃
+┃                                       ┃
+┃  1. src/lib/payment.ts (0.92)         ┃
+┃     → processPayment(), refund()      ┃
+┃                                       ┃
+┃  2. src/api/stripe/route.ts (0.87)    ┃
+┃     → POST handler for payments       ┃
+┃                                       ┃
+┃  3. src/hooks/usePayment.ts (0.81)    ┃
+┃     → React hook for payment state    ┃
+┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+```
+
+### Ingest Results
+
+```
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃  📊 SCOUT INGEST COMPLETE             ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃  Files indexed: 127                   ┃
+┃  Nodes created: 543                   ┃
+┃  Edges created: 892                   ┃
+┃  Time: 4.2s                           ┃
+┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+```
+
+## Benefits over grep
+
+| grep             | /scout                            |
+| ---------------- | --------------------------------- |
+| Exact text match | Semantic meaning                  |
+| "login" only     | Finds "authentication", "sign in" |
+| No context       | Understands code structure        |

package/.agent/workflows/start.md

@@ -0,0 +1,23 @@
+---
+description: 🚀 Initialize Anchi-Kit session (auto-loads ANTIGRAVITY.md)
+---
+
+# /start Workflow for Antigravity
+
+This workflow auto-loads the ANTIGRAVITY.md system instructions.
+
+## Steps
+
+// turbo-all
+
+1. Read @ANTIGRAVITY.md to load system instructions
+2. Run /start command to initialize project context
+
+## Result
+
+After running this workflow, AI will:
+
+- Understand your project structure
+- Know available commands (/do, /clean, /help, etc.)
+- Follow Agent/Skill activation rules
+- Use box-style output format

package/.agent/workflows/team.md

@@ -0,0 +1,9 @@
+---
+description: 👥 Manage team roles and configurations
+---
+
+This command manages team settings, roles, and permissions.
+
+1. Execute the team command
+   // turbo
+   $ npx anchi-kit team {{args}}

package/.agent/workflows/test.md

@@ -0,0 +1,42 @@
+---
+description: ✅ Run tests and verify code
+---
+
+# /test Workflow for Antigravity
+
+Run tests and fix issues.
+
+## Usage
+
+```
+/test                # Run all tests
+/test --fix          # Run tests + auto-fix failures
+/test --watch        # Watch mode
+/test --coverage     # With coverage report
+/test [file]         # Specific file
+```
+
+## Execution Flow
+
+// turbo-all
+
+1. Read @ANTIGRAVITY.md for context
+2. Detect test framework (vitest, jest, playwright)
+3. Run tests with specified flags
+4. Parse and format results
+5. If --fix: Attempt to fix failing tests
+
+## Output Format
+
+```
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃  ✅ TEST RESULTS                      ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃  Total: 42 | Pass: 40 | Fail: 2       ┃
+┃  Coverage: 78.5%                      ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃  ❌ user.service.test.ts:45           ┃
+┃     Expected: "active"                ┃
+┃     Received: "pending"               ┃
+┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+```

package/.agent/workflows/tui.md

@@ -0,0 +1,9 @@
+---
+description: 🖥️ Open Terminal UI
+---
+
+This command launches the rich Terminal User Interface.
+
+1. Run TUI
+   // turbo
+   $ npx anchi-kit tui

package/.agent/workflows/uninstall.md

@@ -0,0 +1,9 @@
+---
+description: 🗑️ Uninstall anchi-kit
+---
+
+This command removes anchi-kit from the project.
+
+1. Run uninstall
+   // turbo
+   $ npx anchi-kit uninstall

package/.agent/workflows/update.md

@@ -0,0 +1,9 @@
+---
+description: 🔄 Update anchi-kit to latest version
+---
+
+This command checks for and installs updates.
+
+1. Run update
+   // turbo
+   $ npx anchi-kit update

package/.cursor/agents/security-auditor.md

@@ -0,0 +1,42 @@
+---
+name: security-auditor
+description: Specialized agent for security reviews, vulnerability assessments, and compliance checks. Focuses on OWASP Top 10, sensitive data handling, and secure coding practices.
+model: sonnet
+---
+
+You are a **Security Auditor**, an expert in application security and compliance.
+
+## Core Responsibilities
+
+1.  **Vulnerability Assessment**: Identify potential security flaws (XSS, CSRF, Injection, etc.).
+2.  **Code Review**: Analyze code changes for security implications.
+3.  **Compliance Check**: Ensure adherence to data protection rules (GDPR, PII handling).
+4.  **Configuration Audit**: Verify secure configuration of infrastructure and dependencies.
+
+## Security Standards
+
+- **OWASP Top 10**: Always check for common web vulnerabilities.
+- **Least Privilege**: Ensure permissions are scoped correctly.
+- **Data Protection**: Verify encryption of sensitive data at rest and in transit.
+- **Input Validation**: Ensure all user inputs are sanitized.
+
+## Execution Process
+
+1.  **Analyze**: Read the code/plan focusing purely on security aspects.
+2.  **Identify**: Flag any lines of code that pose a security risk.
+3.  **Verify**: Check against `deploy-guard.yaml` and `data-classification.yaml` rules.
+4.  **Report**: valid/invalid status with specific remediation steps.
+
+## Tools & Skills
+
+- Activate `skills/security` or relevant security packs if available.
+- Use `patterns` to detect known security anti-patterns.
+
+## Output Format
+
+Provide a structured Security Review:
+
+- **Risk Level**: [Low/Medium/High/Critical]
+- **Findings**: List of specific issues.
+- **Recommendations**: Concrete steps to fix.
+- **Approval**: [Approved/Rejected]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anchi-kit",
-  "version": "1.2.7",
+  "version": "1.2.9",
   "description": "The Ultimate AI-Native Toolkit for Cursor & Gemini. Installs into any existing project. Includes commands, agents, skills, and architecture presets.",
   "main": "src/cli.js",
   "bin": {
@@ -63,6 +63,7 @@
     ".antigravity/data-classification.yaml",
     ".antigravity/deploy-guard.yaml",
     ".antigravity/compliance/",
+    ".agent/workflows/",
     "presets/",
     "docs/",
     ".cursorrules",

package/src/commands/init.js

@@ -435,6 +435,16 @@ async function init() {
         }
     }
 
+    // 5. Install .agent/workflows (Enables slash commands in Antigravity)
+    log.info('   🎯 Installing Slash Commands...');
+    const agentWfSource = path.join(kitPath, '.agent/workflows');
+    const agentWfDest = path.join(targetPath, '.agent/workflows');
+    if (fs.existsSync(agentWfSource)) {
+        copyDirRecursive(agentWfSource, agentWfDest);
+        const wfCount = fs.readdirSync(agentWfSource).filter(f => f.endsWith('.md')).length;
+        log.success(`      + .agent/workflows/ (${wfCount} commands)`);
+    }
+
     // Copy MODEL_COSTS.md
     const modelCostsPath = path.join(kitPath, '.cursor/MODEL_COSTS.md');
     if (fs.existsSync(modelCostsPath)) {