@yss123/cage-cli 0.0.0-stage → 0.1.0

package/dist/impact.js

@@ -0,0 +1,223 @@
+// 影响分析：在基线和当前各生成一张图，找出变化的节点，再沿着边向外扩散。
+// handler 文件的改动会被映射到它所属的命令节点，所以只改实现、不改声明也能算出影响。
+import { execFileSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { checkEventCompat } from './rules.js';
+import { diffOntology } from './ontology.js';
+const git = (cwd, args) => execFileSync('git', args, { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }).trim();
+export function isGitRepo(root) {
+    try {
+        return git(root, ['rev-parse', '--is-inside-work-tree']) === 'true';
+    }
+    catch {
+        return false;
+    }
+}
+export function changedFiles(root, base) {
+    const out = new Set();
+    const add = (s) => s
+        .split('\n')
+        .map((x) => x.trim())
+        .filter(Boolean)
+        .forEach((x) => out.add(x));
+    try {
+        add(git(root, ['diff', '--relative', '--name-only', `${base}...HEAD`]));
+    }
+    catch {
+        /* 基线不存在 */
+    }
+    try {
+        add(git(root, ['diff', '--relative', '--name-only']));
+        add(git(root, ['diff', '--relative', '--name-only', '--cached']));
+        add(git(root, ['ls-files', '--others', '--exclude-standard']));
+    }
+    catch {
+        /* 非 git */
+    }
+    return [...out];
+}
+export function readOntology(path) {
+    return JSON.parse(readFileSync(path, 'utf8'));
+}
+const LABEL = {
+    command: '命令',
+    event: '事件',
+    reaction: '反应',
+    query: '查询',
+    approval: '审批绑定',
+    route: '路由',
+    outbound: '外部',
+    inbound: '入站',
+    job: '任务',
+    aggregate: '聚合',
+    field: '字段',
+    state: '状态',
+    connector: '连接器',
+    capability: '能力点',
+};
+export function impact(base, head, files, tests = [], projectTestFiles = []) {
+    const diff = diffOntology(base, head);
+    const start = new Set([...diff.added, ...diff.removed, ...diff.changed.map((c) => c.after)].map((n) => n.id));
+    // handler 文件改动映射到它所属的命令（以及文件里的其他声明）
+    const norm = (p) => p.replace(/\\/g, '/');
+    for (const n of head.nodes)
+        if (n.file && files.map(norm).includes(norm(n.file)))
+            start.add(n.id);
+    const reasons = new Map();
+    for (const id of start)
+        reasons.set(id, '直接变化');
+    const affected = new Set(start);
+    const queue = [...start];
+    while (queue.length) {
+        const n = queue.shift();
+        // 删除节点时关系已从 head 消失；同时遍历旧图才能找到旧字段的消费者。
+        for (const e of [...base.edges, ...head.edges]) {
+            let next = null;
+            let why = '';
+            if (e.kind === 'reads' && e.to === n) {
+                next = e.from;
+                why = `读依赖 ${n}`;
+            }
+            else if (e.kind === 'queries' && e.to === n) {
+                next = e.from;
+                why = `读取 ${n}`;
+            }
+            else if (e.kind === 'uses' && e.to === n) {
+                next = e.from;
+                why = `${e.as ?? '使用'}用到 ${n}`;
+            }
+            else if (e.kind === 'emits' && e.from === n) {
+                next = e.to;
+                why = `由 ${n} 发出`;
+            }
+            else if (e.kind === 'triggers' && e.from === n) {
+                next = e.to;
+                why = `订阅 ${n}`;
+            }
+            else if (e.kind === 'targets' && e.from === n) {
+                next = e.to;
+                why = `被 ${n} 调用`;
+            }
+            else if (e.kind === 'binds' && e.to === n) {
+                next = e.from;
+                why = `结论落到 ${n}`;
+            }
+            else if (e.kind === 'binds' && e.from === n) {
+                next = e.to;
+                why = `由 ${n} 调用`;
+            }
+            else if (e.kind === 'field' && e.from === n && diff.changed.some((c) => c.after.id === n)) {
+                /* 聚合变化不扩散到每个字段 */
+            }
+            if (next && !affected.has(next)) {
+                affected.add(next);
+                reasons.set(next, why);
+                queue.push(next);
+            }
+        }
+    }
+    const pick = tests.filter((t) => affected.has(t.subject) || affected.has(t.subject.split('.')[0]));
+    const names = [...affected].map((id) => id.split('.').pop());
+    const projectTests = projectTestFiles.filter((f) => {
+        try {
+            const text = readFileSync(f, 'utf8');
+            return names.some((n) => n.length > 2 && text.includes(n));
+        }
+        catch {
+            return false;
+        }
+    });
+    // 需要人工确认的点
+    const confirm = [];
+    const headById = new Map(head.nodes.map((n) => [n.id, n]));
+    for (const c of diff.changed) {
+        if (c.after.kind === 'field') {
+            const ceilings = head.edges.filter((e) => e.kind === 'uses' && e.to === c.after.id && String(e.as).includes('ceiling'));
+            if (ceilings.length)
+                confirm.push(`角色上的审批额度参数是否按 ${c.after.id} 的新口径调整`);
+            if (c.before.attrs.description !== c.after.attrs.description)
+                confirm.push(`${c.after.id} 的口径说明变了：下游报表、外部系统是否同步`);
+        }
+    }
+    for (const n of diff.added) {
+        if (n.kind === 'command')
+            confirm.push(`新能力点 ${n.id} 默认无人拥有，需要管理员在 /admin 授权`);
+    }
+    for (const n of [...affected].map((id) => headById.get(id)).filter((x) => !!x)) {
+        if (n.kind === 'outbound' && !start.has(n.id))
+            confirm.push(`外部同步 ${n.id} 受影响：对方系统是否兼容`);
+    }
+    return {
+        diff,
+        start: [...start],
+        affected: [...affected],
+        reasons,
+        tests: pick,
+        projectTests,
+        confirm: [...new Set(confirm)],
+        unsafe: { base: base.unsafeCount ?? 0, head: head.unsafeCount ?? 0 },
+        findings: checkEventCompat(base, head),
+    };
+}
+function describeNode(n) {
+    if (n.kind === 'command') {
+        const from = n.attrs.from === 'new' ? '新建' : n.attrs.from.join('/');
+        return `${LABEL.command} ${n.id}（${from} → ${n.attrs.to ?? '保持当前状态'}）`;
+    }
+    if (n.kind === 'reaction')
+        return `${LABEL.reaction} ${n.id}${n.attrs.acquires ? `（acquires: ${n.attrs.acquires}）` : ''}${n.attrs.releases ? `（releases: ${n.attrs.releases}）` : ''}`;
+    return `${LABEL[n.kind] ?? n.kind} ${n.id}`;
+}
+export function formatImpact(r, head, opts) {
+    const byId = new Map(head.nodes.map((n) => [n.id, n]));
+    const md = opts.format === 'md';
+    const L = [];
+    const h = (s) => (md ? `**${s}**` : s);
+    L.push(md ? `### cage 摘要${opts.title ? ` · ${opts.title}` : ''}` : `cage impact（相对 ${opts.base}）`);
+    if (opts.gates)
+        L.push(`${h('门禁：')}${opts.gates}`);
+    const changes = [
+        ...r.diff.added
+            .filter((n) => n.kind !== 'state' && n.kind !== 'capability')
+            .map((n) => `+ ${describeNode(n)}`),
+        ...r.diff.removed
+            .filter((n) => n.kind !== 'state' && n.kind !== 'capability')
+            .map((n) => `- ${describeNode(n)}`),
+        ...r.diff.changed.map(({ before, after }) => {
+            const what = after.kind === 'field' && before.attrs.description !== after.attrs.description
+                ? '口径说明被修改'
+                : '声明被修改';
+            return `~ ${describeNode(after)}（${what}）`;
+        }),
+        ...r.start
+            .filter((id) => !r.diff.added.some((n) => n.id === id) &&
+            !r.diff.removed.some((n) => n.id === id) &&
+            !r.diff.changed.some((c) => c.after.id === id))
+            .map((id) => `~ ${byId.get(id) ? describeNode(byId.get(id)) : id}（实现被修改）`),
+    ];
+    L.push(h('变化：'));
+    L.push(...(changes.length ? changes.map((c) => `  ${c}`) : ['  无']));
+    const affected = r.affected
+        .filter((id) => !r.start.includes(id))
+        .map((id) => byId.get(id))
+        .filter((n) => !!n && n.kind !== 'state' && n.kind !== 'field');
+    L.push(h('受影响：'));
+    L.push(...(affected.length
+        ? affected.map((n) => `  - ${(LABEL[n.kind] ?? n.kind).padEnd(4, '　')} ${n.id}（${r.reasons.get(n.id)}）`)
+        : ['  无']));
+    L.push(`${h('必须运行的测试：')}派生测试 ${r.tests.length} 个，项目测试 ${r.projectTests.length} 个`);
+    L.push(`${h('unsafe：')}${r.unsafe.head}（${r.unsafe.head === r.unsafe.base ? '与基线持平' : r.unsafe.head > r.unsafe.base ? `比基线多 ${r.unsafe.head - r.unsafe.base}` : `比基线少 ${r.unsafe.base - r.unsafe.head}`}）`);
+    if (r.findings.length) {
+        L.push(h('兼容性问题：'));
+        for (const f of r.findings)
+            L.push(`  [${f.code}] ${f.reason}`);
+    }
+    if (r.confirm.length) {
+        L.push(h('需要人工确认：'));
+        L.push(...r.confirm.map((c) => `  - ${c}`));
+    }
+    return md
+        ? L.map((l) => (l.startsWith('  ') ? l.replace(/^ {2}/, '- ').replace(/^- - /, '  - ') : l)).join('\n')
+        : L.join('\n');
+}
+//# sourceMappingURL=impact.js.map

package/dist/impact.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export * from './analyze.js';
+export * from './config.js';
+export * from './ontology.js';
+export * from './rules.js';
+export * from './findings.js';
+export * from './impact.js';
+export * from './derive.js';
+export * from './gen/index.js';
+export * from './sync.js';
+export * from './upgrade.js';
+export * from './budget.js';
+export * from './create.js';
+export * from './verify.js';
+export * from './database.js';
+export { serveGraph, collectGraph } from './graph.js';
+export { main } from './main.js';

package/dist/index.js

@@ -0,0 +1,18 @@
+// 对外公开可组合的工具链；bin/cage.js 是这些函数的命令行封装。
+export * from './analyze.js';
+export * from './config.js';
+export * from './ontology.js';
+export * from './rules.js';
+export * from './findings.js';
+export * from './impact.js';
+export * from './derive.js';
+export * from './gen/index.js';
+export * from './sync.js';
+export * from './upgrade.js';
+export * from './budget.js';
+export * from './create.js';
+export * from './verify.js';
+export * from './database.js';
+export { serveGraph, collectGraph } from './graph.js';
+export { main } from './main.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/load.d.ts

@@ -0,0 +1,6 @@
+import { type Registry } from '@yss123/cage-kernel';
+export declare function importDomain(entry: string): Promise<Record<string, unknown>>;
+export declare function loadRegistry(entry: string): Promise<{
+    mod: Record<string, unknown>;
+    registry: Registry;
+}>;

package/dist/load.js

@@ -0,0 +1,17 @@
+// 用 tsx 直接导入 domain 包入口。声明都在模块顶层，导入就是全部，不需要运行任何业务逻辑。
+import { pathToFileURL } from 'node:url';
+import { buildRegistry } from '@yss123/cage-kernel';
+import { register } from 'tsx/esm/api';
+let registered = false;
+export async function importDomain(entry) {
+    if (!registered) {
+        register();
+        registered = true;
+    }
+    return (await import(pathToFileURL(entry).href));
+}
+export async function loadRegistry(entry) {
+    const mod = await importDomain(entry);
+    return { mod, registry: buildRegistry(mod) };
+}
+//# sourceMappingURL=load.js.map

package/dist/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../src/load.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAiB,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAa;IAC9C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,QAAQ,EAAE,CAAC;QACX,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;IACD,OAAO,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAA4B,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAa;IAEb,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IACtC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;AAC/C,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1 @@
+export declare function main(argv?: string[]): Promise<number>;

package/dist/main.js

@@ -0,0 +1,176 @@
+// 命令入口只负责参数、输出和退出码；分析、生成、迁移都保留独立公共函数供测试调用。
+import { parseArgs } from 'node:util';
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { loadConfig, abs } from './config.js';
+import { analyze } from './analyze.js';
+import { errorsOnly, formatFindings } from './findings.js';
+import { generate } from './gen/index.js';
+import { verify, testProject } from './verify.js';
+import { budget } from './budget.js';
+import { sync } from './sync.js';
+import { upgrade, VERSION } from './upgrade.js';
+import { createApp } from './create.js';
+import { migrate } from './migrate.js';
+import { dev } from './dev.js';
+import { loadBaseline } from './baseline.js';
+import { changedFiles, impact, formatImpact } from './impact.js';
+import { deriveTests } from './derive.js';
+import { installDependencies, run } from './process.js';
+import { fileURLToPath } from 'node:url';
+import { loadProjectEnv } from './env.js';
+import { database } from './database.js';
+import { serveGraph } from './graph.js';
+const help = `cage ${VERSION}
+  create <目录> [--framework-path 路径]  从 React 模板建项目，可链接本地框架
+  dev                              启动本地数据库、API、worker 和 Web
+  db setup|up|init|status|down      配置、启动、初始化、查看或停止 Docker 数据库
+  analyze | check                  抽取本体 / 检查声明与图规则
+  graph [--port 15418]             启动本体图谱 Web 工作台
+  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 [--init]                 执行迁移；init 从环境读取建库凭证
+  通用选项：--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' },
+            'framework-path': { type: 'string' },
+            base: { type: 'string' },
+            'base-file': { type: 'string' },
+            format: { type: 'string' },
+            out: { type: 'string' },
+            only: { type: 'string' },
+            to: { type: 'string' },
+            check: { type: 'boolean' },
+            init: { 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') {
+        if (!target)
+            throw new Error('用法：cage create <目录>');
+        console.log(`已创建 ${createApp(target, o['framework-path'])}\n进入项目后运行 pnpm install、pnpm build:app、pnpm cage gen、pnpm cage dev`);
+        return 0;
+    }
+    const cfg = loadConfig(o.root);
+    loadProjectEnv(cfg.root);
+    if (command === 'graph') {
+        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 === 'db')
+        return database(cfg, target);
+    if (command === 'sync') {
+        const findings = sync(cfg, o.check);
+        console.log(findings.length ? formatFindings(findings) : '托管区已同步');
+        return errorsOnly(findings).length ? 1 : 0;
+    }
+    if (command === 'upgrade') {
+        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 dev(cfg);
+    if (command === 'migrate') {
+        await migrate(cfg, o.init);
+        return 0;
+    }
+    const base = await loadBaseline(cfg, { base: o.base, baseFile: o['base-file'] });
+    if (command === 'verify')
+        return verify(cfg, { base, skipTests: o['skip-tests'] });
+    // 框架仓库自身没有 domain 入口，但仍需在 CI 检查内核体积与原语预算。
+    if (command === 'budget' && !existsSync(abs(cfg, cfg.domain))) {
+        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;
+    }
+    if (!['analyze', 'check', 'gen', 'test', 'budget', 'impact'].includes(command))
+        throw new Error(`未知命令 ${command}，运行 cage --help 查看用法`);
+    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 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 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 testProject(cfg, a.graph, o.only);
+    }
+    if (!base)
+        throw new Error('[CAGE-IMPACT-001] impact 需要 --base 提交 或 --base-file 本体图.json');
+    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":"AAAA,2CAA2C;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,IAAI,GAAG,QAAQ,OAAO;;;;;;;;;;;;;;;oCAeQ,CAAC;AAErC,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;QAC3C,IAAI,EAAE,IAAI;QACV,gBAAgB,EAAE,IAAI;QACtB,OAAO,EAAE;YACP,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACpC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACtB,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YACzB,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC9B,eAAe,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YACpC,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YACjC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;YACrC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC7B;KACF,CAAC,CAAC;IACH,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC;IACtC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CACT,OAAO,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,gBAAgB,CAAC,CAAC,mEAAmE,CACjH,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/B,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACnG,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,QAAQ,GAAG,CAAC,IAAI,6CAA6C,CAAC,CAAC;QACjG,sCAAsC;QACtC,MAAM,IAAI,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC9B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACnD,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACnE,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CACT,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC3F,WAAW,CACd,CAAC;QACF,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC;YAAE,OAAO,CAAC,CAAC;QACjD,0CAA0C;QAC1C,4BAA4B;QAC5B,IAAI,MAAM,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACtE,IAAI,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QAChD,OAAO,GAAG,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACjF,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACnF,0CAA0C;IAC1C,IAAI,OAAO,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACvF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5C,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzE,OAAO,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,QAAQ,OAAO,sBAAsB,CAAC,CAAC;IACzD,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/D,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC;IACvE,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;QAC3E,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACjF,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC,OAAO,CAAC,MAAM,MAAM,CAAC,CAAC;QAC1E,OAAO,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/D,OAAO,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAyC,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAC3F,MAAM,MAAM,GAAG,MAAM,CACnB,IAAI,EACJ,CAAC,CAAC,KAAK,EACP,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAC5C,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAChC,CAAC;IACF,MAAM,MAAM,GACV,CAAC,CAAC,MAAM,KAAK,MAAM;QACjB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACrF,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE;YAC5B,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,CAAE;YAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM;SAC1C,CAAC,CAAC;IACT,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;QACV,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;QAC7B,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACrC,CAAC;;QAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,OAAO,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/migrate.d.ts

@@ -0,0 +1,7 @@
+import { type CageConfig } from './config.js';
+export declare function initializeDatabase(superUrl: string, databaseUrl: string, passwords: {
+    app: string;
+    read: string;
+    migrate: string;
+}): Promise<void>;
+export declare function migrate(cfg: CageConfig, init?: boolean, env?: NodeJS.ProcessEnv): Promise<import("@yss123/cage-kernel/db").MigrateResult>;

package/dist/migrate.js

@@ -0,0 +1,69 @@
+import pg from 'pg';
+import { bootstrapSql, q, readMigrations, runMigrations } from '@yss123/cage-kernel/db';
+import { urlsFromEnv } from '@yss123/cage-kernel';
+import { abs } from './config.js';
+import { loadRegistry } from './load.js';
+export async function initializeDatabase(superUrl, databaseUrl, passwords) {
+    const target = new URL(databaseUrl);
+    const name = decodeURIComponent(target.pathname.slice(1));
+    if (!/^[a-z][a-z0-9_]{0,62}$/.test(name))
+        throw new Error('[CAGE-MIG-003] 数据库名只允许小写字母、数字和下划线，以字母开头');
+    const admin = new pg.Client({ connectionString: superUrl });
+    await admin.connect();
+    try {
+        if (!(await admin.query('select 1 from pg_database where datname = $1', [name])).rowCount)
+            await admin.query(`create database ${q(name)}`);
+    }
+    finally {
+        await admin.end();
+    }
+    const url = new URL(superUrl);
+    url.pathname = `/${name}`;
+    const db = new pg.Client({ connectionString: url.toString() });
+    await db.connect();
+    try {
+        // 角色是集群级别；重复初始化不能静默轮换其他项目的密码。
+        if ((await db.query("select 1 from pg_roles where rolname in ('cage_app','cage_read','cage_migrate')"))
+            .rowCount) {
+            throw new Error('[CAGE-MIG-004] 集群已有 cage 账号，拒绝覆盖密码；请复用已初始化的库或使用独立 PostgreSQL 集群');
+        }
+        await db.query('begin');
+        await db.query(bootstrapSql(passwords, name));
+        await db.query('commit');
+    }
+    catch (e) {
+        await db.query('rollback');
+        throw e;
+    }
+    finally {
+        await db.end();
+    }
+}
+export async function migrate(cfg, init = false, env = process.env) {
+    const urls = urlsFromEnv(env);
+    if (!urls.migrate)
+        throw new Error('[CAGE-ENV-001] 设置 CAGE_MIGRATE_DATABASE_URL');
+    if (init) {
+        if (!env.CAGE_SUPER_DATABASE_URL)
+            throw new Error('[CAGE-ENV-001] 初始化需要 CAGE_SUPER_DATABASE_URL');
+        const password = (url) => {
+            const pw = decodeURIComponent(new URL(url).password);
+            if (!pw)
+                throw new Error('[CAGE-ENV-001] 初始化连接串必须包含密码');
+            return pw;
+        };
+        await initializeDatabase(env.CAGE_SUPER_DATABASE_URL, urls.migrate, {
+            app: password(urls.app),
+            read: password(urls.read),
+            migrate: password(urls.migrate),
+        });
+    }
+    const { registry } = await loadRegistry(abs(cfg, cfg.domain));
+    return runMigrations({
+        migrateUrl: urls.migrate,
+        registry,
+        migrations: readMigrations(abs(cfg, cfg.migrations)),
+        log: console.log,
+    });
+}
+//# sourceMappingURL=migrate.js.map

package/dist/migrate.js.map

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

package/dist/ontology.d.ts

@@ -0,0 +1,41 @@
+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' | '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;
+}
+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>;