@yss123/cage-cli 0.0.0-stage → 0.2.0

package/dist/main.js

@@ -0,0 +1,221 @@
+// 命令入口只负责参数、输出和退出码；分析、生成、迁移都保留独立公共函数供测试调用。
+import { parseArgs } from 'node:util';
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { loadConfig, abs } from './config.js';
+import { errorsOnly, formatFindings } from './findings.js';
+import { VERSION } from './version.js';
+import { installDependencies, run } from './process.js';
+import { fileURLToPath } from 'node:url';
+import { loadProjectEnv } from './env.js';
+const help = `cage ${VERSION}
+  create [目录] [--template blank|purchase]  交互选择空白业务项目或采购示例
+    --framework-path <路径>        链接已构建的本地框架，无需先发 npm
+  init                             用管理员连接初始化已有数据库的账号权限，自动填写 .env
+  dev                              连接项目 .env 配置的数据库，启动 API、worker 和 Web
+  analyze | check                  抽取本体 / 检查目录、声明与图规则
+  graph [--port 15418]             启动本体图谱 Web 工作台
+  graph search <关键词>           中文/标识检索；--kind 类型 --limit 10
+  graph inspect <节点>             节点详情、关联原因与源码位置
+  graph path <起点> <终点>        最短关系链；--direction out|both --depth 6
+  context <需求或节点>            AI 业务上下文；--depth 3 --limit 40
+    查询输出：--format md|json --out <文件>；默认 Markdown，每次重新抽取
+  gen [--check]                    生成契约、SQL、状态图和迁移草稿
+  impact --base <提交>             与 Git 基线比较
+  impact --base-file <图.json>     与保存的本体图比较
+  test [--only derived|project]    生成并运行派生/项目测试
+  verify [--skip-tests]            执行门禁；跳过测试时明确标记不完整
+  budget [--base-file <图.json>]   内核与 unsafe 预算
+  sync [--check]                   同步 AGENTS.md 托管区
+  upgrade [--to 版本] [--dry-run] [--codemods-only]
+  migrate                          在已配置的数据库中执行表结构迁移，不创建数据库
+  通用选项：--root <目录> --help --version`;
+export async function main(argv = process.argv.slice(2)) {
+    const { values: o, positionals } = parseArgs({
+        args: argv,
+        allowPositionals: true,
+        options: {
+            root: { type: 'string' },
+            port: { type: 'string' },
+            depth: { type: 'string' },
+            limit: { type: 'string' },
+            kind: { type: 'string' },
+            direction: { type: 'string' },
+            'framework-path': { type: 'string' },
+            template: { type: 'string' },
+            base: { type: 'string' },
+            'base-file': { type: 'string' },
+            format: { type: 'string' },
+            out: { type: 'string' },
+            only: { type: 'string' },
+            to: { type: 'string' },
+            check: { type: 'boolean' },
+            'dry-run': { type: 'boolean' },
+            'codemods-only': { type: 'boolean' },
+            'skip-tests': { type: 'boolean' },
+            help: { type: 'boolean', short: 'h' },
+            version: { type: 'boolean' },
+        },
+    });
+    if (o.version) {
+        console.log(VERSION);
+        return 0;
+    }
+    const [command, target] = positionals;
+    if (o.help || !command) {
+        console.log(help);
+        return 0;
+    }
+    if (command === 'create') {
+        // 帮助、版本和参数错误不加载 TypeScript、codemod、lint 与数据库工具。
+        // 只在执行相应命令时加载，保持独立安装后的启动时间可控。
+        const { appTemplates, createApp } = await import('./create.js');
+        const { chooseApp } = await import('./create-prompt.js');
+        const selected = await chooseApp(target, o.template);
+        if (!selected)
+            return 130;
+        const created = createApp(selected.target, o['framework-path'], selected.template);
+        console.log(`已创建${appTemplates[selected.template].label}：${created}\n进入项目后：\n  1. pnpm install\n  2. 复制 .env.example 为 .env，只填写 CAGE_ADMIN_DATABASE_URL，连接已有 PostgreSQL\n  3. pnpm exec cage init（自动创建账号、生成密码并填写 .env）\n  4. pnpm build:app && pnpm gen\n  5. 审查迁移后 pnpm migrate，再 pnpm dev\nAI 协作：先读本项目 AGENTS.md 和 docs/ai/README.md，按 docs/ai/recipes.md 开发业务；错误码见 docs/errors。\n框架不创建数据库、不管理 Docker。cage 是项目内命令，单独调用使用 pnpm exec cage。`);
+        return 0;
+    }
+    if (![
+        'init',
+        'graph',
+        'context',
+        'sync',
+        'upgrade',
+        'dev',
+        'migrate',
+        'verify',
+        'analyze',
+        'check',
+        'gen',
+        'test',
+        'budget',
+        'impact',
+    ].includes(command))
+        throw new Error(`未知命令 ${command}，运行 cage --help 查看用法`);
+    const cfg = loadConfig(o.root);
+    // 查询只分析声明，无需加载项目密钥或连接数据库；每次在独立进程重新抽取。
+    if (command === 'context' || (command === 'graph' && target)) {
+        const action = command === 'context' ? 'context' : target;
+        if (command === 'graph' && !['search', 'inspect', 'path'].includes(action))
+            throw new Error('graph 子命令只能是 search、inspect、path；启动 Web 图谱直接执行 cage graph');
+        return (await import('./graph-command.js')).graphCommand(cfg, action, positionals.slice(command === 'context' ? 1 : 2), o);
+    }
+    loadProjectEnv(cfg.root);
+    if (command === 'init') {
+        const { initProject } = await import('./init.js');
+        const result = await initProject(cfg);
+        console.log(result.status === 'created'
+            ? `账号和权限已初始化，随机凭证已写入 ${result.envFile}；管理员连接已从文件移除。`
+            : `已有账号配置已验证，保留原密码：${result.envFile}`);
+        console.log('下一步：pnpm build:app、pnpm gen，审查迁移后 pnpm migrate，再 pnpm dev。');
+        return 0;
+    }
+    if (command === 'graph') {
+        const { serveGraph } = await import('./graph.js');
+        const port = Number(o.port ?? 15418);
+        if (!Number.isInteger(port) || port < 0 || port > 65535)
+            throw new Error('--port 必须是 0–65535 的整数');
+        const { server, url } = await serveGraph(cfg, port);
+        console.log(`Cage Atlas 本体图谱：${url}\n项目：${cfg.name}\n在浏览器打开；修改 domain 后点击“重新抽取”。Ctrl+C 关闭图谱服务。`);
+        // 服务句柄保持 CLI 存活。终止时关闭连接，避免桌面终端留下监听进程。
+        const stop = () => {
+            server.closeAllConnections();
+            server.close();
+        };
+        process.once('SIGINT', stop);
+        process.once('SIGTERM', stop);
+        return 0;
+    }
+    if (command === 'sync') {
+        const { sync } = await import('./sync.js');
+        const findings = sync(cfg, o.check);
+        console.log(findings.length ? formatFindings(findings) : '托管区已同步');
+        return errorsOnly(findings).length ? 1 : 0;
+    }
+    if (command === 'upgrade') {
+        const { upgrade } = await import('./upgrade.js');
+        console.log(upgrade(cfg, { to: o.to, dryRun: o['dry-run'], codemodsOnly: o['codemods-only'] }).join('\n') ||
+            '没有需要改写的文件');
+        if (o['dry-run'] || o['codemods-only'])
+            return 0;
+        // 由目标版本 CLI 完成安装、生成和验证。任何一步失败都保留可审查的文件改动，
+        // 返回失败，不把“清单已修改”误报为“升级已完成”。
+        if (await installDependencies(cfg.root))
+            return 1;
+        const cli = fileURLToPath(new URL('../bin/cage.js', import.meta.url));
+        if (await run(cli, ['gen'], cfg.root))
+            return 1;
+        return run(cli, ['verify'], cfg.root);
+    }
+    if (command === 'dev')
+        return (await import('./dev.js')).dev(cfg);
+    if (command === 'migrate') {
+        await (await import('./migrate.js')).migrate(cfg);
+        return 0;
+    }
+    const { loadBaseline } = await import('./baseline.js');
+    const base = await loadBaseline(cfg, { base: o.base, baseFile: o['base-file'] });
+    if (command === 'verify')
+        return (await import('./verify.js')).verify(cfg, { base, skipTests: o['skip-tests'] });
+    // 框架仓库自身没有 domain 入口，但仍需在 CI 检查内核体积与原语预算。
+    if (command === 'budget' && !existsSync(abs(cfg, cfg.domain))) {
+        const { budget } = await import('./budget.js');
+        const result = budget(cfg, { version: 1, nodes: [], edges: [], unsafeCount: 0 }, base);
+        console.log(JSON.stringify(result.metrics));
+        if (result.findings.length)
+            console.log(formatFindings(result.findings));
+        return errorsOnly(result.findings).length ? 1 : 0;
+    }
+    const { analyze } = await import('./analyze.js');
+    const a = await analyze(cfg, { base, write: command === 'analyze' });
+    if (a.findings.length)
+        console.log(formatFindings(a.findings));
+    if (!a.graph || !a.registry || errorsOnly(a.findings).length)
+        return 1;
+    if (command === 'check' || command === 'analyze') {
+        console.log(`声明通过：${a.graph.nodes.length} 个节点，${a.graph.edges.length} 条边`);
+        return 0;
+    }
+    if (command === 'gen') {
+        const { generate } = await import('./gen/index.js');
+        const g = generate(cfg, a.registry, a.graph, a.source.sites, { check: o.check });
+        console.log(formatFindings(g.findings) || `生成完成：${g.written.length} 个文件`);
+        return errorsOnly(g.findings).length ? 1 : 0;
+    }
+    if (command === 'budget') {
+        const { budget } = await import('./budget.js');
+        const b = budget(cfg, a.graph, base);
+        console.log(JSON.stringify(b.metrics));
+        if (b.findings.length)
+            console.log(formatFindings(b.findings));
+        return errorsOnly(b.findings).length ? 1 : 0;
+    }
+    if (command === 'test') {
+        if (o.only && !['derived', 'project'].includes(o.only))
+            throw new Error('--only 只能是 derived 或 project');
+        return (await import('./verify.js')).testProject(cfg, a.graph, o.only);
+    }
+    if (!base)
+        throw new Error('[CAGE-IMPACT-001] impact 需要 --base 提交 或 --base-file 本体图.json');
+    const { changedFiles, impact, formatImpact } = await import('./impact.js');
+    const { deriveTests } = await import('./derive.js');
+    const result = impact(base, a.graph, o.base ? changedFiles(cfg.root, o.base) : [], deriveTests(cfg, a.graph).tests);
+    const report = o.format === 'json'
+        ? JSON.stringify({ ...result, reasons: Object.fromEntries(result.reasons) }, null, 2)
+        : formatImpact(result, a.graph, {
+            base: o.base ?? o['base-file'],
+            format: o.format === 'md' ? 'md' : 'text',
+        });
+    if (o.out) {
+        const file = abs(cfg, o.out);
+        mkdirSync(dirname(file), { recursive: true });
+        writeFileSync(file, report + '\n');
+    }
+    else
+        console.log(report);
+    return errorsOnly(result.findings).length ? 1 : 0;
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/migrate.d.ts

@@ -0,0 +1,4 @@
+import { type CageConfig } from './config.js';
+/** 给首次使用者可执行的步骤，只展示地址和库名，绝不输出连接串中的密码。 */
+export declare function databaseConnectionError(error: unknown, databaseUrl: string): Error;
+export declare function migrate(cfg: CageConfig, env?: NodeJS.ProcessEnv): Promise<import("@yss123/cage-kernel/db").MigrateResult>;

package/dist/migrate.js

@@ -0,0 +1,30 @@
+// 迁移只更新已有数据库的表、视图；账号权限由 cage init 准备，不在迁移中隐式修改。
+import { readMigrations, runMigrations } from '@yss123/cage-kernel/db';
+import { urlsFromEnv } from '@yss123/cage-kernel';
+import { abs } from './config.js';
+import { loadRegistry } from './load.js';
+/** 给首次使用者可执行的步骤，只展示地址和库名，绝不输出连接串中的密码。 */
+export function databaseConnectionError(error, databaseUrl) {
+    const code = error?.code;
+    const target = new URL(databaseUrl);
+    const address = `${target.hostname}:${target.port || '5432'}${target.pathname}`;
+    const messages = {
+        '28P01': `无法使用当前配置登录数据库 ${address}。请检查项目根目录 .env 中的地址、端口、账号和密码是否属于同一个数据库；框架不会自动修改数据库账号。`,
+        '3D000': `数据库 ${address} 不存在。请在项目根目录 .env 中填写已经存在的 PostgreSQL 数据库；框架不会创建数据库。`,
+        ECONNREFUSED: `无法连接数据库 ${address}。请检查数据库服务是否运行，并核对项目根目录 .env 中的地址和端口。`,
+    };
+    return code && messages[code] ? new Error(messages[code], { cause: error }) : error instanceof Error ? error : new Error(String(error));
+}
+export async function migrate(cfg, env = process.env) {
+    const urls = urlsFromEnv(env);
+    if (!urls.migrate)
+        throw new Error('[CAGE-ENV-001] 设置 CAGE_MIGRATE_DATABASE_URL');
+    const { registry } = await loadRegistry(abs(cfg, cfg.domain));
+    return runMigrations({
+        migrateUrl: urls.migrate,
+        registry,
+        migrations: readMigrations(abs(cfg, cfg.migrations)),
+        log: console.log,
+    }).catch((error) => { throw databaseConnectionError(error, urls.migrate); });
+}
+//# sourceMappingURL=migrate.js.map

package/dist/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,GAAG,EAAmB,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,yCAAyC;AACzC,MAAM,UAAU,uBAAuB,CAAC,KAAc,EAAE,WAAmB;IACzE,MAAM,IAAI,GAAI,KAA2B,EAAE,IAAI,CAAC;IAChD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChF,MAAM,QAAQ,GAA2B;QACvC,OAAO,EAAE,iBAAiB,OAAO,uDAAuD;QACxF,OAAO,EAAE,OAAO,OAAO,sDAAsD;QAC7E,YAAY,EAAE,WAAW,OAAO,sCAAsC;KACvE,CAAC;IACF,OAAO,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1I,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAe,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG;IAC9D,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAClF,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9D,OAAO,aAAa,CAAC;QACnB,UAAU,EAAE,IAAI,CAAC,OAAO;QACxB,QAAQ;QACR,UAAU,EAAE,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;QACpD,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,uBAAuB,CAAC,KAAK,EAAE,IAAI,CAAC,OAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC"}

package/dist/ontology.d.ts

@@ -0,0 +1,43 @@
+import { type Registry } from '@yss123/cage-kernel';
+import type { DeclSite } from './static-check.js';
+export type NodeKind = 'aggregate' | 'field' | 'state' | 'command' | 'event' | 'reaction' | 'query' | 'approval' | 'route' | 'job' | 'connector' | 'outbound' | 'inbound' | 'capability';
+export interface OntNode {
+    kind: NodeKind;
+    id: string;
+    /** 内容哈希：声明变化时哈希变化 */
+    hash: string;
+    file?: string;
+    line?: number;
+    attrs: Record<string, unknown>;
+}
+export type EdgeKind = 'transition' | 'reads' | 'emits' | 'uses' | 'triggers' | 'cancels' | 'targets' | 'queries' | 'refs' | 'calls' | 'binds' | 'field';
+export interface OntEdge {
+    kind: EdgeKind;
+    from: string;
+    to: string;
+    via?: string;
+    alias?: string;
+    acquires?: string;
+    releases?: string;
+    /** uses 边的来源说明：约束、事件载荷、路由条件、出站映射、查询 */
+    as?: string;
+    cardinality?: 'many-to-one' | 'one-to-one' | 'one-to-many' | 'many-to-many';
+    mappedBy?: string;
+}
+export interface Ontology {
+    version: 1;
+    nodes: OntNode[];
+    edges: OntEdge[];
+    unsafeCount: number;
+}
+export declare function extract(reg: Registry, sites?: DeclSite[], unsafeCount?: number): Ontology;
+export interface NodeDiff {
+    added: OntNode[];
+    removed: OntNode[];
+    changed: {
+        before: OntNode;
+        after: OntNode;
+    }[];
+}
+export declare function diffOntology(base: Ontology, head: Ontology): NodeDiff;
+export declare const nodeById: (g: Ontology) => Map<string, OntNode>;

package/dist/ontology.js

@@ -0,0 +1,280 @@
+// 抽取器：把声明变成一张本体图（节点 + 边），写到 .cage/ontology.json。规则检查、影响分析、测试生成都读这张图。
+import { createHash } from 'node:crypto';
+import { isRelation, snake, stableStringify } from '@yss123/cage-kernel';
+import { z } from 'zod';
+const h = (v) => createHash('sha256').update(stableStringify(v)).digest('hex').slice(0, 12);
+function jsonSchema(s) {
+    try {
+        return z.toJSONSchema(s, { unrepresentable: 'any', io: 'input' });
+    }
+    catch {
+        return null;
+    }
+}
+function fieldAttrs(f) {
+    return {
+        kind: f.kind,
+        sql: f.sql,
+        optional: f.isOptional,
+        sensitive: f.sensitiveKind ?? null,
+        ref: f.ref ?? null,
+        unique: !!f.isUnique,
+        hidden: !!f.isHidden,
+        ...(isRelation(f) ? { virtual: true, mappedBy: f.mappedBy ?? null, readOnly: f.kind === 'hasMany' } : {}),
+        description: f.description ?? null,
+        values: f.values ?? null,
+        shape: f.shape
+            ? Object.fromEntries(Object.entries(f.shape).map(([k, sf]) => [
+                k,
+                { kind: sf.kind, optional: sf.isOptional },
+            ]))
+            : null,
+    };
+}
+export function extract(reg, sites = [], unsafeCount = 0) {
+    const nodes = [];
+    const edges = [];
+    const siteOf = new Map(sites.map((s) => [s.exportName, s]));
+    const where = (v) => {
+        const n = reg.nameOf(v);
+        const s = n ? siteOf.get(n) : undefined;
+        return s ? { file: s.file, line: s.line } : {};
+    };
+    const textHash = (v) => {
+        const n = reg.nameOf(v);
+        const s = n ? siteOf.get(n) : undefined;
+        // Git 的 autocrlf 会改变检出文件的换行。源码哈希统一换行，避免没有业务改动
+        // 却把整张命令图都报成变化；字符串字面量的转义内容仍保留原样。
+        return s ? h(s.text.replace(/\r\n/g, '\n')) : null;
+    };
+    const push = (kind, id, attrs, at = {}) => nodes.push({ kind, id, hash: h({ kind, id, attrs }), ...at, attrs });
+    const aggOfField = new Map();
+    for (const a of reg.aggregates) {
+        push('aggregate', a.name, {
+            table: `${a.table.schema}.${a.table.name}`,
+            scope: { dept: a.scope.deptField ?? null, owner: a.scope.ownerField ?? null },
+            invariants: Object.keys(a.invariants),
+            invariantSrc: Object.fromEntries(Object.entries(a.invariants).map(([k, fn]) => [k, h(String(fn))])),
+            description: a.description ?? null,
+            defaultStates: a.states.values.join() === 'active,deleted',
+        }, where(a));
+        for (const [k, f] of Object.entries(a.fields)) {
+            push('field', `${a.name}.${k}`, { ...fieldAttrs(f),
+                ...(f.kind === 'manyToMany' ? { through: `${a.table.schema}.${a.table.name}__${snake(k)}` } : {}),
+            });
+            edges.push({ kind: 'field', from: a.name, to: `${a.name}.${k}` });
+            aggOfField.set(`${a.name}.${k}`, a);
+            if (f.ref)
+                edges.push({ kind: 'refs', from: `${a.name}.${k}`, to: f.ref,
+                    cardinality: f.kind === 'hasMany' ? 'one-to-many' : f.kind === 'manyToMany' ? 'many-to-many' : f.isUnique ? 'one-to-one' : 'many-to-one',
+                    ...(f.mappedBy ? { mappedBy: f.mappedBy } : {}),
+                });
+        }
+        for (const s of a.states.values) {
+            push('state', `${a.name}.${s}`, {
+                terminal: a.states.terminal.includes(s),
+                initial: a.states.initial === s,
+            });
+        }
+        push('capability', `${a.name}.read`, { kind: 'read' });
+        push('capability', `${a.name}.export`, { kind: 'export' });
+    }
+    for (const e of reg.events) {
+        push('event', e.name, { fields: Object.fromEntries(Object.entries(e.fields).map(([k, f]) => [k, fieldAttrs(f)])) }, where(e));
+    }
+    for (const c of reg.commands) {
+        const { cmd, capability } = c;
+        const agg = cmd.agg.name;
+        push('command', capability, {
+            from: cmd.from,
+            to: cmd.to,
+            invokedBy: cmd.invokedBy,
+            input: jsonSchema(cmd.input),
+            reads: Object.fromEntries(Object.entries(cmd.reads).map(([k, a]) => [k, a.name])),
+            emits: cmd.emits.map((e) => e.event.name),
+            customEmit: cmd.emits.filter((e) => e.map).map((e) => e.event.name),
+            constraints: cmd.constraints.map((k) => k.name),
+            src: textHash(cmd) ?? h(String(cmd.handler)),
+            domainCodes: sites.find((s) => s.exportName === c.exportName)?.domainCodes ?? [],
+            public: cmd.public,
+        }, where(cmd));
+        const froms = cmd.from === 'new' ? ['[new]'] : cmd.from;
+        for (const f of froms) {
+            edges.push({
+                kind: 'transition',
+                from: f === '[new]' ? `${agg}.[new]` : `${agg}.${f}`,
+                // to: null 是各允许起始状态上的自环，不能生成名为 null 的虚假状态。
+                to: `${agg}.${cmd.to ?? f}`,
+                via: capability,
+            });
+        }
+        for (const [alias, a] of Object.entries(cmd.reads))
+            edges.push({ kind: 'reads', from: capability, to: a.name, alias });
+        for (const spec of cmd.emits) {
+            edges.push({ kind: 'emits', from: capability, to: spec.event.name });
+            // 事件载荷用到了聚合的哪些字段（默认映射按同名字段）
+            if (!spec.map) {
+                for (const k of Object.keys(spec.event.fields)) {
+                    if (k in cmd.agg.fields)
+                        edges.push({ kind: 'uses', from: spec.event.name, to: `${agg}.${k}`, as: '事件载荷' });
+                }
+            }
+        }
+        for (const k of cmd.constraints) {
+            for (const f of k.fields ?? [])
+                edges.push({ kind: 'uses', from: capability, to: `${agg}.${f}`, as: `约束 ${k.name}` });
+        }
+    }
+    for (const { r, name } of reg.reactions) {
+        push('reaction', name, {
+            tx: r.tx,
+            acquires: r.acquires ?? null,
+            releases: r.releases ?? null,
+            event: r.event.name,
+            command: reg.capabilityOf(r.command),
+            src: h(String(r.map)),
+        }, where(r));
+        edges.push({ kind: 'triggers', from: r.event.name, to: name });
+        edges.push({
+            kind: 'targets',
+            from: name,
+            to: reg.capabilityOf(r.command),
+            acquires: r.acquires,
+            releases: r.releases,
+        });
+    }
+    for (const q of reg.queries) {
+        push('query', q.name, {
+            reads: q.reads.map((a) => a.name),
+            sql: q.sql ? h(q.sql) : null,
+            build: q.build ? h(String(q.build)) : null,
+            input: jsonSchema(q.input),
+            sqlText: q.sql ?? null,
+        }, where(q));
+        for (const a of q.reads) {
+            edges.push({ kind: 'queries', from: q.name, to: a.name });
+            const text = (q.sql ?? String(q.build ?? '')).toLowerCase();
+            for (const k of Object.keys(a.fields)) {
+                if (new RegExp(`\\b(${snake(k)}|${k.toLowerCase()})\\b`).test(text))
+                    edges.push({ kind: 'uses', from: q.name, to: `${a.name}.${k}`, as: '查询' });
+            }
+        }
+    }
+    for (const { a, name } of reg.approvals) {
+        push('approval', name, {
+            process: a.process,
+            aggregate: a.agg.name,
+            start: a.start.name,
+            routable: a.routable,
+            onApproved: reg.capabilityOf(a.onApproved),
+            onRejected: reg.capabilityOf(a.onRejected),
+            cancelOn: a.cancelOn.map((e) => e.name),
+        }, where(a));
+        edges.push({ kind: 'triggers', from: a.start.name, to: name });
+        // cancelOn 原本只留在属性中，沿图查取消逻辑时会漏掉审批。把声明中的事件
+        // 也抽成关系，明确它负责取消流程，不能与 start 混成“启动审批”。
+        for (const event of a.cancelOn)
+            edges.push({ kind: 'cancels', from: event.name, to: name });
+        edges.push({ kind: 'binds', from: name, to: reg.capabilityOf(a.onApproved) });
+        edges.push({ kind: 'binds', from: name, to: reg.capabilityOf(a.onRejected) });
+        for (const f of a.routable)
+            edges.push({ kind: 'uses', from: name, to: `${a.agg.name}.${f}`, as: '可路由字段' });
+    }
+    for (const j of reg.jobs) {
+        push('job', j.name, {
+            cron: j.cron,
+            reads: j.reads.map((a) => a.name),
+            calls: j.calls.map((c) => reg.capabilityOf(c)),
+            src: h(String(j.run)),
+        }, where(j));
+        for (const a of j.reads)
+            edges.push({ kind: 'queries', from: j.name, to: a.name });
+        for (const c of j.calls)
+            edges.push({ kind: 'calls', from: j.name, to: reg.capabilityOf(c) });
+    }
+    for (const e of reg.extensions) {
+        const v = e.value;
+        if (e.kind === 'ROUTE') {
+            const binding = reg.approvalByProcess(v.process);
+            push('route', `route:${v.process}`, { process: v.process, nodes: v.nodes }, { ...(siteOf.get(e.name) ? { file: siteOf.get(e.name).file, line: siteOf.get(e.name).line } : {}) });
+            if (binding) {
+                edges.push({ kind: 'binds', from: `route:${v.process}`, to: binding.name });
+                for (const f of v.fieldsUsed)
+                    edges.push({
+                        kind: 'uses',
+                        from: `route:${v.process}`,
+                        to: `${binding.a.agg.name}.${f}`,
+                        as: '路由条件',
+                    });
+            }
+        }
+        else if (e.kind === 'CONNECTOR') {
+            push('connector', `connector:${v.name}`, {
+                hosts: v.hosts,
+                secret: v.secret ?? null,
+                operations: Object.fromEntries(Object.entries(v.operations).map(([k, o]) => [
+                    k,
+                    {
+                        effect: o.effect,
+                        method: o.method,
+                        path: o.path,
+                        request: jsonSchema(o.request),
+                        response: jsonSchema(o.response),
+                    },
+                ])),
+            }, siteOf.get(e.name) ? { file: siteOf.get(e.name).file, line: siteOf.get(e.name).line } : {});
+        }
+        else if (e.kind === 'OUTBOUND') {
+            const id = e.name;
+            push('outbound', id, {
+                event: v.event.name,
+                connector: v.op.connector.name,
+                operation: v.op.name,
+                onSuccess: v.onSuccess ? reg.capabilityOf(v.onSuccess.command) : null,
+                src: h(String(v.map)),
+            }, siteOf.get(e.name) ? { file: siteOf.get(e.name).file, line: siteOf.get(e.name).line } : {});
+            edges.push({ kind: 'triggers', from: v.event.name, to: id });
+            edges.push({ kind: 'targets', from: id, to: `connector:${v.op.connector.name}` });
+            if (v.onSuccess)
+                edges.push({ kind: 'targets', from: id, to: reg.capabilityOf(v.onSuccess.command) });
+            // 出站映射用到的事件字段 → 这些字段在聚合里的同名字段
+            const emitters = reg.commands.filter((c) => c.cmd.emits.some((s) => s.event === v.event));
+            for (const f of v.fields ?? []) {
+                for (const c of emitters)
+                    if (f in c.cmd.agg.fields)
+                        edges.push({ kind: 'uses', from: id, to: `${c.cmd.agg.name}.${f}`, as: '出站映射' });
+            }
+        }
+        else if (e.kind === 'INBOUND') {
+            const id = e.name;
+            push('inbound', id, {
+                connector: v.connector.name,
+                event: v.event,
+                command: reg.capabilityOf(v.command),
+                payload: jsonSchema(v.payload),
+            }, siteOf.get(e.name) ? { file: siteOf.get(e.name).file, line: siteOf.get(e.name).line } : {});
+            edges.push({ kind: 'targets', from: id, to: reg.capabilityOf(v.command) });
+        }
+    }
+    nodes.sort((a, b) => a.id.localeCompare(b.id) || a.kind.localeCompare(b.kind));
+    return { version: 1, nodes, edges, unsafeCount };
+}
+export function diffOntology(base, head) {
+    const key = (n) => `${n.kind}:${n.id}`;
+    const b = new Map(base.nodes.map((n) => [key(n), n]));
+    const hd = new Map(head.nodes.map((n) => [key(n), n]));
+    const out = { added: [], removed: [], changed: [] };
+    for (const [k, n] of hd) {
+        const old = b.get(k);
+        if (!old)
+            out.added.push(n);
+        else if (old.hash !== n.hash)
+            out.changed.push({ before: old, after: n });
+    }
+    for (const [k, n] of b)
+        if (!hd.has(k))
+            out.removed.push(n);
+    return out;
+}
+export const nodeById = (g) => new Map(g.nodes.map((n) => [n.id, n]));
+//# sourceMappingURL=ontology.js.map

package/dist/ontology.js.map

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