@yss123/cage-cli 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shunshunyue and Cage contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,41 @@
-# Temporary Holding Version
+# @yss123/cage-cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+cage 命令行：init、gen、check、graph、context、impact、test、verify、budget、sync、upgrade、dev、migrate
+
+Cage 是通过 TypeScript 声明业务、由框架统一执行权限和数据规则的中后台框架。此包是框架的一部分。
+
+## 使用
+
+```powershell
+pnpm add -D @yss123/cage-cli
+```
+
+首次使用建议通过脚手架创建完整项目，所需依赖由模板统一配置。需要 Node.js 24 或更新版本。
+
+`pnpm exec cage create my-app` 交互选择空白业务项目或采购示例项目；也可显式指定 `--template blank` 或 `--template purchase`。省略目录时可交互输入，非交互终端必须同时提供目录与模板。`--framework-path F:/cage` 可链接已构建的本地框架。
+
+自 `0.2.0` 起，两种产物都包含根目录 `AGENTS.md`、`docs/ai` 业务开发教材和 `docs/errors` 离线错误码册。空白项目只运行组织模型，采购参考代码在 `docs/examples/purchase-admin`；采购项目运行完整演示链路。让 Codex 等编程工具先读 `AGENTS.md`，无需另行克隆框架源码。
+
+`cage sync` 更新 AGENTS 框架托管区，保留标记外的项目业务约定；它不自动覆盖业务代码或学习资料。
+
+## 用本体图开发业务
+
+在应用根目录执行：
+
+```powershell
+pnpm exec cage context "修改采购单取消逻辑"
+pnpm exec cage graph search "取消" --kind command
+pnpm exec cage graph inspect command:PurchaseOrder.cancel
+pnpm exec cage graph path command:PurchaseOrder.cancel command:InventoryLock.release
+pnpm exec cage context command:PurchaseOrder.cancel --format json --out .cage/context.json
+```
+
+CLI 每次重新抽取，不需要数据库；报告包含中文候选与依据、业务关系解释、源码位置、契约/前端/测试候选、迁移和授权提示。默认 Markdown；查询支持 `--format json`、`--out`，context 可用 `--depth` / `--limit` 控制范围。图规则错误仍输出可用上下文并返回非零；无命中、精确节点歧义或深度内无路径也非零。Web 节点详情可复制同源 AI 上下文，修改代码后先重新抽取。
+
+名称、SQL 字段和测试匹配是线索；具体执行条件需阅读源码。上述命令自 `0.2.0` 提供，完整流程随新项目分发在 `docs/ai/ontology-context.md`。
+
+- [完整使用说明](https://github.com/shunshunyue/cage/blob/main/docs/使用说明.md)
+- [框架源码与范例](https://github.com/shunshunyue/cage)
+- [问题反馈](https://github.com/shunshunyue/cage/issues)
+
+许可证：[MIT](https://github.com/shunshunyue/cage/blob/main/LICENSE)。

package/bin/cage.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { main } from '../dist/main.js';
+main().then((code) => { process.exitCode = code; }).catch((error) => {
+  console.error(error.message);
+  process.exitCode = 1;
+});

package/bin/create-cage-app.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { main } from '../dist/main.js';
+main(['create', ...process.argv.slice(2)]).then((code) => { process.exitCode = code; }).catch((error) => {
+  console.error(error.message);
+  process.exitCode = 1;
+});

package/dist/analyze.d.ts

@@ -0,0 +1,18 @@
+import { type CageConfig } from './config.js';
+import { type Finding } from './findings.js';
+import { type Ontology } from './ontology.js';
+/** 静态检查先于模块求值；发现动态声明或 IO 时不执行模块。 */
+export declare function analyze(cfg: CageConfig, opts?: {
+    base?: Ontology;
+    write?: boolean;
+}): Promise<{
+    source: import("./static-check.js").StaticResult;
+    findings: Finding[];
+    registry?: undefined;
+    graph?: undefined;
+} | {
+    source: import("./static-check.js").StaticResult;
+    registry: import("@yss123/cage-kernel").Registry;
+    graph: Ontology;
+    findings: Finding[];
+}>;

package/dist/analyze.js

@@ -0,0 +1,28 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { abs } from './config.js';
+import { errorsOnly } from './findings.js';
+import { loadRegistry } from './load.js';
+import { extract } from './ontology.js';
+import { runRules } from './rules.js';
+import { staticCheck, unexportedFindings } from './static-check.js';
+import { checkProjectStructure } from './project-structure.js';
+/** 静态检查先于模块求值；发现动态声明或 IO 时不执行模块。 */
+export async function analyze(cfg, opts = {}) {
+    const source = staticCheck(cfg);
+    source.findings.push(...checkProjectStructure(cfg));
+    if (errorsOnly(source.findings).length)
+        return { source, findings: source.findings };
+    const { mod, registry } = await loadRegistry(abs(cfg, cfg.domain));
+    const graph = extract(registry, source.sites, source.unsafeCount);
+    const findings = [
+        ...source.findings,
+        ...unexportedFindings(source.sites, new Set(Object.keys(mod))),
+        ...runRules(graph, opts.base),
+    ];
+    if (opts.write) {
+        mkdirSync(abs(cfg, '.cage'), { recursive: true });
+        writeFileSync(abs(cfg, '.cage/ontology.json'), JSON.stringify(graph, null, 2) + '\n');
+    }
+    return { source, registry, graph, findings };
+}
+//# sourceMappingURL=analyze.js.map

package/dist/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../src/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,GAAG,EAAmB,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,UAAU,EAAgB,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,OAAO,EAAiB,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,oCAAoC;AACpC,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAe,EAAE,OAA6C,EAAE;IAC5F,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,IAAI,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IACrF,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAc;QAC1B,GAAG,MAAM,CAAC,QAAQ;QAClB,GAAG,kBAAkB,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,GAAG,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC;KAC9B,CAAC;IACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,qBAAqB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC"}

package/dist/baseline.d.ts

@@ -0,0 +1,5 @@
+import { type CageConfig } from './config.js';
+export declare function loadBaseline(cfg: CageConfig, opts: {
+    base?: string;
+    baseFile?: string;
+}): Promise<import("./ontology.js").Ontology | undefined>;

package/dist/baseline.js

@@ -0,0 +1,50 @@
+// 基线来自显式 JSON 文件，或 Git 提交里的业务声明。
+// Git 比较在独立临时工作树中抽取，不切换用户当前分支，也不安装/执行基线脚本。
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdirSync, mkdtempSync, rmSync, symlinkSync, unlinkSync } from 'node:fs';
+import { dirname, join, relative } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { abs } from './config.js';
+import { readOntology } from './impact.js';
+import { run } from './process.js';
+import { projectManifests } from './upgrade.js';
+export async function loadBaseline(cfg, opts) {
+    if (opts.baseFile)
+        return readOntology(abs(cfg, opts.baseFile));
+    if (!opts.base)
+        return undefined;
+    const git = (args) => execFileSync('git', args, { cwd: cfg.root, encoding: 'utf8', windowsHide: true }).trim();
+    const repository = git(['rev-parse', '--show-toplevel']);
+    // 先解析 ref，错误基线必须报错，不能把“基线不存在”解释为“没有变化”。
+    const commit = git(['rev-parse', '--verify', `${opts.base}^{commit}`]);
+    mkdirSync(abs(cfg, '.cage'), { recursive: true });
+    const temporary = mkdtempSync(abs(cfg, '.cage/baseline-'));
+    const checkout = join(temporary, 'checkout');
+    git(['worktree', 'add', '--detach', checkout, commit]);
+    const links = [];
+    try {
+        const project = join(checkout, relative(repository, cfg.root));
+        // 使用当前已经安装的框架版本；基线与当前声明由同一抽取器解释。
+        // pnpm 把依赖链接放在各 workspace 包内，单独链接根目录不足以解析 domain。
+        for (const original of new Set([repository, cfg.root, ...projectManifests(repository).map(dirname)])) {
+            const destination = join(checkout, relative(repository, original));
+            if (existsSync(destination) && existsSync(join(original, 'node_modules')) && !existsSync(join(destination, 'node_modules'))) {
+                symlinkSync(join(original, 'node_modules'), join(destination, 'node_modules'), process.platform === 'win32' ? 'junction' : 'dir');
+                links.push(join(destination, 'node_modules'));
+            }
+        }
+        const code = await run(fileURLToPath(new URL('../bin/cage.js', import.meta.url)), ['analyze', '--root', project], project);
+        if (code !== 0)
+            throw new Error('[CAGE-IMPACT-001] 基线抽取失败，请修复基线声明或使用保存的 --base-file');
+        return readOntology(join(project, '.cage/ontology.json'));
+    }
+    finally {
+        // 先断开本次建立的 junction，避免清理工作树时遍历共享依赖目录。
+        for (const link of links)
+            unlinkSync(link);
+        git(['worktree', 'remove', '--force', checkout]);
+        // temporary 是本次 mkdtemp 创建的绝对目录，只移除自己的临时目录。
+        rmSync(temporary, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=baseline.js.map

package/dist/baseline.js.map

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

package/dist/budget.d.ts

@@ -0,0 +1,7 @@
+import { type CageConfig } from './config.js';
+import type { Ontology } from './ontology.js';
+import type { Finding } from './findings.js';
+export declare function budget(cfg: CageConfig, graph: Ontology, base?: Ontology): {
+    metrics: Record<string, number | null>;
+    findings: Finding[];
+};

package/dist/budget.js

@@ -0,0 +1,52 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { abs } from './config.js';
+import { listTs } from './static-check.js';
+export function budget(cfg, graph, base) {
+    const kernel = abs(cfg, 'packages/kernel/src');
+    const lines = existsSync(kernel)
+        ? listTs(kernel).reduce((n, f) => n +
+            readFileSync(f, 'utf8')
+                .split('\n')
+                .filter((l) => l.trim() && !l.trim().startsWith('//')).length, 0)
+        : null;
+    const primitivesFile = abs(cfg, 'packages/kernel/src/brands.ts');
+    // 使用公共词汇表计数；品牌还含内部扩展标记，不能把两者混算。
+    const families = {
+        CONNECTOR: 'external',
+        OUTBOUND: 'external',
+        INBOUND: 'external',
+        ROUTE: 'approval',
+        APPROVAL: 'approval',
+    };
+    const vocabulary = new Set(['field', 'capability', 'scope', 'constraint', 'invariant']);
+    if (existsSync(primitivesFile)) {
+        for (const match of readFileSync(primitivesFile, 'utf8').matchAll(/export const (\w+) = Symbol\.for\(/g)) {
+            if (['CONSUMERS', 'SYSTEM_DDL'].includes(match[1]))
+                continue;
+            vocabulary.add(families[match[1]] ?? match[1].toLowerCase());
+        }
+    }
+    const primitives = existsSync(primitivesFile) ? vocabulary.size : null;
+    const findings = [];
+    if (lines !== null && lines > 5000)
+        findings.push({
+            code: 'CAGE-BUDGET-001',
+            reason: `内核 ${lines} 行，超过 5000 行预算`,
+            fix: '拆出扩展职责，或提交架构评审调整预算',
+        });
+    if (primitives !== null && primitives > 16)
+        findings.push({
+            code: 'CAGE-BUDGET-002',
+            reason: `品牌原语 ${primitives} 个，超过 16 个预算`,
+            fix: '优先使用组合子，避免新增原语',
+        });
+    const allowance = base?.unsafeCount ?? 0;
+    if (graph.unsafeCount > allowance)
+        findings.push({
+            code: 'CAGE-BUDGET-003',
+            reason: `unsafe 从 ${allowance} 增加到 ${graph.unsafeCount}`,
+            fix: '移除新增逃生口，或在评审完成后更新受审基线',
+        });
+    return { metrics: { kernelLines: lines, primitives, unsafe: graph.unsafeCount }, findings };
+}
+//# sourceMappingURL=budget.js.map

package/dist/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../src/budget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,GAAG,EAAmB,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI3C,MAAM,UAAU,MAAM,CACpB,GAAe,EACf,KAAe,EACf,IAAe;IAEf,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC;QAC9B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CACnB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,CAAC;YACD,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC;iBACpB,KAAK,CAAC,IAAI,CAAC;iBACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EACjE,CAAC,CACF;QACH,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,cAAc,GAAG,GAAG,CAAC,GAAG,EAAE,+BAA+B,CAAC,CAAC;IACjE,gCAAgC;IAChC,MAAM,QAAQ,GAA2B;QACvC,SAAS,EAAE,UAAU;QACrB,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,UAAU;QACnB,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,UAAU;KACrB,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC;IACxF,IAAI,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,QAAQ,CAC/D,qCAAqC,CACtC,EAAE,CAAC;YACF,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAAE,SAAS;YAC7D,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IACD,MAAM,UAAU,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,GAAG,IAAI;QAChC,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,iBAAiB;YACvB,MAAM,EAAE,MAAM,KAAK,gBAAgB;YACnC,GAAG,EAAE,oBAAoB;SAC1B,CAAC,CAAC;IACL,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,GAAG,EAAE;QACxC,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,iBAAiB;YACvB,MAAM,EAAE,QAAQ,UAAU,cAAc;YACxC,GAAG,EAAE,gBAAgB;SACtB,CAAC,CAAC;IACL,MAAM,SAAS,GAAG,IAAI,EAAE,WAAW,IAAI,CAAC,CAAC;IACzC,IAAI,KAAK,CAAC,WAAW,GAAG,SAAS;QAC/B,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,iBAAiB;YACvB,MAAM,EAAE,YAAY,SAAS,QAAQ,KAAK,CAAC,WAAW,EAAE;YACxD,GAAG,EAAE,uBAAuB;SAC7B,CAAC,CAAC;IACL,OAAO,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC;AAC9F,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,30 @@
+export interface CageConfig {
+    root: string;
+    name: string;
+    /** domain 包入口：抽取器和内核都从这里读 */
+    domain: string;
+    /** 前端 SDK 生成目录 */
+    contracts: string;
+    /** contracts 包名（前端从这里引入） */
+    contractsPackage: string;
+    migrations: string;
+    generated: string;
+    apiEntry: string;
+    workerEntry: string;
+    web: string;
+    /** 需要类型检查的目录（各自有 tsconfig.json） */
+    typecheck: string[];
+    /** lint 与依赖规则检查的目录 */
+    lint: string[];
+    /** 新脚手架启用模块目录约束；旧项目可整理后显式开启，不因升级 CLI 被迫迁移。 */
+    structure?: 'modular';
+    /** 图谱的显示文案独立于业务标识；键为“节点类型:节点 ID”，不影响路由、
+     * 数据表、能力点和影响分析。可用短标题覆盖较长的声明 description。 */
+    graph?: {
+        title?: string;
+        labels?: Record<string, string>;
+    };
+}
+export declare function findRoot(start?: string): string;
+export declare function loadConfig(start?: string): CageConfig;
+export declare const abs: (cfg: CageConfig, p: string) => string;

package/dist/config.js

@@ -0,0 +1,46 @@
+// 项目配置：默认值对应模板生成的目录结构，cage.config.json 可以覆盖。
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+export function findRoot(start = process.cwd()) {
+    let dir = resolve(start);
+    for (;;) {
+        if (existsSync(join(dir, 'cage.config.json')))
+            return dir;
+        const pkg = join(dir, 'package.json');
+        if (existsSync(pkg)) {
+            const j = JSON.parse(readFileSync(pkg, 'utf8'));
+            if (j.devDependencies?.['@yss123/cage-cli'] || j.dependencies?.['@yss123/cage-cli'] || j.cage)
+                return dir;
+        }
+        const up = dirname(dir);
+        if (up === dir)
+            return resolve(start);
+        dir = up;
+    }
+}
+export function loadConfig(start) {
+    const root = findRoot(start);
+    const file = join(root, 'cage.config.json');
+    const user = existsSync(file) ? JSON.parse(readFileSync(file, 'utf8')) : {};
+    const pkg = existsSync(join(root, 'package.json'))
+        ? JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'))
+        : {};
+    const c = {
+        name: pkg.name ?? 'cage-app',
+        domain: 'packages/domain/src/index.ts',
+        contracts: 'packages/contracts/src',
+        contractsPackage: '@app/contracts',
+        migrations: 'db/migrations',
+        generated: 'generated',
+        apiEntry: 'apps/api/src/main.ts',
+        workerEntry: 'apps/api/src/worker.ts',
+        web: 'apps/web',
+        typecheck: ['packages/domain', 'packages/contracts', 'apps/api', 'apps/web'],
+        lint: ['packages/domain/src', 'apps/api/src', 'apps/web/src'],
+        ...pkg.cage,
+        ...user,
+    };
+    return { ...c, root };
+}
+export const abs = (cfg, p) => resolve(cfg.root, p);
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +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"}

package/dist/context.d.ts

@@ -0,0 +1,72 @@
+import { type CageConfig } from './config.js';
+import type { GraphSnapshot } from './graph-snapshot.js';
+import { type GraphNodeInfo } from './graph-query.js';
+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[];
+};
+export declare function formatContext(report: ReturnType<typeof buildContext>): string;

package/dist/context.js

@@ -0,0 +1,202 @@
+// 开发前的上下文包：沿声明截取一小块业务图，并列出继续阅读的源码及检查线索。
+// 这里只读取工程源码、文件名和已抽取元数据，不读取 .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。 */
+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 };
+}
+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: '仅按聚合/查询的代码名称查找引用，不是完整的前端依赖分析。',
+        },
+    };
+}
+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 analyze，并将 .cage/ontology.json 另存为 .cage/before-change.json；后续抽取会覆盖当前图。',
+            '修改后运行 cage check、cage gen，审查契约/迁移，再 cage impact --base-file .cage/before-change.json。',
+            '阅读候选测试，按实际风险运行必要验证；报告通过、跳过、未执行项。',
+        ],
+    };
+}
+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