dw-kit 1.2.0 → 1.2.1

package/.claude/hooks/session-init.sh

@@ -1,74 +1,85 @@
-#!/usr/bin/env bash
-# .claude/hooks/session-init.sh — dw-kit v1.2
-# Inject active task context vào đầu session, giải quyết "session amnesia".
-# Chỉ chạy một lần mỗi session (track bằng session_id).
-#
-# UserPromptSubmit hook
-# Stdout output → được inject vào context của user prompt
-# exit 0 = allow
-
-INPUT=$(cat)
-
-SESSION_ID=$(echo "$INPUT" | node -e "
-let d='';
-process.stdin.on('data',c=>d+=c).on('end',()=>{
-  try{ process.stdout.write(JSON.parse(d).session_id||''); }catch(e){}
-});
-" 2>/dev/null || true)
-
-[ -z "$SESSION_ID" ] && exit 0
-
-# ── Track session: chỉ chạy một lần mỗi session ───────────────────────────────
-SESSION_MARKER="/tmp/dw-session-${SESSION_ID}"
-if [ -f "$SESSION_MARKER" ]; then
-  exit 0
-fi
-touch "$SESSION_MARKER" 2>/dev/null || true
-
-# ── Scan .dw/tasks/ tìm tasks In Progress ─────────────────────────────────────
-PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
-TASKS_DIR="$PROJECT_DIR/.dw/tasks"
-
-[ ! -d "$TASKS_DIR" ] && exit 0
-
-ACTIVE_TASKS=()
-ACTIVE_SUMMARIES=()
-
-while IFS= read -r progress_file; do
-  if grep -q "Trạng thái: In Progress" "$progress_file" 2>/dev/null; then
-    task_name=$(basename "$(dirname "$progress_file")")
-
-    # Extract current subtask (dòng "In Progress" trong table)
-    current_st=$(grep -m1 "In Progress" "$progress_file" 2>/dev/null \
-      | grep -oP '\| ST-\d+ \| [^|]+' | sed 's/|//g' | xargs 2>/dev/null || echo "")
-
-    # Extract last handoff note nếu có
-    last_handoff=$(awk '/## Handoff Notes/{found=1} found{print}' "$progress_file" 2>/dev/null \
-      | grep -m1 "Bước tiếp theo:" | sed 's/.*Bước tiếp theo://' | xargs 2>/dev/null || echo "")
-
-    ACTIVE_TASKS+=("$task_name")
-    summary="$task_name"
-    [ -n "$current_st" ] && summary="$summary — $current_st"
-    [ -n "$last_handoff" ] && summary="$summary | Next: $last_handoff"
-    ACTIVE_SUMMARIES+=("$summary")
-  fi
-done < <(find "$TASKS_DIR" -name "*-progress.md" 2>/dev/null)
-
-[ ${#ACTIVE_TASKS[@]} -eq 0 ] && exit 0
-
-# ── Output context vào stdout (injected vào conversation) ─────────────────────
-echo ""
-echo "---"
-echo "[dw-kit session-init] Task đang in-progress:"
-for summary in "${ACTIVE_SUMMARIES[@]}"; do
-  echo "  • $summary"
-done
-if [ ${#ACTIVE_TASKS[@]} -eq 1 ]; then
-  echo "Context: .dw/tasks/${ACTIVE_TASKS[0]}/"
-else
-  echo "Nhiều tasks đang active — hỏi user task nào cần tiếp tục."
-fi
-echo "---"
-echo ""
-
-exit 0
+#!/usr/bin/env bash
+# .claude/hooks/session-init.sh — dw-kit v1.2
+# Inject active task context vào đầu session, giải quyết "session amnesia".
+# Chỉ chạy một lần mỗi session (track bằng session_id).
+#
+# UserPromptSubmit hook
+# Stdout output → được inject vào context của user prompt
+# exit 0 = allow
+
+INPUT=$(cat)
+
+SESSION_ID=$(echo "$INPUT" | node -e "
+let d='';
+process.stdin.on('data',c=>d+=c).on('end',()=>{
+  try{ process.stdout.write(JSON.parse(d).session_id||''); }catch(e){}
+});
+" 2>/dev/null || true)
+
+# Tier 2: pure-bash grep fallback — works without node (e.g. node absent or CRLF-corrupt shebang)
+if [ -z "$SESSION_ID" ]; then
+  SESSION_ID=$(echo "$INPUT" | grep -o '"session_id":"[^"]*"' | cut -d'"' -f4 2>/dev/null || true)
+fi
+
+# Tier 3: project-scoped + hour-scoped stable ID
+# cksum is POSIX — available on Linux, macOS, and Git Bash on Windows.
+# Ensures marker is always created so re-injection is suppressed even when tiers 1+2 fail.
+if [ -z "$SESSION_ID" ]; then
+  _dir_hash=$(pwd | cksum | cut -d' ' -f1)
+  SESSION_ID="fallback-${_dir_hash}-$(date +%Y%m%d-%H)"
+fi
+
+# ── Track session: chỉ chạy một lần mỗi session ───────────────────────────────
+SESSION_MARKER="/tmp/dw-session-${SESSION_ID}"
+if [ -f "$SESSION_MARKER" ]; then
+  exit 0
+fi
+touch "$SESSION_MARKER" 2>/dev/null || true
+
+# ── Scan .dw/tasks/ tìm tasks In Progress ─────────────────────────────────────
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+TASKS_DIR="$PROJECT_DIR/.dw/tasks"
+
+[ ! -d "$TASKS_DIR" ] && exit 0
+
+ACTIVE_TASKS=()
+ACTIVE_SUMMARIES=()
+
+while IFS= read -r progress_file; do
+  if grep -q "Trạng thái: In Progress" "$progress_file" 2>/dev/null; then
+    task_name=$(basename "$(dirname "$progress_file")")
+
+    # Extract current subtask (dòng "In Progress" trong table)
+    current_st=$(grep -m1 "In Progress" "$progress_file" 2>/dev/null \
+      | grep -oP '\| ST-\d+ \| [^|]+' | sed 's/|//g' | xargs 2>/dev/null || echo "")
+
+    # Extract last handoff note nếu có
+    last_handoff=$(awk '/## Handoff Notes/{found=1} found{print}' "$progress_file" 2>/dev/null \
+      | grep -m1 "Bước tiếp theo:" | sed 's/.*Bước tiếp theo://' | xargs 2>/dev/null || echo "")
+
+    ACTIVE_TASKS+=("$task_name")
+    summary="$task_name"
+    [ -n "$current_st" ] && summary="$summary — $current_st"
+    [ -n "$last_handoff" ] && summary="$summary | Next: $last_handoff"
+    ACTIVE_SUMMARIES+=("$summary")
+  fi
+done < <(find "$TASKS_DIR" -name "*-progress.md" 2>/dev/null)
+
+[ ${#ACTIVE_TASKS[@]} -eq 0 ] && exit 0
+
+# ── Output context vào stdout (injected vào conversation) ─────────────────────
+echo ""
+echo "---"
+echo "[dw-kit session-init] Task đang in-progress:"
+for summary in "${ACTIVE_SUMMARIES[@]}"; do
+  echo "  • $summary"
+done
+if [ ${#ACTIVE_TASKS[@]} -eq 1 ]; then
+  echo "Context: .dw/tasks/${ACTIVE_TASKS[0]}/"
+else
+  echo "Nhiều tasks đang active — hỏi user task nào cần tiếp tục."
+fi
+echo "---"
+echo ""
+
+exit 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/settings.json

@@ -1,99 +1,101 @@
-{
-  "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)"
+    ]
+  },
+  "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": {}
+}