@longzai-intelligence-issues/ledger 0.0.1 → 0.0.3

package/src/parser/format.utils.ts

@@ -131,6 +131,82 @@ export const CANONICAL_STATUS_LABELS: Readonly<
   canceled: '⚫ 已取消',
 };
 
+/**
+ * pre-emoji 存量状态词表（写侧迁移单一真源）
+ *
+ * 读侧归类（classifyStatusLine）不消费本词表——旧词表形态归 unknown 由 lint
+ * status-line-missing 拦截，迁移经由 migrate-legacy 写侧规范化后回归规范五态，
+ * 避免为读侧新增 legacy-red 等形态破坏 IssueStatus 契约面。
+ */
+export const LEGACY_STATUS_VOCABULARY: Readonly<{
+  /**
+   * 绿系词（历史已结案标记）
+   */
+  green: readonly string[];
+
+  /**
+   * 红系词（历史待办标记）
+   */
+  red: readonly string[];
+
+  /**
+   * 延期系词（已登记（延期）族——迁移默认回红灯并保留延期说明）
+   */
+  deferred: readonly string[];
+
+  /**
+   * 取消系词
+   */
+  canceled: readonly string[];
+
+  /**
+   * 进行系词（黄灯候选）
+   */
+  inProgress: readonly string[];
+
+  /**
+   * 冻结系词（不迁移——冻结唯一合法写入路径是 freeze 命令）
+   */
+  frozen: readonly string[];
+}> = {
+  green: [
+    '已解决',
+    '已修复',
+    '已治理',
+    '已处理',
+    '已处置',
+    '已完成',
+    '已闭合',
+    '已消解',
+    '已闭环',
+    '已清治',
+    '已收口',
+    '已根治',
+    '已终态',
+    '已裁决',
+    '已决策',
+    '已验证',
+    '已全部清治',
+    '全量完成',
+    '终态达成',
+  ],
+  red: [
+    '未处理',
+    '待处理',
+    '待治理',
+    '待修复',
+    '未修复',
+    '待验证',
+    '待评估',
+    '紧急',
+    '已立项待治理',
+  ],
+  deferred: ['已登记'],
+  canceled: ['已取消'],
+  inProgress: ['处理中', '进行中'],
+  frozen: ['已冻结'],
+};
+
 /**
  * issue 引用 token 形态
  *

package/src/parser/registry.parser.ts

@@ -497,6 +497,14 @@ export function parseIssueDoc(
      */
     const line = lines[index] ?? '';
 
+    /**
+     * 标题行跳过（标题正文可含「连接状态：」类词组——如 printer 刷屏案
+     * 标题，非元信息状态行；命中会吞掉后续真状态行致 status-line-missing）
+     */
+    if (line.startsWith('#')) {
+      continue;
+    }
+
     if (STATUS_LINE_LOCATE_PATTERN.test(line)) {
       statusLine = line.trim();
       statusLineNumber = index + 1;

package/src/template/issue-template.renderer.ts

@@ -241,13 +241,24 @@ export function renderCriteriaBlockExample(): string {
 /**
  * 渲染注册表 README 格式存根（init 命令落盘）
  *
- * 一页式格式速览：建档入口、状态行五态、正文四段；完整规范指向格式真源指南。
+ * 一页式格式速览：建档入口、状态行五态、正文四段；完整规范指向格式真源指南
+ * （采用仓不携带指南文件时回退机器真源提示，不落死链）。
  *
  * @param scopeTitle - scope 人类可读名
- * @param guideRelPath - 格式指南相对本注册表目录的路径（如 `../../docs/guides/issue-file-format.md`）
+ * @param guideRelPath - 格式指南相对本注册表目录的路径；指南不在采用仓时为 null
  * @returns README 存根全文
  */
-export function renderRegistryReadmeStub(scopeTitle: string, guideRelPath: string): string {
+export function renderRegistryReadmeStub(scopeTitle: string, guideRelPath: string | null): string {
+  /**
+   * 指南指引行（链接形态或机器真源回退形态）
+   */
+  const guideLine =
+    guideRelPath === null
+      ? '- 标准模板：`lzi-issues template`（字段契约 `--format json`）；完整格式规范见 lzi-issues 仓 docs/guides/issue-file-format.md（本仓未携带指南文件，不落链接）'
+      : '- 标准模板：`lzi-issues template`；完整格式规范：[issue-file-format](' +
+        guideRelPath +
+        ')';
+
   return [
     `# ${scopeTitle} issue 注册表`,
     '',
@@ -256,7 +267,7 @@ export function renderRegistryReadmeStub(scopeTitle: string, guideRelPath: strin
     '## 建档',
     '',
     '- `lzi-issues create --title <标题> --scope <key>`（编号走门禁取号，禁止手工定号）',
-    '- 标准模板：`lzi-issues template`；完整格式规范：[issue-file-format](' + guideRelPath + ')',
+    guideLine,
     '',
     '## 状态行（处理情况第一入口）',
     '',