@longzai-intelligence-issues/cli 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# 更新日志
+
+本项目的所有重要更改都将记录在此文件中。
+
+格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
+本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [0.0.1] - 2026-09-14
+
+### 新增
+
+- 新增 apps/cli（bin lzi-issues）：init/template/create/list/show/lint/numbering(next|check|audit)/docs check/verify-close/freeze/unfreeze/normalize-header/health/triage/prompts 全命令面（ADR-0049 壳，退出码 0/1/2）
+
+### 变更
+
+- create 建档 slug 强制 ASCII kebab 校验：派生非法（如纯中文标题）即拒绝并要求显式 --slug

package/README.md

@@ -0,0 +1,33 @@
+# @longzai-intelligence-issues/cli
+
+lzi-issues 命令行应用（bin: `lzi-issues`），把 ledger 引擎与配置包的判定能力组装为可直接使用的工具面：初始化接入、标准模板提供、建档取号、门禁检查、收口冻结与巡检观测。
+
+## 意图
+
+让使用者在任意项目内零服务器零数据库地使用文件化 issue 注册表：一条 `init` 完成接入（配置生成/追加 + 注册表目录 + 格式存根），一条 `create` 完成建档（门禁取号 + 标准模板落盘 + 编号自检），门禁与收口命令的退出码即可作为机器判据接入合入检查。
+
+## 定位
+
+位于 `longzai-intelligence-issues` 项目 `apps/cli`，是应用层（ADR-0049 CLI 壳：`@longzai-intelligence-cli/core` 的 createCli + defineCommand + zod，禁直引 commander）。向下依赖 `@longzai-intelligence-issues/config`（配置加载）与 `@longzai-intelligence-issues/ledger`（全部判定内核）；与 domains/issues 的存储策略装配（createIssuesStorage）互不依赖——CLI 的门禁命令直接面向注册表文件（files 形态），平台管理面走 web/API。
+
+## 职能
+
+命令面（退出码口径：0 通过 / 1 违规 / 2 门禁拦截零执行；违规与错误走 stderr、过程信息走 stdout）：
+
+- 接入与格式：`init`（生成或追加 lzi-issues.config.ts、创建注册表目录并落 README 格式存根，幂等）、`template`（输出标准模板全文，`--format json` 返回字段契约，`--with-criteria` 附判据块示例）。
+- 建档与查询：`create`（写入时刻取号 → 模板渲染 → 目录缺席自创建 → 落盘 → numbering check 自检）、`list`（按 scope 分组）、`show <ref>`（编号 / 编号-slug / 不完整前缀三形态，多义列候选）。
+- 门禁与观测：`lint`（13 规则 + 棘轮基线三态，`--write-baseline --issue` 拒绝扩基线再生）、`numbering next|check|audit`、`docs check`（文档引用检查，`--write-baseline` 再生）、`health`（JSON 巡检）、`triage`（append-only 台账）。
+- 收口与冻结：`verify-close`（缺省零执行证据收口；`--rerun` 证书化真跑，`--confirm-heavy` / `--allow-full-criterion` 两级门禁豁免须留痕）、`freeze` / `unfreeze`（裁定语硬门）、`normalize-header`（方言迁移零丢失）、`prompts list|show`（推荐提示词）。
+
+快速开始：
+
+```bash
+bun ./apps/cli/dist/index.js init --key root --title "项目全局"
+bun ./apps/cli/dist/index.js template
+bun ./apps/cli/dist/index.js create --title "<一句话标题>" --scope root
+bun ./apps/cli/dist/index.js lint && bun ./apps/cli/dist/index.js numbering check
+```
+
+## 实现情况
+
+已实现全部 15 个命令（init / template / create / list / show / lint / numbering×3 / docs check / verify-close / freeze / unfreeze / normalize-header / health / triage / prompts），构建产物经 smoke 验证（--help、template 输出、错误路径、试点全流程 init→create→双零门禁→list）；lint / typecheck / build 门禁通过；建档 slug 强制 ASCII kebab（中文标题须显式 --slug）。命令级自动化测试（含 KNOWN_FLAGS 指南零漂移断言）与格式指南 §七 的旗标清单对齐后补齐。

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+import "./rolldown-runtime-DCIJsbUY.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+import"./rolldown-runtime-DCIJsbUY.js";import{createCli as e,defineCommand as t}from"@longzai-intelligence-cli/core";import{clackInteraction as n,picocolorsColor as r}from"@longzai-intelligence-cli/standard";import{TEMPLATE_FIELDS as i,evidenceCloseFlow as a,freezeIssue as o,listPrompts as s,normalizeHeaderFile as c,renderCriteriaBlockExample as l,renderIssueTemplate as u,renderIssueTemplateSkeleton as d,renderRegistryReadmeStub as f,rerunCloseFlow as p,runDocsCheck as m,runHealth as h,runLint as g,runNumberingAudit as _,runNumberingCheck as v,runNumberingNext as y,runTriage as b,runWriteDocsBaseline as x,runWriteLintBaseline as S,scanRegistryDir as C,showPrompt as w,unfreezeIssue as T}from"@longzai-intelligence-issues/ledger";import*as E from"zod";import{appendScopeToConfigText as D,loadLziIssuesConfig as O,renderConfigScaffoldFile as k}from"@longzai-intelligence-issues/config";import{join as A,relative as j,resolve as M}from"node:path";import{existsSync as N,mkdirSync as P,readFileSync as F,writeFileSync as I}from"node:fs";function L(){return M(process.cwd())}async function R(e){let t=await O(e===void 0?{}:{configPath:e});return t.ok||(process.stderr.write(`错误: ${t.reason}\n`),process.exit(1)),{config:t.config,configFilePath:t.configFilePath}}function z(e){process.stdout.write(`[INFO] ${e}\n`)}function B(e){process.stdout.write(`[SUCCESS] ${e}\n`)}function V(e){process.stdout.write(`${e}\n`)}function H(e){process.stderr.write(`错误: ${e}\n`),process.exit(1)}function U(e,t){let n=null,r=-1;for(let i of e.scopes)for(let e of i.paths)(e===`.`||e===``||t===e||t.startsWith(`${e}/`))&&e.length>r&&(n=i.key,r=e.length);return n}function W(e){t(e,{name:`verify-close`,description:`issue 收口（缺省零执行证据收口；--rerun 证书化真跑）`,options:[{flags:`--issue <issue>`,description:`issue 文件路径（可重复）`},{flags:`--summary <summary>`,description:`收口概要（批量禁用）`},{flags:`--dry-run`,description:`只呈现不落盘/不执行`},{flags:`--rerun`,description:`证书化真跑（重度命令，仅人类明令）`},{flags:`--criterion <criterion>`,description:`显式判据 label|channel|cwd|command（可重复）`},{flags:`--criteria-from-issue`,description:`从各案 criteria 块取判据`},{flags:`--confirm-heavy`,description:`重度命令确认`},{flags:`--allow-full-criterion`,description:`全量判据豁免（须留痕）`},{flags:`--config <path>`,description:`显式配置路径`}],schema:E.object({issue:E.union([E.string(),E.array(E.string())]).optional(),summary:E.string().optional(),dryRun:E.boolean().optional(),rerun:E.boolean().optional(),criterion:E.union([E.string(),E.array(E.string())]).optional(),criteriaFromIssue:E.boolean().optional(),confirmHeavy:E.boolean().optional(),allowFullCriterion:E.boolean().optional(),config:E.string().optional()}).passthrough(),action:async e=>{let t=L(),{config:n}=await R(e.config),r=e.issue===void 0?[]:Array.isArray(e.issue)?e.issue:[e.issue];r.length===0&&H(`缺少 --issue <路径>（可重复指定批量）`);let i=e.criterion===void 0?[]:Array.isArray(e.criterion)?e.criterion:[e.criterion];if(e.rerun===!0){let a=p({root:t,config:n,files:r,explicitCriteria:i,criteriaFromIssue:e.criteriaFromIssue===!0,summaryOverride:r.length===1?e.summary:void 0,dryRun:e.dryRun===!0,allowFullCriterion:e.allowFullCriterion===!0,confirmHeavy:e.confirmHeavy===!0});a.gateBlocked&&(process.stdout.write(`${a.gateMessage}\n`),process.exit(2));for(let e of a.cases)V(`${e.file}: ${e.ok?`通过`:`失败`}——${e.message}`);z(`批次收口汇总：${a.succeeded}/${a.cases.length} 案翻绿`),a.succeeded<a.cases.length&&process.exit(1);return}(i.length>0||e.criteriaFromIssue===!0||e.confirmHeavy===!0||e.allowFullCriterion===!0)&&H(`证据收口（缺省模式）不接受 --criterion/--criteria-from-issue/--confirm-heavy/--allow-full-criterion（属 --rerun 真跑旗标）`);let o=a({root:t,config:n,files:r,summaryOverride:r.length===1?e.summary:void 0,dryRun:e.dryRun===!0});for(let e of o.cases)V(`${e.file}: ${e.ok?`通过`:`失败`}——${e.message}`);z(`批次证据收口汇总：${o.succeeded}/${o.cases.length} 案翻绿（全程零命令执行）`),o.succeeded<o.cases.length&&process.exit(1)}}),t(e,{name:`freeze`,description:`冻结 issue（--reason 须含「用户裁定」）`,options:[{flags:`--issue <issue>`,description:`issue 文件路径`},{flags:`--reason <reason>`,description:`裁定理由（须含「用户裁定」）`},{flags:`--config <path>`,description:`显式配置路径`}],schema:E.object({issue:E.string().optional(),reason:E.string().optional(),config:E.string().optional()}).passthrough(),action:async e=>{let t=L();await R(e.config),(e.issue===void 0||e.reason===void 0)&&H(`freeze 须 --issue <路径> 与 --reason <裁定理由>`);let n=o({root:t,file:e.issue,reason:e.reason});n.ok||H(n.message),B(`${e.issue}: ${n.message}`)}}),t(e,{name:`unfreeze`,description:`解冻 issue（--note 须含「用户裁定」；恢复 🔴）`,options:[{flags:`--issue <issue>`,description:`issue 文件路径`},{flags:`--note <note>`,description:`解冻注记（须含「用户裁定」）`},{flags:`--config <path>`,description:`显式配置路径`}],schema:E.object({issue:E.string().optional(),note:E.string().optional(),config:E.string().optional()}).passthrough(),action:async e=>{let t=L();await R(e.config),(e.issue===void 0||e.note===void 0)&&H(`unfreeze 须 --issue <路径> 与 --note <解冻注记>`);let n=T({root:t,file:e.issue,note:e.note});n.ok||H(n.message),B(`${e.issue}: ${n.message}`)}}),t(e,{name:`normalize-header`,description:`方言头部迁移（字段规范序 / 零丢失守卫 / 幂等）`,options:[{flags:`--issue <issue>`,description:`issue 文件路径（可重复）`},{flags:`--config <path>`,description:`显式配置路径`}],schema:E.object({issue:E.union([E.string(),E.array(E.string())]).optional(),config:E.string().optional()}).passthrough(),action:async e=>{let t=L();await R(e.config);let n=e.issue===void 0?[]:Array.isArray(e.issue)?e.issue:[e.issue];n.length===0&&H(`缺少 --issue <路径>（可重复）`);let r=0;for(let e of n){let n=c({root:t,file:e});V(`${e}: ${n.outcome}（${n.message}）`),r+=+(n.outcome===`failed`)}r>0&&process.exit(1)}}),t(e,{name:`prompts`,description:`推荐提示词（list / show <id>）`,arguments:[{signature:`[action]`,description:`list | show`}],options:[{flags:`--id <id>`,description:`提示词 id（show 用）`},{flags:`--config <path>`,description:`显式配置路径`}],schema:E.object({action:E.string().optional(),id:E.string().optional(),config:E.string().optional()}).passthrough(),action:async e=>{let{config:t}=await R(e.config),n={builtin:t.prompts.builtin,extraDir:t.prompts.extraDir===void 0?void 0:`${L()}/${t.prompts.extraDir}`};if((e.action??`list`)===`show`){let t=e.id??H(`show 须 --id <提示词 id>`),r=w(t,n)??H(`提示词「${t}」未命中（lzi-issues prompts list 查看全部）`);process.stdout.write(`${r.content}\n`);return}for(let e of s(n))process.stdout.write(`${e.id}［${e.source}］ ${e.description}\n`)}})}function G(e){t(e,{name:`lint`,description:`注册表 lint（12 核心规则 + 棘轮基线三态）`,options:[{flags:`--dir <dir>`,description:`限定注册表目录（可重复）`},{flags:`--strict-legacy`,description:`旧格式状态行一并计违规`},{flags:`--write-baseline`,description:`再生棘轮基线（须配 --issue）`},{flags:`--issue <issue>`,description:`收编指针（write-baseline 必填）`},{flags:`--config <path>`,description:`显式配置路径`}],schema:E.object({dir:E.union([E.string(),E.array(E.string())]).optional(),strictLegacy:E.boolean().optional(),writeBaseline:E.boolean().optional(),issue:E.string().optional(),config:E.string().optional()}).passthrough(),action:async e=>{let t=L(),{config:n,configFilePath:r}=await R(e.config),i=e.dir===void 0?void 0:Array.isArray(e.dir)?e.dir:[e.dir],a=e.strictLegacy===!0?{...n,lint:{...n.lint,strictLegacy:!0}}:n;if(e.writeBaseline===!0){let n=S({root:t,config:a,issuePointer:e.issue??``});n.ok||H(n.error),I(r,n.content),B(`基线已再生（${n.entryCount} 条，收编指针 ${e.issue}）——棘轮只许缩短`);return}let o=g({root:t,config:a,dirRels:i});for(let e of o.violations)V(`${e.file}:${e.line} [${e.rule}] ${e.message}`);o.violations.length>0&&(process.stderr.write(`错误: issues:lint ${o.violations.length} 项违规｜存量豁免 ${o.suppressed}｜基线 ${o.baselineCount} 条\n`),process.exit(1)),B(`issues:lint 通过（0 新增违规｜存量豁免 ${o.suppressed}｜基线 ${o.baselineCount} 条）`)}});let n=E.object({scope:E.string().optional(),dir:E.string().optional(),config:E.string().optional()}).passthrough(),r=e.command(`numbering`).description(`编号门禁（next 取号 / check 判定 / audit 覆盖面审计）`);t(r,{name:`next`,description:`取号（--scope <key> 或 --dir <目录> 互斥；只读不写）`,options:[{flags:`--scope <scope>`,description:`目标 scope key`},{flags:`--dir <dir>`,description:`目标注册表目录`},{flags:`--config <path>`,description:`显式配置路径`}],schema:n,action:async e=>{let t=L(),{config:n}=await R(e.config),r=y({root:t,config:n,scopeKey:e.scope,dirRel:e.dir});r.ok||H(r.error),z(`${r.target} 下一可用编号：${r.number}（已跳过保留号与已占用号）`)}}),t(r,{name:`check`,description:`编号门禁判定（缺省全量；--dir 目录增量）`,options:[{flags:`--dir <dir>`,description:`目录增量档`},{flags:`--config <path>`,description:`显式配置路径`}],schema:n,action:async e=>{let t=L(),{config:n}=await R(e.config),r=v({root:t,config:n,dirRel:e.dir});for(let e of r.findings)V(`[${e.kind}] ${e.message}`);r.findings.length>0&&(process.stderr.write(`错误: numbering:check ${r.findings.length} 项违规（scope ${r.scopeCount} 个 / 扫描面 ${r.scannedFiles} 文件）\n`),process.exit(1)),B(`numbering:check 通过（scope ${r.scopeCount} 个 / 扫描面 ${r.scannedFiles} 文件 / 零违规）`)}}),t(r,{name:`audit`,description:`覆盖面审计（未登记编号区 / pending 失效）`,options:[{flags:`--config <path>`,description:`显式配置路径`}],schema:n,action:async e=>{let t=L(),{config:n}=await R(e.config),r=_({root:t,config:n});for(let e of r.findings)V(`[${e.kind}] ${e.message}`);r.findings.length>0&&(process.stderr.write(`错误: numbering:audit ${r.findings.length} 项违规（扫描面 ${r.scannedFiles} 文件）\n`),process.exit(1)),B(`numbering:audit 通过（扫描面 ${r.scannedFiles} 文件 / 零未登记编号区）`)}});let i=e.command(`docs`).description(`文档 issue 引用检查与机械修复`);t(i,{name:`check`,description:`文档 issue 引用检查（不完整 slug 前缀唯一解析 / 棘轮基线）`,options:[{flags:`--write-baseline`,description:`再生 docs 基线（须配 --issue）`},{flags:`--issue <issue>`,description:`收编指针`},{flags:`--config <path>`,description:`显式配置路径`}],schema:E.object({writeBaseline:E.boolean().optional(),issue:E.string().optional(),config:E.string().optional()}).passthrough(),action:async e=>{let t=L(),{config:n,configFilePath:r}=await R(e.config);if(e.writeBaseline===!0)try{let i=x({root:t,config:n,issuePointer:e.issue??``});i.ok||H(i.error),I(r,i.content),B(`docs 基线已再生（${i.entryCount} 条）`);return}catch(e){H(e instanceof Error?e.message:String(e))}try{let e=m({root:t,config:n});for(let t of e.violations)V(`${t.file}:${t.line} [${t.rule}] ${t.message}`);e.violations.length>0&&(process.stderr.write(`错误: docs:check ${e.violations.length} 项违规（扫描面 ${e.scannedFiles} 文件 / 豁免 ${e.suppressed}）\n`),process.exit(1)),B(`docs:check 通过（扫描面 ${e.scannedFiles} 文件 / 零违规）`)}catch(e){H(e instanceof Error?e.message:String(e))}}}),t(e,{name:`health`,description:`黄灯巡检（状态分布 / 最老账龄 / A-B-C 分类，JSON）`,options:[{flags:`--config <path>`,description:`显式配置路径`}],schema:E.object({config:E.string().optional()}).passthrough(),action:async e=>{let t=L(),{config:n}=await R(e.config);process.stdout.write(`${JSON.stringify(h({root:t,config:n}),null,2)}\n`)}}),t(e,{name:`triage`,description:`黄灯分诊台账（append-only 落 .lzi/issues/runs/ledger/）`,options:[{flags:`--config <path>`,description:`显式配置路径`}],schema:E.object({config:E.string().optional()}).passthrough(),action:async e=>{let t=L(),{config:n}=await R(e.config),{ledgerPath:r,ledger:i}=b({root:t,config:n});B(`issues:triage 台账已落盘: ${r}（黄灯 ${i.items.length} 项）`)}})}function K(e){t(e,{name:`create`,description:`建档（门禁取号 → 标准模板落盘 → 编号自检）`,options:[{flags:`--title <title>`,description:`一句话标题（必填）`},{flags:`--slug <slug>`,description:`slug（缺省由标题派生）`},{flags:`--priority <priority>`,description:`P1 | P2 | P3（缺省 P2）`},{flags:`--type <type>`,description:`议题类型（缺省 task）`},{flags:`--scope <scope>`,description:`scope key（缺省按 cwd 解析）`},{flags:`--source <source>`,description:`来源说明`},{flags:`--dry-run`,description:`只呈现不落盘`},{flags:`--config <path>`,description:`显式配置路径`}],schema:E.object({title:E.string(),slug:E.string().optional(),priority:E.string().optional(),type:E.string().optional(),scope:E.string().optional(),source:E.string().optional(),dryRun:E.boolean().optional(),config:E.string().optional()}).passthrough(),action:async e=>{let t=L(),{config:n}=await R(e.config),r=j(t,process.cwd()),i=e.scope??U(n,r)??H(`cwd「${r}」未命中任何 scope 覆盖面——候选：${n.scopes.map(e=>e.key).join(`、`)}（或显式 --scope）`),a=n.scopes.find(e=>e.key===i)??H(`scope「${i}」未登记`),o=y({root:t,config:n,scopeKey:i});o.ok||H(o.error);let s=e.slug??e.title.toLowerCase().replace(/[\s_]+/g,`-`).replace(/[^a-z0-9-]/g,``).replace(/-+/g,`-`).replace(/^-|-$/g,``),c=/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(s)?s:H(`slug 须为纯 ASCII kebab（小写字母/数字/连字符，禁中文）——中文标题请显式提供 --slug <slug>`),l=u({number:o.ok?o.number:`0001`,slug:c,title:e.title,priority:e.priority===`P1`||e.priority===`P3`?e.priority:`P2`,scopeTitle:a.title,date:new Date().toISOString().slice(0,10),source:e.source??`CLI 建档`}),d=A(t,a.registryDir),f=A(d,`${o.ok?o.number:`0001`}-${c}.md`);if(e.dryRun===!0){z(`（dry-run）将落盘：${j(t,f)}`),process.stdout.write(l);return}P(d,{recursive:!0}),N(f)&&H(`文件已存在：${f}`),I(f,l),B(`已建档：${j(t,f)}`);let p=y({root:t,config:n,scopeKey:i});z(`编号自检：下一可用编号 ${p.ok?p.number:`—`}（${a.registryDir} 目录口径）`),C(d).length}}),t(e,{name:`list`,description:`列出注册表 issue（按 scope 分组）`,options:[{flags:`--scope <scope>`,description:`限定 scope`},{flags:`--status <status>`,description:`限定状态灯位（red/yellow/green/frozen/canceled）`},{flags:`--config <path>`,description:`显式配置路径`}],schema:E.object({scope:E.string().optional(),status:E.string().optional(),config:E.string().optional()}).passthrough(),action:async e=>{let t=L(),{config:n}=await R(e.config);for(let r of n.scopes){if(e.scope!==void 0&&r.key!==e.scope)continue;let n=C(A(t,r.registryDir)),i=e.status===void 0?n:n.filter(t=>t.status===e.status);process.stdout.write(`# ${r.key}（${r.title}）— ${i.length} 项\n`);for(let e of i)process.stdout.write(`${e.id} ${e.status.padEnd(7)} ${e.title}\n`)}}}),t(e,{name:`show`,description:`展示单份 issue（ref 支持 编号 / 编号-slug / 不完整前缀；多义列候选）`,arguments:[{signature:`<ref>`,description:`issue 引用`}],options:[{flags:`--config <path>`,description:`显式配置路径`}],schema:E.object({ref:E.string()}).passthrough(),action:async e=>{let t=e,n=t.ref??t._?.[0]??H(`缺少 issue 引用（show <ref>）`),r=L(),{config:i}=await R(t.config),a=/^(\d{3,4})(?:-([a-z0-9-]+))?$/.exec(n);a===null&&H(`引用「${n}」不合法（编号或 编号-slug 形态）`);let o=[];for(let e of i.scopes)for(let t of C(A(r,e.registryDir)))t.id===a[1]&&(a[2]===void 0||t.slug===a[2])&&o.push({scopeKey:e.key,file:`${e.registryDir}/${t.file}`,slug:t.slug,title:t.title,record:t});if(o.length===0)for(let e of i.scopes)for(let t of C(A(r,e.registryDir)))t.id===a[1]&&a[2]!==void 0&&t.slug.startsWith(a[2])&&o.push({scopeKey:e.key,file:`${e.registryDir}/${t.file}`,slug:t.slug,title:t.title,record:t});if(o.length===0&&H(`引用「${n}」无命中`),o.length>1){process.stderr.write(`错误: 引用「${n}」命中不唯一——候选：\n`);for(let e of o)process.stderr.write(`  ${e.scopeKey}/${e.record.id}-${e.slug}（${e.file}）\n`);process.exit(1)}let s=o[0];z(`命中：${s.scopeKey} ${s.file}`),process.stdout.write(s.record.rawContent)}})}function q(e){t(e,{name:`init`,description:`初始化 lzi-issues：生成/追加 lzi-issues.config.ts、创建注册表目录并落格式存根`,options:[{flags:`--key <key>`,description:`scope key（缺省按 package.json 名推导）`},{flags:`--title <title>`,description:`scope 人类可读名`},{flags:`--registry-dir <dir>`,description:`注册表目录（缺省 docs/issues）`},{flags:`--paths <paths...>`,description:`覆盖路径 glob（缺省 .）`}],schema:E.object({key:E.string().optional(),title:E.string().optional(),registryDir:E.string().optional(),paths:E.array(E.string()).optional()}).passthrough(),action:async e=>{let t=L(),n=A(t,`lzi-issues.config.ts`),r=e.key??(N(A(t,`package.json`))?(()=>{try{return(JSON.parse(F(A(t,`package.json`),`utf8`)).name??`root`).replace(/^@[^/]+\//,``).replace(/[^a-z0-9-]/g,`-`)}catch{return`root`}})():`root`),i={key:r,title:e.title??`${r} 域`,paths:e.paths??[`.`],registryDir:e.registryDir??`docs/issues`};if(N(n))try{let e=D(F(n,`utf8`),i);I(n,e),z(`已追加 scope「${r}」到 ${n}`)}catch(e){H(e instanceof Error?e.message:String(e))}else I(n,k(i)),B(`已生成 ${n}`);let a=A(t,i.registryDir),o=A(a,`README.md`);P(a,{recursive:!0}),N(o)?z(`注册表 README 已存在，跳过（幂等不覆盖）`):(I(o,f(i.title,`../../docs/guides/issue-file-format.md`)),B(`已创建注册表目录 ${i.registryDir} 并落格式存根 README.md`)),B(`后续：lzi-issues template 查看标准模板；lzi-issues create --title <标题> 建档`)}}),t(e,{name:`template`,description:`输出 issue 标准格式模板（--with-criteria 附判据块示例）`,options:[{flags:`--with-criteria`,description:`附 criteria 判据块示例`},{flags:`--format <format>`,description:`text | json（json 返回字段契约）`}],schema:E.object({withCriteria:E.boolean().optional(),format:E.string().optional()}).passthrough(),action:async e=>{let t=d();if(e.format===`json`){process.stdout.write(`${JSON.stringify({template:t,fields:i},null,2)}\n`);return}process.stdout.write(t),e.withCriteria===!0&&process.stdout.write(`\n${l()}`)}})}function J(e){q(e),K(e),G(e),W(e)}async function Y(){let t=e({name:`lzi-issues`,description:`Longzai Intelligence Issues CLI（文件化注册表 · Local First）`,interaction:n,color:r});J(t),await t.parseAsync(process.argv)}await Y();export{};

package/dist/rolldown-runtime-DCIJsbUY.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+import"node:module";export{};

package/lzi-builder.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from '@longzai-intelligence-builder/esm';
+
+/**
+ * CLI 应用构建配置：node 平台入口（bin 由 package.json 声明，shebang 注入）
+ */
+export default defineConfig({
+  entry: {
+    index: 'src/index.ts',
+  },
+  platform: 'node',
+  banner: '#!/usr/bin/env bun',
+});

package/lzi-bun.config.ts

@@ -0,0 +1,6 @@
+import { defineCliBunConfig } from '@longzai-intelligence-bun/config';
+
+/**
+ * CLI 应用 bun 测试配置（apps/cli 阈值）
+ */
+export default defineCliBunConfig();

package/oxlint.config.ts

@@ -0,0 +1,3 @@
+import { defineConfig } from '@longzai-intelligence-oxlint/presets/library';
+
+export default defineConfig();

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@longzai-intelligence-issues/cli",
+  "version": "0.0.1",
+  "license": "UNLICENSED",
+  "type": "module",
+  "bin": {
+    "lzi-issues": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "lzi-builder",
+    "build:prod": "NODE_ENV=production bun run build",
+    "prepublishOnly": "bun run build:prod",
+    "typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
+    "typecheck:app": "lzi-tsgo typecheck tsconfig/app.json",
+    "typecheck:node": "lzi-tsgo typecheck tsconfig/node.json",
+    "typecheck:test": "lzi-tsgo typecheck tsconfig/test.json",
+    "lint": "oxlint && oxfmt --check",
+    "lint:fix": "oxlint --fix && oxfmt",
+    "test": "lzi-bun-cli test",
+    "test:watch": "lzi-bun-cli test --watch",
+    "test:coverage": "lzi-bun-cli test --coverage",
+    "clean": "lzi-dev-cli clean"
+  },
+  "dependencies": {
+    "@longzai-intelligence-issues/config": "0.0.1",
+    "@longzai-intelligence-issues/ledger": "0.0.1",
+    "@longzai-intelligence-cli/core": "^0.0.8",
+    "zod": "^4.4.3",
+    "@longzai-intelligence-cli/standard": "^0.0.8"
+  },
+  "devDependencies": {
+    "@longzai-intelligence-builder/cli": "^0.2.16",
+    "@longzai-intelligence-tsgo/cli": "^0.0.1",
+    "@types/bun": "latest",
+    "@typescript/native-preview": "beta",
+    "oxlint": "^1.77.0"
+  }
+}

package/src/commands/close.commands.ts

@@ -0,0 +1,257 @@
+import type { Command } from '@longzai-intelligence-cli/core';
+
+import { defineCommand } from '@longzai-intelligence-cli/core';
+import {
+  evidenceCloseFlow,
+  freezeIssue,
+  listPrompts,
+  normalizeHeaderFile,
+  rerunCloseFlow,
+  showPrompt,
+  unfreezeIssue,
+} from '@longzai-intelligence-issues/ledger';
+import * as z from 'zod';
+
+import { fail, info, loadConfigOrExit, ok, repoRoot, violation } from './context.utils.js';
+
+/**
+ * 收口与冻结命令组：verify-close / freeze / unfreeze / normalize-header / prompts
+ *
+ * 判据口径：exit 0 过 / 1 违规 / 2 门禁拦截零执行。
+ */
+export function registerCloseCommands(program: Command): void {
+  defineCommand(program, {
+    name: 'verify-close',
+    description: 'issue 收口（缺省零执行证据收口；--rerun 证书化真跑）',
+    options: [
+      { flags: '--issue <issue>', description: 'issue 文件路径（可重复）' },
+      { flags: '--summary <summary>', description: '收口概要（批量禁用）' },
+      { flags: '--dry-run', description: '只呈现不落盘/不执行' },
+      { flags: '--rerun', description: '证书化真跑（重度命令，仅人类明令）' },
+      { flags: '--criterion <criterion>', description: '显式判据 label|channel|cwd|command（可重复）' },
+      { flags: '--criteria-from-issue', description: '从各案 criteria 块取判据' },
+      { flags: '--confirm-heavy', description: '重度命令确认' },
+      { flags: '--allow-full-criterion', description: '全量判据豁免（须留痕）' },
+      { flags: '--config <path>', description: '显式配置路径' },
+    ],
+    schema: z
+      .object({
+        issue: z.union([z.string(), z.array(z.string())]).optional(),
+        summary: z.string().optional(),
+        dryRun: z.boolean().optional(),
+        rerun: z.boolean().optional(),
+        criterion: z.union([z.string(), z.array(z.string())]).optional(),
+        criteriaFromIssue: z.boolean().optional(),
+        confirmHeavy: z.boolean().optional(),
+        allowFullCriterion: z.boolean().optional(),
+        config: z.string().optional(),
+      })
+      .passthrough(),
+    action: async (opts) => {
+      const root = repoRoot();
+      const { config } = await loadConfigOrExit(opts.config);
+
+      /**
+       * 目标文件归一
+       */
+      const files = opts.issue === undefined ? [] : Array.isArray(opts.issue) ? opts.issue : [opts.issue];
+
+      if (files.length === 0) {
+        fail('缺少 --issue <路径>（可重复指定批量）');
+      }
+
+      /**
+       * 显式判据归一
+       */
+      const criteria = opts.criterion === undefined ? [] : Array.isArray(opts.criterion) ? opts.criterion : [opts.criterion];
+
+      if (opts.rerun === true) {
+        /**
+         * 证书化真跑
+         */
+        const result = rerunCloseFlow({
+          root,
+          config,
+          files,
+          explicitCriteria: criteria,
+          criteriaFromIssue: opts.criteriaFromIssue === true,
+          summaryOverride: files.length === 1 ? opts.summary : undefined,
+          dryRun: opts.dryRun === true,
+          allowFullCriterion: opts.allowFullCriterion === true,
+          confirmHeavy: opts.confirmHeavy === true,
+        });
+
+        if (result.gateBlocked) {
+          process.stdout.write(`${result.gateMessage}\n`);
+          process.exit(2);
+        }
+
+        for (const entry of result.cases) {
+          violation(`${entry.file}: ${entry.ok ? '通过' : '失败'}——${entry.message}`);
+        }
+
+        info(`批次收口汇总：${result.succeeded}/${result.cases.length} 案翻绿`);
+
+        if (result.succeeded < result.cases.length) {
+          process.exit(1);
+        }
+
+        return;
+      }
+
+      /**
+       * 缺省证据收口（零执行）
+       */
+      if (criteria.length > 0 || opts.criteriaFromIssue === true || opts.confirmHeavy === true || opts.allowFullCriterion === true) {
+        fail('证据收口（缺省模式）不接受 --criterion/--criteria-from-issue/--confirm-heavy/--allow-full-criterion（属 --rerun 真跑旗标）');
+      }
+
+      const result = evidenceCloseFlow({
+        root,
+        config,
+        files,
+        summaryOverride: files.length === 1 ? opts.summary : undefined,
+        dryRun: opts.dryRun === true,
+      });
+
+      for (const entry of result.cases) {
+        violation(`${entry.file}: ${entry.ok ? '通过' : '失败'}——${entry.message}`);
+      }
+
+      info(`批次证据收口汇总：${result.succeeded}/${result.cases.length} 案翻绿（全程零命令执行）`);
+
+      if (result.succeeded < result.cases.length) {
+        process.exit(1);
+      }
+    },
+  });
+
+  defineCommand(program, {
+    name: 'freeze',
+    description: '冻结 issue（--reason 须含「用户裁定」）',
+    options: [
+      { flags: '--issue <issue>', description: 'issue 文件路径' },
+      { flags: '--reason <reason>', description: '裁定理由（须含「用户裁定」）' },
+      { flags: '--config <path>', description: '显式配置路径' },
+    ],
+    schema: z.object({ issue: z.string().optional(), reason: z.string().optional(), config: z.string().optional() }).passthrough(),
+    action: async (opts) => {
+      const root = repoRoot();
+      await loadConfigOrExit(opts.config);
+
+      if (opts.issue === undefined || opts.reason === undefined) {
+        fail('freeze 须 --issue <路径> 与 --reason <裁定理由>');
+      }
+
+      const result = freezeIssue({ root, file: opts.issue, reason: opts.reason });
+
+      if (!result.ok) {
+        fail(result.message);
+      }
+
+      ok(`${opts.issue}: ${result.message}`);
+    },
+  });
+
+  defineCommand(program, {
+    name: 'unfreeze',
+    description: '解冻 issue（--note 须含「用户裁定」；恢复 🔴）',
+    options: [
+      { flags: '--issue <issue>', description: 'issue 文件路径' },
+      { flags: '--note <note>', description: '解冻注记（须含「用户裁定」）' },
+      { flags: '--config <path>', description: '显式配置路径' },
+    ],
+    schema: z.object({ issue: z.string().optional(), note: z.string().optional(), config: z.string().optional() }).passthrough(),
+    action: async (opts) => {
+      const root = repoRoot();
+      await loadConfigOrExit(opts.config);
+
+      if (opts.issue === undefined || opts.note === undefined) {
+        fail('unfreeze 须 --issue <路径> 与 --note <解冻注记>');
+      }
+
+      const result = unfreezeIssue({ root, file: opts.issue, note: opts.note });
+
+      if (!result.ok) {
+        fail(result.message);
+      }
+
+      ok(`${opts.issue}: ${result.message}`);
+    },
+  });
+
+  defineCommand(program, {
+    name: 'normalize-header',
+    description: '方言头部迁移（字段规范序 / 零丢失守卫 / 幂等）',
+    options: [
+      { flags: '--issue <issue>', description: 'issue 文件路径（可重复）' },
+      { flags: '--config <path>', description: '显式配置路径' },
+    ],
+    schema: z.object({ issue: z.union([z.string(), z.array(z.string())]).optional(), config: z.string().optional() }).passthrough(),
+    action: async (opts) => {
+      const root = repoRoot();
+      await loadConfigOrExit(opts.config);
+
+      /**
+       * 目标文件归一
+       */
+      const files = opts.issue === undefined ? [] : Array.isArray(opts.issue) ? opts.issue : [opts.issue];
+
+      if (files.length === 0) {
+        fail('缺少 --issue <路径>（可重复）');
+      }
+
+      /**
+       * 失败计数
+       */
+      let failed = 0;
+
+      for (const file of files) {
+        const result = normalizeHeaderFile({ root, file });
+        violation(`${file}: ${result.outcome}（${result.message}）`);
+        failed += result.outcome === 'failed' ? 1 : 0;
+      }
+
+      if (failed > 0) {
+        process.exit(1);
+      }
+    },
+  });
+
+  defineCommand(program, {
+    name: 'prompts',
+    description: '推荐提示词（list / show <id>）',
+    arguments: [{ signature: '[action]', description: 'list | show' }],
+    options: [
+      { flags: '--id <id>', description: '提示词 id（show 用）' },
+      { flags: '--config <path>', description: '显式配置路径' },
+    ],
+    schema: z.object({ action: z.string().optional(), id: z.string().optional(), config: z.string().optional() }).passthrough(),
+    action: async (opts) => {
+      const { config } = await loadConfigOrExit(opts.config);
+
+      /**
+       * 提示词选项（builtin 开关 + extraDir）
+       */
+      const options = {
+        builtin: config.prompts.builtin,
+        extraDir: config.prompts.extraDir === undefined ? undefined : `${repoRoot()}/${config.prompts.extraDir}`,
+      };
+
+      const action = opts.action ?? 'list';
+
+      if (action === 'show') {
+        const id = opts.id ?? fail('show 须 --id <提示词 id>');
+
+        const entry = showPrompt(id, options) ?? fail(`提示词「${id}」未命中（lzi-issues prompts list 查看全部）`);
+
+        process.stdout.write(`${entry.content}\n`);
+        return;
+      }
+
+      for (const entry of listPrompts(options)) {
+        process.stdout.write(`${entry.id}［${entry.source}］ ${entry.description}\n`);
+      }
+    },
+  });
+}

package/src/commands/context.utils.ts

@@ -0,0 +1,108 @@
+/**
+ * 命令公共上下文：配置加载、根锚定与判据输出
+ *
+ * 判据口径（apex 迁移）：违规与错误走 stderr（`错误: ` 前缀）+ exit 1；过程
+ * 信息走 stdout（[INFO]/[SUCCESS] 前缀）；exit 2 = 门禁拦截零执行。
+ */
+
+import { loadLziIssuesConfig, type LoadLziIssuesConfigResult, type LziIssuesConfig } from '@longzai-intelligence-issues/config';
+
+import { resolve } from 'node:path';
+
+/**
+ * 仓库根绝对路径（cwd 锚定；配置查找亦自 cwd 向上）
+ */
+export function repoRoot(): string {
+  return resolve(process.cwd());
+}
+
+/**
+ * 加载配置（失败即错误退出——引擎零仓库知识，无配置不可运行）
+ *
+ * @param configPath - 显式配置路径（--config）
+ * @returns 解析后配置与命中路径
+ */
+export async function loadConfigOrExit(configPath?: string): Promise<{ config: LziIssuesConfig; configFilePath: string }> {
+  /**
+   * 加载结果
+   */
+  const result: LoadLziIssuesConfigResult = await loadLziIssuesConfig(
+    configPath === undefined ? {} : { configPath },
+  );
+
+  if (!result.ok) {
+    process.stderr.write(`错误: ${result.reason}\n`);
+    process.exit(1);
+  }
+
+  return { config: result.config, configFilePath: result.configFilePath };
+}
+
+/**
+ * 输出 [INFO] 过程信息
+ *
+ * @param message - 消息
+ */
+export function info(message: string): void {
+  process.stdout.write(`[INFO] ${message}\n`);
+}
+
+/**
+ * 输出 [SUCCESS] 结果信息
+ *
+ * @param message - 消息
+ */
+export function ok(message: string): void {
+  process.stdout.write(`[SUCCESS] ${message}\n`);
+}
+
+/**
+ * 输出违规（`文件:行 [规则] 消息` 或裸消息）
+ *
+ * @param line - 违规行文本
+ */
+export function violation(line: string): void {
+  process.stdout.write(`${line}\n`);
+}
+
+/**
+ * 输出错误并 exit 1
+ *
+ * @param message - 错误消息
+ */
+export function fail(message: string): never {
+  process.stderr.write(`错误: ${message}\n`);
+  process.exit(1);
+}
+
+/**
+ * cwd → scope 解析（最长 paths 前缀优先；失败列全部 scope）
+ *
+ * @param config - 解析后配置
+ * @param cwdRel - cwd 相对根路径
+ * @returns 命中 scope key；未命中为 null
+ */
+export function resolveScopeFromCwd(config: LziIssuesConfig, cwdRel: string): string | null {
+  /**
+   * 候选（path 命中 cwd 的 scope，取最长 path）
+   */
+  let bestKey: string | null = null;
+
+  let bestLen = -1;
+
+  for (const scope of config.scopes) {
+    for (const path of scope.paths) {
+      /**
+       * 前缀命中判定（'.' 视为全仓命中）
+       */
+      const hit = path === '.' || path === '' || cwdRel === path || cwdRel.startsWith(`${path}/`);
+
+      if (hit && path.length > bestLen) {
+        bestKey = scope.key;
+        bestLen = path.length;
+      }
+    }
+  }
+
+  return bestKey;
+}