@longzai-intelligence-issues/ledger 0.0.1

package/src/__tests__/close/verify-close.commands.test.ts

@@ -0,0 +1,560 @@
+import { parseLziIssuesConfig } from '@longzai-intelligence-issues/config';
+import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+import { findPendingWord, readEvidence } from '@/close/evidence-reader.utils';
+import { applyGreenFlip } from '@/close/green-flip.commands';
+import {
+  evidenceCloseFlow,
+  rerunCloseFlow,
+  resolveCloseGates,
+} from '@/close/verify-close.commands';
+import { freezeIssue, unfreezeIssue } from '@/freeze/freeze.commands';
+import { normalizeHeader } from '@/normalize/normalize-header.commands';
+import { computeCriterionFingerprint, runCriterionViaVault } from '@/vault/vault.commands';
+
+/**
+ * 测试夹具根（包内临时目录）
+ */
+const FIXTURE_ROOT = join(import.meta.dir, '__tmp-close__');
+
+/**
+ * 注册表目录
+ */
+const REGISTRY_REL = 'docs/issues';
+
+/**
+ * 解析后的测试配置（含两级门禁正则）
+ */
+const CONFIG = parseLziIssuesConfig({
+  schemaVersion: 1,
+  scopes: [{ key: 'root', title: '全局', paths: ['.'], registryDir: REGISTRY_REL }],
+  close: {
+    heavyPattern: 'bun run heavy',
+    fullPattern: 'bun run full-suite',
+  },
+});
+
+/**
+ * 写入注册表文件
+ *
+ * @param name - 文件名
+ * @param content - 文档全文
+ */
+function writeIssue(name: string, content: string): void {
+  writeFileSync(join(FIXTURE_ROOT, REGISTRY_REL, name), content);
+}
+
+/**
+ * 写入夹具
+ */
+function writeFixture(): void {
+  rmSync(FIXTURE_ROOT, { recursive: true, force: true });
+  mkdirSync(join(FIXTURE_ROOT, REGISTRY_REL), { recursive: true });
+}
+
+/**
+ * 清理夹具
+ */
+function cleanFixture(): void {
+  rmSync(FIXTURE_ROOT, { recursive: true, force: true });
+}
+
+beforeEach(writeFixture);
+
+afterEach(cleanFixture);
+
+describe('readEvidence 锚点四级归类', () => {
+  test('围栏外四级锚点命中且优先级归类', () => {
+    /**
+     * 处置段样例（含围栏内判据行与围栏外四类锚点）
+     */
+    const disposition = [
+      '## 四、处置结果/验证口径',
+      '',
+      '```criteria',
+      'summary: 判据全绿',
+      '单包测试|test|pkg|bun run test',
+      '```',
+      '',
+      '证书指纹 ' + 'a'.repeat(64),
+      '退出码 0',
+      '全部通过',
+      '用户亲自自验通过',
+    ].join('\n');
+
+    const { anchors } = readEvidence(`**状态**: 🟡 处理中（待收口）\n\n${disposition}\n`);
+
+    expect(anchors.map((anchor) => anchor.kind)).toEqual([
+      'certificate',
+      'exit-zero',
+      'all-green',
+      'adjudicated',
+    ]);
+  });
+
+  test('围栏内行不判读锚点；处置段跨内嵌围栏', () => {
+    const { anchors, dispositionText } = readEvidence(
+      [
+        '状态: 🟢 已处置',
+        '## 四、处置结果/验证口径',
+        '',
+        '```criteria',
+        'a|b|c|d',
+        '退出码 0',
+        '```',
+      ].join('\n'),
+    );
+
+    expect(anchors).toEqual([]);
+    expect(dispositionText.includes('criteria')).toBe(true);
+  });
+});
+
+describe('findPendingWord 挂起词拦截', () => {
+  test('命中任一挂起词', () => {
+    expect(findPendingWord('**状态**: 🟡 处理中（待补跑回归）', ['待补跑', '挂起'])).toBe('待补跑');
+    expect(findPendingWord('**状态**: 🟡 处理中（正常推进）', ['待补跑'])).toBeNull();
+  });
+});
+
+describe('applyGreenFlip 守卫分诊', () => {
+  test('翻绿保留前缀形态并回填证据块', () => {
+    /**
+     * 黄灯文档
+     */
+    const raw = [
+      '# 0001 - 样例',
+      '',
+      '**状态**: 🟡 处理中（修复完成）',
+      '',
+      '## 四、处置结果/验证口径',
+      '',
+      '已修复，退出码 0。',
+    ].join('\n');
+
+    const flip = applyGreenFlip({
+      raw,
+      summary: '修复完成',
+      evidenceBlock: '证据锚点（末次通过零执行收口）：\n- 退出码 0',
+    });
+
+    expect(flip.idempotent).toBe(false);
+    expect(flip.content).toContain('**状态**: 🟢 已处置（修复完成——判据证据锚点见处置段）');
+    expect(flip.content).toContain('证据锚点（末次通过零执行收口）：');
+  });
+
+  test('幂等分诊：已绿且概要一致零变更', () => {
+    /**
+     * 已绿文档（目标形态）
+     */
+    const raw = [
+      '# 0001 - 样例',
+      '',
+      '**状态**: 🟢 已处置（修复完成——判据证据锚点见处置段）',
+      '',
+      '## 四、处置结果/验证口径',
+      '',
+      '已修复，退出码 0。',
+    ].join('\n');
+
+    const flip = applyGreenFlip({
+      raw,
+      summary: '修复完成',
+      evidenceBlock: '',
+    });
+
+    expect(flip.idempotent).toBe(true);
+    expect(flip.content).toBe(raw);
+  });
+
+  test('零命中抛错拒绝（缺状态行防假绿）', () => {
+    expect(() =>
+      applyGreenFlip({ raw: '# 0001 - 无状态行\n\n正文', summary: 's', evidenceBlock: '' }),
+    ).toThrow('零命中');
+  });
+});
+
+describe('evidenceCloseFlow 证据收口', () => {
+  test('零锚点拒收（不核验即翻绿红线）', () => {
+    writeIssue(
+      '0001-no-evidence.md',
+      '**状态**: 🟡 处理中（修复完成）\n\n## 四、处置结果/验证口径\n\n已修复。\n',
+    );
+
+    const result = evidenceCloseFlow({
+      root: FIXTURE_ROOT,
+      config: CONFIG,
+      files: [`${REGISTRY_REL}/0001-no-evidence.md`],
+    });
+
+    expect(result.succeeded).toBe(0);
+    expect(result.cases[0]?.message).toContain('零绿证据锚点');
+  });
+
+  test('挂起词拦截', () => {
+    writeIssue(
+      '0002-pending.md',
+      '**状态**: 🟡 处理中（待补跑回归）\n\n## 四、处置结果/验证口径\n\n退出码 0\n',
+    );
+
+    const result = evidenceCloseFlow({
+      root: FIXTURE_ROOT,
+      config: CONFIG,
+      files: [`${REGISTRY_REL}/0002-pending.md`],
+    });
+
+    expect(result.succeeded).toBe(0);
+    expect(result.cases[0]?.message).toContain('挂起词');
+  });
+
+  test('冻结案拒收', () => {
+    writeIssue('0003-frozen.md', '**状态**: ⚪ 已冻结（用户裁定暂停）\n');
+
+    const result = evidenceCloseFlow({
+      root: FIXTURE_ROOT,
+      config: CONFIG,
+      files: [`${REGISTRY_REL}/0003-frozen.md`],
+    });
+
+    expect(result.succeeded).toBe(0);
+    expect(result.cases[0]?.message).toContain('冻结案拒收');
+  });
+
+  test('阻塞未全绿拒收（blockingMustBeGreen）', () => {
+    writeIssue('0004-blocker.md', '**状态**: 🔴 待处理\n');
+    writeIssue(
+      '0005-blocked.md',
+      '**状态**: 🟡 处理中（修复完成）\n\n**阻塞**: [0004](./0004-blocker.md)\n\n## 四、处置结果/验证口径\n\n退出码 0\n',
+    );
+
+    const result = evidenceCloseFlow({
+      root: FIXTURE_ROOT,
+      config: CONFIG,
+      files: [`${REGISTRY_REL}/0005-blocked.md`],
+    });
+
+    expect(result.succeeded).toBe(0);
+    expect(result.cases[0]?.message).toContain('未全 🟢');
+  });
+
+  test('正常收口翻绿落盘 + 幂等复跑零变更', () => {
+    writeIssue(
+      '0006-ready.md',
+      '**状态**: 🟡 处理中（修复完成）\n\n## 四、处置结果/验证口径\n\n已修复，退出码 0。\n',
+    );
+
+    const first = evidenceCloseFlow({
+      root: FIXTURE_ROOT,
+      config: CONFIG,
+      files: [`${REGISTRY_REL}/0006-ready.md`],
+    });
+
+    expect(first.succeeded).toBe(1);
+
+    /**
+     * 落盘产物已翻绿
+     */
+    const flipped = readFileSync(join(FIXTURE_ROOT, REGISTRY_REL, '0006-ready.md'), 'utf8');
+
+    expect(flipped).toContain('🟢 已处置（末次通过证据收口（0006）：1 条绿证据锚点');
+
+    /**
+     * 幂等复跑
+     */
+    const second = evidenceCloseFlow({
+      root: FIXTURE_ROOT,
+      config: CONFIG,
+      files: [`${REGISTRY_REL}/0006-ready.md`],
+    });
+
+    expect(second.cases[0]?.idempotent).toBe(true);
+  });
+
+  test('批量串行一案失败不阻断', () => {
+    writeIssue('0007-bad.md', '正文无状态行\n');
+    writeIssue(
+      '0008-good.md',
+      '**状态**: 🟡 处理中（修复完成）\n\n## 四、处置结果/验证口径\n\n退出码 0\n',
+    );
+
+    const result = evidenceCloseFlow({
+      root: FIXTURE_ROOT,
+      config: CONFIG,
+      files: [`${REGISTRY_REL}/0007-bad.md`, `${REGISTRY_REL}/0008-good.md`],
+    });
+
+    expect(result.succeeded).toBe(1);
+    expect(result.cases).toHaveLength(2);
+  });
+});
+
+describe('resolveCloseGates 两级门禁', () => {
+  /**
+   * 判据构造器
+   */
+  const criterion = (command: string) => ({
+    label: '判据',
+    channel: 'test',
+    cwd: '.',
+    command,
+  });
+
+  test('禁用级：全量判据未豁免拦截', () => {
+    const gate = resolveCloseGates(CONFIG, [criterion('bun run full-suite')], false, true);
+
+    expect(gate.blocked).toBe(true);
+    expect(gate.kind).toBe('full');
+  });
+
+  test('确认级：重度命令未确认拦截', () => {
+    const gate = resolveCloseGates(CONFIG, [criterion('bun run heavy')], true, false);
+
+    expect(gate.blocked).toBe(true);
+    expect(gate.kind).toBe('heavy');
+  });
+
+  test('定向判据 + 双豁免通过', () => {
+    const gate = resolveCloseGates(CONFIG, [criterion('bun run test')], false, false);
+
+    expect(gate.blocked).toBe(false);
+  });
+});
+
+describe('rerunCloseFlow 证书化真跑', () => {
+  test('门禁拦截零执行（gateBlocked = exit 2 语义）', () => {
+    writeIssue(
+      '0009-criteria.md',
+      '**状态**: 🟡 处理中（待收口）\n\n```criteria\nsummary: 判据\n重度判据|heavy|.|bun run heavy\n```\n',
+    );
+
+    const result = rerunCloseFlow({
+      root: FIXTURE_ROOT,
+      config: CONFIG,
+      files: [`${REGISTRY_REL}/0009-criteria.md`],
+      criteriaFromIssue: true,
+    });
+
+    expect(result.gateBlocked).toBe(true);
+    expect(result.gateBlocked && result.gateMessage).toContain('confirm-heavy');
+  });
+
+  test('判据真跑全绿收口 + 证书落盘 + 复用秒回', () => {
+    writeIssue(
+      '0010-rerun.md',
+      [
+        '**状态**: 🟡 处理中（待收口）',
+        '',
+        '```criteria',
+        'summary: 真跑判据全绿',
+        '恒真|trivial|.|true',
+        '```',
+        '',
+        '## 四、处置结果/验证口径',
+        '',
+        '待回填。',
+      ].join('\n'),
+    );
+
+    const result = rerunCloseFlow({
+      root: FIXTURE_ROOT,
+      config: CONFIG,
+      files: [`${REGISTRY_REL}/0010-rerun.md`],
+      criteriaFromIssue: true,
+    });
+
+    expect(result.succeeded).toBe(1);
+    expect(result.cases[0]?.message).toContain('证书化收口完成');
+
+    /**
+     * 落盘产物含证据块与 64 位指纹
+     */
+    const flipped = readFileSync(join(FIXTURE_ROOT, REGISTRY_REL, '0010-rerun.md'), 'utf8');
+
+    expect(flipped).toContain('判据执行证据（证书化收口，issues:verify-close）：');
+    expect(flipped).toMatch(/证书指纹 [0-9a-f]{64}/);
+
+    /**
+     * 证书在册
+     */
+    expect(existsSync(join(FIXTURE_ROOT, '.lzi/issues/vault/certificates/trivial'))).toBe(true);
+  });
+
+  test('同指纹复用秒回（固定指纹两连跑）', () => {
+    /**
+     * 固定判据与指纹
+     */
+    const criterion = { label: '恒真', channel: 'trivial2', cwd: '.', command: 'true' };
+
+    const fingerprint = computeCriterionFingerprint(FIXTURE_ROOT, criterion);
+
+    /**
+     * 首跑（真实执行落证书）
+     */
+    const first = runCriterionViaVault({ root: FIXTURE_ROOT, criterion, fingerprint });
+
+    expect(first.reused).toBe(false);
+    expect(first.green).toBe(true);
+
+    /**
+     * 复跑（同指纹在册秒回）
+     */
+    const second = runCriterionViaVault({ root: FIXTURE_ROOT, criterion, fingerprint });
+
+    expect(second.reused).toBe(true);
+    expect(second.green).toBe(true);
+  });
+
+  test('判据红（非零退出码）跳过翻绿并落红证书', () => {
+    writeIssue(
+      '0011-red.md',
+      '**状态**: 🟡 处理中（待收口）\n\n```criteria\nsummary: 判据\n恒假|trivial|.|false\n```\n',
+    );
+
+    const result = rerunCloseFlow({
+      root: FIXTURE_ROOT,
+      config: CONFIG,
+      files: [`${REGISTRY_REL}/0011-red.md`],
+      criteriaFromIssue: true,
+    });
+
+    expect(result.succeeded).toBe(0);
+    expect(result.cases[0]?.message).toContain('未全绿');
+
+    /**
+     * 原文未翻绿
+     */
+    const raw = readFileSync(join(FIXTURE_ROOT, REGISTRY_REL, '0011-red.md'), 'utf8');
+
+    expect(raw).toContain('🟡 处理中');
+  });
+});
+
+describe('freeze / unfreeze', () => {
+  test('无裁定语拒绝', () => {
+    const result = freezeIssue({
+      root: FIXTURE_ROOT,
+      file: `${REGISTRY_REL}/any.md`,
+      reason: '随便冻一下',
+    });
+
+    expect(result.ok).toBe(false);
+    expect(result.message).toContain('用户裁定');
+  });
+
+  test('冻结写入与解冻恢复', () => {
+    writeIssue('0012-freeze.md', '**状态**: 🔴 待处理\n');
+
+    const frozen = freezeIssue({
+      root: FIXTURE_ROOT,
+      file: `${REGISTRY_REL}/0012-freeze.md`,
+      reason: '用户裁定暂停推进',
+    });
+
+    expect(frozen.ok).toBe(true);
+
+    /**
+     * 冻结产物
+     */
+    const frozenRaw = readFileSync(join(FIXTURE_ROOT, REGISTRY_REL, '0012-freeze.md'), 'utf8');
+
+    expect(frozenRaw).toContain('⚪ 已冻结（用户裁定暂停推进');
+
+    /**
+     * 非冻结案解冻拒绝（对另一份红灯案）
+     */
+    writeIssue('0013-red.md', '**状态**: 🔴 待处理\n');
+
+    const wrongUnfreeze = unfreezeIssue({
+      root: FIXTURE_ROOT,
+      file: `${REGISTRY_REL}/0013-red.md`,
+      note: '用户裁定解冻',
+    });
+
+    expect(wrongUnfreeze.ok).toBe(false);
+
+    /**
+     * 正常解冻恢复 🔴
+     */
+    const unfrozen = unfreezeIssue({
+      root: FIXTURE_ROOT,
+      file: `${REGISTRY_REL}/0012-freeze.md`,
+      note: '用户裁定恢复推进',
+    });
+
+    expect(unfrozen.ok).toBe(true);
+
+    const unfrozenRaw = readFileSync(join(FIXTURE_ROOT, REGISTRY_REL, '0012-freeze.md'), 'utf8');
+
+    expect(unfrozenRaw).toContain('🔴 待处理（用户裁定恢复推进');
+  });
+
+  test('复合元信息行拒绝整行替换', () => {
+    writeIssue('0014-composite.md', '**状态**: 🟡 处理中（推进中）｜ 优先级 P2\n');
+
+    const result = freezeIssue({
+      root: FIXTURE_ROOT,
+      file: `${REGISTRY_REL}/0014-composite.md`,
+      reason: '用户裁定冻结',
+    });
+
+    expect(result.ok).toBe(false);
+    expect(result.message).toContain('复合元信息行');
+  });
+});
+
+describe('normalizeHeader 方言迁移', () => {
+  test('管道引用行方言迁移为规范序粗体标签', () => {
+    const raw = [
+      '# 0001 - 样例',
+      '',
+      '> 优先级: P2 ｜ 状态: 🟡 处理中（推进中） ｜ 立案日期: 2026-09-14',
+      '',
+      '## 一、问题动机',
+      '',
+      '正文',
+    ].join('\n');
+
+    const { content, outcome } = normalizeHeader(raw);
+
+    expect(outcome).toBe('rewritten');
+    expect(content).toContain('**立案日期**: 2026-09-14');
+    expect(content.indexOf('**立案日期**')).toBeLessThan(content.indexOf('**优先级**'));
+    expect(content.indexOf('**优先级**')).toBeLessThan(content.indexOf('**状态**'));
+    expect(content).toContain('## 一、问题动机');
+    expect(content).toContain('正文');
+  });
+
+  test('列表式方言迁移', () => {
+    const raw = [
+      '# 0002 - 样例',
+      '',
+      '- 状态: 🔴 待处理',
+      '- 来源: 会话记录',
+      '',
+      '## 一、问题动机',
+    ].join('\n');
+
+    const { outcome, content } = normalizeHeader(raw);
+
+    expect(outcome).toBe('rewritten');
+    expect(content).toContain('**状态**: 🔴 待处理');
+    expect(content).toContain('**来源**: 会话记录');
+  });
+
+  test('无状态行 skipped（不猜灯）', () => {
+    const { outcome } = normalizeHeader('# 0003 - 样例\n\n- 优先级: P1\n');
+
+    expect(outcome).toBe('skipped');
+  });
+
+  test('已规范形态 unchanged（幂等）', () => {
+    const raw = ['# 0004 - 样例', '', '**状态**: 🔴 待处理', '', '## 一、问题动机'].join('\n');
+
+    const { outcome, content } = normalizeHeader(raw);
+
+    expect(outcome).toBe('unchanged');
+    expect(content).toBe(raw);
+  });
+});