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

@@ -0,0 +1,41 @@
+# module: loop-engine
+
+职责:      loop 范式:CMMN 子集解析、标准生命周期推进、前提求值与 Enabled 集发布、
+           DMN 确定性求值与命中行留痕、双向驱动(前推 × 后拉 × 交集导航)、
+           Agent 回路的回合驱动(三型行动)
+不负责:    Agent 的推理本身(经 `AgentPort`,Mastra 在 app/adapter)、放行与落地(见 release)、
+           终态命名(见 task)、活动记忆的存取(经 `MemoryRecorder`)
+
+公开出口:  index.ts
+  - 类型:`LoopEngineService` `CaseModel` `CaseRuntime` `EnabledSet` `Navigation` `AgentAction`
+          `TurnOutcome` `DecisionResult` `DecisionTrace` `Gap` `ItemState` `CaseState`
+  - 错误:`CmmnParseError` `IllegalTransitionError` `ForbiddenTerminalError`
+          `AutomaticOnWorldTouchingError`
+  - 端口类型:`LoopStateStore` `Sfeel` `TaskDataGateway` `AgentPort` `ToolGateway`
+          `CardGateway` `ListenerRegistrar` `MemoryRecorder` `TaskContext`
+  - 用例工厂:`createTurnRunner(deps): LoopEngineService`
+  - 纯函数:`parseCmmn` `parseXml` `publishEnabled` `navigate` `evaluateCriterion`
+          `transitionItem` `occur` `reenter` `autoCompleteReady` `canTransitionItem`
+          `mayCompleteCase` `mayTerminateCase` `evaluateTable` `evaluationOrder` `deduceGaps`
+  - adapter:`createLoopStateStore`;Drizzle 表:`loopStateTable`
+
+层级:      L5(编码规范 §4)
+依赖:      @contracts;@shared/db;skill-engine(L4);port 注入:@sfeel / ledger / toolbox /
+           human-tool / event / memory
+被依赖:    task
+
+不变量(AM 04 / 12.2):
+  - **CMMN 子集封顶**:`parseCmmn` 遇到表外构件**直接报错**,不静默忽略 ——
+    扩构件 = 改编码规范 §4 那一行 + 建 ADR
+  - **语义忠实**:迁移拓扑写死在 `ITEM_TRANSITIONS` / `CASE_TRANSITIONS`,
+    引擎不得私改;活动与模型不得发明状态
+  - **Enabled ≠ Active**:引擎推进到 Enabled 为止;进入 Active 永远出自 Agent 的 manualStart 并留痕
+  - **引擎零 LLM**:前提求值与 DMN 都走 `@sfeel`;语义性前提标「待裁量评估」交上层,
+    引擎**不代裁量、不代把关**
+  - **能算的不问 LLM**:DMN 输入齐备即确定性求值,同输入必同结论;命中规则行必留痕
+  - **结论不可静默覆写**:`isBindingConclusion` 标出约束性输入
+  - **三型行动**:每步行动属于且仅属于「调工具 / 调人 / 立监听」之一;
+    调人 = 立监听听人;AI 对世界只有触达(动作,落在放行)与等待(监听)两种姿势
+  - **终局唯放行与 Harness**:引擎不把案计划置 Completed —— 那是 release 的事;
+    `mayCompleteCase` 只对 release 为真,`mayTerminateCase` 只对 harness / owner / governance 为真
+  - **驳回是迁移不是状态**:`reenter` 以 repetitionRule 新实例重新入场