@dsh-workbench/shared 1.1.8 → 1.1.9

package/src/components/{SelectField.test.tsx → __tests__/SelectField.test.tsx}

@@ -1,7 +1,7 @@
 import { describe, expect, it, vi } from 'vitest';
 
 let states: unknown[] = [];
-vi.mock('../lib/react.js', () => ({
+vi.mock('../../lib/react.js', () => ({
   Fragment: Symbol.for('react.fragment'),
   h: (type: unknown, props: unknown, ...children: unknown[]) => ({ type, props, children }),
   useEffect: () => {},
@@ -10,21 +10,21 @@ vi.mock('../lib/react.js', () => ({
   useState: (initial: unknown) => [states.length > 0 ? states.shift() : initial, () => {}],
 }));
 
-vi.mock('./SelectField.css', () => ({ default: {} }));
+vi.mock('../SelectField.css', () => ({ default: {} }));
 
 import { Menu, TextShimmer } from '@deepseek-ai/dsh-client-ui-primitives';
-import { Spinner } from './Spinner.js';
+import { Spinner } from '../Spinner.js';
 import type { MenuEntry } from '@deepseek-ai/dsh-client-ui-primitives';
-import { h } from '../lib/react.js';
-import { Field } from './Field.js';
-import { TextField } from './TextField.js';
+import { h } from '../../lib/react.js';
+import { Field } from '../Field.js';
+import { TextField } from '../TextField.js';
 import {
   SelectField,
   defaultSelectFilter,
   selectCursorValue,
   selectEntries,
   stepSelectCursor,
-} from './SelectField.js';
+} from '../SelectField.js';
 
 interface AnyElement {
   readonly type: unknown;
@@ -54,10 +54,6 @@ function elementsOf(root: unknown): readonly AnyElement[] {
   return collect(root);
 }
 
-function marked(nodes: readonly AnyElement[]): boolean {
-  return nodes.some((one) => one.props?.['data-wb-select-reveal'] === '');
-}
-
 function menuOf(root: unknown): AnyElement {
   const menu = elementsOf(root).find((one) => one.type === Menu);
   if (menu === undefined) throw new Error('没有渲染出 Menu');
@@ -276,32 +272,6 @@ describe('SelectField：工作区那套下拉的公共形状', () => {
     expect(defaultSelectFilter(option, 'nope')).toBe(false);
   });
 
-  it('★ revealId：只给那一行的图标裹上标记（开列表时靠它滚进可视区），别行一个字节不变', () => {
-    const items = selectEntries(
-      [
-        { value: 'a', label: '甲', icon: <span>甲</span> },
-        { value: 'b', label: '乙', icon: <span>乙</span> },
-      ],
-      undefined,
-      'b',
-    );
-    const iconOf = (id: string): unknown =>
-      (items.find((one) => (one as { id?: string }).id === id) as { icon?: unknown } | undefined)?.icon;
-
-    expect(marked(elementsOf(iconOf('a')))).toBe(false);
-    expect(marked(elementsOf(iconOf('b')))).toBe(true);
-  });
-
-  it('★ revealId 撞上没有图标的行：退而标记它的文字（标记只落一处）', () => {
-    const items = selectEntries([{ value: 'a', label: '甲' }], undefined, 'a');
-    const row = items.find((one) => (one as { id?: string }).id === 'a') as
-      | { label?: unknown; icon?: unknown }
-      | undefined;
-
-    expect(row?.icon).toBeUndefined();
-    expect(marked(elementsOf(row?.label))).toBe(true);
-  });
-
   it('条目构造：图标与禁用照传，分组标题只在换组时出现一次', () => {
     const items = selectEntries(
       [

package/src/components/{Spinner.test.tsx → __tests__/Spinner.test.tsx}

@@ -1,13 +1,13 @@
 import { describe, expect, it, vi } from 'vitest';
 
-vi.mock('../lib/react.js', async () => {
-  const actual = await vi.importActual<typeof import('../lib/react.js')>('../lib/react.js');
+vi.mock('../../lib/react.js', async () => {
+  const actual = await vi.importActual<typeof import('../../lib/react.js')>('../../lib/react.js');
   return { ...actual, h: (type: unknown, props?: unknown, ...children: unknown[]) => ({ type, props: props ?? {}, children }) };
 });
-vi.mock('./Spinner.css', () => ({ default: {} }));
+vi.mock('../Spinner.css', () => ({ default: {} }));
 
 import { StateDot } from '@deepseek-ai/dsh-client-ui-primitives';
-import { Spinner } from './Spinner.js';
+import { Spinner } from '../Spinner.js';
 
 describe('Spinner（loading 那颗）', () => {
   it('画的是 dsh 的 ongoing 状态点（视觉只有这一处实现）', () => {

package/src/config/{constants.test.ts → __tests__/constants.test.ts}

@@ -8,7 +8,7 @@ import {
   PLUGIN_ID,
   STORAGE_KEY_PROJECT,
   STORAGE_KEY_RIGHTBAR,
-} from './constants.js';
+} from '../constants.js';
 
 describe('constants', () => {
   it('API_PREFIX 是合法前缀：以 / 开头、不以 / 结尾、不带查询符', () => {

package/src/config/{storage.test.ts → __tests__/storage.test.ts}

@@ -1,5 +1,5 @@
 import { afterEach, describe, expect, it, vi } from 'vitest';
-import { readText, writeText } from './storage.js';
+import { readText, writeText } from '../storage.js';
 
 function fakeStorage(options: { throwOnWrite?: boolean } = {}) {
   const data = new Map<string, string>();

package/src/config/constants.ts

@@ -31,7 +31,7 @@ export const DIY_RECORD_ACT_PATH = `${DIY_RECORD_PATH}/act`;
 /** 面板运行态的路由前缀，挂在外壳 API 下：上报口用它，拒报回 report-refused。 */
 export const PANEL_STATE_PREFIX = `${API_PREFIX}/${PANEL_STATE_PATH}`;
 
-/** 钉住的 opencli 插件版本：`opencli-runtime` 按它校验、取那一份。 */
+/** 钉住的运行时版本：隔离运行时按它校验、取那一份。 */
 export const OPENCLI_PIN = "1.8.8";
 
 /** 缺陷看板套件的 dsh 服务名（`workbenchIssues`）：套件照它登记自己那份服务。 */
@@ -55,13 +55,13 @@ export const DIY_RECORD_SERVICE = "workbenchDiyRecord";
 /** 会话投影服务的 dsh 服务名（`sessionProjections`）：宿主经 `stateOf(session, 'agentPreset')` 读那一档。 */
 export const SESSION_PROJECTIONS_SERVICE = "sessionProjections";
 
-/** 面板清单一次取回的行数上限（条）：外部模块拿它当 opencli `--pageSize`。 */
+/** 面板清单一次取回的行数上限（条）：外部模块拿它当分页参数。 */
 export const PANEL_LIST_LIMIT = 50;
 
-/** 单次 opencli 调用的默认超时（毫秒）；调用点没传 `timeoutMs` 时按它算。 */
+/** 单次运行时调用的默认超时（毫秒）；调用点没传 `timeoutMs` 时按它算。 */
 export const OPENCLI_TIMEOUT_MS = 120_000;
 
-/** 同时最多几条 opencli 在跑（条）：`opencli.ts` 超出就排队。 */
+/** 同时最多几条运行时调用在跑（条）：超出就排队。 */
 export const OPENCLI_MAX_CONCURRENT = 4;
 
 /** 启动预热站点那一跳的超时（毫秒）；超时按未热对待，不挡面板。 */

package/src/contract/capabilities.ts

@@ -0,0 +1,30 @@
+export interface RuntimeCapabilities {
+  readonly console: boolean;
+  readonly pluginMarket: boolean;
+  readonly browserBridge: boolean;
+}
+
+export interface RuntimeText {
+  readonly zh: string;
+  readonly en: string;
+}
+
+export interface RuntimeTerms {
+  readonly plugin: RuntimeText;
+  readonly pluginOf: RuntimeText;
+  readonly pluginThing: RuntimeText;
+  readonly pluginArea: RuntimeText;
+}
+
+export interface RuntimeBridgeFix {
+  readonly text: RuntimeText;
+  readonly link?: { readonly label: RuntimeText; readonly href: string };
+}
+
+export interface RuntimeProfile {
+  readonly label: string;
+  readonly terms: RuntimeTerms;
+  readonly installHint: RuntimeText;
+  readonly diagnose: Readonly<Partial<Record<'exec' | 'login' | 'bridge', RuntimeText>>>;
+  readonly bridge?: Readonly<Partial<Record<string, RuntimeBridgeFix>>>;
+}

package/src/contract/needs.ts

@@ -69,7 +69,7 @@ export interface BinNeed extends NeedCommon {
 }
 
 /**
- * 某个运行时上要有一个扩展（opencli 的插件就是这种），并且要提供这些命令。
+ * 某个运行时上要有一个扩展（运行时自己的插件就是这种），并且要提供这些命令。
  */
 export interface ExtensionNeed extends NeedCommon {
   readonly kind: 'extension';
@@ -82,8 +82,8 @@ export interface ExtensionNeed extends NeedCommon {
 
 /**
  * 要在隔离运行时里有一个共用依赖包。
- * `runs` 写它自己会起哪些运行时的命令（如 `["opencli"]`）—— 写了外壳就把那份执行器注入进去
- * （库侧约定 `setOpencliRunner`）；不写就按它自己在 PATH 上找。
+ * `runs` 写它自己会起哪个运行时的命令 —— 写了外壳就把那份执行器注入进去
+ * （库侧约定 `set<Runtime>Runner`）；不写就按它自己在 PATH 上找。
  */
 export interface LibNeed extends NeedCommon {
   readonly kind: 'lib';
@@ -294,7 +294,7 @@ function perKindProblemsOf(
   if (raw['docs'] !== undefined && text(raw['docs']) === '') errors.push(`${at}.docs 是空串`);
   if (kind === 'lib') errors.push(...libRunsProblemsOf(raw['runs'], at));
   if (kind === 'extension') {
-    if (text(raw['runtime']) === '') errors.push(`${at}.runtime 没写 —— 扩展属于哪个运行时（如 opencli）`);
+    if (text(raw['runtime']) === '') errors.push(`${at}.runtime 没写 —— 扩展属于哪个运行时`);
     if (text(raw['name']) === '') errors.push(`${at}.name 没写`);
     if (raw['commands'] !== undefined) {
       if (!Array.isArray(raw['commands'])) errors.push(`${at}.commands 要是数组`);

package/src/contract/plugin-source.ts

@@ -1 +1,25 @@
 export type ProvisionProblem = 'not-declared' | 'env-missing' | 'malformed';
+
+export interface PluginSourceCommand {
+  readonly line: string;
+  readonly optional?: true;
+}
+
+export type ResolvedPluginSource =
+  | {
+      readonly ok: true;
+      readonly commands: readonly PluginSourceCommand[];
+      readonly line: string;
+    }
+  | {
+      readonly ok: false;
+      readonly problem: ProvisionProblem;
+      readonly env?: string;
+    };
+
+export interface PluginSourceOptions {
+  readonly command?: string;
+  readonly plugin?: string;
+  readonly version?: string;
+  readonly mode?: 'install' | 'update';
+}

package/src/contract/protocol/bundle-install.ts

@@ -155,8 +155,14 @@ export interface BundleSupplyPayload {
   readonly reason?: string;
 }
 
+export type PluginPackageKind = 'runtime-plugin';
+
+export function isPluginPackageKind(kind: unknown): kind is PluginPackageKind {
+  return kind === 'runtime-plugin';
+}
+
 export interface BundleInstalledPlugin {
-  readonly kind: 'opencli-plugin';
+  readonly kind: PluginPackageKind;
   readonly pkg: string;
   readonly name?: string;
 }

package/src/contract/protocol/platform.ts

@@ -21,7 +21,7 @@ export interface HostCapabilities {
 
 export interface ToolchainPlan {
   readonly node: { readonly source: 'desktop-shim' | 'path' };
-  readonly npm: { readonly neededFor: 'opencli-install' };
+  readonly npm: { readonly neededFor: 'runtime-install' };
   readonly pnpm: { readonly neededFor: 'workshop'; readonly expectedMajor: 10 };
 }
 

package/src/contract/runner.ts

@@ -0,0 +1,6 @@
+/**
+ * 一条运行时命令的执行器：同一形状的 `execFile('<runtime>', args)`，结果只留 stdout。
+ */
+export type LibRunner = (
+  args: readonly string[],
+) => Promise<{ readonly stdout: string }>;

package/src/contract/unit.ts

@@ -25,9 +25,9 @@ export interface UnitCard {
 }
 
 /**
- * 合成工具背后那条 opencli 命令：插件名与命令名都是 opencli 那边的原名，`args` 是命令自己声明的参数名（按声明顺序）。
+ * 合成工具背后那条运行时命令：插件名与命令名都是运行时那边的原名，`args` 是命令自己声明的参数名（按声明顺序）。
  */
-export interface UnitToolOpencli {
+export interface UnitToolRuntime {
   readonly plugin: string;
   readonly command: string;
   readonly args: readonly string[];
@@ -35,12 +35,12 @@ export interface UnitToolOpencli {
 
 /**
  * 一条工具在清单里的样子：全名加会不会写；审批按 writes 认领。
- * `opencli` 只有「按已装插件合成」的单元写，手写模块的工具没有这一格。
+ * `runtime` 只有「按已装插件合成」的单元写，手写模块的工具没有这一格。
  */
 export interface UnitTool {
   readonly name: string;
   readonly writes: boolean;
-  readonly opencli?: UnitToolOpencli;
+  readonly runtime?: UnitToolRuntime;
 }
 
 /**

package/src/host/{extension.test.ts → __tests__/extension.test.ts}

@@ -1,7 +1,7 @@
 import { describe, expect, it } from 'vitest';
-import type { DataReader } from '../contract/data.js';
-import type { ExtensionNeed } from '../contract/needs.js';
-import { extensionCallerOf } from './extension.js';
+import type { DataReader } from '../../contract/data.js';
+import type { ExtensionNeed } from '../../contract/needs.js';
+import { extensionCallerOf } from '../extension.js';
 
 const NEED: ExtensionNeed = {
   kind: 'extension',
@@ -32,7 +32,7 @@ describe('extensionCallerOf', () => {
     await expect(caller.json(['issue-statuses'])).rejects.toMatchObject({
       code: 'cli-unclassified',
       message: expect.stringContaining('workbench_modules_update（id=coding-issues）'),
-      hint: expect.stringContaining('opencli coding issue-statuses --help'),
+      hint: expect.stringContaining('coding issue-statuses --help'),
       detail: "error: unknown command 'issue-statuses'",
     });
   });

package/src/host/{install-failure.test.ts → __tests__/install-failure.test.ts}

@@ -4,7 +4,7 @@ import {
   installFailureOf,
   installTargets,
   installWriteProblem,
-} from './install-failure.js';
+} from '../install-failure.js';
 
 const CURRENT = { uid: 502, gid: 20 };
 

package/src/host/{installed-sources.test.ts → __tests__/installed-sources.test.ts}

@@ -8,7 +8,7 @@ import {
   packageSourceOf,
   readInstalledSources,
   rememberPackageSource,
-} from './installed-sources.js';
+} from '../installed-sources.js';
 
 const dirs: string[] = [];
 

package/src/host/__tests__/lib-runners.test.ts

@@ -1,10 +1,10 @@
 import { describe, expect, it, vi } from 'vitest';
 import type { LibNeed } from '../../contract/needs.js';
 import type { LibReader } from '../../contract/lib.js';
-import type { OpencliRunner } from '../opencli-runner.js';
+import type { LibRunner } from '../../contract/runner.js';
 import { withLibRunners } from '../lib-runners.js';
 
-const runner: OpencliRunner = async () => ({ stdout: '[]' });
+const runner: LibRunner = async () => ({ stdout: '[]' });
 
 function needOf(runs?: readonly string[]): LibNeed {
   return {
@@ -28,6 +28,15 @@ function logger(): { readonly warn: ReturnType<typeof vi.fn<(message: string) =>
 }
 
 describe('withLibRunners', () => {
+  it('★ 换一个运行时名字（mcp）照样注入：外壳不认具体名字，只看清单的 runs', async () => {
+    const module = { setMcpRunner: vi.fn() };
+    const libs = withLibRunners(libsOf(module), { mcp: runner }, logger());
+
+    await libs.load(needOf(['mcp']), 'src/run.js');
+
+    expect(module.setMcpRunner).toHaveBeenCalledWith(runner);
+  });
+
   it('没声明 runs → 原样返回，不注入、不记 warn', async () => {
     const module = { setOpencliRunner: vi.fn() };
     const warn = logger();

package/src/host/__tests__/plugin-ledger.test.ts

@@ -13,7 +13,7 @@ const HOME = '/h/workbench/opencli/home';
 
 function entry(over: Partial<PluginLedgerEntry> = {}): PluginLedgerEntry {
   return {
-    opencliHome: HOME,
+    home: HOME,
     package: 'opencli-plugin-inventory',
     installedAt: '2026-10-14T00:00:00.000Z',
     ...over,
@@ -44,11 +44,11 @@ describe('台账条目的「放手」那一笔', () => {
   });
 
   it('另一个 home 的那一笔不受影响（隔离 wrapper 会换 home）', () => {
-    const other = entry({ opencliHome: '/h/global/opencli/home' });
+    const other = entry({ home: '/h/global/opencli/home' });
     const released = withReleasedEntry([entry(), other], HOME, 'opencli-plugin-inventory', '2026-10-15T00:00:00.000Z');
 
-    expect(released.find((item) => item.opencliHome !== HOME)?.releasedAt).toBeUndefined();
-    expect(heldEntriesOfHome(released, other.opencliHome)).toHaveLength(1);
+    expect(released.find((item) => item.home !== HOME)?.releasedAt).toBeUndefined();
+    expect(heldEntriesOfHome(released, other.home)).toHaveLength(1);
   });
 
   it('★ 按插件名找"用户持着的"那一份：插件名与包名两边都认（§3.4 那条映射）', () => {
@@ -67,8 +67,8 @@ describe('台账条目的「放手」那一笔', () => {
   });
 
   it('键还是「home + 包名」（同一份文件里两个 home 不互相撒谎）', () => {
-    expect(ledgerKeyOf({ opencliHome: '/a', package: 'x' })).not.toBe(
-      ledgerKeyOf({ opencliHome: '/b', package: 'x' }),
+    expect(ledgerKeyOf({ home: '/a', package: 'x' })).not.toBe(
+      ledgerKeyOf({ home: '/b', package: 'x' }),
     );
   });
 });
@@ -92,3 +92,16 @@ describe('物理去留：由谁主张说话（动作与结果分层那条）', (
     expect(pluginRetentionOf({ held: false, claimedBy: [], trustworthy: true })).toBe('remove');
   });
 });
+
+describe('落盘字段改名后的老台账', () => {
+  it('★ 老文件里的 opencliHome 还认（改名不动数据）', () => {
+    const entries = parsePluginLedger({
+      entries: [
+        { opencliHome: '/dsh/home-a', package: 'demo', installedAt: '2026-10-14T00:00:00.000Z' },
+        { home: '/dsh/home-b', package: 'other', installedAt: '2026-10-14T00:00:00.000Z' },
+      ],
+    });
+
+    expect(entries.map((entry) => entry.home)).toEqual(['/dsh/home-a', '/dsh/home-b']);
+  });
+});

package/src/host/{recipe.test.ts → __tests__/recipe.test.ts}

@@ -1,7 +1,7 @@
 import { describe, expect, it } from 'vitest';
-import type { CallOverrides, RequestRecipe } from '../contract/data.js';
-import { describeRecipe, scriptOf, scriptOfMany } from './recipe.js';
-import { callsProblemOf, MAX_RECIPE_CALLS, recipeProblemOf } from './recipe-rules.js';
+import type { CallOverrides, RequestRecipe } from '../../contract/data.js';
+import { describeRecipe, scriptOf, scriptOfMany } from '../recipe.js';
+import { callsProblemOf, MAX_RECIPE_CALLS, recipeProblemOf } from '../recipe-rules.js';
 
 const BASE: RequestRecipe = {
   origin: 'https://x.example.com',

package/src/host/__tests__/runtime-layout.test.ts

@@ -0,0 +1,14 @@
+import { describe, expect, it } from 'vitest';
+import { runtimeLayoutOf, runtimeRootOf } from '../paths.js';
+
+describe('运行时根的算法（这里不认识任何具体运行时）', () => {
+  it('就是 workbench 根加一个 id，别处自己拼下面的布局', () => {
+    const layout = runtimeLayoutOf('demo-runtime');
+
+    expect(layout.root).toBe(runtimeRootOf('demo-runtime'));
+    expect(layout.root.endsWith('/workbench/demo-runtime')).toBe(true);
+    expect(layout.vendorPluginsDir).toBe(`${layout.root}/plugins-npm/node_modules`);
+    expect(layout.libsPrefix).toBe(`${layout.root}/libs`);
+    expect(layout.npmCacheDir).toBe(`${layout.root}/npm-cache`);
+  });
+});

package/src/host/__tests__/supply-index.test.ts

@@ -51,7 +51,7 @@ describe('供给索引：一个包只有一个来源', () => {
     const index = buildSupplyIndex([
       manifest('a', [extension('coding', [npm('opencli-plugin-coding')])]),
       manifest('b', [extension('coding')]),
-    ]);
+    ], { packagePrefix: 'opencli-plugin-' });
 
     expect(index.conflicts.map((item) => item.kind)).toEqual(['source-mismatch']);
     expect(index.entryOf('extension', 'coding')?.conflicted).toBe(true);
@@ -152,7 +152,7 @@ describe('供给索引：一个包只有一个来源', () => {
   });
 
   it('没写 sources 的 extension 按约定落包名，进索引但不代装', () => {
-    const index = buildSupplyIndex([manifest('a', [extension('coding')])]);
+    const index = buildSupplyIndex([manifest('a', [extension('coding')])], { packagePrefix: 'opencli-plugin-' });
 
     expect(index.entryOf('extension', 'coding')?.package).toBe('opencli-plugin-coding');
     expect(index.sourcesOf('extension', 'coding')).toEqual([]);

package/src/host/__tests__/supply-port.test.ts

@@ -0,0 +1,32 @@
+import { describe, expect, it } from 'vitest';
+import { supplyPortOf } from '../supply-port.js';
+import { WORKBENCH_ADAPTERS } from '../adapters.js';
+import { fakeAdapterSet } from '../../testing/fake-adapter-set.js';
+
+function ctxOf(set: ReturnType<typeof fakeAdapterSet>): never {
+  return { get: (name: string) => (name === WORKBENCH_ADAPTERS ? set : undefined) } as never;
+}
+
+describe('组合出给外壳的 supply 端口', () => {
+  it('给了 CLI 目录就透传（opencli 那类运行时）', () => {
+    const port = supplyPortOf(ctxOf(fakeAdapterSet()));
+
+    expect(port.cliCatalogPath?.()).toBe('/tmp/dsh-workbench-fake/catalog.json');
+    expect(port.vendorPluginsDir?.()).toContain('dsh-workbench-fake');
+    expect(port.runtimeInstallCommand?.()).toBeTruthy();
+  });
+
+  it('★ 没给就整条不挂（纯 API 的运行时不用瞎编目录）', () => {
+    const set = fakeAdapterSet();
+    const modules = { ...set.modules } as Record<string, unknown>;
+    delete modules['cliCatalogPath'];
+    delete modules['vendorPluginsDir'];
+    delete modules['runtimeInstallCommand'];
+    const port = supplyPortOf(ctxOf({ ...set, modules } as never));
+
+    expect(port.cliCatalogPath).toBeUndefined();
+    expect(port.vendorPluginsDir).toBeUndefined();
+    expect(port.runtimeInstallCommand).toBeUndefined();
+    expect(port.isolatedRoot()).toBeTruthy();
+  });
+});

package/src/host/adapter-contract.ts

@@ -0,0 +1,93 @@
+import type { DshHostContext } from '../api/dsh.js';
+import type { AdapterSet } from './adapters.js';
+import { validateAdapterSet } from './adapter-set.js';
+
+const CAPABILITY_KEYS = ['console', 'pluginMarket', 'browserBridge'] as const;
+const DATA_METHODS = ['read', 'request', 'requestMany', 'submit'] as const;
+
+function isNonEmptyString(value: unknown): boolean {
+  return typeof value === 'string' && value.trim() !== '';
+}
+
+const CLI_DIR_METHODS = [
+  ['cliCatalogPath', 'cliCatalogPath'],
+  ['vendorPluginsDir', 'vendorPluginsDir'],
+] as const;
+
+export function adapterContractGaps(set: AdapterSet, ctx: DshHostContext): readonly string[] {
+  const gaps: string[] = [];
+  const validated = validateAdapterSet(set, '契约');
+  if (!validated.ok) {
+    gaps.push(`成员不全：${validated.detail}`);
+    return gaps;
+  }
+
+  if (!Number.isInteger(set.apiVersion) || set.apiVersion < 1) {
+    gaps.push(`apiVersion 不是正整数：${String(set.apiVersion)}`);
+  }
+
+  const capabilities = set.runtime.capabilities(ctx);
+  for (const key of CAPABILITY_KEYS) {
+    if (typeof capabilities[key] !== 'boolean') gaps.push(`capabilities.${key} 不是布尔值`);
+  }
+
+  if (typeof set.runtime.profile === 'function') {
+    const profile = set.runtime.profile(ctx);
+    if (!isNonEmptyString(profile?.label)) gaps.push('runtime.profile().label 不是非空字符串');
+    for (const key of ['plugin', 'pluginOf', 'pluginThing', 'pluginArea'] as const) {
+      const text = profile?.terms?.[key];
+      if (!isNonEmptyString(text?.zh) || !isNonEmptyString(text?.en)) {
+        gaps.push(`runtime.profile().terms.${key} 要给 zh / en 两份非空文案`);
+      }
+    }
+    if (!isNonEmptyString(profile?.installHint?.zh) || !isNonEmptyString(profile?.installHint?.en)) {
+      gaps.push('runtime.profile().installHint 要给 zh / en 两份非空文案');
+    }
+  }
+
+  if (typeof set.runtime.commandSurface === 'function') {
+    const surface = set.runtime.commandSurface(ctx);
+    if (surface !== undefined) {
+      if (!isNonEmptyString(surface.name)) gaps.push('runtime.commandSurface().name 不是非空字符串');
+      if (!isNonEmptyString(surface.pluginPrefix)) {
+        gaps.push('runtime.commandSurface().pluginPrefix 不是非空字符串');
+      }
+      if (typeof surface.invoke !== 'function') gaps.push('runtime.commandSurface().invoke 不是函数');
+      else if (!isNonEmptyString(surface.invoke('site', 'command'))) {
+        gaps.push('runtime.commandSurface().invoke(site, command) 拼不出非空命令行');
+      }
+      if (typeof surface.help !== 'function') gaps.push('runtime.commandSurface().help 不是函数');
+      else if (!isNonEmptyString(surface.help('site'))) {
+        gaps.push('runtime.commandSurface().help(site) 拼不出非空提示');
+      }
+    }
+  }
+
+  const health = set.runtime.health(ctx);
+  const commands = set.runtime.commands(ctx);
+  for (const [name, status] of Object.entries(health)) {
+    if (!isNonEmptyString(status?.command)) gaps.push(`health['${name}'].command 不是非空字符串`);
+    if (!['env', 'isolated', 'path'].includes(status?.source)) gaps.push(`health['${name}'].source 不是已知来源`);
+  }
+  for (const name of Object.keys(commands)) {
+    if (health[name] === undefined) gaps.push(`commands 里的 ${name} 在 health 里没有对应条目`);
+    else if (!isNonEmptyString(commands[name])) gaps.push(`commands['${name}'] 不是非空字符串`);
+  }
+
+  for (const method of DATA_METHODS) {
+    if (typeof set.data[method] !== 'function') gaps.push(`data.${method} 不是函数`);
+  }
+
+  if (!isNonEmptyString(set.modules.isolatedRoot())) gaps.push('modules.isolatedRoot() 不是非空字符串');
+  if (set.modules.runtimeInstallCommand !== undefined && !isNonEmptyString(set.modules.runtimeInstallCommand())) {
+    gaps.push('modules.runtimeInstallCommand() 给了但不是非空字符串');
+  }
+  for (const [name, method] of CLI_DIR_METHODS) {
+    const given = set.modules[method];
+    if (given !== undefined && !isNonEmptyString(given())) gaps.push(`modules.${method}() 给了但不是非空字符串（${name}）`);
+  }
+  if (typeof set.probe.probeUnits !== 'function') gaps.push('probe.probeUnits 不是函数');
+  if (typeof set.probe.registerPreflight !== 'function') gaps.push('probe.registerPreflight 不是函数');
+
+  return gaps;
+}

package/src/host/adapter-set.ts

@@ -61,10 +61,9 @@ const CORE_METHODS = [
 const FULL_MEMBERS = ['modules', 'runtime', 'plugins', 'actions'] as const;
 
 const FULL_METHODS = [
+  ['modules', 'isolatedRoot'],
   ['modules', 'isolatedHome'],
-  ['modules', 'cliCatalogPath'],
-  ['modules', 'vendorPluginsDir'],
-  ['modules', 'opencliInstallCommand'],
+  ['modules', 'afterLibInstall'],
   ['modules', 'profileDirOf'],
   ['modules', 'profileModules'],
   ['modules', 'readInstalledModule'],
@@ -81,7 +80,10 @@ const FULL_METHODS = [
   ['modules', 'isNewerVersion'],
   ['modules', 'startSelfUpdate'],
   ['runtime', 'packageRoot'],
-  ['runtime', 'opencliCommand'],
+  ['runtime', 'capabilities'],
+  ['runtime', 'commands'],
+  ['runtime', 'runners'],
+  ['runtime', 'health'],
   ['runtime', 'seed'],
   ['runtime', 'warnUnwritableRoot'],
   ['plugins', 'declarationLookup'],

package/src/host/adapter-types.ts

@@ -77,7 +77,7 @@ export interface SelfUpdateStart {
   readonly forward: string;
 }
 
-export interface OpencliResolution {
+export interface RuntimeStatus {
   readonly command: string;
   readonly source: 'env' | 'isolated' | 'path';
   readonly isolated: string | null;