范式退役:活动只剩一种、只跑 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

apps/api/src/app/seed-mvp-slots.ts

@@ -7,10 +7,11 @@
  *
  * 实现待底座完备后逐个开发:届时以新包版本经安装通道换入,槽位契约不动。
  *
- * **占位期六个槽位一律 `flow` 范式**(2026-07-28):A2/A3/A6 本该是案例活动(loop),
- * 但 loop 由 Agent 每拍决策、要真调模型;占位本身就是固定序列,声明成 flow 才诚实。
- * 真开发它们为案例活动时,以新包版本装回 `paradigm: 'loop'`,那时按 CMMN + DMN 重写业务模型
- * —— 所以这里不留一份没人用的 loop 骨架占地方。
+ * **2026-07-29:活动不再分范式,一律案例模型**(用户定)。flow 那一路连同 flow-engine
+ * 整个退役,所以占位骨架也从「机器步落台账 + 一张验收单」改成**案例骨架**:
+ * 一个「办理」阶段挂着 SOP 每一件事(全部人工激活)+ 一张收口验收。
+ * 代价写在明处:案例由 Agent 每拍决策,**没有模型可用时占位活动一步也走不动** ——
+ * 这是范式统一的直接后果,不是缺陷;真实现时以新包版本换入真案例模型。
  */
 import { createHash } from 'node:crypto';
 import { activityManifestSchema } from '@contracts';
@@ -29,220 +30,63 @@ export const SLOT_ARTIFACT = [
 
 const checksum = createHash('sha256').update(SLOT_ARTIFACT).digest('hex');
 
-/** 一步机器落地:调占位工具,把它的出参按映射落成台账的一行 */
-type Landing = {
-  /** 人读的步名 */
-  readonly label: string;
-  readonly domain: string;
-  readonly object: string;
-  /** 主键列 → 取值路径(占位工具出参的键,或作用域里的键) */
-  readonly key: Readonly<Record<string, string>>;
-  /** 业务列 → 取值路径 */
-  readonly fields: Readonly<Record<string, string>>;
-};
-
 /**
- * 占位期的业务模型骨架 —— **机器步落地 + 一张验收单要人签**。
+ * 占位期的业务模型骨架 —— **案例骨架**:SOP 的每件事一个人工任务,末尾一张收口验收。
  *
- * 为什么是这个形状:
+ * 为什么全部 `manualActivationRule`:这些事都触达世界(问客户、查外部、写台账),
+ * AM 4.1 原理一说得明白 —— 触达世界的项 Enabled ≠ Active,要人按一下才动。
+ * 占位期尤其如此:占位不替活动做任何判断,它连「该不该做这件事」都不替人定。
  *
- * ① **必须写台账**。出口载荷只从落地事实推导(数组字段 ← 这一单的落地行,
- *    标量字段 ← 落地行铺平后的值)。不写台账就发不出口 → 下游网关没有判据 →
- *    一条边都选不中 → 流无声停在第一个活动(实测过,并有 route-dead-end 事件写明缺哪个键)。
- *
- * ② **末步必须是验收工单**。`flow-runner` 写死了 `released = 末步是验收 && 裁决通过` ——
- *    末步不是验收,活动永远不 release:人把前面的单都答完,任务却停在 `awaiting-human`,
- *    没有待答工单也没有待答卡,**等人却没东西给人答**(实测)。
- *
- * ③ **占位不替活动做判断**。落的值来自占位工具,它只穿透上游给的值、给显眼的默认,
- *    行上写 `status: '占位'`。打标、定价、比价那些是活动自己的内容,真实现时整段换掉。
- *
- * ④ **验收单可以改写落地值**。人类步的回传值同样经 `writeOutput` 落台账(flow-runner 的
- *    resume 路径),步序在后、后写赢 —— 占位期要走哪个分支,在验收时说,不必改代码。
- *
- * 一步只写**一行**(`writeOutput` 每步一次 draftWrite),所以要几行就给几个 landing。
+ * 收口验收单是活动 release 的唯一出口:没有它,人把前面的事都办完,任务仍不结案。
  */
-const placeholderSkeleton = (
-  sop: readonly string[],
-  landings: readonly Landing[],
-  /** 台账列名 → 回传字段名 */
-  ask: Readonly<Record<string, string>>,
-) => {
-  const total = landings.length + 1;
-  const failure = { retry: { times: 0, backoff: 'PT30S' }, fallback: { kind: 'blocked' as const } };
-  const source = { k: '来源', v: '活动槽位占位产出(不做业务判断;真实现时整段换掉)' };
-
-  const machine = landings.map((l, i) => ({
-    name: `S${i + 1}`,
-    label: l.label,
-    /* 入参映射:占位工具要的键从任务数据取 —— 上游给了就穿过去 */
-    input: {
-      rfqRef: 'rfqRef',
-      customerCode: 'customerCode',
-      pn: 'pn',
-      quotedAt: 'quotedAt',
-      needAlternative: 'needAlternative',
-      needSourcing: 'needSourcing',
-    },
-    kind: 'pure-tool' as const,
-    tool: 'slot.placeholder',
-    output: { domain: l.domain, object: l.object, key: l.key, fields: l.fields },
-    failure,
-  }));
-
+const placeholderSkeleton = (sop: readonly string[], name: string) => {
+  const items = sop
+    .map(
+      (label, i) =>
+        `      <humanTask id="T${i + 1}" name="${label}">\n` +
+        `        <itemControl><manualActivationRule id="m${i + 1}"/></itemControl>\n` +
+        `      </humanTask>`,
+    )
+    .join('\n');
   return {
-    paradigm: 'flow' as const,
-    steps: [
-      ...machine,
-      {
-        name: `S${total}`,
-        label: '收口验收',
-        input: {},
-        kind: 'human' as const,
-        workOrder: 'acceptance' as const,
-        card: {
-          title: '收口验收',
-          /*
-           * 卡面要人填的正是**这个活动该产出、而占位产不出**的判断值(如两枚去向旗)。
-           * 填了就覆盖占位行的同一列 —— 于是下游网关判的是人的决定,不是占位的默认。
-           */
-          ...(Object.keys(ask).length === 0 ? {} : { fields: Object.values(ask) }),
-          basis: [
-            { k: '步序', v: `第 ${total} 步 / 共 ${total} 步(收口)` },
-            { k: '作业指导书', v: sop.join(' · ') },
-            { k: '占位落地', v: landings.map((l) => `${l.domain}.${l.object}`).join('、') },
-            source,
-          ],
-        },
-        /* 验收也要把值落回同一行:人填的覆盖占位的 */
-        ...(landings[landings.length - 1] === undefined
-          ? {}
-          : {
-              output: {
-                domain: landings[landings.length - 1]!.domain,
-                object: landings[landings.length - 1]!.object,
-                key: landings[landings.length - 1]!.key,
-                fields: ask,
-              },
-            }),
-        deadline: 'P1D',
-        failure,
-      },
-    ],
-    parallelGroups: [],
+    cmmnXml:
+      `<?xml version="1.0" encoding="UTF-8"?>\n` +
+      `<definitions xmlns="http://www.omg.org/spec/CMMN/20151109/MODEL">\n` +
+      `  <case id="slot">\n` +
+      `    <caseFileModel>\n` +
+      `      <caseFileItem id="input" name="调用入参"/>\n` +
+      `      <caseFileItem id="draft" name="草稿台账"/>\n` +
+      `    </caseFileModel>\n` +
+      `    <casePlanModel id="plan" name="${name}" autoComplete="true">\n` +
+      `      <sentry id="s_in">\n` +
+      `        <onPart id="op_in" caseFileItemRef="input"><standardEvent>create</standardEvent></onPart>\n` +
+      `      </sentry>\n` +
+      `      <stage id="S1" name="办理" autoComplete="true">\n` +
+      `        <entryCriterion id="ec_s1" sentryRef="s_in"/>\n` +
+      items.replace(/^ {6}/gm, '        ') +
+      `\n      </stage>\n` +
+      `      <milestone id="M_done" name="事已办完"/>\n` +
+      `      <humanTask id="T_release" name="收口验收">\n` +
+      `        <itemControl><manualActivationRule id="m_rel"/></itemControl>\n` +
+      `      </humanTask>\n` +
+      `      <timerEventListener id="TL_half" name="时限过半">\n` +
+      `        <timerExpression>PT12H</timerExpression>\n` +
+      `      </timerEventListener>\n` +
+      `    </casePlanModel>\n` +
+      `  </case>\n` +
+      `</definitions>`,
+    narrative:
+      `§0 开案:${name}的**契约已就绪、实现留白**。这份说明书是槽位占位,不是业务方法 ——\n` +
+      `它只交代这件事按 MVP 文档分几步办(${sop.join(' → ')}),不替活动做任何判断。\n\n` +
+      `办理:每一件事都要人按一下才动(触达世界的项恒需人工激活)。\n` +
+      `占位期没有自动步:占位若替人落一行台账,下游读到的就是一个编出来的事实。\n\n` +
+      `§Z 结案:事办完、收口验收签字放行即结案。真实现时以新包版本换入真案例模型,\n` +
+      `这份说明书连同 CMMN 一并被替换 —— 契约面不动。`,
+    dmn: { drd: [], tables: [] },
   };
 };
 
-
-/**
- * 各活动占位期要落的台账行 —— 按各自契约出口的必填字段倒推。
- *
- * 数组字段(records / rows / floors)由「这一单的全部落地行」整体构成,所以只要有行就有值;
- * 标量字段必须有**对应的列**才取得到 —— 这就是为什么 A1/A2 要落「受理结论」那一行。
- * 一步一行,所以列在这里的条数就是机器步的步数。
- */
-const LANDINGS: Readonly<Record<string, readonly Landing[]>> = {
-  'rfq-intake': [
-    {
-      label: '落统一受理记录',
-      domain: 'project',
-      object: 'intake_record',
-      key: { customer_code: 'customerCode', pn: 'pn' },
-      fields: { status: 'status' },
-    },
-    {
-      // 两枚去向旗落这一行:一单一行,G1/G2 读同一个值(挂按料号分的行会 last-write-wins)
-      label: '落受理结论(去向旗)',
-      domain: 'project',
-      object: 'intake_verdict',
-      key: { rfq_ref: 'rfqRef' },
-      fields: { need_alternative: 'needAlternative', need_sourcing: 'needSourcing', status: 'status' },
-    },
-  ],
-  'alt-selection': [
-    {
-      label: '落替代对标表',
-      domain: 'project',
-      object: 'alt_benchmark',
-      key: { original_pn: 'pn', candidate_pn: 'pn' },
-      fields: { alt_grade: 'status' },
-    },
-    {
-      // A2 回写**同一行**的 needSourcing —— 去向只有一个出处,不复制
-      label: '回写受理结论(是否还要寻源)',
-      domain: 'project',
-      object: 'intake_verdict',
-      key: { rfq_ref: 'rfqRef' },
-      fields: { need_sourcing: 'needSourcing', status: 'status' },
-    },
-  ],
-  'sourcing-inquiry': [
-    {
-      label: '落寻源比价表',
-      domain: 'project',
-      object: 'sourcing_compare',
-      key: { pn: 'pn', supplier: 'supplier' },
-      fields: { quote_price: 'quotePrice', verdict: 'status' },
-    },
-    {
-      label: '落供应商底价表',
-      domain: 'project',
-      object: 'supplier_floor',
-      key: { pn: 'pn', supplier: 'supplier' },
-      fields: { floor_price: 'floorPrice' },
-    },
-  ],
-  'cost-pricing': [
-    {
-      label: '落报价草案',
-      domain: 'project',
-      object: 'quote_draft',
-      key: { pn: 'pn' },
-      fields: { proposed_price: 'proposedPrice' },
-    },
-  ],
-  'quote-negotiation': [
-    {
-      label: '落正式报价单',
-      domain: 'project',
-      object: 'formal_quote',
-      key: { pn: 'pn' },
-      fields: { unit_price_cny: 'unitPrice' },
-    },
-  ],
-  'intel-archive': [
-    {
-      label: '落报价落地率统计',
-      domain: 'project',
-      object: 'landing_stats',
-      key: { period: 'period' },
-      fields: { landing_rate: 'landingRate' },
-    },
-  ],
-};
-
-/**
- * 验收单要人填的值 —— **这个活动该产出、而占位产不出的判断**。
- * 填了就覆盖占位行的同一列,下游网关判的是人的决定。
- * A6 的三个去向不在这儿:那是选择组(恰发一口),由放行时选口给出。
- *
- * 形状是「**台账列名 → 回传字段名**」,两边不能混:
- * 列名必须是小写蛇形(台账的标识符闸是 `^[a-z][a-z0-9_]*$`),
- * 回传字段名是卡面表单的键、跟着活动契约的驼峰走。
- * 我把这两个搞混过一次:`fields: { needSourcing: 'needSourcing' }` 直接把驼峰当列名,
- * draftWrite 抛「非法标识符:needSourcing」,而且是在放行之后抛 —— 任务卡在 running、
- * 台账一行没有,推进器还在一秒一次地重试。
- */
-const ASK: Readonly<Record<string, Readonly<Record<string, string>>>> = {
-  'rfq-intake': { need_alternative: 'needAlternative', need_sourcing: 'needSourcing' },
-  'alt-selection': { need_sourcing: 'needSourcing' },
-  'sourcing-inquiry': {},
-  'cost-pricing': {},
-  'quote-negotiation': {},
-  'intel-archive': {},
-};
-
-const identity = (activityId: string, name: string, paradigm: 'flow' | 'loop') => ({
+const identity = (activityId: string, name: string) => ({
   activityId,
   name,
   /*
@@ -264,11 +108,12 @@ const identity = (activityId: string, name: string, paradigm: 'flow' | 'loop') =
    * 0.7.0:A6 的三个去向改**选择组**(契约 0.2.0)—— outcome 由放行选口给出,G4 才判得了。
    * 0.8.0:对齐 Mastra 数据流 —— A2 的入参 `material` 更名 `pn`(它就是 PN):
    *   边不再带映射,数据按字段名流动,上游发的名就得是下游收的名。
+   * 0.9.0:范式统一(用户定)—— 业务模型从步序声明改为**案例模型**,
+   *   身份里的 `paradigm` 字段随之消失;占位不再自动落台账。
    * 在途任务按启动时版本跑完,不受影响。
    */
-  packageVersion: '0.8.0',
+  packageVersion: '0.9.0',
   category: '统一报价',
-  paradigm,
   sdkVersion: '0.1.0-m5',
   checksum,
 });
@@ -321,7 +166,7 @@ const authorizationFor = () => ({
 export const MVP_SLOTS: readonly ActivityManifest[] = [
   /* ── A1 客户RFQ受理(SOP · BD) ──────────────────────────────────── */
   activityManifestSchema.parse({
-    identity: identity('rfq-intake', '客户RFQ受理', 'flow'),
+    identity: identity('rfq-intake', '客户RFQ受理'),
     contract: {
       activityId: 'rfq-intake',
       version: '0.1.0',
@@ -381,7 +226,7 @@ export const MVP_SLOTS: readonly ActivityManifest[] = [
       ]),
     },
     assets: {
-      businessModel: placeholderSkeleton(STEPS.rfqIntake, LANDINGS['rfq-intake']!, ASK['rfq-intake']!),
+      businessModel: placeholderSkeleton(STEPS.rfqIntake, '客户RFQ受理'),
       skills: [],
       viewTemplates: [],
       cardSchemas: {},
@@ -399,7 +244,7 @@ export const MVP_SLOTS: readonly ActivityManifest[] = [
 
   /* ── A2 替代选型(Case · FAE) ──────────────────────────────────── */
   activityManifestSchema.parse({
-    identity: identity('alt-selection', '替代选型', 'flow'),
+    identity: identity('alt-selection', '替代选型'),
     contract: {
       activityId: 'alt-selection',
       // 0.3.0:material 更名 pn(对齐 Mastra 名流动 —— 上游 A1 发的就是 pn)
@@ -456,7 +301,7 @@ export const MVP_SLOTS: readonly ActivityManifest[] = [
       ]),
     },
     assets: {
-      businessModel: placeholderSkeleton(STEPS.altSelection, LANDINGS['alt-selection']!, ASK['alt-selection']!),
+      businessModel: placeholderSkeleton(STEPS.altSelection, '替代选型'),
       skills: [],
       viewTemplates: [],
       cardSchemas: {},
@@ -474,7 +319,7 @@ export const MVP_SLOTS: readonly ActivityManifest[] = [
 
   /* ── A3 寻源询价(Case · PRM) ──────────────────────────────────── */
   activityManifestSchema.parse({
-    identity: identity('sourcing-inquiry', '寻源询价', 'flow'),
+    identity: identity('sourcing-inquiry', '寻源询价'),
     contract: {
       activityId: 'sourcing-inquiry',
       version: '0.1.0',
@@ -529,7 +374,7 @@ export const MVP_SLOTS: readonly ActivityManifest[] = [
       ]),
     },
     assets: {
-      businessModel: placeholderSkeleton(STEPS.sourcingInquiry, LANDINGS['sourcing-inquiry']!, ASK['sourcing-inquiry']!),
+      businessModel: placeholderSkeleton(STEPS.sourcingInquiry, '渠道寻源'),
       skills: [],
       viewTemplates: [],
       cardSchemas: {},
@@ -547,7 +392,7 @@ export const MVP_SLOTS: readonly ActivityManifest[] = [
 
   /* ── A4 成本定价(SOP · BD) ────────────────────────────────────── */
   activityManifestSchema.parse({
-    identity: identity('cost-pricing', '成本定价', 'flow'),
+    identity: identity('cost-pricing', '成本定价'),
     contract: {
       activityId: 'cost-pricing',
       version: '0.1.0',
@@ -590,7 +435,7 @@ export const MVP_SLOTS: readonly ActivityManifest[] = [
       ledger: declarationsFor(['intel.history_price', 'customer.profile', 'project.quote_draft']),
     },
     assets: {
-      businessModel: placeholderSkeleton(STEPS.costPricing, LANDINGS['cost-pricing']!, ASK['cost-pricing']!),
+      businessModel: placeholderSkeleton(STEPS.costPricing, '成本定价'),
       skills: [],
       viewTemplates: [],
       cardSchemas: {},
@@ -608,7 +453,7 @@ export const MVP_SLOTS: readonly ActivityManifest[] = [
 
   /* ── A6 报价议价(Case · BD) ───────────────────────────────────── */
   activityManifestSchema.parse({
-    identity: identity('quote-negotiation', '报价议价', 'flow'),
+    identity: identity('quote-negotiation', '报价议价'),
     contract: {
       activityId: 'quote-negotiation',
       version: '0.2.0',
@@ -670,7 +515,7 @@ export const MVP_SLOTS: readonly ActivityManifest[] = [
       ledger: declarationsFor(['project.formal_quote', 'project.followup']),
     },
     assets: {
-      businessModel: placeholderSkeleton(STEPS.quoteNegotiation, LANDINGS['quote-negotiation']!, ASK['quote-negotiation']!),
+      businessModel: placeholderSkeleton(STEPS.quoteNegotiation, '报价议价'),
       skills: [],
       viewTemplates: [],
       cardSchemas: {},
@@ -688,7 +533,7 @@ export const MVP_SLOTS: readonly ActivityManifest[] = [
 
   /* ── A7 情报归档(SOP · BD) ────────────────────────────────────── */
   activityManifestSchema.parse({
-    identity: identity('intel-archive', '情报归档', 'flow'),
+    identity: identity('intel-archive', '情报归档'),
     contract: {
       activityId: 'intel-archive',
       version: '0.1.0',
@@ -731,7 +576,7 @@ export const MVP_SLOTS: readonly ActivityManifest[] = [
       ledger: declarationsFor(['intel.history_price', 'customer.profile', 'project.landing_stats']),
     },
     assets: {
-      businessModel: placeholderSkeleton(STEPS.intelArchive, LANDINGS['intel-archive']!, ASK['intel-archive']!),
+      businessModel: placeholderSkeleton(STEPS.intelArchive, '情报归档'),
       skills: [],
       viewTemplates: [],
       cardSchemas: {},
@@ -750,7 +595,7 @@ export const MVP_SLOTS: readonly ActivityManifest[] = [
 
 export async function installSlots(container: Container): Promise<void> {
   for (const manifest of MVP_SLOTS) {
-    const { activityId, packageVersion, name, paradigm } = manifest.identity;
+    const { activityId, packageVersion, name } = manifest.identity;
 
     /*
      * 先问库里有没有这一版 —— 因为「安装恒为新增、版本并存」:同版再装是 no-op,
@@ -765,7 +610,7 @@ export async function installSlots(container: Container): Promise<void> {
     const verdict = await container.registry.install(manifest, SLOT_ARTIFACT);
     const errors = verdict.staticFindings.filter((finding) => finding.severity === 'error');
     process.stdout.write(
-      `   槽位 ${name}(${paradigm})${already ? ` v${packageVersion} 已在库,未改动 —— 要换内容请升包版` : ` v${packageVersion} 已装`}` +
+      `   槽位 ${name}${already ? ` v${packageVersion} 已在库,未改动 —— 要换内容请升包版` : ` v${packageVersion} 已装`}` +
         ` · 静态审 ${verdict.staticFindings.length} 条` +
         (errors.length > 0 ? ` —— ERROR: ${errors.map((e) => e.message).join('; ')}` : '') +
         '\n',