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
2.0 KiB
2.0 KiB
module: flow-engine
职责: flow 范式:步序声明的装载与静态检查、四种步型的执行、条件跳步、 重试与声明给定的兜底、异步步的监听登记与事件续跑、步序位置的持久 不负责: 任务生命周期与终态裁定(见 task)、放行与落地(见 release)、 复杂路由(不得在 flow 内表达 —— 上升为流程层网关或改用 loop)
公开出口: index.ts
- 类型:
FlowEngineServiceFlowPositionStepRuntimeAdvanceOutcomeFailureActionNextAction - 错误:
FlowDeclarationInvalidError - 端口类型:
FlowStateStorePredicateEvaluatorTaskDataGatewayToolStepInvokerLlmStepGatewayCardGatewayListenerRegistrarMemoryRecorderTaskContext - 用例工厂:
createFlowRunner(deps): FlowEngineService - 纯函数:
nextActionmarkStepfailureActioncheckDeclarationinitialPositionlastStepIsAcceptanceparallelGroupComplete - 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—— 断点续跑的三份持久状态之一