dw-kit 1.9.1 → 1.9.3

package/.dw/core/templates/vi/task-plan.md

@@ -1,93 +1,97 @@
-# Plan: [Task Name]
-
-## Ngày tạo: [date]
-## Trạng thái: Draft → cần approve
-## Approved by: —
-
----
-
-## Tóm Tắt Approach
-
-[1-2 đoạn: tại sao approach này được chọn, alternatives đã bị loại vì lý do gì]
-
----
-
-## Phương Án Đã Xem Xét
-
-| # | Approach | Ưu điểm | Nhược điểm | Assumptions | Chọn? |
-|---|----------|---------|------------|-------------|-------|
-| 1 | [Option A] | | | | **Chọn** |
-| 2 | [Option B] | | | | Loại — vì: |
-| 3 | [Option C] | | | | Loại — vì: |
-
-**Devil's Advocate**: Lý do mạnh nhất để KHÔNG chọn Option A:
-> [điền vào]
-
----
-
-## Subtasks
-
-### ST-1: [Tên subtask]
-- **Mô tả**: [actionable, cụ thể]
-- **Files thay đổi**: [`path/to/file.ts`]
-- **Acceptance Criteria**:
-  - Given [condition], When [action], Then [outcome]
-  - [ ] [Tiêu chí đo lường được]
-- **Dependencies**: none
-- **Estimate**: [giờ — nếu tracking bật]
-
-### ST-2: [Tên subtask]
-- **Mô tả**: ...
-- **Files thay đổi**: [...]
-- **Acceptance Criteria**:
-  - [ ] ...
-- **Dependencies**: ST-1
-
-<!-- Thêm subtasks theo nhu cầu. Tối đa ≤3 files, ≤4h per subtask -->
-
----
-
-## Dependency Graph
-
-```
-ST-1 → ST-2 → ST-3
-         ↓
-        ST-4
-```
-
----
-
-## Rủi Ro & Giả Định
-
-| # | Loại | Mô tả | Xác suất | Tác động | Giảm thiểu |
-|---|------|--------|----------|----------|------------|
-| 1 | Giả định | | Thấp/TB/Cao | Thấp/TB/Cao | Kiểm chứng bằng: |
-| 2 | Rủi ro kỹ thuật | | | | |
-| 3 | Rủi ro security | | | | |
-
----
-
-## Edge Cases
-
-- [ ] [Edge case — khi nào xảy ra, xử lý thế nào]
-- [ ] [Null/empty input]
-- [ ] [Concurrent operations]
-- [ ] [Rollback scenario]
-
----
-
-## Tác Động Hệ Thống
-
-- **Modules bị ảnh hưởng**: [danh sách]
-- **API changes**: [endpoints mới/sửa/xóa]
-- **DB changes**: [migration cần thiết?]
-- **Backward compatibility**: [Có / Không — nếu không: migration plan?]
-- **Breaking changes**: [nếu có, ai bị ảnh hưởng]
-
----
-
-## Góc Nhìn & Trade-offs
-
-| Quyết định | User | Developer | Security | Ops |
-|-----------|------|-----------|----------|-----|
-| [Quyết định 1] | | | | |
+<!-- ⚠️ 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]
+
+## Ngày tạo: [date]
+## Trạng thái: Draft → cần approve
+## Approved by: —
+
+---
+
+## Tóm Tắt Approach
+
+[1-2 đoạn: tại sao approach này được chọn, alternatives đã bị loại vì lý do gì]
+
+---
+
+## Phương Án Đã Xem Xét
+
+| # | Approach | Ưu điểm | Nhược điểm | Assumptions | Chọn? |
+|---|----------|---------|------------|-------------|-------|
+| 1 | [Option A] | | | | **Chọn** |
+| 2 | [Option B] | | | | Loại — vì: |
+| 3 | [Option C] | | | | Loại — vì: |
+
+**Devil's Advocate**: Lý do mạnh nhất để KHÔNG chọn Option A:
+> [điền vào]
+
+---
+
+## Subtasks
+
+### ST-1: [Tên subtask]
+- **Mô tả**: [actionable, cụ thể]
+- **Files thay đổi**: [`path/to/file.ts`]
+- **Acceptance Criteria**:
+  - Given [condition], When [action], Then [outcome]
+  - [ ] [Tiêu chí đo lường được]
+- **Dependencies**: none
+- **Estimate**: [giờ — nếu tracking bật]
+
+### ST-2: [Tên subtask]
+- **Mô tả**: ...
+- **Files thay đổi**: [...]
+- **Acceptance Criteria**:
+  - [ ] ...
+- **Dependencies**: ST-1
+
+<!-- Thêm subtasks theo nhu cầu. Tối đa ≤3 files, ≤4h per subtask -->
+
+---
+
+## Dependency Graph
+
+```
+ST-1 → ST-2 → ST-3
+         ↓
+        ST-4
+```
+
+---
+
+## Rủi Ro & Giả Định
+
+| # | Loại | Mô tả | Xác suất | Tác động | Giảm thiểu |
+|---|------|--------|----------|----------|------------|
+| 1 | Giả định | | Thấp/TB/Cao | Thấp/TB/Cao | Kiểm chứng bằng: |
+| 2 | Rủi ro kỹ thuật | | | | |
+| 3 | Rủi ro security | | | | |
+
+---
+
+## Edge Cases
+
+- [ ] [Edge case — khi nào xảy ra, xử lý thế nào]
+- [ ] [Null/empty input]
+- [ ] [Concurrent operations]
+- [ ] [Rollback scenario]
+
+---
+
+## Tác Động Hệ Thống
+
+- **Modules bị ảnh hưởng**: [danh sách]
+- **API changes**: [endpoints mới/sửa/xóa]
+- **DB changes**: [migration cần thiết?]
+- **Backward compatibility**: [Có / Không — nếu không: migration plan?]
+- **Breaking changes**: [nếu có, ai bị ảnh hưởng]
+
+---
+
+## Góc Nhìn & Trade-offs
+
+| Quyết định | User | Developer | Security | Ops |
+|-----------|------|-----------|----------|-----|
+| [Quyết định 1] | | | | |

package/.dw/core/templates/vi/task-progress.md

@@ -1,56 +1,60 @@
-# Progress: [Task Name]
-
-## Trạng thái: Not Started | In Progress | Blocked | Done
-## Branch: [branch-name]
-## Sprint: [sprint-id — nếu dùng sprint tracking]
-## Bắt đầu: [date]
-## Kết thúc: —
-
----
-
-## Subtask Progress
-
-| # | Subtask | Trạng thái | Commit | Ghi chú |
-|---|---------|-----------|--------|---------|
-| ST-1 | [tên] | Pending | | |
-| ST-2 | [tên] | Pending | | |
-
-**Trạng thái hợp lệ**: Pending → In Progress → Done | Blocked | Skipped
-
----
-
-## Changelog
-
-Ghi lại mọi thay đổi so với plan gốc.
-
-### [date] — [mô tả thay đổi]
-- **Lý do**: [tại sao thay đổi]
-- **Ảnh hưởng**: [subtasks nào bị ảnh hưởng]
-- **Quyết định bởi**: [human / agent / cả hai]
-
----
-
-## Phát Hiện Mới
-
-| # | Phát hiện | Ảnh hưởng | Hành động | Trạng thái |
-|---|-----------|-----------|-----------|-----------|
-| 1 | | | | Resolved / Open |
-
----
-
-## Blockers
-
-- [ ] [Blocker 1] — owner: [ai] — since: [date]
-
----
-
-## Handoff Notes
-
-*Điền trước khi kết thúc session.*
-
-### Session [date]
-- **Đang ở**: ST-[N] — [trạng thái cụ thể]
-- **Context quan trọng**: [decisions, gotchas không obvious từ code]
-- **Bước tiếp theo**: [việc cần làm ngay khi resume]
-- **Cẩn thận**: [warnings, pitfalls đã gặp]
-- **Git state**: `git status` output nếu có uncommitted changes
+<!-- ⚠️ 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]
+
+## Trạng thái: Not Started | In Progress | Blocked | Done
+## Branch: [branch-name]
+## Sprint: [sprint-id — nếu dùng sprint tracking]
+## Bắt đầu: [date]
+## Kết thúc: —
+
+---
+
+## Subtask Progress
+
+| # | Subtask | Trạng thái | Commit | Ghi chú |
+|---|---------|-----------|--------|---------|
+| ST-1 | [tên] | Pending | | |
+| ST-2 | [tên] | Pending | | |
+
+**Trạng thái hợp lệ**: Pending → In Progress → Done | Blocked | Skipped
+
+---
+
+## Changelog
+
+Ghi lại mọi thay đổi so với plan gốc.
+
+### [date] — [mô tả thay đổi]
+- **Lý do**: [tại sao thay đổi]
+- **Ảnh hưởng**: [subtasks nào bị ảnh hưởng]
+- **Quyết định bởi**: [human / agent / cả hai]
+
+---
+
+## Phát Hiện Mới
+
+| # | Phát hiện | Ảnh hưởng | Hành động | Trạng thái |
+|---|-----------|-----------|-----------|-----------|
+| 1 | | | | Resolved / Open |
+
+---
+
+## Blockers
+
+- [ ] [Blocker 1] — owner: [ai] — since: [date]
+
+---
+
+## Handoff Notes
+
+*Điền trước khi kết thúc session.*
+
+### Session [date]
+- **Đang ở**: ST-[N] — [trạng thái cụ thể]
+- **Context quan trọng**: [decisions, gotchas không obvious từ code]
+- **Bước tiếp theo**: [việc cần làm ngay khi resume]
+- **Cẩn thận**: [warnings, pitfalls đã gặp]
+- **Git state**: `git status` output nếu có uncommitted changes