手工走通整条流,揪出五处编排层问题 —— 最要命的是假成功

把 `unified-quote` 从起单一路手工答到底(这是逐个开发活动之前该做的验证), 一路撞出五处,按撞到的顺序: ① 七个活动派出七张一模一样的「请处理」槽位骨架给的是 `card: {}`,工单标题/字段全落回默认。收卡的人不知道自己走到哪一步、这一步要干什么,整条流没法手工走通。→ 卡面自述:标题就是步骤标签, 依据带「第几步 / 共几步」,并如实说「这一步的自动化还没开发,先由你来办」。 ② 走到第 3 步就 `exhausted` 终态、工作流转 abnormal 六个槽位共用 `humanCalls: 3`,而 A1 声明了 6 个人类步 —— 活动**结构上永远走不完**。 → `budgetFor(n)` 按各槽位自己的步数给。步/项清单提成 `STEPS` 常量, 预算与骨架共用同一个数组,数不上不会漂移。治理台申报值也同源(否则台上摆假数)。 ③ 六步答完,任务卡在「等人,却没有任何东西等人答」 `flow-runner` 写死了 `released = lastStepIsAcceptance && lastVerdictPassed` —— 末步不是验收工单,活动就永远不 release。→ 声明的六步来自 MVP 作业指导书, 不篡改语义,在其后**追加**一步「收口验收」。 ④ 只走了 A1(一个节点实例)却报 `completed` ← **最危险的一处** 状态聚合把「没有在跑的了」当成完成。界面上是一单已完成的报价,业务上一步没走。 → 「完成」凭**到过终点节点**;收敛而未到终点 = 卡住 = `abnormal`,进驾驶舱异常卡。 `aggregateWorkflowState` 收第三个入参(终点 id 集),不传退回旧口径。 ⑤ 异或网关一条边都选不中时,流无声停住 ④ 让它至少报异常了,但只说「有问题」不说「哪儿」。→ 发 `route-dead-end` 事件: 哪个节点、各出边的条件、判据里当时有哪些键。只记键名不记值 —— 诊断够用, 载荷不进事件明文。实测这条痕直接指出「G1 要 needAlternative,而键里没有」。顺带:改槽位内容必须升包版(0.1.0 → 0.4.0)。「安装恒为新增、版本并存」是硬不变量, 同版重装是 no-op、manifest 一字不动 —— 我第一次改完重播种,屏幕报「已装入」而库里还是旧的。 `installSlots` 现在先问库、如实报「已装」还是「已在库,未改动 —— 要换内容请升包版」。 **走查后的诚实状态**:A1 走得完、活动 released;流**过不了 G1**,因为出口的必填去向旗产不出来。这不是缺陷 —— 出口载荷由台账落地事实推导,槽位没实现台账写入就没有事实, 凭空捏一个就是在系统内部 mock。于是 A1 的开发完成判据也具体了:必须让 `needAlternative` / `needSourcing` 成为落地事实,否则 G1 永远判不了。债务簿已记。另记一条闸的盲点:api:check 只快照 index/contract/port.d.ts,而 index 是 re-export 名单 —— 给纯函数加形参它看不见(本次实测)。改签名要手动同步 CONTRACT.md,别指望闸提醒。 typecheck ✓ lint ✓ depcruise 374 模块 ✓ api:check ✓ 490 测试 ✓(均以退出码验) Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
2026-07-28 11:11:32 +08:00
parent 5826b6f976
commit 22aa44c775
6 changed files with 260 additions and 36 deletions
@@ -273,6 +273,27 @@ describe('aggregateWorkflowState —— 聚合投影,流程层不另设状态机
  it('控制事件终止 → 已终止', () => {
    expect(aggregateWorkflowState([inst({ running: true })], true)).toBe('terminated');
  });
+
+  /*
+   * 「完成」凭到过终点,不凭没有在跑的了。
+   * 实测过一次假成功:A1 办结、出口少了必填去向旗、G1 异或出边条件全不成立,
+   * 流无声停在 A1 —— 只有一个节点实例,状态却报 completed,界面上是一单「已完成」的报价。
+   */
+  it('传了终点节点:到过终点才算完成', () => {
+    expect(
+      aggregateWorkflowState([inst({ nodeId: 'A1', terminal: 'released' }), inst({ nodeId: 'end', terminal: 'released' })], false, ['end']),
+    ).toBe('completed');
+  });
+
+  it('传了终点节点:收敛了但没到终点 → 异常(卡住了,不是完成)', () => {
+    expect(aggregateWorkflowState([inst({ nodeId: 'A1', terminal: 'released' })], false, ['end'])).toBe('abnormal');
+  });
+
+  it('终点自己没 released 也不算完成', () => {
+    expect(
+      aggregateWorkflowState([inst({ nodeId: 'end', terminal: 'blocked', failureDigested: true })], false, ['end']),
+    ).toBe('abnormal');
+  });
 });

 describe('失败走向的消化与重开', () => {