dw-kit 1.2.0 → 1.3.0

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/rules/dw.md

@@ -0,0 +1,136 @@
+# dw Workflow (consolidated)
+
+Config: `.dw/config/dw.config.yml`
+Full methodology: `.dw/core/` (WORKFLOW · THINKING · QUALITY · ROLES · PILLARS)
+
+---
+
+## Override
+
+Prompt contains `--no-dw` → ignore all dw instructions for that request, work as plain Claude Code.
+
+---
+
+## 5-Pillar Architecture (v2.0)
+
+| Pillar | Role | Owners | Examples |
+|--------|------|--------|----------|
+| **Guards** | Block unsafe actions | privacy-block, pre-commit-gate | Non-negotiable safety |
+| **Surfaces** | Make state visible | ACTIVE.md, project-map, modules | Shared team context |
+| **Records** | Capture decisions | ADRs in `.dw/decisions/` | Organizational memory |
+| **Bridges** | Connect across sessions | auto-handoff, tracking.md | Continuity over time |
+| **Tunes** | Behavioral knobs | roles, depth, presets | Team/solo customization |
+
+---
+
+## Depth Routing
+
+Assess per task — file count, API changes, git blame:
+
+| Scope | Depth | Approach |
+|-------|-------|----------|
+| ≤2 files, hotfix | quick | Understand → Execute → Close |
+| 3–5 files, new module | standard | spec.md + tracking.md |
+| 6+ files, API/DB/security | thorough | Full 2-file + optional reports/ |
+
+Default when unsure: `standard`.
+
+---
+
+## Session Start
+
+1. Read `.dw/tasks/ACTIVE.md` — single source of truth for team state
+2. Resume any task with status `In Progress` from its `tracking.md`
+3. Check `.dw/decisions/` for recent ADRs if task touches architecture
+
+---
+
+## Task Docs (v2 default — 2 files)
+
+```
+.dw/tasks/{task-name}/
+├── spec.md      # Intent + plan (stable after approve)
+└── tracking.md  # Progress + handoff (mutable)
+```
+
+Legacy 3-file (`context + plan + progress`) still supported for older tasks.
+
+Templates at `.dw/core/templates/v2/`.
+
+---
+
+## Skills — Namespace `/dw:*`
+
+All dw skills invoke via `/dw:{name}` (colon namespace separator).
+
+Core workflow: `/dw:flow` · `/dw:task-init` · `/dw:research` · `/dw:plan` · `/dw:execute` · `/dw:commit` · `/dw:handoff`
+
+Decisions: `/dw:decision [title]` — create ADR
+
+Dev: `/dw:debug` · `/dw:review` · `/dw:thinking` · `/dw:prompt` · `/dw:docs-update`
+
+Role-specific: `/dw:requirements` · `/dw:test-plan` · `/dw:arch-review` · `/dw:dashboard` · `/dw:sprint-review`
+
+Setup: `/dw:onboard` · `/dw:retroactive` · `/dw:config-init` · `/dw:upgrade` · `/dw:rollback` · `/dw:archive`
+
+See `.dw/core/skills-index.md` for complete list with descriptions.
+
+---
+
+## Commit Format
+
+```
+<type>(<scope>): <description ≤72 chars>
+```
+
+Types: `feat` `fix` `refactor` `test` `docs` `chore` `style` `perf`
+
+---
+
+## Hooks
+
+| Hook | Purpose |
+|------|---------|
+| `privacy-block` | Guard — block .env/credentials/keys |
+| `pre-commit-gate` | Guard — quality check + sensitive scan |
+| `stop-check` | Bridge — auto-handoff to tracking.md + uncommitted warning |
+| `telemetry-log` | Meta — local event log for v1.4 cut decisions |
+
+Legacy (deprecated, removal in v2.0 based on telemetry): scout-block, post-write, progress-ping, session-init, safety-guard.
+
+---
+
+## Decisions Layer
+
+ADRs at `.dw/decisions/{NNNN}-{title}.md`. Create with `/dw:decision`.
+
+Status values: `Proposed | Accepted | Deprecated | Superseded by ADR-{NNNN}`
+
+When to write: architectural choice · cross-cutting concern · breaking change · trade-off with long-term impact.
+
+---
+
+## Telemetry (Local-Only)
+
+- Storage: `.dw/metrics/events.jsonl`
+- Inspect: `dw metrics show`
+- Privacy: zero network; `DW_NO_TELEMETRY=1` to disable
+- Used for: v1.4 data-driven cut decisions (internal teams only)
+
+---
+
+## Config Local Override
+
+`.dw/config/dw.config.local.yml` (gitignored) for machine-specific overrides.
+
+---
+
+## Presets
+
+| Preset | Audience | Config |
+|--------|----------|--------|
+| `solo` | Vibe coders, solo dev | Guards only, zero task docs |
+| `team` | 5-15 dev teams | Full hooks, tracking encouraged |
+| `enterprise` | Regulated / large teams | Full + roles + audit |
+
+Install: `dw init --preset {name}` or `dw init --solo`.

package/.claude/settings.json

@@ -1,99 +1,120 @@
-{
-  "permissions": {
-    "allow": [
-      "Read(*)",
-      "Grep(*)",
-      "Glob(*)",
-      "Bash(git log *)",
-      "Bash(git diff *)",
-      "Bash(git show *)",
-      "Bash(git status)",
-      "Bash(git blame *)",
-      "Bash(git stash list)",
-      "Bash(ls *)",
-      "Bash(wc *)"
-    ]
-  },
-  "mcpServers": {},
-  "hooks": {
-    "UserPromptSubmit": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/session-init.sh\""
-          }
-        ]
-      }
-    ],
-    "PreToolUse": [
-      {
-        "matcher": "Read|Glob",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/scout-block.sh\""
-          }
-        ]
-      },
-      {
-        "matcher": "Read",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/privacy-block.sh\""
-          }
-        ]
-      },
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/pre-commit-gate.sh\""
-          }
-        ]
-      },
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/safety-guard.sh\""
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Write|Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/post-write.sh\""
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/stop-check.sh\""
-          }
-        ]
-      }
-    ],
-    "Notification": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/progress-ping.sh\""
-          }
-        ]
-      }
-    ]
-  }
-}
+{
+  "includeCoAuthoredBy": false,
+  "permissions": {
+    "allow": [
+      "Read(*)",
+      "Grep(*)",
+      "Glob(*)",
+      "Bash(git log *)",
+      "Bash(git diff *)",
+      "Bash(git show *)",
+      "Bash(git status)",
+      "Bash(git blame *)",
+      "Bash(git stash list)",
+      "Bash(ls *)",
+      "Bash(wc *)",
+      "Bash(node src/smoke-test.mjs)",
+      "Bash(xargs echo *)",
+      "Edit(/.claude/skills/dw-decision/**)",
+      "Bash(node bin/dw.mjs active)",
+      "Bash(node bin/dw.mjs metrics show)",
+      "Bash(node bin/dw.mjs dashboard)",
+      "Bash(node bin/dw.mjs init --help)",
+      "Bash(mkdir -p /tmp/test-solo)",
+      "Read(//tmp/**)",
+      "Bash(DW_NAME=test node /d/huygdv_projects/dw-kit/bin/dw.mjs init --solo)",
+      "Bash(npm test *)",
+      "Bash(node bin/dw.mjs metrics cut-analysis)",
+      "Bash(bash -n .claude/hooks/pre-commit-gate.sh)",
+      "Bash(bash -n /dev/stdin)",
+      "Bash(dos2unix .claude/hooks/pre-commit-gate.sh)",
+      "Bash(sed -i 's/\\\\r$//' .claude/hooks/pre-commit-gate.sh)",
+      "Bash(git add *)"
+    ],
+    "additionalDirectories": [
+      "D:\\huygdv_projects\\dw-kit\\.claude\\rules"
+    ]
+  },
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/session-init.sh\""
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Read|Glob",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/scout-block.sh\""
+          }
+        ]
+      },
+      {
+        "matcher": "Read",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/privacy-block.sh\""
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/pre-commit-gate.sh\""
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/safety-guard.sh\""
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/post-write.sh\""
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/stop-check.sh\""
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/progress-ping.sh\""
+          }
+        ]
+      }
+    ]
+  },
+  "mcpServers": {}
+}