@dsh-workbench/shared 0.1.13 → 0.1.15

package/dist/host/context-inject.js

@@ -1,74 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import { encodeRef, parseMarkers } from '@dsh-workbench/shared';
-export const CONTEXT_SOURCE_KIND = 'workbench';
-export function collectContextRefs(messages) {
-    const seen = new Set();
-    const refs = [];
-    for (const message of messages) {
-        if (message.source?.kind !== 'user')
-            continue;
-        for (const block of message.content ?? []) {
-            if (block.type !== 'text' || typeof block.text !== 'string')
-                continue;
-            for (const ref of parseMarkers(block.text)) {
-                const key = encodeRef(ref);
-                if (seen.has(key))
-                    continue;
-                seen.add(key);
-                refs.push(ref);
-            }
-        }
-    }
-    return refs;
-}
-export function buildContextMessage(text, summary) {
-    return {
-        role: 'user',
-        id: randomUUID(),
-        content: [{ type: 'text', text }],
-        source: { kind: CONTEXT_SOURCE_KIND, form: 'notice', summary },
-    };
-}
-export function createContextInjector(options) {
-    const done = new WeakMap();
-    return {
-        async inject(messages, agent) {
-            const refs = collectContextRefs(messages);
-            if (refs.length === 0)
-                return undefined;
-            const key = typeof agent === 'object' && agent !== null ? agent : undefined;
-            const seen = key === undefined ? undefined : (done.get(key) ?? new Set());
-            if (key !== undefined && seen !== undefined)
-                done.set(key, seen);
-            const fresh = [];
-            for (const ref of refs) {
-                const encoded = encodeRef(ref);
-                if (seen?.has(encoded) === true)
-                    continue;
-                seen?.add(encoded);
-                fresh.push(ref);
-            }
-            if (fresh.length === 0)
-                return undefined;
-            const texts = [];
-            for (const ref of fresh) {
-                const render = options.renderers.get(ref.kind);
-                if (render === undefined)
-                    continue;
-                let text;
-                try {
-                    text = await render(ref);
-                }
-                catch (error) {
-                    options.logger?.warn?.(`[dsh-workbench] 渲染对话引用失败：${String(error)}`);
-                    text = `工作台面板引用了一条内容（${encodeRef(ref)}），但当前渲染不出来（项目未选中或数据源不可用）。`;
-                }
-                if (text !== '')
-                    texts.push(text);
-            }
-            if (texts.length === 0)
-                return undefined;
-            return buildContextMessage(texts.join('\n\n'), `工作台引用：${fresh.length} 条`);
-        },
-    };
-}

package/dist/host/events.d.ts

@@ -1,9 +0,0 @@
-import type { DshHostContext, DshRequest, DshResponse } from '@dsh-workbench/shared';
-import type { FactLog } from './facts';
-export interface FactStream {
-    handler(req: DshRequest, res: DshResponse): void;
-    closeAll(): void;
-    size(): number;
-}
-export declare function createFactStream(log: FactLog): FactStream;
-export declare function registerFactStream(ctx: DshHostContext, log: FactLog): () => void;

package/dist/host/events.js

@@ -1,70 +0,0 @@
-import { EVENTS_PATH } from '@dsh-workbench/shared';
-const HEARTBEAT_MS = 25_000;
-function frame(payload) {
-    return `data: ${JSON.stringify(payload)}\n\n`;
-}
-export function createFactStream(log) {
-    const connections = new Set();
-    const cleanups = new Map();
-    const drop = (res) => {
-        cleanups.get(res)?.();
-        cleanups.delete(res);
-        connections.delete(res);
-    };
-    return {
-        size: () => connections.size,
-        closeAll() {
-            for (const res of [...connections]) {
-                drop(res);
-                res.end?.();
-            }
-        },
-        handler(req, res) {
-            if (req.method !== undefined && req.method !== 'GET') {
-                res.statusCode = 405;
-                res.end();
-                return;
-            }
-            const url = req.url ?? '/';
-            const cut = url.indexOf('?');
-            const since = Number(new URLSearchParams(cut === -1 ? '' : url.slice(cut + 1)).get('since') ?? 0) || 0;
-            const opening = log.since(since);
-            if (typeof res.write !== 'function') {
-                res.statusCode = 200;
-                res.setHeader('content-type', 'application/json; charset=utf-8');
-                res.end(JSON.stringify({ ok: true, ...opening }));
-                return;
-            }
-            const headers = {
-                'content-type': 'text/event-stream; charset=utf-8',
-                'cache-control': 'no-store, no-transform',
-                connection: 'keep-alive',
-            };
-            if (typeof res.writeHead === 'function')
-                res.writeHead(200, headers);
-            else {
-                res.statusCode = 200;
-                for (const [name, value] of Object.entries(headers))
-                    res.setHeader(name, value);
-            }
-            res.write(': connected\n\n');
-            res.write(frame({ type: 'sync', ...opening }));
-            connections.add(res);
-            const timer = setInterval(() => res.write?.(': ping\n\n'), HEARTBEAT_MS);
-            const unsubscribe = log.subscribe((change) => res.write?.(frame({ type: 'bump', ...change })));
-            cleanups.set(res, () => {
-                clearInterval(timer);
-                unsubscribe();
-            });
-            res.on?.('close', () => drop(res));
-        },
-    };
-}
-export function registerFactStream(ctx, log) {
-    const stream = createFactStream(log);
-    const unregister = ctx.webServer.register({ kind: 'exact', path: EVENTS_PATH, handler: stream.handler });
-    return () => {
-        stream.closeAll();
-        unregister();
-    };
-}

package/dist/host/mount-units.d.ts

@@ -1,52 +0,0 @@
-import type { DshHostContext } from '@dsh-workbench/shared';
-import type { UnitManifest } from '@dsh-workbench/shared';
-import { type RouteTable } from './http';
-import type { ContextRenderer, UnitHostFace, UnitMountDeps, UnitMountResult, UnitCall } from './unit-face';
-import { type UnitReadiness } from './unit-readiness';
-export interface MountedUnit {
-    readonly face: UnitHostFace;
-    readonly result: UnitMountResult;
-    readonly readiness: UnitReadiness;
-}
-export interface UnitsPlan {
-    readonly mounted: readonly MountedUnit[];
-    readonly routes: RouteTable;
-    readonly gate: UnitMountResult['gate'];
-    readonly prefs: ReadonlyArray<{
-        readonly resource: string;
-        readonly unit: string;
-        handle(payload: unknown): unknown;
-    }>;
-    readonly actions: ReadonlyArray<{
-        readonly resource: string;
-        readonly unit: string;
-        handle(payload: unknown): unknown;
-    }>;
-    readonly provision: UnitMountResult['provision'];
-    readonly contextRenderers: ReadonlyMap<string, ContextRenderer>;
-    readonly owners: ReadonlyMap<string, string>;
-    readonly routesOfUnit: ReadonlyMap<string, readonly string[]>;
-    readonly factsOf: ReadonlyMap<string, (call: UnitCall) => readonly string[] | undefined>;
-    readonly skipped: ReadonlyArray<{
-        readonly id: string;
-        readonly missing: readonly string[];
-    }>;
-    readonly warmReads: () => readonly (readonly string[])[];
-    readonly disposeLongTasks: () => void;
-}
-export declare function mountUnits(faces: readonly UnitHostFace[], deps: {
-    ctx: DshHostContext;
-    logger?: {
-        info?(m: string): void;
-        warn?(m: string): void;
-    } | undefined;
-    manifests: () => readonly UnitManifest[];
-    opencliCommand?: string;
-    probe?: UnitMountDeps['probe'];
-    store?: UnitMountDeps['store'];
-    values?: UnitMountDeps['values'];
-    longTasks?: {
-        readonly scope: string;
-        readonly bump: (facts: readonly string[]) => void;
-    } | undefined;
-}): UnitsPlan;

package/dist/host/mount-units.js

@@ -1,186 +0,0 @@
-import { runsRouteOf } from '@dsh-workbench/shared';
-import { param } from './http';
-import { createLongTaskHost } from './long-task';
-import { unitReadiness } from './unit-readiness';
-import { createWorkspaceStore } from './workspace-store';
-function withRunsRoute(result, unit) {
-    const runs = result.longTasks;
-    if (runs === undefined)
-        return result;
-    return {
-        ...result,
-        routes: {
-            ...result.routes,
-            [runsRouteOf(unit)]: (search) => {
-                const path = (param(search, 'path') ?? '').trim();
-                return { ok: true, runs: path === '' ? [] : runs.current(path) };
-            },
-        },
-    };
-}
-function collectRoutes(mounted) {
-    const routes = {};
-    const owner = new Map();
-    const routesOfUnit = new Map();
-    for (const item of mounted) {
-        const unit = item.face.manifest.id;
-        for (const [key, handler] of Object.entries(item.result.routes)) {
-            if (key !== unit && !key.startsWith(`${unit}/`)) {
-                throw new Error(`路由名要住在自己那一格的命名空间里（${unit} 或 ${unit}/…）：${key} 不属于 ${unit} —— ` +
-                    `装 / 升 / 卸时点名不到它，那个模块的数据会停在旧值`);
-            }
-            const previous = owner.get(key);
-            if (previous !== undefined) {
-                throw new Error(`路由名冲突：${key} 由套件 ${previous} 与 ${unit} 同时声明`);
-            }
-            owner.set(key, unit);
-            routes[key] = handler;
-            const own = routesOfUnit.get(unit);
-            if (own === undefined)
-                routesOfUnit.set(unit, [key]);
-            else
-                own.push(key);
-        }
-    }
-    return { routes, owners: owner, routesOfUnit };
-}
-function pickGate(mounted) {
-    const providers = mounted.filter((item) => item.result.gate !== undefined);
-    if (providers.length > 1) {
-        throw new Error(`启停闸门只能有一个提供者，现在是：${providers.map((item) => item.face.manifest.id).join('、')}`);
-    }
-    return providers[0]?.result.gate;
-}
-function pickProvision(mounted) {
-    const providers = mounted.filter((item) => item.result.provision !== undefined);
-    if (providers.length > 1) {
-        throw new Error(`机器供给只能有一个提供者，现在是：${providers.map((item) => item.face.manifest.id).join('、')}`);
-    }
-    return providers[0]?.result.provision;
-}
-function collectPrefs(mounted) {
-    const owner = new Map();
-    const prefs = [];
-    for (const item of mounted) {
-        const entry = item.result.prefs;
-        if (entry === undefined)
-            continue;
-        const previous = owner.get(entry.resource);
-        if (previous !== undefined) {
-            throw new Error(`偏好资源名冲突：${entry.resource} 由套件 ${previous} 与 ${item.face.manifest.id} 同时声明`);
-        }
-        owner.set(entry.resource, item.face.manifest.id);
-        prefs.push({ ...entry, unit: item.face.manifest.id });
-    }
-    return prefs;
-}
-function collectActions(mounted) {
-    const owner = new Map();
-    const actions = [];
-    for (const item of mounted) {
-        for (const entry of item.result.actions ?? []) {
-            const previous = owner.get(entry.resource);
-            if (previous !== undefined) {
-                throw new Error(`动作资源名冲突：${entry.resource} 由套件 ${previous} 与 ${item.face.manifest.id} 同时声明`);
-            }
-            owner.set(entry.resource, item.face.manifest.id);
-            actions.push({ ...entry, unit: item.face.manifest.id });
-        }
-    }
-    return actions;
-}
-function collectWarmReads(mounted) {
-    const declarations = mounted
-        .map((item) => item.result.warmReads)
-        .filter((declare) => declare !== undefined);
-    return () => {
-        const seen = new Set();
-        const reads = [];
-        for (const read of declarations.flatMap((declare) => declare())) {
-            const key = read.join(' ');
-            if (seen.has(key))
-                continue;
-            seen.add(key);
-            reads.push(read);
-        }
-        return reads;
-    };
-}
-function collectContextRenderers(mounted) {
-    const table = new Map();
-    const owner = new Map();
-    for (const item of mounted) {
-        const context = item.result.context;
-        if (context === undefined)
-            continue;
-        for (const kind of context.kinds) {
-            const previous = owner.get(kind);
-            if (previous !== undefined) {
-                throw new Error(`对话引用的 kind 冲突：${kind} 由套件 ${previous} 与 ${item.face.manifest.id} 同时认领`);
-            }
-            owner.set(kind, item.face.manifest.id);
-            table.set(kind, (ref) => context.render(ref));
-        }
-    }
-    return table;
-}
-export function mountUnits(faces, deps) {
-    const store = deps.store ?? createWorkspaceStore({ root: null });
-    const mounted = [];
-    const skipped = [];
-    const longTaskDisposers = [];
-    for (const face of faces) {
-        const readiness = unitReadiness(face.manifest, (dep) => deps.ctx.get(dep));
-        if (!readiness.canMount) {
-            skipped.push({ id: face.manifest.id, missing: readiness.missingHard });
-            continue;
-        }
-        const unit = face.manifest.id;
-        const longTasks = deps.longTasks === undefined
-            ? undefined
-            : createLongTaskHost({ scope: deps.longTasks.scope, unit, bump: deps.longTasks.bump });
-        if (longTasks !== undefined)
-            longTaskDisposers.push(longTasks.dispose);
-        const result = face.mount({
-            ctx: deps.ctx,
-            logger: deps.logger,
-            manifests: deps.manifests,
-            ...(deps.opencliCommand === undefined ? {} : { opencliCommand: deps.opencliCommand }),
-            ...(deps.probe === undefined ? {} : { probe: deps.probe }),
-            ...(deps.values === undefined ? {} : { values: deps.values }),
-            ...(longTasks === undefined ? {} : { longTasks: longTasks.host }),
-            store,
-        });
-        mounted.push({ face, readiness, result: withRunsRoute(result, unit) });
-    }
-    const collected = collectRoutes(mounted);
-    const prefs = collectPrefs(mounted);
-    const actions = collectActions(mounted);
-    const owners = new Map(collected.owners);
-    for (const entry of [...prefs, ...actions])
-        owners.set(entry.resource, entry.unit);
-    const factsOf = new Map();
-    for (const item of mounted) {
-        const declare = item.result.factsOf;
-        if (declare !== undefined)
-            factsOf.set(item.face.manifest.id, declare);
-    }
-    return {
-        mounted,
-        routes: collected.routes,
-        owners,
-        routesOfUnit: collected.routesOfUnit,
-        factsOf,
-        gate: pickGate(mounted),
-        prefs,
-        actions,
-        provision: pickProvision(mounted),
-        contextRenderers: collectContextRenderers(mounted),
-        skipped,
-        warmReads: collectWarmReads(mounted),
-        disposeLongTasks: () => {
-            for (const dispose of longTaskDisposers.splice(0))
-                dispose();
-        },
-    };
-}

package/dist/host/preflight.d.ts

@@ -1,58 +0,0 @@
-import type { DshShell } from '@dsh-workbench/shared';
-export type PreflightStepId = 'opencli' | 'bridge' | 'warm';
-export type PreflightStepStatus = 'pending' | 'running' | 'ok' | 'warn' | 'failed';
-export interface PreflightStep {
-    readonly id: PreflightStepId;
-    readonly status: PreflightStepStatus;
-    readonly detail?: string;
-    readonly action?: string;
-    readonly command?: string;
-}
-export type PreflightFailure = 'permission' | 'network' | 'missing' | 'unknown';
-export declare function classifyFailure(text: string): PreflightFailure;
-export type PreflightGuidance = 'install' | 'path' | 'shell';
-export type PreflightBridgeIssue = 'daemon' | 'extension' | 'profile' | 'stale' | 'unknown';
-export declare function readBridgeReport(stdout: string): {
-    readonly ok: boolean;
-    readonly issues: readonly PreflightBridgeIssue[];
-    readonly detail: string;
-};
-export interface PreflightSnapshot {
-    readonly phase: 'idle' | 'checking' | 'installing' | 'ready' | 'failed';
-    readonly steps: readonly PreflightStep[];
-    readonly at: number;
-    readonly error?: string;
-    readonly failure?: PreflightFailure;
-    readonly guidance?: PreflightGuidance;
-    readonly bridgeIssues?: readonly PreflightBridgeIssue[];
-}
-export interface Preflight {
-    run(options?: {
-        force?: boolean;
-    }): Promise<PreflightSnapshot>;
-    snapshot(): PreflightSnapshot;
-}
-export declare const OPENCLI_INSTALL_COMMAND: string;
-export interface BridgeVerdict {
-    readonly ok: boolean;
-    readonly detail: string;
-    readonly issues: readonly PreflightBridgeIssue[];
-    readonly command?: string | undefined;
-}
-export declare function canWarm(bridge: {
-    ok: boolean;
-    issues: readonly PreflightBridgeIssue[];
-}): boolean;
-export declare function createPreflight(options: {
-    shell: DshShell;
-    command?: string;
-    installCommand?: string;
-    logger?: {
-        warn?(message: string): void;
-    } | undefined;
-    install?: (() => Promise<{
-        ok: boolean;
-        detail: string;
-    }>) | undefined;
-    warmReads?: (() => readonly (readonly string[])[]) | undefined;
-}): Preflight;

package/dist/host/preflight.js

@@ -1,233 +0,0 @@
-import { INSTALL_TIMEOUT_MS, OPENCLI_TIMEOUT_MS, WARM_TIMEOUT_MS } from '@dsh-workbench/shared';
-import { tailLines } from '@dsh-workbench/shared';
-import { opencliCommandLine } from './opencli';
-import { isolatedInstallCommand } from './opencli-runtime';
-import { runShell } from './shell';
-export function classifyFailure(text) {
-    const lower = text.toLowerCase();
-    if (/eacces|eperm|permission denied|operation not permitted/.test(lower))
-        return 'permission';
-    if (/enotfound|etimedout|econnrefused|econnreset|network|proxy|fetch failed/.test(lower))
-        return 'network';
-    if (/command not found|not found|no such file/.test(lower))
-        return 'missing';
-    return 'unknown';
-}
-export function readBridgeReport(stdout) {
-    const text = String(stdout ?? '');
-    const ok = /^\[OK\] Daemon:/m.test(text) && /^\[OK\] Extension:/m.test(text) && /^\[OK\] Connectivity:/m.test(text);
-    if (ok) {
-        const good = text.split('\n').find((line) => line.trim() === 'Everything looks good!');
-        return { ok: true, issues: [], detail: good?.trim() ?? tailLines(text, 1) };
-    }
-    const found = new Set();
-    if (!/^\[OK\] Daemon:/m.test(text))
-        found.add('daemon');
-    if (!/^\[OK\] Extension:/m.test(text))
-        found.add('extension');
-    if (/Multiple Chrome profiles are connected/i.test(text))
-        found.add('profile');
-    if (/Default browser profile is stale|Selected browser profile is not connected/i.test(text)) {
-        found.add('stale');
-    }
-    if (found.has('profile') || found.has('stale'))
-        found.delete('extension');
-    if (found.size === 0)
-        found.add('unknown');
-    const order = ['profile', 'stale', 'daemon', 'extension', 'unknown'];
-    return { ok: false, issues: order.filter((issue) => found.has(issue)), detail: issuesSection(text) };
-}
-function issuesSection(text) {
-    const lines = text.split('\n');
-    const start = lines.findIndex((line) => /^Issues:/.test(line.trim()));
-    if (start < 0)
-        return tailLines(text, 6);
-    return lines.slice(start).join('\n').trim();
-}
-function bridgeFixCommand(command, issues) {
-    if (issues.includes('profile') || issues.includes('stale'))
-        return `${command} profile list`;
-    if (issues.includes('daemon') || issues.includes('extension'))
-        return `${command} daemon restart`;
-    return undefined;
-}
-export const OPENCLI_INSTALL_COMMAND = isolatedInstallCommand();
-const WARMABLE_BRIDGE_ISSUES = ['daemon', 'stale'];
-export function canWarm(bridge) {
-    return bridge.ok || bridge.issues.every((issue) => WARMABLE_BRIDGE_ISSUES.includes(issue));
-}
-function step(id) {
-    return { id, status: 'pending' };
-}
-export function createPreflight(options) {
-    const { shell, command = 'opencli', logger } = options;
-    const installCommand = options.installCommand ?? OPENCLI_INSTALL_COMMAND;
-    const warmReads = () => options.warmReads?.() ?? [];
-    const steps = () => [
-        step('opencli'),
-        step('bridge'),
-        ...(warmReads().length === 0 ? [] : [step('warm')]),
-    ];
-    let current = { phase: 'idle', steps: steps(), at: Date.now() };
-    let running = null;
-    let latest = null;
-    let rerun = false;
-    function set(next) {
-        current = { ...current, ...next, at: Date.now() };
-        return current;
-    }
-    function patchStep(id, patch) {
-        return set({ steps: current.steps.map((item) => (item.id === id ? { ...item, ...patch } : item)) });
-    }
-    async function exec(commandLine, timeoutMs) {
-        try {
-            const result = await runShell(shell, commandLine, { timeoutMs });
-            if (result.timedOut) {
-                return { kind: 'error', detail: `超时（${String(timeoutMs)} ms）：${commandLine}` };
-            }
-            if (result.exitCode !== 0) {
-                return { kind: 'nonzero', detail: tailLines(result.stderr || result.stdout, 4) };
-            }
-            return { kind: 'ok', stdout: result.stdout };
-        }
-        catch (error) {
-            return { kind: 'error', detail: String(error) };
-        }
-    }
-    async function probeVersion() {
-        const result = await exec(`${command} --version`, OPENCLI_TIMEOUT_MS);
-        if (result.kind === 'ok')
-            return { ok: true, missing: false, detail: result.stdout.trim().split('\n')[0] ?? '' };
-        return { ok: false, missing: result.kind === 'nonzero', detail: result.detail };
-    }
-    async function probeBridge() {
-        const result = await exec(`${command} doctor`, OPENCLI_TIMEOUT_MS);
-        if (result.kind !== 'ok')
-            return { ok: false, detail: result.detail, issues: ['unknown'] };
-        const report = readBridgeReport(result.stdout);
-        if (report.ok)
-            return report;
-        return { ...report, command: bridgeFixCommand(command, report.issues) };
-    }
-    async function installOpencli() {
-        if (options.install !== undefined)
-            return options.install();
-        const result = await exec(installCommand, INSTALL_TIMEOUT_MS);
-        if (result.kind !== 'ok')
-            return { ok: false, detail: result.detail };
-        return { ok: true, detail: tailLines(result.stdout, 1) };
-    }
-    async function warmSites(bridge) {
-        const reads = warmReads();
-        if (reads.length === 0)
-            return bridge;
-        if (!canWarm(bridge)) {
-            patchStep('warm', { status: 'warn', detail: '' });
-            return bridge;
-        }
-        patchStep('warm', {
-            status: 'running',
-            action: `${command} <套件自己声明的那条读命令> --site-session persistent -f json`,
-        });
-        const results = await Promise.all(reads.map((read) => exec(opencliCommandLine(command, read), WARM_TIMEOUT_MS)));
-        const failed = reads.filter((_, index) => results[index]?.kind !== 'ok');
-        patchStep('warm', {
-            status: failed.length === 0 ? 'ok' : 'warn',
-            detail: failed.length === 0 ? String(reads.length) : failed.map((read) => read.join(' ')).join(' '),
-            action: undefined,
-        });
-        if (bridge.ok)
-            return bridge;
-        const again = await probeBridge();
-        patchStep('bridge', {
-            status: again.ok ? 'ok' : 'warn',
-            detail: again.detail,
-            action: undefined,
-            command: again.command,
-        });
-        return again;
-    }
-    async function doRun() {
-        set({ phase: 'checking', error: undefined, failure: undefined, steps: steps() });
-        patchStep('opencli', { status: 'running', action: `${command} --version` });
-        let version = await probeVersion();
-        if (!version.ok && !version.missing) {
-            patchStep('opencli', { status: 'failed', detail: version.detail, action: undefined });
-            return set({
-                phase: 'failed',
-                error: version.detail,
-                failure: classifyFailure(version.detail),
-                guidance: 'shell',
-            });
-        }
-        if (!version.ok) {
-            set({ phase: 'installing' });
-            patchStep('opencli', { status: 'running', action: installCommand, command: installCommand });
-            const installed = await installOpencli();
-            if (!installed.ok) {
-                patchStep('opencli', {
-                    status: 'failed',
-                    detail: installed.detail,
-                    command: installCommand,
-                });
-                return set({
-                    phase: 'failed',
-                    error: installed.detail,
-                    failure: classifyFailure(installed.detail),
-                    guidance: 'install',
-                });
-            }
-            patchStep('opencli', { status: 'running', action: `${command} --version` });
-            version = await probeVersion();
-            if (!version.ok) {
-                patchStep('opencli', { status: 'failed', detail: version.detail, command: installCommand });
-                return set({
-                    phase: 'failed',
-                    error: version.detail,
-                    failure: classifyFailure(version.detail),
-                    guidance: 'path',
-                });
-            }
-        }
-        patchStep('opencli', { status: 'ok', detail: version.detail, action: undefined });
-        patchStep('bridge', { status: 'running', action: `${command} doctor` });
-        const bridge = await probeBridge();
-        const healable = !bridge.ok && warmReads().length > 0 && canWarm(bridge);
-        if (!healable) {
-            patchStep('bridge', {
-                status: bridge.ok ? 'ok' : 'warn',
-                detail: bridge.detail,
-                action: undefined,
-                ...(bridge.command === undefined ? {} : { command: bridge.command }),
-            });
-        }
-        const settled = await warmSites(bridge);
-        logger?.warn?.(`[dsh-workbench] 环境体检：${current.steps.map((item) => `${item.id}=${item.status}`).join(' ')}`);
-        return set({ phase: 'ready', ...(settled.ok ? {} : { bridgeIssues: settled.issues }) });
-    }
-    async function start(runOptions = {}) {
-        if (running !== null) {
-            if (runOptions.force === true)
-                rerun = true;
-            return running;
-        }
-        if (runOptions.force !== true && latest !== null)
-            return latest;
-        const inflight = doRun();
-        latest = inflight;
-        running = inflight;
-        await inflight.catch(() => undefined);
-        running = null;
-        if (rerun) {
-            rerun = false;
-            return start({ force: true });
-        }
-        return inflight;
-    }
-    return {
-        run: start,
-        snapshot() {
-            return current;
-        },
-    };
-}