task-ledger 1.2.2 → 1.2.3

package/README.md

@@ -192,7 +192,8 @@ stateDiagram-v2
     note right of doing
         set --owner 交接：owner 换成别人
         （只有当前 owner 能执行）
-        阻塞 = 接任务满 7 天；停滞 = 最后更新满 3 天
+        超期 = 接任务满 14 天；停滞 = 最后更新满 3 天
+        积压 = 待认领满 30 天
         （都由看板按时间算，不是状态）
     end note
 ```

package/SKILL.md

@@ -34,7 +34,7 @@ allowed-tools: Read,Write,Bash,Grep
 | 「谁在做 X」「有哪些在办」 | `list`；在等认领的加 `--status open` |
 | 「这个任务到哪一步了」「这轮做了什么」 | `show --id`（任务 JSON + worklog 全文） |
 | 「某件老活什么时候做的」「谁做过哪些活」 | `history`（可按 `--owner` / `--since` 筛） |
-| 「哪些任务停太久」 | `list --json`：`updated` 满 3 天＝停滞、`started` 满 7 天＝阻塞（看板算，别改状态） |
+| 「哪些任务停太久」 | `list --json`：`updated` 满 3 天＝停滞、`started` 满 14 天＝超期、`created` 满 30 天仍 `open`＝积压（看板算，别改状态） |
 | 「新建一个任务」 | `new`（`--self` = 建完即认领） |
 | 「这活我领了」 | `claim`（只对 `open` 有效） |
 | 「开始做 / 接着做 X」 | 还是 `open` 就先 `claim`；已是 `doing` 就直接改正文 + `log` |
@@ -61,7 +61,7 @@ python3 <本 SKILL.md 所在目录>/scripts/progress.py <子命令> --repo <当
 
 ## 铁律
 
-- **状态只有 `open` / `doing`**；`done` 只能由 `close` 产生。**没有 `blocked` 状态**：阻塞 = `started` 满 7 天、停滞 = `updated` 满 3 天，都由看板按时间算，`progress.json` 里不存、不手改；卡在哪写进正文。
+- **状态只有 `open` / `doing`**；`done` 只能由 `close` 产生。**没有 `blocked` 状态**：超期 = `started` 满 14 天、停滞 = `updated` 满 3 天、积压 = `created` 满 30 天且仍 `open`，都由看板按时间算，`progress.json` 里不存、不手改；卡在哪写进正文。
 - **`log` 就是刷新 `updated` 的动作**：该记不记，任务会被看板标成停滞。
 - **owner = 当前 `git config user.name`**，不能由外部传入；读不到就报错（先让用户配 git）。**只能动自己名下**的任务（`open` 的先 `claim`），不是你的直接拒绝 —— 不要绕过脚本改 JSON。
 - **换人只能「释放 → 认领」**：skill 不提供交接，随便写的名字都是假的。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "task-ledger",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "Task-ledger skill for coding agents: per-workspace progress tracking (ledger/progress.json, history, worklog) driven by a CLI script. Standalone install for CodeBuddy and other agents; also bundled inside the dsh-task-ledger DSH plugin.",
   "keywords": [
     "skill",

package/references/state-model.md

@@ -1,6 +1,6 @@
 # 状态与时间模型
 
-> TL;DR：状态只有 `open` / `doing`；`done` 由 `close` 产生。阻塞 = `started` 满 7 天、停滞 = `updated` 满 3 天，看板算、不存字段。`updated` 由 `new/claim/set/log` 刷新。owner 只取当前 git 身份。
+> TL;DR：状态只有 `open` / `doing`；`done` 由 `close` 产生。超期 = `started` 满 14 天、停滞 = `updated` 满 3 天、积压 = `created` 满 30 天仍 `open`，看板算、不存字段。`updated` 由 `new/claim/set/log` 刷新。owner 只取当前 git 身份。
 
 ## 状态机
 
@@ -12,15 +12,16 @@ doing ──set --status open──> open          # 释放认领，执行记录
 - `open`：已建、等认领。`doing`：已认领、在做。`done` 只由 `close` 产生。
 - **没有 `blocked` 状态**（2026-10-19 取消）。旧数据里残留的 `blocked` 读侧当进行中：`list --status blocked` 可捞出，用 `set --status doing` 归位；新写入一律拒绝。
 
-## 两个标记（看板计算，不是状态）
+## 三个标记（看板计算，不是状态）
 
 | 标记 | 依据 | 阈值 |
 |---|---|---|
-| 阻塞 | `started`（接任务）至今，中途更新不影响 | 满 7 天 |
+| 积压 | `created`（建了）至今仍 `open`（没人认领） | 满 30 天 |
+| 超期 | `started`（接任务）至今，中途更新不影响 | 满 14 天 |
 | 停滞 | `updated`（最后推进）至今 | 满 3 天 |
 
-- 真源：`packages/plugin/src/host/services/home.service.ts` 的 `OVERDUE_DAYS = 7` / `STALE_DAYS = 3`；看板随响应下发 `staleDays`，界面文案不硬编码。
-- 脚本不算这两个值，`progress.json` 里也不存；agent 要回答「哪些停太久」时用 `list --json` 的 `updated` / `started` 与当前时间比。
+- 真源：`packages/plugin/src/host/services/home.service.ts` 的 `BACKLOG_DAYS = 30` / `OVERDUE_DAYS = 14` / `STALE_DAYS = 3`；看板随响应下发三个天数，界面文案不硬编码。
+- 脚本不算这三个值，`progress.json` 里也不存；agent 要回答「哪些停太久」时用 `list --json` 的 `created` / `updated` / `started` 与当前时间比。
 - 老数据没有 `updated` 时，读侧回退到 `started`，再到 `created`。
 
 ## 时间

package/scripts/progress.py

@@ -38,7 +38,7 @@ except ImportError:
     msvcrt = None
 
 STATUSES = ("open", "doing")
-# 旧数据只读兼容：早期版本有 blocked 状态（手动标「卡住」）。现在阻塞按时间判定
+# 旧数据只读兼容：早期版本有 blocked 状态（手动标「卡住」）。现在超期按时间判定
 # （接任务满 7 天），不再允许新写入；list / validate / 看板仍能吃老文件。
 LEGACY_STATUSES = ("blocked",)
 PROGRESS_REL = Path("ledger/progress.json")
@@ -1364,7 +1364,7 @@ def cmd_set(args: argparse.Namespace) -> None:
         )
     if status == "blocked":
         raise Fail(
-            "没有 blocked 状态：阻塞由时间自动判定（接任务满 7 天仍未结案），"
+            "没有 blocked 状态：超期由时间自动判定（接任务满 14 天仍未结案），"
             "状态只有 open / doing；卡在哪里请写进 worklog。"
         )
     if status == "done":