@yss123/cage-cli 0.1.0 → 0.3.0

package/dist/capabilities.js

@@ -0,0 +1,133 @@
+/**
+ * 按当前安装包的声明文件建立公开能力目录，供 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: 'primitives.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'))",
+    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,24 +13,47 @@ 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[];
     /** lint 与依赖规则检查的目录 */
     lint: string[];
-    /** 本地开发数据库端口；用于 Docker 初始配置及未配置外部连接时的内嵌实例 */
-    devDbPort: number;
-    /** 图谱的显示文案独立于业务标识；键为“节点类型:节点 ID”，不影响路由、
-     * 数据表、能力点和影响分析。可用短标题覆盖较长的声明 description。 */
+    /** 新脚手架启用模块目录约束；旧项目可整理后显式开启，不因升级 CLI 被迫迁移。 */
+    structure?: 'modular';
+    /** 图谱的显示文案独立于业务标识；键为“节点类型:节点 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');
@@ -37,11 +53,16 @@ export function loadConfig(start) {
         web: 'apps/web',
         typecheck: ['packages/domain', 'packages/contracts', 'apps/api', 'apps/web'],
         lint: ['packages/domain/src', 'apps/api/src', 'apps/web/src'],
-        devDbPort: 54329,
         ...pkg.cage,
         ...user,
     };
     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;gBAAE,OAAO,GAAG,CAAC;QAC5G,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,SAAS,EAAE,KAAK;QAChB,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

@@ -0,0 +1,86 @@
+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;
+    freshness?: 'fresh-extraction' | 'displayed-snapshot';
+}): {
+    operation: "context";
+    status: "ok" | "not-found";
+    query: string;
+    selection: {
+        mode: string;
+        roots: string[];
+        candidates: import("./graph-search.js").GraphSearchHit[];
+        candidateTotal: number;
+        candidatesTruncated: boolean;
+        note: string;
+    };
+    coverage: {
+        depth: number;
+        limit: number;
+        selectedNodes: number;
+        truncated: boolean;
+        omittedByLimit: number;
+        depthBoundary: string[];
+        note: string;
+    };
+    nodes: GraphNodeInfo[];
+    relations: import("./graph-query.js").GraphRelationInfo[];
+    resources: {
+        sourceFiles: string[];
+        contracts: {
+            exists: boolean;
+            generated: boolean;
+            file: string;
+            reason: string;
+        }[];
+        migrations: {
+            directory: string;
+            note: string;
+        };
+        tests: {
+            basis: string;
+            derived: import("./derive.js").DerivedTest[];
+            project: string[];
+            derivedTotal: number;
+            truncated: boolean;
+        };
+        frontend: {
+            candidates: {
+                file: string;
+                matches: string[];
+                basis: "text-match";
+            }[];
+            total: number;
+            truncated: boolean;
+            note: string;
+        };
+    };
+    review: string[];
+    nextSteps: string[];
+    schemaVersion: 1;
+    project: string;
+    domain: string;
+    extractedAt: string;
+    freshness: "fresh-extraction" | "displayed-snapshot";
+    graphHash: string;
+    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

@@ -0,0 +1,235 @@
+/**
+ * 为编程 agent 组织需求相关子图、源码位置、契约及验证候选，供 CLI 与本地图谱共用。
+ * 从精确节点或名称候选出发做有界扩展，再读取项目测试与 Web 源码补充文本匹配线索。
+ * 不执行推荐测试、不访问业务数据；输出截断、深度边界与证据来源，不能替代源码阅读或业务验收。
+ */
+// 开发前的上下文包：沿声明截取一小块业务图，并列出继续阅读的源码及检查线索。
+// 这里只读取工程源码、文件名和已抽取元数据，不读取 .env，不连接业务数据库。
+import { existsSync, globSync, readFileSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { kebab, lowerFirst } from '@yss123/cage-kernel';
+import { abs } from './config.js';
+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 = [
+        ...new Set(nodes
+            .filter((node) => ['aggregate', 'command', 'field', 'state', 'capability'].includes(node.kind))
+            .map((node) => node.id.split('.')[0])),
+    ];
+    const contracts = aggregates.map((id) => ({
+        file: join(cfg.contracts, 'aggregates', kebab(id), 'index.ts').replace(/\\/g, '/'),
+        reason: `聚合 ${id} 的生成 API、类型和 hooks；通过 gen 更新`,
+    }));
+    if (nodes.some((node) => node.kind === 'query'))
+        contracts.push({
+            file: join(cfg.contracts, 'queries/index.ts').replace(/\\/g, '/'),
+            reason: '生成查询 API；通过 gen 更新',
+        });
+    const testFiles = globSync(['packages/**/src/**/*.{test,spec}.{ts,tsx}', 'apps/api/**/*.{test,spec}.{ts,tsx}'], {
+        cwd: cfg.root,
+        exclude: ['**/node_modules/**', '**/dist/**'],
+    }).sort();
+    // 所属聚合只是附带资料时，不把该聚合的全部派生测试都塞进来；命令按 subject 挑选。
+    const subjects = new Set(nodes.filter((node) => node.kind !== 'aggregate' || roots.includes(node.key)).map((node) => node.id));
+    const tests = selectRelatedTests(subjects, deriveTests(cfg, snapshot.graph).tests, testFiles.map((file) => abs(cfg, file)));
+    const terms = [
+        ...new Set([
+            ...aggregates.flatMap((id) => [id, lowerFirst(id)]),
+            ...nodes.filter((node) => node.kind === 'query').map((node) => node.id),
+        ]),
+    ];
+    const frontend = existsSync(abs(cfg, cfg.web))
+        ? globSync('src/**/*.{ts,tsx}', {
+            cwd: abs(cfg, cfg.web),
+            exclude: ['**/node_modules/**', '**/dist/**'],
+        })
+            .sort()
+            .flatMap((file) => {
+            const text = readFileSync(abs(cfg, join(cfg.web, file)), 'utf8');
+            const matches = terms.filter((term) => text.includes(term));
+            return matches.length
+                ? [{ file: join(cfg.web, file).replace(/\\/g, '/'), matches, basis: 'text-match' }]
+                : [];
+        })
+        : [];
+    return {
+        sourceFiles,
+        contracts: contracts.map((ref) => ({ ...ref, exists: existsSync(abs(cfg, ref.file)), generated: true })),
+        migrations: {
+            directory: cfg.migrations,
+            note: '字段/关联存储变化时生成并审查新迁移；不改写已执行迁移。本命令不比较真实数据库。',
+        },
+        tests: {
+            basis: '派生测试按 subject 选择，项目测试按源码名称匹配；只是候选，未执行。',
+            derived: tests.derived.slice(0, 20),
+            project: tests.project.map((file) => relative(cfg.root, file).replace(/\\/g, '/')),
+            derivedTotal: tests.derived.length,
+            truncated: tests.derived.length > 20,
+        },
+        frontend: {
+            candidates: frontend.slice(0, 12),
+            total: frontend.length,
+            truncated: frontend.length > 12,
+            note: '仅按聚合/查询的代码名称查找引用，不是完整的前端依赖分析。',
+        },
+    };
+}
+/**
+ * 从需求候选或精确节点构建有界业务上下文。
+ * 优先扩展执行关系，聚合/字段等附带资料停止继续传播，降低高连接节点造成的上下文膨胀。
+ * @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;
+    const resolution = reader.resolve(query);
+    const candidates = reader.search(query);
+    // 完整 key / 唯一名称可精确定位；其余用得分接近的最多三个候选作为入口，报告中
+    // 明示选择依据。用户可复制某个 key 再请求上下文，不让关键词匹配冒充需求确认。
+    const roots = resolution.status === 'ok'
+        ? resolution.candidates.map((hit) => hit.key)
+        : candidates
+            .filter((hit) => hit.score >= (candidates[0]?.score ?? 0) * 0.8)
+            .slice(0, Math.min(3, limit))
+            .map((hit) => hit.key);
+    const selected = new Set(roots);
+    const rootSet = new Set(roots);
+    const queue = roots.map((key) => ({ key, distance: 0 }));
+    const omitted = new Set();
+    // 实际业务链优先于归属和字段结构，避免聚合这个高连接度节点挤掉取消→释放链。
+    const edges = [...reader.model.edges].sort((a, b) => Number(a.derived) - Number(b.derived) || Number(a.kind === 'field') - Number(b.kind === 'field'));
+    const participants = (edge) => [
+        edge.from,
+        edge.to,
+        ...(edge.kind === 'transition' && reader.byKey.has(`command:${edge.via}`) ? [`command:${edge.via}`] : []),
+    ];
+    for (const current of queue) {
+        for (const edge of edges) {
+            const keys = participants(edge);
+            if (!keys.includes(current.key))
+                continue;
+            for (const key of keys) {
+                if (selected.has(key))
+                    continue;
+                if (current.distance >= depth)
+                    continue;
+                if (selected.size >= limit) {
+                    omitted.add(key);
+                    continue;
+                }
+                selected.add(key);
+                const node = reader.byKey.get(key);
+                // 读依赖指向的表、命令所属对象、状态和字段作为阅读资料收进来；只有业务
+                // 行为继续扩展，避免经“所属采购单”顺带把全部用户/部门和无关命令都展开。
+                if (rootSet.has(key) || !['aggregate', 'field', 'state', 'entry', 'capability'].includes(node.kind))
+                    queue.push({ key, distance: current.distance + 1 });
+            }
+        }
+    }
+    const boundary = queue
+        .filter((current) => current.distance >= depth &&
+        edges.some((edge) => {
+            const keys = participants(edge);
+            return keys.includes(current.key) && keys.some((key) => !selected.has(key));
+        }))
+        .map((current) => current.key);
+    const nodes = [...selected].map((key) => compactNode(reader.nodeInfo(reader.byKey.get(key))));
+    const relations = reader.model.edges
+        .filter((edge) => participants(edge).every((key) => selected.has(key)))
+        .map(reader.relationInfo);
+    const review = [];
+    if (nodes.some((n) => n.kind === 'command' || n.kind === 'capability'))
+        review.push('涉及命令能力、数据范围或额度时复核管理员授权；新增能力不自动授予生产角色。');
+    if (nodes.some((n) => n.kind === 'approval'))
+        review.push('复核 start/cancelOn、审批分支、选人、结论命令和额度约束；取消审批与释放资源分别检查。');
+    if (nodes.some((n) => n.kind === 'reaction' && (n.attrs.acquires || n.attrs.releases)))
+        review.push('资源获取/释放标签只证明声明配对；阅读 map 的执行条件、null 返回以及同事务/异步方式。');
+    if (nodes.some((n) => n.kind === 'event'))
+        review.push('已部署事件保持兼容；核对载荷字段和所有订阅方。');
+    if (nodes.some((n) => ['connector', 'outbound', 'inbound'].includes(n.kind)))
+        review.push('复核外部请求/回调协议、字段映射和幂等；fake 或声明通过不等于真实外部联调通过。');
+    return {
+        ...reader.meta,
+        operation: 'context',
+        status: roots.length ? 'ok' : 'not-found',
+        query,
+        selection: {
+            mode: resolution.status === 'ok' ? 'exact' : 'keyword-candidates',
+            roots,
+            candidates: candidates.slice(0, 8),
+            candidateTotal: candidates.length,
+            candidatesTruncated: candidates.length > 8,
+            note: resolution.status === 'ok'
+                ? '精确节点入口。'
+                : '按名称与中文词片段匹配的候选入口；请核对需求，可复制完整 key 缩小到单个节点。',
+        },
+        coverage: {
+            depth,
+            limit,
+            selectedNodes: nodes.length,
+            truncated: omitted.size > 0,
+            omittedByLimit: omitted.size,
+            depthBoundary: boundary,
+            note: '仅输出相关子图；附带的表/字段/状态不继续展开。边界和截断不代表外部没有其他依赖。',
+        },
+        nodes,
+        relations,
+        resources: contextResources(cfg, snapshot, nodes, roots),
+        review,
+        nextSteps: [
+            '先按源码位置阅读实现，确认候选入口符合需求；不要仅凭箭头推断条件与运行结果。',
+            '改动前 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, '', '## 候选入口与匹配依据', '');
+    for (const hit of report.selection.candidates)
+        lines.push(`- ${report.selection.roots.includes(hit.key) ? '【本次入口】' : '候选'} **${hit.label}** \`${hit.key}\`（得分 ${hit.score}）`, `  - ${hit.matches.map((m) => `${m.field}=${m.value}，命中 ${m.terms.join('、')}`).join('；')}`);
+    if (!report.nodes.length)
+        lines.push('未找到相关声明；尝试更短的中文词或代码标识。空白模板不会注册参考资料中的采购业务。');
+    lines.push('', '## 子图范围', '', `深度 ${report.coverage.depth}，节点 ${report.nodes.length}/${report.coverage.limit}；${report.coverage.truncated ? '已截断，请提高 --limit 或缩小入口' : '节点上限未截断'}。`, report.coverage.note, ...(report.coverage.depthBoundary.length
+        ? [`深度边界：${report.coverage.depthBoundary.join('、')}；需要时提高 --depth。`]
+        : []), '', '## 业务事实与源码', '');
+    for (const node of report.nodes)
+        lines.push(`### ${node.label} · ${node.key}`, '', `源码：${sourceText(node.source)}`, '', '```json', JSON.stringify(node.attrs, null, 2), '```', '');
+    lines.push('## 关系：为什么连接、有什么用', '', ...report.relations.flatMap(relationMarkdown), '', '## 继续阅读的文件', '', ...report.resources.sourceFiles.map((file) => `- 源码：${file}`), ...report.resources.contracts.map((ref) => `- 契约：${ref.file}${ref.exists ? '' : '（尚未生成）'}；${ref.reason}`), ...report.resources.frontend.candidates.map((ref) => `- 前端候选：${ref.file}；文本命中 ${ref.matches.join('、')}`), report.resources.frontend.note, ...(report.resources.frontend.truncated ? ['前端候选已截断。'] : []), '', `迁移目录：${report.resources.migrations.directory}；${report.resources.migrations.note}`, '', '## 验证候选与审查提示', '', report.resources.tests.basis, ...report.resources.tests.project.map((file) => `- 项目测试候选：${file}`), ...report.resources.tests.derived.map((test) => `- 派生测试候选：${test.file} · ${test.name}`), ...(report.resources.tests.truncated
+        ? [`派生测试候选共 ${report.resources.tests.derivedTotal} 项，仅列前 20 项。`]
+        : []), ...report.review.map((item) => `- ${item}`), '', '## 接下来', '', ...report.nextSteps.map((step, i) => `${i + 1}. ${step}`));
+    return [...lines, ...reportFooter(report)].join('\n');
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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