范式退役:活动只剩一种、只跑 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
This commit is contained in:
2026-07-29 23:53:51 +08:00
co-authored by Claude Opus 5
parent 18c3e3fd09
commit 1fd215cf40
88 changed files with 1319 additions and 2966 deletions
@@ -14,7 +14,7 @@
`TemplateGuard` `Clock` `IdGenerator`
- 用例工厂:`createRegistryService(deps): ActivityRegistryService`
- 纯函数:`staticAudit` `auditPassed` `danglingListeners` `acceptanceLevelFindings`
`flowFindings` `loopFindings` `scanArtifact` `buildLoadEnvelope` `shouldSeedAsset`
`loopFindings` `scanArtifact` `buildLoadEnvelope` `shouldSeedAsset`
`canTransition` `assertTransition` `judgeReplay` `mayTakeEffect`
- adapter:`createRegistryStore`
- Drizzle 表:`activityPackageTable` `activityAssetTable` `assetIncrementTable`
@@ -4,7 +4,7 @@
* 活动库:**独立的安装与卸载入口** —— 不在编排中发生。
* 安装恒为新增、版本并存;在途任务按其启动时版本跑完,切换零丢单。
*/
import type { ActivityManifest, InstallVerdict, Paradigm, StaticAuditFinding } from '@contracts';
import type { ActivityManifest, InstallVerdict, StaticAuditFinding } from '@contracts';
import type {
AssetKind,
AssetVersion,
@@ -25,7 +25,6 @@ export type {
InstallVerdict,
LoadEnvelope,
PackageVersion,
Paradigm,
ReplayCase,
ReplayVerdict,
StaticAuditFinding,
@@ -57,7 +56,6 @@ export type ActivityCard = {
readonly activityId: string;
readonly name: string;
readonly category: string;
readonly paradigm: Paradigm;
readonly packageVersions: readonly PackageVersion[];
readonly assetVersions: readonly AssetVersion[];
readonly enabled: boolean;
@@ -36,7 +36,6 @@ export {
acceptanceLevelFindings,
auditPassed,
danglingListeners,
flowFindings,
loopFindings,
scanArtifact,
staticAudit,
@@ -13,7 +13,6 @@ export const activityPackageTable = sys.table(
version: text('version').notNull(),
name: text('name').notNull(),
category: text('category').notNull(),
paradigm: text('paradigm').notNull(),
manifest: jsonb('manifest').notNull(),
/** .JS 产物 —— 装载时由 registry 交给范式运行器(ADR-004) */
artifact: text('artifact').notNull(),
@@ -23,7 +22,7 @@ export const activityPackageTable = sys.table(
},
(t) => [
primaryKey({ columns: [t.activityId, t.version] }),
index('activity_package_category_idx').on(t.category, t.paradigm),
index('activity_package_category_idx').on(t.category),
],
);
@@ -19,7 +19,6 @@ export function createRegistryStore(db: Db): RegistryStore {
version: manifest.identity.packageVersion,
name: manifest.identity.name,
category: manifest.identity.category,
paradigm: manifest.identity.paradigm,
manifest,
artifact,
state: 'active',
@@ -78,30 +78,9 @@ export function acceptanceLevelFindings(manifest: ActivityManifest): StaticAudit
return out;
}
/** flow 判据:每步的六件齐备;复杂路由不得入 flow(AM 12.3) */
export function flowFindings(manifest: ActivityManifest): StaticAuditFinding[] {
const model = manifest.assets.businessModel;
if (model.paradigm !== 'flow') return [];
const out: StaticAuditFinding[] = [];
const names = new Set<string>();
for (const [index, step] of model.steps.entries()) {
const at = `assets.businessModel.steps[${index}]`;
if (names.has(step.name)) out.push({ code: 'schema-invalid', severity: 'error', message: `步名重复:${step.name}`, at });
names.add(step.name);
if (step.kind === 'human' && (step.deadline.trim() === '' || !DURATION.test(step.deadline))) {
out.push({ code: 'dangling-listener', severity: 'error', message: `人类工具步 ${step.name} 缺时限 —— 无死等`, at });
}
if (step.kind === 'llm' && Object.keys(step.outputSchema).length === 0) {
out.push({ code: 'schema-invalid', severity: 'error', message: `LLM 步 ${step.name} 缺出参 schema —— 模板与出参随版本冻结`, at });
}
}
return out;
}
/** loop 判据:双表示同版本,不允许分叉(AM 12.2) */
export function loopFindings(manifest: ActivityManifest): StaticAuditFinding[] {
const model = manifest.assets.businessModel;
if (model.paradigm !== 'loop') return [];
const out: StaticAuditFinding[] = [];
if (model.cmmnXml.trim() === '') {
out.push({ code: 'schema-invalid', severity: 'error', message: '案例模型缺 CMMN XML', at: 'assets.businessModel.cmmnXml' });
@@ -152,7 +131,6 @@ export function staticAudit(manifest: ActivityManifest, external: ExternalChecks
out.push(...danglingListeners(manifest));
out.push(...acceptanceLevelFindings(manifest));
out.push(...flowFindings(manifest));
out.push(...loopFindings(manifest));
return out;
@@ -138,7 +138,6 @@ export function createRegistryService(deps: RegistryServiceDeps): ActivityRegist
activityId,
name: manifest.identity.name,
category: manifest.identity.category,
paradigm: manifest.identity.paradigm,
packageVersions: versions,
assetVersions: await deps.store.listAssets(activityId),
enabled: await deps.store.enabledOf(activityId),
@@ -245,7 +244,7 @@ function serializeAsset(manifest: ActivityManifest, kind: AssetKind): string {
return JSON.stringify(manifest.assets.businessModel);
case 'dmn':
return JSON.stringify(
manifest.assets.businessModel.paradigm === 'loop' ? manifest.assets.businessModel.dmn : { drd: [], tables: [] },
manifest.assets.businessModel.dmn,
);
case 'skill':
return JSON.stringify(manifest.assets.skills);