活动伪函数占位:机器步落台账 + 一张验收单 —— 顺手揪出三个引擎 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

apps/api/src/app/seed-mvp.ts

@@ -51,14 +51,66 @@ const MAIL_TOOL = {
   connectionKeys: ['endpoint'],
 };
 
+/**
+ * 活动槽位的占位产出 —— **编排层跑通期专用的纯工具**。
+ *
+ * 六个活动只有契约面。出口载荷只从落地事实推导,不写台账就发不出口、
+ * 网关判不了、流走不出第一个活动。这枚工具把契约要求的字段落成一行,只为让编排层能被走通。
+ * 它**不含任何业务判断**(实现见 `tools/first-party.ts` 的 `slotPlaceholder`);
+ * 真开发某个活动时,那个活动的步序整个换掉,这枚工具从它的白名单里摘掉。
+ */
+const PLACEHOLDER_TOOL = {
+  name: 'slot.placeholder',
+  version: '0.1.0',
+  description: '活动槽位占位产出:把契约要求的字段落成一行(不做业务判断;真实现后摘除)',
+  input: {
+    type: 'object',
+    properties: {
+      rfqRef: { type: 'string' },
+      customerCode: { type: 'string' },
+      pn: { type: 'string' },
+      supplier: { type: 'string' },
+      quotedAt: { type: 'string' },
+      needAlternative: { type: 'boolean' },
+      needSourcing: { type: 'boolean' },
+    },
+  },
+  output: {
+    type: 'object',
+    properties: {
+      placeholder: { type: 'boolean' },
+      status: { type: 'string' },
+      rfqRef: { type: 'string' },
+      customerCode: { type: 'string' },
+      pn: { type: 'string' },
+      supplier: { type: 'string' },
+      period: { type: 'string' },
+      needAlternative: { type: 'boolean' },
+      needSourcing: { type: 'boolean' },
+      floorPrice: { type: 'number' },
+      quotePrice: { type: 'number' },
+      proposedPrice: { type: 'number' },
+      unitPrice: { type: 'number' },
+      landingRate: { type: 'number' },
+    },
+  },
+  // 纯工具:无外效应、无连接配置 —— 同输入必同出参
+  effect: 'read' as const,
+  errors: [],
+  idempotent: true,
+  timeoutMs: 5_000,
+  retries: 0,
+  connectionKeys: [] as string[],
+};
+
 /** 白名单:逐槽位授权 —— 谁能调什么,治理台说了算,活动代码里看不到这张表 */
 const ALLOWLIST: Readonly<Record<string, readonly string[]>> = {
-  'rfq-intake': [HISTORY_TOOL.name],
-  'alt-selection': [HISTORY_TOOL.name],
-  'sourcing-inquiry': [HISTORY_TOOL.name, MAIL_TOOL.name],
-  'cost-pricing': [HISTORY_TOOL.name],
-  'quote-negotiation': [HISTORY_TOOL.name, MAIL_TOOL.name],
-  'intel-archive': [],
+  'rfq-intake': [HISTORY_TOOL.name, PLACEHOLDER_TOOL.name],
+  'alt-selection': [HISTORY_TOOL.name, PLACEHOLDER_TOOL.name],
+  'sourcing-inquiry': [HISTORY_TOOL.name, MAIL_TOOL.name, PLACEHOLDER_TOOL.name],
+  'cost-pricing': [HISTORY_TOOL.name, PLACEHOLDER_TOOL.name],
+  'quote-negotiation': [HISTORY_TOOL.name, MAIL_TOOL.name, PLACEHOLDER_TOOL.name],
+  'intel-archive': [PLACEHOLDER_TOOL.name],
 };
 
 export async function seedMvp(container: Container): Promise<void> {
@@ -88,17 +140,18 @@ export async function seedMvp(container: Container): Promise<void> {
   log('① LLM 实例已绑定:deepseek-v4-flash · deepseek-v4-pro · quote-extractor(→ flash,系统用途)');
 
   /* ② 功能工具注册两审 + 逐槽位白名单 */
-  for (const contract of [HISTORY_TOOL, MAIL_TOOL]) {
+  for (const contract of [HISTORY_TOOL, MAIL_TOOL, PLACEHOLDER_TOOL]) {
     const verdict = await container.toolbox.register({
       contract,
       samples: [
         {
-          // 样例集一份喂两件工具:并集覆盖各家必填
+          // 样例集一份喂三件工具:并集覆盖各家必填
           input: { pn: 'LM358DR', to: 'x@y.com', subject: '询价' },
           expectShape: { type: 'object' },
         },
       ],
-      connectionValues: { endpoint: 'replay://crm' },
+      // 占位工具是纯工具,没有连接目标 —— 与真工具同门过两审,但不给它端点
+      ...(contract.connectionKeys.length === 0 ? {} : { connectionValues: { endpoint: 'replay://crm' } }),
     });
     if (!verdict.accepted) {
       log('   工具 ' + contract.name + ' 未过两审:' + verdict.staticFindings.map((f) => f.message).join('; '));
@@ -107,7 +160,7 @@ export async function seedMvp(container: Container): Promise<void> {
   for (const [activityId, tools] of Object.entries(ALLOWLIST)) {
     await container.toolbox.setAllowlist(activityId, tools);
   }
-  log('② 功能工具已注册并入白名单(读类 1 · 写类 1,逐槽位授权)');
+  log('② 功能工具已注册并入白名单(读类 1 · 写类 1 · 占位纯工具 1,逐槽位授权)');
 
   /* ③ 六个活动槽位经安装通道装入 —— 声明物化把四域十八对象建出来 */
   await installSlots(container);