M4: 范式引擎与任务运行时

skill-engine(L4):载方法不载权力(白名单外工具即拒)、结晶片段经 ToolInvoker 留痕、
  装配入信封、技能目录渐进披露

flow-engine(L5):四种步型、确定性谓词跳步、重试与声明给定的兜底、
  异步步即监听(时限必配)、写类工具登记动作意向、步序位置持久

loop-engine(L5):自研 CMMN 子集解析器(表外构件直接报错,子集封顶可机器证明)、
  两副标准生命周期与迁移拓扑(引擎不得私改)、Enabled ≠ Active、
  语义性前提标待裁量评估(引擎不代裁量)、DMN 确定性求值 + 命中行留痕、
  DRD 缺口演绎与拓扑序、双向驱动与交集导航(断点即人环)、三型行动、
  终局唯放行与 Harness

task(L6):终态五名裁定(released 唯一成功)、Harness 预算环外强制与停滞熔断
  (监听中是健康态)、控制三语义(叫停不是终态,记最重档纠正)、改派留痕通知双方、
  断点续跑三份持久状态、封卷触发蒸馏钩子

301 个测试通过,门禁五道全绿

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/CONTRACT.md

@@ -0,0 +1,31 @@
+# module: flow-engine
+
+职责:      flow 范式:步序声明的装载与静态检查、四种步型的执行、条件跳步、
+           重试与声明给定的兜底、异步步的监听登记与事件续跑、步序位置的持久
+不负责:    任务生命周期与终态裁定(见 task)、放行与落地(见 release)、
+           复杂路由(**不得在 flow 内表达** —— 上升为流程层网关或改用 loop)
+
+公开出口:  index.ts
+  - 类型:`FlowEngineService` `FlowPosition` `StepRuntime` `AdvanceOutcome` `FailureAction` `NextAction`
+  - 错误:`FlowDeclarationInvalidError`
+  - 端口类型:`FlowStateStore` `PredicateEvaluator` `TaskDataGateway` `ToolStepInvoker`
+          `LlmStepGateway` `CardGateway` `ListenerRegistrar` `MemoryRecorder` `TaskContext`
+  - 用例工厂:`createFlowRunner(deps): FlowEngineService`
+  - 纯函数:`nextAction` `markStep` `failureAction` `checkDeclaration` `initialPosition`
+          `lastStepIsAcceptance` `parallelGroupComplete`
+  - adapter:`createFlowStateStore`;Drizzle 表:`flowStateTable`
+
+层级:      L5(编码规范 §4)
+依赖:      @contracts;@shared/db;skill-engine(L4,步引用结晶片段);
+           port 注入:ledger / toolbox / llm / human-tool / event / memory
+被依赖:    task
+
+不变量(AM 05 / 12.3):
+  - **零临场调度**:下一步由 `nextAction` 从声明算出,LLM 只以「被调用的工具」出现
+  - **条件必谓词**:跳步条件经 `PredicateEvaluator`(@sfeel)确定性求值,零 LLM
+  - **失败路径声明给定**:`failureAction` 只从声明读重试次数与兜底,不临场发明
+  - **异步步 = 监听**:人类工具步登记人事件监听,**时限必配**,无死等
+  - **出参落草稿层**:步的产出是草稿态,放行前不落事实
+  - **写类工具登记为动作意向**:flow 里同样不即时触达世界(除契约显式预授权)
+  - **谱全程可静态检查**:`checkDeclaration` 不过即 `FlowDeclarationInvalidError`,不得上架
+  - 步序位置持久于 `flowStateTable` —— 断点续跑的三份持久状态之一