@longzai-intelligence-issues/ledger 0.0.1 → 0.0.3

package/src/__tests__/migrate/migrate-legacy.commands.test.ts

@@ -0,0 +1,737 @@
+import { parseLziIssuesConfig } from '@longzai-intelligence-issues/config';
+import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+import { migrateLegacyFile } from '@/migrate/migrate-legacy.commands';
+
+/**
+ * 测试夹具根（包内临时目录）
+ */
+const FIXTURE_ROOT = join(import.meta.dir, '__tmp-migrate__');
+
+/**
+ * 注册表目录
+ */
+const REGISTRY_REL = 'docs/issues';
+
+/**
+ * 基准配置（scope root）
+ */
+const config = parseLziIssuesConfig({
+  schemaVersion: 1,
+  scopes: [
+    {
+      key: 'root',
+      title: '项目全局',
+      paths: ['.'],
+      registryDir: REGISTRY_REL,
+    },
+  ],
+});
+
+/**
+ * 写入注册表文件
+ *
+ * @param name - 文件名
+ * @param content - 文档全文
+ */
+function writeIssue(name: string, content: string): void {
+  mkdirSync(join(FIXTURE_ROOT, REGISTRY_REL), { recursive: true });
+
+  writeFileSync(join(FIXTURE_ROOT, REGISTRY_REL, name), content);
+}
+
+/**
+ * 基准迁移入参（dry-run 只读形态）
+ *
+ * @param file - 仓库相对文件路径
+ * @returns 命令入参
+ */
+function input(file: string) {
+  return {
+    root: FIXTURE_ROOT,
+    file,
+    config,
+    defaultPriority: 'P2' as const,
+    defaultSource: '格式清偿迁移回填（2026-09-14）：原案未登记来源',
+    dryRun: true,
+  };
+}
+
+/**
+ * 列表方言（KTV 主流形态）样例
+ */
+const LIST_DIALECT_GREEN = [
+  '# 0400 - roles-matrix 观测两行 deny 错误码红于 deny-first 校验先行分叉族',
+  '',
+  '- 日期：2026-08-27',
+  '- 来源：docs/issues/0390 治理 sweep 复跑发现',
+  '- 状态：**已治理（2026-08-27 同日：守门与口径对齐完成）**',
+  '- 严重程度：中',
+  '- 影响包：packages/api',
+  '',
+  '## 现象',
+  '',
+  '正文。',
+  '',
+  '## 验证结果',
+  '',
+  '验证正文：lint 全绿。',
+].join('\n');
+
+/**
+ * 表格方言（KTV 最新形态）样例
+ */
+const TABLE_DIALECT = [
+  '# 0549 check:testing-coverage 门禁存在 15 处既有违规',
+  '',
+  '| 元数据 | 内容 |',
+  '| --- | --- |',
+  '| Issue 编号 | 0549 |',
+  '| 日期 | 2026-09-14 |',
+  '| 状态 | 已处理 |',
+  '| 来源 | 门禁收尾时发现 |',
+  '| 配对决策 | 无（纯欠账清偿） |',
+  '',
+  '## 现象',
+  '',
+  '正文。',
+  '',
+  '## 治理记录',
+  '',
+  '治理正文。',
+].join('\n');
+
+/**
+ * 粗体旧式（KTV 最老形态）样例
+ */
+const BOLD_DIALECT_RED = [
+  '# StreamableFile 与 typedResponse 类型不兼容问题',
+  '',
+  '**日期**: 2026-06-13',
+  '**状态**: 未处理',
+  '**涉及文件**: `apps/nest-server/src/x.ts`',
+  '',
+  '## 问题描述',
+  '',
+  '正文。',
+].join('\n');
+
+/**
+ * 引用+粗体复合方言（academy 形态：`> **键**: 值` 逐行）样例
+ */
+const QUOTE_BOLD_DIALECT = [
+  '# 0001 — auth 迁移标准化',
+  '',
+  '> **状态**: 已修复',
+  '> **日期**: 2026-08-04',
+  '> **责任方**: academy 项目',
+  '',
+  '## 迁移目标',
+  '',
+  '正文。',
+].join('\n');
+
+/**
+ * 标题式隔行值方言（oxlint 形态：`## 键` 单独成行 + 下一非空行为值）样例
+ */
+const HEADING_ALONE_DIALECT = [
+  '# 0001 — ignorePatterns 未生效',
+  '',
+  '## 状态',
+  '',
+  '已修复（未发布）',
+  '',
+  '## 日期',
+  '',
+  '2026-08-01',
+  '',
+  '## 现象',
+  '',
+  '正文。',
+].join('\n');
+
+beforeEach(() => {
+  rmSync(FIXTURE_ROOT, { recursive: true, force: true });
+});
+
+afterEach(() => {
+  rmSync(FIXTURE_ROOT, { recursive: true, force: true });
+});
+
+describe('migrateLegacyFile 存量清偿（dry-run 只读）', () => {
+  test('列表方言：状态规范化 + 字段别名 + 处置段标题链 + 必填回填', () => {
+    writeIssue('0400-roles-matrix-deny-divergence.md', LIST_DIALECT_GREEN);
+
+    const result = migrateLegacyFile(input(`${REGISTRY_REL}/0400-roles-matrix-deny-divergence.md`));
+
+    expect(result.outcome).toBe('rewritten');
+    expect(result.content).toContain(
+      '**状态**: 🟢 已处置（2026-08-27 同日：守门与口径对齐完成；原「已治理」）',
+    );
+    expect(result.content).toContain('**立案日期**: 2026-08-27');
+    expect(result.content).toContain('**优先级**: P2');
+    expect(result.content).toContain('**所属域**: 项目全局');
+    expect(result.content).toContain('**来源**: docs/issues/0390 治理 sweep 复跑发现');
+    expect(result.content).toContain('**严重程度**: 中');
+    expect(result.content).toContain('**影响包**: packages/api');
+    expect(result.content).toContain('## 处置结果/验证口径');
+    expect(result.content).toContain('验证正文：lint 全绿。');
+    expect(result.content).toContain('## 现象');
+    expect(result.content.startsWith('# 0400 - ')).toBe(true);
+  });
+
+  test('表格方言：数据行提取为字段、脚手架丢弃、治理记录对齐处置段', () => {
+    writeIssue('0549-testing-coverage-gate.md', TABLE_DIALECT);
+
+    const result = migrateLegacyFile(input(`${REGISTRY_REL}/0549-testing-coverage-gate.md`));
+
+    expect(result.outcome).toBe('rewritten');
+    expect(result.content).toContain('**状态**: 🟢 已处置（原「已处理」）');
+    expect(result.content).toContain('**Issue 编号**: 0549');
+    expect(result.content).toContain('**配对决策**: 无（纯欠账清偿）');
+    expect(result.content).toContain('## 处置结果/治理记录');
+    expect(result.content.includes('| --- | --- |')).toBe(false);
+    expect(result.content.includes('| 元数据 | 内容 |')).toBe(false);
+  });
+
+  test('引用+粗体复合方言（> **键**: 值）：键清粗体后入字段，状态词命中绿系', () => {
+    writeIssue('0001-quote-bold-dialect.md', QUOTE_BOLD_DIALECT);
+
+    const result = migrateLegacyFile(input(`${REGISTRY_REL}/0001-quote-bold-dialect.md`));
+
+    expect(result.outcome).toBe('rewritten');
+    expect(result.content).toContain('**状态**: 🟢 已处置（原「已修复」）');
+    expect(result.content).toContain('**立案日期**: 2026-08-04');
+    expect(result.content).toContain('**责任方**: academy 项目');
+    expect(result.content).toContain('## 迁移目标');
+    expect(result.content.startsWith('# 0001 - auth 迁移标准化')).toBe(true);
+  });
+
+  test('标题式隔行值方言（## 键 + 下一非空行）：键值配对入字段且键行被消费', () => {
+    writeIssue('0001-heading-alone-dialect.md', HEADING_ALONE_DIALECT);
+
+    const result = migrateLegacyFile(input(`${REGISTRY_REL}/0001-heading-alone-dialect.md`));
+
+    expect(result.outcome).toBe('rewritten');
+    expect(result.content).toContain('未发布');
+    expect(result.content).toContain('原「已修复」');
+    expect(result.content).toContain('**立案日期**: 2026-08-01');
+    expect(result.content.includes('## 状态')).toBe(false);
+    expect(result.content.includes('## 日期')).toBe(false);
+    expect(result.content).toContain('## 现象');
+    expect(result.content.startsWith('# 0001 - ignorePatterns')).toBe(true);
+  });
+
+  test('粗体旧式：红灯映射 + H1 补编号 + 无验证段红灯不追加处置段', () => {
+    writeIssue('0001-streamablefile-typed-response.md', BOLD_DIALECT_RED);
+
+    const result = migrateLegacyFile(
+      input(`${REGISTRY_REL}/0001-streamablefile-typed-response.md`),
+    );
+
+    expect(result.outcome).toBe('rewritten');
+    expect(result.content).toContain('**状态**: 🔴 待处理（原「未处理」）');
+    expect(result.content).toContain('**立案日期**: 2026-06-13');
+    expect(result.content).toContain('**来源**: 格式清偿迁移回填（2026-09-14）：原案未登记来源');
+    expect(result.content).toContain('**涉及文件**: `apps/nest-server/src/x.ts`');
+    expect(result.content.startsWith('# 0001 - StreamableFile')).toBe(true);
+    expect(result.content.includes('处置结果/')).toBe(false);
+  });
+
+  test('绿灯但处置段占位：降级黄灯并给挂起原因', () => {
+    writeIssue(
+      '0300-green-placeholder.md',
+      [
+        '# 0300 - 样例',
+        '',
+        '- 日期：2026-08-01',
+        '- 状态：已治理',
+        '- 来源：会话记录',
+        '',
+        '## 验证结果',
+        '',
+        '（待回填）',
+      ].join('\n'),
+    );
+
+    const result = migrateLegacyFile(input(`${REGISTRY_REL}/0300-green-placeholder.md`));
+
+    expect(result.outcome).toBe('rewritten');
+    expect(result.content).toContain(
+      '**状态**: 🟡 处理中（历史标记已处置但验证口径为占位，清偿时待核实；原「已治理」）',
+    );
+    expect(result.content).toContain('## 处置结果/验证口径');
+  });
+
+  test('候选段词汇表：落地治理/治理记录（带日期）/验证（治理后）/修复 均命中改名链，计划性段名不误吞', () => {
+    /**
+     * 落地治理族样例（KTV 真实段名词汇）
+     */
+    writeIssue(
+      '0320-landing-governance.md',
+      [
+        '# 0320 - 样例',
+        '',
+        '- 日期：2026-08-03',
+        '- 状态：已治理',
+        '- 来源：会话记录',
+        '',
+        '## 现象',
+        '',
+        '正文。',
+        '',
+        '## 落地治理',
+        '',
+        '治理正文。',
+        '',
+        '## 修复方向',
+        '',
+        '计划正文（不应被改名）。',
+      ].join('\n'),
+    );
+
+    /**
+     * 治理记录带日期样例
+     */
+    writeIssue(
+      '0321-dated-record.md',
+      [
+        '# 0321 - 样例',
+        '',
+        '- 日期：2026-08-04',
+        '- 状态：已治理',
+        '- 来源：会话记录',
+        '',
+        '## 现象',
+        '',
+        '正文。',
+        '',
+        '## 治理记录（2026-08-31）',
+        '',
+        '记录正文。',
+      ].join('\n'),
+    );
+
+    const first = migrateLegacyFile(input(`${REGISTRY_REL}/0320-landing-governance.md`));
+
+    expect(first.outcome).toBe('rewritten');
+    expect(first.content).toContain('## 处置结果/治理记录');
+    expect(first.content).toContain('## 修复方向');
+    expect(first.content).toContain('计划正文（不应被改名）。');
+    expect(first.content.includes('处置结果/验证口径')).toBe(false);
+
+    const second = migrateLegacyFile(input(`${REGISTRY_REL}/0321-dated-record.md`));
+
+    expect(second.outcome).toBe('rewritten');
+    expect(second.content).toContain('## 处置结果/治理记录');
+  });
+
+  test('绿灯无任何候选验证段：追加处置段与事实回填说明', () => {
+    writeIssue(
+      '0310-green-nosection.md',
+      [
+        '# 0310 - 样例',
+        '',
+        '- 日期：2026-08-02',
+        '- 状态：已解决',
+        '- 来源：会话记录',
+        '',
+        '## 解决方案',
+        '',
+        '改了 X。',
+      ].join('\n'),
+    );
+
+    const result = migrateLegacyFile(input(`${REGISTRY_REL}/0310-green-nosection.md`));
+
+    expect(result.outcome).toBe('rewritten');
+    expect(result.content).toContain('## 处置结果/变更记录');
+    expect(result.content).toContain('## 处置结果/验证口径');
+  });
+
+  test('无状态行且未注入灯位：skipped 交人工', () => {
+    writeIssue('0547-anomaly.md', '# 0547 · 无元信息异类\n\n## 现象\n\n正文。\n');
+
+    const result = migrateLegacyFile(input(`${REGISTRY_REL}/0547-anomaly.md`));
+
+    expect(result.outcome).toBe('skipped');
+  });
+
+  test('无状态行 + status 注入（green）：规范标签落位且处置段对齐执行', () => {
+    writeIssue(
+      '0350-status-inject.md',
+      [
+        '# Git 换行符问题分析与处理',
+        '',
+        '## 问题描述',
+        '',
+        '正文。',
+        '',
+        '## 解决方案',
+        '',
+        '已落地 .gitattributes 统一换行。',
+      ].join('\n'),
+    );
+
+    const result = migrateLegacyFile({
+      ...input(`${REGISTRY_REL}/0350-status-inject.md`),
+      status: 'green',
+      defaultFilingDate: '2026-06-13',
+    });
+
+    expect(result.outcome).toBe('rewritten');
+    expect(result.content).toContain(
+      '**状态**: 🟢 已处置（存量清偿定档：原案无状态行，依结案内容人工定档）',
+    );
+    expect(result.content).toContain('**立案日期**: 2026-06-13');
+    expect(result.content).toContain('## 处置结果/变更记录');
+    expect(result.content).toContain('## 处置结果/验证口径');
+    expect(result.content.startsWith('# 0350 - Git 换行符')).toBe(true);
+  });
+
+  test('H1 编号句点分隔符变体（# 0279. 标题）规范为 # 0279 - 标题且守卫通过', () => {
+    writeIssue(
+      '0279-dot-separator.md',
+      [
+        '# 0279. 包厢预订配置页默认值全 0：分组缺 defaultValue 建模',
+        '',
+        '- 日期：2026-08-10',
+        '- 状态：已治理',
+        '- 来源：会话记录',
+        '',
+        '## 现象',
+        '',
+        '正文。',
+        '',
+        '## 验证结果',
+        '',
+        '验证正文。',
+      ].join('\n'),
+    );
+
+    const result = migrateLegacyFile(input(`${REGISTRY_REL}/0279-dot-separator.md`));
+
+    expect(result.outcome).toBe('rewritten');
+    expect(result.content.startsWith('# 0279 - 包厢预订配置页默认值全 0')).toBe(true);
+    expect(result.content.includes('0279.')).toBe(false);
+  });
+
+  test('状态值粗体形态三变体（全包裹/前导无尾随/词中包裹）均可命中词表', () => {
+    writeIssue(
+      '0330-bold-variants.md',
+      [
+        '# 0330 - 样例',
+        '',
+        '- 日期：2026-08-21',
+        '- 状态：**已治理（2026-08-21，commit 57a2d80ef9）',
+        '- 来源：会话记录',
+        '',
+        '## 现象',
+        '',
+        '正文。',
+        '',
+        '## 治理记录',
+        '',
+        '治理正文。',
+      ].join('\n'),
+    );
+
+    writeIssue(
+      '0331-bold-word-wrap.md',
+      [
+        '# 0331 - 样例',
+        '',
+        '- 日期：2026-08-25',
+        '- 状态：**已治理**（2026-08-25 同日收口）',
+        '- 来源：会话记录',
+        '',
+        '## 现象',
+        '',
+        '正文。',
+        '',
+        '## 验证结果',
+        '',
+        '验证正文。',
+      ].join('\n'),
+    );
+
+    const first = migrateLegacyFile(input(`${REGISTRY_REL}/0330-bold-variants.md`));
+
+    expect(first.outcome).toBe('rewritten');
+    expect(first.content).toContain(
+      '**状态**: 🟢 已处置（2026-08-21，commit 57a2d80ef9；原「已治理」）',
+    );
+
+    const second = migrateLegacyFile(input(`${REGISTRY_REL}/0331-bold-word-wrap.md`));
+
+    expect(second.outcome).toBe('rewritten');
+    expect(second.content).toContain('**状态**: 🟢 已处置（2026-08-25 同日收口；原「已治理」）');
+  });
+
+  test('规范词无 emoji 形态（已处置/已完成/已闭合）命中绿系词表', () => {
+    writeIssue(
+      '0334-canonical-word-no-emoji.md',
+      [
+        '# 0334 - 样例',
+        '',
+        '| 元数据 | 内容 |',
+        '| --- | --- |',
+        '| 状态 | 已处置（单例化修复 + e2e 复绿） |',
+        '',
+        '## 现象',
+        '',
+        '正文。',
+        '',
+        '## 验证结果',
+        '',
+        '验证正文。',
+      ].join('\n'),
+    );
+
+    const result = migrateLegacyFile({
+      ...input(`${REGISTRY_REL}/0334-canonical-word-no-emoji.md`),
+      defaultFilingDate: '2026-09-01',
+    });
+
+    expect(result.outcome).toBe('rewritten');
+    expect(result.content).toContain('**状态**: 🟢 已处置（单例化修复 + e2e 复绿；原「已处置」）');
+  });
+
+  test('扩展词表：待处理/未修复/已收口/已根治/终态达成 等命中', () => {
+    writeIssue(
+      '0332-vocab-extended.md',
+      [
+        '# 0332 - 样例',
+        '',
+        '- 日期：2026-08-22',
+        '- 状态：已收口（2026-08-19，D-3 维持现状）',
+        '- 来源：会话记录',
+        '',
+        '## 现象',
+        '',
+        '正文。',
+      ].join('\n'),
+    );
+
+    writeIssue(
+      '0333-vocab-red.md',
+      [
+        '# 0333 - 样例',
+        '',
+        '- 日期：2026-08-23',
+        '- 状态：未修复（本次质量检查发现并归档，待用户决策修复范围）',
+        '- 来源：会话记录',
+        '',
+        '## 现象',
+        '',
+        '正文。',
+      ].join('\n'),
+    );
+
+    const first = migrateLegacyFile(input(`${REGISTRY_REL}/0332-vocab-extended.md`));
+
+    expect(first.outcome).toBe('rewritten');
+    expect(first.content).toContain(
+      '**状态**: 🟢 已处置（2026-08-19，D-3 维持现状；原「已收口」）',
+    );
+
+    const second = migrateLegacyFile(input(`${REGISTRY_REL}/0333-vocab-red.md`));
+
+    expect(second.outcome).toBe('rewritten');
+    expect(second.content).toContain(
+      '🔴 待处理（本次质量检查发现并归档，待用户决策修复范围；原「未修复」）',
+    );
+  });
+
+  test('列表+粗体复合方言（- **键**: 值）解析为字段，原始语义保留且不落残留块', () => {
+    writeIssue(
+      '0340-list-bold-compound.md',
+      [
+        '# 静态导出产物托管纪律未登记',
+        '',
+        '- **严重度**：信息',
+        '- **状态**：未处理（已登记，待治理）',
+        '- **发现**：2026-08-24 issue 022 治理中的同类排查',
+        '',
+        '## 问题描述',
+        '',
+        '正文。',
+      ].join('\n'),
+    );
+
+    const result = migrateLegacyFile({
+      ...input(`${REGISTRY_REL}/0340-list-bold-compound.md`),
+      defaultFilingDate: '2026-08-24',
+    });
+
+    expect(result.outcome).toBe('rewritten');
+    expect(result.content).toContain('**状态**: 🔴 待处理（已登记，待治理；原「未处理」）');
+    expect(result.content).toContain('**严重度**: 信息');
+    expect(result.content).toContain('**发现**: 2026-08-24 issue 022 治理中的同类排查');
+    expect(result.content).not.toMatch(/^- \*\*/m);
+  });
+
+  test('污染修复：规范头部与体首残留元信息块收敛（键去重、注入定档让位原始语义）', () => {
+    writeIssue(
+      '0341-polluted-converge.md',
+      [
+        '# 0341 - 静态导出产物托管纪律未登记',
+        '',
+        '**优先级**: P2',
+        '**状态**: 🔴 待处理（存量清偿定档：原案无状态行，依结案内容人工定档）',
+        '**立案日期**: 2026-08-24',
+        '**所属域**: 项目全局',
+        '**来源**: 格式清偿迁移回填（2026-09-14）：原案未登记来源',
+        '',
+        '- **严重度**：信息',
+        '- **状态**：未处理（已登记，待治理）',
+        '- **发现**：2026-08-24 issue 022 治理中的同类排查',
+        '',
+        '## 问题描述',
+        '',
+        '正文。',
+      ].join('\n'),
+    );
+
+    const result = migrateLegacyFile(input(`${REGISTRY_REL}/0341-polluted-converge.md`));
+
+    expect(result.outcome).toBe('rewritten');
+    expect(result.content).toContain('**状态**: 🔴 待处理（已登记，待治理；原「未处理」）');
+    expect(result.content).toContain('**严重度**: 信息');
+    expect(result.content).toContain('**发现**: 2026-08-24 issue 022 治理中的同类排查');
+    expect(result.content).not.toMatch(/存量清偿定档：原案无状态行/);
+    expect(result.content).not.toMatch(/^- \*\*(状态|严重度|发现)/m);
+    expect(result.content.match(/\*\*状态\*\*/g)).toHaveLength(1);
+
+    /**
+     * 收敛幂等：第一轮产物落盘后二轮 unchanged
+     */
+    const landing = migrateLegacyFile({
+      ...input(`${REGISTRY_REL}/0341-polluted-converge.md`),
+      dryRun: false,
+    });
+
+    expect(landing.outcome).toBe('rewritten');
+
+    const second = migrateLegacyFile(input(`${REGISTRY_REL}/0341-polluted-converge.md`));
+
+    expect(second.outcome).toBe('unchanged');
+  });
+
+  test('体首非元信息列表不被吸收（正文证据列表原样保留）', () => {
+    writeIssue(
+      '0342-body-bullet-kept.md',
+      [
+        '# 0342 - 样例',
+        '',
+        '**优先级**: P2',
+        '**状态**: 🔴 待处理',
+        '**立案日期**: 2026-08-24',
+        '**所属域**: 项目全局',
+        '**来源**: 会话记录',
+        '',
+        '- **next.config.ts:7** — 注释明示静态导出（正文证据，非元信息）',
+        '- **out/** 已被 gitignore（正文证据）',
+        '',
+        '## 问题描述',
+        '',
+        '正文。',
+      ].join('\n'),
+    );
+
+    const result = migrateLegacyFile(input(`${REGISTRY_REL}/0342-body-bullet-kept.md`));
+
+    expect(result.outcome).toBe('unchanged');
+    expect(result.content).toContain(
+      '- **next.config.ts:7** — 注释明示静态导出（正文证据，非元信息）',
+    );
+  });
+
+  test('同键多值合并：重复关联行并值为分号单行，不丢链接', () => {
+    writeIssue(
+      '0343-dup-join.md',
+      [
+        '# 0343 - 样例',
+        '',
+        '**状态**: 🟢 已处置（原「已治理」）',
+        '**立案日期**: 2026-06-13',
+        '**所属域**: 项目全局',
+        '**来源**: 会话记录',
+        '**关联**: [ADR-0010](../decisions/0010-form-error-no-document-flow-shift.md)',
+        '**关联**: [表单错误提示双重反馈机制规格](../specs/spec-20260510-form-error-tooltip-feedback/spec.md)',
+        '',
+        '## 验证结果',
+        '',
+        '验证正文。',
+      ].join('\n'),
+    );
+
+    const result = migrateLegacyFile(input(`${REGISTRY_REL}/0343-dup-join.md`));
+
+    expect(result.outcome).toBe('rewritten');
+    expect(result.content).toContain(
+      '**关联**: [ADR-0010](../decisions/0010-form-error-no-document-flow-shift.md)；[表单错误提示双重反馈机制规格](../specs/spec-20260510-form-error-tooltip-feedback/spec.md)',
+    );
+    expect(result.content.match(/\*\*关联\*\*/g)).toHaveLength(1);
+  });
+
+  test('超长状态拆分：词表命中时长说明落处置摘要字段、状态行保持短规范', () => {
+    writeIssue(
+      '0344-long-status-split.md',
+      [
+        '# 0344 - 样例',
+        '',
+        '> 日期：2026-08-04',
+        '> 状态：**已修复**。删除 `src/index.ts` 源码 shebang，由 `lzi-builder.config.ts` 的 banner 作为唯一 shebang 来源，避免双 shebang 导致 node 以注释行开头的解释器路径执行失败。',
+        '',
+        '## 现象',
+        '',
+        '正文。',
+      ].join('\n'),
+    );
+
+    const result = migrateLegacyFile(input(`${REGISTRY_REL}/0344-long-status-split.md`));
+
+    expect(result.outcome).toBe('rewritten');
+    expect(result.content).toContain('**状态**: 🟢 已处置（原「已修复」）');
+    expect(result.content).toContain('**处置摘要**: 已修复。删除 `src/index.ts` 源码 shebang');
+    expect(result.content).toContain('banner 作为唯一 shebang 来源');
+    expect(result.content).toContain('## 现象');
+  });
+
+  test('幂等：对已规范产物重跑 unchanged', () => {
+    writeIssue('0400-roles-matrix-deny-divergence.md', LIST_DIALECT_GREEN);
+
+    /**
+     * 第一轮落盘
+     */
+    const first = migrateLegacyFile({
+      ...input(`${REGISTRY_REL}/0400-roles-matrix-deny-divergence.md`),
+      dryRun: false,
+    });
+
+    expect(first.outcome).toBe('rewritten');
+
+    /**
+     * 第二轮对产物重跑
+     */
+    const second = migrateLegacyFile(input(`${REGISTRY_REL}/0400-roles-matrix-deny-divergence.md`));
+
+    expect(second.outcome).toBe('unchanged');
+  });
+
+  test('dry-run 不落盘', () => {
+    writeIssue('0001-streamablefile-typed-response.md', BOLD_DIALECT_RED);
+
+    migrateLegacyFile(input(`${REGISTRY_REL}/0001-streamablefile-typed-response.md`));
+
+    expect(
+      readFileSync(
+        join(FIXTURE_ROOT, REGISTRY_REL, '0001-streamablefile-typed-response.md'),
+        'utf8',
+      ),
+    ).toBe(BOLD_DIALECT_RED);
+  });
+});