@yss123/cage-cli 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shunshunyue and Cage contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,19 @@
-# Temporary Holding Version
+# @yss123/cage-cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+cage 命令行：gen、check、impact、test、verify、budget、sync、upgrade、dev、migrate
+
+Cage 是通过 TypeScript 声明业务、由框架统一执行权限和数据规则的中后台框架。此包是框架的一部分。
+
+## 使用
+
+```powershell
+pnpm add -D @yss123/cage-cli
+```
+
+首次使用建议通过脚手架创建完整项目，所需依赖由模板统一配置。需要 Node.js 24 或更新版本。
+
+- [完整使用说明](https://github.com/shunshunyue/cage/blob/main/docs/使用说明.md)
+- [框架源码与范例](https://github.com/shunshunyue/cage)
+- [问题反馈](https://github.com/shunshunyue/cage/issues)
+
+许可证：[MIT](https://github.com/shunshunyue/cage/blob/main/LICENSE)。

package/bin/cage.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { main } from '../dist/main.js';
+main().then((code) => { process.exitCode = code; }).catch((error) => {
+  console.error(error.message);
+  process.exitCode = 1;
+});

package/bin/create-cage-app.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { main } from '../dist/main.js';
+main(['create', ...process.argv.slice(2)]).then((code) => { process.exitCode = code; }).catch((error) => {
+  console.error(error.message);
+  process.exitCode = 1;
+});

package/dist/analyze.d.ts

@@ -0,0 +1,18 @@
+import { type CageConfig } from './config.js';
+import { type Finding } from './findings.js';
+import { type Ontology } from './ontology.js';
+/** 静态检查先于模块求值；发现动态声明或 IO 时不执行模块。 */
+export declare function analyze(cfg: CageConfig, opts?: {
+    base?: Ontology;
+    write?: boolean;
+}): Promise<{
+    source: import("./static-check.js").StaticResult;
+    findings: Finding[];
+    registry?: undefined;
+    graph?: undefined;
+} | {
+    source: import("./static-check.js").StaticResult;
+    registry: import("@yss123/cage-kernel").Registry;
+    graph: Ontology;
+    findings: Finding[];
+}>;

package/dist/analyze.js

@@ -0,0 +1,26 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { abs } from './config.js';
+import { errorsOnly } from './findings.js';
+import { loadRegistry } from './load.js';
+import { extract } from './ontology.js';
+import { runRules } from './rules.js';
+import { staticCheck, unexportedFindings } from './static-check.js';
+/** 静态检查先于模块求值；发现动态声明或 IO 时不执行模块。 */
+export async function analyze(cfg, opts = {}) {
+    const source = staticCheck(cfg);
+    if (errorsOnly(source.findings).length)
+        return { source, findings: source.findings };
+    const { mod, registry } = await loadRegistry(abs(cfg, cfg.domain));
+    const graph = extract(registry, source.sites, source.unsafeCount);
+    const findings = [
+        ...source.findings,
+        ...unexportedFindings(source.sites, new Set(Object.keys(mod))),
+        ...runRules(graph, opts.base),
+    ];
+    if (opts.write) {
+        mkdirSync(abs(cfg, '.cage'), { recursive: true });
+        writeFileSync(abs(cfg, '.cage/ontology.json'), JSON.stringify(graph, null, 2) + '\n');
+    }
+    return { source, registry, graph, findings };
+}
+//# sourceMappingURL=analyze.js.map

package/dist/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../src/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,GAAG,EAAmB,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,UAAU,EAAgB,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,OAAO,EAAiB,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEpE,oCAAoC;AACpC,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAe,EAAE,OAA6C,EAAE;IAC5F,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IACrF,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAc;QAC1B,GAAG,MAAM,CAAC,QAAQ;QAClB,GAAG,kBAAkB,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,GAAG,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC;KAC9B,CAAC;IACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,qBAAqB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC"}

package/dist/baseline.d.ts

@@ -0,0 +1,5 @@
+import { type CageConfig } from './config.js';
+export declare function loadBaseline(cfg: CageConfig, opts: {
+    base?: string;
+    baseFile?: string;
+}): Promise<import("./ontology.js").Ontology | undefined>;

package/dist/baseline.js

@@ -0,0 +1,50 @@
+// 基线来自显式 JSON 文件，或 Git 提交里的业务声明。
+// Git 比较在独立临时工作树中抽取，不切换用户当前分支，也不安装/执行基线脚本。
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdirSync, mkdtempSync, rmSync, symlinkSync, unlinkSync } from 'node:fs';
+import { dirname, join, relative } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { abs } from './config.js';
+import { readOntology } from './impact.js';
+import { run } from './process.js';
+import { projectManifests } from './upgrade.js';
+export async function loadBaseline(cfg, opts) {
+    if (opts.baseFile)
+        return readOntology(abs(cfg, opts.baseFile));
+    if (!opts.base)
+        return undefined;
+    const git = (args) => execFileSync('git', args, { cwd: cfg.root, encoding: 'utf8', windowsHide: true }).trim();
+    const repository = git(['rev-parse', '--show-toplevel']);
+    // 先解析 ref，错误基线必须报错，不能把“基线不存在”解释为“没有变化”。
+    const commit = git(['rev-parse', '--verify', `${opts.base}^{commit}`]);
+    mkdirSync(abs(cfg, '.cage'), { recursive: true });
+    const temporary = mkdtempSync(abs(cfg, '.cage/baseline-'));
+    const checkout = join(temporary, 'checkout');
+    git(['worktree', 'add', '--detach', checkout, commit]);
+    const links = [];
+    try {
+        const project = join(checkout, relative(repository, cfg.root));
+        // 使用当前已经安装的框架版本；基线与当前声明由同一抽取器解释。
+        // pnpm 把依赖链接放在各 workspace 包内，单独链接根目录不足以解析 domain。
+        for (const original of new Set([repository, cfg.root, ...projectManifests(repository).map(dirname)])) {
+            const destination = join(checkout, relative(repository, original));
+            if (existsSync(destination) && existsSync(join(original, 'node_modules')) && !existsSync(join(destination, 'node_modules'))) {
+                symlinkSync(join(original, 'node_modules'), join(destination, 'node_modules'), process.platform === 'win32' ? 'junction' : 'dir');
+                links.push(join(destination, 'node_modules'));
+            }
+        }
+        const code = await run(fileURLToPath(new URL('../bin/cage.js', import.meta.url)), ['analyze', '--root', project], project);
+        if (code !== 0)
+            throw new Error('[CAGE-IMPACT-001] 基线抽取失败，请修复基线声明或使用保存的 --base-file');
+        return readOntology(join(project, '.cage/ontology.json'));
+    }
+    finally {
+        // 先断开本次建立的 junction，避免清理工作树时遍历共享依赖目录。
+        for (const link of links)
+            unlinkSync(link);
+        git(['worktree', 'remove', '--force', checkout]);
+        // temporary 是本次 mkdtemp 创建的绝对目录，只移除自己的临时目录。
+        rmSync(temporary, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=baseline.js.map

package/dist/baseline.js.map

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

package/dist/budget.d.ts

@@ -0,0 +1,7 @@
+import { type CageConfig } from './config.js';
+import type { Ontology } from './ontology.js';
+import type { Finding } from './findings.js';
+export declare function budget(cfg: CageConfig, graph: Ontology, base?: Ontology): {
+    metrics: Record<string, number | null>;
+    findings: Finding[];
+};

package/dist/budget.js

@@ -0,0 +1,52 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { abs } from './config.js';
+import { listTs } from './static-check.js';
+export function budget(cfg, graph, base) {
+    const kernel = abs(cfg, 'packages/kernel/src');
+    const lines = existsSync(kernel)
+        ? listTs(kernel).reduce((n, f) => n +
+            readFileSync(f, 'utf8')
+                .split('\n')
+                .filter((l) => l.trim() && !l.trim().startsWith('//')).length, 0)
+        : null;
+    const primitivesFile = abs(cfg, 'packages/kernel/src/brands.ts');
+    // 使用公共词汇表计数；品牌还含内部扩展标记，不能把两者混算。
+    const families = {
+        CONNECTOR: 'external',
+        OUTBOUND: 'external',
+        INBOUND: 'external',
+        ROUTE: 'approval',
+        APPROVAL: 'approval',
+    };
+    const vocabulary = new Set(['field', 'capability', 'scope', 'constraint', 'invariant']);
+    if (existsSync(primitivesFile)) {
+        for (const match of readFileSync(primitivesFile, 'utf8').matchAll(/export const (\w+) = Symbol\.for\(/g)) {
+            if (['CONSUMERS', 'SYSTEM_DDL'].includes(match[1]))
+                continue;
+            vocabulary.add(families[match[1]] ?? match[1].toLowerCase());
+        }
+    }
+    const primitives = existsSync(primitivesFile) ? vocabulary.size : null;
+    const findings = [];
+    if (lines !== null && lines > 5000)
+        findings.push({
+            code: 'CAGE-BUDGET-001',
+            reason: `内核 ${lines} 行，超过 5000 行预算`,
+            fix: '拆出扩展职责，或提交架构评审调整预算',
+        });
+    if (primitives !== null && primitives > 16)
+        findings.push({
+            code: 'CAGE-BUDGET-002',
+            reason: `品牌原语 ${primitives} 个，超过 16 个预算`,
+            fix: '优先使用组合子，避免新增原语',
+        });
+    const allowance = base?.unsafeCount ?? 0;
+    if (graph.unsafeCount > allowance)
+        findings.push({
+            code: 'CAGE-BUDGET-003',
+            reason: `unsafe 从 ${allowance} 增加到 ${graph.unsafeCount}`,
+            fix: '移除新增逃生口，或在评审完成后更新受审基线',
+        });
+    return { metrics: { kernelLines: lines, primitives, unsafe: graph.unsafeCount }, findings };
+}
+//# sourceMappingURL=budget.js.map

package/dist/budget.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,30 @@
+export interface CageConfig {
+    root: string;
+    name: string;
+    /** domain 包入口：抽取器和内核都从这里读 */
+    domain: string;
+    /** 前端 SDK 生成目录 */
+    contracts: string;
+    /** contracts 包名（前端从这里引入） */
+    contractsPackage: string;
+    migrations: string;
+    generated: string;
+    apiEntry: string;
+    workerEntry: string;
+    web: string;
+    /** 需要类型检查的目录（各自有 tsconfig.json） */
+    typecheck: string[];
+    /** lint 与依赖规则检查的目录 */
+    lint: string[];
+    /** 本地开发数据库端口；用于 Docker 初始配置及未配置外部连接时的内嵌实例 */
+    devDbPort: number;
+    /** 图谱的显示文案独立于业务标识；键为“节点类型:节点 ID”，不影响路由、
+     * 数据表、能力点和影响分析。可用短标题覆盖较长的声明 description。 */
+    graph?: {
+        title?: string;
+        labels?: Record<string, string>;
+    };
+}
+export declare function findRoot(start?: string): string;
+export declare function loadConfig(start?: string): CageConfig;
+export declare const abs: (cfg: CageConfig, p: string) => string;

package/dist/config.js

@@ -0,0 +1,47 @@
+// 项目配置：默认值对应模板生成的目录结构，cage.config.json 可以覆盖。
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+export function findRoot(start = process.cwd()) {
+    let dir = resolve(start);
+    for (;;) {
+        if (existsSync(join(dir, 'cage.config.json')))
+            return dir;
+        const pkg = join(dir, 'package.json');
+        if (existsSync(pkg)) {
+            const j = JSON.parse(readFileSync(pkg, 'utf8'));
+            if (j.devDependencies?.['@yss123/cage-cli'] || j.dependencies?.['@yss123/cage-cli'] || j.cage)
+                return dir;
+        }
+        const up = dirname(dir);
+        if (up === dir)
+            return resolve(start);
+        dir = up;
+    }
+}
+export function loadConfig(start) {
+    const root = findRoot(start);
+    const file = join(root, 'cage.config.json');
+    const user = existsSync(file) ? JSON.parse(readFileSync(file, 'utf8')) : {};
+    const pkg = existsSync(join(root, 'package.json'))
+        ? JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'))
+        : {};
+    const c = {
+        name: pkg.name ?? 'cage-app',
+        domain: 'packages/domain/src/index.ts',
+        contracts: 'packages/contracts/src',
+        contractsPackage: '@app/contracts',
+        migrations: 'db/migrations',
+        generated: 'generated',
+        apiEntry: 'apps/api/src/main.ts',
+        workerEntry: 'apps/api/src/worker.ts',
+        web: 'apps/web',
+        typecheck: ['packages/domain', 'packages/contracts', 'apps/api', 'apps/web'],
+        lint: ['packages/domain/src', 'apps/api/src', 'apps/web/src'],
+        devDbPort: 54329,
+        ...pkg.cage,
+        ...user,
+    };
+    return { ...c, root };
+}
+export const abs = (cfg, p) => resolve(cfg.root, p);
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2BnD,MAAM,UAAU,QAAQ,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE;IAC5C,IAAI,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACzB,SAAS,CAAC;QACR,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACtC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;YAChD,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,IAAI;gBAAE,OAAO,GAAG,CAAC;QAC5G,CAAC;QACD,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,EAAE,KAAK,GAAG;YAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,GAAG,GAAG,EAAE,CAAC;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAChD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9D,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,CAAC,GAAG;QACR,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,UAAU;QAC5B,MAAM,EAAE,8BAA8B;QACtC,SAAS,EAAE,wBAAwB;QACnC,gBAAgB,EAAE,gBAAgB;QAClC,UAAU,EAAE,eAAe;QAC3B,SAAS,EAAE,WAAW;QACtB,QAAQ,EAAE,sBAAsB;QAChC,WAAW,EAAE,wBAAwB;QACrC,GAAG,EAAE,UAAU;QACf,SAAS,EAAE,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,UAAU,EAAE,UAAU,CAAC;QAC5E,IAAI,EAAE,CAAC,qBAAqB,EAAE,cAAc,EAAE,cAAc,CAAC;QAC7D,SAAS,EAAE,KAAK;QAChB,GAAG,GAAG,CAAC,IAAI;QACX,GAAG,IAAI;KACR,CAAC;IACF,OAAO,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,GAAe,EAAE,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC"}

package/dist/create.d.ts

@@ -0,0 +1 @@
+export declare function createApp(target: string, frameworkPath?: string): string;

package/dist/create.js

@@ -0,0 +1,47 @@
+import { cpSync, existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join, relative, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { VERSION, projectManifests } from './upgrade.js';
+export function createApp(target, frameworkPath) {
+    const root = resolve(target);
+    if (existsSync(root))
+        throw new Error('[CAGE-CREATE-001] 目标路径已存在，请选择新目录');
+    const here = dirname(fileURLToPath(import.meta.url));
+    const template = [resolve(here, '../templates/app'), resolve(here, '../../../templates/app')].find(existsSync);
+    if (!template)
+        throw new Error('[CAGE-CREATE-001] CLI 发布包缺少模板');
+    cpSync(template, root, {
+        recursive: true,
+        filter: (p) => {
+            // 安装后的模板本身就在 node_modules 中，只排除模板内部的运行目录。
+            // 若检查绝对路径，npm 安装场景下连模板根目录都会被过滤，产生空项目。
+            const local = relative(template, p);
+            return !/(^|[\\/])(node_modules|dist|\.cage|generated)([\\/]|$)/.test(local) &&
+                (!/^\.env(?:\..+)?$/.test(basename(p)) || basename(p) === '.env.example');
+        },
+    });
+    // 报错链接在新项目中也能直接打开，不要求用户另行克隆框架文档。
+    const errors = [resolve(here, '../managed/errors'), resolve(here, '../../../docs/errors')].find(existsSync);
+    if (errors)
+        cpSync(errors, join(root, 'docs/errors'), { recursive: true });
+    for (const path of projectManifests(root)) {
+        const p = JSON.parse(readFileSync(path, 'utf8'));
+        // 发布后使用统一版本号；源码试用用 link 指向已构建的本地框架，不要求先发 npm。
+        for (const group of ['dependencies', 'devDependencies'])
+            for (const name of Object.keys(p[group] ?? {}))
+                if (name.startsWith('@yss123/cage-')) {
+                    p[group][name] = frameworkPath
+                        ? `link:${resolve(frameworkPath, 'packages', name.slice('@yss123/cage-'.length)).replace(/\\/g, '/')}`
+                        : VERSION;
+                }
+        if (path === join(root, 'package.json'))
+            p.name = root
+                .split(/[\\/]/)
+                .pop()
+                .toLowerCase()
+                .replace(/[^a-z0-9-]/g, '-');
+        writeFileSync(path, JSON.stringify(p, null, 2) + '\n');
+    }
+    return root;
+}
+//# sourceMappingURL=create.js.map

package/dist/create.js.map

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

package/dist/database.d.ts

@@ -0,0 +1,5 @@
+import { type CageConfig } from './config.js';
+/** 首次为项目生成独立凭证；已有配置保持原样，避免与持久卷中的角色密码失配。 */
+export declare function setupDatabase(cfg: CageConfig): boolean;
+/** Docker 仅负责基础设施，建库、账号权限和迁移仍复用框架现有 migrate 流程。 */
+export declare function database(cfg: CageConfig, action?: string): Promise<number>;

package/dist/database.js

@@ -0,0 +1,70 @@
+// 开发数据库的环境配置与 Docker 生命周期属于框架工具链。
+// 业务仓库只保留 compose.yaml/.env 等部署参数，不维护连接、建库或凭证生成脚本。
+import { existsSync, writeFileSync } from 'node:fs';
+import { randomBytes } from 'node:crypto';
+import { spawn } from 'node:child_process';
+import { abs } from './config.js';
+import { migrate } from './migrate.js';
+/** 首次为项目生成独立凭证；已有配置保持原样，避免与持久卷中的角色密码失配。 */
+export function setupDatabase(cfg) {
+    const target = abs(cfg, '.env');
+    if (existsSync(target))
+        return false;
+    const secret = () => randomBytes(24).toString('hex');
+    const passwords = { postgres: secret(), test: secret(), app: secret(), read: secret(), migrate: secret() };
+    const port = cfg.devDbPort;
+    const url = (user, password, port, database) => `postgresql://${user}:${password}@127.0.0.1:${port}/${database}`;
+    const content = [
+        '# 仅供本地开发，由 cage db setup 生成；不要提交或复制进镜像。',
+        `CAGE_POSTGRES_PORT=${port}`,
+        `CAGE_TEST_POSTGRES_PORT=${port + 1}`,
+        `POSTGRES_PASSWORD=${passwords.postgres}`,
+        `CAGE_TEST_POSTGRES_PASSWORD=${passwords.test}`,
+        `CAGE_SUPER_DATABASE_URL=${url('postgres', passwords.postgres, port, 'postgres')}`,
+        `CAGE_APP_DATABASE_URL=${url('cage_app', passwords.app, port, 'cage_dev')}`,
+        `CAGE_READ_DATABASE_URL=${url('cage_read', passwords.read, port, 'cage_dev')}`,
+        `CAGE_MIGRATE_DATABASE_URL=${url('cage_migrate', passwords.migrate, port, 'cage_dev')}`,
+        '# 测试会初始化集群角色，必须使用独立的可丢弃测试集群。',
+        `CAGE_TEST_DATABASE_URL=${url('postgres', passwords.test, port + 1, 'postgres')}`,
+        `CAGE_COOKIE_SECRET=${secret()}`,
+        'CAGE_STAGE=fake',
+        'CAGE_WEB_PORT=5173',
+        'PORT=3000',
+        'HOST=127.0.0.1',
+        '',
+    ].join('\n');
+    writeFileSync(target, content, { mode: 0o600, flag: 'wx' });
+    return true;
+}
+/** Docker 仅负责基础设施，建库、账号权限和迁移仍复用框架现有 migrate 流程。 */
+export async function database(cfg, action) {
+    if (action === 'setup') {
+        console.log(setupDatabase(cfg)
+            ? '已生成 .env（不输出密码）。随后运行 cage db up、cage db init、cage dev。'
+            : '已有 .env，保留当前数据库配置。');
+        return 0;
+    }
+    if (action === 'init') {
+        await migrate(cfg, true);
+        return 0;
+    }
+    // 参数列表由命令固定，不接受任意 shell 文本；down 不删除持久卷。
+    const actions = {
+        up: ['up', '-d', '--wait'],
+        down: ['down'],
+        status: ['ps'],
+    };
+    if (!action || !actions[action])
+        throw new Error('用法：cage db setup|up|init|status|down');
+    const child = spawn('docker', ['compose', '--profile', 'test', ...actions[action]], {
+        cwd: cfg.root,
+        env: process.env,
+        stdio: 'inherit',
+        windowsHide: true,
+    });
+    return new Promise((resolve, reject) => {
+        child.once('error', reject);
+        child.once('exit', (code) => resolve(code ?? 1));
+    });
+}
+//# sourceMappingURL=database.js.map

package/dist/database.js.map

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

package/dist/derive.d.ts

@@ -0,0 +1,14 @@
+import { type CageConfig } from './config.js';
+import type { Ontology } from './ontology.js';
+export interface DerivedTest {
+    file: string;
+    name: string;
+    /** 这个测试守护的本体节点（影响分析据此挑选要运行的测试） */
+    subject: string;
+}
+export declare function deriveTests(cfg: CageConfig, g: Ontology): {
+    files: Record<string, string>;
+    tests: DerivedTest[];
+};
+export declare function writeDerived(cfg: CageConfig, files: Record<string, string>): string;
+export declare function vitestConfig(cfg: CageConfig, only?: 'derived' | 'project'): string;