M5(2/3): process 用例与流转 —— 流程引擎的确定性调度

- routing domain:选边(XOR 恰取一条 + 默认分支兜底;AND 全走)、边映射装配(四类来源 +
  S-FEEL 转换)、AND 汇合回齐(容忍分支不阻汇合)、审批点驳回走向声明式
- process-service:起单 → 调度节点 → 负责人四策略解析(结果与依据留痕)→
  活动起单 / 审批点卡工位 / 终点收束按来源回执;任务终态到达继续流转或走失败走向四选一;
  审批驳回按声明回指定节点重开新实例;状态每次变动后重算聚合投影
- adapter:流程包(id × version)、工作流实例、节点实例三表持久 —— 崩溃后可续跑

ADR 待补项登记为 debt M5-1:§6.1 的 Mastra workflow 编译器作为可替换 adapter 后补,
当前由自持确定性状态机承担,语义等价、usecase 不动

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

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m

api-report/apps/api/src/modules/process/contract.d.ts

@@ -7,10 +7,48 @@
  * M5 进行中:domain 已落(闭合校验 / 四策略解析 / 状态聚合),
  * 用例与 Mastra 工作流编译随后(编码规范 §6.1)。
  */
-import type { ClosureReport, ClosureViolation, OwnerSpec, ProcessPackage, WorkflowState } from '@contracts';
+import type { ClosureReport, ClosureViolation, OwnerSpec, ProcessNode, ProcessPackage, TerminalState, WorkflowState } from '@contracts';
 import type { ActivityContractFace, ClosureInput } from './internal/domain/closure.ts';
 import type { Candidate, NodeInstance, ResolveContext, Resolution } from './internal/domain/owner-resolution.ts';
-export type { ActivityContractFace, Candidate, ClosureInput, ClosureReport, ClosureViolation, NodeInstance, OwnerSpec, ProcessPackage, ResolveContext, Resolution, WorkflowState, };
+import type { AssembleScope, Dispatch, RejectRoute } from './internal/domain/routing.ts';
+import type { WorkflowRecord } from './port.ts';
+export type { ActivityContractFace, AssembleScope, Candidate, ClosureInput, Dispatch, RejectRoute, WorkflowRecord, ClosureReport, ClosureViolation, NodeInstance, OwnerSpec, ProcessPackage, ProcessNode, ResolveContext, Resolution, TerminalState, WorkflowState, };
+/** 起单入参 —— 触发器与上游系统一律经**调用接口**调起(OS 03) */
+export type StartWorkflowInput = {
+    readonly packageId: string;
+    readonly packageVersion?: number;
+    readonly subject: string;
+    /** 凡单必有来源:触发器即来源;纪要登记起单的,登记人即来源 */
+    readonly source: {
+        kind: 'periodic' | 'event' | 'registration';
+        ref: string;
+        by?: string;
+    };
+    readonly data: Record<string, unknown>;
+};
+export type ProcessService = {
+    savePackage(pkg: ProcessPackage): Promise<ProcessPackage>;
+    listPackages(): Promise<ProcessPackage[]>;
+    getPackage(id: string, version?: number): Promise<ProcessPackage | undefined>;
+    /** 画图即校验 —— 与前端画布同源 */
+    validate(pkg: ProcessPackage): Promise<ClosureReport>;
+    /** 不闭合不得发布 */
+    publish(id: string, version: number): Promise<ClosureReport>;
+    start(input: StartWorkflowInput): Promise<WorkflowRecord>;
+    getWorkflow(id: string): Promise<WorkflowRecord>;
+    listWorkflows(limit?: number): Promise<WorkflowRecord[]>;
+    instancesOf(workflowId: string): Promise<NodeInstance[]>;
+    /** 任务终态到达:完成即继续流转;非完成即走声明的失败走向 */
+    onTaskTerminal(taskId: string, terminal: TerminalState, ports: Record<string, Record<string, unknown>>): Promise<WorkflowState | undefined>;
+    applyFailure(workflowId: string, nodeId: string, instance: number, node: Extract<ProcessNode, {
+        kind: 'activity';
+    }>, terminal: TerminalState): Promise<WorkflowState>;
+    /** 审批裁决:通过继续;驳回按声明走向回指定节点**重开新实例** */
+    onApprovalVerdict(workflowId: string, nodeId: string, verdict: 'pass' | 'reject', payload: Record<string, unknown>): Promise<WorkflowState>;
+    /** 状态是聚合投影 —— 每次变动后重算 */
+    refreshState(workflowId: string): Promise<WorkflowState>;
+    terminate(workflowId: string, reason: string): Promise<WorkflowState>;
+};
 export declare class NotPublishableError extends Error {
     readonly report: ClosureReport;
     constructor(report: ClosureReport);