@yss123/cage-cli 0.2.0 → 0.3.1

package/dist/snapshots.d.ts

@@ -0,0 +1,40 @@
+import { type CageConfig } from './config.js';
+import type { Ontology } from './ontology.js';
+/**
+ * 命名基线信封，保存来源时间、版本、指纹和完整本体；不是可反复覆盖的当前缓存。
+ */
+export interface NamedSnapshot {
+    schemaVersion: 1; /** 经过安全校验的快照名，用于文件定位。 */
+    name: string; /** 保存时的 ISO 时间，不会随后续分析刷新。 */
+    createdAt: string; /** 保存该基线的 CLI/框架版本。 */
+    frameworkVersion: string; /** 按图内容计算的摘要，用于核对快照身份。 */
+    graphHash: string; /** 保存时的完整本体，供后续 impact 比较。 */
+    graph: Ontology;
+}
+/**
+ * 限制安全命名并生成固定目录下的快照路径。
+ * @param cfg 应用根。
+ * @param name 字母开头，最多 64 字符，只含字母数字、下划线或连字符。
+ * @returns .cage/snapshots 内路径；非法名称抛 CAGE-IMPACT-002。
+ */
+export declare function snapshotPath(cfg: CageConfig, name: string): string;
+/**
+ * 读取命名快照，不重新分析领域。
+ * @param cfg 应用配置。
+ * @param name 快照名，仍会验证安全命名。
+ * @returns JSON 信封；文件缺失或损坏时抛出，不自动创建。
+ */
+export declare function readSnapshot(cfg: CageConfig, name: string): NamedSnapshot;
+/**
+ * 按文件名稳定列出基线。
+ * @param cfg 应用根配置。
+ * @returns 快照数组，目录不存在时为空；损坏文件的错误不吞掉。
+ */
+export declare function listSnapshots(cfg: CageConfig): NamedSnapshot[];
+/**
+ * 重新抽取通过规则的声明并独占保存基线。
+ * @param cfg 当前应用配置。
+ * @param name 尚未使用的名称。
+ * @returns 已保存信封；声明错误、同名或 IO 失败抛出，wx 防止并发覆盖。
+ */
+export declare function saveSnapshot(cfg: CageConfig, name: string): Promise<NamedSnapshot>;

package/dist/snapshots.js

@@ -0,0 +1,62 @@
+/**
+ * 保存、读取和列出命名本体基线，供修改前留证及 impact 比较。
+ * 名称限制为安全文件名，保存前重新分析声明并附时间、框架版本和 SHA-256 指纹。
+ * 快照以独占写入避免覆盖；普通查询不修改这些文件，读取失败或非法 JSON 直接向调用方报告。
+ */
+// Named baselines are immutable records; ordinary graph queries never write them.
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { abs } from './config.js';
+import { analyze } from './analyze.js';
+import { errorsOnly } from './findings.js';
+import { VERSION } from './version.js';
+/**
+ * 限制安全命名并生成固定目录下的快照路径。
+ * @param cfg 应用根。
+ * @param name 字母开头，最多 64 字符，只含字母数字、下划线或连字符。
+ * @returns .cage/snapshots 内路径；非法名称抛 CAGE-IMPACT-002。
+ */
+export function snapshotPath(cfg, name) {
+    if (!/^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/.test(name))
+        throw new Error('[CAGE-IMPACT-002] 快照名称须以字母开头，只含字母、数字、下划线或连字符');
+    return abs(cfg, `.cage/snapshots/${name}.json`);
+}
+/**
+ * 读取命名快照，不重新分析领域。
+ * @param cfg 应用配置。
+ * @param name 快照名，仍会验证安全命名。
+ * @returns JSON 信封；文件缺失或损坏时抛出，不自动创建。
+ */
+export function readSnapshot(cfg, name) {
+    return JSON.parse(readFileSync(snapshotPath(cfg, name), 'utf8'));
+}
+/**
+ * 按文件名稳定列出基线。
+ * @param cfg 应用根配置。
+ * @returns 快照数组，目录不存在时为空；损坏文件的错误不吞掉。
+ */
+export function listSnapshots(cfg) {
+    const dir = abs(cfg, '.cage/snapshots');
+    return existsSync(dir) ? readdirSync(dir).filter(p => p.endsWith('.json')).sort().map(p => JSON.parse(readFileSync(join(dir, p), 'utf8'))) : [];
+}
+/**
+ * 重新抽取通过规则的声明并独占保存基线。
+ * @param cfg 当前应用配置。
+ * @param name 尚未使用的名称。
+ * @returns 已保存信封；声明错误、同名或 IO 失败抛出，wx 防止并发覆盖。
+ */
+export async function saveSnapshot(cfg, name) {
+    const file = snapshotPath(cfg, name);
+    if (existsSync(file))
+        throw new Error(`[CAGE-IMPACT-002] 快照 ${name} 已存在，请使用新名称；已有比较基线不会被覆盖`);
+    const result = await analyze(cfg);
+    if (!result.graph || errorsOnly(result.findings).length)
+        throw new Error('[CAGE-IMPACT-002] 声明检查未通过，不能建立比较基线');
+    const snapshot = { schemaVersion: 1, name, createdAt: new Date().toISOString(), frameworkVersion: VERSION, graphHash: createHash('sha256').update(JSON.stringify(result.graph)).digest('hex'), graph: result.graph };
+    mkdirSync(abs(cfg, '.cage/snapshots'), { recursive: true });
+    // Exclusive creation prevents a repeated command from silently changing the comparison point.
+    writeFileSync(file, JSON.stringify(snapshot, null, 2) + '\n', { flag: 'wx' });
+    return snapshot;
+}
+//# sourceMappingURL=snapshots.js.map

package/dist/snapshots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.js","sourceRoot":"","sources":["../src/snapshots.ts"],"names":[],"mappings":"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"}

package/dist/static-check.d.ts

@@ -1,23 +1,56 @@
 import type { CageConfig } from './config.js';
 import type { Finding } from './findings.js';
+/**
+ * 需要保持顶层可抽取声明形式的公开原语名称集合；不等于完整公开 API 清单。
+ */
 export declare const PRIMITIVES: Set<string>;
+/**
+ * 静态扫描识别的顶层导出声明，源码片段用于哈希、预览和业务错误码提取。
+ */
 export interface DeclSite {
+    /** 模块顶层声明变量名，后续核对领域入口是否导出。 */
     exportName: string;
+    /** 识别到的原语调用名，已处理导入别名。 */
     primitive: string;
+    /** 相对应用根目录的声明文件路径。 */
     file: string;
+    /** 声明源码起始行，从 1 开始。 */
     line: number;
     /** 声明调用的源码（用于哈希与业务错误码提取） */
     text: string;
     /** handler 里 fail('CODE') 的业务错误码 */
     domainCodes: string[];
 }
+/**
+ * 静态阶段汇总：声明位置、诊断、unsafe 次数和扫描文件；尚未证明注册成功。
+ */
 export interface StaticResult {
+    /** 识别到的静态声明及源码定位。 */
     sites: DeclSite[];
+    /** 静态边界违规与后续入口漏导出诊断。 */
     findings: Finding[];
+    /** 扫描范围中的 unsafe 使用数量。 */
     unsafeCount: number;
+    /** 扫描到的源码文件，供新鲜度和影响分析使用。 */
     files: string[];
 }
+/**
+ * 递归列举非测试手写 TypeScript 源码，排除隐藏目录、依赖、dist 和声明文件。
+ * @param dir 扫描目录，要求存在。
+ * @returns 稳定排序绝对路径；文件系统错误直接抛出。
+ */
 export declare function listTs(dir: string): string[];
+/**
+ * 在导入前扫描领域源码并记录可抽取声明，识别别名与命名空间导入。
+ * @param cfg domain 路径和应用根配置。
+ * @returns 静态诊断及位置；不执行模块，不保证任意动态代码完全可分析。
+ */
 export declare function staticCheck(cfg: CageConfig): StaticResult;
 /** 有声明文件未被导出：静态扫到的声明必须出现在 domain 入口的导出里 */
+/**
+ * 比较扫描声明与入口已证明导出名称，定位未进入注册表的声明。
+ * @param sites 静态声明位置。
+ * @param exported 实际模块或符号解析确认的导出集合。
+ * @returns 缺失导出诊断，不自动添加 barrel 导出。
+ */
 export declare function unexportedFindings(sites: DeclSite[], exported: Set<string>): Finding[];

package/dist/static-check.js

@@ -1,23 +1,39 @@
+/**
+ * 领域模块求值之前的 TypeScript AST 扫描器，负责声明位置与基础依赖边界。
+ * 遍历领域源码，识别框架导入别名/命名空间，检查顶层 export const、禁止的 IO、重复导出和 unsafe 数量。
+ * 这里只做静态识别，不执行源码；不是任意 JavaScript 的安全沙箱，注册与领域语义仍由后续阶段检查。
+ */
 // 静态检查：导入之前先用 TypeScript 编译器 API 扫一遍源码，确保没有声明藏在函数、条件或循环里（那样抽取器就看不到它），
 // 并记下每个声明的位置（影响分析把 handler 文件的改动映射到它所属的命令）。
 import { readdirSync, readFileSync, statSync } from 'node:fs';
 import { dirname, join, relative } from 'node:path';
 import ts from 'typescript';
+/**
+ * 需要保持顶层可抽取声明形式的公开原语名称集合；不等于完整公开 API 清单。
+ */
 export const PRIMITIVES = new Set([
     'aggregate',
     'states',
     'command',
     'event',
     'reaction',
+    'reactionEach',
     'query',
     'approval',
     'job',
+    'businessProcess',
     'connector',
     'outbound',
     'inbound',
     'route',
+    'ai',
 ]);
-const IO_MODULES = /^(node:)?(fs|fs\/promises|net|http|https|http2|child_process|dgram|tls|worker_threads|cluster)(\/|$)|^(pg|kysely|axios|undici|node-fetch|got|@yss123\/cage-http|@yss123\/cage-kernel\/db|@yss123\/cage-kernel\/worker)(\/|$)/;
+const IO_MODULES = /^(node:)?(fs|fs\/promises|net|http|https|http2|child_process|dgram|tls|worker_threads|cluster)(\/|$)|^(pg|kysely|axios|undici|node-fetch|got|@yss123\/cage-files|@yss123\/cage-http|@yss123\/cage-kernel\/db|@yss123\/cage-kernel\/worker)(\/|$)/;
+/**
+ * 递归列举非测试手写 TypeScript 源码，排除隐藏目录、依赖、dist 和声明文件。
+ * @param dir 扫描目录，要求存在。
+ * @returns 稳定排序绝对路径；文件系统错误直接抛出。
+ */
 export function listTs(dir) {
     const out = [];
     const walk = (d) => {
@@ -34,6 +50,9 @@ export function listTs(dir) {
     walk(dir);
     return out.sort();
 }
+/**
+ * 识别会使声明脱离模块顶层的函数或类容器，用于向上追踪声明位置。
+ */
 function isFunctionLike(n) {
     return (ts.isFunctionDeclaration(n) ||
         ts.isFunctionExpression(n) ||
@@ -44,6 +63,9 @@ function isFunctionLike(n) {
         ts.isSetAccessor(n) ||
         ts.isClassDeclaration(n));
 }
+/**
+ * 识别条件、循环和块等动态执行容器，防止声明只在部分执行路径出现。
+ */
 function isControl(n) {
     return (ts.isIfStatement(n) ||
         ts.isForStatement(n) ||
@@ -56,9 +78,17 @@ function isControl(n) {
         ts.isConditionalExpression(n) ||
         ts.isBlock(n));
 }
+/**
+ * 读取简单标识调用名，复杂属性访问返回 null；不解析运行时对象或执行表达式。
+ */
 function calleeName(call) {
     return ts.isIdentifier(call.expression) ? call.expression.text : null;
 }
+/**
+ * 在导入前扫描领域源码并记录可抽取声明，识别别名与命名空间导入。
+ * @param cfg domain 路径和应用根配置。
+ * @returns 静态诊断及位置；不执行模块，不保证任意动态代码完全可分析。
+ */
 export function staticCheck(cfg) {
     const domainDir = dirname(join(cfg.root, cfg.domain));
     const files = listTs(domainDir);
@@ -209,6 +239,12 @@ export function staticCheck(cfg) {
     return { sites, findings, unsafeCount, files: files.map((f) => relative(cfg.root, f).replace(/\\/g, '/')) };
 }
 /** 有声明文件未被导出：静态扫到的声明必须出现在 domain 入口的导出里 */
+/**
+ * 比较扫描声明与入口已证明导出名称，定位未进入注册表的声明。
+ * @param sites 静态声明位置。
+ * @param exported 实际模块或符号解析确认的导出集合。
+ * @returns 缺失导出诊断，不自动添加 barrel 导出。
+ */
 export function unexportedFindings(sites, exported) {
     return sites
         .filter((s) => !exported.has(s.exportName))

package/dist/static-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"static-check.js","sourceRoot":"","sources":["../src/static-check.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"static-check.js","sourceRoot":"","sources":["../src/static-check.ts"],"names":[],"mappings":"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"}

package/dist/sync.d.ts

@@ -1,5 +1,16 @@
 import { type CageConfig } from './config.js';
 import type { Finding } from './findings.js';
+/** 当前 CLI 版本对应的项目协作说明；这是分发给 agent 的文档，不是运行时业务配置。 */
 export declare const managedBlock: string;
+/**
+ * 将现有文档中的唯一托管区替换为目标版本，返回完整文本而不写文件。
+ * 未出现任何标记时把托管区放在原文前；缺一个标记、标记重复或顺序反转时拒绝处理，
+ * 避免猜测边界后覆盖用户内容。latest 可由调用者提供，默认使用本包规范。
+ */
 export declare function syncManagedBlock(current: string, latest?: string): string;
+/**
+ * 在项目根目录同步或检查 AGENTS.md，不遍历和改写项目源码。
+ * check=true 时只比较并返回 CAGE-SYNC-001 修复提示；普通模式在内容变化时创建父目录并写入。
+ * 没有差异时返回空诊断。托管标记异常由 syncManagedBlock 抛出，文件系统错误向调用方传播。
+ */
 export declare function sync(cfg: CageConfig, check?: boolean): Finding[];

package/dist/sync.js

@@ -1,7 +1,14 @@
+/**
+ * 维护业务项目 AGENTS.md 中由框架拥有的协作规范。
+ * create 和 upgrade 复用这里的托管文本，sync 只替换 begin/end 标记之间的内容，
+ * 保留标记外的客户业务约定；它不修改业务源码、角色授权或数据库。
+ * 规范文本变更后须同步标准范例、两套模板并重新构建 CLI，才能随脚手架分发。
+ */
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname } from 'node:path';
 import { abs } from './config.js';
 import { VERSION } from './version.js';
+/** 当前 CLI 版本对应的项目协作说明；这是分发给 agent 的文档，不是运行时业务配置。 */
 export const managedBlock = `<!-- cage:begin v${VERSION} -->
 ## Cage 业务开发约定（框架托管）
 
@@ -11,6 +18,33 @@ export const managedBlock = `<!-- cage:begin v${VERSION} -->
 
 先读项目说明指定的学习资料，默认入口为 \`docs/ai/README.md\`。第一次读 \`architecture.md\`、\`project-structure.md\` 和 \`primitives.md\`；具体任务读 \`recipes.md\`，采购全链路读 \`purchase-example.md\`，错误查 \`docs/errors/README.md\` 和 \`docs/ai/troubleshooting.md\`。资料相对该学习目录，项目说明可指定源码仓库中的规范资料位置。
 
+### 详细中文注释（每次开发必须遵守）
+
+所有新增和维护的手写源码都必须写详细中文注释，先读学习目录中的 \`commenting.md\`（独立项目为 \`docs/ai/commenting.md\`）。注释是交付内容，不能以“代码自解释”或“保持简洁”为由省略。
+
+- 每个文件开头说明模块职责、谁调用它、主要调用链和责任边界；纯导出入口也说明如何组合模块。
+- 导出函数、类、组件、hooks、接口和业务声明使用 JSDoc，写清用途、参数含义、返回结果、主要步骤、前置条件、失败行为和副作用；复杂内部函数同样说明。参数类型已表达的语法无需重复，业务单位、空值、默认行为与约束必须解释。
+- 领域代码说明字段和状态的业务意义、命令调用身份与权限/范围、reads 依赖、事件用途、事务与异步边界、幂等/重试及资源释放；只写实际声明和实现已有的保证。
+- 页面说明 URL/查询参数、数据来源、临时状态、加载/空态/失败/无权限、提交后的刷新、会话与订阅清理；复杂分支、计算、顺序、并发和缓存规则在附近解释原因与过程。
+- 测试说明场景、前置条件、动作、断言和所防止的回归；脚本说明输入、读写路径、执行顺序、外部副作用与退出条件。注释不含密钥、凭据或个人数据。
+- 注释同时回答“做什么、为什么、如何完成、有哪些边界”，不能只有一句标题，也不能机械逐行翻译、凑字数或批量粘贴空泛模板。代码变更时同步更新注释，交付前逐文件核对。
+- 生成契约的注释由生成器维护，不手改生成物；已执行/已发布迁移不能改写。仅补注释时不得顺便重构或改变逻辑、接口、配置值和运行文案。
+
+### 原生 AI 能力入口
+
+遇到以下需求，先读 \`docs/ai/intelligence.md\`，用 \`pnpm exec cage capabilities "关键词" --format json\` 核对当前安装版本的公开 API，再检查本项目 domain 导出和页面接入。关键词可直接使用下表需求名称；未命中时缩短关键词或查公开符号，不能据此断言能力不存在。
+
+| 需求 | 框架入口与应用职责 |
+| --- | --- |
+| AI审批 / 智能审批 | 现有 \`step\` 使用 \`kind: 'ai'\`，支持 pass 通过、return 退回修改、manual 转人工；应用声明策略、结论命令、自动执行角色及接管人 |
+| 业务助理 / 本体助理 | 导出 \`ai({ models, assistant })\`；框架提供执行循环、按领域声明生成的工具、会话、偏好记忆和 HTTP；应用配置授权及界面 |
+| 页面上下文 / 随页助理 | \`useAssistant(client.ai, page)\` 配合 \`useAiPageContext\` / \`AiPageContext\`；应用上报页面、对象、选中项和草稿，服务端重读并校验业务事实 |
+| 模型管理 / Responses | \`managedModel\` 接入 Admin 动态配置，支持 Chat Completions / Responses；应用配置部署加密密钥并显式授权管理者 |
+| 性格 / 流式输出 | Admin 管理性格，SDK 提供选择、增量文字与执行进度；应用实现悬浮窗、Markdown 和确认卡片 |
+| 上下文预算 | \`ai({ context: ... })\` 的配置形状见 \`AiContextOptions\`；框架按预算选择完整工具或发现模式，历史和本体按需读取 |
+
+前端只使用客户端、协议与契约；后端循环、通用工具和记忆使用框架实现。页面快照和性格不授予权限。分别核对**框架支持**（公开导出）、**项目已启用**（domain 导出、迁移、模型、权限、worker、SDK）和**实际验证通过**（真实角色与模型联调）；空白模板的参考代码不表示已启用。具体接入顺序和验收步骤见该指南，不必将整份指南塞入每次任务上下文。
+
 ### 业务代码放在哪里
 
 | 位置 | 职责 |
@@ -20,7 +54,7 @@ export const managedBlock = `<!-- cage:begin v${VERSION} -->
 | \`packages/domain/src/index.ts\` | 统一导出全部业务及组织模型；没导出的声明不会注册 |
 | \`packages/contracts/src/aggregates/<聚合>\`、\`queries\` | 生成协议；根 index.ts 提供 @app/contracts 公共入口，只用 cage gen 更新 |
 | \`apps/api/src\` | API/worker 薄启动入口，普通业务不手写 HTTP 路由 |
-| \`apps/web/src/app\` | 会话、导航、布局、模块组合；main.tsx 只挂载和装配 Provider |
+| \`apps/web/src/app\` | 会话、URL 路由、布局、模块组合；main.tsx 只挂载和装配 Provider |
 | \`apps/web/src/modules/<业务>\` | 页面、表单、专用 hooks/API/样式；从模块 index.ts 暴露页面 |
 | \`apps/web/src/shared\` | 跨模块复用且不绑定业务的 UI、hooks、纯辅助函数 |
 | \`db/migrations\` | 审查过的结构迁移，作用于已配置的数据库 |
@@ -32,11 +66,11 @@ export const managedBlock = `<!-- cage:begin v${VERSION} -->
 ### 实现一项需求的顺序
 
 1. 先运行 \`pnpm exec cage context "需求关键词"\`；按需 \`graph search\` 查候选、\`graph inspect\` 查完整节点、\`graph path\` 看关系路径。确认中文匹配入口后按源码位置阅读实现；候选和子图不是全部依赖，具体条件不能凭连线推断。完整用法见 \`docs/ai/ontology-context.md\`。从用户需求确定字段、状态/动作、角色/范围、约束与后续动作；能由业务声明表达的不改框架。
-2. 已有业务含义变化时，修改前保存本体图基线：\`pnpm exec cage analyze\` 后将 \`.cage/ontology.json\` 另存为独立文件；或使用真实 Git 基线。
+2. 已有业务含义变化时，修改前用 \`pnpm exec cage snapshot save before-change\` 保存不可覆盖的命名基线；或使用真实 Git 提交/独立本体图文件。
 3. 先声明 aggregate/states/command/constraints/event，再写 handler、reaction/query/approval/connector，最后接业务页面。声明使用模块顶层 \`export const\`，从 domain 入口导出，跨文件导出名保持唯一。
-4. 运行 \`pnpm exec cage check\` 和 \`pnpm gen\`，审查 contracts 和迁移草稿。按需运行 \`pnpm exec cage impact --base-file 旧图.json\`，补中文图谱名。
-5. 页面使用生成方法并处理 code/domainCode；新增能力由管理员授权。数据库结构变化审查后显式 \`pnpm migrate\`，dev 不代办迁移。
-6. 按改动运行必要验证，交付时说明体验步骤、授权配置、迁移，以及通过/跳过/未执行项。
+4. 运行 \`pnpm exec cage check\` 和 \`pnpm gen\`，审查 contracts 和迁移草稿。按需运行 \`pnpm exec cage impact --snapshot before-change\`，补中文图谱名。
+5. 页面使用生成方法并处理 code/domainCode；列表、详情等多页面注册到 React Router，Link/NavLink 导航，筛选/分页进入 URL。组件状态用于弹窗和表单等临时交互。新增能力由管理员授权。数据库结构变化审查后显式 \`pnpm migrate\`，dev 不代办迁移。
+6. 按 \`commenting.md\` 逐文件检查详细中文注释与实现一致，再按改动运行必要验证；交付时说明体验步骤、授权配置、迁移、注释覆盖，以及通过/跳过/未执行项。
 
 ### 必守边界
 
@@ -47,17 +81,25 @@ export const managedBlock = `<!-- cage:begin v${VERSION} -->
 - 自定义查询声明 reads，二选一使用 sql/build，只读 \`safe.*\`；值参数化。不得拼接 SQL、查询基表绕过范围或硬编码密钥。
 - scope 描述范围字段，角色数据决定实际范围；\`scope.none()\` 不代表所有人可访问。\`can/useCan\` 只控制按钮，后端负责授权。
 - 前端从 \`@app/contracts\` 导入生成 API/类型，按需使用 \`@yss123/cage-client\`；不导入 domain、内核或数据库包。
+- 多页面业务必须有独立 URL，不用 useState/tab 模拟整页导航；详情从 URL 取 ID 并独立加载。前端路由集中在 app，页面从模块公开入口接入 Outlet。登录后保留原路径/query/hash，401 回登录，403 展示权限提示；/admin/ 使用普通链接进入独立系统管理。前端路由不替代后端授权。实现、SPA 部署回退和浏览器配方见 docs/ai/routing.md。
 - 跨聚合写入通过 reaction 调用命令。\`tx: 'same'\` 共同提交/回滚，默认 outbox 异步执行。资源 acquires/releases 是图规则标签，实际占用/释放仍由命令完成；离开持有状态要检查每条释放路径。
-- 审批通过 approval + route 配置，结论是 process 命令；选中审批人不等于已具备能力、范围和额度。第三方 IO 通过连接器，回调验签后调用 external 命令。
+- 批量调用同一命令使用 reactionEach，声明 maxItems、唯一排序字段 orderBy、items 和 map；稳定键排序后串行执行。步骤依赖用 order，同事件同事务分组不得混用有序/无序或重复顺序。保持同事务回滚边界，见 docs/ai/primitives.md。
+- 审批通过 approval + route 配置，结论是 process 命令；选中审批人不等于已具备能力、范围和额度。parallel(title, ...branch(...)) 声明结构化 AND：分支同时开始，内部顺序独立，全部活动分支完成后汇合；when 支持嵌套并仍按提交快照求值，声明有深度/数量边界，不支持任意跳转。currentSteps 表示当前活动节点集合，兼容字段 currentStep 只是最小活动索引，不能据此隐藏其他分支。人工节点 assignment: 'candidate' 开放候选领取/释放，approver.field 从 routable 字段选人；actions 开放转办、委派归还和前后/并行必签。任务操作与决定携带 revision，waiting 任务只能查看。approvalOperations() 为框架通用时效运行时：step.sla 配置自然分钟节点总时限，route.reminders 配置申请人催办；迁移并运行 worker 后提供持久站内提醒、已读与 Admin 通用页面，不自动批准或授予权限。政策、SDK 和边界见 docs/ai/approvals.md。第三方 IO 通过连接器，回调验签后调用 external 命令。
 - job 的读取与调用必须列入 reads/calls。业务导入/导出放在需要的业务页面调用通用任务接口，202 只代表任务已接受；worker 必须运行。
 - 已部署事件只做兼容扩展；新增字段设为 optional，不兼容含义用新事件。已执行/已发布迁移不能改写，结构更新新增迁移。
 - 不手改生成物，不关闭门禁掩盖错误，不因方便自动授予生产角色新能力。unsafe 必须写明 reason/owner，不能替代普通业务声明。
-- 代码注释说明职责、关键流程和设计原因；避免无业务价值的防御分支和静默兜底。维护脚本用 TypeScript，不新增 .mjs。
+- 按前述详细中文注释规范完成文件、API、业务声明和关键流程说明；避免无业务价值的防御分支和静默兜底。维护脚本用 TypeScript，不新增 .mjs。
 
 ### 最小命令形状
 
 \`\`\`ts
 // 片段：Order 为已导出的聚合，OrderSubmitted 为事件，业务校验按需求添加。
+/**
+ * 将草稿订单提交审批：只有 draft 可进入 pending_approval。
+ * 入口使用 Order.submit 能力，真实授权、范围、状态和版本由内核检查；声明本身不自动授予权限。
+ * handler 返回草稿供后续校验和持久化，OrderSubmitted 随命令事务登记，后续由已配置消费者处理。
+ * 失败不会提交这次业务变更；事件已登记也不代表后续审批已经完成。
+ */
 export const submitOrder = command(Order, {
   name: 'submit',
   from: 'draft',
@@ -71,21 +113,31 @@ export const submitOrder = command(Order, {
 
 ### 启动、验证与排错
 
-在项目根目录执行：首次 \`pnpm install\`，复制并编辑 .env.example，仅提供已有库管理员连接后 \`pnpm exec cage init\`；再 \`pnpm build:app\`、\`pnpm gen\`，审查后 \`pnpm migrate\`，最后 \`pnpm dev\`。已有配置不能覆盖。
+在项目根目录执行：首次 \`pnpm install\`，复制并编辑 .env.example，仅提供已有库管理员连接后 \`pnpm exec cage init\`；再 \`pnpm build:app\`、\`pnpm gen\`，审查后 \`pnpm migrate\`；用 \`pnpm exec cage bootstrap --credentials-file .cage/admin-credentials.json\` 显式初始化组织，最后 \`pnpm dev\`。已有配置不能覆盖，凭据文件必须是新受限文件且父目录存在。
 
 init 只准备账号/schema/授权并填写三个连接，不创建数据库；APP/READ/MIGRATE 指向同一个库。已有集群账号复用原密码，日常启动不用管理员。普通项目不新增 Docker 生命周期命令。
 
+API 日常启动不初始化组织、不输出管理员密码；生产缺少合格 Cookie 密钥会拒绝启动。bootstrap 不自动授予业务能力。\`/healthz\` 只表示存活，\`/readyz\` 检查必要依赖。首阶段 API 与 worker 同版本部署，查看实际注册指纹和消费者心跳。
+
 - \`pnpm exec cage graph\`：浏览器图谱，默认端口 15418，以终端为准。
 - \`pnpm exec cage context command:对象.命令 --format json --out .cage/context.json\`：按完整 key 取精简上下文；默认 Markdown，可用 --depth/--limit 调整范围。CLI 每次重新抽取；Web“复制 AI 上下文”使用当前页面快照，改代码后先刷新图谱。
-- \`graph inspect/path\` 有歧义时复制候选完整 key；path 默认沿箭头，--direction both 的逆向遍历不表示执行方向。报告中的测试/前端文件是候选，须核对；查询也会覆盖当前 .cage/ontology.json，旧基线务必另存。
+- \`graph inspect/path\` 有歧义时复制候选完整 key；path 默认沿箭头，--direction both 的逆向遍历不表示执行方向。报告中的测试/前端文件是候选，须核对；context 与图谱查询不覆盖当前图或命名快照。
+- \`pnpm exec cage capabilities 关键词 --format json\`：查当前安装版本公开签名；\`cage doctor\`：区分注册、生成、构建、迁移、授权与实际进程证据，unknown 不能当作通过。\`cage timeline/explain\` 关联实际异步证据与解释授权，参数和权限见 docs/ai/diagnostics.md。
+- 生成方法支持 signal/timeoutMs/idempotencyKey 请求选项。底层 CageResult 与 mutation 行为有区别：useCageCommand 失败抛 CageCommandError，成功才返回业务数据。订阅 client.subscribe 在退出、401、切换账号时取消查询并清除应用缓存。
 - \`pnpm exec cage gen --check\`：生成一致性；\`pnpm exec cage sync --check\`：本托管区一致性。
 - \`pnpm exec cage test --only project\`：业务测试；\`pnpm verify\`：类型、依赖、lint、图规则、生成、托管区、预算和测试。
 - \`pnpm exec cage verify --skip-tests\` 表示不完整门禁；派生测试跳过不能当作通过。测试连接只用独立测试集群。
 - 重要业务改动验证成功路径及有风险的反例；文档或可逆的小改动不反复跑全量数据库测试。
+- 修改页面/导航后实际验收深链接、刷新、前进后退、登录回跳、无权限和 404；生产再查 SPA 回退。check/verify 不自动完成浏览器验收，未执行要明确报告。见 docs/ai/routing.md。
 - CLI 报错先看 code/at/reason/fix，再查错误码册；HTTP 错误查 runtime.md。异步失败先看 worker、同步记录和死信，修复后重放，不能直接 SQL 改状态。
 
 框架托管区由 cage sync 更新；项目独有的业务规则写在标记之外，避免升级覆盖。
 <!-- cage:end -->`;
+/**
+ * 将现有文档中的唯一托管区替换为目标版本，返回完整文本而不写文件。
+ * 未出现任何标记时把托管区放在原文前；缺一个标记、标记重复或顺序反转时拒绝处理，
+ * 避免猜测边界后覆盖用户内容。latest 可由调用者提供，默认使用本包规范。
+ */
 export function syncManagedBlock(current, latest = managedBlock) {
     const starts = [...current.matchAll(/<!-- cage:begin[^\n]*-->/g)];
     const ends = [...current.matchAll(/<!-- cage:end -->/g)];
@@ -96,6 +148,11 @@ export function syncManagedBlock(current, latest = managedBlock) {
     }
     return current.slice(0, starts[0].index) + latest + current.slice(ends[0].index + ends[0][0].length);
 }
+/**
+ * 在项目根目录同步或检查 AGENTS.md，不遍历和改写项目源码。
+ * check=true 时只比较并返回 CAGE-SYNC-001 修复提示；普通模式在内容变化时创建父目录并写入。
+ * 没有差异时返回空诊断。托管标记异常由 syncManagedBlock 抛出，文件系统错误向调用方传播。
+ */
 export function sync(cfg, check = false) {
     const file = abs(cfg, 'AGENTS.md');
     const before = existsSync(file) ? readFileSync(file, 'utf8') : '';

package/dist/sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"sync.js","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,GAAG,EAAmB,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmFrC,CAAC;AAEnB,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,MAAM,GAAG,YAAY;IACrE,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACrE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,KAAM,EAAE,CAAC;QAClF,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACxG,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAe,EAAE,KAAK,GAAG,KAAK;IACjD,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IAChC,IAAI,KAAK;QACP,OAAO;YACL;gBACE,IAAI,EAAE,eAAe;gBACrB,EAAE,EAAE,WAAW;gBACf,MAAM,EAAE,WAAW;gBACnB,GAAG,EAAE,wBAAwB;aAC9B;SACF,CAAC;IACJ,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3B,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,GAAG,EAAmB,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,oDAAoD;AACpD,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA2HrC,CAAC;AAEnB;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,MAAM,GAAG,YAAY;IACrE,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACrE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,KAAM,EAAE,CAAC;QAClF,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACxG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,GAAe,EAAE,KAAK,GAAG,KAAK;IACjD,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IAChC,IAAI,KAAK;QACP,OAAO;YACL;gBACE,IAAI,EAAE,eAAe;gBACrB,EAAE,EAAE,WAAW;gBACf,MAAM,EAAE,WAAW;gBACnB,GAAG,EAAE,wBAAwB;aAC9B;SACF,CAAC;IACJ,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3B,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/upgrade.d.ts

@@ -1,8 +1,24 @@
 import { type CageConfig } from './config.js';
 export { VERSION } from './version.js';
+/**
+ * 递归收集清单，跳过隐藏目录、node_modules、dist 与 generated。
+ * @param root 扫描根目录。
+ * @returns package.json 路径；只读目录，不安装依赖，访问错误抛出。
+ */
 export declare function projectManifests(root: string): string[];
 /** 0.1 接收早期样例里的 caller 写法，运行时规范名为 invokedBy。只改从 kernel 导入的 command。 */
+/**
+ * 把直接 kernel command 调用中的旧 caller 属性改为 invokedBy。
+ * @param source 内存源码文本，不在本函数写盘。
+ * @returns 改写文本；新旧属性同时存在抛错误，命名空间或其他调用不猜改。
+ */
 export declare function codemodSource(source: string): string;
+/**
+ * 收集并按需应用目标版本清单与领域 codemod。
+ * @param cfg 当前应用位置。
+ * @param opts to 须等于当前 CLI，dryRun 只列路径，codemodsOnly 不升级清单。
+ * @returns 清单/源码变化路径，AGENTS 同步不列入其中；不自动回滚或运行后续安装验证。
+ */
 export declare function upgrade(cfg: CageConfig, opts?: {
     to?: string;
     dryRun?: boolean;

package/dist/upgrade.js

@@ -1,3 +1,8 @@
+/**
+ * 目标版本 CLI 携带的清单升级及早期声明 codemod，供 upgrade 命令调用。
+ * 收集待改清单和领域源码，dryRun 只返回路径；实际应用写入文件后同步 AGENTS 托管区。
+ * 这里只支持当前 CLI 版本，不安装依赖或执行验证；后续步骤由 main 完成，失败保留可审查改动，不改历史 SQL。
+ */
 import { readFileSync, readdirSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { Project, SyntaxKind } from 'ts-morph';
@@ -6,6 +11,11 @@ import { sync } from './sync.js';
 import { listTs } from './static-check.js';
 import { VERSION } from './version.js';
 export { VERSION } from './version.js';
+/**
+ * 递归收集清单，跳过隐藏目录、node_modules、dist 与 generated。
+ * @param root 扫描根目录。
+ * @returns package.json 路径；只读目录，不安装依赖，访问错误抛出。
+ */
 export function projectManifests(root) {
     const out = [];
     const walk = (dir) => {
@@ -23,6 +33,11 @@ export function projectManifests(root) {
     return out;
 }
 /** 0.1 接收早期样例里的 caller 写法，运行时规范名为 invokedBy。只改从 kernel 导入的 command。 */
+/**
+ * 把直接 kernel command 调用中的旧 caller 属性改为 invokedBy。
+ * @param source 内存源码文本，不在本函数写盘。
+ * @returns 改写文本；新旧属性同时存在抛错误，命名空间或其他调用不猜改。
+ */
 export function codemodSource(source) {
     const project = new Project({ useInMemoryFileSystem: true });
     const file = project.createSourceFile('domain.ts', source);
@@ -44,6 +59,12 @@ export function codemodSource(source) {
     }
     return file.getFullText();
 }
+/**
+ * 收集并按需应用目标版本清单与领域 codemod。
+ * @param cfg 当前应用位置。
+ * @param opts to 须等于当前 CLI，dryRun 只列路径，codemodsOnly 不升级清单。
+ * @returns 清单/源码变化路径，AGENTS 同步不列入其中；不自动回滚或运行后续安装验证。
+ */
 export function upgrade(cfg, opts = {}) {
     const version = opts.to ?? VERSION;
     if (version !== VERSION)

package/dist/upgrade.js.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../src/upgrade.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../src/upgrade.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,GAAG,EAAmB,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE;QAC3B,KAAK,MAAM,CAAC,IAAI,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC1D,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC/F,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,CAAC,WAAW,EAAE;gBAAE,IAAI,CAAC,IAAI,CAAC,CAAC;iBAC3B,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc;gBAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,CAAC;IACX,OAAO,GAAG,CAAC;AACb,CAAC;AAED,uEAAuE;AACvE;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,IAAI,GAAG,CACnB,IAAI;SACD,qBAAqB,EAAE;SACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,uBAAuB,EAAE,KAAK,qBAAqB,CAAC;SACpE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CACb,CAAC;SACE,eAAe,EAAE;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,SAAS,CAAC;SACxC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAC1D,CACJ,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACxE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,CAAC;YAAE,SAAS;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;QAC/E,MAAM,GAAG,GAAG,GAAG,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;QAC9E,IAAI,GAAG,IAAI,GAAG,EAAE,WAAW,CAAC,WAAW,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CACrB,GAAe,EACf,OAAkE,EAAE;IAEpE,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,IAAI,OAAO,CAAC;IACnC,IAAI,OAAO,KAAK,OAAO;QACrB,MAAM,IAAI,KAAK,CACb,iCAAiC,OAAO,6CAA6C,CACtF,CAAC;IACJ,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,IAAI,CAAC,IAAI,CAAC,YAAY;QACpB,KAAK,MAAM,IAAI,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC7B,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,KAAK,MAAM,KAAK,IAAI,CAAC,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,sBAAsB,CAAC,EAAE,CAAC;gBACpG,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;oBAC5C,IAAI,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;wBACnE,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;wBACzB,OAAO,GAAG,IAAI,CAAC;oBACjB,CAAC;YACL,CAAC;YACD,IAAI,OAAO;gBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACpE,CAAC;IACH,mCAAmC;IACnC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,MAAM,KAAK,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,OAAO;YAAE,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACpE,IAAI,CAAC,GAAG,CAAC,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/verify.d.ts

@@ -1,6 +1,20 @@
 import { type CageConfig } from './config.js';
 import type { Ontology } from './ontology.js';
+/**
+ * 生成通用性质用例并执行 Vitest，先删除旧报告避免读取历史成功结果。
+ * @param cfg 应用与生成目录配置。
+ * @param graph 当前本体。
+ * @param only 可限定派生或项目用例，项目模式允许无测试。
+ * @returns 进程和 JSON 报告共同确定的退出码；pending 会提示，但不单独使本函数失败。
+ */
 export declare function testProject(cfg: CageConfig, graph: Ontology, only?: 'derived' | 'project'): Promise<number>;
+/**
+ * 依次执行门禁并写入当前阶段结果，首个失败后停止。
+ * @param cfg 类型、依赖、源码和生成目录配置。
+ * @param opts 可提供语义基线；skipTests 省略整个测试阶段。
+ * @returns 0 表示已执行门禁通过，1 表示失败，工具启动或文件异常仍可抛出。
+ * complete 当前描述是否省略整个测试阶段，具体 pending 仍需读取 test-results.json。
+ */
 export declare function verify(cfg: CageConfig, opts?: {
     base?: Ontology;
     skipTests?: boolean;