@dsh-workbench/shared 0.3.11 → 1.0.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-workbench contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,97 @@
+# @dsh-workbench/shared
+
+工作台与模块共用的**契约与纯代码**：类型、纯函数、哑组件、i18n、宿主侧工具。
+它不持有状态、不依赖外壳运行时、不产生全局副作用 —— 所以外壳和每个模块都可以各自打一份，
+不会打架。
+
+对模块作者来说，这里是「不用自己重画」的那一层：卡片壳、行、表单、链接、加载态都在
+`components/`，契约类型都在 `api/`。**dsh 有的原语走 kit，工作台自己的视觉用这里的组件**，
+两者拼出面板，不要从 DOM + CSS 重写一遍。
+
+## 三个入口
+
+| 入口 | 谁用 | 有什么 |
+|---|---|---|
+| `@dsh-workbench/shared` | 浏览器侧 | 契约类型、纯函数、哑组件（样式随组件）、i18n、读通道 `apiGet` / `factOfRoute` |
+| `@dsh-workbench/shared/host` | 宿主侧（Node） | 数据根、opencli 运行时、git、http、面板状态、单元声明、请求配方 composer、公共通道插件计划等，**有 `node:*`** |
+| `@dsh-workbench/shared/testing` | 测试 | 宿主侧假件、从 `package.json` 读模块声明 |
+
+两条硬边界：
+
+- **根入口是浏览器安全的**：不许出现 `node:*`。宿主侧取运行值只走 `/host`。
+- **模块源码对根入口只许 `import type`**：取运行值会在浏览器里打进第二份实例，也会让
+  `dist/host.js` 在 Node 里 import 不进来。这条由 module-tools 的 `source` 判据盯着。
+
+组件样式与组件同目录（`X.css` / `X.module.css`），构建时原样搬到 `dist/` —— 消费方不用另配
+CSS 处理。
+
+## 收录判据
+
+进这个包的东西要同时满足三条，缺一条就留在外壳里：
+
+1. **无模块级可变状态**：顶层 `let` / `var`、被写入的顶层 `Map` / `Set` 都不行。共享包会被每个
+   消费者各打一份，带状态就是各说各话。`scripts/check-state.mjs` 守这一条。
+2. **不依赖外壳运行时**：不 import 外壳的代码、不假设自己在哪一列里渲染。
+3. **不产生全局副作用**：import 即注册、改全局、读环境都不行；要环境就从参数或 `/host` 进。
+
+判断不了就问一句：**这份东西被复制成两份，会有什么坏结果？** 答案不是「没有」就别放进来。
+
+## 目录
+
+| 落点 | 是什么 |
+|---|---|
+| `src/api/` | 契约：单元清单、卡片面、读通道、写通道、长任务、审批、面板状态 |
+| `src/components/` | 哑组件：`Card` / `CardHead` / `Rows` / `Form` / `FormRow(s)` / `FormActions` / `Link` / `Stack` / 各态块 |
+| `src/config/` | 常量与存储键 |
+| `src/i18n/` | zh / en 字典、合并与设置 |
+| `src/lib/` | 纯函数：文本、忙碌态、表单问题、看板事实 |
+| `src/host/` | 宿主侧内核与领域：http、facts、面板状态、workspace、单元声明 |
+| `src/testing/` | 测试假件与声明读取 |
+
+`src/index.ts` 与 `src/host.ts` 是**生成的 barrel**：新增文件后跑 `pnpm run barrels`，别手抄。
+它会拦重名导出（`export *` 会静默丢掉其中一个）。
+
+## 怎么用
+
+```ts
+// 外壳
+import { Card, Rows, type UnitManifest } from '@dsh-workbench/shared';
+import { workbenchRoot } from '@dsh-workbench/shared/host';
+
+// 模块
+import type { UnitClientFace } from '@dsh-workbench/shared';
+import { kit } from '@dsh-workbench/core/client';
+```
+
+规矩按调用方分：
+
+- **外壳自己**从根入口取运行值（组件、`apiGet`…），它是这份代码的主人。
+- **模块**的组件从 kit 取：`import { kit } from '@dsh-workbench/core/client'`，根入口只许
+  `import type`。宿主侧要运行值走 `/host`，浏览器侧要纯函数走 kit —— 两侧都不该从根入口取，
+  否则浏览器会打进第二份实例、宿主侧会让 `dist/host.js` 在 Node 里 import 不进来。
+- 模块里只取类型时写成单独一行 `import type { … }`，别和运行值混在一条语句里 ——
+  `source` 判据按语句判「是不是只取类型」。
+
+组件是**哑的**：props 进、界面出，不取数、不读宿主、不自己决定什么时候刷新。取数在外壳的
+hooks 或模块自己的 `model/` 里，所以同一张卡片在真数据和夹具下长得一样。
+
+## 开发
+
+```bash
+pnpm --filter @dsh-workbench/shared run build      # tsc + 搬 CSS
+pnpm --filter @dsh-workbench/shared run test
+pnpm --filter @dsh-workbench/shared run selfcheck  # check-state：无模块级可变状态
+```
+
+两个 barrel 用 `pnpm run barrels` 重生成；`pnpm run arch` 跑这个包自己的分层配置。
+代码零注释，只有公开成员的导出 JSDoc 例外（它会进 `.d.ts`，是给消费方看的）。
+
+## 相关文档
+
+| 想了解 | 读 |
+|---|---|
+| 层序、两个运行时、槽位、数据通路 | [ARCHITECTURE.md](../../ARCHITECTURE.md) |
+| 组件怎么选、kit 里有什么 | [KIT.md](../core/skills/workbench-module-diy/KIT.md) |
+| 模块的构建与门禁 | [module-tools](../module-tools/README.md) |
+| 最小模块样本 | [module-hello](../module-hello/README.md) |
+| 环境与提交 | [CONTRIBUTING.md](../../CONTRIBUTING.md) |

package/dist/api/blocker-table.d.ts

@@ -1,7 +1,7 @@
-import type { Translate } from './dsh-client.js';
-import type { CapabilityPayload } from './workbench-contract.js';
+import type { Translate } from '../lib/dsh-client.js';
+import type { CapabilityPayload } from '../contract/workbench-contract.js';
 import type { ApiError } from './workbench-client.js';
-import type { ModuleBlocker } from './blocker.js';
+import type { ModuleBlocker } from '../contract/blocker.js';
 /**
  * 把一次读失败翻成一张卡住态，交给卡片直接渲染。
  * @param error 读口回的错误；undefined 表示连错误都没拿到（多半是网络断，回「原因未知」）。

package/dist/api/blocker-table.js

@@ -98,20 +98,23 @@ export function blockerOfError(error, t, context = {}) {
 export function blockerOfCapability(capability, t) {
     if (capability.status === 'ok')
         return undefined;
-    const fixAction = capability.fix === undefined
+    const problem = capability.needs.find((need) => need.status !== 'ok');
+    const fix = problem?.provision === 'ready' ? 'install' : undefined;
+    const fixAction = fix === undefined
         ? undefined
         : {
             kind: 'run-fix',
-            label: capability.fix === 'install' ? t('blocker.fix.install') : t('blocker.fix.update'),
+            label: t('blocker.fix.install'),
             unit: capability.unit,
-            fix: capability.fix,
+            fix,
         };
-    const sourceUnknown = capability.fix === undefined && capability.install !== undefined && capability.install !== 'ready';
+    const sourceUnknown = problem?.provision !== undefined && problem.provision !== 'ready';
     const install = [
         ...(fixAction === undefined ? [] : [fixAction]),
         ...(sourceUnknown ? [{ kind: 'open-market', label: t('blocker.market.open'), unit: capability.unit }] : []),
-        ...(capability.command === undefined || sourceUnknown ? [] : [copyAction(t, capability.command)]),
+        ...(problem?.command === undefined || sourceUnknown ? [] : [copyAction(t, problem.command)]),
     ];
+    const detail = problem?.detail ?? capability.detail;
     if (capability.status === 'failed') {
         return {
             id: 'unit-mount-failed',
@@ -122,32 +125,53 @@ export function blockerOfCapability(capability, t) {
             actions: [retryAction(t)],
         };
     }
-    if (capability.status === 'missing-plugin') {
+    if (capability.status === 'unsupported') {
         return {
-            id: 'unit-missing-plugin',
+            id: 'unit-unsupported',
             severity: 'block',
-            title: t('env.unit.missingPlugin'),
-            hint: t('env.unit.hint'),
-            ...(capability.detail === undefined ? {} : { detail: capability.detail }),
-            actions: [...install, retryAction(t)],
+            title: t('env.unit.unsupported'),
+            hint: t('env.unit.unsupportedHint'),
+            ...(detail === undefined ? {} : { detail }),
+            actions: [retryAction(t)],
         };
     }
-    if (capability.status === 'missing-commands') {
+    if (capability.status === 'degraded') {
         return {
-            id: 'unit-missing-commands',
-            severity: 'block',
-            title: t('env.unit.missingCommands'),
-            hint: t('env.unit.missingCommandsHint'),
+            id: 'unit-degraded',
+            severity: 'notice',
+            title: t('env.unit.degraded'),
+            hint: t('env.unit.degradedHint'),
+            ...(detail === undefined ? {} : { detail }),
+            actions: [retryAction(t)],
+        };
+    }
+    if (problem === undefined) {
+        return {
+            id: 'unit-unchecked',
+            severity: 'notice',
+            title: t('env.unit.unchecked'),
+            hint: t('env.unit.uncheckedHint'),
             ...(capability.detail === undefined ? {} : { detail: capability.detail }),
-            actions: [...install, retryAction(t)],
+            actions: [retryAction(t)],
+        };
+    }
+    if (problem.status === 'unchecked') {
+        return {
+            id: 'unit-unchecked',
+            severity: 'notice',
+            title: t('env.unit.unchecked'),
+            hint: t('env.unit.uncheckedHint'),
+            ...(detail === undefined ? {} : { detail }),
+            actions: [retryAction(t)],
         };
     }
+    const kindTitle = `env.need.${problem.kind}.${problem.status}`;
     return {
-        id: 'unit-unchecked',
-        severity: 'notice',
-        title: t('env.unit.unchecked'),
-        hint: t('env.unit.uncheckedHint'),
-        ...(capability.detail === undefined ? {} : { detail: capability.detail }),
-        actions: [retryAction(t)],
+        id: `unit-need-${problem.kind}-${problem.status}`,
+        severity: 'block',
+        title: t(kindTitle),
+        hint: t(`env.need.${problem.kind}.hint`),
+        ...(detail === undefined ? {} : { detail }),
+        actions: [...install, retryAction(t)],
     };
 }

package/dist/api/dsh.d.ts

@@ -115,7 +115,7 @@ export interface DshHostContext {
             messages?: readonly unknown[];
         }>): (() => void) | undefined;
     };
-    get<T = unknown>(name: string): T | undefined;
+    get<T = unknown>(name: string, strict?: boolean): T | undefined;
     provide(name: string, value: unknown): () => void;
     effect(effect: () => void | (() => void), label?: string): () => void;
     inject(names: readonly string[], effect: (scoped: DshHostContext) => void): () => void;

package/dist/api/workbench-client.js

@@ -14,7 +14,8 @@ export async function apiGet(route, query = {}, options = {}) {
             search.set(key, String(value));
     }
     const suffix = search.toString();
-    const response = await fetch(`${API_PREFIX}/${route}${suffix ? `?${suffix}` : ''}`, {
+    const target = suffix === '' ? `${API_PREFIX}/${route}` : `${API_PREFIX}/${route}?${suffix}`;
+    const response = await fetch(target, {
         method: 'GET',
         headers: { accept: 'application/json' },
         ...(signal === undefined ? {} : { signal }),

package/dist/components/Activity.css

@@ -1,4 +1,3 @@
-
 .wb-activityBlock {
   display: flex;
   flex-direction: column;

package/dist/components/ApprovalDetail.css

@@ -1,4 +1,3 @@
-
 .wb-approvalCommand {
   max-width: 100%;
-}
+}

package/dist/components/ApprovalDetail.d.ts

@@ -1,4 +1,4 @@
-import type { Translate } from '../api/dsh-client.js';
+import type { Translate } from '../lib/dsh-client.js';
 import type { ApprovalInput, UnitClientFace } from '../components/board-module.js';
 import { type ReactNode } from '../lib/react.js';
 import './ApprovalDetail.css';

package/dist/components/ApprovalPlan.css

@@ -1,4 +1,3 @@
-
 .wb-approvalPlan {
   display: flex;
   flex-direction: column;

package/dist/components/Card.css

@@ -1,4 +1,3 @@
-
 .wb-card {
   border: 0.5px solid var(--dsw-alias-border-l3);
   border-radius: var(--dsw-radius-xl);

package/dist/components/Card.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from '../lib/react.js';
-import type { Translate } from '../api/dsh-client.js';
+import type { Translate } from '../lib/dsh-client.js';
 import './Card.css';
 /**
  * `Card` 的契约：标题、刷新、卡片体，以及可整块替换的卡头。

package/dist/components/CardBoundary.d.ts

@@ -1,4 +1,4 @@
-import type { Translate } from '../api/dsh-client.js';
+import type { Translate } from '../lib/dsh-client.js';
 import type { ReactNode } from '../lib/react.js';
 import { Component } from '../lib/react.js';
 /**

package/dist/components/CardHead.css

@@ -1,4 +1,3 @@
-
 .wb-cardHead {
   display: flex;
   align-items: center;

package/dist/components/CardHead.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from '../lib/react.js';
-import type { Translate } from '../api/dsh-client.js';
+import type { Translate } from '../lib/dsh-client.js';
 import './CardHead.css';
 /**
  * `CardHead` 的契约：标题、补充、刷新，外加齿轮与平台跳转两格。

package/dist/components/ChoiceGroup.css

@@ -1,4 +1,3 @@
-
 .wb-choiceMenu {
   display: flex;
   flex-direction: column;
@@ -180,4 +179,4 @@
 .wb-radio:focus-visible {
   outline: var(--dsw-focus-ring-width, var(--wb-len-2)) solid var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary));
   outline-offset: 2px;
-}
+}

package/dist/components/ConfirmBar.d.ts

@@ -23,7 +23,7 @@ export interface ConfirmBarProps {
 }
 /**
  * 「先问一句再动手」那一条：标题 + 说明 + 键值 + 失败那句 + 动作区，形状一次收口。
- * **要不要问**归调用点（ADR-0054 §2 规则三），这一件只回答"问的时候长什么样"。
+ * **要不要问**归调用点，这一件只回答"问的时候长什么样"。
  * @param props.title - 那一句问话（"发布到 prod？"）。
  * @param props.hint - 标题下面那句说明或正文；不给不占位。
  * @param props.rows - 键值两格（键值列宽与分隔线归 `Rows` / `Row`）；不给或空数组不渲染。值那一格可以放控件。

package/dist/components/ConfirmBar.js

@@ -5,7 +5,7 @@ import { Row, Rows } from './Rows.js';
 import './ConfirmBar.css';
 /**
  * 「先问一句再动手」那一条：标题 + 说明 + 键值 + 失败那句 + 动作区，形状一次收口。
- * **要不要问**归调用点（ADR-0054 §2 规则三），这一件只回答"问的时候长什么样"。
+ * **要不要问**归调用点，这一件只回答"问的时候长什么样"。
  * @param props.title - 那一句问话（"发布到 prod？"）。
  * @param props.hint - 标题下面那句说明或正文；不给不占位。
  * @param props.rows - 键值两格（键值列宽与分隔线归 `Rows` / `Row`）；不给或空数组不渲染。值那一格可以放控件。

package/dist/components/Form.css

@@ -3,4 +3,4 @@
   flex-direction: column;
   gap: var(--wb-len-12);
   width: 100%;
-}
+}

package/dist/components/FormActions.js

@@ -17,7 +17,7 @@ function reportExtraPrimaries(actions) {
     if (keys.length < 2)
         return;
     console.error(`[dsh-workbench] FormActions 一个区里出现了 ${keys.length} 颗 primary（${keys.join('、')}）—— ` +
-        '一个区只许一颗主操作（ADR-0054 §2 规则二）：多余的这颗该改成 default');
+        '一个区只许一颗主操作：多余的这颗该改成 default');
 }
 function variantOf(kind) {
     if (kind === 'primary')

package/dist/components/FormNodes.js

@@ -144,14 +144,18 @@ export function formRowsOf(args) {
     return args.fields.map((field) => h(FormRow, {
         key: field.key,
         label: field.label,
+        htmlFor: controlIdOf(field.key),
         hint: field.hint,
         problem: args.showProblem ? args.problems[field.key] : undefined,
         layout: field.layout,
     }, controlOf(field, args.problems, args.showProblem, args.busy)));
 }
+function controlIdOf(key) {
+    return `wb-form-${key}`;
+}
 function controlOf(field, problems, showProblem, busy) {
     return field.control({
-        id: `wb-form-${field.key}`,
+        id: controlIdOf(field.key),
         name: field.key,
         invalid: showProblem && Boolean(problems[field.key]),
         disabled: busy || field.disabled === true,

package/dist/components/FormRows.css

@@ -29,6 +29,7 @@
 }
 
 .wb-formLabel {
+  justify-self: start;
   min-width: 0;
   font-size: var(--dsw-font-xs-13-font-size);
   color: var(--dsw-alias-label-secondary);

package/dist/components/FormRows.d.ts

@@ -17,6 +17,7 @@ export declare function FormRows({ children }: FormRowsProps): JSX.Element;
  */
 export interface FormRowProps {
     readonly label: ReactNode;
+    readonly htmlFor?: string | undefined;
     readonly hint?: ReactNode | undefined;
     readonly problem?: ReactNode | undefined;
     readonly layout?: 'inline' | 'stacked' | undefined;
@@ -25,10 +26,11 @@ export interface FormRowProps {
 /**
  * 表单一行：左边标签、右边控件，提示与错误占控件下面那一格。
  * @param props.label - 这一行的标签；进了这一行，控件自己就别再给 `label`，否则会多一个标签。
+ * @param props.htmlFor - 标签挂到哪个控件（同一个 `id`）；不给就只是排布，点标签不聚焦 —— `Form` 会自己接好。
  * @param props.hint - 控件下的说明；给了 `problem` 就不画它 —— 同一格不叠两段话。
  * @param props.problem - 校验失败那句话；给了就顶掉 `hint` 并给整行加上出错标记。
  * @param props.layout - `stacked` 才是标签在上、控件在下（默认 `inline`：标签在左）。
  * @param props.children - 控件本体。
- * @returns 一个 `<label>`。
+ * @returns 一个 `<div>`：里面的 `<label>` 只包标签文字，不包控件、提示与整行的空白。
  */
-export declare function FormRow({ label, hint, problem, layout, children }: FormRowProps): JSX.Element;
+export declare function FormRow({ label, htmlFor, hint, problem, layout, children }: FormRowProps): JSX.Element;

package/dist/components/FormRows.js

@@ -11,15 +11,16 @@ export function FormRows({ children }) {
 /**
  * 表单一行：左边标签、右边控件，提示与错误占控件下面那一格。
  * @param props.label - 这一行的标签；进了这一行，控件自己就别再给 `label`，否则会多一个标签。
+ * @param props.htmlFor - 标签挂到哪个控件（同一个 `id`）；不给就只是排布，点标签不聚焦 —— `Form` 会自己接好。
  * @param props.hint - 控件下的说明；给了 `problem` 就不画它 —— 同一格不叠两段话。
  * @param props.problem - 校验失败那句话；给了就顶掉 `hint` 并给整行加上出错标记。
  * @param props.layout - `stacked` 才是标签在上、控件在下（默认 `inline`：标签在左）。
  * @param props.children - 控件本体。
- * @returns 一个 `<label>`。
+ * @returns 一个 `<div>`：里面的 `<label>` 只包标签文字，不包控件、提示与整行的空白。
  */
-export function FormRow({ label, hint, problem, layout = 'inline', children }) {
-    return (h("label", { className: "wb-formRow", "data-layout": layout, "data-wb-problem": problem === undefined ? undefined : '' },
-        h("span", { className: "wb-formLabel" }, label),
+export function FormRow({ label, htmlFor, hint, problem, layout = 'inline', children }) {
+    return (h("div", { className: "wb-formRow", "data-layout": layout, "data-wb-problem": problem === undefined ? undefined : '' },
+        h("label", { className: "wb-formLabel", htmlFor: htmlFor }, label),
         h("span", { className: "wb-formControl" }, children),
         problem === undefined ? (hint === undefined ? null : (h("span", { className: "wb-formHint" }, hint))) : (h("span", { className: "wb-formProblem" }, problem))));
 }

package/dist/components/LongTaskRow.css

@@ -1,4 +1,3 @@
-
 .wb-longTask {
   padding-top: var(--wb-len-12);
   border-top: 0.5px solid var(--dsw-alias-border-l2);
@@ -97,4 +96,4 @@
   line-height: var(--wb-line-16);
   color: var(--dsw-alias-state-error-primary);
   overflow-wrap: anywhere;
-}
+}

package/dist/components/LongTaskRow.d.ts

@@ -1,4 +1,4 @@
-import { type LongTaskStatus } from '../api/long-task.js';
+import { type LongTaskStatus } from '../contract/long-task.js';
 import './LongTaskRow.css';
 /**
  * 长任务行尾的一个链接：地址与文字。

package/dist/components/LongTaskRow.js

@@ -1,4 +1,4 @@
-import { longTaskDot, longTaskStopPress, longTaskStopStage, LONG_TASK_STOP_ARM_MS } from '../api/long-task.js';
+import { longTaskDot, longTaskStopPress, longTaskStopStage, LONG_TASK_STOP_ARM_MS } from '../contract/long-task.js';
 import { Link } from './Link.js';
 import { Fragment, h, useEffect, useState } from '../lib/react.js';
 import { CodeBlock, DisclosureRow, IconCodeOutlineRegular, IconFlatListOutlineRegular, IconStopFillRegular, StateDot, } from '@deepseek-ai/dsh-client-ui-primitives';

package/dist/components/Note.css

@@ -1,4 +1,3 @@
-
 .wb-note {
   margin: 0;
   font-size: var(--dsw-font-xxs-12-font-size);

package/dist/components/ResourceStates.css

@@ -1,4 +1,3 @@
-
 .wb-centered.wb-centeredCompact {
   flex: none;
   min-height: 0;

package/dist/components/SettingsSection.css

@@ -1,4 +1,3 @@
-
 section.wb-settings {
   display: flex;
   flex-direction: column;

package/dist/components/Spinner.css

@@ -1,4 +1,3 @@
-
 .wb-spinner {
   display: inline-flex;
   align-items: center;

package/dist/components/Stack.css

@@ -1,4 +1,3 @@
-
 .wb-stack {
   display: flex;
   flex-direction: column;

package/dist/components/StateBlock.css

@@ -1,4 +1,3 @@
-
 .wb-stateBlock {
   display: flex;
   flex-direction: column;

package/dist/components/board-module.d.ts

@@ -1,7 +1,7 @@
 import type { ReactNode } from 'react';
-import type { SessionsSnapshot, Translate, WorkspaceSnapshot, WorkspaceView } from '../api/dsh-client.js';
-import type { UnitManifest } from '../api/unit.js';
-import type { CapabilityPayload } from '../api/workbench-contract.js';
+import type { SessionsSnapshot, Translate, WorkspaceSnapshot, WorkspaceView } from '../lib/dsh-client.js';
+import type { UnitManifest } from '../contract/unit.js';
+import type { CapabilityPayload } from '../contract/workbench-contract.js';
 import type { Dictionaries } from '../i18n/index.js';
 /**
  * 面板要跳去的一格：只用 `kind` 说去哪，具体负载由各 unit 自己约定。

package/dist/components/icons.d.ts

@@ -11,7 +11,7 @@ export interface IconProps {
  */
 export declare function IconConversation({ size }: IconProps): JSX.Element;
 /**
- * 品牌标：侧栏顶上那枚工作台方块标；默认 24px（它是品牌物，别拿它当通用图标）。
+ * 品牌标：一台显示器里放着 dsh 的鲸鱼尾巴；默认 24px（它是品牌物，别拿它当通用图标）。
  * @param props.size - 边长像素，同时给 `width` 与 `height`。
  * @returns 一枚 `aria-hidden` 的 svg。
  */

package/dist/components/icons.js

@@ -11,15 +11,22 @@ export function IconConversation({ size = 16 }) {
     return (h(Shell, { size: size, strokeWidth: 1.3 },
         h("path", { d: "M2.5 7.2c0-2.3 2.1-4.2 4.8-4.2h1.4c2.7 0 4.8 1.9 4.8 4.2s-2.1 4.2-4.8 4.2H7.5l-3.2 2v-2.3c-1.1-.8-1.8-2-1.8-3.9Z", stroke: "currentColor", strokeLinejoin: "round" })));
 }
+const BRAND_FRAME = 'M10 6H54A5 5 0 0 1 59 11V43A5 5 0 0 1 54 48H10A5 5 0 0 1 5 43V11A5 5 0 0 1 10 6Z M12 10H52A3 3 0 0 1 55 13V41A3 3 0 0 1 52 44H12A3 3 0 0 1 9 41V13A3 3 0 0 1 12 10Z';
+const BRAND_TAIL = 'M8.844 13.742C8.967 12.328 8.45 10.4 8.45 9.65C8.45 8.94 8.88 8.43 9.6 8.43C11.285 8.43 12.106 8.281 12.685 8.104C13.71 7.791 14.585 6.768 15.055 5.945C15.137 5.803 14.99 5.641 14.829 5.671C13.829 5.86 12.828 5.376 11.827 4.978C10.659 4.514 9.491 4.707 8.935 4.876C8.805 4.915 8.658 4.819 8.636 4.686C8.468 3.643 7.405 2.615 5.498 2.238C4.54 2.048 3.748 1.574 3.347 1.202C3.252 1.113 3.088 1.125 3.03 1.242C2.628 2.059 2.168 3.82 5.248 6.115C5.82 6.494 6.31 6.785 6.574 7.637C6.72 8.104 6.157 9.168 6.061 9.368C5.157 11.27 5.089 12.19 4.926 13.742Z';
+const BRAND_TAIL_TRANSFORM = 'translate(14.6263 10.5853) scale(1.95)';
 /**
- * 品牌标：侧栏顶上那枚工作台方块标；默认 24px（它是品牌物，别拿它当通用图标）。
+ * 品牌标：一台显示器里放着 dsh 的鲸鱼尾巴；默认 24px（它是品牌物，别拿它当通用图标）。
  * @param props.size - 边长像素，同时给 `width` 与 `height`。
  * @returns 一枚 `aria-hidden` 的 svg。
  */
 export function IconBrandMark({ size = 24 }) {
-    return (h(Shell, { size: size, strokeWidth: 1.6, viewBox: "0 0 24 24" },
-        h("rect", { x: 3, y: 3, width: 18, height: 18, rx: 5, stroke: "currentColor" }),
-        h("path", { d: "M8 9.5h8M8 12.5h8M8 15.5h5", stroke: "currentColor", strokeLinecap: "round" })));
+    return (h(Shell, { size: size, viewBox: "0 0 64 64" },
+        h("path", { d: BRAND_FRAME, fill: "currentColor", fillRule: "evenodd" }),
+        h("rect", { x: 27.5, y: 48, width: 9, height: 4.75, fill: "currentColor" }),
+        h("rect", { x: 19, y: 52.75, width: 26, height: 4.75, rx: 2.375, fill: "currentColor" }),
+        h("g", { transform: BRAND_TAIL_TRANSFORM },
+            h("path", { d: BRAND_TAIL, fill: "currentColor" }),
+            h("circle", { cx: 6.885, cy: 13.742, r: 1.95, fill: "currentColor" }))));
 }
 /**
  * opencli 的标：包类型那一格用它；颜色写死的品牌物，不跟主题走。默认 16px。

package/dist/config/constants.d.ts

@@ -1,7 +1,5 @@
 /** 外壳插件的包名：浏览器模块表与宿主按它注册、认领这枚插件。 */
 export declare const PLUGIN_ID = "@dsh-workbench/core";
-/** 与外壳同批发布的兄弟包名：`release.ts` 用它判一版三包是否都已在源上。 */
-export declare const RELEASE_SIBLINGS: readonly ["@dsh-workbench/shared", "@dsh-workbench/module-tools"];
 /** 外壳宿主 HTTP API 的根前缀；prefs / actions / provision 等路由都挂在它下面。 */
 export declare const API_PREFIX = "/workbench/api";
 /** 模块偏好读写的路由前缀，挂在外壳 API 下：走写通道，拒写回 write-refused。 */
@@ -26,8 +24,8 @@ export declare const DIY_RECORD_ACT_PATH = "diy-record/act";
 export declare const PANEL_STATE_PREFIX = "/workbench/api/panel-state";
 /** 钉住的 opencli 插件版本：`opencli-runtime` 按它校验、取那一份。 */
 export declare const OPENCLI_PIN = "1.8.8";
-/** 缺陷看板套件的 dsh 服务名（`workbenchCodingIssues`）：套件照它登记自己那份服务。 */
-export declare const CODING_ISSUES_SERVICE = "workbenchCodingIssues";
+/** 缺陷看板套件的 dsh 服务名（`workbenchIssues`）：套件照它登记自己那份服务。 */
+export declare const ISSUES_SERVICE = "workbenchIssues";
 /** 面板套件的 dsh 服务名（`workbenchPanels`）：宿主经它取套件公布的清单与订阅。 */
 export declare const PANELS_SERVICE = "workbenchPanels";
 /** 单元花名册服务的 dsh 服务名（`workbenchUnits`）：模块经它认领自己的单元。 */

package/dist/config/constants.js

@@ -1,10 +1,5 @@
 /** 外壳插件的包名：浏览器模块表与宿主按它注册、认领这枚插件。 */
 export const PLUGIN_ID = "@dsh-workbench/core";
-/** 与外壳同批发布的兄弟包名：`release.ts` 用它判一版三包是否都已在源上。 */
-export const RELEASE_SIBLINGS = [
-    "@dsh-workbench/shared",
-    "@dsh-workbench/module-tools",
-];
 /** 外壳宿主 HTTP API 的根前缀；prefs / actions / provision 等路由都挂在它下面。 */
 export const API_PREFIX = "/workbench/api";
 /** 模块偏好读写的路由前缀，挂在外壳 API 下：走写通道，拒写回 write-refused。 */
@@ -29,8 +24,8 @@ export const DIY_RECORD_ACT_PATH = `${DIY_RECORD_PATH}/act`;
 export const PANEL_STATE_PREFIX = `${API_PREFIX}/${PANEL_STATE_PATH}`;
 /** 钉住的 opencli 插件版本：`opencli-runtime` 按它校验、取那一份。 */
 export const OPENCLI_PIN = "1.8.8";
-/** 缺陷看板套件的 dsh 服务名（`workbenchCodingIssues`）：套件照它登记自己那份服务。 */
-export const CODING_ISSUES_SERVICE = "workbenchCodingIssues";
+/** 缺陷看板套件的 dsh 服务名（`workbenchIssues`）：套件照它登记自己那份服务。 */
+export const ISSUES_SERVICE = "workbenchIssues";
 /** 面板套件的 dsh 服务名（`workbenchPanels`）：宿主经它取套件公布的清单与订阅。 */
 export const PANELS_SERVICE = "workbenchPanels";
 /** 单元花名册服务的 dsh 服务名（`workbenchUnits`）：模块经它认领自己的单元。 */

package/dist/contract/adapters.d.ts

@@ -0,0 +1,10 @@
+export interface BrowserPort {
+    read(input: unknown): Promise<unknown>;
+    find(input: unknown): Promise<unknown>;
+}
+export interface PreflightPort {
+    run(options?: {
+        readonly hard?: boolean;
+    }): Promise<unknown>;
+    snapshot(): unknown;
+}

package/dist/contract/cli.d.ts

@@ -0,0 +1,3 @@
+export interface CliPort {
+    readonly command: string;
+}