@dsh-workbench/core 0.3.0 → 0.3.1

package/dist/types/app/client.d.ts

@@ -181,6 +181,7 @@ export declare const kit: {
         STORAGE_KEY_PROJECT: "dsh-workbench.project";
         STORAGE_KEY_RIGHTBAR: "dsh-workbench.rightbar.expanded";
         STORAGE_KEY_RIGHTBAR_COLUMN: "dsh-workbench.rightbar.column";
+        STORAGE_KEY_RIGHTBAR_WIDTH: "dsh-workbench.rightbar.width";
         RIGHTBAR_FULLSCREEN_WIDTH: 768;
         LOCALE_NS: "workbench";
         LOCALES: readonly ["zh", "en"];
@@ -1216,6 +1217,7 @@ export declare const kit: {
         STORAGE_KEY_PROJECT: "dsh-workbench.project";
         STORAGE_KEY_RIGHTBAR: "dsh-workbench.rightbar.expanded";
         STORAGE_KEY_RIGHTBAR_COLUMN: "dsh-workbench.rightbar.column";
+        STORAGE_KEY_RIGHTBAR_WIDTH: "dsh-workbench.rightbar.width";
         RIGHTBAR_FULLSCREEN_WIDTH: 768;
         LOCALE_NS: "workbench";
         LOCALES: readonly ["zh", "en"];
@@ -2246,6 +2248,7 @@ export declare const kit: {
         STORAGE_KEY_PROJECT: "dsh-workbench.project";
         STORAGE_KEY_RIGHTBAR: "dsh-workbench.rightbar.expanded";
         STORAGE_KEY_RIGHTBAR_COLUMN: "dsh-workbench.rightbar.column";
+        STORAGE_KEY_RIGHTBAR_WIDTH: "dsh-workbench.rightbar.width";
         RIGHTBAR_FULLSCREEN_WIDTH: 768;
         LOCALE_NS: "workbench";
         LOCALES: readonly ["zh", "en"];

package/dist/types/app/layouts/rightbar/BoardGrid.d.ts

@@ -0,0 +1,23 @@
+import type { BoardModule, BoardModuleProps, ModuleSummary, PanelStep, SuiteWorld, Translate } from '@dsh-workbench/shared';
+import type { BoardPlan } from './board-plan';
+export declare function workspacePathOf(world: SuiteWorld): string;
+export declare function ModuleHost({ module, step, panelToken, onPanelRefresh, onSummary, ...rest }: {
+    module: BoardModule;
+    step?: string;
+    panelToken: number;
+    onPanelRefresh: () => void;
+} & Omit<BoardModuleProps, 'refreshToken' | 'onRefresh' | 'onSummary'> & {
+    onSummary: (id: string, summary: ModuleSummary) => void;
+}): JSX.Element;
+export declare function BoardGrid({ entries, panelWidth, world, panelToken, onPanelRefresh, onNavigate, onOpenMarket, onSummary, onCardFailure, t, }: {
+    entries: BoardPlan['modules'];
+    panelWidth: number;
+    world: SuiteWorld;
+    panelToken: number;
+    onPanelRefresh: () => void;
+    onNavigate: (step: PanelStep) => void;
+    onOpenMarket: () => void;
+    onSummary: (id: string, summary: ModuleSummary) => void;
+    onCardFailure: (unit: string, reason: string) => void;
+    t: Translate;
+}): JSX.Element | null;

package/dist/types/app/layouts/rightbar/board-columns.d.ts

@@ -2,7 +2,20 @@ export declare const BOARD_COLUMN_MIN_WIDTH = 332;
 export declare const BOARD_COLUMN_GAP = 12;
 export declare const BOARD_PANEL_PADDING = 12;
 export declare const BOARD_COLUMNS_AT: number;
-export declare function boardFitsTwoColumns(panelWidth: number): boolean;
-export type BoardColumns<T> = readonly [readonly T[], readonly T[]];
-export declare function splitBoardColumns<T>(items: readonly T[]): BoardColumns<T>;
-export declare function boardColumnsOf<T>(items: readonly T[], twoColumns: boolean): readonly (readonly T[])[];
+export declare const BOARD_SPLIT_SEARCH_LIMIT = 100000;
+export declare const BOARD_SPLIT_MIN_GAIN = 32;
+export declare const BOARD_SPLIT_QUIET_MS = 600;
+export declare const BOARD_SPLIT_DEADLINE_MS = 3000;
+export declare function boardColumnCount(panelWidth: number, itemCount: number): number;
+export declare function roundRobinIndexes(count: number, columns: number): readonly number[];
+export declare function roundRobinColumns<T>(items: readonly T[], columns: number): readonly (readonly T[])[];
+export declare function boardImproves(current: readonly number[], candidate: readonly number[], heights: readonly number[], columns: number): boolean;
+export declare function boardColumnIndexes(heights: readonly number[], columns: number): readonly number[];
+export declare function boardAssignment(heights: readonly number[], columns: number): readonly number[];
+export declare function boardColumnsByHeight<T>(items: readonly T[], heights: readonly number[], columns: number): readonly (readonly T[])[];
+export interface BoardSlot {
+    readonly index: number;
+    readonly breakBefore: boolean;
+    readonly trailing: boolean;
+}
+export declare function boardLayout(assignment: readonly number[], columns: number): readonly BoardSlot[];

package/dist/types/app/layouts/rightbar/rightbar-width.d.ts

@@ -0,0 +1,16 @@
+import type { DshLayoutPanels } from '@dsh-workbench/shared';
+import { writeText } from '@dsh-workbench/shared';
+export declare const RIGHTBAR_DEFAULT_WIDTH = 420;
+export declare const RIGHTBAR_WIDTH_MAX = 4000;
+export declare function parseRightbarWidth(raw: string | null): number | null;
+export declare function readRightbarWidth(): number | null;
+export declare function writeRightbarWidth(px: number, write?: typeof writeText): void;
+export interface RightbarWidthMemory {
+    seed(px: number): void;
+    dispose(): void;
+}
+export declare function createRightbarWidthMemory(panels: DshLayoutPanels | undefined, write?: (px: number) => void): RightbarWidthMemory;
+export declare function ensureRightbarWidthMemory(panels: DshLayoutPanels | undefined, write?: (px: number) => void): RightbarWidthMemory;
+export declare function releaseRightbarWidthMemory(panels: DshLayoutPanels | undefined): void;
+export declare function restoreRightbarWidth(panels: DshLayoutPanels | undefined, remembered?: number | null): void;
+export declare function seedRightbarWidth(panels: DshLayoutPanels | undefined, remembered?: number | null): void;

package/dist/types/app/layouts/rightbar/rightbar-width.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/app/layouts/rightbar/use-board-split.d.ts

@@ -0,0 +1,8 @@
+import { type BoardSlot } from './board-columns';
+export interface BoardSplit {
+    readonly root: {
+        current: HTMLDivElement | null;
+    };
+    readonly slots: readonly BoardSlot[] | null;
+}
+export declare function useBoardSplit(keys: readonly string[], columns: number): BoardSplit;

package/dist/types/modules/panels/model/diy-report.d.ts

@@ -1,5 +1,14 @@
 import type { PanelUnitReport } from '@dsh-workbench/shared';
-import type { WorkshopModule } from '../../../shared/api/host/diy-workshop';
+import { type WorkshopModule, type WorkshopSync, type WorkshopToolchain } from '../../../shared/api/host/diy-workshop';
+export declare const SYNC_STALE_MINUTES = 15;
+export declare const SYNC_STALE_MS: number;
+export declare function syncNotice(input: {
+    readonly sync: WorkshopSync | undefined;
+    readonly shellVersion: string | undefined;
+    readonly toolchain: WorkshopToolchain | undefined;
+    readonly now?: number;
+    readonly windowMs?: number;
+}): string | undefined;
 export interface SuiteHealth {
     readonly state: 'ok' | 'failed' | 'absent';
     readonly reason?: string;
@@ -59,5 +68,7 @@ export declare function statusOf(options: {
     readonly open: boolean;
     readonly health: SuiteHealth;
 }): ModuleStatus;
-export declare function renderStatus(packagesDir: string, lines: readonly ModuleStatus[]): string;
+export declare function renderStatus(packagesDir: string, lines: readonly ModuleStatus[], options?: {
+    readonly shellVersion?: string;
+}): string;
 export declare function renderList(packagesDir: string, modules: readonly WorkshopModule[]): string;

package/dist/types/shared/api/host/diy-workshop.d.ts

@@ -10,3 +10,16 @@ export declare function workshopPackagesDir(ctx: DshHostContext): string | null;
 export declare function insideWorkshop(root: string, target: string): boolean;
 export declare function workshopModules(packagesDir: string, installed?: readonly string[]): readonly WorkshopModule[];
 export declare function inWorkshopSession(ctx: DshHostContext, workspace: string | null): boolean;
+export interface WorkshopSync {
+    readonly state: 'ok' | 'syncing' | 'failed';
+    readonly version: string;
+    readonly at: string;
+    readonly reason?: string;
+}
+export declare function workshopSyncOf(workshopRoot: string): WorkshopSync | undefined;
+export interface WorkshopToolchain {
+    readonly core: string;
+    readonly moduleTools: string;
+    readonly shared: string;
+}
+export declare function workshopToolchainOf(workshopRoot: string): WorkshopToolchain | undefined;

package/dist/types/shared/api/host/runtime-seed.d.ts

@@ -1,6 +1,5 @@
 import { spawn } from 'node:child_process';
 import type { DshHostContext } from '@dsh-workbench/shared';
-export declare const WORKSHOP_SKILLS_DIR = "workbench-module-diy";
 export type SeedLog = (message: string) => void;
 export interface RuntimeSeedPaths {
     readonly root: string;
@@ -12,7 +11,6 @@ export interface RuntimeSeedPaths {
     readonly workshop: string;
     readonly workshopPackages: string;
     readonly workshopManifest: string;
-    readonly skillsLink: string;
 }
 export interface RuntimeSeedOptions {
     readonly root: string;

package/docs/HANDOFF.md

@@ -37,7 +37,11 @@
 DIY 工坊骨架、可写根）由**外壳自己**补齐 —— 不用跑 `setup`，也不用起第二个实例。
 
 差别（先跟对方说清）：**会话 / 存储不分家**（接着用他原来那份）、**没有独立端口与进程**、
-**改外壳源码不热重载**、DIY 工坊依赖是首次启动在后台装的。
+**改外壳源码不热重载**、DIY 工坊依赖是首次启动在后台装的。工坊的工具链（那三个
+`@dsh-workbench/*`）此后**每次启动**都会与**正在跑的那份外壳**比一次（基准经 `DSH_WB_SHELL_ROOT`
+显式传入 —— 宿主给加载中那份、启动器给 profile 里那份），不同代就在后台增量同步到同代 ——
+升级外壳不用手动删工坊，**下一次启动**就对上了；同步不上时 `workbench_diy_status` 会说清
+（差在哪、为什么、怎么修），日志在 `$DSH_HOME/workbench/seed.log`。
 
 ## 三、B：两步装（独立 profile，占 :3081）
 
@@ -99,6 +103,12 @@ Settings → 插件里把 `@dsh-workbench/core` 关掉后，工作台会**退化
    就一个字节不写）。为什么单列这一步：`dsh plugin add` 装完的登记**跳过已存在的依赖**，
    所以重跑 setup（包已在清单里）时它不会补 bundle —— 那一档是静默的（起得来、侧边栏
    没入口），现在启动器拿"选中"当硬门禁，这一步就是它给的修复命令。
+6. `scripts/seed-workshop.sh`（`seed-profile.sh:155-160` 调它）—— 建 / 补齐 **DIY 工坊**：
+   骨架缺才建、依赖缺才装、写 `dsh-wb-module` 入口。**这一步不做代际对齐**：代际比对的基准是
+   "正在跑的那份外壳"（`DSH_WB_SHELL_ROOT`），而 `setup` 这趟 profile 里那份还没装 / 还是旧的，
+   所以它**不设基准、这一轮不比对**。**重跑 `setup` 只建骨架 / 装依赖；工坊工具链对上正在跑的那一代
+   发生在下一次启动**（启动器按 profile 里那份、宿主按加载中那份，同一个基准）—— 与 README 的
+   "升级要重启一次"一致，不必手动删工坊。
 
 **设置不在这一步继承**（这里以前快照 web 的 patch、并继承被它点名的依赖）：新机器上
 `setup` 完的工作台**没有模型供应商**，第一次打开去 设置 → 「配置同步」拉一次即可 ——

package/docs/OPERATIONS.md

@@ -49,6 +49,8 @@
 
 差别：**会话 / 存储不隔离**（接着用你原来那份）、**没有独立端口与进程**、
 **改外壳源码不热重载**、DIY 工坊依赖是首次启动在后台装的（几百 MB，失败只落日志）。
+此后**每次启动**都会比对工坊里那三个 `@dsh-workbench/*` 与**正在跑的那份外壳**的版本，不同代就在后台**增量同步**
+（见下面「工坊工具链怎么跟着外壳走」）。
 
 撤销：Plugins 页卸载 `@dsh-workbench/core`（配置与数据不清）；`~/.dsh/workbench/**` 想清就手删。
 
@@ -158,6 +160,47 @@ WORKBENCH_PORT=3091 pnpm run dev   # 换端口（监听与实例同一个端口
 现在的脚本追加前会先把那行单独的 `[]` 让位（`selfcheck` 有判据钉着）。如果你手上那份 profile 是旧脚本建出来的，
 手工把 `cordis.patch.yml` 里**单独一行**的 `[]` 删掉再起即可（其余内容不用动）。
 
+### 工坊工具链怎么跟着外壳走
+
+工坊（`$DSH_HOME/workbench/diy`）里那三个 `@dsh-workbench/*` 必须与**当前跑着的外壳**同代 ——
+不同代就是"指引是新的、判据与模板是旧的"，报错会指着你的声明而不是指着版本。
+
+- **判据**：工坊 `node_modules/@dsh-workbench/{core,module-tools,shared}/package.json` 里**实装**的
+  `version`，与**基准版本**（见下条）**全等**。不看 `package.json` 里写的范围，也不信 `pnpm` 的退出码 ——
+  装完会按盘上那份复核实装版本，只有真的同代才写 `ok`。
+- **基准 = 正在跑的那份外壳**，由调用者经 `DSH_WB_SHELL_ROOT` 显式传进来：
+  宿主自举给**加载中的那份**（`packageRootOf(import.meta.url)`），启动器给 **profile 里那份**
+  `node_modules/@dsh-workbench/core`（只在它真能读出 `package.json` 时才给）。**谁都没传 → 这一轮不比对**
+  （不读工坊实装版本、不起同步、不写 `.sync.json`、不动工坊一个字节）。
+  ⚠️ **跑脚本的那份副本不算基准**：安装态下启动器与宿主是**两份物理副本**，谁后跑谁说了算会来回漂
+  —— 现在启动器那份落后**不会再**把工坊往回拽（实测那一次：启动器 0.3.0 / profile 0.3.1 / 工坊已跟到
+  0.3.1，旧口径把工坊降级成 0.3.0，见 [ADR-0056](../../../docs/adr/0056-workshop-toolchain-follows-the-shell.md) 补记）。
+- **触发**：每次启动都会比一次（`bin/dsh-workbench` 与宿主自举走的那条 `entry`）。
+  无参那一趟（建骨架 / 重跑 `setup`）**只有带基准时才比** —— 启动器兜底建骨架时带，`setup` 那趟
+  **不设基准 → 空转**。所以**重跑 `setup` 不做代际对齐**，对齐发生在**下一次启动**工作台时
+  （与 README 的"升级要重启一次"一致）。比对是**便宜**的：只读四份 `package.json` 的版本。
+- **不一致 → 后台自愈**：起一个 `nohup` 的 `seed-workshop.sh sync`，把工坊根的 `devDependency`
+  范围与 `pnpm.overrides` 都对齐到基准那一代，再增量 `pnpm install`，跑完复核实装版本。
+  启动路径不等它。
+- **状态文件**：`$DSH_HOME/workbench/diy/.sync.json`（`state` / `version` / `at` / `reason`），四种态：
+  - `ok`：复核过、同代。⚠️ **`ok` 可能是旧版本的记录** —— 判据**永远是实装版本**，
+    `.sync.json` 只用于退避与说人话，别拿它当"装好了"的证据；
+  - `syncing`：正在后台同步；超过 15 分钟还停在这，`workbench_diy_status` 会说
+    「⚠️ 工坊工具链上一次同步没走完（这条停在 <at>，超过 15 分钟了）」；
+  - `failed`：**这一轮没修好**（原因在 `reason` 里），`workbench_diy_status` 会直说
+    「⚠️ 工坊工具链还是上一代（…；外壳已经是 <版本>）：<原因>」并把修法一起给出来；
+  - 文件不在：还没有同步记录（首次 / 天然同代）；**实装版本与外壳同代时不出声**，不同代时显示
+    「⏳ 工坊工具链还是上一代（工坊里 <包> <版本>，外壳 <版本>）—— 下一轮工作台启动时会对齐到 <版本>；一直这样就看 `$DSH_HOME/workbench/seed.log`」。
+- **去哪看**：日志在 `$DSH_HOME/workbench/seed.log`（每次同步都写：比对的实装版本、开始自愈、
+  `pnpm install` 的原话、复核结果）；状态也可以直接问 agent：`workbench_diy_status`。
+- **失败了怎么修**：先照状态里那条命令来 —— `cd "$DSH_HOME/workbench/diy" && pnpm install`；
+  还是不行就把工坊目录删掉再重启一次工作台（骨架会自己重建；`packages/` 下你造的模块先留着或另存）。
+  两句常见原因：PATH 上没有 `pnpm`（装好后 `cd <工坊> && pnpm install`）、
+  工坊根 `package.json` 被手改坏了（修回一份合法 JSON）。
+- **离线 / 装不动**：就停在旧一代，但**看得见**（`failed` + `reason` + 修法）。同一个外壳版本上失败过，
+  一小时内不再重试（`SYNC_BACKOFF_SECONDS=3600`）；外壳换了一代就是新问题，会重新试。
+  自愈锁的过期判据是 15 分钟（`SYNC_LOCK_STALE_MINUTES=15`，持锁者崩了不会被永久锁死）。
+
 ## 排障
 
 | 症状 | 原因 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/core",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "个人工作台：Agent 工作台外壳（左栏 + 常驻对话 + 自研右侧数据面板）。",
   "type": "module",
   "icon": "./icon.svg",
@@ -87,7 +87,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@dsh-workbench/shared": "0.3.0"
+    "@dsh-workbench/shared": "0.3.1"
   },
   "scripts": {
     "build": "node scripts/build.mjs && node scripts/build-types.mjs",