devlog-tracker 1.0.0 → 1.1.1

package/core/scripts/round-start.sh

@@ -29,12 +29,7 @@ HOOKS_DIR="$(cd "${_src%/*}" && pwd)"
 PROJECT_DIR="${DEVLOG_PROJECT_DIR:-${CLAUDE_PROJECT_DIR:-.}}"
 [ -f "$PROJECT_DIR/.devlog/.enabled" ] || exit 0
 devlog_resolve_paths "$PROJECT_DIR"
-ROUND_CURRENT="$DEVLOG_DIR/.round-current.md"
-SPAN_FILE="$DEVLOG_DIR/.span-open"
 CHECKPOINT_FILE="$DEVLOG_DIR/.checkpoint-state"
-SEGMENT_FILE="$DEVLOG_DIR/.segment-state"
-ROUND_OPEN="$DEVLOG_DIR/.round-open"
-AWAITING_FILE="$DEVLOG_DIR/.awaiting-reply"
 ADVISORY_FILE="$DEVLOG_DIR/.lessons-advisory-state"
 
 devlog_lock_acquire
@@ -59,11 +54,9 @@ if [ -f "$AWAITING_FILE" ]; then
   case "$AWAIT_ROUND" in
     ''|*[!0-9]*) AWAIT_ROUND='' ;;
   esac
-  if [ -n "$AWAIT_ROUND" ] && [ -f "$DEVLOG_FILE" ]; then
-    CURRENT_LAST="$(devlog_list_round_starts "$DEVLOG_FILE" | awk 'END { print $2 }')"
-    if [ "$CURRENT_LAST" = "$AWAIT_ROUND" ]; then
-      FOLD_ROUND="$AWAIT_ROUND"
-    fi
+  if [ -n "$AWAIT_ROUND" ] && [ -f "$DEVLOG_FILE" ] \
+    && [ -n "$(devlog_fold_round_start "$DEVLOG_FILE" "$AWAIT_ROUND" "$DEVLOG_PLATFORM")" ]; then
+    FOLD_ROUND="$AWAIT_ROUND"
   fi
 fi
 
@@ -155,7 +148,7 @@ if [ "$SPAN_SKIP" -eq 1 ]; then
 fi
 
 if [ "$TASK_NOTIF" -eq 1 ] && [ -z "$FOLD_ROUND" ] && [ "$SPAN_SKIP" -eq 0 ] && [ -f "$DEVLOG_FILE" ]; then
-  TASK_NOTIF_LAST="$(devlog_list_round_starts "$DEVLOG_FILE" | awk 'END { print $2 }')"
+  TASK_NOTIF_LAST="$(devlog_list_round_starts_of "$DEVLOG_FILE" "$DEVLOG_PLATFORM" | awk 'END { print $2 }')"
   case "$TASK_NOTIF_LAST" in
     ''|*[!0-9]*) : ;;
     *)
@@ -165,18 +158,17 @@ if [ "$TASK_NOTIF" -eq 1 ] && [ -z "$FOLD_ROUND" ] && [ "$SPAN_SKIP" -eq 0 ] &&
   esac
 fi
 
-MISMATCH_FILE="$DEVLOG_DIR/.workspace-mismatch"
 rm -f "$MISMATCH_FILE" 2>/dev/null || true
 if [ "$SPAN_SKIP" -eq 0 ] && [ "$TASK_NOTIF" -eq 0 ] && [ -f "$DEVLOG_FILE" ]; then
-  CLAIM_ST="$(workspace_claim_state "$PROJECT_DIR" "$DEVLOG_FILE" 2>/dev/null || echo NO_CLAIM)"
+  CLAIM_ST="$(workspace_claim_state "$PROJECT_DIR" "$DEVLOG_FILE" "$DEVLOG_PLATFORM" 2>/dev/null || echo NO_CLAIM)"
   if [ "$CLAIM_ST" = "MISMATCH" ]; then
-    LAST_START="$(devlog_list_round_starts "$DEVLOG_FILE" | awk 'END { print $1 }')"
+    LAST_START="$(devlog_list_round_starts_of "$DEVLOG_FILE" "$DEVLOG_PLATFORM" | awk 'END { print $1 }')"
     LAST_END="$(devlog_block_end "$DEVLOG_FILE" "$LAST_START")"
     CLAIMED_WS="$(devlog_round_workspace_body "$DEVLOG_FILE" "$LAST_START" "$LAST_END")"
     LIVE_WS="$(workspace_snapshot "$PROJECT_DIR")"
     if [ -n "$LIVE_WS" ]; then
       printf '%s\n' "$LIVE_WS" > "$MISMATCH_FILE" 2>/dev/null || true
-      printf '%s\n' "上一輪 Handoff 的工作區（\`<workspace>\`；舊格式是 \`#### 工作區\`）跟目前 git 不符。先在這一輪追加 ### 段落，寫宣稱 vs 實際（實際用下面「實際」逐字內容），再依實際工作樹行動，不要照上一輪「現況／下一步」的字面。"
+      printf '%s\n' "上一輪 Handoff 的工作區（\`<workspace>\`；舊格式是 \`#### 工作區\`）跟目前 git 不符。先在這一輪追加 ### 段落，寫宣稱 vs 實際（實際用下面「實際」逐字內容），再依實際工作樹行動，不要照上一輪「現況／下一步」的字面。（若同一工作樹還有其他平台在跑，差異可能來自它。）"
       printf '\n宣稱：\n%s\n\n實際：\n%s\n' "$CLAIMED_WS" "$LIVE_WS"
 
       if [ -f "$DEVLOG_DIR/.lessons-enabled" ]; then
@@ -188,7 +180,7 @@ if [ "$SPAN_SKIP" -eq 0 ] && [ "$TASK_NOTIF" -eq 0 ] && [ -f "$DEVLOG_FILE" ]; t
 fi
 
 if [ "$SPAN_SKIP" -eq 0 ] && [ "$TASK_NOTIF" -eq 0 ] && [ -f "$DEVLOG_FILE" ] && [ -f "$DEVLOG_DIR/.lessons-enabled" ]; then
-  BLOCKED_ROUND_STARTS="$(devlog_list_round_starts "$DEVLOG_FILE")"
+  BLOCKED_ROUND_STARTS="$(devlog_list_round_starts_of "$DEVLOG_FILE" "$DEVLOG_PLATFORM")"
   BLOCKED_ROUND_COUNT="$(printf '%s\n' "$BLOCKED_ROUND_STARTS" | grep -c '.' || true)"
   BLOCKED_LAST_LINE="$(printf '%s\n' "$BLOCKED_ROUND_STARTS" | awk 'END { print }')"
   BLOCKED_LAST_START="$(printf '%s\n' "$BLOCKED_LAST_LINE" | awk '{ print $1 }')"
@@ -214,7 +206,7 @@ if [ "$SPAN_SKIP" -eq 0 ] && [ "$TASK_NOTIF" -eq 0 ] && [ -f "$DEVLOG_FILE" ] &&
 fi
 
 if [ -n "$FOLD_ROUND" ]; then
-  devlog_reopen_last_round "$DEVLOG_FILE" "$ROUND_CURRENT" || : > "$ROUND_CURRENT"
+  devlog_reopen_round "$DEVLOG_FILE" "$ROUND_CURRENT" "$FOLD_ROUND" "$DEVLOG_PLATFORM" || : > "$ROUND_CURRENT"
   if [ -z "$PROMPT" ]; then
     PROMPT="（無 prompt）"
   fi
@@ -251,6 +243,7 @@ if [ -n "$FOLD_ROUND" ]; then
   fi
 
   printf '{"round": %s, "opened_at": "%s", "file": "%s"}\n' "$FOLD_ROUND" "$FULL_TS" "${DEVLOG_FILE##*/}" > "$ROUND_OPEN" 2>/dev/null || true
+  [ "$DEVLOG_PLATFORM" = claude ] || printf '這一輪寫在 .devlog/%s。\n' "${ROUND_CURRENT##*/}"
 elif [ "$SPAN_SKIP" -eq 0 ]; then
   if [ -z "$PROMPT" ]; then
     PROMPT="（無 prompt）"
@@ -285,11 +278,20 @@ elif [ "$SPAN_SKIP" -eq 0 ]; then
     ' "$DEVLOG_FILE" 2>/dev/null || echo 0)"
     case "$LAST_N" in ''|*[!0-9]*) LAST_N=0 ;; esac
   fi
+  # Another platform's still-open round already owns its number
+  # (docs/design/multi-platform-concurrency.md "Round numbering").
+  RESERVED_N="$(devlog_open_rounds | awk -F '\t' -v f="${DEVLOG_FILE##*/}" '
+    ($3 == f || $3 == "") && $2 ~ /^[0-9]+$/ && $2 + 0 > m { m = $2 + 0 }
+    END { print m + 0 }')"
+  case "$RESERVED_N" in ''|*[!0-9]*) RESERVED_N=0 ;; esac
+  [ "$RESERVED_N" -gt "$LAST_N" ] && LAST_N="$RESERVED_N"
   NEXT_N=$((LAST_N + 1))
   TS="$(date +%Y-%m-%dT%H:%M:%S%z 2>/dev/null || echo unknown)"
 
+  HEADING_SOURCE=""
+  [ "$DEVLOG_PLATFORM" = claude ] || HEADING_SOURCE=" · $DEVLOG_PLATFORM"
   {
-    printf '## Round %s — %s\n\n' "$NEXT_N" "$TS"
+    printf '## Round %s — %s%s\n\n' "$NEXT_N" "$TS" "$HEADING_SOURCE"
     printf '### User Input\n'
     printf '```text\n'
     printf '%s\n' "$PROMPT"
@@ -302,13 +304,14 @@ elif [ "$SPAN_SKIP" -eq 0 ]; then
 
   if [ -f "$ROUND_CURRENT" ]; then
     printf '{"round": %s, "opened_at": "%s", "file": "%s"}\n' "$NEXT_N" "$TS" "${DEVLOG_FILE##*/}" > "$ROUND_OPEN" 2>/dev/null || true
+    [ "$DEVLOG_PLATFORM" = claude ] || printf '這一輪寫在 .devlog/%s。\n' "${ROUND_CURRENT##*/}"
   fi
 fi
 
 if [ -f "$ROUND_CURRENT" ]; then
-  cksum < "$ROUND_CURRENT" > "$DEVLOG_DIR/.turn-start" 2>/dev/null || true
+  cksum < "$ROUND_CURRENT" > "$TURN_MARKER" 2>/dev/null || true
 else
-  echo "MISSING" > "$DEVLOG_DIR/.turn-start" 2>/dev/null || true
+  echo "MISSING" > "$TURN_MARKER" 2>/dev/null || true
 fi
 
 SPAN_WILL_PASS_THROUGH=0
@@ -337,6 +340,14 @@ if [ "$SPAN_WILL_PASS_THROUGH" -eq 0 ] && [ -z "$FOLD_ROUND" ] && [ -f "$CHECKPO
   esac
 fi
 
+CLAUDE_SEGMENT="$DEVLOG_DIR/.segment-state"
+if [ "$SEGMENT_FILE" != "$CLAUDE_SEGMENT" ] && [ ! -f "$SEGMENT_FILE" ] && [ -f "$CLAUDE_SEGMENT" ]; then
+  SEED_MAX="$(json_int_get "$CLAUDE_SEGMENT" max_silent_seconds)"
+  case "$SEED_MAX" in ''|*[!0-9]*) SEED_MAX=600 ;; esac
+  printf '{"last_change_epoch": 0, "last_seen_cksum": "", "max_silent_seconds": %s, "session_id": ""}\n' \
+    "$SEED_MAX" > "$SEGMENT_FILE" 2>/dev/null || true
+fi
+
 if [ -f "$SEGMENT_FILE" ]; then
   SEG_EPOCH="$(json_int_get "$SEGMENT_FILE" last_change_epoch)"
   SEG_MAX="$(json_int_get "$SEGMENT_FILE" max_silent_seconds)"

package/core/scripts/segment-watch-set.sh

@@ -24,21 +24,25 @@ case "$SECONDS_ARG" in
     ;;
 esac
 
-if [ -f "$DEVLOG_DIR/.segment-state" ]; then
-  json_int_set "$DEVLOG_DIR/.segment-state" max_silent_seconds "$SECONDS_ARG"
-  APPLIED="$(json_int_get "$DEVLOG_DIR/.segment-state" max_silent_seconds)"
+APPLIED_ANY=0
+for SEG in "$DEVLOG_DIR"/.segment-state "$DEVLOG_DIR"/.segment-state@*; do
+  [ -f "$SEG" ] || continue
+  APPLIED_ANY=1
+  json_int_set "$SEG" max_silent_seconds "$SECONDS_ARG"
+  APPLIED="$(json_int_get "$SEG" max_silent_seconds)"
   if [ "$APPLIED" != "$SECONDS_ARG" ]; then
     # Existing file didn't have a matching max_silent_seconds key to patch
     # (malformed / hand-edited) -- rebuild it fresh rather than leave the
     # requested value silently unapplied.
-    LAST_EPOCH="$(json_int_get "$DEVLOG_DIR/.segment-state" last_change_epoch)"
-    LAST_SUM="$(json_str_get "$DEVLOG_DIR/.segment-state" last_seen_cksum)"
-    SESSION="$(json_str_get "$DEVLOG_DIR/.segment-state" session_id)"
+    LAST_EPOCH="$(json_int_get "$SEG" last_change_epoch)"
+    LAST_SUM="$(json_str_get "$SEG" last_seen_cksum)"
+    SESSION="$(json_str_get "$SEG" session_id)"
     case "$LAST_EPOCH" in ''|*[!0-9]*) LAST_EPOCH=0 ;; esac
     printf '%s\n' "{\"last_change_epoch\": ${LAST_EPOCH}, \"last_seen_cksum\": \"${LAST_SUM}\", \"max_silent_seconds\": ${SECONDS_ARG}, \"session_id\": \"${SESSION}\"}" \
-      > "$DEVLOG_DIR/.segment-state" || exit 1
+      > "$SEG" || exit 1
   fi
-else
+done
+if [ "$APPLIED_ANY" -eq 0 ]; then
   printf '%s\n' "{\"last_change_epoch\": 0, \"last_seen_cksum\": \"\", \"max_silent_seconds\": ${SECONDS_ARG}, \"session_id\": \"\"}" \
     > "$DEVLOG_DIR/.segment-state" || exit 1
 fi

package/core/scripts/segment-watch.sh

@@ -16,8 +16,6 @@ SCRIPT_DIR="$(cd "${_src%/*}" && pwd)"
 PROJECT_DIR="${DEVLOG_PROJECT_DIR:-${CLAUDE_PROJECT_DIR:-.}}"
 [ -f "$PROJECT_DIR/.devlog/.enabled" ] || exit 0
 devlog_resolve_paths "$PROJECT_DIR"
-ROUND_CURRENT="$DEVLOG_DIR/.round-current.md"
-SEGMENT_FILE="$DEVLOG_DIR/.segment-state"
 
 INPUT="$(cat 2>/dev/null || true)"
 [ -n "$INPUT" ] || exit 0
@@ -66,7 +64,7 @@ is_devlog_tool_allowed() {
   case "$1" in
     Write|Edit|StrReplace|Read|Grep)
       case "$2" in
-        .devlog/.round-current.md|*/.devlog/.round-current.md) return 0 ;;
+        ".devlog/${ROUND_CURRENT##*/}"|*"/.devlog/${ROUND_CURRENT##*/}") return 0 ;;
       esac
       ;;
     Bash)
@@ -82,7 +80,6 @@ if [ -n "$AGENT_ID" ]; then
   exit 0
 fi
 
-MISMATCH_FILE="$DEVLOG_DIR/.workspace-mismatch"
 if [ -f "$MISMATCH_FILE" ]; then
   LIVE_MARK="$(cat "$MISMATCH_FILE" 2>/dev/null || true)"
   if [ -z "$LIVE_MARK" ]; then
@@ -103,7 +100,7 @@ if [ -f "$MISMATCH_FILE" ]; then
       *"$mark_flat"*) rm -f "$MISMATCH_FILE" 2>/dev/null || true ;;
       *)
         if ! is_devlog_tool_allowed "$TOOL_NAME" "$FILE_PATH" "$COMMAND"; then
-          echo "上一輪 Handoff 的工作區（\`<workspace>\`；舊格式是 \`#### 工作區\`）跟目前 git 不符。請先 Read .devlog/.round-current.md，再用 Edit／StrReplace 在這一輪追加 ### 段落，把下面「實際」逐字貼進段落（宣稱 vs 實際）。寫完再呼叫其他工具。不要照上一輪 Handoff「現況／下一步」的字面行動。（唯讀的 git status／diff／log／show／rev-parse 仍可執行，方便自行核對。）" >&2
+          echo "上一輪 Handoff 的工作區（\`<workspace>\`；舊格式是 \`#### 工作區\`）跟目前 git 不符。請先 Read .devlog/${ROUND_CURRENT##*/}，再用 Edit／StrReplace 在這一輪追加 ### 段落，把下面「實際」逐字貼進段落（宣稱 vs 實際）。寫完再呼叫其他工具。不要照上一輪 Handoff「現況／下一步」的字面行動。（唯讀的 git status／diff／log／show／rev-parse 仍可執行，方便自行核對。）" >&2
           echo "" >&2
           echo "實際：" >&2
           printf '%s\n' "$LIVE_MARK" >&2
@@ -190,7 +187,7 @@ fi
 
 ELAPSED=$((NOW - SEG_EPOCH))
 if [ "$ELAPSED" -ge "$SEG_MAX" ]; then
-  echo "這一輪已經 ${ELAPSED} 秒沒有更新 .devlog/.round-current.md（門檻 ${SEG_MAX} 秒）。請先 Read .devlog/.round-current.md，再用 Edit 或 StrReplace **追加**一段「### 段落」（一行也可以）；禁止用 Write 覆寫整份檔。寫完再繼續呼叫其他工具。（唯讀的 git status／diff／log／show／rev-parse 仍可執行。）" >&2
+  echo "這一輪已經 ${ELAPSED} 秒沒有更新 .devlog/${ROUND_CURRENT##*/}（門檻 ${SEG_MAX} 秒）。請先 Read .devlog/${ROUND_CURRENT##*/}，再用 Edit 或 StrReplace **追加**一段「### 段落」（一行也可以）；禁止用 Write 覆寫整份檔。寫完再繼續呼叫其他工具。（唯讀的 git status／diff／log／show／rev-parse 仍可執行。）" >&2
   exit 2
 fi
 

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

@@ -21,6 +21,9 @@
 # 非空就整份印出來、清楚標示「尚未收尾」，跟上面的歷史摘要分開。startup /
 # resume / fork 這幾個 source 因為上面已經先 heal 過，這裡通常是空的、印出
 # 來是 no-op，不特別排除，寫法比較單純。讀不到就跳過，fail-open。
+#
+# 其他平台的 Session Handoff：只注入本平台的 handoff 檔；其他平台非空的
+# handoff 只印一行路徑提醒，不注入內容。
 
 set -uo pipefail
 
@@ -35,15 +38,13 @@ HOOKS_DIR="$(cd "${_src%/*}" && pwd)"
 
 PROJECT_DIR="${DEVLOG_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
+    if [ -f "$ROUND_OPEN" ]; then
       DANGLING_DETAIL=""
       if [ -n "$(detect_pending_question "$(json_str_field "$INPUT" transcript_path)")" ]; then
         DANGLING_DETAIL="awaiting_question"
@@ -64,7 +65,7 @@ if [ -f "$SPAN_FILE" ]; then
   if [ -n "$SPAN_ROUND" ] && [ -n "$SPAN_OPENED_AT" ]; then
     echo "⚠️ 有一個開啟中的 span：Round ${SPAN_ROUND}，從 ${SPAN_OPENED_AT} 開始，"
     echo "還沒有正式結束。請先確認要繼續這個自動化任務，還是要明確關閉它"
-    echo "（刪除 .devlog/.span-open 並補寫收尾的 Round）。"
+    echo "（刪除 .devlog/${SPAN_FILE##*/} 並補寫收尾的 Round）。"
     echo ""
   fi
 fi
@@ -76,6 +77,11 @@ if [ -s "${HANDOFF_FILE:-}" ]; then
   echo ""
 fi
 
+devlog_other_handoffs | while IFS="$(printf '\t')" read -r OTHER_PLATFORM OTHER_FILE; do
+  echo "另一個平台（${OTHER_PLATFORM}）有未完成的交接：.devlog/${OTHER_FILE##*/}"
+  echo ""
+done
+
 if [ -f "$DEVLOG_FILE" ]; then
   echo "以下是本專案 .devlog/${DEVLOG_FILE##*/} 的接手摘要（不是全文；完整紀錄請自行讀取原檔）："
   echo ""
@@ -155,7 +161,7 @@ fi
 # 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 "以下是目前還沒收尾、仍在 .devlog/${ROUND_CURRENT##*/} 裡的這一輪內容（跟上面的歷史摘要分開，尚未併入 devlog.md）："
   echo ""
   cat "$ROUND_CURRENT" 2>/dev/null || true
   echo ""

package/core/scripts/span-close.sh

@@ -1,9 +1,13 @@
 #!/usr/bin/env bash
 set -uo pipefail
-DEVLOG_DIR="${DEVLOG_PROJECT_DIR:-${CLAUDE_PROJECT_DIR:-.}}/.devlog"
-if [ ! -e "$DEVLOG_DIR/.span-open" ]; then
+_src="${BASH_SOURCE[0]}"
+SCRIPT_DIR="$(cd "${_src%/*}" && pwd)"
+# shellcheck source=devlog-path.sh
+. "$SCRIPT_DIR/devlog-path.sh"
+devlog_resolve_paths "${DEVLOG_PROJECT_DIR:-${CLAUDE_PROJECT_DIR:-.}}"
+if [ ! -e "$SPAN_FILE" ]; then
   echo "NOT_OPEN"
   exit 0
 fi
-rm -f "$DEVLOG_DIR/.span-open" || exit 1
+rm -f "$SPAN_FILE" || exit 1
 echo "CLOSED"

package/core/scripts/span-open.sh

@@ -8,14 +8,14 @@ SCRIPT_DIR="$(cd "${_src%/*}" && pwd)"
 
 devlog_resolve_paths "${DEVLOG_PROJECT_DIR:-${CLAUDE_PROJECT_DIR:-.}}"
 [ -f "$DEVLOG_DIR/.enabled" ] || { echo "NOT_ENABLED" >&2; exit 1; }
-[ ! -e "$DEVLOG_DIR/.span-open" ] || { echo "ALREADY_OPEN" >&2; exit 1; }
+[ ! -e "$SPAN_FILE" ] || { echo "ALREADY_OPEN" >&2; exit 1; }
 ROUND=""
-[ ! -f "$DEVLOG_DIR/.round-open" ] || ROUND="$(json_int_get "$DEVLOG_DIR/.round-open" round)"
+[ ! -f "$ROUND_OPEN" ] || ROUND="$(json_int_get "$ROUND_OPEN" round)"
 if [ -z "$ROUND" ] && [ -f "$DEVLOG_FILE" ]; then
-  ROUND="$(devlog_list_round_starts "$DEVLOG_FILE" | awk 'END { print $2 }')"
+  ROUND="$(devlog_list_round_starts_of "$DEVLOG_FILE" "$DEVLOG_PLATFORM" | 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
+  "$ROUND" "$OPENED_AT" > "$SPAN_FILE" || exit 1
 printf 'OPENED=%s\n' "$ROUND"

package/core/scripts/status-devlog.sh

@@ -16,11 +16,11 @@ if [ -f "$DEVLOG_DIR/.lessons-advisory-state" ]; then
   advisory_max="$(json_int_get "$DEVLOG_DIR/.lessons-advisory-state" threshold)"
   printf 'LESSONS_ADVISORY=%s/%s\n' "${advisory_count:-0}" "${advisory_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)"
+if [ -f "$SPAN_FILE" ]; then
+  r="$(json_int_get "$SPAN_FILE" round)"
+  opened="$(json_str_get "$SPAN_FILE" opened_at)"
+  ticks="$(json_int_get "$SPAN_FILE" ticks_since_checkin)"
+  max="$(json_int_get "$SPAN_FILE" max_silent_ticks)"
   printf 'SPAN=%s,%s,%s,%s\n' "${r:-?}" "${opened:-?}" "${ticks:-?}" "${max:-5}"
 else
   echo "SPAN=closed"
@@ -28,7 +28,7 @@ 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)"
+seconds="$(json_int_get "$SEGMENT_FILE" max_silent_seconds)"
 printf 'SEGMENT=max_silent_seconds=%s\n' "${seconds:-600}"
 
 status="none"

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

@@ -103,6 +103,15 @@ 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"
 
+# --- platform: codex falls back to its own last round ----------------------
+rm -f "$DEVLOG_DIR/.round-open" "$DEVLOG_DIR/.awaiting-reply" "$DEVLOG_DIR/.awaiting-reply@codex"
+printf '## Round 7 — t · codex\n\n### Status\nDONE\n\n## Round 8 — t\n\n### Status\nDONE\n' > "$DEVLOG_DIR/devlog.md"
+touch "$DEVLOG_DIR/.platform-claimed"
+OUT="$(DEVLOG_PLATFORM=codex bash "$SCRIPT_DIR/await-open.sh")"
+assert_contains "codex await-open uses its own last round" "OPENED=7" "$OUT"
+[ -f "$DEVLOG_DIR/.awaiting-reply@codex" ] && [ ! -f "$DEVLOG_DIR/.awaiting-reply" ] \
+  && echo "PASS: codex awaiting file" || { echo "FAIL: codex awaiting file"; FAIL=1; }
+
 if [ "$FAIL" -eq 0 ]; then
   echo "All checks passed."
   exit 0

package/core/scripts/tests/test-devlog-md.sh

@@ -475,6 +475,36 @@ NONGIT_DIR="$TMP_ROOT/nongit"
 mkdir -p "$NONGIT_DIR"
 assert_eq "unclosed fence still yields a claim (MISMATCH, not NO_CLAIM)" "MISMATCH" "$(workspace_claim_state "$NONGIT_DIR" "$TMP_ROOT/unclosed-fence.md")"
 
+WS_FILE="$TMP_ROOT/per-platform-claim.md"
+cat > "$WS_FILE" <<'EOF'
+## Round 1 — 2026-09-27T10:00:00+0800
+
+### Handoff
+<handoff>
+<workspace>
+非 git 工作區
+</workspace>
+</handoff>
+
+### Status
+IN_PROGRESS
+
+## Round 2 — 2026-09-27T10:05:00+0800 · codex
+
+### Handoff
+<handoff>
+<workspace>
+bogus
+</workspace>
+</handoff>
+
+### Status
+IN_PROGRESS
+EOF
+assert_eq "claude claim ignores codex's later round" "MATCH" "$(workspace_claim_state "$NONGIT_DIR" "$WS_FILE" claude)"
+assert_eq "claude is the default platform" "MATCH" "$(workspace_claim_state "$NONGIT_DIR" "$WS_FILE")"
+assert_eq "codex claim sees its own round" "MISMATCH" "$(workspace_claim_state "$NONGIT_DIR" "$WS_FILE" codex)"
+
 cat > "$TMP_ROOT/unclosed-fence-segments.md" <<'EOF'
 ## Round 1 — 2026-09-11T00:00:00+08:00
 
@@ -515,30 +545,61 @@ devlog_merge_round_current "$MERGE_MAIN" "$MERGE_CUR"
 AFTER="$(cat "$MERGE_MAIN")"
 if [ "$BEFORE" = "$AFTER" ]; then echo "PASS: merge no-op when round-current absent"; else echo "FAIL: merge no-op when round-current absent"; FAIL=1; fi
 
-# --- devlog_reopen_last_round ------------------------------------------
-REOPEN_MAIN="$TMP_ROOT/.devlog/reopen-main.md"
-REOPEN_CUR="$TMP_ROOT/.devlog/reopen-current.md"
-rm -f "$REOPEN_CUR"
+# --- per-platform round lookup --------------------------------------------
+MP="$TMP_ROOT/mp.md"
+cat > "$MP" <<'EOF'
+# 專案摘要
+
+## Round 1 — 2026-09-27T10:00:00+0800
+
+### Status
+DONE
 
-printf '## Round 1 — 2026-09-17T09:00:00+0800\n\n### Summary\ns1\n\n### Handoff\n#### 現況\nc1\n\n### Status\nDONE\n\n## Round 2 — 2026-09-17T09:10:00+0800\n\n### User Input\n```text\n問題？\n```\n\n### Summary\ns2\n\n### Handoff\n#### 現況\nBLOCKED 等答案\n\n### Status\nBLOCKED\n' > "$REOPEN_MAIN"
+## Round 3 — 2026-09-27T10:05:00+0800 · codex
 
-devlog_reopen_last_round "$REOPEN_MAIN" "$REOPEN_CUR"
-RC=$?
-assert_exit "reopen: returns 0 when a round exists" 0 "$RC"
+### Status
+IN_PROGRESS
 
-REOPENED="$(cat "$REOPEN_CUR" 2>/dev/null || echo '')"
-assert_contains "reopen: round 2 moved into round-current" "## Round 2" "$REOPENED"
-assert_not_contains "reopen: round 1 not pulled along" "## Round 1" "$REOPENED"
+## Round 2 — 2026-09-27T10:01:00+0800
 
-REMAINING="$(cat "$REOPEN_MAIN")"
-assert_contains "reopen: round 1 stays in main file" "## Round 1" "$REMAINING"
-assert_not_contains "reopen: round 2 removed from main file" "## Round 2" "$REMAINING"
+```text
+## Round 9 — fenced · codex
+```
+
+### Status
+DONE
+
+## Round 4 — 2026-09-27T10:09:00+0800 · cursor
+
+### Status
+DONE
+EOF
+assert_eq "claude rounds" "3 1
+13 2" "$(devlog_list_round_starts_of "$MP" claude)"
+assert_eq "codex rounds (fenced ignored)" "8 3" "$(devlog_list_round_starts_of "$MP" codex)"
+assert_eq "cursor rounds" "22 4" "$(devlog_list_round_starts_of "$MP" cursor)"
+assert_eq "by number: middle round" "8" "$(devlog_round_start_by_number "$MP" 3)"
+assert_eq "by number: missing" "" "$(devlog_round_start_by_number "$MP" 8)"
+
+# --- devlog_reopen_round ----------------------------------------------------
+REOPEN_MAIN="$TMP_ROOT/reopen.md"
+REOPEN_CUR="$TMP_ROOT/reopen-cur.md"
+cp "$MP" "$REOPEN_MAIN"
+devlog_reopen_round "$REOPEN_MAIN" "$REOPEN_CUR" 3
+assert_eq "reopen middle: returns 0" "0" "$?"
+assert_contains "reopen middle: current has round 3" "## Round 3 — 2026-09-27T10:05:00+0800 · codex" "$(cat "$REOPEN_CUR")"
+assert_not_contains "reopen middle: devlog lost round 3" "## Round 3 " "$(cat "$REOPEN_MAIN")"
+assert_eq "reopen middle: others stay in order" "1 2 4 " "$(devlog_list_round_starts "$REOPEN_MAIN" | awk '{printf "%s ", $2}')"
+devlog_reopen_round "$REOPEN_MAIN" "$TMP_ROOT/should-not-exist.md" 3
+assert_eq "reopen missing: returns 1" "1" "$?"
+assert_file_absent "reopen missing: no current file" "$TMP_ROOT/should-not-exist.md"
 
 # reopen on a file with no round at all fails without touching either file
+mkdir -p "$TMP_ROOT/.devlog"
 EMPTY_MAIN="$TMP_ROOT/.devlog/empty-main.md"
 : > "$EMPTY_MAIN"
 rm -f "$TMP_ROOT/.devlog/should-not-exist.md"
-devlog_reopen_last_round "$EMPTY_MAIN" "$TMP_ROOT/.devlog/should-not-exist.md"
+devlog_reopen_round "$EMPTY_MAIN" "$TMP_ROOT/.devlog/should-not-exist.md" 1
 assert_exit "reopen: returns 1 when no round exists" 1 $?
 assert_file_absent "reopen: no round-current created on failure" "$TMP_ROOT/.devlog/should-not-exist.md"
 

package/core/scripts/tests/test-devlog-path.sh

@@ -288,5 +288,131 @@ devlog_resolve_paths "$DETACHEDREPO"
   && echo "PASS: detached HANDOFF_FILE uses worktree dirname" \
   || { echo "FAIL: detached HANDOFF_FILE=$HANDOFF_FILE"; FAIL=1; }
 
+# --- platform identity ---------------------------------------------------
+assert_path() {
+  if [ "$2" = "$3" ]; then echo "PASS: $1"; else echo "FAIL: $1 (expected [$2], got [$3])"; FAIL=1; fi
+}
+assert_path "unset platform is claude" claude "$(unset DEVLOG_PLATFORM; devlog_platform)"
+assert_path "codex platform" codex "$(DEVLOG_PLATFORM=codex devlog_platform)"
+assert_path "unknown platform falls back to claude" claude "$(DEVLOG_PLATFORM='x;rm' devlog_platform)"
+assert_path "claude keeps plain name" .round-current.md "$(devlog_platform_file .round-current .md claude)"
+assert_path "codex gets @ suffix" .round-current@codex.md "$(devlog_platform_file .round-current .md codex)"
+assert_path "extensionless @ suffix" .round-open@cursor "$(devlog_platform_file .round-open '' cursor)"
+
+# --- per-platform state paths --------------------------------------------
+PLATREPO="$TMP/platrepo"
+mkdir -p "$PLATREPO"
+git_setup "$PLATREPO"
+git -C "$PLATREPO" branch -M main
+DEVLOG_PLATFORM=codex devlog_resolve_paths "$PLATREPO"
+assert_path "codex ROUND_CURRENT" "$PLATREPO/.devlog/.round-current@codex.md" "$ROUND_CURRENT"
+assert_path "codex ROUND_OPEN" "$PLATREPO/.devlog/.round-open@codex" "$ROUND_OPEN"
+assert_path "codex TURN_MARKER" "$PLATREPO/.devlog/.turn-start@codex" "$TURN_MARKER"
+assert_path "codex SEGMENT_FILE" "$PLATREPO/.devlog/.segment-state@codex" "$SEGMENT_FILE"
+assert_path "codex AWAITING_FILE" "$PLATREPO/.devlog/.awaiting-reply@codex" "$AWAITING_FILE"
+assert_path "codex INTERRUPTED_FLAG" "$PLATREPO/.devlog/.interrupted@codex" "$INTERRUPTED_FLAG"
+assert_path "codex SPAN_FILE" "$PLATREPO/.devlog/.span-open@codex" "$SPAN_FILE"
+assert_path "codex MISMATCH_FILE" "$PLATREPO/.devlog/.workspace-mismatch@codex" "$MISMATCH_FILE"
+assert_path "codex main HANDOFF_FILE" "$PLATREPO/.devlog/handoff@codex.md" "$HANDOFF_FILE"
+assert_path "codex DEVLOG_FILE shared" "$PLATREPO/.devlog/devlog.md" "$DEVLOG_FILE"
+unset DEVLOG_PLATFORM
+devlog_resolve_paths "$PLATREPO"
+assert_path "claude ROUND_CURRENT unchanged" "$PLATREPO/.devlog/.round-current.md" "$ROUND_CURRENT"
+assert_path "claude ROUND_OPEN unchanged" "$PLATREPO/.devlog/.round-open" "$ROUND_OPEN"
+assert_path "claude HANDOFF_FILE unchanged" "$PLATREPO/.devlog/handoff.md" "$HANDOFF_FILE"
+git -C "$PLATREPO" checkout -q -b codex
+DEVLOG_PLATFORM=cursor devlog_resolve_paths "$PLATREPO"
+assert_path "branch named codex + cursor platform" "$PLATREPO/.devlog/handoff.codex@cursor.md" "$HANDOFF_FILE"
+assert_path "HANDOFF_STEM" "$PLATREPO/.devlog/handoff.codex" "$HANDOFF_STEM"
+unset DEVLOG_PLATFORM
+
+# --- legacy claim ----------------------------------------------------------
+CLAIMREPO="$TMP/claimrepo"
+mkdir -p "$CLAIMREPO/.devlog"
+git_setup "$CLAIMREPO"
+git -C "$CLAIMREPO" branch -M main
+touch "$CLAIMREPO/.devlog/.enabled"
+echo "open round" > "$CLAIMREPO/.devlog/.round-current.md"
+printf '{"round": 3, "opened_at": "t", "file": "devlog.md"}\n' > "$CLAIMREPO/.devlog/.round-open"
+echo "legacy handoff" > "$CLAIMREPO/.devlog/handoff.md"
+echo "segment cfg" > "$CLAIMREPO/.devlog/.segment-state"
+DEVLOG_PLATFORM=codex devlog_resolve_paths "$CLAIMREPO"
+if [ -f "$CLAIMREPO/.devlog/.round-current@codex.md" ] && [ ! -f "$CLAIMREPO/.devlog/.round-current.md" ] \
+  && [ -f "$CLAIMREPO/.devlog/.round-open@codex" ] \
+  && grep -q "legacy handoff" "$CLAIMREPO/.devlog/handoff@codex.md" \
+  && [ -f "$CLAIMREPO/.devlog/.segment-state" ] \
+  && [ -f "$CLAIMREPO/.devlog/.platform-claimed" ]; then
+  echo "PASS: first non-claude platform claims legacy state (segment config stays)"
+else
+  echo "FAIL: legacy claim"; ls -a "$CLAIMREPO/.devlog"; FAIL=1
+fi
+echo "later claude round" > "$CLAIMREPO/.devlog/.round-current.md"
+DEVLOG_PLATFORM=cursor devlog_resolve_paths "$CLAIMREPO"
+if [ -f "$CLAIMREPO/.devlog/.round-current.md" ] && [ ! -f "$CLAIMREPO/.devlog/.round-current@cursor.md" ]; then
+  echo "PASS: marker stops later claims"
+else
+  echo "FAIL: second claim happened"; FAIL=1
+fi
+unset DEVLOG_PLATFORM
+
+CLAUDEFIRST="$TMP/claudefirst"
+mkdir -p "$CLAUDEFIRST/.devlog"
+git_setup "$CLAUDEFIRST"
+git -C "$CLAUDEFIRST" branch -M main
+touch "$CLAUDEFIRST/.devlog/.enabled"
+echo "open round" > "$CLAUDEFIRST/.devlog/.round-current.md"
+devlog_resolve_paths "$CLAUDEFIRST"
+if [ -f "$CLAUDEFIRST/.devlog/.round-current.md" ] && [ -f "$CLAUDEFIRST/.devlog/.platform-claimed" ]; then
+  echo "PASS: claude-first claims nothing, writes marker"
+else
+  echo "FAIL: claude-first claim"; FAIL=1
+fi
+
+NOTENABLED="$TMP/notenabled"
+mkdir -p "$NOTENABLED/.devlog"
+echo "x" > "$NOTENABLED/.devlog/.round-current.md"
+DEVLOG_PLATFORM=codex devlog_resolve_paths "$NOTENABLED"
+if [ -f "$NOTENABLED/.devlog/.round-current.md" ] && [ ! -e "$NOTENABLED/.devlog/.platform-claimed" ]; then
+  echo "PASS: no claim without .enabled"
+else
+  echo "FAIL: claimed while disabled"; FAIL=1
+fi
+unset DEVLOG_PLATFORM
+
+# --- open rounds / other handoffs -----------------------------------------
+LISTREPO="$TMP/listrepo"
+mkdir -p "$LISTREPO/.devlog"
+git_setup "$LISTREPO"
+git -C "$LISTREPO" branch -M main
+touch "$LISTREPO/.devlog/.enabled" "$LISTREPO/.devlog/.platform-claimed"
+printf '{"round": 5, "opened_at": "t", "file": "devlog.md"}\n' > "$LISTREPO/.devlog/.round-open"
+printf '{"round": 6, "opened_at": "t", "file": "devlog.md"}\n' > "$LISTREPO/.devlog/.round-open@codex"
+echo "claude h" > "$LISTREPO/.devlog/handoff.md"
+echo "cursor h" > "$LISTREPO/.devlog/handoff@cursor.md"
+: > "$LISTREPO/.devlog/handoff@codex.md"
+DEVLOG_PLATFORM=codex devlog_resolve_paths "$LISTREPO"
+assert_path "open rounds listing" "$(printf 'claude\t5\tdevlog.md\ncodex\t6\tdevlog.md')" "$(devlog_open_rounds)"
+assert_path "other handoffs (non-empty, not own)" \
+  "$(printf 'claude\t%s\ncursor\t%s' "$LISTREPO/.devlog/handoff.md" "$LISTREPO/.devlog/handoff@cursor.md")" \
+  "$(DEVLOG_PLATFORM=codex devlog_other_handoffs)"
+unset DEVLOG_PLATFORM
+
+# --- branch tail migration moves every platform's handoff -----------------
+PTAIL="$TMP/ptail"
+mig_repo "$PTAIL"
+write_main_devlog "$PTAIL/.devlog/devlog.md" 1:DONE 2:IN_PROGRESS
+touch "$PTAIL/.devlog/.platform-claimed"
+echo "claude handoff" > "$PTAIL/.devlog/handoff.md"
+echo "codex handoff" > "$PTAIL/.devlog/handoff@codex.md"
+git -C "$PTAIL" checkout -q -b feature-p
+devlog_resolve_paths "$PTAIL"
+if grep -q "claude handoff" "$PTAIL/.devlog/handoff.feature-p.md" \
+  && grep -q "codex handoff" "$PTAIL/.devlog/handoff.feature-p@codex.md" \
+  && [ ! -f "$PTAIL/.devlog/handoff@codex.md" ]; then
+  echo "PASS: tail migration moves every platform's handoff"
+else
+  echo "FAIL: platform handoff tail migration"; ls -a "$PTAIL/.devlog"; FAIL=1
+fi
+
 if [ "$FAIL" -eq 0 ]; then echo "All checks passed."; exit 0
 else echo "Some checks FAILED."; exit 1; fi