@longzai-intelligence-issues/ledger 0.0.2 → 0.0.4

package/src/__tests__/parser/registry.parser.test.ts

@@ -104,6 +104,21 @@ describe('parseIssueDoc 状态行', () => {
     expect(record?.status).toBe('legacy-yellow');
   });
 
+  test('标题行内含「连接状态：」词组不误定位（跳过标题行命中真状态行）', () => {
+    const record = parseIssueDoc(
+      '0001-sample.md',
+      [
+        '# 0001 - 调试面板被「连接状态: API=不可达, WS=未配置」刷屏',
+        '',
+        '**状态**: 🟢 已处置（按方案 B 落地）',
+      ].join('\n'),
+      0,
+    );
+
+    expect(record?.status).toBe('green');
+    expect(record?.statusLineNumber).toBe(3);
+  });
+
   test('规范绿灯归类 green', () => {
     const record = parseIssueDoc(
       '0001-sample.md',

package/src/index.ts

@@ -33,6 +33,10 @@ export * from './migrate/migrate-legacy.commands.js';
 
 export * from './migrate/migrate-legacy.core.js';
 
+export * from './migrate/migrate-legacy.vocab.js';
+
+export * from './migrate/migrate-legacy.backfill.js';
+
 export * from './numbering/numbering.commands.js';
 
 export * from './numbering/numbering.core.js';

package/src/lint/lint.core.ts

@@ -287,6 +287,57 @@ export const CORE_LINT_RULES: readonly LintRule[] = [
         : `slug 段含数字（scope 政策 slugDigitPolicy 或白名单 slugDigitAllowlist 登记）：${record.file}`;
     },
   },
+  {
+    name: 'duplicate-metadata-key',
+    evaluate: (record) => {
+      /**
+       * 头部区行（首行起至首个二级标题，上限 40 行——覆盖规范头部与其后
+       * 紧邻的残留方言块）
+       */
+      const headerLines: string[] = [];
+
+      for (const line of record.rawContent.split(/\r?\n/)) {
+        if (line.startsWith('## ') || headerLines.length >= 40) {
+          break;
+        }
+
+        headerLines.push(line);
+      }
+
+      /**
+       * 规范键命中计数器
+       */
+      const counts = new Map<string, number>();
+
+      for (const line of headerLines) {
+        /**
+         * 元信息行匹配（粗体 / 列表 / 列表+粗体复合前缀通吃）
+         */
+        const match =
+          /^(?:\*\*|- \*\*|- )(优先级|状态|立案日期|所属域|来源|严重程度)(?:\*\*)?\s*[：:]/.exec(
+            line.trim(),
+          );
+
+        if (match !== null) {
+          /**
+           * 命中的元信息键
+           */
+          const key = match[1] ?? '';
+
+          counts.set(key, (counts.get(key) ?? 0) + 1);
+        }
+      }
+
+      /**
+       * 重复键列表
+       */
+      const duplicated = [...counts.entries()].filter(([, count]) => count > 1).map(([key]) => key);
+
+      return duplicated.length > 0
+        ? `头部区元信息键重复：${duplicated.join('、')}（方言残留块与规范头部并存——须经 migrate-legacy 收敛）`
+        : null;
+    },
+  },
   {
     name: 'canceled-no-reason',
     evaluate: (record) =>

package/src/migrate/migrate-legacy.backfill.ts

@@ -0,0 +1,149 @@
+/**
+ * migrate-legacy 必填元信息回填（自 core 拆出守函数行上限）
+ *
+ * 字段别名（日期 → 立案日期）、立案日期/优先级回填与档位映射。缺省未给时
+ * 返回 skip 语由调用方裁决，不在此抛错。
+ */
+
+import type { MigrationTransformation } from './migrate-legacy.core';
+
+import { mapPriorityValue } from './migrate-legacy.vocab';
+
+/**
+ * 回填入参（与 MigrateCoreOptions 的回填子集 + 字段工作副本）
+ */
+export type BackfillInput = {
+  /**
+   * 头部字段工作副本（原地回填）
+   */
+  fields: Array<{ key: string; value: string }>;
+
+  /**
+   * 变换台账
+   */
+  transformations: MigrationTransformation[];
+
+  /**
+   * 优先级缺省
+   */
+  defaultPriority?: 'P1' | 'P2' | 'P3';
+
+  /**
+   * 立案日期回填缺省
+   */
+  defaultFilingDate?: string;
+};
+
+/**
+ * 回填产物
+ */
+export type BackfillResult = {
+  /**
+   * skip 语（缺省未给交人工时非空）
+   */
+  skipMessage: string | null;
+};
+
+/**
+ * 执行字段别名与必填回填
+ *
+ * @param input - 回填入参
+ * @returns 回填产物（skipMessage 非空即调用方应 skipped 返回）
+ */
+export function backfillRequiredFields(input: BackfillInput): BackfillResult {
+  /**
+   * 解构字段副本与台账
+   */
+  const { fields, transformations } = input;
+
+  /**
+   * 字段别名：日期 → 立案日期（已有立案日期则保留原字段不动）
+   */
+  const filingIndex = fields.findIndex((field) => field.key === '立案日期');
+
+  /**
+   * 旧字段名「日期」下标（方言主流的立案日期载体）
+   */
+  const dateIndex = fields.findIndex((field) => field.key === '日期');
+
+  if (filingIndex === -1 && dateIndex !== -1) {
+    /**
+     * 待改名的日期字段
+     */
+    const dateField = fields[dateIndex];
+
+    if (dateField !== undefined) {
+      fields[dateIndex] = { key: '立案日期', value: dateField.value };
+
+      transformations.push({
+        kind: 'field-alias',
+        detail: `日期 → 立案日期（${dateField.value}）`,
+      });
+    }
+  }
+
+  /**
+   * 立案日期缺省回填（未给缺省则交人工）
+   */
+  if (!fields.some((field) => field.key === '立案日期')) {
+    if (input.defaultFilingDate === undefined) {
+      return { skipMessage: '缺立案日期且未给回填缺省——交人工' };
+    }
+
+    fields.push({ key: '立案日期', value: input.defaultFilingDate });
+
+    transformations.push({
+      kind: 'required-backfilled',
+      detail: `立案日期 ← ${input.defaultFilingDate}`,
+    });
+  }
+
+  /**
+   * 优先级：既有值映射 / 严重程度映射 / 缺省回填
+   */
+  const priorityIndex = fields.findIndex((field) => field.key === '优先级');
+
+  if (priorityIndex !== -1) {
+    /**
+     * 既有优先级值
+     */
+    const existing = fields[priorityIndex]?.value ?? '';
+
+    /**
+     * 映射产物（中文档位 → P 档位）
+     */
+    const mapped = mapPriorityValue(existing);
+
+    if (mapped !== null && mapped !== existing) {
+      fields[priorityIndex] = { key: '优先级', value: mapped };
+
+      transformations.push({ kind: 'priority-mapped', detail: `优先级 ${existing} → ${mapped}` });
+    }
+  } else {
+    /**
+     * 严重程度映射或缺省回填
+     */
+    const severityField = fields.find((field) => field.key === '严重程度');
+
+    /**
+     * 回填值
+     */
+    const backfill =
+      (severityField !== undefined ? mapPriorityValue(severityField.value) : null) ??
+      input.defaultPriority ??
+      null;
+
+    if (backfill === null) {
+      return { skipMessage: '缺优先级且未给回填缺省——交人工' };
+    }
+
+    fields.push({ key: '优先级', value: backfill });
+
+    transformations.push({
+      kind: severityField !== undefined ? 'priority-mapped' : 'priority-backfilled',
+      detail: `优先级 ← ${backfill}${severityField !== undefined ? `（严重程度 ${severityField.value}）` : '（缺省回填）'}`,
+    });
+  }
+
+  return { skipMessage: null };
+}

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

@@ -10,12 +10,14 @@ import type { LziIssuesConfig } from '@longzai-intelligence-issues/config';
 import { readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 
+import { HEADING_ALONE_METADATA_KEYS } from '@/normalize/normalize-header.commands';
+
 import {
-  cleanValue,
   DISPOSITION_CANDIDATES,
   migrateLegacyCore,
   type MigrationTransformation,
 } from './migrate-legacy.core';
+import { cleanValue } from './migrate-legacy.vocab';
 
 /**
  * 单文件迁移入参
@@ -163,7 +165,7 @@ function findLostContent(raw: string, migrated: string, transformedKeys: string[
        */
       const titleCore = trimmed
         .replace(/^#\s+/, '')
-        .replace(/^[0-9]{3,4}\s*(?:[-·.．：:]\s*|\s+)/, '')
+        .replace(/^[0-9]{3,4}\s*(?:[-—―·.．：:－]+\s*|\s+)/, '')
         .trim();
 
       if (titleCore !== '' && migrated.includes(titleCore)) {
@@ -261,9 +263,9 @@ function findLostContent(raw: string, migrated: string, transformedKeys: string[
         }
 
         /**
-         * 键
+         * 键（清粗体包裹——`> **键**: 值` 复合形态与头部字段行对账同口径）
          */
-        const key = (pairMatch[1] ?? '').trim();
+        const key = (pairMatch[1] ?? '').replace(/^\*+|\*+$/g, '').trim();
 
         /**
          * 清理后值（与引擎 cleanValue 同口径）
@@ -281,9 +283,25 @@ function findLostContent(raw: string, migrated: string, transformedKeys: string[
     }
 
     /**
-     * 头部字段行：粗体包裹与值清理后的形态在场即可
+     * 多行元信息形态：空值键行（键已并入规范头部即通过）
      */
-    const labeled = /^(?:\*\*|- |## )([^*：:]{1,20})(?:\*\*)?\s*[：:]\s*(.+)$/.exec(line);
+    const emptyKeyMatch = /^(?:\*\*|- \*\*|- )([^*：:]{1,20})(?:\*\*)?\s*[：:]\s*$/.exec(trimmed);
+
+    if (emptyKeyMatch !== null && migrated.includes(`**${(emptyKeyMatch[1] ?? '').trim()}**:`)) {
+      continue;
+    }
+
+    /**
+     * 列表子项行：去列表标记后的文本在场即通过（多行元信息子项已并入单行值）
+     */
+    if (trimmed.startsWith('- ') && migrated.includes(trimmed.slice(2).trim())) {
+      continue;
+    }
+
+    /**
+     * 头部字段行：粗体包裹与值清理后的形态在场即可（含列表+粗体复合方言）
+     */
+    const labeled = /^(?:\*\*|- \*\*|- |## )([^*：:]{1,20})(?:\*\*)?\s*[：:]\s*(.+)$/.exec(line);
 
     if (labeled !== null) {
       /**
@@ -301,6 +319,42 @@ function findLostContent(raw: string, migrated: string, transformedKeys: string[
       }
     }
 
+    /**
+     * 标题式隔行值键行（`## 键` 单独成行）：键行属登记变换被消费进规范头部，
+     * 配对值行自身经上方 includes 对账在场
+     */
+    const aloneKey = /^##\s*([^：:]{1,10})\s*$/.exec(trimmed);
+
+    if (aloneKey !== null && HEADING_ALONE_METADATA_KEYS.has(aloneKey[1]?.trim() ?? '')) {
+      continue;
+    }
+
+    /**
+     * 标题式隔行值配对值行：前非空行是 `## 键` 且键在集合内时按字段值对账
+     * （状态词规范化会重组值文本——键属已变换集合或清理值在场即通过）
+     */
+    let prevIndex = lineIndex - 1;
+
+    while (prevIndex >= 0 && (rawLines[prevIndex] ?? '').trim() === '') {
+      prevIndex -= 1;
+    }
+
+    /**
+     * 前非空行的标题式键形态
+     */
+    const prevAlone = /^##\s*([^：:]{1,10})\s*$/.exec((rawLines[prevIndex] ?? '').trim());
+
+    if (prevAlone !== null && HEADING_ALONE_METADATA_KEYS.has(prevAlone[1]?.trim() ?? '')) {
+      /**
+       * 配对键
+       */
+      const prevKey = (prevAlone[1] ?? '').trim();
+
+      if (transformedKeys.includes(prevKey) || migrated.includes(cleanValue(trimmed))) {
+        continue;
+      }
+    }
+
     lost.push(trimmed.slice(0, 60));
   }
 
@@ -389,9 +443,13 @@ export function migrateLegacyFile(input: MigrateLegacyFileInput): MigrateLegacyF
   }
 
   /**
-   * 零丢失守卫（已变换字段键集合：状态/日期别名/优先级/H1）
+   * 零丢失守卫（已变换字段键集合：状态/日期别名/优先级/H1；来源让位时加来源）
    */
-  const lost = findLostContent(raw, migrated.content, ['状态', '日期', '优先级']);
+  const lost = findLostContent(
+    raw,
+    migrated.content,
+    migrated.sourceReplaced ? ['状态', '日期', '优先级', '来源'] : ['状态', '日期', '优先级'],
+  );
 
   if (lost.length > 0) {
     return {