@yss123/cage-cli 0.1.0 → 0.3.0

package/dist/create-prompt.d.ts

@@ -0,0 +1,12 @@
+import { type AppTemplate } from './create.js';
+/**
+ * 补齐创建目录与模板选项，供 main 在任何文件复制前调用。
+ * @param target 显式目录；缺省时交互询问。
+ * @param template blank 或 purchase；缺省时交互选择而非在 CI 静默默认。
+ * @returns 完整创建选择；用户取消返回 null，由入口转换为取消退出码。
+ * @throws 非交互缺项或模板名无效时抛出 CAGE-CREATE-001。
+ */
+export declare function chooseApp(target?: string, template?: string): Promise<{
+    target: string;
+    template: AppTemplate;
+} | null>;

package/dist/create-prompt.js

@@ -0,0 +1,62 @@
+/**
+ * 创建应用前的终端交互层，向 main 返回已经明确的目录与模板选择。
+ * 显式参数优先，缺项时使用 Clack 提示；非 TTY 必须提供完整参数，取消返回 null。
+ * 本模块不复制模板或安装依赖，因此交互取消不会留下创建到一半的应用。
+ */
+// 交互只收集创建选项，所有问题结束后才复制文件；Ctrl+C 不会留下半个项目。
+import { cancel, intro, isCancel, select, text } from '@clack/prompts';
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { appTemplates, isAppTemplate } from './create.js';
+/**
+ * 补齐创建目录与模板选项，供 main 在任何文件复制前调用。
+ * @param target 显式目录；缺省时交互询问。
+ * @param template blank 或 purchase；缺省时交互选择而非在 CI 静默默认。
+ * @returns 完整创建选择；用户取消返回 null，由入口转换为取消退出码。
+ * @throws 非交互缺项或模板名无效时抛出 CAGE-CREATE-001。
+ */
+export async function chooseApp(target, template) {
+    if (template !== undefined && !isAppTemplate(template))
+        throw new Error('[CAGE-CREATE-001] --template 只能是 blank 或 purchase');
+    // 管道和 CI 没有可操作的终端，不隐式选择业务模板，也不让安装任务挂在提示上。
+    if ((!target || !template) && (!process.stdin.isTTY || !process.stdout.isTTY))
+        throw new Error('[CAGE-CREATE-001] 非交互终端请指定目录和模板，例如：create-cage-app my-app --template blank');
+    if (!target || !template)
+        intro('创建 Cage 业务应用');
+    if (!target) {
+        const answer = await text({
+            message: '项目目录',
+            placeholder: 'my-cage-app',
+            defaultValue: 'my-cage-app',
+            validate: (value) => {
+                if (!value?.trim())
+                    return '请输入项目目录';
+                if (existsSync(resolve(value.trim())))
+                    return '目标路径已存在，请选择新目录';
+            },
+        });
+        if (isCancel(answer)) {
+            cancel('已取消创建');
+            return null;
+        }
+        target = answer.trim();
+    }
+    if (!template) {
+        const answer = await select({
+            message: '选择项目模板（↑↓ 选择，Enter 确认）',
+            initialValue: 'blank',
+            options: Object.entries(appTemplates).map(([value, option]) => ({
+                value: value,
+                label: option.label,
+                hint: option.hint,
+            })),
+        });
+        if (isCancel(answer)) {
+            cancel('已取消创建');
+            return null;
+        }
+        template = answer;
+    }
+    return { target, template: template };
+}
+//# sourceMappingURL=create-prompt.js.map

package/dist/create-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-prompt.js","sourceRoot":"","sources":["../src/create-prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,0CAA0C;AAC1C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAoB,MAAM,aAAa,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAe,EACf,QAAiB;IAEjB,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IAEvE,0CAA0C;IAC1C,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3E,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;IAEJ,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ;QAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC;YACxB,OAAO,EAAE,MAAM;YACf,WAAW,EAAE,aAAa;YAC1B,YAAY,EAAE,aAAa;YAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;gBAClB,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;oBAAE,OAAO,SAAS,CAAC;gBACrC,IAAI,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;oBAAE,OAAO,gBAAgB,CAAC;YACjE,CAAC;SACF,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,OAAO,CAAC,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IACD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,MAAM,GAAG,MAAM,MAAM,CAAc;YACvC,OAAO,EAAE,wBAAwB;YACjC,YAAY,EAAE,OAAO;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9D,KAAK,EAAE,KAAoB;gBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;aAClB,CAAC,CAAC;SACJ,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,OAAO,CAAC,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,QAAQ,GAAG,MAAM,CAAC;IACpB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAuB,EAAE,CAAC;AACvD,CAAC"}

package/dist/create.d.ts

@@ -1 +1,38 @@
-export declare function createApp(target: string, frameworkPath?: string): string;
+/** 两种模板共用框架基础能力，只让用户选择是否带业务演示。目录名与命令参数分开，
+ * 保留已有 templates/app 作为采购模板，避免改写它已分发的迁移历史。 */
+/**
+ * 可分发模板目录与交互标签的固定映射；blank 只有应用基础，purchase 包含采购演示。
+ * 目录名与命令参数分离，保留既有模板路径及迁移历史；此映射本身不创建应用。
+ */
+export declare const appTemplates: {
+    readonly blank: {
+        readonly directory: "blank";
+        readonly label: "空白业务项目";
+        readonly hint: "保留登录、权限和系统管理，从自己的业务开始";
+    };
+    readonly purchase: {
+        readonly directory: "app";
+        readonly label: "采购示例项目";
+        readonly hint: "包含采购单、库存、审批和 fake ERP 完整链路";
+    };
+};
+/**
+ * 创建命令允许的模板键，只对应 appTemplates 中已打包的两种模板。
+ */
+export type AppTemplate = keyof typeof appTemplates;
+/**
+ * 校验外部字符串是否为已知模板键。
+ * @param value CLI 参数或交互值。
+ * @returns 是否存在固定映射；不访问磁盘，也不验证模板资源完整性。
+ */
+export declare function isAppTemplate(value: string): value is AppTemplate;
+/** 创建本身不负责交互，供 CLI、自动化和测试复用。第二个参数是可选本地框架路径，第三个参数选择模板。 */
+/**
+ * 复制内置模板并把框架依赖改为统一版本或显式本地链接。
+ * @param target 不存在的目标目录；相对当前工作目录解析。
+ * @param frameworkPath 可选已构建框架路径，用于本地 link，不自动构建。
+ * @param template 模板键，默认 blank。
+ * @returns 创建目录的绝对路径。
+ * @throws 目标已存在、模板缺失或文件 IO 失败；不覆盖既有应用，不回滚部分复制结果。
+ */
+export declare function createApp(target: string, frameworkPath?: string, template?: AppTemplate): string;

package/dist/create.js

@@ -1,29 +1,68 @@
-import { cpSync, existsSync, readFileSync, writeFileSync } from 'node:fs';
+/**
+ * 脚手架文件复制层，由 create 命令在完成选项收集后调用。
+ * 选择 CLI 内置模板，排除运行缓存和真实环境文件，恢复 .gitignore 并改写框架依赖版本或本地链接。
+ * 仅创建不存在的目标目录；不安装包、不准备数据库，复制过程中发生 IO 错误会保留已经写入的文件供排查。
+ */
+import { cpSync, existsSync, readFileSync, renameSync, 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) {
+/** 两种模板共用框架基础能力，只让用户选择是否带业务演示。目录名与命令参数分开，
+ * 保留已有 templates/app 作为采购模板，避免改写它已分发的迁移历史。 */
+/**
+ * 可分发模板目录与交互标签的固定映射；blank 只有应用基础，purchase 包含采购演示。
+ * 目录名与命令参数分离，保留既有模板路径及迁移历史；此映射本身不创建应用。
+ */
+export const appTemplates = {
+    blank: { directory: 'blank', label: '空白业务项目', hint: '保留登录、权限和系统管理，从自己的业务开始' },
+    purchase: { directory: 'app', label: '采购示例项目', hint: '包含采购单、库存、审批和 fake ERP 完整链路' },
+};
+/**
+ * 校验外部字符串是否为已知模板键。
+ * @param value CLI 参数或交互值。
+ * @returns 是否存在固定映射；不访问磁盘，也不验证模板资源完整性。
+ */
+export function isAppTemplate(value) {
+    return Object.hasOwn(appTemplates, value);
+}
+/** 创建本身不负责交互，供 CLI、自动化和测试复用。第二个参数是可选本地框架路径，第三个参数选择模板。 */
+/**
+ * 复制内置模板并把框架依赖改为统一版本或显式本地链接。
+ * @param target 不存在的目标目录；相对当前工作目录解析。
+ * @param frameworkPath 可选已构建框架路径，用于本地 link，不自动构建。
+ * @param template 模板键，默认 blank。
+ * @returns 创建目录的绝对路径。
+ * @throws 目标已存在、模板缺失或文件 IO 失败；不覆盖既有应用，不回滚部分复制结果。
+ */
+export function createApp(target, frameworkPath, template = 'blank') {
+    if (!isAppTemplate(template))
+        throw new Error('[CAGE-CREATE-001] --template 只能是 blank 或 purchase');
     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, {
+    const directory = appTemplates[template].directory;
+    const source = [
+        resolve(here, '../templates', directory),
+        resolve(here, '../../../templates', directory),
+    ].find(existsSync);
+    if (!source)
+        throw new Error(`[CAGE-CREATE-001] CLI 发布包缺少 ${template} 模板`);
+    cpSync(source, 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 local = relative(source, 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 });
+    // npm 不分发 .gitignore，因此模板保存为 _gitignore。创建后恢复文件名，
+    // 使源码创建和 npm 创建都能忽略 .env、依赖和运行缓存。
+    renameSync(join(root, '_gitignore'), join(root, '.gitignore'));
+    // 模板本身包含所有学习资料。这里不另找框架仓库补文档，
+    // 确保本地试用与从 npm 安装得到的是同一份完整业务项目。
     for (const path of projectManifests(root)) {
         const p = JSON.parse(readFileSync(path, 'utf8'));
         // 发布后使用统一版本号；源码试用用 link 指向已构建的本地框架，不要求先发 npm。

package/dist/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","sourceRoot":"","sources":["../src/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAe,aAAa,EAAE,MAAM,SAAS,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,aAAsB;IAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,UAAU,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC1E,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,kBAAkB,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAChG,UAAU,CACX,CAAC;IACF,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAChE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE;QACrB,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;YACZ,0CAA0C;YAC1C,sCAAsC;YACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;YACpC,OAAO,CAAC,wDAAwD,CAAC,IAAI,CAAC,KAAK,CAAC;gBAC1E,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC;QAC9E,CAAC;KACF,CAAC,CAAC;IACH,iCAAiC;IACjC,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,mBAAmB,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5G,IAAI,MAAM;QAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,KAAK,MAAM,IAAI,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACjD,8CAA8C;QAC9C,KAAK,MAAM,KAAK,IAAI,CAAC,cAAc,EAAE,iBAAiB,CAAC;YACrD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC5C,IAAI,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;oBACrC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,aAAa;wBAC5B,CAAC,CAAC,QAAQ,OAAO,CAAC,aAAa,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE;wBACtG,CAAC,CAAC,OAAO,CAAC;gBACd,CAAC;QACL,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC;YACrC,CAAC,CAAC,IAAI,GAAG,IAAI;iBACV,KAAK,CAAC,OAAO,CAAC;iBACd,GAAG,EAAG;iBACN,WAAW,EAAE;iBACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QACjC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../src/create.ts"],"names":[],"mappings":"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"}

package/dist/derive.d.ts

@@ -1,14 +1,37 @@
 import { type CageConfig } from './config.js';
 import type { Ontology } from './ontology.js';
+/**
+ * 生成性质测试的目录索引，供影响分析按主体挑选候选；不是测试执行结果。
+ */
 export interface DerivedTest {
+    /** 派生测试相对 generated/tests 目录的文件名，调用者结合配置解析完整路径。 */
     file: string;
+    /** 验证类别与主体组合的测试名，用于报告及候选选择。 */
     name: string;
     /** 这个测试守护的本体节点（影响分析据此挑选要运行的测试） */
     subject: string;
 }
+/**
+ * 按本体生成通用性质用例文本及 subject 索引。
+ * @param cfg 决定生成目录和领域导入相对路径。
+ * @param g 当前本体，提供用户调用能力、状态、范围和不变量。
+ * @returns 待写文件内容与用例索引；不写盘、不执行测试，skip 处理留在生成用例里。
+ */
 export declare function deriveTests(cfg: CageConfig, g: Ontology): {
     files: Record<string, string>;
     tests: DerivedTest[];
 };
+/**
+ * 写入本轮派生测试，先清理当前生成器拥有的固定文件名。
+ * @param cfg 决定 generated/tests 位置。
+ * @param files deriveTests 产生的文件映射。
+ * @returns 测试目录绝对路径；用户额外文件不会被递归删除，IO 失败直接抛出。
+ */
 export declare function writeDerived(cfg: CageConfig, files: Record<string, string>): string;
+/**
+ * 生成用于本次测试进程的 Vitest 配置字符串。
+ * @param cfg 应用根与派生测试位置。
+ * @param only derived 仅派生、project 仅项目，省略时两者都包含。
+ * @returns 使用 testkit 全局准备的配置源码；超时单位为毫秒，不在此处启动测试。
+ */
 export declare function vitestConfig(cfg: CageConfig, only?: 'derived' | 'project'): string;

package/dist/derive.js

@@ -1,9 +1,22 @@
+/**
+ * 从本体声明生成通用性质测试及 Vitest 配置，由 cage test 和 verify 驱动。
+ * 按能力、状态、范围、审计、幂等、掩码和不变量生成代码，真实执行委托 cage-testkit。
+ * 生成器不能推断所有合法业务夹具；生成用例允许显式 skip，生成数量不等于已覆盖业务需求。
+ */
 // 派生测试生成器：遍历本体图，按固定模板为每个能力点、每个范围组合子、每条非法迁移生成测试。
 // 生成到 generated/tests，不入库，每次运行前重新生成。
 import { existsSync, mkdirSync, readdirSync, writeFileSync, unlinkSync } from 'node:fs';
 import { join, relative } from 'node:path';
 import { abs } from './config.js';
+/**
+ * 把主体和测试名称编码成合法 TS 字符串字面量，不将业务文案作为生成代码拼接执行。
+ */
 const q = (s) => JSON.stringify(s);
+/**
+ * 生成每个测试文件的共享 setup/teardown 代码，使用领域入口建立 testkit 环境。
+ * @param domainImport 生成目录到 domain 的导入路径。
+ * @returns 源码行数组；仅拼接文本，不初始化数据库。
+ */
 function header(domainImport) {
     return [
         '// 生成物：派生测试（cage test 每次运行前重新生成，不要手改）',
@@ -17,9 +30,24 @@ function header(domainImport) {
         '',
     ];
 }
+/**
+ * 筛选当前本体中的命令节点，作为派生验证的主体集合。
+ */
 const commands = (g) => g.nodes.filter((n) => n.kind === 'command');
+/**
+ * 只为声明允许 user 的命令生成用户能力验证，内部流程命令不补造用户入口。
+ */
 const userInvokable = (c) => c.attrs.invokedBy.includes('user');
+/**
+ * 从命令能力标识取得聚合前缀，与抽取器使用的 Aggregate.command 命名约定一致。
+ */
 const aggOf = (c) => c.id.split('.')[0];
+/**
+ * 按本体生成通用性质用例文本及 subject 索引。
+ * @param cfg 决定生成目录和领域导入相对路径。
+ * @param g 当前本体，提供用户调用能力、状态、范围和不变量。
+ * @returns 待写文件内容与用例索引；不写盘、不执行测试，skip 处理留在生成用例里。
+ */
 export function deriveTests(cfg, g) {
     const dir = abs(cfg, join(cfg.generated, 'tests'));
     const domainImport = relative(dir, abs(cfg, cfg.domain))
@@ -126,6 +154,12 @@ export function deriveTests(cfg, g) {
     }
     return { files, tests };
 }
+/**
+ * 写入本轮派生测试，先清理当前生成器拥有的固定文件名。
+ * @param cfg 决定 generated/tests 位置。
+ * @param files deriveTests 产生的文件映射。
+ * @returns 测试目录绝对路径；用户额外文件不会被递归删除，IO 失败直接抛出。
+ */
 export function writeDerived(cfg, files) {
     const dir = abs(cfg, join(cfg.generated, 'tests'));
     // 只清理本生成器拥有的测试文件，不递归删除配置指向的整个目录。
@@ -139,6 +173,12 @@ export function writeDerived(cfg, files) {
         writeFileSync(join(dir, name), content);
     return dir;
 }
+/**
+ * 生成用于本次测试进程的 Vitest 配置字符串。
+ * @param cfg 应用根与派生测试位置。
+ * @param only derived 仅派生、project 仅项目，省略时两者都包含。
+ * @returns 使用 testkit 全局准备的配置源码；超时单位为毫秒，不在此处启动测试。
+ */
 export function vitestConfig(cfg, only) {
     const include = only === 'derived'
         ? [`${cfg.generated}/tests/**/*.test.ts`]

package/dist/derive.js.map

@@ -1 +1 @@
-{"version":3,"file":"derive.js","sourceRoot":"","sources":["../src/derive.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,qCAAqC;AACrC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACxF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAmB,MAAM,aAAa,CAAC;AAUnD,MAAM,CAAC,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAE3C,SAAS,MAAM,CAAC,YAAoB;IAClC,OAAO;QACL,uCAAuC;QACvC,2DAA2D;QAC3D,iDAAiD;QACjD,2BAA2B,CAAC,CAAC,YAAY,CAAC,GAAG;QAC7C,EAAE;QACF,4BAA4B;QAC5B,6BAA6B;QAC7B,+BAA+B;QAC/B,EAAE;KACH,CAAC;AACJ,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,CAAW,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AAC9E,MAAM,aAAa,GAAG,CAAC,CAAU,EAAE,EAAE,CAAE,CAAC,CAAC,KAAK,CAAC,SAAsB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACvF,MAAM,KAAK,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjD,MAAM,UAAU,WAAW,CACzB,GAAe,EACf,CAAW;IAEX,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;SACrD,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC1B,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,YAAY,EAAE,CAAC;IAC9E,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,IAAY,EAAE,OAAe,EAAE,IAAc,EAAE,EAAE;QAC1E,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,CAAC,IAAI,CAAC,uBAAuB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;QACnG,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC;IAEF,iCAAiC;IACjC,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAClD,GAAG,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE;YACnD,sCAAsC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI;YACjD,sCAAsC;YACtC,mCAAmC;SACpC,CAAC,CAAC;IACL,CAAC;IAED,+CAA+C;IAC/C,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK;YAAE,SAAS;QACrC,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,IAAgB,CAAC;QACtC,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK;aACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;aACpE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QAC/C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;gBAClD,uCAAuC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;gBAC3D,sCAAsC;gBACtC,4CAA4C;aAC7C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,CAAC;QAC9D,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,KAAsD,CAAC;QAC1E,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,CAAU,EAAE,CAAC;YAC7C,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK;gBAAE,SAAS;YAC3C,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC;gBAAE,SAAS;YAChE,GAAG,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE;gBACxD,iCAAiC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI;gBACxD,sCAAsC;gBACtC,kCAAkC;gBAClC,+BAA+B;gBAC/B,mCAAmC;gBACnC,kCAAkC;aACnC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,CACvE,EAAE,CAAC;gBACF,GAAG,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,EAAE,sBAAsB,EAAE,CAAC,CAAC,EAAE,EAAE;oBACxD,qCAAqC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI;oBAChD,sCAAsC;oBACtC,mCAAmC;iBACpC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5B,GAAG,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE;YAChD,+BAA+B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI;YAC1C,sCAAsC;YACtC,yBAAyB;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,qBAAqB;IACrB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,CAAC;QAC9D,MAAM,CAAC,GACL,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;YACxF,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,GAAG,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE;YACzD,gCAAgC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI;YAC3C,sCAAsC;YACtC,4BAA4B;YAC5B,yBAAyB;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,0BAA0B;IAC1B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CACzB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CACjG,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAChC,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE;YAC5C,4BAA4B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI;YACvC,sCAAsC;YACtC,+DAA+D;SAChE,CAAC,CAAC;IACL,CAAC;IAED,yBAAyB;IACzB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAE,CAAC,CAAC,KAAK,CAAC,UAAuB,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CACrF,EAAE,CAAC;QACF,GAAG,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE;YACxD,oCAAoC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI;YAC/C,sCAAsC;YACtC,mCAAmC;SACpC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAe,EAAE,KAA6B;IACzE,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,iCAAiC;IACjC,IAAI,UAAU,CAAC,GAAG,CAAC;QACjB,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,IAAI,uEAAuE,CAAC,IAAI,CAAC,IAAI,CAAC;gBACpF,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QAChC,CAAC;IACH,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IAC7F,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAe,EAAE,IAA4B;IACxE,MAAM,OAAO,GACX,IAAI,KAAK,SAAS;QAChB,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,SAAS,qBAAqB,CAAC;QACzC,CAAC,CAAC,IAAI,KAAK,SAAS;YAClB,CAAC,CAAC,CAAC,8BAA8B,EAAE,uBAAuB,CAAC;YAC3D,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,SAAS,qBAAqB,EAAE,8BAA8B,EAAE,uBAAuB,CAAC,CAAC;IACzG,OAAO;;;;YAIG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;eAC5B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;;;;;;;;CAQrC,CAAC;AACF,CAAC"}
+{"version":3,"file":"derive.js","sourceRoot":"","sources":["../src/derive.ts"],"names":[],"mappings":"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"}

package/dist/dev.d.ts

@@ -1,2 +1,8 @@
 import { type CageConfig } from './config.js';
+/**
+ * 启动并持有本地开发进程，等待退出后完成资源清理。
+ * @param cfg API、worker、Web 和 domain 的应用布局。
+ * @returns 正常中止返回零，生成或子进程异常返回失败码/抛错；完成前回收本次子进程。
+ * 运行态移除管理员、迁移和测试连接，只传业务与读连接；热生成串行化不等于数据库迁移。
+ */
 export declare function dev(cfg: CageConfig): Promise<number>;

package/dist/dev.js

@@ -1,15 +1,24 @@
-// 本地开发的进程编排：持久化 Postgres → 生成/迁移 → API、worker、Vite。
-// 配置连接串时使用指定 PostgreSQL；没有连接串时才启动 .cage/postgres 中的内嵌实例。
-import { watch, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { randomBytes } from 'node:crypto';
+/**
+ * 本地开发进程编排入口，连接应用已配置数据库并启动 API、worker 与 Vite。
+ * 首次生成声明产物，随后用 tsx watch 重启服务，并串行处理领域变更触发的生成任务。
+ * 不安装或创建数据库、不执行迁移；退出时关闭 watcher 和本次子进程，Windows 通过进程树回收 watch 子进程。
+ */
+// 本地开发只编排 API、worker 和 Vite，数据库由使用方提供。
+// 缺少连接配置就报错，不自动启动数据库；表结构迁移由开发者审查后单独执行。
+import { watch } from 'node:fs';
 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 { urlsFromEnv } from '@yss123/cage-kernel';
 import { abs } from './config.js';
-import { initializeDatabase } from './migrate.js';
 import { binPath, launch, run } from './process.js';
+/**
+ * 启动并持有本地开发进程，等待退出后完成资源清理。
+ * @param cfg API、worker、Web 和 domain 的应用布局。
+ * @returns 正常中止返回零，生成或子进程异常返回失败码/抛错；完成前回收本次子进程。
+ * 运行态移除管理员、迁移和测试连接，只传业务与读连接；热生成串行化不等于数据库迁移。
+ */
 export async function dev(cfg) {
     const cli = fileURLToPath(new URL('../bin/cage.js', import.meta.url));
     const env = {
@@ -19,7 +28,7 @@ export async function dev(cfg) {
     };
     // 项目包的 development 导出指向源码，tsx watch 才能观察到 domain 的修改。
     env.NODE_OPTIONS = `${env.NODE_OPTIONS ?? ''} --conditions=development`.trim();
-    let database;
+    const urls = urlsFromEnv(env);
     const children = [];
     const watchers = [];
     let finish;
@@ -27,7 +36,7 @@ export async function dev(cfg) {
     const done = new Promise((resolve) => {
         finish = resolve;
     });
-    // 所有退出路径共用一次清理，避免子进程退出事件与 Ctrl+C 同时关闭数据库。
+    // 所有退出路径共用一次清理，避免子进程退出事件与 Ctrl+C 重复关闭应用进程。
     const stop = async (code) => {
         if (stopping)
             return;
@@ -45,7 +54,6 @@ export async function dev(cfg) {
         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 = () => {
@@ -54,51 +62,15 @@ export async function dev(cfg) {
     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 target = new URL(urls.app);
+        console.log(`连接数据库 ${target.hostname}:${target.port || '5432'}${target.pathname}；表结构变更请审查后单独运行 pnpm exec cage migrate。`);
+        // API/worker 只需要业务及只读连接；迁移、测试和旧版管理员凭证不传给运行时。
         const runtimeEnv = { ...env };
         for (const key of [
+            'CAGE_ADMIN_DATABASE_URL',
             'CAGE_SUPER_DATABASE_URL',
             'CAGE_MIGRATE_DATABASE_URL',
             'CAGE_MIGRATE_PASSWORD',
@@ -121,7 +93,7 @@ export async function dev(cfg) {
             });
             return child;
         };
-        // tsx watch 负责 API/worker 热重启；domain 的生成任务串行，避免迁移竞争。
+        // 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`));
@@ -138,7 +110,7 @@ export async function dev(cfg) {
                     if (stopping)
                         return;
                     if ((await run(cli, ['gen'], cfg.root, env)) === 0)
-                        await run(cli, ['migrate'], cfg.root, env);
+                        console.log('声明已生成；若有表结构变更，请审查迁移后运行 pnpm exec cage migrate。');
                 });
             }, 250);
         }));

package/dist/dev.js.map

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

package/dist/doctor.d.ts

@@ -0,0 +1,98 @@
+import { type CageConfig } from './config.js';
+import { type Finding } from './findings.js';
+/**
+ * 单项诊断证据：pass 有支持证据，fail 已发现不一致，unknown 表示未检查或事实不足。
+ * 下一步是建议，不会被 doctor 自动执行；detail 只包含本项用于解释的附加数据。
+ */
+export interface Diagnostic {
+    id: string; /** pass 有证据支持，fail 已发现问题，unknown 表示事实不足。 */
+    status: 'pass' | 'fail' | 'unknown'; /** 证据来源命令、文件或运行接口说明。 */
+    source: string; /** 本次诊断采集时间，ISO 8601 字符串，不代表代码最后修改时间。 */
+    observedAt: string; /** 当前状态及其依据的中文解释。 */
+    reason: string; /** 建议后续动作；doctor 不执行这些命令。 */
+    next: string[]; /** 可选原始解释数据，缺省表示本项没有额外明细。 */
+    detail?: unknown;
+}
+/**
+ * 运行服务返回的可选事实形状；缺少字段代表证据不足，不用磁盘状态补造。
+ */
+export interface RuntimeEvidence {
+    /** 实际 API 进程报告的框架版本；缺失时无法比较。 */
+    version?: string; /** 运行进程加载注册表的指纹，不使用源码指纹冒充。 */
+    registryHash?: string; /** 运行进程报告的注册加载时间。 */
+    loadedAt?: string; /** 服务自报的运行角色，用于附加诊断。 */
+    role?: string;
+    /** worker 的版本、注册指纹及就绪/心跳事实；缺失不能解释为未启动。 */
+    worker?: {
+        version?: string;
+        registryHash?: string;
+        ready?: boolean;
+        lastHeartbeatAt?: string;
+    };
+    /** 实例报告的已配置能力点集合，不代表当前主体可执行任意命令。 */
+    authorization?: {
+        configuredCapabilities?: string[];
+    };
+    /** 实例报告的已执行迁移名称，用于与源码要求比较。 */
+    migrations?: {
+        applied?: string[];
+    };
+}
+/**
+ * 收集源码、生成物、构建与可选实际进程状态。
+ * @param cfg 应用配置，源与编译入口按标准 src→dist 布局对应。
+ * @param options 可提供运行地址、受控 Cookie 文件和测试用 fetch；省略地址只做离线检查。
+ * @returns checks、注册链、路由和历史验证；ok 允许 unknown，complete 才要求无 unknown。
+ * 运行态连接异常降为 unknown，源码分析或本地文件异常仍可抛出；不修改业务或运行状态。
+ */
+export declare function doctor(cfg: CageConfig, options?: {
+    runtimeUrl?: string;
+    cookieFile?: string;
+    fetch?: typeof fetch;
+}): Promise<{
+    schemaVersion: number;
+    cliVersion: string;
+    observedAt: string;
+    project: string;
+    registryHash: string | undefined;
+    sourceHash: string | undefined;
+    registryHashSource: string | null;
+    ok: boolean;
+    complete: boolean;
+    checks: Diagnostic[];
+    findings: Finding[];
+    registration: {
+        declaration: {
+            name: string;
+            kind: string;
+            file: string;
+            line: number;
+        };
+        domainEntry: string;
+        exports: {
+            name: string;
+            file: string;
+            line: number;
+            exportedAs: string[];
+            chain: string[];
+        } | undefined;
+        registered: boolean;
+        nodes: {
+            key: string;
+            attrs: {
+                event: unknown;
+                command: unknown;
+                tx: unknown;
+                order: unknown;
+                collection: unknown;
+            } | undefined;
+        }[];
+    }[];
+    routes: {
+        method: string;
+        url: string;
+        capability: string;
+    }[];
+    previousVerification: any;
+    limitations: string[];
+}>;