dw-kit 1.9.0 → 1.9.2

package/.claude/templates/en/task-plan.md

@@ -1,79 +1,83 @@
-# Plan: [Task Name]
-
-## Created: [date]
-## Status: Draft | Approved | In Progress | Done
-## Approved by: [name / role]
-
----
-
-## Solution Summary
-
-[1-2 paragraphs describing the goal and chosen approach]
-
-## Options Considered
-
-| # | Option | Pros | Cons | Selected? |
-|---|--------|------|------|-----------|
-| 1 | [Approach A] | | | **Selected** |
-| 2 | [Approach B] | | | Rejected — reason: |
-
-## Subtasks
-
-### ST-1: [Subtask name]
-- **Description**: [Specific, actionable]
-- **Files**: [List of files to change]
-- **Acceptance Criteria**:
-  - [ ] [Condition 1]
-  - [ ] [Condition 2]
-- **Dependencies**: none
-- **Estimate**: [effort — if estimation enabled]
-
-### ST-2: [Subtask name]
-- **Description**: ...
-- **Files**: ...
-- **Acceptance Criteria**:
-  - [ ] ...
-- **Dependencies**: ST-1
-- **Estimate**: ...
-
-<!-- Add more subtasks as needed -->
-
-## Risks & Assumptions
-
-| # | Type | Description | Probability | Impact | Mitigation |
-|---|------|-------------|-------------|--------|------------|
-| 1 | Assumption | | | | Verify by: |
-| 2 | Risk | | High/Med/Low | High/Med/Low | |
-
-## Edge Cases
-
-- [ ] [Edge case 1 — when it occurs, how to handle]
-- [ ] [Edge case 2]
-
-## System Impact
-
-- **Affected modules**: [list]
-- **API changes**: [new/modified/removed endpoints]
-- **Database changes**: [migrations needed]
-- **Backward compatibility**: [Yes/No — details]
-- **Breaking changes**: [if any]
-
-## Perspectives & Trade-offs
-
-| Decision | User impact | Developer impact | Security | Ops/Deploy |
-|----------|-------------|------------------|----------|------------|
-| [Decision 1] | | | | |
-
-<!-- Section below only shown when flags.estimation = true -->
-
-## Estimation Summary
-
-| Phase | Estimate | Notes |
-|-------|----------|-------|
-| Research | [done] | |
-| Planning | [done] | |
-| Coding | | |
-| Testing | | |
-| Review | | |
-| Documentation | | |
-| **Total** | **[sum]** | |
+<!-- ⚠️ LEGACY TEMPLATE — do not use for new tasks. -->
+<!-- Canonical task doc lineage = v3 (.dw/core/templates/v3/task.md), per ADR-0008 / ADR-0020. -->
+<!-- Kept only as reference for `dw task migrate` + reading legacy task docs. -->
+
+# Plan: [Task Name]
+
+## Created: [date]
+## Status: Draft | Approved | In Progress | Done
+## Approved by: [name / role]
+
+---
+
+## Solution Summary
+
+[1-2 paragraphs describing the goal and chosen approach]
+
+## Options Considered
+
+| # | Option | Pros | Cons | Selected? |
+|---|--------|------|------|-----------|
+| 1 | [Approach A] | | | **Selected** |
+| 2 | [Approach B] | | | Rejected — reason: |
+
+## Subtasks
+
+### ST-1: [Subtask name]
+- **Description**: [Specific, actionable]
+- **Files**: [List of files to change]
+- **Acceptance Criteria**:
+  - [ ] [Condition 1]
+  - [ ] [Condition 2]
+- **Dependencies**: none
+- **Estimate**: [effort — if estimation enabled]
+
+### ST-2: [Subtask name]
+- **Description**: ...
+- **Files**: ...
+- **Acceptance Criteria**:
+  - [ ] ...
+- **Dependencies**: ST-1
+- **Estimate**: ...
+
+<!-- Add more subtasks as needed -->
+
+## Risks & Assumptions
+
+| # | Type | Description | Probability | Impact | Mitigation |
+|---|------|-------------|-------------|--------|------------|
+| 1 | Assumption | | | | Verify by: |
+| 2 | Risk | | High/Med/Low | High/Med/Low | |
+
+## Edge Cases
+
+- [ ] [Edge case 1 — when it occurs, how to handle]
+- [ ] [Edge case 2]
+
+## System Impact
+
+- **Affected modules**: [list]
+- **API changes**: [new/modified/removed endpoints]
+- **Database changes**: [migrations needed]
+- **Backward compatibility**: [Yes/No — details]
+- **Breaking changes**: [if any]
+
+## Perspectives & Trade-offs
+
+| Decision | User impact | Developer impact | Security | Ops/Deploy |
+|----------|-------------|------------------|----------|------------|
+| [Decision 1] | | | | |
+
+<!-- Section below only shown when flags.estimation = true -->
+
+## Estimation Summary
+
+| Phase | Estimate | Notes |
+|-------|----------|-------|
+| Research | [done] | |
+| Planning | [done] | |
+| Coding | | |
+| Testing | | |
+| Review | | |
+| Documentation | | |
+| **Total** | **[sum]** | |

package/.claude/templates/en/task-progress.md

@@ -1,65 +1,69 @@
-# Progress: [Task Name]
-
-## Status: Not Started | In Progress | Blocked | Done
-## Branch: [branch-name]
-## Started: [date]
-## Completed: [date — when done]
-
----
-
-## Subtask Progress
-
-| # | Subtask | Status | Commit | Owner | Notes |
-|---|---------|--------|--------|-------|-------|
-| ST-1 | | Pending | | | |
-| ST-2 | | Pending | | | |
-
-**Status values**: Pending → In Progress → Done | Blocked | Skipped
-
-## Changelog
-
-Record all deviations from the original plan.
-
-### [date] — [description of change]
-- **Reason**: [why the change was made]
-- **Impact**: [which subtasks are affected]
-- **Decision by**: [human / agent / both]
-
-## New Findings
-
-Record when assumptions are wrong, new risks appear, or scope changes.
-
-| # | Finding | Impact | Action | Status |
-|---|---------|--------|--------|--------|
-| 1 | | | | Resolved / Open |
-
-## Blockers
-
-- [ ] [Blocker 1] — owner: [who is responsible] — since: [date]
-
-<!-- Section below only shown when flags.log_work = true -->
-
-## Effort Log
-
-| Date | Subtask | Work type | Estimate | Actual | Notes |
-|------|---------|-----------|----------|--------|-------|
-| | | coding/testing/review | | | |
-
-### Effort Summary
-
-| Metric | Value |
-|--------|-------|
-| Total Estimate | |
-| Total Actual | |
-| Variance | |
-| Accuracy | % |
-
-## Handoff Notes
-
-Record at end of session so next person/agent can continue without asking.
-
-### Session [date]
-- **Currently at**: ST-[N] — [describe current state]
-- **Important context**: [decisions, gotchas]
-- **Next steps**: [what to do immediately]
-- **Watch out for**: [warnings, edge cases encountered]
+<!-- ⚠️ LEGACY TEMPLATE — do not use for new tasks. -->
+<!-- Canonical task doc lineage = v3 (.dw/core/templates/v3/task.md), per ADR-0008 / ADR-0020. -->
+<!-- Kept only as reference for `dw task migrate` + reading legacy task docs. -->
+
+# Progress: [Task Name]
+
+## Status: Not Started | In Progress | Blocked | Done
+## Branch: [branch-name]
+## Started: [date]
+## Completed: [date — when done]
+
+---
+
+## Subtask Progress
+
+| # | Subtask | Status | Commit | Owner | Notes |
+|---|---------|--------|--------|-------|-------|
+| ST-1 | | Pending | | | |
+| ST-2 | | Pending | | | |
+
+**Status values**: Pending → In Progress → Done | Blocked | Skipped
+
+## Changelog
+
+Record all deviations from the original plan.
+
+### [date] — [description of change]
+- **Reason**: [why the change was made]
+- **Impact**: [which subtasks are affected]
+- **Decision by**: [human / agent / both]
+
+## New Findings
+
+Record when assumptions are wrong, new risks appear, or scope changes.
+
+| # | Finding | Impact | Action | Status |
+|---|---------|--------|--------|--------|
+| 1 | | | | Resolved / Open |
+
+## Blockers
+
+- [ ] [Blocker 1] — owner: [who is responsible] — since: [date]
+
+<!-- Section below only shown when flags.log_work = true -->
+
+## Effort Log
+
+| Date | Subtask | Work type | Estimate | Actual | Notes |
+|------|---------|-----------|----------|--------|-------|
+| | | coding/testing/review | | | |
+
+### Effort Summary
+
+| Metric | Value |
+|--------|-------|
+| Total Estimate | |
+| Total Actual | |
+| Variance | |
+| Accuracy | % |
+
+## Handoff Notes
+
+Record at end of session so next person/agent can continue without asking.
+
+### Session [date]
+- **Currently at**: ST-[N] — [describe current state]
+- **Important context**: [decisions, gotchas]
+- **Next steps**: [what to do immediately]
+- **Watch out for**: [warnings, edge cases encountered]

package/.claude/templates/pr-template.md

@@ -1,56 +1,56 @@
-## Tóm Tắt
-
-[Mô tả ngắn: thay đổi gì, tại sao]
-
-## Loại Thay Đổi
-
-- [ ] Feature mới (feat)
-- [ ] Bug fix (fix)
-- [ ] Refactoring (refactor)
-- [ ] Tests (test)
-- [ ] Documentation (docs)
-- [ ] Performance (perf)
-- [ ] Chore/Config (chore)
-
-## Thay Đổi Chi Tiết
-
-- [Thay đổi 1]: [mô tả]
-- [Thay đổi 2]: [mô tả]
-
-## Task Documentation
-
-- Plan: `.dw/tasks/[task-name]/[task-name]-plan.md`
-- Context: `.dw/tasks/[task-name]/[task-name]-context.md`
-- Progress: `.dw/tasks/[task-name]/[task-name]-progress.md`
-
-## Testing
-
-- [ ] Unit tests pass
-- [ ] Integration tests pass (nếu applicable)
-- [ ] Manual testing done
-- [ ] Edge cases đã test: [liệt kê]
-
-## Checklist
-
-- [ ] Code tuân thủ conventions (`.claude/rules/code-style.md`)
-- [ ] Commit messages đúng format
-- [ ] Không có sensitive data (secrets, tokens, .env)
-- [ ] Không có debug code (console.log, debugger)
-- [ ] Documentation cập nhật (nếu applicable)
-- [ ] Breaking changes đã documented (nếu có)
-- [ ] Backward compatible (hoặc migration plan có sẵn)
-
-## Screenshots / Demo
-
-[Nếu UI changes — đính kèm screenshots]
-
-## Estimate vs Actual
-
-| Metric | Giá trị |
-|--------|---------|
-| Estimated | [hours/points] |
-| Actual | [hours/points] |
-| Notes | |
-
----
-> PR này được tạo với sự hỗ trợ của AI Agent (dv-workflow-kit)
+## Tóm Tắt
+
+[Mô tả ngắn: thay đổi gì, tại sao]
+
+## Loại Thay Đổi
+
+- [ ] Feature mới (feat)
+- [ ] Bug fix (fix)
+- [ ] Refactoring (refactor)
+- [ ] Tests (test)
+- [ ] Documentation (docs)
+- [ ] Performance (perf)
+- [ ] Chore/Config (chore)
+
+## Thay Đổi Chi Tiết
+
+- [Thay đổi 1]: [mô tả]
+- [Thay đổi 2]: [mô tả]
+
+## Task Documentation
+
+- Plan: `.dw/tasks/[task-name]/[task-name]-plan.md`
+- Context: `.dw/tasks/[task-name]/[task-name]-context.md`
+- Progress: `.dw/tasks/[task-name]/[task-name]-progress.md`
+
+## Testing
+
+- [ ] Unit tests pass
+- [ ] Integration tests pass (nếu applicable)
+- [ ] Manual testing done
+- [ ] Edge cases đã test: [liệt kê]
+
+## Checklist
+
+- [ ] Code tuân thủ conventions (`.claude/rules/code-style.md`)
+- [ ] Commit messages đúng format
+- [ ] Không có sensitive data (secrets, tokens, .env)
+- [ ] Không có debug code (console.log, debugger)
+- [ ] Documentation cập nhật (nếu applicable)
+- [ ] Breaking changes đã documented (nếu có)
+- [ ] Backward compatible (hoặc migration plan có sẵn)
+
+## Screenshots / Demo
+
+[Nếu UI changes — đính kèm screenshots]
+
+## Estimate vs Actual
+
+| Metric | Giá trị |
+|--------|---------|
+| Estimated | [hours/points] |
+| Actual | [hours/points] |
+| Notes | |
+
+---
+> PR này được tạo với sự hỗ trợ của AI Agent (dv-workflow-kit)

package/.claude/templates/task-context.md

@@ -1,73 +1,77 @@
-# Context: [Task Name]
-
-## Ngày khảo sát: [date]
-## Người thực hiện: [dev / agent]
-
----
-
-## Yêu Cầu Gốc
-
-> [Copy/paste yêu cầu từ user, ticket, hoặc BA requirements doc]
-
-## Codebase Analysis
-
-### Files Liên Quan
-
-| # | File | Vai trò | Cần thay đổi? | Ghi chú |
-|---|------|---------|----------------|---------|
-| 1 | | | | |
-
-### Kiến Trúc Hiện Tại
-
-```
-[Mô tả luồng hiện tại, có thể dùng ASCII diagram]
-
-Input → [Module A] → [Module B] → Output
-                ↓
-          [Database]
-```
-
-### Data Flow
-
-- **Input**: [Dữ liệu đầu vào từ đâu, format gì]
-- **Processing**: [Logic xử lý chính]
-- **Output**: [Kết quả đi đâu, format gì]
-- **Storage**: [Lưu ở đâu, schema gì]
-
-## Dependencies
-
-### Upstream (task phụ thuộc vào)
-- [ ] [Module/API/Service] — [vai trò]
-
-### Downstream (bị ảnh hưởng bởi task)
-- [ ] [Module/API/Service] — [ảnh hưởng thế nào]
-
-## Patterns & Conventions Phát Hiện
-
-| Pattern | Mô tả | Ví dụ (file:line) |
-|---------|--------|--------------------|
-| | | |
-
-## Test Coverage Hiện Tại
-
-- [ ] Có tests cho khu vực liên quan? [Có/Không]
-- Test files: [danh sách]
-- Coverage: [% hoặc mô tả]
-- Gaps: [thiếu test ở đâu]
-
-## Giả Định
-
-| # | Giả định | Cần kiểm chứng? | Nếu sai thì sao? |
-|---|----------|------------------|-------------------|
-| 1 | | Có / Không | |
-
-## Hạn Chế Đã Biết
-- [Hạn chế 1]
-
-## Chưa Rõ / Cần Làm Rõ
-- [ ] [Câu hỏi 1] — cần hỏi ai?
-- [ ] [Câu hỏi 2]
-
-## Ghi Chú Bổ Sung
-
-[Bất kỳ thông tin quan trọng khác: gotchas, tech debt, lịch sử thay đổi gần đây]
+<!-- ⚠️ LEGACY TEMPLATE — do not use for new tasks. -->
+<!-- Canonical task doc lineage = v3 (.dw/core/templates/v3/task.md), per ADR-0008 / ADR-0020. -->
+<!-- Kept only as reference for `dw task migrate` + reading legacy task docs. -->
+
+# Context: [Task Name]
+
+## Ngày khảo sát: [date]
+## Người thực hiện: [dev / agent]
+
+---
+
+## Yêu Cầu Gốc
+
+> [Copy/paste yêu cầu từ user, ticket, hoặc BA requirements doc]
+
+## Codebase Analysis
+
+### Files Liên Quan
+
+| # | File | Vai trò | Cần thay đổi? | Ghi chú |
+|---|------|---------|----------------|---------|
+| 1 | | | | |
+
+### Kiến Trúc Hiện Tại
+
+```
+[Mô tả luồng hiện tại, có thể dùng ASCII diagram]
+
+Input → [Module A] → [Module B] → Output
+                ↓
+          [Database]
+```
+
+### Data Flow
+
+- **Input**: [Dữ liệu đầu vào từ đâu, format gì]
+- **Processing**: [Logic xử lý chính]
+- **Output**: [Kết quả đi đâu, format gì]
+- **Storage**: [Lưu ở đâu, schema gì]
+
+## Dependencies
+
+### Upstream (task phụ thuộc vào)
+- [ ] [Module/API/Service] — [vai trò]
+
+### Downstream (bị ảnh hưởng bởi task)
+- [ ] [Module/API/Service] — [ảnh hưởng thế nào]
+
+## Patterns & Conventions Phát Hiện
+
+| Pattern | Mô tả | Ví dụ (file:line) |
+|---------|--------|--------------------|
+| | | |
+
+## Test Coverage Hiện Tại
+
+- [ ] Có tests cho khu vực liên quan? [Có/Không]
+- Test files: [danh sách]
+- Coverage: [% hoặc mô tả]
+- Gaps: [thiếu test ở đâu]
+
+## Giả Định
+
+| # | Giả định | Cần kiểm chứng? | Nếu sai thì sao? |
+|---|----------|------------------|-------------------|
+| 1 | | Có / Không | |
+
+## Hạn Chế Đã Biết
+- [Hạn chế 1]
+
+## Chưa Rõ / Cần Làm Rõ
+- [ ] [Câu hỏi 1] — cần hỏi ai?
+- [ ] [Câu hỏi 2]
+
+## Ghi Chú Bổ Sung
+
+[Bất kỳ thông tin quan trọng khác: gotchas, tech debt, lịch sử thay đổi gần đây]