@yss123/cage-cli 0.2.0 → 0.3.1

package/dist/capabilities.js

@@ -0,0 +1,148 @@
+/**
+ * 按当前安装包的声明文件建立公开能力目录，供 agent 查真实签名与本地指南。
+ * 依次尝试领域、契约、Web、项目及 CLI 的依赖边界，用 TypeScript 类型检查器解析公开导出。
+ * 关键词提示只帮助召回，不创造不存在的 API；未解析到包或声明文件时记录未检查，不据此判定框架不支持。
+ */
+// Public capability discovery reads installed declarations, never framework implementation bodies.
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import ts from 'typescript';
+import { abs } from './config.js';
+import { VERSION } from './version.js';
+const modules = ['kernel', 'approval', 'connectors', 'client', 'admin', 'files', 'ai', 'ai-protocol', 'ontology'];
+// 关键词负责把需求指向真实公开符号；签名仍来自当前安装包，不能用词表伪造可用 API。
+const topics = {
+    ai: { words: '智能助理 业务助理 本体助理 全能助理 AI审批 AI 审批 智能审批 运行时 执行循环 loop 工具 会话 记忆 上下文预算', guide: 'intelligence.md',
+        limitations: ['须从 domain 入口导出并完成迁移、模型配置、角色授权和 worker 启动；框架支持不代表应用已启用。'] },
+    AiContextOptions: { words: '上下文预算 上下文窗口 大本体 按需加载 工具发现 工具搜索 历史 记忆 token', guide: 'intelligence.md' },
+    chatModel: { words: '模型接入 Chat Completions 流式输出 fake', guide: 'intelligence.md' },
+    responsesModel: { words: '模型接入 Responses 接口协议 会话接续 previous_response_id 服务端压缩', guide: 'intelligence.md',
+        limitations: ['Responses 接口可用不等于网关支持接续或压缩；接续历史仍占上下文与输入用量。'] },
+    managedModel: { words: '模型管理 模型配置 动态配置 密钥 admin HTTP HTTPS Chat Completions Responses', guide: 'intelligence.md',
+        limitations: ['Admin 管理需显式授予 Sys.ai.models.manage，并配置部署加密密钥；连接测试不代表工具和业务联调通过。'] },
+    '@yss123/cage-approval#step': { words: '审批步骤 AI审批 AI 审批 智能审批 通过 退回修改 转人工', guide: 'intelligence.md',
+        limitations: ['AI 使用 step 的 kind: ai 重载；handoff 指定本步骤接管人，角色与结论命令仍须授权。'] },
+    AiStepOptions: { words: 'AI审批 AI 审批 智能审批 审核策略 退回修改 转人工', guide: 'intelligence.md' },
+    AiDecision: { words: 'AI审批 AI 审批 智能审批 三态裁决 通过 退回修改 转人工', guide: 'intelligence.md' },
+    useAssistant: { words: '智能助理 业务助理 本体助理 全能助理 随页助理 会话 前端 SDK 性格 流式输出 悬浮窗 Markdown', guide: 'intelligence.md',
+        limitations: ['SDK 提供状态与动作；悬浮窗、Markdown 和交互卡片由应用实现，不能等待发送 Promise 完成后才展示增量文字。'] },
+    AiClient: { words: '业务助理 随页助理 前端 SDK 会话 记忆 性格 流式输出 模型管理', guide: 'intelligence.md' },
+    AiPageContext: { words: '页面上下文 随页助理 当前页面 快照 选中项 草稿 标签页', guide: 'intelligence.md' },
+    useAiPageContext: { words: '页面上下文 随页助理 当前页面 快照 选中项 草稿 标签页', guide: 'intelligence.md',
+        limitations: ['应用主动提供语义快照，SDK 不抓取整个 DOM；服务端按当前身份重新读取并校验业务对象。'] },
+    PageContext: { words: '页面上下文 随页助理 当前页面 快照 选中项 草稿 标签页', guide: 'intelligence.md' },
+    AiPersonality: { words: '性格 人设 表达风格 默认预设 admin', guide: 'intelligence.md',
+        limitations: ['性格只影响助理表达，不改变权限、工具或审批策略；管理需 Sys.ai.personalities.manage。'] },
+    AiPersonalityInput: { words: '性格 人设 表达风格 自定义配置', guide: 'intelligence.md' },
+    runtimeOntology: { words: '领域本体 业务本体 本体助理 自动工具 运行时', guide: 'intelligence.md' },
+    file: { words: '文件 附件 上传 单文件', guide: 'files.md' },
+    files: { words: '文件 附件 上传 多文件', guide: 'files.md' },
+    FileService: { words: '文件 断点续传 分片 上传 存储', guide: 'files.md' },
+    FileStorage: { words: '文件 对象存储 S3 适配器', guide: 'files.md' },
+    LocalFileStorage: { words: '文件 本地 私有 存储', guide: 'files.md' },
+    FileUploadTask: { words: '文件 上传 暂停 恢复 断点续传', guide: 'files.md' },
+    scope: { words: '本人 owner 部门 数据范围 授权', guide: 'architecture.md' },
+    reaction: { words: '跨对象 事务 事件 反应 原子', guide: 'primitives.md' },
+    reactionEach: { words: '批量 集合 多条 上限 顺序 事务', guide: 'diagnostics.md' },
+    approver: { words: '审批 选人 部门负责人 角色 单据字段 人员数组', guide: 'approvals.md' },
+    '@yss123/cage-approval#parallel': { words: '审批 并行 网关 AND 分叉 汇合 多部门 分支 同时 联合会审', guide: 'approvals.md',
+        limitations: ['结构化 AND 分支同时开始，全部活动分支完成后继续；when 仍按启动快照求值，不支持任意跳转或运行中修改路线。'] },
+    '@yss123/cage-approval#branch': { words: '审批 并行 分支 内部顺序 嵌套 条件 AND 汇合', guide: 'approvals.md' },
+    InCodeEngine: { words: '复杂OA 审批 转办 转签 委派 归还 加签 前签 后签 并行必签 候选 领取 释放 claim unclaim 任务 操作历史 revision', guide: 'approvals.md',
+        limitations: ['候选领取由 assignment 声明，任务操作由 actions 开放；自然分钟 SLA 需 approvalOperations；parallel/branch 支持结构化 AND，并非任意流程图，不支持指定节点退回或管理员人员恢复。'] },
+    approvalOperations: { words: '审批 流程 时限 SLA 到期 临期 超时 提醒 站内通知 催办 已读 我的申请', guide: 'approvals.md',
+        limitations: ['显式导出运行时并迁移、启动 worker；step.sla 按自然分钟计时，route.reminders 限定申请人。没有工作日历、自动升级或外部通知。'] },
+    ApprovalNotice: { words: '审批 流程 提醒 站内通知 临期 超时 催办 已读', guide: 'approvals.md' },
+    TaskActionPolicy: { words: '审批 转办 委派 归还 加签 节点政策', guide: 'approvals.md' },
+    TaskActionInput: { words: '审批任务 输入 版本 原因 转办 委派 加签 前签 后签 领取 释放', guide: 'approvals.md' },
+    ApprovalTaskAction: { words: '前端 SDK 审批 转办 委派 归还 加签 候选 领取 释放', guide: 'approvals.md' },
+    CageClient: { words: '客户端 SDK 审批 转办 委派 归还 加签 操作历史 时限 提醒 催办 已读', guide: 'approvals.md' },
+    connector: { words: '第三方 ERP 外呼 外部', guide: 'primitives.md' },
+    command: { words: '命令 写入 校验 业务操作', guide: 'primitives.md' },
+    query: { words: '查询 报表 安全读取', guide: 'primitives.md' },
+};
+const examples = {
+    ai: "export const intelligence = ai({ models: { main: managedModel('main') }, assistant: { model: 'main', confirmWrites: true } })",
+    managedModel: "models: { main: managedModel('main') } // ai() 的配置片段；连接信息在 Admin 保存",
+    '@yss123/cage-approval#step': "step('材料预审', { kind: 'ai', model: 'main', instructions: '资料不足时转人工，并说明缺失信息。', context: { fields: ['reason'] }, handoff: approver.role('reviewer') })",
+    useAssistant: 'const assistant = useAssistant(client.ai, page); // page 由 useAiPageContext 提供，按 streamingText / progress 渲染',
+    scope: "scope.self('applicantId'); scope.deptSubtree('deptId', 'applicantId')",
+    reaction: "reaction(OrderApproved, { command: reserve, tx: 'same', map: event => ({ id: event.stockId }) })",
+    reactionEach: "reactionEach(Allocated, { command: reserve, tx: 'same', order: 2, maxItems: 20, orderBy: 'id', items: event => event.devices, map: item => ({ id: item.id }) })",
+    approver: "step('部门负责人', approver.deptLeader('deptId'))",
+    '@yss123/cage-approval#parallel': "parallel('联合会审', branch('业务', step('业务审核', approver.role('reviewer'))), branch('财务', step('财务审核', approver.role('finance'))))",
+    '@yss123/cage-approval#branch': "branch('法务', step('合同核查', approver.role('legal')), step('法务复核', approver.role('legal_lead')))",
+    approvalOperations: 'export const approvalOps = approvalOperations(); // 再在人工 step 声明 sla、route 声明 reminders，并从 domain 入口导出',
+    query: "query('recentOrders', { reads: [Order], input: z.object({}), sql: 'select id from safe.order limit 20' })",
+};
+/**
+ * 读取安装版本的公开导出签名，按关键词筛选可用 API 的证据。
+ * 查询只做归一化后的连续文本包含判断，不进行同义词推理；无结果和未检查包都不能说明能力不存在。
+ * @param cfg 用于定位应用不同包的依赖解析边界。
+ * @param query 公开名称、JSDoc 或维护的业务词条；空字符串返回全部已发现符号。
+ * @returns 包检查状态、真实签名、声明位置和本地 guide；不加载运行时实现或修改文件。
+ */
+export function publicCapabilities(cfg, query = '') {
+    const requests = [createRequire(abs(cfg, cfg.domain)), createRequire(abs(cfg, `${cfg.contracts}/index.ts`)), createRequire(abs(cfg, `${cfg.web}/package.json`)), createRequire(abs(cfg, 'package.json')), createRequire(import.meta.url)];
+    const packages = modules.flatMap(module => {
+        const name = `@yss123/cage-${module}`;
+        try {
+            const workspace = abs(cfg, `packages/${module}/package.json`);
+            const resolvers = existsSync(workspace) ? [createRequire(workspace), ...requests] : requests;
+            let resolved;
+            for (const request of resolvers) {
+                try {
+                    resolved = request.resolve(name);
+                    break;
+                }
+                catch { /* Try the next configured package boundary. */ }
+            }
+            if (!resolved)
+                return [{ name, version: null, entry: null }];
+            const entry = resolved.replace(/\.js$/, '.d.ts');
+            const manifest = join(dirname(dirname(entry)), 'package.json');
+            if (!existsSync(entry))
+                return [{ name, version: null, entry: null }];
+            return [{ name, version: JSON.parse(readFileSync(manifest, 'utf8')).version, entry }];
+        }
+        catch {
+            return [{ name, version: null, entry: null }];
+        }
+    });
+    const entries = packages.flatMap(p => p.entry ? [p.entry] : []);
+    const program = ts.createProgram(entries, { target: ts.ScriptTarget.ESNext, module: ts.ModuleKind.NodeNext, moduleResolution: ts.ModuleResolutionKind.NodeNext, skipLibCheck: true });
+    const checker = program.getTypeChecker();
+    const needle = query.normalize('NFKC').toLowerCase();
+    const capabilities = packages.flatMap(pkg => {
+        if (!pkg.entry)
+            return [];
+        const file = program.getSourceFile(pkg.entry);
+        const module = file && checker.getSymbolAtLocation(file);
+        if (!module)
+            return [];
+        return checker.getExportsOfModule(module).flatMap(symbol => {
+            const target = symbol.flags & ts.SymbolFlags.Alias ? checker.getAliasedSymbol(symbol) : symbol;
+            const declaration = target.declarations?.[0];
+            if (!declaration)
+                return [];
+            const name = symbol.name;
+            const description = ts.displayPartsToString(target.getDocumentationComment(checker));
+            // 内核日志和审批路由都导出 step；同名符号的用法必须按包限定。
+            const key = `${pkg.name}#${name}`, topic = topics[key] ?? topics[name];
+            const example = examples[key] ?? examples[name];
+            if (needle && !`${name} ${description} ${topic?.words ?? ''}`.normalize('NFKC').toLowerCase().includes(needle))
+                return [];
+            const type = checker.getTypeOfSymbolAtLocation(target, declaration);
+            const signatures = checker.getSignaturesOfType(type, ts.SignatureKind.Call).map(s => checker.signatureToString(s, declaration, ts.TypeFormatFlags.NoTruncation));
+            return [{ key, package: pkg.name, version: pkg.version, name, public: true, description,
+                    signatures: signatures.length ? signatures : [declaration.getText().slice(0, 6000)],
+                    guide: `docs/ai/${topic?.guide ?? 'README.md'}`, example: example ? { code: example, context: '组合片段；声明中的业务符号须来自当前项目，完整可运行例子见 guide' } : undefined,
+                    limitations: topic ? ['能力和数据范围仍由实际授权决定；按照当前签名与指南使用。', ...(topic.limitations ?? [])] : [],
+                    source: { file: declaration.getSourceFile().fileName, line: declaration.getSourceFile().getLineAndCharacterOfPosition(declaration.getStart()).line + 1 } }];
+        });
+    });
+    return { schemaVersion: 1, cliVersion: VERSION, query, packages: packages.map(({ entry, ...p }) => ({ ...p, inspected: !!entry })), capabilities,
+        limitations: ['仅展示当前安装版本的公共导出；签名不代表任意组合均有效。按 guide 查看最小例子、限制及相关错误码。', '未安装的包标为未检查，不据此断言框架不支持。'] };
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

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

package/dist/config.d.ts

@@ -1,5 +1,11 @@
+/**
+ * 各 CLI 职责共用的有效应用配置；相对路径均以 root 为基准。
+ * 默认值由 loadConfig 提供，调用方可覆盖布局；本类型不承担配置内容的运行时校验。
+ */
 export interface CageConfig {
+    /** 应用根目录的绝对路径，其余相对路径经 abs 以此解析。 */
     root: string;
+    /** 项目显示名称，用于报告与默认图谱标题。 */
     name: string;
     /** domain 包入口：抽取器和内核都从这里读 */
     domain: string;
@@ -7,10 +13,15 @@ export interface CageConfig {
     contracts: string;
     /** contracts 包名（前端从这里引入） */
     contractsPackage: string;
+    /** SQL 迁移及新生成草稿所在目录，不会由配置加载自动执行。 */
     migrations: string;
+    /** CLI 托管输出目录，保存派生测试、路由/能力清单与安全层 SQL；迁移草稿写入 migrations。 */
     generated: string;
+    /** 开发模式启动 API 的 TypeScript 入口路径。 */
     apiEntry: string;
+    /** 开发模式启动 worker 的 TypeScript 入口路径。 */
     workerEntry: string;
+    /** 前端应用目录，dev 在此启动配置的开发脚本。 */
     web: string;
     /** 需要类型检查的目录（各自有 tsconfig.json） */
     typecheck: string[];
@@ -18,13 +29,31 @@ export interface CageConfig {
     lint: string[];
     /** 新脚手架启用模块目录约束；旧项目可整理后显式开启，不因升级 CLI 被迫迁移。 */
     structure?: 'modular';
-    /** 图谱的显示文案独立于业务标识；键为“节点类型:节点 ID”，不影响路由、
-     * 数据表、能力点和影响分析。可用短标题覆盖较长的声明 description。 */
+    /** 图谱的显示文案独立于业务标识；键为“节点类型:节点 ID”，板块标题可用
+     * “module:模块目录名”，审批角色使用“role:角色编码”。不影响路由、数据表、能力点和影响分析。
+     * 可用短标题覆盖较长的声明 description。 */
     graph?: {
         title?: string;
         labels?: Record<string, string>;
     };
 }
+/**
+ * 沿父目录寻找 Cage 应用根，以配置文件优先，其次识别依赖 CLI 的清单。
+ * @param start 起始目录，默认当前工作目录。
+ * @returns 首个匹配的绝对目录；到文件系统根仍未匹配时返回原起点。
+ * @throws 遇到不可读取或非法 JSON 清单时抛出，不静默忽略损坏配置。
+ */
 export declare function findRoot(start?: string): string;
+/**
+ * 加载应用配置并填充标准目录约定，不创建任何目录。
+ * @param start 用于向上寻找根目录的可选起点。
+ * @returns 默认值被 package.cage 与 cage.config.json 依次覆盖后的配置，root 始终是实际识别根。
+ */
 export declare function loadConfig(start?: string): CageConfig;
+/**
+ * 将配置中的相对路径解析为绝对路径，供各命令一致定位文件。
+ * @param cfg 提供 root 的有效配置。
+ * @param p 相对或绝对路径；绝对路径按 Node resolve 规则保留。
+ * @returns 规范化绝对路径；本函数不限制目录逃逸，也不检查存在性。
+ */
 export declare const abs: (cfg: CageConfig, p: string) => string;

package/dist/config.js

@@ -1,6 +1,17 @@
+/**
+ * CLI 的应用根目录识别与路径配置装配，所有工具通过本模块取得一致目录约定。
+ * 向上寻找 cage.config.json 或依赖 cage-cli 的包清单，再按默认值、package.cage、配置文件顺序合并。
+ * 仅执行文件读取和路径解析；不验证配置架构、不加载环境变量，也不把路径解析当成目录访问授权。
+ */
 // 项目配置：默认值对应模板生成的目录结构，cage.config.json 可以覆盖。
 import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
+/**
+ * 沿父目录寻找 Cage 应用根，以配置文件优先，其次识别依赖 CLI 的清单。
+ * @param start 起始目录，默认当前工作目录。
+ * @returns 首个匹配的绝对目录；到文件系统根仍未匹配时返回原起点。
+ * @throws 遇到不可读取或非法 JSON 清单时抛出，不静默忽略损坏配置。
+ */
 export function findRoot(start = process.cwd()) {
     let dir = resolve(start);
     for (;;) {
@@ -18,6 +29,11 @@ export function findRoot(start = process.cwd()) {
         dir = up;
     }
 }
+/**
+ * 加载应用配置并填充标准目录约定，不创建任何目录。
+ * @param start 用于向上寻找根目录的可选起点。
+ * @returns 默认值被 package.cage 与 cage.config.json 依次覆盖后的配置，root 始终是实际识别根。
+ */
 export function loadConfig(start) {
     const root = findRoot(start);
     const file = join(root, 'cage.config.json');
@@ -42,5 +58,11 @@ export function loadConfig(start) {
     };
     return { ...c, root };
 }
+/**
+ * 将配置中的相对路径解析为绝对路径，供各命令一致定位文件。
+ * @param cfg 提供 root 的有效配置。
+ * @param p 相对或绝对路径；绝对路径按 Node resolve 规则保留。
+ * @returns 规范化绝对路径；本函数不限制目录逃逸，也不检查存在性。
+ */
 export const abs = (cfg, p) => resolve(cfg.root, p);
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2BnD,MAAM,UAAU,QAAQ,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE;IAC5C,IAAI,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACzB,SAAS,CAAC;QACR,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACtC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;YAChD,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,IAAI;gBAC3F,OAAO,GAAG,CAAC;QACf,CAAC;QACD,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,EAAE,KAAK,GAAG;YAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,GAAG,GAAG,EAAE,CAAC;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAChD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9D,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,CAAC,GAAG;QACR,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,UAAU;QAC5B,MAAM,EAAE,8BAA8B;QACtC,SAAS,EAAE,wBAAwB;QACnC,gBAAgB,EAAE,gBAAgB;QAClC,UAAU,EAAE,eAAe;QAC3B,SAAS,EAAE,WAAW;QACtB,QAAQ,EAAE,sBAAsB;QAChC,WAAW,EAAE,wBAAwB;QACrC,GAAG,EAAE,UAAU;QACf,SAAS,EAAE,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,UAAU,EAAE,UAAU,CAAC;QAC5E,IAAI,EAAE,CAAC,qBAAqB,EAAE,cAAc,EAAE,cAAc,CAAC;QAC7D,GAAG,GAAG,CAAC,IAAI;QACX,GAAG,IAAI;KACR,CAAC;IACF,OAAO,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,GAAe,EAAE,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,6CAA6C;AAC7C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuCnD;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE;IAC5C,IAAI,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACzB,SAAS,CAAC;QACR,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACtC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;YAChD,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,IAAI;gBAC3F,OAAO,GAAG,CAAC;QACf,CAAC;QACD,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,EAAE,KAAK,GAAG;YAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,GAAG,GAAG,EAAE,CAAC;IACX,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAChD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9D,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,CAAC,GAAG;QACR,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,UAAU;QAC5B,MAAM,EAAE,8BAA8B;QACtC,SAAS,EAAE,wBAAwB;QACnC,gBAAgB,EAAE,gBAAgB;QAClC,UAAU,EAAE,eAAe;QAC3B,SAAS,EAAE,WAAW;QACtB,QAAQ,EAAE,sBAAsB;QAChC,WAAW,EAAE,wBAAwB;QACrC,GAAG,EAAE,UAAU;QACf,SAAS,EAAE,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,UAAU,EAAE,UAAU,CAAC;QAC5E,IAAI,EAAE,CAAC,qBAAqB,EAAE,cAAc,EAAE,cAAc,CAAC;QAC7D,GAAG,GAAG,CAAC,IAAI;QACX,GAAG,IAAI;KACR,CAAC;IACF,OAAO,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,GAAe,EAAE,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC"}

package/dist/context.d.ts

@@ -1,6 +1,15 @@
 import { type CageConfig } from './config.js';
 import type { GraphSnapshot } from './graph-snapshot.js';
 import { type GraphNodeInfo } from './graph-query.js';
+/**
+ * 从需求候选或精确节点构建有界业务上下文。
+ * 优先扩展执行关系，聚合/字段等附带资料停止继续传播，降低高连接节点造成的上下文膨胀。
+ * @param cfg 应用文件位置。
+ * @param snapshot 单次抽取快照，查询不会更新它。
+ * @param query 业务词或完整节点 key。
+ * @param options depth 默认 3，limit 默认 40，freshness 区分本次抽取与页面快照。
+ * @returns 子图、选择依据、覆盖边界和建议；未命中返回 not-found，不猜造节点。
+ */
 export declare function buildContext(cfg: CageConfig, snapshot: GraphSnapshot, query: string, options?: {
     depth?: number;
     limit?: number;
@@ -69,4 +78,9 @@ export declare function buildContext(cfg: CageConfig, snapshot: GraphSnapshot, q
     findings: import("./findings.js").Finding[];
     limitations: string[];
 };
+/**
+ * 把结构化上下文渲染为可交给 agent 的 Markdown，保留候选和证据限制。
+ * @param report buildContext 的完整报告。
+ * @returns Markdown 文本；不写文件、不执行报告中的下一步命令。
+ */
 export declare function formatContext(report: ReturnType<typeof buildContext>): string;

package/dist/context.js

@@ -1,3 +1,8 @@
+/**
+ * 为编程 agent 组织需求相关子图、源码位置、契约及验证候选，供 CLI 与本地图谱共用。
+ * 从精确节点或名称候选出发做有界扩展，再读取项目测试与 Web 源码补充文本匹配线索。
+ * 不执行推荐测试、不访问业务数据；输出截断、深度边界与证据来源，不能替代源码阅读或业务验收。
+ */
 // 开发前的上下文包：沿声明截取一小块业务图，并列出继续阅读的源码及检查线索。
 // 这里只读取工程源码、文件名和已抽取元数据，不读取 .env，不连接业务数据库。
 import { existsSync, globSync, readFileSync } from 'node:fs';
@@ -8,10 +13,24 @@ import { deriveTests } from './derive.js';
 import { selectRelatedTests } from './impact.js';
 import { graphReader, relationMarkdown, reportFooter, reportHeader, sourceText, } from './graph-query.js';
 /** 只去掉实现哈希，保留输入、状态、约束、范围等可读事实。要看完整原始属性用 inspect。 */
+/**
+ * 移除实现文本及实现哈希等大属性，保留输入、状态、约束和字段 SQL 等可读事实。
+ * @param node 已附证据与源码位置的节点。
+ * @returns 浅拷贝节点和筛选后的 attrs，不修改快照；完整原始属性仍由 inspect 提供。
+ */
 function compactNode(node) {
     const attrs = Object.fromEntries(Object.entries(node.attrs).filter(([key]) => !['src', 'invariantSrc', 'sql', 'build'].includes(key) || (key === 'sql' && node.kind === 'field')));
     return { ...node, attrs };
 }
+/**
+ * 补齐子图之外需要阅读的契约、测试、Web 候选和迁移目录说明。
+ * 按聚合/查询名扫描源码，不进行完整导入图分析；候选只是线索，未执行或证明覆盖。
+ * @param cfg 文件定位配置。
+ * @param snapshot 本次抽取图，供派生测试筛选使用。
+ * @param nodes 子图节点。
+ * @param roots 真正选定入口，避免把附带聚合的全部测试都带入。
+ * @returns 带存在性、截断数量及匹配依据的资源清单；只读项目文件。
+ */
 function contextResources(cfg, snapshot, nodes, roots) {
     const sourceFiles = [...new Set(nodes.flatMap((node) => (node.source ? [node.source.file] : [])))].sort();
     const aggregates = [
@@ -77,6 +96,15 @@ function contextResources(cfg, snapshot, nodes, roots) {
         },
     };
 }
+/**
+ * 从需求候选或精确节点构建有界业务上下文。
+ * 优先扩展执行关系，聚合/字段等附带资料停止继续传播，降低高连接节点造成的上下文膨胀。
+ * @param cfg 应用文件位置。
+ * @param snapshot 单次抽取快照，查询不会更新它。
+ * @param query 业务词或完整节点 key。
+ * @param options depth 默认 3，limit 默认 40，freshness 区分本次抽取与页面快照。
+ * @returns 子图、选择依据、覆盖边界和建议；未命中返回 not-found，不猜造节点。
+ */
 export function buildContext(cfg, snapshot, query, options = {}) {
     const reader = graphReader(snapshot, options.freshness);
     const depth = options.depth ?? 3, limit = options.limit ?? 40;
@@ -176,12 +204,17 @@ export function buildContext(cfg, snapshot, query, options = {}) {
         review,
         nextSteps: [
             '先按源码位置阅读实现，确认候选入口符合需求；不要仅凭箭头推断条件与运行结果。',
-            '改动前 cage analyze，并将 .cage/ontology.json 另存为 .cage/before-change.json；后续抽取会覆盖当前图。',
-            '修改后运行 cage check、cage gen，审查契约/迁移，再 cage impact --base-file .cage/before-change.json。',
+            '改动前 cage snapshot save before-change，保存带时间与版本的独立基线；查询不修改命名快照。',
+            '修改后运行 cage check、cage gen、cage doctor，审查契约/迁移，再 cage impact --snapshot before-change。',
             '阅读候选测试，按实际风险运行必要验证；报告通过、跳过、未执行项。',
         ],
     };
 }
+/**
+ * 把结构化上下文渲染为可交给 agent 的 Markdown，保留候选和证据限制。
+ * @param report buildContext 的完整报告。
+ * @returns Markdown 文本；不写文件、不执行报告中的下一步命令。
+ */
 export function formatContext(report) {
     const lines = reportHeader(report, 'Cage 业务开发上下文');
     lines.push(`需求/节点：${report.query}`, '', report.selection.note, '', '## 候选入口与匹配依据', '');

package/dist/context.js.map

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

package/dist/create-prompt.d.ts

@@ -1,4 +1,11 @@
 import { type AppTemplate } from './create.js';
+/**
+ * 补齐创建目录与模板选项，供 main 在任何文件复制前调用。
+ * @param target 显式目录；缺省时交互询问。
+ * @param template blank 或 purchase；缺省时交互选择而非在 CI 静默默认。
+ * @returns 完整创建选择；用户取消返回 null，由入口转换为取消退出码。
+ * @throws 非交互缺项或模板名无效时抛出 CAGE-CREATE-001。
+ */
 export declare function chooseApp(target?: string, template?: string): Promise<{
     target: string;
     template: AppTemplate;

package/dist/create-prompt.js

@@ -1,8 +1,20 @@
+/**
+ * 创建应用前的终端交互层，向 main 返回已经明确的目录与模板选择。
+ * 显式参数优先，缺项时使用 Clack 提示；非 TTY 必须提供完整参数，取消返回 null。
+ * 本模块不复制模板或安装依赖，因此交互取消不会留下创建到一半的应用。
+ */
 // 交互只收集创建选项，所有问题结束后才复制文件；Ctrl+C 不会留下半个项目。
 import { cancel, intro, isCancel, select, text } from '@clack/prompts';
 import { existsSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { appTemplates, isAppTemplate } from './create.js';
+/**
+ * 补齐创建目录与模板选项，供 main 在任何文件复制前调用。
+ * @param target 显式目录；缺省时交互询问。
+ * @param template blank 或 purchase；缺省时交互选择而非在 CI 静默默认。
+ * @returns 完整创建选择；用户取消返回 null，由入口转换为取消退出码。
+ * @throws 非交互缺项或模板名无效时抛出 CAGE-CREATE-001。
+ */
 export async function chooseApp(target, template) {
     if (template !== undefined && !isAppTemplate(template))
         throw new Error('[CAGE-CREATE-001] --template 只能是 blank 或 purchase');

package/dist/create-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-prompt.js","sourceRoot":"","sources":["../src/create-prompt.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAoB,MAAM,aAAa,CAAC;AAE5E,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAe,EACf,QAAiB;IAEjB,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IAEvE,0CAA0C;IAC1C,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3E,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;IAEJ,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ;QAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC;YACxB,OAAO,EAAE,MAAM;YACf,WAAW,EAAE,aAAa;YAC1B,YAAY,EAAE,aAAa;YAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;gBAClB,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;oBAAE,OAAO,SAAS,CAAC;gBACrC,IAAI,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;oBAAE,OAAO,gBAAgB,CAAC;YACjE,CAAC;SACF,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,OAAO,CAAC,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IACD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,MAAM,GAAG,MAAM,MAAM,CAAc;YACvC,OAAO,EAAE,wBAAwB;YACjC,YAAY,EAAE,OAAO;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9D,KAAK,EAAE,KAAoB;gBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;aAClB,CAAC,CAAC;SACJ,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,OAAO,CAAC,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,QAAQ,GAAG,MAAM,CAAC;IACpB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAuB,EAAE,CAAC;AACvD,CAAC"}
+{"version":3,"file":"create-prompt.js","sourceRoot":"","sources":["../src/create-prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,0CAA0C;AAC1C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAoB,MAAM,aAAa,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAe,EACf,QAAiB;IAEjB,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IAEvE,0CAA0C;IAC1C,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3E,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;IAEJ,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ;QAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC;YACxB,OAAO,EAAE,MAAM;YACf,WAAW,EAAE,aAAa;YAC1B,YAAY,EAAE,aAAa;YAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;gBAClB,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;oBAAE,OAAO,SAAS,CAAC;gBACrC,IAAI,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;oBAAE,OAAO,gBAAgB,CAAC;YACjE,CAAC;SACF,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,OAAO,CAAC,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IACD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,MAAM,GAAG,MAAM,MAAM,CAAc;YACvC,OAAO,EAAE,wBAAwB;YACjC,YAAY,EAAE,OAAO;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9D,KAAK,EAAE,KAAoB;gBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;aAClB,CAAC,CAAC;SACJ,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,OAAO,CAAC,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,QAAQ,GAAG,MAAM,CAAC;IACpB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAuB,EAAE,CAAC;AACvD,CAAC"}

package/dist/create.d.ts

@@ -1,5 +1,9 @@
 /** 两种模板共用框架基础能力，只让用户选择是否带业务演示。目录名与命令参数分开，
  * 保留已有 templates/app 作为采购模板，避免改写它已分发的迁移历史。 */
+/**
+ * 可分发模板目录与交互标签的固定映射；blank 只有应用基础，purchase 包含采购演示。
+ * 目录名与命令参数分离，保留既有模板路径及迁移历史；此映射本身不创建应用。
+ */
 export declare const appTemplates: {
     readonly blank: {
         readonly directory: "blank";
@@ -12,7 +16,23 @@ export declare const appTemplates: {
         readonly hint: "包含采购单、库存、审批和 fake ERP 完整链路";
     };
 };
+/**
+ * 创建命令允许的模板键，只对应 appTemplates 中已打包的两种模板。
+ */
 export type AppTemplate = keyof typeof appTemplates;
+/**
+ * 校验外部字符串是否为已知模板键。
+ * @param value CLI 参数或交互值。
+ * @returns 是否存在固定映射；不访问磁盘，也不验证模板资源完整性。
+ */
 export declare function isAppTemplate(value: string): value is AppTemplate;
-/** 创建本身不负责交互，供 CLI、自动化和测试复用。第三个参数保留原有本地框架路径调用方式。 */
+/** 创建本身不负责交互，供 CLI、自动化和测试复用。第二个参数是可选本地框架路径，第三个参数选择模板。 */
+/**
+ * 复制内置模板并把框架依赖改为统一版本或显式本地链接。
+ * @param target 不存在的目标目录；相对当前工作目录解析。
+ * @param frameworkPath 可选已构建框架路径，用于本地 link，不自动构建。
+ * @param template 模板键，默认 blank。
+ * @returns 创建目录的绝对路径。
+ * @throws 目标已存在、模板缺失或文件 IO 失败；不覆盖既有应用，不回滚部分复制结果。
+ */
 export declare function createApp(target: string, frameworkPath?: string, template?: AppTemplate): string;

package/dist/create.js

@@ -1,17 +1,39 @@
+/**
+ * 脚手架文件复制层，由 create 命令在完成选项收集后调用。
+ * 选择 CLI 内置模板，排除运行缓存和真实环境文件，恢复 .gitignore 并改写框架依赖版本或本地链接。
+ * 仅创建不存在的目标目录；不安装包、不准备数据库，复制过程中发生 IO 错误会保留已经写入的文件供排查。
+ */
 import { cpSync, existsSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
 import { basename, dirname, join, relative, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { VERSION, projectManifests } from './upgrade.js';
 /** 两种模板共用框架基础能力，只让用户选择是否带业务演示。目录名与命令参数分开，
  * 保留已有 templates/app 作为采购模板，避免改写它已分发的迁移历史。 */
+/**
+ * 可分发模板目录与交互标签的固定映射；blank 只有应用基础，purchase 包含采购演示。
+ * 目录名与命令参数分离，保留既有模板路径及迁移历史；此映射本身不创建应用。
+ */
 export const appTemplates = {
     blank: { directory: 'blank', label: '空白业务项目', hint: '保留登录、权限和系统管理，从自己的业务开始' },
     purchase: { directory: 'app', label: '采购示例项目', hint: '包含采购单、库存、审批和 fake ERP 完整链路' },
 };
+/**
+ * 校验外部字符串是否为已知模板键。
+ * @param value CLI 参数或交互值。
+ * @returns 是否存在固定映射；不访问磁盘，也不验证模板资源完整性。
+ */
 export function isAppTemplate(value) {
     return Object.hasOwn(appTemplates, value);
 }
-/** 创建本身不负责交互，供 CLI、自动化和测试复用。第三个参数保留原有本地框架路径调用方式。 */
+/** 创建本身不负责交互，供 CLI、自动化和测试复用。第二个参数是可选本地框架路径，第三个参数选择模板。 */
+/**
+ * 复制内置模板并把框架依赖改为统一版本或显式本地链接。
+ * @param target 不存在的目标目录；相对当前工作目录解析。
+ * @param frameworkPath 可选已构建框架路径，用于本地 link，不自动构建。
+ * @param template 模板键，默认 blank。
+ * @returns 创建目录的绝对路径。
+ * @throws 目标已存在、模板缺失或文件 IO 失败；不覆盖既有应用，不回滚部分复制结果。
+ */
 export function createApp(target, frameworkPath, template = 'blank') {
     if (!isAppTemplate(template))
         throw new Error('[CAGE-CREATE-001] --template 只能是 blank 或 purchase');

package/dist/create.js.map

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