M5/M6 修复串:判据 ③ 全链路跑通 —— 六处「声明与引擎对不上」

判据 ③ 现在从入站到 released 一路走通:步序推进 → LLM 步(密钥是占位符,
按声明降级为人兜底)→ 台账草稿层 → D1 条件跳步 → S4 工具 → S5 DMN 三分类
(LM358DR → Type A · 直接快答)→ 验收放行 → 草稿合并正式版 2 行 → 输出口
intake 发射 → 终态 released。

沿路修掉的六处,每一处都是「声明是这么写的,引擎不这么读」:

1. 人兜底卡只问一个笼统「结果」框 → 改问**这一步声明的出参字段**。
   出参契约属于步、不属于执行者:同一步谁做完,落进作用域的形状都得一样。
2. 人事件的载荷是回传协议壳 `{mode,workOrderId,values}`,
   引擎把整个壳当出参写 → 取 `values`。
3. 引擎作用域是 `{'域.对象': 行数组}`,而所有活动的步声明写的都是裸字段名 →
   任务视图三层铺开:起单入参在底、各对象最新行的字段铺顶层、地址式整表保留。
4. 起单入参从不落库、也进不了作用域 → task 存 `input_data`,断点续跑后仍在。
5. 步出参无法声明**写哪一行** → 出参加 `key`(主键列 → 作用域路径);
   六个活动包的每处出参补上键。台账几乎都有主键,不声明键就只能写无主键行。
6. `tick` 不处理 `finished`:谱走完仍按 running 一拍拍推,把预算烧到 exhausted,
   把「没人裁」误报成「跑爆了」→ 放行通过则落地收敛后 released;未放行则挂起等人。
   `flow.advance` 据末步验收裁决报 released —— **完成只出自放行通过**。

另两处装配缺口:
  · `release.land()` 实现完整却无人调用 —— 放行后从不落地。经 LandingGateway 接上。
  · `process.onTaskTerminal()` 实现完整却无人调用 —— 任务终态报不到流程层,
    流就停在那个节点上,既不流转也不走失败走向。task 在 L6 不得反向依赖 L7,
    这一跳由 app 缝合(延后绑定,同 container 里 TriggerMatcher 的手法)。

还有一处版本化缺陷:资产播种恒用 v1,`shouldSeedAsset` 一比就跳过 ——
只有**第一个**包版本的资产此生有效,之后装什么都跑旧的。改为播下一版;
进化管线放行出的更高版仍不被盖过;同版重复安装不再播种。

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

apps/api/src/modules/flow-engine/internal/domain/step-sequence.ts

@@ -17,6 +17,8 @@ export type StepRuntime = {
   readonly attempt: number;
   readonly output?: Record<string, unknown>;
   readonly error?: string;
+  /** 验收工单的放行裁决:pass / 驳回类别 —— 末步据此定终局 */
+  readonly verdict?: string;
 };
 
 export type FlowPosition = {
@@ -121,3 +123,25 @@ export function parallelGroupComplete(position: FlowPosition, members: readonly
     return runtime?.state === 'done' || runtime?.state === 'skipped';
   });
 }
+
+/**
+ * 人兜底时要回填的字段 —— 取自这一步**声明的出参**。
+ *
+ * 出参契约属于**步**,不属于执行者:同一步无论由 LLM、工具还是人做完,
+ * 落进作用域的形状必须一致。若兜底卡只给一个笼统的「结果」文本框,
+ * 人填了也落不进去 —— 下游按 `output.fields` 取值,取不到就在下一步崩。
+ *
+ * 返回键名数组,与 human 步的 `card.fields` 同形:卡的渲染只有一套。
+ */
+export function fallbackFields(step: FlowStep): readonly string[] {
+  return step.output === undefined ? [] : Object.values(step.output.fields);
+}
+
+/**
+ * 末步的放行裁决是否「通过」—— **完成只出自放行通过**(OS 05)。
+ * 驳回(重做 / 迭代)不是完成:谱虽走完,任务不得进 released。
+ */
+export function lastVerdictPassed(position: FlowPosition): boolean {
+  const last = position.steps[position.steps.length - 1];
+  return last?.verdict === 'pass';
+}