@yss123/cage-cli 0.1.0 → 0.3.0

package/dist/main.js

@@ -1,42 +1,54 @@
+/**
+ * Cage 命令行总入口，负责参数解析、按需加载、输出和退出状态。
+ * 先处理帮助与创建，再分发无需环境变量的查询，其他命令加载项目 .env 后调用各职责模块。
+ * 不在入口复制领域运行规则；命令 IO、副作用和是否可只读由分支决定，异常由 bin 包装器转为失败退出。
+ */
 // 命令入口只负责参数、输出和退出码；分析、生成、迁移都保留独立公共函数供测试调用。
 import { parseArgs } from 'node:util';
-import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync, 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 { VERSION } from './version.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';
+import { createHash } from 'node:crypto';
 const help = `cage ${VERSION}
-  create <目录> [--framework-path 路径]  从 React 模板建项目，可链接本地框架
-  dev                              启动本地数据库、API、worker 和 Web
-  db setup|up|init|status|down      配置、启动、初始化、查看或停止 Docker 数据库
-  analyze | check                  抽取本体 / 检查声明与图规则
+  create [目录] [--template blank|purchase]  交互选择空白业务项目或采购示例
+    --framework-path <路径>        链接已构建的本地框架，无需先发 npm
+  init                             用管理员连接初始化已有数据库的账号权限，自动填写 .env
+  bootstrap --credentials-file <新文件>  显式初始化组织；凭据仅写入受限文件
+  capabilities [关键词] --format json   查询当前安装版本的公开签名与指南
+  doctor [--runtime-url URL]       只读状态诊断；未检查的运行证据标为 unknown
+  timeline --request-id ID         查询实际异步记录；需 --runtime-url 与受控 Cookie 文件
+  explain <命令> --input-file JSON  解释授权；不执行命令，不写业务数据
+  snapshot save <名称> | list      保存不可覆盖的命名基线
+  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>     与保存的本体图比较
+  impact --snapshot <名称>         与命名基线比较
   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 从环境读取建库凭证
+  migrate                          在已配置的数据库中执行表结构迁移，不创建数据库
   通用选项：--root <目录> --help --version`;
+/**
+ * 解析命令并分发职责模块，供两个 bin 包装器复用。
+ * @param argv 不含 Node 与脚本路径的参数，默认 process.argv.slice(2)。
+ * @returns 命令退出码；doctor 的 2 表示无失败但证据不完整，取消创建返回 130。
+ * @throws 参数、配置和子模块异常交给 bin 处理；不强制退出进程，graph/dev 的句柄保持运行。
+ */
 export async function main(argv = process.argv.slice(2)) {
     const { values: o, positionals } = parseArgs({
         args: argv,
@@ -44,15 +56,29 @@ export async function main(argv = process.argv.slice(2)) {
         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' },
+            snapshot: { type: 'string' },
+            'runtime-url': { type: 'string' },
+            'cookie-file': { type: 'string' },
+            'credentials-file': { type: 'string' },
+            'request-id': { type: 'string' },
+            'outbox-id': { type: 'string' },
+            aggregate: { type: 'string' },
+            'aggregate-id': { type: 'string' },
+            'input-file': { type: 'string' },
+            'user-id': { 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' },
@@ -70,33 +96,129 @@ export async function main(argv = process.argv.slice(2)) {
         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`);
+        // 帮助、版本和参数错误不加载 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',
+        'bootstrap',
+        'capabilities',
+        'doctor',
+        'timeline',
+        'explain',
+        'snapshot',
+        '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);
+    const output = (value) => {
+        const json = JSON.stringify(value, null, 2);
+        const content = o.format === 'md' ? `# Cage ${command}\n\n\`\`\`json\n${json}\n\`\`\`\n` : json + '\n';
+        if (o.out) {
+            const file = abs(cfg, o.out);
+            mkdirSync(dirname(file), { recursive: true });
+            writeFileSync(file, content);
+        }
+        else
+            console.log(content.trimEnd());
+    };
+    if (command === 'capabilities') {
+        output((await import('./capabilities.js')).publicCapabilities(cfg, positionals.slice(1).join(' ')));
+        return 0;
+    }
+    if (command === 'timeline' || command === 'explain') {
+        if (command === 'explain' && (!target || !o['input-file']))
+            throw new Error('[CAGE-DIAG-001] 使用 cage explain <命令> --input-file <JSON文件> --runtime-url <地址> --cookie-file <文件>');
+        const body = command === 'explain' ? { command: target, input: JSON.parse(readFileSync(abs(cfg, o['input-file']), 'utf8')), userId: o['user-id'] } : undefined;
+        const result = await (await import('./runtime-diagnostics.js')).runtimeDiagnostic(cfg, { runtimeUrl: o['runtime-url'], cookieFile: o['cookie-file'] }, `/api/sys/diagnostics/${command === 'timeline' ? 'timeline' : 'authorization'}`, {
+            query: command === 'timeline' ? { requestId: o['request-id'], outboxId: o['outbox-id'], aggregate: o.aggregate, aggregateId: o['aggregate-id'] } : undefined, body,
+        });
+        output(result);
+        return result.ok ? 0 : 1;
+    }
+    if (command === 'doctor') {
+        const report = await (await import('./doctor.js')).doctor(cfg, { runtimeUrl: o['runtime-url'], cookieFile: o['cookie-file'] });
+        output(report);
+        return report.ok ? report.complete ? 0 : 2 : 1;
+    }
+    if (command === 'snapshot') {
+        const snapshots = await import('./snapshots.js');
+        if (target === 'save' && positionals[2]) {
+            const { graph, ...metadata } = await snapshots.saveSnapshot(cfg, positionals[2]);
+            output(metadata);
+        }
+        else if (target === 'list')
+            output(snapshots.listSnapshots(cfg).map(({ graph, ...metadata }) => metadata));
+        else
+            throw new Error('使用 cage snapshot save <名称> 或 cage snapshot list');
+        return 0;
+    }
+    // 查询只分析声明，无需加载项目密钥或连接数据库；每次在独立进程重新抽取。
+    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 === 'bootstrap') {
+        const result = await (await import('./bootstrap.js')).bootstrapOrganization(cfg, o['credentials-file'] ?? '');
+        console.log(`${result.created ? '组织初始化完成' : '组织已存在，账号保持原样'}；结果已写入 ${result.credentialsFile}。业务能力需显式授权。`);
+        return 0;
+    }
+    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(); };
+        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 { 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'])
@@ -111,24 +233,26 @@ export async function main(argv = process.argv.slice(2)) {
         return run(cli, ['verify'], cfg.root);
     }
     if (command === 'dev')
-        return dev(cfg);
+        return (await import('./dev.js')).dev(cfg);
     if (command === 'migrate') {
-        await migrate(cfg, o.init);
+        await (await import('./migrate.js')).migrate(cfg);
         return 0;
     }
-    const base = await loadBaseline(cfg, { base: o.base, baseFile: o['base-file'] });
+    const { loadBaseline } = await import('./baseline.js');
+    const baseFile = o.snapshot ? (await import('./snapshots.js')).snapshotPath(cfg, o.snapshot) : o['base-file'];
+    const base = await loadBaseline(cfg, { base: o.base, baseFile });
     if (command === 'verify')
-        return verify(cfg, { base, skipTests: o['skip-tests'] });
+        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;
     }
-    if (!['analyze', 'check', 'gen', 'test', 'budget', 'impact'].includes(command))
-        throw new Error(`未知命令 ${command}，运行 cage --help 查看用法`);
+    const { analyze } = await import('./analyze.js');
     const a = await analyze(cfg, { base, write: command === 'analyze' });
     if (a.findings.length)
         console.log(formatFindings(a.findings));
@@ -139,11 +263,13 @@ export async function main(argv = process.argv.slice(2)) {
         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)
@@ -153,15 +279,22 @@ export async function main(argv = process.argv.slice(2)) {
     if (command === 'test') {
         if (o.only && !['derived', 'project'].includes(o.only))
             throw new Error('--only 只能是 derived 或 project');
-        return testProject(cfg, a.graph, o.only);
+        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 saved = o.snapshot ? (await import('./snapshots.js')).readSnapshot(cfg, o.snapshot) : undefined;
+    const comparison = {
+        base: { source: o.base ?? (o.snapshot ? `snapshot:${o.snapshot}` : baseFile), graphHash: createHash('sha256').update(JSON.stringify(base)).digest('hex'), createdAt: saved?.createdAt, frameworkVersion: saved?.frameworkVersion },
+        head: { extractedAt: new Date().toISOString(), frameworkVersion: VERSION, graphHash: createHash('sha256').update(JSON.stringify(a.graph)).digest('hex') },
+    };
     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'],
+        ? JSON.stringify({ ...result, comparison, reasons: Object.fromEntries(result.reasons) }, null, 2)
+        : `比较基线 ${comparison.base.source}（${comparison.base.graphHash.slice(0, 12)}${saved ? `，${saved.createdAt}` : ''}）→ 当前图（${comparison.head.graphHash.slice(0, 12)}，${comparison.head.extractedAt}）\n` + formatImpact(result, a.graph, {
+            base: o.base ?? (o.snapshot ? `snapshot:${o.snapshot}` : baseFile),
             format: o.format === 'md' ? 'md' : 'text',
         });
     if (o.out) {

package/dist/main.js.map

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

package/dist/migrate.d.ts

@@ -1,7 +1,16 @@
 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>;
+/** 给首次使用者可执行的步骤，只展示地址和库名，绝不输出连接串中的密码。 */
+/**
+ * 将常见连接错误翻译为不含凭据的诊断。
+ * @param error 原始连接错误。
+ * @param databaseUrl 仅提取主机、端口与库名。
+ * @returns 已知错误的新 Error 并保留 cause；未知 Error 原样返回，其他值转换为 Error。
+ */
+export declare function databaseConnectionError(error: unknown, databaseUrl: string): Error;
+/**
+ * 使用专用迁移账号应用内核和项目迁移，不隐式 init。
+ * @param cfg 领域入口与迁移目录配置。
+ * @param env 连接来源，默认当前环境。
+ * @returns 内核迁移 Promise；缺少连接或执行失败抛出，不创建数据库。
+ */
+export declare function migrate(cfg: CageConfig, env?: NodeJS.ProcessEnv): Promise<import("@yss123/cage-kernel/db").MigrateResult>;

package/dist/migrate.js

@@ -1,69 +1,47 @@
-import pg from 'pg';
-import { bootstrapSql, q, readMigrations, runMigrations } from '@yss123/cage-kernel/db';
+/**
+ * 迁移命令适配层，从环境取得迁移账号并按当前领域注册表执行结构迁移。
+ * 只连接已有数据库，读取迁移目录后交给 kernel runMigrations 校验历史并应用新迁移。
+ * 不隐式准备账号或创建数据库；常见连接错误只输出主机、端口、库名及修复方向，不泄露密码。
+ */
+// 迁移只更新已有数据库的表、视图；账号权限由 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 async function initializeDatabase(superUrl, databaseUrl, passwords) {
+/** 给首次使用者可执行的步骤，只展示地址和库名，绝不输出连接串中的密码。 */
+/**
+ * 将常见连接错误翻译为不含凭据的诊断。
+ * @param error 原始连接错误。
+ * @param databaseUrl 仅提取主机、端口与库名。
+ * @returns 已知错误的新 Error 并保留 cause；未知 Error 原样返回，其他值转换为 Error。
+ */
+export function databaseConnectionError(error, databaseUrl) {
+    const code = error?.code;
     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();
-    }
+    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, init = false, env = process.env) {
+/**
+ * 使用专用迁移账号应用内核和项目迁移，不隐式 init。
+ * @param cfg 领域入口与迁移目录配置。
+ * @param env 连接来源，默认当前环境。
+ * @returns 内核迁移 Promise；缺少连接或执行失败抛出，不创建数据库。
+ */
+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');
-    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,
-    });
+    }).catch((error) => { throw databaseConnectionError(error, urls.migrate); });
 }
 //# sourceMappingURL=migrate.js.map

package/dist/migrate.js.map

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

@@ -1,41 +1,108 @@
 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';
+/**
+ * 本体节点语义类别，区分聚合、行为、字段、协作和业务阅读规格，身份须与 id 联合使用。
+ */
+export type NodeKind = 'aggregate' | 'field' | 'state' | 'command' | 'event' | 'reaction' | 'query' | 'approval' | 'route' | 'job' | 'connector' | 'outbound' | 'inbound' | 'capability' | 'process' | 'stage';
+/**
+ * 可序列化节点，attrs 保存抽取事实，hash 表示当前可抽取内容而非运行状态。
+ */
 export interface OntNode {
+    /** 领域声明类别，和 id 一起确定节点身份。 */
     kind: NodeKind;
+    /** 领域原始标识，字段/状态通常带聚合前缀。 */
     id: string;
     /** 内容哈希：声明变化时哈希变化 */
     hash: string;
+    /** 已定位声明的项目相对源码路径；库内声明可缺失。 */
     file?: string;
+    /** 源码 1 起始行号，缺失表示尚无定位证据。 */
     line?: number;
+    /** 可序列化的声明语义属性，不是运行时实体记录。 */
     attrs: Record<string, unknown>;
 }
-export type EdgeKind = 'transition' | 'reads' | 'emits' | 'uses' | 'triggers' | 'targets' | 'queries' | 'refs' | 'calls' | 'binds' | 'field';
+/**
+ * 显式本体关系类型；读取、触发、状态迁移和阅读规格分别保留，不能混当执行先后。
+ */
+export type EdgeKind = 'transition' | 'reads' | 'emits' | 'uses' | 'triggers' | 'cancels' | 'targets' | 'queries' | 'refs' | 'calls' | 'binds' | 'field' | 'contains' | 'implements' | 'follows' | 'relates';
+/**
+ * 节点关系的存储形式，端点通常为业务 ID，规格边可补 kind 消除同名歧义。
+ */
 export interface OntEdge {
+    /** 关系种类，决定端点解释及影响传播方向。 */
     kind: EdgeKind;
+    /** 原始源节点 ID，尚未附加种类前缀。 */
     from: string;
+    /** 原始目标节点 ID。 */
     to: string;
+    /** 状态迁移对应命令等中间声明标识。 */
     via?: string;
+    /** reads/queries 等依赖在声明中的本地别名。 */
     alias?: string;
+    /** 命令声明的资源获取标签，只用于静态配对。 */
     acquires?: string;
+    /** 命令声明的资源释放标签，不会代替命令执行。 */
     releases?: string;
     /** uses 边的来源说明：约束、事件载荷、路由条件、出站映射、查询 */
     as?: string;
+    /** 字段引用关系的基数，区分外键、反查和自动中间表。 */
+    cardinality?: 'many-to-one' | 'one-to-one' | 'one-to-many' | 'many-to-many';
+    /** 一对多反向引用的目标外键字段名。 */
+    mappedBy?: string;
+    /** 新的业务规格边显式保留端点类型，避免同名事件和命令混淆。 */
+    fromKind?: NodeKind;
+    /** 目标节点显式种类，消除同名声明歧义。 */
+    toKind?: NodeKind;
+    /** 流程阶段连线的人工作用、自动执行或等待语义。 */
+    mode?: 'manual' | 'automatic' | 'wait';
+    /** 显式业务连线标题，未声明时由解释层生成。 */
+    label?: string;
+    /** 次要分支标记，影响阅读和布局，不改变执行权限。 */
+    branch?: boolean;
 }
+/**
+ * 版本化本体文件形状，是分析与生成共享的静态快照，不含业务数据库记录。
+ */
 export interface Ontology {
+    /** 当前本体 JSON 结构版本，固定为 1。 */
     version: 1;
+    /** 抽取的语义节点，包含依赖声明与字段等细分事实。 */
     nodes: OntNode[];
+    /** 节点之间可抽取的显式依赖与流程关系。 */
     edges: OntEdge[];
+    /** 静态扫描发现的 unsafe 使用数，用于预算与影响提示。 */
     unsafeCount: number;
 }
+/**
+ * 从已构建注册表和源码位置生成本体节点与关系。
+ * @param reg 已校验注册表。
+ * @param sites 顶层声明位置及调用文本，依赖包可以没有位置。
+ * @param unsafeCount 静态扫描的逃生口数量，默认零。
+ * @returns version=1 本体；函数只读声明，不执行命令、查询或连接器。
+ */
 export declare function extract(reg: Registry, sites?: DeclSite[], unsafeCount?: number): Ontology;
+/**
+ * 按 kind+id 比较后的新增、删除和内容哈希变化，边变化通过相关节点属性体现。
+ */
 export interface NodeDiff {
+    /** 当前图新出现的节点。 */
     added: OntNode[];
+    /** 基线有而当前没有的节点。 */
     removed: OntNode[];
+    /** 同一身份内容哈希变化的前后节点对。 */
     changed: {
         before: OntNode;
         after: OntNode;
     }[];
 }
+/**
+ * 比较两份本体节点稳定身份与内容哈希。
+ * @param base 修改前图。
+ * @param head 当前图。
+ * @returns 新增、删除和 before/after 变化对，不修改输入，不单独比较边数组。
+ */
 export declare function diffOntology(base: Ontology, head: Ontology): NodeDiff;
+/**
+ * 按原始 ID 建立节点 Map；同名 ID 会由后出现节点覆盖，调用方须确认身份无歧义，公开查询使用完整 key。
+ */
 export declare const nodeById: (g: Ontology) => Map<string, OntNode>;