/** * ACT-WORK-05 差异评估的包内自测 —— **只准 import @sdk / @contracts / @sfeel**。 * 案例活动没有 `run`,自测不跑回合;测的是清单本身与授权面对齐,结构照 E04 / I01。 * * 七组:清单本身合规 / 台账声明 / 案例模型与清单的对齐 / 报告模版:编辑面与只读面各就各位 / * 徽标别名与值域相关的坑(2026-08-27 实测账,回归网)/ 可编辑件的主键与必填列 * (2026-08-27 复审,回归网)/ 活动入口。 */ import { describe, expect, it } from 'vitest'; import { activityManifestSchema } from '@contracts'; import { createMockHost } from '@sdk'; import { manifest, D, RULE_VERSION } from '../src/manifest.ts'; import activity from '../src/index.ts'; const ITEMS = ['S0_bind', 'S0d_p08_master', 'S0d_p10_document', 'S1_input_confirm', 'S2_normalize', 'S3_assess', 'S4_review', 'S5_prepare_landing', 'T_release']; const NO_DONE_WHEN = new Set(['S0d_p08_master', 'S0d_p10_document', 'S1_input_confirm', 'S4_review', 'T_release']); const VIEWS = ['p08-master-create', 'p10-document-create', 'eval-input-list', 'difference-review', 'landing-confirm']; const byAddress = (domain: string, object: string) => manifest.declarations.ledger.find((l) => l.domain === domain && l.object === object); const viewHtml = (name: string) => manifest.assets.viewTemplates.find((t) => t.name === name)?.html ?? ''; describe('清单本身合规', () => { it('过 @contracts 的 schema', () => { expect(() => activityManifestSchema.parse(manifest)).not.toThrow(); }); it('没有静态监听(等外部回音一律落在执行工单上,listen 在本仓不可用)', () => { expect(manifest.declarations.listeners).toEqual([]); }); it('L1/L2 判据都给了谓词;L4 三条不给(裁量项);L5 恰一条', () => { for (const c of manifest.contract.acceptanceCriteria) { if (c.level === 'L1' || c.level === 'L2') expect(c.predicate, c.key).toBeDefined(); if (c.level === 'L4') expect(c.predicate, c.key).toBeUndefined(); } expect(manifest.contract.acceptanceCriteria.filter((c) => c.level === 'L4')).toHaveLength(3); expect(manifest.contract.acceptanceCriteria.filter((c) => c.level === 'L5')).toHaveLength(1); }); it('机检谓词只读基座读数与记账旗:不出现活动自报的汇总列名', () => { const forbidden = ['relation_total', 'candidate_total', 'recommended_total', 'not_recommended_total']; for (const c of manifest.contract.acceptanceCriteria) { for (const name of forbidden) expect(c.predicate ?? '', `${c.key} 读了自报数 ${name}`).not.toContain(name); } }); it('三件必交付物都有台账地址;人环预算严格大于「基线 8 + 两轮审核循环 4」', () => { expect(manifest.contract.requiredDeliverables).toHaveLength(3); for (const d of manifest.contract.requiredDeliverables) expect(d.ledger, d.key).toBeDefined(); expect(manifest.contract.authorization.humanCallBudget).toBeGreaterThan(12); expect(manifest.contract.resources.budget.humanCalls).toBeGreaterThan(12); }); it('起单只必填 4 项(客户 / 需求 / 原 PN / 候选数组);datasheet 是选填文件', () => { expect(manifest.contract.input.data['required']).toEqual(['customerCode', 'requestDescription', 'originalInternalPn', 'candidateInternalPns']); const properties = manifest.contract.input.data['properties'] as Record; expect(properties['candidateInternalPns']?.type).toBe('array'); expect(properties['datasheets']?.format).toBe('file'); }); it('五条样例:第一条满载走数据工单那条路,名字 ≤14 字,形状各不相同', () => { expect(manifest.samples).toHaveLength(5); for (const s of manifest.samples) expect(s.name.length, s.name).toBeLessThanOrEqual(14); expect(new Set(manifest.samples.map((s) => JSON.stringify(s.input))).size).toBe(5); const first = manifest.samples[0]?.input as { candidateInternalPns?: string[] }; expect(first.candidateInternalPns).toContain('XL2596S-5.0'); const newCustomer = manifest.samples.find((s) => (s.input as { customerName?: string }).customerName !== undefined); expect(newCustomer).toBeDefined(); }); it('五张视图模版都声明了,剧本每一步引用的 view 都在其中', () => { expect(new Set(manifest.assets.viewTemplates.map((v) => v.name))).toEqual(new Set(VIEWS)); for (const step of manifest.assets.businessModel.steps as ReadonlyArray<{ view?: string }>) { if (step.view !== undefined) expect(VIEWS, step.view).toContain(step.view); } }); }); describe('台账声明:授权面与《统一方案》口径', () => { it('P-08 主键 internal_pn,标准化参数集拆成独立子表 parts.parameter(2026-08-27 结构改:与目标件一致)', () => { const p08 = byAddress('parts', 'profile'); expect(p08?.fields.filter((f) => f.primaryKey).map((f) => f.name)).toEqual(['internal_pn']); expect(p08?.fields.find((f) => f.name === 'normalized_parameter_set')).toBeUndefined(); const param = byAddress('parts', 'parameter'); expect(param?.kind).toBe('master'); expect(param?.fields.filter((f) => f.primaryKey).map((f) => f.name)).toEqual(['internal_pn', 'param_name']); expect(param?.fields.find((f) => f.name === 'internal_pn')?.refersTo).toBe('parts.profile.internal_pn'); expect(param?.fields.find((f) => f.name === 'param_value')?.required).toBe(true); expect(param?.fields.find((f) => f.name === 'constraint_type')?.tally).toEqual(['hard', 'soft']); expect(param?.fields.find((f) => f.name === 'constraint_type')?.required).toBe(true); }); it('P-11 主记录的原 PN / 候选 PN 都是引用墙(查无此料当场拒 —— 存在性检查的硬门)', () => { const rel = byAddress('substitution', 'relation'); for (const name of ['original_internal_pn', 'candidate_internal_pn']) { expect(rel?.fields.find((f) => f.name === name)?.refersTo, name).toBe('parts.profile.internal_pn'); } }); it('客户批准状态**不在声明里**:本活动没有它的写权(只读边界)', () => { const rel = byAddress('substitution', 'relation'); expect(rel?.fields.map((f) => f.name)).not.toContain('customer_approval_status'); }); it('UNKNOWN 必有去向:unknown_disposition 钉在 difference_status = unknown 的行上;四态是 ASCII tally', () => { const item = byAddress('substitution', 'difference_item'); expect(item?.fields.find((f) => f.name === 'unknown_disposition')?.requiredWhen).toEqual({ column: 'difference_status', value: 'unknown' }); expect(item?.fields.find((f) => f.name === 'difference_status')?.tally).toEqual(['match', 'mismatch', 'unknown', 'conditional']); expect(item?.fields.find((f) => f.name === 'substitution_relation_id')?.distinct).toBe(true); }); it('P-01 回写五项钉在 current_stage = gate03 那一刻(放行前不拦,放行门 L2 数得出来)', () => { const p01 = byAddress('demand', 'request'); for (const name of ['risk_level', 'verification_requirement', 'output_ref', 'next_action', 'current_activity']) { expect(p01?.fields.find((f) => f.name === name)?.requiredWhen, name).toEqual({ column: 'current_stage', value: 'gate03' }); } }); it('自持单据都带 caseKey eval_ref 且在主键里;放弃候选必须写原因', () => { for (const object of ['pn_check', 'input_gap', 'verdict']) { const t = byAddress(D, object); expect(t?.kind, object).toBe('record'); expect(t?.caseKey, object).toBe('eval_ref'); expect(t?.fields.find((f) => f.name === 'eval_ref')?.primaryKey, object).toBe(true); } expect(byAddress(D, 'pn_check')?.fields.find((f) => f.name === 'abandon_reason')?.requiredWhen).toEqual({ column: 'exists_status', value: 'abandoned' }); }); it('规则版本常量随包冻结', () => { expect(RULE_VERSION).toBe('R-2026.07'); expect(manifest.assets.businessModel.dmn.tables.map((t) => t.id)).toEqual(['d01-difference-status', 'd02-recommendation']); }); }); describe('案例模型与清单的对齐', () => { it('九个计划项,剧本 item 与 CMMN humanTask id 一一对应', () => { const cmmnIds = [...manifest.assets.businessModel.cmmnXml.matchAll(/ m[1] ?? ''); expect(cmmnIds).toEqual(ITEMS); expect((manifest.assets.businessModel.steps as ReadonlyArray<{ item: string }>).map((s) => s.item)).toEqual(ITEMS); }); it('五处不给 doneWhen(两张数据工单 / 输入确认 / 审核 / 放行),其余四处都给', () => { for (const s of manifest.assets.businessModel.steps as ReadonlyArray<{ item: string; doneWhen?: string }>) { if (NO_DONE_WHEN.has(s.item)) expect(s.doneWhen, s.item).toBeUndefined(); else expect(s.doneWhen, s.item).toBeDefined(); } }); it('两张数据工单件各自绑自己的 view(P-08 与 P-10 不共用同一份画面)', () => { const steps = manifest.assets.businessModel.steps as ReadonlyArray<{ item: string; view?: string }>; expect(steps.find((s) => s.item === 'S0d_p08_master')?.view).toBe('p08-master-create'); expect(steps.find((s) => s.item === 'S0d_p10_document')?.view).toBe('p10-document-create'); }); it('那五项在 CMMN 里都标了人工激活', () => { for (const id of NO_DONE_WHEN) { const block = new RegExp(``).exec(manifest.assets.businessModel.cmmnXml)?.[0] ?? ''; expect(block, id).toContain('manualActivationRule'); } }); it('除放行外每一项恰好属于一个阶段;5 段 + 放行 = x/6,与文档 0.5/1/2/3/4/5 六步对齐', () => { const phases = manifest.assets.businessModel.phases ?? []; expect(phases).toHaveLength(5); const phaseItems = phases.flatMap((p) => p.items); expect([...phaseItems].sort()).toEqual([...ITEMS.filter((i) => i !== 'T_release')].sort()); expect(new Set(phaseItems).size).toBe(phaseItems.length); }); it('说明书点名的计划项都真实存在', () => { const mentioned = [...manifest.assets.businessModel.narrative.matchAll(/\b(S\d[a-z]?_[a-zA-Z_]+|T_release)\b/g)].map((m) => m[1] ?? ''); for (const name of mentioned) expect(ITEMS, `说明书提到但不存在的计划项: ${name}`).toContain(name); }); it('两种决策卡骨架都在说明书里:候选放弃/创建(create/abandon)与审核(approve/reject/custom:)', () => { const n = manifest.assets.businessModel.narrative; expect(n).toContain('"kind":"decide","itemId":"S0d_p08_master"'); expect(n).toContain('"value":"create"'); expect(n).toContain('"value":"abandon"'); expect(n).toContain('"kind":"decide","itemId":"S4_review"'); expect(n).toContain('"approve"'); expect(n).toContain('"reject"'); expect(n).toContain('"custom:"'); }); it('T_release 剧本里 judge criterion 的原文逐字对得上 acceptanceCriteria 的 label', () => { const tRelease = (manifest.assets.businessModel.steps as ReadonlyArray<{ item: string; guide?: string }>).find((s) => s.item === 'T_release'); const quoted = [...(tRelease?.guide ?? '').matchAll(/judge criterion="([^"]+)"/g)].map((m) => m[1] ?? ''); expect(quoted).toHaveLength(3); const labels = new Set(manifest.contract.acceptanceCriteria.map((c) => c.label)); for (const q of quoted) expect(labels.has(q), q).toBe(true); }); }); describe('报告模版:编辑面与只读面各就各位', () => { it('P-08 数据工单件的表 1 + 表 2(标准化参数子表)都可加行可编辑:data-edit / data-edit-add 与主键 data-col 都在', () => { const p08 = viewHtml('p08-master-create'); expect(p08).toContain('data-edit="parts.profile"'); expect(p08).toContain('data-edit-add="parts.profile"'); expect(p08).toContain('data-col="internal_pn"'); expect(p08).toContain('data-edit="parts.parameter"'); expect(p08).toContain('data-edit-add="parts.parameter"'); expect(p08).toContain('data-col="param_name"'); expect(p08).toContain('data-col="param_value"'); expect(p08).toContain('data-col="constraint_type"'); const p10 = viewHtml('p10-document-create'); expect(p10).toContain('data-edit="parts.document"'); expect(p10).toContain('data-col="doc_seq"'); }); it('评估输入清单:缺口表可编辑(supplement),绑定区只读', () => { const html = viewHtml('eval-input-list'); expect(html).toContain(`data-edit="${D}.input_gap"`); expect(html).toContain('data-col="supplement"'); expect(html).toContain(`data-rows="mine:${D}.pn_check"`); }); it('差异审核与落账确认只读:没有任何 data-edit / data-col', () => { for (const name of ['difference-review', 'landing-confirm']) { expect(viewHtml(name), name).not.toContain('data-edit='); expect(viewHtml(name), name).not.toContain('data-col='); } }); it('每个可编辑格子的 data-col 都在对应台账对象的声明里(p08-master-create 一屏两张表,两张台账对象的声明并起来看)', () => { const cases: Array<[string, Array<[string, string]>]> = [ ['p08-master-create', [['parts', 'profile'], ['parts', 'parameter']]], ['p10-document-create', [['parts', 'document']]], ['eval-input-list', [[D, 'input_gap']]], ]; for (const [view, objects] of cases) { const cols = new Set([...viewHtml(view).matchAll(/data-col="([^"]+)"/g)].map((m) => m[1] ?? '')); const declared = new Set(objects.flatMap(([domain, object]) => byAddress(domain, object)?.fields.map((f) => f.name) ?? [])); for (const c of cols) expect(declared.has(c), `${view}: ${c}`).toBe(true); } }); it('枚举列只用 data-class-of 投影,不摆 ASCII 原值', () => { expect(viewHtml('difference-review')).toContain('data-class-of="difference_status"'); expect(viewHtml('difference-review')).toContain('data-class-of="recommendation_level"'); expect(viewHtml('difference-review')).not.toContain('data-slot="difference_status"'); const landing = viewHtml('landing-confirm'); for (const col of ['request_status', 'current_stage', 'analysis_status', 'recommendation_level']) { expect(landing, col).toContain(`data-class-of="${col}"`); expect(landing, col).not.toContain(`data-slot="${col}"`); } }); it('宿主拒推含脚本的模版', async () => { const host = createMockHost({ contract: CONTRACT }); await expect(host.base.interaction.pushHtml('
')).rejects.toThrow(/无脚本执行权/); }); it('五张模版的外壳都是搬自目标件的 page/card,不再含 E04/I01 那套视觉底(.proto-root)的痕迹', () => { for (const view of VIEWS) { const html = viewHtml(view); expect(html, view).toContain('class="card-head"'); expect(html, view).toContain('class="card-foot"'); expect(html, view).not.toContain('proto-root'); } }); }); /* * 2026-08-27 实测账,两条都真截图 + SQL 复核过: * ① **带下划线的枚举值一律显示成「待定」**——平台有两套互相打架的消毒规则: * `data-class-of` 投影出的 class 走 `view-render.ts` 的 `classToken`(只留 `[a-z0-9-]`, * 吃掉下划线,`pin_to_pin` → `v-pintopin`);基座读数名走 `engines.ts` 的 `slug` * (只留 `[a-z0-9_]`,吃掉连字符)。手写 `.v-pin_to_pin` 那种选择器永远匹配不上 —— * 这条测试把 `manifest.declarations.ledger` 里每一个「模版真的摆了徽标」的 tally 列过一遍, * 用与 `classToken` 一字不差的 `vtok` 算出选择器,断言对应的 CSS 规则确实存在。 * ② **缺口表补充内容每一行都摆红「必填」,而闸只认 3 行**——`requiredWhen` 是按行不按列, * 静态 `class="req"` 把整列都标了必填。 */ describe('徽标别名与值域相关的坑(2026-08-27 实测账,回归网)', () => { /** 必须与 `apps/api/src/modules/interaction/internal/domain/view-render.ts` 的 `classToken` 一字不差 */ const vtok = (v: string): string => v.toLowerCase().replace(/[^a-z0-9-]/g, '').slice(0, 24); /** 每张模版真的摆了徽标的那几列(带下划线的 tally 值最容易漏,漏了就是「待定」那次事故) */ const BADGED: ReadonlyArray<{ view: string; domain: string; object: string; column: string }> = [ { view: 'p08-master-create', domain: 'parts', object: 'profile', column: 'lifecycle_status' }, { view: 'p08-master-create', domain: 'parts', object: 'parameter', column: 'constraint_type' }, { view: 'p10-document-create', domain: 'parts', object: 'document', column: 'document_type' }, { view: 'p10-document-create', domain: 'parts', object: 'document', column: 'document_status' }, { view: 'eval-input-list', domain: D, object: 'pn_check', column: 'exists_status' }, { view: 'eval-input-list', domain: D, object: 'pn_check', column: 'role' }, { view: 'eval-input-list', domain: D, object: 'input_gap', column: 'status' }, { view: 'difference-review', domain: 'substitution', object: 'relation', column: 'substitution_type' }, { view: 'difference-review', domain: 'substitution', object: 'relation', column: 'recommendation_level' }, { view: 'difference-review', domain: 'substitution', object: 'relation', column: 'risk_level' }, { view: 'difference-review', domain: 'substitution', object: 'difference_item', column: 'constraint_type' }, { view: 'difference-review', domain: 'substitution', object: 'difference_item', column: 'difference_status' }, { view: 'difference-review', domain: 'substitution', object: 'difference_item', column: 'risk_level' }, { view: 'landing-confirm', domain: 'substitution', object: 'relation', column: 'substitution_type' }, { view: 'landing-confirm', domain: 'substitution', object: 'relation', column: 'recommendation_level' }, { view: 'landing-confirm', domain: 'substitution', object: 'relation', column: 'analysis_status' }, { view: 'landing-confirm', domain: 'substitution', object: 'relation', column: 'risk_level' }, { view: 'landing-confirm', domain: 'demand', object: 'request', column: 'request_status' }, ]; it('每张模版摆了徽标的每个 tally 列,声明里的每个值都有对应的 v- 规则(选择器是从值算出来的,不是手写的)', () => { for (const { view, domain, object, column } of BADGED) { const tally = byAddress(domain, object)?.fields.find((f) => f.name === column)?.tally ?? []; expect(tally.length, `${domain}.${object}.${column} 没有声明 tally`).toBeGreaterThan(0); const html = viewHtml(view); for (const value of tally) { expect(html, `${view}: ${domain}.${object}.${column}=${value} → 应有 .v-${vtok(value)}::after`).toContain(`.v-${vtok(value)}::after`); } } }); it('缺口表补充内容按行投影必填,不是整列静态 req(requiredWhen 是按行的,不是按列的)', () => { const html = viewHtml('eval-input-list'); expect(html).not.toContain('class="req" data-h="补充内容"'); expect(html).toContain('data-class-of="status"'); expect(html).toContain('.sup.v-gap'); }); }); /* * 2026-08-27 定向复审逮住的两条 Critical(都是这一轮版面重做新引入的回归,不是原有的坑): * ① `sub_eval.input_gap` 的「键」(`item_key`)那一格丢了 `data-col` —— 一单 11 行,`item_key` * 逐行不同,人保存**任何一行**时服务端 `resolveRowKey` 凑不出主键(它既不在件上、 * 又不是「全表一致」的那种案号型列),整格落不下去; * ② `sub_eval.input_gap.status` 声明 `required: true`,件上又有「+ 加一行」—— * 降成只读徽标后,人新加的行永远没有格子能把这一列填上,`_missing` 恒为正、 * 提交闸永远拦着,这是「墙不配路」的死路形态。 * 两条各配一张回归网,防的是同一类事故再出现在别的字段上。 */ describe('可编辑件的主键与必填列(2026-08-27 复审:主键丢钥匙 / 必填填不了,两条 Critical 回归)', () => { /** 三张真能编辑的件与它们各自绑定的台账对象 */ const EDITABLE: ReadonlyArray<{ view: string; domain: string; object: string }> = [ { view: 'p08-master-create', domain: 'parts', object: 'profile' }, { view: 'p08-master-create', domain: 'parts', object: 'parameter' }, { view: 'p10-document-create', domain: 'parts', object: 'document' }, { view: 'eval-input-list', domain: D, object: 'input_gap' }, ]; it('每一个主键列都有 data-col —— 它不是编辑面,是行的钥匙,丢了就整行保存不下去', () => { for (const { view, domain, object } of EDITABLE) { const table = byAddress(domain, object); /* * `caseKey` 声明的那一列(如 `eval_ref`)是例外:它是「一单一号,全表当然一致」的 * 案号型主键(与 I01 的 `round_ref` 同款),件上压根不摆,服务端 `resolveRowKey` * 按「全表一致」自动补上(`apps/api/src/app/routes/desk.ts` 注释里点名的那条路)—— * 摆出来给人填反而是错的(那会让人以为能按行改案号)。真正逐行不同、必须挂 * `data-col` 的,是主键里除 caseKey 之外的那几列(如 `item_key`)。 */ const pk = (table?.fields.filter((f) => f.primaryKey).map((f) => f.name) ?? []).filter((name) => name !== table?.caseKey); expect(pk.length, `${domain}.${object} 没有非 caseKey 的主键列`).toBeGreaterThan(0); const html = viewHtml(view); for (const col of pk) { expect(html, `${view}: 主键列 ${domain}.${object}.${col} 缺 data-col`).toContain(`data-col="${col}"`); } } }); it('可编辑件上,每一个 required:true 的列都有真能填的控件(data-col)—— 必填但填不了是墙不配路', () => { for (const { view, domain, object } of EDITABLE) { const table = byAddress(domain, object); const required = table?.fields.filter((f) => f.required === true).map((f) => f.name) ?? []; expect(required.length, `${domain}.${object} 没有声明 required 列`).toBeGreaterThan(0); const html = viewHtml(view); for (const col of required) { expect(html, `${view}: 必填列 ${domain}.${object}.${col} 没有可填的控件`).toContain(`data-col="${col}"`); } } }); }); describe('活动入口', () => { it('没有 run —— 行为全在清单里', () => { expect(activity.run).toBeUndefined(); }); }); const CONTRACT = { activityId: 'part-substitution-assessment', version: '1.0.0', data: {}, message: undefined, outputPorts: { mandatory: ['assessment-released'], selective: [] }, prohibitions: [], discretion: [], } as const;