@yss123/cage-cli 0.0.0-stage → 0.2.0

package/dist/impact.js

@@ -0,0 +1,235 @@
+// 影响分析：在基线和当前各生成一张图，找出变化的节点，再沿着边向外扩散。
+// handler 文件的改动会被映射到它所属的命令节点，所以只改实现、不改声明也能算出影响。
+import { execFileSync } from 'node:child_process';
+import { existsSync, 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 selectRelatedTests(subjects, tests, projectTestFiles) {
+    const derived = tests.filter((t) => subjects.has(t.subject) || subjects.has(t.subject.split('.')[0]));
+    const names = [...subjects].map((id) => id.split('.').pop());
+    const project = projectTestFiles.filter((file) => {
+        // Git 候选可能包括本次删除的测试；不存在的用例不能再作为可执行候选。
+        if (!existsSync(file))
+            return false;
+        const text = readFileSync(file, 'utf8');
+        return names.some((name) => name.length > 2 && text.includes(name));
+    });
+    return { derived, project };
+}
+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 === 'refs' && e.to === n) {
+                next = e.from;
+                why = `关联目标 ${n}`;
+            }
+            else if (e.kind === 'field' && e.to === n) {
+                next = e.from;
+                why = `包含字段 ${n}`;
+            }
+            else if (e.kind === 'emits' && e.from === n) {
+                next = e.to;
+                why = `由 ${n} 发出`;
+            }
+            else if ((e.kind === 'triggers' || e.kind === 'cancels') && e.from === n) {
+                next = e.to;
+                why = e.kind === 'cancels' ? `由 ${n} 取消审批` : `订阅 ${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 selectedTests = selectRelatedTests(affected, tests, projectTestFiles);
+    // 需要人工确认的点
+    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: selectedTests.derived,
+        projectTests: selectedTests.project,
+        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,20 @@
+export * from './analyze.js';
+export * from './context.js';
+export * from './graph-query.js';
+export * from './graph-search.js';
+export * from './graph-presentation.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 './init.js';
+export * from './verify.js';
+export { serveGraph, collectGraph } from './graph.js';
+export { main } from './main.js';

package/dist/index.js

@@ -0,0 +1,22 @@
+// 对外公开可组合的工具链；bin/cage.js 是这些函数的命令行封装。
+export * from './analyze.js';
+export * from './context.js';
+export * from './graph-query.js';
+export * from './graph-search.js';
+export * from './graph-presentation.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 './init.js';
+export * from './verify.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,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,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,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,6 @@
+import { type CageConfig } from './config.js';
+export interface InitResult {
+    status: 'created' | 'reused';
+    envFile: string;
+}
+export declare function initProject(cfg: CageConfig, env?: NodeJS.ProcessEnv): Promise<InitResult>;

package/dist/init.js

@@ -0,0 +1,131 @@
+// 首次接入已有 PostgreSQL：管理员只提供一次连接，框架负责账号、授权和本地凭证。
+// 建库、容器生命周期和业务表迁移仍由各自流程负责，启动应用不会隐式调用本模块。
+import { randomBytes } from 'node:crypto';
+import { existsSync, readFileSync, renameSync, unlinkSync, writeFileSync } from 'node:fs';
+import { parseEnv } from 'node:util';
+import pg from 'pg';
+import { bootstrapSql } from '@yss123/cage-kernel/db';
+import { abs } from './config.js';
+import { databaseConnectionError } from './migrate.js';
+const accounts = { APP: 'cage_app', READ: 'cage_read', MIGRATE: 'cage_migrate' };
+const configured = (value) => !!value && !value.includes('REPLACE_WITH_');
+/** 校验保存的账号能真正登录；重复 init 不以“文件存在”代替初始化成功。 */
+async function verifyConnections(urls) {
+    const target = new URL(urls.APP);
+    for (const key of Object.keys(accounts)) {
+        const url = new URL(urls[key]);
+        if (url.username !== accounts[key] || url.host !== target.host || url.pathname !== target.pathname) {
+            throw new Error('[CAGE-INIT-003] APP / READ / MIGRATE 需使用各自的 cage 账号，指向同一个数据库；请检查 .env');
+        }
+        const client = new pg.Client({ connectionString: urls[key], connectionTimeoutMillis: 5000 });
+        try {
+            await client.connect();
+        }
+        catch (error) {
+            throw databaseConnectionError(error, urls[key]);
+        }
+        finally {
+            await client.end();
+        }
+    }
+}
+/** 只更新框架生成的条目，保留业务自定义项和原注释；管理员密码不留在成功后的文件里。 */
+function completedEnv(source, urls) {
+    let content = source.replace(/^[ \t]*(?:export\s+)?CAGE_ADMIN_DATABASE_URL\s*=.*(?:\r?\n|$)/gm, '# CAGE_ADMIN_DATABASE_URL=\n');
+    const put = (key, value, comment) => {
+        const line = `${key}=${JSON.stringify(value)}`;
+        const pattern = new RegExp(`^(?:# ?)?${key}\\s*=.*$`, 'gm');
+        if (pattern.test(content))
+            content = content.replace(pattern, line);
+        else
+            content = `${content.trimEnd()}\n\n# ${comment}\n${line}\n`;
+    };
+    for (const key of Object.keys(accounts)) {
+        put(`CAGE_${key}_DATABASE_URL`, urls[key], {
+            APP: '业务写入连接：API 和 worker 使用，与其他连接指向同一个数据库。',
+            READ: '安全查询连接：只能通过安全视图读取，与写入账号隔离。',
+            MIGRATE: '表结构迁移连接：仅 pnpm migrate 使用，运行应用时不需要此账号。',
+        }[key]);
+    }
+    if (!configured(parseEnv(content).CAGE_COOKIE_SECRET)) {
+        put('CAGE_COOKIE_SECRET', randomBytes(32).toString('hex'), '会话 Cookie 签名密钥，由 cage init 生成；同一应用实例间保持一致。');
+    }
+    return content.trimEnd() + '\n';
+}
+export async function initProject(cfg, env = process.env) {
+    const envFile = abs(cfg, '.env');
+    const source = existsSync(envFile) ? readFileSync(envFile, 'utf8')
+        : existsSync(abs(cfg, '.env.example')) ? readFileSync(abs(cfg, '.env.example'), 'utf8') : '';
+    const values = { ...parseEnv(source), ...env };
+    const saved = Object.fromEntries(Object.keys(accounts)
+        .map((key) => [key, values[`CAGE_${key}_DATABASE_URL`]]));
+    const hasSaved = Object.values(saved).every(configured);
+    const adminUrl = values.CAGE_ADMIN_DATABASE_URL;
+    // 成功后已移除管理员连接，日常重复执行只验证已有账号，不再索取管理员密码。
+    if (!configured(adminUrl)) {
+        if (!hasSaved)
+            throw new Error('[CAGE-ENV-001] 首次初始化请在项目 .env 填写 CAGE_ADMIN_DATABASE_URL，连接已有数据库后运行 pnpm exec cage init');
+        await verifyConnections(saved);
+        return { status: 'reused', envFile };
+    }
+    const target = new URL(adminUrl);
+    if (!target.pathname || target.pathname === '/') {
+        throw new Error('[CAGE-INIT-001] 管理员连接必须指定已经存在的数据库名，例如 postgresql://postgres:密码@localhost:5432/business_db');
+    }
+    const admin = new pg.Client({ connectionString: adminUrl, connectionTimeoutMillis: 5000, application_name: 'cage-init' });
+    let staged;
+    let committed = false;
+    try {
+        await admin.connect();
+        await admin.query('begin');
+        // 同一数据库的首次初始化串行，避免两个终端同时创建角色。
+        await admin.query('select pg_advisory_xact_lock(727275)');
+        const existing = await admin.query("select rolname from pg_roles where rolname in ('cage_app', 'cage_read', 'cage_migrate', 'cage_view_owner')");
+        const reuse = existing.rowCount !== 0;
+        if (reuse) {
+            if (existing.rowCount !== 4 || !hasSaved) {
+                throw new Error('[CAGE-INIT-002] PostgreSQL 集群已有 Cage 账号；请在 .env 提供已有的 APP / READ / MIGRATE 连接后重试。初始化不会重置这些账号的密码');
+            }
+            if (new URL(saved.APP).host !== target.host || new URL(saved.APP).pathname !== target.pathname) {
+                throw new Error('[CAGE-INIT-003] 已有账号连接与管理员连接必须指向同一个数据库；请检查 .env');
+            }
+            await verifyConnections(saved);
+        }
+        const passwords = { app: randomBytes(24).toString('hex'), read: randomBytes(24).toString('hex'), migrate: randomBytes(24).toString('hex') };
+        const urls = reuse ? saved : Object.fromEntries(Object.keys(accounts).map((key) => {
+            const url = new URL(adminUrl);
+            url.username = accounts[key];
+            url.password = passwords[key.toLowerCase()];
+            return [key, url.toString()];
+        }));
+        // 先把凭证完整写到同目录临时文件，确认本地可写，再修改数据库权限。
+        // 数据库失败时删除草稿并回滚；提交后若替换失败，保留草稿供恢复，避免丢失随机密码。
+        const draft = `${envFile}.cage-init-${randomBytes(6).toString('hex')}.tmp`;
+        writeFileSync(draft, completedEnv(source, urls), { mode: 0o600, flag: 'wx' });
+        staged = draft;
+        const { rows: [database] } = await admin.query('select current_database() as name');
+        // bootstrapSql 对空密码不发 ALTER ROLE；复用账号时仅补目标库授权，绝不轮换密码。
+        await admin.query(bootstrapSql(reuse ? { app: '', read: '', migrate: '' } : passwords, database.name));
+        await admin.query('commit');
+        committed = true;
+        try {
+            renameSync(staged, envFile);
+        }
+        catch {
+            throw new Error(`[CAGE-INIT-004] 账号权限已准备，但无法替换 .env；凭证保存在 ${staged}，请将它恢复为项目 .env 后继续`);
+        }
+        staged = undefined;
+        return { status: reuse ? 'reused' : 'created', envFile };
+    }
+    catch (error) {
+        if (!committed)
+            await admin.query('rollback').catch(() => { });
+        throw databaseConnectionError(error, adminUrl);
+    }
+    finally {
+        await admin.end();
+        if (staged && !committed)
+            unlinkSync(staged);
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

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>;