@dsh-workbench/module-tools 1.2.0 → 1.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/module-tools",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "模块包的构建与门禁工具：build（单文件 ESM 宿主侧 + 套 loader 壳的浏览器侧）、check（契约/产物边界/源码边界/卡片渲染）。模块包不再各带一份构建脚本。",
   "license": "MIT",
   "type": "module",
@@ -33,7 +33,7 @@
     "semver": "^7.8.5",
     "typescript": "5.9.3",
     "typescript-eslint": "^8.71.0",
-    "@dsh-workbench/shared": "1.2.0"
+    "@dsh-workbench/shared": "1.2.2"
   },
   "repository": {
     "type": "git",

package/src/checks/cards.mjs

@@ -367,6 +367,23 @@ const PROBE_LONG_TASKS = [
     step: '完成',
     steps: [],
   },
+  {
+    unit: 'probe',
+    id: 'run-3',
+    workspace: '/tmp/repo',
+    target: 'probe-waiting',
+    status: 'needs-human',
+    step: '等确认',
+    steps: ['等确认'],
+    intervention: {
+      title: '去控制台确认发布',
+      hint: '发布会话还等着你点「确认」',
+      actions: [
+        { kind: 'open-url', url: 'https://example.test/console' },
+        { kind: 'copy', text: 'release-session-123' },
+      ],
+    },
+  },
 ];
 
 const PROBE_VIEW = {

package/src/checks/contracts.mjs

@@ -193,6 +193,9 @@ function fakeLongTasks(created) {
         live: () => [],
         stop: () => false,
         onChange: () => () => {},
+        recheck: () => false,
+        answer: () => false,
+        answerable: false,
       };
     },
   };
@@ -309,7 +312,7 @@ function mountOf(face, created, manifest, tools) {
   }
 }
 
-const LONG_TASK_METHODS = ['start', 'snapshot', 'active', 'current', 'live', 'stop', 'onChange'];
+const LONG_TASK_METHODS = ['start', 'snapshot', 'active', 'current', 'live', 'stop', 'onChange', 'recheck', 'answer'];
 
 const LONG_TASK_RENDERERS = ['useLongTask', 'LongTaskRow', 'longTaskDot'];
 
@@ -736,7 +739,7 @@ export async function run() {
         const missing = LONG_TASK_METHODS.filter((method) => typeof registry[method] !== 'function');
         if (missing.length > 0) {
           problems.push(
-            `${name}: 长任务注册表缺方法 ${missing.join(' / ')} —— 外壳按它给这个单元投影出 /runs 路由（停止那颗钮也按它发），` +
+            `${name}: 长任务注册表缺方法 ${missing.join(' / ')} —— 外壳按它给这个单元投影出 /runs 路由（停止 / 我处理完了 / 回执三颗钮也按它发），` +
               `kit 的 useLongTask 与左栏会话行那颗 loading 点读的也是它（后者走 \`live()\`；注册表用 ` +
               `@dsh-workbench/shared/host 的 createLongTaskRegistry 建）`,
           );
@@ -761,7 +764,7 @@ export async function run() {
       if (!LONG_TASK_RENDERERS.some((one) => clientText.includes(one))) {
         problems.push(
           `${name}: 注册了长任务，但客户端产物里没有 ${LONG_TASK_RENDERERS.join(' / ')}（kit 里那套）—— ` +
-            `用户点完只看得到"没反应"，看不到进行中 / 要登录 / 停下的 / 完成 / 出错`,
+            `用户点完只看得到"没反应"，看不到进行中 / 等人处理 / 要登录 / 停下的 / 完成 / 出错`,
         );
       }
     }

package/template-diy/src/model/__tests__/flow.test.ts.tpl

@@ -17,20 +17,22 @@ describe('样板流程的模型', () => {
     expect(flow.target).toEqual({ $ref: 'in.path' });
   });
 
-  it('只有 running / needs-login 算还在跑', () => {
+  it('running / needs-human / needs-login 都算还在跑', () => {
     expect(runIsLive(run())).toBe(true);
+    expect(runIsLive(run({ status: 'needs-human' }))).toBe(true);
     expect(runIsLive(run({ status: 'needs-login' }))).toBe(true);
     expect(runIsLive(run({ status: 'ok' }))).toBe(false);
     expect(runIsLive(run({ status: 'failed' }))).toBe(false);
     expect(runIsLive(run({ status: 'stopped' }))).toBe(false);
   });
 
-  it('标题按五态与当前步骤说人话', () => {
+  it('标题按六态与当前步骤说人话', () => {
     expect(headlineOf(run())).toBe('样板流程正在跑');
     expect(headlineOf(run({ step: '读目录' }))).toBe('样板流程：读目录');
     expect(headlineOf(run({ status: 'ok' }))).toBe('样板流程跑完了');
     expect(headlineOf(run({ status: 'failed' }))).toBe('样板流程失败');
     expect(headlineOf(run({ status: 'stopped' }))).toBe('样板流程已停止');
+    expect(headlineOf(run({ status: 'needs-human' }))).toBe('样板流程在等人处理');
     expect(headlineOf(run({ status: 'needs-login' }))).toBe('样板流程要登录');
   });
 });

package/template-diy/src/model/flow.ts.tpl

@@ -38,10 +38,11 @@ export function headlineOf(run: SampleRun): string {
   if (run.status === 'ok') return '样板流程跑完了';
   if (run.status === 'failed') return '样板流程失败';
   if (run.status === 'stopped') return '样板流程已停止';
+  if (run.status === 'needs-human') return '样板流程在等人处理';
   if (run.status === 'needs-login') return '样板流程要登录';
   return run.step === '' ? '样板流程正在跑' : `样板流程：${run.step}`;
 }
 
 export function runIsLive(run: SampleRun): boolean {
-  return run.status === 'running' || run.status === 'needs-login';
+  return run.status === 'running' || run.status === 'needs-human' || run.status === 'needs-login';
 }