devlog-tracker 0.33.4 → 0.33.5

package/README.md

@@ -2,7 +2,7 @@
 
 *English | [繁體中文](README.zh-TW.md)*
 
-**Version** 0.33.4
+**Version** 0.33.5
 
 Maintains a `.devlog/devlog.md` in your project, turning each conversation round's requests, decisions, and outcomes into a permanent record. A conversation disappears the moment you `/clear` or switch sessions; this file fills that gap so work can pause and resume. Nothing is touched until you explicitly run `/devlog-tracker:start` — installing the plugin alone doesn't create or modify any files.
 

package/README.zh-TW.md

@@ -2,7 +2,7 @@
 
 *[English](README.md) | 繁體中文*
 
-**版本** 0.33.4
+**版本** 0.33.5
 
 在專案中維護一份 `.devlog/devlog.md`，把每一輪對話的請求、決策與結果寫成永久紀錄。對話一 `/clear` 或換 session 就沒了；這份檔案取代那個缺口，讓工作可以中斷再接。沒下過 `/devlog-tracker:start` 時，裝著也不會動任何檔案。
 

package/core/scripts/tests/test-workspace-snapshot.sh

@@ -83,6 +83,38 @@ CLI_UNBORN="$(bash "$SCRIPT_DIR/workspace-snapshot.sh" "$UNBORN")"
 FUNC_UNBORN="$(workspace_snapshot "$UNBORN")"
 assert_eq "cli matches function (unborn dirty)" "$FUNC_UNBORN" "$CLI_UNBORN"
 
+# --- .devlog/ changes are ignored (same rule as files-snapshot.sh) ----------
+# The devlog is rewritten every round, so counting it would make every
+# snapshot dirty and every Handoff 工作區 drift on its own write.
+DL="$TMP_ROOT/devlog-ignored"
+mkdir -p "$DL"
+git -C "$DL" init -q -b main
+git -C "$DL" config user.email test@example.com
+git -C "$DL" config user.name test
+echo hello > "$DL/a.txt"
+mkdir -p "$DL/.devlog"
+echo tracked > "$DL/.devlog/devlog.md"
+git -C "$DL" add a.txt .devlog/devlog.md
+git -C "$DL" commit -q -m init
+DL_HASH="$(git -C "$DL" rev-parse --short HEAD)"
+echo more >> "$DL/.devlog/devlog.md"
+echo round > "$DL/.devlog/.round-current.md"
+OUT="$(workspace_snapshot "$DL")"
+assert_eq ".devlog-only changes count as clean" "main @ ${DL_HASH}，工作樹乾淨" "$OUT"
+
+echo change >> "$DL/a.txt"
+OUT="$(workspace_snapshot "$DL")"
+EXPECTED="main @ ${DL_HASH}
+未提交：a.txt"
+assert_eq ".devlog changes omitted from 未提交" "$EXPECTED" "$OUT"
+
+DL_UNBORN="$TMP_ROOT/devlog-unborn"
+mkdir -p "$DL_UNBORN/.devlog"
+git -C "$DL_UNBORN" init -q -b main
+echo x > "$DL_UNBORN/.devlog/devlog.md"
+OUT="$(workspace_snapshot "$DL_UNBORN")"
+assert_eq "unborn with untracked .devlog/ only is clean" "main @ (尚無 commit)，工作樹乾淨" "$OUT"
+
 # --- executable entry matches the sourced function --------------------------
 CLI_NONGIT="$(bash "$SCRIPT_DIR/workspace-snapshot.sh" "$NONGIT")"
 assert_eq "cli non-git directory" "非 git 工作區" "$CLI_NONGIT"

package/core/scripts/workspace-snapshot.sh

@@ -15,6 +15,19 @@
 # Known limitation: a dirty file path containing a space is not exactly
 # reversible from `git status --short`'s last-field extraction below — same
 # limitation the hand-written 工作區 convention already has.
+#
+# Paths under .devlog/ are left out (same rule as files-snapshot.sh): the
+# devlog is rewritten every round, so counting it would make the snapshot
+# dirty by its own write. A tree whose only changes are under .devlog/
+# reports as clean.
+
+# `git status --short` minus .devlog/ entries. Lines are "<XY> <path>".
+_ws_status_short() {
+  git -C "$1" status --short 2>/dev/null \
+    | awk '{ p = substr($0, 4) } p == ".devlog" || p ~ /^\.devlog\// { next } { print }' \
+    || true
+}
+
 workspace_snapshot() {
   local dir="${1:-.}"
   if ! git -C "$dir" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
@@ -37,7 +50,7 @@ workspace_snapshot() {
       printf '非 git 工作區\n'
       return 0
     fi
-    status_out="$(git -C "$dir" status --short 2>/dev/null || echo '')"
+    status_out="$(_ws_status_short "$dir")"
     if [ -z "$status_out" ]; then
       printf '%s @ (尚無 commit)，工作樹乾淨\n' "$unborn_branch"
     else
@@ -51,7 +64,7 @@ workspace_snapshot() {
   else
     label="$branch"
   fi
-  status_out="$(git -C "$dir" status --short 2>/dev/null || echo '')"
+  status_out="$(_ws_status_short "$dir")"
   if [ -z "$status_out" ]; then
     if [ "$label" = "HEAD detached" ]; then
       printf '%s @ %s\n' "$label" "$hash"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devlog-tracker",
-  "version": "0.33.4",
+  "version": "0.33.5",
   "description": "npx installer for devlog-tracker's Claude Code, Cursor and Codex adapters.",
   "bin": {
     "devlog-tracker": "bin/devlog-tracker.js"

package/skills/devlog-tracker/SKILL.md

@@ -245,7 +245,7 @@ Round 編號：讀取檔案中最後一個 `## Round <N>`，本輪用 N+1；檔
   `完成條件` 要寫到下一輪能對照判斷「可否 DONE」（例如「`bash core/scripts/tests/test-foo.sh` 全過」），
   不要只寫「功能完成」。`下一步` 要具體到下一輪打開就能做（路徑／反引號指令／skill 名），寫「繼續完成」不算完成；
   `IN_PROGRESS` 時 Stop 會做輕量可執行檢查（見下）。`BLOCKED` 的 `現況` 或 `下一步` 必須寫「缺什麼、出現長怎樣」。
-- **`工作區` 是收尾當下的 git 快照，給下一輪核對用。** 寫之前跑 `git status --short`、`git rev-parse --abbrev-ref HEAD`、`git rev-parse --short HEAD`，照輸出寫。`abbrev-ref` 為 `HEAD` 時用 detached 格式；`rev-parse --short HEAD` 失敗但 `git symbolic-ref --short HEAD` 抓得到分支名（尚無 commit，例如剛 `git init`）用 unborn 格式；兩者都失敗才是非 git。髒檔是整棵樹的未提交，不必跟「檔案」那輪 delta 相同。格式：
+- **`工作區` 是收尾當下的 git 快照，給下一輪核對用。** 寫之前跑 `git status --short`、`git rev-parse --abbrev-ref HEAD`、`git rev-parse --short HEAD`，照輸出寫。`abbrev-ref` 為 `HEAD` 時用 detached 格式；`rev-parse --short HEAD` 失敗但 `git symbolic-ref --short HEAD` 抓得到分支名（尚無 commit，例如剛 `git init`）用 unborn 格式；兩者都失敗才是非 git。髒檔是整棵樹的未提交，不必跟「檔案」那輪 delta 相同；`.devlog/` 底下的路徑不列（devlog 每輪都會改，只有它髒時照「工作樹乾淨」寫）。格式：
   - 乾淨：`main @ a1b2c3d，工作樹乾淨`（一行）
   - 有未提交：第一行 `feat/foo @ a1b2c3d`，第二行 `未提交：src/a.ts, hooks/foo.sh`
   - 非 git：一行 `非 git 工作區`