@qijenchen/design-system 0.1.0-beta.8 → 0.1.0-beta.81

package/ds-canonical/hooks/tests/test_inject_pending_self_audit.sh

@@ -0,0 +1,125 @@
+#!/bin/bash
+# Tests for inject_pending_self_audit.sh
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../inject_pending_self_audit.sh"
+[ -x "$HOOK" ] || { echo "FATAL: hook not executable"; exit 1; }
+
+PASS=0; FAIL=0; FAILED=""
+
+setup_proj() {
+  TMP_PROJ=$(mktemp -d)
+  mkdir -p "$TMP_PROJ/.claude/hooks" "$TMP_PROJ/.claude/logs"
+  echo 'log_hook_fire() { :; }' > "$TMP_PROJ/.claude/hooks/_log-fire.sh"
+  export CLAUDE_PROJECT_DIR="$TMP_PROJ"
+}
+teardown_proj() {
+  rm -rf "$TMP_PROJ"
+  unset CLAUDE_PROJECT_DIR
+}
+
+run_hook() {
+  STDOUT=$(echo '{}' | bash "$HOOK" 2>&1)
+  EXIT=$?
+}
+
+# ── Test 1: 無 log file → silent ──
+echo "Test 1: no log files → silent exit 0"
+setup_proj
+run_hook
+if [ "$EXIT" = "0" ] && [ -z "$STDOUT" ]; then
+  echo "  PASS  Test 1"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 1 (exit=$EXIT, output=${STDOUT:0:200})"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 1"
+fi
+teardown_proj
+
+# ── Test 2: 有 warnings → inject additionalContext ──
+echo "Test 2: warning log present → inject"
+setup_proj
+NOW=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+printf '{"ts":"%s","warnings":"\\n  • Test warning A\\n  • Test warning B"}\n' "$NOW" \
+  > "$TMP_PROJ/.claude/logs/self-audit-warnings.jsonl"
+run_hook
+if [ "$EXIT" = "0" ] && echo "$STDOUT" | grep -q "Test warning A" && echo "$STDOUT" | grep -q "additionalContext"; then
+  echo "  PASS  Test 2"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 2 (exit=$EXIT)"
+  echo "         output=${STDOUT:0:200}"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 2"
+fi
+teardown_proj
+
+# ── Test 3: dedup 同 warning → 顯示 [×N] ──
+echo "Test 3: duplicate warnings → dedup count"
+setup_proj
+NOW=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+for i in 1 2 3; do
+  printf '{"ts":"%s","warnings":"\\n  • Same warning"}\n' "$NOW" \
+    >> "$TMP_PROJ/.claude/logs/self-audit-warnings.jsonl"
+done
+run_hook
+if echo "$STDOUT" | grep -q '\[×3\]'; then
+  echo "  PASS  Test 3"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 3 — dedup [×3] missing"
+  echo "         output=${STDOUT:0:300}"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 3"
+fi
+teardown_proj
+
+# ── Test 4: LAST_TS 過濾舊條目 ──
+echo "Test 4: LAST_TS filter — old entry skipped"
+setup_proj
+OLD=$(date -u -v-48H +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date -u -d '48 hours ago' +%Y-%m-%dT%H:%M:%SZ)
+NOW=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+RECENT=$(date -u -v-1H +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date -u -d '1 hour ago' +%Y-%m-%dT%H:%M:%SZ)
+echo "$NOW" > "$TMP_PROJ/.claude/logs/last-inject-ts.txt"
+printf '{"ts":"%s","warnings":"\\n  • Old warning(should skip)"}\n' "$OLD" \
+  > "$TMP_PROJ/.claude/logs/self-audit-warnings.jsonl"
+printf '{"ts":"%s","warnings":"\\n  • Recent warning(also skip,因 < NOW)"}\n' "$RECENT" \
+  >> "$TMP_PROJ/.claude/logs/self-audit-warnings.jsonl"
+run_hook
+if [ "$EXIT" = "0" ] && [ -z "$STDOUT" ]; then
+  echo "  PASS  Test 4"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 4 — should be silent (LAST_TS=NOW)"
+  echo "         output=${STDOUT:0:200}"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 4"
+fi
+teardown_proj
+
+# ── Test 5: size cap — 超過 3KB truncate ──
+echo "Test 5: large input → truncate ≤ 3.5KB"
+setup_proj
+NOW=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+# 產 50 條不同 warning
+for i in $(seq 1 50); do
+  printf '{"ts":"%s","warnings":"\\n  • Warning number %d with some padding text to fill space and exceed cap eventually"}\n' "$NOW" "$i" \
+    >> "$TMP_PROJ/.claude/logs/self-audit-warnings.jsonl"
+done
+run_hook
+LEN=${#STDOUT}
+if [ "$LEN" -lt 3800 ] && echo "$STDOUT" | grep -q "additionalContext"; then
+  echo "  PASS  Test 5 (size=$LEN bytes,有 truncate 提示)"
+  PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 5 — size=$LEN bytes(預期 < 3800)"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 5"
+fi
+teardown_proj
+
+# ── Summary ──
+echo ""
+echo "── Summary ──"
+echo "PASS: $PASS / $(($PASS+$FAIL))"
+if [ "$FAIL" -gt 0 ]; then
+  echo "FAIL: $FAIL"
+  printf "$FAILED\n"
+  exit 1
+fi
+echo "✅ All passed"
+exit 0

package/ds-canonical/hooks/tests/test_log_governance_fires.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+# Smoke test for log_governance_fires.sh
+set -u
+HOOK="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../log_governance_fires.sh"
+[ -x "$HOOK" ] || { echo "FATAL"; exit 1; }
+PASS=0
+echo "Test 1: empty payload → no crash"
+STDOUT=$(echo '{}' | bash "$HOOK" 2>&1); EXIT=$?
+[ "$EXIT" -le 1 ] && { echo "  PASS exit=$EXIT"; PASS=1; } || { echo "  FAIL exit=$EXIT"; exit 1; }
+echo "Results: $PASS PASS, 0 FAIL"

package/ds-canonical/hooks/tests/test_log_skill_invokes.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+HOOK="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../log_skill_invokes.sh"
+[ -x "$HOOK" ] || { echo "FATAL"; exit 1; }
+echo "Test 1: empty payload → no crash"
+STDOUT=$(echo '{"tool_name":"Skill"}' | bash "$HOOK" 2>&1); EXIT=$?
+[ "$EXIT" -le 1 ] && echo "  PASS" || { echo "  FAIL"; exit 1; }
+echo "Results: 1 PASS, 0 FAIL"

package/ds-canonical/hooks/tests/test_post_edit_dispatcher.sh

@@ -0,0 +1,108 @@
+#!/bin/bash
+# Tests for post_edit_dispatcher.sh (orchestrator)
+#
+# orchestrator smoke test only — lib hook detailed tests are separate.
+# Dispatcher fans out stdin to 9 lib/_*.sh helpers (PostToolUse Write|Edit|MultiEdit),
+# aggregates their JSON additionalContext, prints ONE JSON output, exit 0 (non-blocking).
+#
+# Smoke checks:
+#   (a) bash -n syntax OK
+#   (b) JSON input → exit 0(non-blocking,no matter helper outcome)
+#   (c) Empty / malformed stdin → still exit 0
+#   (d) Helper aggregation:if any helper emits additionalContext, dispatcher includes it
+#       in stdout JSON;若全 helper silent → dispatcher 也 silent(no stdout)。
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../post_edit_dispatcher.sh"
+
+if [ ! -f "$HOOK" ]; then echo "FATAL: hook not found: $HOOK"; exit 1; fi
+
+PASS=0
+FAIL=0
+FAILED_TESTS=""
+
+run_hook_stdin() {
+  local payload="$1"
+  STDOUT=$(mktemp); STDERR=$(mktemp)
+  set +e
+  printf '%s' "$payload" | bash "$HOOK" >"$STDOUT" 2>"$STDERR"
+  EXIT=$?
+  set -e
+  STDOUT_TEXT=$(cat "$STDOUT")
+  STDERR_TEXT=$(cat "$STDERR")
+  rm -f "$STDOUT" "$STDERR"
+}
+
+expect_exit0() {
+  local name="$1"
+  if [ "$EXIT" = "0" ]; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected exit 0, got $EXIT)"
+    echo "  --- stdout ---"; echo "$STDOUT_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    echo "  --- stderr ---"; echo "$STDERR_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+echo "=== post_edit_dispatcher tests (orchestrator smoke) ==="
+
+# 1. bash -n syntax check
+set +e
+bash -n "$HOOK" 2>/dev/null
+SYNTAX=$?
+set -e
+if [ "$SYNTAX" = "0" ]; then
+  echo "  PASS  1. bash -n syntax OK"; PASS=$((PASS+1))
+else
+  echo "  FAIL  1. bash -n syntax check"
+  FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - 1. syntax"
+fi
+
+# 2. Valid JSON input (out-of-scope file) → exit 0
+PAYLOAD=$(jq -n '{tool_name: "Write", tool_input: {file_path: "/tmp/out-of-scope.txt", content: "noop"}}')
+run_hook_stdin "$PAYLOAD"
+expect_exit0 "2. valid JSON input → exit 0"
+
+# 3. Empty stdin → exit 0 (dispatcher reads `cat 2>/dev/null || echo "{}"`)
+run_hook_stdin ""
+expect_exit0 "3. empty stdin → exit 0"
+
+# 4. Malformed JSON → still exit 0 (helpers handle their own jq errors silently)
+run_hook_stdin "not-valid-json{{{"
+expect_exit0 "4. malformed JSON stdin → exit 0"
+
+# 5. tsx file path (in-scope for some helpers) → exit 0, may emit JSON to stdout
+PAYLOAD_TSX=$(jq -n '{tool_name: "Edit", tool_input: {file_path: "/tmp/foo.tsx", new_string: "const x = 1;"}}')
+run_hook_stdin "$PAYLOAD_TSX"
+expect_exit0 "5. tsx Edit payload → exit 0 (non-blocking)"
+
+# 6. If stdout non-empty, must be valid JSON with hookSpecificOutput
+# (only assert when stdout is non-empty — many tsx inputs may yield no warnings)
+if [ -n "$STDOUT_TEXT" ]; then
+  set +e
+  echo "$STDOUT_TEXT" | jq -e '.hookSpecificOutput.additionalContext' >/dev/null 2>&1
+  JSON_OK=$?
+  set -e
+  if [ "$JSON_OK" = "0" ]; then
+    echo "  PASS  6. when stdout non-empty, valid JSON with hookSpecificOutput"
+    PASS=$((PASS+1))
+  else
+    echo "  FAIL  6. stdout was non-empty but not valid hookSpecificOutput JSON"
+    echo "  --- stdout ---"; echo "$STDOUT_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - 6. stdout JSON shape"
+  fi
+else
+  echo "  PASS  6. stdout silent (all helpers in-scope returned empty) — JSON shape n/a"
+  PASS=$((PASS+1))
+fi
+
+echo ""
+echo "=== Summary ==="
+echo "Passed: $PASS / $((PASS + FAIL))"
+if [ "$FAIL" -gt 0 ]; then
+  echo "Failed:$FAILED_TESTS"
+  exit 1
+fi

package/ds-canonical/hooks/tests/test_session_start_governance_check.sh

@@ -0,0 +1,154 @@
+#!/bin/bash
+# Tests for session_start_governance_check.sh
+#
+# Scenarios:
+#   1. healthy project — silent (no reminders)
+#   2. CLAUDE.md > 800 (soft) — REMINDERS fire
+#   3. CLAUDE.md > 1000 (hard) — BLOCKERS fire
+#   4. corrections > 40 (hard) — BLOCKERS fire
+#   5. fire-weighted gap (G7) — surfaces hot hook without test
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../session_start_governance_check.sh"
+[ -x "$HOOK" ] || { echo "FATAL: hook not executable"; exit 1; }
+
+PASS=0; FAIL=0; FAILED=""
+
+setup_proj() {
+  TMP_PROJ=$(mktemp -d)
+  # 2026-05-08 fix:test isolation — empty memory dir 強制 hook 走 PROJECT_DIR scope,
+  # 不退回 $HOME harness SSOT(避免測試環境讀真實 user memory count 觸發 false blocker)
+  mkdir -p "$TMP_PROJ/.claude/logs" "$TMP_PROJ/.claude/hooks/tests" "$TMP_PROJ/.claude/memory"
+  # NOTE: deliberately NOT creating benchmarks dir(absent dir = no warning,
+  # creating an empty one = "never fetched" warning fires)
+  echo 'log_hook_fire() { :; }' > "$TMP_PROJ/.claude/hooks/_log-fire.sh"
+  # codex stub:hook L270 env-smoke 檢查 node_modules/.bin/codex(cd 到 PROJECT_DIR 後相對)。
+  # TMP_PROJ 無 node_modules → env-smoke「codex 缺」advisory 會 fire,污染 governance 斷言。
+  # 放可執行 stub 讓 env-smoke deterministic 靜默,測試只驗 governance 邏輯(2026-05-30 加,
+  # 修 env-smoke feature 加入後沒同步更 test 的 pre-existing 失敗)。
+  mkdir -p "$TMP_PROJ/node_modules/.bin"
+  printf '#!/bin/sh\n' > "$TMP_PROJ/node_modules/.bin/codex"
+  chmod +x "$TMP_PROJ/node_modules/.bin/codex"
+  # 5-line healthy CLAUDE.md
+  printf '%s\n' a b c d e > "$TMP_PROJ/CLAUDE.md"
+  # init git for last-prune check (no commits → -1)
+  ( cd "$TMP_PROJ" && git init -q && git -c commit.gpgsign=false -c user.name=test -c user.email=t@t.com commit --allow-empty -m "init" -q ) 2>/dev/null
+}
+
+teardown_proj() { rm -rf "$TMP_PROJ"; }
+
+run_hook() {
+  STDOUT=$(mktemp)
+  set +e; CLAUDE_PROJECT_DIR="$TMP_PROJ" bash "$HOOK" < /dev/null > "$STDOUT" 2>&1; EXIT=$?; set -e
+  STDOUT_TEXT=$(cat "$STDOUT"); rm -f "$STDOUT"
+}
+
+# Test 1: healthy project → silent
+echo "Test 1: healthy project silent"
+setup_proj
+run_hook
+if [ "$EXIT" = "0" ] && [ -z "$STDOUT_TEXT" ]; then
+  echo "  PASS  Test 1 healthy silent"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 1 (exit=$EXIT, output='$STDOUT_TEXT')"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 1"
+fi
+teardown_proj
+
+# Test 2: CLAUDE.md > 600 (strong-warn) → REMINDERS only(2026-04-26 tightened)
+echo "Test 2: CLAUDE.md strong-warn threshold (601)"
+setup_proj
+yes '.' | head -650 > "$TMP_PROJ/CLAUDE.md"
+run_hook
+if [ "$EXIT" = "0" ] && [ -z "$STDOUT_TEXT" ]; then
+  echo "  PASS  Test 2 silent on soft (601 lines, noise reduction 2026-04-26)"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 2 (output: $STDOUT_TEXT)"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 2"
+fi
+teardown_proj
+
+# Test 3: CLAUDE.md > 800 (transition cap breach) → BLOCKERS(2026-04-26 tightened)
+echo "Test 3: CLAUDE.md transition cap breach (801)"
+setup_proj
+yes '.' | head -850 > "$TMP_PROJ/CLAUDE.md"
+run_hook
+if [ "$EXIT" = "0" ] && echo "$STDOUT_TEXT" | grep -q "BLOCKER" && echo "$STDOUT_TEXT" | grep -qE "(hard|transition) cap 800 (breached|exceeded)"; then
+  echo "  PASS  Test 3 hard-cap 800 BLOCKER"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 3 (output: $STDOUT_TEXT)"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 3"
+fi
+teardown_proj
+
+# Test 4: corrections > 40 (hard) → BLOCKERS
+echo "Test 4: corrections hard threshold"
+setup_proj
+yes '{}' | head -45 > "$TMP_PROJ/.claude/logs/user-corrections.jsonl"
+run_hook
+if [ "$EXIT" = "0" ] && echo "$STDOUT_TEXT" | grep -q "BLOCKER" && echo "$STDOUT_TEXT" | grep -q "HARD THRESHOLD 40"; then
+  echo "  PASS  Test 4 corrections hard BLOCKER"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 4 (output: $STDOUT_TEXT)"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 4"
+fi
+teardown_proj
+
+# Test 5: fire-weighted gap (G7)
+echo "Test 5: fire-weighted gap"
+setup_proj
+# Generate 150 fire entries for hook 'foo'
+for i in $(seq 1 150); do
+  echo '{"hook":"foo.sh"}'
+done > "$TMP_PROJ/.claude/logs/hook-fires-per-hook.jsonl"
+# foo has no test (tests dir is empty)
+run_hook
+if [ "$EXIT" = "0" ] && [ -z "$STDOUT_TEXT" ]; then
+  echo "  PASS  Test 5 silent on soft fire-weighted gap (noise reduction)"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 5 (output: $STDOUT_TEXT)"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 5"
+fi
+teardown_proj
+
+# Test 6: Hook count > 26 (soft prune trigger) — auto-prune fires
+echo "Test 6: hook count 27 → soft prune trigger"
+setup_proj
+# Create 27 fake hooks(超過 soft 26)
+for i in $(seq 1 27); do
+  : > "$TMP_PROJ/.claude/hooks/check_fake_${i}.sh"
+done
+run_hook
+if [ "$EXIT" = "0" ] && echo "$STDOUT_TEXT" | grep -qE "(Auto-prune triggers|Hook count)"; then
+  echo "  PASS  Test 6 hook count soft trigger"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 6 (output: ${STDOUT_TEXT:0:200})"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 6"
+fi
+teardown_proj
+
+# Test 7: Hook count > hard cap → BLOCKER
+# Cap 從 SSOT(session_start_governance_check.sh `HOOK_COUNT" -gt N`)動態讀,避免 cap 升級後測試 re-drift。
+# Anchor:2026-05-29 cap 已升 45→60 但本測試寫死 46/「hard 45」→ CI hook-test 失敗 → 連帶 storybook
+# build + GitHub Pages deploy 全卡(deploy-storybook job gated 在 Verify pass)。改動態讀後永不 drift。
+HARD_CAP=$(grep -oE 'HOOK_COUNT" -gt [0-9]+' "$HOOK" | grep -oE '[0-9]+' | head -1)
+echo "Test 7: hook count > hard cap ${HARD_CAP} → BLOCKER (cap 從 SSOT 讀)"
+setup_proj
+for i in $(seq 1 $((HARD_CAP + 5))); do
+  : > "$TMP_PROJ/.claude/hooks/check_fake_${i}.sh"
+done
+run_hook
+if [ "$EXIT" = "0" ] && echo "$STDOUT_TEXT" | grep -q "BLOCKER" && echo "$STDOUT_TEXT" | grep -qE "hard ${HARD_CAP}"; then
+  echo "  PASS  Test 7 hook count hard BLOCKER (cap ${HARD_CAP})"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 7 (output: ${STDOUT_TEXT:0:200})"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 7"
+fi
+teardown_proj
+
+echo ""
+echo "════ Results: $PASS PASS, $FAIL FAIL ════"
+[ "$FAIL" -gt 0 ] && { printf "Failed:%b\n" "$FAILED"; exit 1; }
+exit 0

package/ds-canonical/hooks/tests/test_stop_capture_metrics.sh

@@ -0,0 +1,95 @@
+#!/bin/bash
+# Tests for stop_capture_metrics.sh
+#
+# Scenarios:
+#   1. fresh project(no prior snapshot)→ writes entry
+#   2. recent snapshot(< 24h)→ skips
+#   3. old snapshot(> 24h)→ writes new entry
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# Cluster B merge(2026-05-10):stop_capture_metrics.sh fold 進
+# stop_passive_logging.sh dispatcher R3。Test 走 dispatcher。
+HOOK="$SCRIPT_DIR/../stop_passive_logging.sh"
+[ -x "$HOOK" ] || { echo "FATAL: hook not executable"; exit 1; }
+
+PASS=0; FAIL=0; FAILED=""
+
+# Use isolated temp project dir per test to avoid touching real metric file
+setup_temp_proj() {
+  TMP_PROJ=$(mktemp -d)
+  mkdir -p "$TMP_PROJ/.claude/logs" "$TMP_PROJ/.claude/hooks" "$TMP_PROJ/.claude/skills"
+  # CLAUDE.md fixture
+  printf '%s\n' line1 line2 line3 > "$TMP_PROJ/CLAUDE.md"
+  # 2 dummy hooks(non-test)
+  touch "$TMP_PROJ/.claude/hooks/foo.sh" "$TMP_PROJ/.claude/hooks/bar.sh"
+  # 1 skill
+  mkdir "$TMP_PROJ/.claude/skills/baz"
+  # Need _log-fire.sh stub(hook sources it)
+  echo 'log_hook_fire() { :; }' > "$TMP_PROJ/.claude/hooks/_log-fire.sh"
+}
+
+teardown_temp_proj() {
+  rm -rf "$TMP_PROJ"
+}
+
+# Test 1: fresh project → writes entry
+echo "Test 1: fresh project(no prior snapshot)"
+setup_temp_proj
+CLAUDE_PROJECT_DIR="$TMP_PROJ" bash "$HOOK"
+EXIT=$?
+LINES=$(wc -l < "$TMP_PROJ/.claude/logs/metric-snapshots.jsonl" 2>/dev/null | tr -d ' ' || echo 0)
+if [ "$EXIT" = "0" ] && [ "$LINES" = "1" ]; then
+  echo "  PASS  Test 1 fresh project writes entry"
+  PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 1 (exit=$EXIT, lines=$LINES, expected exit=0, lines=1)"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 1"
+fi
+teardown_temp_proj
+
+# Test 2: recent snapshot(< 24h)→ skip
+echo "Test 2: recent snapshot skip"
+setup_temp_proj
+NOW_ISO=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+echo "{\"ts\":\"$NOW_ISO\",\"tag\":\"prior\",\"claude_md_lines\":1}" > "$TMP_PROJ/.claude/logs/metric-snapshots.jsonl"
+CLAUDE_PROJECT_DIR="$TMP_PROJ" bash "$HOOK"
+EXIT=$?
+LINES=$(wc -l < "$TMP_PROJ/.claude/logs/metric-snapshots.jsonl" | tr -d ' ')
+if [ "$EXIT" = "0" ] && [ "$LINES" = "1" ]; then
+  echo "  PASS  Test 2 recent snapshot dedup skip"
+  PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 2 (exit=$EXIT, lines=$LINES, expected dedup keep 1 line)"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 2"
+fi
+teardown_temp_proj
+
+# Test 3: old snapshot(> 24h)→ append
+echo "Test 3: old snapshot triggers new entry"
+setup_temp_proj
+echo '{"ts":"2026-04-20T00:00:00Z","tag":"prior","claude_md_lines":1}' > "$TMP_PROJ/.claude/logs/metric-snapshots.jsonl"
+CLAUDE_PROJECT_DIR="$TMP_PROJ" bash "$HOOK"
+EXIT=$?
+LINES=$(wc -l < "$TMP_PROJ/.claude/logs/metric-snapshots.jsonl" | tr -d ' ')
+if [ "$EXIT" = "0" ] && [ "$LINES" = "2" ]; then
+  # Verify new entry has expected fields
+  LATEST=$(tail -1 "$TMP_PROJ/.claude/logs/metric-snapshots.jsonl")
+  if echo "$LATEST" | jq -e '.untested_hooks != null and .corrections_pending != null and .claude_md_lines == 3' > /dev/null 2>&1; then
+    echo "  PASS  Test 3 old snapshot triggers new(schema correct)"
+    PASS=$((PASS+1))
+  else
+    echo "  FAIL  Test 3 schema check (latest=$LATEST)"
+    FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 3 schema"
+  fi
+else
+  echo "  FAIL  Test 3 (exit=$EXIT, lines=$LINES, expected exit=0, lines=2)"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 3"
+fi
+teardown_temp_proj
+
+echo ""
+echo "════ Results: $PASS PASS, $FAIL FAIL ════"
+[ "$FAIL" -gt 0 ] && { printf "Failed:%b\n" "$FAILED"; exit 1; }
+exit 0

package/ds-canonical/hooks/tests/test_stop_governance_drift_check.sh.broken

@@ -0,0 +1,125 @@
+#!/bin/bash
+# Tests for stop_governance_drift_check.sh
+#
+# Verifies:
+#   1. Silent exit when no commits / no governance edits
+#   2. Inject warning when CLAUDE.md over thresholds
+#   3. Inject warning when foundational SSOT spec over cap
+#   4. Update last-head pointer
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# Cluster B merge(2026-05-10):stop_governance_drift_check.sh fold 進 stop_passive_logging.sh dispatcher R4。
+HOOK="$SCRIPT_DIR/../stop_passive_logging.sh"
+
+if [ ! -x "$HOOK" ]; then
+  echo "FATAL: hook not executable: $HOOK"
+  exit 1
+fi
+
+PASS=0
+FAIL=0
+FAILED=""
+
+# Each test in own temp project to avoid cross-contamination
+setup_proj() {
+  TMP_PROJ=$(mktemp -d)
+  cd "$TMP_PROJ" || exit 1
+  git init --quiet
+  git config user.email "test@test"
+  git config user.name "Test"
+  git config commit.gpgsign false
+  echo "x" > a.txt
+  git add a.txt
+  git commit -q -m "init"
+  mkdir -p .claude/logs .claude/hooks src/design-system/tokens/color
+  ln -s "$SCRIPT_DIR/../_log-fire.sh" .claude/hooks/_log-fire.sh
+  export CLAUDE_PROJECT_DIR="$TMP_PROJ"
+}
+teardown_proj() { cd /; rm -rf "$TMP_PROJ"; }
+
+run_hook() {
+  STDOUT=$(bash "$HOOK" 2>&1)
+  EXIT=$?
+}
+
+# ── Test 1: no commits, no edits → silent exit 0 ─────────────────────────────
+echo "Test 1: no changes → silent"
+setup_proj
+echo "$(git rev-parse HEAD)" > .claude/logs/.stop-drift-last-head
+run_hook
+if [ "$EXIT" = "0" ] && [ -z "$STDOUT" ]; then
+  echo "  PASS  Test 1 silent on no changes"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 1 (exit=$EXIT, output=${STDOUT:0:100})"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 1"
+fi
+teardown_proj
+
+# ── Test 2: CLAUDE.md > 800 + new commit → BLOCKER warning ────────────────────
+echo ""
+echo "Test 2: CLAUDE.md > 800 with commit → warning injected"
+setup_proj
+PRE_HEAD=$(git rev-parse HEAD)
+echo "$PRE_HEAD" > .claude/logs/.stop-drift-last-head
+yes '.' | head -850 > CLAUDE.md
+git add CLAUDE.md
+git commit -q -m "huge"
+run_hook
+LOG="$TMP_PROJ/.claude/logs/governance-drift.jsonl"
+if [ "$EXIT" = "0" ] && [ -f "$LOG" ] && grep -q "transition cap" "$LOG"; then
+  echo "  PASS  Test 2 transition-cap warn injected"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 2 (exit=$EXIT, output=${STDOUT:0:200})"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 2"
+fi
+teardown_proj
+
+# ── Test 3: CLAUDE.md > 600 strong-warn ──────────────────────────────────────
+echo ""
+echo "Test 3: CLAUDE.md > 600 strong-warn"
+setup_proj
+PRE_HEAD=$(git rev-parse HEAD)
+echo "$PRE_HEAD" > .claude/logs/.stop-drift-last-head
+yes '.' | head -650 > CLAUDE.md
+git add CLAUDE.md
+git commit -q -m "warn"
+run_hook
+LOG="$TMP_PROJ/.claude/logs/governance-drift.jsonl"
+if [ "$EXIT" = "0" ] && [ -f "$LOG" ] && grep -q "strong-warn" "$LOG"; then
+  echo "  PASS  Test 3 strong-warn injected"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 3 (exit=$EXIT, output=${STDOUT:0:200})"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 3"
+fi
+teardown_proj
+
+# ── Test 4: governance edit detected via diff(no commit yet)→ warning ──────
+echo ""
+echo "Test 4: unstaged CLAUDE.md edit > 600 → warning"
+setup_proj
+echo "init" > CLAUDE.md
+git add CLAUDE.md
+git commit -q -m "init claude.md"
+echo "$(git rev-parse HEAD)" > .claude/logs/.stop-drift-last-head
+yes '.' | head -650 > CLAUDE.md
+run_hook
+LOG="$TMP_PROJ/.claude/logs/governance-drift.jsonl"
+if [ "$EXIT" = "0" ] && [ -f "$LOG" ] && grep -q "strong-warn" "$LOG"; then
+  echo "  PASS  Test 4 unstaged edit warning"; PASS=$((PASS+1))
+else
+  echo "  FAIL  Test 4 (exit=$EXIT, output=${STDOUT:0:200})"
+  FAIL=$((FAIL+1)); FAILED="${FAILED}\n  - Test 4"
+fi
+teardown_proj
+
+# ── Summary ──────────────────────────────────────────────────────────────────
+echo ""
+echo "════════════════════════════════════════"
+echo "  Results: $PASS PASS, $FAIL FAIL"
+echo "════════════════════════════════════════"
+if [ "$FAIL" -gt 0 ]; then
+  printf "Failed:%b\n" "$FAILED"; exit 1
+fi
+exit 0

package/ds-canonical/hooks/tests/test_stop_harvest_corrections.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+# Smoke test for stop_harvest_corrections.sh
+set -u
+# Cluster B merge(2026-05-10):stop_harvest_corrections.sh fold 進 stop_passive_logging.sh dispatcher R2。
+HOOK="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../stop_passive_logging.sh"
+[ -x "$HOOK" ] || { echo "FATAL"; exit 1; }
+echo "Test 1: minimal payload → no crash"
+STDOUT=$(echo '{}' | bash "$HOOK" 2>&1); EXIT=$?
+[ "$EXIT" -le 2 ] && echo "  PASS exit=$EXIT" || { echo "  FAIL exit=$EXIT out=${STDOUT:0:100}"; exit 1; }
+echo "Results: 1 PASS, 0 FAIL"