dsh-task-ledger 0.1.5 → 0.1.8

package/dist/host/repositories/runner.js

@@ -2,14 +2,25 @@ import { spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { IdentityMissingError } from "../errors.js";
 /**
- * 内嵌 skill 入口的默认路径：dist/host/repositories/runner.js → 包根 skill/scripts/progress
- * （比原 host/script.js 深一层 ⇒ 相对路径多一级 `../`）。
+ * 内嵌 skill 的平台入口：dist/host/repositories/runner.js → 包根 skill/scripts（比原
+ * host/script.js 深一层 ⇒ 相对路径多一级 `../`）。
+ *
+ * POSIX：`scripts/progress` 这个薄 shell 包装，按平台 exec `scripts/bin/ledger-<os>-<arch>`
+ * （自带运行时的静态二进制）——所以本插件不需要系统装任何运行时。
+ *
+ * Windows：不能起这个包装。CreateProcessW 不执行无扩展名的 sh 脚本，还会按扩展名补
+ * `.exe` 去找 `scripts/progress.exe`，结果就是 spawn ENOENT（issue #1）⇒ 直接起
+ * `scripts/bin/` 下的静态二进制。Windows 资产目前只有 amd64 一份，Intel 与 ARM64 都能跑。
  *
- * 这是个薄 shell 包装，按平台 exec `skill/scripts/bin/ledger-<os>-<arch>`（自带运行时的
- * 静态二进制）——所以本插件不需要系统装任何运行时。
  * 构建时 scripts/copy-skill.mjs 把 packages/skill 的运行时拷到 packages/plugin/skill/。
  */
-const DEFAULT_SCRIPT_PATH = fileURLToPath(new URL("../../../skill/scripts/progress", import.meta.url));
+function defaultScriptPath() {
+    if (process.platform === "win32") {
+        return fileURLToPath(new URL("../../../skill/scripts/bin/ledger-windows-amd64.exe", import.meta.url));
+    }
+    return fileURLToPath(new URL("../../../skill/scripts/progress", import.meta.url));
+}
+const DEFAULT_SCRIPT_PATH = defaultScriptPath();
 /** 单次脚本调用超时上限（ms）。实测单仓 5 万行全量 1.2s，10s 是宽松上限。 */
 const DEFAULT_TIMEOUT_MS = 10_000;
 /** 脚本绝对路径（界面上要写给用户复制的命令用；别在别处再拼一份）。 */

package/dist/host/routes.d.ts

@@ -2,7 +2,7 @@
  * 数据面路由薄壳：只做协议（参数解析 + JSON 响应 + 错误转 500），
  * 一行业务逻辑都不多写——全部调 service（2026-10-17 定稿）。
  * 宿主事实（handler = 原始 Node req/res、发头后不抛错、重复 path 注册直接 throw）
- * 见 external/host-webserver.md。
+ * 见 docs/dependencies/host-webserver.md。
  *
  * 2026-10-28 收敛：界面只有 8 个统计卡 + 在办列表 ⇒ 只注册 `/workspaces` 与 `/board/snapshot`。
  * 详情 / 历史 / 筛选项 / 趋势 / 写动作的端点与实现已删除（要接回按 skill 方法重写，不复用旧直读逻辑）。
@@ -10,7 +10,7 @@
 import type { IncomingMessage, ServerResponse } from "node:http";
 import { type AgentDefaultModelLike, type AgentPresetsLike, type AgentsLike, type SessionTitleLike } from "./services/continue.service.js";
 import type { RegistryWorkspace } from "./types.js";
-/** 宿主 webServer.register 的最小面（WebRoute 形状见 external/host-webserver.md）。 */
+/** 宿主 webServer.register 的最小面（WebRoute 形状见 docs/dependencies/host-webserver.md）。 */
 export interface WebServerLike {
     register(route: {
         kind: "exact" | "prefix";
@@ -18,7 +18,7 @@ export interface WebServerLike {
         handler: (req: IncomingMessage, res: ServerResponse) => void | Promise<void>;
     }): unknown;
 }
-/** 宿主 workspaceRegistry 的最小面（事实见 external/dsh-workspace-registry.md）。 */
+/** 宿主 workspaceRegistry 的最小面（事实见 docs/dependencies/dsh-workspace-registry.md）。 */
 export interface WorkspaceRegistryLike {
     list(): readonly RegistryWorkspace[];
 }

package/dist/host/routes.js

@@ -80,9 +80,11 @@ function sendWriteFailure(res, error) {
     }
     sendFailure(res, error);
 }
-/** 界面上给用户复制到终端的 init 命令（有工作区就带上 --repo，否则脚本找不到台账）。 */
+/** 界面上给用户复制到终端的 init 命令（有工作区就带上 --repo，否则脚本找不到台账）。
+ *  Windows 上 scriptPath() 已经是 bin 下的 exe，不能加 `sh ` 前缀。 */
 function initCommandOf(repoPath) {
-    const head = `sh "${scriptPath()}" init`;
+    const entry = scriptPath();
+    const head = process.platform === "win32" ? `"${entry}" init` : `sh "${entry}" init`;
     return repoPath === "" ? head : `${head} --repo "${repoPath}"`;
 }
 /** 换身份请求体 → 动作参数（名字 / uuid 的合法性由 skill 再判一次，这里只挡形状）。 */

package/dist/host/services/continue.service.d.ts

@@ -5,7 +5,7 @@
  * （`dsh-client-ui-conversation` `contract/input.d.ts:165`，经 `SessionInputResolver.for(actx)` 取），
  * 根级 client 插件拿不到某个会话的 `actx`；按 id 取的 `input.shell()` 是包内部件。
  * 且任务↔会话之间没有绑定字段 ⇒「往哪个会话塞」本身没有答案。链路事实见
- * `docs/design/external/dsh-session-handoff.md`，兄弟插件实证 `dsh-task-dispatch-table/src/dispatch.ts:519/562/627`。
+ * `docs/dependencies/dsh-session-handoff.md`，兄弟插件实证 `dsh-task-dispatch-table/src/dispatch.ts:519/562/627`。
  *
  * 三条硬约束（宿主 rc 线的坑，缺一条就是"会话建了但没法干活"）：
  *  1. `setup` 里必须 `agentPresets.mount()` —— 不挂 preset 的 agent 落到空的全局层，fs / bash 全无；

package/dist/host/services/continue.service.js

@@ -5,7 +5,7 @@
  * （`dsh-client-ui-conversation` `contract/input.d.ts:165`，经 `SessionInputResolver.for(actx)` 取），
  * 根级 client 插件拿不到某个会话的 `actx`；按 id 取的 `input.shell()` 是包内部件。
  * 且任务↔会话之间没有绑定字段 ⇒「往哪个会话塞」本身没有答案。链路事实见
- * `docs/design/external/dsh-session-handoff.md`，兄弟插件实证 `dsh-task-dispatch-table/src/dispatch.ts:519/562/627`。
+ * `docs/dependencies/dsh-session-handoff.md`，兄弟插件实证 `dsh-task-dispatch-table/src/dispatch.ts:519/562/627`。
  *
  * 三条硬约束（宿主 rc 线的坑，缺一条就是"会话建了但没法干活"）：
  *  1. `setup` 里必须 `agentPresets.mount()` —— 不挂 preset 的 agent 落到空的全局层，fs / bash 全无；

package/dist/host/skill/registration.d.ts

@@ -20,8 +20,7 @@ export interface SkillsRegistry {
  * 组装注册体：读内嵌 SKILL.md → 取 name / description → 正文里的脚本路径占位符
  * 替换为绝对路径。
  *
- * 相对资源解析的二选一（external/dsh-skill-registration.md §三）**未拍板**；
- * 最小闭环选「插值绝对路径」——resourceBase 的消费者呈现未验证，不押注。
- * 拍板后如改走 resourceBase，只动本函数，调用方无感。
+ * 相对资源解析见 docs/dependencies/dsh-skill-registration.md：本实现选「插值绝对路径」，
+ * resourceBase 的消费者呈现未验证，不押注。若改走 resourceBase，只动本函数，调用方无感。
  */
 export declare function buildSkillRegistration(skillDir?: string): SkillRegistration;

package/dist/host/skill/registration.js

@@ -1,6 +1,6 @@
 /**
  * 内嵌 skill 的注册体组装（任务 2「skill 注册最小闭环」）。
- * 宿主事实（0.2.0-rc.2 npm pack 亲验）：external/dsh-skill-registration.md。
+ * 宿主事实（0.2.0-rc.2 npm pack 亲验）：docs/dependencies/dsh-skill-registration.md。
  */
 import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
@@ -31,9 +31,8 @@ function parseFrontmatter(text) {
  * 组装注册体：读内嵌 SKILL.md → 取 name / description → 正文里的脚本路径占位符
  * 替换为绝对路径。
  *
- * 相对资源解析的二选一（external/dsh-skill-registration.md §三）**未拍板**；
- * 最小闭环选「插值绝对路径」——resourceBase 的消费者呈现未验证，不押注。
- * 拍板后如改走 resourceBase，只动本函数，调用方无感。
+ * 相对资源解析见 docs/dependencies/dsh-skill-registration.md：本实现选「插值绝对路径」，
+ * resourceBase 的消费者呈现未验证，不押注。若改走 resourceBase，只动本函数，调用方无感。
  */
 export function buildSkillRegistration(skillDir = SKILL_DIR) {
     const text = readFileSync(`${skillDir}/SKILL.md`, "utf-8");

package/dist/host/types.d.ts

@@ -1,8 +1,8 @@
 /**
  * 后端方法共享类型。
  * 宿主能力（workspaceRegistry / webServer 等）的结构面在 index.ts 与 routes.ts 本地声明——
- * 不 import 官方包（参考插件同款纪律：宿主 rc 接口会无声变，结构化声明 + external/ 文档坐标
- * 比绑死官方类型更稳）。
+ * 不 import 官方包（参考插件同款纪律：宿主 rc 接口会无声变，结构化声明 + `docs/dependencies/`
+ * 下的已核实事实比绑死官方类型更稳）。
  */
 import type { DegradedInfo } from "./errors.js";
 /** 一个可看的台账：机器级清单里的一条（已去掉隐藏）。 */
@@ -16,7 +16,7 @@ export interface LedgerWorkspace {
 }
 /**
  * 宿主 `workspaceRegistry.list()` 条目的最小面（结构声明；事实与坐标见
- * external/dsh-workspace-registry.md）。它现在只承担「替台账清单补登记」一件事。
+ * docs/dependencies/dsh-workspace-registry.md）。它现在只承担「替台账清单补登记」一件事。
  */
 export interface RegistryWorkspace {
     readonly id: string;

package/dist/host/types.js

@@ -1,7 +1,7 @@
 /**
  * 后端方法共享类型。
  * 宿主能力（workspaceRegistry / webServer 等）的结构面在 index.ts 与 routes.ts 本地声明——
- * 不 import 官方包（参考插件同款纪律：宿主 rc 接口会无声变，结构化声明 + external/ 文档坐标
- * 比绑死官方类型更稳）。
+ * 不 import 官方包（参考插件同款纪律：宿主 rc 接口会无声变，结构化声明 + `docs/dependencies/`
+ * 下的已核实事实比绑死官方类型更稳）。
  */
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "dsh-task-ledger",
-	"version": "0.1.5",
+	"version": "0.1.8",
 	"description": "Tasks are created, claimed, advanced and closed by the agent and written straight into a plain-text ledger in the workspace, so the owner, the current state and the next step are always on record. It is not limited to development work — research, documentation, presentations and video production all fit. No cloud service is involved: everything is managed locally. Single-user and multi-user both work, with Git synchronisation, and every action is on record. The control panel summarises in-flight, overdue and stalled work with weekly trends.",
 	"icon": "./assets/icon.svg",
 	"keywords": [
@@ -65,6 +65,6 @@
 	},
 	"dependencies": {
 		"@deepseek-ai/schemastery": "^3.18.5",
-		"dsh-plugin-core": "^0.35.3"
+		"dsh-plugin-core": "^0.35.7"
 	}
 }

package/skill/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: task-ledger
 description: 本地任务台账，跨会话记录在办任务的归属、进度与起止。当用户要登记一件新的事（新建任务 / 建个坑 / 这活我领了）、记录已有任务的进展（接着做 / 记一条进展 / 这轮先记下）、查看任务状态或历史（现在该做什么 / 这活谁在做 / 上周做过什么）、给任务结案 / 取消作废 / 退回（做完了 / 验收通过 / 取消 / 作废 / 退回待认领）、删除建错的或垃圾任务（只认「删除」二字）、整理标签或检查台账一致性时加载；同一件事做了多轮、用户始终没提记账时也加载，问一句要不要建台账（只提醒一次，无需就忽略）。
-version: 1.3.57
+version: 1.3.58
 allowed-tools: Read,Edit,Bash,Grep
 ---
 
@@ -319,6 +319,7 @@ allowed-tools: Read,Edit,Bash,Grep
 - **不需要安装任何东西**（不装解释器、不装运行时、不往 PATH 里加命令）：直接执行上面那条绝对路径即可。
 - 若报 `Permission denied`（某些安装环节会丢可执行位），前面加 `sh `：`sh <本 SKILL.md 所在目录>/scripts/progress <子命令> …`。
 - **交给用户的命令必须是这个绝对路径**，不许简写成 `progress` —— 用户机器的 PATH 里没有这个命令，简写后用户一跑就是 `command not found`。
+- **Windows 上直接跑 `scripts/bin/ledger-windows-amd64.exe`**：`scripts/progress` 是无扩展名的 sh 包装，CreateProcessW 不会执行它（还会按扩展名补 `.exe` 去找 → 报找不到）。同一目录下的 exe 参数完全一致；Git Bash / WSL 里仍可用 `scripts/progress`。
 
 - 定位项目：`--repo <工作区根>`（**直接含有 `ledger/` 的那个目录**）给了就校验后用；不给就从当前目录逐级向上找。当前目录已经在这个工作区里时不要带 `--repo`，只有要操作别的工作区才带。`ledger/` 本身、以及它下面的任何子目录都不是根，指过去会被直接拒绝（判据只看位置，不看目录里有哪些文件 —— 项目根自带 `pool.json`、`history/`、`worklog/` 都不影响）。
 - `--no-sync`（放在子命令**前**）：用户明确要求「先别同步」时才用；之后自己 `git add ledger && commit && push`。

package/skill/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "task-ledger",
-	"version": "1.3.57",
+	"version": "1.3.58",
 	"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",