devlog-tracker 0.33.2 → 0.33.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (17) hide show
  1. package/README.md +1 -1
  2. package/README.zh-TW.md +1 -1
  3. package/commands/checkpoint.md +1 -1
  4. package/commands/clean.md +1 -1
  5. package/commands/compact.md +1 -1
  6. package/commands/keep.md +1 -1
  7. package/commands/lessons-drift.md +1 -1
  8. package/commands/lessons-off.md +1 -1
  9. package/commands/lessons-on.md +1 -1
  10. package/commands/pause.md +1 -1
  11. package/commands/report.md +1 -1
  12. package/commands/segment-watch.md +1 -1
  13. package/commands/span.md +2 -2
  14. package/commands/start.md +1 -1
  15. package/commands/status.md +1 -1
  16. package/commands/timeline.md +1 -1
  17. package/package.json +1 -1
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  *English | [繁體中文](README.zh-TW.md)*
4
4
 
5
- **Version** 0.33.2
5
+ **Version** 0.33.3
6
6
 
7
7
  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.
8
8
 
package/README.zh-TW.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  *[English](README.md) | 繁體中文*
4
4
 
5
- **版本** 0.33.2
5
+ **版本** 0.33.3
6
6
 
7
7
  在專案中維護一份 `.devlog/devlog.md`，把每一輪對話的請求、決策與結果寫成永久紀錄。對話一 `/clear` 或換 session 就沒了；這份檔案取代那個缺口，讓工作可以中斷再接。沒下過 `/devlog-tracker:start` 時，裝著也不會動任何檔案。
8
8
 
package/commands/checkpoint.md CHANGED
@@ -7,7 +7,7 @@ description: 調整 Checkpoint Mode 的沉默門檻——累積多少輪沒寫 #
7
7
 
8
8
  ```bash
9
9
  PLUGIN_ROOT="${DEVLOG_TRACKER_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"
10
- DEVLOG_PROJECT_DIR="$(pwd)" bash "${PLUGIN_ROOT}/core/scripts/checkpoint-set.sh" <rounds>
10
+ DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑，不要用 $(pwd) 重新推>" bash "${PLUGIN_ROOT}/core/scripts/checkpoint-set.sh" <rounds>
11
11
  ```
12
12
 
13
13
  不要自己手改 `.devlog/.checkpoint-state`。
package/commands/clean.md CHANGED
@@ -34,7 +34,7 @@ description: 無條件清空 .devlog/devlog.md（含專案摘要與所有 Round
34
34
 
35
35
  ```bash
36
36
  PLUGIN_ROOT="${DEVLOG_TRACKER_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"
37
- DEVLOG_PROJECT_DIR="$(pwd)" bash "${PLUGIN_ROOT}/core/scripts/clean-devlog.sh" --confirmed
37
+ DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑，不要用 $(pwd) 重新推>" bash "${PLUGIN_ROOT}/core/scripts/clean-devlog.sh" --confirmed
38
38
  ```
39
39
  ```
40
40
 
package/commands/compact.md CHANGED
@@ -16,7 +16,7 @@ description: 把 .devlog/devlog.md 裡已完成且較舊的紀錄搬到 devlog.a
16
16
  先決定 plugin 根目錄（有 `DEVLOG_TRACKER_ROOT` 用它；否則用 `CLAUDE_PLUGIN_ROOT`；兩者都空就用含 `.claude-plugin/plugin.json` 的本 plugin 根目錄）：
17
17
  ```bash
18
18
  PLUGIN_ROOT="${DEVLOG_TRACKER_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"
19
- DEVLOG_PROJECT_DIR="$(pwd)" bash "${PLUGIN_ROOT}/core/scripts/compact-devlog.sh"
19
+ DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑，不要用 $(pwd) 重新推>" bash "${PLUGIN_ROOT}/core/scripts/compact-devlog.sh"
20
20
  ```
21
21
  檔案不存在時腳本 exit 1：告知沒有東西可壓縮。
22
22
  5. 用 stdout 的 `MOVED` / `REMAINING` / `ARCHIVE` 回報一句話。
package/commands/keep.md CHANGED
@@ -84,7 +84,7 @@ description: 掃描整份 devlog.md，把值得留名的主題段落一次分別
84
84
 
85
85
  ```bash
86
86
  PLUGIN_ROOT="${DEVLOG_TRACKER_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"
87
- DEVLOG_PROJECT_DIR="$(pwd)" bash "${PLUGIN_ROOT}/core/scripts/keep-move.sh" \
87
+ DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑，不要用 $(pwd) 重新推>" bash "${PLUGIN_ROOT}/core/scripts/keep-move.sh" \
88
88
  --from <from> --to <to> --name "<name>" --desc "<這段在做什麼的一句話>"
89
89
  ```
90
90
 
package/commands/lessons-drift.md CHANGED
@@ -6,7 +6,7 @@ description: 調整 Lessons Mode 機制性提醒的共用門檻——工作區
6
6
 
7
7
  ```bash
8
8
  PLUGIN_ROOT="${DEVLOG_TRACKER_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"
9
- DEVLOG_PROJECT_DIR="$(pwd)" bash "${PLUGIN_ROOT}/core/scripts/lessons-drift-set.sh" <次數>
9
+ DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑，不要用 $(pwd) 重新推>" bash "${PLUGIN_ROOT}/core/scripts/lessons-drift-set.sh" <次數>
10
10
  ```
11
11
 
12
12
  不要自己手改 `.devlog/.lessons-advisory-state`。
package/commands/lessons-off.md CHANGED
@@ -7,7 +7,7 @@ description: 關閉 Lessons Mode。不會刪除任何已寫的 devlog.lessons.*.
7
7
  1. 先決定 plugin 根目錄（有 `DEVLOG_TRACKER_ROOT` 用它；否則用 `CLAUDE_PLUGIN_ROOT`；兩者都空就用含 `.claude-plugin/plugin.json` 的本 plugin 根目錄）：
8
8
  ```bash
9
9
  PLUGIN_ROOT="${DEVLOG_TRACKER_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"
10
- DEVLOG_PROJECT_DIR="$(pwd)" bash "${PLUGIN_ROOT}/core/scripts/lessons-off.sh"
10
+ DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑，不要用 $(pwd) 重新推>" bash "${PLUGIN_ROOT}/core/scripts/lessons-off.sh"
11
11
  ```
12
12
  不要自己刪 `.lessons-enabled`。
13
13
  2. stdout 是 `NOT_ENABLED`：告知 Lessons Mode 本來就沒開，結束。
package/commands/lessons-on.md CHANGED
@@ -7,7 +7,7 @@ description: 開啟 Lessons Mode（開發歷程教訓，預設關閉）。隸屬
7
7
  1. 先決定 plugin 根目錄（有 `DEVLOG_TRACKER_ROOT` 用它；否則用 `CLAUDE_PLUGIN_ROOT`；兩者都空就用含 `.claude-plugin/plugin.json` 的本 plugin 根目錄）：
8
8
  ```bash
9
9
  PLUGIN_ROOT="${DEVLOG_TRACKER_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"
10
- DEVLOG_PROJECT_DIR="$(pwd)" bash "${PLUGIN_ROOT}/core/scripts/lessons-on.sh"
10
+ DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑，不要用 $(pwd) 重新推>" bash "${PLUGIN_ROOT}/core/scripts/lessons-on.sh"
11
11
  ```
12
12
  不要自己用手建 `.lessons-enabled`。
13
13
  2. stdout 是 `NOT_ENABLED`：告知這個專案還沒下過 `/devlog-tracker:start`，Lessons Mode 隸屬主開關，沒有 Round/Status 紀錄可判斷「BLOCKED→解開」，請先 `/devlog-tracker:start` 再開這個。
package/commands/pause.md CHANGED
@@ -10,7 +10,7 @@ description: 暫停這個專案的 devlog 強制記錄機制。不會刪除任
10
10
 
11
11
  ```bash
12
12
  PLUGIN_ROOT="${DEVLOG_TRACKER_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"
13
- DEVLOG_PROJECT_DIR="$(pwd)" bash "${PLUGIN_ROOT}/core/scripts/pause-devlog.sh"
13
+ DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑，不要用 $(pwd) 重新推>" bash "${PLUGIN_ROOT}/core/scripts/pause-devlog.sh"
14
14
  ```
15
15
  ```
16
16
  不要自己刪 `.enabled`。
package/commands/report.md CHANGED
@@ -6,7 +6,7 @@ description: 查看 devlog 統計：Round 數、各 Status、BLOCKED 比例、Ch
6
6
 
7
7
  ```bash
8
8
  PLUGIN_ROOT="${DEVLOG_TRACKER_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"
9
- DEVLOG_PROJECT_DIR="$(pwd)" bash "${PLUGIN_ROOT}/core/scripts/report-devlog.sh"
9
+ DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑，不要用 $(pwd) 重新推>" bash "${PLUGIN_ROOT}/core/scripts/report-devlog.sh"
10
10
  ```
11
11
 
12
12
  使用者要看所有 branch 的合計時加 `--all-branches`。
package/commands/segment-watch.md CHANGED
@@ -10,7 +10,7 @@ description: 調整 Segment Watch 的沉默門檻——同一輪連續多久沒
10
10
 
11
11
  ```bash
12
12
  PLUGIN_ROOT="${DEVLOG_TRACKER_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"
13
- DEVLOG_PROJECT_DIR="$(pwd)" bash "${PLUGIN_ROOT}/core/scripts/segment-watch-set.sh" <seconds>
13
+ DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑，不要用 $(pwd) 重新推>" bash "${PLUGIN_ROOT}/core/scripts/segment-watch-set.sh" <seconds>
14
14
  ```
15
15
  ```
16
16
 
package/commands/span.md CHANGED
@@ -5,9 +5,9 @@ description: 開啟或關閉 Span Mode，讓自動續接的長任務定期記錄
5
5
  先判斷使用者要開啟或關閉：
6
6
 
7
7
  - 使用者明確要求關閉，或 `.devlog/.span-open` 已存在且沒有明確要求重新開啟：
8
- 先決定 plugin 根目錄（有 `DEVLOG_TRACKER_ROOT` 用它；否則用 `CLAUDE_PLUGIN_ROOT`；兩者都空就用含 `.claude-plugin/plugin.json` 的本 plugin 根目錄），設 `PLUGIN_ROOT="${DEVLOG_TRACKER_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"`，再跑 `DEVLOG_PROJECT_DIR="$(pwd)" bash "${PLUGIN_ROOT}/core/scripts/span-close.sh"`，
8
+ 先決定 plugin 根目錄（有 `DEVLOG_TRACKER_ROOT` 用它；否則用 `CLAUDE_PLUGIN_ROOT`；兩者都空就用含 `.claude-plugin/plugin.json` 的本 plugin 根目錄），設 `PLUGIN_ROOT="${DEVLOG_TRACKER_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"`，再跑 `DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑，不要用 $(pwd) 重新推>" bash "${PLUGIN_ROOT}/core/scripts/span-close.sh"`，
9
9
  再依 SKILL 的 span 收尾規則寫一個**新的 Round**，總結整段 span。
10
10
  - 使用者要求開啟：先把目前 Round 正常寫完，`Status` 設為 `IN_PROGRESS`，再跑
11
- `DEVLOG_PROJECT_DIR="$(pwd)" bash "${PLUGIN_ROOT}/core/scripts/span-open.sh"`。
11
+ `DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑，不要用 $(pwd) 重新推>" bash "${PLUGIN_ROOT}/core/scripts/span-open.sh"`。
12
12
 
13
13
  不要手寫 `.span-open` JSON。腳本 exit 1 時顯示 stderr，停止操作。
package/commands/start.md CHANGED
@@ -7,7 +7,7 @@ description: 啟動這個專案的 devlog 強制記錄機制。之後每一輪
7
7
  1. 先決定 plugin 根目錄（有 `DEVLOG_TRACKER_ROOT` 用它；否則用 `CLAUDE_PLUGIN_ROOT`；兩者都空就用含 `.claude-plugin/plugin.json` 的本 plugin 根目錄）：
8
8
  ```bash
9
9
  PLUGIN_ROOT="${DEVLOG_TRACKER_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"
10
- DEVLOG_PROJECT_DIR="$(pwd)" bash "${PLUGIN_ROOT}/core/scripts/start-devlog.sh"
10
+ DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑，不要用 $(pwd) 重新推>" bash "${PLUGIN_ROOT}/core/scripts/start-devlog.sh"
11
11
  ```
12
12
  不要自己用手建 `.enabled` / `.checkpoint-state` / `.segment-state`。
13
13
  2. 若 stdout 有 `GITIGNORE_DEVLOG=no`：鄭重提醒——`.devlog/` 會寫入使用者原文（遮罩只覆蓋常見 token 前綴，不是通用掃密）。**強烈建議**把 `.devlog/` 加進專案 `.gitignore`。問要不要現在加。只有使用者明確說要，才在 `.gitignore` 末尾追加一行 `.devlog/`（檔案不存在就建立）。不要改其他行。若使用者拒絕，再警告一次「之後若不小心 commit，prompt／殘留密鑰可能進版控」，然後繼續步驟 3。
package/commands/status.md CHANGED
@@ -8,7 +8,7 @@ description: 查看這個專案 devlog 強制記錄是否開著、span / checkpo
8
8
 
9
9
  ```bash
10
10
  PLUGIN_ROOT="${DEVLOG_TRACKER_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"
11
- DEVLOG_PROJECT_DIR="$(pwd)" bash "${PLUGIN_ROOT}/core/scripts/status-devlog.sh"
11
+ DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑，不要用 $(pwd) 重新推>" bash "${PLUGIN_ROOT}/core/scripts/status-devlog.sh"
12
12
  ```
13
13
  ```
14
14
  把 stdout 翻譯成給人看的幾行（含 `LESSONS=yes/no`：Lessons Mode 開關狀態；`LESSONS_ADVISORY=<count>/<threshold>`：Lessons Mode 開著時，機制性訊號（工作區漂移不符、或
package/commands/timeline.md CHANGED
@@ -6,7 +6,7 @@ description: 把 devlog 產生成一份離線可開的 HTML 時間軸（.devlog/
6
6
 
7
7
  ```bash
8
8
  PLUGIN_ROOT="${DEVLOG_TRACKER_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"
9
- DEVLOG_PROJECT_DIR="$(pwd)" bash "${PLUGIN_ROOT}/core/scripts/timeline-devlog.sh"
9
+ DEVLOG_PROJECT_DIR="<專案根目錄絕對路徑，不要用 $(pwd) 重新推>" bash "${PLUGIN_ROOT}/core/scripts/timeline-devlog.sh"
10
10
  ```
11
11
 
12
12
  使用者要看所有 branch 時加 `--all-branches`；要寫到別的位置時加 `--out <路徑>`。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "devlog-tracker",
3
- "version": "0.33.2",
3
+ "version": "0.33.3",
4
4
  "description": "npx installer for devlog-tracker's Claude Code, Cursor and Codex adapters.",
5
5
  "bin": {
6
6
  "devlog-tracker": "bin/devlog-tracker.js"