@dsh-workbench/shared 1.1.7 → 1.1.9

package/src/components/SelectField.tsx

@@ -56,7 +56,6 @@ export interface SelectFieldProps {
   readonly selection?: 'check' | 'fill' | undefined;
   readonly variant?: 'ghost' | 'boxed' | undefined;
   readonly iconOnly?: boolean | undefined;
-  readonly revealId?: string | undefined;
   readonly ariaLabel?: string | undefined;
   readonly title?: string | undefined;
   readonly id?: string | undefined;
@@ -76,41 +75,15 @@ function triggerClassOf(variantClass: string | undefined, iconOnly: boolean): st
   return mergeClass('wb-selectTrigger', variantClass, iconOnly ? 'wb-selectIconOnly' : undefined);
 }
 
-function itemOf(option: SelectFieldOption, revealId: string | undefined): MenuItem {
-  const mark = option.value === revealId;
-  if (!mark) {
-    return {
-      id: option.value,
-      label: option.label,
-      ...(option.icon === undefined ? {} : { icon: option.icon }),
-      ...(option.disabled === true ? { disabled: true } : {}),
-    };
-  }
-  const revealed = (node: ReactNode): ReactNode => (
-    <span className="wb-selectReveal" data-wb-select-reveal="">
-      {node}
-    </span>
-  );
+function itemOf(option: SelectFieldOption): MenuItem {
   return {
     id: option.value,
-    label: option.icon === undefined ? revealed(option.label) : option.label,
-    ...(option.icon === undefined ? {} : { icon: revealed(option.icon) }),
+    label: option.label,
+    ...(option.icon === undefined ? {} : { icon: option.icon }),
     ...(option.disabled === true ? { disabled: true } : {}),
   };
 }
 
-function revealNode(): HTMLElement | null {
-  const found = document.querySelector('[data-wb-select-reveal]');
-  return found instanceof HTMLElement ? found : null;
-}
-
-function useRevealOnOpen(open: boolean, revealId: string | undefined): void {
-  useEffect(() => {
-    if (!open || revealId === undefined) return;
-    revealNode()?.scrollIntoView({ block: 'nearest' });
-  }, [open, revealId]);
-}
-
 function selectValueNode(
   current: SelectFieldOption | undefined,
   renderValue: SelectFieldProps['renderValue'],
@@ -251,11 +224,10 @@ export function stepSelectCursor(
   return (cursor + step + shown.length) % shown.length;
 }
 
-/** 把候选排成 `Menu` 要的条目表：按 `group` 插分组标题；一项都没有时退回 `emptyText` 那一行（不给就是空表）。`revealId` 是开列表时要滚进可视区的那个 value。 */
+/** 把候选排成 `Menu` 要的条目表：按 `group` 插分组标题；一项都没有时退回 `emptyText` 那一行（不给就是空表）。 */
 export function selectEntries(
   shown: readonly SelectFieldOption[],
   emptyText: string | undefined,
-  revealId?: string | undefined,
 ): readonly MenuEntry[] {
   if (shown.length === 0) {
     return emptyText === undefined ? [] : [{ type: 'label', id: EMPTY_ID, text: emptyText }];
@@ -267,7 +239,7 @@ export function selectEntries(
       out.push({ type: 'label', id: `__wb-select-group-${String(out.length)}`, text: option.group });
       group = option.group;
     }
-    out.push(itemOf(option, revealId));
+    out.push(itemOf(option));
   }
   return out;
 }
@@ -372,7 +344,6 @@ export function SelectField(props: SelectFieldProps) {
     selection = 'fill',
     variant = 'boxed',
     iconOnly = false,
-    revealId,
     ariaLabel,
     title,
     id,
@@ -383,7 +354,6 @@ export function SelectField(props: SelectFieldProps) {
   const state = useSelectState(props);
   const current = options.find((option) => option.value === value);
 
-  useRevealOnOpen(state.open, revealId);
   const variantClass = variant === 'ghost' ? 'wb-selectGhost' : undefined;
   const triggerClass = triggerClassOf(variantClass, iconOnly);
 
@@ -425,6 +395,7 @@ export function SelectField(props: SelectFieldProps) {
     value: selectValueNode(current, renderValue, placeholder),
     iconOnly,
     onOpen: () => state.setOpen(true),
+    ref: state.triggerRef,
   });
 
   const anchor =
@@ -470,7 +441,7 @@ export function SelectField(props: SelectFieldProps) {
       anchor,
       selection,
       selectedId: selectCursorValue(state.shown, state.cursor) ?? undefined,
-      items: selectEntries(state.shown, state.empty, revealId),
+      items: selectEntries(state.shown, state.empty),
       footer:
         footer === undefined
           ? undefined

package/src/components/SelectFieldNodes.tsx

@@ -1,4 +1,4 @@
-import type { ReactNode } from 'react';
+import type { ReactNode, Ref } from 'react';
 import { Fragment, h } from '../lib/react.js';
 import {
   IconChevronDownOutlineRegular,
@@ -19,6 +19,7 @@ import { Spinner } from './Spinner.js';
  * @param args.value - 已渲染好的当前值节点（文本或占位）。
  * @param args.iconOnly - 只画图标（窄栏那颗切换钮），值与箭头都不画。
  * @param args.onOpen - 点它做什么，通常是把列表打开。
+ * @param args.ref - 挂到这颗 `<button>` 上，取消后回焦点、菜单开着头条滚轮要用它。
  * @returns 一颗 `<button>`。
  */
 export function selectTriggerNode(args: {
@@ -33,10 +34,12 @@ export function selectTriggerNode(args: {
   readonly value: ReactNode;
   readonly iconOnly: boolean;
   readonly onOpen: () => void;
+  readonly ref: Ref<HTMLButtonElement> | undefined;
 }): ReactNode {
   return (
     <button
       type="button"
+      ref={args.ref}
       id={args.id}
       className={args.className}
       disabled={args.disabled}

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

@@ -1,10 +1,10 @@
 import { describe, expect, it, vi } from 'vitest';
 
-vi.mock('../lib/react.js', () => ({
+vi.mock('../../lib/react.js', () => ({
   h: (type: unknown, props: unknown, ...children: unknown[]) => ({ type, props, children }),
 }));
 
-import { Card, type CardProps } from './Card.js';
+import { Card, type CardProps } from '../Card.js';
 
 const t = (key: string): string => key;
 

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

@@ -1,12 +1,12 @@
 import { describe, expect, it, vi } from 'vitest';
 
-vi.mock('../lib/react.js', () => ({
+vi.mock('../../lib/react.js', () => ({
   h: (type: unknown, props: unknown, ...children: unknown[]) => ({ type, props, children }),
 }));
 
-vi.mock('./CardAnchor.module.css', () => ({ default: { anchor: 'wb-anchor' } }));
+vi.mock('../CardAnchor.module.css', () => ({ default: { anchor: 'wb-anchor' } }));
 
-import { CardAnchor, cardIdOf } from './CardAnchor.js';
+import { CardAnchor, cardIdOf } from '../CardAnchor.js';
 
 interface AnyElement {
   readonly type: unknown;

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

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { CardHead } from './CardHead.js';
+import { CardHead } from '../CardHead.js';
 
 interface AnyElement {
   readonly type: unknown;

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

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'vitest';
-import { Fragment, h } from '../lib/react.js';
-import { ChoiceGroup } from './ChoiceGroup.js';
+import { Fragment, h } from '../../lib/react.js';
+import { ChoiceGroup } from '../ChoiceGroup.js';
 
 interface AnyElement {
   readonly type: unknown;

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

@@ -1,9 +1,9 @@
 import { readFileSync } from 'node:fs';
 import { describe, expect, it } from 'vitest';
-import { ConfirmBar, type ConfirmRow } from './ConfirmBar.js';
-import { FormActions, type FormAction } from './FormActions.js';
-import { Note } from './Note.js';
-import { Rows } from './Rows.js';
+import { ConfirmBar, type ConfirmRow } from '../ConfirmBar.js';
+import { FormActions, type FormAction } from '../FormActions.js';
+import { Note } from '../Note.js';
+import { Rows } from '../Rows.js';
 
 interface AnyElement {
   readonly type: unknown;
@@ -84,7 +84,7 @@ describe('确认条（契约类 wb-confirmBar）', () => {
   });
 });
 
-const CSS = readFileSync(new URL('./ConfirmBar.css', import.meta.url), 'utf8');
+const CSS = readFileSync(new URL('../ConfirmBar.css', import.meta.url), 'utf8');
 
 function declarations(selector: string): string[] {
   for (const block of CSS.split('}')) {

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

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { Field } from './Field.js';
+import { Field } from '../Field.js';
 
 function texts(node: unknown): string[] {
   if (node === null || node === undefined || typeof node === 'boolean') return [];

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

@@ -1,6 +1,6 @@
 import { readFileSync } from 'node:fs';
 import { describe, expect, it } from 'vitest';
-import type { FormField, FormValue } from './FormTypes.js';
+import type { FormField, FormValue } from '../FormTypes.js';
 import {
   duplicateKeysOf,
   formActionsOf,
@@ -11,9 +11,9 @@ import {
   formValuesOf,
   reportDuplicateKeys,
   visibleFieldsOf,
-} from './FormNodes.js';
-import { FormRow } from './FormRows.js';
-import type { FormAction } from './FormActions.js';
+} from '../FormNodes.js';
+import { FormRow } from '../FormRows.js';
+import type { FormAction } from '../FormActions.js';
 
 function field(key: string, value: FormValue, validate?: FormField['validate']): FormField {
   return {
@@ -444,7 +444,7 @@ describe('formRowsOf', () => {
   });
 });
 
-const CSS = readFileSync(new URL('./Form.css', import.meta.url), 'utf8');
+const CSS = readFileSync(new URL('../Form.css', import.meta.url), 'utf8');
 
 function declarations(selector: string): string[] {
   for (const block of CSS.split('}')) {

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

@@ -1,7 +1,7 @@
 import { readFileSync } from 'node:fs';
 import { describe, expect, it, vi } from 'vitest';
-import { FormActions, type FormAction, type FormActionKind } from './FormActions.js';
-import { SaveBar } from './SaveBar.js';
+import { FormActions, type FormAction, type FormActionKind } from '../FormActions.js';
+import { SaveBar } from '../SaveBar.js';
 
 function action(key: string, kind?: FormActionKind): FormAction {
   return { key, label: key, ...(kind === undefined ? {} : { kind }), onClick: () => {} };
@@ -90,7 +90,7 @@ describe('FormActions', () => {
   });
 });
 
-const CSS = readFileSync(new URL('./FormActions.css', import.meta.url), 'utf8');
+const CSS = readFileSync(new URL('../FormActions.css', import.meta.url), 'utf8');
 
 function declarations(selector: string): string[] {
   for (const block of CSS.split('}')) {

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

@@ -1,6 +1,6 @@
 import { readFileSync } from 'node:fs';
 import { describe, expect, it } from 'vitest';
-import { FormRow, FormRows } from './FormRows.js';
+import { FormRow, FormRows } from '../FormRows.js';
 
 function texts(node: unknown): string[] {
   if (node === null || node === undefined || typeof node === 'boolean') return [];
@@ -111,7 +111,7 @@ describe('FormRow', () => {
   });
 });
 
-const FORM_CSS = readFileSync(new URL('./FormRows.css', import.meta.url), 'utf8');
+const FORM_CSS = readFileSync(new URL('../FormRows.css', import.meta.url), 'utf8');
 
 function normalize(selector: string): string {
   return selector

package/src/components/{FormTypes.test.ts → __tests__/FormTypes.test.ts}

@@ -1,5 +1,5 @@
 import { describe, expect, expectTypeOf, it } from 'vitest';
-import type { FormFieldOf, FormProps } from './FormTypes.js';
+import type { FormFieldOf, FormProps } from '../FormTypes.js';
 
 type Draft = { readonly env: string; readonly branch?: string };
 

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

@@ -1,6 +1,6 @@
 import { describe, expect, it, vi } from 'vitest';
-import type { FormField, FormProps, FormValue } from './FormTypes.js';
-import { Form } from './Form.js';
+import type { FormField, FormProps, FormValue } from '../FormTypes.js';
+import { Form } from '../Form.js';
 
 function field(key: string, value: FormValue, validate?: FormField['validate']): FormField {
   return {
@@ -13,8 +13,8 @@ function field(key: string, value: FormValue, validate?: FormField['validate']):
   };
 }
 
-vi.mock('../lib/react.js', async () => {
-  const actual = await vi.importActual<Record<string, unknown>>('../lib/react.js');
+vi.mock('../../lib/react.js', async () => {
+  const actual = await vi.importActual<Record<string, unknown>>('../../lib/react.js');
   return {
     ...actual,
     useState: (initial: unknown) => [typeof initial === 'function' ? (initial as () => unknown)() : initial, () => {}],

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

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { Link } from './Link.js';
+import { Link } from '../Link.js';
 
 interface AnyElement {
   readonly type: unknown;

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

@@ -1,6 +1,6 @@
 import { readFileSync } from 'node:fs';
 import { describe, expect, it } from 'vitest';
-import { Row, Rows } from './Rows.js';
+import { Row, Rows } from '../Rows.js';
 
 function texts(node: unknown): string[] {
   if (node === null || node === undefined || typeof node === 'boolean') return [];
@@ -35,7 +35,7 @@ describe('Row', () => {
   });
 });
 
-const ROWS_CSS = readFileSync(new URL('./Rows.css', import.meta.url), 'utf8');
+const ROWS_CSS = readFileSync(new URL('../Rows.css', import.meta.url), 'utf8');
 const FLEX_CONTAINER = `.wb-rows {
   display: flex;
   flex-direction: column;

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/market-index.ts

@@ -263,6 +263,7 @@ export interface PublishPreview {
   readonly name: string;
   readonly version: string;
   readonly author?: string;
+  readonly labels?: readonly string[];
   readonly registry?: string;
   readonly market?: MarketPublishDestination;
   readonly claim?: MarketClaim;

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;
 }
 
 /**