devlog-tracker 0.33.5 → 0.34.0

package/core/scripts/tests/test-enforce-devlog-handoff-order.sh

@@ -1,6 +1,7 @@
 #!/usr/bin/env bash
-# Self-check for enforce-devlog.sh's Handoff subsection order/duplicate
-# check (Phase 2, docs/design/devlog-as-ssot-assessment.md). No framework —
+# Self-check for enforce-devlog.sh's Handoff format gate: XML tag order／
+# duplicate／unknown-tag checks and legacy-format blocking
+# (docs/design/handoff-xml.md). No framework —
 # plain assert-and-exit, matching this repo's existing style.
 set -uo pipefail
 
@@ -14,11 +15,10 @@ mkdir -p "$DEVLOG_DIR"
 touch "$DEVLOG_DIR/.enabled"
 
 # A real (if minimal) git repo, only so the "full canonical order" fixture's
-# #### 檔案 + #### 工作區 pair below can carry a #### 工作區 that actually
-# matches live git — DONE rounds with a non-empty #### 檔案 are now
-# machine-verified too (enforce-devlog.sh's workspace check, extended past
-# Phase 1's IN_PROGRESS/BLOCKED). Every other fixture in this file keeps
-# Status DONE with no #### 檔案, so it stays decoupled from this check.
+# <files> + <workspace> pair below can carry a <workspace> that actually
+# matches live git — DONE rounds with a non-empty <files> are
+# machine-verified too. Every other fixture in this file keeps Status DONE
+# with no <files>, so it stays decoupled from this check.
 git -C "$TMP_ROOT" init -q -b main
 git -C "$TMP_ROOT" config user.email test@example.com
 git -C "$TMP_ROOT" config user.name test
@@ -55,7 +55,7 @@ assert_round_merged() {
 }
 
 write_round() {
-  # $1 = Handoff body (already includes #### subsection lines). Status DONE
+  # $1 = Handoff body (already includes the <handoff> block). Status DONE
   # throughout so this suite is decoupled from Phase 1's 工作區/下一步 checks.
   # Writes into .round-current.md — the file enforce-devlog.sh now validates
   # (round-start.sh already opened a skeleton there; this overwrites it).
@@ -78,40 +78,56 @@ write_round() {
 
 # --- full canonical order -> allowed -----------------------------------------
 bash "$SCRIPT_DIR/round-start.sh" < /dev/null
-write_round "#### 決策
+write_round "<handoff>
+<decisions>
 d
-#### 檔案
+</decisions>
+<files>
 尚未 commit：
-#### 工作區
+</files>
+<workspace>
 main @ ${HASH}，工作樹乾淨
-#### 現況
+</workspace>
+<state>
 c
-#### 完成條件
+</state>
+<done-when>
 observable done.
-#### 下一步
-n"
+</done-when>
+<next>
+n
+</next>
+</handoff>"
 echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" >/dev/null 2>&1
 assert_exit "full canonical order -> allowed" 0 $?
 assert_round_merged "full canonical order"
 
 # --- subset in order -> allowed -----------------------------------------------
 bash "$SCRIPT_DIR/round-start.sh" < /dev/null
-write_round "#### 決策
+write_round "<handoff>
+<decisions>
 d
-#### 現況
-c"
+</decisions>
+<state>
+c
+</state>
+</handoff>"
 echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" >/dev/null 2>&1
 assert_exit "subset in canonical order -> allowed" 0 $?
 assert_round_merged "subset in canonical order"
 
 # --- reordered -> blocked -------------------------------------------------------
 bash "$SCRIPT_DIR/round-start.sh" < /dev/null
-write_round "#### 現況
+write_round "<handoff>
+<state>
 c
-#### 決策
-d"
+</state>
+<decisions>
+d
+</decisions>
+</handoff>"
 MSG="$(echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" 2>&1)"
-assert_exit "現況 before 決策 -> blocked" 2 $?
+assert_exit "state before decisions -> blocked" 2 $?
 case "$MSG" in
   *"順序錯了"*) echo "PASS: order-violation message" ;;
   *) echo "FAIL: expected 順序錯了 message, got: $MSG"; FAIL=1 ;;
@@ -119,32 +135,44 @@ esac
 
 # --- duplicate -> blocked -------------------------------------------------------
 bash "$SCRIPT_DIR/round-start.sh" < /dev/null
-write_round "#### 現況
+write_round "<handoff>
+<state>
 c1
-#### 現況
-c2"
+</state>
+<state>
+c2
+</state>
+</handoff>"
 MSG="$(echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" 2>&1)"
-assert_exit "duplicate 現況 -> blocked" 2 $?
+assert_exit "duplicate state -> blocked" 2 $?
 case "$MSG" in
-  *"出現超過一次"*) echo "PASS: duplicate-subsection message" ;;
+  *"出現超過一次"*) echo "PASS: duplicate-tag message" ;;
   *) echo "FAIL: expected 出現超過一次 message, got: $MSG"; FAIL=1 ;;
 esac
 
-# --- unrecognized heading interleaved -> ignored, allowed ------------------------
+# --- unknown tag -> blocked (spec rule 6: no silently ignored subsections) ---
 bash "$SCRIPT_DIR/round-start.sh" < /dev/null
-write_round "#### 決策
+write_round "<handoff>
+<decisions>
 d
-#### 其他備註
+</decisions>
+<notes>
 x
-#### 現況
-c"
-echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" >/dev/null 2>&1
-assert_exit "unrecognized #### heading interleaved -> ignored, allowed" 0 $?
-assert_round_merged "unrecognized #### heading interleaved"
+</notes>
+</handoff>"
+MSG="$(echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" 2>&1)"
+assert_exit "unknown tag -> blocked" 2 $?
+case "$MSG" in
+  *"不認得的標籤"*) echo "PASS: unknown-tag message" ;;
+  *) echo "FAIL: expected 不認得的標籤 message, got: $MSG"; FAIL=1 ;;
+esac
 
-# --- fenced example reordering subsection headings -> ignored, allowed -----
+# --- fenced legacy example inside a field -> plain content, allowed --------
+# XML fields don't track fences; a ``` block quoting old #### headings is
+# just text in <decisions>.
 bash "$SCRIPT_DIR/round-start.sh" < /dev/null
-write_round "#### 決策
+write_round "<handoff>
+<decisions>
 說明格式時可以貼一段範例：
 \`\`\`markdown
 #### 現況
@@ -153,67 +181,107 @@ c
 d
 \`\`\`
 真正決定
-#### 現況
-c"
+</decisions>
+<state>
+c
+</state>
+</handoff>"
 echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" >/dev/null 2>&1
-assert_exit "fenced example reordering subsection headings -> ignored, allowed" 0 $?
-assert_round_merged "fenced example reordering subsection headings"
+assert_exit "fenced #### example inside <decisions> -> allowed" 0 $?
+assert_round_merged "fenced #### example inside <decisions>"
 
-# --- fenced example duplicating a heading already used -> ignored, allowed -
-bash "$SCRIPT_DIR/round-start.sh" < /dev/null
-write_round "#### 決策
-真正決策
-說明格式時再貼一次範例：
-\`\`\`markdown
-#### 決策
-d2
-\`\`\`
-#### 現況
-c"
-echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" >/dev/null 2>&1
-assert_exit "fenced example duplicating a used heading -> ignored, allowed" 0 $?
-assert_round_merged "fenced example duplicating a used heading"
-
-# --- unterminated fence inside #### 決策 -> fail-open, not a false block
-# (final-review Fix 1). A ``` fence that never closes (odd fence-marker
-# count) must never make a present #### 現況 register as missing/malformed.
-# Status DONE so 下一步/工作區 (Phase 1) stay out of the picture — this only
-# exercises section_body()/ORDER_ERR's own fence handling.
+# --- unterminated fence inside a field -> fail-open, allowed ----------------
 bash "$SCRIPT_DIR/round-start.sh" < /dev/null
-write_round "#### 決策
+write_round "<handoff>
+<decisions>
 一段沒收尾的範例：
 \`\`\`markdown
-沒收尾內容，一路吃到 Handoff 結尾
-#### 現況
-c"
+沒收尾內容
+</decisions>
+<state>
+c
+</state>
+</handoff>"
 echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" >/dev/null 2>&1
-assert_exit "unterminated fence in 決策, real 現況 after it -> fail-open, allowed" 0 $?
-assert_round_merged "unterminated fence in 決策, real 現況 after it"
-
-# --- same unterminated fence, but hiding a real duplicate below it --------
-# ORDER_ERR re-scans the extracted Handoff body with its own fence tracking;
-# pre-fix the same stuck-fence bug hid every #### heading after the broken
-# fence from ORDER_ERR too — including a genuine duplicate "#### 決策" that
-# should be rejected. NOFENCE degrades ORDER_ERR back to a plain scan for
-# this round, so the duplicate check reaches it again. (This is the mirror
-# image of the false-block case above: here the pre-fix bug wrongly *allowed*
-# something; the point is the same root cause, fixed the same way.)
+assert_exit "unterminated fence in <decisions> -> allowed" 0 $?
+assert_round_merged "unterminated fence in <decisions>"
+
+# --- unterminated fence does not hide a real duplicate tag -------------------
 bash "$SCRIPT_DIR/round-start.sh" < /dev/null
-write_round "#### 決策
+write_round "<handoff>
+<decisions>
 一段沒收尾的範例：
 \`\`\`markdown
 沒收尾內容
-#### 現況
+</decisions>
+<state>
 c
-#### 決策
-d2（應該被判定為重複）"
+</state>
+<decisions>
+d2（應該被判定為重複）
+</decisions>
+</handoff>"
 MSG="$(echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" 2>&1)"
 assert_exit "unterminated fence no longer hides a real duplicate -> blocked" 2 $?
 case "$MSG" in
-  *"出現超過一次"*) echo "PASS: duplicate-subsection message despite unterminated fence" ;;
+  *"出現超過一次"*) echo "PASS: duplicate-tag message despite unterminated fence" ;;
   *) echo "FAIL: expected 出現超過一次 message, got: $MSG"; FAIL=1 ;;
 esac
 
+# --- XML gate (docs/design/handoff-xml.md) ---
+write_handoff_round() {  # $1 = Handoff body lines (already formatted)
+  {
+    echo "## Round 1 — 2026-09-26T00:00:00+08:00"
+    echo ""
+    echo "### Summary"; echo "s"; echo ""
+    echo "### Reply"; echo "r"; echo ""
+    echo "### Handoff"
+    printf '%s\n' "$1"
+    echo ""
+    echo "### Status"; echo "DONE"
+  } > "$DEVLOG_DIR/.round-current.md"
+}
+
+bash "$SCRIPT_DIR/round-start.sh" < /dev/null
+write_handoff_round '#### 現況
+legacy'
+MSG="$(echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" 2>&1)"
+assert_exit "legacy Handoff blocked" 2 $?
+case "$MSG" in
+  *"migrate-handoff.sh"*"<handoff>"*"npx devlog-tracker init"*) echo "PASS: legacy message has migrate, template, init hint" ;;
+  *) echo "FAIL: legacy message: $MSG"; FAIL=1 ;;
+esac
+
+bash "$SCRIPT_DIR/round-start.sh" < /dev/null
+write_handoff_round '<handoff>
+<state>
+ok
+</state>
+</handoff>'
+echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" >/dev/null 2>&1
+assert_exit "XML Handoff DONE passes" 0 $?
+
+bash "$SCRIPT_DIR/round-start.sh" < /dev/null
+write_handoff_round '<handoff>
+<next>
+x
+</next>
+<state>
+y
+</state>
+</handoff>'
+MSG="$(echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" 2>&1)"
+assert_exit "XML order violation blocked" 2 $?
+case "$MSG" in *"順序"*"### Handoff"*"<handoff>"*) echo "PASS: order message + template" ;; *) echo "FAIL: order msg: $MSG"; FAIL=1 ;; esac
+
+bash "$SCRIPT_DIR/round-start.sh" < /dev/null
+write_handoff_round '<handoff>
+<state>
+y
+</state>'
+echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" >/dev/null 2>&1
+assert_exit "unclosed handoff blocked" 2 $?
+
 if [ "$FAIL" -eq 0 ]; then
   echo "All checks passed."
   exit 0

package/core/scripts/tests/test-enforce-devlog-session-handoff.sh

@@ -4,6 +4,8 @@
 set -uo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+# shellcheck source=lib/xml-fixture.sh
+. "$SCRIPT_DIR/tests/lib/xml-fixture.sh"
 TMP_ROOT="$(mktemp -d)"
 trap 'rm -rf "$TMP_ROOT"' EXIT
 
@@ -79,6 +81,7 @@ write_unfinished() {
     echo "### Status"
     echo "$status"
   } > "$DEVLOG_DIR/.round-current.md"
+  xml_fixture "$DEVLOG_DIR/.round-current.md"
 }
 
 # 1) IN_PROGRESS without Session Handoff -> blocked
@@ -87,8 +90,8 @@ write_unfinished IN_PROGRESS ""
 MSG="$(echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" 2>&1)"
 assert_exit "IN_PROGRESS without Session Handoff -> blocked" 2 $?
 case "$MSG" in
-  *"Session Handoff"*) echo "PASS: message mentions Session Handoff" ;;
-  *) echo "FAIL: expected Session Handoff in message, got: $MSG"; FAIL=1 ;;
+  *"<session-handoff>"*) echo "PASS: message shows <session-handoff> template" ;;
+  *) echo "FAIL: expected <session-handoff> in message, got: $MSG"; FAIL=1 ;;
 esac
 
 # 2) IN_PROGRESS with Session Handoff -> write handoff.md
@@ -97,7 +100,7 @@ write_unfinished IN_PROGRESS "$SESSION_OK"
 echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" >/dev/null 2>&1
 assert_exit "IN_PROGRESS with Session Handoff -> allowed" 0 $?
 if [ -f "$DEVLOG_DIR/handoff.md" ] && grep -q 'pick route A' "$DEVLOG_DIR/handoff.md" \
-  && grep -q '^## Session Handoff' "$DEVLOG_DIR/handoff.md"; then
+  && grep -q '^<session-handoff>$' "$DEVLOG_DIR/handoff.md"; then
   echo "PASS: handoff.md written from Session Handoff"
 else
   echo "FAIL: handoff.md missing or wrong"; FAIL=1
@@ -144,6 +147,7 @@ bash "$SCRIPT_DIR/round-start.sh" < /dev/null
   echo "### Status"
   echo "DONE"
 } > "$DEVLOG_DIR/.round-current.md"
+xml_fixture "$DEVLOG_DIR/.round-current.md"
 echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" >/dev/null 2>&1
 assert_exit "DONE -> allowed" 0 $?
 if [ ! -f "$DEVLOG_DIR/handoff.md" ]; then
@@ -152,27 +156,104 @@ else
   echo "FAIL: handoff.md survived DONE"; FAIL=1
 fi
 
-# 5) wrong order -> blocked; existing handoff unchanged
+# 5) wrong order -> blocked; existing handoff unchanged. Written as XML by
+# hand: the converter skips a Session Handoff in the wrong order, so a legacy
+# fixture would be stopped by the legacy gate instead of the order check.
 echo "keep-me" > "$DEVLOG_DIR/handoff.md"
 bash "$SCRIPT_DIR/round-start.sh" < /dev/null
 write_unfinished IN_PROGRESS "
 ### Session Handoff
-
-#### 待解問題
+<session-handoff>
+<open-questions>
 - x
-
-#### 決策
+</open-questions>
+<decisions>
 - y
-
-#### 失敗嘗試
+</decisions>
+<failed-attempts>
 - z
+</failed-attempts>
+</session-handoff>
 "
-echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" >/dev/null 2>&1
+MSG="$(echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" 2>&1)"
 assert_exit "wrong Session Handoff order -> blocked" 2 $?
+case "$MSG" in
+  *"順序"*) echo "PASS: wrong order message mentions 順序" ;;
+  *) echo "FAIL: expected 順序 in message, got: $MSG"; FAIL=1 ;;
+esac
 if [ -f "$DEVLOG_DIR/handoff.md" ] && grep -q 'keep-me' "$DEVLOG_DIR/handoff.md"; then
   echo "PASS: handoff.md unchanged on validation failure"
 else
   echo "FAIL: handoff.md should be untouched on validation failure"; FAIL=1
 fi
 
+# 6) legacy Session Handoff under an XML Handoff -> blocked with migrate hint
+bash "$SCRIPT_DIR/round-start.sh" < /dev/null
+write_unfinished IN_PROGRESS "$SESSION_OK"
+xml_fixture "$DEVLOG_DIR/.round-current.md"
+# re-inject a legacy Session Handoff after conversion
+awk '/^### Session Handoff/{skip=1; print "### Session Handoff\n#### 決策\n- x\n#### 待解問題\n- y\n#### 失敗嘗試\n- z\n"; next} skip && /^### /{skip=0} !skip' \
+  "$DEVLOG_DIR/.round-current.md" > "$DEVLOG_DIR/.rc" && mv "$DEVLOG_DIR/.rc" "$DEVLOG_DIR/.round-current.md"
+MSG="$(echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" 2>&1)"
+assert_exit "legacy Session Handoff blocked" 2 $?
+case "$MSG" in *"migrate-handoff.sh"*) echo "PASS: legacy session message" ;; *) echo "FAIL: $MSG"; FAIL=1 ;; esac
+
+# 7) DONE round quoting a fenced ### Session Handoff example in its Reply, no
+# real Session Handoff -> allowed (presence check must ignore fences)
+bash "$SCRIPT_DIR/round-start.sh" < /dev/null
+cat > "$DEVLOG_DIR/.round-current.md" <<'EOF2'
+## Round 1 — 2026-09-22T02:00:00+08:00
+
+### Summary
+done
+
+### Reply
+範例格式：
+```markdown
+### Session Handoff
+<session-handoff>
+<decisions>
+- x
+</decisions>
+</session-handoff>
+```
+
+### Handoff
+<handoff>
+<state>
+finished
+</state>
+</handoff>
+
+### Status
+DONE
+EOF2
+MSG="$(echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" 2>&1)"
+assert_exit "DONE with fenced Session Handoff example -> allowed" 0 $?
+[ -n "$MSG" ] && echo "note: stderr was: $MSG"
+
+# 8) IN_PROGRESS with only a look-alike heading (### Session Handoff（補充）)
+# -> blocked as missing: the writer only accepts the exact heading
+bash "$SCRIPT_DIR/round-start.sh" < /dev/null
+write_unfinished IN_PROGRESS "
+### Session Handoff（補充）
+<session-handoff>
+<decisions>
+- x
+</decisions>
+<open-questions>
+- y
+</open-questions>
+<failed-attempts>
+- z
+</failed-attempts>
+</session-handoff>
+"
+MSG="$(echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" 2>&1)"
+assert_exit "look-alike Session Handoff heading -> blocked" 2 $?
+case "$MSG" in
+  *"缺少 ### Session Handoff"*) echo "PASS: look-alike heading reported as missing" ;;
+  *) echo "FAIL: expected missing Session Handoff message, got: $MSG"; FAIL=1 ;;
+esac
+
 [ "$FAIL" -eq 0 ] && exit 0 || exit 1

package/core/scripts/tests/test-enforce-devlog-workspace.sh

@@ -1,11 +1,13 @@
 #!/usr/bin/env bash
-# Self-check for enforce-devlog.sh's #### 工作區 machine-verify (Phase 1,
+# Self-check for enforce-devlog.sh's <workspace> machine-verify (Phase 1,
 # docs/design/devlog-as-ssot-assessment.md). Separate file from
 # test-enforce-devlog.sh to avoid growing that suite further; still
 # auto-discovered by run-tests.sh's tests/test-*.sh glob.
 set -uo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+# shellcheck source=lib/xml-fixture.sh
+. "$SCRIPT_DIR/tests/lib/xml-fixture.sh"
 TMP_ROOT="$(mktemp -d)"
 trap 'rm -rf "$TMP_ROOT"' EXIT
 
@@ -89,6 +91,7 @@ write_round() {
     echo "### Status"
     echo "IN_PROGRESS"
   } > "$DEVLOG_DIR/.round-current.md"
+xml_fixture "$DEVLOG_DIR/.round-current.md"
 }
 
 # --- exact match -> allowed --------------------------------------------------
@@ -150,6 +153,7 @@ bash "$SCRIPT_DIR/round-start.sh" < /dev/null
   echo "### Status"
   echo "BLOCKED"
 } > "$DEVLOG_DIR/.round-current.md"
+xml_fixture "$DEVLOG_DIR/.round-current.md"
 echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" >/dev/null 2>&1
 assert_exit "BLOCKED with missing workspace -> blocked" 2 $?
 
@@ -171,12 +175,15 @@ bash "$SCRIPT_DIR/round-start.sh" < /dev/null
   echo "### Status"
   echo "DONE"
 } > "$DEVLOG_DIR/.round-current.md"
+xml_fixture "$DEVLOG_DIR/.round-current.md"
 echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" >/dev/null 2>&1
 assert_exit "DONE with no workspace section -> allowed (check does not apply)" 0 $?
 assert_round_merged "DONE with no workspace section"
 
-# --- fenced example quoting #### 工作區 before the real section -> ignored,
-# extractor still finds the real (unfenced) 工作區 body -------------------
+# --- fenced example quoting a legacy `#### 工作區` inside <decisions> before
+# the real <workspace> -> the quoted text stays plain content of <decisions>
+# after xml_fixture, and the workspace check still reads the real <workspace>
+# body -------------------------------------------------------------------
 bash "$SCRIPT_DIR/round-start.sh" < /dev/null
 {
   echo "## Round 4 — 2026-09-10T00:15:00+08:00"
@@ -219,17 +226,15 @@ bash "$SCRIPT_DIR/round-start.sh" < /dev/null
   echo "### Status"
   echo "IN_PROGRESS"
 } > "$DEVLOG_DIR/.round-current.md"
+xml_fixture "$DEVLOG_DIR/.round-current.md"
 echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" >/dev/null 2>&1
 assert_exit "fenced example quoting #### 工作區 before the real section -> allowed" 0 $?
 assert_round_merged "fenced example quoting #### 工作區 before the real section"
 
-# --- unterminated fence in an earlier subsection -> fail-open, not a false
-# block (final-review Fix 1). A ``` fence that never closes (odd fence-marker
-# count) must never make a present, filled-in #### 下一步 register as missing.
-# Pre-fix, the odd fence opened by #### 現況's (malformed) example got
-# `fence` stuck at 1 for the rest of the round, so handoff_subsection_body()
-# could no longer even find the "#### 下一步" heading — even though #### 工作區
-# above it is exactly correct and #### 下一步 below it has real content.
+# --- unterminated fence in an earlier field -> not a false block. A ```
+# fence that never closes must never make a present, filled-in <next>
+# register as missing: XML fields don't track fences at all. Written as XML
+# directly — the legacy converter leaves odd-fence rounds untouched.
 bash "$SCRIPT_DIR/round-start.sh" < /dev/null
 {
   echo "## Round 5 — 2026-09-10T00:20:00+08:00"
@@ -241,28 +246,36 @@ bash "$SCRIPT_DIR/round-start.sh" < /dev/null
   echo "fixture reply."
   echo ""
   echo "### Handoff"
-  echo "#### 工作區"
+  echo "<handoff>"
+  echo "<workspace>"
   echo "main @ ${HASH}，工作樹乾淨"
-  echo "#### 現況"
+  echo "</workspace>"
+  echo "<state>"
   echo "一段沒收尾的範例："
   echo '```markdown'
   echo "沒收尾內容，一路吃到這個 Round 結尾"
-  echo "#### 完成條件"
+  echo "</state>"
+  echo "<done-when>"
   echo "observable done via test."
-  echo "#### 下一步"
+  echo "</done-when>"
+  echo "<next>"
   echo "edit hooks/scripts/enforce-devlog.sh"
+  echo "</next>"
+  echo "</handoff>"
   echo ""
   echo ""
   echo "### Session Handoff"
-  echo ""
-  echo "#### 決策"
+  echo "<session-handoff>"
+  echo "<decisions>"
   echo "- （無）"
-  echo ""
-  echo "#### 待解問題"
+  echo "</decisions>"
+  echo "<open-questions>"
   echo "- fixture open"
-  echo ""
-  echo "#### 失敗嘗試"
+  echo "</open-questions>"
+  echo "<failed-attempts>"
   echo "- （無）"
+  echo "</failed-attempts>"
+  echo "</session-handoff>"
   echo ""
   echo "### Status"
   echo "IN_PROGRESS"
@@ -271,17 +284,17 @@ echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" >/dev/null 2>&1
 assert_exit "unterminated fence in 現況 -> fail-open, 下一步 still recognized" 0 $?
 assert_round_merged "unterminated fence in 現況"
 
-# --- DONE with a non-empty #### 檔案 (claims files were touched/committed)
+# --- DONE with a non-empty <files> (claims files were touched/committed)
 # IS now checked: a DONE round that reports file changes but has no/wrong
-# #### 工作區 is exactly the "已 commit 完成" false-claim case
+# <workspace> is exactly the "已 commit 完成" false-claim case
 # devlog-as-ssot-assessment.md flags as uncaught — machine-verify it the
 # same way IN_PROGRESS/BLOCKED already are. A trivial DONE round with no
-# #### 檔案 stays exempt (previous test above), matching SKILL.md's
+# <files> stays exempt (previous test above), matching SKILL.md's
 # "瑣碎輪只留現況一句（沒有工作區）" convention untouched.
 #
-# The #### 檔案 body below is just "尚未 commit：" with no claimed paths —
-# this suite only cares about triggering the 工作區 check via a non-empty
-# #### 檔案, not about 檔案 content itself (that's
+# The <files> body below is just "尚未 commit：" with no claimed paths —
+# this suite only cares about triggering the <workspace> check via a non-empty
+# <files>, not about <files> content itself (that's
 # test-enforce-devlog-files.sh's job, Phase 4). Any grammar-valid,
 # always-passing body works here. ------------------------------------------
 bash "$SCRIPT_DIR/round-start.sh" < /dev/null
@@ -303,6 +316,7 @@ bash "$SCRIPT_DIR/round-start.sh" < /dev/null
   echo "### Status"
   echo "DONE"
 } > "$DEVLOG_DIR/.round-current.md"
+xml_fixture "$DEVLOG_DIR/.round-current.md"
 MSG_DONE="$(echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" 2>&1)"
 assert_exit "DONE with #### 檔案 but no #### 工作區 -> blocked" 2 $?
 case "$MSG_DONE" in
@@ -331,6 +345,7 @@ bash "$SCRIPT_DIR/round-start.sh" < /dev/null
   echo "### Status"
   echo "DONE"
 } > "$DEVLOG_DIR/.round-current.md"
+xml_fixture "$DEVLOG_DIR/.round-current.md"
 echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" >/dev/null 2>&1
 assert_exit "DONE with #### 檔案 and stale 工作區 hash -> blocked" 2 $?
 
@@ -355,6 +370,7 @@ bash "$SCRIPT_DIR/round-start.sh" < /dev/null
   echo "### Status"
   echo "DONE"
 } > "$DEVLOG_DIR/.round-current.md"
+xml_fixture "$DEVLOG_DIR/.round-current.md"
 echo '{}' | bash "$SCRIPT_DIR/enforce-devlog.sh" >/dev/null 2>&1
 assert_exit "DONE with #### 檔案 and matching 工作區 -> allowed" 0 $?
 assert_round_merged "DONE with #### 檔案 and matching 工作區"