@yss123/cage-cli 0.0.0-stage → 0.1.0

package/dist/derive.js

@@ -0,0 +1,163 @@
+// 派生测试生成器：遍历本体图，按固定模板为每个能力点、每个范围组合子、每条非法迁移生成测试。
+// 生成到 generated/tests，不入库，每次运行前重新生成。
+import { existsSync, mkdirSync, readdirSync, writeFileSync, unlinkSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { abs } from './config.js';
+const q = (s) => JSON.stringify(s);
+function header(domainImport) {
+    return [
+        '// 生成物：派生测试（cage test 每次运行前重新生成，不要手改）',
+        `import { afterAll, beforeAll, expect, it } from 'vitest';`,
+        `import { derived } from '@yss123/cage-testkit';`,
+        `import * as domain from ${q(domainImport)};`,
+        '',
+        'const t = derived(domain);',
+        'beforeAll(() => t.setup());',
+        'afterAll(() => t.teardown());',
+        '',
+    ];
+}
+const commands = (g) => g.nodes.filter((n) => n.kind === 'command');
+const userInvokable = (c) => c.attrs.invokedBy.includes('user');
+const aggOf = (c) => c.id.split('.')[0];
+export function deriveTests(cfg, g) {
+    const dir = abs(cfg, join(cfg.generated, 'tests'));
+    const domainImport = relative(dir, abs(cfg, cfg.domain))
+        .replace(/\\/g, '/')
+        .replace(/\.tsx?$/, '');
+    const imp = domainImport.startsWith('.') ? domainImport : `./${domainImport}`;
+    const files = {};
+    const tests = [];
+    const add = (file, name, subject, body) => {
+        files[file] ??= header(imp).join('\n');
+        files[file] += `\nit(${q(name)}, async (ctx) => {\n${body.map((l) => `  ${l}`).join('\n')}\n});\n`;
+        tests.push({ file, name, subject });
+    };
+    // 能力：每个能力点，缺少它的用户调用，断言 FORBIDDEN
+    for (const c of commands(g).filter(userInvokable)) {
+        add('capability.test.ts', `${c.id}：没有能力点时被拒绝`, c.id, [
+            `const r = await t.capabilityDenied(${q(c.id)});`,
+            `if (r === 'skip') return ctx.skip();`,
+            `expect(r.code).toBe('FORBIDDEN');`,
+        ]);
+    }
+    // 状态：每个命令、每个不在 from 中的状态，断言 INVALID_TRANSITION
+    for (const c of commands(g)) {
+        if (c.attrs.from === 'new')
+            continue;
+        const from = c.attrs.from;
+        const states = g.nodes
+            .filter((n) => n.kind === 'state' && n.id.startsWith(`${aggOf(c)}.`))
+            .map((n) => n.id.slice(aggOf(c).length + 1));
+        for (const s of states.filter((x) => !from.includes(x))) {
+            add('state.test.ts', `${c.id}：在 ${s} 状态下被拒绝`, c.id, [
+                `const r = await t.invalidTransition(${q(c.id)}, ${q(s)});`,
+                `if (r === 'skip') return ctx.skip();`,
+                `expect(r.code).toBe('INVALID_TRANSITION');`,
+            ]);
+        }
+    }
+    // 范围：每个聚合、每个范围组合子，范围外的数据读、列表、安全视图都拿不到，基表碰不到
+    for (const a of g.nodes.filter((n) => n.kind === 'aggregate')) {
+        const sc = a.attrs.scope;
+        for (const comb of ['self', 'dept']) {
+            if (comb === 'self' && !sc.owner)
+                continue;
+            if (comb === 'dept' && (!sc.dept || sc.dept === 'id'))
+                continue;
+            add('scope.test.ts', `${a.id}：范围 ${comb} 之外的数据读不到`, a.id, [
+                `const r = await t.scopeHidden(${q(a.id)}, ${q(comb)});`,
+                `if (r === 'skip') return ctx.skip();`,
+                `expect(r.get).toBe('NOT_FOUND');`,
+                `expect(r.listed).toBe(false);`,
+                `expect(r.rawVisible).toBe(false);`,
+                `expect(r.baseDenied).toBe(true);`,
+            ]);
+        }
+        if (sc.owner) {
+            for (const c of commands(g).filter((x) => aggOf(x) === a.id && userInvokable(x) && x.attrs.from !== 'new')) {
+                add('scope.test.ts', `${c.id}：写范围外的数据返回 NOT_FOUND`, c.id, [
+                    `const r = await t.outOfScopeWrite(${q(c.id)});`,
+                    `if (r === 'skip') return ctx.skip();`,
+                    `expect(r.code).toBe('NOT_FOUND');`,
+                ]);
+            }
+        }
+    }
+    // 审计：每个命令的成功路径都产生且仅产生一条审计
+    for (const c of commands(g)) {
+        add('audit.test.ts', `${c.id}：成功时写且只写一条审计`, c.id, [
+            `const r = await t.auditOnce(${q(c.id)});`,
+            `if (r === 'skip') return ctx.skip();`,
+            `expect(r.rows).toBe(1);`,
+        ]);
+    }
+    // 幂等：每个聚合挑一个非新建的用户命令
+    for (const a of g.nodes.filter((n) => n.kind === 'aggregate')) {
+        const c = commands(g).find((x) => aggOf(x) === a.id && userInvokable(x) && x.attrs.from !== 'new') ??
+            commands(g).find((x) => aggOf(x) === a.id && userInvokable(x));
+        if (!c)
+            continue;
+        add('idempotency.test.ts', `${c.id}：同一幂等键重复提交只执行一次`, c.id, [
+            `const r = await t.idempotent(${q(c.id)});`,
+            `if (r === 'skip') return ctx.skip();`,
+            `expect(r.same).toBe(true);`,
+            `expect(r.rows).toBe(1);`,
+        ]);
+    }
+    // 脱敏：没有 unmask 能力时读到的是掩码值
+    for (const a of g.nodes.filter((n) => n.kind === 'aggregate')) {
+        const sens = g.nodes.filter((n) => n.kind === 'field' && n.id.startsWith(`${a.id}.`) && n.attrs.sensitive && !n.attrs.hidden);
+        if (sens.length === 0)
+            continue;
+        add('mask.test.ts', `${a.id}：敏感字段默认掩码`, a.id, [
+            `const r = await t.masked(${q(a.id)});`,
+            `if (r === 'skip') return ctx.skip();`,
+            `for (const f of r) expect(f.seen, f.field).not.toBe(f.plain);`,
+        ]);
+    }
+    // 不变量：随机命令序列，断言每步之后不变量成立
+    for (const a of g.nodes.filter((n) => n.kind === 'aggregate' && (n.attrs.invariants ?? []).length > 0)) {
+        add('invariant.test.ts', `${a.id}：随机命令序列之后不变量始终成立`, a.id, [
+            `const r = await t.invariantsHold(${q(a.id)});`,
+            `if (r === 'skip') return ctx.skip();`,
+            `expect(r.violations).toEqual([]);`,
+        ]);
+    }
+    return { files, tests };
+}
+export function writeDerived(cfg, files) {
+    const dir = abs(cfg, join(cfg.generated, 'tests'));
+    // 只清理本生成器拥有的测试文件，不递归删除配置指向的整个目录。
+    if (existsSync(dir))
+        for (const name of readdirSync(dir)) {
+            if (/^(capability|state|scope|audit|idempotency|mask|invariant)\.test\.ts$/.test(name))
+                unlinkSync(join(dir, name));
+        }
+    mkdirSync(dir, { recursive: true });
+    for (const [name, content] of Object.entries(files))
+        writeFileSync(join(dir, name), content);
+    return dir;
+}
+export function vitestConfig(cfg, only) {
+    const include = only === 'derived'
+        ? [`${cfg.generated}/tests/**/*.test.ts`]
+        : only === 'project'
+            ? ['packages/**/src/**/*.test.ts', 'apps/api/**/*.test.ts']
+            : [`${cfg.generated}/tests/**/*.test.ts`, 'packages/**/src/**/*.test.ts', 'apps/api/**/*.test.ts'];
+    return `// 生成物：cage test 的 Vitest 配置
+import { defineConfig } from 'vitest/config';
+export default defineConfig({
+  test: {
+    root: ${q(cfg.root.replace(/\\/g, '/'))},
+    include: ${JSON.stringify(include)},
+    exclude: ['**/node_modules/**', '**/dist/**'],
+    globalSetup: ['@yss123/cage-testkit/global-setup'],
+    testTimeout: 60000,
+    hookTimeout: 180000,
+    fileParallelism: true,
+  },
+});
+`;
+}
+//# sourceMappingURL=derive.js.map

package/dist/derive.js.map

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

package/dist/dev.d.ts

@@ -0,0 +1,2 @@
+import { type CageConfig } from './config.js';
+export declare function dev(cfg: CageConfig): Promise<number>;

package/dist/dev.js

@@ -0,0 +1,155 @@
+// 本地开发的进程编排：持久化 Postgres → 生成/迁移 → API、worker、Vite。
+// 配置连接串时使用指定 PostgreSQL；没有连接串时才启动 .cage/postgres 中的内嵌实例。
+import { watch, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { randomBytes } from 'node:crypto';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { execFile } from 'node:child_process';
+import { startEmbeddedPostgres, withDb } from '@yss123/cage-testkit/pg';
+import { abs } from './config.js';
+import { initializeDatabase } from './migrate.js';
+import { binPath, launch, run } from './process.js';
+export async function dev(cfg) {
+    const cli = fileURLToPath(new URL('../bin/cage.js', import.meta.url));
+    const env = {
+        ...process.env,
+        NODE_ENV: 'development',
+        CAGE_STAGE: process.env.CAGE_STAGE ?? 'fake',
+    };
+    // 项目包的 development 导出指向源码，tsx watch 才能观察到 domain 的修改。
+    env.NODE_OPTIONS = `${env.NODE_OPTIONS ?? ''} --conditions=development`.trim();
+    let database;
+    const children = [];
+    const watchers = [];
+    let finish;
+    let stopping = false;
+    const done = new Promise((resolve) => {
+        finish = resolve;
+    });
+    // 所有退出路径共用一次清理，避免子进程退出事件与 Ctrl+C 同时关闭数据库。
+    const stop = async (code) => {
+        if (stopping)
+            return;
+        stopping = true;
+        for (const watcher of watchers)
+            watcher.close();
+        for (const child of children) {
+            // Windows 没有 POSIX 进程组；tsx watch 有子进程，需要按本次启动的 PID 清理整棵树。
+            if (process.platform === 'win32' && child.pid && child.exitCode === null) {
+                await new Promise((resolve) => execFile('taskkill', ['/PID', String(child.pid), '/T', '/F'], { windowsHide: true }, () => resolve()));
+            }
+            else
+                child.kill();
+        }
+        await Promise.all(children.map((child) => child.exitCode !== null || child.signalCode !== null
+            ? Promise.resolve()
+            : new Promise((resolve) => child.once('exit', () => resolve()))));
+        await database?.stop();
+        finish(code);
+    };
+    const onSignal = () => {
+        void stop(0);
+    };
+    process.once('SIGINT', onSignal);
+    process.once('SIGTERM', onSignal);
+    try {
+        if (!env.CAGE_APP_DATABASE_URL && !env.DATABASE_URL) {
+            mkdirSync(abs(cfg, '.cage'), { recursive: true });
+            const credentials = abs(cfg, '.cage/dev-credentials.json');
+            const fresh = !existsSync(credentials);
+            const pw = fresh
+                ? {
+                    app: randomBytes(24).toString('hex'),
+                    read: randomBytes(24).toString('hex'),
+                    migrate: randomBytes(24).toString('hex'),
+                }
+                : JSON.parse(readFileSync(credentials, 'utf8'));
+            database = await startEmbeddedPostgres({
+                dir: abs(cfg, '.cage/postgres'),
+                port: cfg.devDbPort,
+                persistent: true,
+            });
+            const databaseName = 'cage_dev';
+            env.CAGE_APP_DATABASE_URL = withDb(database.superUrl, databaseName, {
+                name: 'cage_app',
+                password: pw.app,
+            });
+            env.CAGE_READ_DATABASE_URL = withDb(database.superUrl, databaseName, {
+                name: 'cage_read',
+                password: pw.read,
+            });
+            env.CAGE_MIGRATE_DATABASE_URL = withDb(database.superUrl, databaseName, {
+                name: 'cage_migrate',
+                password: pw.migrate,
+            });
+            if (fresh) {
+                await initializeDatabase(database.superUrl, env.CAGE_MIGRATE_DATABASE_URL, pw);
+                writeFileSync(credentials, JSON.stringify(pw), { mode: 0o600 });
+            }
+        }
+        // 抽取器用独立进程，声明改动不会被 Node 的模块缓存吞掉。
+        if (await run(cli, ['gen'], cfg.root, env))
+            throw new Error('声明生成失败');
+        if (await run(cli, ['migrate'], cfg.root, env))
+            throw new Error('数据库迁移失败');
+        const target = new URL(env.CAGE_APP_DATABASE_URL ?? env.DATABASE_URL);
+        console.log(`数据库 ${target.hostname}:${target.port || '5432'}${target.pathname}（${database ? '内嵌实例' : '外部 PostgreSQL'}）`);
+        // 初始化和迁移完成后，API/worker 只需要业务及只读连接。
+        // 超级用户、迁移和测试连接留在编排进程，不传给运行时子进程。
+        const runtimeEnv = { ...env };
+        for (const key of [
+            'CAGE_SUPER_DATABASE_URL',
+            'CAGE_MIGRATE_DATABASE_URL',
+            'CAGE_MIGRATE_PASSWORD',
+            'CAGE_TEST_DATABASE_URL',
+            'CAGE_TEST_SUPER_URL',
+            'POSTGRES_PASSWORD',
+            'CAGE_TEST_POSTGRES_PASSWORD',
+        ])
+            delete runtimeEnv[key];
+        const start = (file, args, cwd = cfg.root) => {
+            const child = launch(file, args, cwd, runtimeEnv);
+            children.push(child);
+            child.once('error', (error) => {
+                console.error(error.message);
+                void stop(1);
+            });
+            child.once('exit', (code) => {
+                if (!stopping)
+                    void stop(code ?? 1);
+            });
+            return child;
+        };
+        // tsx watch 负责 API/worker 热重启；domain 的生成任务串行，避免迁移竞争。
+        start(binPath('tsx'), ['watch', abs(cfg, cfg.apiEntry)]);
+        start(binPath('tsx'), ['watch', abs(cfg, cfg.workerEntry)]);
+        const req = createRequire(abs(cfg, `${cfg.web}/package.json`));
+        const vite = join(dirname(req.resolve('vite/package.json')), 'bin/vite.js');
+        start(vite, ['--host', '127.0.0.1'], abs(cfg, cfg.web));
+        let pending = Promise.resolve();
+        let timer;
+        watchers.push(watch(dirname(abs(cfg, cfg.domain)), { recursive: true }, (_event, name) => {
+            if (!name || !/\.tsx?$/.test(String(name)) || /\.(test|spec)\.tsx?$/.test(String(name)))
+                return;
+            clearTimeout(timer);
+            timer = setTimeout(() => {
+                pending = pending.then(async () => {
+                    if (stopping)
+                        return;
+                    if ((await run(cli, ['gen'], cfg.root, env)) === 0)
+                        await run(cli, ['migrate'], cfg.root, env);
+                });
+            }, 250);
+        }));
+        const apiPort = env.PORT ?? '3000';
+        console.log(`API http://localhost:${apiPort} · 管理 http://localhost:${apiPort}/admin · Web http://localhost:${env.CAGE_WEB_PORT ?? '5173'}`);
+        return await done;
+    }
+    finally {
+        await stop(0);
+        process.removeListener('SIGINT', onSignal);
+        process.removeListener('SIGTERM', onSignal);
+    }
+}
+//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,yDAAyD;AACzD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAqB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAmB,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAAE,GAAG,EAAmB,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,GAAe;IACvC,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,MAAM,GAAG,GAAsB;QAC7B,GAAG,OAAO,CAAC,GAAG;QACd,QAAQ,EAAE,aAAa;QACvB,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,MAAM;KAC7C,CAAC;IACF,sDAAsD;IACtD,GAAG,CAAC,YAAY,GAAG,GAAG,GAAG,CAAC,YAAY,IAAI,EAAE,2BAA2B,CAAC,IAAI,EAAE,CAAC;IAC/E,IAAI,QAAgC,CAAC;IACrC,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,MAAM,QAAQ,GAA+B,EAAE,CAAC;IAChD,IAAI,MAA+B,CAAC;IACpC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,IAAI,GAAG,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QAC3C,MAAM,GAAG,OAAO,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,0CAA0C;IAC1C,MAAM,IAAI,GAAG,KAAK,EAAE,IAAY,EAAE,EAAE;QAClC,IAAI,QAAQ;YAAE,OAAO;QACrB,QAAQ,GAAG,IAAI,CAAC;QAChB,KAAK,MAAM,OAAO,IAAI,QAAQ;YAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAChD,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,0DAA0D;YAC1D,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACzE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAClC,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CACxF,OAAO,EAAE,CACV,CACF,CAAC;YACJ,CAAC;;gBAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CACf,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACrB,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI;YAClD,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE;YACnB,CAAC,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CACxE,CACF,CAAC;QACF,MAAM,QAAQ,EAAE,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;IACf,CAAC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YACpD,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,EAAE,4BAA4B,CAAC,CAAC;YAC3D,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;YACvC,MAAM,EAAE,GAAG,KAAK;gBACd,CAAC,CAAC;oBACE,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;oBACpC,IAAI,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;oBACrC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;iBACzC;gBACH,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;YAClD,QAAQ,GAAG,MAAM,qBAAqB,CAAC;gBACrC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC;gBAC/B,IAAI,EAAE,GAAG,CAAC,SAAS;gBACnB,UAAU,EAAE,IAAI;aACjB,CAAC,CAAC;YACH,MAAM,YAAY,GAAG,UAAU,CAAC;YAChC,GAAG,CAAC,qBAAqB,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE;gBAClE,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,EAAE,CAAC,GAAG;aACjB,CAAC,CAAC;YACH,GAAG,CAAC,sBAAsB,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE;gBACnE,IAAI,EAAE,WAAW;gBACjB,QAAQ,EAAE,EAAE,CAAC,IAAI;aAClB,CAAC,CAAC;YACH,GAAG,CAAC,yBAAyB,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE;gBACtE,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,EAAE,CAAC,OAAO;aACrB,CAAC,CAAC;YACH,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;gBAC/E,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QACD,iCAAiC;QACjC,IAAI,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtE,IAAI,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;QAC3E,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,qBAAqB,IAAI,GAAG,CAAC,YAAa,CAAC,CAAC;QACvE,OAAO,CAAC,GAAG,CACT,OAAO,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,GAAG,MAAM,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,GAAG,CAC5G,CAAC;QACF,mCAAmC;QACnC,gCAAgC;QAChC,MAAM,UAAU,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI;YAChB,yBAAyB;YACzB,2BAA2B;YAC3B,uBAAuB;YACvB,wBAAwB;YACxB,qBAAqB;YACrB,mBAAmB;YACnB,6BAA6B;SAC9B;YACC,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,IAAc,EAAE,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,EAAE;YAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;YAClD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC5B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC7B,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;YACf,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBAC1B,IAAI,CAAC,QAAQ;oBAAE,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;QACF,qDAAqD;QACrD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACxD,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAChC,IAAI,KAAoC,CAAC;QACzC,QAAQ,CAAC,IAAI,CACX,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;YACzE,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAAE,OAAO;YAChG,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;oBAChC,IAAI,QAAQ;wBAAE,OAAO;oBACrB,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC;wBAAE,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBACjG,CAAC,CAAC,CAAC;YACL,CAAC,EAAE,GAAG,CAAC,CAAC;QACV,CAAC,CAAC,CACH,CAAC;QACF,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,IAAI,MAAM,CAAC;QACnC,OAAO,CAAC,GAAG,CACT,wBAAwB,OAAO,0BAA0B,OAAO,iCAAiC,GAAG,CAAC,aAAa,IAAI,MAAM,EAAE,CAC/H,CAAC;QACF,OAAO,MAAM,IAAI,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;QACd,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC3C,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1 @@
+export declare function loadProjectEnv(root: string, env?: NodeJS.ProcessEnv): void;

package/dist/env.js

@@ -0,0 +1,15 @@
+// CLI 从项目根目录读取本地连接配置。显式传入的环境变量优先，CI/部署可以覆盖本地值。
+// 使用 Node 自带的 dotenv 解析器，不展开 shell 表达式，也不打印文件中的凭证。
+import { existsSync, readFileSync } from 'node:fs';
+import { parseEnv } from 'node:util';
+import { join } from 'node:path';
+export function loadProjectEnv(root, env = process.env) {
+    const file = join(root, '.env');
+    if (!existsSync(file))
+        return;
+    for (const [name, value] of Object.entries(parseEnv(readFileSync(file, 'utf8')))) {
+        if (env[name] === undefined)
+            env[name] = value;
+    }
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,mDAAmD;AACnD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,MAAyB,OAAO,CAAC,GAAG;IAC/E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO;IAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/findings.d.ts

@@ -0,0 +1,11 @@
+export interface Finding {
+    code: string;
+    /** 文件:行 */
+    at?: string;
+    reason: string;
+    fix?: string;
+    severity?: 'error' | 'warning';
+}
+export declare function formatFinding(f: Finding): string;
+export declare function formatFindings(list: Finding[]): string;
+export declare const errorsOnly: (list: Finding[]) => Finding[];

package/dist/findings.js

@@ -0,0 +1,13 @@
+// 门禁报错：每条都有错误码、位置、原因、修复方法，末尾附错误码册路径，agent 可以直接打开。
+export function formatFinding(f) {
+    const lines = [`  [${f.code}] ${f.at ?? ''}`.trimEnd(), `  原因：${f.reason}`];
+    if (f.fix)
+        lines.push(`  修复：${f.fix}`);
+    lines.push(`  详见：docs/errors/${f.code}.md`);
+    return lines.join('\n');
+}
+export function formatFindings(list) {
+    return list.map(formatFinding).join('\n\n');
+}
+export const errorsOnly = (list) => list.filter((f) => f.severity !== 'warning');
+//# sourceMappingURL=findings.js.map

package/dist/findings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.js","sourceRoot":"","sources":["../src/findings.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAWlD,MAAM,UAAU,aAAa,CAAC,CAAU;IACtC,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5E,IAAI,CAAC,CAAC,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAe;IAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAe,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC"}

package/dist/gen/contracts.d.ts

@@ -0,0 +1,6 @@
+import { type AnyAggregate, type Registry } from '@yss123/cage-kernel';
+import type { DeclSite } from '../static-check.js';
+export declare function aggregateFile(reg: Registry, a: AnyAggregate, sites: DeclSite[]): string;
+export declare function queriesFile(reg: Registry): string;
+export declare function indexFile(reg: Registry): string;
+export declare function contractsFiles(reg: Registry, sites: DeclSite[]): Record<string, string>;

package/dist/gen/contracts.js

@@ -0,0 +1,167 @@
+// 前端契约（packages/contracts）：每个聚合一个文件——字段 schema、错误码类型、调用方法和查询 hooks。
+// 前端只能从这里引入，所以调用方式、参数、错误码都有类型检查。
+import { kebab, lowerFirst, upperFirst, } from '@yss123/cage-kernel';
+import { z } from 'zod';
+import { snapshotCode, zodCodeOf } from './zod-code.js';
+const HEADER = '// 生成物：由 cage gen 从 domain 声明生成，不要手改。\n/* eslint-disable */\n';
+function commandUrlExpr(c) {
+    const base = `/api/${kebab(c.cmd.agg.name)}`;
+    return c.cmd.from === 'new'
+        ? `'${base}/${kebab(c.name)}'`
+        : `\`${base}/\${encodeURIComponent(id)}/${kebab(c.name)}\``;
+}
+function errorUnion(c) {
+    const codes = new Set(['FORBIDDEN', 'INVALID_INPUT', 'DOMAIN_ERROR', 'CONFLICT']);
+    if (c.cmd.from !== 'new')
+        ['NOT_FOUND', 'INVALID_TRANSITION'].forEach((x) => codes.add(x));
+    if (c.cmd.constraints.length || c.cmd.from === 'new')
+        codes.add('CONSTRAINT_VIOLATED');
+    if (Object.keys(c.cmd.agg.invariants).length)
+        codes.add('INVARIANT_VIOLATED');
+    return [...codes].sort();
+}
+function isIdOnly(c) {
+    const s = c.cmd.input;
+    return s instanceof z.ZodObject && Object.keys(s.shape).length === 1 && 'id' in s.shape;
+}
+export function aggregateFile(reg, a, sites) {
+    const N = a.name;
+    const m = lowerFirst(N);
+    const cmds = reg.commands.filter((c) => c.cmd.agg === a && c.cmd.invokedBy.includes('user'));
+    const out = [HEADER];
+    out.push(`import { z } from 'zod';`);
+    out.push(`import { client, useCageList, useCageQuery } from '@yss123/cage-client';`);
+    out.push('');
+    out.push(`/** ${a.description ?? N}：读侧快照（敏感字段是按权限掩码后的值） */`);
+    out.push(`export const ${N}Schema = ${snapshotCode(a.fields, a.states.values)};`);
+    out.push(`export type ${N} = z.infer<typeof ${N}Schema>;`);
+    out.push(`export type ${N}Status = ${N}['status'];`);
+    out.push(`export const ${N}States = [${a.states.values.map((s) => `'${s}'`).join(', ')}] as const;`);
+    out.push('');
+    out.push(`/** 命令输入：和后端命令的输入校验完全一致 */`);
+    out.push(`export const ${N}Inputs = {`);
+    for (const c of cmds)
+        out.push(`  ${c.name}: ${zodCodeOf(c.cmd.input)},`);
+    out.push('};');
+    out.push('');
+    for (const c of cmds) {
+        const site = sites.find((s) => s.exportName === c.exportName);
+        out.push(`/** ${c.capability} 可能返回的错误码${site?.domainCodes.length ? `；业务码（domainCode）：${site.domainCodes.join('、')}` : ''} */`);
+        out.push(`export type ${N}${upperFirst(c.name)}Error = ${errorUnion(c)
+            .map((x) => `'${x}'`)
+            .join(' | ')};`);
+        if (site?.domainCodes.length)
+            out.push(`export type ${N}${upperFirst(c.name)}DomainCode = ${site.domainCodes.map((x) => `'${x}'`).join(' | ')};`);
+    }
+    out.push('');
+    const fieldKeys = Object.entries(a.fields)
+        .filter(([, f]) => !f.isHidden && f.sql !== 'jsonb' && !f.sensitiveKind)
+        .map(([k]) => k);
+    const sortKeys = [
+        'createdAt',
+        'updatedAt',
+        ...Object.entries(a.fields)
+            .filter(([, f]) => !f.isHidden && f.sql !== 'jsonb')
+            .map(([k]) => k),
+    ];
+    out.push(`export type ${N}SortKey = ${sortKeys.map((k) => `'${k}'`).join(' | ')};`);
+    out.push(`export interface ${N}ListParams {`);
+    out.push('  page?: number;');
+    out.push('  pageSize?: number;');
+    out.push(`  /** 排序：字段名，前面加 - 表示倒序 */`);
+    out.push(`  sort?: ${N}SortKey | \`-\${${N}SortKey}\`;`);
+    out.push(`  /** 可以逗号分隔多个状态 */`);
+    out.push('  status?: string;');
+    out.push('  createdAfter?: string;');
+    out.push('  createdBefore?: string;');
+    for (const k of fieldKeys)
+        out.push(`  ${k}?: string | number | boolean;`);
+    out.push('}');
+    out.push('');
+    out.push(`/** 调用方法：每个命令一个；client 自动生成并附带幂等键和 CSRF 令牌 */`);
+    out.push(`export const ${m} = {`);
+    for (const c of cmds) {
+        const E = `${N}${upperFirst(c.name)}Error`;
+        const url = commandUrlExpr(c);
+        const desc = c.cmd.description ? `  /** ${c.cmd.description} */\n` : '';
+        if (c.cmd.from === 'new') {
+            out.push(`${desc}  ${c.name}: (input: z.input<typeof ${N}Inputs.${c.name}>) => client.post<${N}, ${E}>(${url}, input),`);
+        }
+        else if (isIdOnly(c)) {
+            out.push(`${desc}  ${c.name}: (id: string, expectedVersion?: number) => client.post<${N}, ${E}>(${url}, { expectedVersion }),`);
+        }
+        else {
+            out.push(`${desc}  ${c.name}: (id: string, input: Omit<z.input<typeof ${N}Inputs.${c.name}>, 'id'>, expectedVersion?: number) => client.post<${N}, ${E}>(${url}, { ...input, expectedVersion }),`);
+        }
+    }
+    out.push(`  /** 导出 CSV：需要 ${N}.export 能力 */`);
+    out.push(`  export: (params: ${N}ListParams = {}) => client.post<string, never>('/api/${kebab(N)}/export', params),`);
+    out.push(`  get: (id: string) => client.get<${N}>(\`/api/${kebab(N)}/\${encodeURIComponent(id)}\`),`);
+    out.push(`  list: (params: ${N}ListParams = {}) => client.get<{ items: ${N}[]; total: number; page: number; pageSize: number }>('/api/${kebab(N)}', params as Record<string, unknown>),`);
+    out.push('};');
+    out.push('');
+    out.push(`/** 详情查询 hook：响应也用 schema 校验；范围外返回 NOT_FOUND */`);
+    out.push(`export const use${N} = (id: string) => useCageQuery(['${kebab(N)}', id], \`/api/${kebab(N)}/\${encodeURIComponent(id)}\`, ${N}Schema, { enabled: !!id });`);
+    out.push(`/** 列表查询 hook：走读侧账号与安全视图 */`);
+    out.push(`export const use${N}List = (params: ${N}ListParams = {}) => useCageList(['${kebab(N)}'], '/api/${kebab(N)}', params as Record<string, unknown>, ${N}Schema);`);
+    out.push(`/** 查询缓存键前缀：命令成功后让它失效 */`);
+    out.push(`export const ${m}Keys = { all: ['${kebab(N)}'] as const, one: (id: string) => ['${kebab(N)}', id] as const };`);
+    return out.join('\n') + '\n';
+}
+export function queriesFile(reg) {
+    const out = [
+        HEADER,
+        `import { z } from 'zod';`,
+        `import { client, useCageQuery } from '@yss123/cage-client';`,
+        '',
+    ];
+    out.push('/** 查询输入 */');
+    out.push('export const QueryInputs = {');
+    for (const q of reg.queries)
+        out.push(`  ${q.name}: ${zodCodeOf(q.input)},`);
+    out.push('};');
+    out.push('');
+    out.push('export const queries = {');
+    for (const q of reg.queries) {
+        out.push(`  /** ${q.description ?? q.name}（需要 ${q.reads.map((r) => `${r.name}.read`).join('、')}） */`);
+        out.push(`  ${q.name}: (input: z.input<typeof QueryInputs.${q.name}> = {} as any) => client.get<Record<string, unknown>[]>('/api/queries/${kebab(q.name)}', input as Record<string, unknown>),`);
+    }
+    out.push('};');
+    out.push('');
+    for (const q of reg.queries) {
+        out.push(`export const use${upperFirst(q.name)} = (input: z.input<typeof QueryInputs.${q.name}> = {} as any) => useCageQuery<Record<string, unknown>[]>(['query', '${q.name}'], '/api/queries/${kebab(q.name)}', undefined, { query: input as Record<string, unknown> });`);
+    }
+    return out.join('\n') + '\n';
+}
+export function indexFile(reg) {
+    const caps = reg.capabilityCatalog().map((c) => c.capability);
+    const out = [HEADER];
+    for (const a of reg.aggregates)
+        out.push(`export * from './${kebab(a.name)}';`);
+    out.push(`export * from './queries';`);
+    out.push(`import { can as baseCan, useCan as baseUseCan } from '@yss123/cage-client';`);
+    for (const a of reg.aggregates)
+        out.push(`import { ${a.name}Inputs } from './${kebab(a.name)}';`);
+    out.push(`export { client, configureClient, loadMe, currentUser, CageQueryError, type CageResult, type CommonError } from '@yss123/cage-client';`);
+    out.push('');
+    out.push('/** 能力目录（由代码派生）：写错能力点名会编译失败 */');
+    out.push(`export const capabilities = [\n${caps.map((c) => `  '${c}',`).join('\n')}\n] as const;`);
+    out.push('export type Capability = (typeof capabilities)[number];');
+    out.push('');
+    out.push('/** 当前用户有没有某个能力点。只影响界面显示：绕过前端直接调接口，内核一样会拒绝 */');
+    out.push('export const can = (capability: Capability): boolean => baseCan(capability);');
+    out.push('export const useCan = (capability: Capability): boolean => baseUseCan(capability);');
+    out.push('');
+    out.push('/** 各聚合的命令输入 schema：schemas.PurchaseOrder.create 可以直接给表单库做校验 */');
+    out.push(`export const schemas = {\n${reg.aggregates.map((a) => `  ${a.name}: ${a.name}Inputs,`).join('\n')}\n};`);
+    return out.join('\n') + '\n';
+}
+export function contractsFiles(reg, sites) {
+    const files = {};
+    for (const a of reg.aggregates)
+        files[`${kebab(a.name)}.ts`] = aggregateFile(reg, a, sites);
+    files['queries.ts'] = queriesFile(reg);
+    files['index.ts'] = indexFile(reg);
+    return files;
+}
+//# sourceMappingURL=contracts.js.map

package/dist/gen/contracts.js.map

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

package/dist/gen/index.d.ts

@@ -0,0 +1,19 @@
+import { type Registry } from '@yss123/cage-kernel';
+import { type CageConfig } from '../config.js';
+import type { Finding } from '../findings.js';
+import type { Ontology } from '../ontology.js';
+import type { DeclSite } from '../static-check.js';
+export declare function stateDiagram(g: Ontology, agg: string): string;
+export interface GenResult {
+    written: string[];
+    findings: Finding[];
+    migrationDraft?: string;
+}
+export declare function generate(cfg: CageConfig, reg: Registry, g: Ontology, sites: DeclSite[], opts?: {
+    check?: boolean;
+}): GenResult;
+export declare function routes(reg: Registry): {
+    method: string;
+    url: string;
+    capability: string;
+}[];