devlog-tracker 0.22.0

package/hooks/scripts/session-start-devlog.sh

@@ -0,0 +1,157 @@
+#!/usr/bin/env bash
+# SessionStart hook：在 startup / resume / clear / compact / fork 時執行。
+# startup / resume / compact / fork：讀 .devlog/devlog.md 最後 N 輪 + 開頭摘要，
+# 印到 stdout 讓 Claude Code 當成 additionalContext 注入。
+# source=clear：只做 dangling heal，不注入、不印 span 提醒——/clear 必須是真的空
+# context，接續改由 /devlog-tracker:continue。找不到檔案就 exit 0。
+#
+# Span Mode：.span-open 還開著時，在注入內容最前面加一段提醒（clear 除外）。
+# 讀不到／格式壞掉就靜默跳過，fail-open。
+#
+# Dangling heal：startup / resume / clear / fork 把殘留的 .round-open 標成
+# INTERRUPTED。source=compact（以及 source 缺失／讀不到）跳過 heal，避免
+# mid-turn auto-compact 改雜湊讓 Stop 靜默放行；compact 仍注入 excerpt
+#（最後一個 Checkpoint + 最近兩輪 Summary/Handoff/Status），不 heal。
+# close-open-round.sh 必須對 stdout 保持沉默。
+#
+# .round-current.md excerpt：因為 compact 不 heal，這一輪真的可能還開著、
+# 內容只在 .devlog/.round-current.md 裡（尚未併回 devlog.md）——起始時的
+# devlog.md 摘要看不到它，會讓 mid-turn auto-compact 的注入內容悄悄漏掉
+# Claude 正在寫的這一輪。devlog.md 摘要印完之後，只要 .round-current.md
+# 非空就整份印出來、清楚標示「尚未收尾」，跟上面的歷史摘要分開。startup /
+# resume / fork 這幾個 source 因為上面已經先 heal 過，這裡通常是空的、印出
+# 來是 no-op，不特別排除，寫法比較單純。讀不到就跳過，fail-open。
+
+set -uo pipefail
+
+_src="${BASH_SOURCE[0]}"
+HOOKS_DIR="$(cd "${_src%/*}" && pwd)"
+# shellcheck source=json-field.sh
+. "$HOOKS_DIR/json-field.sh"
+# shellcheck source=detect-pending-question.sh
+. "$HOOKS_DIR/detect-pending-question.sh"
+# shellcheck source=devlog-path.sh
+. "$HOOKS_DIR/devlog-path.sh"
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-.}"
+devlog_resolve_paths "$PROJECT_DIR"
+ROUND_CURRENT="$DEVLOG_DIR/.round-current.md"
+SPAN_FILE="$DEVLOG_DIR/.span-open"
+
+INPUT="$(cat 2>/dev/null || true)"
+SOURCE="$(json_str_field "$INPUT" source)"
+
+case "$SOURCE" in
+  startup|resume|clear|fork)
+    if [ -f "$DEVLOG_DIR/.round-open" ]; then
+      DANGLING_DETAIL=""
+      if [ -n "$(detect_pending_question "$(json_str_field "$INPUT" transcript_path)")" ]; then
+        DANGLING_DETAIL="awaiting_question"
+      fi
+      bash "$HOOKS_DIR/close-open-round.sh" "dangling:session_start" "$DANGLING_DETAIL" || true
+    fi
+    ;;
+esac
+
+# /clear 清空對話；不要把 devlog 或 span 提醒打回 context。
+if [ "$SOURCE" = "clear" ]; then
+  exit 0
+fi
+
+if [ -f "$SPAN_FILE" ]; then
+  SPAN_ROUND="$(json_int_get "$SPAN_FILE" round)"
+  SPAN_OPENED_AT="$(json_str_get "$SPAN_FILE" opened_at)"
+  if [ -n "$SPAN_ROUND" ] && [ -n "$SPAN_OPENED_AT" ]; then
+    echo "⚠️ 有一個開啟中的 span：Round ${SPAN_ROUND}，從 ${SPAN_OPENED_AT} 開始，"
+    echo "還沒有正式結束。請先確認要繼續這個自動化任務，還是要明確關閉它"
+    echo "（刪除 .devlog/.span-open 並補寫收尾的 Round）。"
+    echo ""
+  fi
+fi
+
+if [ -f "$DEVLOG_FILE" ]; then
+  echo "以下是本專案 .devlog/${DEVLOG_FILE##*/} 的接手摘要（不是全文；完整紀錄請自行讀取原檔）："
+  echo ""
+  awk '
+  /^[ \t]*```/ { fence = !fence }
+  {
+    lines[NR] = $0
+    infence[NR] = fence
+  }
+  END {
+    n = NR
+    last_cp = 0
+    last_kept = 0
+    last_lessons = 0
+    rc = 0
+    for (i = 1; i <= n; i++) {
+      if (infence[i]) continue
+      if (lines[i] ~ /^## Checkpoint/) last_cp = i
+      if (lines[i] ~ /^## Kept 索引/) last_kept = i
+      if (lines[i] ~ /^## Lessons 索引/) last_lessons = i
+      if (lines[i] ~ /^## Round /) { rc++; round_at[rc] = i }
+    }
+    if (last_cp > 0) {
+      cp_end = n
+      for (j = last_cp + 1; j <= n; j++) {
+        if (!infence[j] && lines[j] ~ /^## /) { cp_end = j - 1; break }
+      }
+      for (j = last_cp; j <= cp_end; j++) print lines[j]
+      print ""
+    }
+    if (last_kept > 0) {
+      kp_end = n
+      for (j = last_kept + 1; j <= n; j++) {
+        if (!infence[j] && lines[j] ~ /^## /) { kp_end = j - 1; break }
+      }
+      for (j = last_kept; j <= kp_end; j++) print lines[j]
+      print ""
+    }
+    if (last_lessons > 0) {
+      ls_end = n
+      for (j = last_lessons + 1; j <= n; j++) {
+        if (!infence[j] && lines[j] ~ /^## /) { ls_end = j - 1; break }
+      }
+      for (j = last_lessons; j <= ls_end; j++) print lines[j]
+      print ""
+    }
+    start_i = (rc > 2) ? rc - 1 : 1
+    if (rc == 0) exit 0
+    for (r = start_i; r <= rc; r++) {
+      rs = round_at[r]
+      re = n
+      for (j = rs + 1; j <= n; j++) {
+        if (!infence[j] && lines[j] ~ /^## /) { re = j - 1; break }
+      }
+      print lines[rs]
+      print ""
+      has_summary = 0
+      for (j = rs; j <= re; j++) if (!infence[j] && lines[j] ~ /^### Summary/) has_summary = 1
+      keep = 0
+      for (j = rs + 1; j <= re; j++) {
+        if (infence[j]) {
+          if (keep) print lines[j]
+          continue
+        }
+        if (lines[j] ~ /^### Summary/ || lines[j] ~ /^### Handoff/ || lines[j] ~ /^### Status/) { keep = 1; print lines[j]; continue }
+        if (lines[j] ~ /^### User Input/) { keep = (has_summary ? 0 : 1); if (keep) print lines[j]; continue }
+        if (lines[j] ~ /^### /) { keep = 0; continue }
+        if (keep) print lines[j]
+      }
+      print ""
+    }
+  }
+  ' "$DEVLOG_FILE" 2>/dev/null || true
+fi
+
+# See header comment: this round may still be genuinely open (compact skips
+# heal) with its real content sitting only in .round-current.md. Surface it
+# separately from the devlog.md excerpt above so it isn't silently dropped.
+if [ -s "$ROUND_CURRENT" ]; then
+  echo "以下是目前還沒收尾、仍在 .devlog/.round-current.md 裡的這一輪內容（跟上面的歷史摘要分開，尚未併入 devlog.md）："
+  echo ""
+  cat "$ROUND_CURRENT" 2>/dev/null || true
+  echo ""
+fi
+
+exit 0

package/hooks/scripts/span-close.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+set -uo pipefail
+DEVLOG_DIR="${CLAUDE_PROJECT_DIR:-.}/.devlog"
+if [ ! -e "$DEVLOG_DIR/.span-open" ]; then
+  echo "NOT_OPEN"
+  exit 0
+fi
+rm -f "$DEVLOG_DIR/.span-open" || exit 1
+echo "CLOSED"

package/hooks/scripts/span-open.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -uo pipefail
+_src="${BASH_SOURCE[0]}"
+SCRIPT_DIR="$(cd "${_src%/*}" && pwd)"
+. "$SCRIPT_DIR/json-field.sh"
+. "$SCRIPT_DIR/devlog-md.sh"
+. "$SCRIPT_DIR/devlog-path.sh"
+
+devlog_resolve_paths "${CLAUDE_PROJECT_DIR:-.}"
+[ -f "$DEVLOG_DIR/.enabled" ] || { echo "NOT_ENABLED" >&2; exit 1; }
+[ ! -e "$DEVLOG_DIR/.span-open" ] || { echo "ALREADY_OPEN" >&2; exit 1; }
+ROUND=""
+[ ! -f "$DEVLOG_DIR/.round-open" ] || ROUND="$(json_int_get "$DEVLOG_DIR/.round-open" round)"
+if [ -z "$ROUND" ] && [ -f "$DEVLOG_FILE" ]; then
+  ROUND="$(devlog_list_round_starts "$DEVLOG_FILE" | awk 'END { print $2 }')"
+fi
+[ -n "$ROUND" ] || { echo "NO_ROUND" >&2; exit 1; }
+OPENED_AT="$(date -Iseconds 2>/dev/null || date '+%Y-%m-%dT%H:%M:%S%z')"
+printf '{"round": %s, "opened_at": "%s", "ticks_since_checkin": 0, "max_silent_ticks": 5}\n' \
+  "$ROUND" "$OPENED_AT" > "$DEVLOG_DIR/.span-open" || exit 1
+printf 'OPENED=%s\n' "$ROUND"

package/hooks/scripts/start-devlog.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+# User-invoked: /devlog-tracker:start filesystem side.
+set -uo pipefail
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-.}"
+DEVLOG_DIR="$PROJECT_DIR/.devlog"
+mkdir -p "$DEVLOG_DIR" || exit 1
+if [ ! -f "$DEVLOG_DIR/.enabled" ]; then
+  date -Iseconds > "$DEVLOG_DIR/.enabled" 2>/dev/null || echo enabled > "$DEVLOG_DIR/.enabled"
+fi
+if [ ! -f "$DEVLOG_DIR/.checkpoint-state" ]; then
+  printf '%s\n' '{"rounds_since_checkpoint": 0, "max_silent_rounds": 20, "checkpoint_marker_count": 0}' \
+    > "$DEVLOG_DIR/.checkpoint-state" || exit 1
+fi
+if [ ! -f "$DEVLOG_DIR/.segment-state" ]; then
+  printf '%s\n' '{"last_change_epoch": 0, "last_seen_cksum": "", "max_silent_seconds": 600, "session_id": ""}' \
+    > "$DEVLOG_DIR/.segment-state" || exit 1
+fi
+GITIGNORE_DEVLOG=no
+if [ -f "$PROJECT_DIR/.gitignore" ] && grep -E -q '(^|/)\.devlog(/|$)' "$PROJECT_DIR/.gitignore"; then
+  GITIGNORE_DEVLOG=yes
+fi
+echo "ENABLED=$DEVLOG_DIR/.enabled"
+echo "GITIGNORE_DEVLOG=$GITIGNORE_DEVLOG"
+exit 0

package/hooks/scripts/status-devlog.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+set -uo pipefail
+_src="${BASH_SOURCE[0]}"
+SCRIPT_DIR="$(cd "${_src%/*}" && pwd)"
+. "$SCRIPT_DIR/json-field.sh"
+. "$SCRIPT_DIR/devlog-md.sh"
+. "$SCRIPT_DIR/devlog-path.sh"
+
+devlog_resolve_paths "${CLAUDE_PROJECT_DIR:-.}"
+[ -d "$DEVLOG_DIR" ] || { echo "NOT_STARTED"; exit 0; }
+
+[ -f "$DEVLOG_DIR/.enabled" ] && echo "ENABLED=yes" || echo "ENABLED=no"
+[ -f "$DEVLOG_DIR/.lessons-enabled" ] && echo "LESSONS=yes" || echo "LESSONS=no"
+if [ -f "$DEVLOG_DIR/.lessons-drift-state" ]; then
+  drift_count="$(json_int_get "$DEVLOG_DIR/.lessons-drift-state" mismatch_count)"
+  drift_max="$(json_int_get "$DEVLOG_DIR/.lessons-drift-state" threshold)"
+  printf 'LESSONS_DRIFT=%s/%s\n' "${drift_count:-0}" "${drift_max:-3}"
+fi
+if [ -f "$DEVLOG_DIR/.span-open" ]; then
+  r="$(json_int_get "$DEVLOG_DIR/.span-open" round)"
+  opened="$(json_str_get "$DEVLOG_DIR/.span-open" opened_at)"
+  ticks="$(json_int_get "$DEVLOG_DIR/.span-open" ticks_since_checkin)"
+  max="$(json_int_get "$DEVLOG_DIR/.span-open" max_silent_ticks)"
+  printf 'SPAN=%s,%s,%s,%s\n' "${r:-?}" "${opened:-?}" "${ticks:-?}" "${max:-5}"
+else
+  echo "SPAN=closed"
+fi
+rounds="$(json_int_get "$DEVLOG_DIR/.checkpoint-state" rounds_since_checkpoint)"
+checkpoint_max="$(json_int_get "$DEVLOG_DIR/.checkpoint-state" max_silent_rounds)"
+printf 'CHECKPOINT=%s/%s\n' "${rounds:-0}" "${checkpoint_max:-20}"
+seconds="$(json_int_get "$DEVLOG_DIR/.segment-state" max_silent_seconds)"
+printf 'SEGMENT=max_silent_seconds=%s\n' "${seconds:-600}"
+
+status="none"
+if [ -f "$DEVLOG_FILE" ]; then
+  last="$(devlog_list_round_starts "$DEVLOG_FILE" | awk 'END { print $1 }')"
+  if [ -n "$last" ]; then
+    end="$(devlog_block_end "$DEVLOG_FILE" "$last")"
+    found="$(devlog_round_status "$DEVLOG_FILE" "$last" "$end")"
+    [ -z "$found" ] || status="$found"
+  fi
+fi
+printf 'LAST_STATUS=%s\n' "$status"

package/hooks/scripts/tests/test-await-open.sh

@@ -0,0 +1,112 @@
+#!/usr/bin/env bash
+# Self-check for await-open.sh. Run:
+#   bash hooks/scripts/test-await-open.sh
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+TMP_ROOT="$(mktemp -d)"
+trap 'rm -rf "$TMP_ROOT"' EXIT
+
+export CLAUDE_PROJECT_DIR="$TMP_ROOT"
+DEVLOG_DIR="$TMP_ROOT/.devlog"
+mkdir -p "$DEVLOG_DIR"
+
+FAIL=0
+assert_exit() {
+  local desc="$1" expected="$2" actual="$3"
+  if [ "$actual" -eq "$expected" ]; then
+    echo "PASS: $desc"
+  else
+    echo "FAIL: $desc (expected exit $expected, got $actual)"
+    FAIL=1
+  fi
+}
+assert_contains() {
+  local desc="$1" needle="$2" haystack="$3"
+  case "$haystack" in
+    *"$needle"*) echo "PASS: $desc" ;;
+    *) echo "FAIL: $desc (missing: $needle)"; FAIL=1 ;;
+  esac
+}
+
+# --- 1: not enabled -> NOT_ENABLED, no file --------------------------------
+OUT="$(bash "$SCRIPT_DIR/await-open.sh")"
+assert_exit "not enabled -> exit 1" 1 $?
+assert_contains "reports NOT_ENABLED" "NOT_ENABLED" "$OUT"
+if [ -f "$DEVLOG_DIR/.awaiting-reply" ]; then
+  echo "FAIL: .awaiting-reply should not exist when disabled"
+  FAIL=1
+else
+  echo "PASS: no .awaiting-reply when disabled"
+fi
+
+touch "$DEVLOG_DIR/.enabled"
+
+# --- 2: resolves round from .round-open when present -----------------------
+printf '%s\n' '{"round": 4, "opened_at": "2026-09-09T12:00:00+08:00"}' > "$DEVLOG_DIR/.round-open"
+OUT="$(bash "$SCRIPT_DIR/await-open.sh")"
+assert_exit "opens -> exit 0" 0 $?
+assert_contains "reports OPENED=4" "OPENED=4" "$OUT"
+ROUND_FIELD="$(grep -o '"round"[[:space:]]*:[[:space:]]*[0-9]\+' "$DEVLOG_DIR/.awaiting-reply" | grep -o '[0-9]\+$')"
+if [ "$ROUND_FIELD" = "4" ]; then
+  echo "PASS: .awaiting-reply round=4 (from .round-open)"
+else
+  echo "FAIL: expected round=4, got $ROUND_FIELD"
+  FAIL=1
+fi
+grep -q '"opened_at"' "$DEVLOG_DIR/.awaiting-reply" \
+  && echo "PASS: opened_at field present" || { echo "FAIL: opened_at missing"; FAIL=1; }
+rm -f "$DEVLOG_DIR/.awaiting-reply" "$DEVLOG_DIR/.round-open"
+
+# --- 3: falls back to last ## Round in devlog.md when .round-open absent ---
+cat > "$DEVLOG_DIR/devlog.md" <<'EOF'
+## Round 1 — 2026-09-09T12:00:00+08:00
+
+### Summary
+done
+
+### Reply
+fixture reply.
+
+### Handoff
+#### 現況
+done
+
+### Status
+DONE
+
+## Round 2 — 2026-09-09T13:00:00+08:00
+
+### Summary
+done
+
+### Reply
+fixture reply.
+
+### Handoff
+#### 現況
+done
+
+### Status
+DONE
+EOF
+OUT="$(bash "$SCRIPT_DIR/await-open.sh")"
+assert_contains "falls back to last Round in devlog.md" "OPENED=2" "$OUT"
+rm -f "$DEVLOG_DIR/.awaiting-reply"
+
+# --- 4: already open -> ALREADY_OPEN, does not overwrite --------------------
+printf '%s\n' '{"round": 99, "opened_at": "sentinel"}' > "$DEVLOG_DIR/.awaiting-reply"
+OUT="$(bash "$SCRIPT_DIR/await-open.sh")"
+assert_exit "already open -> exit 1" 1 $?
+assert_contains "reports ALREADY_OPEN" "ALREADY_OPEN" "$OUT"
+grep -q 'sentinel' "$DEVLOG_DIR/.awaiting-reply" \
+  && echo "PASS: existing marker left untouched" || { echo "FAIL: existing marker was overwritten"; FAIL=1; }
+rm -f "$DEVLOG_DIR/.awaiting-reply" "$DEVLOG_DIR/devlog.md"
+
+if [ "$FAIL" -eq 0 ]; then
+  echo "All checks passed."
+  exit 0
+else
+  echo "Some checks FAILED."
+  exit 1
+fi

package/hooks/scripts/tests/test-branch-scoped-integration.sh

@@ -0,0 +1,108 @@
+#!/usr/bin/env bash
+set -uo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+TMP="$(mktemp -d)"
+trap 'rm -rf "$TMP"' EXIT
+FAIL=0
+
+REPO="$TMP/repo"
+mkdir -p "$REPO"
+git -C "$REPO" init -q
+git -C "$REPO" -c user.email=t@t.t -c user.name=t commit -q --allow-empty -m init
+git -C "$REPO" branch -M main
+mkdir -p "$REPO/.devlog"
+: > "$REPO/.devlog/.enabled"
+export CLAUDE_PROJECT_DIR="$REPO"
+
+git -C "$REPO" checkout -q -b fix-issue-123
+
+# --- round-start.sh opens a Round in .round-current.md -------------------
+# Round-current split: the open round lives in the shared, non-branch-scoped
+# .devlog/.round-current.md until Stop merges it — it is NOT written directly
+# into the branch-scoped file (that only happens once the round closes).
+OUT="$(echo '{"prompt":"hello"}' | bash "$SCRIPT_DIR/round-start.sh" 2>&1)"
+BRANCH_FILE="$REPO/.devlog/devlog.fix-issue-123.md"
+ROUND_CURRENT="$REPO/.devlog/.round-current.md"
+if [ -f "$ROUND_CURRENT" ] && grep -q '^## Round 1' "$ROUND_CURRENT" && [ ! -f "$BRANCH_FILE" ] && [ ! -f "$REPO/.devlog/devlog.md" ]; then
+  echo "PASS: round-start.sh opens Round 1 in .round-current.md, not yet in devlog.fix-issue-123.md"
+else
+  echo "FAIL: round-start.sh output=$OUT branch_file_exists=$([ -f "$BRANCH_FILE" ] && echo y || echo n)"
+  FAIL=1
+fi
+
+# --- segment-watch.sh: Read of .round-current.md is allowed ---------------
+INPUT='{"tool_name":"Read","tool_input":{"file_path":".devlog/.round-current.md"}}'
+if echo "$INPUT" | bash "$SCRIPT_DIR/segment-watch.sh" >/dev/null 2>&1; then
+  echo "PASS: segment-watch.sh allows Read of .round-current.md"
+else
+  echo "FAIL: segment-watch.sh denied Read of .round-current.md"
+  FAIL=1
+fi
+
+# --- segment-watch.sh: its own deny message names .round-current.md, not the
+#     branch-scoped file (that's only the merge target, not what's tracked
+#     while the round is still open) -----------------------------------------
+# Force a stale segment-state so the silence-timeout path fires. The stored
+# cksum must MATCH .round-current.md as it is right now: a mismatch means
+# "the devlog just changed", which resets the timer and exits 0 instead of
+# ever reaching the deny message we're trying to assert on.
+SEEN_SUM="$(cksum < "$ROUND_CURRENT" | tr -d '\n')"
+cat > "$REPO/.devlog/.segment-state" <<JSON
+{"last_change_epoch": 1, "last_seen_cksum": "$SEEN_SUM", "max_silent_seconds": 1}
+JSON
+DENY_INPUT='{"tool_name":"Bash","tool_input":{"command":"echo hi"}}'
+DENY_MSG="$(echo "$DENY_INPUT" | bash "$SCRIPT_DIR/segment-watch.sh" 2>&1 1>/dev/null)"
+DENY_RC=0
+echo "$DENY_INPUT" | bash "$SCRIPT_DIR/segment-watch.sh" >/dev/null 2>/dev/null || DENY_RC=$?
+if [ "$DENY_RC" -eq 2 ] && printf '%s' "$DENY_MSG" | grep -q '\.round-current\.md' \
+  && ! printf '%s' "$DENY_MSG" | grep -q 'devlog.fix-issue-123.md'; then
+  echo "PASS: segment-watch.sh deny message names .round-current.md, not the branch-scoped file"
+else
+  echo "FAIL: segment-watch.sh deny message rc=$DENY_RC msg=$DENY_MSG"
+  FAIL=1
+fi
+
+# --- enforce-devlog.sh: Stop hook checks the branch-scoped file's hash ----
+echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" >/dev/null 2>&1
+ENFORCE_RC=$?
+if [ "$ENFORCE_RC" -eq 2 ]; then
+  echo "PASS: enforce-devlog.sh blocks when the branch-scoped file's Round has no Summary/Handoff yet"
+else
+  echo "FAIL: enforce-devlog.sh unexpected rc=$ENFORCE_RC (expected 2, unchanged branch file with only User Input)"
+  FAIL=1
+fi
+
+# --- devlog_resolve_paths: reserved name and CJK fallback (Fix 2 / Fix 3) ---
+. "$SCRIPT_DIR/devlog-path.sh"
+
+ARCHREPO="$TMP/archrepo"
+mkdir -p "$ARCHREPO"
+git -C "$ARCHREPO" init -q
+git -C "$ARCHREPO" -c user.email=t@t.t -c user.name=t commit -q --allow-empty -m init
+git -C "$ARCHREPO" checkout -q -b archive
+devlog_resolve_paths "$ARCHREPO"
+if [ "$DEVLOG_FILE" = "$ARCHREPO/.devlog/devlog.md" ]; then
+  echo "PASS: branch named 'archive' falls back to shared devlog.md, doesn't collide with devlog.archive.md"
+else
+  echo "FAIL: 'archive' branch got $DEVLOG_FILE"
+  FAIL=1
+fi
+
+CJKREPO="$TMP/cjkrepo"
+mkdir -p "$CJKREPO"
+git -C "$CJKREPO" init -q
+git -C "$CJKREPO" -c user.email=t@t.t -c user.name=t commit -q --allow-empty -m init
+git -C "$CJKREPO" checkout -q -b 修復登入問題
+devlog_resolve_paths "$CJKREPO"
+case "$DEVLOG_FILE" in
+  "$CJKREPO"/.devlog/devlog.b-*.md)
+    echo "PASS: all-CJK branch name gets a stable hash-derived file, not shared devlog.md"
+    ;;
+  *)
+    echo "FAIL: CJK branch got $DEVLOG_FILE"
+    FAIL=1
+    ;;
+esac
+
+if [ "$FAIL" -eq 0 ]; then echo "All checks passed."; exit 0
+else echo "Some checks FAILED."; exit 1; fi

package/hooks/scripts/tests/test-checkpoint-set.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+set -uo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+FAIL=0
+TMP="$(mktemp -d)"
+trap 'rm -rf "$TMP"' EXIT
+
+OUT="$(CLAUDE_PROJECT_DIR="$TMP" bash "$SCRIPT_DIR/checkpoint-set.sh" 25)"
+[ "$OUT" = "NOT_STARTED" ] && echo "PASS: not started" || { echo "FAIL: $OUT"; FAIL=1; }
+
+mkdir -p "$TMP/.devlog"
+touch "$TMP/.devlog/.enabled"
+printf '%s\n' '{"rounds_since_checkpoint": 7, "max_silent_rounds": 20, "checkpoint_marker_count": 2}' \
+  > "$TMP/.devlog/.checkpoint-state"
+
+OUT="$(CLAUDE_PROJECT_DIR="$TMP" bash "$SCRIPT_DIR/checkpoint-set.sh" 30)"
+case "$OUT" in *CHECKPOINT_MAX_SILENT_ROUNDS=30*) echo "PASS: set 30" ;; *) echo "FAIL: $OUT"; FAIL=1 ;; esac
+grep -q '"rounds_since_checkpoint": 7' "$TMP/.devlog/.checkpoint-state" \
+  && echo "PASS: rounds preserved" || { echo "FAIL: rounds reset"; FAIL=1; }
+grep -q '"checkpoint_marker_count": 2' "$TMP/.devlog/.checkpoint-state" \
+  && echo "PASS: markers preserved" || { echo "FAIL: markers reset"; FAIL=1; }
+grep -q '"max_silent_rounds": 30' "$TMP/.devlog/.checkpoint-state" \
+  && echo "PASS: max written" || { echo "FAIL: max"; FAIL=1; }
+
+CLAUDE_PROJECT_DIR="$TMP" bash "$SCRIPT_DIR/checkpoint-set.sh" 0 >/dev/null 2>&1
+[ $? -eq 1 ] && echo "PASS: reject 0" || { echo "FAIL: accepted 0"; FAIL=1; }
+
+# create when missing
+rm -f "$TMP/.devlog/.checkpoint-state"
+OUT="$(CLAUDE_PROJECT_DIR="$TMP" bash "$SCRIPT_DIR/checkpoint-set.sh" 15)"
+case "$OUT" in *CHECKPOINT_MAX_SILENT_ROUNDS=15*) echo "PASS: create 15" ;; *) echo "FAIL: create $OUT"; FAIL=1 ;; esac
+grep -q '"rounds_since_checkpoint": 0' "$TMP/.devlog/.checkpoint-state" \
+  && echo "PASS: create rounds 0" || { echo "FAIL: create rounds"; FAIL=1; }
+
+if [ "$FAIL" -eq 0 ]; then echo "All checks passed."; exit 0
+else echo "Some checks FAILED."; exit 1; fi