/** CMMN 子集解析、生命周期与 DMN —— domain 测试零 mock(AM 03 / 04) */
import { describe, expect, it } from 'vitest';
import type { DmnDecisionTable, DmnModel } from '@contracts';
import type { CaseRuntime } from '../internal/domain/lifecycle.ts';
import { CmmnParseError, parseCmmn } from '../internal/domain/cmmn-parse.ts';
import {
autoCompleteReady,
canTransitionItem,
IllegalTransitionError,
initialRuntime,
markWorldTouched,
mayCompleteCase,
mayTerminateCase,
navigate,
occur,
publishEnabled,
reenter,
transitionItem,
} from '../internal/domain/lifecycle.ts';
import { deduceGaps, evaluateTable, evaluationOrder } from '../internal/domain/dmn.ts';
/** 渠道寻源 A3 的极简案例模型 —— 取自 MVP 示例(S1 接需核史 → S2 选渠定策 → S3 发询比价) */
const XML = `
create
create
semantic: 回价是否可信
P4D
`;
describe('parseCmmn —— 子集封顶', () => {
const model = parseCmmn(XML);
it('读出案计划与自动完成', () => {
expect(model.name).toBe('渠道寻源');
expect(model.autoComplete).toBe(true);
});
it('读出任务数据(CaseFileItem)', () => {
expect(model.fileItems.map((f) => f.id)).toEqual(['inquiry', 'quotes']);
});
it('读出全部计划项与类型', () => {
expect(model.items.map((i) => `${i.id}:${i.type}`)).toEqual([
'S1:stage',
'T1:humanTask',
'D1:decisionTask',
'T2:humanTask',
'M1:milestone',
'TL1:timerEventListener',
]);
});
it('manualActivationRule 被识别 —— Enabled ≠ Active', () => {
expect(model.items.find((i) => i.id === 'T1')?.manualActivation).toBe(true);
expect(model.items.find((i) => i.id === 'D1')?.manualActivation).toBe(false);
});
it('planning table 里的项标为裁量项', () => {
expect(model.items.find((i) => i.id === 'T2')?.discretionary).toBe(true);
expect(model.items.find((i) => i.id === 'T1')?.discretionary).toBe(false);
});
it('entryCriterion 关到 sentry 的 onPart', () => {
const stage = model.items.find((i) => i.id === 'S1');
expect(stage?.entryCriteria[0]?.onParts[0]).toEqual({ kind: 'file', ref: 'inquiry', event: 'create' });
});
it('decisionRef 与 timerExpression', () => {
expect(model.items.find((i) => i.id === 'D1')?.decisionRef).toBe('strategy');
expect(model.items.find((i) => i.id === 'TL1')?.timerExpression).toBe('P4D');
});
it('表外构件直接报错 —— 不静默忽略', () => {
const bad = XML.replace('', '');
expect(() => parseCmmn(bad)).toThrow(CmmnParseError);
});
it('标签不匹配报错', () => {
expect(() => parseCmmn('')).toThrow(CmmnParseError);
});
});
describe('生命周期 —— 语义忠实,引擎不得私改迁移拓扑', () => {
it('计划项八态的合法迁移', () => {
expect(canTransitionItem('Available', 'Enabled')).toBe(true);
expect(canTransitionItem('Enabled', 'Active')).toBe(true);
expect(canTransitionItem('Active', 'Completed')).toBe(true);
expect(canTransitionItem('Enabled', 'Completed')).toBe(false);
expect(canTransitionItem('Completed', 'Active')).toBe(false);
});
it('非法迁移抛错', () => {
const model = parseCmmn(XML);
const runtime = initialRuntime(model);
expect(() => transitionItem(runtime, 'T1', 'Completed')).toThrow(IllegalTransitionError);
});
it('里程碑只有一条主迁移 Available →(occur)→ Completed', () => {
const model = parseCmmn(XML);
const next = occur(initialRuntime(model), 'M1');
expect(next.items.find((i) => i.id === 'M1')?.state).toBe('Completed');
expect(next.milestones).toEqual(['M1']);
});
it('驳回是迁移不是状态:新实例重新入场', () => {
const model = parseCmmn(XML);
let runtime = transitionItem(initialRuntime(model), 'T1', 'Enabled');
runtime = transitionItem(runtime, 'T1', 'Active');
const next = reenter(runtime, 'T1');
expect(next.items.find((i) => i.id === 'T1')).toEqual({ id: 'T1', state: 'Available', instance: 2 });
});
describe('markWorldTouched —— finish 前的证据(AM 12.2 原理一)', () => {
it('标一个项 —— 其余项原样不动', () => {
const model = parseCmmn(XML);
const next = markWorldTouched(initialRuntime(model), 'T1');
expect(next.items.find((i) => i.id === 'T1')?.worldTouched).toBe(true);
expect(next.items.find((i) => i.id !== 'T1')?.worldTouched).toBeUndefined();
});
it('驳回重新入场是新实例 —— 标记不带过去,得重新证明真触达过', () => {
const model = parseCmmn(XML);
const touched = markWorldTouched(initialRuntime(model), 'T1');
const next = reenter(touched, 'T1');
expect(next.items.find((i) => i.id === 'T1')?.worldTouched).toBeUndefined();
});
});
});
describe('终局唯放行与 Harness —— AI 不得产生终局迁移', () => {
it('Completed 只出自放行', () => {
expect(mayCompleteCase('release')).toBe(true);
expect(mayCompleteCase('harness')).toBe(false);
expect(mayCompleteCase('owner')).toBe(false);
});
it('Terminated 只出自 Harness / 负责人 / 治理台', () => {
expect(mayTerminateCase('harness')).toBe(true);
expect(mayTerminateCase('owner')).toBe(true);
expect(mayTerminateCase('governance')).toBe(true);
expect(mayTerminateCase('release')).toBe(false);
});
});
describe('publishEnabled —— 引擎推进到 Enabled 为止', () => {
const model = parseCmmn(XML);
it('前提未满足时不发布', () => {
const enabled = publishEnabled(model, initialRuntime(model), {}, new Set(), () => true);
expect(enabled.entries.map((e) => e.id)).not.toContain('S1');
});
it('onPart 件到 + 无 ifPart → Enabled', () => {
const enabled = publishEnabled(model, initialRuntime(model), { inquiry: {} }, new Set(['inquiry']), () => true);
expect(enabled.entries.map((e) => e.id)).toContain('S1');
});
it('父阶段未激活的子项不入场', () => {
const enabled = publishEnabled(model, initialRuntime(model), { inquiry: {} }, new Set(['inquiry']), () => true);
expect(enabled.entries.map((e) => e.id)).not.toContain('T1');
});
it('manualActivation 的项标出「须 Agent 启动」', () => {
let runtime = initialRuntime(model);
runtime = transitionItem(runtime, 'S1', 'Enabled');
runtime = transitionItem(runtime, 'S1', 'Active');
const enabled = publishEnabled(model, runtime, { inquiry: {} }, new Set(['inquiry']), () => true);
expect(enabled.entries.find((e) => e.id === 'T1')?.requiresManualStart).toBe(true);
});
});
describe('navigate —— 导航即交集,断点即人环', () => {
it('有交集即择优推进', () => {
const nav = navigate(
{ entries: [{ id: 'a', name: 'A', type: 'humanTask', requiresManualStart: true, discretionary: false }], inProgress: [], judgements: [], gaps: ['缺报价'], activeStages: [] },
new Set(['a']),
);
expect(nav.kind).toBe('proceed');
});
it('交集为空**且手上没开着的活**才是断点 —— 调人或立监听的判定时机', () => {
const nav = navigate({ entries: [], inProgress: [], judgements: [], gaps: ['缺客户信用'], activeStages: [] }, new Set(['a']));
expect(nav).toEqual({ kind: 'breakpoint', gaps: ['缺客户信用'] });
});
/*
* 断点的定义是「无路可走」。手上还有开着的活就不算 —— 从前只看 Enabled 集,
* 局面推进开以后手上全是 Active,每拍都判成断点,而断点的处置是「调人或立监听」:
* 环于是把没干完的活丢下,去等一个不会来的事件。
*/
it('Enabled 为空但有进行中的项 → 接着干,不是断点', () => {
const nav = navigate(
{
entries: [],
inProgress: [{ id: 'w', name: '正在查历史价', type: 'humanTask', requiresManualStart: false, discretionary: false }],
judgements: [],
gaps: ['缺分类表'],
activeStages: [],
},
new Set(['nothing']),
);
expect(nav).toEqual({ kind: 'proceed', candidates: [{ id: 'w', name: '正在查历史价', type: 'humanTask', requiresManualStart: false, discretionary: false }] });
});
it('无缺口即收敛', () => {
expect(navigate({ entries: [], inProgress: [], judgements: [], gaps: [], activeStages: [] }, new Set()).kind).toBe('converged');
});
});
describe('autoCompleteReady —— 齐了即收', () => {
it('必做项未完不收', () => {
const model = parseCmmn(XML);
expect(autoCompleteReady(model, initialRuntime(model))).toBe(false);
});
});
/* ── DMN:三分类规则 P-03 ─────────────────────────────────────────── */
const p03: DmnDecisionTable = {
id: 'p03',
label: '三分类规则 P-03',
hitPolicy: 'FIRST',
inputs: [
{ name: 'days', expression: 'historyDays' },
{ name: 'stable', expression: 'marketStable' },
],
outputs: [{ name: 'type' }, { name: 'play' }],
rules: [
{ id: 'r1', when: ['<= 90', 'true'], then: ['A', '直接快答'] },
{ id: 'r2', when: ['-', '-'], then: ['B', '重估后报'] },
],
};
const evalExpr = (expr: string, scope: Readonly>): unknown => scope[expr];
const evalTest = (cell: string, value: unknown): boolean => {
const trimmed = cell.trim();
if (trimmed === '-' || trimmed === '') return true;
if (trimmed.startsWith('<=')) return Number(value) <= Number(trimmed.slice(2));
if (trimmed === 'true') return value === true;
return String(value) === trimmed.replace(/^"|"$/g, '');
};
describe('evaluateTable —— 能算的不问 LLM', () => {
it('命中首行,留痕带命中规则行', () => {
const result = evaluateTable(p03, { historyDays: 30, marketStable: true }, evalExpr, evalTest);
expect(result.kind).toBe('decided');
if (result.kind === 'decided') {
expect(result.trace.hitRules).toEqual(['r1']);
expect(result.trace.outputs).toEqual({ type: 'A', play: '直接快答' });
expect(result.trace.inputs).toEqual({ days: 30, stable: true });
}
});
it('同输入必同结论 —— 零方差', () => {
const a = evaluateTable(p03, { historyDays: 30, marketStable: true }, evalExpr, evalTest);
const b = evaluateTable(p03, { historyDays: 30, marketStable: true }, evalExpr, evalTest);
expect(a).toEqual(b);
});
it('落到兜底行', () => {
const result = evaluateTable(p03, { historyDays: 200, marketStable: false }, evalExpr, evalTest);
if (result.kind === 'decided') expect(result.trace.outputs['type']).toBe('B');
});
it('输入不齐即 incomplete —— DRD 指出缺什么', () => {
const result = evaluateTable(p03, { historyDays: 30 }, evalExpr, evalTest);
expect(result).toEqual({ kind: 'incomplete', missing: ['stable'] });
});
});
describe('DRD —— 缺口演绎与拓扑序', () => {
const model: DmnModel = {
drd: [
{ decision: 'price', requires: ['margin'], inputs: ['basePrice'] },
{ decision: 'margin', requires: [], inputs: ['customerGrade', 'materialType'] },
],
tables: [],
};
it('反向遍历给出缺口', () => {
expect(deduceGaps(model, 'price', new Set(['basePrice']))).toEqual([
{ kind: 'decision', ref: 'margin' },
{ kind: 'input', ref: 'customerGrade' },
{ kind: 'input', ref: 'materialType' },
]);
});
it('已知项不再算缺口', () => {
expect(deduceGaps(model, 'price', new Set(['basePrice', 'margin']))).toEqual([]);
});
it('拓扑序:先算上游决策', () => {
expect(evaluationOrder(model, 'price')).toEqual(['margin', 'price']);
});
it('成环即报错', () => {
const cyclic: DmnModel = { drd: [{ decision: 'a', requires: ['b'], inputs: [] }, { decision: 'b', requires: ['a'], inputs: [] }], tables: [] };
expect(() => evaluationOrder(cyclic, 'a')).toThrow(/成环/);
});
});
describe('先验迁移再动手 —— 不合法的行动不留痕迹', () => {
it('Available → Disabled 是非法迁移,transitionItem 抛错', () => {
const runtime: CaseRuntime = {
items: [{ id: 'T1', state: 'Available', instance: 1 }],
milestones: [],
state: 'Active',
};
// 引擎语义忠实:不私改迁移拓扑。AI 提了就拒,拒在**副作用之前**
expect(() => transitionItem(runtime, 'T1', 'Disabled')).toThrow();
});
it('不存在的计划项同样拒 —— AI 可能报一个图上没有的 id', () => {
const runtime: CaseRuntime = { items: [], milestones: [], state: 'Active' };
expect(() => transitionItem(runtime, '不存在', 'Active')).toThrow();
});
it('Available → Active 合法', () => {
const runtime: CaseRuntime = {
items: [{ id: 'T1', state: 'Available', instance: 1 }],
milestones: [],
state: 'Active',
};
expect(transitionItem(runtime, 'T1', 'Active').items[0]?.state).toBe('Active');
});
});