活动伪函数占位:机器步落台账 + 一张验收单 —— 顺手揪出三个引擎 bug

按你定的形态做:占位一律机器步,每个活动只留一张验收单要人签; **不碰活动内部的业务判断** —— 打标、定价、比价那些一概不做。 ## 占位怎么占一枚纯工具 `slot.placeholder`:只穿透上游给的值、给显眼的默认(数值一律 0, 主键给「PN-占位」这类),行上写 `status: '占位'`。它不判断任何事。骨架 = N 个机器步各落一行台账 + 末步一张验收单。验收单的卡面要人填的正是**该活动该产出、而占位产不出的判断**(如两枚去向旗)—— 人类步的回传值同样经 writeOutput 落台账、步序在后,所以人填的覆盖占位的默认。占位期要走哪个分支,在验收时说,不必改代码。六个槽位一律 flow 范式(A2/A3/A6 本该是 loop,但 loop 要 Agent 真调模型; 占位是固定序列,声明成 flow 才诚实),那份没人用的 loop 骨架顺手删了。预算改成固定 humanCalls: 2(机器步不吃人工调用)。 ## 三个引擎 bug,都是「无声卡住」 **① 异或汇合在等一条永远不来的分支。** `joinReady` 按并行汇合写(全部责任分支收敛才放行), 可 G2J 是异或 —— 两条分支互斥、结构上只来一条。于是「不需要寻源」这条路上永远在等 A3。最坑的是**连死路事件都没有**:边是选中了的,只在汇合判定里被 continue 跳过, 从外面看就是 A1 办结后什么都不再发生。已改为异或汇合不等,加了三条测试。 **② 出口载荷取的是落地前的草稿值,不是落地事实。** `releaseWrite` 直接回 `draft.patch`。人的回传值天生是字符串 `"true"`,列是 boolean,PG 存的时候转了,可发出去的口里还是字符串 —— 下游活动入参校验当场拒收「/needSourcing must be boolean」,节点报 blocked, 而台账里明明是对的。改为合并后**读回来**:出口载荷与台账逐字一致,类型由列定义说了算。 **③ 审批箱按岗位码筛,无视工作组绑定。** 引擎派审批时「绑定先于策略」(ADR-011), 装了组的单实际派给被绑定的人;而收件与裁决两处都只比 `me.position.code` —— 于是「审批派给了我、我的审批箱里没有」,单子谁也看不见,流永远卡在审批点(实测)。 `toChain` 早为同一件事修过一次,这是漏的两处,一并按派单口径改。 ## 顺带 `cards.issue` 的验收分支写死 `fields: []`,而 `acceptanceWorkOrderSchema` 本来就有 `fields` —— 是没填,不是设计上不要。执行与验收现在共用同一份字段解析。我自己也踩了一个:验收步的出参映射键写成驼峰 `needSourcing`,但**键是台账列名** (小写蛇形),draftWrite 抛「非法标识符」,而且是在放行之后抛 —— 任务卡在 running、台账一行没有、推进器一秒一次无限重试。测试里加了「所有出参键必须匹配 ^[a-z][a-z0-9_]*$」。 ## 实测走到哪起单 → A1(两机器步落台账,一张验收单)→ 人填 needAlternative=false → G1 判「不需要选型」→ G2 判「不需要寻源」→ **G2J 通过** → A4 成本定价办结 → A5 审批点(审批箱可见)→ 裁决通过 → **G3 判到 A6**(链位 6/7)。 A6 的三个去向要选择组(T2),到那儿为止。 typecheck ✓ lint ✓ depcruise 374 模块 ✓ api:check ✓ 498 测试 ✓ Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
2026-07-28 13:16:17 +08:00
parent b2f5f69d6a
commit 58d914b8a2
9 changed files with 487 additions and 114 deletions
@@ -360,3 +360,47 @@ describe('joinReady —— 网关直通道不参与等待', () => {
    expect(joinReady(pkg, 'J', new Set(['X', 'Y']), new Set())).not.toBe(false);
  });
 });
+
+/*
+ * 异或汇合不等 —— 这条曾经让流无声停住。
+ *
+ * G2J(寻源汇合)是异或:「需要寻源」走 A3、「不需要」直通,两条互斥、只来一条。
+ * 而 `joinReady` 原本按并行汇合写(全部责任分支收敛才放行),于是在「不需要寻源」那条路上
+ * 永远在等 A3 —— 一个结构上不会激活的分支。症状最坑的地方是**连死路事件都没有**:
+ * 边是选中了的,只是在汇合判定里被 continue 跳过,从外面看就是 A1 办结后什么都不再发生。
+ */
+describe('joinReady —— 异或汇合只来一条,不等', () => {
+  const xor = processPackageSchema.parse({
+    id: 'p-xor-join',
+    name: '异或汇合测试',
+    version: 1,
+    state: 'active',
+    callInterface: { input: { type: 'object' }, output: { type: 'object' } },
+    nodes: [
+      { kind: 'start', id: 'S', label: '开始' },
+      { kind: 'gateway', id: 'G', label: '要不要绕', gateway: 'exclusive', mode: 'fork', basis: '判据' },
+      { kind: 'activity', id: 'X', label: 'X', activityId: 'a-x', owner: { kind: 'position', position: 'BD' } },
+      { kind: 'gateway', id: 'J', label: '汇合', gateway: 'exclusive', mode: 'join' },
+      { kind: 'end', id: 'E', label: '结束' },
+    ],
+    edges: [
+      { id: 'e1', from: 'S', to: 'G', mapping: [], reopen: false },
+      { id: 'e2', from: 'G', to: 'X', condition: 'go = true', mapping: [], reopen: false },
+      // 直通:不绕 X,从网关直接进汇合
+      { id: 'e3', from: 'G', to: 'J', condition: 'go = false', mapping: [], reopen: false },
+      { id: 'e4', from: 'X', to: 'J', mapping: [], reopen: false },
+      { id: 'e5', from: 'J', to: 'E', mapping: [], reopen: false },
+    ],
+    variables: [],
+  });
+
+  it('走直通那条:X 从未激活,汇合照样放行', () => {
+    expect(joinReady(xor, 'J', new Set(), new Set())).toBe(true);
+  });
+
+  it('走 X 那条:X 收敛后放行', () => {
+    expect(joinReady(xor, 'J', new Set(['X']), new Set())).toBe(true);
+  });
+
+  // 并行汇合「该等的还得等」由上一个 describe 的「还差一条 → 不回齐」守着,不在这儿重复
+});
@@ -100,6 +100,20 @@ export function joinReady(
  converged: ReadonlySet<string>,
  tolerated: ReadonlySet<string>,
 ): boolean {
+  const node = pkg.nodes.find((n) => n.id === joinNodeId);
+
+  /*
+   * **异或汇合不等。**
+   *
+   * 上面那句「回齐」是按并行汇合写的:AND 分叉出去的每一支都要跑,所以汇合处要等齐。
+   * 异或汇合是另一回事 —— 两条分支互斥,**结构上只会来一条**,另一条永远不激活。
+   * 拿「全部入边都收敛」去要求它,就是在等一个不可能到来的分支:
+   * 实测 G2J(寻源汇合)在「不需要寻源」这条路上永远 false,流无声停在 G2J,
+   * 而且**连死路事件都没有** —— 边是选中了的,只是在汇合判定里被 continue 跳过,
+   * 从外面看就是 A1 办结后什么都不再发生。
+   */
+  if (node?.kind === 'gateway' && node.gateway === 'exclusive') return true;
+
  const isGateway = (nodeId: string): boolean =>
    pkg.nodes.find((n) => n.id === nodeId)?.kind === 'gateway';
  const inbound = pkg.edges.filter((e) => e.to === joinNodeId && !isGateway(e.from));