@longzai-intelligence-issues/ledger 0.0.2 → 0.0.4

package/.turbo/turbo-lint.log

@@ -1,7 +1,7 @@
 $ oxlint && oxfmt --check
 Found 0 warnings and 0 errors.
-Finished in 224ms on 39 files with 186 rules using 10 threads.
+Finished in 417ms on 42 files with 186 rules using 10 threads.
 Checking formatting...
 
 All matched files use the correct format.
-Finished in 153ms on 48 files using 10 threads.
+Finished in 229ms on 51 files using 10 threads.

package/CHANGELOG.md

@@ -5,6 +5,23 @@
 格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
 本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.0.4] - 2026-09-14
+
+### 变更
+
+- migrate-legacy 渲染层字段块连续化（去除规范组/额外组间空行）——修复 0.0.3 分组空行致解析层 bodyStart 误判的幂等循环（docs/issues/0013-npm-003-render-grouping-blank-breaks-idempotency.md）
+
+## [0.0.3] - 2026-09-14
+
+### 新增
+
+- parseHeaderDialect 新增引用+粗体复合键（> **键**: 值）与标题式隔行值（## 键 + 下一非空独立行）两类方言解析，H1 分隔符规范化扩展 em-dash 系；零丢失守卫同口径对账；状态值超长（>80 字符，段落级文本混入）交人工拆分
+
+### 变更
+
+- migrate-legacy 头部收敛：复合/多行/引用粗体/标题式隔行值四方言缺口修复、体首残留元信息块吸收与键去重（注入定档让位原始语义）、duplicate-metadata-key lint 规则、词表与收敛函数拆分守行限（事故记录见 docs/issues/0012）
+- registry.parser 状态行定位跳过标题行（标题含「连接状态：」词组不再吞掉真状态行）；migrate-legacy 超长状态拆分（状态词+长说明 → 短规范状态+处置摘要字段，零信息丢失）；同键多值合并为分号单行；多行元信息（空值键+缩进子项）子项并入单行值；核心函数拆分守行限（事故记录见 docs/issues/0012-batch-clearance-pollution-convergence-and-gate.md）
+
 ## [0.0.2] - 2026-09-14
 
 ### 新增

package/dist/index.d.ts

@@ -1504,11 +1504,20 @@ declare function deriveEntriesFromViolations(violations: readonly LintViolation[
 /**
  * normalize-header（方言头部迁移）
  *
- * 四种历史方言（单行管道引用行 / 粗体标签行 / `## 键: 值` 标题式 / `- ` 列表式）
- * 解析后重排为裁定格式：粗体标签逐行 `**键**: 值`；字段规范序（FIELD_RANK）；
- * 「主题」问题陈述迁正文首个节标题后；residual 原样保留。零丢失守卫：每字段
- * 必须在产物文本在场否则 failed 不落盘；幂等（产物 === 原文 → unchanged）。
+ * 五种历史方言（单行管道引用行 / 粗体标签行 / `## 键: 值` 标题式 / `- ` 列表式 /
+ * `| 键 | 值 |` 表格）与两类复合形态（引用行内粗体键 `> **键**: 值`、标题式隔行值
+ * `## 键` + 下一非空独立行）解析后重排为裁定格式：粗体标签逐行 `**键**: 值`；字段
+ * 规范序（FIELD_RANK）；「主题」问题陈述迁正文首个节标题后；residual 原样保留。
+ * 零丢失守卫：每字段必须在产物文本在场否则 failed 不落盘；幂等（产物 === 原文 →
+ * unchanged）。
  */
+/**
+ * 标题式隔行值认定键集（`## 键` + 下一非空独立行为值的复合方言）
+ *
+ * 键限集合防误吞：非元信息键的 `## 节` 仍按正文边界终止头部；值行另有独立
+ * 短行约束（见 parseHeaderDialect 形态七），流水段落首行不受影响。
+ */
+declare const HEADING_ALONE_METADATA_KEYS: ReadonlySet<string>;
 /**
  * 单文件迁移入参
  */
@@ -1565,7 +1574,8 @@ type ParsedHeader = {
   bodyStartIndex: number;
 };
 /**
- * 解析头部方言（五种形态逐行尝试：粗体标签 / 列表式 / 标题式 / 管道引用行 / 表格）
+ * 解析头部方言（五种形态逐行尝试：粗体标签 / 列表式 / 标题式 / 管道引用行 / 表格；
+ * 另含两类复合形态：引用行内粗体键、标题式隔行值）
  *
  * @param lines - 文档行数组
  * @returns 头部解析产物
@@ -1620,8 +1630,8 @@ declare function normalizeHeaderFile(input: NormalizeHeaderFileInput): Normalize
  * migrate-legacy 纯变换核（无 IO，可测性单一来源）
  *
  * 五方言解析（含表格）→ 字段别名 → pre-emoji 状态词规范化 → H1 编号规范 →
- * 处置段标题链对齐 → 必填元信息回填。全部变换可幂等重放，变换台账逐条记录，
- * 供命令层零丢失守卫与人工复核消费。
+ * 处置段标题链对齐 → 必填元信息回填 → 体首残留元信息块吸收与键去重收敛。
+ * 全部变换可幂等重放，变换台账逐条记录，供命令层零丢失守卫与人工复核消费。
  */
 /**
  * 单文件迁移变换台账条目
@@ -1630,7 +1640,7 @@ type MigrationTransformation = {
   /**
    * 变换类别（人工复核消费的稳定标识）
    */
-  kind: 'status-canonicalized' | 'status-downgraded-placeholder' | 'field-alias' | 'priority-mapped' | 'priority-backfilled' | 'h1-numbered' | 'disposition-renamed' | 'disposition-appended' | 'required-backfilled';
+  kind: 'status-canonicalized' | 'status-downgraded-placeholder' | 'field-alias' | 'priority-mapped' | 'priority-backfilled' | 'h1-numbered' | 'disposition-renamed' | 'disposition-appended' | 'required-backfilled' | 'header-converged' | 'duplicate-field-converged';
   /**
    * 变换说明（原值 → 新值）
    */
@@ -1656,6 +1666,10 @@ type MigrateCoreResult = {
    * 变换台账（rewritten 时非空）
    */
   transformations: MigrationTransformation[];
+  /**
+   * 来源让位标记（回填缺省让位原始语义——守卫对来源键放行依据）
+   */
+  sourceReplaced: boolean;
 };
 /**
  * 迁移选项（引擎零仓库知识——仓库特有缺省值全部经入参注入）
@@ -1688,6 +1702,100 @@ type MigrateCoreOptions = {
    */
   status?: 'red' | 'green';
 };
+/**
+ * 处置段候选标题链（apex-energy-ktv 全量段名词频盘点驱动；验证族 > 治理记录族 >
+ * 变更/修复族。计划性段名（治理方案/治理方向/修复方向/处置方向）不属处置记录，排除）
+ */
+declare const DISPOSITION_CANDIDATES: ReadonlyArray<{
+  pattern: RegExp;
+  title: string;
+}>;
+/**
+ * 执行单文档纯变换
+ *
+ * @param raw - 文档全文
+ * @param options - 迁移选项
+ * @returns 纯变换产物
+ */
+declare function migrateLegacyCore(raw: string, options: MigrateCoreOptions): MigrateCoreResult;
+//#endregion
+//#region src/migrate/migrate-legacy.commands.d.ts
+/**
+ * 单文件迁移入参
+ */
+type MigrateLegacyFileInput = {
+  /**
+   * 仓库根绝对路径
+   */
+  root: string;
+  /**
+   * issue 文件仓库相对路径（须落 scope registryDir 内）
+   */
+  file: string;
+  /**
+   * 解析后配置（所属域回填取 scope title）
+   */
+  config: LziIssuesConfig;
+  /**
+   * 优先级缺省（原案无优先级与严重程度时回填）
+   */
+  defaultPriority?: 'P1' | 'P2' | 'P3';
+  /**
+   * 来源回填缺省文案
+   */
+  defaultSource?: string;
+  /**
+   * 立案日期回填缺省（YYYY-MM-DD）
+   */
+  defaultFilingDate?: string;
+  /**
+   * 无状态行历史文档的显式灯位注入（--status red|green；灯位语义由操作者定档）
+   */
+  status?: 'red' | 'green';
+  /**
+   * 只呈现不落盘
+   */
+  dryRun?: boolean;
+};
+/**
+ * 单文件迁移结果
+ */
+type MigrateLegacyFileResult = {
+  /**
+   * issue 文件仓库相对路径
+   */
+  file: string;
+  /**
+   * 处置形态
+   */
+  outcome: 'rewritten' | 'unchanged' | 'skipped' | 'failed';
+  /**
+   * 结果说明
+   */
+  message: string;
+  /**
+   * 产物全文（rewritten/unchanged 携带，dry-run 复核消费）
+   */
+  content: string;
+  /**
+   * 变换台账（人工复核消费）
+   */
+  transformations: MigrationTransformation[];
+};
+/**
+ * 迁移并（缺省）落盘单份存量文档
+ *
+ * @param input - 命令入参
+ * @returns 单文件迁移结果
+ */
+declare function migrateLegacyFile(input: MigrateLegacyFileInput): MigrateLegacyFileResult;
+//#endregion
+//#region src/migrate/migrate-legacy.vocab.d.ts
+/**
+ * migrate-legacy 词表与纯规范化函数（无 IO，自 migrate-legacy.core 拆出守文件行上限）
+ *
+ * 字段值粗体清理、pre-emoji 状态词表匹配与五态规范化、优先级档位映射、H1 规范化。
+ */
 /**
  * 状态词匹配产物
  */
@@ -1761,93 +1869,48 @@ type CanonicalH1 = {
  * @returns 规范标题行与标题核心
  */
 declare function canonicalizeH1(h1: string, number: string): CanonicalH1;
-/**
- * 处置段候选标题链（apex-energy-ktv 全量段名词频盘点驱动；验证族 > 治理记录族 >
- * 变更/修复族。计划性段名（治理方案/治理方向/修复方向/处置方向）不属处置记录，排除）
- */
-declare const DISPOSITION_CANDIDATES: ReadonlyArray<{
-  pattern: RegExp;
-  title: string;
-}>;
-/**
- * 执行单文档纯变换
- *
- * @param raw - 文档全文
- * @param options - 迁移选项
- * @returns 纯变换产物
- */
-declare function migrateLegacyCore(raw: string, options: MigrateCoreOptions): MigrateCoreResult;
 //#endregion
-//#region src/migrate/migrate-legacy.commands.d.ts
+//#region src/migrate/migrate-legacy.backfill.d.ts
 /**
- * 单文件迁移入参
+ * 回填入参（与 MigrateCoreOptions 的回填子集 + 字段工作副本）
  */
-type MigrateLegacyFileInput = {
+type BackfillInput = {
   /**
-   * 仓库根绝对路径
+   * 头部字段工作副本（原地回填）
    */
-  root: string;
+  fields: Array<{
+    key: string;
+    value: string;
+  }>;
   /**
-   * issue 文件仓库相对路径（须落 scope registryDir 内）
+   * 变换台账
    */
-  file: string;
-  /**
-   * 解析后配置（所属域回填取 scope title）
-   */
-  config: LziIssuesConfig;
+  transformations: MigrationTransformation[];
   /**
-   * 优先级缺省（原案无优先级与严重程度时回填）
+   * 优先级缺省
    */
   defaultPriority?: 'P1' | 'P2' | 'P3';
   /**
-   * 来源回填缺省文案
-   */
-  defaultSource?: string;
-  /**
-   * 立案日期回填缺省（YYYY-MM-DD）
+   * 立案日期回填缺省
    */
   defaultFilingDate?: string;
-  /**
-   * 无状态行历史文档的显式灯位注入（--status red|green；灯位语义由操作者定档）
-   */
-  status?: 'red' | 'green';
-  /**
-   * 只呈现不落盘
-   */
-  dryRun?: boolean;
 };
 /**
- * 单文件迁移结果
+ * 回填产物
  */
-type MigrateLegacyFileResult = {
+type BackfillResult = {
   /**
-   * issue 文件仓库相对路径
+   * skip 语（缺省未给交人工时非空）
    */
-  file: string;
-  /**
-   * 处置形态
-   */
-  outcome: 'rewritten' | 'unchanged' | 'skipped' | 'failed';
-  /**
-   * 结果说明
-   */
-  message: string;
-  /**
-   * 产物全文（rewritten/unchanged 携带，dry-run 复核消费）
-   */
-  content: string;
-  /**
-   * 变换台账（人工复核消费）
-   */
-  transformations: MigrationTransformation[];
+  skipMessage: string | null;
 };
 /**
- * 迁移并（缺省）落盘单份存量文档
+ * 执行字段别名与必填回填
  *
- * @param input - 命令入参
- * @returns 单文件迁移结果
+ * @param input - 回填入参
+ * @returns 回填产物（skipMessage 非空即调用方应 skipped 返回）
  */
-declare function migrateLegacyFile(input: MigrateLegacyFileInput): MigrateLegacyFileResult;
+declare function backfillRequiredFields(input: BackfillInput): BackfillResult;
 //#endregion
 //#region src/numbering/numbering.core.d.ts
 /**
@@ -2430,4 +2493,4 @@ type TriageClassification = {
  */
 declare function classifyIssue(record: IssueDocRecord): TriageClassification;
 //#endregion
-export { ADJUDICATION_KEYWORD, ASCII_KEBAB_SLUG_PATTERN, AuditCoverageInput, BLOCKING_LINE_KEY, CANONICAL_STATUS_LABELS, CORE_LINT_RULES, CRITERIA_CHANNEL_PATTERN, CRITERIA_FENCE_CLOSE_PATTERN, CRITERIA_FENCE_OPEN_PATTERN, CloseBatchResult, CloseCaseResult, CloseGateResult, Criterion, CriterionCertificate, CriterionRunResult, DISPOSITION_CANDIDATES, DISPOSITION_PLACEHOLDER_PATTERN, DISPOSITION_PLACEHOLDER_WINDOW_LINES, DISPOSITION_TITLE_KEYWORD, DocRefCheckResult, DocRefViolation, DocsBaselineInput, DocsBaselineResult, DocsCheckInput, DocsFixInput, DocsFixResult, EVIDENCE_ANCHOR_MARKERS, EvidenceAnchor, EvidenceAnchorKind, EvidenceCloseInput, EvidenceReadResult, FreezeIssueInput, FreezeResult, GUIDE_FIXTURE_END_MARK, GUIDE_FIXTURE_START_MARK, GreenFlipInput, GreenFlipResult, HISTORY_LINE_KEY, HealthReport, ISSUES_KEY_RULE, ISSUE_FILE_FORMAT_GUIDE_RELATIVE, ISSUE_REF_TOKEN_PATTERN, IssueDocRecord, IssueRefToken, IssueStatusKind, IssueTemplatePriority, IssueTemplateRef, IssueTemplateValues, LEGACY_STATUS_VOCABULARY, LintResult, LintRule, LintRuleContext, LintViolation, META_LINE_PREFIX_SOURCE_TEMPLATE, MigrateCoreOptions, MigrateCoreResult, MigrateLegacyFileInput, MigrateLegacyFileResult, MigrationTransformation, MiniGlobError, NextNumberInput, NextNumberResult, NormalizeHeaderFileInput, NormalizeHeaderOptions, NormalizeHeaderResult, NormalizeOutcome, NormalizeResult, NumberingAllowlistEntry, NumberingAuditCommandInput, NumberingAuditFinding, NumberingAuditFindingKind, NumberingAuditResult, NumberingCheckCommandInput, NumberingCheckResult, NumberingFinding, NumberingFindingKind, NumberingKeyRule, NumberingNextCommandInput, NumberingNextResult, PENDING_REASON_PATTERN, ParsedCriteriaBlock, ParsedCriterion, ParsedHeader, PromptEntry, PromptsOptions, REGISTRY_FILE_PATTERN, RegistryFileNameParts, RerunCloseInput, RunCriterionInput, RunHealthInput, RunLintInput, RunLockHandle, RunTriageInput, RunTriageResult, STATUS_LINE_LOCATE_PATTERN, STATUS_LINE_PREFIX_SOURCE, STATUS_LINE_SCAN_LINES, ScopeScanInput, TEMPLATE_FIELDS, TemplateFieldDoc, TriageCategory, TriageClassification, TriageItem, TriageLedgerFile, UnfreezeIssueInput, WalkOptions, WriteLintBaselineInput, WriteLintBaselineResult, acquireRunLock, applyGreenFlip, auditCoverage, buildMetaLineLocatePattern, canonicalizeH1, canonicalizeStatusValue, certificatePath, classifyIssue, classifyStatusLine, cleanValue, compileMiniGlob, computeCriterionFingerprint, computeNextNumber, deriveEntriesFromViolations, deriveWalkPrefixes, evidenceCloseFlow, extractFileKey, extractIssueRefTokens, extractSlugSegment, findCertificate, findPendingWord, freezeIssue, keyLeadingNumber, listPrompts, loadIssueFileFormatGuide, locateDispositionText, locateIssueFileFormatGuide, mapPriorityValue, matchMiniGlob, migrateLegacyCore, migrateLegacyFile, normalizeHeader, normalizeHeaderFile, parseCriteriaBlock, parseHeaderDialect, parseIssueDoc, parseRegistryFileName, readEvidence, readEvidenceAnchors, readPendingReason, registerLintRulePack, renderCriteriaBlockExample, renderEvidenceCloseBlock, renderIssueTemplate, renderIssueTemplateSkeleton, renderRegistryReadmeStub, renderRerunEvidenceBlock, rerunCloseFlow, resolveCloseGates, runCriterionViaVault, runDocsCheck, runDocsFix, runHealth, runLint, runNumberingAudit, runNumberingCheck, runNumberingNext, runTriage, runWriteDocsBaseline, runWriteLintBaseline, scanOrphanSidecars, scanRegistryDir, scanScopeForFindings, showPrompt, sliceGuideFixtureSample, unfreezeIssue, walkFilesUnderPrefixes, walkFilesUnderRoots };
+export { ADJUDICATION_KEYWORD, ASCII_KEBAB_SLUG_PATTERN, AuditCoverageInput, BLOCKING_LINE_KEY, BackfillInput, BackfillResult, CANONICAL_STATUS_LABELS, CORE_LINT_RULES, CRITERIA_CHANNEL_PATTERN, CRITERIA_FENCE_CLOSE_PATTERN, CRITERIA_FENCE_OPEN_PATTERN, CloseBatchResult, CloseCaseResult, CloseGateResult, Criterion, CriterionCertificate, CriterionRunResult, DISPOSITION_CANDIDATES, DISPOSITION_PLACEHOLDER_PATTERN, DISPOSITION_PLACEHOLDER_WINDOW_LINES, DISPOSITION_TITLE_KEYWORD, DocRefCheckResult, DocRefViolation, DocsBaselineInput, DocsBaselineResult, DocsCheckInput, DocsFixInput, DocsFixResult, EVIDENCE_ANCHOR_MARKERS, EvidenceAnchor, EvidenceAnchorKind, EvidenceCloseInput, EvidenceReadResult, FreezeIssueInput, FreezeResult, GUIDE_FIXTURE_END_MARK, GUIDE_FIXTURE_START_MARK, GreenFlipInput, GreenFlipResult, HEADING_ALONE_METADATA_KEYS, HISTORY_LINE_KEY, HealthReport, ISSUES_KEY_RULE, ISSUE_FILE_FORMAT_GUIDE_RELATIVE, ISSUE_REF_TOKEN_PATTERN, IssueDocRecord, IssueRefToken, IssueStatusKind, IssueTemplatePriority, IssueTemplateRef, IssueTemplateValues, LEGACY_STATUS_VOCABULARY, LintResult, LintRule, LintRuleContext, LintViolation, META_LINE_PREFIX_SOURCE_TEMPLATE, MigrateCoreOptions, MigrateCoreResult, MigrateLegacyFileInput, MigrateLegacyFileResult, MigrationTransformation, MiniGlobError, NextNumberInput, NextNumberResult, NormalizeHeaderFileInput, NormalizeHeaderOptions, NormalizeHeaderResult, NormalizeOutcome, NormalizeResult, NumberingAllowlistEntry, NumberingAuditCommandInput, NumberingAuditFinding, NumberingAuditFindingKind, NumberingAuditResult, NumberingCheckCommandInput, NumberingCheckResult, NumberingFinding, NumberingFindingKind, NumberingKeyRule, NumberingNextCommandInput, NumberingNextResult, PENDING_REASON_PATTERN, ParsedCriteriaBlock, ParsedCriterion, ParsedHeader, PromptEntry, PromptsOptions, REGISTRY_FILE_PATTERN, RegistryFileNameParts, RerunCloseInput, RunCriterionInput, RunHealthInput, RunLintInput, RunLockHandle, RunTriageInput, RunTriageResult, STATUS_LINE_LOCATE_PATTERN, STATUS_LINE_PREFIX_SOURCE, STATUS_LINE_SCAN_LINES, ScopeScanInput, TEMPLATE_FIELDS, TemplateFieldDoc, TriageCategory, TriageClassification, TriageItem, TriageLedgerFile, UnfreezeIssueInput, WalkOptions, WriteLintBaselineInput, WriteLintBaselineResult, acquireRunLock, applyGreenFlip, auditCoverage, backfillRequiredFields, buildMetaLineLocatePattern, canonicalizeH1, canonicalizeStatusValue, certificatePath, classifyIssue, classifyStatusLine, cleanValue, compileMiniGlob, computeCriterionFingerprint, computeNextNumber, deriveEntriesFromViolations, deriveWalkPrefixes, evidenceCloseFlow, extractFileKey, extractIssueRefTokens, extractSlugSegment, findCertificate, findPendingWord, freezeIssue, keyLeadingNumber, listPrompts, loadIssueFileFormatGuide, locateDispositionText, locateIssueFileFormatGuide, mapPriorityValue, matchMiniGlob, migrateLegacyCore, migrateLegacyFile, normalizeHeader, normalizeHeaderFile, parseCriteriaBlock, parseHeaderDialect, parseIssueDoc, parseRegistryFileName, readEvidence, readEvidenceAnchors, readPendingReason, registerLintRulePack, renderCriteriaBlockExample, renderEvidenceCloseBlock, renderIssueTemplate, renderIssueTemplateSkeleton, renderRegistryReadmeStub, renderRerunEvidenceBlock, rerunCloseFlow, resolveCloseGates, runCriterionViaVault, runDocsCheck, runDocsFix, runHealth, runLint, runNumberingAudit, runNumberingCheck, runNumberingNext, runTriage, runWriteDocsBaseline, runWriteLintBaseline, scanOrphanSidecars, scanRegistryDir, scanScopeForFindings, showPrompt, sliceGuideFixtureSample, unfreezeIssue, walkFilesUnderPrefixes, walkFilesUnderRoots };