devlog-tracker 0.22.0

package/hooks/scripts/tests/test-clean-devlog.sh

@@ -0,0 +1,160 @@
+#!/usr/bin/env bash
+set -uo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+. "$SCRIPT_DIR/devlog-md.sh"
+TMP="$(mktemp -d)"
+trap 'rm -rf "$TMP"' EXIT
+FAIL=0
+assert_eq() {
+  local d="$1" e="$2" a="$3"
+  if [ "$e" = "$a" ]; then echo "PASS: $d"; else echo "FAIL: $d expected [$e] got [$a]"; FAIL=1; fi
+}
+perm_of() {
+  stat -f '%Lp' "$1" 2>/dev/null || stat -c '%a' "$1" 2>/dev/null
+}
+make_round() {
+  local file="$1" n="$2" status="$3"
+  cat >> "$file" <<EOF
+## Round $n — 2026-09-09T12:00:00+08:00
+
+### Status
+$status
+EOF
+}
+
+# no --confirmed -> exit 1, nothing changes, no stdout
+NOFLAG="$TMP/noflag"
+mkdir -p "$NOFLAG/.devlog"
+export CLAUDE_PROJECT_DIR="$NOFLAG"
+printf '# project\n\n' > "$NOFLAG/.devlog/devlog.md"
+make_round "$NOFLAG/.devlog/devlog.md" 1 DONE
+OUT="$(bash "$SCRIPT_DIR/clean-devlog.sh" 2>/dev/null)"
+assert_eq "no --confirmed: exit 1" 1 "$?"
+assert_eq "no --confirmed: empty stdout" "" "$OUT"
+grep -q '^## Round 1' "$NOFLAG/.devlog/devlog.md" && echo "PASS: no --confirmed leaves devlog.md untouched" || { echo "FAIL: devlog.md changed without --confirmed"; FAIL=1; }
+
+# missing devlog.md -> exit 1, nothing created, no stdout
+MISSING="$TMP/missing"
+mkdir -p "$MISSING/.devlog"
+export CLAUDE_PROJECT_DIR="$MISSING"
+OUT="$(bash "$SCRIPT_DIR/clean-devlog.sh" --confirmed 2>/dev/null)"
+assert_eq "missing log exit 1" 1 "$?"
+assert_eq "missing log: empty stdout" "" "$OUT"
+[ ! -e "$MISSING/.devlog/devlog.md" ] || { echo "FAIL: devlog.md created for missing case"; FAIL=1; }
+
+# .round-open names a Round that isn't in the file -> refuse, don't touch anything
+STALEOPEN="$TMP/staleopen"
+mkdir -p "$STALEOPEN/.devlog"
+export CLAUDE_PROJECT_DIR="$STALEOPEN"
+printf '# project\n\n' > "$STALEOPEN/.devlog/devlog.md"
+make_round "$STALEOPEN/.devlog/devlog.md" 1 DONE
+make_round "$STALEOPEN/.devlog/devlog.md" 2 DONE
+printf '%s\n' '{"round": 7, "opened_at": "now"}' > "$STALEOPEN/.devlog/.round-open"
+OUT="$(bash "$SCRIPT_DIR/clean-devlog.sh" --confirmed 2>/dev/null)"
+assert_eq "stale round-open: exit 1" 1 "$?"
+assert_eq "stale round-open: empty stdout" "" "$OUT"
+[ -f "$STALEOPEN/.devlog/devlog.md" ] && grep -q '^## Round 1' "$STALEOPEN/.devlog/devlog.md" && echo "PASS: stale round-open leaves devlog.md untouched" || { echo "FAIL: stale round-open touched devlog.md"; FAIL=1; }
+grep -q '"round": 7' "$STALEOPEN/.devlog/.round-open" && echo "PASS: stale round-open file untouched" || { echo "FAIL: round-open file changed"; FAIL=1; }
+
+# .round-open has an unparseable round while a real open Round exists -> refuse, don't touch anything
+BADOPEN="$TMP/badopen"
+mkdir -p "$BADOPEN/.devlog"
+export CLAUDE_PROJECT_DIR="$BADOPEN"
+printf '# project\n\n' > "$BADOPEN/.devlog/devlog.md"
+make_round "$BADOPEN/.devlog/devlog.md" 1 IN_PROGRESS
+printf '%s\n' '{"round": "abc", "opened_at": "now"}' > "$BADOPEN/.devlog/.round-open"
+OUT="$(bash "$SCRIPT_DIR/clean-devlog.sh" --confirmed 2>/dev/null)"
+assert_eq "unparseable round-open: exit 1" 1 "$?"
+assert_eq "unparseable round-open: empty stdout" "" "$OUT"
+grep -q '^## Round 1' "$BADOPEN/.devlog/devlog.md" && echo "PASS: unparseable round-open leaves the real open round in place" || { echo "FAIL: unparseable round-open deleted the open round"; FAIL=1; }
+
+# open round: everything else discarded, this round renumbered to 1, body preserved verbatim
+# (including a fenced fake heading, to prove the rename only touches the real heading line)
+OPEN="$TMP/open"
+mkdir -p "$OPEN/.devlog"
+export CLAUDE_PROJECT_DIR="$OPEN"
+printf '# project summary\n\nsome durable notes\n\n' > "$OPEN/.devlog/devlog.md"
+make_round "$OPEN/.devlog/devlog.md" 1 DONE
+make_round "$OPEN/.devlog/devlog.md" 2 DONE
+{
+  printf '## Round 3 — 2026-09-09T12:00:00+08:00\n\n'
+  printf '### User Input\n```text\nplease do not touch this fake heading:\n## Round 1 fake\n## Round 99 — fake heading\n```\n\n'
+  printf '### Status\nIN_PROGRESS\n'
+} > "$OPEN/.devlog/.round-current.md"
+printf '%s\n' '{"round": 3, "opened_at": "now"}' > "$OPEN/.devlog/.round-open"
+printf '%s\n' '{"round": 2, "ticks": 1, "max_silent_ticks": 5}' > "$OPEN/.devlog/.span-open"
+printf '%s\n' '{"rounds_since_checkpoint": 19, "max_silent_rounds": 20, "checkpoint_marker_count": 2}' > "$OPEN/.devlog/.checkpoint-state"
+: > "$OPEN/.devlog/.interrupted"
+: > "$OPEN/.devlog/.awaiting-reply"
+OUT="$(bash "$SCRIPT_DIR/clean-devlog.sh" --confirmed)"
+assert_eq "open round: exit 0" 0 "$?"
+assert_eq "open round: stdout" "CLEANED KEPT_ROUND=1" "$OUT"
+# Round-current split invariant: the surviving round lands in
+# .round-current.md (renumbered to Round 1), and devlog.md is emptied/gone
+# — never the other way around (that would leave .round-open pointing at a
+# round Stop/close-open-round.sh can no longer find).
+[ ! -s "$OPEN/.devlog/devlog.md" ] && echo "PASS: devlog.md emptied/absent (project summary + old rounds discarded)" || { echo "FAIL: devlog.md still has content"; FAIL=1; }
+grep -q '^## Round 1 ' "$OPEN/.devlog/.round-current.md" && echo "PASS: open round renumbered to 1" || { echo "FAIL: renumber"; FAIL=1; }
+grep -q '^## Round 2 ' "$OPEN/.devlog/.round-current.md" && { echo "FAIL: old round 2 survived"; FAIL=1; } || echo "PASS: old rounds gone"
+[ "$(devlog_list_round_starts "$OPEN/.devlog/.round-current.md" | wc -l | tr -d ' ')" = "1" ] && echo "PASS: exactly one real heading remains (fence-aware count)" || { echo "FAIL: heading count"; FAIL=1; }
+grep -q '^please do not touch this fake heading:$' "$OPEN/.devlog/.round-current.md" && echo "PASS: fenced body preserved verbatim" || { echo "FAIL: fenced body altered"; FAIL=1; }
+grep -q '^## Round 1 fake$' "$OPEN/.devlog/.round-current.md" && echo "PASS: fenced fake heading untouched" || { echo "FAIL: fenced fake heading renamed"; FAIL=1; }
+grep -q '^## Round 99 — fake heading$' "$OPEN/.devlog/.round-current.md" && echo "PASS: second fenced fake heading untouched" || { echo "FAIL: second fenced fake heading renamed"; FAIL=1; }
+[ -s "$OPEN/.devlog/.round-current.md" ] && echo "PASS: .round-current.md holds the renumbered round" || { echo "FAIL: .round-current.md empty/missing"; FAIL=1; }
+grep -q '"round": 1' "$OPEN/.devlog/.round-open" && echo "PASS: round-open reset to 1" || { echo "FAIL: round-open"; FAIL=1; }
+[ ! -e "$OPEN/.devlog/.span-open" ] && echo "PASS: span-open removed" || { echo "FAIL: span-open remains"; FAIL=1; }
+[ ! -e "$OPEN/.devlog/.interrupted" ] && echo "PASS: interrupted removed" || { echo "FAIL: interrupted remains"; FAIL=1; }
+[ ! -e "$OPEN/.devlog/.awaiting-reply" ] && echo "PASS: awaiting-reply removed" || { echo "FAIL: awaiting-reply remains"; FAIL=1; }
+grep -q '"rounds_since_checkpoint": 0' "$OPEN/.devlog/.checkpoint-state" && echo "PASS: checkpoint rounds reset" || { echo "FAIL: checkpoint rounds"; FAIL=1; }
+grep -q '"checkpoint_marker_count": 0' "$OPEN/.devlog/.checkpoint-state" && echo "PASS: checkpoint marker count reset" || { echo "FAIL: checkpoint marker count"; FAIL=1; }
+grep -q '"max_silent_rounds": 20' "$OPEN/.devlog/.checkpoint-state" && echo "PASS: checkpoint max kept" || { echo "FAIL: checkpoint max"; FAIL=1; }
+PERM="$(perm_of "$OPEN/.devlog/.round-current.md")"
+[ "$PERM" != "600" ] && echo "PASS: rewritten .round-current.md is not owner-only (mode $PERM)" || { echo "FAIL: rewritten .round-current.md is 600"; FAIL=1; }
+
+# no open round (never started / paused): whole file deleted
+NOOPEN="$TMP/noopen"
+mkdir -p "$NOOPEN/.devlog"
+export CLAUDE_PROJECT_DIR="$NOOPEN"
+printf '# project summary\n\n' > "$NOOPEN/.devlog/devlog.md"
+make_round "$NOOPEN/.devlog/devlog.md" 1 DONE
+make_round "$NOOPEN/.devlog/devlog.md" 2 DONE
+printf '%s\n' '{"rounds_since_checkpoint": 5, "max_silent_rounds": 20, "checkpoint_marker_count": 1}' > "$NOOPEN/.devlog/.checkpoint-state"
+printf '%s\n' '# archive' > "$NOOPEN/.devlog/devlog.archive.md"
+printf '%s\n' '# kept' > "$NOOPEN/.devlog/devlog.span-mode.md"
+printf '%s\n' 'enabled' > "$NOOPEN/.devlog/.enabled"
+OUT="$(bash "$SCRIPT_DIR/clean-devlog.sh" --confirmed)"
+assert_eq "no open round: exit 0" 0 "$?"
+assert_eq "no open round: stdout" "CLEANED KEPT_ROUND=0" "$OUT"
+[ ! -e "$NOOPEN/.devlog/devlog.md" ] && echo "PASS: devlog.md deleted" || { echo "FAIL: devlog.md remains"; FAIL=1; }
+grep -q '"rounds_since_checkpoint": 0' "$NOOPEN/.devlog/.checkpoint-state" && echo "PASS: checkpoint rounds reset (no-open)" || { echo "FAIL: checkpoint rounds (no-open)"; FAIL=1; }
+grep -q '"checkpoint_marker_count": 0' "$NOOPEN/.devlog/.checkpoint-state" && echo "PASS: checkpoint marker count reset (no-open)" || { echo "FAIL: checkpoint marker count (no-open)"; FAIL=1; }
+grep -q '^# archive' "$NOOPEN/.devlog/devlog.archive.md" && echo "PASS: archive.md untouched (no-open)" || { echo "FAIL: archive.md touched (no-open)"; FAIL=1; }
+grep -q '^# kept' "$NOOPEN/.devlog/devlog.span-mode.md" && echo "PASS: named keep file untouched (no-open)" || { echo "FAIL: named keep file touched (no-open)"; FAIL=1; }
+[ -f "$NOOPEN/.devlog/.enabled" ] && echo "PASS: .enabled untouched (no-open)" || { echo "FAIL: .enabled removed (no-open)"; FAIL=1; }
+
+# does not touch archive.md or named keep files (open-round branch)
+SIB="$TMP/siblings"
+mkdir -p "$SIB/.devlog"
+export CLAUDE_PROJECT_DIR="$SIB"
+printf '%s\n' '# archive' > "$SIB/.devlog/devlog.archive.md"
+printf '%s\n' '# kept' > "$SIB/.devlog/devlog.span-mode.md"
+printf '# project\n\n' > "$SIB/.devlog/devlog.md"
+make_round "$SIB/.devlog/.round-current.md" 1 DONE
+printf '%s\n' '{"round": 1, "opened_at": "now"}' > "$SIB/.devlog/.round-open"
+bash "$SCRIPT_DIR/clean-devlog.sh" --confirmed >/dev/null
+grep -q '^# archive' "$SIB/.devlog/devlog.archive.md" && echo "PASS: archive.md untouched" || { echo "FAIL: archive.md touched"; FAIL=1; }
+grep -q '^# kept' "$SIB/.devlog/devlog.span-mode.md" && echo "PASS: named keep file untouched" || { echo "FAIL: named keep file touched"; FAIL=1; }
+
+# .enabled is never touched either way
+ENAB="$TMP/enabled"
+mkdir -p "$ENAB/.devlog"
+export CLAUDE_PROJECT_DIR="$ENAB"
+printf '%s\n' 'enabled' > "$ENAB/.devlog/.enabled"
+printf '# project\n\n' > "$ENAB/.devlog/devlog.md"
+make_round "$ENAB/.devlog/.round-current.md" 1 IN_PROGRESS
+printf '%s\n' '{"round": 1, "opened_at": "now"}' > "$ENAB/.devlog/.round-open"
+bash "$SCRIPT_DIR/clean-devlog.sh" --confirmed >/dev/null
+[ -f "$ENAB/.devlog/.enabled" ] && echo "PASS: .enabled untouched" || { echo "FAIL: .enabled removed"; FAIL=1; }
+
+if [ "$FAIL" -eq 0 ]; then echo "All checks passed."; exit 0
+else echo "Some checks FAILED."; exit 1; fi

package/hooks/scripts/tests/test-cli-init-e2e.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+set -uo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+TMP="$(mktemp -d)"
+trap 'rm -rf "$TMP"' EXIT
+FAIL=0
+
+command -v node >/dev/null 2>&1 || { echo "SKIP: node not installed"; exit 0; }
+
+PROJECT="$TMP/project"
+mkdir -p "$PROJECT"
+
+cd "$PROJECT" || exit 1
+NODE_BIN="$(command -v node)"
+"$NODE_BIN" "$REPO_ROOT/bin/devlog-tracker.js" init --codex --cursor >/dev/null 2>"$TMP/stderr" \
+  || { echo "FAIL: init exited non-zero"; cat "$TMP/stderr"; FAIL=1; }
+
+[ -f "$PROJECT/.devlog-tracker/VERSION" ] && echo "PASS: vendored VERSION exists" || { echo "FAIL: no VERSION"; FAIL=1; }
+[ -f "$PROJECT/.devlog-tracker/env.sh" ] && echo "PASS: vendored env.sh exists" || { echo "FAIL: no env.sh"; FAIL=1; }
+[ -f "$PROJECT/.codex/hooks.json" ] && echo "PASS: .codex/hooks.json written" || { echo "FAIL: no .codex/hooks.json"; FAIL=1; }
+[ -f "$PROJECT/.cursor/hooks.json" ] && echo "PASS: .cursor/hooks.json written" || { echo "FAIL: no .cursor/hooks.json"; FAIL=1; }
+
+# re-running must not duplicate entries
+COUNT_BEFORE=$(node -e "console.log(JSON.parse(require('fs').readFileSync('$PROJECT/.codex/hooks.json')).hooks.Stop.length)")
+"$NODE_BIN" "$REPO_ROOT/bin/devlog-tracker.js" init --codex --cursor >/dev/null 2>"$TMP/stderr" \
+  || { echo "FAIL: second init exited non-zero"; cat "$TMP/stderr"; FAIL=1; }
+COUNT_AFTER=$(node -e "console.log(JSON.parse(require('fs').readFileSync('$PROJECT/.codex/hooks.json')).hooks.Stop.length)")
+if [ "$COUNT_BEFORE" = "$COUNT_AFTER" ]; then
+  echo "PASS: re-running init does not duplicate hook entries"
+else
+  echo "FAIL: hook entries duplicated ($COUNT_BEFORE -> $COUNT_AFTER)"; FAIL=1
+fi
+
+if [ "$FAIL" -eq 0 ]; then echo "All checks passed."; exit 0
+else echo "Some checks FAILED."; exit 1
+fi

package/hooks/scripts/tests/test-close-open-round.sh

@@ -0,0 +1,325 @@
+#!/usr/bin/env bash
+# Self-check for close-open-round.sh. Run:
+#   bash hooks/scripts/test-close-open-round.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"
+touch "$DEVLOG_DIR/.enabled"
+
+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
+}
+assert_not_contains() {
+  local desc="$1" needle="$2" haystack="$3"
+  case "$haystack" in
+    *"$needle"*) echo "FAIL: $desc (unexpected: $needle)"; FAIL=1 ;;
+    *) echo "PASS: $desc" ;;
+  esac
+}
+assert_file_absent() {
+  local desc="$1" path="$2"
+  if [ -f "$path" ]; then
+    echo "FAIL: $desc (file still present: $path)"
+    FAIL=1
+  else
+    echo "PASS: $desc"
+  fi
+}
+
+write_skeleton() {
+  : > "$DEVLOG_DIR/devlog.md"
+  cat > "$DEVLOG_DIR/.round-current.md" <<'EOF'
+## Round 1 — 2026-09-09T12:00:00+08:00
+
+### User Input
+```text
+hello
+```
+
+### Status
+IN_PROGRESS
+EOF
+  printf '%s\n' '{"round": 1, "opened_at": "2026-09-09T12:00:00+08:00"}' > "$DEVLOG_DIR/.round-open"
+}
+
+# --- 1: no .enabled -> no-op, .round-current.md untouched -------------------
+rm -f "$DEVLOG_DIR/.enabled"
+write_skeleton
+BEFORE="$(cat "$DEVLOG_DIR/.round-current.md")"
+bash "$SCRIPT_DIR/close-open-round.sh" "dangling:next_prompt"
+assert_exit "no .enabled -> exit 0" 0 $?
+AFTER="$(cat "$DEVLOG_DIR/.round-current.md")"
+if [ "$BEFORE" = "$AFTER" ]; then
+  echo "PASS: no .enabled -> .round-current.md unchanged"
+else
+  echo "FAIL: no .enabled should not edit .round-current.md"
+  FAIL=1
+fi
+touch "$DEVLOG_DIR/.enabled"
+
+# --- 2: matching skeleton, never touched (not recovered) -> INTERRUPTED +
+#        "no record left" stub wording, merged into devlog.md, markers gone -
+write_skeleton
+touch "$DEVLOG_DIR/.interrupted"
+bash "$SCRIPT_DIR/close-open-round.sh" "StopFailure:server_error"
+assert_exit "matching open round -> exit 0" 0 $?
+assert_file_absent "stamp: .round-current.md removed after merge" "$DEVLOG_DIR/.round-current.md"
+BODY="$(cat "$DEVLOG_DIR/devlog.md")"
+assert_contains "status INTERRUPTED" $'### Status\nINTERRUPTED' "$BODY"
+assert_contains "reason line" "StopFailure:server_error" "$BODY"
+assert_contains "summary stub (not recovered)" "devlog.md 沒有留下任何後續處理紀錄就結束了" "$BODY"
+assert_contains "handoff stub heading" "#### 現況" "$BODY"
+assert_contains "handoff stub body (not recovered)" "這一輪沒有留下任何處理紀錄" "$BODY"
+assert_contains "user input kept" "hello" "$BODY"
+
+# --- 2b: skeleton + a segment was recorded (recovered) but Summary/Handoff
+#         still missing -> INTERRUPTED + the old "interrupted mid-way" stub --
+write_skeleton
+cksum < "$DEVLOG_DIR/devlog.md" > "$DEVLOG_DIR/.turn-start"
+printf '\n### 段落 1 - 12:01\n```text\nsome progress\n```\n\n' >> "$DEVLOG_DIR/devlog.md"
+bash "$SCRIPT_DIR/close-open-round.sh" "user_interrupt"
+BODY="$(cat "$DEVLOG_DIR/devlog.md")"
+assert_contains "recovered summary stub" "這輪意外中斷。" "$BODY"
+assert_contains "recovered handoff stub" "這輪沒有正常收尾。" "$BODY"
+assert_contains "recovered segment kept" "some progress" "$BODY"
+if [ -f "$DEVLOG_DIR/.round-open" ] || [ -f "$DEVLOG_DIR/.interrupted" ]; then
+  echo "FAIL: markers should be deleted after a successful stamp"
+  FAIL=1
+else
+  echo "PASS: .round-open and .interrupted deleted"
+fi
+
+# --- 3: already has headings -> do not duplicate stubs, still stamp+merge ---
+: > "$DEVLOG_DIR/devlog.md"
+cat > "$DEVLOG_DIR/.round-current.md" <<'EOF'
+## Round 1 — 2026-09-09T12:00:00+08:00
+
+### User Input
+```text
+hello
+```
+
+### Summary
+partial
+
+### Reply
+fixture reply.
+
+### Handoff
+#### 現況
+partial
+
+### Status
+IN_PROGRESS
+EOF
+printf '%s\n' '{"round": 1, "opened_at": "2026-09-09T12:00:00+08:00"}' > "$DEVLOG_DIR/.round-open"
+rm -f "$DEVLOG_DIR/.turn-start"
+bash "$SCRIPT_DIR/close-open-round.sh" "user_interrupt"
+assert_file_absent "existing-headings: .round-current.md removed after merge" "$DEVLOG_DIR/.round-current.md"
+BODY="$(cat "$DEVLOG_DIR/devlog.md")"
+assert_contains "kept existing summary" "partial" "$BODY"
+COUNT="$(printf '%s\n' "$BODY" | grep -c '^### Summary' || true)"
+if [ "$COUNT" = "1" ]; then
+  echo "PASS: did not add a second ### Summary"
+else
+  echo "FAIL: expected one ### Summary, got $COUNT"
+  FAIL=1
+fi
+assert_contains "stamped interrupt" "INTERRUPTED" "$BODY"
+assert_contains "user_interrupt reason" "user_interrupt" "$BODY"
+
+# --- 4: no .round-open -> delete .interrupted, do not touch either file -----
+write_skeleton
+rm -f "$DEVLOG_DIR/.round-open"
+touch "$DEVLOG_DIR/.interrupted"
+BEFORE_CUR="$(cat "$DEVLOG_DIR/.round-current.md")"
+BEFORE_MAIN="$(cat "$DEVLOG_DIR/devlog.md")"
+bash "$SCRIPT_DIR/close-open-round.sh" "SessionEnd:other"
+AFTER_CUR="$(cat "$DEVLOG_DIR/.round-current.md")"
+AFTER_MAIN="$(cat "$DEVLOG_DIR/devlog.md")"
+if [ "$BEFORE_CUR" = "$AFTER_CUR" ] && [ "$BEFORE_MAIN" = "$AFTER_MAIN" ]; then
+  echo "PASS: missing .round-open -> nothing merged or edited"
+else
+  echo "FAIL: missing .round-open touched a file"
+  FAIL=1
+fi
+if [ -f "$DEVLOG_DIR/.interrupted" ]; then
+  echo "FAIL: missing .round-open should still delete .interrupted"
+  FAIL=1
+else
+  echo "PASS: missing .round-open deleted .interrupted"
+fi
+rm -f "$DEVLOG_DIR/.round-current.md"
+
+# --- 4b: malformed .round-open -> delete both markers, do not touch either --
+write_skeleton
+printf '%s\n' 'not valid json' > "$DEVLOG_DIR/.round-open"
+touch "$DEVLOG_DIR/.interrupted"
+BEFORE_CUR="$(cat "$DEVLOG_DIR/.round-current.md")"
+BEFORE_MAIN="$(cat "$DEVLOG_DIR/devlog.md")"
+bash "$SCRIPT_DIR/close-open-round.sh" "SessionEnd:other"
+AFTER_CUR="$(cat "$DEVLOG_DIR/.round-current.md")"
+AFTER_MAIN="$(cat "$DEVLOG_DIR/devlog.md")"
+if [ "$BEFORE_CUR" = "$AFTER_CUR" ] && [ "$BEFORE_MAIN" = "$AFTER_MAIN" ]; then
+  echo "PASS: malformed .round-open -> nothing merged or edited"
+else
+  echo "FAIL: malformed .round-open touched a file"
+  FAIL=1
+fi
+if [ -f "$DEVLOG_DIR/.interrupted" ] || [ -f "$DEVLOG_DIR/.round-open" ]; then
+  echo "FAIL: malformed .round-open should delete both markers"
+  FAIL=1
+else
+  echo "PASS: malformed .round-open deleted both markers"
+fi
+rm -f "$DEVLOG_DIR/.round-current.md"
+
+# --- 5: prior finished history in devlog.md is preserved across the merge --
+cat > "$DEVLOG_DIR/devlog.md" <<'EOF'
+## Round 1 — 2026-09-09T11:00:00+08:00
+
+### Summary
+old
+
+### Reply
+fixture reply.
+
+### Handoff
+#### 現況
+old
+
+### Status
+DONE
+
+## Checkpoint（Round 1 摘要）
+keep me
+EOF
+cat > "$DEVLOG_DIR/.round-current.md" <<'EOF'
+## Round 2 — 2026-09-09T12:00:00+08:00
+
+### User Input
+```text
+new
+```
+
+### Status
+IN_PROGRESS
+EOF
+printf '%s\n' '{"round": 2, "opened_at": "2026-09-09T12:00:00+08:00"}' > "$DEVLOG_DIR/.round-open"
+bash "$SCRIPT_DIR/close-open-round.sh" "SessionEnd:clear"
+assert_file_absent "prior-history: .round-current.md removed after merge" "$DEVLOG_DIR/.round-current.md"
+BODY="$(cat "$DEVLOG_DIR/devlog.md")"
+assert_contains "round 1 stays DONE" $'### Status\nDONE' "$BODY"
+assert_contains "round 2 interrupted" "INTERRUPTED" "$BODY"
+assert_contains "checkpoint kept" "keep me" "$BODY"
+
+# --- 6: headings present but hash equal -> still stamp (no recovery proof) --
+# (main's independent "completed last Round + hash moved -> do not stamp"
+# fixture, which asserted devlog.md stayed byte-for-byte unchanged, tested a
+# pre-merge assumption this branch deliberately changes: a recovered round
+# now always gets merged into devlog.md rather than left in place untouched.
+# That property is covered below by scenario 8 ("recovered case also
+# merges"), which asserts the merge instead of asserting no-op.)
+: > "$DEVLOG_DIR/devlog.md"
+cat > "$DEVLOG_DIR/.round-current.md" <<'EOF'
+## Round 1 — 2026-09-09T12:00:00+08:00
+
+### User Input
+```text
+hello
+```
+
+### Summary
+partial
+
+### Reply
+fixture reply.
+
+### Handoff
+#### 現況
+partial
+
+### Status
+IN_PROGRESS
+EOF
+printf '%s\n' '{"round": 1, "opened_at": "2026-09-09T12:00:00+08:00"}' > "$DEVLOG_DIR/.round-open"
+cksum < "$DEVLOG_DIR/.round-current.md" > "$DEVLOG_DIR/.turn-start"
+bash "$SCRIPT_DIR/close-open-round.sh" "user_interrupt"
+assert_file_absent "hash-equal: .round-current.md removed after merge" "$DEVLOG_DIR/.round-current.md"
+BODY="$(cat "$DEVLOG_DIR/devlog.md")"
+assert_contains "hash-equal headings still stamp" "INTERRUPTED" "$BODY"
+assert_contains "hash-equal reason" "user_interrupt" "$BODY"
+
+# --- 7: stamp-then-merge, prior round in devlog.md preserved ---------------
+STAMP_DIR="$(mktemp -d)"
+export CLAUDE_PROJECT_DIR="$STAMP_DIR"
+mkdir -p "$STAMP_DIR/.devlog"
+touch "$STAMP_DIR/.devlog/.enabled"
+printf '## Round 7 — 2026-09-17T09:00:00+0800\n\n### User Input\n```text\ndo X\n```\n\n### Status\nIN_PROGRESS\n' > "$STAMP_DIR/.devlog/devlog.md"
+printf '## Round 8 — 2026-09-17T09:30:00+0800\n\n### User Input\n```text\ndo Y\n```\n\n### Status\nIN_PROGRESS\n' > "$STAMP_DIR/.devlog/.round-current.md"
+printf '{"round": 8}\n' > "$STAMP_DIR/.devlog/.round-open"
+cksum < "$STAMP_DIR/.devlog/.round-current.md" > "$STAMP_DIR/.devlog/.turn-start"
+
+bash "$SCRIPT_DIR/close-open-round.sh" "test_reason"
+
+assert_file_absent "stamp: .round-current.md removed after merge" "$STAMP_DIR/.devlog/.round-current.md"
+MAIN_AFTER="$(cat "$STAMP_DIR/.devlog/devlog.md")"
+assert_contains "stamp: round 7 (prior history) still present" "## Round 7" "$MAIN_AFTER"
+assert_contains "stamp: round 8 merged into devlog.md" "## Round 8" "$MAIN_AFTER"
+assert_contains "stamp: INTERRUPTED status merged in" "INTERRUPTED" "$MAIN_AFTER"
+assert_contains "stamp: reason tag merged in" "[reason: test_reason]" "$MAIN_AFTER"
+rm -rf "$STAMP_DIR"
+export CLAUDE_PROJECT_DIR="$TMP_ROOT"
+
+# --- 8: recovered case also merges (Claude finished before the signal) -----
+REC_DIR="$(mktemp -d)"
+export CLAUDE_PROJECT_DIR="$REC_DIR"
+mkdir -p "$REC_DIR/.devlog"
+touch "$REC_DIR/.devlog/.enabled"
+: > "$REC_DIR/.devlog/devlog.md"
+printf '## Round 1 — 2026-09-17T09:00:00+0800\n\n### User Input\n```text\ndo X\n```\n\n### Summary\n完成了\n\n### Handoff\n#### 現況\n收尾\n\n### Status\nDONE\n' > "$REC_DIR/.devlog/.round-current.md"
+printf '{"round": 1}\n' > "$REC_DIR/.devlog/.round-open"
+echo "stale-hash-that-does-not-match" > "$REC_DIR/.devlog/.turn-start"
+
+bash "$SCRIPT_DIR/close-open-round.sh" "user_interrupt"
+
+assert_file_absent "recovered: .round-current.md removed after merge" "$REC_DIR/.devlog/.round-current.md"
+MAIN_AFTER="$(cat "$REC_DIR/.devlog/devlog.md")"
+assert_contains "recovered: finished round merged into devlog.md" "完成了" "$MAIN_AFTER"
+assert_not_contains "recovered: no INTERRUPTED stamped over real content" "INTERRUPTED" "$MAIN_AFTER"
+if [ -f "$REC_DIR/.devlog/.round-open" ]; then
+  echo "FAIL: recovered case should still delete .round-open"
+  FAIL=1
+else
+  echo "PASS: recovered case deleted .round-open"
+fi
+rm -rf "$REC_DIR"
+export CLAUDE_PROJECT_DIR="$TMP_ROOT"
+
+if [ "$FAIL" -eq 0 ]; then
+  echo "All checks passed."
+  exit 0
+else
+  echo "Some checks FAILED."
+  exit 1
+fi

package/hooks/scripts/tests/test-compact-devlog.sh

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+set -uo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+TMP="$(mktemp -d)"
+trap 'rm -rf "$TMP"' EXIT
+export CLAUDE_PROJECT_DIR="$TMP"
+mkdir -p "$TMP/.devlog"
+FAIL=0
+assert_eq() {
+  local d="$1" e="$2" a="$3"
+  if [ "$e" = "$a" ]; then echo "PASS: $d"; else echo "FAIL: $d expected [$e] got [$a]"; FAIL=1; fi
+}
+
+bash "$SCRIPT_DIR/compact-devlog.sh" >/dev/null
+assert_eq "missing log exit 1" "1" "$?"
+
+round() {
+  local n="$1" st="$2"
+  cat >> "$TMP/.devlog/devlog.md" <<EOF
+## Round ${n} — 2026-09-09T12:00:00+08:00
+
+### Summary
+s${n}
+
+### Reply
+fixture reply.
+
+### Handoff
+#### 現況
+h${n}
+
+### Status
+${st}
+EOF
+}
+
+: > "$TMP/.devlog/devlog.md"
+printf '%s\n\n' '# preamble' >> "$TMP/.devlog/devlog.md"
+n=1
+while [ "$n" -le 8 ]; do round "$n" DONE; n=$((n+1)); done
+round 9 IN_PROGRESS
+cat >> "$TMP/.devlog/devlog.md" <<'EOF'
+## Checkpoint（Round 1-3 摘要）
+cp body
+EOF
+
+OUT="$(bash "$SCRIPT_DIR/compact-devlog.sh")"
+assert_eq "compact exit 0" "0" "$?"
+echo "$OUT" | grep -q 'MOVED=3' && echo "PASS: moved 1-3" || { echo "FAIL: $OUT"; FAIL=1; }
+grep -q '# preamble' "$TMP/.devlog/devlog.md" && echo "PASS: preamble stays" || { echo "FAIL: preamble"; FAIL=1; }
+grep -q '## Checkpoint' "$TMP/.devlog/devlog.md" && echo "PASS: checkpoint stays" || { echo "FAIL: cp"; FAIL=1; }
+grep -q '## Round 9' "$TMP/.devlog/devlog.md" && echo "PASS: in-progress stays" || { echo "FAIL: r9"; FAIL=1; }
+grep -q '## Round 4' "$TMP/.devlog/devlog.md" && echo "PASS: last-5 keep 4" || { echo "FAIL: r4"; FAIL=1; }
+grep -q '## Round 1' "$TMP/.devlog/devlog.archive.md" && echo "PASS: archive has 1" || { echo "FAIL: archive"; FAIL=1; }
+grep -q '## Round 9' "$TMP/.devlog/devlog.archive.md" && { echo "FAIL: archived in-progress"; FAIL=1; } || echo "PASS: did not archive 9"
+test -f "$TMP/.devlog/devlog.foo.md" && { echo "FAIL: touched keep file"; FAIL=1; } || echo "PASS: no keep file"
+
+OUT2="$(bash "$SCRIPT_DIR/compact-devlog.sh")"
+echo "$OUT2" | grep -q 'MOVED=0' && echo "PASS: second compact moves 0" || { echo "FAIL: $OUT2"; FAIL=1; }
+
+if [ "$FAIL" -eq 0 ]; then echo "All checks passed."; exit 0
+else echo "Some checks FAILED."; exit 1; fi

package/hooks/scripts/tests/test-devlog-lock.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+set -uo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+. "$SCRIPT_DIR/devlog-lock.sh"
+TMP="$(mktemp -d)"
+trap 'rm -rf "$TMP"' EXIT
+DEVLOG_DIR="$TMP/.devlog"
+mkdir -p "$DEVLOG_DIR"
+FAIL=0
+
+devlog_lock_acquire
+[ "${LOCK_HELD:-0}" -eq 1 ] && [ -d "$DEVLOG_DIR/.lock" ] \
+  && echo "PASS: acquired" || { echo "FAIL: acquire"; FAIL=1; }
+mkdir "$DEVLOG_DIR/.lock" >/dev/null 2>&1
+[ "$?" -ne 0 ] && echo "PASS: second mkdir excluded" || { echo "FAIL: duplicate mkdir"; FAIL=1; }
+devlog_lock_release
+devlog_lock_acquire
+[ "${LOCK_HELD:-0}" -eq 1 ] && echo "PASS: reacquired after release" || { echo "FAIL: reacquire"; FAIL=1; }
+devlog_lock_release
+
+mkdir "$DEVLOG_DIR/.lock"
+START="$(date +%s)"
+devlog_lock_acquire
+END="$(date +%s)"
+ELAPSED=$((END - START))
+[ "${LOCK_HELD:-0}" -eq 0 ] && [ "$ELAPSED" -ge 2 ] && [ "$ELAPSED" -le 3 ] \
+  && echo "PASS: contention fails open" || { echo "FAIL: contention held=$LOCK_HELD elapsed=$ELAPSED"; FAIL=1; }
+rmdir "$DEVLOG_DIR/.lock"
+
+MIN_PATH="$TMP/min-path"
+mkdir "$MIN_PATH"
+ln -s "$(command -v bash)" "$MIN_PATH/bash"
+HELD="$(PATH="$MIN_PATH" bash -c '. "$1"; DEVLOG_DIR="$2"; devlog_lock_acquire; echo "${LOCK_HELD:-0}"' _ "$SCRIPT_DIR/devlog-lock.sh" "$DEVLOG_DIR")"
+[ "$HELD" = "0" ] && echo "PASS: missing lock tools fails open" || { echo "FAIL: restricted path held=$HELD"; FAIL=1; }
+
+if [ "$FAIL" -eq 0 ]; then echo "All checks passed."; exit 0
+else echo "Some checks FAILED."; exit 1; fi