anchi-toolkit 1.0.0 → 1.2.1

package/dist/presets/professional/contract.json

@@ -0,0 +1,72 @@
+{
+    "name": "professional",
+    "displayName": "Professional",
+    "version": "3.2.0",
+    "architecture": {
+        "type": "modular-monolith",
+        "database": "PostgreSQL",
+        "structure": "modules"
+    },
+    "rules": {
+        "allowed": [
+            "modular structure",
+            "service layer pattern",
+            "repository pattern",
+            "component composition"
+        ],
+        "forbidden": [
+            "logic in components",
+            "direct database in routes",
+            "circular dependencies",
+            "god objects",
+            "inline SQL"
+        ],
+        "warnings": [
+            "missing tests for new features",
+            "missing documentation"
+        ]
+    },
+    "checks": {
+        "required": [
+            "syntax",
+            "lint",
+            "type-check"
+        ],
+        "optional": [
+            "test"
+        ],
+        "coverage_min": 60
+    },
+    "approvals": {
+        "code_changes": false,
+        "architecture_changes": true,
+        "destructive_actions": true
+    },
+    "ai_behavior": {
+        "speed_priority": false,
+        "explanation_level": "standard",
+        "auto_approve": false
+    },
+    "migration": {
+        "previous": "rapid",
+        "next": "enterprise",
+        "requirements": [
+            "Add DDD structure",
+            "Add domain events",
+            "Add CQRS if needed",
+            "Add comprehensive tests"
+        ]
+    },
+    "patterns": {
+        "file_naming": "kebab-case",
+        "component_naming": "PascalCase",
+        "function_naming": "camelCase",
+        "module_structure": [
+            "{module}/",
+            "{module}/components/",
+            "{module}/services/",
+            "{module}/hooks/",
+            "{module}/types/"
+        ]
+    }
+}

package/dist/presets/rapid/contract.json

@@ -0,0 +1,53 @@
+{
+    "name": "rapid",
+    "displayName": "Rapid MVP",
+    "version": "3.2.0",
+    "architecture": {
+        "type": "flat",
+        "database": "SQLite",
+        "structure": "flexible"
+    },
+    "rules": {
+        "allowed": [
+            "any file structure",
+            "direct database access",
+            "inline styles",
+            "quick patterns",
+            "skip tests"
+        ],
+        "forbidden": [],
+        "warnings": [
+            "no type checking",
+            "no test coverage"
+        ]
+    },
+    "checks": {
+        "required": [
+            "syntax"
+        ],
+        "optional": [
+            "lint",
+            "type-check",
+            "test"
+        ],
+        "coverage_min": 0
+    },
+    "approvals": {
+        "code_changes": false,
+        "architecture_changes": false,
+        "destructive_actions": true
+    },
+    "ai_behavior": {
+        "speed_priority": true,
+        "explanation_level": "minimal",
+        "auto_approve": true
+    },
+    "migration": {
+        "next": "professional",
+        "requirements": [
+            "Add module structure",
+            "Add service layer",
+            "Add basic tests"
+        ]
+    }
+}

package/dist/scripts/check-setup.ps1

@@ -0,0 +1,59 @@
+# Script: Kiểm Tra Setup Dự Án
+# Cách dùng: .\check-setup.ps1
+
+Write-Host ""
+Write-Host "🔍 Kiểm tra setup dự án..." -ForegroundColor Cyan
+Write-Host ""
+
+$checks = @(
+    @{Name = ".cursorrules"; Path = ".cursorrules"; Required = $true; Description = "AI rules chính" },
+    @{Name = ".cursor/"; Path = ".cursor"; Required = $true; Description = "Cursor configuration" },
+    @{Name = ".cursor/agents/"; Path = ".cursor/agents"; Required = $true; Description = "Agent definitions" },
+    @{Name = ".cursor/commands/"; Path = ".cursor/commands"; Required = $true; Description = "Slash commands" },
+    @{Name = ".cursor/skills/"; Path = ".cursor/skills"; Required = $true; Description = "Skills modules" },
+    @{Name = ".antigravity/"; Path = ".antigravity"; Required = $true; Description = "Antigravity agents" },
+    @{Name = "CURSOR.md"; Path = "CURSOR.md"; Required = $true; Description = "AI instructions" },
+    @{Name = "ANTIGRAVITY.md"; Path = "ANTIGRAVITY.md"; Required = $false; Description = "Orchestration guide" },
+    @{Name = "docs/"; Path = "docs"; Required = $true; Description = "Documentation folder" },
+    @{Name = "docs/PROJECT.md"; Path = "docs/PROJECT.md"; Required = $true; Description = "Project description" },
+    @{Name = "docs/code-standards.md"; Path = "docs/code-standards.md"; Required = $true; Description = "Coding standards" },
+    @{Name = "package.json"; Path = "package.json"; Required = $true; Description = "Package config" }
+)
+
+$passed = 0
+$failed = 0
+
+foreach ($check in $checks) {
+    if (Test-Path $check.Path) {
+        Write-Host "  ✅ $($check.Name)" -ForegroundColor Green
+        $passed++
+    }
+    else {
+        if ($check.Required) {
+            Write-Host "  ❌ $($check.Name) - MISSING (Required)" -ForegroundColor Red
+            $failed++
+        }
+        else {
+            Write-Host "  ⚠️ $($check.Name) - Missing (Optional)" -ForegroundColor Yellow
+        }
+    }
+}
+
+Write-Host ""
+Write-Host "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" -ForegroundColor Gray
+Write-Host "Kết quả: $passed passed, $failed failed" -ForegroundColor White
+
+if ($failed -eq 0) {
+    Write-Host ""
+    Write-Host "✅ Setup hoàn chỉnh! Có thể mở Cursor IDE." -ForegroundColor Green
+    Write-Host ""
+    Write-Host "Tiếp theo:" -ForegroundColor Yellow
+    Write-Host "  cursor ." -ForegroundColor Cyan
+}
+else {
+    Write-Host ""
+    Write-Host "❌ Thiếu $failed file(s) bắt buộc." -ForegroundColor Red
+    Write-Host "Kiểm tra lại template hoặc chạy lại setup." -ForegroundColor Yellow
+}
+
+Write-Host ""

package/dist/scripts/install-hooks.ps1

@@ -0,0 +1,74 @@
+# ═══════════════════════════════════════════════════════════════
+# anchi-kit Git Hooks Installer (Windows)
+# ═══════════════════════════════════════════════════════════════
+
+Write-Host ""
+Write-Host "🔗 anchi-kit Git Hooks Installer" -ForegroundColor Cyan
+Write-Host "═══════════════════════════════════════════════════════════════" -ForegroundColor Gray
+Write-Host ""
+
+$gitDir = ".git"
+$hooksDir = "$gitDir\hooks"
+
+# Check if git repository
+if (-not (Test-Path $gitDir)) {
+    Write-Host "❌ Not a git repository" -ForegroundColor Red
+    exit 1
+}
+
+# Create hooks directory
+if (-not (Test-Path $hooksDir)) {
+    New-Item -ItemType Directory -Path $hooksDir -Force | Out-Null
+}
+
+# Create pre-commit hook (Enforce Tests)
+$preCommitHook = @"
+#!/bin/sh
+# anchi-kit pre-commit hook
+# Enforces code quality by running tests
+
+echo "🛡️  anchi-kit: Checking Safety Net..."
+
+# 1. Check for tests
+if [ -f "package.json" ] && grep -q "\"test\":" "package.json"; then
+    echo "🧪 Running npm test..."
+    npm test
+    
+    if [ $? -ne 0 ]; then
+        echo "❌ TESTS FAILED. Commit blocked."
+        echo "   (Use --no-verify to force if you really must)"
+        exit 1
+    fi
+else
+    echo "⚠️  No test script found in package.json. Skipping tests."
+fi
+
+echo "✅ Safety Check Passed."
+exit 0
+"@
+
+$preCommitPath = "$hooksDir\pre-commit"
+Set-Content -Path $preCommitPath -Value $preCommitHook -NoNewline
+Write-Host "✅ Installed: pre-commit hook" -ForegroundColor Green
+
+# Create post-merge hook (Reminder)
+$postMergeHook = @"
+#!/bin/sh
+# anchi-kit post-merge hook
+# Reminder: Update docs after merge
+
+echo "💡 anchi-kit reminder: Consider running /docs:update"
+exit 0
+"@
+
+$postMergePath = "$hooksDir\post-merge"
+Set-Content -Path $postMergePath -Value $postMergeHook -NoNewline
+Write-Host "✅ Installed: post-merge hook" -ForegroundColor Green
+
+Write-Host ""
+Write-Host "═══════════════════════════════════════════════════════════════" -ForegroundColor Gray
+Write-Host "✅ Git hooks installed successfully!" -ForegroundColor Green
+Write-Host ""
+Write-Host "📌 Hooks will verify tests before commit." -ForegroundColor Yellow
+Write-Host "   To skip: use --no-verify flag" -ForegroundColor Gray
+Write-Host ""

package/dist/scripts/install-hooks.sh

@@ -0,0 +1,69 @@
+#!/bin/bash
+# ═══════════════════════════════════════════════════════════════
+# anchi-kit Git Hooks Installer (macOS/Linux)
+# ═══════════════════════════════════════════════════════════════
+
+echo ""
+echo "🔗 anchi-kit Git Hooks Installer"
+echo "═══════════════════════════════════════════════════════════════"
+echo ""
+
+GIT_DIR=".git"
+HOOKS_DIR="$GIT_DIR/hooks"
+
+# Check if git repository
+if [ ! -d "$GIT_DIR" ]; then
+    echo "❌ Not a git repository"
+    exit 1
+fi
+
+# Create hooks directory
+mkdir -p "$HOOKS_DIR"
+
+# Create pre-commit hook
+cat > "$HOOKS_DIR/pre-commit" << 'EOF'
+#!/bin/sh
+# anchi-kit pre-commit hook
+# Enforces code quality by running tests
+
+echo "🛡️  anchi-kit: Checking Safety Net..."
+
+# 1. Check for tests
+if [ -f "package.json" ] && grep -q "\"test\":" "package.json"; then
+    echo "🧪 Running npm test..."
+    npm test
+    
+    if [ $? -ne 0 ]; then
+        echo "❌ TESTS FAILED. Commit blocked."
+        echo "   (Use --no-verify to force if you really must)"
+        exit 1
+    fi
+else
+    echo "⚠️  No test script found in package.json. Skipping tests."
+fi
+
+echo "✅ Safety Check Passed."
+exit 0
+EOF
+chmod +x "$HOOKS_DIR/pre-commit"
+echo "✅ Installed: pre-commit hook"
+
+# Create post-merge hook
+cat > "$HOOKS_DIR/post-merge" << 'EOF'
+#!/bin/sh
+# anchi-kit post-merge hook
+# Reminder: Update docs after merge
+
+echo "💡 anchi-kit reminder: Consider running /docs:update"
+exit 0
+EOF
+chmod +x "$HOOKS_DIR/post-merge"
+echo "✅ Installed: post-merge hook"
+
+echo ""
+echo "═══════════════════════════════════════════════════════════════"
+echo "✅ Git hooks installed successfully!"
+echo ""
+echo "📌 Hooks will show reminders for anchi-kit commands."
+echo "   To skip: use --no-verify flag"
+echo ""

package/dist/scripts/install.ps1

@@ -0,0 +1,204 @@
+# =============================================================================
+# Script: Install anchi-kit vào dự án có sẵn
+# Cách dùng: 
+#   Từ folder dự án: irm https://raw.githubusercontent.com/.../install.ps1 | iex
+#   Hoặc: .\install.ps1 -KitPath "path/to/anchi-kit"
+# =============================================================================
+
+param(
+    [string]$KitPath = ""
+)
+
+$ErrorActionPreference = "Stop"
+
+# =============================================================================
+# HELPER FUNCTIONS
+# =============================================================================
+
+function Write-Banner {
+    Write-Host ""
+    Write-Host "╔═══════════════════════════════════════════════════════════╗" -ForegroundColor Cyan
+    Write-Host "║           🚀 anchi-kit Installer                          ║" -ForegroundColor Cyan
+    Write-Host "║     Cài đặt Cursor AI toolkit vào dự án có sẵn            ║" -ForegroundColor Cyan
+    Write-Host "╚═══════════════════════════════════════════════════════════╝" -ForegroundColor Cyan
+    Write-Host ""
+}
+
+function Ask-ConflictResolution {
+    param([string]$FilePath)
+    
+    Write-Host ""
+    Write-Host "⚠️  File đã tồn tại: $FilePath" -ForegroundColor Yellow
+    Write-Host "    [O] Overwrite - Ghi đè (backup file cũ)"
+    Write-Host "    [S] Skip - Bỏ qua, giữ file hiện tại"
+    Write-Host "    [M] Merge - Mở cả 2 file để merge thủ công"
+    Write-Host ""
+    
+    do {
+        $choice = Read-Host "    Chọn (O/S/M)"
+        $choice = $choice.ToUpper()
+    } while ($choice -notin @("O", "S", "M"))
+    
+    return $choice
+}
+
+function Backup-File {
+    param([string]$FilePath)
+    
+    $timestamp = Get-Date -Format "yyyyMMdd_HHmmss"
+    $backupPath = "$FilePath.backup_$timestamp"
+    Copy-Item $FilePath $backupPath -Force
+    Write-Host "    📦 Backup: $backupPath" -ForegroundColor DarkGray
+    return $backupPath
+}
+
+function Copy-WithConflictHandling {
+    param(
+        [string]$Source,
+        [string]$Destination,
+        [switch]$IsDirectory
+    )
+    
+    if ($IsDirectory) {
+        if (Test-Path $Destination) {
+            # Directory exists - copy contents with per-file handling
+            Get-ChildItem $Source -Recurse | ForEach-Object {
+                $relativePath = $_.FullName.Substring($Source.Length + 1)
+                $destPath = Join-Path $Destination $relativePath
+                
+                if ($_.PSIsContainer) {
+                    if (-not (Test-Path $destPath)) {
+                        New-Item -ItemType Directory -Path $destPath -Force | Out-Null
+                    }
+                } else {
+                    if (Test-Path $destPath) {
+                        $choice = Ask-ConflictResolution -FilePath $relativePath
+                        switch ($choice) {
+                            "O" {
+                                Backup-File -FilePath $destPath
+                                Copy-Item $_.FullName $destPath -Force
+                                Write-Host "    ✅ Overwrote: $relativePath" -ForegroundColor Green
+                            }
+                            "S" {
+                                Write-Host "    ⏭️  Skipped: $relativePath" -ForegroundColor Gray
+                            }
+                            "M" {
+                                $newPath = "$destPath.new"
+                                Copy-Item $_.FullName $newPath -Force
+                                Write-Host "    📝 Merge manually: $relativePath vs $relativePath.new" -ForegroundColor Yellow
+                            }
+                        }
+                    } else {
+                        $parentDir = Split-Path $destPath -Parent
+                        if (-not (Test-Path $parentDir)) {
+                            New-Item -ItemType Directory -Path $parentDir -Force | Out-Null
+                        }
+                        Copy-Item $_.FullName $destPath -Force
+                    }
+                }
+            }
+        } else {
+            Copy-Item $Source $Destination -Recurse -Force
+            Write-Host "    ✅ Copied: $(Split-Path $Source -Leaf)/" -ForegroundColor Green
+        }
+    } else {
+        if (Test-Path $Destination) {
+            $choice = Ask-ConflictResolution -FilePath (Split-Path $Destination -Leaf)
+            switch ($choice) {
+                "O" {
+                    Backup-File -FilePath $Destination
+                    Copy-Item $Source $Destination -Force
+                    Write-Host "    ✅ Overwrote: $(Split-Path $Destination -Leaf)" -ForegroundColor Green
+                }
+                "S" {
+                    Write-Host "    ⏭️  Skipped: $(Split-Path $Destination -Leaf)" -ForegroundColor Gray
+                }
+                "M" {
+                    $newPath = "$Destination.new"
+                    Copy-Item $Source $newPath -Force
+                    Write-Host "    📝 Merge manually: $(Split-Path $Destination -Leaf) vs $(Split-Path $Destination -Leaf).new" -ForegroundColor Yellow
+                }
+            }
+        } else {
+            Copy-Item $Source $Destination -Force
+            Write-Host "    ✅ Copied: $(Split-Path $Destination -Leaf)" -ForegroundColor Green
+        }
+    }
+}
+
+# =============================================================================
+# MAIN INSTALLATION
+# =============================================================================
+
+Write-Banner
+
+$TargetPath = Get-Location
+
+# Determine kit source
+if ($KitPath -eq "") {
+    # Check if running from kit directory
+    if (Test-Path (Join-Path $PSScriptRoot "..\presets")) {
+        $KitPath = Split-Path $PSScriptRoot -Parent
+    } else {
+        Write-Host "❌ Không tìm thấy anchi-kit source." -ForegroundColor Red
+        Write-Host "   Sử dụng: .\install.ps1 -KitPath 'path/to/anchi-kit'" -ForegroundColor Yellow
+        exit 1
+    }
+}
+
+Write-Host "📁 Kit source: $KitPath" -ForegroundColor Gray
+Write-Host "📂 Target: $TargetPath" -ForegroundColor Gray
+Write-Host ""
+
+# Confirm installation
+$confirm = Read-Host "Tiếp tục cài đặt? (Y/n)"
+if ($confirm -eq "n" -or $confirm -eq "N") {
+    Write-Host "❌ Đã hủy." -ForegroundColor Red
+    exit 0
+}
+
+Write-Host ""
+Write-Host "📋 Installing anchi-kit components..." -ForegroundColor Yellow
+Write-Host ""
+
+# Install components
+$components = @(
+    @{ Source = ".cursor"; IsDir = $true; Desc = "Cursor commands, agents, skills" },
+    @{ Source = "presets"; IsDir = $true; Desc = "Architecture presets" },
+    @{ Source = "docs"; IsDir = $true; Desc = "Documentation templates" },
+    @{ Source = ".cursorrules"; IsDir = $false; Desc = "Cursor rules" },
+    @{ Source = "CURSOR.md"; IsDir = $false; Desc = "AI instructions" },
+    @{ Source = "GEMINI.md"; IsDir = $false; Desc = "Gemini AI instructions" },
+    @{ Source = "ANTIGRAVITY.md"; IsDir = $false; Desc = "Antigravity instructions" }
+)
+
+foreach ($comp in $components) {
+    $sourcePath = Join-Path $KitPath $comp.Source
+    $destPath = Join-Path $TargetPath $comp.Source
+    
+    if (Test-Path $sourcePath) {
+        Write-Host "  📦 $($comp.Desc)..." -ForegroundColor Cyan
+        if ($comp.IsDir) {
+            Copy-WithConflictHandling -Source $sourcePath -Destination $destPath -IsDirectory
+        } else {
+            Copy-WithConflictHandling -Source $sourcePath -Destination $destPath
+        }
+    }
+}
+
+Write-Host ""
+Write-Host "═══════════════════════════════════════════════════════════════" -ForegroundColor Cyan
+Write-Host "  ✅ anchi-kit đã được cài đặt thành công!" -ForegroundColor Green
+Write-Host "═══════════════════════════════════════════════════════════════" -ForegroundColor Cyan
+Write-Host ""
+Write-Host "📌 Bước tiếp theo:" -ForegroundColor Yellow
+Write-Host ""
+Write-Host "  1. Mở Cursor IDE và chạy:" -ForegroundColor White
+Write-Host "     /start" -ForegroundColor Green
+Write-Host ""
+Write-Host "  2. Chọn preset phù hợp:" -ForegroundColor White
+Write-Host "     /use-preset rapid|professional|enterprise" -ForegroundColor Green
+Write-Host ""
+Write-Host "  3. Bắt đầu code:" -ForegroundColor White
+Write-Host "     /plan \"Feature description\"" -ForegroundColor Green
+Write-Host ""