anchi-toolkit 1.0.0 → 1.2.0

package/docs/WORKFLOW.md

@@ -1,6 +1,6 @@
 # 🚀 Team Pipeline Workflow
 
-Hướng dẫn chi tiết để team khai thác tối đa các chức năng của anchi-toolkit.
+Guideline cho team để phối hợp hiệu quả với Anchi Toolkit.
 
 ---
 
@@ -11,376 +11,115 @@ Hướng dẫn chi tiết để team khai thác tối đa các chức năng củ
 │                        TEAM PIPELINE WORKFLOW                            │
 └─────────────────────────────────────────────────────────────────────────┘
 
-Phase 1: SETUP          Phase 2: PLAN           Phase 3: IMPLEMENT
+Phase 1: START          Phase 2: EXECUTE        Phase 3: VERIFY
 ┌─────────────┐         ┌─────────────┐         ┌─────────────┐
-│ /use-preset │ ──────► │   /plan     │ ──────► │   /cook     │
-│ + docs      │         │ + /scout    │         │ + /design-* │
+│   /start    │ ──────► │     /do     │ ──────► │ /do --careful │
+│   (Recall)  │         │ (Auto Mode) │         │ (Test/Fix)  │
 └─────────────┘         └─────────────┘         └─────────────┘
                                                        │
                                                        ▼
-Phase 6: DEPLOY         Phase 5: REVIEW         Phase 4: VERIFY
-┌─────────────┐         ┌─────────────┐         ┌─────────────┐
-│ git push    │ ◄────── │  /review    │ ◄────── │   /test     │
-│ + CI/CD     │         │ + PR        │         │ + /fix      │
-└─────────────┘         └─────────────┘         └─────────────┘
+Phase 5: DEPLOY         Phase 4: REVIEW
+┌─────────────┐         ┌─────────────┐
+│   Git Publish   │ ◄────── │ Code Review │
+│     (CI/CD)     │         │ (Manual/AI) │
+└─────────────┘         └─────────────┘
 ```
 
 ---
 
-## 🎯 Phase 1: PROJECT SETUP
+## 🎯 Phase 1: PROJECT START
 
-### 1.1. Khởi Tạo Dự Án
+### 1.1. Khởi Tạo / Resume
 
 ```bash
-# Clone template
-git clone https://github.com/ANCHI-STE/anchi-webkit-dev.git my-project
-cd my-project
-cursor .
+/start
+# AI sẽ tự detect project mới hoặc recall session cũ.
 ```
 
-### 1.2. Chọn Preset (`Ctrl+L`)
-
-```
-/use-preset [rapid|professional|enterprise]
-```
-
-| Chọn | Khi nào |
-|------|---------|
-| `rapid` | Demo, prototype, < 2 tuần |
-| `professional` | Sản phẩm thương mại |
-| `enterprise` | Dự án lớn, DDD |
-
-### 1.3. Điền Documentation
+### 1.2. Setup Git Automation (Safety Net)
 
-| File | Việc cần làm |
-|------|-------------|
-| `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 |
-
-### 1.4. Setup Git
+Dev hay quên chạy test? Hãy cài "Lưới an toàn":
 
 ```bash
-git init
-git remote add origin https://github.com/ANCHI-STE/anchi-webkit-dev.git
-git checkout -b develop
+# Windows
+./scripts/install-hooks.ps1
+# Mac/Linux
+./scripts/install-hooks.sh
 ```
 
----
+_Tác dụng: Tự động chặn commit nếu code lỗi hoặc chưa format._
 
-## 📝 Phase 2: PLANNING
+### 1.3. Đồng Bộ Team
 
-### 2.1. Tìm Hiểu Codebase (Optional)
-
-```
-/scout "Tổng quan về dự án, folder structure"
-```
-
-### 2.2. Lập Kế Hoạch Feature
-
-```
-/plan "Mô tả chi tiết feature cần làm"
-```
-
-AI sẽ:
-1. Đọc `.cursorrules` → Biết preset
-2. Đọc `docs/` → Hiểu context
-3. Tạo plan với phases
-
-### 2.3. Review Plan
-
-- Kiểm tra plan có hợp lý
-- Điều chỉnh nếu cần
-- Approve để tiếp tục
-
----
-
-## 🔨 Phase 3: IMPLEMENTATION
-
-### 3.1. Design (Tùy nhu cầu)
-
-**UI Component:**
-```
-/design-ui "Login form với social login buttons"
-```
-
-**Domain Architecture (Professional/Enterprise):**
-```
-/design-domain "User authentication module"
-```
-
-### 3.2. Implement
-
-```
-/cook "Phase 1: Setup authentication routes"
-/cook "Phase 2: Implement login logic"
-/cook "Phase 3: Add UI components"
-```
-
-### 3.3. Command Workflow
-
-```
-┌─────────────────────────────────────────────────┐
-│                   /cook Flow                     │
-├─────────────────────────────────────────────────┤
-│ 1. Research    - Analyze requirements           │
-│ 2. Plan        - Create implementation steps    │
-│ 3. Implement   - Write code                     │
-│ 4. Test        - Run tests                      │
-│ 5. Review      - Code quality check             │
-│ 6. Document    - Update docs                    │
-└─────────────────────────────────────────────────┘
-```
-
----
-
-## ✅ Phase 4: VERIFICATION
-
-### 4.1. Run Tests
-
-```
-/test "Unit tests cho authentication module"
-```
-
-### 4.2. Fix Issues
-
-```
-/fix "Error: type mismatch in login handler"
-```
-
-**Fix routing:**
-| Issue Type | Command |
-|------------|---------|
-| Type errors | `/fix:types` |
-| UI bugs | `/fix:ui` |
-| Test failures | `/fix:test` |
-| Complex | `/fix:hard` |
-
-### 4.3. Manual Testing
+Luôn pull về trước khi làm việc:
 
 ```bash
-npm run dev
-# Test trong browser
+git pull origin develop
 ```
 
 ---
 
-## 👀 Phase 5: CODE REVIEW
+## 🔨 Phase 2: EXECUTE (The `/do` Magic)
 
-### 5.1. AI Review
+Thay vì nhớ 10 lệnh, chỉ cần nhớ `/do`.
 
-```
-/review
-```
+### Feature mới:
 
-### 5.2. Create PR
+> `/do "Thêm trang Dashboard có chart doanh thu"`
 
-```bash
-git add .
-git commit -m "feat(auth): add login functionality"
-git push origin feature/auth-login
-```
-
-### 5.3. GitHub PR
-
-- Tạo PR trên GitHub
-- Fill PR template
-- Request reviewers (auto từ CODEOWNERS)
-- Wait for CI to pass
-- Get approval
-
----
-
-## 🚀 Phase 6: DEPLOY
-
-### 6.1. Merge
-
-```bash
-# Sau khi approved
-git checkout develop
-git merge feature/auth-login
-git push origin develop
-```
-
-### 6.2. CI/CD
-
-GitHub Actions tự động:
-- Run lint + type check
-- Run tests
-- Build verification
-- Deploy (nếu configured)
-
-### 6.3. Update Docs
-
-```
-/docs update "Added authentication module"
-```
-
----
-
-## ⚡ QUICK REFERENCE
-
-### Commands Hay Dùng
-
-| Command | Mục đích |
-|---------|----------|
-| `/use-preset [name]` | Chọn architecture |
-| `/plan "..."` | Lập kế hoạch |
-| `/scout "..."` | Tìm hiểu code |
-| `/cook "..."` | Implement |
-| `/design-ui "..."` | Design UI |
-| `/design-domain "..."` | Design DDD |
-| `/test "..."` | Viết tests |
-| `/fix "..."` | Sửa bug |
-| `/review` | Code review |
-
-### Phím Tắt Cursor
-
-| Phím | Chức năng |
-|------|-----------|
-| `Ctrl+L` | Mở Chat Panel |
-| `Ctrl+K` | Inline AI edit |
-| `Ctrl+P` | Tìm file |
-| `Ctrl+`` ` | Terminal |
-
-### Git Conventions
-
-```bash
-# Feature
-git commit -m "feat(scope): description"
+### Fix bug:
 
-# Bug fix
-git commit -m "fix(scope): description"
+> `/do "Sửa lỗi button login không click được"`
 
-# Docs
-git commit -m "docs(scope): description"
-```
-
----
-
-## 📊 Workflow Theo Role
+### Refactor:
 
-### 👤 Developer
-
-```
-Morning:
-  git pull origin develop
-  
-During day:
-  /plan "task"
-  /cook "phase"
-  /test
-  /review
-  
-End of day:
-  git commit + push
-  Create PR
-```
+> `/do "Refactor file user.service.ts theo chuẩn DDD"`
 
-### 👤 Tech Lead
+### ⚠️ Quy tắc Teamwork:
 
-```
-Review PRs
-Setup branch protection
-Update presets if needed
-Mentor team on commands
-```
-
-### 👤 Team Lead
-
-```
-Manage roadmap (docs/project-roadmap.md)
-Review architecture decisions
-Approve major PRs
-```
+- **Luôn dùng Branch:** Đừng làm trực tiếp trên main/develop.
+- **Tương tác:** Nếu AI hỏi xác nhận (Risk Alert), hãy đọc kỹ trước khi Yes.
 
 ---
 
-## 🎯 Best Practices
+## ✅ Phase 3: VERIFY & REVIEW
 
-### ✅ DO
+### 3.1. Verify
 
-- Luôn chạy `/plan` trước khi code
-- Điền đầy đủ `docs/` để AI hiểu context
-- Dùng `/scout` khi chưa quen codebase
-- Commit thường xuyên với Conventional Commits
-- Request review qua PR
+Chạy test và check code:
 
-### ❌ DON'T
+> `/do "Chạy full test suite"` > `/do "Review code này xem có security flaw không"`
 
-- Code mà không có plan
-- Push trực tiếp lên main
-- Ignore CI failures
-- Skip code review
-- Quên update docs
+### 3.2. Tạo Pull Request
 
----
-
-## 📞 Support
+Khi code đã ổn:
 
-| Vấn đề | Giải pháp |
-|--------|-----------|
-| Commands không work | `Ctrl+L`, restart Cursor |
-| AI không hiểu | Tag files: `@.cursorrules` |
-| CI failed | Check GitHub Actions logs |
-| Need help | Hỏi team lead |
+1.  Review lại thay đổi.
+2.  Commit & Push.
+3.  Tạo PR trên GitHub/GitLab.
 
 ---
 
-## 🔀 GIT & GITHUB WORKFLOW
-
-### Branch Strategy
-
-```
-main ─────────────────────────────► Production
-  │
-  └── develop ────────────────────► Integration
-        │
-        ├── feature/auth-login
-        ├── feature/product-crud
-        └── fix/button-style
-```
+## 🔀 GIT WORKFLOW (Chuẩn Team)
 
 ### Branch Naming
 
-| Type | Format | Example |
-|------|--------|---------|
-| Feature | `feature/[name]` | `feature/user-profile` |
-| Bug fix | `fix/[name]` | `fix/login-error` |
-| Hotfix | `hotfix/[name]` | `hotfix/security-patch` |
+- Feature: `feat/ten-chuc-nang`
+- Bugfix: `fix/ten-loi`
+- Hotfix: `hotfix/loi-gap`
 
-### Commit Conventions
+### Commit Message
 
-```bash
-feat(scope): description    # New feature
-fix(scope): description     # Bug fix
-docs(scope): description    # Documentation
-refactor(scope): desc       # Refactoring
-```
-
-### CI/CD Automation
-
-| Trigger | Actions |
-|---------|---------|
-| Push/PR | ESLint, TypeScript, Tests, Build |
-| Tag `v*` | Auto create release |
+- `feat: thêm chức năng login`
+- `fix: sửa lỗi typo`
+- `docs: cập nhật readme`
 
-### CODEOWNERS (Auto Reviewers)
-
-| Path | Reviewers |
-|------|-----------|
-| `/presets/` | @tech-lead |
-| `/.cursor/` | @ai-team |
-| `/src/components/` | @frontend-team |
-| `/src/modules/` | @backend-team |
+---
 
-### Branch Protection (Manual Setup)
+## 🤝 Team Roles
 
-Team lead setup trong **GitHub Settings → Branches**:
-- ✅ Require PR reviews (1 approval)
-- ✅ Require CI to pass
-- ✅ No direct push to main
+- **Lead:** Setup `.cursorrules` và `team.yaml`. Review PR.
+- **Dev:** Chạy `/do` để code feature. Tạo PR.
+- **Reviewer:** Check logic, merge PR.
 
 ---
-
-> 💡 **Tip:** Bookmark file này và dùng như reference hàng ngày!

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "anchi-toolkit",
-  "version": "1.0.0",
-  "description": "Cursor AI toolkit - Install into any existing project. Includes commands, agents, skills, and architecture presets.",
+  "version": "1.2.0",
+  "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": {
     "anchi-toolkit": "./src/cli.js"
@@ -38,6 +38,8 @@
     "scripts/",
     ".cursor/",
     ".antigravity/",
+    ".ai-audit/",
+    ".ai-memory/",
     "presets/",
     "docs/",
     ".cursorrules",
@@ -48,6 +50,11 @@
     "CHANGELOG.md",
     "LICENSE"
   ],
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "ora": "^5.4.1",
+    "prompts": "^2.4.2"
+  },
   "devDependencies": {
     "@commitlint/cli": "^18.4.3",
     "@commitlint/config-conventional": "^18.4.3",

package/presets/ci-cd/ai-review.yml

@@ -0,0 +1,49 @@
+name: Anchi AI Review
+# 🤖 Auto-generated by anchi-toolkit
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  ai-review:
+    name: 🧠 AI Analysis
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: "18"
+
+      - name: Install Tooling
+        run: |
+          npm install -g anchi-toolkit
+          # Install dependencies based on project (modify if using pnpm/yarn)
+          npm ci || npm install
+
+      - name: 🛡️ Health Check
+        run: npx anchi-toolkit doctor
+
+      - name: 🧪 Run Tests (Safety Net)
+        run: |
+          if npm run | grep -q "test"; then
+            npm test
+          else
+            echo "⚠️ No test script found. Skipping."
+          fi
+
+      # Placeholder for Phase 2: AI Review execution
+      # - name: 🧠 AI Review
+      #   env:
+      #     GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
+      #   run: npx anchi-toolkit review --ci --output pr_comment

package/scripts/install-hooks.ps1

@@ -9,7 +9,6 @@ Write-Host ""
 
 $gitDir = ".git"
 $hooksDir = "$gitDir\hooks"
-$configFile = ".cursor\hooks.yaml"
 
 # Check if git repository
 if (-not (Test-Path $gitDir)) {
@@ -22,14 +21,29 @@ if (-not (Test-Path $hooksDir)) {
     New-Item -ItemType Directory -Path $hooksDir -Force | Out-Null
 }
 
-# Create pre-commit hook
+# Create pre-commit hook (Enforce Tests)
 $preCommitHook = @"
 #!/bin/sh
 # anchi-kit pre-commit hook
-# Reminder: Run /review:fast before committing
+# Enforces code quality by running tests
 
-echo "💡 anchi-kit reminder: Consider running /review:fast"
-echo "   To skip: git commit --no-verify"
+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
 "@
 
@@ -37,7 +51,7 @@ $preCommitPath = "$hooksDir\pre-commit"
 Set-Content -Path $preCommitPath -Value $preCommitHook -NoNewline
 Write-Host "✅ Installed: pre-commit hook" -ForegroundColor Green
 
-# Create post-merge hook
+# Create post-merge hook (Reminder)
 $postMergeHook = @"
 #!/bin/sh
 # anchi-kit post-merge hook
@@ -55,6 +69,6 @@ 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 "📌 Hooks will verify tests before commit." -ForegroundColor Yellow
 Write-Host "   To skip: use --no-verify flag" -ForegroundColor Gray
 Write-Host ""

package/scripts/install-hooks.sh

@@ -24,10 +24,25 @@ mkdir -p "$HOOKS_DIR"
 cat > "$HOOKS_DIR/pre-commit" << 'EOF'
 #!/bin/sh
 # anchi-kit pre-commit hook
-# Reminder: Run /review:fast before committing
+# Enforces code quality by running tests
 
-echo "💡 anchi-kit reminder: Consider running /review:fast"
-echo "   To skip: git commit --no-verify"
+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"