dsh-task-ledger 0.0.62 → 0.0.64

package/dist/host/repositories/runner.d.ts

@@ -5,19 +5,38 @@ export type LedgerScriptResult<T> = {
     ok: false;
     error: string;
 };
+/** 写命令的返回：只收 stdout 原文（claim / set 打的是人话，不是 JSON）。 */
+export type LedgerCommandResult = {
+    ok: true;
+    output: string;
+} | {
+    ok: false;
+    error: string;
+};
+export interface RunOptions {
+    /** 测试用：覆盖脚本路径。 */
+    scriptPath?: string;
+    /** 覆盖超时。 */
+    timeoutMs?: number;
+    /**
+     * 子进程 cwd。写命令（claim / set）必须落在工作区：
+     * 脚本内的 owner 取 `git config user.name`，走进程 cwd 而不是 `--repo`。
+     */
+    cwd?: string;
+}
 /**
- * 全插件唯一碰 Python 的地方：spawn python3 跑内嵌 skill 脚本，收 stdout JSON。
+ * 读命令：spawn python3 跑内嵌 skill 脚本，收 stdout JSON。
  * 不解析任何台账格式——解析真源只有 skill 脚本一份（2026-10-17 用户拍板）。
  *
- * 出错一律归一为 { ok:false, error }（人话，直接可上界面）：
- * 起不了 python3 / 超时（kill）/ 非零退出（stderr 原文）/ 输出不是 JSON。
- *
  * @param sub - 子命令（list / history / show…）
  * @param args - 参数数组，由调用方自拼（含 --repo / --json / --months 等）
  * @param opts.scriptPath - 测试用：覆盖脚本路径
  * @param opts.timeoutMs - 覆盖超时
+ * @param opts.cwd - 子进程工作目录（写命令取 git 身份用）
  */
-export declare function runLedgerScript<T = unknown>(sub: string, args: readonly string[], opts?: {
-    scriptPath?: string;
-    timeoutMs?: number;
-}): Promise<LedgerScriptResult<T>>;
+export declare function runLedgerScript<T = unknown>(sub: string, args: readonly string[], opts?: RunOptions): Promise<LedgerScriptResult<T>>;
+/**
+ * 写命令（claim / set）：同样是 spawn python3，但**不解析 JSON**——这些子命令打的是人话，
+ * 成功与否看退出码，失败时 stderr 就是能直接上界面的人话。
+ */
+export declare function runLedgerCommand(sub: string, args: readonly string[], opts?: RunOptions): Promise<LedgerCommandResult>;

package/dist/host/repositories/runner.js

@@ -9,22 +9,14 @@ const DEFAULT_SCRIPT_PATH = fileURLToPath(new URL('../../../skill/scripts/progre
 /** 单次脚本调用超时上限（ms）。实测单仓 5 万行全量 1.2s，10s 是宽松上限。 */
 const DEFAULT_TIMEOUT_MS = 10_000;
 /**
- * 全插件唯一碰 Python 的地方：spawn python3 跑内嵌 skill 脚本，收 stdout JSON。
- * 不解析任何台账格式——解析真源只有 skill 脚本一份（2026-10-17 用户拍板）。
- *
- * 出错一律归一为 { ok:false, error }（人话，直接可上界面）：
- * 起不了 python3 / 超时（kill）/ 非零退出（stderr 原文）/ 输出不是 JSON。
- *
- * @param sub - 子命令（list / history / show…）
- * @param args - 参数数组，由调用方自拼（含 --repo / --json / --months 等）
- * @param opts.scriptPath - 测试用：覆盖脚本路径
- * @param opts.timeoutMs - 覆盖超时
+ * 起一次 python3、收 stdout / stderr。出错一律归一成人话（起不了 python3 / 超时 / 非零退出）。
+ * 解析留给调用方：读命令要 JSON，写命令要原文。
  */
-export function runLedgerScript(sub, args, opts) {
+function exec(sub, args, opts) {
     const scriptPath = opts?.scriptPath ?? DEFAULT_SCRIPT_PATH;
     const timeoutMs = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     return new Promise((resolve) => {
-        const child = spawn('python3', [scriptPath, sub, ...args], { stdio: ['ignore', 'pipe', 'pipe'] });
+        const child = spawn('python3', [scriptPath, sub, ...args], { cwd: opts?.cwd, stdio: ['ignore', 'pipe', 'pipe'] });
         let stdout = '';
         let stderr = '';
         let settled = false;
@@ -49,12 +41,36 @@ export function runLedgerScript(sub, args, opts) {
                 settle({ ok: false, error: stderr.trim() || `skill 脚本退出码 ${String(code)}` });
                 return;
             }
-            try {
-                settle({ ok: true, data: JSON.parse(stdout) });
-            }
-            catch {
-                settle({ ok: false, error: `skill 脚本输出不是 JSON：${stdout.slice(0, 200)}` });
-            }
+            settle({ ok: true, stdout });
         });
     });
 }
+/**
+ * 读命令：spawn python3 跑内嵌 skill 脚本，收 stdout JSON。
+ * 不解析任何台账格式——解析真源只有 skill 脚本一份（2026-10-17 用户拍板）。
+ *
+ * @param sub - 子命令（list / history / show…）
+ * @param args - 参数数组，由调用方自拼（含 --repo / --json / --months 等）
+ * @param opts.scriptPath - 测试用：覆盖脚本路径
+ * @param opts.timeoutMs - 覆盖超时
+ * @param opts.cwd - 子进程工作目录（写命令取 git 身份用）
+ */
+export async function runLedgerScript(sub, args, opts) {
+    const result = await exec(sub, args, opts);
+    if (!result.ok)
+        return result;
+    try {
+        return { ok: true, data: JSON.parse(result.stdout) };
+    }
+    catch {
+        return { ok: false, error: `skill 脚本输出不是 JSON：${result.stdout.slice(0, 200)}` };
+    }
+}
+/**
+ * 写命令（claim / set）：同样是 spawn python3，但**不解析 JSON**——这些子命令打的是人话，
+ * 成功与否看退出码，失败时 stderr 就是能直接上界面的人话。
+ */
+export async function runLedgerCommand(sub, args, opts) {
+    const result = await exec(sub, args, opts);
+    return result.ok ? { ok: true, output: result.stdout.trim() } : result;
+}

package/dist/host/routes.d.ts

@@ -23,6 +23,13 @@ export interface RouteDeps {
     readonly registry: WorkspaceRegistryLike;
 }
 export declare function registerRoutes(webServer: WebServerLike, deps: RouteDeps): void;
+/**
+ * 注册认领 / 释放端点（2026-10-18 B 混合制：没有判断量的动作由 host 直跑脚本）。
+ *
+ * 这两条**会改磁盘上的台账文件**，所以和 `/close` 一样必须过同源守卫；
+ * 成功后就地清该工作区读缓存，避免按钮点完还看到上一屏的 owner。
+ */
+export declare function registerWriteRoutes(webServer: WebServerLike, deps: RouteDeps): void;
 export interface SessionRouteDeps {
     readonly registry: WorkspaceRegistryLike;
     /** 起会话的服务面；宿主缺就回 503 人话（端点照常注册，前端不用按版本分支）。 */

package/dist/host/routes.js

@@ -1,6 +1,7 @@
 import { getHomeAggregate, getFilterOptions, queryClosed } from './board.js';
 import { getSnapshot } from './services/home.service.js';
 import { getTrend } from './services/trend.service.js';
+import { claimTask, releaseTask } from './services/ledger-write.service.js';
 import { getTask, readTasks, readWorklog } from './repositories/ledger.repository.js';
 import { invalidate } from './repositories/cache.js';
 import { HandoffError, startCloseSession, } from './services/session.service.js';
@@ -155,6 +156,63 @@ export function registerRoutes(webServer, deps) {
         }
     });
 }
+// ───────────────────────── 台账写端点（host 直写 · 不开会话） ─────────────────────────
+/**
+ * 注册认领 / 释放端点（2026-10-18 B 混合制：没有判断量的动作由 host 直跑脚本）。
+ *
+ * 这两条**会改磁盘上的台账文件**，所以和 `/close` 一样必须过同源守卫；
+ * 成功后就地清该工作区读缓存，避免按钮点完还看到上一屏的 owner。
+ */
+export function registerWriteRoutes(webServer, deps) {
+    const registerWrite = (path, action) => {
+        webServer.register({
+            kind: 'exact',
+            path: `${API_PREFIX}${path}`,
+            handler: async (req, res) => {
+                if (req.method !== 'POST') {
+                    sendJson(res, 405, { error: '只支持 POST' });
+                    return;
+                }
+                if (!isTrustedRequest(req)) {
+                    sendJson(res, 403, { error: '只接受同源请求' });
+                    return;
+                }
+                let body;
+                try {
+                    body = await readJsonBody(req);
+                }
+                catch (error) {
+                    const tooLarge = error instanceof Error && error.message === 'body-too-large';
+                    sendJson(res, tooLarge ? 413 : 400, { error: tooLarge ? '请求体过大' : '请求体不是合法 JSON' });
+                    return;
+                }
+                const fields = typeof body === 'object' && body !== null ? body : {};
+                const str = (key) => (typeof fields[key] === 'string' ? fields[key] : '');
+                const workspaceId = str('ws');
+                const taskId = str('id');
+                if (workspaceId === '' || taskId === '') {
+                    sendJson(res, 400, { error: '缺少 ws / id 参数' });
+                    return;
+                }
+                const workspace = workspacesOf(deps).find((item) => item.id === workspaceId);
+                if (workspace === undefined) {
+                    sendJson(res, 404, { error: '工作区不存在或不含台账' });
+                    return;
+                }
+                try {
+                    await action(workspace, taskId);
+                    invalidate(workspace.id);
+                    sendJson(res, 200, { ok: true });
+                }
+                catch (error) {
+                    sendJson(res, 500, { error: error instanceof Error ? error.message : String(error) });
+                }
+            },
+        });
+    };
+    registerWrite('/claim', claimTask);
+    registerWrite('/release', releaseTask);
+}
 // ───────────────────────── 会话交接（按钮侧 · 写类端点） ─────────────────────────
 /** 写端点请求体上限：只收一小段用户留言，别让人往这塞文件。 */
 const BODY_LIMIT = 64 * 1024;

package/dist/host/services/ledger-write.service.d.ts

@@ -0,0 +1,5 @@
+import type { LedgerWorkspace } from '../types.js';
+/** 认领：只有 open 且无人认领才能接（脚本内判定），owner = 当前工作区的 git 身份。 */
+export declare function claimTask(workspace: LedgerWorkspace, taskId: string): Promise<void>;
+/** 释放：退回待认领（owner / started 清空），只许当前 owner 本人（脚本内判定）。 */
+export declare function releaseTask(workspace: LedgerWorkspace, taskId: string): Promise<void>;

package/dist/host/services/ledger-write.service.js

@@ -0,0 +1,22 @@
+/**
+ * 台账写方法（2026-10-18 拍板 B 混合制）：认领 / 释放没有判断量，host 直跑 skill 脚本，**不开会话**。
+ *
+ * 唯一要点：子进程 cwd 必须是工作区 —— `progress.py` 的 owner 取 `git config user.name`，
+ * 走的是进程 cwd，`--repo` 只解决路径、不解决身份（2026-10-18 核实结论）。
+ *
+ * 校验全在脚本里（认领要求 open 且无 owner；释放要求是当前 owner），本层不重复实现。
+ */
+import { runLedgerCommand } from '../repositories/runner.js';
+async function run(workspace, sub, args) {
+    const result = await runLedgerCommand(sub, [...args, '--repo', workspace.path], { cwd: workspace.path });
+    if (!result.ok)
+        throw new Error(`${workspace.title}：${result.error}`);
+}
+/** 认领：只有 open 且无人认领才能接（脚本内判定），owner = 当前工作区的 git 身份。 */
+export function claimTask(workspace, taskId) {
+    return run(workspace, 'claim', ['--id', taskId]);
+}
+/** 释放：退回待认领（owner / started 清空），只许当前 owner 本人（脚本内判定）。 */
+export function releaseTask(workspace, taskId) {
+    return run(workspace, 'set', ['--id', taskId, '--status', 'open']);
+}

package/dist/index.js

@@ -9,7 +9,7 @@
  * 满足不了的依赖会令 entry 一直 pending、卡死整个 dsh 启动）；两条注入线
  * 互相独立——skills 缺席不挡数据面，反之亦然。
  */
-import { registerRoutes, registerSessionRoutes } from './host/routes.js';
+import { registerRoutes, registerSessionRoutes, registerWriteRoutes } from './host/routes.js';
 import { buildSkillRegistration } from './host/skill/registration.js';
 export const name = 'dsh-task-ledger';
 /**
@@ -35,7 +35,9 @@ export function apply(ctx) {
             return;
         }
         registerRoutes(webServer, { registry });
-        console.info('[task-ledger] 数据面路由已注册（/api/task-ledger/*）');
+        // 写端点（认领 / 释放）：B 混合制下由 host 直跑脚本，不依赖 agents ⇒ 与数据面同一条注入线。
+        registerWriteRoutes(webServer, { registry });
+        console.info('[task-ledger] 数据面路由已注册（读 /api/task-ledger/* + 写 /claim /release）');
     });
     // ── 会话交接（按钮侧「结束任务」，2026-10-18 拍板 B 案：只有结束走会话） ──
     // 单独一条注入线：agents 缺席只影响这一个端点，不该拖累数据面（上一条线只等 registry + webServer）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-task-ledger",
-  "version": "0.0.62",
+  "version": "0.0.64",
   "description": "Task ledger board for dsh (DeepSeek Harness): read-only board over task-ledger skill workspaces. The task-ledger skill is bundled — install the plugin, get the skill globally.",
   "keywords": [
     "deepseek",