task-ledger 1.3.6 → 1.3.8

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: task-ledger
 description: 本地任务台账，跨会话记录在办任务的归属、进度与起止。当用户要登记一件新的事（新建任务 / 建个坑 / 这活我领了）、记录已有任务的进展（接着做 / 记一条进展 / 这轮先记下）、查看任务状态或历史（现在该做什么 / 这活谁在做 / 上周做过什么）、给任务结案或退回（做完了 / 验收通过 / 不做了 / 退回待认领）、整理标签或检查台账一致性时加载；只是改代码、讨论方案时不要用。
-version: 1.3.6
+version: 1.3.8
 allowed-tools: Read,Edit,Bash,Grep
 ---
 
@@ -13,6 +13,20 @@ allowed-tools: Read,Edit,Bash,Grep
 - **任务状态**：`待认领（open）` = 建了还没人认领；`进行中（doing）` = 已认领、在做；`已结案` = 用户明确说结束后由 `close` 产生，此后只读。
 - **操作方式**：台账的状态与归属只经命令改；唯一能手写的是过程文档前五节（见「手写边界」）。台账只记「建 / 做 / 结」和指向过程文档的链接；产出物本身按项目自己的约定落盘。
 
+## 身份闸门（未初始化时怎么走）
+
+**任何命令返回「这台机器还没有初始化身份」⇒ 一律停下，不许绕。** 身份是用户自己的，不是你的决定。
+
+- **查询类**（`list` / `show` / `history` / `validate`）：什么都不做。把 init 命令交给用户，等 ta 跑完再重试原命令。
+- **写入类**（`new` / `claim` / `set` / `log` / `close`）：不建、不改、不推送。先裸跑一次 `init`（只读，只把名册里已有的身份报出来）：
+  - **有名单** ⇒ 「名册里已有这些身份：<uuid 名字>。确定哪个是你的，就自己在终端跑 `init --claim <uuid>` 选它；都不是就 `init --new --name <名字>` 新建。」**报给用户，让 ta 选。**
+  - **没名单** ⇒ 「名册为空，请在终端 `init --new --name <名字>` 新建。」
+- **禁止（硬规则）**：
+  - **不替用户执行** `init --claim` / `init --new` / `init --name` —— 挑哪个身份是用户的事；
+  - **不读** `ledger/*.json`、worklog 去"自己看"；
+  - 未初始化时**不做任何写**。
+- `init` 的写操作只能由用户在终端交互执行（脚本对无终端调用直接报错）；agent **唯一**可跑的 `init` 是不带参数、只报名单的只读形式。
+
 ## 手写边界
 
 - **唯一能手写的是任务的过程文档（worklog）前五节**（怎么写见「过程文档」节）；末节「执行记录」由脚本维护，**禁止手写、禁止手工添加**。
@@ -31,7 +45,7 @@ allowed-tools: Read,Edit,Bash,Grep
 | `--claim <uuid>` | 认领名册里已有的 uuid（名字一起复制） |
 | `--new --name "…"` | 新建身份：生成 uuid + 名字 |
 
-干什么：写本机身份文件（`~/.taskledger/identity.json`），**一台机器只一次**，与台账无关。全新机器或新项目没有名册 ⇒ 直接用 `init --new --name "<名字>"`，裸跑 `init` 会报「新建身份必须输入一个名字」。
+干什么：写本机身份文件（`~/.taskledger/identity.json`），**一台机器只一次**，与台账无关。在终端里**裸跑 `init` 即交互式**：读当前仓库名册——有候选就列出来让你**选编号认领**（或输 `n` 新建），名册为空就让你**输入用户名**；全程要真终端。`--claim <uuid>` / `--new --name "<名字>"` 也只接受真终端，agent 的无终端调用会被脚本拒绝。
 
 ### new — 建任务
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "task-ledger",
-	"version": "1.3.6",
+	"version": "1.3.8",
 	"description": "Task-ledger skill for coding agents: per-workspace progress tracking (ledger/pool.json + owners/<hash>.json shards + owners.json index, 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/scripts/ledgerkit/shell/cli.py

@@ -269,8 +269,29 @@ def _lock_dir(repo: Path) -> Path:
     return lock_dir
 
 
+def _print_candidates(opts: list[dict]) -> None:
+    print("这台机器还没初始化。当前仓库里已有的用户：")
+    for i, opt in enumerate(opts, 1):
+        print(f"  {i}. {opt['uuid']}  {opt['name']}")
+
+
+def _print_init_result(res: dict) -> None:
+    if res.get("already"):
+        print(
+            f"已经初始化过，未做改动：{res['name'] or res['uuid'][:8]}（{res['uuid']}）"
+        )
+        print(f"文件：{res['path']}")
+        return
+    print(f"已初始化：{res['name'] or res['uuid'][:8]}（{res['uuid']}）")
+    print(f"文件：{res['path']}")
+
+
 def _run_init(args: argparse.Namespace) -> int:
-    """init 不进 runner、不解析台账、不碰 git：只写机器身份文件。"""
+    """init 不进 runner、不解析台账、不碰 git：只写机器身份文件。
+
+    交互式：裸 init 在真终端读名册、问用户选 / 输名字；无终端（agent）只报候选、不写。
+    """
+    from .. import env
     from ..actions.init_identity import init_identity
 
     repo: Path | None = None
@@ -279,30 +300,56 @@ def _run_init(args: argparse.Namespace) -> int:
         repo = as_root(raw, source="--repo") if raw else root_of(Path.cwd().resolve())
     except Fail:
         repo = None
+    claim = getattr(args, "claim", None)
+    new = bool(getattr(args, "new_id", False))
+    name = (getattr(args, "name", "") or "").strip()
+    tty = sys.stdin.isatty()
+
     try:
-        res = init_identity(
-            repo,
-            claim=getattr(args, "claim", None),
-            new=bool(getattr(args, "new_id", False)),
-            name=getattr(args, "name", "") or "",
-        )
+        existing = env.read_identity()
+        if existing is not None:
+            # 已初始化：幂等空转（带不带 flag 都一样，零写）
+            res = init_identity(repo, claim=claim, new=new, name=name)
+        elif claim or new or name:
+            # flag 写操作：只接受真终端；agent 无终端调不动（2026-10-26 事故）
+            if not tty:
+                raise Fail(
+                    "写入身份必须由用户在终端里交互执行（当前没有终端）。\n"
+                    "  处理：请用户在终端运行 `python3 progress.py init --repo <工作区根>`，\n"
+                    "  它会列出已有身份供选择，或让 ta 输入一个新名字。"
+                )
+            res = init_identity(repo, claim=claim, new=new, name=name)
+        else:
+            # 裸 init：先看名册
+            res = init_identity(repo, claim=None, new=False, name="")
+            if res.get("need_choose"):
+                opts = res.get("options", [])
+                if not tty:
+                    _print_candidates(opts)
+                    print(
+                        "请重跑：init --claim=<uuid>  认领，或  init --new --name=<名字>  新建"
+                    )
+                    return 0
+                _print_candidates(opts)
+                choice = input("选编号认领，或输入 n 新建：").strip()
+                if choice.lower() == "n":
+                    prompt_name = input("输入用户名：").strip()
+                    res = init_identity(repo, claim=None, new=True, name=prompt_name)
+                else:
+                    res = init_identity(
+                        repo, claim=opts[int(choice) - 1]["uuid"], new=False, name=""
+                    )
+            else:
+                # 名册空：交互输入名字；非终端交给用户去终端跑（init_identity 会报需要名字）
+                prompt_name = input("输入用户名：").strip() if tty else ""
+                res = init_identity(repo, claim=None, new=tty, name=prompt_name)
     except Fail as exc:
         render.fail_message(exc)
         return BUSINESS
-    if res.get("need_choose"):
-        print("这台机器还没初始化。当前仓库里已有的用户：")
-        for opt in res.get("options", []):
-            print(f"  {opt['uuid']}  {opt['name']}")
-        print("请重跑：init --claim=<uuid>  认领，或  init --new --name=<名字>  新建")
-        return 0
-    if res.get("already"):
-        print(
-            f"已经初始化过，未做改动：{res['name'] or res['uuid'][:8]}（{res['uuid']}）"
-        )
-        print(f"文件：{res['path']}")
-        return 0
-    print(f"已初始化：{res['name'] or res['uuid'][:8]}（{res['uuid']}）")
-    print(f"文件：{res['path']}")
+    except (ValueError, IndexError):
+        render.fail_message(Fail("输入无效，初始化已取消。"))
+        return BUSINESS
+    _print_init_result(res)
     return 0