BPOS-TMP-REPO/activities/part-substitution-assessment/__tests__/activity.test.ts

/**
 * 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<string, { type?: string; format?: string }>;
    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('判「在库」必须填得出引用依据,基座拿它去主数据里查(2026-08-27 实测:原 PN 不在库而模型把两颗都写成 found,硬阻塞那条路整个被跳过)', () => {
    const ref = byAddress(D, 'pn_check')?.fields.find((f) => f.name === 'found_pn_ref');
    expect(ref?.refersTo).toBe('parts.profile.internal_pn');
    expect(ref?.requiredWhen).toEqual({ column: 'exists_status', value: 'found' });
    expect(ref?.primaryKey ?? false).toBe(false);
  });

  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(/<humanTask id="([^"]+)"/g)].map((m) => 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(`<humanTask id="${id}"[\\s\\S]*?</humanTask>`).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('<div><script>x()</script></div>')).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-<token> 规则(选择器是从值算出来的,不是手写的)', () => {
    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;