@longzai-intelligence-issues/ledger 0.0.1 → 0.0.3

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/__tests__/template/issue-template.renderer.test.ts

@@ -130,4 +130,14 @@ describe('renderRegistryReadmeStub', () => {
     expect(stub.includes('🔴 待处理')).toBe(true);
     expect(stub.includes('⚪ 已冻结')).toBe(true);
   });
+
+  test('指南不在采用仓时（null）回退机器真源提示且不含死链', () => {
+    const stub = renderRegistryReadmeStub('项目全局', null);
+
+    expect(stub.includes('# 项目全局 issue 注册表')).toBe(true);
+    expect(stub.includes('lzi-issues template')).toBe(true);
+    expect(stub.includes('docs/guides/issue-file-format.md')).toBe(true);
+    expect(stub.includes('](../')).toBe(false);
+    expect(stub.includes('](../../')).toBe(false);
+  });
 });

package/src/index.ts

@@ -29,6 +29,14 @@ export * from './lint/lint.core.js';
 
 export * from './normalize/normalize-header.commands.js';
 
+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

@@ -259,6 +259,17 @@ export const CORE_LINT_RULES: readonly LintRule[] = [
         return null;
       }
 
+      /**
+       * 所属 scope 数字政策（allow 档位整域放行，缺省 forbid 走白名单例外通道）
+       */
+      const scopePolicy = ctx.config.scopes.find(
+        (scope) => scope.key === ctx.scopeKey,
+      )?.slugDigitPolicy;
+
+      if (scopePolicy === 'allow') {
+        return null;
+      }
+
       /**
        * 仓库相对路径（白名单匹配口径）
        */
@@ -273,7 +284,58 @@ export const CORE_LINT_RULES: readonly LintRule[] = [
 
       return whitelisted
         ? null
-        : `slug 段含数字（白名单登记请到配置 slugDigitAllowlist）：${record.file}`;
+        : `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;
     },
   },
   {

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 };
+}