@dsh-workbench/core 0.3.7 → 0.3.8

package/client.js

@@ -559,6 +559,16 @@ window.__ModuleLoader__.load({
       	return "idle";
       }
       /**
+      * 这一趟还在不在跑（`running` 与 `needs-login` 都算）。
+      * 卡片要判"这一行要不要摆停止钮""这套环境里有没有活着的跑"时用这个 —— **不是** `longTaskDot`：
+      * 那一件是状态点的**长相**（四档），归 `LongTaskRow` 自己用，不该被调用点拿去当判据。
+      * @param status 长任务的五种态。
+      * @returns 在跑 `true`；成功 / 失败 / 用户按停都是 `false`。
+      */
+      function longTaskIsLive(status) {
+      	return status === "running" || status === "needs-login";
+      }
+      /**
       * 算停止钮现在在哪一档。
       * @param state armed = 已经按过第一下、在等第二下；busy = 停止请求已经在飞。
       * @returns busy 优先（在飞时按不动），其次 armed，否则 idle。
@@ -10837,17 +10847,19 @@ window.__ModuleLoader__.load({
       			setStopping((current) => current === id ? null : current);
       		}
       	}, [send]);
-      	const every = longTaskPollMs(runs.some((run) => longTaskDot(run.status) === "ongoing"), options.pollMs);
+      	const every = longTaskPollMs(runs.some((run) => longTaskIsLive(run.status)), options.pollMs);
       	useEffect(() => {
       		if (!enabled) return void 0;
       		const timer = setInterval(() => setTick((count) => count + 1), every);
       		return () => clearInterval(timer);
       	}, [enabled, every]);
+      	const refresh = useCallback(() => setTick((count) => count + 1), []);
       	return {
       		runs,
       		stop,
       		stopping,
-      		stopFailed: write.failed
+      		stopFailed: write.failed,
+      		refresh
       	};
       }
       //#endregion
@@ -11103,6 +11115,7 @@ window.__ModuleLoader__.load({
       		...context_chips_exports
       	},
       	lib: {
+      		longTaskIsLive,
       		MIN_BUSY_MS: 500,
       		blockerOfCapability,
       		blockerOfError,

package/dist/client/client.body.js

@@ -552,6 +552,16 @@ function longTaskDot(status) {
 	return "idle";
 }
 /**
+* 这一趟还在不在跑（`running` 与 `needs-login` 都算）。
+* 卡片要判"这一行要不要摆停止钮""这套环境里有没有活着的跑"时用这个 —— **不是** `longTaskDot`：
+* 那一件是状态点的**长相**（四档），归 `LongTaskRow` 自己用，不该被调用点拿去当判据。
+* @param status 长任务的五种态。
+* @returns 在跑 `true`；成功 / 失败 / 用户按停都是 `false`。
+*/
+function longTaskIsLive(status) {
+	return status === "running" || status === "needs-login";
+}
+/**
 * 算停止钮现在在哪一档。
 * @param state armed = 已经按过第一下、在等第二下；busy = 停止请求已经在飞。
 * @returns busy 优先（在飞时按不动），其次 armed，否则 idle。
@@ -10830,17 +10840,19 @@ function useLongTask(options) {
 			setStopping((current) => current === id ? null : current);
 		}
 	}, [send]);
-	const every = longTaskPollMs(runs.some((run) => longTaskDot(run.status) === "ongoing"), options.pollMs);
+	const every = longTaskPollMs(runs.some((run) => longTaskIsLive(run.status)), options.pollMs);
 	useEffect(() => {
 		if (!enabled) return void 0;
 		const timer = setInterval(() => setTick((count) => count + 1), every);
 		return () => clearInterval(timer);
 	}, [enabled, every]);
+	const refresh = useCallback(() => setTick((count) => count + 1), []);
 	return {
 		runs,
 		stop,
 		stopping,
-		stopFailed: write.failed
+		stopFailed: write.failed,
+		refresh
 	};
 }
 //#endregion
@@ -11096,6 +11108,7 @@ var kit = {
 		...context_chips_exports
 	},
 	lib: {
+		longTaskIsLive,
 		MIN_BUSY_MS: 500,
 		blockerOfCapability,
 		blockerOfError,

package/dist/client/index.js

@@ -555,6 +555,16 @@ function longTaskDot(status) {
 	return "idle";
 }
 /**
+* 这一趟还在不在跑（`running` 与 `needs-login` 都算）。
+* 卡片要判"这一行要不要摆停止钮""这套环境里有没有活着的跑"时用这个 —— **不是** `longTaskDot`：
+* 那一件是状态点的**长相**（四档），归 `LongTaskRow` 自己用，不该被调用点拿去当判据。
+* @param status 长任务的五种态。
+* @returns 在跑 `true`；成功 / 失败 / 用户按停都是 `false`。
+*/
+function longTaskIsLive(status) {
+	return status === "running" || status === "needs-login";
+}
+/**
 * 算停止钮现在在哪一档。
 * @param state armed = 已经按过第一下、在等第二下；busy = 停止请求已经在飞。
 * @returns busy 优先（在飞时按不动），其次 armed，否则 idle。
@@ -10833,17 +10843,19 @@ function useLongTask(options) {
 			setStopping((current) => current === id ? null : current);
 		}
 	}, [send]);
-	const every = longTaskPollMs(runs.some((run) => longTaskDot(run.status) === "ongoing"), options.pollMs);
+	const every = longTaskPollMs(runs.some((run) => longTaskIsLive(run.status)), options.pollMs);
 	useEffect(() => {
 		if (!enabled) return void 0;
 		const timer = setInterval(() => setTick((count) => count + 1), every);
 		return () => clearInterval(timer);
 	}, [enabled, every]);
+	const refresh = useCallback(() => setTick((count) => count + 1), []);
 	return {
 		runs,
 		stop,
 		stopping,
-		stopFailed: write.failed
+		stopFailed: write.failed,
+		refresh
 	};
 }
 //#endregion
@@ -11099,6 +11111,7 @@ var kit = {
 		...context_chips_exports
 	},
 	lib: {
+		longTaskIsLive,
 		MIN_BUSY_MS: 500,
 		blockerOfCapability,
 		blockerOfError,

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

@@ -9,7 +9,7 @@ import * as capabilityGateModule from '../shared/hooks/use-capability-gate';
 import * as unitBoardModule from '../shared/hooks/use-unit-board';
 import * as visibleBusyModule from '../shared/hooks/use-visible-busy';
 import * as blockerStateModule from '../shared/components/BlockerState';
-import { ActivityAction, ActivityBlock, ActivityLine, ApprovalDetail, ApprovalPlan, Card, CardAnchor, CardBoundary, CardHead, CenteredState, ChoiceGroup, ConfirmBar, EmptyState, Field, Form, FormActions, FormRow, FormRows, IconBrandMark, IconConversation, IconModuleMark, IconNpm, IconOpencli, IconPanelScreen, Link, LongTaskRow, Note, Row, Rows, SaveBar, SelectField, SettingsSection, SkeletonRows, Spinner, Stack, StateBlock, TextField, apiGet, apiPost, blockerOfCapability, blockerOfError, cardIdOf, cx, defaultSelectFilter, duplicateKeysOf, errorReasonOf, excerpt, filterSelectOptions, firstProblemOf, formFirstProblemOf, formValuesOf, holdBusy, parseJsonLoose, parseLocalTimestamp, readText, relativeTime, relativeTimeAgo, relativeTimeBucket, relativeTimeCompact, revealFirstProblem, searchTextOf, selectCursorValue, selectEntries, shortenPath, stepSelectCursor, writeText } from '@dsh-workbench/shared';
+import { ActivityAction, ActivityBlock, ActivityLine, ApprovalDetail, ApprovalPlan, Card, CardAnchor, CardBoundary, CardHead, CenteredState, ChoiceGroup, ConfirmBar, EmptyState, Field, Form, FormActions, FormRow, FormRows, IconBrandMark, IconConversation, IconModuleMark, IconNpm, IconOpencli, IconPanelScreen, Link, LongTaskRow, longTaskIsLive, Note, Row, Rows, SaveBar, SelectField, SettingsSection, SkeletonRows, Spinner, Stack, StateBlock, TextField, apiGet, apiPost, blockerOfCapability, blockerOfError, cardIdOf, cx, defaultSelectFilter, duplicateKeysOf, errorReasonOf, excerpt, filterSelectOptions, firstProblemOf, formFirstProblemOf, formValuesOf, holdBusy, parseJsonLoose, parseLocalTimestamp, readText, relativeTime, relativeTimeAgo, relativeTimeBucket, relativeTimeCompact, revealFirstProblem, searchTextOf, selectCursorValue, selectEntries, shortenPath, stepSelectCursor, writeText } from '@dsh-workbench/shared';
 export declare const kit: {
     hooks: {
         heldPhase(phase: visibleBusyModule.HeldPhase, refreshing: boolean): visibleBusyModule.HeldPhase;
@@ -102,6 +102,7 @@ export declare const kit: {
         apiPost: typeof apiPost;
     };
     lib: {
+        longTaskIsLive: typeof longTaskIsLive;
         MIN_BUSY_MS: number;
         blockerOfCapability: typeof blockerOfCapability;
         blockerOfError: typeof blockerOfError;

package/dist/types/shared/hooks/use-long-task.d.ts

@@ -3,12 +3,15 @@ import { type LongTaskStatus, type WriteOutcome } from '@dsh-workbench/shared';
  * 这一单元的长任务清单与停止口：`runs` 是这次读交回的那一批（读数还没回来时是空数组）；
  * `stop(id)` 请外壳停某一趟 —— 回执没成就带回一句人话（调用点自己决定说不说）；
  * `stopping` 是正在请求停止的那一趟 id（没有就是 `null`），`stopFailed` 是上一次停止请求失败那句话（没有就是 `null`）。
+ * `refresh()` 让这一格**立刻**重读一次（不必等下一拍轮询）—— 自己写完/发起完之后用它，
+ * 别去拼读口路由、也别为一个读数去碰事实通道。
  */
 export interface LongTaskFeed<T> {
     readonly runs: readonly T[];
     stop(id: string): Promise<WriteOutcome<unknown>>;
     readonly stopping: string | null;
     readonly stopFailed: string | null;
+    refresh(): void;
 }
 /**
  * 卡片要轮询长任务那一行时调用：有在跑的（`running` / `needs-login`）按 `longTaskPollMs` 走快档、空闲走慢档；

package/package.json

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

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

@@ -105,7 +105,7 @@ h(Form<{ branch: string }>, {
 
 **`ConfirmBar`** —— 「先问一句再动手」那一条（标题 / 说明 / 键值 / 失败那句 / 动作区一次收口）：
 键值走 `Rows` / `Row`、错走 `Note tone="problem"`、动作走 `FormActions` —— **别自己拼这四个槽**。
-**要不要问归调用点**（同 `FormActions`：`danger` 只标"破坏性"）。口径见 ADR-0073。
+**要不要问归调用点**（`danger` 只标"破坏性"）。口径见 ADR-0073。
 
 怎么排（标签位置、错误态、尺寸）见 §5。
 
@@ -120,7 +120,7 @@ kit 的 hook 也分四个场合，**别自己 `useState` + `setTimeout` 造一
 | "至少转一会儿"的忙态 | `useVisibleBusy`（投影那两件 `busyView` / `heldPhase`） |
 | 一格**卡片**起步（gate + 忙 + 探针 + 上报 + blocker 一次叠好） | `useUnitBoard`（`read(gated)` 里自己调 `useApiResource`） |
 | 只要一格的能力门 / 整张能力表 | `useCapabilityGate` / `useCapabilityMap` |
-| 写（**别在组件里 `fetch`**） / 轮询长任务 | `useHostWrite` / `useLongTask`（画用 `LongTaskRow` —— 圆点与阶段它自己带） |
+| 写（**别在组件里 `fetch`**） / 轮询长任务 | `useHostWrite` / `useLongTask`（画用 `LongTaskRow`；判「还在跑」`longTaskIsLive`、写完让这一格立刻重读 `refresh()`） |
 
 取数那条链的图见 [LINKAGE.md](LINKAGE.md) §8，写通道与配置见 [PANEL.md](PANEL.md) §5。
 
@@ -131,8 +131,8 @@ kit 的 hook 也分四个场合，**别自己 `useState` + `setTimeout` 造一
 它自己组 `[...extra, ...cancel, submit(primary)]`（提交钮永远在右；「一会在左一会在右」就是自己摆的结果）；
 其余口径（时机 / 第一处错误 / `busy` / `disabled`）看它的 JSDoc 与 ADR-0068 / ADR-0074。
 
-`FormRows` + `FormRow` + `FormActions` 留给**不是整张表单**的地方：单行（一格字段嵌在别处，比如卡片里
-那一条设定）、非表单的一组动作（工具栏、卡头那几颗钮）。那里才自己拼这三件：
+`FormRows` + `FormRow` + `FormActions` 留给**不是整张表单**的地方：单行（一格字段嵌在别处）、
+非表单的一组动作（工具栏、卡头那几颗钮）—— 那里才自己拼这三件：
 
 ```tsx
 h(FormRows, null,
@@ -145,7 +145,7 @@ h(FormRows, null,
 - **`hint` 与 `problem` 二选一**：有错先显示错。
 
 **错误态**：位置与长相归 `FormRow.problem` + 控件的 `invalid`；**算错的逻辑留在模块**（纯函数 + 文案，
-交给 `FormField.validate`）—— **别指望外壳给校验引擎**（不做 `rules` / 异步 / 联动、不持有值），
+交给 `FormField.validate`）—— **别指望外壳给校验引擎**（不做 `rules` / 异步 / 联动），
 **"提交过没有"与聚焦第一处错也归 `Form`**（别自己记布尔、别自己调 `revealFirstProblem`）。
 
 **选择类用哪件**：候选多 / 要搜索 / 要分组 / 名单可能读不到 ⇒ `SelectField`；候选少、要一眼看全 / 多选 ⇒
@@ -172,7 +172,7 @@ h('form', …)                                  // ← 裸 <form> / 手写行槽
 - **`Link`** —— **唯一**的外链写法（`h(Link, { href, children })`）：**别去掉箭头、别在文案里自带 `→`、
   别手写 `<a>`**（判据红）。
 - **`SettingsSection` / `Stack` / `BlockerState` / `Tip`** —— 一屏设置里的一节 / 竖排间距 / 阻断屏 /
-  Tooltip（图标钮与只有图的地方**必须**有它或 `aria-label`）；prop 看 `.d.ts`。
+  Tooltip（只有图的地方**必须**有它或 `aria-label`）；prop 看 `.d.ts`。
 - **真机上造不出来的那几态**：拿你自己那份 `plugin.test.ts` 把五态各喂一遍（`check --only cards`
   拿七种外壳侧输入各喂一遍，只问"退化得干不干净"）。
 - **图标** —— `IconPanelScreen` / `IconModuleMark` / `IconNpm` / `IconOpencli`；其余图形一律从 dsh 的
@@ -189,11 +189,10 @@ h('form', …)                                  // ← 裸 <form> / 手写行槽
 
 ## 8 kit 里没有、但你确定要标准控件
 
-**先问工具**：DIY 会话里调 `workbench_diy_components`（不填给清单与类型面根；`name=Button`
-回它的类型文件与声明）。工程域用 `dsh-wb-module check --only primitives`
+**先问工具**：DIY 会话里调 `workbench_diy_components`（不填给清单；`name=Button` 回它的类型与声明）。工程域用 `dsh-wb-module check --only primitives`
 （`--all` 全表 / `--json` 机器档）—— 分桶导出 + 与 kit 求交（`kit 里已有` 的优先用）+
 该写进 `package.json` 的那两行；骨架默认已备好。
-**要看某一件**：`--file <名字>`（`--files | grep <名字>` 全表）。
+**要看某一件**：`--file <名字>`（`--files | grep <名字>`）。
 
 ```jsonc
 "dsh": { "client": { "external": [ "@dsh-workbench/core/client", "@deepseek-ai/dsh-client-ui-primitives" ] } },