dw-kit 1.0.0 → 1.0.2

package/.claude/hooks/post-write.sh

@@ -22,9 +22,7 @@ except:
 [ -z "$FILE_PATH" ] && exit 0
 
 # ── Đọc lint command từ config ────────────────────────────────────────────────
-CONFIG_FILE="${CLAUDE_PROJECT_DIR:-$PWD}/config/dw.config.yml"
-# Fallback sang old config nếu chưa migrate
-[ ! -f "$CONFIG_FILE" ] && CONFIG_FILE="${CLAUDE_PROJECT_DIR:-$PWD}/config/dw.config.yml"
+CONFIG_FILE="${CLAUDE_PROJECT_DIR:-$PWD}/.dw/config/dw.config.yml"
 [ ! -f "$CONFIG_FILE" ] && exit 0
 
 LINT_CMD=$(grep -m1 "lint_command:" "$CONFIG_FILE" 2>/dev/null \

package/.claude/rules/code-style.md

@@ -1,37 +1,37 @@
-# Code Style & Conventions
-
-## Nguyên tắc chung
-- Đặt tên biến/hàm rõ ràng, tự giải thích (self-documenting)
-- Ưu tiên đơn giản, dễ đọc hơn clever code
-- Mỗi function làm MỘT việc
-- Comments giải thích WHY, không phải WHAT
-- Xử lý errors ở đầu function (guard clauses / early return)
-
-## Naming Conventions
-- Variables/Functions: camelCase
-- Classes/Components: PascalCase
-- Constants: UPPER_SNAKE_CASE
-- Files: kebab-case hoặc theo convention của framework
-- Directories: kebab-case
-
-## File Organization
-- 1 component/class per file (trừ khi strongly related)
-- Group imports: external → internal → relative
-- Export ở cuối file hoặc inline (nhất quán trong project)
-
-## Error Handling
-- KHÔNG swallow errors (catch rỗng)
-- Log đủ context để debug (error message, input data, stack)
-- Dùng custom error types cho domain errors
-- Validate input ở boundary (API, form, external data)
-
-## Testing
-- Test file cùng tên với source: `foo.ts` → `foo.test.ts` hoặc `foo.spec.ts`
-- Mỗi test case kiểm tra MỘT behavior
-- Test name mô tả expected behavior: "should return error when input is empty"
-- Arrange → Act → Assert pattern
-- KHÔNG mock internal implementation details
-
-## NOTE
-Đây là quy tắc mặc định. Team tùy chỉnh theo stack cụ thể của dự án.
-Thêm framework-specific rules vào file này hoặc tạo file riêng trong `.claude/rules/`.
+# Code Style & Conventions
+
+## Nguyên tắc chung
+- Đặt tên biến/hàm rõ ràng, tự giải thích (self-documenting)
+- Ưu tiên đơn giản, dễ đọc hơn clever code
+- Mỗi function làm MỘT việc
+- Comments giải thích WHY, không phải WHAT
+- Xử lý errors ở đầu function (guard clauses / early return)
+
+## Naming Conventions
+- Variables/Functions: camelCase
+- Classes/Components: PascalCase
+- Constants: UPPER_SNAKE_CASE
+- Files: kebab-case hoặc theo convention của framework
+- Directories: kebab-case
+
+## File Organization
+- 1 component/class per file (trừ khi strongly related)
+- Group imports: external → internal → relative
+- Export ở cuối file hoặc inline (nhất quán trong project)
+
+## Error Handling
+- KHÔNG swallow errors (catch rỗng)
+- Log đủ context để debug (error message, input data, stack)
+- Dùng custom error types cho domain errors
+- Validate input ở boundary (API, form, external data)
+
+## Testing
+- Test file cùng tên với source: `foo.ts` → `foo.test.ts` hoặc `foo.spec.ts`
+- Mỗi test case kiểm tra MỘT behavior
+- Test name mô tả expected behavior: "should return error when input is empty"
+- Arrange → Act → Assert pattern
+- KHÔNG mock internal implementation details
+
+## NOTE
+Đây là quy tắc mặc định. Team tùy chỉnh theo stack cụ thể của dự án.
+Thêm framework-specific rules vào file này hoặc tạo file riêng trong `.claude/rules/`.

package/.claude/rules/commit-standards.md

@@ -1,37 +1,37 @@
-# Commit Standards
-
-## Format
-```
-<type>(<scope>): <mô tả tiếng Việt hoặc tiếng Anh>
-
-[Body - chi tiết thay đổi, lý do]
-[Blank line]
-[Footer - breaking changes, references]
-
-Co-Authored-By: Claude <noreply@anthropic.com>
-```
-
-## Types
-| Type | Khi nào dùng |
-|------|-------------|
-| `feat` | Tính năng mới |
-| `fix` | Sửa lỗi |
-| `refactor` | Tái cấu trúc, không thay đổi behavior |
-| `test` | Thêm/sửa tests |
-| `docs` | Tài liệu, comments |
-| `chore` | Build, config, dependencies |
-| `style` | Format, whitespace (không thay đổi logic) |
-| `perf` | Cải thiện performance |
-
-## Quy tắc
-- Mỗi commit = 1 subtask hoặc 1 đơn vị logic hoàn chỉnh
-- Mô tả ngắn <= 72 ký tự
-- Dùng thì hiện tại: "thêm", "sửa", "cập nhật" (không phải "đã thêm")
-- KHÔNG commit files chứa secrets (.env, credentials, tokens)
-- KHÔNG commit console.log/debugger còn sót
-
-## Branch Naming
-```
-<type>/<task-name>
-```
-Ví dụ: `feat/user-auth`, `fix/login-redirect`, `refactor/api-structure`
+# Commit Standards
+
+## Format
+```
+<type>(<scope>): <mô tả tiếng Việt hoặc tiếng Anh>
+
+[Body - chi tiết thay đổi, lý do]
+[Blank line]
+[Footer - breaking changes, references]
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+```
+
+## Types
+| Type | Khi nào dùng |
+|------|-------------|
+| `feat` | Tính năng mới |
+| `fix` | Sửa lỗi |
+| `refactor` | Tái cấu trúc, không thay đổi behavior |
+| `test` | Thêm/sửa tests |
+| `docs` | Tài liệu, comments |
+| `chore` | Build, config, dependencies |
+| `style` | Format, whitespace (không thay đổi logic) |
+| `perf` | Cải thiện performance |
+
+## Quy tắc
+- Mỗi commit = 1 subtask hoặc 1 đơn vị logic hoàn chỉnh
+- Mô tả ngắn <= 72 ký tự
+- Dùng thì hiện tại: "thêm", "sửa", "cập nhật" (không phải "đã thêm")
+- KHÔNG commit files chứa secrets (.env, credentials, tokens)
+- KHÔNG commit console.log/debugger còn sót
+
+## Branch Naming
+```
+<type>/<task-name>
+```
+Ví dụ: `feat/user-auth`, `fix/login-redirect`, `refactor/api-structure`

package/.claude/settings.json

@@ -52,7 +52,7 @@
         "hooks": [
           {
             "type": "prompt",
-            "prompt": "Trước khi kết thúc, kiểm tra: (1) Có uncommitted changes quan trọng không? (2) Task đang làm dở chưa cập nhật progress? (3) Có blocker nào chưa ghi lại? Nếu có vấn đề, trả về {\"decision\": \"block\", \"reason\": \"[mô tả]\"}. Nếu OK, trả về {\"decision\": \"allow\"}."
+            "prompt": "Session context: $ARGUMENTS\n\nIf stop_hook_active is true in the context above, reply ONLY: {\"decision\":\"allow\"} to prevent infinite loops.\n\nOtherwise check: any uncommitted important changes? any in-progress task with outdated progress file? any unrecorded blockers?\n\nReply with ONLY valid JSON, no other text:\n- {\"decision\":\"block\",\"reason\":\"<describe what needs attention>\"} if action needed\n- {\"decision\":\"allow\"} if all clear"
           }
         ]
       }

package/.claude/settings.local.json

@@ -6,7 +6,8 @@
       "WebFetch(domain:docs.anthropic.com)",
       "Bash(grep -rL \"^name:\" .claude/skills/dw-*/SKILL.md)",
       "Bash(grep -c '\\\\$ARGUMENTS\\\\|context: fork\\\\|allowed-tools' .dw/adapters/generic/AGENT.md)",
-      "Bash(grep [v1.0.0] CHANGELOG.md)"
+      "Bash(grep [v1.0.0] CHANGELOG.md)",
+      "Bash(node src/smoke-test.mjs)"
     ]
   }
 }

package/.claude/skills/dw-prompt/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: dw-prompt
+description: "Improve a vague task description into a clear, actionable prompt. Uses git log + recent dw tasks for project context. Output is concise — human dev will refine further."
+argument-hint: "[task description] [--vi]"
+---
+
+# Prompt Builder
+
+Input: **$ARGUMENTS**
+
+## Bước 0 — Parse options
+
+- Nếu `$ARGUMENTS` chứa `--vi`: output bằng **tiếng Việt**, bỏ flag `--vi` ra khỏi description
+- Mặc định: output bằng **tiếng Anh**
+
+## Bước 1 — Lấy context từ git log
+
+Extract 1–2 keywords chính từ description (bỏ qua stop words: fix, add, feat, the, a, in, of).
+
+Chạy **cả hai** để có context tốt nhất:
+
+```bash
+# Tìm commits liên quan theo keyword
+git log --oneline --no-merges --all --grep="<keyword1>" -15
+git log --oneline --no-merges --all --grep="<keyword2>" -15
+
+# Fallback: 30 commits gần nhất
+git log --oneline --no-merges -30
+```
+
+Dùng kết quả để nhận ra: module names, naming conventions, commit style của project.
+
+## Bước 2 — Lấy context từ dw tasks gần đây
+
+Đọc danh sách task đang/đã làm:
+
+```bash
+ls .dw/tasks/
+```
+
+Nếu có task liên quan đến keyword → đọc file `*-progress.md` để hiểu thêm context (scope, decisions, findings).
+
+## Bước 3 — Improve prompt
+
+**Nếu $ARGUMENTS rỗng (sau khi bỏ flags):** hỏi ngắn "Describe your task:" trước.
+
+**Rules:**
+- **1–2 dòng tối đa** — human dev sẽ tự sửa thêm
+- Giữ: **what** + **scope** (nếu rõ từ context) + **outcome** (nếu rõ)
+- Active voice, present tense: "Fix...", "Add...", "Refactor..."
+- Không bullet points, không markdown headers trong output
+- Match naming conventions từ git log nếu nhận ra được
+
+## Output format
+
+```
+─── Improved prompt ──────────────────────
+<1–2 line improved prompt>
+──────────────────────────────────────────
+```
+
+Không thêm gì khác ngoài block trên.

package/.claude/skills/dw-upgrade/SKILL.md

@@ -6,52 +6,42 @@ argument-hint: ""
 
 # Upgrade dv-workflow-kit
 
-## Điều Kiện Tiên Quyết
+## Điều Kiện tiên quyết
 
-Skill này yêu cầu toolkit được cài qua git submodule tại `.dw-module/`.
+Toolkit được cài theo luồng chuẩn v1 trong project hiện tại (thường là `npm install -g dw-kit` + `dw init`).
+Các tùy chỉnh của team được đặt tại:
+- overrides: `.dw/adapters/claude-cli/overrides/`
+- extensions (skills mới): `.dw/adapters/claude-cli/extensions/`
 
-## Bước 1: Kiểm tra setup
+## Bước 1: Preview upgrade (khuyến nghị)
 
-Kiểm tra `.dw-module/` có tồn tại và là git repo:
 ```bash
-ls .dw-module/.git
+dw upgrade --check
+dw upgrade --dry-run
 ```
 
-Nếu không có → thông báo: "Toolkit chưa được cài dạng git submodule. Xem `examples/integration-guide/README.md`."
-
-## Bước 2: Pull version mới nhất
+## Bước 2: Backup config (tùy chọn nhưng nên làm)
 
-```bash
-cd .dv-workflow && git fetch origin && git log origin/main --oneline -5
-```
-
-Hiển thị 5 commits mới nhất của upstream để user biết có gì thay đổi.
-
-## Bước 3: Backup config
-
-Trước khi update, backup config hiện tại:
 ```bash
 cp .dw/config/dw.config.yml .dw/config/dw.config.yml.backup-$(date +%Y%m%d)
 ```
 
-Thông báo: "Config đã backup tại `.dw/config/dw.config.yml.backup-[date]`"
-
-## Bước 4: Update submodule
+## Bước 3: Chạy upgrade
 
 ```bash
-cd .dv-workflow && git pull origin main
+dw upgrade
 ```
 
-## Bước 5: So sánh và update files
+`dw upgrade` sẽ update toolkit files theo version mới và **tôn trọng overrides** của team (không ghi đè override).
+
+## Bước 4: Validate & health check
 
-Chạy setup script với mode update (không overwrite):
 ```bash
-bash .dw-module/examples/integration-guide/setup.sh
+dw validate
+dw doctor
 ```
 
-Script dùng `cp -n` (no-clobber) — chỉ copy files MỚI, không overwrite files đã customize.
-
-## Bước 6: Báo cáo kết quả
+## Bước 5: Báo cáo kết quả
 
 ```
 === Upgrade Report ===
@@ -64,7 +54,7 @@ Files mới (đã copy):
   + .claude/templates/en/task-context.md
 
 Files đã thay đổi trong toolkit (KHÔNG tự động update vì bạn có thể đã customize):
-  ~ .claude/skills/dw-task-init/SKILL.md   — xem diff: git diff .dw-module/.claude/skills/dw-task-init/SKILL.md
+  ~ .claude/skills/dw-task-init/SKILL.md   — xem diff: git diff .claude/skills/dw-task-init/SKILL.md
   ~ .claude/agents/planner.md
 
 Files của bạn (giữ nguyên):
@@ -72,11 +62,11 @@ Files của bạn (giữ nguyên):
 
 Lưu ý:
   - Review các files "đã thay đổi" và merge thủ công nếu cần
-  - Xem CHANGELOG tại .dw-module/CHANGELOG.md để biết breaking changes
+  - Xem CHANGELOG của release (nếu cần) để biết breaking changes
   - Chạy /dw-config-validate sau khi upgrade để kiểm tra config
 ```
 
-## Bước 7: Cleanup backup (tùy chọn)
+## Cleanup backup (tùy chọn)
 
 Hỏi user: "Bạn có muốn xóa file backup config không? (y/n)"
 Nếu y: `rm .dw/config/dw.config.yml.backup-*`

package/.dw/adapters/claude-cli/extensions/README.md

@@ -1,4 +1,4 @@
-# .dw/adapters/claude-cli/extensions/
+# .dw/adapters/claude-cli/extensions/
 
 > **NET-NEW TEAM SKILLS — Không conflict với generated, không bị overwrite.**
 
@@ -15,7 +15,7 @@ extensions/
     └── README.md       ← optional: mô tả skill
 ```
 
-`setup.sh` copy tất cả skills trong thư mục này vào `.claude/skills/`.
+`dw upgrade` copy tất cả skills trong thư mục này vào `.claude/skills/` (extensions không ghi đè skills đã customize).
 
 ## Ví dụ Skills Phù Hợp
 

package/.dw/adapters/claude-cli/generated/README.md

@@ -1,7 +1,7 @@
-# .dw/adapters/claude-cli/generated/
+# .dw/adapters/claude-cli/generated/
 
 > **AUTO-GENERATED — Không edit tay.**
-> Thư mục này được overwrite khi chạy `scripts/upgrade.sh` hoặc `setup.sh`.
+> Thư mục này được overwrite khi nâng cấp toolkit trong quá trình build/generation nội bộ.
 
 ## Nội dung
 
@@ -16,7 +16,7 @@ generated/
 
 ## Cách hoạt động
 
-`setup.sh` → copy `generated/` → `.claude/`, với overrides từ `overrides/` thắng.
+`dw init`/`dw upgrade` → populate `.claude/`, áp dụng overrides từ `overrides/` (override thắng).
 
 ## Nếu muốn customize
 

package/.dw/adapters/claude-cli/overrides/README.md

@@ -1,4 +1,4 @@
-# .dw/adapters/claude-cli/overrides/
+# .dw/adapters/claude-cli/overrides/
 
 > **TEAM CUSTOMIZATIONS — KHÔNG BAO GIỜ bị overwrite khi upgrade.**
 
@@ -19,11 +19,13 @@ overrides/
     └── reviewer.md       ← override generated/agents/reviewer.md
 ```
 
-Khi upgrade, `scripts/upgrade.sh` sẽ:
+Khi chạy `dw upgrade`, luồng sẽ:
 1. Update `generated/` từ toolkit mới
 2. Apply overrides từ thư mục này (overrides thắng generated)
 3. Copy kết quả vào `.claude/`
 
+Trong v1, luồng chuẩn là `dw upgrade`: nó tôn trọng overrides khi cập nhật `.claude/`.
+
 ## Khi nào nên override?
 
 - Team có domain-specific review rules

package/CLAUDE.md

@@ -42,6 +42,7 @@ Không chắc scope → dùng `standard`. Assess dựa trên facts (file count,
 
 | Skill | Mô tả | Depth |
 |-------|--------|-------|
+| `/dw-prompt [desc]` | Build structured prompt (autocomplete + wizard) | all |
 | `/dw-task-init [name]` | Khởi tạo task docs | all |
 | `/dw-research [name]` | Khảo sát codebase | all |
 | `/dw-plan [name]` | Lập kế hoạch (DỪNG chờ approve) | standard+ |