anchi-toolkit 1.2.0 → 1.2.1

package/dist/docs/UX_MODES.md

@@ -0,0 +1,173 @@
+# UX Mode System
+
+> **Command mode → Command owns the UI
+> Prompt mode → AI Agent owns the UI**
+
+Hai mode **loại trừ nhau**, không bao giờ hiển thị song song.
+
+---
+
+## 📜 Rule #1: Mode Decides the Voice
+
+```
+IF user_input = command (starts with /)
+→ Command owns the UI
+
+ELSE (free text prompt)
+→ AI Agent owns the UI
+```
+
+**Không có ngoại lệ.**
+
+---
+
+## 1️⃣ Command Mode
+
+### Khi nào?
+User gõ command bắt đầu bằng `/`:
+```
+/do "Add login"
+/commit
+/test
+```
+
+### Hiển thị:
+- ✅ Command log (summary, files, status, risk)
+- ✅ Structured output
+- ✅ Governance indicators
+
+### Không hiển thị:
+- ❌ Agent progress narration
+- ❌ "AI decided…"
+- ❌ "User approved…"
+- ❌ Raw execution text
+
+> 👉 AI agent **im lặng hoàn toàn** ở UI.
+
+### Output Format:
+```
+📋 /do "Add user login"
+
+═══════════════════════════════════════════════
+📊 Analysis:
+├── Agent: fullstack-developer (0.85)
+├── Skills: better-auth, databases
+└── Risk: medium
+
+📋 Plan:
+1. Create AuthService
+2. Create login page
+3. Add session middleware
+
+⏱️ Estimated: 5-8 minutes
+═══════════════════════════════════════════════
+
+[Progress bar or status updates only]
+
+✅ Completed: 4 files created
+```
+
+---
+
+## 2️⃣ Prompt Mode (Chat Mode)
+
+### Khi nào?
+User gõ free text (không có `/`):
+```
+Create a walkthrough documentation for new users
+Can you help me understand the auth flow?
+```
+
+### Hiển thị:
+- ✅ AI agent narration
+- ✅ Progress updates
+- ✅ Explanations
+- ✅ "I'll create these files..."
+
+### Không hiển thị:
+- ❌ Command log format
+- ❌ Governance summary
+- ❌ Risk assessment
+
+> 👉 Đây là mode **exploratory**, không governance.
+
+### Output Format:
+```
+I'll help you create a walkthrough documentation for new users.
+
+Let me create the documentation file...
+
+[Creates docs/WALKTHROUGH.md]
+
+I've created the walkthrough with the following sections:
+- Day 1: Setup
+- Day 2: First feature
+...
+
+Would you like me to add anything else?
+```
+
+---
+
+## 📊 Comparison Table
+
+| Aspect | Command Mode | Prompt Mode |
+|--------|--------------|-------------|
+| **Purpose** | Controlled execution | Exploration |
+| **Narrator** | Command | AI Agent |
+| **UX** | Clean, tool-like | Rich, conversational |
+| **Log shown** | Command log | Agent narration |
+| **Best for** | Long-term, team | Quick trial, personal |
+| **Governance** | Yes | No |
+
+---
+
+## 🚨 Absolute Rules
+
+### ❌ Never Do:
+1. Show agent chat while in command mode
+2. Merge base log into command log
+3. Auto-switch to command log during free chat
+4. Mix narration styles
+
+### ✅ Always Do:
+1. Clear mode indicator
+2. Consistent log format per mode
+3. Let mode determine narrator
+4. Respect user's mode choice
+
+---
+
+## 🎯 Mode Indicator (Optional Enhancement)
+
+Display current mode to user:
+```
+┌─────────────────────────────────────┐
+│ Mode: Command 📋                    │
+└─────────────────────────────────────┘
+
+┌─────────────────────────────────────┐
+│ Mode: Chat 💬                       │
+└─────────────────────────────────────┘
+```
+
+User **luôn biết mình đang ở đâu**.
+
+---
+
+## 🧩 Why This Works
+
+| Benefit | Reason |
+|---------|--------|
+| No log conflict | Only 1 narrator at a time |
+| No overload | User sees only what they chose |
+| Matches kit philosophy | Command = governance, Prompt = freedom |
+| Easy to teach | "Want control → command", "Want explore → prompt" |
+
+---
+
+## 🔗 Related
+
+- [docs/ORCHESTRATION.md](./ORCHESTRATION.md) - AI meta-layer
+- [docs/AI_CONTRACT.md](./AI_CONTRACT.md) - Constitutional rules
+- [CURSOR.md](../CURSOR.md) - AI behavior configuration

package/dist/docs/WORKFLOW.md

@@ -0,0 +1,125 @@
+# 🚀 Team Pipeline Workflow
+
+Guideline cho team để phối hợp hiệu quả với Anchi Toolkit.
+
+---
+
+## 📋 Tổng Quan Pipeline
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                        TEAM PIPELINE WORKFLOW                            │
+└─────────────────────────────────────────────────────────────────────────┘
+
+Phase 1: START          Phase 2: EXECUTE        Phase 3: VERIFY
+┌─────────────┐         ┌─────────────┐         ┌─────────────┐
+│   /start    │ ──────► │     /do     │ ──────► │ /do --careful │
+│   (Recall)  │         │ (Auto Mode) │         │ (Test/Fix)  │
+└─────────────┘         └─────────────┘         └─────────────┘
+                                                       │
+                                                       ▼
+Phase 5: DEPLOY         Phase 4: REVIEW
+┌─────────────┐         ┌─────────────┐
+│   Git Publish   │ ◄────── │ Code Review │
+│     (CI/CD)     │         │ (Manual/AI) │
+└─────────────┘         └─────────────┘
+```
+
+---
+
+## 🎯 Phase 1: PROJECT START
+
+### 1.1. Khởi Tạo / Resume
+
+```bash
+/start
+# AI sẽ tự detect project mới hoặc recall session cũ.
+```
+
+### 1.2. Setup Git Automation (Safety Net)
+
+Dev hay quên chạy test? Hãy cài "Lưới an toàn":
+
+```bash
+# 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._
+
+### 1.3. Đồng Bộ Team
+
+Luôn pull về trước khi làm việc:
+
+```bash
+git pull origin develop
+```
+
+---
+
+## 🔨 Phase 2: EXECUTE (The `/do` Magic)
+
+Thay vì nhớ 10 lệnh, chỉ cần nhớ `/do`.
+
+### Feature mới:
+
+> `/do "Thêm trang Dashboard có chart doanh thu"`
+
+### Fix bug:
+
+> `/do "Sửa lỗi button login không click được"`
+
+### Refactor:
+
+> `/do "Refactor file user.service.ts theo chuẩn DDD"`
+
+### ⚠️ Quy tắc Teamwork:
+
+- **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.
+
+---
+
+## ✅ Phase 3: VERIFY & REVIEW
+
+### 3.1. Verify
+
+Chạy test và check code:
+
+> `/do "Chạy full test suite"` > `/do "Review code này xem có security flaw không"`
+
+### 3.2. Tạo Pull Request
+
+Khi code đã ổn:
+
+1.  Review lại thay đổi.
+2.  Commit & Push.
+3.  Tạo PR trên GitHub/GitLab.
+
+---
+
+## 🔀 GIT WORKFLOW (Chuẩn Team)
+
+### Branch Naming
+
+- Feature: `feat/ten-chuc-nang`
+- Bugfix: `fix/ten-loi`
+- Hotfix: `hotfix/loi-gap`
+
+### Commit Message
+
+- `feat: thêm chức năng login`
+- `fix: sửa lỗi typo`
+- `docs: cập nhật readme`
+
+---
+
+## 🤝 Team Roles
+
+- **Lead:** Setup `.cursorrules` và `team.yaml`. Review PR.
+- **Dev:** Chạy `/do` để code feature. Tạo PR.
+- **Reviewer:** Check logic, merge PR.
+
+---

package/dist/index.js

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/presets/MIGRATION_GUIDE.md

@@ -0,0 +1,270 @@
+# 🔄 Migration Guide: Chuyển Đổi Giữa Các Presets
+
+Hướng dẫn upgrade/migrate giữa các architecture levels.
+
+---
+
+## Tổng Quan Migration Paths
+
+```
+┌─────────────┐      ┌──────────────────┐      ┌─────────────────┐
+│ RAPID MVP   │ ───► │   PROFESSIONAL   │ ───► │   ENTERPRISE    │
+│ (Prototype) │      │ (Scalable Prod)  │      │ (Full DDD)      │
+└─────────────┘      └──────────────────┘      └─────────────────┘
+    SQLite              PostgreSQL               PostgreSQL
+    Simple files        Modules + Services       DDD Layers
+    Inline logic        Service pattern          Domain + Events
+```
+
+---
+
+## 🚀 Rapid → Professional
+
+### Thời gian ước tính: 1-2 ngày
+
+### Bước 1: Database Migration
+```bash
+# Đổi DATABASE_URL trong .env
+DATABASE_URL="postgresql://..."
+
+# Push schema
+npx prisma db push
+```
+
+### Bước 2: Tạo Module Structure
+```
+# Từ:
+src/
+├── app/api/products/route.ts
+└── components/ProductCard.tsx
+
+# Thành:
+src/
+├── modules/
+│   └── products/
+│       ├── components/ProductCard.tsx
+│       ├── services/product.service.ts
+│       ├── types/product.types.ts
+│       └── index.ts
+```
+
+### Bước 3: Extract Services
+```typescript
+// TRƯỚC: Inline trong route
+// app/api/products/route.ts
+export async function GET() {
+  const products = await prisma.product.findMany();
+  return Response.json(products);
+}
+
+// SAU: Service pattern
+// modules/products/services/product.service.ts
+export const productService = {
+  getAll: () => prisma.product.findMany(),
+  getById: (id: string) => prisma.product.findUnique({ where: { id } }),
+};
+
+// app/api/products/route.ts
+import { productService } from '@/modules/products';
+
+export async function GET() {
+  const products = await productService.getAll();
+  return Response.json(products);
+}
+```
+
+### Bước 4: Add Validation
+```typescript
+// modules/products/schemas/product.schema.ts
+import { z } from 'zod';
+
+export const createProductSchema = z.object({
+  name: z.string().min(1),
+  price: z.number().positive(),
+});
+
+export type CreateProductInput = z.infer<typeof createProductSchema>;
+```
+
+### Bước 5: Update Imports
+```typescript
+// Tạo index.ts cho mỗi module
+// modules/products/index.ts
+export * from './services/product.service';
+export * from './types/product.types';
+export * from './components/ProductCard';
+```
+
+### Checklist
+- [ ] Database migrated
+- [ ] Modules created
+- [ ] Services extracted
+- [ ] Zod schemas added
+- [ ] Index exports setup
+
+---
+
+## 🏢 Professional → Enterprise
+
+### Thời gian ước tính: 3-5 ngày
+
+### Bước 1: Add Domain Layer
+
+```typescript
+// TRƯỚC: Service chỉ có methods
+// modules/products/services/product.service.ts
+export const productService = {
+  create: (data) => prisma.product.create({ data }),
+};
+
+// SAU: Domain Entity
+// modules/products/domain/entities/Product.ts
+import { Entity } from '@/shared/domain';
+
+export class Product extends Entity<string> {
+  private _name: string;
+  private _price: number;
+  private _status: ProductStatus;
+
+  static create(name: string, price: number): Product {
+    if (price <= 0) throw new Error('Price must be positive');
+    return new Product(uuid(), name, price, ProductStatus.DRAFT);
+  }
+
+  publish(): void {
+    if (this._status !== ProductStatus.DRAFT) {
+      throw new Error('Can only publish draft products');
+    }
+    this._status = ProductStatus.PUBLISHED;
+    this.addDomainEvent(new ProductPublished(this.id));
+  }
+}
+```
+
+### Bước 2: Create Value Objects
+
+```typescript
+// modules/products/domain/value-objects/Money.ts
+export class Money extends ValueObject<{ amount: number; currency: string }> {
+  get amount(): number { return this.props.amount; }
+  get currency(): string { return this.props.currency; }
+
+  static create(amount: number, currency = 'VND'): Money {
+    if (amount < 0) throw new Error('Amount cannot be negative');
+    return new Money({ amount, currency });
+  }
+
+  add(other: Money): Money {
+    if (this.currency !== other.currency) {
+      throw new Error('Currency mismatch');
+    }
+    return Money.create(this.amount + other.amount, this.currency);
+  }
+}
+```
+
+### Bước 3: Define Aggregates
+
+```typescript
+// modules/orders/domain/aggregates/Order.ts
+export class Order extends AggregateRoot<OrderId> {
+  private _items: OrderItem[];
+  private _status: OrderStatus;
+
+  addItem(product: ProductId, quantity: number, price: Money): void {
+    this._items.push(OrderItem.create(product, quantity, price));
+    this.addDomainEvent(new ItemAddedToOrder(this.id, product));
+  }
+
+  place(): void {
+    this._status = OrderStatus.PLACED;
+    this.addDomainEvent(new OrderPlaced({
+      orderId: this.id,
+      items: this._items,
+      total: this.calculateTotal()
+    }));
+  }
+}
+```
+
+### Bước 4: Implement Domain Events
+
+```typescript
+// shared/infrastructure/EventBus.ts
+class EventBus {
+  private handlers = new Map<string, EventHandler[]>();
+
+  subscribe(eventType: string, handler: EventHandler): void {
+    const handlers = this.handlers.get(eventType) || [];
+    handlers.push(handler);
+    this.handlers.set(eventType, handlers);
+  }
+
+  async publish(event: DomainEvent): Promise<void> {
+    const handlers = this.handlers.get(event.eventType) || [];
+    await Promise.all(handlers.map(h => h.handle(event)));
+  }
+}
+```
+
+### Bước 5: Update Repository Pattern
+
+```typescript
+// TRƯỚC: Direct Prisma
+const product = await prisma.product.findUnique({ where: { id } });
+
+// SAU: Repository Interface + Implementation
+// domain/repositories/IProductRepository.ts
+export interface IProductRepository {
+  findById(id: ProductId): Promise<Product | null>;
+  save(product: Product): Promise<void>;
+}
+
+// infrastructure/persistence/PrismaProductRepository.ts
+export class PrismaProductRepository implements IProductRepository {
+  async findById(id: ProductId): Promise<Product | null> {
+    const data = await prisma.product.findUnique({ where: { id: id.value } });
+    return data ? ProductMapper.toDomain(data) : null;
+  }
+}
+```
+
+### Checklist
+- [ ] Domain entities with behavior
+- [ ] Value objects for validation
+- [ ] Aggregate boundaries defined
+- [ ] Domain events implemented
+- [ ] Repository interfaces in domain
+- [ ] Event handlers for cross-module
+
+---
+
+## 💡 Tips
+
+### Migrate Incrementally
+- Upgrade từng module một
+- Không cần migrate tất cả cùng lúc
+- Critical modules trước
+
+### Maintain Compatibility
+- Keep API routes stable
+- Use adapters for old code
+- Feature flags for gradual rollout
+
+### Testing Strategy
+- Write tests trước khi migrate
+- Tests đảm bảo behavior không đổi
+- Add integration tests
+
+---
+
+## 🆘 Khi Gặp Vấn Đề
+
+```
+/help-migrate "Mô tả vấn đề"
+```
+
+Hoặc tham khảo:
+- `presets/rapid-mvp/README.md`
+- `presets/professional/README.md`
+- `presets/enterprise/README.md`

package/dist/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/dist/presets/enterprise/contract.json

@@ -0,0 +1,93 @@
+{
+    "name": "enterprise",
+    "displayName": "Enterprise",
+    "version": "3.2.0",
+    "architecture": {
+        "type": "ddd",
+        "database": "PostgreSQL + Redis",
+        "structure": "bounded-contexts"
+    },
+    "rules": {
+        "allowed": [
+            "DDD patterns",
+            "bounded contexts",
+            "domain events",
+            "CQRS",
+            "event sourcing"
+        ],
+        "forbidden": [
+            "anemic domain models",
+            "logic in controllers",
+            "direct database in application layer",
+            "circular dependencies",
+            "god objects",
+            "inline SQL",
+            "skip code review",
+            "skip tests",
+            "hardcoded secrets"
+        ],
+        "warnings": [
+            "missing integration tests",
+            "missing domain events",
+            "missing audit logging"
+        ]
+    },
+    "checks": {
+        "required": [
+            "syntax",
+            "lint",
+            "type-check",
+            "test",
+            "security-scan"
+        ],
+        "optional": [],
+        "coverage_min": 80
+    },
+    "approvals": {
+        "code_changes": true,
+        "architecture_changes": true,
+        "destructive_actions": true,
+        "security_changes": true
+    },
+    "ai_behavior": {
+        "speed_priority": false,
+        "explanation_level": "detailed",
+        "auto_approve": false,
+        "require_tests": true
+    },
+    "migration": {
+        "previous": "professional",
+        "next": null,
+        "requirements": []
+    },
+    "patterns": {
+        "file_naming": "kebab-case",
+        "component_naming": "PascalCase",
+        "function_naming": "camelCase",
+        "domain_structure": [
+            "src/domain/{context}/",
+            "src/domain/{context}/entities/",
+            "src/domain/{context}/value-objects/",
+            "src/domain/{context}/events/",
+            "src/domain/{context}/services/",
+            "src/domain/{context}/repositories/"
+        ],
+        "application_structure": [
+            "src/application/{context}/",
+            "src/application/{context}/commands/",
+            "src/application/{context}/queries/",
+            "src/application/{context}/handlers/"
+        ],
+        "infrastructure_structure": [
+            "src/infrastructure/",
+            "src/infrastructure/persistence/",
+            "src/infrastructure/messaging/",
+            "src/infrastructure/external/"
+        ]
+    },
+    "compliance": {
+        "audit_logging": true,
+        "data_retention": "90 days",
+        "security_review": "required"
+    }
+}