@dsh-workbench/core 0.2.14 → 0.2.16

package/dist/types/modules/panels/model/diy-debug-routes.test.d.ts

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

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

@@ -0,0 +1,8 @@
+import type { DshHostContext, DshToolRegistry } from '@dsh-workbench/shared';
+import type { DebugRefusal, DebugState, DebugStore } from '@dsh-workbench/shared/host';
+export declare function debugRefusalText(code: DebugRefusal, held?: DebugState): string;
+export declare function renderDebugStart(state: DebugState): string;
+export declare function renderDebugPause(state: DebugState): string;
+export declare function renderDebugResume(state: DebugState): string;
+export declare function renderDebugStop(state: DebugState): string;
+export declare function registerDebugTools(ctx: DshHostContext, tools: DshToolRegistry, store: DebugStore): readonly (() => void)[];

package/dist/types/modules/panels/model/diy-debug-tools.test.d.ts

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

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

@@ -1,4 +1,5 @@
 import type { DshHostContext, DshToolRegistry } from '@dsh-workbench/shared';
+import { type BoardState } from './diy-page';
 import { type Shot } from './diy-browser';
 import { type CardView, type PickRequest, type SlotFacts } from './diy-scripts';
 export declare function registerLookTools(ctx: DshHostContext, tools: DshToolRegistry): readonly (() => void)[];
@@ -11,4 +12,4 @@ export declare function slotLineOf(view: CardView): string;
 export declare function outlineText(view: CardView): string;
 export declare function contrastLineOf(view: CardView): string;
 export declare function renderLook(unit: string, view: CardView, shot: Shot, pick: PickRequest): string;
-export declare function renderMissingCard(unit: string, cards: number, anchored: boolean): string;
+export declare function renderMissingCard(unit: string, view: CardView, board: BoardState): string;

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

@@ -1,4 +1,8 @@
 import type { DshHostContext, DshShell, DshToolRunContext } from '@dsh-workbench/shared';
+import type { DebugState } from '@dsh-workbench/shared/host';
+import { type BoardFactState, type BoardProbe, type BoardSituation } from '@dsh-workbench/shared/host';
+import { type WorkbenchPage } from './diy-browser';
+export type BoardState = BoardFactState;
 export interface PageHandle {
     readonly packagesDir: string;
     readonly unit: string;
@@ -7,9 +11,19 @@ export interface PageHandle {
     readonly command: string;
     readonly session: string;
     readonly bound: boolean;
+    readonly board: BoardState;
+    readonly boardPath: string;
 }
 export interface PageOptions {
     readonly requireWorkbench?: boolean | undefined;
     readonly requireUnit?: boolean | undefined;
+    readonly requireBoard?: 'workshop' | false | undefined;
+    readonly requirePact?: boolean | undefined;
 }
+export declare function debugPausedText(held: DebugState): string;
+export declare function debugForeignPactText(held: DebugState): string;
+export declare function debugOffBoardText(held: DebugState, situation?: BoardSituation): string;
+export declare function boardProbeOf(page: WorkbenchPage): BoardProbe;
+export declare function boardStateOf(page: WorkbenchPage, workshop: string | null): BoardState;
+export declare function boardGateText(situation: BoardSituation, unit: string, page: WorkbenchPage): string;
 export declare function pageAt(ctx: DshHostContext, exec: DshToolRunContext, raw: unknown, options?: PageOptions): Promise<PageHandle>;

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

@@ -1,4 +1,4 @@
-export declare const PAGE_PROBE = "(async () => {\n  const answer = await fetch('/workbench/api/health').then((one) => one.json()).catch(() => null);\n  return JSON.stringify({\n    plugin: answer === null ? null : answer.plugin,\n    pid: answer === null ? null : answer.pid,\n    url: location.href,\n    title: document.title,\n  });\n})()";
+export declare const PAGE_PROBE = "(async () => {\n  const answer = await fetch('/workbench/api/health').then((one) => one.json()).catch(() => null);\n  const root = document.querySelector('.wb-root');\n  const where = root === null ? '' : (root.getAttribute('data-wb-where') ?? '');\n  const bar = document.querySelector('.wb-rightbar');\n  const board = bar === null ? '' : (bar.getAttribute('data-wb-board') ?? '');\n  const open = bar === null ? null : bar.hasAttribute('data-wb-open');\n  const style = bar === null ? null : getComputedStyle(bar);\n  const box = bar === null ? null : bar.getBoundingClientRect();\n  const drawn =\n    bar !== null &&\n    style.visibility !== 'hidden' &&\n    style.display !== 'none' &&\n    box.width > 0 &&\n    box.height > 0;\n  return JSON.stringify({\n    plugin: answer === null ? null : answer.plugin,\n    pid: answer === null ? null : answer.pid,\n    url: location.href,\n    title: document.title,\n    where,\n    board,\n    open,\n    shown: drawn,\n  });\n})()";
 export declare function cardSelectorOf(unit: string): string;
 export type DomMode = 'none' | 'outline' | 'html';
 export interface PickRequest {
@@ -18,6 +18,7 @@ export declare function pickOf(raw: Record<string, unknown>): PickRequest;
 export interface CardView {
     readonly ok: boolean;
     readonly anchored: boolean;
+    readonly visible: boolean;
     readonly width: number;
     readonly height: number;
     readonly head: string;

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

@@ -1,4 +1,5 @@
 import type { DshHostContext } from '@dsh-workbench/shared';
+import type { DebugStore } from '@dsh-workbench/shared/host';
 import type { MarketService } from './market';
 import type { PanelsService } from './service';
-export declare function registerDiyTools(ctx: DshHostContext, market: MarketService, panels: PanelsService): Array<() => void>;
+export declare function registerDiyTools(ctx: DshHostContext, market: MarketService, panels: PanelsService, debug: DebugStore): Array<() => void>;

package/dist/types/modules/panels/model/handoff.d.ts

@@ -2,6 +2,7 @@ import type { UnitCall } from '@dsh-workbench/shared/host';
 import type { HandoffEntry } from '@dsh-workbench/shared/host';
 import type { UnitManifest } from '@dsh-workbench/shared/host';
 export declare const PANELS_FACT = "panels";
+export declare const DIY_DEBUG_FACT = "diy-debug";
 export declare function panelsHandoffEntry(target?: {
     readonly path?: string | undefined;
 }): HandoffEntry | undefined;

package/dist/types/modules/panels/unit.d.ts

@@ -37,9 +37,14 @@ export declare const DIY_NET_STOP_TOOL = "workbench_diy_net_stop";
 export declare const DIY_LOGS_WATCH_TOOL = "workbench_diy_logs_watch";
 export declare const DIY_LOGS_READ_TOOL = "workbench_diy_logs_read";
 export declare const DIY_LOGS_STOP_TOOL = "workbench_diy_logs_stop";
-export declare const ALL_TOOLS: readonly ["workbench_panels_list", "workbench_panels_show", "workbench_panels_hide", "workbench_panels_move", "workbench_panels_reset", "workbench_panels_follow", "workbench_modules_list", "workbench_modules_install", "workbench_modules_update", "workbench_modules_uninstall", "workbench_modules_install_bundle", "workbench_modules_update_dependency", "workbench_modules_update_plugin", "workbench_modules_uninstall_plugin", "workbench_modules_update_workbench", "workbench_diy_list", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_recon", "workbench_diy_probe", "workbench_diy_look", "workbench_diy_install", "workbench_diy_show", "workbench_diy_click", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_hover", "workbench_diy_select", "workbench_diy_scroll", "workbench_diy_reload", "workbench_diy_viewport", "workbench_diy_net_watch", "workbench_diy_net_read", "workbench_diy_net_stop", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop"];
+export declare const DIY_DEBUG_START_TOOL = "workbench_diy_debug_start";
+export declare const DIY_DEBUG_PAUSE_TOOL = "workbench_diy_debug_pause";
+export declare const DIY_DEBUG_RESUME_TOOL = "workbench_diy_debug_resume";
+export declare const DIY_DEBUG_STOP_TOOL = "workbench_diy_debug_stop";
+export declare const ALL_TOOLS: readonly ["workbench_panels_list", "workbench_panels_show", "workbench_panels_hide", "workbench_panels_move", "workbench_panels_reset", "workbench_panels_follow", "workbench_modules_list", "workbench_modules_install", "workbench_modules_update", "workbench_modules_uninstall", "workbench_modules_install_bundle", "workbench_modules_update_dependency", "workbench_modules_update_plugin", "workbench_modules_uninstall_plugin", "workbench_modules_update_workbench", "workbench_diy_list", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_recon", "workbench_diy_probe", "workbench_diy_look", "workbench_diy_install", "workbench_diy_show", "workbench_diy_click", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_hover", "workbench_diy_select", "workbench_diy_scroll", "workbench_diy_reload", "workbench_diy_viewport", "workbench_diy_net_watch", "workbench_diy_net_read", "workbench_diy_net_stop", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop", "workbench_diy_debug_start", "workbench_diy_debug_pause", "workbench_diy_debug_resume", "workbench_diy_debug_stop"];
 export type PanelsToolName = (typeof ALL_TOOLS)[number];
 export declare const READ_TOOLS: readonly ["workbench_panels_list", "workbench_modules_list", "workbench_diy_list", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_recon", "workbench_diy_probe", "workbench_diy_look", "workbench_diy_click", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_hover", "workbench_diy_select", "workbench_diy_scroll", "workbench_diy_reload", "workbench_diy_viewport", "workbench_diy_net_watch", "workbench_diy_net_read", "workbench_diy_net_stop", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop"];
-export declare const WRITE_TOOLS: readonly ["workbench_panels_show", "workbench_panels_hide", "workbench_panels_move", "workbench_panels_reset", "workbench_panels_follow", "workbench_modules_install", "workbench_modules_update", "workbench_modules_uninstall", "workbench_modules_install_bundle", "workbench_modules_update_dependency", "workbench_modules_update_plugin", "workbench_modules_uninstall_plugin", "workbench_modules_update_workbench", "workbench_diy_install", "workbench_diy_show"];
+export declare const WRITE_TOOLS: readonly ["workbench_panels_show", "workbench_panels_hide", "workbench_panels_move", "workbench_panels_reset", "workbench_panels_follow", "workbench_modules_install", "workbench_modules_update", "workbench_modules_uninstall", "workbench_modules_install_bundle", "workbench_modules_update_dependency", "workbench_modules_update_plugin", "workbench_modules_uninstall_plugin", "workbench_modules_update_workbench", "workbench_diy_install", "workbench_diy_show", "workbench_diy_debug_start", "workbench_diy_debug_pause", "workbench_diy_debug_resume", "workbench_diy_debug_stop"];
 export declare const DIY_TOOLS: readonly ["workbench_diy_list", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_recon", "workbench_diy_probe", "workbench_diy_look", "workbench_diy_install", "workbench_diy_show", "workbench_diy_click", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_hover", "workbench_diy_select", "workbench_diy_scroll", "workbench_diy_reload", "workbench_diy_viewport", "workbench_diy_net_watch", "workbench_diy_net_read", "workbench_diy_net_stop", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop"];
+export declare const DIY_DEBUG_TOOLS: readonly ["workbench_diy_debug_start", "workbench_diy_debug_pause", "workbench_diy_debug_resume", "workbench_diy_debug_stop"];
 export declare const panelsUnit: UnitManifest;

package/dist/types/modules/sessions/index.d.ts

@@ -1,3 +1,3 @@
 export { currentSessionId, orderByRecency, sessionNode, orderSessionRows, sessionRows, workspaceOfSession, sessionStatuses, visiblePendingKind, type SessionNode, type SessionStatusDot, } from './model/session-node';
 export { scrollEdgesOf, type ScrollEdges } from './model/scroll-edges';
-export { attentionLabel, attentionOf, attentionOfSession, attentionWordLabel, type Attention, type AttentionInput, type AttentionSeverity, type WorkspaceAttention, } from './model/attention';
+export { attentionLabel, attentionOf, attentionOfSession, attentionSessionIdOf, attentionWordLabel, type Attention, type AttentionInput, type AttentionSeverity, type WorkspaceAttention, } from './model/attention';

package/dist/types/modules/sessions/model/attention.d.ts

@@ -17,6 +17,13 @@ export interface AttentionInput {
     readonly currentWorkspaceId: string | null;
 }
 export declare function attentionOfSession(summary: SessionSummary, statusById: SessionStatusSnapshot, sessions: SessionsSnapshot): AttentionSeverity | undefined;
+export interface AttentionPickInput {
+    readonly workspace: WorkspaceView | null;
+    readonly sessions: SessionsSnapshot;
+    readonly statusById: SessionStatusSnapshot;
+    readonly archivedIds: ReadonlySet<string>;
+}
+export declare function attentionSessionIdOf(input: AttentionPickInput): string | null;
 export declare function attentionOf(input: AttentionInput): Attention;
 export declare function attentionLabel(attention: WorkspaceAttention, t: Translate): string;
 export declare function attentionWordLabel(attention: WorkspaceAttention, t: Translate): string;

package/dist/types/shared/__tests__/host-import-barrel.test.d.ts

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

package/dist/types/shared/api/host/__tests__/diy-debug-act.test.d.ts

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

package/dist/types/shared/api/host/__tests__/host-args.test.d.ts

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

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

@@ -0,0 +1,31 @@
+import type { DebugIntent, DebugState, DebugStore, PostResource } from '@dsh-workbench/shared/host';
+export declare const DEBUG_NOTICE_KIND = "workbench-diy";
+export interface NoticeAgent {
+    readonly status: string;
+    inject(message: unknown): void;
+    followup(message: unknown): void;
+}
+export interface AgentsLookup {
+    get(id: string): NoticeAgent | undefined;
+}
+export declare function debugNoticeText(intent: DebugIntent, state: DebugState): string;
+export declare function debugNoticeSummary(intent: DebugIntent, state: DebugState): string;
+export declare function debugNotice(intent: DebugIntent, state: DebugState): {
+    message: unknown;
+    summary: string;
+};
+export type NoticeMode = 'wake' | 'hold' | 'drop';
+export type NoticeDelivery = 'followup' | 'inject' | 'held' | 'none' | 'skipped-idle';
+export declare function holdNotice(sessionId: string, message: unknown): void;
+export declare function takeHeldNotices(sessionId: string): unknown[];
+export declare function deliverDebugNotice(agents: AgentsLookup | undefined, sessionId: string, message: unknown, mode?: NoticeMode): NoticeDelivery;
+export interface DebugActDeps {
+    readonly store: () => DebugStore | undefined;
+    readonly agents: () => AgentsLookup | undefined;
+    readonly now?: (() => number) | undefined;
+    readonly notice?: ((intent: DebugIntent, state: DebugState) => {
+        message: unknown;
+        summary: string;
+    }) | undefined;
+}
+export declare function debugActResource(deps: DebugActDeps): PostResource;

package/dist/types/shared/api/host/host-args.d.ts

@@ -0,0 +1,3 @@
+import type { DshHostContext } from '@dsh-workbench/shared';
+export declare function asArgs(value: unknown): Readonly<Record<string, unknown>>;
+export declare function warn(ctx: DshHostContext, message: string): void;

package/dist/types/shared/hooks/use-api-resource.d.ts

@@ -15,4 +15,5 @@ export declare function useApiResource<T>(route: string, query: Query, refreshTo
     enabled?: boolean;
     key?: string;
     fact?: string;
+    report?: boolean;
 }): ResourceState<T>;

package/dist/types/shared/hooks/use-diy-debug.d.ts

@@ -0,0 +1,8 @@
+import type { DebugState } from '@dsh-workbench/shared';
+import type { HostWrite } from './use-host-write';
+export declare const DIY_DEBUG_ROUTE = "panels/diy-debug";
+export declare const DIY_DEBUG_FACT = "diy-debug";
+export declare function useDiyDebugState(): DebugState | null;
+export declare function useDiyDebugAct(): HostWrite<{
+    text?: string;
+}>;

package/package.json

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

package/skills/workbench-module-diy/KIT.md

@@ -86,6 +86,20 @@ h(Field, { label: t('myunit.mode'), hint: t('myunit.modeHint') },
 **`SelectField`** —— 下拉：默认是**常规下拉框**（跟 `TextField` 一套），无边框那种给 `variant: 'ghost'`；
 搜索、分组、禁用项、加载态、空态、页脚都是它的 prop。
 **`SaveBar`** —— 设置面底下那条"取消 / 保存"（`busy` / `disabled` / `labels` / `onCancel` / `onSave`）。
+**`FormActions`** —— **操作区**（一组按钮）：`actions: { key, label, kind?: 'default' | 'danger' | 'primary', onClick, disabled?, busy? }[]`。
+**顺序 / 间距 / 换行都归它** —— `primary` 永远在右、`danger` 紧挨它左侧、一个区只许一颗 `primary`、
+窄了自动折行且 `primary` 落在右下角；`busy` 自带 `Spinner`。调用点只给"有哪些动作、哪个是主要、点了做什么"：
+**别自己写 `gap` / `margin` / 顺序，也别借 `.wb-formActions` 槽类手摆**（`check:style` 的 F3 会红，没有豁免）。
+
+```tsx
+h(FormActions, { actions: [
+  { key: 'retry', label: t('myunit.retry'), onClick: onRetry, disabled: busy },
+  { key: 'confirm', label: t('myunit.confirm'), kind: 'primary', onClick: submit, disabled: busy },
+] })
+```
+
+`danger` 只标"这是破坏性的"（渲成描边 + 危险色，**永远不当填充的 `primary`**）；**二次确认那半归调用点**
+（先问一句或弹窗都行），口径见 [ADR-0054](../../../../docs/adr/0054-the-action-area-is-one-component.md) §2 规则三。
 
 **别手写 `<button>` / `<input>` / `<select>`**：dsh 有 `Button`（`variant` / `size`），
 kit 有上面这几件；手写的会拿到浏览器默认样式，而且**判据会红**（`check:style`）。
@@ -136,12 +150,13 @@ h('div', { className: styles.form }, …)                    // ← .form { gap:
 ```
 
 `<span className={styles.label}>` 紧邻控件、或给表单容器自己写 `gap` —— 这正是 `check:style` 那条
-棘轮（F1 手写行 / F2 自己管行距）盯的东西；`FORM_ROW_EXEMPT` 是**等外壳发版后要清空的历史账**
-（"迁一处删一行"），**不是"可以继续这么写"的许可**。
+棘轮（F1 手写行 / F2 自己管行距）盯的东西；`FORM_ROW_EXEMPT` 是这张表的历史账，**2026-10-17 已经清空**
+（外壳 0.2.13 之后按"迁一处删一行"迁完，ADR-0052 §10）—— 表空了仍然**不是"可以继续这么写"的许可**：
+现在再这么写直接红，没有豁免那一层。
 
 **时点**：这一层随外壳**发版**后模块才能用 —— 模块的 `peerDependencies` 下限得先有它
 （`check:kit` 拿 peer 下限那份外壳比，不抬必红）；迁移步骤见
-[ADR-0052](../../../../docs/adr/0052-the-form-row-is-one-component.md) §10。
+[ADR-0052](../../../../docs/adr/0052-the-form-row-is-one-component.md) §10。已迁完的包下限在 `^0.2.14`。
 
 ## 6 别的