范式退役:活动只剩一种、只跑 Loop;审批活动可管;活动库重做

用户定的两件,一并落地。

**一、活动不再分 flow 和 loop —— 彻底退役 flow**
  · `flow-engine` 模块整个删除(runner 379 行 + step-sequence 184 行 + 测试);
  · `paradigm` 从清单身份、`activity_package`/`task` 两张表、任务卡与活动库一并退场;
    `businessModel` 不再是判别联合 —— 只有案例模型(CMMN + 说明书 + DMN)一形;
  · task 的引擎分派从「按 paradigm 取两个之一」收成**唯一的引擎**;
  · `activities/` 四个 flow 活动(A1 受理 / A4 定价 / A6 议价 / A7 归档)各写了一份
    案例模型:阶段照原来的步分,触达世界的项一律 manualActivationRule,
    能算的交 DMN(A1 的三分类 P-03、A4 的 P-01/P-02)不交 Agent;
  · 六个占位槽位的骨架从「机器步落台账 + 一张验收单」改成案例骨架,包版本 0.8.0 → 0.9.0。

**代价写在明处,不假装没有**:`turn-runner` 每一拍都要 `agent.decide` ——
环境里没有模型 key,案例活动一步也走不动。三套端到端(统一报价 / 新建流程包 / 测试台
Trace)整套跳过,文件头写明恢复条件:①有可用模型 ②走法改写成按 Enabled 集推进。
**不许把断言改松让它变绿** —— 绿得不诚实比红着更坏。debt.md 已记。

**二、审批活动可管**(新能力)
  · `sys.approval_template`:审批点**可复用的那一半** —— 审批人看哪几项、按什么名字看、
    怎么催、说什么话。谁来审不在里面(与活动点同口径,运营时轮值);驳回回哪个节点
    也不在里面(那是每张图自己的事,留在节点上);
  · 三条路由 + 引用反查:还被审批点引着就不许删(409),删了那些节点会**静默**退回旧行为;
  · 运行时 `basisOf`:引了模板就按模板筛与改名,没引即旧行为(载荷全摊开)。
    模板改了只影响新发出的审批单 —— 在途单的依据在发出那一刻已定形。

**三、活动库重做**:一区两格 —— 「活动(装进来的)」与「审批活动(配出来的)」,
都用流程卡那套两段式卡片(头 + 四格数据板),幽灵卡当入口(装入活动 / 新建审批活动);
「标准/案例」那一维随范式一起撤,业务分类成了唯一的一维,以行内小签呈现。

迁移 0020:两张表 drop paradigm、建 approval_template。已在开发库跑过并重播种。
实测(丁子乔账号):建「定价审批」模板 → 流程包 A5 属性里选得到 → 引用反查计数正确。
四闸绿(api:check 随本提交)。

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,7 +7,7 @@
  * M5 进行中:domain 已落(闭合校验 / 四策略解析 / 状态聚合),
  * 用例与 Mastra 工作流编译随后(编码规范 §6.1)。
  */
-import type { ClosureReport, ClosureViolation, OwnerSpec, ProcessNode, ProcessPackage, TerminalState, WorkflowState } from '@contracts';
+import type { ApprovalTemplate, 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';
 import type { AssembleScope, Dispatch, RejectRoute } from './internal/domain/routing.ts';
@@ -70,6 +70,16 @@ export type ProcessService = {
         version?: number;
         name?: string;
     }): Promise<ProcessPackage[]>;
+    /** 列模板,连同「被哪些包的哪些审批点引着」 */
+    approvalTemplates(): Promise<Array<ApprovalTemplate & {
+        usedBy: Array<{
+            packageId: string;
+            nodeId: string;
+        }>;
+    }>>;
+    saveApprovalTemplate(template: ApprovalTemplate): Promise<ApprovalTemplate>;
+    /** 还被审批点引着就不许删(`TemplateInUseError`)—— 删了那些节点会静默退回旧行为 */
+    deleteApprovalTemplate(id: string): Promise<void>;
     nodeOwners(packageId: string): Promise<Record<string, string>>;
     setNodeOwner(packageId: string, nodeId: string, staffId: string | undefined): Promise<void>;
     /** 任务终态到达:完成即继续流转;非完成即走声明的失败走向 */
@@ -119,6 +129,18 @@ export declare class VersionTakenError extends Error {
     readonly version: number;
     constructor(packageId: string, version: number);
 }
+/** 模板还被审批点引着 —— 删了那些节点会静默退回「载荷全摊开」,不许悄悄改变行为 */
+export declare class TemplateInUseError extends Error {
+    readonly templateId: string;
+    readonly usedBy: ReadonlyArray<{
+        packageId: string;
+        nodeId: string;
+    }>;
+    constructor(templateId: string, usedBy: ReadonlyArray<{
+        packageId: string;
+        nodeId: string;
+    }>);
+}
 export declare class PositionVacantError extends Error {
     readonly position: string;
     constructor(position: string);

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

@@ -2,7 +2,7 @@
  * module: process —— 唯一出口。只做 re-export,不写逻辑(编码规范 §10.1)。
  */
 export type { ActivityContractFace, AssembleScope, Candidate, ClosureInput, ClosureReport, ClosureViolation, NodeInstance, OwnerSpec, ProcessPackage, ProcessService, ResolveContext, Resolution, StartWorkflowInput, WorkflowRecord, WorkflowState, } from './contract.ts';
-export { ActiveVersionError, CallInterfaceViolationError, NotClosedError, VersionTakenError, PinnedVersionError, PositionVacantError, StaleVersionError } from './contract.ts';
+export { ActiveVersionError, CallInterfaceViolationError, NotClosedError, VersionTakenError, PinnedVersionError, PositionVacantError, StaleVersionError, TemplateInUseError } from './contract.ts';
 export type { FlowRuntime, ActivityDirectory, ApprovalGateway, Clock, FlowEventPublisher, IdGenerator, OrgDirectory, ProcessStore, ReceiptNotifier, Sfeel, TaskGateway, } from './port.ts';
 export type { ProcessServiceDeps } from './internal/usecase/process-service.ts';
 export { createProcessService } from './internal/usecase/process-service.ts';

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

@@ -1,7 +1,7 @@
 /**
  * module: process —— 本模块要外界提供的能力(编码规范 §10.1 / §5.3)。
  */
-import type { ProcessNode, ProcessPackage, StaffId, TerminalState, WorkflowState } from '@contracts';
+import type { ApprovalTemplate, ProcessNode, ProcessPackage, StaffId, TerminalState, WorkflowState } from '@contracts';
 import type { NodeInstance } from './internal/domain/owner-resolution.ts';
 import type { ActivityContractFace } from './internal/domain/closure.ts';
 export type Clock = {
@@ -77,6 +77,9 @@ export type ProcessStore = {
      */
     renumberVersion(id: string, from: number, to: number): Promise<void>;
     getPackage(id: string, version?: number): Promise<ProcessPackage | undefined>;
+    listApprovalTemplates(): Promise<ApprovalTemplate[]>;
+    upsertApprovalTemplate(template: ApprovalTemplate): Promise<void>;
+    deleteApprovalTemplate(id: string): Promise<void>;
     listPackages(): Promise<ProcessPackage[]>;
     insertWorkflow(record: WorkflowRecord): Promise<void>;
     getWorkflow(id: string): Promise<WorkflowRecord | undefined>;