@dsh-workbench/shared 0.3.5 → 0.3.7

package/src/components/__tests__/long-task-row.test.ts

@@ -0,0 +1,115 @@
+import { readFileSync } from 'node:fs';
+import { describe, expect, it } from 'vitest';
+
+const HERE = new URL('../', import.meta.url);
+const read = (name: string): string => readFileSync(new URL(name, HERE), 'utf8');
+
+const ROW = read('LongTaskRow.tsx');
+const CSS = read('LongTaskRow.css');
+
+describe('两按停止钮：接线（这仓的组件测试是 node 环境，读源码断言）', () => {
+  it('★★ 不给 stop ⇒ 那颗钮整个不出现；文件里也再没有第二颗 button', () => {
+    const gate = ROW.indexOf('{stop === undefined ? null : (');
+    const button = ROW.indexOf('<button');
+
+    expect(ROW).toContain('const stop = props.stop;');
+    expect(gate).toBeGreaterThan(0);
+    expect(button).toBeGreaterThan(gate);
+    expect(ROW.indexOf('<button', button + 1)).toBe(-1);
+  });
+
+  it('★★ 住在 .wb-longTaskHead 里、最右边那颗（margin-left: auto）', () => {
+    const head = ROW.indexOf('className="wb-longTaskHead"');
+    const button = ROW.indexOf('<button');
+    const close = ROW.indexOf('</p>', button);
+
+    expect(head).toBeGreaterThan(0);
+    expect(button).toBeGreaterThan(head);
+    expect(close).toBeGreaterThan(button);
+    expect(CSS).toContain('margin-left: auto');
+  });
+
+  it('★★ 两按只走 longTaskStopPress(longTaskStopStage({ armed, busy }))：arm 上膛 / fire 落膛并 onStop / ignore 不动', () => {
+    expect(ROW).toContain('longTaskStopPress(longTaskStopStage({ armed, busy }))');
+    expect(ROW).toContain('onClick={onStopPress}');
+    expect(ROW).toContain("if (press === 'ignore') return;");
+    expect(ROW).toContain("if (press === 'arm') {");
+    expect(ROW).toContain('setArmed(true);');
+    expect(ROW).toMatch(/setArmed\(false\);\s*stop\.onStop\(\);/);
+  });
+
+  it('★★ onBlur 落膛（焦点一走就退回没上膛）', () => {
+    expect(ROW).toContain('onBlur={() => setArmed(false)}');
+  });
+
+  it('★★ 上膛后 3 秒自己落膛：用 LONG_TASK_STOP_ARM_MS，卸载 / 落膛都清掉计时器', () => {
+    expect(ROW).toContain("from '../api/long-task.js'");
+    expect(ROW).toContain('setTimeout(() => setArmed(false), LONG_TASK_STOP_ARM_MS)');
+    expect(ROW).toContain('clearTimeout(timer)');
+    expect(ROW).toContain('}, [armed]);');
+  });
+
+  it('★★ data-stop-state 交出那一档（照 dsh 的 data-kill-state）', () => {
+    expect(ROW).toContain('data-stop-state={longTaskStopStage({ armed, busy })}');
+  });
+
+  it('★★ busy 时 disabled；上膛时多一个 span 显示 askLabel；三句词全部由调用点给', () => {
+    expect(ROW).toContain('const busy = stop?.busy === true;');
+    expect(ROW).toContain('disabled={busy}');
+    expect(ROW).toContain('<span className="wb-longTaskStopLabel">{stop.askLabel}</span>');
+    expect(ROW).toContain('aria-label={armed ? stop.armedLabel ?? stop.askLabel : stop.label}');
+    expect(ROW).toContain('<IconStopFillRegular size={12} />');
+    expect(ROW).toContain('type="button"');
+    expect(ROW).not.toContain('Translate');
+  });
+
+  it('★★ failed 非空 ⇒ 在 problem 那行后面再画一行（wb-longTaskStopWhy）', () => {
+    const problem = ROW.indexOf('className="wb-longTaskProblem"');
+    const why = ROW.indexOf('className="wb-longTaskStopWhy"');
+
+    expect(ROW).toContain("const stopWhy = stop?.failed ?? '';");
+    expect(ROW).toContain('className="wb-longTaskStopWhy">{stopWhy}');
+    expect(problem).toBeGreaterThan(0);
+    expect(why).toBeGreaterThan(problem);
+  });
+
+  it('★★ 没有 stop 的行一个像素都不变：既要的规则一个字没动，新规则也只在带钮的行上起作用', () => {
+    expect(CSS).toContain('.wb-longTaskHeadline {\n  margin: 0;');
+    expect(CSS).toContain('.wb-longTaskLink {\n  flex: none;\n}');
+    expect(CSS).toContain('.wb-longTaskHead {');
+  });
+});
+
+describe('两按停止钮：样式跟 dsh 那颗钮同款（组件自带，同目录一份 .css）', () => {
+  it('★★ 四个类都在同目录那份 .css 里', () => {
+    for (const cls of [
+      '.wb-longTaskStop {',
+      '.wb-longTaskStopArmed,',
+      '.wb-longTaskStopLabel {',
+      '.wb-longTaskStopWhy {',
+    ]) {
+      expect(CSS).toContain(cls);
+    }
+  });
+
+  it('★★ 上膛变宽（width: auto），取值照 dsh：error 45% 边框 + 12% 底 + gap 4 + padding 0 7px', () => {
+    expect(CSS).toMatch(/\.wb-longTaskStopArmed[\s\S]*width: auto/);
+    expect(CSS).toContain('color-mix(in srgb, var(--dsw-alias-state-error-primary) 45%, transparent)');
+    expect(CSS).toContain('color-mix(in srgb, var(--dsw-alias-state-error-primary) 12%, transparent)');
+    expect(CSS).toContain('gap: var(--wb-len-4)');
+    expect(CSS).toContain('padding: 0 var(--wb-len-7)');
+  });
+
+  it('★★ 上膛那颗字 11px / 18px；失败那行 error 色', () => {
+    expect(CSS).toContain('font-size: var(--dsw-font-xxxs-11-font-size)');
+    expect(CSS).toContain('line-height: var(--wb-line-18)');
+    expect(CSS).toMatch(/\.wb-longTaskStopWhy \{[\s\S]*--dsw-alias-state-error-primary/);
+  });
+
+  it('★ 一格注释都没有，颜色不写字面值（尺寸走 --wb-len-*）', () => {
+    expect(CSS).not.toContain('/*');
+    expect(CSS).not.toContain('#');
+    expect(CSS).toContain('var(--wb-len-20)');
+    expect(CSS).not.toMatch(/(^|[^a-z-])rgb\(/);
+  });
+});

package/src/config/constants.ts

@@ -73,6 +73,9 @@ export const OPENCLI_MAX_CONCURRENT = 4;
 /** 启动预热站点那一跳的超时（毫秒）；超时按未热对待，不挡面板。 */
 export const WARM_TIMEOUT_MS = 20_000;
 
+/** 体检结果算「还新鲜」的时长（毫秒）：期内再来的强制体检直接回上一次那份快照。 */
+export const PREFLIGHT_FRESH_MS = 30_000;
+
 /** 装 / 卸模块包的超时（毫秒）：pnpm 与取包内容都按它算。 */
 export const INSTALL_TIMEOUT_MS = 300_000;
 

package/src/host/__tests__/board-fact.test.ts

@@ -0,0 +1,47 @@
+import { describe, expect, it } from 'vitest';
+import type { BoardProbe } from '../../lib/board-fact.js';
+import { boardFactOf } from '../board-fact.js';
+
+const WORKSHOP = '/w/workbench/diy';
+
+const probe = (over: Partial<BoardProbe> = {}): BoardProbe => ({
+  workbench: true,
+  where: WORKSHOP,
+  bar: true,
+  board: WORKSHOP,
+  open: true,
+  drawn: true,
+  ...over,
+});
+
+describe('板事实：一份判据，两边共用', () => {
+  it('★★ 画着的就是工坊那块板（含子路径）⇒ workshop', () => {
+    expect(boardFactOf(probe(), WORKSHOP)).toBe('workshop');
+    expect(boardFactOf(probe({ board: `${WORKSHOP}/packages` }), WORKSHOP)).toBe('workshop');
+  });
+
+  it('★★ 画的是别的项目的板 ⇒ other（前缀像但没落在里面也算 other）', () => {
+    expect(boardFactOf(probe({ board: '/w/project' }), WORKSHOP)).toBe('other');
+    expect(boardFactOf(probe({ board: `${WORKSHOP}-other` }), WORKSHOP)).toBe('other');
+  });
+
+  it('★★ 那块板没画在屏上 ⇒ hidden：不挂、没声明开着、量出来不可见，三条里任一条不成立都算', () => {
+    expect(boardFactOf(probe({ bar: false }), WORKSHOP)).toBe('hidden');
+    expect(boardFactOf(probe({ open: false }), WORKSHOP)).toBe('hidden');
+    expect(boardFactOf(probe({ drawn: false }), WORKSHOP)).toBe('hidden');
+  });
+
+  it('★★ 工作台没答话（旧外壳 / 夹具页）⇒ unknown：放行，但不许当成"就是工坊板"', () => {
+    expect(boardFactOf(probe({ workbench: false }), WORKSHOP)).toBe('unknown');
+  });
+
+  it('★ 画着板但说不清是哪块、或不知道工坊在哪 ⇒ unknown', () => {
+    expect(boardFactOf(probe({ board: '' }), WORKSHOP)).toBe('unknown');
+    expect(boardFactOf(probe(), null)).toBe('unknown');
+  });
+
+  it('★★ 顺序要紧：没画在屏上，就别去猜是哪块板', () => {
+    expect(boardFactOf(probe({ board: WORKSHOP, drawn: false }), WORKSHOP)).toBe('hidden');
+    expect(boardFactOf(probe({ workbench: false, bar: false }), WORKSHOP)).toBe('unknown');
+  });
+});

package/src/{lib → host/__tests__}/diy-debug.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { DEBUG_STALE_MS, createDebugStore, parseDebugIntent, type DebugPact } from './diy-debug.js';
+import { DEBUG_STALE_MS, createDebugStore, parseDebugIntent, type DebugPact } from '../diy-debug.js';
 
 const pact = (sessionId: string, now = 1000, unit = 'demo'): DebugPact => ({
   sessionId,

package/src/{lib → host/__tests__}/diy-record.test.ts

@@ -4,9 +4,10 @@ import {
   createRecordStore,
   parseRecordIntent,
   recordOwnerText,
+  shotDueOf,
   type RecordPact,
   type RecordState,
-} from './diy-record.js';
+} from '../diy-record.js';
 
 const pact = (sessionId: string, now = 1000, unit = 'demo'): RecordPact => ({
   sessionId,
@@ -169,3 +170,138 @@ describe('用户在左栏按的三个键：意图词表只此一份', () => {
     }
   });
 });
+
+describe('按计数落图的台账：落成才前进，失败如实记、同一个计数只重试一次', () => {
+  const shot = (n: number, extra: Partial<RecordState['shots'][number]> = {}) => ({
+    n,
+    at: 1500 + n,
+    path: `/w/diy/shots/rec-shot-demo-${String(n)}.png`,
+    ...extra,
+  });
+
+  it('★ begin 时台账是空的（还没人按过「截图」）', () => {
+    const store = createRecordStore();
+    const state = held(store.begin(pact('s1', 1000)));
+
+    expect(state.shots).toEqual([]);
+    expect(state.shotsSeen).toBe(0);
+    expect(state.shotTries).toBeNull();
+  });
+
+  it('★★ 落成一张 ⇒ 台账一条、shotsSeen 跟到那个计数、重试数清零', () => {
+    const store = createRecordStore();
+    store.begin(pact('s1', 1000));
+    store.shotFailed('s1', shot(1, { error: '第一次没成' }), 1501);
+
+    const state = held(store.shotTaken('s1', shot(1), 1502));
+
+    expect(state.shots).toEqual([shot(1)]);
+    expect(state.shotsSeen).toBe(1);
+    expect(state.shotTries).toBeNull();
+  });
+
+  it('★★ 落失败 ⇒ 那一条带 error 原文、shotsSeen 一步不前进、同一个计数重试一次就试满了', () => {
+    const store = createRecordStore();
+    store.begin(pact('s1', 1000));
+
+    const first = held(store.shotFailed('s1', shot(1, { error: 'opencli：截不下来' }), 1501));
+    expect(first.shots).toEqual([shot(1, { error: 'opencli：截不下来' })]);
+    expect(first.shotsSeen).toBe(0);
+    expect(first.shotTries).toEqual({ n: 1, tries: 1 });
+
+    const retried = held(store.shotFailed('s1', shot(1, { error: '还是截不下来' }), 1601));
+    expect(retried.shots).toEqual([shot(1, { error: '还是截不下来' })]);
+    expect(retried.shotTries).toEqual({ n: 1, tries: 2 });
+  });
+
+  it('★★ shotDueOf：没涨不拍 / 涨了才拍 / 试满两次就放下 / 他再按一下（计数换新）重来', () => {
+    const store = createRecordStore();
+    const state = held(store.begin(pact('s1', 1000)));
+
+    expect(shotDueOf(state, 0)).toBeNull();
+    expect(shotDueOf(state, 1)).toBe(1);
+    expect(shotDueOf(state, 2.9)).toBe(2);
+    expect(shotDueOf(state, Number.NaN)).toBeNull();
+
+    const done = held(store.shotTaken('s1', shot(1), 1500));
+    expect(shotDueOf(done, 1)).toBeNull();
+    expect(shotDueOf(done, 2)).toBe(2);
+
+    const failed = held(store.shotFailed('s1', shot(2, { error: '没成' }), 1501));
+    expect(shotDueOf(failed, 2)).toBe(2);
+
+    const tried = held(store.shotFailed('s1', shot(2, { error: '还是没成' }), 1502));
+    expect(shotDueOf(tried, 2)).toBeNull();
+    expect(shotDueOf(tried, 3)).toBe(3);
+  });
+
+  it('★ 台账按计数排好，且同一张只留最新那条（重试不叠行）', () => {
+    const store = createRecordStore();
+    store.begin(pact('s1', 1000));
+    store.shotTaken('s1', shot(2), 1500);
+    store.shotFailed('s1', shot(1, { error: '没成' }), 1501);
+
+    const state = held(store.shotFailed('s1', shot(1, { error: '重试也没成' }), 1502));
+
+    expect(state.shots.map((one) => one.n)).toEqual([1, 2]);
+    expect(state.shots).toHaveLength(2);
+    expect(state.shots[0]?.error).toBe('重试也没成');
+  });
+
+  it('★ 台账不是谁都能写的：别人的会话 / 没有那一场，当场拒', () => {
+    const store = createRecordStore();
+
+    expect(store.shotTaken('s1', shot(1), 1000)).toEqual({ ok: false, code: 'none' });
+    expect(store.shotFailed('s1', shot(1), 1000)).toEqual({ ok: false, code: 'none' });
+
+    store.begin(pact('s1', 1000));
+    expect(store.shotTaken('s2', shot(1), 1100)).toEqual({ ok: false, code: 'not-owner' });
+    expect(store.shotFailed('s2', shot(1), 1100)).toEqual({ ok: false, code: 'not-owner' });
+    expect(store.live(1100)?.shots).toEqual([]);
+  });
+});
+
+describe('门铃那一格：命中记一次，超时一个字不动', () => {
+  it('★★ begin 时 0 次；命中一次 +1，并把这一次等了多少毫秒记下', () => {
+    const store = createRecordStore();
+    const state = held(store.begin(pact('s1', 1000)));
+
+    expect(state.beats).toBe(0);
+    expect(state.beatMs).toBe(0);
+
+    const first = held(store.beat('s1', 42, 1200));
+    expect(first.beats).toBe(1);
+    expect(first.beatMs).toBe(42);
+    expect(first.at).toBe(1200);
+
+    const second = held(store.beat('s1', 7, 1300));
+    expect(second.beats).toBe(2);
+    expect(second.beatMs).toBe(7);
+  });
+
+  it('★★ 跟着相位走不丢（started / finished 都保留），收工连它一起清；别人的会话不许写', () => {
+    const store = createRecordStore();
+    store.begin(pact('s1', 1000));
+    store.beat('s1', 12, 1100);
+    store.started('s1', 2000, 2001);
+    store.finished('s1', 3000, 3002);
+
+    const live = store.live(3002);
+    expect(live?.beats).toBe(1);
+    expect(live?.beatMs).toBe(12);
+
+    expect(store.beat('s2', 5, 3100)).toEqual({ ok: false, code: 'not-owner' });
+    expect(held(store.beat('s1', 5, 3200)).beats).toBe(2);
+    expect(store.stop('s1', 3300).ok).toBe(true);
+    expect(store.live(3300)).toBeNull();
+    expect(store.beat('s1', 5, 3400)).toEqual({ ok: false, code: 'none' });
+  });
+
+  it('★ 负数 / 小数收成正经毫秒（读侧那一行不出现 "-0 毫秒" 这种话）', () => {
+    const store = createRecordStore();
+    store.begin(pact('s1', 1000));
+
+    expect(held(store.beat('s1', -3, 1100)).beatMs).toBe(0);
+    expect(held(store.beat('s1', 4.7, 1200)).beatMs).toBe(4);
+  });
+});

package/src/host/__tests__/facts.test.ts

@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest';
+import { isFactScope, scopePrefixOf } from '../../api/facts.js';
+import { unitFactScope } from '../facts.js';
+
+describe('unitFactScope', () => {
+  it('命名空间 = 模块 id + `*`（"这个模块的数据全作废"只写一个字符串）', () => {
+    expect(unitFactScope('cmdb')).toBe('cmdb*');
+    expect(isFactScope('cmdb*')).toBe(true);
+    expect(isFactScope('*')).toBe(false);
+    expect(isFactScope('cmdb/summary')).toBe(false);
+    expect(scopePrefixOf('cmdb*')).toBe('cmdb');
+  });
+});

package/src/host/__tests__/long-task.test.ts

@@ -0,0 +1,306 @@
+import { describe, expect, it } from 'vitest';
+import type { LongTaskStep } from '../../api/long-task.js';
+import {
+  createLongTaskHost,
+  createLongTaskRegistry,
+  sharedLongTaskRegistry,
+  type LongTaskBase,
+  type LongTaskDeps,
+} from '../long-task.js';
+
+interface Probe extends LongTaskBase {
+  readonly note?: string | undefined;
+}
+
+function harness(over: Partial<LongTaskDeps<Probe>> = {}) {
+  let signal: AbortSignal | undefined;
+  let step: ((step: LongTaskStep) => void) | undefined;
+  let settle: ((result: unknown) => void) | undefined;
+  let fail: ((error: unknown) => void) | undefined;
+  const base: LongTaskDeps<Probe> = {
+    now: () => '2026-10-21T02:00:00.000Z',
+    run: (options) =>
+      new Promise((resolve, reject) => {
+        signal = options.signal;
+        step = options.onStep;
+        settle = resolve as (result: unknown) => void;
+        fail = reject as (error: unknown) => void;
+      }),
+    view: (snapshot) => ({ target: snapshot.target, status: snapshot.status, note: snapshot.note }),
+  };
+  return {
+    deps: { ...base, ...over },
+    signal: () => signal,
+    step: (one: LongTaskStep) => step?.(one),
+    done: (result: unknown) => settle?.(result),
+    boom: (error: unknown) => fail?.(error),
+  };
+}
+
+const flush = async (): Promise<void> => {
+  await Promise.resolve();
+  await Promise.resolve();
+};
+
+describe('createLongTaskRegistry.stop（停止只是转发给生产方，认不认 signal 是模块的事）', () => {
+  it('★★ stop：run 拿到的 signal 被 abort，这一趟变 stopped，回 true', () => {
+    const h = harness();
+    const runs = createLongTaskRegistry(h.deps);
+    const started = runs.start({ workspace: '/w/a', target: 'release' });
+
+    expect(h.signal()?.aborted).toBe(false);
+    expect(runs.stop(started.id)).toBe(true);
+    expect(h.signal()?.aborted).toBe(true);
+    expect(runs.snapshot(started.id)?.status).toBe('stopped');
+  });
+
+  it('★★ 结算首胜：停过之后 run 再 resolve 也不许翻案（还是 stopped，不是 ok）', async () => {
+    const h = harness();
+    const runs = createLongTaskRegistry(h.deps);
+    const started = runs.start({ workspace: '/w/a', target: 'release' });
+
+    runs.stop(started.id);
+    h.done({ anything: true });
+    await flush();
+
+    expect(runs.snapshot(started.id)?.status).toBe('stopped');
+  });
+
+  it('★★ 被 abort 的 run 常常 reject（AbortError）：那一趟不许变成 failed', async () => {
+    const h = harness();
+    const runs = createLongTaskRegistry(h.deps);
+    const started = runs.start({ workspace: '/w/a', target: 'release' });
+
+    runs.stop(started.id);
+    h.boom(new Error('This operation was aborted'));
+    await flush();
+
+    expect(runs.snapshot(started.id)?.status).toBe('stopped');
+    expect(runs.snapshot(started.id)?.why).toBeUndefined();
+  });
+
+  it('★★ 不是活的：已收尾 / 不认识的 id ⇒ 回 false，什么都没变', async () => {
+    const h = harness();
+    const runs = createLongTaskRegistry(h.deps);
+    const started = runs.start({ workspace: '/w/a', target: 'release' });
+
+    h.done({});
+    await flush();
+
+    expect(runs.stop(started.id)).toBe(false);
+    expect(runs.snapshot(started.id)?.status).toBe('ok');
+    expect(runs.stop('run-nope')).toBe(false);
+    expect(runs.current('/w/a')).toHaveLength(1);
+  });
+
+  it('★★ 停这一下走 deps.stopped（与 outcome 之于 ok 同形：停在哪、文案怎么写是模块的知识）', () => {
+    const h = harness({ stopped: () => ({ note: '用户按停的' }) });
+    const runs = createLongTaskRegistry(h.deps);
+    const started = runs.start({ workspace: '/w/a', target: 'release' });
+
+    runs.stop(started.id);
+
+    expect(runs.snapshot(started.id)?.note).toBe('用户按停的');
+  });
+
+  it('★ 等你登录时也能停：登录地址跟着清掉', () => {
+    const h = harness();
+    const runs = createLongTaskRegistry(h.deps);
+    const started = runs.start({ workspace: '/w/a', target: 'release' });
+
+    h.step({ kind: 'start', text: '未登录', loginUrl: 'https://x/login' });
+    expect(runs.snapshot(started.id)?.status).toBe('needs-login');
+
+    expect(runs.stop(started.id)).toBe(true);
+    expect(runs.snapshot(started.id)?.status).toBe('stopped');
+    expect(runs.snapshot(started.id)?.loginUrl).toBeUndefined();
+  });
+
+  it('★ 停过之后迟到的步骤也不进这一趟（结算首胜）', () => {
+    const h = harness();
+    const runs = createLongTaskRegistry(h.deps);
+    const started = runs.start({ workspace: '/w/a', target: 'release' });
+
+    runs.stop(started.id);
+    h.step({ kind: 'info', text: '迟到一步' });
+
+    expect(runs.snapshot(started.id)?.steps).toEqual([]);
+    expect(runs.snapshot(started.id)?.status).toBe('stopped');
+  });
+
+  it('★★ current() 每条都带 id（浏览器按 id 点那颗钮），view 覆盖不了', () => {
+    const h = harness({ view: (snapshot) => ({ id: 'spoofed', status: snapshot.status }) });
+    const runs = createLongTaskRegistry({ ...h.deps, nextId: () => 'run-1' });
+    const started = runs.start({ workspace: '/w/a', target: 'release' });
+
+    const [row] = runs.current('/w/a');
+
+    expect(started.id).toBe('run-1');
+    expect(row?.['id']).toBe('run-1');
+  });
+});
+
+describe('createLongTaskRegistry.live（外壳侧栏那颗 loading 点读的：不分工作区，只给活着的）', () => {
+  it('★★ 两个工作区各一趟在跑 ⇒ 两趟都在；收尾的 / 停掉的不在', async () => {
+    const h = harness();
+    const runs = createLongTaskRegistry(h.deps);
+    const a = runs.start({ workspace: '/w/a', target: 'release', session: 's-1' });
+    const b = runs.start({ workspace: '/w/b', target: 'board' });
+
+    expect(runs.live().map((one) => one.id)).toEqual([a.id, b.id]);
+    expect(runs.live().map((one) => one.session)).toEqual(['s-1', undefined]);
+
+    h.done({});
+    await flush();
+    expect(runs.live().map((one) => one.id)).toEqual([a.id]);
+
+    runs.stop(a.id);
+    expect(runs.live()).toEqual([]);
+  });
+
+  it('★ 要登录那种也算活着（与 longTaskDot 同一口径）', () => {
+    const h = harness();
+    const runs = createLongTaskRegistry(h.deps);
+    runs.start({ workspace: '/w/a', target: 'release' });
+
+    h.step({ kind: 'start', text: '未登录', loginUrl: 'https://x/login' });
+
+    expect(runs.live().map((one) => one.status)).toEqual(['needs-login']);
+  });
+
+  it('★★ 交回的是 base 快照（工作区 / 目标 / 来源会话都在），模块那层 view 投影不参与', () => {
+    const h = harness({ view: () => ({ hidden: true }) });
+    const runs = createLongTaskRegistry(h.deps);
+    runs.start({ workspace: '/w/a', target: 'release', session: 's-1' });
+
+    expect(runs.live()[0]).toMatchObject({
+      workspace: '/w/a',
+      target: 'release',
+      session: 's-1',
+      status: 'running',
+    });
+  });
+});
+
+describe('sharedLongTaskRegistry（那一份跨热重载存活）', () => {
+  it('★★ 槽里那份**上一版的注册表**（四个方法、没有 stop）仍被认回：升级那次重载不重建空表', () => {
+    const scope = `test-${String(Date.now())}-${Math.random()}`;
+    const slot = Symbol.for(`dsh-workbench:long-task:${scope}:demo`);
+    const stale = {
+      start: () => undefined,
+      snapshot: () => null,
+      active: () => null,
+      current: () => [],
+      onChange: () => () => {},
+    };
+    (globalThis as unknown as Record<symbol, unknown>)[slot] = stale;
+
+    const again = sharedLongTaskRegistry(scope, 'demo', harness().deps);
+
+    expect(again).toBe(stale);
+    expect(Object.hasOwn(again, 'stop')).toBe(false);
+  });
+
+  it('★ 认不出（热重载换了接口）⇒ 重造，槽里换成新表', () => {
+    const scope = `test-${String(Date.now())}-${Math.random()}`;
+    const slot = Symbol.for(`dsh-workbench:long-task:${scope}:demo`);
+    const stale = {
+      start: () => undefined,
+      snapshot: () => null,
+      active: () => null,
+    };
+    (globalThis as unknown as Record<symbol, unknown>)[slot] = stale;
+
+    const fresh = sharedLongTaskRegistry(scope, 'demo', harness().deps);
+
+    expect(fresh).not.toBe(stale);
+    expect((globalThis as unknown as Record<symbol, unknown>)[slot]).toBe(fresh);
+    expect(typeof fresh.stop).toBe('function');
+  });
+});
+
+describe('来源会话（谁的这一趟，决定停它要不要审批）', () => {
+  it('★★ start 把来源会话记进快照', () => {
+    const h = harness();
+    const runs = createLongTaskRegistry({ ...h.deps, nextId: () => 'run-1' });
+    const started = runs.start({ workspace: '/w/a', target: 'release', session: 's-1' });
+
+    expect(started.session).toBe('s-1');
+    expect(runs.snapshot('run-1')?.session).toBe('s-1');
+  });
+
+  it('★★ 不给来源 ⇒ 快照里连 session 这个键都没有（别把 undefined 塞进去）', () => {
+    const h = harness();
+    const runs = createLongTaskRegistry(h.deps);
+    const started = runs.start({ workspace: '/w/a', target: 'release' });
+
+    expect(started.session).toBeUndefined();
+    expect(Object.keys(runs.snapshot(started.id) ?? {})).not.toContain('session');
+  });
+
+  it('★★ stop(id, by)：谁按的落在那条 settle 通知上', () => {
+    const h = harness();
+    const runs = createLongTaskRegistry(h.deps);
+    const seen: Array<{ kind: string; by: string | undefined; status: string }> = [];
+    runs.onChange((change) => {
+      seen.push({ kind: change.kind, by: change.by, status: change.snapshot.status });
+    });
+    const started = runs.start({ workspace: '/w/a', target: 'release', session: 's-1' });
+
+    expect(runs.stop(started.id, 's-2')).toBe(true);
+
+    expect(seen).toEqual([
+      { kind: 'start', by: undefined, status: 'running' },
+      { kind: 'settle', by: 's-2', status: 'stopped' },
+    ]);
+  });
+
+  it('★★ stop(id) 不给 by ⇒ 通知里的 by 是 undefined（界面上按的用户）', () => {
+    const h = harness();
+    const runs = createLongTaskRegistry(h.deps);
+    let settleBy: string | undefined = 'sentinel';
+    runs.onChange((change) => {
+      if (change.kind === 'settle') settleBy = change.by;
+    });
+    const started = runs.start({ workspace: '/w/a', target: 'release' });
+
+    expect(runs.stop(started.id)).toBe(true);
+    expect(settleBy).toBeUndefined();
+  });
+});
+
+describe('createLongTaskHost 的 notify（每次变更都叫一下，bump 那半照旧）', () => {
+  it('★★ 起 / 走一步 / 被停 三次都叫 notify；停那笔带着谁按的', () => {
+    const bumps: string[][] = [];
+    const seen: string[] = [];
+    const box = createLongTaskHost({
+      scope: `test-${String(Date.now())}-${Math.random()}`,
+      unit: 'demo',
+      bump: (facts) => bumps.push([...facts]),
+      notify: (change) => seen.push(`${change.kind}:${change.snapshot.status}:${change.by ?? '-'}`),
+    });
+    const h = harness();
+    const runs = box.host.create({ key: 'release', ...h.deps, nextId: () => 'run-1' });
+
+    runs.start({ workspace: '/w/a', target: 'release', session: 's-1' });
+    h.step({ kind: 'start', text: '走一步' });
+
+    expect(runs.stop('run-1', 's-1')).toBe(true);
+    expect(seen).toEqual(['start:running:-', 'step:running:-', 'settle:stopped:s-1']);
+    expect(bumps).toEqual([['demo/runs'], ['demo/runs'], ['demo/runs']]);
+  });
+
+  it('★ 没给 notify 也照常跑（老调用点不受影响）', () => {
+    const bumps: string[][] = [];
+    const box = createLongTaskHost({
+      scope: `test-${String(Date.now())}-${Math.random()}`,
+      unit: 'demo',
+      bump: (facts) => bumps.push([...facts]),
+    });
+    const h = harness();
+
+    box.host.create({ key: 'release', ...h.deps }).start({ workspace: '/w/a', target: 'release' });
+
+    expect(bumps).toEqual([['demo/runs']]);
+  });
+});

package/src/{lib → host/__tests__}/panel-state.test.ts

@@ -5,7 +5,7 @@ import {
   createPanelStateStore,
   parseCardsReport,
   parseCrashReport,
-} from './panel-state';
+} from '../panel-state.js';
 
 function card(unit: string, route: string, phase: 'idle' | 'loading' | 'ready' | 'error', at: number) {
   return { unit, route, phase, at };