判据 ④⑤ 解锁:G2 并行网关起出 A3 / A2 —— 输出口发射的是落地事实

G2 之后一直不分流,根因三条,逐条修:

① 输出口载荷是空的。`outputPortsOf` 原先从**作用域**里捞字段拼载荷,
   而放行那一刻草稿层已合并并清空,捞到的只剩起单入参 —— 下游节点必然缺字段。
   改为:载荷取自**落地收敛的事实**,由 `releaseWrite` 回报合并了哪些行,
   经 release → task → app 一路带上来。这也正是「落地收敛,输出口才发射」的字面意思:
   发射的就该是已经落地的那些事实。
   `LandedFacts` 给两种读法:铺平(标量取值)与逐行(数组取值),
   输出口声明里 `type: 'array'` 的属性填逐行,标量属性填铺平值(驼峰/下划线两种写法都认)。

② 一条分支起不来,把整条终态上报连坐掀翻 —— 于是**上游任务的终态也报不上去**,
   流停在原地,一行日志都没有。改为:该分支记 `node-start-failed` 事件 + 落一个
   blocked 实例,其余分支照走,在治理台「需处置」里现形。
   (这条是先修的:正因为它,前面两条才一直查不出来。)

③ 边映射引用了不存在的路径:`G2→A3` 的 pn 取 `intake.records`(那是想象中的 LLM 出参形状)、
   `G2J→A4` 的 records 取 `initiation.records`(起单时根本还没有这些行)。
   按输出口的真实声明改正。

结果:A1 released → G2 并行分叉 → **A3 渠道寻源落到林佩萱、A2 替代选型落到王梓名**,
两个 loop 活动同时在跑,岗位解析正确。

gates: tsc / eslint / depcruise(317 模块)/ api-report / 393 测试 全绿

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
This commit is contained in:
2026-07-27 04:52:53 +08:00
co-authored by Claude Opus 5
parent 1721bcf6e3
commit 9de33a5416
22 changed files with 223 additions and 35 deletions
+6 -4
View File
@@ -247,7 +247,7 @@ export async function seedQuote(container: Container): Promise<void> {
to: 'A3',
label: 'TYPE-B 转寻源',
mapping: [
{ target: 'pn', source: { from: 'output-port', port: 'intake', path: 'records' } },
{ target: 'pn', source: { from: 'output-port', port: 'intake', path: 'pn' } },
{ target: 'scenario', source: { from: 'constant', value: 'BOM后期' } },
],
reopen: false,
@@ -257,7 +257,7 @@ export async function seedQuote(container: Container): Promise<void> {
from: 'G2',
to: 'A2',
label: 'TYPE-C 转选型',
mapping: [{ target: 'originalPn', source: { from: 'output-port', port: 'intake', path: 'records' } }],
mapping: [{ target: 'originalPn', source: { from: 'output-port', port: 'intake', path: 'pn' } }],
reopen: false,
},
@@ -270,7 +270,8 @@ export async function seedQuote(container: Container): Promise<void> {
to: 'A4',
mapping: [
{ target: 'customerCode', source: { from: 'initiation', path: 'customerCode' } },
{ target: 'records', source: { from: 'initiation', path: 'records' } },
// records 来自 A1 的输出口(受理归一的产物),不是起单入参 —— 起单时还没有这些行
{ target: 'records', source: { from: 'output-port', port: 'intake', path: 'records' } },
],
reopen: false,
},
@@ -299,7 +300,8 @@ export async function seedQuote(container: Container): Promise<void> {
label: '有异议 → 返回调整',
mapping: [
{ target: 'customerCode', source: { from: 'initiation', path: 'customerCode' } },
{ target: 'records', source: { from: 'initiation', path: 'records' } },
// records 来自 A1 的输出口(受理归一的产物),不是起单入参 —— 起单时还没有这些行
{ target: 'records', source: { from: 'output-port', port: 'intake', path: 'records' } },
],
reopen: true,
},
+41 -13
View File
@@ -4,6 +4,7 @@
* 这里把 M4/M5 的模块用**端口**接起来:跨层协作一律经端口,模块之间不互相认识。
*/
import type { Db } from '@shared/db.ts';
import type { LandedFacts } from '@modules/task';
import type { EventService } from '@modules/event';
import type { LedgerService } from '@modules/ledger';
import type { MemoryService } from '@modules/memory';
@@ -339,19 +340,36 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
*/
const processRef = createDeferredProcess();
/** 任务的输出口载荷:活动声明的必交付输出口 → 该任务视图上的字段 */
async function outputPortsOf(taskId: TaskId): Promise<Record<string, Record<string, unknown>>> {
const task = await taskStore.get(taskId);
if (task === undefined) return {};
const manifest = await deps.registry.manifestOf(task.activityId);
const scope = await taskData.view(taskId);
/**
* 任务的输出口载荷。
*
* 载荷来自**落地收敛的事实**(`facts`),不是从作用域里再捞一遍:
* 放行那一刻草稿层已合并并清空,此时再捞只剩起单入参,下游节点会因缺字段起不来。
* 输出口声明的属性名与台账列名可能不同形(驼峰 / 下划线),两种写法都认。
*/
function outputPortsOf(
manifest: { contract: { output: { mandatory: ReadonlyArray<{ name: string; payload: unknown }> } } },
landed: LandedFacts,
): Record<string, Record<string, unknown>> {
const snake = (name: string): string => name.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
const ports: Record<string, Record<string, unknown>> = {};
for (const port of manifest.contract.output.mandatory) {
const payload = port.payload as { properties?: Record<string, unknown> };
const fields = Object.keys(payload.properties ?? {});
ports[port.name] = Object.fromEntries(
fields.filter((f) => scope[f] !== undefined).map((f) => [f, scope[f]]),
);
const payload = port.payload as { properties?: Record<string, { type?: string }> };
const declared = Object.entries(payload.properties ?? {});
const picked: Record<string, unknown> = {};
for (const [field, spec] of declared) {
// 数组属性 = 这一单落地的那些行(逐行的键 + 值);标量属性 = 铺平后的事实
if (spec.type === 'array') {
picked[field] = landed.rows.map((r) => ({ ...r.key, ...r.values }));
continue;
}
const value = landed.flat[field] ?? landed.flat[snake(field)];
if (value !== undefined) picked[field] = value;
}
// 声明之外的落地事实一并带上:边映射也可能直接引用台账列名
ports[port.name] = { ...landed.flat, ...picked };
}
return ports;
}
@@ -421,6 +439,14 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
converged: outcome.verdict.kind === 'converged',
emittedPorts: outcome.emittedPorts,
ledgerRowsMerged: outcome.ledgerRowsMerged,
// 输出口载荷 = 已落地的事实:铺平供标量取值,逐行供数组取值
facts: {
flat: outcome.merged.reduce<Record<string, unknown>>(
(acc, row) => ({ ...acc, ...row.key, ...row.values }),
{},
),
rows: outcome.merged.map((r) => ({ key: r.key, values: r.values })),
},
};
},
},
@@ -449,7 +475,7 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
source: { kind: 'governance' },
});
},
publishTerminal: async (taskId, terminal, reason) => {
publishTerminal: async (taskId, terminal, reason, facts) => {
await deps.event.publish({
type: 'data',
correlation: { target: { kind: 'task', id: taskId }, cause: { kind: 'engine', ref: 'terminal' }, keys: { terminal } },
@@ -466,7 +492,9 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
* 流就停在那个节点上,既不流转也不走失败走向。
* 用延后绑定是因为 process 在本函数里晚于 task 构造。
*/
const ports = await outputPortsOf(taskId);
const task = await taskStore.get(taskId);
const manifest = task === undefined ? undefined : await deps.registry.manifestOf(task.activityId);
const ports = manifest === undefined ? {} : outputPortsOf(manifest, facts);
await processRef.onTaskTerminal(taskId, terminal, ports);
},
},