anchi-kit 2.0.3 → 2.2.0

package/.cursor/workflows/feature.yaml

@@ -0,0 +1,51 @@
+# Feature Workflow
+# Standard flow for new features
+# ═══════════════════════════════════════════════════════════════
+
+name: Feature Development
+description: Standard workflow for new features
+
+# Steps to follow
+steps:
+  1_plan:
+    command: /plan
+    required: true
+    auto_proceed: false
+    description: Create detailed plan
+    
+  2_approve:
+    type: approval
+    required: true
+    approvers: [lead]
+    description: Get plan approval
+    
+  3_implement:
+    command: /cook
+    required: true
+    auto_proceed: false
+    description: Implement feature
+    
+  4_test:
+    command: /test
+    required: true
+    auto_proceed: true
+    description: Run tests
+    
+  5_review:
+    command: /review
+    required: true
+    auto_proceed: false
+    description: Code review
+    
+  6_commit:
+    command: git commit
+    required: true
+    auto_proceed: false
+    description: Commit changes
+
+# Checklist before completion
+checklist:
+  - Tests passing
+  - Code reviewed
+  - Docs updated
+  - No console.log

package/.cursor/workflows/hotfix.yaml

@@ -0,0 +1,35 @@
+# Hotfix Workflow
+# Fast track for critical fixes
+# ═══════════════════════════════════════════════════════════════
+
+name: Hotfix
+description: Fast workflow for critical bug fixes
+
+# Steps - minimal for speed
+steps:
+  1_fix:
+    command: /fix:fast
+    required: true
+    auto_proceed: true
+    description: Quick fix
+    
+  2_test:
+    command: /test
+    required: true
+    auto_proceed: true
+    description: Verify fix
+    
+  3_commit:
+    command: git commit
+    required: true
+    auto_proceed: false
+    description: Commit with hotfix tag
+
+# No approval needed for hotfixes
+approval:
+  required: false
+
+# Quick checklist
+checklist:
+  - Fix verified
+  - No regressions

package/.cursor/workflows/release.yaml

@@ -0,0 +1,61 @@
+# Release Workflow
+# Structured flow for releases
+# ═══════════════════════════════════════════════════════════════
+
+name: Release
+description: Workflow for version releases
+
+# Steps
+steps:
+  1_summary:
+    command: /summary
+    required: true
+    auto_proceed: true
+    description: Update project summary
+    
+  2_changelog:
+    command: /docs:update
+    required: true
+    auto_proceed: true
+    description: Update changelog
+    
+  3_test:
+    command: /test:all
+    required: true
+    auto_proceed: false
+    description: Full test suite
+    
+  4_review:
+    command: /review:codebase
+    required: true
+    auto_proceed: false
+    description: Final review
+    
+  5_version:
+    type: manual
+    required: true
+    description: Bump version number
+    
+  6_tag:
+    command: git tag
+    required: true
+    auto_proceed: false
+    description: Create release tag
+    
+  7_publish:
+    type: manual
+    required: true
+    description: Publish/deploy
+
+# Approval required
+approval:
+  required: true
+  approvers: [lead]
+
+# Release checklist
+checklist:
+  - All tests passing
+  - Changelog updated
+  - Version bumped
+  - Tag created
+  - Docs updated

package/CURSOR.md

@@ -21,7 +21,7 @@ Hướng dẫn cho Cursor AI khi làm việc trong repository này.
 ### Bắt buộc đọc:
 
 1. ✅ Đọc `.cursorrules` để biết preset đang dùng
-2. ✅ Đọc `docs/project-overview-pdr.md` để hiểu context
+2. ✅ Đọc `docs/PROJECT.md` để hiểu context
 3. ✅ Đọc command definition trong `.cursor/commands/`
 4. ✅ Activate skills phù hợp từ `.cursor/skills/`
 
@@ -66,7 +66,7 @@ User: /plan "Add authentication"
 
 AI steps:
 1. Đọc .cursorrules → Biết đang dùng Professional preset
-2. Đọc docs/project-overview-pdr.md → Hiểu context
+2. Đọc docs/PROJECT.md → Hiểu context
 3. Đọc .cursor/commands/plan.md → Biết format output
 4. Đọc .cursor/agents/planner.md → Đóng vai planner
 5. Activate skill: .cursor/skills/better-auth/
@@ -139,10 +139,10 @@ Activate skills khi cần kiến thức chuyên sâu:
 ## 📖 Documentation Management
 
 Locations:
-- `docs/project-overview-pdr.md` - Project description
+- `docs/PROJECT.md` - Project description
 - `docs/code-standards.md` - Coding standards
 - `docs/system-architecture.md` - Architecture
-- `docs/codebase-summary.md` - Codebase overview
+- `docs/CODEBASE.md` - Codebase overview
 
 **Khi cần context → Đọc docs/ trước khi trả lời.**
 
@@ -156,4 +156,4 @@ Cho complex tasks, tham khảo:
 
 ---
 
-**CRITICAL:** Đây là file AI PHẢI ĐỌC. Mọi command PHẢI follow rules này.
+**CRITICAL:** Đây là file AI PHẢI ĐỌC. Mọi command PHẢI follow rules này.

package/README.md

@@ -82,12 +82,17 @@ AI sẽ hỏi:
 |---------|-------|
 | `/start` | **🔥 Entry point** - Bắt đầu mọi dự án |
 | `/use-preset [name]` | Chọn architecture (rapid/professional/enterprise) |
-| `/summary` | Tổng hợp thông tin dự án vào docs |
 | `/plan "..."` | Lập kế hoạch feature |
+| `/plan:auto "..."` | Auto-pilot planning |
 | `/cook "..."` | Implement theo plan |
+| `/cook:auto "..."` | Auto-pilot implementation |
 | `/scout "..."` | Tìm hiểu codebase |
 | `/fix "..."` | Sửa bug |
-| `/review` | Review code |
+| `/generate:page` | **NEW** Tạo page boilerplate |
+| `/generate:api` | **NEW** Tạo API route |
+| `/generate:component` | **NEW** Tạo component |
+| `/context` | **NEW** Xem AI context |
+| `/suggest` | **NEW** AI gợi ý action |
 
 ---
 
@@ -156,7 +161,7 @@ Xem chi tiết: [MIGRATION_GUIDE.md](./presets/MIGRATION_GUIDE.md)
 |------|-------|
 | [BEGINNER_GUIDE_VI.md](./BEGINNER_GUIDE_VI.md) | Hướng dẫn người mới |
 | [CONTRIBUTING.md](./CONTRIBUTING.md) | Hướng dẫn đóng góp |
-| [docs/TEAM_PIPELINE.md](./docs/TEAM_PIPELINE.md) | **🔥 Pipeline + Git workflow** |
+| [docs/WORKFLOW.md](./docs/WORKFLOW.md) | **🔥 Pipeline + Git workflow** |
 | [docs/FAQ.md](./docs/FAQ.md) | Câu hỏi thường gặp |
 | [CURSOR.md](./CURSOR.md) | AI instructions |
 | [CHANGELOG.md](./CHANGELOG.md) | Version history |
@@ -190,7 +195,7 @@ Xem chi tiết: [MIGRATION_GUIDE.md](./presets/MIGRATION_GUIDE.md)
 | Vấn đề | Giải pháp |
 |--------|-----------|
 | Commands không hoạt động | Dùng trong Chat Panel (`Ctrl+L`), restart Cursor |
-| AI không hiểu dự án | Tag files: `@.cursorrules @docs/project-overview-pdr.md` |
+| AI không hiểu dự án | Tag files: `@.cursorrules @docs/PROJECT.md` |
 | Không biết chọn preset | Hỏi Team Lead hoặc dùng `professional` |
 
 ---
@@ -201,4 +206,4 @@ MIT License
 
 ---
 
-**Built with ❤️ by Anchi Team**
+**Built with ❤️ by Anchi Team**

package/docs/{codebase-summary.md → CODEBASE.md}

@@ -2,7 +2,7 @@
 
 > 💻 **Purpose:** TECHNICAL document - HOW the code is structured
 > 
-> **For planning/requirements:** See [project-overview-pdr.md](./project-overview-pdr.md)
+> **For planning/requirements:** See [PROJECT.md](./PROJECT.md)
 
 ---
 
@@ -175,4 +175,4 @@ Run `npm list --depth=0` for full list.
 
 ---
 
-> 💡 **Note:** File này focus vào TECHNICAL. Xem [project-overview-pdr.md](./project-overview-pdr.md) cho planning/requirements.
+> 💡 **Note:** File này focus vào TECHNICAL. Xem [PROJECT.md](./PROJECT.md) cho planning/requirements.

package/docs/{code-standards.md → CODE_STYLE.md}

@@ -15,7 +15,7 @@
 | Validation | Optional | Zod required | Zod + Domain rules |
 | Testing | Basic | Unit tests | Full coverage |
 
-> 💡 Đánh dấu preset tại `docs/project-overview-pdr.md`
+> 💡 Đánh dấu preset tại `docs/PROJECT.md`
 
 ---
 

package/docs/FAQ.md

@@ -13,7 +13,7 @@
 ### Q: AI không hiểu context dự án?
 **A:** Tag files vào câu hỏi:
 ```
-@.cursorrules @docs/project-overview-pdr.md
+@.cursorrules @docs/PROJECT.md
 
 [Câu hỏi của bạn]
 ```

package/docs/{ONBOARDING_CHECKLIST.md → ONBOARDING.md}

@@ -28,14 +28,14 @@ Checklist cho member mới vào team. Đánh dấu `[x]` khi hoàn thành.
 
 ### Required Reading
 - [ ] `.cursorrules` - Biết preset và conventions
-- [ ] `docs/project-overview-pdr.md` - Hiểu dự án
-- [ ] `docs/TEAM_PIPELINE.md` - Workflow chuẩn
+- [ ] `docs/PROJECT.md` - Hiểu dự án
+- [ ] `docs/WORKFLOW.md` - Workflow chuẩn
 - [ ] `BEGINNER_GUIDE_VI.md` - Hướng dẫn sử dụng
 
 ### Optional Reading
 - [ ] `docs/code-standards.md` - Chi tiết coding standards
 - [ ] `docs/system-architecture.md` - Kiến trúc hệ thống
-- [ ] `docs/TEAM_PIPELINE.md` - Git workflow (đã merged)
+- [ ] `docs/WORKFLOW.md` - Git workflow (đã merged)
 
 ---
 
@@ -71,7 +71,7 @@ Checklist cho member mới vào team. Đánh dấu `[x]` khi hoàn thành.
 
 ### Codebase Understanding
 - [ ] Dùng `/scout` để tìm hiểu modules chính
-- [ ] Đọc `docs/codebase-summary.md`
+- [ ] Đọc `docs/CODEBASE.md`
 - [ ] Hiểu folder structure
 
 ### Team Integration

package/docs/{project-overview-pdr.md → PROJECT.md}

@@ -2,7 +2,7 @@
 
 > 📋 **Purpose:** PLANNING document - WHY & WHAT we're building
 > 
-> **For technical details (HOW):** See [codebase-summary.md](./codebase-summary.md)
+> **For technical details (HOW):** See [CODEBASE.md](./CODEBASE.md)
 
 ---
 
@@ -137,4 +137,4 @@
 
 ---
 
-> 💡 **Note:** File này focus vào PLANNING. Xem [codebase-summary.md](./codebase-summary.md) cho technical details.
+> 💡 **Note:** File này focus vào PLANNING. Xem [CODEBASE.md](./CODEBASE.md) cho technical details.

package/docs/{TEAM_PIPELINE.md → WORKFLOW.md}

@@ -54,7 +54,7 @@ cursor .
 
 | File | Việc cần làm |
 |------|-------------|
-| `docs/project-overview-pdr.md` | Mô tả dự án, features, goals |
+| `docs/PROJECT.md` | Mô tả dự án, features, goals |
 | `docs/system-architecture.md` | Đánh dấu preset, tech stack |
 | `docs/code-standards.md` | Review conventions |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anchi-kit",
-  "version": "2.0.3",
+  "version": "2.2.0",
   "description": "Cursor AI toolkit - Install into any existing project. Includes commands, agents, skills, and architecture presets.",
   "main": "src/cli.js",
   "bin": {

package/scripts/check-setup.ps1

@@ -15,7 +15,7 @@ $checks = @(
     @{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-overview-pdr.md"; Path = "docs/project-overview-pdr.md"; Required = $true; Description = "Project description" },
+    @{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" }
 )

package/scripts/install-hooks.ps1

@@ -0,0 +1,60 @@
+# ═══════════════════════════════════════════════════════════════
+# 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"
+$configFile = ".cursor\hooks.yaml"
+
+# 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
+$preCommitHook = @"
+#!/bin/sh
+# anchi-kit pre-commit hook
+# Reminder: Run /review:fast before committing
+
+echo "💡 anchi-kit reminder: Consider running /review:fast"
+echo "   To skip: git commit --no-verify"
+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
+$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 show reminders for anchi-kit commands." -ForegroundColor Yellow
+Write-Host "   To skip: use --no-verify flag" -ForegroundColor Gray
+Write-Host ""

package/scripts/install-hooks.sh

@@ -0,0 +1,54 @@
+#!/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
+# Reminder: Run /review:fast before committing
+
+echo "💡 anchi-kit reminder: Consider running /review:fast"
+echo "   To skip: git commit --no-verify"
+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/scripts/new-project.ps1

@@ -92,7 +92,7 @@ Write-Host "  2. Edit .cursorrules:" -ForegroundColor White
 Write-Host "     - Thay đổi Tech Stack phù hợp dự án" -ForegroundColor Gray
 Write-Host "     - Thêm coding conventions" -ForegroundColor Gray
 Write-Host ""
-Write-Host "  3. Edit docs/project-overview-pdr.md:" -ForegroundColor White
+Write-Host "  3. Edit docs/PROJECT.md:" -ForegroundColor White
 Write-Host "     - Mô tả dự án" -ForegroundColor Gray
 Write-Host "     - Liệt kê features" -ForegroundColor Gray
 Write-Host ""

package/scripts/new-project.sh

@@ -1,61 +1,61 @@
-#!/bin/bash
-# Script: Tạo Dự Án Mới Từ Template
-# Cách dùng: ./new-project.sh my-webapp
-
-PROJECT_NAME=$1
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-TEMPLATE_PATH="$(dirname "$SCRIPT_DIR")"
-TARGET_PATH="$(pwd)/$PROJECT_NAME"
-
-if [ -z "$PROJECT_NAME" ]; then
-    echo "❌ Vui lòng cung cấp tên dự án"
-    echo "Cách dùng: ./new-project.sh my-webapp"
-    exit 1
-fi
-
-echo ""
-echo "🚀 Tạo dự án: $PROJECT_NAME"
-echo "📁 Template: $TEMPLATE_PATH"
-echo "📂 Target: $TARGET_PATH"
-echo ""
-
-# Tạo folder và copy
-echo "📋 Copying template files..."
-mkdir -p "$TARGET_PATH"
-cp -r "$TEMPLATE_PATH"/* "$TARGET_PATH/"
-
-cd "$TARGET_PATH"
-
-# Xóa files không cần
-echo "🧹 Cleaning up unnecessary files..."
-rm -f CHANGELOG.md PROJECT_EXPLANATION_VI.md USAGE_GUIDE_VI.md
-rm -f .releaserc* .coverage .repomixignore .commitlintrc.json
-rm -rf guide tests
-
-# Init git
-echo "📦 Initializing git repository..."
-rm -rf .git
-git init > /dev/null 2>&1
-git add . > /dev/null 2>&1
-git commit -m "chore: init project with anchi-cursorkit-antigravity template" > /dev/null 2>&1
-
-# Cập nhật package.json
-echo "📝 Updating package.json..."
-if command -v jq &> /dev/null; then
-    jq ".name = \"$PROJECT_NAME\" | .version = \"1.0.0\" | .description = \"Project created with anchi-cursorkit-antigravity template\" | .author = \"$USER\"" package.json > temp.json && mv temp.json package.json
-fi
-
-echo ""
-echo "========================================"
-echo "  ✅ Dự án '$PROJECT_NAME' đã sẵn sàng!"
-echo "========================================"
-echo ""
-echo "📌 Bước tiếp theo:"
-echo ""
-echo "  1. Mở Cursor IDE:"
-echo "     cursor ."
-echo ""
-echo "  2. Edit .cursorrules"
-echo "  3. Edit docs/project-overview-pdr.md"
-echo "  4. Bắt đầu code với: /plan \"Feature description\""
-echo ""
+#!/bin/bash
+# Script: Tạo Dự Án Mới Từ Template
+# Cách dùng: ./new-project.sh my-webapp
+
+PROJECT_NAME=$1
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+TEMPLATE_PATH="$(dirname "$SCRIPT_DIR")"
+TARGET_PATH="$(pwd)/$PROJECT_NAME"
+
+if [ -z "$PROJECT_NAME" ]; then
+    echo "❌ Vui lòng cung cấp tên dự án"
+    echo "Cách dùng: ./new-project.sh my-webapp"
+    exit 1
+fi
+
+echo ""
+echo "🚀 Tạo dự án: $PROJECT_NAME"
+echo "📁 Template: $TEMPLATE_PATH"
+echo "📂 Target: $TARGET_PATH"
+echo ""
+
+# Tạo folder và copy
+echo "📋 Copying template files..."
+mkdir -p "$TARGET_PATH"
+cp -r "$TEMPLATE_PATH"/* "$TARGET_PATH/"
+
+cd "$TARGET_PATH"
+
+# Xóa files không cần
+echo "🧹 Cleaning up unnecessary files..."
+rm -f CHANGELOG.md PROJECT_EXPLANATION_VI.md USAGE_GUIDE_VI.md
+rm -f .releaserc* .coverage .repomixignore .commitlintrc.json
+rm -rf guide tests
+
+# Init git
+echo "📦 Initializing git repository..."
+rm -rf .git
+git init > /dev/null 2>&1
+git add . > /dev/null 2>&1
+git commit -m "chore: init project with anchi-cursorkit-antigravity template" > /dev/null 2>&1
+
+# Cập nhật package.json
+echo "📝 Updating package.json..."
+if command -v jq &> /dev/null; then
+    jq ".name = \"$PROJECT_NAME\" | .version = \"1.0.0\" | .description = \"Project created with anchi-cursorkit-antigravity template\" | .author = \"$USER\"" package.json > temp.json && mv temp.json package.json
+fi
+
+echo ""
+echo "========================================"
+echo "  ✅ Dự án '$PROJECT_NAME' đã sẵn sàng!"
+echo "========================================"
+echo ""
+echo "📌 Bước tiếp theo:"
+echo ""
+echo "  1. Mở Cursor IDE:"
+echo "     cursor ."
+echo ""
+echo "  2. Edit .cursorrules"
+echo "  3. Edit docs/PROJECT.md"
+echo "  4. Bắt đầu code với: /plan \"Feature description\""
+echo ""

package/src/cli.js

@@ -264,6 +264,11 @@ async function main() {
             await uninstall();
             break;
 
+        case 'doctor':
+            const { doctor } = require('./commands/doctor');
+            await doctor();
+            break;
+
         default:
             showHelp();
             break;
@@ -279,6 +284,7 @@ function showHelp() {
     log.success('  npx anchi-kit init       Cài đặt thông minh (chọn profile)');
     log.success('  npx anchi-kit update     Kiểm tra cập nhật');
     log.success('  npx anchi-kit uninstall  Gỡ cài đặt');
+    log.success('  npx anchi-kit doctor     Kiểm tra setup health');
     console.log('');
     console.log('Documentation:');
     console.log('  https://github.com/ANCHI-STE/anchi-webkit-dev');