@longzai-intelligence-issues/ledger 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,2123 @@
+import "./rolldown-runtime-BqT_7tdF.js";
+import { LintBaselineEntry, LziIssuesConfig } from "@longzai-intelligence-issues/config";
+//#region src/close/evidence-reader.utils.d.ts
+/**
+ * 绿证据锚点判读（证据收口缺省模式的判定核）
+ *
+ * 处置段定位（标题行起至下一 `## ` 或文末，跨内嵌围栏）；段内围栏里行整体跳过
+ * （判据声明非执行结果），围栏外逐行按优先级归类锚点：certificate > exit-zero >
+ * all-green > adjudicated；零锚点拒收。挂起词拦截按状态行全文判定。
+ */
+/**
+ * 锚点类别
+ */
+type EvidenceAnchorKind = 'certificate' | 'exit-zero' | 'all-green' | 'adjudicated';
+/**
+ * 绿证据锚点
+ */
+type EvidenceAnchor = {
+  /**
+   * 锚点类别
+   */
+  kind: EvidenceAnchorKind;
+  /**
+   * 锚点原文行
+   */
+  line: string;
+};
+/**
+ * 证据判读结果
+ */
+type EvidenceReadResult = {
+  /**
+   * 锚点列表（按判读优先级序）
+   */
+  anchors: EvidenceAnchor[];
+  /**
+   * 处置段文本（定位失败为空串）
+   */
+  dispositionText: string;
+};
+/**
+ * 定位处置段文本（跨内嵌围栏）
+ *
+ * @param raw - 文档全文
+ * @returns 处置段文本（含标题行；缺席为空串）
+ */
+declare function locateDispositionText(raw: string): string;
+/**
+ * 判读处置段围栏外锚点
+ *
+ * @param dispositionText - 处置段文本
+ * @returns 锚点列表（优先级降序归类，首个命中类别只取一次）
+ */
+declare function readEvidenceAnchors(dispositionText: string): EvidenceAnchor[];
+/**
+ * 证据判读组合入口
+ *
+ * @param raw - 文档全文
+ * @returns 判读结果
+ */
+declare function readEvidence(raw: string): EvidenceReadResult;
+/**
+ * 挂起词拦截判定（状态行含任一挂起词即拒绝收口——诚实黄灯维持）
+ *
+ * @param statusLine - 状态行全文
+ * @param pendingWords - 挂起词表
+ * @returns 命中的挂起词；未命中为 null
+ */
+declare function findPendingWord(statusLine: string, pendingWords: readonly string[]): string | null;
+/**
+ * 挂起原因提取（冻结/收口报文引用；复用解析器括注口径）
+ *
+ * @param statusLine - 状态行全文
+ * @returns 挂起原因；无括注为 null
+ */
+declare function readPendingReason(statusLine: string): string | null;
+//#endregion
+//#region src/docs-refs/docs-refs.commands.d.ts
+/**
+ * docs 检查入参
+ */
+type DocsCheckInput = {
+  /**
+   * 仓库根绝对路径
+   */
+  root: string;
+  /**
+   * 解析后配置
+   */
+  config: LziIssuesConfig;
+  /**
+   * 跳过基线豁免（write-baseline 再生口径）
+   */
+  ignoreBaseline?: boolean;
+};
+/**
+ * docs 修带入参
+ */
+type DocsFixInput = {
+  /**
+   * 仓库根绝对路径
+   */
+  root: string;
+  /**
+   * 解析后配置
+   */
+  config: LziIssuesConfig;
+  /**
+   * 只呈现不落盘
+   */
+  dryRun?: boolean;
+};
+/**
+ * docs 修复结果
+ */
+type DocsFixResult = {
+  /**
+   * 已修复文件清单
+   */
+  fixedFiles: string[];
+  /**
+   * 拒绝项清单（待人工面，存在即 exit 1 语义）
+   */
+  refused: DocRefViolation[];
+};
+/**
+ * docs 基线再生命令入参
+ */
+type DocsBaselineInput = {
+  /**
+   * 仓库根绝对路径
+   */
+  root: string;
+  /**
+   * 解析后配置
+   */
+  config: LziIssuesConfig;
+  /**
+   * 收编指针
+   */
+  issuePointer: string;
+};
+/**
+ * docs 基线再生结果
+ */
+type DocsBaselineResult = {
+  ok: true;
+  content: string;
+  entryCount: number;
+} | {
+  ok: false;
+  error: string;
+};
+/**
+ * docs 引用违例
+ */
+type DocRefViolation = {
+  /**
+   * 引用所在文件仓库相对 posix 路径
+   */
+  file: string;
+  /**
+   * 行号（1 起）
+   */
+  line: number;
+  /**
+   * 列号（1 起）
+   */
+  column: number;
+  /**
+   * 规则名（doc-ref-unknown / doc-ref-ambiguous / baseline-stale）
+   */
+  rule: string;
+  /**
+   * 违规消息
+   */
+  message: string;
+};
+/**
+ * docs 引用检查结果
+ */
+type DocRefCheckResult = {
+  /**
+   * 违例列表（active + baseline-stale）
+   */
+  violations: DocRefViolation[];
+  /**
+   * 基线豁免计数
+   */
+  suppressed: number;
+  /**
+   * 扫描文件数
+   */
+  scannedFiles: number;
+};
+/**
+ * docs 引用检查
+ *
+ * @param input - 命令入参
+ * @param input.root - 仓库根绝对路径
+ * @param input.config - 解析后配置
+ * @param input.ignoreBaseline - 跳过基线豁免（write-baseline 再生口径）
+ * @returns 检查结果
+ * @throws {@link Error} 配置未登记 docs 节
+ */
+declare function runDocsCheck(input: DocsCheckInput): DocRefCheckResult;
+/**
+ * docs 引用机械修复（唯一前缀展开为完整 slug）
+ *
+ * @param input - 命令入参
+ * @param input.root - 仓库根绝对路径
+ * @param input.config - 解析后配置
+ * @param input.dryRun - 只呈现不落盘
+ * @returns 修复结果（fixed / refused 清单；存在 refused 即 exit 1 语义）
+ * @throws {@link Error} 配置未登记 docs 节
+ */
+declare function runDocsFix(input: DocsFixInput): DocsFixResult;
+/**
+ * docs 基线再生命令核（拒绝扩基线）
+ *
+ * @param input - 命令入参
+ * @param input.root - 仓库根绝对路径
+ * @param input.config - 解析后配置
+ * @param input.issuePointer - 收编指针
+ * @returns 再生结果
+ * @throws {@link Error} 配置未登记 docs 节
+ */
+declare function runWriteDocsBaseline(input: DocsBaselineInput): DocsBaselineResult;
+//#endregion
+//#region src/prompts/prompts.commands.d.ts
+/**
+ * 推荐提示词（内置两模板 + extraDir 自定义加载）
+ *
+ * apex 两工作流提示词的泛化迁移：watch 域特有内容替换为 config 驱动的 scope
+ * 判定与 lzi-issues 命令面。CLI `prompts list / show` 消费；不动 MCP。
+ */
+/**
+ * 提示词列举/展示选项
+ */
+type PromptsOptions = {
+  /**
+   * 是否包含内置模板（默认 true）
+   */
+  builtin?: boolean;
+  /**
+   * 自定义模板目录绝对路径
+   */
+  extraDir?: string;
+};
+/**
+ * 提示词条目
+ */
+type PromptEntry = {
+  /**
+   * 提示词 id（kebab-case）
+   */
+  id: string;
+  /**
+   * 一句话描述
+   */
+  description: string;
+  /**
+   * 正文全文（markdown）
+   */
+  content: string;
+  /**
+   * 来源（builtin / extra）
+   */
+  source: 'builtin' | 'extra';
+};
+/**
+ * 列出全部提示词（内置 + extra；builtin 关闭时仅 extra）
+ *
+ * @param options - 列举选项
+ * @param options.builtin - 是否包含内置（默认 true）
+ * @param options.extraDir - 自定义模板目录
+ * @returns 提示词条目列表（id 去重，extra 覆盖同 id 内置）
+ */
+declare function listPrompts(options: PromptsOptions): PromptEntry[];
+/**
+ * 展示单个提示词
+ *
+ * @param id - 提示词 id
+ * @param options - 列举选项（与 listPrompts 一致）
+ * @returns 提示词条目；未命中为 null
+ */
+declare function showPrompt(id: string, options: PromptsOptions): PromptEntry | null;
+//#endregion
+//#region src/close/green-flip.commands.d.ts
+/**
+ * 翻绿回填内核（green-flip）
+ *
+ * 状态行改写保留前缀粗体/冒号原形态（读/写口径统一）；处置段回填证据锚点块
+ * （两种收口形态标题）。守卫分诊：replace 原样返回且正则仍命中（已绿且概要
+ * 逐字一致）→ 幂等零变更；正则零命中 → 抛错拒绝（防「处置段在场而状态行未
+ * 翻」假绿）。
+ */
+/**
+ * 翻绿入参
+ */
+type GreenFlipInput = {
+  /**
+   * 文档全文
+   */
+  raw: string;
+  /**
+   * 收口概要（状态行括注与证据块首行）
+   */
+  summary: string;
+  /**
+   * 证据锚点块全文（含标题行；空串表示只翻状态行）
+   */
+  evidenceBlock: string;
+};
+/**
+ * 翻绿结果
+ */
+type GreenFlipResult = {
+  /**
+   * 翻绿产物全文（幂等时与原文一致）
+   */
+  content: string;
+  /**
+   * 幂等标记（原文已为目标形态）
+   */
+  idempotent: boolean;
+};
+/**
+ * 执行翻绿回填
+ *
+ * @param input - 翻绿入参
+ * @returns 翻绿结果
+ * @throws {@link Error} 状态行零命中（缺状态行的文档不得走翻绿路径）
+ */
+declare function applyGreenFlip(input: GreenFlipInput): GreenFlipResult;
+/**
+ * 零执行证据收口证据块渲染
+ *
+ * @param anchorLines - 锚点原文行列表
+ * @param decisionRef - 收口依据（如「docs/decisions/0005」）
+ * @returns 证据锚点块全文
+ */
+declare function renderEvidenceCloseBlock(anchorLines: readonly string[], decisionRef: string): string;
+/**
+ * 证书化真跑证据块渲染（逐判据证书指纹行）
+ *
+ * @param summary - 收口概要
+ * @param evidenceLines - 逐判据证据行（已含证书指纹与退出码）
+ * @param caseRef - 收口先例指针
+ * @returns 证据锚点块全文
+ */
+declare function renderRerunEvidenceBlock(summary: string, evidenceLines: readonly string[], caseRef: string): string;
+//#endregion
+//#region src/vault/vault.commands.d.ts
+/**
+ * 证书库（verify vault）
+ *
+ * 判据指纹 = sha256(git 可见树 + 命令身份)——git 仓取 `git ls-files` 可见面，
+ * 非 git 仓回退目录全树；证书按 <channel>/<指纹>.json 落 .lzi/issues/vault/
+ * certificates/，同指纹复用秒回；run.lock 防并行互踩（D3：FIFO 队列留增强）。
+ */
+/**
+ * 判据（verify-close --criterion 四段）
+ */
+type Criterion = {
+  /**
+   * 判据标签
+   */
+  label: string;
+  /**
+   * 判据通道（证书库的通道维度）
+   */
+  channel: string;
+  /**
+   * 判据工作目录（相对仓库根）
+   */
+  cwd: string;
+  /**
+   * 判据命令（退出码即判据）
+   */
+  command: string;
+};
+/**
+ * 判据证书
+ */
+type CriterionCertificate = {
+  /**
+   * 内容寻址指纹（64 位 hex）
+   */
+  fingerprint: string;
+  /**
+   * 通道
+   */
+  channel: string;
+  /**
+   * 判据命令
+   */
+  command: string;
+  /**
+   * 工作目录
+   */
+  cwd: string;
+  /**
+   * 退出码
+   */
+  exitCode: number;
+  /**
+   * 输出摘要（首尾各若干行）
+   */
+  outputSummary: string[];
+  /**
+   * 执行时刻（ISO）
+   */
+  executedAt: string;
+};
+/**
+ * 判据执行入参
+ */
+type RunCriterionInput = {
+  /**
+   * 仓库根绝对路径
+   */
+  root: string;
+  /**
+   * 判据
+   */
+  criterion: Criterion;
+  /**
+   * 预计算指纹（缺省现算）
+   */
+  fingerprint?: string;
+};
+/**
+ * 判据执行结果
+ */
+type CriterionRunResult = {
+  /**
+   * 是否全绿（退出码 0）
+   */
+  green: boolean;
+  /**
+   * 真实执行 / 复用标记
+   */
+  reused: boolean;
+  /**
+   * 证书（执行失败时也落证书）
+   */
+  certificate: CriterionCertificate;
+};
+/**
+ * 计算判据指纹
+ *
+ * @param root - 仓库根绝对路径
+ * @param criterion - 判据
+ * @returns 64 位 hex 指纹
+ */
+declare function computeCriterionFingerprint(root: string, criterion: Criterion): string;
+/**
+ * 证书路径
+ *
+ * @param root - 仓库根绝对路径
+ * @param channel - 通道
+ * @param fingerprint - 指纹
+ * @returns 证书文件绝对路径
+ */
+declare function certificatePath(root: string, channel: string, fingerprint: string): string;
+/**
+ * 查找在册证书（只读）
+ *
+ * @param root - 仓库根绝对路径
+ * @param channel - 通道
+ * @param fingerprint - 指纹
+ * @returns 证书；缺席为 null
+ */
+declare function findCertificate(root: string, channel: string, fingerprint: string): CriterionCertificate | null;
+/**
+ * 执行判据并落证书（同指纹在册直接复用秒回）
+ *
+ * @param input - 执行入参
+ * @param input.root - 仓库根绝对路径
+ * @param input.criterion - 判据
+ * @param input.fingerprint - 预计算指纹（缺省现算）
+ * @returns 执行结果
+ */
+declare function runCriterionViaVault(input: RunCriterionInput): CriterionRunResult;
+/**
+ * 运行锁句柄
+ */
+type RunLockHandle = {
+  /**
+   * 释放锁（仅释放本进程写入的锁）
+   */
+  unlock: () => void;
+};
+/**
+ * 运行锁（防并行真跑互踩；进程退出自动释放）
+ *
+ * @param root - 仓库根绝对路径
+ * @returns 锁句柄（unlock 释放；持锁失败抛错）
+ * @throws {@link Error} 已有并行真跑持锁
+ */
+declare function acquireRunLock(root: string): RunLockHandle;
+//#endregion
+//#region src/close/verify-close.commands.d.ts
+/**
+ * 证据收口入参
+ */
+type EvidenceCloseInput = {
+  /**
+   * 仓库根绝对路径
+   */
+  root: string;
+  /**
+   * 解析后配置
+   */
+  config: LziIssuesConfig;
+  /**
+   * issue 文件仓库相对路径列表
+   */
+  files: readonly string[];
+  /**
+   * 显式概要（批量禁用）
+   */
+  summaryOverride?: string;
+  /**
+   * 只呈现不落盘
+   */
+  dryRun?: boolean;
+};
+/**
+ * 单案收口结果
+ */
+type CloseCaseResult = {
+  /**
+   * issue 文件仓库相对路径
+   */
+  file: string;
+  /**
+   * 是否翻绿成功
+   */
+  ok: boolean;
+  /**
+   * 结果说明（失败原因 / 概要）
+   */
+  message: string;
+  /**
+   * 幂等标记（已绿且概要一致零变更）
+   */
+  idempotent: boolean;
+};
+/**
+ * 批次收口结果
+ */
+type CloseBatchResult = {
+  /**
+   * 逐案结果
+   */
+  cases: CloseCaseResult[];
+  /**
+   * 成功案数
+   */
+  succeeded: number;
+  /**
+   * 门禁拦截标记（exit 2 语义；真跑模式未过两级门禁时为真，零执行）
+   */
+  gateBlocked: boolean;
+  /**
+   * 门禁拦截说明
+   */
+  gateMessage: string;
+};
+/**
+ * 证据收口批（缺省模式，零执行）
+ *
+ * @param input - 命令入参
+ * @param input.root - 仓库根绝对路径
+ * @param input.config - 解析后配置
+ * @param input.files - issue 文件仓库相对路径列表
+ * @param input.summaryOverride - 显式概要（批量禁用）
+ * @param input.dryRun - 只呈现不落盘
+ * @returns 批次结果
+ */
+declare function evidenceCloseFlow(input: EvidenceCloseInput): CloseBatchResult;
+/**
+ * 两级门禁判定结果
+ */
+type CloseGateResult = {
+  /**
+   * 是否拦截
+   */
+  blocked: boolean;
+  /**
+   * 拦截级（full 禁用级 / heavy 确认级 / none 通过）
+   */
+  kind: 'full' | 'heavy' | 'none';
+  /**
+   * 拦截说明
+   */
+  message: string;
+};
+/**
+ * 真跑两级门禁判定
+ *
+ * @param config - 解析后配置
+ * @param criteria - 判据列表
+ * @param allowFullCriterion - --allow-full-criterion 豁免
+ * @param confirmHeavy - --confirm-heavy 确认
+ * @returns 拦截结果（blocked=false 通过）
+ */
+declare function resolveCloseGates(config: LziIssuesConfig, criteria: readonly Criterion[], allowFullCriterion: boolean, confirmHeavy: boolean): CloseGateResult;
+/**
+ * 证书化真跑入参
+ */
+type RerunCloseInput = {
+  /**
+   * 仓库根绝对路径
+   */
+  root: string;
+  /**
+   * 解析后配置
+   */
+  config: LziIssuesConfig;
+  /**
+   * issue 文件仓库相对路径列表
+   */
+  files: readonly string[];
+  /**
+   * 显式判据（四段字符串列表，公共判据垫后）
+   */
+  explicitCriteria?: readonly string[];
+  /**
+   * 从各案 criteria 块取判据
+   */
+  criteriaFromIssue?: boolean;
+  /**
+   * 显式概要（批量禁用）
+   */
+  summaryOverride?: string;
+  /**
+   * 只呈现不执行不落盘
+   */
+  dryRun?: boolean;
+  /**
+   * 全量判据豁免（须留痕）
+   */
+  allowFullCriterion?: boolean;
+  /**
+   * 重度命令确认（仅人类明令）
+   */
+  confirmHeavy?: boolean;
+};
+/**
+ * 证书化真跑批（--rerun）
+ *
+ * @param input - 命令入参
+ * @param input.root - 仓库根绝对路径
+ * @param input.config - 解析后配置
+ * @param input.files - issue 文件仓库相对路径列表
+ * @param input.explicitCriteria - 显式判据（四段字符串列表，公共判据垫后）
+ * @param input.criteriaFromIssue - 从各案 criteria 块取判据
+ * @param input.summaryOverride - 显式概要（批量禁用）
+ * @param input.dryRun - 只呈现不执行不落盘（门禁拦截外的干跑）
+ * @param input.allowFullCriterion - 全量豁免
+ * @param input.confirmHeavy - 重度确认
+ * @returns 批次结果（gateBlocked=true 时零执行，exit 2 语义）
+ */
+declare function rerunCloseFlow(input: RerunCloseInput): CloseBatchResult;
+//#endregion
+//#region src/fs/mini-glob.utils.d.ts
+/**
+ * 自研 mini-glob 编译器（零第三方依赖）
+ *
+ * 语义（apex numbering-guard 同款）：单星→段内任意；双星后随分隔→任意层级
+ * 目录；双星非后随分隔→任意字符；`?`→段内单字符；`{a,b}`→段内多选一（候选
+ * 项可含通配）；字符类 `[` 与裸大括号显式抛错（不静默误配）；整串锚定匹配。
+ */
+/**
+ * mini-glob 编译错误
+ */
+declare class MiniGlobError extends Error {
+  /**
+   * 构造编译错误
+   *
+   * @param pattern - 涉事 glob 模式
+   * @param reason - 违规原因
+   */
+  constructor(pattern: string, reason: string);
+}
+/**
+ * 编译 glob 模式为整串锚定正则
+ *
+ * @param pattern - glob 模式
+ * @returns 整串 `^…$` 正则
+ * @throws {@link MiniGlobError} 模式含不支持语法
+ */
+declare function compileMiniGlob(pattern: string): RegExp;
+/**
+ * 判定候选路径是否命中 glob
+ *
+ * @param pattern - glob 模式
+ * @param candidate - 候选 posix 相对路径
+ * @returns 是否命中
+ * @throws {@link MiniGlobError} 模式含不支持语法
+ */
+declare function matchMiniGlob(pattern: string, candidate: string): boolean;
+//#endregion
+//#region src/fs/walk-surface.utils.d.ts
+/**
+ * 扫描面分层遍历基座
+ *
+ * include glob 反推最小目录前缀集（截断=保守超集，glob 可匹配路径必落某推导
+ * 前缀下）；前缀遍历宽容（缺前缀静默跳过=未来目录合法），全仓遍历严格（缺根
+ * 抛错防扫描面缩水）。剪枝：.git 恒跳过 / 排除 glob 整树剪枝 / 符号链接跳过；
+ * 文件名级零内容读取、零子进程、零网络；输出 posix 相对路径升序。
+ *
+ * 前缀约定：无尾斜杠的 posix 相对目录路径，'' 表示全仓根。
+ */
+/**
+ * 遍历选项
+ */
+type WalkOptions = {
+  /**
+   * 排除 glob 列表（目录命中即整树剪枝，按原相对路径 / 尾斜杠 / 子树三口径测试）
+   */
+  excludeGlobs?: readonly string[];
+};
+/**
+ * include glob 反推最小目录前缀集
+ *
+ * 末段恒为文件名模式不参与推导；字面段续推、通配段截断（截断=更短前缀=
+ * 覆盖超集）、`{a,b}` 分叉（候选项含通配即截断该分支）；任一模式贡献空前缀
+ * 则全仓标记（''）。候选去重后按包含关系裁剪（宽前缀吞并其下窄前缀）。
+ * 空模式集产出空前缀集（无扫描面）。
+ *
+ * @param includeGlobs - include glob 列表
+ * @returns 最小目录前缀集（无尾斜杠 posix 相对路径，'' 表示全仓）
+ */
+declare function deriveWalkPrefixes(includeGlobs: readonly string[]): string[];
+/**
+ * 前缀定向遍历（宽容：前缀目录缺失静默跳过——scope 登记未来目录属合法现状）
+ *
+ * @param root - 遍历根绝对路径
+ * @param prefixes - deriveWalkPrefixes 产物（'' 表示全仓）
+ * @param options - 遍历选项（排除 glob）
+ * @returns 命中文件相对路径列表（posix 升序）
+ */
+declare function walkFilesUnderPrefixes(root: string, prefixes: readonly string[], options?: WalkOptions): string[];
+/**
+ * 全仓严格遍历（缺根抛错，audit 防缩水口径）
+ *
+ * @param root - 遍历根绝对路径
+ * @param options - 遍历选项（排除 glob）
+ * @returns 命中文件相对路径列表（posix 升序）
+ * @throws {@link Error} 根目录缺失
+ */
+declare function walkFilesUnderRoots(root: string, options?: WalkOptions): string[];
+//#endregion
+//#region src/freeze/freeze.commands.d.ts
+/**
+ * freeze / unfreeze（裁定语硬门）
+ *
+ * 冻结/解冻均属人类裁定事项：--reason/--note 必须含「用户裁定」，工具拒绝形式
+ * 冻结/解冻；状态行含 `｜`（复合元信息行）拒绝整行破坏性替换；幂等（重复
+ * freeze 更新理由）；解冻仅对已冻结案生效，恢复 🔴。
+ */
+/**
+ * 裁定语硬门关键词
+ */
+declare const ADJUDICATION_KEYWORD = "用户裁定";
+/**
+ * freeze 命令入参
+ */
+type FreezeIssueInput = {
+  /**
+   * 仓库根绝对路径
+   */
+  root: string;
+  /**
+   * issue 文件仓库相对路径
+   */
+  file: string;
+  /**
+   * 裁定理由（须含「用户裁定」）
+   */
+  reason: string;
+};
+/**
+ * unfreeze 命令入参
+ */
+type UnfreezeIssueInput = {
+  /**
+   * 仓库根绝对路径
+   */
+  root: string;
+  /**
+   * issue 文件仓库相对路径
+   */
+  file: string;
+  /**
+   * 解冻注记（须含「用户裁定」）
+   */
+  note: string;
+};
+/**
+ * freeze / unfreeze 结果
+ */
+type FreezeResult = {
+  /**
+   * 操作成功标记
+   */
+  ok: boolean;
+  /**
+   * 结果说明
+   */
+  message: string;
+  /**
+   * 幂等标记
+   */
+  idempotent: boolean;
+};
+/**
+ * 执行冻结（幂等：重复调用更新理由）
+ *
+ * @param input - 命令入参
+ * @param input.root - 仓库根绝对路径
+ * @param input.file - issue 文件仓库相对路径
+ * @param input.reason - 裁定理由（须含「用户裁定」）
+ * @returns 操作结果
+ */
+declare function freezeIssue(input: FreezeIssueInput): FreezeResult;
+/**
+ * 执行解冻（仅对已冻结案生效）
+ *
+ * @param input - 命令入参
+ * @param input.root - 仓库根绝对路径
+ * @param input.file - issue 文件仓库相对路径
+ * @param input.note - 解冻注记（须含「用户裁定」）
+ * @returns 操作结果
+ */
+declare function unfreezeIssue(input: UnfreezeIssueInput): FreezeResult;
+//#endregion
+//#region src/health/health.commands.d.ts
+/**
+ * 巡检报告
+ */
+type HealthReport = {
+  /**
+   * 状态分布（状态归类 → 计数）
+   */
+  statusCounts: Record<string, number>;
+  /**
+   * 黄灯总数（含旧格式 legacy-yellow）
+   */
+  yellowTotal: number;
+  /**
+   * 最老黄灯账龄（天，mtime 口径向下取整；无黄灯为 0）
+   */
+  oldestYellowAgeDays: number;
+  /**
+   * A-B-C 分类分布
+   */
+  categoryCounts: Record<string, number>;
+};
+/**
+ * 分诊台账条目
+ */
+type TriageItem = {
+  /**
+   * issue 编号
+   */
+  id: string;
+  /**
+   * issue 文件仓库相对路径
+   */
+  file: string;
+  /**
+   * 状态归类
+   */
+  status: string;
+  /**
+   * 分类（A/B/C）
+   */
+  category: 'A' | 'B' | 'C';
+  /**
+   * 分类依据（中文说明）
+   */
+  reason: string;
+  /**
+   * 判据命令列表（空表示待补录）
+   */
+  criteriaCommands: string[];
+};
+/**
+ * 分诊台账文件结构
+ */
+type TriageLedgerFile = {
+  /**
+   * 生成时刻（毫秒）
+   */
+  generatedAtMs: number;
+  /**
+   * 参与扫描的注册表目录
+   */
+  registryDirs: string[];
+  /**
+   * 台账条目（黄灯）
+   */
+  items: TriageItem[];
+};
+/**
+ * 黄灯巡检命令入参
+ */
+type RunHealthInput = {
+  /**
+   * 仓库根绝对路径
+   */
+  root: string;
+  /**
+   * 解析后配置
+   */
+  config: LziIssuesConfig;
+  /**
+   * 限定注册表目录（缺省全部）
+   */
+  dirRels?: readonly string[];
+};
+/**
+ * 黄灯巡检
+ *
+ * @param input - 命令入参
+ * @returns 巡检报告
+ */
+declare function runHealth(input: RunHealthInput): HealthReport;
+/**
+ * 分诊命令入参
+ */
+type RunTriageInput = {
+  /**
+   * 仓库根绝对路径
+   */
+  root: string;
+  /**
+   * 解析后配置
+   */
+  config: LziIssuesConfig;
+  /**
+   * 台账输出目录覆盖（缺省 <root>/.lzi/issues/runs/ledger）
+   */
+  outDir?: string;
+};
+/**
+ * 分诊命令结果
+ */
+type RunTriageResult = {
+  /**
+   * 台账绝对路径
+   */
+  ledgerPath: string;
+  /**
+   * 台账对象
+   */
+  ledger: TriageLedgerFile;
+};
+/**
+ * 分诊台账落盘（append-only：triage-<时刻>.json 不覆盖历史）
+ *
+ * @param input - 命令入参
+ * @returns 台账绝对路径与台账对象
+ */
+declare function runTriage(input: RunTriageInput): RunTriageResult;
+//#endregion
+//#region src/parser/format.utils.d.ts
+/**
+ * issue 注册表格式单一真源
+ *
+ * 全部格式口径（文件名、状态行、处置段、criteria 围栏块、引用形态）的常量与判定
+ * 函数集中于此模块。读侧（解析器 / lint / 收口）与写侧（模板渲染 / 翻绿回填 / 冻结
+ * 写入）共用同一真源，杜绝两套口径漂移——该纪律经 apex-energy-turbo
+ * issue-verify-ledger 长期验证有效后迁移（其 registry.parser.ts 同构实现）。
+ */
+/**
+ * 注册表文件收集口径
+ *
+ * 3-4 位零填充数字前缀 + `-` + slug + `.md`；README 等不匹配文件天然不收编。
+ */
+declare const REGISTRY_FILE_PATTERN: RegExp;
+/**
+ * slug 合法字符集（单一真源）：仅 ASCII kebab——小写字母、数字、连字符，
+ * 禁中文与任何非 ASCII 字符（与契约层 SlugVO 口径一致）。
+ */
+declare const ASCII_KEBAB_SLUG_PATTERN: RegExp;
+/**
+ * 状态行前缀正则源（读写共用单一真源）
+ *
+ * 「状态」+ 可选 0-2 个粗体星号 + 可选空白 + 全/半角冒号。以源字符串形态导出，
+ * 写侧改写正则由本源动态构造，保证读/写口径永不分裂。
+ */
+declare const STATUS_LINE_PREFIX_SOURCE = "状态\\*{0,2}\\s*[：:]";
+/**
+ * 状态行定位正则（读侧使用，由前缀源构造）
+ */
+declare const STATUS_LINE_LOCATE_PATTERN: RegExp;
+/**
+ * 状态行定位扫描窗口（头部前 N 行）
+ */
+declare const STATUS_LINE_SCAN_LINES = 30;
+/**
+ * 挂起原因括注提取模式：全/半角括号内至少 4 字符
+ */
+declare const PENDING_REASON_PATTERN: RegExp;
+/**
+ * 处置段标题关键词
+ *
+ * `## ` 标题行包含本关键词即认定为处置段。
+ */
+declare const DISPOSITION_TITLE_KEYWORD = "处置结果";
+/**
+ * 处置段占位判定模式（读写共用单一真源）
+ *
+ * 「处置中 / 待回填」后须紧跟右括号 / 标点 / 破折号 / 行尾才计占位——占位是终态
+ * 标签，正文状语（如「处置中新核实的…」后为继续字符）不计。
+ */
+declare const DISPOSITION_PLACEHOLDER_PATTERN: RegExp;
+/**
+ * 处置段占位判定窗口（处置段标题起 N 行）
+ */
+declare const DISPOSITION_PLACEHOLDER_WINDOW_LINES = 8;
+/**
+ * 证据锚点块在位判定标记
+ *
+ * 两种收口形态的回填标题前缀：零执行证据收口 / 证书化真跑收口。
+ */
+declare const EVIDENCE_ANCHOR_MARKERS: readonly ['证据锚点（末次通过零执行收口', '判据执行证据（'];
+/**
+ * criteria 围栏块开栏行模式
+ */
+declare const CRITERIA_FENCE_OPEN_PATTERN: RegExp;
+/**
+ * criteria 围栏块闭栏行模式
+ */
+declare const CRITERIA_FENCE_CLOSE_PATTERN: RegExp;
+/**
+ * criteria 判据行 channel 段合法形态（字母数字起首，限字母数字与 . _ -）
+ */
+declare const CRITERIA_CHANNEL_PATTERN: RegExp;
+/**
+ * 元信息行「沿革」键：前序 issue 引用载体
+ */
+declare const HISTORY_LINE_KEY = "沿革";
+/**
+ * 元信息行「阻塞」键：阻塞关系引用载体（全部 🟢 后方可收口）
+ */
+declare const BLOCKING_LINE_KEY = "阻塞";
+/**
+ * 元信息行键定位前缀源
+ *
+ * 粗体标签（`**沿革**:`）与裸键（`沿革:`）两形态通吃；冒号全/半角均可。
+ */
+declare const META_LINE_PREFIX_SOURCE_TEMPLATE = "\\*{0,2}%s\\*{0,2}\\s*[：:]";
+/**
+ * issue 状态归类
+ *
+ * 规范五态（red / yellow / green / frozen / canceled）+ 旧格式变体
+ * （legacy-yellow / legacy-green，仅 --strict-legacy 计违规）+ 未知（unknown）。
+ */
+type IssueStatusKind = 'red' | 'yellow' | 'green' | 'frozen' | 'canceled' | 'legacy-yellow' | 'legacy-green' | 'unknown';
+/**
+ * 规范状态标签（写侧单一真源）
+ */
+declare const CANONICAL_STATUS_LABELS: Readonly<Record<'red' | 'yellow' | 'green' | 'frozen' | 'canceled', string>>;
+/**
+ * issue 引用 token 形态
+ *
+ * `number` 为 3-4 位编号；`slug` 为可空的不完整 slug 段（纯编号引用无 slug）。
+ */
+type IssueRefToken = {
+  /**
+   * 引用编号（3-4 位零填充）
+   */
+  number: string;
+  /**
+   * 引用 slug 段（纯编号引用时为 null）
+   */
+  slug: string | null;
+};
+/**
+ * issue 引用 token 提取模式
+ *
+ * 命中 markdown 链接 label 与纯文本两种形态：`[0035](./0035-xxx.md)` 与 `[0035]`，
+ * 以及行内代码中的不完整 slug 前缀 `[0035-slug-pre]` 形态。链接目标（第三捕获组）
+ * 作为 slug 兜底来源——label 只有编号时从目标文件名 `NNNN-slug.md` 反解 slug。
+ */
+declare const ISSUE_REF_TOKEN_PATTERN: RegExp;
+/**
+ * 从任意文本行提取 issue 引用 token 列表
+ *
+ * slug 解析优先级：label 内 slug 段 > 链接目标文件名 slug；两者皆无时为 null
+ * （纯编号引用）。
+ *
+ * @param text - 待提取文本（沿革/阻塞行内容、正文段落等）
+ * @returns 按出现顺序去重后的引用 token 列表
+ */
+declare function extractIssueRefTokens(text: string): IssueRefToken[];
+/**
+ * 构造元信息行键定位正则
+ *
+ * @param key - 元信息键（如「沿革」「阻塞」）
+ * @returns 行首锚定的键定位正则
+ */
+declare function buildMetaLineLocatePattern(key: string): RegExp;
+/**
+ * 状态行归类
+ *
+ * 归类优先级：已冻结 > 🔴 > ⚫ > 🟡 处理中 > 🟡（旧格式）> 🟢 已处置 > 🟢/✅（旧格式）>
+ * 未知。未识别形态归 unknown（与「无状态行」同判，lint 由 status-line-missing 拦截）。
+ *
+ * @param line - 状态行全文
+ * @returns 状态归类
+ */
+declare function classifyStatusLine(line: string): IssueStatusKind;
+//#endregion
+//#region src/parser/registry.parser.d.ts
+/**
+ * criteria 判据条目（一行一判据，四段竖线分隔）
+ */
+type ParsedCriterion = {
+  /**
+   * 判据标签（人类可读名）
+   */
+  label: string;
+  /**
+   * 判据通道（证书库的通道维度）
+   */
+  channel: string;
+  /**
+   * 判据工作目录（相对仓库根）
+   */
+  cwd: string;
+  /**
+   * 判据命令（退出码即判据）
+   */
+  command: string;
+};
+/**
+ * criteria 围栏块解析产物
+ */
+type ParsedCriteriaBlock = {
+  /**
+   * 概要行（唯一非空；缺席为 null）
+   */
+  summary: string | null;
+  /**
+   * 判据条目列表（至少一条）
+   */
+  criteria: ParsedCriterion[];
+};
+/**
+ * issue 文档解析产物（IssueDocRecord）
+ */
+type IssueDocRecord = {
+  /**
+   * 编号（文件名 3-4 位数字前缀）
+   */
+  id: string;
+  /**
+   * slug（文件名剥前缀与扩展名）
+   */
+  slug: string;
+  /**
+   * 文件名（basename）
+   */
+  file: string;
+  /**
+   * 标题（首个 `# ` 行内容；缺席为空串）
+   */
+  title: string;
+  /**
+   * 状态归类
+   */
+  status: IssueStatusKind;
+  /**
+   * 状态行全文（未定位为空串）
+   */
+  statusLine: string;
+  /**
+   * 状态行行号（1 起；未定位为 0）
+   */
+  statusLineNumber: number;
+  /**
+   * 挂起原因（状态行首个 ≥4 字括注；缺席为 null）
+   */
+  pendingReason: string | null;
+  /**
+   * 是否存在处置段标题
+   */
+  hasDispositionSection: boolean;
+  /**
+   * 处置段是否命中占位模式（标题起 8 行窗口）
+   */
+  dispositionIsPlaceholder: boolean;
+  /**
+   * 证据锚点块是否在位
+   */
+  hasEvidenceAnchorBlock: boolean;
+  /**
+   * criteria 围栏块解析产物（块在位且解析成功）
+   */
+  criteria: ParsedCriteriaBlock | null;
+  /**
+   * criteria 围栏块解析错误消息（块缺席为 null；多块/畸形带行号）
+   */
+  criteriaError: string | null;
+  /**
+   * 沿革引用 token 列表
+   */
+  historyRefs: IssueRefToken[];
+  /**
+   * 阻塞引用 token 列表
+   */
+  blockedByRefs: IssueRefToken[];
+  /**
+   * 文档全文
+   */
+  rawContent: string;
+  /**
+   * 文件 mtime（毫秒；账龄计算口径）
+   */
+  modifiedAtMs: number;
+};
+/**
+ * 注册表文件名解析产物
+ */
+type RegistryFileNameParts = {
+  /**
+   * 编号（3-4 位零填充）
+   */
+  id: string;
+  /**
+   * slug 段
+   */
+  slug: string;
+};
+/**
+ * 解析文件名为编号与 slug
+ *
+ * @param file - 文件名（basename）
+ * @returns 编号与 slug；不符合收集口径返回 null
+ */
+declare function parseRegistryFileName(file: string): RegistryFileNameParts | null;
+/**
+ * 解析 criteria 围栏块（宁可拒收不可猜）
+ *
+ * 全文必须单块唯一；`summary:` 唯一非空；判据行四段逐段非空、channel 合法、
+ * 段内禁多余竖线；块内至少一条判据。所有违规抛带行号错误。
+ *
+ * @param raw - 文档全文
+ * @returns 围栏块解析产物
+ * @throws {@link Error} 块缺席 / 多块 / 未闭合 / 行内违规（错误消息含行号）
+ */
+declare function parseCriteriaBlock(raw: string): ParsedCriteriaBlock;
+/**
+ * 解析单份 issue 文档
+ *
+ * @param file - 文件名（basename，用于编号与 slug 提取）
+ * @param raw - 文档全文
+ * @param modifiedAtMs - 文件 mtime（毫秒）
+ * @returns 解析产物（收集口径外的文件返回 null）
+ */
+declare function parseIssueDoc(file: string, raw: string, modifiedAtMs: number): IssueDocRecord | null;
+/**
+ * 扫描注册表目录
+ *
+ * 只收集口径内文件（NNNN-slug.md），逐份解析，按编号升序；目录缺席返回空数组；
+ * 单份读档失败降级为 unknown 最小形态（不中断批次，apex 同款语义）。
+ *
+ * @param registryDir - 注册表目录绝对或相对路径
+ * @returns 解析产物列表（编号升序）
+ */
+declare function scanRegistryDir(registryDir: string): IssueDocRecord[];
+//#endregion
+//#region src/lint/lint.core.d.ts
+/**
+ * lint 违规
+ */
+type LintViolation = {
+  /**
+   * issue 文件仓库相对 posix 路径
+   */
+  file: string;
+  /**
+   * 违规行号（0 = 全文级）
+   */
+  line: number;
+  /**
+   * 规则名
+   */
+  rule: string;
+  /**
+   * 人类可读违规消息
+   */
+  message: string;
+};
+/**
+ * lint 结果
+ */
+type LintResult = {
+  /**
+   * 违规列表（active + baseline-stale，按 file/rule 排序）
+   */
+  violations: LintViolation[];
+  /**
+   * 基线豁免计数（命中存量）
+   */
+  suppressed: number;
+  /**
+   * 基线条目总数
+   */
+  baselineCount: number;
+};
+/**
+ * 规则判定上下文
+ */
+type LintRuleContext = {
+  /**
+   * 仓库根绝对路径
+   */
+  root: string;
+  /**
+   * 所属 scope key
+   */
+  scopeKey: string;
+  /**
+   * 注册表目录（posix 相对）
+   */
+  registryDir: string;
+  /**
+   * 该注册表全部文件名集合（blocking 引用存在性判定）
+   */
+  registryBasenames: ReadonlySet<string>;
+  /**
+   * 解析后配置
+   */
+  config: LziIssuesConfig;
+};
+/**
+ * 单条规则（返回违规消息即违规；null 放行）
+ */
+type LintRule = {
+  /**
+   * 规则名（基线 (file, rule) 豁免键成分）
+   */
+  name: string;
+  /**
+   * 判定函数
+   *
+   * @param record - 解析产物
+   * @param ctx - 判定上下文
+   * @returns 违规消息；放行为 null
+   */
+  evaluate: (record: IssueDocRecord, ctx: LintRuleContext) => string | null;
+};
+/**
+ * 注册 lint 规则包（域规则扩展点；覆盖同名包）
+ *
+ * @param packId - 规则包 id（config lint.rulePacks 引用）
+ * @param rules - 规则列表
+ */
+declare function registerLintRulePack(packId: string, rules: readonly LintRule[]): void;
+/**
+ * 核心规则全集（13 条）
+ */
+declare const CORE_LINT_RULES: readonly LintRule[];
+/**
+ * lint 命令入参
+ */
+type RunLintInput = {
+  /**
+   * 仓库根绝对路径
+   */
+  root: string;
+  /**
+   * 解析后配置
+   */
+  config: LziIssuesConfig;
+  /**
+   * 限定注册表目录（缺省全部 scope）
+   */
+  dirRels?: readonly string[];
+  /**
+   * 是否跳过基线豁免（write-baseline 再生口径：全集违规）
+   */
+  ignoreBaseline?: boolean;
+};
+/**
+ * 运行 lint（核心规则 + 启用的规则包 + 棘轮基线三态）
+ *
+ * @param input - 命令入参
+ * @returns lint 结果（violations 非空即违规）
+ */
+declare function runLint(input: RunLintInput): LintResult;
+/**
+ * 全仓 sidecar 孤儿扫描辅助（orphan-sidecar 的目录级补充：边车存在而注册表无文件）
+ *
+ * @param root - 仓库根绝对路径
+ * @param config - 解析后配置
+ * @returns 孤儿边车违规列表
+ */
+declare function scanOrphanSidecars(root: string, config: LziIssuesConfig): LintViolation[];
+//#endregion
+//#region src/lint/lint-baseline.commands.d.ts
+/**
+ * 基线再生结果
+ */
+type WriteLintBaselineResult = {
+  /**
+   * 再生成功标记
+   */
+  ok: true;
+  /**
+   * 再生产物全文（整文件写回 lzi-issues.config.ts）
+   */
+  content: string;
+  /**
+   * 再生条目数
+   */
+  entryCount: number;
+} | {
+  /**
+   * 再生成功标记
+   */
+  ok: false;
+  /**
+   * 拒绝原因
+   */
+  error: string;
+};
+/**
+ * 基线再生命令入参
+ */
+type WriteLintBaselineInput = {
+  /**
+   * 仓库根绝对路径
+   */
+  root: string;
+  /**
+   * 解析后配置
+   */
+  config: LziIssuesConfig;
+  /**
+   * 收编指针（非空；作为新条目盖章）
+   */
+  issuePointer: string;
+};
+/**
+ * 基线再生命令核
+ *
+ * @param input - 命令入参
+ * @returns 再生结果
+ */
+declare function runWriteLintBaseline(input: WriteLintBaselineInput): WriteLintBaselineResult;
+/**
+ * 从 lint 违规导出基线条目（排序去重；测试与工具消费）
+ *
+ * @param violations - 违规列表
+ * @param issuePointer - 收编指针
+ * @returns 基线条目列表
+ */
+declare function deriveEntriesFromViolations(violations: readonly LintViolation[], issuePointer: string): LintBaselineEntry[];
+//#endregion
+//#region src/normalize/normalize-header.commands.d.ts
+/**
+ * normalize-header（方言头部迁移）
+ *
+ * 四种历史方言（单行管道引用行 / 粗体标签行 / `## 键: 值` 标题式 / `- ` 列表式）
+ * 解析后重排为裁定格式：粗体标签逐行 `**键**: 值`；字段规范序（FIELD_RANK）；
+ * 「主题」问题陈述迁正文首个节标题后；residual 原样保留。零丢失守卫：每字段
+ * 必须在产物文本在场否则 failed 不落盘；幂等（产物 === 原文 → unchanged）。
+ */
+/**
+ * 单文件迁移入参
+ */
+type NormalizeHeaderFileInput = {
+  /**
+   * 仓库根绝对路径
+   */
+  root: string;
+  /**
+   * issue 文件仓库相对路径
+   */
+  file: string;
+};
+/**
+ * 单文件迁移结果
+ */
+type NormalizeHeaderResult = {
+  /**
+   * issue 文件仓库相对路径
+   */
+  file: string;
+  /**
+   * 处置形态：rewritten / unchanged / skipped / failed
+   */
+  outcome: 'rewritten' | 'unchanged' | 'skipped' | 'failed';
+  /**
+   * 结果说明（failed 含原因；skipped 说明灯位缺失等）
+   */
+  message: string;
+};
+/**
+ * 迁移形态
+ */
+type NormalizeOutcome = 'rewritten' | 'unchanged' | 'skipped';
+/**
+ * 迁移产物
+ */
+type NormalizeResult = {
+  /**
+   * 产物全文
+   */
+  content: string;
+  /**
+   * 迁移形态
+   */
+  outcome: NormalizeOutcome;
+};
+/**
+ * 迁移单份文档头部
+ *
+ * @param raw - 文档全文
+ * @returns 迁移产物
+ */
+declare function normalizeHeader(raw: string): NormalizeResult;
+/**
+ * 迁移并落盘单份文档（守卫失败不落盘）
+ *
+ * @param input - 命令入参
+ * @param input.root - 仓库根绝对路径
+ * @param input.file - issue 文件仓库相对路径
+ * @returns 单文件迁移结果
+ */
+declare function normalizeHeaderFile(input: NormalizeHeaderFileInput): NormalizeHeaderResult;
+//#endregion
+//#region src/numbering/numbering.core.d.ts
+/**
+ * 编号门禁核心（纯函数，零 fs）
+ *
+ * apex numbering-guard 语义迁移：四类键型提取、取号（max+1 顺延跳已占与保留、
+ * 宽度随最大键）、五类违例扫描（目录=编号命名空间）、slug 数字策略、覆盖面
+ * 审计。文件系统编排由 numbering.commands 承担，本模块可独立测试。
+ */
+/**
+ * 编号键规则（判别联合；v1 issues 注册表固定 numericPrefix，其余键型供通用引擎使用）
+ */
+type NumberingKeyRule = {
+  kind: 'numericPrefix';
+} | {
+  kind: 'compositePrefix';
+  groups: number;
+} | {
+  kind: 'numericSuffix';
+} | {
+  kind: 'customPattern';
+  pattern: string;
+};
+/**
+ * 编号违例种类
+ */
+type NumberingFindingKind = 'duplicate' | 'reservedOccupied' | 'widthInconsistent' | 'allowlistStale' | 'slugContainsDigit' | 'slugDigitAllowlistStale';
+/**
+ * 编号违例
+ */
+type NumberingFinding = {
+  /**
+   * 违例种类
+   */
+  kind: NumberingFindingKind;
+  /**
+   * 所属 scope（slugDigitAllowlistStale 为 'global'）
+   */
+  scopeKey: string;
+  /**
+   * 人类可读违例消息（含文件清单与处置指引）
+   */
+  message: string;
+};
+/**
+ * 审计违例种类
+ */
+type NumberingAuditFindingKind = 'coverageGap' | 'pendingStale';
+/**
+ * 审计违例
+ */
+type NumberingAuditFinding = {
+  /**
+   * 违例种类
+   */
+  kind: NumberingAuditFindingKind;
+  /**
+   * 人类可读违例消息
+   */
+  message: string;
+};
+/**
+ * 编号豁免条目（引擎消费形态；files 为仓库相对 posix 路径，精确文件集）
+ */
+type NumberingAllowlistEntry = {
+  /**
+   * 所属 scope key
+   */
+  scopeKey: string;
+  /**
+   * 豁免编号
+   */
+  number: string;
+  /**
+   * 精确文件集（排序后与磁盘对照）
+   */
+  files: string[];
+  /**
+   * 棘轮状态
+   */
+  status: string;
+  /**
+   * 豁免理由
+   */
+  reason: string;
+};
+/**
+ * 提取文件名编号键
+ *
+ * 提不出键的文件（README 等）返回 null，天然不占号。
+ *
+ * @param basename - 文件名
+ * @param rule - 键规则
+ * @returns 编号键原文；无键为 null
+ */
+declare function extractFileKey(basename: string, rule: NumberingKeyRule): string | null;
+/**
+ * 提取键的前导数值
+ *
+ * @param key - 编号键
+ * @returns 前导数值；非数字键为 null
+ */
+declare function keyLeadingNumber(key: string): number | null;
+/**
+ * 取号入参
+ */
+type NextNumberInput = {
+  /**
+   * 扫描面文件名列表（键提取口径占号）
+   */
+  basenames: readonly string[];
+  /**
+   * 键规则
+   */
+  rule: NumberingKeyRule;
+  /**
+   * 保留号列表（不回收复用）
+   */
+  reserved: readonly string[];
+};
+/**
+ * 取号结果
+ */
+type NextNumberResult = {
+  ok: true;
+  number: string;
+  skippedOccupied: number;
+  skippedReserved: number;
+} | {
+  ok: false;
+  error: string;
+};
+/**
+ * 取号：max+1 起顺延，跳过磁盘已占与保留号，取首个空闲
+ *
+ * 宽度 = 数值最大键的字符串长度（零填充跟随现行形态）；空范围拒绝取号（无法
+ * 推断位数，人工定号）。
+ *
+ * @param input - 取号入参
+ * @returns 取号结果
+ */
+declare function computeNextNumber(input: NextNumberInput): NextNumberResult;
+/**
+ * 提取文件名 slug 段（剥前缀键 + 单个分隔符 + 最后一个扩展名）
+ *
+ * 空.slug 放行（返回空串）；非前缀数字形态返回 null（不属判定面）。
+ *
+ * @param basename - 文件名
+ * @returns slug 段；非判定面为 null
+ */
+declare function extractSlugSegment(basename: string): string | null;
+/**
+ * 违例扫描入参（单 scope）
+ */
+type ScopeScanInput = {
+  /**
+   * scope key
+   */
+  scopeKey: string;
+  /**
+   * 扫描面文件名列表
+   */
+  basenames: readonly string[];
+  /**
+   * 键规则
+   */
+  rule: NumberingKeyRule;
+  /**
+   * 保留号（含理由，报文引用）
+   */
+  reserved: ReadonlyArray<{
+    number: string;
+    reason: string;
+  }>;
+  /**
+   * 该 scope 的豁免条目（files 为仓库相对 posix 路径）
+   */
+  allowlist: readonly NumberingAllowlistEntry[];
+  /**
+   * slug 数字策略（'forbid' 启用判定）
+   */
+  slugDigitPolicy?: 'forbid';
+  /**
+   * slug 数字白名单 glob（仓库相对路径命中豁免）
+   */
+  slugDigitAllowlist: readonly string[];
+  /**
+   * 文件仓库相对路径构造器（slug 白名单匹配口径）
+   */
+  toRepoRelative: (basename: string) => string;
+  /**
+   * 全量档标记（true 时追加 slug 白名单失效对账）
+   */
+  fullMode: boolean;
+};
+/**
+ * 单 scope 违例扫描（目录=编号命名空间）
+ *
+ * 判定顺序：先撞号组（豁免须排序文件集双向相等精确覆盖）后保留号；全部组判
+ * 完后逐豁免条目对账（棘轮只许缩短）。
+ *
+ * @param input - 扫描入参
+ * @returns 违例列表
+ */
+declare function scanScopeForFindings(input: ScopeScanInput): NumberingFinding[];
+/**
+ * 覆盖面审计入参
+ */
+type AuditCoverageInput = {
+  /**
+   * 全仓扫描面文件列表（posix 相对路径，已过全局排除）
+   */
+  files: readonly string[];
+  /**
+   * 形似编号筛选模式（作用于 basename）
+   */
+  numberishPattern: string;
+  /**
+   * 已登记注册表目录列表（文件落于其下即被 scope 收编）
+   */
+  registryDirs: readonly string[];
+  /**
+   * pending 探针列表（glob + 理由；命中即视为已规划覆盖）
+   */
+  pending: ReadonlyArray<{
+    glob: string;
+    reason: string;
+  }>;
+};
+/**
+ * 覆盖面审计：形似编号文件必须被 scope / 排除 / pending 三者之一覆盖
+ *
+ * 未覆盖按目录聚合为 coverageGap；pending 未命中计 pendingStale。
+ *
+ * @param input - 审计入参
+ * @returns 审计违例列表
+ */
+declare function auditCoverage(input: AuditCoverageInput): NumberingAuditFinding[];
+//#endregion
+//#region src/numbering/numbering.commands.d.ts
+/**
+ * issues 注册表键规则（数字前缀；v1 注册表固定形态）
+ */
+declare const ISSUES_KEY_RULE: NumberingKeyRule;
+/**
+ * 取号命令结果
+ */
+type NumberingNextResult = {
+  /**
+   * 取号成功标记
+   */
+  ok: true;
+  /**
+   * 下一可用编号（零填充）
+   */
+  number: string;
+  /**
+   * 取号目标描述（scope key 或目录）
+   */
+  target: string;
+  /**
+   * 跳过的已占用号数
+   */
+  skippedOccupied: number;
+  /**
+   * 跳过的保留号数
+   */
+  skippedReserved: number;
+} | {
+  /**
+   * 取号成功标记
+   */
+  ok: false;
+  /**
+   * 失败原因
+   */
+  error: string;
+};
+/**
+ * 检查命令结果
+ */
+type NumberingCheckResult = {
+  /**
+   * 违例列表（空 = 通过）
+   */
+  findings: NumberingFinding[];
+  /**
+   * 参与判定的 scope 数
+   */
+  scopeCount: number;
+  /**
+   * 扫描面文件数
+   */
+  scannedFiles: number;
+};
+/**
+ * 审计命令结果
+ */
+type NumberingAuditResult = {
+  /**
+   * 违例列表（空 = 通过）
+   */
+  findings: NumberingAuditFinding[];
+  /**
+   * 全仓扫描面文件数
+   */
+  scannedFiles: number;
+};
+/**
+ * 取号命令入参
+ */
+type NumberingNextCommandInput = {
+  /**
+   * 仓库根绝对路径
+   */
+  root: string;
+  /**
+   * 解析后配置
+   */
+  config: LziIssuesConfig;
+  /**
+   * 目标 scope key（与 dirRel 互斥）
+   */
+  scopeKey?: string;
+  /**
+   * 目标注册表目录（posix 相对，与 scopeKey 互斥）
+   */
+  dirRel?: string;
+};
+/**
+ * 取号命令核（只读不写；编号写入时刻确定——落盘前重跑取最新值）
+ *
+ * @param input - 命令入参
+ * @returns 取号结果
+ */
+declare function runNumberingNext(input: NumberingNextCommandInput): NumberingNextResult;
+/**
+ * 检查命令入参
+ */
+type NumberingCheckCommandInput = {
+  /**
+   * 仓库根绝对路径
+   */
+  root: string;
+  /**
+   * 解析后配置
+   */
+  config: LziIssuesConfig;
+  /**
+   * 目录增量档目标（缺省全量档）
+   */
+  dirRel?: string;
+};
+/**
+ * 检查命令核（全量档 / 目录增量档）
+ *
+ * 目录增量档：只判覆盖 scope，豁免按目录过滤（防其他目录条目误判 stale），
+ * 不跑 slug 白名单失效对账（扫描面不完整防假阳性）。
+ *
+ * @param input - 命令入参
+ * @returns 检查结果
+ */
+declare function runNumberingCheck(input: NumberingCheckCommandInput): NumberingCheckResult;
+/**
+ * 审计命令入参
+ */
+type NumberingAuditCommandInput = {
+  /**
+   * 仓库根绝对路径
+   */
+  root: string;
+  /**
+   * 解析后配置
+   */
+  config: LziIssuesConfig;
+};
+/**
+ * 审计命令核（全仓严格遍历防逃逸；审计根缺失抛错防扫描面缩水）
+ *
+ * @param input - 命令入参
+ * @returns 审计结果
+ * @throws {@link Error} 审计根缺失
+ */
+declare function runNumberingAudit(input: NumberingAuditCommandInput): NumberingAuditResult;
+//#endregion
+//#region src/parser/guide-fixture.utils.d.ts
+/**
+ * 格式指南夹具工具（零漂移守卫的切片面）
+ *
+ * 格式真源指南（docs/guides/issue-file-format.md）内的活样板以 HTML 注释标记
+ * 圈定边界；本模块负责定位指南文件、切片活样板，供测试与渲染器比对——
+ * 「写指南即写测试，改解析器必改指南」（apex guide-fixture 同款机制）。
+ */
+/**
+ * 活样板起点标记
+ */
+declare const GUIDE_FIXTURE_START_MARK = "<!-- issue-file-format-fixture:start -->";
+/**
+ * 活样板终点标记
+ */
+declare const GUIDE_FIXTURE_END_MARK = "<!-- issue-file-format-fixture:end -->";
+/**
+ * 格式指南相对项目根路径
+ */
+declare const ISSUE_FILE_FORMAT_GUIDE_RELATIVE = "docs/guides/issue-file-format.md";
+/**
+ * 定位格式指南绝对路径
+ *
+ * 从本模块运行位置逐级向上查找 `docs/guides/issue-file-format.md`（源码运行与
+ * dist 构建产物两种位置均可命中；上限 10 层防失控上溯）。
+ *
+ * @returns 指南绝对路径
+ * @throws {@link Error} 超出查找上限仍未命中
+ */
+declare function locateIssueFileFormatGuide(): string;
+/**
+ * 读取格式指南全文
+ *
+ * @returns 指南全文
+ */
+declare function loadIssueFileFormatGuide(): string;
+/**
+ * 切片指南活样板
+ *
+ * @param guide - 指南全文
+ * @returns 起终点标记之间的活样板文本（去首尾空白行）
+ * @throws {@link Error} 标记缺席或次序颠倒（显式抛错，不静默返回空）
+ */
+declare function sliceGuideFixtureSample(guide: string): string;
+//#endregion
+//#region src/template/issue-template.renderer.d.ts
+/**
+ * issue 标准模板渲染器（唯一真源）
+ *
+ * 标准格式三路共用本渲染器：template 命令（skeleton 骨架展示）、create 建档
+ * （instance 实际值骨架）、init 注册表 README 存根。正文四段占位文本以常量形态
+ * 由两种模式共享，结构漂移在构造上不可能发生；指南活样板与骨架的逐字一致由
+ * guide-fixture 测试守卫（零漂移五环之一）。
+ */
+/**
+ * issue 优先级（模板口径）
+ */
+type IssueTemplatePriority = 'P1' | 'P2' | 'P3';
+/**
+ * 模板引用形态（沿革 / 阻塞行的引用条目）
+ */
+type IssueTemplateRef = {
+  /**
+   * 引用编号（3-4 位零填充）
+   */
+  number: string;
+  /**
+   * 引用完整 slug（缺席时渲染为纯编号引用）
+   */
+  slug?: string;
+};
+/**
+ * instance 模式渲染入参
+ */
+type IssueTemplateValues = {
+  /**
+   * 编号（4 位零填充，编号门禁取号分配）
+   */
+  number: string;
+  /**
+   * slug（kebab-case，默认禁数字）
+   */
+  slug: string;
+  /**
+   * 一句话标题（问题是什么，禁笼统词）
+   */
+  title: string;
+  /**
+   * 优先级
+   */
+  priority: IssueTemplatePriority;
+  /**
+   * 所属域（config 登记的 scope title）
+   */
+  scopeTitle: string;
+  /**
+   * 立案日期（YYYY-MM-DD）
+   */
+  date: string;
+  /**
+   * 来源（问题原文出处 + 日期）
+   */
+  source: string;
+  /**
+   * 沿革引用（缺席时省略沿革行）
+   */
+  historyRefs?: IssueTemplateRef[];
+  /**
+   * 阻塞引用（缺席时省略阻塞行；全部 🟢 后方可收口）
+   */
+  blockedByRefs?: IssueTemplateRef[];
+};
+/**
+ * 渲染标准模板骨架（skeleton 模式）
+ *
+ * 占位符形态，供 template 命令展示与指南活样板消费。
+ *
+ * @returns 骨架全文（以单个换行结尾）
+ */
+declare function renderIssueTemplateSkeleton(): string;
+/**
+ * 渲染标准模板实例（instance 模式）
+ *
+ * 头部元信息代入实际值；沿革 / 阻塞行按入参省略或渲染；正文四段保留占位指导
+ * 文本（建档即骨架，内容随治理进展回填——apex 同款语义）。
+ *
+ * @param values - 实际值入参
+ * @returns 可直接落盘的 issue 文档全文（以单个换行结尾）
+ */
+declare function renderIssueTemplate(values: IssueTemplateValues): string;
+/**
+ * 渲染 criteria 判据块示例（template --with-criteria 附带）
+ *
+ * 示例本身为解析器合法形态（照抄即通过机检），字段说明以 `#` 注释行承载。
+ *
+ * @returns 判据块示例全文
+ */
+declare function renderCriteriaBlockExample(): string;
+/**
+ * 渲染注册表 README 格式存根（init 命令落盘）
+ *
+ * 一页式格式速览：建档入口、状态行五态、正文四段；完整规范指向格式真源指南。
+ *
+ * @param scopeTitle - scope 人类可读名
+ * @param guideRelPath - 格式指南相对本注册表目录的路径（如 `../../docs/guides/issue-file-format.md`）
+ * @returns README 存根全文
+ */
+declare function renderRegistryReadmeStub(scopeTitle: string, guideRelPath: string): string;
+/**
+ * 模板字段说明条目（template --format json 载荷）
+ */
+type TemplateFieldDoc = {
+  /**
+   * 字段名（渲染入参名或元信息键）
+   */
+  name: string;
+  /**
+   * 是否必填
+   */
+  required: boolean;
+  /**
+   * 字段说明
+   */
+  description: string;
+};
+/**
+ * 标准模板字段说明全集（供 agent / 使用者程序化消费）
+ */
+declare const TEMPLATE_FIELDS: readonly TemplateFieldDoc[];
+//#endregion
+//#region src/triage/triage.classify.d.ts
+/**
+ * 分诊类别
+ */
+type TriageCategory = 'A' | 'B' | 'C';
+/**
+ * 分诊结果
+ */
+type TriageClassification = {
+  /**
+   * 类别
+   */
+  category: TriageCategory;
+  /**
+   * 分类依据（中文说明）
+   */
+  reason: string;
+};
+/**
+ * 黄灯分诊分类
+ *
+ * @param record - 解析产物
+ * @returns 分诊结果
+ */
+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 };