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
parent 2850e6d4ef
commit 3c974d2860
55 changed files with 7113 additions and 1 deletions
@@ -0,0 +1,93 @@
+/**
+ * module: loop-engine —— 本模块要外界提供的能力(编码规范 §10.1 / §5.3)。
+ */
+import type { LoopModel, StaffId, TaskId } from '@contracts';
+import type { CaseModel } from './internal/domain/cmmn-parse.ts';
+import type { CaseRuntime, EnabledSet } from './internal/domain/lifecycle.ts';
+import type { AgentAction } from './contract.ts';
+
+export type Clock = { now(): Date };
+
+/** 运行时实例状态 —— loop 的模型定位与就绪集(OS 09 三份持久状态之一) */
+export type LoopStateStore = {
+  save(taskId: TaskId, model: LoopModel, parsed: CaseModel, runtime: CaseRuntime): Promise<void>;
+  load(taskId: TaskId): Promise<{ model: LoopModel; parsed: CaseModel; runtime: CaseRuntime } | undefined>;
+};
+
+/** S-FEEL —— app 注入 `@sfeel`;引擎零 LLM */
+export type Sfeel = {
+  condition(expression: string, scope: Readonly<Record<string, unknown>>): boolean;
+  expression(expression: string, scope: Readonly<Record<string, unknown>>): unknown;
+  unaryTest(cell: string, value: unknown, scope: Readonly<Record<string, unknown>>): boolean;
+};
+
+/** 任务数据 —— app 注入 `ledger`(L1):引擎对**任务视图**求值,不依赖事件 */
+export type TaskDataGateway = {
+  view(taskId: TaskId): Promise<Record<string, unknown>>;
+  draftWrite(input: {
+    taskId: TaskId;
+    domain: string;
+    object: string;
+    key: Record<string, string | number>;
+    patch: Record<string, unknown>;
+  }): Promise<void>;
+};
+
+/**
+ * Agent 回路 —— app 注入(Mastra Agent 在 adapter,§6.1)。
+ * **回合由 usecase 驱动,不放开自由 maxSteps,预算在环外由 Harness 强制。**
+ */
+export type AgentPort = {
+  decide(input: {
+    taskId: TaskId;
+    /** 叙事面:说明书 + 活动记忆选摘 + 任务记忆窗口 */
+    narrative: string;
+    enabled: EnabledSet;
+    scope: Record<string, unknown>;
+  }): Promise<AgentAction>;
+};
+
+/** 工具 / 人类工具 / 监听 —— 三型行动的落点 */
+export type ToolGateway = {
+  invoke(input: { tool: string; input: Record<string, unknown>; activityId: string; taskId: TaskId }): Promise<{
+    ok: boolean;
+    output?: Record<string, unknown>;
+    error?: { message: string };
+  }>;
+  isWriteEffect(tool: string): Promise<boolean>;
+  registerIntent(input: { taskId: TaskId; tool: string; input: Record<string, unknown>; label: string }): Promise<void>;
+};
+
+export type CardGateway = {
+  issue(input: {
+    taskId: TaskId;
+    ownerId: StaffId;
+    humanCallCap: number;
+    workOrder: 'execution' | 'acceptance';
+    card: Record<string, unknown>;
+  }): Promise<{ id: string }>;
+};
+
+export type ListenerRegistrar = {
+  register(input: {
+    taskId: TaskId;
+    eventType: 'data' | 'time' | 'human';
+    keyFilter: Record<string, string>;
+    deadline: string;
+  }): Promise<{ id: string }>;
+};
+
+export type MemoryRecorder = {
+  append(input: {
+    taskId: TaskId;
+    kind: 'engine-transition' | 'evaluation' | 'thought' | 'action' | 'result' | 'observation';
+    title: string;
+    detail?: Record<string, unknown>;
+  }): Promise<void>;
+  /** 装载:按定位选摘活动记忆入 Agent 上下文(渐进披露) */
+  loadActivityMemory(activityId: string, limit: number): Promise<Array<{ layer: string; statement: string }>>;
+};
+
+export type TaskContext = {
+  of(taskId: TaskId): Promise<{ activityId: string; ownerId: StaffId; humanCallCap: number }>;
+};