Files
JX-BPOS/activities/quote-intake/__tests__/activity.test.ts
T
ChaiHaoandClaude Opus 5 abd371b51c DeepSeek provider + 判据 ③ 机器路径跑通(零人工兜底)
Provider 侧:
  · 新增 `provider-profile`(纯数据):各家的默认端点 / 结构化出参姿势 / 是否回推理
    集中一处,adapter 只按画像行事 —— 新增 provider 只改画像,不写一族 if-else。
    DeepSeek:`https://api.deepseek.com`,支持 json_object,v4 系列是推理模型。
  · 建实例时 URL 可留空 → 取该 provider 的默认端点(openai-compatible 本就是
    「随便哪个兼容端点」,没有默认,必须自填)。
  · 推理正文归 `reasoning` 单列:那是**过程**不是结论,不进出参、不参与 schema 校验、
    不入录制(录的是语义入参与结论)。
  · 两档实例 deepseek-v4-flash / deepseek-v4-pro 已建;`quote-extractor` 是**用途名**,
    指向 flash 档 —— 换档只改这一处绑定,活动一行不动。密钥只从环境读、落库即密封,
    治理台只回「是否已绑定」(实测:库里是密文,视图无明文字段,三个实例探活全通)。

沿路修掉五处真问题:

① **同一任务被并发推进**:推进器与派发器各推各的,用的不是同一把锁 ——
   实测同一步跑两遍、同一张卡发两张、同一行草稿写出两条互相打架的版本。
   两者改用同一把 advisory lock(键的推导提取共用)。
② **LLM 步出参从不校验**:声明了 outputSchema,解析不出来就静默当 `{}` 写下去,
   毛病要到下游缺字段时才炸、还炸在别处。改为「出参必过 schema」(AM 12.3),
   不过即按声明的失败走向,并把模型原文记进留痕,好让人看见它到底回了什么。
③ **出参路径不认点号**:入参能走 `a.b.0.c`,出参只认扁平键 ——
   模型按 schema 回嵌套结构(最常见的情形)就写出一条空记录。两边共用一份解析。
④ **归一步拿不到原文**:通道载荷只带指针不带正文、start→A1 边也没把主题正文传下去,
   模型只拿到一个单号,于是回空 records。通道载荷带原文,边映射一路带到 A1。
⑤ **出参形状没讲给模型听**:声明了 schema 却只在提示里写「只输出 JSON」,
   模型只能猜键名(实测回 `{"items":[]}` 而声明要 `{"records":[...]}`)。
   改由网关按 outputSchema 统一附上说明 —— 这是系统的事,不该每个活动作者各写一遍。

另修:连接池没有 error 处理器,空闲连接被服务端掐断会让整个进程退出(一次运维操作
就能把 API 带崩)。

结果:一封 RFQ 入站 → 模型从正文抽出 pn/brand/eau/目标价/交期 →
D1 判定跳过补全 → 查历史价 → DMN 三分类 Type A → 验收放行卡,**全程零人工兜底**。

gates: tsc / eslint / depcruise(319 模块)/ api-report / 409 测试 全绿

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
2026-07-27 10:25:57 +08:00

161 lines
6.4 KiB
TypeScript

/**
* 活动包的自测 —— **只准 import @sdk / @contracts 与白名单纯库**(编码规范 §5.1 / ADR-004)。
* 安装两审那一侧的验收在 `apps/api/.../activity-registry/__tests__` —— 二者之间只有安装通道,
* 没有代码通道,depcruise 双向隔离在守着。
*/
import { describe, expect, it } from 'vitest';
import { activityManifestSchema } from '@contracts';
import { evaluate, evaluateUnaryTest } from '@sfeel';
import { createMockHost } from '@sdk';
import { manifest, P03_DMN } from '../src/manifest.ts';
import activity from '../src/index.ts';
describe('清单本身合规', () => {
it('过 @contracts 的 schema', () => {
expect(() => activityManifestSchema.parse(manifest)).not.toThrow();
});
it('监听时限已配 —— 无悬空监听(AM 4.4)', () => {
expect(manifest.declarations.listeners.every((l) => /^P/.test(l.deadline))).toBe(true);
});
it('L1/L2 判据都给了可机检的谓词 —— 验收等级不得谎报', () => {
for (const c of manifest.contract.acceptanceCriteria) {
if (c.level === 'L1' || c.level === 'L2') expect(c.predicate ?? c.modelRef).toBeDefined();
}
});
it('禁区短而硬,授权边界给了调人预算', () => {
expect(manifest.contract.prohibitions.length).toBeGreaterThan(0);
expect(manifest.contract.authorization.humanCallBudget).toBeGreaterThan(0);
});
});
describe('步序声明(AM 12.3)', () => {
const model = manifest.assets.businessModel;
if (model.paradigm !== 'flow') throw new Error('A1 应是 flow 范式');
it('末步是验收工单 —— 完成只出自放行通过', () => {
expect(model.steps.at(-1)).toMatchObject({ kind: 'human', workOrder: 'acceptance' });
});
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('条件跳步是任务数据上的确定性谓词,由引擎求值', () => {
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('人类工具步都配了时限 —— 无死等', () => {
for (const step of model.steps) {
if (step.kind === 'human') expect(step.deadline).toMatch(/^P/);
}
});
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');
}
});
});
describe('三分类规则 P-03 —— 能算的不问 LLM', () => {
const table = P03_DMN.tables[0]!;
/** 按 DMN 语义逐行求值:FIRST 命中即定,单元格谓词复用 @sfeel */
const decide = (scope: Record<string, unknown>) => {
for (const rule of table.rules) {
const hit = table.inputs.every((input, i) => evaluateUnaryTest(rule.when[i] ?? '-', scope[input.expression], scope));
if (hit) return { type: rule.then[0], play: rule.then[1], rule: rule.id };
}
return undefined;
};
it('历史价 ≤90 天且行情稳 → A · 直接快答', () => {
expect(decide({ historyDays: 30, marketStable: true, lifecycle: '在产' })).toEqual({
type: 'A',
play: '直接快答',
rule: 'p03-a',
});
});
it('无历史 / 过期 / 波动 → B · 重估后报', () => {
expect(decide({ historyDays: 200, marketStable: false, lifecycle: '在产' })?.type).toBe('B');
});
it('EOL / 缺货 / 要求替代 → C · 转案处理(优先于 A)', () => {
expect(decide({ historyDays: 10, marketStable: true, lifecycle: 'EOL' })).toMatchObject({ type: 'C', rule: 'p03-c' });
});
it('同输入必同结论 —— 零方差、零 token', () => {
const scope = { historyDays: 30, marketStable: true, lifecycle: '在产' };
expect(decide(scope)).toEqual(decide(scope));
});
});
describe('代码入口 —— 零环境能力,一切经基座六件', () => {
const contract = {
activityId: 'quote-intake',
version: '0.1.0',
data: { customerCode: 'C001', rfqRef: 'mail:m-1001' },
message: undefined,
outputPorts: { mandatory: ['intake'], selective: [] },
prohibitions: [],
discretion: [],
} as const;
it('全部打标后提交放行', async () => {
const host = createMockHost({
contract,
ledger: {
'quote_intake.record': [
{ customer_code: 'C001', pn: 'LM358DR', brand: 'TI', eau: 5000, type_tag: 'A' },
{ customer_code: 'C001', pn: 'NE555', brand: 'TI', eau: 2000, type_tag: 'B' },
],
'quote_intake.type_table': [{ pn: 'LM358DR', type_tag: 'A' }],
},
});
const outcome = await host.run(activity);
expect(outcome).toMatchObject({ kind: 'submit', deliverable: 'intake-record' });
expect(host.recording.views).toHaveLength(1);
expect(host.recording.says.join()).toContain('A 1 条直通定价');
});
it('尚有未打标即等待,不提交放行', async () => {
const host = createMockHost({
contract,
ledger: { 'quote_intake.record': [{ customer_code: 'C001', pn: 'LM358DR' }], 'quote_intake.type_table': [] },
});
expect(await host.run(activity)).toMatchObject({ kind: 'await' });
});
it('视图模版含脚本时宿主拒推 —— 容器无脚本执行权', async () => {
const host = createMockHost({ contract });
await expect(host.base.interaction.pushHtml('<div><script>x()</script></div>')).rejects.toThrow(/无脚本执行权/);
});
it('裸调用被基座拒发 —— 调用必附上下文', async () => {
const host = createMockHost({ contract });
await expect(
host.base.interaction.issueWorkOrder({ mode: 'execution', title: 'x', basis: [], ask: 'y', fields: [] }),
).rejects.toThrow(/裸调用/);
});
it('监听时限必配 —— 无死等', async () => {
const host = createMockHost({ contract });
await expect(host.base.tools.listen({ eventType: 'data', keyFilter: {}, deadline: '' })).rejects.toThrow(/时限必配/);
});
});