dsh-task-ledger 0.0.73 → 0.0.75

package/dist/host/board.d.ts

@@ -5,8 +5,8 @@
  * 拆端点后（host-data-plane §五 A）首屏走 `services/home.service.ts::getSnapshot()`（不碰 history），
  * 本组合归「兼容期全量 `/board`」；新端点在 routes 层直接调 service，不过本文件。
  */
-import { type DegradedInfo } from './errors.js';
-import type { HomeAggregate, LedgerWorkspace } from './types.js';
+import { type DegradedInfo } from "./errors.js";
+import type { HomeAggregate, LedgerWorkspace } from "./types.js";
 /**
  * 首页一次拿全：在办快照（含停滞 / 天数 / 身份）+ 近 8 周趋势（完成 / 新增 × 所有 / 我的）
  * + 四个自然周期计数。**每个工作区只读一次**（list + history + git 身份），
@@ -16,5 +16,5 @@ import type { HomeAggregate, LedgerWorkspace } from './types.js';
 export declare function getHomeAggregate(workspaces: readonly LedgerWorkspace[]): Promise<HomeAggregate & {
     degraded: readonly DegradedInfo[];
 }>;
-export { getSnapshot as getBoardSnapshot } from './services/home.service.js';
-export { getFilterOptions, queryClosed } from './services/history.service.js';
+export { getFilterOptions, queryClosed } from "./services/history.service.js";
+export { getSnapshot as getBoardSnapshot } from "./services/home.service.js";

package/dist/host/board.js

@@ -5,9 +5,9 @@
  * 拆端点后（host-data-plane §五 A）首屏走 `services/home.service.ts::getSnapshot()`（不碰 history），
  * 本组合归「兼容期全量 `/board`」；新端点在 routes 层直接调 service，不过本文件。
  */
-import { settleWorkspaces } from './errors.js';
-import { computeSnapshot } from './services/home.service.js';
-import { computeClosedSummary, computeTrendPeriods, readTrendScope } from './services/trend.service.js';
+import { settleWorkspaces } from "./errors.js";
+import { computeSnapshot } from "./services/home.service.js";
+import { computeClosedSummary, computeTrendPeriods, readTrendScope, } from "./services/trend.service.js";
 /**
  * 首页一次拿全：在办快照（含停滞 / 天数 / 身份）+ 近 8 周趋势（完成 / 新增 × 所有 / 我的）
  * + 四个自然周期计数。**每个工作区只读一次**（list + history + git 身份），
@@ -16,7 +16,7 @@ import { computeClosedSummary, computeTrendPeriods, readTrendScope } from './ser
  */
 export async function getHomeAggregate(workspaces) {
     const now = new Date();
-    const { data: scopes, degraded } = await settleWorkspaces(workspaces, 'history', readTrendScope, (rows) => rows);
+    const { data: scopes, degraded } = await settleWorkspaces(workspaces, "history", readTrendScope, (rows) => rows);
     return {
         snapshot: computeSnapshot(scopes, now),
         closed: computeClosedSummary(scopes, now),
@@ -24,6 +24,6 @@ export async function getHomeAggregate(workspaces) {
         degraded,
     };
 }
+export { getFilterOptions, queryClosed } from "./services/history.service.js";
 // 单路径用例直接透传 service（调用方按快 / 慢自己选，不必经过组合）：
-export { getSnapshot as getBoardSnapshot } from './services/home.service.js';
-export { getFilterOptions, queryClosed } from './services/history.service.js';
+export { getSnapshot as getBoardSnapshot } from "./services/home.service.js";

package/dist/host/errors.d.ts

@@ -8,7 +8,7 @@
  *   防止「python3 根本没装」被集体降级成一片绿色空板——那等于界面撒谎。
  */
 /** 机器可读错误码（只增不改；`LEDGER_` 前缀避开宿主错误码空间）。 */
-export type LedgerErrorCode = 'LEDGER_SCRIPT_UNAVAILABLE' | 'LEDGER_SCRIPT_TIMEOUT' | 'LEDGER_SCRIPT_FAILED' | 'LEDGER_SCRIPT_BAD_JSON' | 'LEDGER_DATA_INVALID';
+export type LedgerErrorCode = "LEDGER_SCRIPT_UNAVAILABLE" | "LEDGER_SCRIPT_TIMEOUT" | "LEDGER_SCRIPT_FAILED" | "LEDGER_SCRIPT_BAD_JSON" | "LEDGER_DATA_INVALID";
 /** 台账数据形状不符（容器级校验失败）。message 带工作区名 + 人话，可直接上界面。 */
 export declare class LedgerDataError extends Error {
     readonly code: LedgerErrorCode;
@@ -20,7 +20,7 @@ export interface DegradedInfo {
     readonly workspaceId: string;
     readonly workspaceTitle: string;
     /** 哪个读挂了——trend 同时读 list + history，必须能区分。 */
-    readonly op: 'list' | 'history';
+    readonly op: "list" | "history";
     readonly code: LedgerErrorCode;
     /** 人话，可直接上界面（真源：脚本 stderr / records 校验文案）。 */
     readonly message: string;
@@ -36,7 +36,7 @@ export declare function messageOf(error: unknown): string;
 export declare function settleWorkspaces<W extends {
     id: string;
     title: string;
-}, T, R>(workspaces: readonly W[], op: 'list' | 'history', read: (workspace: W) => Promise<T>, merge: (rows: readonly T[]) => R): Promise<{
+}, T, R>(workspaces: readonly W[], op: "list" | "history", read: (workspace: W) => Promise<T>, merge: (rows: readonly T[]) => R): Promise<{
     data: R;
     degraded: readonly DegradedInfo[];
 }>;

package/dist/host/errors.js

@@ -9,22 +9,22 @@
  */
 /** 台账数据形状不符（容器级校验失败）。message 带工作区名 + 人话，可直接上界面。 */
 export class LedgerDataError extends Error {
-    code = 'LEDGER_DATA_INVALID';
+    code = "LEDGER_DATA_INVALID";
     workspaceId;
     constructor(workspaceId, message) {
         super(message);
-        this.name = 'LedgerDataError';
+        this.name = "LedgerDataError";
         this.workspaceId = workspaceId;
     }
 }
 /** 从任意抛出物取错误码（无 code 的按 LEDGER_SCRIPT_FAILED 兜底——那正是脚本非零的主路径）。 */
 export function codeOf(error) {
-    if (error !== null && typeof error === 'object' && 'code' in error) {
+    if (error !== null && typeof error === "object" && "code" in error) {
         const code = error.code;
-        if (typeof code === 'string' && code.startsWith('LEDGER_'))
+        if (typeof code === "string" && code.startsWith("LEDGER_"))
             return code;
     }
-    return 'LEDGER_SCRIPT_FAILED';
+    return "LEDGER_SCRIPT_FAILED";
 }
 /** 人话（优先 Error.message；其余 String()，不吞）。 */
 export function messageOf(error) {
@@ -41,13 +41,19 @@ export async function settleWorkspaces(workspaces, op, read, merge) {
     let firstError = null;
     settled.forEach((result, i) => {
         const workspace = workspaces[i];
-        if (result.status === 'fulfilled') {
+        if (result.status === "fulfilled") {
             rows.push(result.value);
             return;
         }
         if (firstError === null)
             firstError = result.reason;
-        degraded.push({ workspaceId: workspace.id, workspaceTitle: workspace.title, op, code: codeOf(result.reason), message: messageOf(result.reason) });
+        degraded.push({
+            workspaceId: workspace.id,
+            workspaceTitle: workspace.title,
+            op,
+            code: codeOf(result.reason),
+            message: messageOf(result.reason),
+        });
     });
     if (rows.length === 0 && workspaces.length > 0)
         throw firstError;

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

@@ -12,7 +12,7 @@
 /** 缓存有效期（2026-10-18 拍板 1.5s：够挡同一屏的重复读，短到不会让人看到旧数据）。 */
 export declare const CACHE_TTL_MS = 1500;
 /** 缓存的操作种类（= skill 脚本子命令；worklog 不进缓存故不在此列）。 */
-export type CacheOp = 'list' | 'history';
+export type CacheOp = "list" | "history";
 /** 缓存键：`op:workspace:filter` 三条信息都要，否则不同筛选 / 不同工作区会串味。 */
 export declare function cacheKey(workspaceId: string, op: CacheOp, detail: string): string;
 /**

package/dist/host/repositories/cache.js

@@ -11,7 +11,7 @@
  */
 /** 缓存有效期（2026-10-18 拍板 1.5s：够挡同一屏的重复读，短到不会让人看到旧数据）。 */
 export const CACHE_TTL_MS = 1_500;
-const SEP = '\u0000';
+const SEP = "\u0000";
 /** 已完成的缓存：key → 值与时间戳。 */
 const settled = new Map();
 /** 在途单飞：key → 正在跑的 Promise（同 key 并发只跑一次）。 */
@@ -37,7 +37,9 @@ export function cached(key, load, now = Date.now()) {
         settled.set(key, { at: Date.now(), value });
         return value;
     })
-        .finally(() => { inflight.delete(key); });
+        .finally(() => {
+        inflight.delete(key);
+    });
     inflight.set(key, task);
     return task;
 }

package/dist/host/repositories/identity.repository.d.ts

@@ -1,4 +1,4 @@
-import type { LedgerWorkspace } from '../types.js';
+import type { LedgerWorkspace } from "../types.js";
 /**
  * 当前 git 身份（cwd = 该工作区）——「我的待办」判定源。
  * 与 agent 在会话里跑 skill 时的取值环境一致；取不到回 null（非 git 目录 / 没配身份），

package/dist/host/repositories/identity.repository.js

@@ -1,4 +1,4 @@
-import { spawn } from 'node:child_process';
+import { spawn } from "node:child_process";
 /**
  * 当前 git 身份（cwd = 该工作区）——「我的待办」判定源。
  * 与 agent 在会话里跑 skill 时的取值环境一致；取不到回 null（非 git 目录 / 没配身份），
@@ -8,13 +8,20 @@ import { spawn } from 'node:child_process';
  */
 export function getCurrentIdentity(workspace) {
     return new Promise((resolve) => {
-        const child = spawn('git', ['config', 'user.name'], { cwd: workspace.path, stdio: ['ignore', 'pipe', 'ignore'] });
-        let stdout = '';
-        child.stdout.on('data', (chunk) => { stdout += chunk.toString(); });
-        child.on('error', () => { resolve(null); });
-        child.on('close', (code) => {
+        const child = spawn("git", ["config", "user.name"], {
+            cwd: workspace.path,
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        let stdout = "";
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.on("error", () => {
+            resolve(null);
+        });
+        child.on("close", (code) => {
             const name = stdout.trim();
-            resolve(code === 0 && name !== '' ? name : null);
+            resolve(code === 0 && name !== "" ? name : null);
         });
     });
 }

package/dist/host/repositories/ledger.repository.d.ts

@@ -1,4 +1,4 @@
-import type { HistoryRecord, LedgerFilter, LedgerWorkspace, TaskRow } from '../types.js';
+import type { HistoryRecord, LedgerFilter, LedgerWorkspace, TaskRow } from "../types.js";
 /**
  * LedgerFilter → skill 脚本参数（只拼调用方给了的；undefined 一律不拼，
  * 让脚本走自己的默认——插件不替脚本决定默认值）。

package/dist/host/repositories/ledger.repository.js

@@ -1,11 +1,11 @@
-import { existsSync } from 'node:fs';
-import { readFile } from 'node:fs/promises';
-import path from 'node:path';
-import { runLedgerScript } from './runner.js';
-import { parseHistoryRecords, parseTaskList } from './records.js';
-import { cacheKey, cached } from './cache.js';
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { cached, cacheKey } from "./cache.js";
+import { parseHistoryRecords, parseTaskList } from "./records.js";
+import { runLedgerScript } from "./runner.js";
 /** 台账目录名（各工作区根下的这一个目录；布局知识只在本文件出现一次）。 */
-const LEDGER_DIR = 'ledger';
+const LEDGER_DIR = "ledger";
 /**
  * LedgerFilter → skill 脚本参数（只拼调用方给了的；undefined 一律不拼，
  * 让脚本走自己的默认——插件不替脚本决定默认值）。
@@ -13,21 +13,21 @@ const LEDGER_DIR = 'ledger';
 export function filterArgs(filter) {
     const args = [];
     if (filter.status !== undefined)
-        args.push('--status', filter.status);
+        args.push("--status", filter.status);
     if (filter.owner !== undefined)
-        args.push('--owner', filter.owner);
+        args.push("--owner", filter.owner);
     if (filter.category !== undefined)
-        args.push('--category', filter.category);
+        args.push("--category", filter.category);
     if (filter.tag !== undefined)
-        args.push('--tag', filter.tag);
+        args.push("--tag", filter.tag);
     if (filter.since !== undefined)
-        args.push('--since', filter.since);
+        args.push("--since", filter.since);
     if (filter.until !== undefined)
-        args.push('--until', filter.until);
+        args.push("--until", filter.until);
     if (filter.limit !== undefined)
-        args.push('--limit', String(filter.limit));
+        args.push("--limit", String(filter.limit));
     if (filter.months !== undefined)
-        args.push('--months', String(filter.months));
+        args.push("--months", String(filter.months));
     return args;
 }
 /**
@@ -35,7 +35,8 @@ export function filterArgs(filter) {
  * 2026-10-17 拍板）。全 host 对台账目录的 IO 只在本文件——别处再写 existsSync 即为分层倒退。
  */
 export function hasLedger(workspacePath) {
-    return existsSync(path.join(workspacePath, LEDGER_DIR, 'progress.json'));
+    // 分片布局（2026-10-23）：公共池 pool.json 在才算初始化；各人分片 owners/*.json 由脚本维护。
+    return existsSync(path.join(workspacePath, LEDGER_DIR, "pool.json"));
 }
 /**
  * 在办任务（包 `list --json`；结果过 records 入口校验后打上 workspace）。
@@ -43,8 +44,13 @@ export function hasLedger(workspacePath) {
  * 不静默返空（空 = 撒谎）。**过 1.5s 读缓存**（同屏多端点会反复读同一份在办）。
  */
 export async function readTasks(workspace, filter = {}) {
-    return await cached(cacheKey(workspace.id, 'list', argsKey(filter)), async () => {
-        const result = await runLedgerScript('list', ['--repo', workspace.path, '--json', ...filterArgs(filter)]);
+    return await cached(cacheKey(workspace.id, "list", argsKey(filter)), async () => {
+        const result = await runLedgerScript("list", [
+            "--repo",
+            workspace.path,
+            "--json",
+            ...filterArgs(filter),
+        ]);
         if (!result.ok)
             throw new Error(`${workspace.title}: ${result.error}`);
         return parseTaskList(result.data, workspace);
@@ -52,8 +58,13 @@ export async function readTasks(workspace, filter = {}) {
 }
 /** 已结案记录（包 `history --json`；`records` 必须存在且为数组，缺了即坏数据）。同样过读缓存。 */
 export async function readHistory(workspace, filter = {}) {
-    return await cached(cacheKey(workspace.id, 'history', argsKey(filter)), async () => {
-        const result = await runLedgerScript('history', ['--repo', workspace.path, '--json', ...filterArgs(filter)]);
+    return await cached(cacheKey(workspace.id, "history", argsKey(filter)), async () => {
+        const result = await runLedgerScript("history", [
+            "--repo",
+            workspace.path,
+            "--json",
+            ...filterArgs(filter),
+        ]);
         if (!result.ok)
             throw new Error(`${workspace.title}: ${result.error}`);
         return parseHistoryRecords(result.data, workspace);
@@ -61,7 +72,7 @@ export async function readHistory(workspace, filter = {}) {
 }
 /** 缓存键的 filter 段：脚本参数原样序列化（分隔符取不可见字符，值里带空格也不会串）。 */
 function argsKey(filter) {
-    return filterArgs(filter).join('\u0001');
+    return filterArgs(filter).join("\u0001");
 }
 /** 单条在办（展开行 / 详情用）。取不到回 null，不抛。 */
 export async function getTask(workspace, taskId) {
@@ -74,10 +85,10 @@ export async function getTask(workspace, taskId) {
  */
 export async function readWorklog(workspace, task) {
     const relative = task.worklog;
-    if (relative === undefined || relative === null || relative === '')
+    if (relative === undefined || relative === null || relative === "")
         return null;
     try {
-        return await readFile(path.join(workspace.path, LEDGER_DIR, relative), 'utf-8');
+        return await readFile(path.join(workspace.path, LEDGER_DIR, relative), "utf-8");
     }
     catch {
         return null;

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

@@ -1,4 +1,4 @@
-import type { HistoryRecord, LedgerWorkspace, TaskRow } from '../types.js';
+import type { HistoryRecord, LedgerWorkspace, TaskRow } from "../types.js";
 /** `list --json`（任务号为键的对象）→ TaskRow[]（打上 id 与 workspace）。 */
 export declare function parseTaskList(raw: unknown, workspace: LedgerWorkspace): TaskRow[];
 /** `history --json`（`{count, filters, records}`）→ HistoryRecord[]（打上 workspace）。 */

package/dist/host/repositories/records.js

@@ -8,9 +8,9 @@
  *   旧 8 列 history 不因此被误杀）。
  * 失败抛 {@link LedgerDataError}——由 service 层捕获进 degraded，不静默。
  */
-import { LedgerDataError } from '../errors.js';
+import { LedgerDataError } from "../errors.js";
 function isPlainObject(value) {
-    return value !== null && typeof value === 'object' && !Array.isArray(value);
+    return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 /** `list --json`（任务号为键的对象）→ TaskRow[]（打上 id 与 workspace）。 */
 export function parseTaskList(raw, workspace) {
@@ -22,7 +22,7 @@ export function parseTaskList(raw, workspace) {
         if (!isPlainObject(value)) {
             throw new LedgerDataError(workspace.id, `${workspace.title}: 任务 ${id} 不是对象，台账格式可能已变`);
         }
-        if (id === '') {
+        if (id === "") {
             throw new LedgerDataError(workspace.id, `${workspace.title}: 台账存在空任务号，格式可能已变`);
         }
         rows.push({ ...value, id, workspace });

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

@@ -1,9 +1,10 @@
 /**
- * 写命令的超时上限（ms）：脚本写完会顺手 fetch + commit + push，最坏 30×4 = 120s。
- * 沿用读命令的 10s 会把「已经 commit、还没 push」那一步掐死 —— 界面报失败，台账其实
- * 已经改了，用户一重试就是二次写入。
+ * 写命令的超时上限（ms）：脚本每条 git 调用各自 30s 超时，写前（fetch / ff / push /
+ * rebase / push）与写后（push / fetch / rebase / push）串起来最坏约 270s。
+ * 低到 120s 会在网络挂死时先报「超时失败」——台账其实已写入，用户一重试就是二次写入。
+ * 180s 覆盖常见最坏组合，又不至于让真卡死的请求占着界面太久。
  */
-export declare const WRITE_TIMEOUT_MS = 120000;
+export declare const WRITE_TIMEOUT_MS = 180000;
 export type LedgerScriptResult<T> = {
     ok: true;
     data: T;

package/dist/host/repositories/runner.js

@@ -1,19 +1,20 @@
-import { spawn } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
 /**
  * 内嵌 skill 脚本的默认路径：dist/host/repositories/runner.js → 包根 skill/scripts/progress.py
  * （比原 host/script.js 深一层 ⇒ 相对路径多一级 `../`）。
  * 构建时 scripts/copy-skill.mjs 把 packages/skill 拷到 packages/plugin/skill/。
  */
-const DEFAULT_SCRIPT_PATH = fileURLToPath(new URL('../../../skill/scripts/progress.py', import.meta.url));
+const DEFAULT_SCRIPT_PATH = fileURLToPath(new URL("../../../skill/scripts/progress.py", import.meta.url));
 /** 单次脚本调用超时上限（ms）。实测单仓 5 万行全量 1.2s，10s 是宽松上限。 */
 const DEFAULT_TIMEOUT_MS = 10_000;
 /**
- * 写命令的超时上限（ms）：脚本写完会顺手 fetch + commit + push，最坏 30×4 = 120s。
- * 沿用读命令的 10s 会把「已经 commit、还没 push」那一步掐死 —— 界面报失败，台账其实
- * 已经改了，用户一重试就是二次写入。
+ * 写命令的超时上限（ms）：脚本每条 git 调用各自 30s 超时，写前（fetch / ff / push /
+ * rebase / push）与写后（push / fetch / rebase / push）串起来最坏约 270s。
+ * 低到 120s 会在网络挂死时先报「超时失败」——台账其实已写入，用户一重试就是二次写入。
+ * 180s 覆盖常见最坏组合，又不至于让真卡死的请求占着界面太久。
  */
-export const WRITE_TIMEOUT_MS = 120_000;
+export const WRITE_TIMEOUT_MS = 180_000;
 /**
  * 起一次 python3、收 stdout / stderr。出错一律归一成人话（起不了 python3 / 超时 / 非零退出）。
  * 解析留给调用方：读命令要 JSON，写命令要原文。
@@ -22,13 +23,19 @@ 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], { cwd: opts?.cwd, stdio: ['ignore', 'pipe', 'pipe'] });
-        let stdout = '';
-        let stderr = '';
+        const child = spawn("python3", [scriptPath, sub, ...args], {
+            cwd: opts?.cwd,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
         let settled = false;
         const timer = setTimeout(() => {
             child.kill();
-            settle({ ok: false, error: `skill 脚本超时（>${timeoutMs}ms）：${sub} ${args.join(' ')}` });
+            settle({
+                ok: false,
+                error: `skill 脚本超时（>${timeoutMs}ms）：${sub} ${args.join(" ")}`,
+            });
         }, timeoutMs);
         const settle = (result) => {
             if (settled)
@@ -37,14 +44,24 @@ function exec(sub, args, opts) {
             clearTimeout(timer);
             resolve(result);
         };
-        child.stdout.on('data', (chunk) => { stdout += chunk.toString(); });
-        child.stderr.on('data', (chunk) => { stderr += chunk.toString(); });
-        child.on('error', (error) => {
-            settle({ ok: false, error: `起不了 python3（${error.message}）——本插件需要 python3 运行内嵌 skill 脚本` });
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString();
         });
-        child.on('close', (code) => {
+        child.on("error", (error) => {
+            settle({
+                ok: false,
+                error: `起不了 python3（${error.message}）——本插件需要 python3 运行内嵌 skill 脚本`,
+            });
+        });
+        child.on("close", (code) => {
             if (code !== 0) {
-                settle({ ok: false, error: stderr.trim() || `skill 脚本退出码 ${String(code)}` });
+                settle({
+                    ok: false,
+                    error: stderr.trim() || `skill 脚本退出码 ${String(code)}`,
+                });
                 return;
             }
             settle({ ok: true, stdout, stderr: stderr.trim() });
@@ -69,7 +86,10 @@ export async function runLedgerScript(sub, args, opts) {
         return { ok: true, data: JSON.parse(result.stdout) };
     }
     catch {
-        return { ok: false, error: `skill 脚本输出不是 JSON：${result.stdout.slice(0, 200)}` };
+        return {
+            ok: false,
+            error: `skill 脚本输出不是 JSON：${result.stdout.slice(0, 200)}`,
+        };
     }
 }
 /**
@@ -82,5 +102,7 @@ export async function runLedgerCommand(sub, args, opts) {
         return result;
     const output = result.stdout.trim();
     // 退出码 0 但 stderr 有字 = 写成功、同步失败（progress.py 的既定行为），必须带出去
-    return result.stderr ? { ok: true, output, notice: result.stderr } : { ok: true, output };
+    return result.stderr
+        ? { ok: true, output, notice: result.stderr }
+        : { ok: true, output };
 }

package/dist/host/routes.d.ts

@@ -4,13 +4,13 @@
  * 宿主事实（handler = 原始 Node req/res、发头后不抛错、重复 path 注册直接 throw）
  * 见 external/host-webserver.md。
  */
-import type { IncomingMessage, ServerResponse } from 'node:http';
-import { type AgentsLike } from './services/session.service.js';
-import { type RegistryWorkspace } from './workspace.js';
+import type { IncomingMessage, ServerResponse } from "node:http";
+import { type AgentsLike } from "./services/session.service.js";
+import { type RegistryWorkspace } from "./workspace.js";
 /** 宿主 webServer.register 的最小面（WebRoute 形状见 external/host-webserver.md）。 */
 export interface WebServerLike {
     register(route: {
-        kind: 'exact' | 'prefix';
+        kind: "exact" | "prefix";
         path: string;
         handler: (req: IncomingMessage, res: ServerResponse) => void | Promise<void>;
     }): unknown;