This repository has been archived on 2026-09-13. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
BPOS-MVP/apps/api/src/modules/flow-engine/CONTRACT.md
T
JCAI Main AgentandClaude Opus 5 3c974d2860 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
2026-07-27 01:51:22 +08:00

2.0 KiB

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 —— 断点续跑的三份持久状态之一