This repository has been archived on 2026-09-13. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
BPOS-MVP/apps/api/src/modules/activity-registry/CONTRACT.md
T
ChaiHaoandClaude Opus 5 1fd215cf40 范式退役:活动只剩一种、只跑 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
2026-07-29 23:53:51 +08:00

3.1 KiB

module: activity-registry

职责: 活动库:包清单六区的落库、安装两审(静态审 + 回放审)、包版本 × 资产版本两条序列、 两维分类、.JS 产物存取、资产版本进化管线(候选 → 回放 → 人放行 → 生效 / 回退) 不负责: .JS 的执行(见范式运行器)、工具契约与模型绑定的真身(经端口问 toolbox / llm)、 台账物化(经端口问 ledger)、模版净化的实现(经端口问 interaction)

公开出口: index.ts

  • 类型:ActivityRegistryService ActivityCard LoadEnvelope AssetVersion PackageVersion ReplayCase ReplayVerdict DependencyFile ExternalChecks
  • 错误:InstallRejectedError ActivityNotInstalledError ToolNotDeclaredError IllegalIncrementTransitionError
  • 端口类型:RegistryStore ToolContractProbe ModelBindingProbe LedgerDeclarationApplier TemplateGuard Clock IdGenerator
  • 用例工厂:createRegistryService(deps): ActivityRegistryService
  • 纯函数:staticAudit auditPassed danglingListeners acceptanceLevelFindings loopFindings scanArtifact buildLoadEnvelope shouldSeedAsset canTransition assertTransition judgeReplay mayTakeEffect
  • adapter:createRegistryStore
  • Drizzle 表:activityPackageTable activityAssetTable assetIncrementTable

层级: L4(编码规范 §4) 依赖: @contracts;@shared/db;port 注入:toolbox(L2)、llm(L1)、ledger(L1)、interaction(L3) 被依赖: loop-engine, flow-engine, skill-engine, task, process, app(治理台 · 活动库管理)

不变量(OS 11.2 / 11.3,AM 11.3):

  • 安装两审:静态审有 error 即不上架;「旧成不坏」是生效硬门, 「旧败能成」只入重演报告、不作门槛;首装无历史即免回放审
  • 悬空监听拒绝:无时限或无关联键与内容条件的监听一律拒装(AM 4.4)
  • 装不齐不上架:工具调用契约缺一即拒;模型名未绑定四元即拒
  • 活动包零环境能力:产物含 process.env / fetch( / node 核心模块 / 动态执行即拒(ADR-004)
  • 模版无脚本:含脚本或外部资源的视图模版即拒
  • 验收等级不得谎报:标为 L1/L2 却无可机检谓词即拒
  • 资产与包分离:包只携资产初始版;shouldSeedAsset 保证不覆盖已有更高资产版, 覆盖只能是显式的 rollbackAsset 治理动作
  • 进化必过治理:候选 → 回放 → 人放行,状态机不许跳过回放
  • 安装恒为新增、版本并存:卸载只置 state,在途任务按其启动时版本跑完

近变(2026-07-28):模块面未变。app 层的 GET /api/gov/activities 出参加 contract 面 (必填入参 / 入参字段 / 输出口与载荷字段 / 声明的工具·模型·域对象·岗位 / 调人预算), 由 manifestOf 逐个读清单组装。此前治理台看不到活动的契约: 编排的人引用一个活动却不知道它吃什么,边映射只能靠猜; 要开发一个活动的人也没有一处能照着看。