anchi-kit 1.2.0 → 1.2.2

package/.antigravity/workflows/clean.md

@@ -0,0 +1,333 @@
+---
+description: 🧹 Self-healing and system cleanup
+argument-hint: [optional: --memory | --audit | --config | --all]
+---
+
+# /clean - Self-Healing System
+
+**What:** Auto-clean stale memory, audit logs, reset failure modes, and optimize system state.
+
+## Usage
+
+```
+/clean                    # Quick cleanup (safe defaults)
+/clean --memory           # Clean only memory files
+/clean --audit            # Archive old audit logs
+/clean --config           # Reset to default config
+/clean --all              # Deep cleanup (ask confirmation)
+/clean --dry-run          # Preview what will be cleaned
+```
+
+---
+
+## 💰 Model Selection
+
+| Mode        | Recommended Model  | Cost      |
+| ----------- | ------------------ | --------- |
+| Quick clean | GPT-5.1 Codex Mini | 💚 Low    |
+| Deep clean  | Sonnet 4.5         | 💛 Medium |
+
+> Cleanup is mostly file operations - use cheap models.
+
+---
+
+## Logic
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ 🧹 /clean - SELF-HEALING SYSTEM                             │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  [1] SCAN System Health:                                    │
+│      ├── Check .ai-memory/ for stale sessions (>30 days)   │
+│      ├── Check .ai-audit/ for old logs (>30 days)          │
+│      ├── Check .cursor/failure-modes.yaml for conflicts    │
+│      └── Check tmp files and cache                         │
+│                                                             │
+│  [2] ANALYZE What Needs Cleaning:                          │
+│      ├── Stale memory files: N files                       │
+│      ├── Old audit logs: N files                           │
+│      ├── Orphaned config: N items                          │
+│      └── Cache size: X MB                                  │
+│                                                             │
+│  [3] PROMPT User (if not --all):                           │
+│      "Found items to clean. Continue? [Y/n/select]"        │
+│                                                             │
+│  [4] EXECUTE Cleanup:                                      │
+│      ├── Archive old memories → .ai-memory/archive/        │
+│      ├── Archive old audits → .ai-audit/archive/           │
+│      ├── Reset failure modes (if conflicts)                │
+│      └── Clear cache                                       │
+│                                                             │
+│  [5] VERIFY System Health:                                 │
+│      ├── Memory usage: Before → After                      │
+│      ├── Files cleaned: N files                            │
+│      └── Health score: 95/100 ✅                           │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Output
+
+```
+🧹 /clean
+
+═══════════ SYSTEM CLEANUP ═══════════
+
+🔍 Scanning...
+
+📊 Found Issues:
+  • Stale memory: 12 files (450MB)
+  • Old audit logs: 25 files (>30 days)
+  • Cache: 320MB
+
+📋 Cleanup Plan:
+  [1] Archive .ai-memory/session-2024-11-*.json → archive/
+  [2] Archive .ai-audit/2024-11-*.jsonl → archive/
+  [3] Clear cache/temp files
+
+💾 Space to recover: 770MB
+
+👉 Continue? [Y/n/select]
+
+─────────────────────────────────────
+
+✅ Cleanup Complete!
+
+📊 Results:
+  ✅ Archived 12 memory files
+  ✅ Archived 25 audit logs
+  ✅ Cleared 320MB cache
+
+💾 Space freed: 770MB
+🎯 System health: 95/100 ✅
+
+📁 Archives:
+  • .ai-memory/archive/2024-11.tar.gz
+  • .ai-audit/archive/2024-11.tar.gz
+```
+
+---
+
+## Cleanup Targets
+
+### 1. Memory Cleanup (`--memory`)
+
+```
+Targets:
+  • .ai-memory/session-*.json (older than 30 days)
+  • .ai-memory/feature_status.json (stale entries)
+  • .ai-memory/context.json (orphaned references)
+
+Actions:
+  • Archive to .ai-memory/archive/YYYY-MM.tar.gz
+  • Keep last 30 days + current session
+```
+
+### 2. Audit Cleanup (`--audit`)
+
+```
+Targets:
+  • .ai-audit/*.jsonl (older than 30 days)
+  • .ai-audit/summary.json (recalculate)
+
+Actions:
+  • Archive to .ai-audit/archive/YYYY-MM.tar.gz
+  • Regenerate summary.json
+```
+
+### 3. Config Cleanup (`--config`)
+
+```
+Targets:
+  • .cursor/anchi-toolkit.config.yaml (conflicts)
+  • .cursor/failure-modes.yaml (duplicates)
+  • .cursor/orchestration.yaml (validate)
+
+Actions:
+  • Validate YAML syntax
+  • Remove duplicate rules
+  • Reset to defaults if corrupted
+```
+
+### 4. Cache Cleanup (Automatic)
+
+```
+Targets:
+  • node_modules/.cache/
+  • .next/cache/
+  • .turbo/
+  • tmp/
+
+Actions:
+  • Clear all cache directories
+  • Keep package-lock.json intact
+```
+
+---
+
+## Flags
+
+| Flag        | Action                               |
+| ----------- | ------------------------------------ |
+| `--memory`  | Clean only memory files              |
+| `--audit`   | Clean only audit logs                |
+| `--config`  | Reset config to defaults             |
+| `--all`     | Deep cleanup (confirmation required) |
+| `--dry-run` | Preview without executing            |
+| `--force`   | Skip confirmation                    |
+| `--keep N`  | Keep last N days (default: 30)       |
+
+---
+
+## Safety Features
+
+```yaml
+safety:
+  never_delete:
+    - Current session memory
+    - Last 7 days audit logs
+    - Active config files
+    - package.json, package-lock.json
+
+  always_archive:
+    - Old memory → .ai-memory/archive/
+    - Old audits → .ai-audit/archive/
+
+  rollback:
+    - Archives kept for 90 days
+    - Can restore with /undo
+```
+
+---
+
+## Examples
+
+**Quick cleanup:**
+
+```bash
+/clean
+# Cleans safe targets, asks confirmation
+```
+
+**Preview mode:**
+
+```bash
+/clean --dry-run
+# Shows what would be cleaned
+```
+
+**Memory only:**
+
+```bash
+/clean --memory
+# Cleans only .ai-memory/ folder
+```
+
+**Deep cleanup:**
+
+```bash
+/clean --all --force
+# Cleans everything without asking
+```
+
+**Custom retention:**
+
+```bash
+/clean --keep 60
+# Keep last 60 days instead of 30
+```
+
+---
+
+## Agent & Skill Activation
+
+### Dynamic Agent Selection
+
+**Primary Agents:**
+
+```yaml
+default: project-manager
+conditionals:
+  - if: "--memory" → docs-manager (memory expert)
+  - if: "--audit" → failure-analyst (log expert)
+  - if: "--config" → project-manager (config expert)
+  - if: "--all" → project-manager + file-organizer
+```
+
+**Skills (Auto-Activated):**
+
+- `file-organizer/` - Smart file management
+- `document-skills/` - YAML validation
+- `debugging/` - System health check
+- `kaizen/` - Continuous improvement
+
+---
+
+## 🔄 Dynamic Orchestration
+
+> **AI MUST read orchestration config before execution**
+
+```
+1. READ .cursor/agent-skill-index.yaml
+2. CHECK command_mapping for this command
+3. DETECT cleanup mode from flags
+4. ACTIVATE appropriate agents:
+   - Default: project-manager
+   - --memory: docs-manager
+   - --audit: failure-analyst
+5. ACTIVATE skills:
+   - file-organizer/ (always)
+   - document-skills/ (for config)
+6. CHECK .cursor/failure-modes.yaml
+7. LOG decision to .ai-audit/
+```
+
+📖 [docs/ORCHESTRATION_RUNTIME.md](../docs/ORCHESTRATION_RUNTIME.md)
+
+---
+
+## Replaces
+
+```
+/clean replaces:
+  • /cleanup
+  • /reset
+  • /clear:memory
+  • /clear:cache
+
+Total: 4+ commands → 1 command
+```
+
+---
+
+## Health Metrics
+
+After cleanup, system reports:
+
+```
+📊 System Health: 95/100
+
+✅ Memory: Optimal (< 500MB)
+✅ Audit: Organized (30 days retention)
+✅ Config: Valid (no conflicts)
+✅ Cache: Clear (< 100MB)
+
+💡 Next cleanup recommended: in 30 days
+```
+
+---
+
+## Rollback
+
+If cleanup causes issues:
+
+```bash
+/undo
+# Restores from archives
+
+# Or manual:
+.ai-memory/archive/2024-12.tar.gz → extract to .ai-memory/
+```

package/.antigravity/workflows/health.md

@@ -0,0 +1,228 @@
+---
+description: 🏥 Project health check - Security, Performance, Bugs, Tests
+argument-hint: [optional: --robot for JSON output]
+---
+
+# /health - Project Health Check
+
+**Proactive health monitoring for your codebase.**
+
+---
+
+## 🧠 EXECUTION FLOW
+
+```
+STEP 1: SCAN PROJECT
+        → Analyze package.json, config files, source code
+        ↓
+STEP 2: RUN CHECKS
+        → Security: dependencies, secrets, auth patterns
+        → Performance: N+1, caching, pagination
+        → Bugs: error handling, edge cases, types
+        → Tests: coverage, failing tests
+        ↓
+STEP 3: CALCULATE HEALTH SCORE
+        → Each category: 0-100
+        → Overall: weighted average
+        ↓
+STEP 4: GENERATE RECOMMENDATIONS
+        → Priority-ordered action items
+        ↓
+STEP 5: OUTPUT
+        → Box format (default) or JSON (--robot)
+```
+
+---
+
+## 📋 OUTPUT FORMAT (Default)
+
+```
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃  🏥 PROJECT HEALTH                             ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃  📁 Project: {project_name}                    ┃
+┃  📊 Health Score: {score}/100                  ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃  🔐 Security: {✅ OK | ⚠️ Warning | ❌ Critical}┃
+┃  ⚡ Performance: {status}                      ┃
+┃  🐛 Bugs: {status}                             ┃
+┃  🧪 Tests: {coverage}% coverage                ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃  💡 Recommendations:                           ┃
+┃    1. {recommendation_1}                       ┃
+┃    2. {recommendation_2}                       ┃
+┃    3. {recommendation_3}                       ┃
+┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+```
+
+---
+
+## 🤖 ROBOT PROTOCOL (--robot flag)
+
+For AI agent consumption:
+
+```json
+{
+  "command": "/health",
+  "timestamp": "2024-12-28T22:30:00Z",
+  "project": {
+    "name": "my-app",
+    "path": "/path/to/project",
+    "stack": ["nextjs", "prisma", "typescript"]
+  },
+  "health": {
+    "overall": 78,
+    "security": {
+      "score": 85,
+      "status": "ok",
+      "issues": []
+    },
+    "performance": {
+      "score": 65,
+      "status": "warning",
+      "issues": [
+        { "type": "n_plus_one", "file": "src/api/users.ts", "line": 45 },
+        { "type": "missing_pagination", "file": "src/api/posts.ts" }
+      ]
+    },
+    "bugs": {
+      "score": 80,
+      "status": "ok",
+      "issues": []
+    },
+    "tests": {
+      "score": 78,
+      "coverage": 78,
+      "passing": 45,
+      "failing": 2,
+      "skipped": 3
+    }
+  },
+  "recommendations": [
+    {
+      "priority": 1,
+      "category": "performance",
+      "action": "Fix N+1 query in users API"
+    },
+    {
+      "priority": 2,
+      "category": "performance",
+      "action": "Add pagination to posts listing"
+    },
+    { "priority": 3, "category": "tests", "action": "Fix 2 failing tests" }
+  ],
+  "next_actions": ["Fix N+1 in src/api/users.ts:45"]
+}
+```
+
+---
+
+## 🔍 HEALTH CHECKS
+
+### 🔐 Security Checks
+
+| Check                    | Detection                     | Severity |
+| ------------------------ | ----------------------------- | -------- |
+| Hardcoded secrets        | Regex for API keys, passwords | CRITICAL |
+| Outdated dependencies    | npm audit                     | HIGH     |
+| Missing input validation | No zod/yup usage              | MEDIUM   |
+| Missing auth on routes   | Public API endpoints          | HIGH     |
+| No rate limiting         | Missing rate-limit middleware | MEDIUM   |
+
+### ⚡ Performance Checks
+
+| Check              | Detection                        | Severity |
+| ------------------ | -------------------------------- | -------- |
+| N+1 queries        | Loop with DB calls               | HIGH     |
+| Missing pagination | Large findMany without take/skip | HIGH     |
+| No caching         | Repeated identical queries       | MEDIUM   |
+| Missing indexes    | Schema without indexes           | MEDIUM   |
+| Large bundle       | > 500KB initial load             | LOW      |
+
+### 🐛 Bug Risk Checks
+
+| Check                  | Detection                  | Severity |
+| ---------------------- | -------------------------- | -------- |
+| Missing error handling | catch without handling     | MEDIUM   |
+| TypeScript `any` usage | Explicit any types         | LOW      |
+| Missing null checks    | Optional chaining not used | MEDIUM   |
+| Unhandled promises     | .then without .catch       | MEDIUM   |
+
+### 🧪 Test Checks
+
+| Check                  | Detection             | Severity |
+| ---------------------- | --------------------- | -------- |
+| Low coverage           | < 50%                 | HIGH     |
+| Failing tests          | npm test fails        | CRITICAL |
+| Missing critical tests | No auth/payment tests | HIGH     |
+| Outdated snapshots     | Stale snapshot files  | LOW      |
+
+---
+
+## 🎯 HEALTH SCORE CALCULATION
+
+```
+Overall = (0.30 × Security) + (0.25 × Performance) + (0.25 × Bugs) + (0.20 × Tests)
+```
+
+| Score  | Status     | Color |
+| ------ | ---------- | ----- |
+| 90-100 | Excellent  | 🟢    |
+| 70-89  | Good       | 🟡    |
+| 50-69  | Needs Work | 🟠    |
+| 0-49   | Critical   | 🔴    |
+
+---
+
+## ⚡ EXAMPLES
+
+### Basic Health Check
+
+```
+User: /health
+
+Output:
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃  🏥 PROJECT HEALTH                             ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃  📁 Project: my-app                            ┃
+┃  📊 Health Score: 78/100 🟡                    ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃  🔐 Security: ✅ OK (85)                       ┃
+┃  ⚡ Performance: ⚠️ Warning (65)               ┃
+┃  🐛 Bugs: ✅ OK (80)                           ┃
+┃  🧪 Tests: 78% coverage                        ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃  💡 Top 3 Recommendations:                     ┃
+┃    1. 🔴 Fix N+1 query in users API            ┃
+┃    2. 🟡 Add pagination to posts               ┃
+┃    3. 🟡 Fix 2 failing tests                   ┃
+┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+```
+
+### Robot Output for AI
+
+```
+User: /health --robot
+
+AI receives JSON → parses → prioritizes fixes → executes
+```
+
+---
+
+## 🔗 INTEGRATION WITH /do
+
+When AI runs `/do` on HIGH risk tasks, it should:
+
+1. Run `/health` first to understand current state
+2. Check if task will improve or degrade health
+3. Include health impact in report
+
+---
+
+## 📚 SKILLS ACTIVATED
+
+- `performance-patterns/` - N+1, pagination detection
+- `security-audit/` - Vulnerability scanning
+- `code-quality/` - Bug risk analysis
+- `test-driven-development/` - Test coverage

package/.cursor/compliance/audit-standard.yaml

@@ -0,0 +1,70 @@
+# ============================================
+# Audit Logging Standard
+# ============================================
+# Format standard for security & compliance logs
+
+# ============================================
+# Standard JSON Structure
+# ============================================
+log_format:
+  timestamp: "ISO-8601 (UTC)"
+  level: "INFO | WARN | ERROR | FATAL"
+  service: "Service Name"
+
+  # Context (Who/Where)
+  context:
+    user_id: "Hash/UUID (Never plain PII)"
+    ip_address: "Masked (e.g., 192.168.x.x)"
+    request_id: "UUID"
+    session_id: "UUID"
+
+  # Action (What)
+  diff:
+    action: "CREATE | UPDATE | DELETE | READ"
+    resource: "Table/File Name"
+    target_id: "Resource ID"
+    changes: "JSON diff (Redacted)"
+
+  # Metadata
+  meta:
+    latency_ms: 123
+    status_code: 200
+    risk_score: 0-100
+
+# ============================================
+# Required Events to Log
+# ============================================
+mandatory_events:
+  security:
+    - "Login success/failure"
+    - "Password reset"
+    - "2FA configuration"
+    - "API Key generation"
+
+  data:
+    - "Bulk export"
+    - "Bulk delete"
+    - "Schema change"
+    - "Permission elevation"
+
+  system:
+    - "Deployment"
+    - "Config change"
+    - "Server restart"
+
+# ============================================
+# Anchi-Kit Implementation
+# ============================================
+# Config cho auditLogger.js
+
+implementation:
+  output: "JSON"
+  pii_redaction: "Strict"
+  destination:
+    - "Console (Dev)"
+    - "File (.ai-audit/audit.log)"
+    - "Remote (Datadog/Splunk) - Configurable"
+
+  integrity_check:
+    enabled: true
+    hashing: "SHA-256 chain per log entry"

package/.cursor/compliance/data-retention.yaml

@@ -0,0 +1,55 @@
+# ============================================
+# Data Retention Policy
+# ============================================
+# Guidelines for data lifecycle management
+
+policies:
+  # 🔴 Application Logs
+  app_logs:
+    retention_period: "30 days"
+    action_after: "Delete"
+    storage: "Encrypted S3 / CloudWatch"
+    pii_handling: "Redacted at source"
+
+  # 🟠 Audit Logs (Security)
+  audit_logs:
+    retention_period: "1 year"
+    action_after: "Archive to Cold Storage"
+    requirement: "Immutable"
+    content: ["Login attempts", "Permission changes", "Data exports"]
+
+  # 🟡 User Activity Data
+  user_activity:
+    retention_period: "2 years"
+    action_after: "Anonymize"
+    purpose: "Analytics & Improvement"
+
+  # 🟢 Backups
+  database_backups:
+    daily: "7 days"
+    weekly: "4 weeks"
+    monthly: "12 months"
+    encryption: "Required (AES-256)"
+
+# ============================================
+# AI Automation Checks
+# ============================================
+automation:
+  # Check if Cleanup Cron Jobs exist
+  cron_checks:
+    - pattern: "log cleanup"
+    - pattern: "delete old records"
+    - pattern: "archive data"
+
+  # Check Database Schema for timestamps
+  schema_checks:
+    required_fields:
+      - created_at
+      - updated_at
+      - deleted_at (for soft deletes)
+      - data_retention_date (optional)
+
+  # Warning triggers
+  warnings:
+    - condition: "Table grows > 10GB without archiving strategy"
+    - condition: "Logs stored > 90 days in hot storage"