task-ledger 1.3.7 → 1.3.9

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: task-ledger
 description: 本地任务台账，跨会话记录在办任务的归属、进度与起止。当用户要登记一件新的事（新建任务 / 建个坑 / 这活我领了）、记录已有任务的进展（接着做 / 记一条进展 / 这轮先记下）、查看任务状态或历史（现在该做什么 / 这活谁在做 / 上周做过什么）、给任务结案或退回（做完了 / 验收通过 / 不做了 / 退回待认领）、整理标签或检查台账一致性时加载；只是改代码、讨论方案时不要用。
-version: 1.3.7
+version: 1.3.9
 allowed-tools: Read,Edit,Bash,Grep
 ---
 
@@ -45,7 +45,7 @@ allowed-tools: Read,Edit,Bash,Grep
 | `--claim <uuid>` | 认领名册里已有的 uuid（名字一起复制） |
 | `--new --name "…"` | 新建身份：生成 uuid + 名字 |
 
-干什么：写本机身份文件（`~/.taskledger/identity.json`），**一台机器只一次**，与台账无关。**写操作只能由用户在终端里执行**（无终端调用会被脚本拒绝）；agent 只许裸跑 `init`（只读、把候选报给用户），不得代跑 `--claim` / `--new` / `--name`。名册为空时裸跑 `init` 会报「新建身份必须输入一个名字」，此时让用户自己 `init --new --name "<名字>"` 新建。
+干什么：写本机身份文件（`~/.taskledger/identity.json`），**一台机器只一次**，与台账无关。在终端里**裸跑 `init` 即交互式选择框**：读当前仓库名册，用**上下箭头**移动、**Enter** 认领某个身份，末尾「＋ 新建身份」可输入新用户名自建；名册为空则直接让你输入用户名；全程要真终端。`--claim <uuid>` / `--new --name "<名字>"` 也只接受真终端，agent 的无终端调用会被脚本拒绝。
 
 ### new — 建任务
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "task-ledger",
-	"version": "1.3.7",
+	"version": "1.3.9",
 	"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,103 @@ 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['name']}   {opt['uuid']}")
+
+
+def _print_init_result(res: dict) -> None:
+    name_disp = res.get("name") or res["uuid"][:8]
+    if res.get("already"):
+        print(f"已经初始化过，未做改动：@{name_disp}   {res['uuid']}")
+        print(f"文件：{res['path']}")
+        return
+    print(f"\x1b[32m✓ 已初始化：\x1b[0m@{name_disp}   {res['uuid']}")
+    print(f"文件：{res['path']}")
+
+
+def _select_identity(opts: list[dict], *, title: str) -> tuple[str, int | None]:
+    """交互选身份：箭头上下移动，末尾「＋ 新建身份」，Enter 确认，Ctrl-C 取消。
+    返回 (kind, index)：kind∈{claim,new,cancel}；claim/new 时 index 为候选项下标。
+    TTY 下走 raw 光标选择；不支持 raw（非 Unix / 无 TTY）时退回编号输入。仅在 TTY 调用。
+    """
+    entries = list(opts) + [{"new": True}]
+    n = len(entries)
+
+    try:
+        fd = sys.stdin.fileno()
+        if not sys.stdin.isatty():
+            raise OSError("not a tty")
+        import termios
+        import tty
+
+        old = termios.tcgetattr(fd)
+        sel = 0
+        try:
+            tty.setraw(fd)
+            while True:
+                sys.stdout.write("\x1b[H\x1b[J")
+                sys.stdout.write("\x1b[1;36m" + title + "\x1b[0m\n\n")
+                for i, e in enumerate(entries):
+                    label = (
+                        "＋ 新建身份（自己输入名字）"
+                        if e.get("new")
+                        else f"@{e['name']}   {e['uuid']}"
+                    )
+                    if i == sel:
+                        sys.stdout.write("  \x1b[7m ❯ " + label + " \x1b[0m\n")
+                    else:
+                        sys.stdout.write("    " + label + "\n")
+                sys.stdout.write(
+                    "\n  \x1b[2m↑/↓ 移动 · Enter 确认 · Ctrl-C 退出\x1b[0m\n"
+                )
+                sys.stdout.flush()
+                ch = sys.stdin.read(1)
+                if ch == "\x1b":
+                    nxt = sys.stdin.read(1)
+                    if nxt in ("[", "O"):
+                        k = sys.stdin.read(1)
+                        if k == "A":
+                            sel = (sel - 1) % n
+                        elif k == "B":
+                            sel = (sel + 1) % n
+                elif ch in ("\r", "\n"):
+                    return ("new", None) if entries[sel].get("new") else ("claim", sel)
+                elif ch == "\x03":  # Ctrl-C
+                    return ("cancel", None)
+        finally:
+            termios.tcsetattr(fd, termios.TCSADRAIN, old)
+            sys.stdout.write("\x1b[2J\x1b[H")
+            sys.stdout.flush()
+    except (OSError, ImportError):
+        print(title)
+        for i, o in enumerate(opts, 1):
+            print(f"  {i}. @{o['name']}   {o['uuid']}")
+        print(f"  {n}. ＋ 新建身份")
+        while True:
+            try:
+                c = input(f"选编号(1-{n})：").strip()
+            except (EOFError, KeyboardInterrupt):
+                return ("cancel", None)
+            if c.lower() == "n":
+                return ("new", None)
+            try:
+                idx = int(c) - 1
+            except ValueError:
+                continue
+            if idx == len(opts):
+                return ("new", None)
+            if 0 <= idx < len(opts):
+                return ("claim", idx)
+    return ("cancel", None)
+
+
 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
 
@@ -282,38 +377,61 @@ def _run_init(args: argparse.Namespace) -> int:
         repo = None
     claim = getattr(args, "claim", None)
     new = bool(getattr(args, "new_id", False))
-    name = getattr(args, "name", "") or ""
+    name = (getattr(args, "name", "") or "").strip()
+    tty = sys.stdin.isatty()
+
     try:
-        # 首次写身份只能由用户在真终端交互完成：agent 的 subprocess 没有 TTY，
-        # 放行就等于让它替用户挑一个身份写进本机（2026-10-26 事故）。
-        if (
-            env.read_identity() is None
-            and (claim or new or name.strip())
-            and not sys.stdin.isatty()
-        ):
-            raise Fail(
-                "写入身份必须由用户在终端里交互执行（当前没有终端）。\n"
-                "  处理：请用户在终端运行 `python3 progress.py init --repo <工作区根>`，\n"
-                "  它会列出已有身份供选择，或让 ta 输入一个新名字。"
-            )
-        res = init_identity(repo, claim=claim, new=new, name=name)
+        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
+                kind, idx = _select_identity(
+                    opts, title="这台机器还没初始化。选择你的身份，或新建一个："
+                )
+                if kind == "cancel":
+                    print("已取消初始化。")
+                    return BUSINESS
+                if kind == "new":
+                    prompt_name = input("输入用户名：").strip()
+                    if not prompt_name:
+                        print("未输入用户名，已取消。")
+                        return BUSINESS
+                    res = init_identity(repo, claim=None, new=True, name=prompt_name)
+                else:
+                    res = init_identity(
+                        repo, claim=opts[idx]["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