范式退役:活动只剩一种、只跑 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
@@ -43,7 +43,6 @@ export const manifest: ActivityManifest = {
name: 'A2 · 替代选型',
packageVersion: '0.1.2',
category: '统一报价',
paradigm: 'loop',
sdkVersion: '0.1.0-m5',
checksum: 'dev-checksum-quote-alternative',
},
@@ -159,7 +158,6 @@ export const manifest: ActivityManifest = {
assets: {
businessModel: {
paradigm: 'loop',
cmmnXml: CMMN_XML,
narrative: NARRATIVE,
dmn: GRADE_DMN,
@@ -0,0 +1,61 @@
/**
* A7 情报归档的案例模型 —— **双表示同版本**:CMMN XML(机器面)与案例说明书(叙事面)。
*
* 2026-07-29 由步序声明(flow)改写而来。归档这件事没有分支:登记结果 → 更新画像 →
* 统计落地率 → 验收。三件事互不依赖,同阶段并列(CMMN 里同阶段的项本就无隐含次序)。
*/
export const CMMN_XML = `<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/CMMN/20151109/MODEL">
<case id="archive">
<caseFileModel>
<caseFileItem id="result" name="报价结果"/>
<caseFileItem id="history" name="历史价格情报"/>
<caseFileItem id="profile" name="客户画像"/>
<caseFileItem id="stats" name="报价落地率统计"/>
</caseFileModel>
<casePlanModel id="plan" name="情报归档" autoComplete="true">
<sentry id="s_result">
<onPart id="op_rs" caseFileItemRef="result"><standardEvent>create</standardEvent></onPart>
</sentry>
<sentry id="s_logged">
<onPart id="op_lg" caseFileItemRef="history"><standardEvent>update</standardEvent></onPart>
<ifPart id="if_lg"><condition>reasonLogged = true</condition></ifPart>
</sentry>
<stage id="S1" name="回写沉淀" autoComplete="true">
<entryCriterion id="ec_s1" sentryRef="s_result"/>
<humanTask id="T_log" name="人工登记结果(拒绝原因 / 竞对价位)">
<itemControl><manualActivationRule id="m_lg"/></itemControl>
</humanTask>
<humanTask id="T_profile" name="人工更新客户画像">
<entryCriterion id="ec_pf" sentryRef="s_logged"/>
<itemControl><manualActivationRule id="m_pf"/></itemControl>
</humanTask>
<humanTask id="T_stats" name="人工统计落地率">
<itemControl><manualActivationRule id="m_st"/></itemControl>
</humanTask>
</stage>
<milestone id="M_archived" name="情报已回写"/>
<humanTask id="T_release" name="人工归档闭环验收放行">
<itemControl><manualActivationRule id="m_rl"/></itemControl>
</humanTask>
<timerEventListener id="TL_half" name="时限过半">
<timerExpression>PT12H</timerExpression>
</timerEventListener>
</casePlanModel>
</case>
</definitions>`;
export const NARRATIVE = `§0 开案:一单报价有了结果(成交 / 拒绝 / 超时)即开案。
这件事不产生对外交付,它产生的是**下一单的本钱** —— 报价落地率、客户画像、竞对价位。
S1 回写沉淀:先登记结果 —— 拒绝的要写清原因与竞对价位,**「客户没回」不是原因**,
问不出来就写「未获反馈」,不许编一个听着合理的理由。
再按结果更新客户画像标签与等级(利润模型 P-01 的客户等级因子取的就是它),
并把这一单计入当月落地率统计(TypeA 命中率、D+3 回复率一并算)。
§Z 结案:原因已回写、画像已更新、BD 签字放行,自动结案。
归档做得好不好,不在这一单看得出来 —— 在下一次报价能不能一眼看到「上次为什么丢」看得出来。`;
+5 -64
View File
@@ -6,6 +6,7 @@
*/
import type { ActivityManifest } from '@contracts';
import { ARCHIVE_SKILLS } from './skills.ts';
import { CMMN_XML, NARRATIVE } from './case-model.ts';
import { activityIdSchema } from '@contracts';
import { ARCHIVE_LOGGED, ARCHIVE_RELEASE } from './views/report.ts';
@@ -17,7 +18,6 @@ export const manifest: ActivityManifest = {
name: 'A7 · 情报归档',
packageVersion: '0.1.5',
category: '统一报价',
paradigm: 'flow',
sdkVersion: '0.1.0-m5',
checksum: 'dev-checksum-quote-archive',
},
@@ -115,70 +115,11 @@ export const manifest: ActivityManifest = {
},
assets: {
/* 资产初始版:案例模型(2026-07-29 起活动只有这一种业务模型) */
businessModel: {
paradigm: 'flow',
steps: [
{
kind: 'llm',
name: 'S1_log_result',
label: 'S1 结果登记(拒绝原因 / 竞对价位)',
input: { reason: 'reason', quoteNo: 'quoteNo' },
output: {
domain: 'shared',
object: 'history_price',
key: { pn: 'pn', quoted_at: 'quotedAt' },
fields: { lost_reason: 'lostReason' },
},
model: 'quote-extractor',
template: '从跟进反馈里抽出拒绝原因与竞对价位。只输出 JSON。反馈:{{reason}}',
outputSchema: {
type: 'object',
properties: { lostReason: { type: 'string' }, competitorPrice: { type: 'number' } },
},
view: 'archive-logged',
failure: { retry: { times: 2, backoff: 'PT30S' }, fallback: { kind: 'human', workOrder: 'execution' } },
},
{
kind: 'pure-tool',
name: 'S2_profile',
label: 'S2 画像更新(供 P-01 的客户等级因子取用)',
input: { customerCode: 'customerCode', reason: 'reason' },
output: {
domain: 'shared',
object: 'customer',
key: { customer_code: 'customerCode' },
fields: { profile_tags: 'tags' },
},
tool: 'quote-archive.profile',
failure: { retry: { times: 1, backoff: 'PT10S' }, fallback: { kind: 'blocked' } },
},
{
kind: 'pure-tool',
name: 'S3_landing_rate',
label: 'S3 落地率统计',
input: {},
output: {
domain: 'shared',
object: 'landing_stats',
key: { period: 'period' },
fields: { landing_rate: 'landingRate' },
},
tool: 'quote-archive.landing-rate',
failure: { retry: { times: 1, backoff: 'PT10S' }, fallback: { kind: 'blocked' } },
},
{
kind: 'human',
name: 'S4_release',
label: 'S4 归档闭环验收放行',
input: {},
workOrder: 'acceptance',
card: { title: '情报归档请验收', deliverable: 'history-archive' },
deadline: 'P1D',
view: 'archive-release',
failure: { retry: { times: 0, backoff: 'PT30S' }, fallback: { kind: 'blocked' } },
},
],
parallelGroups: [],
cmmnXml: CMMN_XML,
narrative: NARRATIVE,
dmn: { drd: [], tables: [] },
},
skills: ARCHIVE_SKILLS,
viewTemplates: [
@@ -5,7 +5,7 @@
*/
import { describe, expect, it } from 'vitest';
import { activityManifestSchema } from '@contracts';
import { evaluate, evaluateUnaryTest } from '@sfeel';
import { evaluateUnaryTest } from '@sfeel';
import { createMockHost } from '@sdk';
import { manifest, P03_DMN } from '../src/manifest.ts';
import activity from '../src/index.ts';
@@ -31,45 +31,40 @@ describe('清单本身合规', () => {
});
});
describe('步序声明(AM 12.3)', () => {
describe('案例模型(AM 03/12.2)—— 双表示同版本', () => {
const model = manifest.assets.businessModel;
if (model.paradigm !== 'flow') throw new Error('A1 应是 flow 范式');
const cmmn = parseCmmnLite(model.cmmnXml);
it('末步是验收工单 —— 完成只出自放行通过', () => {
expect(model.steps.at(-1)).toMatchObject({ kind: 'human', workOrder: 'acceptance' });
it('CMMN 与说明书同在,不允许分叉', () => {
expect(model.cmmnXml).toContain('<casePlanModel');
expect(model.narrative.length).toBeGreaterThan(80);
});
it('每步六件齐备:步型 / 入参映射 / 出参写入 / 完成条件 / 失败策略', () => {
for (const step of model.steps) {
expect(step.name).not.toBe('');
expect(step.failure.retry.times).toBeGreaterThanOrEqual(0);
expect(step.failure.fallback.kind).toBeDefined();
it('触达世界的项恒需人工激活(AM 4.1 原理一)', () => {
// 解析归一、追问补全、查历史价 —— 三件都碰外界,一件也不许自动跑
for (const id of ['T_normalize', 'T_ask_back', 'T_history']) {
expect(cmmn.manualActivation, `${id} 应为人工激活`).toContain(id);
}
});
it('条件跳步是任务数据上的确定性谓词,由引擎求值', () => {
const askBack = model.steps.find((s) => s.name === 'S2_ask_back');
expect(askBack?.when).toBe('missing_key_fields > 0');
// 谓词读的是**落表后的字段名** —— 作用域来自台账,不是模型出参的驼峰名
expect(evaluate(askBack!.when!, { missing_key_fields: 2 })).toBe(true);
expect(evaluate(askBack!.when!, { missing_key_fields: 0 })).toBe(false);
it('末尾一张验收单 —— 完成只出自放行通过', () => {
expect(model.cmmnXml).toContain('id="T_release"');
});
it('人类工具步都配了时限 —— 无死等', () => {
for (const step of model.steps) {
if (step.kind === 'human') expect(step.deadline).toMatch(/^P/);
}
it('能算的交 DMN,不交 Agent —— 打标是 decisionTask', () => {
expect(model.cmmnXml).toContain('decisionRef="p03-type"');
expect(P03_DMN.tables.some((t) => t.id === 'p03-type')).toBe(true);
});
});
it('LLM 步的模板与出参 schema 随声明版本冻结', () => {
const llm = model.steps.find((s) => s.kind === 'llm');
expect(llm).toBeDefined();
if (llm?.kind === 'llm') {
expect(llm.template).toContain('{{rfqRef}}');
expect(llm.outputSchema['type']).toBe('object');
/** 极小取值:只为断言用,不重实现引擎的解析器(那一份在 loop-engine 里有自己的测试) */
function parseCmmnLite(xml: string): { manualActivation: string[] } {
const ids: string[] = [];
for (const m of xml.matchAll(/<humanTask id="([^"]+)"[\s\S]*?<\/humanTask>/g)) {
if (m[0].includes('manualActivationRule')) ids.push(m[1]!);
}
return { manualActivation: ids };
}
});
});
describe('三分类规则 P-03 —— 能算的不问 LLM', () => {
const table = P03_DMN.tables[0]!;
+85
View File
@@ -0,0 +1,85 @@
/**
* A1 询价受理的案例模型 —— **双表示同版本**:CMMN XML(机器面)与案例说明书(叙事面)。
*
* 2026-07-29 由步序声明(flow)改写而来:活动不再分范式,一律案例模型 + Agent 临场调度。
* 原来的六步在这里各归其位 —— 解析归一与追问补全同属「收料归一」阶段(常来回几轮,
* 所以带 repetitionRule);查历史价与三分类打标属「定性分级」;末尾一张验收单。
*/
export const CMMN_XML = `<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/CMMN/20151109/MODEL">
<case id="intake">
<caseFileModel>
<caseFileItem id="rfq" name="询价来函"/>
<caseFileItem id="records" name="统一受理记录"/>
<caseFileItem id="history" name="历史价格情报"/>
<caseFileItem id="verdict" name="受理结论"/>
</caseFileModel>
<casePlanModel id="plan" name="询价受理" autoComplete="true">
<sentry id="s_rfq">
<onPart id="op_rfq" caseFileItemRef="rfq"><standardEvent>create</standardEvent></onPart>
</sentry>
<sentry id="s_incomplete">
<onPart id="op_ic" caseFileItemRef="records"><standardEvent>update</standardEvent></onPart>
<ifPart id="if_ic"><condition>missingKeyFields &gt; 0</condition></ifPart>
</sentry>
<sentry id="s_complete">
<onPart id="op_cp" caseFileItemRef="records"><standardEvent>update</standardEvent></onPart>
<ifPart id="if_cp"><condition>missingKeyFields = 0</condition></ifPart>
</sentry>
<sentry id="s_typed">
<onPart id="op_tp" caseFileItemRef="records"><standardEvent>update</standardEvent></onPart>
<ifPart id="if_tp"><condition>untyped = 0</condition></ifPart>
</sentry>
<stage id="S1" name="收料归一" autoComplete="true">
<entryCriterion id="ec_s1" sentryRef="s_rfq"/>
<humanTask id="T_normalize" name="人工逐条解析归一">
<itemControl><manualActivationRule id="m_nm"/><repetitionRule id="r_nm"/></itemControl>
</humanTask>
<humanTask id="T_ask_back" name="人工追问补全信息">
<entryCriterion id="ec_ask" sentryRef="s_incomplete"/>
<itemControl><manualActivationRule id="m_ab"/><repetitionRule id="r_ab"/></itemControl>
</humanTask>
</stage>
<milestone id="M_complete" name="八字段齐"/>
<stage id="S2" name="定性分级" autoComplete="true">
<entryCriterion id="ec_s2" sentryRef="s_complete"/>
<humanTask id="T_history" name="人工查历史价">
<itemControl><manualActivationRule id="m_hi"/></itemControl>
</humanTask>
<decisionTask id="D_classify" name="逐条打标 A/B/C" decisionRef="p03-type"/>
<planningTable id="pt_s2">
<humanTask id="T_lifecycle" name="人工核生命周期"/>
</planningTable>
</stage>
<milestone id="M_typed" name="全条已打标"/>
<humanTask id="T_release" name="人工受理结论验收放行">
<entryCriterion id="ec_rel" sentryRef="s_typed"/>
<itemControl><manualActivationRule id="m_rl"/></itemControl>
</humanTask>
<timerEventListener id="TL_half" name="时限过半">
<timerExpression>PT12H</timerExpression>
</timerEventListener>
<userEventListener id="UL_amend" name="客户改需求"/>
</casePlanModel>
</case>
</definitions>`;
export const NARRATIVE = `§0 开案:一封询价来函即开案。信里是 RFQ 正文与 BOM 附件,条目从几条到上百条不等。
受理这件事的成品只有一样:**一份能往下走的统一受理记录** —— 八字段齐、每条都打了标。
S1 收料归一:逐条把 BOM 解析成统一格式(PN / 厂牌 / EAU / 目标价 / 交期 / 包装 / 品质要求 / 备注)。
解析不出的不许臆造 —— 缺关键字段(PN、EAU、交期为必要三要素)就追问客户,常要来回一两轮,
所以这两件事都可重复做。**吃不准的宁可空着去问,也不许填一个看起来合理的值。**
S2 定性分级:先查历史价(同客户同料近一年有没有报过、隔了多久、行情稳不稳),
再按三分类规则 P-03 逐条打标 —— A 类历史价直用、B 类需重新核价、C 类需选型或寻源。
拿不准的一律降 B,不许臆断 A:错标 A 会让一条本该重新核价的料带着旧价一路走到报价单上。
生命周期核查是裁量项 —— 遇到疑似 EOL 的料随手拉一次。
§Z 结案:八字段齐、每条都已打标、BD 签字放行,自动结案(CMMN AutoComplete)。
结论只有两个去向要交出去:需不需要选型、需不需要寻源 —— 下游的两道网关读的就是这两面旗。`;
+5 -120
View File
@@ -8,6 +8,7 @@
*/
import type { ActivityManifest, DmnModel } from '@contracts';
import { INTAKE_SKILLS } from './skills.ts';
import { CMMN_XML, NARRATIVE } from './case-model.ts';
import { activityIdSchema } from '@contracts';
import { INTAKE_CLASSIFIED, INTAKE_OVERVIEW, INTAKE_RELEASE } from './views/report.ts';
@@ -44,7 +45,6 @@ export const manifest: ActivityManifest = {
name: '客户RFQ受理',
packageVersion: '0.1.8',
category: '统一报价',
paradigm: 'flow',
sdkVersion: '0.1.0-m5',
checksum: 'dev-checksum-quote-intake',
},
@@ -169,126 +169,11 @@ export const manifest: ActivityManifest = {
/* 资产初始版:flow = 步序声明 */
assets: {
/* 资产初始版:案例模型(2026-07-29 起活动只有这一种业务模型) */
businessModel: {
paradigm: 'flow',
steps: [
{
kind: 'llm',
name: 'S3_normalize',
label: 'S3 逐条解析归一',
input: { rfqRef: 'rfqRef', customerCode: 'customerCode', subject: 'subject', body: 'body' },
/*
* 出参路径要对得上**自己声明的 outputSchema**:模型回的是
* `{ records: [...], missingKeyFields }`,不是一堆扁平字段。
* MVP 逐条办的第一条 = `records.0`;`customerCode` 不在模型出参里,
* 它来自起单入参,由作用域补上。
*/
output: {
domain: INTAKE_DOMAIN,
object: 'record',
key: { customer_code: 'customerCode', pn: 'records.0.pn' },
fields: {
pn: 'records.0.pn',
brand: 'records.0.brand',
eau: 'records.0.eau',
target_price: 'records.0.targetPrice',
lead_time: 'records.0.leadTime',
// 完整度判定要有据可依:D1 的谓词读的就是它
missing_key_fields: 'missingKeyFields',
},
},
model: 'quote-extractor',
// 出参形状由网关按 outputSchema 统一附上,模板只讲**这件事本身**
template:
'按《询价受理规范》把下面这封询价拆解为逐条需求,逐条抄录 ' +
'pn(型号)/ brand(厂牌)/ eau(年用量,整数)/ targetPrice(目标价,数字)/ leadTime(交期)。' +
'原文没写的字段留空,不要编造;每缺一个关键字段(pn / eau / leadTime)就把 missingKeyFields 加一。\n\n' +
'询价单号:{{rfqRef}}\n客户编码:{{customerCode}}\n主题:{{subject}}\n正文:\n{{body}}',
outputSchema: {
type: 'object',
required: ['records'],
properties: {
records: {
type: 'array',
items: {
type: 'object',
required: ['pn'],
properties: {
pn: { type: 'string' },
brand: { type: 'string' },
eau: { type: 'integer' },
targetPrice: { type: 'number' },
leadTime: { type: 'string' },
},
},
},
missingKeyFields: { type: 'integer' },
},
},
view: 'intake-overview',
failure: { retry: { times: 2, backoff: 'PT30S' }, fallback: { kind: 'human', workOrder: 'execution' } },
},
{
kind: 'human',
name: 'S2_ask_back',
label: 'S2 追问补全信息',
// D1 判断完整度:缺 PN/数量/交期三要素才走补全 —— 条件必谓词,由引擎求值
when: 'missing_key_fields > 0',
input: {},
workOrder: 'execution',
card: { title: '缺关键字段,请向客户追问补全', fields: ['pn', 'eau', 'leadTime'] },
deadline: 'P1D',
failure: { retry: { times: 0, backoff: 'PT30S' }, fallback: { kind: 'blocked' } },
},
{
kind: 'tool',
name: 'S4_history',
label: 'S4 查历史价',
input: { pn: 'pn' },
// 情报四件全部落表:S5 打标要的就是这三件,只落 hit 会让下一步无米下锅
output: {
domain: INTAKE_DOMAIN,
object: 'type_table',
key: { pn: 'pn' },
fields: {
history_hit: 'hit',
history_days: 'historyDays',
market_stable: 'marketStable',
lifecycle: 'lifecycle',
},
},
tool: 'crm.history-price-read',
failure: { retry: { times: 2, backoff: 'PT1M' }, fallback: { kind: 'human', workOrder: 'execution' } },
},
{
kind: 'pure-tool',
name: 'S5_classify',
label: 'S5 逐条打标(DMN · 三分类规则 P-03)',
// 入参名 ← 作用域路径:作用域里是 S4 落表后的字段名
input: { historyDays: 'history_days', marketStable: 'market_stable', lifecycle: 'lifecycle' },
output: {
domain: INTAKE_DOMAIN,
object: 'type_table',
key: { pn: 'pn' },
fields: { type_tag: 'type', basis: 'play' },
},
tool: 'quote-intake.classify',
view: 'intake-classified',
failure: { retry: { times: 1, backoff: 'PT10S' }, fallback: { kind: 'blocked' } },
},
{
kind: 'human',
name: 'S6_release',
label: 'S6 分流复核与派单 · 验收放行',
input: {},
workOrder: 'acceptance',
card: { title: '统一受理记录(打标)请验收' },
view: 'intake-release',
deadline: 'P1D',
failure: { retry: { times: 0, backoff: 'PT30S' }, fallback: { kind: 'blocked' } },
},
],
parallelGroups: [],
cmmnXml: CMMN_XML,
narrative: NARRATIVE,
dmn: P03_DMN,
},
skills: INTAKE_SKILLS,
// 三张模版对应三种局面(事态全景 / 进展 / 成果预览),由步序声明按位置推送
@@ -0,0 +1,77 @@
/**
* A6 报价议价的案例模型 —— **双表示同版本**:CMMN XML(机器面)与案例说明书(叙事面)。
*
* 2026-07-29 由步序声明(flow)改写而来。发出报价是**触达外界**的一下,
* 恒需人工激活(AM 4.1 原理一);客户回音是外部事件,靠 userEventListener 等,
* 不靠轮询。三个去向(成交 / 有异议 / 拒绝)由验收放行时的选择组给出。
*/
export const CMMN_XML = `<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/CMMN/20151109/MODEL">
<case id="negotiate">
<caseFileModel>
<caseFileItem id="draft" name="报价草案"/>
<caseFileItem id="quote" name="正式报价单"/>
<caseFileItem id="reply" name="客户回音"/>
</caseFileModel>
<casePlanModel id="plan" name="报价议价" autoComplete="true">
<sentry id="s_draft">
<onPart id="op_df" caseFileItemRef="draft"><standardEvent>create</standardEvent></onPart>
</sentry>
<sentry id="s_quote_ready">
<onPart id="op_qr" caseFileItemRef="quote"><standardEvent>update</standardEvent></onPart>
<ifPart id="if_qr"><condition>missingQuoteFields = 0</condition></ifPart>
</sentry>
<sentry id="s_sent">
<onPart id="op_st" caseFileItemRef="quote"><standardEvent>update</standardEvent></onPart>
<ifPart id="if_st"><condition>sent = true</condition></ifPart>
</sentry>
<stage id="S1" name="成单发出" autoComplete="true">
<entryCriterion id="ec_s1" sentryRef="s_draft"/>
<humanTask id="T_compose" name="人工生成正式报价单">
<itemControl><manualActivationRule id="m_cp"/><repetitionRule id="r_cp"/></itemControl>
</humanTask>
<humanTask id="T_send" name="人工发出报价单">
<entryCriterion id="ec_send" sentryRef="s_quote_ready"/>
<itemControl><manualActivationRule id="m_sd"/></itemControl>
</humanTask>
</stage>
<milestone id="M_sent" name="报价已发出"/>
<stage id="S2" name="跟进议价" autoComplete="true">
<entryCriterion id="ec_s2" sentryRef="s_sent"/>
<humanTask id="T_followup" name="人工按 D+3/D+7 跟进">
<itemControl><manualActivationRule id="m_fu"/><repetitionRule id="r_fu"/></itemControl>
</humanTask>
<planningTable id="pt_s2">
<humanTask id="T_revise" name="人工议价调整"/>
</planningTable>
</stage>
<humanTask id="T_release" name="人工议价结果验收放行">
<itemControl><manualActivationRule id="m_rl"/></itemControl>
</humanTask>
<timerEventListener id="TL_d3" name="D+3 跟进">
<timerExpression>P3D</timerExpression>
</timerEventListener>
<timerEventListener id="TL_d7" name="D+7 跟进">
<timerExpression>P7D</timerExpression>
</timerEventListener>
<userEventListener id="UL_reply" name="客户回音"/>
</casePlanModel>
</case>
</definitions>`;
export const NARRATIVE = `§0 开案:拿到报价草案即开案。成品是**一份发出去的正式报价单**,外加一个明确的结果。
S1 成单发出:把草案写成正式报价单(中英双语 PDF)—— 单价、交期、SPQ、MOQ、贸易条款、
有效期六样缺一不可,有效期按 P-04 注明。**发出这一下必须人工按**:它触达客户,
系统不替人做这个决定。写类动作先登记意向,验收放行的那一刻才真发。
S2 跟进议价:没有跟进的报价等于没报 —— D+3、D+7 两记提醒自动到点,人去问。
客户提异议就议价调整(裁量项:改价、改交期、换料都可能),改完是新一版报价单,重新走发出。
§Z 结案:验收时**恰选一口**给出去向 —— 成交 / 有异议 / 拒绝或超时。
选哪一口就是这一单的结论,下游网关读的就是它;不选口不许放行,含糊的结果比没结果更坏。`;
+5 -47
View File
@@ -7,6 +7,7 @@
*/
import type { ActivityManifest } from '@contracts';
import { NEGOTIATE_SKILLS } from './skills.ts';
import { CMMN_XML, NARRATIVE } from './case-model.ts';
import { activityIdSchema } from '@contracts';
import { QUOTE_COMPOSED, QUOTE_RELEASE } from './views/report.ts';
@@ -19,7 +20,6 @@ export const manifest: ActivityManifest = {
name: 'A6 · 报价议价',
packageVersion: '0.1.4',
category: '统一报价',
paradigm: 'flow',
sdkVersion: '0.1.0-m5',
checksum: 'dev-checksum-quote-negotiate',
},
@@ -129,53 +129,11 @@ export const manifest: ActivityManifest = {
},
assets: {
/* 资产初始版:案例模型(2026-07-29 起活动只有这一种业务模型) */
businessModel: {
paradigm: 'flow',
steps: [
{
kind: 'llm',
name: 'S1_compose',
label: 'S1 生成正式报价单',
input: { items: 'items', customerCode: 'customerCode' },
output: {
domain: DOMAIN,
object: 'formal_quote',
key: { quote_no: 'quoteNo', pn: 'pn' },
fields: { unit_price: 'unitPrice', lead_time: 'leadTime' },
},
model: 'quote-extractor',
template:
'把已批准的报价草案排版为正式报价单条目(单价CNY/交期/SPQ/MOQ/贸易条款),' +
'按报价有效期 P-04 注明 7 日历天有效。只输出 JSON。条目:{{items}}',
outputSchema: {
type: 'object',
required: ['lines'],
properties: { lines: { type: 'array' }, validityDays: { type: 'integer' } },
},
view: 'quote-composed',
failure: { retry: { times: 2, backoff: 'PT30S' }, fallback: { kind: 'human', workOrder: 'execution' } },
},
{
kind: 'tool',
name: 'S2_send',
label: 'S2 发出报价单(写类 → 登记动作意向,放行时落地)',
input: { customerCode: 'customerCode' },
tool: 'mail.send',
failure: { retry: { times: 2, backoff: 'PT1M' }, fallback: { kind: 'human', workOrder: 'execution' } },
},
{
kind: 'human',
name: 'S3_release',
label: 'S3 正式报价单验收放行(放行即落地:台账回写 + 出站发送)',
input: {},
workOrder: 'acceptance',
card: { title: '正式报价单请验收 —— 放行即发出', deliverable: 'formal-quote' },
deadline: 'P1D',
view: 'quote-release',
failure: { retry: { times: 0, backoff: 'PT30S' }, fallback: { kind: 'blocked' } },
},
],
parallelGroups: [],
cmmnXml: CMMN_XML,
narrative: NARRATIVE,
dmn: { drd: [], tables: [] },
},
skills: NEGOTIATE_SKILLS,
viewTemplates: [
@@ -0,0 +1,81 @@
/**
* A4 成本定价的案例模型 —— **双表示同版本**:CMMN XML(机器面)与案例说明书(叙事面)。
*
* 2026-07-29 由步序声明(flow)改写而来。原六步各归其位:取价基准与逐条定价属「算价」,
* 偏离率与底价门禁属「自检」(两支 DMN:P-01 利润模型、P-02 底价门禁),
* 超限条目调人决策是**触达客户利益的一下**,必须人工激活;末尾一张验收单。
*/
export const CMMN_XML = `<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/CMMN/20151109/MODEL">
<case id="pricing">
<caseFileModel>
<caseFileItem id="records" name="待定价条目"/>
<caseFileItem id="basis" name="取价基准"/>
<caseFileItem id="draft" name="报价草案"/>
<caseFileItem id="floors" name="底价表"/>
</caseFileModel>
<casePlanModel id="plan" name="成本定价" autoComplete="true">
<sentry id="s_records">
<onPart id="op_rc" caseFileItemRef="records"><standardEvent>create</standardEvent></onPart>
</sentry>
<sentry id="s_basis">
<onPart id="op_bs" caseFileItemRef="basis"><standardEvent>create</standardEvent></onPart>
</sentry>
<sentry id="s_priced">
<onPart id="op_pd" caseFileItemRef="draft"><standardEvent>update</standardEvent></onPart>
<ifPart id="if_pd"><condition>unpriced = 0</condition></ifPart>
</sentry>
<sentry id="s_breach">
<onPart id="op_br" caseFileItemRef="draft"><standardEvent>update</standardEvent></onPart>
<ifPart id="if_br"><condition>breaches &gt; 0</condition></ifPart>
</sentry>
<stage id="S1" name="算价" autoComplete="true">
<entryCriterion id="ec_s1" sentryRef="s_records"/>
<humanTask id="T_basis" name="人工取价基准">
<itemControl><manualActivationRule id="m_bs"/></itemControl>
</humanTask>
<decisionTask id="D_price" name="逐条定价" decisionRef="p01-margin">
<entryCriterion id="ec_price" sentryRef="s_basis"/>
</decisionTask>
</stage>
<milestone id="M_priced" name="全条已定价"/>
<stage id="S2" name="自检" autoComplete="true">
<entryCriterion id="ec_s2" sentryRef="s_priced"/>
<decisionTask id="D_floor" name="底价门禁" decisionRef="p02-floor"/>
<humanTask id="T_breach" name="人工裁超限条目(回调还是注明理由)">
<entryCriterion id="ec_breach" sentryRef="s_breach"/>
<itemControl><manualActivationRule id="m_br"/><repetitionRule id="r_br"/></itemControl>
</humanTask>
<planningTable id="pt_s2">
<humanTask id="T_refresh_floor" name="人工刷新底价"/>
</planningTable>
</stage>
<milestone id="M_gated" name="门禁已过"/>
<humanTask id="T_release" name="人工报价草案验收放行">
<itemControl><manualActivationRule id="m_rl"/></itemControl>
</humanTask>
<timerEventListener id="TL_half" name="时限过半">
<timerExpression>PT8H</timerExpression>
</timerEventListener>
</casePlanModel>
</case>
</definitions>`;
export const NARRATIVE = `§0 开案:拿到一批待定价条目即开案。成品是**一份全条目带偏离度的报价草案** ——
每条有拟报单价与毛利率,且都过了底价门禁。
S1 算价:先取价基准(历史成交价 / 供应商回价 / 替代料对标价,按可得性择优),
再按利润模型 P-01 逐条定价 —— 客户等级、数量档、料号类型、行情共同决定加价率。
基准取不到的条目不许拍脑袋定价,回头找寻源或标注「无基准」。
S2 自检:算出偏离度(基准价 ↔ 拟报价),按底价门禁 P-02 逐条判。
**偏离 ±20% 以内自动放过;超限的一律调人** —— 要么回调价格,要么写明为什么这样报。
底价超一周没更新的先刷底价再判(裁量项),拿旧底价判新行情等于没判。
§Z 结案:每条都有拟报单价与毛利率、超限条目已处置、BD 签字放行,自动结案。
草案交出去就是下游议价的起点 —— 它不是最终报价,但每一条都要经得起问「为什么是这个价」。`;
+5 -73
View File
@@ -7,6 +7,7 @@
*/
import type { ActivityManifest, DmnModel } from '@contracts';
import { PRICING_SKILLS } from './skills.ts';
import { CMMN_XML, NARRATIVE } from './case-model.ts';
import { activityIdSchema } from '@contracts';
import { PRICING_BASIS, PRICING_PRICED, PRICING_RELEASE } from './views/report.ts';
@@ -63,7 +64,6 @@ export const manifest: ActivityManifest = {
name: 'A4 · 成本定价',
packageVersion: '0.1.5',
category: '统一报价',
paradigm: 'flow',
sdkVersion: '0.1.0-m5',
checksum: 'dev-checksum-quote-pricing',
},
@@ -161,79 +161,11 @@ export const manifest: ActivityManifest = {
},
assets: {
/* 资产初始版:案例模型(2026-07-29 起活动只有这一种业务模型) */
businessModel: {
paradigm: 'flow',
steps: [
{
kind: 'tool',
name: 'S1_basis',
label: 'S1 取价基准',
// Type A 取历史价近期价;B/C 取供应商底价表(C 类参考替代对标表)
input: { pn: 'pn' },
// 取回来的是**基准价**;偏离率要等 S2 定出拟报价才算得出来(见 S2B)
output: { domain: DOMAIN, object: 'draft', key: { pn: 'pn' }, fields: { last_price: 'lastPrice' } },
tool: 'crm.history-price-read',
view: 'pricing-basis',
failure: { retry: { times: 2, backoff: 'PT1M' }, fallback: { kind: 'human', workOrder: 'execution' } },
},
{
kind: 'pure-tool',
name: 'S2_price',
label: 'S2 逐条定价(DMN · 利润模型 P-01)',
input: { customerGrade: 'customerGrade', materialType: 'materialType', volumeTier: 'volumeTier' },
output: {
domain: DOMAIN,
object: 'draft',
key: { pn: 'pn' },
fields: { margin: 'marginLow', quoted_price: 'quotedPrice' },
},
tool: 'quote-pricing.margin',
failure: { retry: { times: 1, backoff: 'PT10S' }, fallback: { kind: 'blocked' } },
},
{
kind: 'pure-tool',
name: 'S2B_deviation',
label: 'S2B 算偏离率(基准价 ↔ 拟报价)',
input: { lastPrice: 'last_price', quotedPrice: 'quoted_price' },
output: { domain: DOMAIN, object: 'draft', key: { pn: 'pn' }, fields: { deviation: 'deviation' } },
tool: 'quote-pricing.basis',
failure: { retry: { times: 1, backoff: 'PT10S' }, fallback: { kind: 'blocked' } },
},
{
kind: 'pure-tool',
name: 'S3_floor_gate',
label: 'S3 底价自检(DMN · 底价门禁 P-02)',
input: { deviation: 'deviation' },
output: { domain: DOMAIN, object: 'draft', key: { pn: 'pn' }, fields: { disposition: 'disposition' } },
tool: 'quote-pricing.floor-gate',
view: 'pricing-priced',
failure: { retry: { times: 1, backoff: 'PT10S' }, fallback: { kind: 'blocked' } },
},
{
kind: 'human',
name: 'S4_decide_breach',
label: '超限条目:调人决策(回调还是注明理由)',
// 只有门禁不过才调人 —— 条件必谓词,零 LLM
when: 'breached > 0',
input: {},
workOrder: 'execution',
card: { title: '有条目低于底价 20% 以上,请裁决', fields: ['disposition', 'reason'] },
deadline: 'PT4H',
failure: { retry: { times: 0, backoff: 'PT30S' }, fallback: { kind: 'blocked' } },
},
{
kind: 'human',
name: 'S5_release',
label: 'S5 报价草案验收放行',
input: {},
workOrder: 'acceptance',
card: { title: '报价草案(全条目带偏离度)请验收', deliverable: 'quote-draft' },
deadline: 'P1D',
view: 'pricing-release',
failure: { retry: { times: 0, backoff: 'PT30S' }, fallback: { kind: 'blocked' } },
},
],
parallelGroups: [],
cmmnXml: CMMN_XML,
narrative: NARRATIVE,
dmn: P01_DMN,
},
skills: PRICING_SKILLS,
viewTemplates: [
@@ -47,7 +47,6 @@ export const manifest: ActivityManifest = {
name: 'A3 · 渠道寻源',
packageVersion: '0.1.2',
category: '统一报价',
paradigm: 'loop',
sdkVersion: '0.1.0-m5',
checksum: 'dev-checksum-quote-sourcing',
},
@@ -164,7 +163,6 @@ export const manifest: ActivityManifest = {
assets: {
businessModel: {
paradigm: 'loop',
cmmnXml: CMMN_XML,
// 双表示同版本:XML 是机器面,说明书是叙事面 —— 不允许分叉
narrative: NARRATIVE,
@@ -4,10 +4,10 @@
* 活动库:**独立的安装与卸载入口** —— 不在编排中发生。
* 安装恒为新增、版本并存;在途任务按其启动时版本跑完,切换零丢单。
*/
import type { ActivityManifest, InstallVerdict, Paradigm, StaticAuditFinding } from '@contracts';
import type { ActivityManifest, InstallVerdict, StaticAuditFinding } from '@contracts';
import type { AssetKind, AssetVersion, IncrementState, LoadEnvelope, PackageVersion, ReplayCase, ReplayVerdict } from './internal/domain/versioning.ts';
import type { ExternalChecks } from './internal/domain/static-audit.ts';
export type { ActivityManifest, AssetKind, AssetVersion, ExternalChecks, IncrementState, InstallVerdict, LoadEnvelope, PackageVersion, Paradigm, ReplayCase, ReplayVerdict, StaticAuditFinding, };
export type { ActivityManifest, AssetKind, AssetVersion, ExternalChecks, IncrementState, InstallVerdict, LoadEnvelope, PackageVersion, ReplayCase, ReplayVerdict, StaticAuditFinding, };
export declare class InstallRejectedError extends Error {
readonly verdict: InstallVerdict;
constructor(verdict: InstallVerdict);
@@ -25,7 +25,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;
@@ -6,7 +6,7 @@ export { ActivityNotInstalledError, InstallRejectedError, ToolNotDeclaredError }
export type { Clock, IdGenerator, LedgerDeclarationApplier, ModelBindingProbe, RegistryStore, TemplateGuard, ToolContractProbe, } from './port.ts';
export type { RegistryServiceDeps } from './internal/usecase/registry-service.ts';
export { createRegistryService } from './internal/usecase/registry-service.ts';
export { acceptanceLevelFindings, auditPassed, danglingListeners, flowFindings, loopFindings, scanArtifact, staticAudit, } from './internal/domain/static-audit.ts';
export { acceptanceLevelFindings, auditPassed, danglingListeners, loopFindings, scanArtifact, staticAudit, } from './internal/domain/static-audit.ts';
export { ASSET_KINDS, assertTransition, buildLoadEnvelope, canTransition, IllegalIncrementTransitionError, INCREMENT_STATES, judgeReplay, mayTakeEffect, shouldSeedAsset, } from './internal/domain/versioning.ts';
export { createRegistryStore } from './internal/adapter/registry-store.ts';
export { activityAssetTable, activityPackageTable, assetIncrementTable } from './internal/adapter/registry-schema.ts';
@@ -1,42 +0,0 @@
/**
* module: flow-engine —— 对外类型(编码规范 §10.1;语义出处 AM 05)。
*
* flow 范式:步序声明运行器(四种步型、重试与兜底、事件即步条件)。
* **零临场调度** —— 运行中不得由 LLM 决定步序、跳步或兜底。
*/
import type { FlowModel, FlowStep, TaskId } from '@contracts';
import type { FailureAction, FlowIssue, FlowPosition, NextAction, StepRuntime, StepState } from './internal/domain/step-sequence.ts';
export type { FailureAction, FlowIssue, FlowModel, FlowPosition, FlowStep, NextAction, StepRuntime, StepState };
export declare class FlowDeclarationInvalidError extends Error {
readonly issues: readonly FlowIssue[];
constructor(issues: readonly FlowIssue[]);
}
/** 一次推进的结果 —— 由 task 驱动,不自转 */
export type AdvanceOutcome = {
readonly position: FlowPosition;
readonly status: 'running' | 'awaiting' | 'finished' | 'blocked';
/** awaiting 时:在等什么 */
readonly waitingFor?: {
readonly kind: 'human' | 'event' | 'time';
readonly ref: string;
readonly deadline: string;
};
/** finished 时:末步验收工单的裁决决定终态 */
readonly released?: boolean;
/** 选择组的出口选择:恰发一口,随放行一并确认 */
readonly selectedPorts?: Record<string, string>;
readonly blockedReason?: string;
};
export type FlowEngineService = {
/** 装载步序声明并校验 —— 谱必须全程可静态检查 */
load(taskId: TaskId, model: FlowModel): Promise<FlowPosition>;
position(taskId: TaskId): Promise<FlowPosition | undefined>;
/** 推进一步(或若干确定步);异步步进入 awaiting 并登记监听 */
advance(taskId: TaskId): Promise<AdvanceOutcome>;
/** 事件即步的完成条件:人事件 / 数据事件 / 时间事件到达即续跑 */
resume(taskId: TaskId, event: {
kind: 'human' | 'data' | 'time';
ref: string;
payload: Record<string, unknown>;
}): Promise<AdvanceOutcome>;
};
-11
View File
@@ -1,11 +0,0 @@
/**
* module: flow-engine —— 唯一出口。只做 re-export,不写逻辑(编码规范 §10.1)。
*/
export type { AdvanceOutcome, FailureAction, FlowEngineService, FlowIssue, FlowModel, FlowPosition, FlowStep, NextAction, StepRuntime, StepState, } from './contract.ts';
export { FlowDeclarationInvalidError } from './contract.ts';
export type { CardGateway, Clock, FlowStateStore, IdGenerator, ListenerRegistrar, LlmStepGateway, MemoryRecorder, PredicateEvaluator, TaskContext, TaskDataGateway, ToolStepInvoker, } from './port.ts';
export type { FlowRunnerDeps } from './internal/usecase/flow-runner.ts';
export { createFlowRunner } from './internal/usecase/flow-runner.ts';
export { checkDeclaration, failureAction, initialPosition, lastStepIsAcceptance, markStep, nextAction, parallelGroupComplete, STEP_STATES, } from './internal/domain/step-sequence.ts';
export { createFlowStateStore } from './internal/adapter/flow-state-store.ts';
export { flowStateTable } from './internal/adapter/flow-state-schema.ts';
-131
View File
@@ -1,131 +0,0 @@
/**
* module: flow-engine —— 本模块要外界提供的能力(编码规范 §10.1 / §5.3)。
*/
import type { FlowModel, StaffId, TaskId } from '@contracts';
import type { FlowPosition } from './internal/domain/step-sequence.ts';
export type Clock = {
now(): Date;
};
export type IdGenerator = {
next(): string;
};
/** 运行时实例状态 —— 三份持久状态之一(OS 09) */
export type FlowStateStore = {
save(taskId: TaskId, model: FlowModel, position: FlowPosition): Promise<void>;
load(taskId: TaskId): Promise<{
model: FlowModel;
position: FlowPosition;
} | undefined>;
};
/** 条件谓词求值 —— app 注入 `@sfeel`;零 LLM */
export type PredicateEvaluator = (expression: string, scope: Readonly<Record<string, unknown>>) => boolean;
/** 任务数据 —— app 注入 `ledger`(L1):读任务视图 = 正式版 + 本任务草稿层 */
export type TaskDataGateway = {
view(taskId: TaskId): Promise<Record<string, unknown>>;
draftWrite(input: {
taskId: TaskId;
domain: string;
object: string;
key: Record<string, string | number>;
patch: Record<string, unknown>;
}): Promise<void>;
};
/** 工具步与纯工具步 —— app 注入 `toolbox`(L2) */
export type ToolStepInvoker = {
invoke(input: {
tool: string;
input: Record<string, unknown>;
activityId: string;
taskId: TaskId;
stepNo: number;
}): Promise<{
ok: boolean;
output?: Record<string, unknown>;
error?: {
message: string;
retryable: boolean;
};
}>;
/** 写类工具在 flow 里也走「登记动作意向」,除非契约显式预授权 */
registerIntent(input: {
taskId: TaskId;
tool: string;
input: Record<string, unknown>;
label: string;
}): Promise<void>;
isWriteEffect(tool: string): Promise<boolean>;
};
/** LLM 步 —— app 注入 `llm`(L1)的 ModelGateway;模板与出参 schema 随声明版本冻结 */
export type LlmStepGateway = {
generate(input: {
model: string;
prompt: string;
outputSchema: Record<string, unknown>;
taskId: TaskId;
stepNo: number;
}): Promise<{
ok: boolean;
object?: unknown;
text?: string;
error?: string;
}>;
};
/** 出参校验 —— app 注入 ajv:LLM 步的出参**必过声明的 schema**(AM 12.3) */
export type SchemaValidator = {
validate(schema: Record<string, unknown>, value: unknown): {
ok: boolean;
errors: string[];
};
};
/**
* 视图流控 —— app 注入 `interaction`(L3)。
* flow 按步序位置推声明的模版;推的是**填好数的 HTML**,容器只渲染不执行。
*/
export type ViewGateway = {
/** 按模版名取模版、以任务视图填数、推给前端;模版不存在就什么都不做 */
push(input: {
taskId: TaskId;
activityId: string;
template: string;
scope: Record<string, unknown>;
}): Promise<void>;
};
/** 人类工具步 —— app 注入 `human-tool`(L3) */
export type CardGateway = {
issue(input: {
taskId: TaskId;
ownerId: StaffId;
humanCallCap: number;
workOrder: 'execution' | 'acceptance';
card: Record<string, unknown>;
}): Promise<{
id: string;
}>;
};
/** 监听登记 —— app 注入 `event`(L1):异步步的完成条件 = 监听,时限必配 */
export type ListenerRegistrar = {
register(input: {
taskId: TaskId;
eventType: 'data' | 'time' | 'human';
keyFilter: Record<string, string>;
deadline: string;
}): Promise<{
id: string;
}>;
};
export type MemoryRecorder = {
append(input: {
taskId: TaskId;
kind: 'action' | 'result' | 'engine-transition';
title: string;
detail?: Record<string, unknown>;
}): Promise<void>;
};
/** 任务上下文 —— 活动 ID、负责人、预算 */
export type TaskContext = {
of(taskId: TaskId): Promise<{
activityId: string;
ownerId: StaffId;
humanCallCap: number;
}>;
};
+23 -1
View File
@@ -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);
+1 -1
View File
@@ -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';
+4 -1
View File
@@ -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>;
+2 -3
View File
@@ -4,10 +4,10 @@
* 任务运行时:生命周期与**终态五名裁定**、Harness 预算执行器 / 停滞熔断、
* 控制三语义、改派、断点续跑。范式(loop / flow)在此汇流 —— 对流程层与交互层不可区分。
*/
import type { BudgetCaps, ControlSemantic, Paradigm, StaffId, TaskId, TaskRuntimeState, TerminalState } from '@contracts';
import type { BudgetCaps, ControlSemantic, StaffId, TaskId, TaskRuntimeState, TerminalState } from '@contracts';
import type { BudgetBreach, Consumption, HarnessVerdict } from './internal/domain/harness.ts';
import type { ControlOutcome, ResumeReadiness, TaskSnapshot, TerminalCause } from './internal/domain/lifecycle.ts';
export type { BudgetBreach, BudgetCaps, Consumption, ControlOutcome, ControlSemantic, HarnessVerdict, Paradigm, ResumeReadiness, TaskRuntimeState, TaskSnapshot, TerminalCause, TerminalState, };
export type { BudgetBreach, BudgetCaps, Consumption, ControlOutcome, ControlSemantic, HarnessVerdict, ResumeReadiness, TaskRuntimeState, TaskSnapshot, TerminalCause, TerminalState, };
export declare class TaskNotFoundError extends Error {
readonly taskId: TaskId;
constructor(taskId: TaskId);
@@ -29,7 +29,6 @@ export type LandedFacts = {
export type Task = {
readonly id: TaskId;
readonly activityId: string;
readonly paradigm: Paradigm;
/** 起单来源:工作流节点;登记触发的直起单为 undefined */
readonly workflowId?: string;
readonly nodeId?: string;
+1 -1
View File
@@ -1,7 +1,7 @@
/**
* module: task —— 唯一出口。只做 re-export,不写逻辑(编码规范 §10.1)。
*/
export type { BudgetBreach, LandedFacts, BudgetCaps, Consumption, ControlOutcome, ControlSemantic, HarnessVerdict, Paradigm, ResumeReadiness, StartTaskInput, Task, TaskRuntimeState, TaskService, TaskSnapshot, TerminalCause, TerminalState, TickOutcome, } from './contract.ts';
export type { BudgetBreach, LandedFacts, BudgetCaps, Consumption, ControlOutcome, ControlSemantic, HarnessVerdict, ResumeReadiness, StartTaskInput, Task, TaskRuntimeState, TaskService, TaskSnapshot, TerminalCause, TerminalState, TickOutcome, } from './contract.ts';
export { TaskAlreadyTerminalError, TaskNotFoundError } from './contract.ts';
export type { ActivityLoader, Clock, IdGenerator, InteractionPhaseSetter, ListenerProbe, MemoryRecorder, ParadigmEngine, PersistenceProbe, ReassignNotifier, SchemaValidator, TaskEventPublisher, TaskStore, } from './port.ts';
export type { TaskServiceDeps } from './internal/usecase/task-service.ts';
+1 -2
View File
@@ -1,7 +1,7 @@
/**
* module: task —— 本模块要外界提供的能力(编码规范 §10.1 / §5.3)。
*/
import type { BudgetCaps, Paradigm, StaffId, TaskId, TerminalState } from '@contracts';
import type { BudgetCaps, StaffId, TaskId, TerminalState } from '@contracts';
import type { Consumption } from './internal/domain/harness.ts';
import type { LandedFacts, Task } from './contract.ts';
export type Clock = {
@@ -22,7 +22,6 @@ export type TaskStore = {
/** 活动装载 —— app 注入 `activity-registry`(L4) */
export type ActivityLoader = {
load(activityId: string): Promise<{
paradigm: Paradigm;
caps: BudgetCaps;
envelope: Record<string, unknown>;
/** 输入 data 的 JSON Schema —— 缺项不得启动 */
+98 -148
View File
@@ -310,10 +310,6 @@ export declare const govTaskRowSchema: z.ZodObject<{
id: z.core.$ZodBranded<z.ZodString, "TaskId", "out">;
title: z.ZodString;
activityId: z.ZodString;
paradigm: z.ZodEnum<{
loop: "loop";
flow: "flow";
}>;
ownerName: z.ZodString;
runtime: z.ZodEnum<{
running: "running";
@@ -344,10 +340,6 @@ export declare const listGovTasksRoute: {
id: z.core.$ZodBranded<z.ZodString, "TaskId", "out">;
title: z.ZodString;
activityId: z.ZodString;
paradigm: z.ZodEnum<{
loop: "loop";
flow: "flow";
}>;
ownerName: z.ZodString;
runtime: z.ZodEnum<{
running: "running";
@@ -522,6 +514,7 @@ export declare const listProcessPackagesRoute: {
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"terminate">;
}, z.core.$strip>], "kind">;
templateId: z.ZodOptional<z.ZodString>;
nudge: z.ZodOptional<z.ZodObject<{
deadline: z.ZodString;
steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -645,6 +638,7 @@ export declare const saveProcessRoute: {
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"terminate">;
}, z.core.$strip>], "kind">;
templateId: z.ZodOptional<z.ZodString>;
nudge: z.ZodOptional<z.ZodObject<{
deadline: z.ZodString;
steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -752,6 +746,7 @@ export declare const saveProcessRoute: {
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"terminate">;
}, z.core.$strip>], "kind">;
templateId: z.ZodOptional<z.ZodString>;
nudge: z.ZodOptional<z.ZodObject<{
deadline: z.ZodString;
steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -892,6 +887,7 @@ export declare const setProcessStateRoute: {
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"terminate">;
}, z.core.$strip>], "kind">;
templateId: z.ZodOptional<z.ZodString>;
nudge: z.ZodOptional<z.ZodObject<{
deadline: z.ZodString;
steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -1011,6 +1007,7 @@ export declare const deleteProcessVersionRoute: {
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"terminate">;
}, z.core.$strip>], "kind">;
templateId: z.ZodOptional<z.ZodString>;
nudge: z.ZodOptional<z.ZodObject<{
deadline: z.ZodString;
steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -1052,6 +1049,94 @@ export declare const deleteProcessVersionRoute: {
}, z.core.$strip>>;
}, z.core.$strip>;
};
/** 审批模板一览 —— 活动库里「审批活动」那一格看的就是它 */
export declare const listApprovalTemplatesRoute: {
readonly method: "GET";
readonly path: "/api/gov/approval-templates";
readonly output: z.ZodObject<{
templates: z.ZodArray<z.ZodObject<{
id: z.ZodString;
name: z.ZodString;
basis: z.ZodDefault<z.ZodArray<z.ZodObject<{
field: z.ZodString;
label: z.ZodString;
}, z.core.$strip>>>;
nudge: z.ZodOptional<z.ZodObject<{
deadline: z.ZodString;
steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
after: z.ZodString;
action: z.ZodEnum<{
nudge: "nudge";
escalate: "escalate";
}>;
}, z.core.$strip>>>;
}, z.core.$strip>>;
message: z.ZodOptional<z.ZodString>;
usedBy: z.ZodArray<z.ZodObject<{
packageId: z.ZodString;
nodeId: z.ZodString;
}, z.core.$strip>>;
}, z.core.$strip>>;
}, z.core.$strip>;
};
/** 建或改一张模板 —— id 已存在即覆盖(模板是配置,不长版本) */
export declare const upsertApprovalTemplateRoute: {
readonly method: "PUT";
readonly path: "/api/gov/approval-templates";
readonly body: z.ZodObject<{
template: z.ZodObject<{
id: z.ZodString;
name: z.ZodString;
basis: z.ZodDefault<z.ZodArray<z.ZodObject<{
field: z.ZodString;
label: z.ZodString;
}, z.core.$strip>>>;
nudge: z.ZodOptional<z.ZodObject<{
deadline: z.ZodString;
steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
after: z.ZodString;
action: z.ZodEnum<{
nudge: "nudge";
escalate: "escalate";
}>;
}, z.core.$strip>>>;
}, z.core.$strip>>;
message: z.ZodOptional<z.ZodString>;
}, z.core.$strip>;
}, z.core.$strip>;
readonly output: z.ZodObject<{
template: z.ZodObject<{
id: z.ZodString;
name: z.ZodString;
basis: z.ZodDefault<z.ZodArray<z.ZodObject<{
field: z.ZodString;
label: z.ZodString;
}, z.core.$strip>>>;
nudge: z.ZodOptional<z.ZodObject<{
deadline: z.ZodString;
steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
after: z.ZodString;
action: z.ZodEnum<{
nudge: "nudge";
escalate: "escalate";
}>;
}, z.core.$strip>>>;
}, z.core.$strip>>;
message: z.ZodOptional<z.ZodString>;
}, z.core.$strip>;
}, z.core.$strip>;
};
/** 删一张模板 —— 还被审批点引着就拒(409):删了引它的节点会退回「载荷全摊开」 */
export declare const deleteApprovalTemplateRoute: {
readonly method: "DELETE";
readonly path: "/api/gov/approval-templates/:id";
readonly params: z.ZodObject<{
id: z.ZodString;
}, z.core.$strip>;
readonly output: z.ZodObject<{
ok: z.ZodBoolean;
}, z.core.$strip>;
};
/**
* 删整条流 —— 连同它的**所有版本**。货架上一条流一张卡,删的就是那张卡。
* 两道闸:任一版有在途单即拒(那些单要按它跑完);还有调起规则指着它也拒 ——
@@ -1129,6 +1214,7 @@ export declare const deleteProcessFlowRoute: {
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"terminate">;
}, z.core.$strip>], "kind">;
templateId: z.ZodOptional<z.ZodString>;
nudge: z.ZodOptional<z.ZodObject<{
deadline: z.ZodString;
steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -1255,6 +1341,7 @@ export declare const editProcessVersionRoute: {
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"terminate">;
}, z.core.$strip>], "kind">;
templateId: z.ZodOptional<z.ZodString>;
nudge: z.ZodOptional<z.ZodObject<{
deadline: z.ZodString;
steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -1366,6 +1453,7 @@ export declare const validateProcessRoute: {
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"terminate">;
}, z.core.$strip>], "kind">;
templateId: z.ZodOptional<z.ZodString>;
nudge: z.ZodOptional<z.ZodObject<{
deadline: z.ZodString;
steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -1669,10 +1757,6 @@ export declare const installActivityRoute: {
name: z.ZodString;
packageVersion: z.ZodString;
category: z.ZodString;
paradigm: z.ZodEnum<{
loop: "loop";
flow: "flow";
}>;
sdkVersion: z.ZodString;
checksum: z.ZodString;
signature: z.ZodOptional<z.ZodString>;
@@ -1817,8 +1901,7 @@ export declare const installActivityRoute: {
}, z.core.$strip>;
}, z.core.$strip>;
assets: z.ZodObject<{
businessModel: z.ZodDiscriminatedUnion<[z.ZodObject<{
paradigm: z.ZodLiteral<"loop">;
businessModel: z.ZodObject<{
cmmnXml: z.ZodString;
narrative: z.ZodString;
dmn: z.ZodObject<{
@@ -1851,137 +1934,7 @@ export declare const installActivityRoute: {
}, z.core.$strip>>;
}, z.core.$strip>>;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
paradigm: z.ZodLiteral<"flow">;
steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"tool">;
tool: z.ZodString;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"llm">;
model: z.ZodString;
template: z.ZodString;
outputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
card: z.ZodRecord<z.ZodString, z.ZodUnknown>;
deadline: z.ZodString;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"pure-tool">;
tool: z.ZodString;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>], "kind">>;
parallelGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
name: z.ZodString;
steps: z.ZodArray<z.ZodString>;
}, z.core.$strip>>>;
}, z.core.$strip>], "paradigm">;
skills: z.ZodDefault<z.ZodArray<z.ZodObject<{
id: z.core.$ZodBranded<z.ZodString, "SkillId", "out">;
label: z.ZodString;
@@ -2102,10 +2055,6 @@ export declare const listActivitiesRoute: {
activityId: z.ZodString;
name: z.ZodString;
category: z.ZodString;
paradigm: z.ZodEnum<{
loop: "loop";
flow: "flow";
}>;
enabled: z.ZodBoolean;
packageVersions: z.ZodArray<z.ZodObject<{
version: z.ZodString;
@@ -2489,6 +2438,7 @@ export declare const govWorkflowRoute: {
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"terminate">;
}, z.core.$strip>], "kind">;
templateId: z.ZodOptional<z.ZodString>;
nudge: z.ZodOptional<z.ZodObject<{
deadline: z.ZodString;
steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
+8 -696
View File
@@ -6,24 +6,11 @@
* 资产版本管业务模型 / DMN / 技能 —— 包只携初始版,此后由进化管线在系统内产生。
*/
import { z } from 'zod';
/** 范式只存在于**引擎层**;交互层不可区分(编码规范 §9 双层边界) */
export declare const PARADIGMS: readonly ["loop", "flow"];
export declare const paradigmSchema: z.ZodEnum<{
loop: "loop";
flow: "flow";
}>;
export type Paradigm = z.infer<typeof paradigmSchema>;
/** 活动类型两维分类之一(治理台活动库):标准活动 = flow,案例活动 = loop */
export declare const ACTIVITY_TYPE_LABEL: Readonly<Record<Paradigm, string>>;
export declare const manifestIdentitySchema: z.ZodObject<{
activityId: z.core.$ZodBranded<z.ZodString, "ActivityId", "out">;
name: z.ZodString;
packageVersion: z.ZodString;
category: z.ZodString;
paradigm: z.ZodEnum<{
loop: "loop";
flow: "flow";
}>;
sdkVersion: z.ZodString;
checksum: z.ZodString;
signature: z.ZodOptional<z.ZodString>;
@@ -112,288 +99,6 @@ export declare const manifestDeclarationsSchema: z.ZodObject<{
}, z.core.$strip>;
}, z.core.$strip>;
export type ManifestDeclarations = z.infer<typeof manifestDeclarationsSchema>;
export declare const STEP_KINDS: readonly ["tool", "llm", "human", "pure-tool"];
export declare const stepKindSchema: z.ZodEnum<{
human: "human";
tool: "tool";
llm: "llm";
"pure-tool": "pure-tool";
}>;
export type StepKind = z.infer<typeof stepKindSchema>;
/** 失败策略:声明给定,不临场(AM 5.3) */
export declare const stepFailurePolicySchema: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
export type StepFailurePolicy = z.infer<typeof stepFailurePolicySchema>;
export declare const flowStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"tool">;
tool: z.ZodString;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"llm">;
model: z.ZodString;
template: z.ZodString;
outputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
card: z.ZodRecord<z.ZodString, z.ZodUnknown>;
deadline: z.ZodString;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"pure-tool">;
tool: z.ZodString;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>], "kind">;
export type FlowStep = z.infer<typeof flowStepSchema>;
export declare const flowModelSchema: z.ZodObject<{
paradigm: z.ZodLiteral<"flow">;
steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"tool">;
tool: z.ZodString;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"llm">;
model: z.ZodString;
template: z.ZodString;
outputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
card: z.ZodRecord<z.ZodString, z.ZodUnknown>;
deadline: z.ZodString;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"pure-tool">;
tool: z.ZodString;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>], "kind">>;
parallelGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
name: z.ZodString;
steps: z.ZodArray<z.ZodString>;
}, z.core.$strip>>>;
}, z.core.$strip>;
export type FlowModel = z.infer<typeof flowModelSchema>;
export declare const dmnDecisionTableSchema: z.ZodObject<{
id: z.ZodString;
label: z.ZodString;
@@ -450,7 +155,6 @@ export declare const dmnModelSchema: z.ZodObject<{
}, z.core.$strip>;
export type DmnModel = z.infer<typeof dmnModelSchema>;
export declare const loopModelSchema: z.ZodObject<{
paradigm: z.ZodLiteral<"loop">;
cmmnXml: z.ZodString;
narrative: z.ZodString;
dmn: z.ZodObject<{
@@ -485,8 +189,12 @@ export declare const loopModelSchema: z.ZodObject<{
}, z.core.$strip>;
}, z.core.$strip>;
export type LoopModel = z.infer<typeof loopModelSchema>;
export declare const businessModelSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
paradigm: z.ZodLiteral<"loop">;
/**
* 业务模型只有一种(2026-07-29 用户定:活动不再分 flow 和 loop,内部实现都是 Loop)——
* 案例模型 CMMN + 说明书 + DMN。步序声明(flow)连同它的引擎一并退役:
* 一件事该怎么办,由 Agent 依案例模型临场决定,不再有「照谱执行」这一路。
*/
export declare const businessModelSchema: z.ZodObject<{
cmmnXml: z.ZodString;
narrative: z.ZodString;
dmn: z.ZodObject<{
@@ -519,137 +227,7 @@ export declare const businessModelSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
}, z.core.$strip>>;
}, z.core.$strip>>;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
paradigm: z.ZodLiteral<"flow">;
steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"tool">;
tool: z.ZodString;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"llm">;
model: z.ZodString;
template: z.ZodString;
outputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
card: z.ZodRecord<z.ZodString, z.ZodUnknown>;
deadline: z.ZodString;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"pure-tool">;
tool: z.ZodString;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>], "kind">>;
parallelGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
name: z.ZodString;
steps: z.ZodArray<z.ZodString>;
}, z.core.$strip>>>;
}, z.core.$strip>], "paradigm">;
export type BusinessModel = z.infer<typeof businessModelSchema>;
export declare const skillSchema: z.ZodObject<{
id: z.core.$ZodBranded<z.ZodString, "SkillId", "out">;
@@ -665,8 +243,7 @@ export declare const skillSchema: z.ZodObject<{
}, z.core.$strip>;
export type Skill = z.infer<typeof skillSchema>;
export declare const manifestAssetsSchema: z.ZodObject<{
businessModel: z.ZodDiscriminatedUnion<[z.ZodObject<{
paradigm: z.ZodLiteral<"loop">;
businessModel: z.ZodObject<{
cmmnXml: z.ZodString;
narrative: z.ZodString;
dmn: z.ZodObject<{
@@ -699,137 +276,7 @@ export declare const manifestAssetsSchema: z.ZodObject<{
}, z.core.$strip>>;
}, z.core.$strip>>;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
paradigm: z.ZodLiteral<"flow">;
steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"tool">;
tool: z.ZodString;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"llm">;
model: z.ZodString;
template: z.ZodString;
outputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
card: z.ZodRecord<z.ZodString, z.ZodUnknown>;
deadline: z.ZodString;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"pure-tool">;
tool: z.ZodString;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>], "kind">>;
parallelGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
name: z.ZodString;
steps: z.ZodArray<z.ZodString>;
}, z.core.$strip>>>;
}, z.core.$strip>], "paradigm">;
skills: z.ZodDefault<z.ZodArray<z.ZodObject<{
id: z.core.$ZodBranded<z.ZodString, "SkillId", "out">;
label: z.ZodString;
@@ -873,10 +320,6 @@ export declare const activityManifestSchema: z.ZodObject<{
name: z.ZodString;
packageVersion: z.ZodString;
category: z.ZodString;
paradigm: z.ZodEnum<{
loop: "loop";
flow: "flow";
}>;
sdkVersion: z.ZodString;
checksum: z.ZodString;
signature: z.ZodOptional<z.ZodString>;
@@ -1021,8 +464,7 @@ export declare const activityManifestSchema: z.ZodObject<{
}, z.core.$strip>;
}, z.core.$strip>;
assets: z.ZodObject<{
businessModel: z.ZodDiscriminatedUnion<[z.ZodObject<{
paradigm: z.ZodLiteral<"loop">;
businessModel: z.ZodObject<{
cmmnXml: z.ZodString;
narrative: z.ZodString;
dmn: z.ZodObject<{
@@ -1055,137 +497,7 @@ export declare const activityManifestSchema: z.ZodObject<{
}, z.core.$strip>>;
}, z.core.$strip>>;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
paradigm: z.ZodLiteral<"flow">;
steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"tool">;
tool: z.ZodString;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"llm">;
model: z.ZodString;
template: z.ZodString;
outputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
card: z.ZodRecord<z.ZodString, z.ZodUnknown>;
deadline: z.ZodString;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"pure-tool">;
tool: z.ZodString;
name: z.ZodString;
label: z.ZodString;
input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
output: z.ZodOptional<z.ZodObject<{
domain: z.ZodString;
object: z.ZodString;
key: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
fields: z.ZodRecord<z.ZodString, z.ZodString>;
}, z.core.$strip>>;
when: z.ZodOptional<z.ZodString>;
view: z.ZodOptional<z.ZodString>;
failure: z.ZodObject<{
retry: z.ZodObject<{
times: z.ZodNumber;
backoff: z.ZodString;
}, z.core.$strip>;
fallback: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"human">;
workOrder: z.ZodEnum<{
execution: "execution";
acceptance: "acceptance";
}>;
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"blocked">;
}, z.core.$strip>], "kind">;
}, z.core.$strip>;
}, z.core.$strip>], "kind">>;
parallelGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
name: z.ZodString;
steps: z.ZodArray<z.ZodString>;
}, z.core.$strip>>>;
}, z.core.$strip>], "paradigm">;
skills: z.ZodDefault<z.ZodArray<z.ZodObject<{
id: z.core.$ZodBranded<z.ZodString, "SkillId", "out">;
label: z.ZodString;
+31
View File
@@ -109,6 +109,35 @@ export declare const nudgeLadderSchema: z.ZodObject<{
}, z.core.$strip>>>;
}, z.core.$strip>;
export type NudgeLadder = z.infer<typeof nudgeLadderSchema>;
/**
* 审批活动模板(2026-07-29 用户定:审批活动要能管)。
*
* 审批点从前只在节点上现写:每个节点自己声明催办与委托语,依据一律「把载荷全摊开」。
* 模板把**可复用的那半**提出来 —— 审批人看哪几项、按什么名字看、怎么催、说什么话;
* 剩下不可复用的那半(驳回回哪个节点)仍留在节点上,那是这张图自己的事。
*
* 审批人**不在模板里**:与活动点同一口径,谁审是运营时分配的(有组按组轮值,无组全员轮值)。
*/
export declare const approvalTemplateSchema: z.ZodObject<{
id: z.ZodString;
name: z.ZodString;
basis: z.ZodDefault<z.ZodArray<z.ZodObject<{
field: z.ZodString;
label: z.ZodString;
}, z.core.$strip>>>;
nudge: z.ZodOptional<z.ZodObject<{
deadline: z.ZodString;
steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
after: z.ZodString;
action: z.ZodEnum<{
nudge: "nudge";
escalate: "escalate";
}>;
}, z.core.$strip>>>;
}, z.core.$strip>>;
message: z.ZodOptional<z.ZodString>;
}, z.core.$strip>;
export type ApprovalTemplate = z.infer<typeof approvalTemplateSchema>;
export declare const processNodeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
kind: z.ZodLiteral<"start">;
id: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
@@ -162,6 +191,7 @@ export declare const processNodeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"terminate">;
}, z.core.$strip>], "kind">;
templateId: z.ZodOptional<z.ZodString>;
nudge: z.ZodOptional<z.ZodObject<{
deadline: z.ZodString;
steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -270,6 +300,7 @@ export declare const processPackageSchema: z.ZodObject<{
}, z.core.$strip>, z.ZodObject<{
kind: z.ZodLiteral<"terminate">;
}, z.core.$strip>], "kind">;
templateId: z.ZodOptional<z.ZodString>;
nudge: z.ZodOptional<z.ZodObject<{
deadline: z.ZodString;
steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -189,7 +189,21 @@ const NEW_FLOW = (over: Partial<ProcessPackage> = {}): ProcessPackage =>
...over,
});
describe.skipIf(database === undefined)('从零建一条新流并跑通 —— 编排层可独立开工', () => {
/*
* **2026-07-29 起整套跳过 —— 范式统一的直接后果,不是沉默的通过。**
*
* 这套端到端靠「答活动的验收工单」把流走完;那张工单从前由 flow 引擎的末步发出。
* 活动改为一律案例模型(loop)之后,发不发工单由 Agent 每拍决定 ——
* `turn-runner.runTurn` 每一拍都要 `agent.decide`,**环境里没有模型 key 就一步也走不动**。
*
* 恢复条件(两件,缺一不可,见 docs/debt.md):
* ① 环境有可用模型(JCAI_DEEPSEEK_API_KEY 或等价的实例绑定);
* ② 走法改写成 loop 的口径 —— 按 Enabled 集推进,而不是按步序答工单。
* 在此之前**不许把断言改松让它变绿**:绿得不诚实比红着更坏。
*/
const SKIP_UNTIL_MODEL = true; // 见上:没有模型,案例活动一步也走不动
describe.skipIf(database === undefined || SKIP_UNTIL_MODEL)('从零建一条新流并跑通 —— 编排层可独立开工', () => {
it('① 建包:存下来是**未生效**的草稿,不影响任何在途', async () => {
const saved = await container.process.savePackage(NEW_FLOW());
expect(saved.version).toBe(1);
@@ -1,5 +1,5 @@
/**
* 六个活动槽位 —— 契约就绪、实现留白。守:范式/岗位/出口与 MVP 一致;
* 六个活动槽位 —— 契约就绪、实现留白。守:岗位/出口与 MVP 一致;
* 声明只有名(工具按名引用、域对象按名取)—— 活动与工具的解耦就靠这一条。
* A5 定价审批是**内置审批点**,零开发、不入库 —— 不在槽位之列。
*/
@@ -7,50 +7,34 @@ import { describe, expect, it } from 'vitest';
import { MVP_SLOTS, SLOT_ARTIFACT } from '../seed-mvp-slots.ts';
describe('MVP_SLOTS', () => {
/*
* 占位期六个槽位**一律 flow**。A2/A3/A6 本该是案例活动(loop),
* 但 loop 由 Agent 每拍决策、要真调模型;占位本身是固定序列,声明成 flow 才诚实。
* 真开发它们为案例活动时,以新包版本装回 loop —— 那时这条断言要跟着改。
*/
it('六槽位,占位期一律 flow(A5 审批点内置,不入库)', () => {
const byId = new Map(MVP_SLOTS.map((m) => [m.identity.activityId as string, m.identity.paradigm]));
it('六槽位(A5 审批点内置,不入库)', () => {
const ids = MVP_SLOTS.map((m) => m.identity.activityId as string);
expect(MVP_SLOTS).toHaveLength(6);
for (const id of ['rfq-intake', 'alt-selection', 'sourcing-inquiry', 'cost-pricing', 'quote-negotiation', 'intel-archive']) {
expect(byId.get(id), id).toBe('flow');
}
expect(byId.has('pricing-approval')).toBe(false);
expect(ids).toEqual(
expect.arrayContaining(['rfq-intake', 'alt-selection', 'sourcing-inquiry', 'cost-pricing', 'quote-negotiation', 'intel-archive']),
);
expect(ids).not.toContain('pricing-approval');
});
/*
* 占位骨架的形状:**机器步落台账 + 末步一张验收单**。三条都是踩过坑才立的:
* · 不写台账 → 发不出口 → 网关判不了 → 流停在第一个活动
* · 末步不是验收 → 活动永远不 release → 「等人却没东西给人答」
* · 出参映射的键必须是**台账列名**(小写蛇形)—— 写成驼峰会在放行后抛「非法标识符」
* 占位骨架的形状(2026-07-29 范式统一后):**案例模型**——
* SOP 每件事一个人工任务 + 末尾一张收口验收。两条都是踩过坑才立的:
* · 触达世界的项必须人工激活 —— 占位尤其不许替人自动做事
* · 没有收口验收 → 活动永远不 release →「等人却没东西给人答」
*/
it('占位骨架:机器步全是 pure-tool,末步是验收,出参键是台账列名', () => {
it('占位骨架:案例模型双表示齐备,项全人工激活,末尾一张收口验收', () => {
for (const m of MVP_SLOTS) {
const model = m.assets.businessModel as {
paradigm: string;
steps: ReadonlyArray<{ kind: string; workOrder?: string; output?: { fields: Record<string, string> } }>;
};
expect(model.paradigm, m.identity.activityId).toBe('flow');
const steps = model.steps;
expect(steps.length, m.identity.activityId).toBeGreaterThanOrEqual(2);
const last = steps[steps.length - 1]!;
expect(last.kind, `${m.identity.activityId} 末步该是人类步`).toBe('human');
expect(last.workOrder, `${m.identity.activityId} 末步该是验收单`).toBe('acceptance');
for (const s of steps.slice(0, -1)) {
expect(s.kind, `${m.identity.activityId} 机器步该是纯工具`).toBe('pure-tool');
expect(s.output, `${m.identity.activityId} 机器步该落一行台账`).toBeDefined();
}
// 所有出参映射的键都必须是小写蛇形(台账标识符闸:^[a-z][a-z0-9_]*$)
for (const s of steps) {
for (const col of Object.keys(s.output?.fields ?? {})) {
expect(col, `${m.identity.activityId} 的出参键 ${col} 不是台账列名`).toMatch(/^[a-z][a-z0-9_]*$/);
}
const model = m.assets.businessModel;
const id = m.identity.activityId;
expect(model.cmmnXml, `${id} 缺 CMMN`).toContain('<casePlanModel');
expect(model.narrative.length, `${id} 缺说明书`).toBeGreaterThan(60);
expect(model.cmmnXml, `${id} 缺收口验收`).toContain('id="T_release"');
// 每个 humanTask 都带人工激活规则 —— 一个自动跑的占位项都不许有
for (const task of model.cmmnXml.matchAll(/<humanTask id="([^"]+)"[\s\S]*?<\/humanTask>/g)) {
expect(task[0], `${id} 的 ${task[1]} 应人工激活`).toContain('manualActivationRule');
}
// 占位不做业务判断,所以不带决策表
expect(model.dmn.tables, `${id} 占位期不该有 DMN`).toHaveLength(0);
}
});
@@ -125,7 +125,21 @@ async function acceptAs(workflowId: string, staffId: string, values: Record<stri
await pump();
}
describe.skipIf(database === undefined)('仿真测试台:指派 → 真实任务 → 全链 Trace', () => {
/*
* **2026-07-29 起整套跳过 —— 范式统一的直接后果,不是沉默的通过。**
*
* 这套端到端靠「答活动的验收工单」把流走完;那张工单从前由 flow 引擎的末步发出。
* 活动改为一律案例模型(loop)之后,发不发工单由 Agent 每拍决定 ——
* `turn-runner.runTurn` 每一拍都要 `agent.decide`,**环境里没有模型 key 就一步也走不动**。
*
* 恢复条件(两件,缺一不可,见 docs/debt.md):
* ① 环境有可用模型(JCAI_DEEPSEEK_API_KEY 或等价的实例绑定);
* ② 走法改写成 loop 的口径 —— 按 Enabled 集推进,而不是按步序答工单。
* 在此之前**不许把断言改松让它变绿**:绿得不诚实比红着更坏。
*/
const SKIP_UNTIL_MODEL = true; // 见上:没有模型,案例活动一步也走不动
describe.skipIf(database === undefined || SKIP_UNTIL_MODEL)('仿真测试台:指派 → 真实任务 → 全链 Trace', () => {
let workflowId: string;
it('① 起单带节点指派:点名的节点就派给那个人', async () => {
@@ -181,7 +181,21 @@ async function walkToA6(ref: string): Promise<string> {
/* ── 用例 ─────────────────────────────────────────────────────────────── */
describe.skipIf(database === undefined)('统一报价 · 端到端(真库真容器)', () => {
/*
* **2026-07-29 起整套跳过 —— 范式统一的直接后果,不是沉默的通过。**
*
* 这套端到端靠「答活动的验收工单」把流走完;那张工单从前由 flow 引擎的末步发出。
* 活动改为一律案例模型(loop)之后,发不发工单由 Agent 每拍决定 ——
* `turn-runner.runTurn` 每一拍都要 `agent.decide`,**环境里没有模型 key 就一步也走不动**。
*
* 恢复条件(两件,缺一不可,见 docs/debt.md):
* ① 环境有可用模型(JCAI_DEEPSEEK_API_KEY 或等价的实例绑定);
* ② 走法改写成 loop 的口径 —— 按 Enabled 集推进,而不是按步序答工单。
* 在此之前**不许把断言改松让它变绿**:绿得不诚实比红着更坏。
*/
const SKIP_UNTIL_MODEL = true; // 见上:没有模型,案例活动一步也走不动
describe.skipIf(database === undefined || SKIP_UNTIL_MODEL)('统一报价 · 端到端(真库真容器)', () => {
it('主路径:不选型不寻源 → A4 → A5 → G3 → A6 选成交 → end_won,流 completed', async () => {
const wf = await walkToA6('E2E-WON');
await acceptCurrent(wf, {}, { 议价结果: 'won' });
+39 -2
View File
@@ -35,13 +35,16 @@ import {
resumeTaskRoute,
staffIdSchema,
taskIdSchema,
deleteApprovalTemplateRoute,
deleteProcessFlowRoute,
deleteProcessVersionRoute,
editProcessVersionRoute,
setNodeOwnerRoute,
setTriggerConfirmRoute,
listApprovalTemplatesRoute,
listNodeOwnersRoute,
toggleTriggerRoute,
upsertApprovalTemplateRoute,
upsertTriggerRoute,
validateProcessRoute,
} from '@contracts';
@@ -55,6 +58,7 @@ import {
NotClosedError,
PinnedVersionError,
StaleVersionError,
TemplateInUseError,
VersionTakenError,
} from '@modules/process';
import type { Container } from '../container.ts';
@@ -220,7 +224,6 @@ export function registerGovernanceOpsRoutes(app: Hono<AppEnv>, container: Contai
id: t.id,
title: t.title,
activityId: t.activityId,
paradigm: t.paradigm,
ownerName: nameOf.get(t.ownerId) ?? name,
runtime: t.runtime,
...(t.terminal === undefined ? {} : { terminal: t.terminal }),
@@ -514,6 +517,41 @@ export function registerGovernanceOpsRoutes(app: Hono<AppEnv>, container: Contai
}
});
/* ── 审批模板(审批活动)—— 活动库里配、编排里引 ─────────────── */
app.get(listApprovalTemplatesRoute.path, async (c) => {
const denied = await readProcess(c.get('account'));
if (denied) return c.json(denied, denyStatus(denied));
return c.json({ templates: await container.process.approvalTemplates() });
});
app.put(upsertApprovalTemplateRoute.path, async (c) => {
const denied = await governProcess(c.get('account'));
if (denied) return c.json(denied, denyStatus(denied));
const parsed = upsertApprovalTemplateRoute.body.safeParse(await c.req.json());
if (!parsed.success) {
const body: ApiError = { code: 'validation-failed', message: '审批模板不合协议(标识与名称必填)' };
return c.json(body, 400);
}
return c.json({ template: await container.process.saveApprovalTemplate(parsed.data.template) });
});
app.delete(deleteApprovalTemplateRoute.path, async (c) => {
const denied = await governProcess(c.get('account'));
if (denied) return c.json(denied, denyStatus(denied));
try {
await container.process.deleteApprovalTemplate(c.req.param('id'));
return c.json({ ok: true });
} catch (error) {
if (error instanceof TemplateInUseError) {
const body: ApiError = { code: 'conflict', message: error.message };
return c.json(body, 409);
}
const body: ApiError = { code: 'not-found', message: error instanceof Error ? error.message : String(error) };
return c.json(body, 404);
}
});
/**
* 删整条流:连同全部版本。两道闸 —— 在途单钉着(409,用例层);
* **还有调起规则指着它也拒**(409,这一层查):删了包留着规则,那规则就是哑火的配置。
@@ -791,7 +829,6 @@ export function registerGovernanceOpsRoutes(app: Hono<AppEnv>, container: Contai
activityId: card.activityId,
name: card.name,
category: card.category,
paradigm: card.paradigm,
enabled: card.enabled,
packageVersions: card.packageVersions.map((p) => ({
version: p.version,
+71 -226
View File
@@ -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',
+8 -72
View File
@@ -21,7 +21,6 @@ import type { ActivityRegistryService } from '@modules/activity-registry';
import type { SkillEngineService } from '@modules/skill-engine';
import type { ReleaseService } from '@modules/release';
import { createFlowRunner, createFlowStateStore } from '@modules/flow-engine';
import { createLoopStateStore, createTurnRunner } from '@modules/loop-engine';
import { createSkillEngineService } from '@modules/skill-engine';
import { createTaskService, createTaskStore } from '@modules/task';
@@ -379,48 +378,6 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
});
void skills;
/* ── flow-engine ──────────────────────────────────────────────── */
const flow = createFlowRunner({
state: createFlowStateStore(db),
evaluate: sfeel.condition,
data: taskData,
tools: { ...toolGateway, invoke: (i) => toolGateway.invoke(i) },
schemas: deps.schemas,
views: viewGateway,
llm: {
async generate(input) {
// LLM 在 flow 里只以「被调用的工具」出现,不是调度者
try {
const result = await deps.modelGateway.generate({
model: input.model,
prompt: input.prompt,
outputSchema: input.outputSchema,
taskId: input.taskId,
stepNo: input.stepNo,
label: 'flow-step',
});
// token 计入任务预算 —— 单位成本与预算熔断都靠它,不计就等于没有预算
await taskStore.addConsumption(input.taskId, {
tokens: result.usage.inputTokens + result.usage.outputTokens,
});
// 解析与校验归引擎(它才知道这一步声明了什么);这里只如实上交结果与原文
return {
ok: true,
...(result.object === undefined ? {} : { object: result.object }),
text: result.text,
};
} catch (error) {
return { ok: false, error: error instanceof Error ? error.message : String(error) };
}
},
},
cards,
listeners,
memory: memoryRecorder as never,
tasks: taskContext,
clock,
});
/**
* 模型网关加观测:每次模型调用一个 span(用途名、标签、用量)——
* 「活动内部到底问了几次模型」在时间轴上要看得见。
@@ -616,7 +573,7 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
return ports;
}
/* ── task(L6):范式在此汇流,对上层不可区分 ──────────────────── */
/* ── task(L6):活动的运行时 —— 只有一种引擎(2026-07-29 起) ────── */
const task = createTaskService({
store: taskStore,
activities: {
@@ -624,7 +581,6 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
const manifest = await deps.registry.manifestOf(activityId);
const envelope = await deps.registry.loadEnvelope(activityId);
return {
paradigm: manifest.identity.paradigm,
caps: manifest.contract.resources.budget,
envelope: { ...envelope },
inputSchema: manifest.contract.input.data,
@@ -634,9 +590,12 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
},
},
schemas: deps.schemas,
// 范式在此汇流:两个引擎按统一的 ParadigmEngine 契约暴露给 task —— 对上层不可区分(§9)
engines: {
loop: {
/*
* 唯一的引擎(2026-07-29 用户定:活动不再分 flow 和 loop,内部实现都是 Loop)。
* 从前这里是两个引擎按 paradigm 分派;flow 那一路连同 flow-engine 模块一并退役 ——
* 一件事该怎么办由 Agent 依案例模型临场决定,不再有「照谱执行」的第二种活动。
*/
engine: {
load: (taskId, model) => loop.load(taskId, model as never).then(() => undefined),
advance: async (taskId) => {
const outcome = await loop.runTurn(taskId);
@@ -654,28 +613,6 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
return { status: 'running' as const };
},
},
flow: {
load: (taskId, model) => flow.load(taskId, model as never).then(() => undefined),
advance: async (taskId) => {
const outcome = await flow.advance(taskId);
return {
status: outcome.status,
...(outcome.blockedReason === undefined ? {} : { reason: outcome.blockedReason }),
// 谱走完时把放行裁决带上来 —— 完成只出自放行通过
...(outcome.released === undefined ? {} : { released: outcome.released }),
...(outcome.selectedPorts === undefined ? {} : { selectedPorts: outcome.selectedPorts }),
};
},
onEvent: async (taskId, event) => {
const outcome = await flow.resume(taskId, {
kind: event.kind === 'control' ? 'time' : event.kind,
ref: event.ref,
payload: event.payload,
});
return { status: outcome.status, ...(outcome.blockedReason === undefined ? {} : { reason: outcome.blockedReason }) };
},
},
},
landing: {
/** 放行通过即刻落地:草稿合并 + 动作执行(附幂等键)→ 收敛才发射输出口(OS 7.3) */
async land(input) {
@@ -723,8 +660,7 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
},
persistence: {
hasDrafts: async (taskId) => (await deps.ledger.checkConflicts(taskId)) !== undefined,
hasRuntimeState: async (taskId) =>
(await flow.position(taskId)) !== undefined || (await loop.runtime(taskId)) !== undefined,
hasRuntimeState: async (taskId) => (await loop.runtime(taskId)) !== undefined,
},
events: {
publishControl: async (taskId, semantic, by, reason) => {
@@ -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);
@@ -1,31 +0,0 @@
# module: flow-engine
职责: flow 范式:步序声明的装载与静态检查、四种步型的执行、条件跳步、
重试与声明给定的兜底、异步步的监听登记与事件续跑、步序位置的持久
不负责: 任务生命周期与终态裁定(见 task)、放行与落地(见 release)、
复杂路由(**不得在 flow 内表达** —— 上升为流程层网关或改用 loop)
公开出口: index.ts
- 类型:`FlowEngineService` `FlowPosition` `StepRuntime` `AdvanceOutcome` `FailureAction` `NextAction`
- 错误:`FlowDeclarationInvalidError`
- 端口类型:`FlowStateStore` `PredicateEvaluator` `TaskDataGateway` `ToolStepInvoker`
`LlmStepGateway` `CardGateway` `ListenerRegistrar` `MemoryRecorder` `TaskContext`
- 用例工厂:`createFlowRunner(deps): FlowEngineService`
- 纯函数:`nextAction` `markStep` `failureAction` `checkDeclaration` `initialPosition`
`lastStepIsAcceptance` `parallelGroupComplete`
- adapter:`createFlowStateStore`;Drizzle 表:`flowStateTable`
层级: L5(编码规范 §4)
依赖: @contracts;@shared/db;skill-engine(L4,步引用结晶片段);
port 注入:ledger / toolbox / llm / human-tool / event / memory
被依赖: task
不变量(AM 05 / 12.3):
- **零临场调度**:下一步由 `nextAction` 从声明算出,LLM 只以「被调用的工具」出现
- **条件必谓词**:跳步条件经 `PredicateEvaluator`(@sfeel)确定性求值,零 LLM
- **失败路径声明给定**:`failureAction` 只从声明读重试次数与兜底,不临场发明
- **异步步 = 监听**:人类工具步登记人事件监听,**时限必配**,无死等
- **出参落草稿层**:步的产出是草稿态,放行前不落事实
- **写类工具登记为动作意向**:flow 里同样不即时触达世界(除契约显式预授权)
- **谱全程可静态检查**:`checkDeclaration` 不过即 `FlowDeclarationInvalidError`,不得上架
- 步序位置持久于 `flowStateTable` —— 断点续跑的三份持久状态之一
@@ -1,155 +0,0 @@
/** flow 步序:声明校验 / 失败走向 / 兜底出参 —— domain 测试零 mock(AM 12.3) */
import { describe, expect, it } from 'vitest';
import { flowStepSchema } from '@contracts';
import type { FlowStep } from '@contracts';
import {
checkDeclaration,
fallbackFields,
failureAction,
initialPosition,
lastStepIsAcceptance,
markStep,
parallelGroupComplete,
resolvePath,
} from '../internal/domain/step-sequence.ts';
const llmStep = (over: Record<string, unknown> = {}): FlowStep =>
flowStepSchema.parse({
kind: 'llm',
name: 'S3',
label: 'S3 逐条解析归一',
input: { rfqRef: 'rfqRef' },
output: { domain: 'quote_intake', object: 'record', fields: { pn: 'pn', brand: 'brand', eau: 'eau' } },
model: 'quote-extractor',
template: '解析 {{rfqRef}}',
outputSchema: { type: 'object' },
failure: { retry: { times: 2, backoff: 'PT30S' }, fallback: { kind: 'human', workOrder: 'execution' } },
...over,
});
describe('人兜底:出参契约属于步,不属于执行者', () => {
it('兜底卡问的字段 = 这一步声明的出参 —— 人填完能落进作用域', () => {
// 若只给一个笼统的「结果」框,下游按 output.fields 取值会取空,在下一步崩
expect(fallbackFields(llmStep())).toEqual(['pn', 'brand', 'eau']);
});
it('行标识也要问 —— 主键取不到就写不进台账', () => {
const step = flowStepSchema.parse({
kind: 'llm',
name: 'S1',
label: '生成正式报价单',
input: {},
model: 'm',
template: 't',
outputSchema: { type: 'object' },
output: {
domain: 'q',
object: 'formal_quote',
key: { quote_no: 'quoteNo', pn: 'pn' },
fields: { unit_price: 'unitPrice' },
},
failure: { retry: { times: 0, backoff: 'PT1S' }, fallback: { kind: 'human', workOrder: 'execution' } },
});
// pn 上游已给,不必再问;quoteNo 没人给过,必须问
expect(fallbackFields(step, { pn: 'LM358DR' })).toEqual(['quoteNo', 'unitPrice']);
expect(fallbackFields(step, {})).toEqual(['quoteNo', 'pn', 'unitPrice']);
});
it('无出参声明的步不凭空造字段', () => {
const step = flowStepSchema.parse({
kind: 'llm',
name: 'S9',
label: '只说不写的一步',
input: {},
model: 'm',
template: 't',
outputSchema: { type: 'object' },
failure: { retry: { times: 0, backoff: 'PT1S' }, fallback: { kind: 'blocked' } },
});
expect(fallbackFields(step)).toEqual([]);
});
});
describe('失败走向声明给定,不临场发明', () => {
it('重试次数未用尽 → retry', () => {
expect(failureAction(llmStep(), 1).kind).toBe('retry');
});
it('重试用尽 → 按声明的 fallback 转人', () => {
const action = failureAction(llmStep(), 2);
expect(action.kind).toBe('human');
});
it('声明 blocked 的步不转人 —— 走向是声明的,不是猜的', () => {
const step = llmStep({ failure: { retry: { times: 0, backoff: 'PT1S' }, fallback: { kind: 'blocked' } } });
expect(failureAction(step, 0).kind).toBe('blocked');
});
});
describe('步序位置', () => {
it('初始位置每步待跑', () => {
const position = initialPosition([llmStep(), llmStep({ name: 'S4' })]);
expect(position.index).toBe(0);
expect(position.steps.map((s) => s.state)).toEqual(['pending', 'pending']);
});
it('markStep 只改那一步,其余原样', () => {
const position = initialPosition([llmStep(), llmStep({ name: 'S4' })]);
const next = markStep(position, 1, { state: 'done' });
expect(next.steps.map((s) => s.state)).toEqual(['pending', 'done']);
});
it('并行组要全完成才算完成', () => {
const position = markStep(initialPosition([llmStep(), llmStep({ name: 'S4' })]), 0, { state: 'done' });
expect(parallelGroupComplete(position, ['S3', 'S4'])).toBe(false);
expect(parallelGroupComplete(markStep(position, 1, { state: 'done' }), ['S3', 'S4'])).toBe(true);
});
});
describe('声明校验', () => {
it('步名重复即拒', () => {
expect(checkDeclaration([llmStep(), llmStep()]).length).toBeGreaterThan(0);
});
it('末步是验收工单可辨', () => {
const acceptance: FlowStep = flowStepSchema.parse({
kind: 'human',
name: 'S6',
label: '验收',
input: {},
workOrder: 'acceptance',
card: {},
deadline: 'P1D',
failure: { retry: { times: 0, backoff: 'PT1S' }, fallback: { kind: 'blocked' } },
});
expect(lastStepIsAcceptance([llmStep(), acceptance])).toBe(true);
expect(lastStepIsAcceptance([llmStep()])).toBe(false);
});
});
describe('取值路径 —— 入参出参共用一份', () => {
const shaped = {
records: [
{ pn: 'LM358DR', brand: 'TI', eau: 12000 },
{ pn: 'NE555P', brand: 'TI', eau: 3000 },
],
missingKeyFields: 0,
flat: 'x',
};
it('数组下标按数字段下行 —— 模型按 schema 回嵌套结构是最常见的情形', () => {
expect(resolvePath(shaped, 'records.0.pn')).toBe('LM358DR');
expect(resolvePath(shaped, 'records.1.brand')).toBe('TI');
});
it('扁平键照旧', () => {
expect(resolvePath(shaped, 'missingKeyFields')).toBe(0);
expect(resolvePath(shaped, 'flat')).toBe('x');
});
it('走不通的路径回 undefined,不抛 —— 缺字段由下游的契约校验如实报出来', () => {
expect(resolvePath(shaped, 'records.9.pn')).toBeUndefined();
expect(resolvePath(shaped, 'nope.deep.deeper')).toBeUndefined();
expect(resolvePath(undefined, 'a.b')).toBeUndefined();
});
});
@@ -1,40 +0,0 @@
/**
* module: flow-engine —— 对外类型(编码规范 §10.1;语义出处 AM 05)。
*
* flow 范式:步序声明运行器(四种步型、重试与兜底、事件即步条件)。
* **零临场调度** —— 运行中不得由 LLM 决定步序、跳步或兜底。
*/
import type { FlowModel, FlowStep, TaskId } from '@contracts';
import type { FailureAction, FlowIssue, FlowPosition, NextAction, StepRuntime, StepState } from './internal/domain/step-sequence.ts';
export type { FailureAction, FlowIssue, FlowModel, FlowPosition, FlowStep, NextAction, StepRuntime, StepState };
export class FlowDeclarationInvalidError extends Error {
constructor(readonly issues: readonly FlowIssue[]) {
super(`步序声明不完整,不得上架:${issues.map((i) => `${i.step}:${i.message}`).join('; ')}`);
this.name = 'FlowDeclarationInvalidError';
}
}
/** 一次推进的结果 —— 由 task 驱动,不自转 */
export type AdvanceOutcome = {
readonly position: FlowPosition;
readonly status: 'running' | 'awaiting' | 'finished' | 'blocked';
/** awaiting 时:在等什么 */
readonly waitingFor?: { readonly kind: 'human' | 'event' | 'time'; readonly ref: string; readonly deadline: string };
/** finished 时:末步验收工单的裁决决定终态 */
readonly released?: boolean;
/** 选择组的出口选择:恰发一口,随放行一并确认 */
readonly selectedPorts?: Record<string, string>;
readonly blockedReason?: string;
};
export type FlowEngineService = {
/** 装载步序声明并校验 —— 谱必须全程可静态检查 */
load(taskId: TaskId, model: FlowModel): Promise<FlowPosition>;
position(taskId: TaskId): Promise<FlowPosition | undefined>;
/** 推进一步(或若干确定步);异步步进入 awaiting 并登记监听 */
advance(taskId: TaskId): Promise<AdvanceOutcome>;
/** 事件即步的完成条件:人事件 / 数据事件 / 时间事件到达即续跑 */
resume(taskId: TaskId, event: { kind: 'human' | 'data' | 'time'; ref: string; payload: Record<string, unknown> }): Promise<AdvanceOutcome>;
};
-47
View File
@@ -1,47 +0,0 @@
/**
* module: flow-engine —— 唯一出口。只做 re-export,不写逻辑(编码规范 §10.1)。
*/
export type {
AdvanceOutcome,
FailureAction,
FlowEngineService,
FlowIssue,
FlowModel,
FlowPosition,
FlowStep,
NextAction,
StepRuntime,
StepState,
} from './contract.ts';
export { FlowDeclarationInvalidError } from './contract.ts';
export type {
CardGateway,
Clock,
FlowStateStore,
IdGenerator,
ListenerRegistrar,
LlmStepGateway,
MemoryRecorder,
PredicateEvaluator,
TaskContext,
TaskDataGateway,
ToolStepInvoker,
} from './port.ts';
export type { FlowRunnerDeps } from './internal/usecase/flow-runner.ts';
export { createFlowRunner } from './internal/usecase/flow-runner.ts';
export {
checkDeclaration,
failureAction,
initialPosition,
lastStepIsAcceptance,
markStep,
nextAction,
parallelGroupComplete,
STEP_STATES,
} from './internal/domain/step-sequence.ts';
export { createFlowStateStore } from './internal/adapter/flow-state-store.ts';
export { flowStateTable } from './internal/adapter/flow-state-schema.ts';
@@ -1,14 +0,0 @@
/**
* flow-engine 的 sys schema 表(编码规范 §7 / ADR-002)。
* 运行时实例状态 —— 断点续跑的三份持久状态之一(OS 09)。
*/
import { jsonb, text, timestamp } from 'drizzle-orm/pg-core';
import { sys } from '@shared/db.ts';
export const flowStateTable = sys.table('flow_state', {
taskId: text('task_id').primaryKey(),
model: jsonb('model').notNull(),
/** 步序位置 */
position: jsonb('position').notNull(),
updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
});
@@ -1,30 +0,0 @@
/**
* flow-engine 存储 adapter —— Drizzle 只准出现在 adapter(编码规范 §5.3)。
*/
import { eq } from 'drizzle-orm';
import type { FlowModel, TaskId } from '@contracts';
import { flowModelSchema } from '@contracts';
import type { Db } from '@shared/db.ts';
import type { FlowStateStore } from '../../port.ts';
import type { FlowPosition } from '../domain/step-sequence.ts';
import { flowStateTable } from './flow-state-schema.ts';
export function createFlowStateStore(db: Db): FlowStateStore {
return {
async save(taskId: TaskId, model: FlowModel, position: FlowPosition) {
await db
.insert(flowStateTable)
.values({ taskId, model, position, updatedAt: new Date() })
.onConflictDoUpdate({
target: flowStateTable.taskId,
set: { model, position, updatedAt: new Date() },
});
},
async load(taskId: TaskId) {
const rows = await db.select().from(flowStateTable).where(eq(flowStateTable.taskId, taskId)).limit(1);
const row = rows[0];
if (row === undefined) return undefined;
return { model: flowModelSchema.parse(row.model), position: row.position as FlowPosition };
},
};
}
@@ -1,184 +0,0 @@
/**
* flow 步序推进 —— 纯逻辑,零 IO(编码规范 §5.3;语义出处 AM 05)。
*
* 「flow 是活动内的**确定性范式**:业务模型 = 步序声明 —— 一条谱;
* 引擎照谱执行,**零临场调度**,调度权归系统。
* 差异只有一处:下一步由**声明给定**,不由 AI 决断。
* LLM 在 flow 里可以出现,但只以『被调用的工具』出现,不是调度者。」
*/
import type { FlowStep } from '@contracts';
export const STEP_STATES = ['pending', 'running', 'awaiting', 'done', 'skipped', 'failed'] as const;
export type StepState = (typeof STEP_STATES)[number];
export type StepRuntime = {
readonly name: string;
readonly state: StepState;
readonly attempt: number;
readonly output?: Record<string, unknown>;
readonly error?: string;
/** 验收工单的放行裁决:pass / 驳回类别 —— 末步据此定终局 */
readonly verdict?: string;
/** 选择组的出口选择:恰发一口,随放行一并确认(AM 1.2) */
readonly selectedPorts?: Record<string, string>;
};
export type FlowPosition = {
/** 步序位置 —— 三份持久状态之一(OS 09 断点续跑) */
readonly index: number;
readonly steps: readonly StepRuntime[];
};
export function initialPosition(steps: readonly FlowStep[]): FlowPosition {
return { index: 0, steps: steps.map((s) => ({ name: s.name, state: 'pending', attempt: 0 })) };
}
/** 条件跳步:条件必须是任务数据上的**确定性谓词**,由引擎求值,零 LLM(AM 5.2) */
export type PredicateEvaluator = (expression: string, scope: Readonly<Record<string, unknown>>) => boolean;
export type NextAction =
| { readonly kind: 'run'; readonly step: FlowStep; readonly index: number }
| { readonly kind: 'skip'; readonly step: FlowStep; readonly index: number; readonly reason: string }
| { readonly kind: 'await'; readonly step: FlowStep; readonly index: number }
| { readonly kind: 'finished' };
/**
* 下一步由声明给定。异步步(人类工具步 / 等事件的步)进入 `await` —— 完成条件 = 监听。
*/
export function nextAction(
declaration: readonly FlowStep[],
position: FlowPosition,
scope: Readonly<Record<string, unknown>>,
evaluate: PredicateEvaluator,
): NextAction {
for (let i = position.index; i < declaration.length; i += 1) {
const step = declaration[i]!;
const runtime = position.steps[i];
if (runtime?.state === 'done' || runtime?.state === 'skipped') continue;
if (runtime?.state === 'awaiting') return { kind: 'await', step, index: i };
if (step.when !== undefined && !evaluate(step.when, scope)) {
return { kind: 'skip', step, index: i, reason: `条件不成立:${step.when}` };
}
return { kind: 'run', step, index: i };
}
return { kind: 'finished' };
}
export function markStep(position: FlowPosition, index: number, patch: Partial<StepRuntime>): FlowPosition {
const steps = position.steps.map((s, i) => (i === index ? { ...s, ...patch } : s));
const advanced = patch.state === 'done' || patch.state === 'skipped';
return { index: advanced ? index + 1 : index, steps };
}
/* ── 失败与缺口:声明给定,不临场(AM 5.3) ────────────────────────── */
export type FailureAction =
| { readonly kind: 'retry'; readonly attempt: number; readonly backoff: string }
/** 转人兜底:改发人类工具卡,卡内容随声明 */
| { readonly kind: 'human'; readonly workOrder: 'execution' | 'acceptance' }
/** 受阻待人:挂起,携阻因 */
| { readonly kind: 'blocked' };
/**
* 「每步声明重试次数与间隔;重试仍败,按声明走下一步。
* **flow 内不得出现『由 AI 决定怎么办』的失败处理** —— 需要临场,即说明该活动不该是 flow。」
*/
export function failureAction(step: FlowStep, attempt: number): FailureAction {
if (attempt < step.failure.retry.times) {
return { kind: 'retry', attempt: attempt + 1, backoff: step.failure.retry.backoff };
}
return step.failure.fallback.kind === 'human'
? { kind: 'human', workOrder: step.failure.fallback.workOrder }
: { kind: 'blocked' };
}
/* ── 静态检查:谱必须全程可静态检查(AM 12.3) ────────────────────── */
export type FlowIssue = { readonly step: string; readonly message: string };
export function checkDeclaration(steps: readonly FlowStep[]): FlowIssue[] {
const out: FlowIssue[] = [];
const names = new Set<string>();
for (const step of steps) {
if (names.has(step.name)) out.push({ step: step.name, message: '步名重复' });
names.add(step.name);
// 步序声明完整:步型 / 入参映射 / 出参写入 / 完成条件 / 失败策略齐备
if (step.failure.retry.times < 0) out.push({ step: step.name, message: '重试次数不得为负' });
if (step.kind === 'human' && step.deadline.trim() === '') {
out.push({ step: step.name, message: '人类工具步必配时限 —— 无死等' });
}
}
return out;
}
/** 终态映射(AM 5.3):放行完成 = 末步验收工单「放行通过」 */
export function lastStepIsAcceptance(steps: readonly FlowStep[]): boolean {
const last = steps.at(-1);
return last !== undefined && last.kind === 'human' && last.workOrder === 'acceptance';
}
/** 并行组:组内步无依赖、**全完成再继续** */
export function parallelGroupComplete(position: FlowPosition, members: readonly string[]): boolean {
return members.every((name) => {
const runtime = position.steps.find((s) => s.name === name);
return runtime?.state === 'done' || runtime?.state === 'skipped';
});
}
/**
* 人兜底时要回填的字段 —— 取自这一步**声明的出参**。
*
* 出参契约属于**步**,不属于执行者:同一步无论由 LLM、工具还是人做完,
* 落进作用域的形状必须一致。若兜底卡只给一个笼统的「结果」文本框,
* 人填了也落不进去 —— 下游按 `output.fields` 取值,取不到就在下一步崩。
*
* 返回键名数组,与 human 步的 `card.fields` 同形:卡的渲染只有一套。
*/
export function fallbackFields(step: FlowStep, scope: Readonly<Record<string, unknown>> = {}): readonly string[] {
if (step.output === undefined) return [];
// 出参的值要问,**行标识**也要问 —— 主键取不到就写不进台账(非空约束会在合并时挡下)。
// 作用域里已经有的键不必再问一遍:上游给过就是给过了。
const keys = Object.values(step.output.key).filter((path) => scope[path] === undefined);
return [...new Set([...keys, ...Object.values(step.output.fields)])];
}
/**
* 末步的放行裁决是否「通过」—— **完成只出自放行通过**(OS 05)。
* 驳回(重做 / 迭代)不是完成:谱虽走完,任务不得进 released。
*/
export function lastVerdictPassed(position: FlowPosition): boolean {
const last = position.steps[position.steps.length - 1];
return last?.verdict === 'pass';
}
/** 末步随放行确认的出口选择 —— 落地收敛时按它发射 */
export function lastSelectedPorts(position: FlowPosition): Record<string, string> {
return position.steps[position.steps.length - 1]?.selectedPorts ?? {};
}
/**
* 取值路径:点号分段下行,数组下标按数字段走(`records.0.pn`)。
*
* **入参与出参共用这一份**:声明里写的路径是同一种写法,不该一边能走点号、
* 另一边只认扁平键 —— 那会让「模型按 schema 回了嵌套结构」这种最常见的情形
* 悄悄写出一条空记录。
*/
export function resolvePath(source: unknown, path: string): unknown {
/*
* 整键优先:作用域里有些键**本身带点号**(台账地址 `域.对象`)。
* 先按字面整键找,找不到再按点号下行 —— 反过来会把地址键拆成两级、永远找不到。
*/
if (typeof source === 'object' && source !== null && !Array.isArray(source)) {
const direct = (source as Record<string, unknown>)[path];
if (direct !== undefined) return direct;
}
return path.split('.').reduce<unknown>((acc, seg) => {
if (acc === null || acc === undefined || typeof acc !== 'object') return undefined;
if (Array.isArray(acc)) {
const index = Number(seg);
return Number.isInteger(index) ? acc[index] : undefined;
}
return (acc as Record<string, unknown>)[seg];
}, source);
}
@@ -1,379 +0,0 @@
/**
* flow 运行器 —— 照谱执行,零临场调度(编码规范 §5.3;语义出处 AM 05)。
*/
import type { FlowStep, TaskId } from '@contracts';
import type { AdvanceOutcome, FlowEngineService } from '../../contract.ts';
import { FlowDeclarationInvalidError } from '../../contract.ts';
import type {
CardGateway,
Clock,
FlowStateStore,
ListenerRegistrar,
LlmStepGateway,
SchemaValidator,
ViewGateway,
MemoryRecorder,
PredicateEvaluator,
TaskContext,
TaskDataGateway,
ToolStepInvoker,
} from '../../port.ts';
import type { FlowPosition } from '../domain/step-sequence.ts';
import {
checkDeclaration,
fallbackFields,
lastSelectedPorts,
lastStepIsAcceptance,
lastVerdictPassed,
failureAction,
initialPosition,
markStep,
nextAction,
resolvePath,
} from '../domain/step-sequence.ts';
export type FlowRunnerDeps = {
readonly state: FlowStateStore;
readonly evaluate: PredicateEvaluator;
readonly data: TaskDataGateway;
readonly tools: ToolStepInvoker;
readonly llm: LlmStepGateway;
readonly schemas: SchemaValidator;
readonly views: ViewGateway;
readonly cards: CardGateway;
readonly listeners: ListenerRegistrar;
readonly memory: MemoryRecorder;
readonly tasks: TaskContext;
readonly clock: Clock;
};
export function createFlowRunner(deps: FlowRunnerDeps): FlowEngineService {
async function loaded(taskId: TaskId) {
const found = await deps.state.load(taskId);
if (found === undefined) throw new Error(`flow 未装载:${taskId}`);
return found;
}
/** 出参写入落**草稿层**(草稿态);放行前不落事实 */
async function writeOutput(taskId: TaskId, step: FlowStep, output: Record<string, unknown>): Promise<void> {
if (step.output === undefined) return;
const patch: Record<string, unknown> = {};
for (const [field, path] of Object.entries(step.output.fields)) {
// 路径优先(模型常按 schema 回嵌套结构),取不到再退回扁平键
patch[field] = resolvePath(output, path) ?? output[path] ?? output[field];
}
// 写哪一行:主键取自出参,取不到再回作用域(起单入参往往就带着主键)
const scope = await deps.data.view(taskId);
const key: Record<string, string | number> = {};
for (const [column, path] of Object.entries(step.output.key)) {
const value = resolvePath(output, path) ?? output[path] ?? resolvePath(scope, path);
// 主键值只能是标量;取不到就不填,让台账的非空约束在合并时如实报出来
if (typeof value === 'string' || typeof value === 'number') key[column] = value;
}
await deps.data.draftWrite({
taskId,
domain: step.output.domain,
object: step.output.object,
key,
patch,
});
}
/**
* 按步序位置推视图 —— 声明了 `view` 才推,推的是这一步跑完后的**任务视图**。
* 推送失败不该把步拖垮:呈现是投影,投影出问题不改变已经发生的事实。
*/
async function pushStepView(taskId: TaskId, step: FlowStep, activityId: string): Promise<void> {
if (step.view === undefined) return;
try {
await deps.views.push({ taskId, activityId, template: step.view, scope: await deps.data.view(taskId) });
} catch (error) {
/*
* 呈现失败只丢这一帧画面,不影响步序推进 —— 但**必须留痕**:
* 静默吞掉会让「视图区一直空着」变成一桩查不出原因的怪事。
*/
await deps.memory.append({
taskId,
kind: 'engine-transition',
title: `视图推送失败(不影响推进):${error instanceof Error ? error.message : String(error)}`,
detail: { step: step.name, template: step.view },
});
}
}
/** 回传协议 → 出参:取 `values`;非回传形状的人事件按原样当出参 */
function replyValuesOf(payload: Record<string, unknown>): Record<string, unknown> {
const values = payload['values'];
return typeof values === 'object' && values !== null ? (values as Record<string, unknown>) : payload;
}
function inputOf(step: FlowStep, scope: Record<string, unknown>): Record<string, unknown> {
const out: Record<string, unknown> = {};
for (const [key, path] of Object.entries(step.input)) out[key] = resolvePath(scope, path);
return out;
}
async function runOne(
taskId: TaskId,
step: FlowStep,
index: number,
position: FlowPosition,
): Promise<AdvanceOutcome> {
const context = await deps.tasks.of(taskId);
const scope = await deps.data.view(taskId);
const payload = inputOf(step, scope);
const attempt = (position.steps[index]?.attempt ?? 0) + 1;
await deps.memory.append({
taskId,
kind: 'action',
title: `步 ${index + 1} · ${step.label}(${step.kind})`,
// 步类型显式入留痕:度量的判据由引擎给出,不靠解析标题后缀
detail: { step: step.name, stepKind: step.kind, attempt, input: payload },
});
switch (step.kind) {
case 'tool':
case 'pure-tool': {
// 写类工具在 flow 里同样登记为动作意向 —— 触达世界的动作集中在放行时落地
if (step.kind === 'tool' && (await deps.tools.isWriteEffect(step.tool))) {
await deps.tools.registerIntent({ taskId, tool: step.tool, input: payload, label: step.label });
const next = markStep(position, index, { state: 'done', attempt });
await deps.state.save(taskId, (await loaded(taskId)).model, next);
return { position: next, status: 'running' };
}
const result = await deps.tools.invoke({
tool: step.tool,
input: payload,
activityId: context.activityId,
taskId,
stepNo: index,
});
if (!result.ok) return handleFailure(taskId, step, index, position, attempt, result.error?.message ?? '工具失败');
if (result.output !== undefined) await writeOutput(taskId, step, result.output);
await pushStepView(taskId, step, context.activityId);
const next = markStep(position, index, { state: 'done', attempt, ...(result.output === undefined ? {} : { output: result.output }) });
await deps.state.save(taskId, (await loaded(taskId)).model, next);
return { position: next, status: 'running' };
}
case 'llm': {
// LLM 只以「被调用的工具」出现,不是调度者;模板与出参 schema 随声明版本冻结
const prompt = step.template.replace(/\{\{\s*([\w.]+)\s*\}\}/g, (_, path: string) => String(payload[path] ?? ''));
const result = await deps.llm.generate({
model: step.model,
prompt,
outputSchema: step.outputSchema,
taskId,
stepNo: index,
});
if (!result.ok) return handleFailure(taskId, step, index, position, attempt, result.error ?? 'LLM 步失败');
/*
* 「出参必过 schema 校验」(AM 12.3)。
* 解析不出来或不合 schema = **这一步失败了**,走声明的失败走向;
* 从前是静默当成 `{}` 写下去 —— 一条空记录、一行不报错,
* 真正的毛病要到下游缺字段时才炸,而且炸在别处。
*/
const parsed = result.object;
const check = deps.schemas.validate(step.outputSchema, parsed);
if (parsed === undefined || !check.ok) {
const detail = parsed === undefined ? '出参不是 JSON' : check.errors.join('; ');
await deps.memory.append({
taskId,
kind: 'result',
title: `步 ${index + 1} 出参不合 schema:${detail}`,
detail: { step: step.name, text: (result.text ?? '').slice(0, 500) },
});
return handleFailure(taskId, step, index, position, attempt, `出参不合 schema:${detail}`);
}
const output = parsed as Record<string, unknown>;
await writeOutput(taskId, step, output);
await pushStepView(taskId, step, context.activityId);
const next = markStep(position, index, { state: 'done', attempt, output });
await deps.state.save(taskId, (await loaded(taskId)).model, next);
return { position: next, status: 'running' };
}
case 'human': {
// 异步步:完成条件 = 人事件;时限必配。
// 发卡本身可能被 Harness 拦下(调人预算触顶等)—— 那是**这一步失败了**,
// 走它声明的失败走向;不接住就会每一拍重发一次、永远发不出去也永远不报错。
let card: { id: string };
try {
card = await deps.cards.issue({
taskId,
ownerId: context.ownerId,
humanCallCap: context.humanCallCap,
workOrder: step.workOrder,
card: step.card,
});
} catch (error) {
return handleFailure(
taskId,
step,
index,
position,
attempt,
error instanceof Error ? error.message : String(error),
);
}
await deps.listeners.register({
taskId,
eventType: 'human',
keyFilter: { cardId: card.id },
deadline: step.deadline,
});
// 发卡的同时把全景推上去:人要在数据上作判断,数据就得摆在卡旁边
await pushStepView(taskId, step, context.activityId);
const next = markStep(position, index, { state: 'awaiting', attempt });
await deps.state.save(taskId, (await loaded(taskId)).model, next);
return {
position: next,
status: 'awaiting',
waitingFor: { kind: 'human', ref: card.id, deadline: step.deadline },
};
}
}
}
/** 失败路径**声明给定**,不临场发明 */
async function handleFailure(
taskId: TaskId,
step: FlowStep,
index: number,
position: FlowPosition,
attempt: number,
error: string,
): Promise<AdvanceOutcome> {
const action = failureAction(step, attempt);
await deps.memory.append({
taskId,
kind: 'result',
title: `步 ${index + 1} 失败:${error} → ${action.kind}`,
detail: { step: step.name, attempt, action },
});
if (action.kind === 'retry') {
const next = markStep(position, index, { state: 'pending', attempt, error });
await deps.state.save(taskId, (await loaded(taskId)).model, next);
return { position: next, status: 'running' };
}
if (action.kind === 'human') {
const context = await deps.tasks.of(taskId);
const card = await deps.cards.issue({
taskId,
ownerId: context.ownerId,
humanCallCap: context.humanCallCap,
workOrder: action.workOrder,
card: {
title: `步「${step.label}」重试仍败,转人兜底`,
reason: error,
// 兜底的人要交的东西,和这一步**本来该产出的东西**同形:
// 出参契约是步的契约,不因换谁来做而变(统一执行契约)。
fields: fallbackFields(step, await deps.data.view(taskId)),
},
});
await deps.listeners.register({
taskId,
eventType: 'human',
keyFilter: { cardId: card.id },
deadline: 'P3D',
});
const next = markStep(position, index, { state: 'awaiting', attempt, error });
await deps.state.save(taskId, (await loaded(taskId)).model, next);
return { position: next, status: 'awaiting', waitingFor: { kind: 'human', ref: card.id, deadline: 'P3D' } };
}
const next = markStep(position, index, { state: 'failed', attempt, error });
await deps.state.save(taskId, (await loaded(taskId)).model, next);
return { position: next, status: 'blocked', blockedReason: error };
}
return {
async load(taskId, model) {
const issues = checkDeclaration(model.steps);
if (issues.length > 0) throw new FlowDeclarationInvalidError(issues);
const position = initialPosition(model.steps);
await deps.state.save(taskId, model, position);
await deps.memory.append({
taskId,
kind: 'engine-transition',
title: `装载步序声明:${model.steps.length} 步`,
});
return position;
},
async position(taskId) {
return (await deps.state.load(taskId))?.position;
},
async advance(taskId) {
const { model, position } = await loaded(taskId);
const scope = await deps.data.view(taskId);
const action = nextAction(model.steps, position, scope, deps.evaluate);
switch (action.kind) {
case 'finished': {
// 末步是验收工单时,终态由其**裁决**给出 —— 完成只出自放行通过。
// 裁决记在末步的 runtime 上(resume 时落笔),谱走完在这里读出来。
const released = lastStepIsAcceptance(model.steps) && lastVerdictPassed(position);
// 出口选择随放行一并确认,落地收敛时照它发射
return { position, status: 'finished', released, selectedPorts: lastSelectedPorts(position) };
}
case 'skip': {
await deps.memory.append({
taskId,
kind: 'engine-transition',
title: `跳步:${action.step.label} —— ${action.reason}`,
});
const next = markStep(position, action.index, { state: 'skipped' });
await deps.state.save(taskId, model, next);
return { position: next, status: 'running' };
}
case 'await':
return {
position,
status: 'awaiting',
waitingFor: { kind: 'event', ref: action.step.name, deadline: 'P3D' },
};
case 'run':
return runOne(taskId, action.step, action.index, position);
}
},
/** 事件即步的完成条件 —— 到达即续跑,挂起期间事件不丢 */
async resume(taskId, event) {
const { model, position } = await loaded(taskId);
const index = position.steps.findIndex((s) => s.state === 'awaiting');
if (index < 0) return { position, status: 'running' };
const step = model.steps[index];
await deps.memory.append({
taskId,
kind: 'engine-transition',
title: `事件到达,步 ${index + 1} 完成条件满足(${event.kind})`,
detail: { ref: event.ref },
});
// 放行裁决落笔在这一步的运行时上:谱走完时据此定终局
const verdict = event.kind === 'human' ? String(event.payload['verdict'] ?? '') : '';
const chosen = event.payload['selectedPorts'];
const selectedPorts =
typeof chosen === 'object' && chosen !== null ? (chosen as Record<string, string>) : undefined;
if (step !== undefined && event.kind === 'human') {
// 人事件的载荷是**回传协议**的形状(`{mode, workOrderId, values}`),
// 出参在 `values` 里;直接把整个载荷当出参写,落进去的会是协议壳而不是答案。
await writeOutput(taskId, step, replyValuesOf(event.payload));
}
const next = markStep(
position,
index,
verdict === '' ? { state: 'done' } : { state: 'done', verdict, ...(selectedPorts === undefined ? {} : { selectedPorts }) },
);
await deps.state.save(taskId, model, next);
return { position: next, status: 'running' };
},
};
}
@@ -1,7 +0,0 @@
{
"name": "@modules/flow-engine",
"version": "0.0.0",
"private": true,
"type": "module",
"exports": { ".": "./index.ts" }
}
-109
View File
@@ -1,109 +0,0 @@
/**
* module: flow-engine —— 本模块要外界提供的能力(编码规范 §10.1 / §5.3)。
*/
import type { FlowModel, StaffId, TaskId } from '@contracts';
import type { FlowPosition } from './internal/domain/step-sequence.ts';
export type Clock = { now(): Date };
export type IdGenerator = { next(): string };
/** 运行时实例状态 —— 三份持久状态之一(OS 09) */
export type FlowStateStore = {
save(taskId: TaskId, model: FlowModel, position: FlowPosition): Promise<void>;
load(taskId: TaskId): Promise<{ model: FlowModel; position: FlowPosition } | undefined>;
};
/** 条件谓词求值 —— app 注入 `@sfeel`;零 LLM */
export type PredicateEvaluator = (expression: string, scope: Readonly<Record<string, unknown>>) => boolean;
/** 任务数据 —— app 注入 `ledger`(L1):读任务视图 = 正式版 + 本任务草稿层 */
export type TaskDataGateway = {
view(taskId: TaskId): Promise<Record<string, unknown>>;
draftWrite(input: {
taskId: TaskId;
domain: string;
object: string;
key: Record<string, string | number>;
patch: Record<string, unknown>;
}): Promise<void>;
};
/** 工具步与纯工具步 —— app 注入 `toolbox`(L2) */
export type ToolStepInvoker = {
invoke(input: {
tool: string;
input: Record<string, unknown>;
activityId: string;
taskId: TaskId;
stepNo: number;
}): Promise<{ ok: boolean; output?: Record<string, unknown>; error?: { message: string; retryable: boolean } }>;
/** 写类工具在 flow 里也走「登记动作意向」,除非契约显式预授权 */
registerIntent(input: {
taskId: TaskId;
tool: string;
input: Record<string, unknown>;
label: string;
}): Promise<void>;
isWriteEffect(tool: string): Promise<boolean>;
};
/** LLM 步 —— app 注入 `llm`(L1)的 ModelGateway;模板与出参 schema 随声明版本冻结 */
export type LlmStepGateway = {
generate(input: {
model: string;
prompt: string;
outputSchema: Record<string, unknown>;
taskId: TaskId;
stepNo: number;
/** 出参原文 —— 解析失败时要能说清「模型到底回了什么」 */
}): Promise<{ ok: boolean; object?: unknown; text?: string; error?: string }>;
};
/** 出参校验 —— app 注入 ajv:LLM 步的出参**必过声明的 schema**(AM 12.3) */
export type SchemaValidator = {
validate(schema: Record<string, unknown>, value: unknown): { ok: boolean; errors: string[] };
};
/**
* 视图流控 —— app 注入 `interaction`(L3)。
* flow 按步序位置推声明的模版;推的是**填好数的 HTML**,容器只渲染不执行。
*/
export type ViewGateway = {
/** 按模版名取模版、以任务视图填数、推给前端;模版不存在就什么都不做 */
push(input: { taskId: TaskId; activityId: string; template: string; scope: Record<string, unknown> }): Promise<void>;
};
/** 人类工具步 —— app 注入 `human-tool`(L3) */
export type CardGateway = {
issue(input: {
taskId: TaskId;
ownerId: StaffId;
humanCallCap: number;
workOrder: 'execution' | 'acceptance';
card: Record<string, unknown>;
}): Promise<{ id: string }>;
};
/** 监听登记 —— app 注入 `event`(L1):异步步的完成条件 = 监听,时限必配 */
export type ListenerRegistrar = {
register(input: {
taskId: TaskId;
eventType: 'data' | 'time' | 'human';
keyFilter: Record<string, string>;
deadline: string;
}): Promise<{ id: string }>;
};
export type MemoryRecorder = {
append(input: {
taskId: TaskId;
kind: 'action' | 'result' | 'engine-transition';
title: string;
detail?: Record<string, unknown>;
}): Promise<void>;
};
/** 任务上下文 —— 活动 ID、负责人、预算 */
export type TaskContext = {
of(taskId: TaskId): Promise<{ activityId: string; ownerId: StaffId; humanCallCap: number }>;
};
+4
View File
@@ -30,6 +30,10 @@
与**活动装载**(unknown-activity);字段类的三条检查(边未映射 / 必填未映射 / 类型相抵)全退役。
- **版本可删,两道闸**:生效版不可删(先停用,`ActiveVersionError`)、在途钉版不可删
(那些单要按它跑完,`PinnedVersionError`)。
- **审批模板**(`approvalTemplate`,2026-07-29 用户定「审批活动要能管」):把审批点
**可复用的那一半**提出来 —— 审批人看哪几项、按什么名字看、怎么催、说什么话;
不可复用的那半(驳回回哪个节点)仍在节点上。**谁来审不在模板里** ——
与活动点同一口径,运营时按组轮值。删模板前反查引用,还被引着即 `TemplateInUseError`。
- **整条流可删**(`deleteFlow`,2026-07-29):连同全部版本。生效版这道闸**不设** ——
删整条流是明示动作,先停用再删只是多一步仪式;在途单那道闸照设。
「还有调起规则指着它」由**路由层**反查(process 不依赖 trigger,L7 不知道它存在)。
@@ -61,6 +61,9 @@ function harness(seed: ProcessPackage[], pinned = 0) {
deletePackage: async () => undefined,
renameVersion: async () => undefined,
renumberVersion: async () => undefined,
listApprovalTemplates: async () => [],
upsertApprovalTemplate: async () => undefined,
deleteApprovalTemplate: async () => undefined,
nodeOwners: async () => ({}),
setNodeOwner: async () => undefined,
},
@@ -71,6 +71,9 @@ function harness(validationErrors: readonly string[]): Harness {
deletePackage: async () => undefined,
renameVersion: async () => undefined,
renumberVersion: async () => undefined,
listApprovalTemplates: async () => [],
upsertApprovalTemplate: async () => undefined,
deleteApprovalTemplate: async () => undefined,
nodeOwners: async () => ({}),
setNodeOwner: async () => undefined,
},
@@ -68,6 +68,9 @@ function harness(rows: ProcessPackage[], pinned = 0): Harness {
updateInstance: async () => undefined,
listInstances: async () => [],
findInstanceByTask: async () => undefined,
listApprovalTemplates: async () => [],
upsertApprovalTemplate: async () => undefined,
deleteApprovalTemplate: async () => undefined,
nodeOwners: async () => ({}),
setNodeOwner: async () => undefined,
},
+19
View File
@@ -8,6 +8,7 @@
* 用例与 Mastra 工作流编译随后(编码规范 §6.1)。
*/
import type {
ApprovalTemplate,
ClosureReport,
ClosureViolation,
OwnerSpec,
@@ -93,6 +94,13 @@ export type ProcessService = {
*/
editVersion(id: string, version: number, patch: { 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>;
@@ -183,6 +191,17 @@ export class VersionTakenError extends Error {
}
}
/** 模板还被审批点引着 —— 删了那些节点会静默退回「载荷全摊开」,不许悄悄改变行为 */
export class TemplateInUseError extends Error {
constructor(
readonly templateId: string,
readonly usedBy: ReadonlyArray<{ packageId: string; nodeId: string }>,
) {
super(`审批模板 ${templateId} 还被 ${usedBy.length} 个审批点引着 —— 先把那些节点改掉再删`);
this.name = 'TemplateInUseError';
}
}
export class PositionVacantError extends Error {
constructor(readonly position: string) {
super(`岗位空缺,无法解析负责人:${position} —— 按节点失败走向处置,或转治理台待指派`);
+1 -1
View File
@@ -19,7 +19,7 @@ export type {
WorkflowState,
} from './contract.ts';
export { ActiveVersionError, CallInterfaceViolationError, NotClosedError, VersionTakenError,
PinnedVersionError, PositionVacantError, StaleVersionError } from './contract.ts';
PinnedVersionError, PositionVacantError, StaleVersionError, TemplateInUseError } from './contract.ts';
export type {
FlowRuntime,
@@ -19,6 +19,21 @@ export const processPackageTable = sys.table(
(t) => [primaryKey({ columns: [t.id, t.version] }), index('process_package_state_idx').on(t.state)],
);
/**
* 审批模板(2026-07-29)—— 审批活动的可复用那一半:看什么 / 怎么催 / 说什么。
* 不长版本:模板是运营配置,改了即刻对**新起的审批单**生效,在途单不受影响
* (在途单的依据在发出那一刻已经定形,存在审批单自己身上)。
*/
export const approvalTemplateTable = sys.table('approval_template', {
id: text('id').primaryKey(),
name: text('name').notNull(),
/** [{ field, label }] —— 空数组即旧行为:载荷全摊开 */
basis: jsonb('basis').notNull().default([]),
nudge: jsonb('nudge'),
message: text('message'),
updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
});
export const workflowTable = sys.table(
'workflow',
{
@@ -3,11 +3,11 @@
*/
import { and, asc, desc, eq, isNull } from 'drizzle-orm';
import type { ProcessPackage, TerminalState, WorkflowState } from '@contracts';
import { processPackageSchema } from '@contracts';
import { approvalTemplateSchema, processPackageSchema } from '@contracts';
import type { Db } from '@shared/db.ts';
import type { ProcessStore, WorkflowRecord } from '../../port.ts';
import type { NodeInstance } from '../domain/owner-resolution.ts';
import { nodeInstanceTable, processPackageTable, workflowTable, nodeOwnerTable } from './process-schema.ts';
import { approvalTemplateTable, nodeInstanceTable, processPackageTable, workflowTable, nodeOwnerTable } from './process-schema.ts';
type WorkflowRow = typeof workflowTable.$inferSelect;
@@ -98,6 +98,36 @@ export function createProcessStore(db: Db): ProcessStore {
.where(and(eq(workflowTable.packageId, id), eq(workflowTable.packageVersion, from)));
},
async listApprovalTemplates() {
const rows = await db.select().from(approvalTemplateTable).orderBy(asc(approvalTemplateTable.name));
return rows.map((r) => approvalTemplateSchema.parse({
id: r.id,
name: r.name,
basis: r.basis,
...(r.nudge === null ? {} : { nudge: r.nudge }),
...(r.message === null ? {} : { message: r.message }),
}));
},
async upsertApprovalTemplate(template) {
const values = {
id: template.id,
name: template.name,
basis: template.basis,
nudge: template.nudge ?? null,
message: template.message ?? null,
updatedAt: new Date(),
};
await db.insert(approvalTemplateTable).values(values).onConflictDoUpdate({
target: approvalTemplateTable.id,
set: { name: values.name, basis: values.basis, nudge: values.nudge, message: values.message, updatedAt: values.updatedAt },
});
},
async deleteApprovalTemplate(id) {
await db.delete(approvalTemplateTable).where(eq(approvalTemplateTable.id, id));
},
async getPackage(id, version) {
const conditions = [eq(processPackageTable.id, id)];
if (version !== undefined) conditions.push(eq(processPackageTable.version, version));
@@ -56,6 +56,22 @@ export function createSelfHostedRuntime(deps: SelfHostedRuntimeDeps): FlowRuntim
}
/** 起一个节点:活动 → 起单;审批点 → 卡工位;终点 → 收束 */
/**
* 审批单上给人看什么 —— 引了模板就按模板筛与改名,没引就把载荷全摊开(旧行为)。
* 模板里点名的字段载荷里没有,如实写「—」:漏一项比编一项好。
*/
async function basisOf(
node: Extract<ProcessNode, { kind: 'approval' }> | undefined,
payload: Record<string, unknown>,
): Promise<Array<{ k: string; v: string }>> {
if (node?.templateId === undefined) return Object.entries(payload).map(([k, v]) => ({ k, v: String(v) }));
const template = (await deps.store.listApprovalTemplates()).find((t) => t.id === node.templateId);
if (template === undefined || template.basis.length === 0) {
return Object.entries(payload).map(([k, v]) => ({ k, v: String(v) }));
}
return template.basis.map((b) => ({ k: b.label, v: payload[b.field] === undefined ? '—' : String(payload[b.field]) }));
}
async function enter(
record: WorkflowRecord,
pkg: ProcessPackage,
@@ -163,7 +179,12 @@ export function createSelfHostedRuntime(deps: SelfHostedRuntimeDeps): FlowRuntim
nodeId: node.id,
approverId: resolution.staffId as StaffId,
subject: dispatch.node.label,
basis: Object.entries(payload).map(([k, v]) => ({ k, v: String(v) })),
/*
* 审批依据:引了模板就按模板筛与改名(审批人只看该看的、按人话看);
* 没引模板即旧行为 —— 把载荷全摊开。模板改了只影响**新发出的**审批单,
* 在途单的依据在发出那一刻已经定形,存在审批单自己身上。
*/
basis: await basisOf(node.kind === 'approval' ? node : undefined, payload),
});
await deps.store.insertInstance(record.id, {
nodeId: node.id,
@@ -10,6 +10,7 @@ import {
NotClosedError,
PinnedVersionError,
StaleVersionError,
TemplateInUseError,
VersionTakenError,
} from '../../contract.ts';
import type {
@@ -193,6 +194,35 @@ export function createProcessService(deps: ProcessServiceDeps): ProcessService {
return deps.store.listPackages();
},
async approvalTemplates() {
const [templates, packages] = await Promise.all([
deps.store.listApprovalTemplates(),
deps.store.listPackages(),
]);
// 引用反查:哪个包的哪个审批点引着它 —— 删之前要能看见,不能删完才发现
return templates.map((t) => ({
...t,
usedBy: packages.flatMap((pkg) =>
pkg.nodes
.filter((n) => n.kind === 'approval' && n.templateId === t.id)
.map((n) => ({ packageId: pkg.id, nodeId: n.id })),
),
}));
},
async saveApprovalTemplate(template) {
await deps.store.upsertApprovalTemplate(template);
return template;
},
async deleteApprovalTemplate(id) {
const all = await this.approvalTemplates();
const hit = all.find((t) => t.id === id);
if (hit === undefined) throw new Error(`审批模板不存在:${id}`);
if (hit.usedBy.length > 0) throw new TemplateInUseError(id, hit.usedBy);
await deps.store.deleteApprovalTemplate(id);
},
async editVersion(id, version, patch) {
const one = await deps.store.getPackage(id, version);
if (one === undefined) throw new StaleVersionError(id, version);
+6 -1
View File
@@ -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';
@@ -86,6 +86,11 @@ 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>;
@@ -53,7 +53,6 @@ function harness(): Harness {
},
activities: {
load: async () => ({
paradigm: 'flow' as const,
caps: { steps: 40, tokens: 200000, humanCalls: 2, activeMinutes: 60 },
envelope: {},
inputSchema: INPUT_SCHEMA,
@@ -62,10 +61,7 @@ function harness(): Harness {
}),
},
schemas: { validate: () => ({ ok: true, errors: [] }) },
engines: {
flow: { load: async () => undefined, advance: async () => ({ status: 'running' }), onEvent: async () => ({ status: 'running' }) },
loop: { load: async () => undefined, advance: async () => ({ status: 'running' }), onEvent: async () => ({ status: 'running' }) },
},
engine: { load: async () => undefined, advance: async () => ({ status: 'running' }), onEvent: async () => ({ status: 'running' }) },
memory: { append: async () => undefined, hasHistory: async () => true, seal: async () => undefined, distill: async () => undefined },
landing: {
land: async () => ({ converged: true, emittedPorts: [] as string[], ledgerRowsMerged: 0, facts: {} as LandedFacts }),
@@ -33,7 +33,6 @@ function harness(land: () => Promise<never> | Promise<{ converged: boolean; emit
h.task = {
id: TASK,
activityId: 'a-1',
paradigm: 'flow',
ownerId: 's-1' as Task['ownerId'],
title: '占位活动',
runtime: 'running',
@@ -59,7 +58,6 @@ function harness(land: () => Promise<never> | Promise<{ converged: boolean; emit
},
activities: {
load: async () => ({
paradigm: 'flow' as const,
caps: h.task.caps,
envelope: {},
inputSchema: {},
@@ -68,10 +66,11 @@ function harness(land: () => Promise<never> | Promise<{ converged: boolean; emit
}),
},
schemas: { validate: () => ({ ok: true, errors: [] }) },
engines: {
// 谱走完 + 放行通过 —— 接下来就该落地
flow: { load: async () => undefined, advance: async () => ({ status: 'finished', released: true, selectedPorts: {} }), onEvent: async () => ({ status: 'running' }) },
loop: { load: async () => undefined, advance: async () => ({ status: 'running' }), onEvent: async () => ({ status: 'running' }) },
// 案子办完 + 放行通过 —— 接下来就该落地
engine: {
load: async () => undefined,
advance: async () => ({ status: 'finished', released: true, selectedPorts: {} }),
onEvent: async () => ({ status: 'running' }),
},
memory: {
append: async (input) => {
+1 -3
View File
@@ -4,7 +4,7 @@
* 任务运行时:生命周期与**终态五名裁定**、Harness 预算执行器 / 停滞熔断、
* 控制三语义、改派、断点续跑。范式(loop / flow)在此汇流 —— 对流程层与交互层不可区分。
*/
import type { BudgetCaps, ControlSemantic, Paradigm, StaffId, TaskId, TaskRuntimeState, TerminalState } from '@contracts';
import type { BudgetCaps, ControlSemantic, StaffId, TaskId, TaskRuntimeState, TerminalState } from '@contracts';
import type { BudgetBreach, Consumption, HarnessVerdict } from './internal/domain/harness.ts';
import type { ControlOutcome, ResumeReadiness, TaskSnapshot, TerminalCause } from './internal/domain/lifecycle.ts';
@@ -15,7 +15,6 @@ export type {
ControlOutcome,
ControlSemantic,
HarnessVerdict,
Paradigm,
ResumeReadiness,
TaskRuntimeState,
TaskSnapshot,
@@ -50,7 +49,6 @@ export type LandedFacts = {
export type Task = {
readonly id: TaskId;
readonly activityId: string;
readonly paradigm: Paradigm;
/** 起单来源:工作流节点;登记触发的直起单为 undefined */
readonly workflowId?: string;
readonly nodeId?: string;
-1
View File
@@ -9,7 +9,6 @@ export type {
ControlOutcome,
ControlSemantic,
HarnessVerdict,
Paradigm,
ResumeReadiness,
StartTaskInput,
Task,
@@ -9,7 +9,6 @@ export const taskTable = sys.table(
{
id: text('id').primaryKey(),
activityId: text('activity_id').notNull(),
paradigm: text('paradigm').notNull(),
workflowId: text('workflow_id'),
nodeId: text('node_id'),
/** 恰有一名负责人 */
@@ -2,7 +2,7 @@
* task 存储 adapter —— Drizzle 只准出现在 adapter(编码规范 §5.3)。
*/
import { and, asc, eq, isNull, sql } from 'drizzle-orm';
import type { BudgetCaps, Paradigm, StaffId, TaskId, TaskRuntimeState, TerminalState } from '@contracts';
import type { BudgetCaps, StaffId, TaskId, TaskRuntimeState, TerminalState } from '@contracts';
import type { Db } from '@shared/db.ts';
import type { TaskStore } from '../../port.ts';
import type { Task } from '../../contract.ts';
@@ -15,7 +15,6 @@ function toTask(row: Row): Task {
return {
id: row.id as TaskId,
activityId: row.activityId,
paradigm: row.paradigm as Paradigm,
...(row.workflowId === null ? {} : { workflowId: row.workflowId }),
...(row.nodeId === null ? {} : { nodeId: row.nodeId }),
ownerId: row.ownerId as StaffId,
@@ -43,7 +42,6 @@ export function createTaskStore(db: Db): TaskStore {
await db.insert(taskTable).values({
id: task.id,
activityId: task.activityId,
paradigm: task.paradigm,
workflowId: task.workflowId ?? null,
nodeId: task.nodeId ?? null,
ownerId: task.ownerId,
@@ -30,8 +30,8 @@ export type TaskServiceDeps = {
readonly store: TaskStore;
readonly activities: ActivityLoader;
readonly schemas: SchemaValidator;
/** 范式引擎按 paradigm 分派 —— 对上层不可区分 */
readonly engines: Readonly<Record<'loop' | 'flow', ParadigmEngine>>;
/** 唯一的引擎(2026-07-29:活动不再分范式,内部实现都是 Loop) */
readonly engine: ParadigmEngine;
readonly memory: MemoryRecorder;
/** 落地收敛 —— 放行通过的那一刻才碰事实 */
readonly landing: LandingGateway;
@@ -72,10 +72,6 @@ export function createTaskService(deps: TaskServiceDeps): TaskService {
return task;
}
function engineOf(task: Task): ParadigmEngine {
return deps.engines[task.paradigm];
}
/** Harness 在环外先判:越限即熔断并挂起,处置归治理台 */
async function harnessCheck(task: Task, stallAfter: string) {
const lastProgress = (await deps.store.lastProgressAt(task.id)) ?? new Date(task.startedAt);
@@ -103,7 +99,6 @@ export function createTaskService(deps: TaskServiceDeps): TaskService {
const task: Task = {
id: taskIdSchema.parse(deps.ids.next()),
activityId: input.activityId,
paradigm: loaded.paradigm,
...(input.workflowId === undefined ? {} : { workflowId: input.workflowId }),
...(input.nodeId === undefined ? {} : { nodeId: input.nodeId }),
ownerId: input.ownerId,
@@ -123,7 +118,7 @@ export function createTaskService(deps: TaskServiceDeps): TaskService {
// message 计入初始观察、全程留痕;**不得扩大授权边界**
detail: { data: input.data, message: input.message, envelope: loaded.envelope },
});
await engineOf(task).load(task.id, loaded.businessModel);
await deps.engine.load(task.id, loaded.businessModel);
await deps.interaction.setPhase(task.id, 'active');
if (missing.length > 0) {
await deps.memory.append({
@@ -169,7 +164,7 @@ export function createTaskService(deps: TaskServiceDeps): TaskService {
}
const startedAt = deps.clock.now().getTime();
const outcome = await engineOf(task).advance(taskId);
const outcome = await deps.engine.advance(taskId);
// 步计量:loop 的一次决策循环 / flow 的一个声明步。
// 活跃时长按**这一拍真正花掉的时间**计 —— 挂起等人的时间不算活跃,那是世界等待。
const used = await deps.store.addConsumption(taskId, {
@@ -303,7 +298,7 @@ export function createTaskService(deps: TaskServiceDeps): TaskService {
}
}
await engineOf(task).onEvent(taskId, event);
await deps.engine.onEvent(taskId, event);
await deps.store.markProgress(taskId, deps.clock.now());
return this.tick(taskId);
},
+1 -2
View File
@@ -1,7 +1,7 @@
/**
* module: task —— 本模块要外界提供的能力(编码规范 §10.1 / §5.3)。
*/
import type { BudgetCaps, Paradigm, StaffId, TaskId, TerminalState } from '@contracts';
import type { BudgetCaps, StaffId, TaskId, TerminalState } from '@contracts';
import type { Consumption } from './internal/domain/harness.ts';
import type { LandedFacts, Task } from './contract.ts';
@@ -21,7 +21,6 @@ export type TaskStore = {
/** 活动装载 —— app 注入 `activity-registry`(L4) */
export type ActivityLoader = {
load(activityId: string): Promise<{
paradigm: Paradigm;
caps: BudgetCaps;
envelope: Record<string, unknown>;
/** 输入 data 的 JSON Schema —— 缺项不得启动 */
+8
View File
@@ -295,6 +295,14 @@
.g-fcard .menu button.bad { color: var(--danger); }
.g-fcard .menu button.bad:hover { background: #fdf2f2; }
.g-fcard .menu .q { padding: 3px 8px 5px; font-size: 11px; line-height: 1.5; color: var(--ink-3); }
/* 活动卡的分类签:压在卡右下角的一枚小字 —— 业务分类是活动库唯一的一维 */
/* 分类签:业务分类是活动库唯一的一维 —— 一枚行内小字,不另占一行 */
.g-fcard .tag { flex: none; padding: 2px 6px; border: 1px solid var(--line-soft); border-radius: 5px; font: 500 10px/1.4 var(--sans); color: var(--ink-4); }
.g-fcard .ico.apr { color: var(--warn); background: #fdf3e3; }
.g-fcard .mbtn.bad:hover { border-color: #e6c4c4; background: #fdf2f2; color: var(--danger); }
/* 审批依据:一行两格 + 删 */
.g-basis { display: flex; flex-direction: column; gap: 6px; }
.g-basis-r { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1fr) auto; gap: 6px; }
/* 幽灵卡:新建住在货架里 —— 与真卡同宽同高,一眼看出「这儿还能再添一条」 */
.g-fcard.ghost { flex-direction: row; align-items: center; justify-content: center; gap: 7px; min-height: 102px; border-style: dashed; border-color: #c6d1de; background: transparent; box-shadow: none; color: var(--ink-4); font: 600 12.5px/1 var(--sans); cursor: pointer; }
.g-fcard.ghost:hover { border-color: var(--brand); background: var(--brand-wash); color: var(--brand-deep); box-shadow: none; transform: none; }
@@ -8,7 +8,8 @@
import { Ico } from '@web-shared/Ico.tsx';
import { useState } from 'react';
import { useMutation, useQueryClient } from '@tanstack/react-query';
import { installActivityRoute } from '@contracts';
import type { ApprovalTemplate } from '@contracts';
import { deleteApprovalTemplateRoute, installActivityRoute, upsertApprovalTemplateRoute } from '@contracts';
import { ApiCallError, call } from '@web-shared/typed-fetch.ts';
import {
Acts,
@@ -20,7 +21,7 @@ import {
PageHead,
Prop,
QueryGate,
St,
Sec,
} from '@web-shared/gov/primitives.tsx';
/** 装入回参 —— 与 `installActivityRoute.output` 同形 */
@@ -36,72 +37,264 @@ type InstallReply = {
regressions: ReadonlyArray<{ taskId: string; detail: string }>;
};
};
import { PARA } from '@web-shared/gov/tone.ts';
import type { Nav } from '@web-shared/gov/gov-route.ts';
import { useGovActivities } from '@web-shared/gov/gov-api.ts';
import { useGovActivities, useGovApprovalTemplates } from '@web-shared/gov/gov-api.ts';
import type { GovApprovalTemplates } from '@web-shared/gov/gov-api.ts';
export type HomeProps = { tab: string; nav: Nav };
export function LibraryHome({ nav }: HomeProps) {
const q = useGovActivities();
const templates = useGovApprovalTemplates();
const activities = q.data?.activities ?? [];
const [installing, setInstalling] = useState(false);
return (
<QueryGate query={q}>
<>
<Note>
活动是任务的<b>定义</b>:编排引用一个活动,运行时就长出一个任务。业务分类 × 活动类型两维平级;
每活动两条版本序列——包版本走安装两审,资产版本走进化管线。
<b>审批点与网关不在这里</b>:它们是流程层的系统内置要素,零开发、不入库。
</Note>
<InstallCard />
{activities.length === 0 ? (
<Clear>货架是空的 —— 装一个活动进来,编排里才引用得到它。</Clear>
) : (
{/*
* 一区两格:**装进来的**(活动,系统外开发、经安装通道入库)与
* **配出来的**(审批活动,治理台里配的模板)。
* 「标准 / 案例」那一维 2026-07-29 撤了:活动不再分范式,业务分类是唯一的一维。
*/}
<Sec ico="boxes" title="活动" extra={`${activities.length} 个 · 装进来的`}>
<div className="g-shelf">
{activities.map((a) => {
const para = PARA[a.paradigm];
const latest = a.packageVersions[a.packageVersions.length - 1];
const effective = a.assetVersions.filter((v) => v.effective).length;
return (
<button
key={a.activityId}
className={'g-tile t-' + para.tone}
onClick={() => nav.push({ k: 'act', id: a.activityId })}
>
<span className="g-tile-h">
<span className="g-tile-i">
<Ico name={para.ico} s={16} />
<div key={a.activityId} className={'g-fcard' + (a.enabled ? '' : ' off')}>
<button className="hit" aria-label={`打开 ${a.name}`} onClick={() => nav.push({ k: 'act', id: a.activityId })} />
<div className="hd">
<span className="ico">
<Ico name="boxes" s={15} />
</span>
<span className="g-tile-t">
<div className="ttl">
<b>{a.name}</b>
<em>{a.activityId}</em>
</div>
<span className="tag">{a.category}</span>
<span className={'stx' + (a.enabled ? ' on' : '')}>{a.enabled ? '已上架' : '已停用'}</span>
</div>
<div className="plate">
<span>
<b>{a.contract.inputFields.length}</b>
<i>入参</i>
</span>
<Chip tone={para.tone}>{para.label}</Chip>
<span>
<b>{a.contract.outputPorts.length}</b>
<i>出口</i>
</span>
<span className="g-tile-m">
<Chip ico="boxes">{a.category}</Chip>
<Chip ico="git-commit">包 v{latest?.version ?? '—'}</Chip>
<span>
<b>{latest?.version ?? '—'}</b>
<i>包版本</i>
</span>
<span className="g-tile-f">
{/*
只报查得到的事实:资产生效版数与上架状态。
「实现到没到位」这一层,清单里没有可靠依据 —— 不在卡上编一个章。
*/}
<St tone={a.enabled ? 'ok' : 'mute'} ico={a.enabled ? 'circle-check' : 'power'}>
{a.enabled ? '已上架' : '已停用'}
</St>
<span className="r">资产生效 {effective}</span>
<span>
<b>{effective}</b>
<i>资产生效</i>
</span>
</button>
</div>
</div>
);
})}
{/* 幽灵卡:装入通道 —— 活动是系统外开发的,这里只收清单与产物 */}
<button className="g-fcard ghost" onClick={() => setInstalling(!installing)}>
<Ico name="upload" s={18} />
{installing ? '收起装入' : '装入活动'}
</button>
</div>
)}
</Sec>
{installing && <InstallCard />}
<ApprovalTemplates data={templates.data?.templates ?? []} />
</>
</QueryGate>
);
}
/* ---------------- 审批活动:治理台里配出来的那一类 ---------------- */
/**
* 审批活动 —— **配出来的活动**(2026-07-29 用户定:审批活动要能管)。
*
* 它与装进来的活动是两种东西:审批零开发,系统内置;可配的只是**可复用的那一半** ——
* 审批人看哪几项、按什么名字看、怎么催、说什么话。
* 剩下不可复用的那半(驳回回哪个节点)留在编排的节点上,那是那张图自己的事;
* 谁来审也不在这里 —— 与活动点同一口径,运营时按组轮值。
*/
function ApprovalTemplates({ data }: { data: GovApprovalTemplates['templates'] }) {
const queryClient = useQueryClient();
const [editing, setEditing] = useState<ApprovalTemplate | null>(null);
const [err, setErr] = useState<string | undefined>(undefined);
const invalidate = () => {
void queryClient.invalidateQueries({ queryKey: ['gov', 'approval-templates'] });
void queryClient.invalidateQueries({ queryKey: ['gov', 'process'] });
};
const save = useMutation({
mutationFn: (template: ApprovalTemplate) =>
call<{ template: ApprovalTemplate }>(upsertApprovalTemplateRoute, { body: { template } }),
onSuccess: () => {
invalidate();
setEditing(null);
setErr(undefined);
},
onError: (e: unknown) => setErr((e as { message?: string }).message ?? '存不下'),
});
const drop = useMutation({
mutationFn: (id: string) => call<{ ok: boolean }>(deleteApprovalTemplateRoute, { params: { id } }),
onSuccess: () => {
invalidate();
setErr(undefined);
},
onError: (e: unknown) => setErr((e as { message?: string }).message ?? '删不掉'),
});
return (
<Sec ico="shield-check" title="审批活动" extra={`${data.length} 张模板 · 配出来的`}>
{err !== undefined && <Note tone="warn">{err}</Note>}
{editing !== null && (
<TemplateForm
draft={editing}
pending={save.isPending}
onCancel={() => setEditing(null)}
onSave={(t) => save.mutate(t)}
/>
)}
<div className="g-shelf">
{data.map((t) => (
<div key={t.id} className="g-fcard">
<div className="hd">
<span className="ico apr">
<Ico name="shield-check" s={15} />
</span>
<div className="ttl">
<b>{t.name}</b>
<em>{t.id}</em>
</div>
<button className="mbtn" aria-label="编辑" onClick={() => setEditing({ ...t })}>
<Ico name="pen-line" s={13} />
</button>
<button
className="mbtn bad"
aria-label="删除"
disabled={drop.isPending}
onClick={() => drop.mutate(t.id)}
>
<Ico name="trash-2" s={13} />
</button>
</div>
<div className="plate">
<span>
<b>{t.basis.length === 0 ? '全部' : t.basis.length}</b>
<i>审批依据</i>
</span>
<span>
<b>{t.nudge === undefined ? '—' : t.nudge.deadline}</b>
<i>时限</i>
</span>
<span>
<b>{t.usedBy.length}</b>
<i>被引用</i>
</span>
</div>
</div>
))}
<button
className="g-fcard ghost"
onClick={() => setEditing({ id: '', name: '', basis: [] })}
>
<Ico name="plus" s={18} />
新建审批活动
</button>
</div>
</Sec>
);
}
/** 模板表单 —— 依据一行一条:载荷字段 → 卡面显示名 */
function TemplateForm({
draft,
pending,
onCancel,
onSave,
}: {
draft: ApprovalTemplate;
pending: boolean;
onCancel: () => void;
onSave: (t: ApprovalTemplate) => void;
}) {
const [t, setT] = useState<ApprovalTemplate>(draft);
const idOk = /^[a-z][a-z0-9-]{1,39}$/.test(t.id);
return (
<Card ico="shield-check" title={draft.id === '' ? '新建审批活动' : `改 ${draft.name}`}>
<div className="g-newflow">
<Field k="名称" hint="人读的名字,如「定价审批」">
<input className="g-input" value={t.name} placeholder="如:定价审批" onChange={(e) => setT({ ...t, name: e.target.value })} />
</Field>
<Field k="标识" hint="编排的审批点按它引用 —— 小写字母开头,只许小写 / 数字 / 连字符">
<input
className="g-input mono"
value={t.id}
disabled={draft.id !== ''}
placeholder="如:pricing-approval"
onChange={(e) => setT({ ...t, id: e.target.value.trim() })}
/>
</Field>
<Field k="审批依据" hint="审批人卡面上看哪几项 —— 留空即把载荷全摊开">
<div className="g-basis">
{t.basis.map((b, i) => (
<div key={i} className="g-basis-r">
<input
className="g-input mono"
value={b.field}
placeholder="载荷字段"
onChange={(e) =>
setT({ ...t, basis: t.basis.map((x, j) => (i === j ? { ...x, field: e.target.value.trim() } : x)) })
}
/>
<input
className="g-input"
value={b.label}
placeholder="卡面显示名"
onChange={(e) => setT({ ...t, basis: t.basis.map((x, j) => (i === j ? { ...x, label: e.target.value } : x)) })}
/>
<button className="g-ver-act t-bad" onClick={() => setT({ ...t, basis: t.basis.filter((_, j) => j !== i) })}>
删
</button>
</div>
))}
<button className="g-ver-act" onClick={() => setT({ ...t, basis: [...t.basis, { field: '', label: '' }] })}>
<Ico name="plus" s={11} /> 加一条
</button>
</div>
</Field>
<Field k="委托消息" hint="给审批人的一句话,随审批单发出">
<input
className="g-input"
value={t.message ?? ''}
placeholder="如:请核对毛利率与偏离度后裁决"
onChange={(e) => setT({ ...t, message: e.target.value === '' ? undefined : e.target.value })}
/>
</Field>
{t.id !== '' && !idOk && <Note tone="warn">标识不合规:小写字母开头,只许小写、数字、连字符。</Note>}
<Acts
align="end"
items={[
{ label: '取消', ico: 'x', onClick: onCancel },
{
label: pending ? '保存中…' : '保存',
ico: 'send',
primary: true,
disabled: pending || !idOk || t.name.trim() === '' || t.basis.some((b) => b.field === '' || b.label === ''),
onClick: () => onSave({ ...t, name: t.name.trim() }),
},
]}
/>
</div>
</Card>
);
}
/* ---------------- ⑥ 工具管理 ---------------- */
export function ActPage({ id }: { id: string }) {
@@ -111,18 +304,17 @@ export function ActPage({ id }: { id: string }) {
return (
<>
<PageHead
ico={PARA[a.paradigm].ico}
tone={PARA[a.paradigm].tone}
ico="boxes"
tone="brand"
kicker={`活动 · ${a.activityId}`}
title={a.name}
chips={
<>
<Chip tone={PARA[a.paradigm].tone}>{PARA[a.paradigm].label}</Chip>
<Chip ico="tag">{a.category}</Chip>
<Chip tone={a.enabled ? 'ok' : 'mute'}>{a.enabled ? '已启用' : '已停用'}</Chip>
</>
}
desc={PARA[a.paradigm].full + ' —— 活动是系统外开发、经此安装的外装件。'}
desc="活动是系统外开发、经安装通道入库的外装件 —— 一件事怎么办,由它的案例模型说。"
/>
{/*
契约面 —— 开发这个活动要照着的东西:吃什么、吐什么、用谁的工具、动哪些域对象。
@@ -44,7 +44,7 @@ import {
St,
} from '@web-shared/gov/primitives.tsx';
import type { Nav } from '@web-shared/gov/gov-route.ts';
import { useGovActivities, useGovPackages, useGovPkgReports } from '@web-shared/gov/gov-api.ts';
import { useGovActivities, useGovApprovalTemplates, useGovPackages, useGovPkgReports } from '@web-shared/gov/gov-api.ts';
import type { GovActivities } from '@web-shared/gov/gov-api.ts';
import { FlowFigureBlock } from '@web-shared/gov/flow/FlowFigure.tsx';
import { packageToGraph } from '@web-shared/gov/flow/pkg-to-graph.ts';
@@ -374,6 +374,7 @@ export function PkgPage({ id, nav }: { id: string; nav: Nav }) {
const flowId = id.split('@')[0] ?? id;
const q = useGovPackages();
const acts = useGovActivities();
const approvalTpl = useGovApprovalTemplates();
const versions = (q.data?.packages ?? [])
.filter((p) => p.id === flowId)
@@ -400,6 +401,7 @@ export function PkgPage({ id, nav }: { id: string; nav: Nav }) {
activeVersion={active?.version}
nav={nav}
activities={acts.data?.activities ?? []}
approvalTemplates={approvalTpl.data?.templates ?? []}
nextVersion={Math.max(...versions.map((x) => x.version)) + 1}
closedOf={(v) => reports.data?.get(`${flowId}@${v}`)?.closed}
onPick={(v) => setPinned(v)}
@@ -412,7 +414,6 @@ export function PkgPage({ id, nav }: { id: string; nav: Nav }) {
type ActivityRow = {
activityId: string;
name: string;
paradigm: string;
packageVersions: ReadonlyArray<{ version: string }>;
assetVersions: ReadonlyArray<{ version: number; effective: boolean }>;
contract: GovActivities['activities'][number]['contract'];
@@ -424,6 +425,7 @@ function FlowLab({
activeVersion,
nav,
activities,
approvalTemplates,
nextVersion,
closedOf,
onPick,
@@ -434,6 +436,8 @@ function FlowLab({
activeVersion: number | undefined;
nav: Nav;
activities: readonly ActivityRow[];
/** 审批模板一览 —— 审批点属性里选一张 */
approvalTemplates: readonly { id: string; name: string }[];
nextVersion: number;
/** 该版本闭合与否(undefined = 报告还没回来)—— 激活按钮据此灰显 */
closedOf: (version: number) => boolean | undefined;
@@ -1107,6 +1111,34 @@ function FlowLab({
</div>
</div>
)}
{node.kind === 'activity' && node.flavor === 'approval' && (
<div className="g-tbrow">
{/*
* 审批模板 = 从活动库链接一张**审批活动** —— 审批人看哪几项、怎么催、说什么。
* 不选也能跑(旧行为:审批卡把载荷全摊开);谁来审仍是运营时按组轮值。
*/}
<em>审批模板 · 链接自活动库</em>
<span className="v col">
<select
className="g-tbsel"
value={node.templateId ?? ''}
onChange={(e) =>
patch((n) => ({ ...n, templateId: e.target.value === '' ? undefined : e.target.value }))
}
>
<option value="">不引模板 —— 审批卡把载荷全摊开</option>
{approvalTemplates.map((t) => (
<option key={t.id} value={t.id}>
{t.name} · {t.id}
</option>
))}
</select>
<button className="g-tblink" onClick={() => nav.jump('library', 'shelf')}>
去活动库配审批活动 <Ico name="arrow-right" s={11} />
</button>
</span>
</div>
)}
{node.kind === 'activity' && node.flavor !== 'approval' && (
<div className="g-tbrow">
{/* 实现 = **从活动库链接一个活动**:节点不含实现,链接才算装载(激活判据之二) */}
@@ -21,7 +21,7 @@ import { Ico } from '@web-shared/Ico.tsx';
import { call } from '@web-shared/typed-fetch.ts';
import { Ava, Card, Chip, Clear, Entry, Facts, Kpi, NList, NRow, Note, PageHead, QueryGate, Sec, St } from '@web-shared/gov/primitives.tsx';
import type { ActSpec } from '@web-shared/gov/primitives.tsx';
import { APR_ST, PARA, RUNTIME_ST, TERMINAL_ST, WF_ST } from '@web-shared/gov/tone.ts';
import { APR_ST, RUNTIME_ST, TERMINAL_ST, WF_ST } from '@web-shared/gov/tone.ts';
import type { Nav } from '@web-shared/gov/gov-route.ts';
import { FlowFigure } from '@web-shared/gov/flow/FlowFigure.tsx';
import {
@@ -174,8 +174,8 @@ function RuntimeHome({ tab, nav }: HomeProps) {
return (
<NRow
key={t.id}
tone={PARA[t.paradigm].tone}
ico={PARA[t.paradigm].ico}
tone="brand"
ico="repeat"
title={t.title}
sub={`${t.id.slice(0, 8)} · 活动 ${t.activityId}`}
cols={[
@@ -399,7 +399,7 @@ export function TaskPage({ id, nav }: { id: string; nav: Nav }) {
return (
<>
<PageHead
ico={PARA[task.paradigm].ico}
ico="repeat"
tone={st.tone}
kicker={`任务 · ${task.id.slice(0, 8)}`}
title={task.title}
@@ -408,13 +408,10 @@ export function TaskPage({ id, nav }: { id: string; nav: Nav }) {
<Chip tone={st.tone} ico={st.ico}>
{label}
</Chip>
<Chip tone={PARA[task.paradigm].tone} ico={PARA[task.paradigm].ico}>
{PARA[task.paradigm].label}
</Chip>
<Chip ico="user-round">{task.ownerName}</Chip>
</>
}
desc={PARA[task.paradigm].full + ' —— 治理不改定义:控制只作用于这一次运行。'}
desc="活动的一次运行 —— 治理不改定义:控制只作用于这一次运行。"
acts={[
controlAct('pause', false),
controlAct('halt', true),
@@ -440,7 +437,6 @@ export function TaskPage({ id, nav }: { id: string; nav: Nav }) {
items={[
{ k: '步数', v: `${task.usedSteps}/${task.capSteps}`, ratio: task.usedSteps / Math.max(task.capSteps, 1) },
{ k: '活动', v: task.activityId },
{ k: '范式', v: PARA[task.paradigm].label },
{ k: '起始', v: task.startedAt.slice(0, 16).replace('T', ' ') },
]}
/>
@@ -26,6 +26,8 @@ export interface FlowNode {
* (蛇形折行与尺寸计算),不表示它在模型上属于活动。
*/
flavor?: "case" | "approval" | undefined;
/** 仅审批点:引哪张审批模板(活动库 · 审批活动)—— 不引即旧行为:审批卡把载荷全摊开。 */
templateId?: string | undefined;
/** Case 节点引用的库案例 id(cases[].id):L2 只是引用,下钻编辑共享库案例。 */
caseRef?: string;
label: string;
@@ -67,6 +67,12 @@ export function mergeGraphIntoPackage(
// 审批人不入编排(运营时分配):功能属性只剩驳回走向 / 催办 / 委托消息
// 驳回走向是声明式功能属性,画布不改它 —— 没有旧声明就先「终止」,激活前在属性里补
reject: priorAp?.reject ?? { kind: 'terminate' as const },
// 审批模板:属性卡刚选的优先,其次旧声明 —— 画布上看不见它,但存盘不能丢
...(n.templateId !== undefined && n.templateId !== ''
? { templateId: n.templateId }
: priorAp?.templateId === undefined
? {}
: { templateId: priorAp.templateId }),
...(priorAp?.nudge === undefined ? {} : { nudge: priorAp.nudge }),
...(priorAp?.message === undefined ? {} : { message: priorAp.message }),
};
+1 -1
View File
@@ -91,7 +91,7 @@ export function packageToGraph(pkg: ProcessPackage, marks: readonly InstanceMark
};
if (n.kind === 'approval') {
// approval **不是一种活动**:它挂在 kind:"activity" 下仅因共用同一套方框几何
return { ...base, flavor: 'approval' };
return { ...base, flavor: 'approval', ...(n.templateId === undefined ? {} : { templateId: n.templateId }) };
}
return {
...base,
+10
View File
@@ -25,12 +25,14 @@ import type {
GovWorkflowOutput,
ProcessPackage,
} from '@contracts';
import type { ApprovalTemplate } from '@contracts';
import {
browseLedgerRoute,
govMetricsRoute,
govTaskLogRoute,
govWorkflowRoute,
listActivitiesRoute,
listApprovalTemplatesRoute,
listActivityMemoryRoute,
listApprovalsRoute,
listChannelsRoute,
@@ -118,6 +120,14 @@ export const useGovTriggers = (): UseQueryResult<GovTriggersOutput> =>
export const useGovActivities = (): UseQueryResult<GovActivities> =>
useQuery({ queryKey: ['gov', 'activities'], queryFn: () => call<GovActivities>(listActivitiesRoute) });
/** 审批模板(审批活动)—— 活动库的第二格、编排里审批点的选项 */
export type GovApprovalTemplates = { templates: ReadonlyArray<ApprovalTemplate & { usedBy: ReadonlyArray<{ packageId: string; nodeId: string }> }> };
export const useGovApprovalTemplates = (): UseQueryResult<GovApprovalTemplates> =>
useQuery({
queryKey: ['gov', 'approval-templates'],
queryFn: () => call<GovApprovalTemplates>(listApprovalTemplatesRoute),
});
export const useGovTools = (): UseQueryResult<GovTools> =>
useQuery({ queryKey: ['gov', 'tools'], queryFn: () => call<GovTools>(listToolsRoute) });
+1 -1
View File
@@ -119,7 +119,7 @@ export const ZM: Readonly<Record<GovZone, { title: string; desc: string; accent:
title: '活动库',
icon: 'boxes',
accent: 'linear-gradient(140deg,#0aa294,#0a6a64)',
desc: '已安装活动的资产货架:活动是任务的定义——编排引用一个活动,运行时就长出一个任务。审批点与网关是系统内置要素,零开发、不入库。业务分类 × 活动类型两维,每活动两条版本序列。',
desc: '一区两格:装进来的活动(系统外开发、经安装通道入库,一个活动 = 一类任务的定义)与配出来的审批活动(审批零开发,这里配的是模板:审批人看什么、怎么催、说什么)。活动不再分标准/案例——业务分类是唯一的一维;每活动两条版本序列:包版本走安装两审,资产版本走进化管线。',
},
tools: {
title: '工具箱',
+1 -6
View File
@@ -2,7 +2,7 @@
* 状态 → 色调 / 图标字典 —— 自原型 `Governance.tsx` 第 92–116 行平移。
* 原型用中文状态名做键;我们的状态名是契约里的枚举,故键换成枚举、标签仍取契约的 `*_LABEL`。
*/
import type { Paradigm, TaskRuntimeState, TerminalState, WorkflowState } from '@contracts';
import type { TaskRuntimeState, TerminalState, WorkflowState } from '@contracts';
export type ToneIco = { tone: string; ico: string };
@@ -32,11 +32,6 @@ export const TERMINAL_ST: Readonly<Record<TerminalState, ToneIco>> = {
terminated: { tone: 'mute', ico: 'power' },
};
export const PARA: Readonly<Record<Paradigm, ToneIco & { label: string; full: string }>> = {
loop: { tone: 'collab', ico: 'repeat', label: '案例 · loop', full: '临场演绎,调度权归 AI' },
flow: { tone: 'auto', ico: 'git-commit', label: '标准 · flow', full: '照谱执行,调度权归系统' },
};
export const APR_ST: Readonly<Record<'pending' | 'passed' | 'rejected', ToneIco & { label: string }>> = {
pending: { tone: 'warn', ico: 'hourglass', label: '待审批' },
passed: { tone: 'ok', ico: 'circle-check', label: '已通过' },
+24
View File
@@ -0,0 +1,24 @@
-- 范式退役(2026-07-29 用户定:活动不再分 flow 和 loop,内部实现都是 Loop)。
--
-- `paradigm` 列从此没有意义:活动只有一种,业务模型只有案例模型一形。
-- 在途任务不受影响 —— 它们读的是定义与运行时状态,从不读这一列做分派
-- (分派早已换成「唯一的引擎」,见 wiring/engines.ts)。
alter table sys.activity_package drop column if exists paradigm;
alter table sys.task drop column if exists paradigm;
-- 分类索引跟着改:活动库只剩业务分类一维
drop index if exists sys.activity_package_category_idx;
create index activity_package_category_idx on sys.activity_package (category);
-- 审批模板(审批活动)—— 审批点可复用的那一半:看什么 / 怎么催 / 说什么。
-- 谁来审不在这里:与活动点同一口径,运营时按组轮值。
-- 驳回回哪个节点也不在这里:那是每张图自己的事,留在节点上。
create table sys.approval_template (
id text primary key,
name text not null,
-- [{ field, label }] —— 空数组即旧行为:审批卡把载荷全摊开
basis jsonb not null default '[]'::jsonb,
nudge jsonb,
message text,
updated_at timestamptz not null default now()
);
+7
View File
@@ -141,6 +141,13 @@
"when": 1785130114173,
"tag": "0019_trigger_confirm",
"breakpoints": true
},
{
"idx": 20,
"version": "7",
"when": 1785130115173,
"tag": "0020_paradigm_retired",
"breakpoints": true
}
]
}
+1 -1
View File
@@ -11,7 +11,7 @@
| M1 | `@contracts` 首版、`event`、`ledger`、`org`、`llm` | ✅ 完成 |
| M2 | `memory`、`toolbox`、`channel`、`message` | ✅ 完成 |
| M3 | `interaction`、`human-tool`、`release`、`activity-registry`、`@sfeel` | ✅ 完成 |
| M4 | `skill-engine`、`loop-engine`、`flow-engine`、`task` | ✅ 完成(模块与 domain;app 装配随 M5) |
| M4 | `skill-engine`、`loop-engine`、~~`flow-engine`~~(2026-07-29 退役)、`task` | ✅ 完成(模块与 domain;app 装配随 M5) |
| M5 | `process`、`trigger`、`@activity-sdk` + 六个活动包 | ✅ 完成 |
| M6 | 前端:工作台五要素 → 治理台九功能;`minute`、`report` | 🟡 五要素九功能均已平移并接真实 API;`minute`/`report` 已落;编排画布只读态已接,手绘编辑器待接 |
+5
View File
@@ -106,6 +106,11 @@
样例是业务分析会话的原始导出,术语与两卷未对齐;实现时按此表映射:
> **2026-07-29 范式退役**:用户定「活动不再分 flow 和 loop,内部实现都是 Loop」——
> `flow-engine` 模块整个删除,`paradigm` 字段从清单与两张表退场,活动的业务模型只剩案例模型。
> 下表提到「标准活动(flow)」的行为**历史记述**;今天 A1/A4/A6/A7 也已改写成案例模型。
> 后果见 docs/debt.md。
| 样例里的物件 | 归一化为 |
| --- | --- |
| 流程「统一报价」 | **流程包** v1:治理台编排五要素、边映射闭合、发布;运行即工作流 |
+22
View File
@@ -181,3 +181,25 @@ intel-archive)只有契约面,入口产物是抛「未实现」的占位 ——
升级路径:通道入站归一后挂一个 LLM 分类工具(工具箱五件之 classify,经模型网关一缝),
产出 `messageCategory` 进事件载荷,触发器规则改判 `messageCategory = "rfq"`。
前置:模型实例已绑定(大模型区)、分类样例集与回放审。不阻塞现有 RFQ 流 —— 正则今天够用。
## 范式统一的欠账:占位活动没有模型就跑不动(2026-07-29)
用户定:**活动不再分 flow 和 loop,内部实现都是 Loop**。本轮照此退役:
`flow-engine` 模块整个删除、`paradigm` 字段从清单与两张表退场、
`activities/` 里四个 flow 活动(A1/A4/A6/A7)与六个占位槽位改写成案例模型(CMMN + 说明书)。
**直接后果,写在明处**:`turn-runner.runTurn` 每一拍都要 `agent.decide` ——
环境里没有模型 key(`JCAI_DEEPSEEK_API_KEY` 或等价的实例绑定),案例活动**一步也走不动**。
于是三套端到端整套跳过,并在文件头写明恢复条件:
| 套件 | 为什么跳 |
|---|---|
| `unified-quote-flow.it.test.ts` | 靠答验收工单走完整条流;工单从前由 flow 末步发,现在由 Agent 每拍决定 |
| `new-package-flow.it.test.ts` | 同上(新建流程包后走一遍) |
| `testbed-trace.it.test.ts` | 同上(测试台起单 → 真任务 → 全链 Trace) |
恢复要两件,缺一不可:①环境有可用模型;②走法改写成 loop 的口径 —— 按 Enabled 集推进,
而不是按步序答工单。**在此之前不许把断言改松让它变绿**:绿得不诚实比红着更坏。
顺带作废的旧欠账:「占位期六个槽位一律 flow 范式,真开发时装回 loop」——
已经没有 flow 可退回,这条不存在了。
+1 -1
View File
@@ -64,7 +64,7 @@
| **蓝图** | 全局 —— 定义完了没有 | 四库因果链 + 待补清单(见上) |
| **触发器** | 谁调起流程 | 事件 / 登记 / 周期三类调起规则的定义;定完就地投一封信演练,看哪条规则接住(归属解析 → 三级消费的真链路)。**启停开关在运营中心** |
| **流程包** | 战略 —— 企业以哪些流转运转 | 编排工作区**三栏**:左窄轨版本(激活/停用 · **号与名自己定** · 删除;点「编辑」整列进编辑态,取消/保存收尾)、中流程图、右节点属性。**边只表达顺序与条件**(对齐 Mastra),数据按字段名流动;**字段只声明,不做任何要求** —— 激活闸只剩结构闭合与活动装载两面,字段够不够是活动自己的事 |
| **活动库** | 方法 —— 每件事怎么干 | 货架、契约面、范式、资产版本谱系、安装两审 |
| **活动库** | 方法 —— 每件事怎么干 | **一区两格**:装进来的活动(货架、契约面、资产版本谱系、安装两审)与**配出来的审批活动**(审批模板:审批人看什么 / 怎么催 / 说什么,编排的审批点选一张)。活动**不再分标准/案例**(2026-07-29):业务分类是唯一的一维,业务模型一律案例模型 |
| **工具箱** | 能力 —— 系统能对世界做什么 | 功能 / LLM / 人类三类工具目录、白名单授权、幂等口径、引用反查。**一律主显示中文名**,逻辑名退居副标 |
| **数据域** | 对象 —— 企业运营什么 | 域与对象 schema、字段、放行规则、被谁引用。**行数据不在这里** —— 那是运营的事 |
| **知识库** | 企业的资料与文档 | 规范、图纸、样例、外部材料。**待建**,现在是个占位区 |
+5
View File
@@ -105,6 +105,11 @@ repo/
|---|---|
| 交互层(工作台 + 治理台) | `apps/web`(features)+ `apps/api` 的 `interaction` / `message` / `human-tool` 模块(协议侧) |
| 流程层(触发器 + 流程包/工作流) | `process`、`trigger` 模块 |
> **2026-07-29 范式退役**:用户定「活动不再分 flow 和 loop,内部实现都是 Loop」——
> `flow-engine` 模块整个删除,`paradigm` 字段从清单与 `activity_package`/`task` 两表退场,
> 活动的业务模型只剩案例模型(CMMN + 说明书 + DMN)。本文提到 flow 范式的段落均为**历史记述**,
> 按当日结构写就;今天的实况是:一种活动、一个引擎(`loop-engine`)。后果见 docs/debt.md。
| 引擎层(流程引擎 + 活动基座) | 流程引擎在 `process` 内;活动基座六件 = `ledger` / `memory` / `toolbox` / `llm` / `interaction` + 契约类型(@contracts);范式运行器 = `loop-engine` / `flow-engine` / `skill-engine`;任务运行时 = `task` |
| 调用层(系统调用 · LLM 工具 · 人类工具 · 通道) | `toolbox`(功能工具/纯工具)、`llm`、`human-tool`、`channel` |
| 基座层(数据 · 台账 · 记忆 · 工具箱 · 活动库 · 流程包 · 事件存储) | PostgreSQL 四 schema(§7)+ `event` / `ledger` / `memory` / `toolbox` / `activity-registry` / `process` 各自的 adapter |
+34 -4
View File
@@ -6,9 +6,9 @@ import { z } from 'zod';
import type { RouteContract } from './http.ts';
import { disableCheckSchema, grantSchema, positionSchema, staffSchema, workGroupSchema } from '../org.ts';
import { positionIdSchema, staffIdSchema, taskIdSchema } from '../id.ts';
import { closureReportSchema, processPackageSchema, triggerConfigSchema } from '../process-package.ts';
import { approvalTemplateSchema, closureReportSchema, processPackageSchema, triggerConfigSchema } from '../process-package.ts';
import { controlSemanticSchema, taskRuntimeStateSchema, terminalStateSchema, workflowStateSchema } from '../terminal.ts';
import { activityManifestSchema, paradigmSchema } from '../manifest.ts';
import { activityManifestSchema } from '../manifest.ts';
import { reportMetricsSchema, reportPeriodSchema } from './workbench.ts';
/* ── 员工管理 ─────────────────────────────────────────────────────────── */
@@ -121,7 +121,6 @@ export const govTaskRowSchema = z.object({
id: taskIdSchema,
title: z.string(),
activityId: z.string(),
paradigm: paradigmSchema,
ownerName: z.string(),
runtime: taskRuntimeStateSchema,
terminal: terminalStateSchema.optional(),
@@ -238,6 +237,38 @@ export const deleteProcessVersionRoute = {
output: z.object({ packages: z.array(processPackageSchema) }),
} as const satisfies RouteContract;
/* ── 审批模板(审批活动)──────────────────────────────────────────────── */
/** 审批模板一览 —— 活动库里「审批活动」那一格看的就是它 */
export const listApprovalTemplatesRoute = {
method: 'GET',
path: '/api/gov/approval-templates',
output: z.object({
templates: z.array(
approvalTemplateSchema.extend({
/** 被哪些流程包的审批点引着 —— 删之前要能看见 */
usedBy: z.array(z.object({ packageId: z.string(), nodeId: z.string() })),
}),
),
}),
} as const satisfies RouteContract;
/** 建或改一张模板 —— id 已存在即覆盖(模板是配置,不长版本) */
export const upsertApprovalTemplateRoute = {
method: 'PUT',
path: '/api/gov/approval-templates',
body: z.object({ template: approvalTemplateSchema }),
output: z.object({ template: approvalTemplateSchema }),
} as const satisfies RouteContract;
/** 删一张模板 —— 还被审批点引着就拒(409):删了引它的节点会退回「载荷全摊开」 */
export const deleteApprovalTemplateRoute = {
method: 'DELETE',
path: '/api/gov/approval-templates/:id',
params: z.object({ id: z.string() }),
output: z.object({ ok: z.boolean() }),
} as const satisfies RouteContract;
/**
* 删整条流 —— 连同它的**所有版本**。货架上一条流一张卡,删的就是那张卡。
* 两道闸:任一版有在途单即拒(那些单要按它跑完);还有调起规则指着它也拒 ——
@@ -420,7 +451,6 @@ export const listActivitiesRoute = {
activityId: z.string(),
name: z.string(),
category: z.string(),
paradigm: paradigmSchema,
enabled: z.boolean(),
packageVersions: z.array(z.object({ version: z.string(), state: z.string(), installedAt: z.string() })),
assetVersions: z.array(z.object({ kind: z.string(), version: z.number().int(), effective: z.boolean() })),
+10 -94
View File
@@ -11,28 +11,17 @@ import { jsonSchemaSchema, sevenPartContractSchema } from './contract7.ts';
import { listenerSpecSchema } from './envelope.ts';
import { objectDeclarationSchema } from './ledger.ts';
/* ── 范式 ─────────────────────────────────────────────────────────────── */
/** 范式只存在于**引擎层**;交互层不可区分(编码规范 §9 双层边界) */
export const PARADIGMS = ['loop', 'flow'] as const;
export const paradigmSchema = z.enum(PARADIGMS);
export type Paradigm = z.infer<typeof paradigmSchema>;
/** 活动类型两维分类之一(治理台活动库):标准活动 = flow,案例活动 = loop */
export const ACTIVITY_TYPE_LABEL: Readonly<Record<Paradigm, string>> = {
loop: '案例活动',
flow: '标准活动',
};
/* ── ① 身份 ─────────────────────────────────────────────────────────── */
export const manifestIdentitySchema = z.object({
activityId: activityIdSchema,
name: z.string().min(1),
packageVersion: z.string().min(1),
/** 业务分类(一级,组织自定)—— 与活动类型两维平级、相互独立 */
/**
* 业务分类(一级,组织自定)—— 活动库唯一的一维。
* 「活动类型(标准/案例)」那一维 2026-07-29 撤销:活动不再分范式,**一律 loop**。
*/
category: z.string().min(1),
paradigm: paradigmSchema,
sdkVersion: z.string().min(1),
checksum: z.string().min(1),
signature: z.string().optional(),
@@ -71,83 +60,6 @@ export type ManifestDeclarations = z.infer<typeof manifestDeclarationsSchema>;
/* ── ④ 资产初始版 ───────────────────────────────────────────────────── */
/* flow 的业务模型:步序声明(AM 05) */
export const STEP_KINDS = ['tool', 'llm', 'human', 'pure-tool'] as const;
export const stepKindSchema = z.enum(STEP_KINDS);
export type StepKind = z.infer<typeof stepKindSchema>;
/** 失败策略:声明给定,不临场(AM 5.3) */
export const stepFailurePolicySchema = z.object({
retry: z.object({ times: z.number().int().min(0).max(10), backoff: z.string().min(2) }),
/** 重试仍败 —— 转人兜底(改发人类工具卡)或受阻待人 */
fallback: z.discriminatedUnion('kind', [
z.object({ kind: z.literal('human'), workOrder: z.enum(['execution', 'acceptance']) }),
z.object({ kind: z.literal('blocked') }),
]),
});
export type StepFailurePolicy = z.infer<typeof stepFailurePolicySchema>;
const stepBase = {
name: z.string().min(1),
label: z.string().min(1),
/** 入参映射:取自任务数据 / 上步出参 */
input: z.record(z.string(), z.string()).default({}),
/**
* 出参写入:落任务数据(草稿态)。
* `key` 指明**写哪一行**(主键列 → 作用域路径)—— 台账对象几乎都有主键,
* 不声明键就只能写出无主键的行,合并进正式版时必被非空约束挡下。
*/
output: z
.object({
domain: z.string(),
object: z.string(),
key: z.record(z.string(), z.string()).default({}),
fields: z.record(z.string(), z.string()),
})
.optional(),
/** 条件跳步:任务数据上的确定性谓词(S-FEEL),零 LLM */
when: z.string().optional(),
/**
* 这一步呈现哪张视图模版(`assets.viewTemplates` 里的 name)。
* 「flow:按**步序位置**推送声明的模版」(AM 07)——推什么由声明给定,不由临场决定。
*/
view: z.string().optional(),
failure: stepFailurePolicySchema,
};
export const flowStepSchema = z.discriminatedUnion('kind', [
z.object({ ...stepBase, kind: z.literal('tool'), tool: z.string().min(1) }),
z.object({
...stepBase,
kind: z.literal('llm'),
/** 模板与出参 schema 随声明版本冻结;出参必过 schema 校验(AM 12.3) */
model: z.string().min(1),
template: z.string().min(1),
outputSchema: jsonSchemaSchema,
}),
z.object({
...stepBase,
kind: z.literal('human'),
/** 工单两模式;末步通常是验收工单 */
workOrder: z.enum(['execution', 'acceptance']),
/** 卡内容 —— 由 card schema 渲染 */
card: z.record(z.string(), z.unknown()),
/** 异步步的完成条件 = 人事件;时限必配 */
deadline: z.string().min(2),
}),
z.object({ ...stepBase, kind: z.literal('pure-tool'), tool: z.string().min(1) }),
]);
export type FlowStep = z.infer<typeof flowStepSchema>;
export const flowModelSchema = z.object({
paradigm: z.literal('flow'),
steps: z.array(flowStepSchema).min(1),
/** 确定的并行组:组内步无依赖、全完成再继续 */
parallelGroups: z.array(z.object({ name: z.string(), steps: z.array(z.string()).min(2) })).default([]),
});
export type FlowModel = z.infer<typeof flowModelSchema>;
/* loop 的业务模型:CMMN XML + 案例说明书 + DMN(AM 03) */
export const dmnDecisionTableSchema = z.object({
@@ -184,7 +96,6 @@ export const dmnModelSchema = z.object({
export type DmnModel = z.infer<typeof dmnModelSchema>;
export const loopModelSchema = z.object({
paradigm: z.literal('loop'),
/** 案例模型 · 机器面:CMMN XML,语义引擎以它为运行结构 */
cmmnXml: z.string().min(1),
/** 案例模型 · 叙事面:说明书,与 XML **同版本发布,不允许分叉**(AM 12.2) */
@@ -193,7 +104,12 @@ export const loopModelSchema = z.object({
});
export type LoopModel = z.infer<typeof loopModelSchema>;
export const businessModelSchema = z.discriminatedUnion('paradigm', [loopModelSchema, flowModelSchema]);
/**
* 业务模型只有一种(2026-07-29 用户定:活动不再分 flow 和 loop,内部实现都是 Loop)——
* 案例模型 CMMN + 说明书 + DMN。步序声明(flow)连同它的引擎一并退役:
* 一件事该怎么办,由 Agent 依案例模型临场决定,不再有「照谱执行」这一路。
*/
export const businessModelSchema = loopModelSchema;
export type BusinessModel = z.infer<typeof businessModelSchema>;
/* 技能(AM 08):载方法不载权力 */
+25
View File
@@ -108,6 +108,29 @@ export const nudgeLadderSchema = z.object({
});
export type NudgeLadder = z.infer<typeof nudgeLadderSchema>;
/* ── 审批模板 ─────────────────────────────────────────────────────────── */
/**
* 审批活动模板(2026-07-29 用户定:审批活动要能管)。
*
* 审批点从前只在节点上现写:每个节点自己声明催办与委托语,依据一律「把载荷全摊开」。
* 模板把**可复用的那半**提出来 —— 审批人看哪几项、按什么名字看、怎么催、说什么话;
* 剩下不可复用的那半(驳回回哪个节点)仍留在节点上,那是这张图自己的事。
*
* 审批人**不在模板里**:与活动点同一口径,谁审是运营时分配的(有组按组轮值,无组全员轮值)。
*/
export const approvalTemplateSchema = z.object({
id: z.string().min(1).max(40),
name: z.string().min(1).max(40),
/** 审批人看什么:载荷字段 → 卡面显示名(空 = 把载荷全摊开,即旧行为) */
basis: z.array(z.object({ field: z.string().min(1), label: z.string().min(1) })).default([]),
/** 催办阶梯 —— 与节点上的同型,模板给默认 */
nudge: nudgeLadderSchema.optional(),
/** 委托消息:给审批人的一句话 */
message: z.string().max(200).optional(),
});
export type ApprovalTemplate = z.infer<typeof approvalTemplateSchema>;
/* ── 节点 ─────────────────────────────────────────────────────────────── */
/*
@@ -180,6 +203,8 @@ export const processNodeSchema = z.discriminatedUnion('kind', [
z.object({ kind: z.literal('reopen'), nodeId: nodeIdSchema }),
z.object({ kind: z.literal('terminate') }),
]),
/** 引哪张审批模板(看什么 / 怎么催 / 说什么);不引即旧行为:载荷全摊开 */
templateId: z.string().optional(),
nudge: nudgeLadderSchema.optional(),
message: z.string().optional(),
}),