evnict-kit 0.2.1

package/templates/workflows/claude/evnict-kit-wiki-archive-feature.md

@@ -0,0 +1,162 @@
+# Wiki Archive Feature
+**Command:** `/evnict-kit:wiki-archive-feature $ARGUMENTS`
+
+$ARGUMENTS chứa mô tả từ user.
+
+## Khi nào dùng
+- Sau khi hoàn thành feature-large hoặc feature-small
+- Sau khi `/evnict-kit:archive-wiki` chạy xong (hoặc thay thế archive-wiki)
+- Khi muốn nạp tri thức thủ công cho 1 feature cụ thể
+
+## Input
+- Feature slug (auto-detect từ `.evnict/specs/` gần nhất hoặc chỉ định)
+
+---
+
+## Pre-checks
+
+### Check 1: Wiki accessible
+```bash
+ls -la {project_name}-wiki/
+```
+Nếu không tồn tại → DỪNG: *"Wiki chưa được liên kết. Chạy `evnict-kit init` hoặc tạo symlink thủ công."*
+
+### Check 2: Wiki đã setup
+```bash
+ls {project_name}-wiki/package.json
+```
+Nếu không tồn tại → DỪNG: *"Wiki chưa khởi tạo. Chạy `/evnict-kit:init-wiki` trước."*
+
+---
+
+## Bước 1: Thu thập đầu vào
+Đọc TẤT CẢ files liên quan đến feature:
+
+| Nguồn | Path | Nội dung trích xuất |
+|-------|------|---------------------|
+| Spec | `.evnict/specs/{feature}/spec.md` | WHAT, WHY, Business Rules, Acceptance Criteria |
+| Plan | `.evnict/specs/{feature}/plan.md` | DB Schema, API Design, FE Design, Task breakdown |
+| Task files | `.evnict/specs/{feature}/tasks/*.md` | Implementation details, test cases |
+| API Contract | `.evnict/handoff/contracts/{feature}-api.yaml` | Endpoints, request/response |
+| Git log | `git log --oneline main..HEAD` | Commits, files changed |
+| Handoff | `.evnict/handoff/handoff.md` | Cross-project context (entries liên quan feature) |
+
+> **Nếu file nào không tồn tại → bỏ qua nguồn đó, KHÔNG dừng.**
+
+## Bước 2: Sinh wiki note
+Tạo file markdown HOÀN CHỈNH (không phải tóm tắt sơ sài):
+
+```markdown
+---
+title: "Chức năng {feature_name}"
+discovered: {YYYY-MM-DD}
+topic: "{module}"
+tags: [{feature, module, api, database}]
+source: "evnict-kit-auto"
+type: feature
+---
+
+# ═══ PHẦN NGHIỆP VỤ ═══
+
+## Tổng quan
+{Trích từ spec: WHAT + WHY — 5-10 câu}
+
+## Mục đích chức năng
+{Chức năng này giải quyết vấn đề gì cho user? — 3-5 câu}
+{Suy ra từ spec WHAT/WHY + code implementation}
+
+## Đối tượng sử dụng
+{Ai dùng? Role nào? Quyền gì?}
+{Suy ra từ: spec, auth annotations, role checks}
+
+## Nghiệp vụ chính
+### Luồng chính
+{Trích từ spec: Main Flow}
+
+### Luồng ngoại lệ
+{Trích từ spec: Exception Flow}
+
+### Nhập/Thêm mới
+- {Mô tả hành vi, fields cần nhập, ràng buộc}
+
+### Danh sách/Tìm kiếm
+- {Mô tả filters, phân trang, sort}
+
+### Sửa/Cập nhật
+- {Mô tả}
+
+### Xóa
+- {Mô tả, confirm logic}
+
+## Quy tắc nghiệp vụ
+| Mã | Quy tắc |
+|----|---------|
+| BR01 | {Trích từ spec + suy ra từ validation logic} |
+| BR02 | {Suy ra từ unique constraints, foreign keys} |
+| BR03 | {Suy ra từ authorization checks} |
+
+## Liên kết chức năng
+{Module này liên quan đến module nào khác?}
+{Suy ra từ: foreign keys, service dependencies, shared DTOs}
+- **{Module A}**: {mô tả liên kết}
+- **{Module B}**: {mô tả liên kết}
+
+# ═══ PHẦN KỸ THUẬT ═══
+
+## Database
+{Trích từ plan: tables, columns, relationships}
+
+## API Endpoints
+| Method | Path | Mô tả |
+|--------|------|-------|
+{Trích từ plan hoặc API contract}
+
+## Backend
+- Controller: {file, endpoints}
+- Service: {file, business logic}
+- Repository: {file, JOOQ queries}
+- DTO: {file, fields}
+
+## Frontend
+- Component: {file, mô tả}
+- Service: {file, API calls}
+- Page: {route, mô tả}
+
+## Files liên quan
+{List files created/modified — từ git diff}
+
+## Tham chiếu
+- Spec: `.evnict/specs/{feature}/spec.md`
+- Plan: `.evnict/specs/{feature}/plan.md`
+- API Contract: `.evnict/handoff/contracts/{feature}-api.yaml`
+```
+
+## Bước 3: Push + Auto-ingest
+```bash
+cp {generated_file} {wiki_path}/raw/notes/{module}-{feature-slug}.md
+cd {wiki_path} && node scripts/ingest.js
+```
+Nếu `scripts/ingest.js` không tồn tại → thử `npm run ingest`.
+Nếu vẫn fail → báo: *"Chạy `/evnict-kit:init-wiki`"*
+
+## Bước 4: Confirm
+```
+✅ Wiki note created: {wiki_path}/raw/notes/{file}
+   Nội dung: {N} sections, {M} API endpoints, {K} business rules
+✅ Ingest completed
+```
+
+---
+
+## Lưu ý
+- Workflow này thay thế phần wiki trong `/evnict-kit:archive-wiki`
+- Wiki note PHẢI hoàn chỉnh — không chỉ tóm tắt 3-5 câu
+- Nếu feature có cả BE+FE → ghi đủ cả 2 phần (Backend + Frontend)
+- Nếu thiếu thông tin FE/BE → ghi phần có, note phần thiếu
+
+## Checklist hoàn thành
+- [ ] Đọc đủ nguồn (spec, plan, tasks, contract, git log)
+- [ ] Wiki note sinh đúng format frontmatter
+- [ ] Đủ sections: Tổng quan, Nghiệp vụ, Kỹ thuật, Files, Tham chiếu
+- [ ] File copied vào `raw/notes/`
+- [ ] Ingest triggered thành công

package/templates/workflows/claude/evnict-kit-wiki-query.md

@@ -0,0 +1,89 @@
+# Wiki Query
+**Command:** `/evnict-kit:wiki-query $ARGUMENTS`
+
+$ARGUMENTS chứa mô tả từ user.
+
+## Khi nào dùng
+- Trước khi bắt đầu feature mới → tìm context liên quan
+- Khi fix bug → tìm thông tin chức năng bị bug
+- Khi cần hiểu business rule → tìm trong wiki
+- Khi onboard → tìm hiểu module
+
+## Input
+- Từ khóa tìm kiếm (tiếng Việt hoặc tiếng Anh)
+- VD: `/evnict-kit:wiki-query "công suất giờ"`
+- VD: `/evnict-kit:wiki-query "API import CSV"`
+
+---
+
+## Bước 1: Xác định wiki path
+1. Check symlink `{project_name}-wiki/` trong thư mục gốc project
+2. Nếu không tồn tại → đọc `.evnict/config.yaml` → lấy `wiki.folder`
+3. Nếu vẫn không tìm thấy → DỪNG: *"Wiki chưa được liên kết. Chạy `evnict-kit init`."*
+
+## Bước 2: Search
+1. Đọc `{wiki_path}/wiki/INDEX.md` → map keywords (nếu INDEX tồn tại)
+2. Search trong `{wiki_path}/processed/` và `{wiki_path}/raw/notes/`:
+   ```bash
+   grep -rl "{keyword}" {wiki_path}/processed/ --include="*.md"
+   grep -rl "{keyword}" {wiki_path}/raw/notes/ --include="*.md"
+   ```
+3. Đọc các pages liên quan (đọc ĐỦ nội dung, không chỉ 1-2 trang)
+4. Nếu keyword không khớp chính xác → thử tìm kiếm mở rộng:
+   - Tách keyword thành từ đơn
+   - Tìm theo domain/topic trong frontmatter
+   - Tìm theo tags
+
+## Bước 3: Trả kết quả
+```
+📚 Wiki Query: "{keyword}"
+═══════════════════════════
+Tìm thấy {N} trang liên quan:
+
+1. {page_name} — {1 dòng mô tả}
+   Tags: {tags}
+   
+2. {page_name} — {1 dòng mô tả}
+   Tags: {tags}
+
+───────────────────────────
+## Context trích xuất:
+{Tổng hợp nội dung liên quan từ các trang — đây là phần QUAN TRỌNG NHẤT}
+
+## Nguồn:
+- {wiki_path}/processed/{page_1}.md
+- {wiki_path}/raw/notes/{page_2}.md
+```
+
+Nếu KHÔNG tìm thấy kết quả:
+```
+📚 Wiki Query: "{keyword}"
+═══════════════════════════
+Không tìm thấy trang nào liên quan.
+
+💡 Gợi ý:
+- Thử từ khóa khác (tiếng Việt/Anh)
+- Nạp thêm tri thức: /evnict-kit:wiki-scan-project
+- Wiki có thể trống — kiểm tra: ls {wiki_path}/raw/notes/
+```
+
+## Bước 4: Lưu synthesis (nếu phân tích sâu)
+Nếu query dẫn đến so sánh/phân tích giữa nhiều trang:
+1. Tổng hợp thành 1 synthesis document
+2. Lưu vào `{wiki_path}/wiki/syntheses/{keyword-slug}-{date}.md`
+3. Thông báo: "Đã lưu tổng hợp vào syntheses/"
+
+---
+
+## Lưu ý
+- Query KHÔNG sửa wiki — chỉ đọc
+- Context trích xuất PHẢI đủ chi tiết để Agent sử dụng được
+- Nếu trang wiki bị thiếu/cũ → gợi ý user chạy `/evnict-kit:wiki-archive-feature` hoặc `/evnict-kit:wiki-scan-project`
+- Workflow này được gọi TỰ ĐỘNG bởi các workflow khác (feature-large, feature-small, bug-fix) ở bước đầu tiên
+
+## Checklist hoàn thành
+- [ ] Wiki path xác định
+- [ ] Search hoàn tất
+- [ ] Context trích xuất đầy đủ
+- [ ] Kết quả trả về cho Agent/User
+- [ ] Synthesis lưu (nếu có phân tích sâu)

package/templates/workflows/claude/evnict-kit-wiki-scan-project.md

@@ -0,0 +1,270 @@
+# Wiki Scan Project
+**Command:** `/evnict-kit:wiki-scan-project $ARGUMENTS`
+
+$ARGUMENTS chứa mô tả từ user.
+
+## Khi nào dùng
+- Mới init evnict-kit cho dự án có sẵn code
+- Dự án chưa có wiki hoặc wiki trống
+- Muốn populate wiki ban đầu từ codebase
+
+## Input
+- Không cần input — tự detect project type
+
+---
+
+## Pre-checks
+
+### Check 1: Wiki accessible
+```bash
+ls -la {project_name}-wiki/
+```
+Nếu không tồn tại → DỪNG: *"Wiki chưa được liên kết. Chạy `evnict-kit init` hoặc tạo symlink thủ công."*
+
+### Check 2: Wiki đã setup
+```bash
+ls {project_name}-wiki/package.json
+```
+Nếu không tồn tại → DỪNG: *"Wiki chưa khởi tạo. Chạy `/evnict-kit:init-wiki` trước."*
+
+---
+
+## Bước 1: Detect project type
+Đang ở BE hay FE?
+- Có `pom.xml` hoặc `build.gradle` → **Backend**
+- Có `angular.json` → **Frontend (Angular)**
+- Có `package.json` + react dependency → **Frontend (React)**
+
+---
+
+## Bước 2: Scan code theo project type
+
+### Nếu BACKEND:
+1. **Đọc Controllers** → liệt kê tất cả API endpoints theo module
+   ```bash
+   find src/ -name "*Controller.java" -type f
+   ```
+   Với mỗi Controller: đọc file, trích `@RequestMapping`, `@GetMapping`, `@PostMapping`...
+
+2. **Đọc Services** → liệt kê business logic, validations
+   ```bash
+   find src/ -name "*Service.java" -o -name "*ServiceImpl.java" -type f
+   ```
+
+3. **Đọc Repositories/DAOs** → liệt kê database queries, tables sử dụng
+   ```bash
+   find src/ -name "*Repository.java" -o -name "*Dao.java" -o -name "*DAO.java" -type f
+   ```
+
+4. **Đọc DTOs/Entities** → liệt kê data models, fields
+   ```bash
+   find src/ -name "*DTO.java" -o -name "*Entity.java" -type f
+   ```
+
+5. **Đọc Configurations** → liệt kê external integrations
+   ```bash
+   find src/ -name "*Config.java" -o -name "application*.yml" -o -name "application*.properties" -type f
+   ```
+
+### Nếu FRONTEND (Angular):
+1. **Đọc Modules** → liệt kê feature modules
+   ```bash
+   find src/ -name "*.module.ts" -type f
+   ```
+
+2. **Đọc Components** → liệt kê pages, shared components
+   ```bash
+   find src/ -name "*.component.ts" -type f
+   ```
+
+3. **Đọc Services** → liệt kê API calls, state management
+   ```bash
+   find src/ -name "*.service.ts" -type f
+   ```
+
+4. **Đọc Routing** → liệt kê routes, menu structure
+   ```bash
+   find src/ -name "*routing*.ts" -o -name "*routes*.ts" -type f
+   ```
+
+5. **Đọc Models/Interfaces** → liệt kê TypeScript types
+   ```bash
+   find src/ -name "*.model.ts" -o -name "*.interface.ts" -type f
+   ```
+
+---
+
+## Bước 3: Nhóm theo module
+Phân tích kết quả scan → nhóm files theo module/chức năng.
+Mỗi module CÓ THỂ bao gồm: Controller + Service + Repository + DTO + Component + Page.
+
+---
+
+## Bước 4: Sinh wiki notes — MỖI MODULE 1 FILE
+
+Với mỗi module, tạo file:
+```markdown
+---
+title: "Module {module_name}"
+discovered: {YYYY-MM-DD}
+topic: "{project_name}"
+tags: [{module, project_type, tech_stack}]
+source: "evnict-kit-scan"
+type: module
+---
+
+# ═══ PHẦN NGHIỆP VỤ ═══
+
+## Mục đích chức năng
+{Chức năng này giải quyết vấn đề gì cho user? — 3-5 câu}
+{Agent ĐỌC code (controller methods, service logic) rồi SUY RA mục đích}
+
+## Đối tượng sử dụng
+{Ai dùng? Role nào? Quyền gì?}
+{Suy ra từ: auth annotations, data authorization logic, role checks}
+
+## Nghiệp vụ chính
+{Mô tả TỪNG thao tác user có thể làm — nhập, sửa, xóa, tìm, xuất...}
+{Suy ra từ: controller endpoints + service methods}
+
+### Nhập/Thêm mới
+- {Mô tả hành vi, fields cần nhập, ràng buộc}
+
+### Danh sách/Tìm kiếm
+- {Mô tả filters, phân trang, sort}
+
+### Sửa/Cập nhật
+- {Mô tả}
+
+### Xóa
+- {Mô tả, confirm logic}
+
+## Quy tắc nghiệp vụ
+| Mã | Quy tắc |
+|----|---------|
+| BR01 | {Suy ra từ validation logic trong service/controller} |
+| BR02 | {Suy ra từ unique constraints, foreign keys} |
+| BR03 | {Suy ra từ authorization checks} |
+
+## Liên kết chức năng
+{Module này liên quan đến module nào khác?}
+{Suy ra từ: foreign keys, service dependencies, shared DTOs}
+- **{Module A}**: {mô tả liên kết — VD: dropdown lấy từ danh mục đơn vị}
+- **{Module B}**: {mô tả liên kết}
+
+# ═══ PHẦN KỸ THUẬT ═══
+
+## API Endpoints
+| Method | Path | Mô tả |
+|--------|------|-------|
+| {method} | {path} | {description từ annotation/comment} |
+
+## Database Tables
+{Tables sử dụng trong Repository/DAO}
+
+## Services
+{List services + public methods}
+
+## Components (nếu FE)
+| Component | Route | Mô tả |
+|-----------|-------|-------|
+| {name} | {route} | {description} |
+
+## Files
+{List all files thuộc module}
+```
+
+### Hướng dẫn viết phần Nghiệp vụ
+
+Agent PHẢI đọc code rồi SUY RA nghiệp vụ, KHÔNG chỉ liệt kê code:
+
+| Đọc code | Suy ra nghiệp vụ |
+|----------|-------------------|
+| Controller có POST /save + validation | → "Nhập mới: cần điền fields X, Y, Z. Validate: X bắt buộc, Y <= today" |
+| Service check duplicate(dept+profile+date) | → "BR01: Không nhập trùng bộ key (Đơn vị + Profile + Ngày)" |
+| Repository query filter by departmentId | → "Danh sách: lọc theo đơn vị" |
+| Auth annotation @PreAuthorize | → "Phân quyền: chỉ role ADMIN được xóa" |
+| FK đến bảng LRS_DEPARTMENT | → "Liên kết: dropdown chọn đơn vị từ danh mục" |
+| Service gọi ExternalAPI (CMIS) | → "Tích hợp: upload file qua hệ thống CMIS" |
+
+Mục tiêu: người đọc wiki note HIỂU ĐƯỢC chức năng làm gì MÀ KHÔNG CẦN đọc code.
+Phần kỹ thuật bên dưới để Agent AI tra cứu khi cần implement.
+
+Thêm 2 file đặc biệt:
+- `{project_name}-architecture.md` — Kiến trúc tổng thể (tech stack, security, dual schema nếu có)
+- `{project_name}-api-catalog.md` — Catalog toàn bộ API endpoints (nếu BE)
+
+---
+
+## Bước 5: Handoff cho project còn lại
+Nếu feature cần cả BE+FE:
+
+**Sinh handoff request:**
+```
+┌─────────────────────────────────────────────────┐
+│  📋 Wiki Scan — Cần bổ sung từ {FE/BE}         │
+│                                                  │
+│  Tôi đã scan project {BE/FE} và sinh {N} notes. │
+│  Để wiki đầy đủ, cần scan thêm project {FE/BE}.│
+│                                                  │
+│  👉 Mở AI Agent trong project {FE/BE}, chạy:    │
+│     /evnict-kit:wiki-scan-project                │
+│                                                  │
+│  Agent sẽ đọc handoff và kết hợp tri thức.      │
+└─────────────────────────────────────────────────┘
+```
+
+Append vào `.evnict/handoff/handoff.md`:
+```markdown
+### [{YYYY-MM-DD}] {BE/FE}→{FE/BE}: Wiki Scan — Cần bổ sung
+- **Trạng thái:** 🔴 Chờ xử lý
+- **Mô tả:** Đã scan project {BE/FE} và sinh {N} wiki notes. Cần scan thêm project {FE/BE} để wiki đầy đủ.
+- **Đã scan:** {N} modules, {M} API endpoints, {K} components
+- **Wiki notes đã tạo:** {list files}
+- **Mong muốn:** Scan {FE/BE} project, kết hợp với notes {BE/FE} để tạo bức tranh toàn diện
+- **Kết quả xử lý:** _(Agent bên kia điền sau khi scan xong)_
+```
+
+---
+
+## Bước 6: Auto-ingest
+```bash
+cd {wiki_path} && node scripts/ingest.js
+```
+Nếu `scripts/ingest.js` không tồn tại → thử `npm run ingest`.
+Nếu vẫn fail → báo: *"Chạy `/evnict-kit:init-wiki`"*
+
+---
+
+## Bước 7: Status report
+```
+📚 Wiki Scan Report
+═══════════════════════
+  Scanned: {type} project ({N} files đọc)
+  Generated: {M} wiki notes
+  Modules: {list}
+  API Endpoints: {count} (nếu BE)
+  Components: {count} (nếu FE)
+  Ingest: ✅ completed
+  
+  ⚠️ Cần scan thêm {FE/BE} project — xem handoff request
+```
+
+---
+
+## Lưu ý
+- Scan KHÔNG xóa wiki notes cũ — chỉ thêm mới hoặc overwrite cùng tên
+- Nếu đã scan trước đó → agent hỏi: "Wiki đã có notes. Overwrite hay skip?"
+- Workflow này GỌI skill `evnict-kit-wiki` cho phần push + ingest
+- Mỗi module 1 file — KHÔNG gộp tất cả vào 1 file khổng lồ
+
+## Checklist hoàn thành
+- [ ] Project type detected
+- [ ] Code scanned theo type
+- [ ] Modules identified và grouped
+- [ ] Wiki notes sinh cho mỗi module
+- [ ] Architecture note sinh
+- [ ] API catalog sinh (nếu BE)
+- [ ] Handoff request ghi (nếu cần scan project còn lại)
+- [ ] Auto-ingest completed
+- [ ] Status report hiển thị