@dsh-workbench/shared 1.1.14-beta.2 → 1.1.15

package/dist/host/fs-write.d.ts

@@ -0,0 +1,68 @@
+export type WriteMode = number | 'keep';
+export interface WriteFileOptions {
+    readonly atomic?: boolean | undefined;
+    readonly mkdir?: boolean | undefined;
+    readonly fsync?: boolean | undefined;
+    readonly mode?: WriteMode | undefined;
+}
+/**
+ * 把文本写进文件；默认原子写（temp + rename）、目录不存在就建、已有文件保留原权限。
+ * @param path 目标文件；父目录按 `mkdir` 决定是否创建。
+ * @param text 文本内容。
+ * @param options 原子/目录/权限/fsync；`mode` 默认 `'keep'`（新文件 0644）。
+ */
+export declare function writeTextFile(path: string, text: string, options?: WriteFileOptions): void;
+/**
+ * 往文件末尾追加文本；文件或目录不存在就建。追加不是原子写，只给「日志/采集」这类只增不改的流。
+ * @param path 目标文件。
+ * @param text 追加内容。
+ */
+export declare function appendTextFile(path: string, text: string): void;
+/**
+ * `writeTextFile` 的异步版；语义与默认值相同。
+ * @param path 目标文件。
+ * @param text 文本内容。
+ * @param options 原子/目录/权限/fsync。
+ * @returns 落盘完成。
+ */
+export declare function writeTextFileAsync(path: string, text: string, options?: WriteFileOptions): Promise<void>;
+/**
+ * 把二进制写进文件；语义与默认值同 `writeTextFile`。
+ * @param path 目标文件。
+ * @param bytes 二进制内容。
+ * @param options 原子/目录/权限/fsync。
+ */
+export declare function writeBytesFile(path: string, bytes: Uint8Array, options?: WriteFileOptions): void;
+/**
+ * `writeBytesFile` 的异步版；语义与默认值相同。
+ * @param path 目标文件。
+ * @param bytes 二进制内容。
+ * @param options 原子/目录/权限/fsync。
+ * @returns 落盘完成。
+ */
+export declare function writeBytesFileAsync(path: string, bytes: Uint8Array, options?: WriteFileOptions): Promise<void>;
+/**
+ * 把 JSON 写进文件：`JSON.stringify(value, null, 2)` 加末尾换行；语义与默认值同 `writeTextFile`。
+ * @param path 目标文件。
+ * @param value 可序列化的值。
+ * @param options 原子/目录/权限/fsync。
+ */
+export declare function writeJsonFile(path: string, value: unknown, options?: WriteFileOptions): void;
+/**
+ * `writeJsonFile` 的异步版；语义与默认值相同。
+ * @param path 目标文件。
+ * @param value 可序列化的值。
+ * @param options 原子/目录/权限/fsync。
+ * @returns 落盘完成。
+ */
+export declare function writeJsonFileAsync(path: string, value: unknown, options?: WriteFileOptions): Promise<void>;
+/**
+ * 确保目录存在（`mkdir -p`）。
+ * @param dir 目录路径。
+ */
+export declare function ensureDir(dir: string): void;
+/**
+ * 把已存在的文件设成可执行（0755）。
+ * @param path 文件路径。
+ */
+export declare function makeExecutable(path: string): void;

package/dist/host/fs-write.js

@@ -0,0 +1,121 @@
+import { appendFileSync, chmodSync, mkdirSync, statSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import writeFileAtomic from 'write-file-atomic';
+function modeOf(path, mode) {
+    if (typeof mode === 'number')
+        return mode;
+    try {
+        return statSync(path).mode & 0o777;
+    }
+    catch {
+        return 0o644;
+    }
+}
+function prepareOf(path, options) {
+    if (options.mkdir !== false)
+        mkdirSync(dirname(path), { recursive: true });
+    return modeOf(path, options.mode);
+}
+function atomicOptionsOf(mode, options) {
+    return options.fsync === true ? { mode, fsync: true } : { mode };
+}
+/**
+ * 把文本写进文件；默认原子写（temp + rename）、目录不存在就建、已有文件保留原权限。
+ * @param path 目标文件；父目录按 `mkdir` 决定是否创建。
+ * @param text 文本内容。
+ * @param options 原子/目录/权限/fsync；`mode` 默认 `'keep'`（新文件 0644）。
+ */
+export function writeTextFile(path, text, options = {}) {
+    const mode = prepareOf(path, options);
+    if (options.atomic === false) {
+        writeFileSync(path, text, { mode });
+        return;
+    }
+    writeFileAtomic.sync(path, text, atomicOptionsOf(mode, options));
+}
+/**
+ * 往文件末尾追加文本；文件或目录不存在就建。追加不是原子写，只给「日志/采集」这类只增不改的流。
+ * @param path 目标文件。
+ * @param text 追加内容。
+ */
+export function appendTextFile(path, text) {
+    mkdirSync(dirname(path), { recursive: true });
+    appendFileSync(path, text, { mode: modeOf(path, 'keep') });
+}
+/**
+ * `writeTextFile` 的异步版；语义与默认值相同。
+ * @param path 目标文件。
+ * @param text 文本内容。
+ * @param options 原子/目录/权限/fsync。
+ * @returns 落盘完成。
+ */
+export async function writeTextFileAsync(path, text, options = {}) {
+    const mode = prepareOf(path, options);
+    if (options.atomic === false) {
+        writeFileSync(path, text, { mode });
+        return;
+    }
+    await writeFileAtomic(path, text, atomicOptionsOf(mode, options));
+}
+/**
+ * 把二进制写进文件；语义与默认值同 `writeTextFile`。
+ * @param path 目标文件。
+ * @param bytes 二进制内容。
+ * @param options 原子/目录/权限/fsync。
+ */
+export function writeBytesFile(path, bytes, options = {}) {
+    const mode = prepareOf(path, options);
+    if (options.atomic === false) {
+        writeFileSync(path, bytes, { mode });
+        return;
+    }
+    writeFileAtomic.sync(path, Buffer.from(bytes), atomicOptionsOf(mode, options));
+}
+/**
+ * `writeBytesFile` 的异步版；语义与默认值相同。
+ * @param path 目标文件。
+ * @param bytes 二进制内容。
+ * @param options 原子/目录/权限/fsync。
+ * @returns 落盘完成。
+ */
+export async function writeBytesFileAsync(path, bytes, options = {}) {
+    const mode = prepareOf(path, options);
+    if (options.atomic === false) {
+        writeFileSync(path, bytes, { mode });
+        return;
+    }
+    await writeFileAtomic(path, Buffer.from(bytes), atomicOptionsOf(mode, options));
+}
+/**
+ * 把 JSON 写进文件：`JSON.stringify(value, null, 2)` 加末尾换行；语义与默认值同 `writeTextFile`。
+ * @param path 目标文件。
+ * @param value 可序列化的值。
+ * @param options 原子/目录/权限/fsync。
+ */
+export function writeJsonFile(path, value, options = {}) {
+    writeTextFile(path, `${JSON.stringify(value, null, 2)}\n`, options);
+}
+/**
+ * `writeJsonFile` 的异步版；语义与默认值相同。
+ * @param path 目标文件。
+ * @param value 可序列化的值。
+ * @param options 原子/目录/权限/fsync。
+ * @returns 落盘完成。
+ */
+export async function writeJsonFileAsync(path, value, options = {}) {
+    await writeTextFileAsync(path, `${JSON.stringify(value, null, 2)}\n`, options);
+}
+/**
+ * 确保目录存在（`mkdir -p`）。
+ * @param dir 目录路径。
+ */
+export function ensureDir(dir) {
+    mkdirSync(dir, { recursive: true });
+}
+/**
+ * 把已存在的文件设成可执行（0755）。
+ * @param path 文件路径。
+ */
+export function makeExecutable(path) {
+    chmodSync(path, 0o755);
+}

package/dist/host/host-kit.d.ts

@@ -1,9 +1,10 @@
 import type { HostSurface } from '../contract/protocol/platform.js';
 import type { EnvSupplyPort } from './port-types.js';
+import type { UnitSeam } from './seam/unit-seam.js';
 import { type FlowHost } from './flow/kit.js';
 import { sessionIdOf, sessionWorkspace } from './tool-kit.js';
 /**
- * 宿主 kit 的公共部分：flow、工具侧 session 读法、外部供给装法、宿主平台事实。
+ * 宿主 kit 的公共部分：flow、工具侧 session 读法、外部供给装法、宿主平台事实、按 unit 绑定的执行缝门面。
  */
 export interface HostKit {
     readonly flow: FlowHost;
@@ -11,14 +12,17 @@ export interface HostKit {
     readonly sessionWorkspace: typeof sessionWorkspace;
     readonly libInstallCommand: EnvSupplyPort['libInstallCommand'];
     readonly surface: HostSurface;
+    readonly seam?: UnitSeam | undefined;
 }
 /**
  * 建一份宿主 kit；每个挂载点一份，没有模块级状态。
  * @param parts.libInstallCommand 拼「装这个共用依赖」的那条命令。
  * @param parts.surface 宿主平台事实；由组合根按 profile 与宿主进程算好再交进来。
- * @returns flow / sessionIdOf / sessionWorkspace / libInstallCommand / surface。
+ * @param parts.seam 按 unit 绑定好的执行缝门面；模块清单没声明写入域时缺省不给。
+ * @returns flow / sessionIdOf / sessionWorkspace / libInstallCommand / surface，有门面时带上 seam。
  */
 export declare function createHostKit(parts: {
     readonly libInstallCommand: EnvSupplyPort['libInstallCommand'];
     readonly surface: HostSurface;
+    readonly seam?: UnitSeam | undefined;
 }): HostKit;

package/dist/host/host-kit.js

@@ -4,7 +4,8 @@ import { sessionIdOf, sessionWorkspace } from './tool-kit.js';
  * 建一份宿主 kit；每个挂载点一份，没有模块级状态。
  * @param parts.libInstallCommand 拼「装这个共用依赖」的那条命令。
  * @param parts.surface 宿主平台事实；由组合根按 profile 与宿主进程算好再交进来。
- * @returns flow / sessionIdOf / sessionWorkspace / libInstallCommand / surface。
+ * @param parts.seam 按 unit 绑定好的执行缝门面；模块清单没声明写入域时缺省不给。
+ * @returns flow / sessionIdOf / sessionWorkspace / libInstallCommand / surface，有门面时带上 seam。
  */
 export function createHostKit(parts) {
     return {
@@ -13,5 +14,6 @@ export function createHostKit(parts) {
         sessionWorkspace,
         libInstallCommand: parts.libInstallCommand,
         surface: parts.surface,
+        ...(parts.seam === undefined ? {} : { seam: parts.seam }),
     };
 }

package/dist/host/http.js

@@ -1,3 +1,4 @@
+import { now, nowIso } from './time.js';
 import { unitFactScope } from './facts.js';
 import { parseCardsReport, parseCrashReport } from './panel-state.js';
 import { ACTIONS_PREFIX, API_PREFIX, DIY_DEBUG_PATH, DIY_RECORD_PATH, PANEL_STATE_PREFIX, PLUGIN_ID, PREFS_PREFIX, PROVISION_PREFIX } from '../config/constants.js';
@@ -180,8 +181,13 @@ export function changesHandler(log) {
 }
 export function preflightHandler(preflight) {
     return (search) => {
-        void preflight.run({ hard: flag(search, 'hard') });
-        return { ok: true, ...preflight.snapshot() };
+        if (flag(search, 'hard')) {
+            void preflight.run({ hard: true });
+            return { ok: true, ...preflight.snapshot() };
+        }
+        const snapshot = preflight.snapshot();
+        void preflight.run({ hard: false });
+        return { ok: true, ...snapshot };
     };
 }
 export function capabilityHandler(probe) {
@@ -204,7 +210,7 @@ export function healthHandler(ctx, runtimes) {
             profile: dir === undefined ? null : dir.split('/').pop(),
             profileDir: dir ?? null,
             pid: process.pid,
-            now: new Date().toISOString(),
+            now: nowIso(),
             ...(runtimes === undefined ? {} : { runtimes }),
         };
     };
@@ -240,7 +246,7 @@ export function registerPanelState(ctx, store) {
                     if (!parsed.ok)
                         return { ok: false, text: parsed.message };
                     store.cards(parsed.value);
-                    return { ok: true, at: Date.now() };
+                    return { ok: true, at: now() };
                 },
             },
             {
@@ -250,7 +256,7 @@ export function registerPanelState(ctx, store) {
                     if (!parsed.ok)
                         return { ok: false, text: parsed.message };
                     store.crash(parsed.value);
-                    return { ok: true, at: Date.now() };
+                    return { ok: true, at: now() };
                 },
             },
         ],

package/dist/host/installed-sources.js

@@ -1,5 +1,6 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { writeTextFile } from './fs-write.js';
 const FILE_NAME = '.dsh-workbench-sources.json';
 const FILE_VERSION = 1;
 function asRecord(value) {
@@ -41,11 +42,9 @@ export function packageSourceOf(profileDir, pkg) {
     return readInstalledSources(profileDir)[pkg];
 }
 function writeInstalledSources(profileDir, sources) {
-    const file = installedSourcesFile(profileDir);
-    const temp = `${file}.tmp`;
-    const text = `${JSON.stringify({ version: FILE_VERSION, packages: sources }, null, 2)}\n`;
-    fs.writeFileSync(temp, text, { mode: 0o600 });
-    fs.renameSync(temp, file);
+    writeTextFile(installedSourcesFile(profileDir), `${JSON.stringify({ version: FILE_VERSION, packages: sources }, null, 2)}\n`, {
+        mode: 0o600,
+    });
 }
 export function rememberPackageSource(profileDir, pkg, source) {
     const trimmed = pkg.trim();

package/dist/host/long-task.js

@@ -1,13 +1,13 @@
-import { epochOf } from './time.js';
+import { epochOf, now as clockNow, nowIso } from './time.js';
 import { runsRouteOf } from '../contract/long-task.js';
 const LIVE = new Set(['running', 'needs-login']);
 const RECENT_MS = 10 * 60 * 1000;
 export function createLongTaskRegistry(deps) {
     const runs = new Map();
     const controls = new Map();
-    const now = deps.now ?? (() => new Date().toISOString());
+    const now = deps.now ?? (() => nowIso());
     let counter = 0;
-    const nextId = deps.nextId ?? (() => `run-${Date.now()}-${(counter += 1)}`);
+    const nextId = deps.nextId ?? (() => `run-${clockNow()}-${(counter += 1)}`);
     const recentMs = deps.recentMs ?? RECENT_MS;
     const listeners = new Set();
     const live = (id) => {

package/dist/host/opencli-runner.d.ts

@@ -0,0 +1,26 @@
+import type { DataRequest, DataResult } from '../contract/data.js';
+/**
+ * 一条 opencli 命令的执行器：同一形状的 `execFile('opencli', args)`，结果只留 stdout。
+ */
+export type LibRunner = (args: readonly string[]) => Promise<{
+    readonly stdout: string;
+}>;
+export type OpencliRunner = LibRunner;
+/**
+ * 读缝（`DataReader.read`）的形状；模块直接把自己的 `data.read` 传进来即可。
+ */
+export type OpencliRead = (request: DataRequest) => Promise<DataResult<unknown>>;
+export interface OpencliRunnerOptions {
+    readonly timeoutMs?: number;
+}
+/**
+ * 把读缝包成一条 opencli 命令的执行器：给还按 `execFile('opencli', args)` 收结果的编排库用，
+ * 让它们跑在面板用的那份 opencli 上（同一套插件、同一份登录态）。
+ *
+ * 失败按 opencli 自己的约定还原：未登录是 `code: AUTH_REQUIRED` + 退出码 77，编排库的
+ * 「等登录再重试」才接得上；其它失败保留 `Command failed: opencli …` 那句外壳。
+ * @param read 模块手里的读缝（`data.read`）。
+ * @param options `timeoutMs` 透传给读缝；不传就用读缝自己的默认值。
+ * @returns 执行器；直接交给编排库的 `setOpencliRunner`。
+ */
+export declare function opencliRunnerOf(read: OpencliRead, options?: OpencliRunnerOptions): OpencliRunner;

package/dist/host/opencli-runner.js

@@ -0,0 +1,50 @@
+const AUTH_REQUIRED_EXIT_CODE = 77;
+function textOf(value) {
+    return typeof value === 'string' ? value : '';
+}
+function failedOf(args, error) {
+    const head = `Command failed: opencli ${args.join(' ')}`;
+    const auth = error?.pageCode === 'auth-required';
+    const helpUrl = textOf(error?.helpUrl);
+    const detail = textOf(error?.detail);
+    const hint = textOf(error?.hint);
+    const failed = new Error([
+        head,
+        ...(auth
+            ? ['code: AUTH_REQUIRED', `message: ${textOf(error?.message)}`]
+            : [textOf(error?.message) || 'opencli 这条命令没跑通']),
+        ...(detail === '' ? [] : [detail]),
+        ...(hint === '' ? [] : [hint]),
+        ...(auth && helpUrl !== ''
+            ? [`help: Please open Chrome or Chromium and log in to ${helpUrl}`]
+            : []),
+    ].join('\n'));
+    if (auth)
+        failed.code = AUTH_REQUIRED_EXIT_CODE;
+    return failed;
+}
+/**
+ * 把读缝包成一条 opencli 命令的执行器：给还按 `execFile('opencli', args)` 收结果的编排库用，
+ * 让它们跑在面板用的那份 opencli 上（同一套插件、同一份登录态）。
+ *
+ * 失败按 opencli 自己的约定还原：未登录是 `code: AUTH_REQUIRED` + 退出码 77，编排库的
+ * 「等登录再重试」才接得上；其它失败保留 `Command failed: opencli …` 那句外壳。
+ * @param read 模块手里的读缝（`data.read`）。
+ * @param options `timeoutMs` 透传给读缝；不传就用读缝自己的默认值。
+ * @returns 执行器；直接交给编排库的 `setOpencliRunner`。
+ */
+export function opencliRunnerOf(read, options = {}) {
+    return async (args) => {
+        const result = await read({
+            kind: 'command',
+            adapter: 'opencli',
+            argv: [...args],
+            ...(options.timeoutMs === undefined
+                ? {}
+                : { timeoutMs: options.timeoutMs }),
+        });
+        if (result.ok)
+            return { stdout: JSON.stringify(result.data) };
+        throw failedOf(args, result.error);
+    };
+}

package/dist/host/package-content.d.ts

@@ -1,6 +1,6 @@
-import type { DshShell } from '../api/dsh.js';
+import type { Seam } from './seam/run.js';
 export declare function withPackageDir<T>(options: {
-    readonly shell?: DshShell | undefined;
+    readonly seam?: Seam | undefined;
     readonly spec: string;
     readonly registry?: string | undefined;
     readonly cacheDir?: string | undefined;

package/dist/host/package-content.js

@@ -1,10 +1,10 @@
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
+import { productWrite } from './seam/intent.js';
 import { INSTALL_TIMEOUT_MS } from '../config/constants.js';
 import { parseJsonLoose } from '../lib/text.js';
 import { quoteShellArg } from './shell-text.js';
-import { runShell } from './shell.js';
 import { splitNpmSpec } from './package-kind.js';
 import { localDirOf } from './local-declaration.js';
 function cacheFlag(cacheDir) {
@@ -35,8 +35,8 @@ export async function withPackageDir(options, visit) {
         return visit(local);
     if (splitNpmSpec(options.spec) === undefined)
         return undefined;
-    const shell = options.shell;
-    if (shell === undefined)
+    const seam = options.seam;
+    if (seam === undefined)
         return undefined;
     let root;
     try {
@@ -47,15 +47,29 @@ export async function withPackageDir(options, visit) {
     }
     try {
         const at = options.registry === undefined ? '' : ` --registry ${quoteShellArg(options.registry)}`;
-        const packed = await runShell(shell, `npm pack ${quoteShellArg(options.spec)} --ignore-scripts --json --pack-destination ${quoteShellArg(root)}${cacheFlag(options.cacheDir)}${at}`, { timeoutMs: INSTALL_TIMEOUT_MS }).catch(() => undefined);
+        const packed = await seam
+            .run({
+            command: `npm pack ${quoteShellArg(options.spec)} --ignore-scripts --json --pack-destination ${quoteShellArg(root)}${cacheFlag(options.cacheDir)}${at}`,
+            intent: productWrite(),
+            retry: 'safe',
+            timeoutMs: INSTALL_TIMEOUT_MS,
+            bestEffort: true,
+        })
+            .catch(() => undefined);
         if (packed === undefined || packed.exitCode !== 0)
             return undefined;
         const file = packedFileFrom(packed.stdout, root);
         if (file === undefined)
             return undefined;
-        const unpacked = await runShell(shell, `tar -xzf ${quoteShellArg(file)} -C ${quoteShellArg(root)}`, {
+        const unpacked = await seam
+            .run({
+            command: `tar -xzf ${quoteShellArg(file)} -C ${quoteShellArg(root)}`,
+            intent: productWrite(),
+            retry: 'safe',
             timeoutMs: INSTALL_TIMEOUT_MS,
-        }).catch(() => undefined);
+            bestEffort: true,
+        })
+            .catch(() => undefined);
         if (unpacked === undefined || unpacked.exitCode !== 0)
             return undefined;
         const dir = path.join(root, 'package');

package/dist/host/package-route.d.ts

@@ -1,4 +1,4 @@
-import type { DshShell } from '../api/dsh.js';
+import type { Seam } from './seam/run.js';
 export type PackageRouteKind = 'runtime-plugin' | 'dsh-bundle' | 'neither';
 export interface PackageRoute {
     readonly kind: PackageRouteKind;
@@ -11,7 +11,7 @@ export interface PackageRouter {
 }
 interface RouteOptions {
     readonly spec: string;
-    readonly shell?: DshShell | undefined;
+    readonly seam?: Seam | undefined;
     readonly registry?: string | undefined;
     readonly force?: boolean;
 }
@@ -19,7 +19,7 @@ export interface PackageRouterOptions {
     readonly manifestFile: string;
     readonly cacheDir?: string | undefined;
     readonly dshLookup?: ((options: {
-        shell: DshShell;
+        seam: Seam;
         name: string;
         registry: string;
     }) => Promise<{

package/dist/host/package-route.js

@@ -1,3 +1,4 @@
+import { now } from './time.js';
 import { VERSION_CHECK_TTL_MS } from '../config/constants.js';
 import { dshMarkersOf, splitNpmSpec, verdictOf } from './package-kind.js';
 import { withPackageDir } from './package-content.js';
@@ -32,26 +33,26 @@ async function routeOf(cache, options, routeOptions) {
     const ref = splitNpmSpec(routeOptions.spec);
     if (ref === undefined)
         return undefined;
-    const shell = routeOptions.shell;
+    const seam = routeOptions.seam;
     const registry = routeOptions.registry;
-    if (shell === undefined || registry === undefined)
+    if (seam === undefined || registry === undefined)
         return undefined;
     const key = `${registry}|${routeOptions.spec}`;
     const hit = cache.get(key);
-    if (routeOptions.force !== true && hit !== undefined && Date.now() - hit.at < VERSION_CHECK_TTL_MS) {
+    if (routeOptions.force !== true && hit !== undefined && now() - hit.at < VERSION_CHECK_TTL_MS) {
         return hit.route ?? undefined;
     }
     const found = options.dshLookup === undefined
         ? { readable: false, raw: undefined }
-        : await options.dshLookup({ shell, name: routeOptions.spec, registry });
+        : await options.dshLookup({ seam, name: routeOptions.spec, registry });
     let route;
     if (found.readable && dshMarkersOf(found.raw)) {
         route = { kind: 'dsh-bundle' };
     }
     else {
-        const verdict = await withPackageDir({ shell, spec: routeOptions.spec, registry, ...(options.cacheDir === undefined ? {} : { cacheDir: options.cacheDir }) }, (dir) => verdictOf(dir, options.manifestFile));
+        const verdict = await withPackageDir({ seam, spec: routeOptions.spec, registry, ...(options.cacheDir === undefined ? {} : { cacheDir: options.cacheDir }) }, (dir) => verdictOf(dir, options.manifestFile));
         route = verdict === undefined ? undefined : routeOfVerdict(verdict, ref.name);
     }
-    cache.set(key, { at: Date.now(), route: route ?? null });
+    cache.set(key, { at: now(), route: route ?? null });
     return route;
 }

package/dist/host/panel-state.js

@@ -1,3 +1,4 @@
+import { now } from './time.js';
 /**
  * 留存的工作区上限（LRU，满 64 个丢最旧的）。
  */
@@ -97,7 +98,7 @@ export function parseCrashReport(payload) {
         return { ok: false, message: 'unit 不能是空的' };
     if (reason === '')
         return { ok: false, message: 'reason 不能是空的（没有原因的崩溃没法查）' };
-    return { ok: true, value: { workspace, unit, reason, at: atOf(record['at']) ?? Date.now() } };
+    return { ok: true, value: { workspace, unit, reason, at: atOf(record['at']) ?? now() } };
 }
 /**
  * 造一份面板运行态的留存（进程内存、按工作区分桶，带上面那几条上限的 LRU）。

package/dist/host/patch-blocks.d.ts

@@ -0,0 +1,13 @@
+export interface PatchBlock {
+    readonly key: string;
+    readonly id: string;
+    readonly insert: boolean;
+    readonly body: string;
+    readonly names: readonly string[];
+}
+export interface SpannedBlock extends PatchBlock {
+    readonly from: number;
+    readonly to: number;
+}
+export declare function spannedBlocks(text: string): SpannedBlock[];
+export declare function patchBlocks(text: string): PatchBlock[];

package/dist/host/patch-blocks.js

@@ -0,0 +1,52 @@
+const ID_LINE = /^- id:[ \t]*"?([^"\s#]+)/;
+const INSERT_LINE = /^- insert:[ \t]*$/;
+const NESTED_ID = /^[ \t]+-[ \t]*id:[ \t]*"?([^"\s#]+)/;
+const NAME_LINE = /^[ \t]*-?[ \t]*name:[ \t]*['"]?([^'"\s#]+)/;
+function trimmedTail(lines) {
+    let end = lines.length;
+    while (end > 0 && (lines[end - 1] ?? '').trim() === '')
+        end -= 1;
+    return lines.slice(0, end);
+}
+function matched(text, pattern) {
+    const found = pattern.exec(text);
+    return found === null ? undefined : found[1];
+}
+function blockOf(body, index) {
+    const lines = body.split('\n');
+    const first = lines[0] ?? '';
+    const id = matched(first, ID_LINE);
+    const nested = lines.flatMap((line) => {
+        const one = matched(line, NESTED_ID);
+        return one === undefined ? [] : [one];
+    });
+    const insert = id === undefined && INSERT_LINE.test(first);
+    const label = id ?? nested.join(', ');
+    const key = id !== undefined ? `id:${id}` : insert ? `insert:${nested.join(', ')}` : `block:${String(index)}`;
+    const names = lines.flatMap((line) => {
+        const one = matched(line, NAME_LINE);
+        return one === undefined ? [] : [one];
+    });
+    return { key, id: label === '' ? key : label, insert, body, names };
+}
+export function spannedBlocks(text) {
+    const lines = text.split('\n');
+    const starts = [];
+    lines.forEach((line, index) => {
+        if (/^- /.test(line) || line === '-')
+            starts.push(index);
+    });
+    const blocks = [];
+    for (let i = 0; i < starts.length; i += 1) {
+        const from = starts[i] ?? 0;
+        const to = i + 1 < starts.length ? (starts[i + 1] ?? lines.length) : lines.length;
+        const body = trimmedTail(lines.slice(from, to)).join('\n');
+        if (body.trim() === '')
+            continue;
+        blocks.push({ ...blockOf(body, blocks.length), from, to });
+    }
+    return blocks;
+}
+export function patchBlocks(text) {
+    return spannedBlocks(text).map(({ from: _from, to: _to, ...block }) => block);
+}

package/dist/host/patch.d.ts

@@ -1,9 +1,4 @@
-export interface PatchBlock {
-    readonly key: string;
-    readonly id: string;
-    readonly insert: boolean;
-    readonly body: string;
-    readonly names: readonly string[];
-}
-export declare function patchBlocks(text: string): PatchBlock[];
+import { patchBlocks, type PatchBlock } from './patch-blocks.js';
+export { patchBlocks, type PatchBlock };
+/** 把 patch 文本写回原文件：原子写，保留已有权限位（新文件 0644）。 */
 export declare function writePatchFile(path: string, text: string): void;