anchi-toolkit 1.2.0 → 1.2.1

package/dist/.cursor/commands/migrate.md

@@ -0,0 +1,180 @@
+---
+description: ⚡⚡⚡ Migrate between presets safely
+argument-hint: [target: professional | enterprise]
+---
+
+# /migrate - Safe Preset Migration
+
+**What:** Migrate project from one preset to another with violation scanning and phased refactoring.
+
+## Usage
+```
+/migrate professional       # Migrate to Professional
+/migrate enterprise         # Migrate to Enterprise
+/migrate --scan             # Scan only, no changes
+/migrate --plan             # Generate migration plan
+```
+
+---
+
+## 💰 Model Selection
+
+| Action | Recommended Model | Cost |
+|--------|-------------------|------|
+| Scan violations | Gemini 3 Flash | 💚 Low |
+| Generate plan | Sonnet 4.5 | 💛 Medium |
+| Execute migration | Opus 4.5 | 🔴 High |
+
+---
+
+## Migration Paths
+
+```
+┌─────────┐     ┌──────────────┐     ┌────────────┐
+│  Rapid  │ ──► │ Professional │ ──► │ Enterprise │
+└─────────┘     └──────────────┘     └────────────┘
+     ↑                 ↑                    ↑
+   MVP          Startup/Team         Large projects
+```
+
+---
+
+## Workflow
+
+```
+/migrate professional
+
+═══════════ MIGRATION ANALYSIS ═══════════
+
+📊 Current: Rapid (SQLite, flat files)
+📊 Target: Professional (PostgreSQL, modular)
+
+🔍 Scanning codebase...
+
+⚠️ VIOLATIONS FOUND: 15
+
+  Structure (5):
+    • src/app/page.tsx - Logic in component
+    • src/app/api/users/route.ts - Direct DB access
+    • src/lib/auth.ts - Mixed concerns
+    ...
+  
+  Patterns (7):
+    • No service layer detected
+    • No repository pattern
+    • Inline SQL queries
+    ...
+
+  Tests (3):
+    • Coverage: 12% (required: 60%)
+    • Missing: auth tests, user tests
+    ...
+
+📋 MIGRATION PLAN (Phased):
+
+  Phase 1: Structure (2-3 days)
+    □ Create src/modules/ structure
+    □ Create src/services/ layer
+    □ Create src/repositories/ layer
+    
+  Phase 2: Refactor (3-4 days)
+    □ Move logic from components to services
+    □ Add repository wrapping for DB
+    □ Extract shared utilities
+    
+  Phase 3: Database (1-2 days)
+    □ Setup PostgreSQL
+    □ Migrate schema
+    □ Update connection config
+    
+  Phase 4: Testing (2-3 days)
+    □ Add unit tests for services
+    □ Add integration tests
+    □ Reach 60% coverage
+
+📊 Estimated Total: 8-12 days
+
+👉 Start Phase 1? [y/n]
+```
+
+---
+
+## Flags
+
+| Flag | Description |
+|------|-------------|
+| `--scan` | Scan only, show violations |
+| `--plan` | Generate plan, no execution |
+| `--phase N` | Execute specific phase |
+| `--auto` | Auto-execute all (lead only) |
+| `--force` | Skip confirmation |
+
+---
+
+## Phase Execution
+
+```
+/migrate professional --phase 1
+
+═══════════ PHASE 1: Structure ═══════════
+
+Creating module structure...
+
+  ✅ Created src/modules/
+  ✅ Created src/modules/users/
+  ✅ Created src/modules/auth/
+  ✅ Created src/services/
+  ✅ Created src/repositories/
+
+📊 Progress: Phase 1 complete (1/4)
+
+👉 Continue to Phase 2? [y/n]
+```
+
+---
+
+## Rollback
+
+```
+/migrate --rollback
+
+═══════════ ROLLBACK Migration ═══════════
+
+Rolling back to checkpoint before migration...
+
+  ✅ Restored src/ structure
+  ✅ Restored package.json
+  ✅ Restored prisma/
+
+📊 Rollback complete. Project is at pre-migration state.
+```
+
+---
+
+## Agent & Skill Activation
+
+**Primary Agents:**
+- `.cursor/agents/ddd-architect.md` - Architecture analysis
+- `.cursor/agents/fullstack-developer.md` - Refactoring
+- `.cursor/agents/tester.md` - Test coverage
+
+**Skills:**
+- `backend-development/` - Service patterns
+- `databases/` - DB migration
+- `testing/` - Test generation
+
+---
+
+##  Dynamic Orchestration
+
+> **AI MUST read orchestration config before execution**
+
+```
+1. READ .cursor/agent-skill-index.yaml
+2. CHECK command_mapping for this command
+3. APPLY skill activation rules
+4. CHECK .cursor/failure-modes.yaml
+5. LOG decision to .ai-audit/
+```
+
+ [docs/ORCHESTRATION_RUNTIME.md](../docs/ORCHESTRATION_RUNTIME.md)

package/dist/.cursor/commands/review.md

@@ -0,0 +1,108 @@
+---
+description: ⚡⚡ Code review and quality check
+argument-hint: [optional: specific file or area]
+---
+
+# /review - Code Review
+
+**What:** Review code quality, suggest improvements.
+
+## Usage
+```
+/review                        # Review recent changes
+/review "LoginForm"            # Review specific file
+/review --security             # Security-focused review
+/review --performance          # Performance-focused
+```
+
+---
+
+## 💰 Model Selection
+
+| Focus | Recommended Model | Cost |
+|-------|-------------------|------|
+| General review | Sonnet 4.5 | 💛 Medium |
+| Security | Opus 4.5 | 🔴 High |
+| Performance | Sonnet 4.5 | 💛 Medium |
+| Full codebase | Gemini 3 Flash | 💚 Low |
+
+---
+
+## Output
+
+```
+📋 /review
+
+═══════════ CODE REVIEW ═══════════
+
+📊 Files reviewed: 5
+⏱️ Lines analyzed: 450
+
+✅ Good:
+  • Clean component structure
+  • Proper TypeScript types
+  • Good error handling
+
+⚠️ Improvements:
+  1. LoginForm.tsx:23 - Consider memoization
+  2. auth.ts:45 - Add input validation
+  3. api/login: Add rate limiting
+
+❌ Issues:
+  1. password.ts:12 - Weak hash algorithm
+
+📊 Score: 7.5/10
+
+👉 Apply suggested fixes? (ok/select)
+```
+
+---
+
+## Flags
+
+| Flag | Focus |
+|------|-------|
+| `--security` | Security vulnerabilities |
+| `--performance` | Performance issues |
+| `--a11y` | Accessibility |
+| `--all` | Full codebase |
+
+---
+
+## Replaces
+
+```
+/review replaces:
+  • /review:codebase
+  • /cleanup (partial)
+```
+
+---
+
+## Agent & Skill Activation
+
+**Primary Agents:**
+- `.cursor/agents/code-reviewer.md` - Code review
+- `.cursor/agents/debugger.md` - Issue detection
+
+**Skills:**
+- `code-review/` - Review patterns
+- `debugging/` - Issue analysis
+- `chrome-devtools/` - Performance analysis
+
+
+---
+
+##  Dynamic Orchestration
+
+> **AI MUST read orchestration config before execution**
+
+```
+1. READ .cursor/agent-skill-index.yaml
+2. CHECK command_mapping for this command
+3. APPLY skill activation rules
+4. CHECK .cursor/failure-modes.yaml
+5. LOG decision to .ai-audit/
+```
+
+ [docs/ORCHESTRATION_RUNTIME.md](../docs/ORCHESTRATION_RUNTIME.md)

package/dist/.cursor/commands/scout.md

@@ -0,0 +1,111 @@
+---
+description: ⚡⚡ Explore codebase and find relevant files
+argument-hint: [what to find or understand]
+---
+
+# /scout - Codebase Explorer
+
+**What:** Explore codebase, find files, understand structure.
+
+## Usage
+```
+/scout                         # Overview of codebase
+/scout "auth"                  # Find auth-related files
+/scout "how login works"       # Understand flow
+/scout --external              # Use external tools
+```
+
+---
+
+## 💰 Model Selection
+
+| Mode | Recommended Model | Cost |
+|------|-------------------|------|
+| Quick search | GPT-5.1 Codex Mini | 💚 Low |
+| Deep analysis | Sonnet 4.5 | 💛 Medium |
+| Large codebase (>200 files) | Gemini 3 Flash | 💚 Low |
+| External tools | Gemini 2.5 Flash | 💚 Low |
+
+---
+
+## Output
+
+```
+🔍 /scout "auth"
+
+═══════════ FOUND ═══════════
+
+📂 Files (8):
+  • lib/auth/session.ts
+  • lib/auth/password.ts  
+  • app/api/auth/login/route.ts
+  • app/api/auth/logout/route.ts
+  • components/LoginForm.tsx
+  • hooks/useAuth.ts
+  • types/auth.ts
+  • middleware.ts
+
+📊 Summary:
+  • Session-based auth with JWT
+  • Password hashing: bcrypt
+  • OAuth: Google, GitHub
+  • Middleware for protected routes
+
+🔗 Flow:
+  LoginForm → POST /api/auth/login → session.ts → JWT
+
+📌 Entry points:
+  • Login: app/api/auth/login/route.ts
+  • Auth hook: hooks/useAuth.ts
+```
+
+---
+
+## Flags
+
+| Flag | Mode |
+|------|------|
+| `--external` | Use MCP/external tools |
+| `--deep` | Deep analysis |
+| `--deps` | Analyze dependencies |
+
+---
+
+## Replaces
+
+```
+/scout replaces:
+  • /scout:ext
+  • /context
+```
+
+---
+
+## Agent & Skill Activation
+
+**Agents:**
+- `.cursor/agents/scout.md` - Primary codebase search
+- `.cursor/agents/scout-external.md` - For `--external` flag
+- `.cursor/agents/researcher.md` - For `--deep` analysis
+
+**Skills (auto-activated):**
+- `research/` - Research patterns
+- `docs-seeker/` - Find documentation
+- `problem-solving/` - Analyze structure
+- `sequential-thinking/` - Deep analysis
+
+---
+
+##  Dynamic Orchestration
+
+> **AI MUST read orchestration config before execution**
+
+```
+1. READ .cursor/agent-skill-index.yaml
+2. CHECK command_mapping for this command
+3. APPLY skill activation rules
+4. CHECK .cursor/failure-modes.yaml
+5. LOG decision to .ai-audit/
+```
+
+ [docs/ORCHESTRATION_RUNTIME.md](../docs/ORCHESTRATION_RUNTIME.md)

package/dist/.cursor/commands/skill-learn.md

@@ -0,0 +1,48 @@
+---
+description: 🧠 Teach AI new skills from the web
+argument-hint: [skill name / tech stack]
+---
+
+# /skill-learn - Infinite Knowledge
+
+**What:** Crawls documentation and creates a new Skill Module dynamically.
+
+## Logic
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ 🧠 /skill-learn - KNOWLEDGE ACQUISITION                     │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  [1] ANALYZE REQUEST: "Learn Rust"                          │
+│      ├── Identify Tech: Rust Language                       │
+│      └── Identify Goal: syntax, best practices, packaging   │
+│                                                             │
+│  [2] RESEARCH (Agent: Researcher):                          │
+│      ├── Search Official Docs (rust-lang.org)               │
+│      ├── Search Popular Patterns (Awesome Rust)             │
+│      └── Extract: "Do's & Don'ts", "Snippet Patterns"       │
+│                                                             │
+│  [3] SYNTHESIZE (Agent: Docs-Manager):                      │
+│      ├── Template: .cursor/skills/_template.md             │
+│      ├── Fill: Rules, File Patterns, Dependencies           │
+│      └── Create: .cursor/skills/rust-development/README.md  │
+│                                                             │
+│  [4] REGISTER:                                              │
+│      ├── Append to: .cursor/agent-skill-index.yaml          │
+│      └── Map to: fullstack-developer (or create new role)   │
+│                                                             │
+│  [5] OUTPUT:                                                │
+│      "✅ Learned Skill: Rust Development                    │
+│       Activated for *.rs files."                            │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Usage
+
+```
+/skill-learn "Tailwind CSS"
+/skill-learn "Go Fiber Framework"
+/skill-learn "Solidity Smart Contracts"
+```

package/dist/.cursor/commands/start.md

@@ -0,0 +1,56 @@
+---
+description: 🚀 Start/Resume project with Context Recall
+argument-hint: [optional: new project name]
+---
+
+# /start - Project Intelligence
+
+**What:** Initialize project or RESUME work with context awareness.
+
+## Logic (The "Brain")
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ 🧠 /start - PROJECT RECALL                                  │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  [1] CHECK: Is this a new project?                          │
+│      ├── YES → Show Preset Selection (Rapid/Pro/Enterprise) │
+│      └── NO  → Activate RECALL MODE                         │
+│                                                             │
+│  [2] RECALL MODE (The "Wow" Factor):                        │
+│      ├── READ: .ai-memory/feature_status.json              │
+│      ├── READ: .ai-audit/latest.jsonl                       │
+│      └── ANALYZE: What was the last active task?            │
+│                                                             │
+│  [3] OUTPUT:                                                │
+│      "Welcome back! 👋                                      │
+│       Last time we were working on [Task Name].             │
+│       Status: [In Progress/Done]                            │
+│       Files: [Active Files]                                 │
+│                                                             │
+│       👉 Continue? [Y]es / [C]hange Task"                   │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Setup Steps (New Project)
+
+If folder is empty:
+
+1. Detect Tech Stack (Node, Python, Go...)
+2. Suggest Best Preset
+3. Run `npx anchi-toolkit init`
+
+## Memory Schema (For Recall)
+
+AI looks for `.ai-memory/session.json`:
+
+```json
+{
+  "last_active": "2024-12-27T10:00:00Z",
+  "current_task": "Dashboard UI Implementation",
+  "active_files": ["src/dashboard.tsx", "src/api.ts"],
+  "next_step": "Implement chart component"
+}
+```

package/dist/.cursor/commands/status.md

@@ -0,0 +1,163 @@
+---
+description: ⚡⚡ Show project health and status dashboard
+argument-hint: [optional: specific area]
+---
+
+# /status - Project Status Dashboard
+
+**What:** Show project health, metrics, và recommendations.
+
+## Usage
+```
+/status                        # Full project status
+/status --deps                 # Check dependencies
+/status --tests                # Test status only
+```
+
+---
+
+## 💰 Model Selection
+
+| Check | Recommended Model | Cost |
+|-------|-------------------|------
+| Quick status | GPT-5.1 Codex Mini | 💚 Low |
+| Full analysis | Sonnet 4.5 | 💛 Medium |
+| Large codebase | Gemini 3 Flash | 💚 Low |
+
+---
+
+## Workflow
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ 📊 STATUS CHECK                                             │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  [AUTO] Check: Git status                                   │
+│  [AUTO] Check: Dependencies (outdated, vulnerabilities)     │
+│  [AUTO] Check: Tests (last run, coverage)                   │
+│  [AUTO] Check: Build (last build, errors)                   │
+│  [AUTO] Check: TODOs in code                                │
+│  [AUTO] Check: Open tasks in plans/                         │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Output
+
+```
+📊 PROJECT STATUS
+
+═══════════ OVERVIEW ═══════════
+
+┌─────────────────────────────────────────────────────────────┐
+│ 🏠 my-app v1.2.0                                            │
+│ 📂 Next.js + TypeScript + Prisma                            │
+│ 🏢 Preset: Professional                                     │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  📁 Files: 150 | 📝 Lines: 15,000 | 📦 Deps: 45            │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+
+═══════════ HEALTH CHECK ═══════════
+
+| Check | Status | Details |
+|-------|--------|---------|
+| 🔀 Git | ✅ Clean | 0 uncommitted changes |
+| 🧪 Tests | ✅ Pass | 45/45 (100%) |
+| 📊 Coverage | ⚠️ 72% | Below 80% threshold |
+| 📦 Deps | ⚠️ 3 outdated | next, prisma, tailwind |
+| 🔒 Security | ✅ 0 vulns | Last scan: 2h ago |
+| 🏗️ Build | ✅ Pass | Last: 30 min ago |
+
+═══════════ OPEN TASKS ═══════════
+
+| Type | Count |
+|------|-------|
+| 📋 Plans | 2 active |
+| 📌 TODOs | 5 in code |
+| ⚠️ FIXMEs | 2 in code |
+
+📋 Active Plans:
+  1. plans/payment-integration/ (Phase 2/3)
+  2. plans/user-settings/ (Phase 1/2)
+
+═══════════ RECOMMENDATIONS ═══════════
+
+⚠️ Issues to address:
+  1. Increase test coverage to 80%+
+  2. Update 3 outdated dependencies
+  
+💡 Suggestions:
+  • /test --coverage - View coverage details
+  • /do "update dependencies"
+  • /do "payment-integration Phase 3"
+
+📌 Next: /do "continue payment integration"
+```
+
+---
+
+## Health Checks
+
+| Check | What |
+|-------|------|
+| Git | Uncommitted changes, branch status |
+| Tests | Last run result, pass rate |
+| Coverage | Percentage vs threshold |
+| Dependencies | Outdated packages |
+| Security | npm audit results |
+| Build | Last build status |
+| TODOs | TODO/FIXME comments in code |
+| Plans | Open plans in plans/ folder |
+
+---
+
+## Agent & Skill Activation
+
+**Agents:**
+- `.cursor/agents/project-manager.md` - Status overview
+- `.cursor/agents/scout.md` - Code analysis
+
+**Skills:**
+- `devops/` - Build and deploy
+- `code-review/` - Quality assessment
+
+---
+
+## Configuration
+
+```yaml
+status:
+  checks:
+    git: true
+    tests: true
+    coverage: true
+    dependencies: true
+    security: true
+    build: true
+    todos: true
+    plans: true
+  thresholds:
+    coverage: 80
+    outdated_deps: 5
+```
+
+---
+
+##  Dynamic Orchestration
+
+> **AI MUST read orchestration config before execution**
+
+```
+1. READ .cursor/agent-skill-index.yaml
+2. CHECK command_mapping for this command
+3. APPLY skill activation rules
+4. CHECK .cursor/failure-modes.yaml
+5. LOG decision to .ai-audit/
+```
+
+ [docs/ORCHESTRATION_RUNTIME.md](../docs/ORCHESTRATION_RUNTIME.md)