@longzai-intelligence-issues/ledger 0.0.1 → 0.0.2

package/.turbo/turbo-build.log

@@ -0,0 +1,5 @@
+$ lzi-builder
+ℹ lzi-builder v0.2.19 powered by rolldown v1.2.8
+ℹ @longzai-intelligence-issues/ledger tsconfig: tsconfig/build.json
+ℹ Cleaning 5 files
+TypeScript 7.0 尚未提供稳定的 API，仍处于实验阶段。部分选项将不可用。

package/.turbo/turbo-lint.log

@@ -0,0 +1,7 @@
+$ oxlint && oxfmt --check
+Found 0 warnings and 0 errors.
+Finished in 224ms on 39 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.

package/.turbo/turbo-typecheck.log

@@ -0,0 +1,4 @@
+$ bun run typecheck:app && bun run typecheck:node && bun run typecheck:test
+$ lzi-tsgo typecheck tsconfig/app.json
+$ lzi-tsgo typecheck tsconfig/node.json
+$ lzi-tsgo typecheck tsconfig/test.json

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.2] - 2026-09-14
+
+### 新增
+
+- migrate-legacy 存量清偿引擎（五方言解析→状态词规范化→处置段对齐→必填回填；零丢失守卫+幂等+dry-run）
+- LEGACY_STATUS_VOCABULARY pre-emoji 状态词表常量（读侧归类不动，IssueStatus 契约零破坏）
+
+### 变更
+
+- normalize-header 支持 --status 显式灯位注入（无可识别状态行场景）
+- parseHeaderDialect 新增表格方言解析（两列表；脚手架设计性丢弃）
+- lint issue-slug-contains-digit 支持 scope slugDigitPolicy allow 放行
+- 注册表 README 存根支持指南缺失回退（不落死链，指向 template 机器真源）
+- migrate-legacy 新增 --status red|green 显式灯位注入（无状态行历史文档的人工定档通道）与处置段候选链数据驱动扩展（落地治理/治理落地/验证/修复等，排除计划性段名）
+- migrate-legacy H1 分隔符变体兼容句点形态（# 0279. 标题）
+- LEGACY_STATUS_VOCABULARY 补 已处置/已完成/已闭合（规范词无 emoji 历史形态）
+
 ## [0.0.1] - 2026-09-14
 
 ### 新增

package/dist/index.d.ts

@@ -1068,6 +1068,39 @@ type IssueStatusKind = 'red' | 'yellow' | 'green' | 'frozen' | 'canceled' | 'leg
  * 规范状态标签（写侧单一真源）
  */
 declare const CANONICAL_STATUS_LABELS: Readonly<Record<'red' | 'yellow' | 'green' | 'frozen' | 'canceled', string>>;
+/**
+ * pre-emoji 存量状态词表（写侧迁移单一真源）
+ *
+ * 读侧归类（classifyStatusLine）不消费本词表——旧词表形态归 unknown 由 lint
+ * status-line-missing 拦截，迁移经由 migrate-legacy 写侧规范化后回归规范五态，
+ * 避免为读侧新增 legacy-red 等形态破坏 IssueStatus 契约面。
+ */
+declare const LEGACY_STATUS_VOCABULARY: Readonly<{
+  /**
+   * 绿系词（历史已结案标记）
+   */
+  green: readonly string[];
+  /**
+   * 红系词（历史待办标记）
+   */
+  red: readonly string[];
+  /**
+   * 延期系词（已登记（延期）族——迁移默认回红灯并保留延期说明）
+   */
+  deferred: readonly string[];
+  /**
+   * 取消系词
+   */
+  canceled: readonly string[];
+  /**
+   * 进行系词（黄灯候选）
+   */
+  inProgress: readonly string[];
+  /**
+   * 冻结系词（不迁移——冻结唯一合法写入路径是 freeze 命令）
+   */
+  frozen: readonly string[];
+}>;
 /**
  * issue 引用 token 形态
  *
@@ -1488,6 +1521,11 @@ type NormalizeHeaderFileInput = {
    * issue 文件仓库相对路径
    */
   file: string;
+  /**
+   * 无可识别状态行时的显式灯位（--status 语义；frozen 不在此通道——冻结唯一合法
+   * 写入路径是 freeze 命令，其裁定语硬门不可绕过）
+   */
+  status?: 'red' | 'yellow' | 'green' | 'canceled';
 };
 /**
  * 单文件迁移结果
@@ -1506,10 +1544,46 @@ type NormalizeHeaderResult = {
    */
   message: string;
 };
+/**
+ * 头部解析产物
+ */
+type ParsedHeader = {
+  /**
+   * 字段键值对（保序）
+   */
+  fields: Array<{
+    key: string;
+    value: string;
+  }>;
+  /**
+   * residual 行（解析不成字段的行，原样保留）
+   */
+  residuals: string[];
+  /**
+   * 头部结束行下标（正文起点）
+   */
+  bodyStartIndex: number;
+};
+/**
+ * 解析头部方言（五种形态逐行尝试：粗体标签 / 列表式 / 标题式 / 管道引用行 / 表格）
+ *
+ * @param lines - 文档行数组
+ * @returns 头部解析产物
+ */
+declare function parseHeaderDialect(lines: string[]): ParsedHeader;
 /**
  * 迁移形态
  */
 type NormalizeOutcome = 'rewritten' | 'unchanged' | 'skipped';
+/**
+ * normalizeHeader 迁移选项（无可识别状态行时的显式灯位注入）
+ */
+type NormalizeHeaderOptions = {
+  /**
+   * 显式灯位（--status 语义；frozen 不在此通道——冻结唯一合法写入路径是 freeze）
+   */
+  status?: NormalizeHeaderFileInput['status'];
+};
 /**
  * 迁移产物
  */
@@ -1527,9 +1601,10 @@ type NormalizeResult = {
  * 迁移单份文档头部
  *
  * @param raw - 文档全文
+ * @param options - 迁移选项（无可识别状态行时的显式灯位注入）
  * @returns 迁移产物
  */
-declare function normalizeHeader(raw: string): NormalizeResult;
+declare function normalizeHeader(raw: string, options?: NormalizeHeaderOptions): NormalizeResult;
 /**
  * 迁移并落盘单份文档（守卫失败不落盘）
  *
@@ -1540,6 +1615,240 @@ declare function normalizeHeader(raw: string): NormalizeResult;
  */
 declare function normalizeHeaderFile(input: NormalizeHeaderFileInput): NormalizeHeaderResult;
 //#endregion
+//#region src/migrate/migrate-legacy.core.d.ts
+/**
+ * migrate-legacy 纯变换核（无 IO，可测性单一来源）
+ *
+ * 五方言解析（含表格）→ 字段别名 → pre-emoji 状态词规范化 → H1 编号规范 →
+ * 处置段标题链对齐 → 必填元信息回填。全部变换可幂等重放，变换台账逐条记录，
+ * 供命令层零丢失守卫与人工复核消费。
+ */
+/**
+ * 单文件迁移变换台账条目
+ */
+type MigrationTransformation = {
+  /**
+   * 变换类别（人工复核消费的稳定标识）
+   */
+  kind: 'status-canonicalized' | 'status-downgraded-placeholder' | 'field-alias' | 'priority-mapped' | 'priority-backfilled' | 'h1-numbered' | 'disposition-renamed' | 'disposition-appended' | 'required-backfilled';
+  /**
+   * 变换说明（原值 → 新值）
+   */
+  detail: string;
+};
+/**
+ * 纯变换产物
+ */
+type MigrateCoreResult = {
+  /**
+   * 迁移形态
+   */
+  outcome: 'rewritten' | 'unchanged' | 'skipped';
+  /**
+   * 产物全文（skipped 时为原文）
+   */
+  content: string;
+  /**
+   * skip/unchanged 说明
+   */
+  message: string;
+  /**
+   * 变换台账（rewritten 时非空）
+   */
+  transformations: MigrationTransformation[];
+};
+/**
+ * 迁移选项（引擎零仓库知识——仓库特有缺省值全部经入参注入）
+ */
+type MigrateCoreOptions = {
+  /**
+   * 编号（文件名前缀，H1 规范化用）
+   */
+  number: string;
+  /**
+   * 所属域回填值（scope title）
+   */
+  scopeTitle: string;
+  /**
+   * 优先级缺省（原案无优先级与严重程度时回填）
+   */
+  defaultPriority?: 'P1' | 'P2' | 'P3';
+  /**
+   * 来源回填缺省文案
+   */
+  defaultSource?: string;
+  /**
+   * 立案日期回填缺省（原案无日期字段时；未给则 skipped 交人工）
+   */
+  defaultFilingDate?: string;
+  /**
+   * 无状态行历史文档的显式灯位注入（--status；灯位属语义判断由操作者定档，
+   * 引擎仅承接机械迁移。红/绿两态——黄灯须 ≥4 字挂起原因不适用固定文案注入，
+   * 冻结唯一合法路径是 freeze 命令）
+   */
+  status?: 'red' | 'green';
+};
+/**
+ * 状态词匹配产物
+ */
+type StatusWordMatch = {
+  /**
+   * 词表档位
+   */
+  tier: 'green' | 'red' | 'deferred' | 'canceled' | 'inProgress' | 'frozen';
+  /**
+   * 命中词
+   */
+  word: string;
+};
+/**
+ * 状态值规范化产物
+ */
+type CanonicalStatusValue = {
+  /**
+   * 规范状态值（五态灯位 + 溯源括注）
+   */
+  value: string;
+  /**
+   * 词表档位
+   */
+  tier: StatusWordMatch['tier'];
+  /**
+   * 命中词（原词溯源）
+   */
+  word: string;
+};
+/**
+ * 清理字段值（去首尾空白与粗体星号——覆盖三种历史形态：整体包裹 `**值**`、
+ * 前导无尾随 `**值`、词中包裹 `**词**（括注）`）
+ *
+ * @param value - 原值
+ * @returns 清理后值
+ */
+declare function cleanValue(value: string): string;
+/**
+ * 规范化状态值（pre-emoji 词 → 五态灯位；原词与括注零丢失保留）
+ *
+ * @param value - 清理后的状态值
+ * @returns 规范值与档位；不可机械迁移为 null（须人工）
+ */
+declare function canonicalizeStatusValue(value: string): CanonicalStatusValue | null;
+/**
+ * 严重程度/中文优先级 → P 档位映射
+ *
+ * @param value - 原值（高/中/低或 P1/P2/P3）
+ * @returns P 档位；不可映射为 null
+ */
+declare function mapPriorityValue(value: string): 'P1' | 'P2' | 'P3' | null;
+/**
+ * H1 规范化产物
+ */
+type CanonicalH1 = {
+  /**
+   * 规范标题行（`# NNNN - 标题核心`）
+   */
+  line: string;
+  /**
+   * 标题核心（剥离既有编号与分隔符变体后的标题文本）
+   */
+  titleCore: string;
+};
+/**
+ * H1 标题规范化：`# NNNN - 标题`（剥离既有编号与分隔符变体）
+ *
+ * @param h1 - 原一级标题行
+ * @param number - 文件名编号
+ * @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
+/**
+ * 单文件迁移入参
+ */
+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/numbering/numbering.core.d.ts
 /**
  * 编号门禁核心（纯函数，零 fs）
@@ -1718,9 +2027,9 @@ type ScopeScanInput = {
    */
   allowlist: readonly NumberingAllowlistEntry[];
   /**
-   * slug 数字策略（'forbid' 启用判定）
+   * slug 数字策略（'forbid' 启用判定；'allow' 整域放行跳过判定）
    */
-  slugDigitPolicy?: 'forbid';
+  slugDigitPolicy?: 'forbid' | 'allow';
   /**
    * slug 数字白名单 glob（仓库相对路径命中豁免）
    */
@@ -2065,13 +2374,14 @@ declare function renderCriteriaBlockExample(): string;
 /**
  * 渲染注册表 README 格式存根（init 命令落盘）
  *
- * 一页式格式速览：建档入口、状态行五态、正文四段；完整规范指向格式真源指南。
+ * 一页式格式速览：建档入口、状态行五态、正文四段；完整规范指向格式真源指南
+ * （采用仓不携带指南文件时回退机器真源提示，不落死链）。
  *
  * @param scopeTitle - scope 人类可读名
- * @param guideRelPath - 格式指南相对本注册表目录的路径（如 `../../docs/guides/issue-file-format.md`）
+ * @param guideRelPath - 格式指南相对本注册表目录的路径；指南不在采用仓时为 null
  * @returns README 存根全文
  */
-declare function renderRegistryReadmeStub(scopeTitle: string, guideRelPath: string): string;
+declare function renderRegistryReadmeStub(scopeTitle: string, guideRelPath: string | null): string;
 /**
  * 模板字段说明条目（template --format json 载荷）
  */
@@ -2120,4 +2430,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_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, LintResult, LintRule, LintRuleContext, LintViolation, META_LINE_PREFIX_SOURCE_TEMPLATE, MiniGlobError, NextNumberInput, NextNumberResult, NormalizeHeaderFileInput, NormalizeHeaderResult, NormalizeOutcome, NormalizeResult, NumberingAllowlistEntry, NumberingAuditCommandInput, NumberingAuditFinding, NumberingAuditFindingKind, NumberingAuditResult, NumberingCheckCommandInput, NumberingCheckResult, NumberingFinding, NumberingFindingKind, NumberingKeyRule, NumberingNextCommandInput, NumberingNextResult, PENDING_REASON_PATTERN, ParsedCriteriaBlock, ParsedCriterion, 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, certificatePath, classifyIssue, classifyStatusLine, compileMiniGlob, computeCriterionFingerprint, computeNextNumber, deriveEntriesFromViolations, deriveWalkPrefixes, evidenceCloseFlow, extractFileKey, extractIssueRefTokens, extractSlugSegment, findCertificate, findPendingWord, freezeIssue, keyLeadingNumber, listPrompts, loadIssueFileFormatGuide, locateDispositionText, locateIssueFileFormatGuide, matchMiniGlob, normalizeHeader, normalizeHeaderFile, parseCriteriaBlock, 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, 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 };