@yss123/cage-cli 0.1.0 → 0.3.0

package/dist/doctor.js

@@ -0,0 +1,93 @@
+/**
+ * 把源码、生成物、编译产物与可选运行证据汇总为只读状态诊断。
+ * 离线阶段重新分析声明并比较生成物；提供 runtimeUrl 时通过受权限保护的 HTTP 接口获取实际进程事实。
+ * pass、fail、unknown 明确区分证据结论；本模块不迁移、不授权、不重启服务，也不把历史 verify 报告当成当前验证。
+ */
+// Status is evidence, not a replacement for verify. Offline inspection never grants access or applies migrations.
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { createHash } from 'node:crypto';
+import { readMigrations, SYSTEM_MIGRATIONS } from '@yss123/cage-kernel/db';
+import * as kernel from '@yss123/cage-kernel';
+import { abs } from './config.js';
+import { analyze } from './analyze.js';
+import { generate, routes } from './gen/index.js';
+import { errorsOnly } from './findings.js';
+import { VERSION } from './version.js';
+import { loadRegistry } from './load.js';
+import { runtimeDiagnostic } from './runtime-diagnostics.js';
+/**
+ * 收集源码、生成物、构建与可选实际进程状态。
+ * @param cfg 应用配置，源与编译入口按标准 src→dist 布局对应。
+ * @param options 可提供运行地址、受控 Cookie 文件和测试用 fetch；省略地址只做离线检查。
+ * @returns checks、注册链、路由和历史验证；ok 允许 unknown，complete 才要求无 unknown。
+ * 运行态连接异常降为 unknown，源码分析或本地文件异常仍可抛出；不修改业务或运行状态。
+ */
+export async function doctor(cfg, options = {}) {
+    const observedAt = new Date().toISOString();
+    const checks = [];
+    const add = (id, status, source, reason, next, detail) => checks.push({ id, status, source, observedAt, reason, next, detail });
+    const result = await analyze(cfg, { registration: true });
+    const findings = [...result.findings];
+    add('registered', result.registry && !errorsOnly(result.findings).length ? 'pass' : 'fail', 'analyze/check', '静态声明、导出、注册与图规则', ['cage check'], result.findings);
+    let generated = [];
+    if (result.registry && result.graph) {
+        generated = generate(cfg, result.registry, result.graph, result.source.sites, { check: true }).findings;
+        findings.push(...generated);
+        add('generated', errorsOnly(generated).length ? 'fail' : 'pass', 'gen --check', '契约及迁移草稿与声明的一致性', ['cage gen --check', 'cage gen，然后审查差异'], generated);
+    }
+    else
+        add('generated', 'unknown', 'gen --check', '声明失败，无法比较生成物', ['cage check']);
+    const sourceHash = result.registry ? kernel.registryFingerprint(result.registry) : undefined;
+    const compiledEntry = /([\\/])src([\\/])/.test(cfg.domain) ? cfg.domain.replace(/([\\/])src([\\/])/, '$1dist$2').replace(/\.tsx?$/, '.js') : '';
+    const compiledExists = !!compiledEntry && existsSync(abs(cfg, compiledEntry));
+    const stale = result.source.files.filter(file => {
+        const compiled = file.replace(/([\\/])src([\\/])/, '$1dist$2').replace(/\.tsx?$/, '.js');
+        return compiled !== file && (!existsSync(abs(cfg, compiled)) || statSync(abs(cfg, file)).mtimeMs > statSync(abs(cfg, compiled)).mtimeMs);
+    });
+    let registryHash;
+    if (compiledExists)
+        registryHash = kernel.registryFingerprint((await loadRegistry(abs(cfg, compiledEntry))).registry);
+    else if (/\.js$/.test(cfg.domain))
+        registryHash = sourceHash;
+    add('build', compiledExists ? stale.length ? 'fail' : 'pass' : 'unknown', compiledEntry || 'not-inspected', compiledExists ? '源码与对应编译产物的新鲜度；运行指纹使用实际编译产物' : '缺少标准 src→dist 编译入口；非标准布局不猜测输出目录', ['构建 domain、API 与 worker 后重启进程'], { stale });
+    let runtime;
+    let runtimeReason = '未提供 --runtime-url，未检查运行进程或数据库';
+    if (options.runtimeUrl) {
+        try {
+            const response = await runtimeDiagnostic(cfg, options, '/api/sys/diagnostics');
+            if (!response.ok)
+                runtimeReason = `运行证据不可读取（HTTP ${response.status}），需要 Sys.ops.read`;
+            else
+                runtime = response.data;
+        }
+        catch {
+            runtimeReason = '运行证据不可读取；检查服务、地址和受控凭证文件';
+        }
+    }
+    const source = options.runtimeUrl ? 'GET /api/sys/diagnostics' : 'not-inspected';
+    const extensions = result.registry?.systemDdl.map((sql, index) => `cage:ext_${createHash('sha256').update(sql).digest('hex').slice(0, 16)}_${index}`) ?? [];
+    const migrations = [...SYSTEM_MIGRATIONS.map(m => m.name), ...extensions, ...(result.registry?.systemMigrations.map(m => m.name) ?? []), ...readMigrations(abs(cfg, cfg.migrations)).map(m => m.name)];
+    const applied = runtime?.migrations?.applied;
+    const pending = applied ? migrations.filter(name => !applied.includes(name)) : undefined;
+    add('migration', pending ? pending.length ? 'fail' : 'pass' : 'unknown', source, pending ? `${pending.length} 个未执行项目迁移` : runtimeReason, ['审查迁移后显式 cage migrate'], { files: migrations, pending });
+    const configured = runtime?.authorization?.configuredCapabilities;
+    const roleRequired = result.registry ? new Set([
+        ...result.registry.commands.filter(c => c.cmd.invokedBy.includes('user')).map(c => c.capability),
+        ...result.registry.aggregates.map(a => `${a.name}.read`),
+        ...result.registry.approvals.flatMap(({ a }) => [result.registry.capabilityOf(a.onApproved), result.registry.capabilityOf(a.onRejected), ...(a.onReturned ? [result.registry.capabilityOf(a.onReturned)] : [])]),
+    ]) : undefined;
+    const missing = configured && roleRequired ? [...roleRequired].filter(c => !configured.includes(c)) : undefined;
+    add('authorization', missing ? missing.length ? 'fail' : 'pass' : 'unknown', source, missing ? '检查用户入口、读取和审批结论是否配置角色；内部任务命令不要求授予用户' : runtimeReason, ['管理员按角色、范围与额度显式配置业务授权'], { unconfigured: missing, optionalUnconfigured: configured && result.registry?.capabilityCatalog().filter(c => !roleRequired?.has(c.capability) && !configured.includes(c.capability)).map(c => c.capability) });
+    const matching = (version, hash) => version && hash && registryHash ? version === VERSION && hash === registryHash ? 'pass' : 'fail' : 'unknown';
+    add('api', matching(runtime?.version, runtime?.registryHash), source, runtime ? '比较实际 API 版本与注册指纹' : runtimeReason, ['构建并重启 API/worker，重新获取运行证据'], runtime && { version: runtime.version, registryHash: runtime.registryHash, loadedAt: runtime.loadedAt });
+    add('worker', runtime?.worker?.ready === false ? 'fail' : matching(runtime?.worker?.version, runtime?.worker?.registryHash), source, runtime?.worker ? '比较 worker 就绪、版本与注册指纹' : runtimeReason, ['检查 worker 心跳、消费者就绪与实际加载版本'], runtime?.worker);
+    const registration = result.source.sites.map(site => ({ declaration: { name: site.exportName, kind: site.primitive, file: site.file, line: site.line }, domainEntry: cfg.domain,
+        exports: result.registration?.find(entry => entry.name === site.exportName && entry.file === site.file),
+        registered: !result.findings.some(f => f.code === 'CAGE-DECL-002' && f.at === `${site.file}:${site.line}`),
+        nodes: result.graph?.nodes.filter(n => n.file === site.file && n.line === site.line).map(n => ({ key: `${n.kind}:${n.id}`, attrs: n.kind === 'reaction' ? { event: n.attrs.event, command: n.attrs.command, tx: n.attrs.tx, order: n.attrs.order, collection: n.attrs.collection } : undefined })) ?? [] }));
+    const verifyFile = abs(cfg, '.cage/verify.json');
+    return { schemaVersion: 1, cliVersion: VERSION, observedAt, project: cfg.name, registryHash, sourceHash, registryHashSource: compiledExists ? compiledEntry : /\.js$/.test(cfg.domain) ? cfg.domain : null, ok: checks.every(c => c.status !== 'fail'), complete: checks.every(c => c.status !== 'unknown'), checks, findings, registration,
+        routes: result.registry ? routes(result.registry) : [], previousVerification: existsSync(verifyFile) ? JSON.parse(readFileSync(verifyFile, 'utf8')) : null,
+        limitations: ['已有 verify 报告只代表过去一次执行，不证明当前代码已验证。', '未检查的依赖标为 unknown。doctor 不执行迁移、测试、授权或重启进程。'] };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/env.d.ts

@@ -1 +1,7 @@
+/**
+ * 将本地配置补入指定环境对象，已有同名值优先。
+ * @param root 应用根目录，只读取其 .env。
+ * @param env 要原地补充的环境对象，默认 process.env。
+ * 文件缺失时无副作用；不会输出值，读取或解析失败向上抛出。
+ */
 export declare function loadProjectEnv(root: string, env?: NodeJS.ProcessEnv): void;

package/dist/env.js

@@ -1,8 +1,19 @@
+/**
+ * 供需要运行环境的 CLI 子命令加载应用 .env，统一使用 Node 的 dotenv 解析规则。
+ * 只补充目标环境对象中尚未定义的键，已有部署变量及空字符串均保持原值。
+ * 读取内容不做 shell 展开、不打印秘密；缺少文件是无操作，解析或文件读取异常交给命令入口处理。
+ */
 // CLI 从项目根目录读取本地连接配置。显式传入的环境变量优先，CI/部署可以覆盖本地值。
 // 使用 Node 自带的 dotenv 解析器，不展开 shell 表达式，也不打印文件中的凭证。
 import { existsSync, readFileSync } from 'node:fs';
 import { parseEnv } from 'node:util';
 import { join } from 'node:path';
+/**
+ * 将本地配置补入指定环境对象，已有同名值优先。
+ * @param root 应用根目录，只读取其 .env。
+ * @param env 要原地补充的环境对象，默认 process.env。
+ * 文件缺失时无副作用；不会输出值，读取或解析失败向上抛出。
+ */
 export function loadProjectEnv(root, env = process.env) {
     const file = join(root, '.env');
     if (!existsSync(file))

package/dist/env.js.map

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

@@ -1,11 +1,38 @@
+/**
+ * 静态分析与门禁共享的诊断数据和终端格式化工具。
+ * 规则产生 code、位置、原因与可选修复建议，再由这里关联本地错误码册。
+ * 格式化是纯文本转换；severity 省略时按错误处理，只有明确 warning 才不阻止门禁。
+ */
+/**
+ * 静态检查和门禁的一条诊断，按 code 链接逐码说明，支持可选源码位置与修复方向。severity 缺省按错误处理。
+ */
 export interface Finding {
+    /** 稳定 CAGE 错误码，链接到统一错误码册。 */
     code: string;
     /** 文件:行 */
     at?: string;
+    /** 具体失败原因，不仅是错误类别标题。 */
     reason: string;
+    /** 可选可执行修复建议；不存在时由上层补通用定位信息。 */
     fix?: string;
+    /** warning 不阻断 errorsOnly；缺省按 error 处理。 */
     severity?: 'error' | 'warning';
 }
+/**
+ * 生成单条人类可读诊断及本地错误码册路径。
+ * @param f 原始诊断，缺位置或 fix 时对应行按实现省略。
+ * @returns 多行文本；不读取或验证目标文档。
+ */
 export declare function formatFinding(f: Finding): string;
+/**
+ * 按输入顺序拼接诊断，空列表返回空字符串。
+ * @param list 不会被修改的诊断数组。
+ * @returns 条目间空行分隔的终端文本。
+ */
 export declare function formatFindings(list: Finding[]): string;
+/**
+ * 筛选阻止门禁的诊断，只有显式 warning 被排除。
+ * @param list 原始列表，不会被修改。
+ * @returns severity 缺省或为 error 的条目。
+ */
 export declare const errorsOnly: (list: Finding[]) => Finding[];

package/dist/findings.js

@@ -1,4 +1,14 @@
+/**
+ * 静态分析与门禁共享的诊断数据和终端格式化工具。
+ * 规则产生 code、位置、原因与可选修复建议，再由这里关联本地错误码册。
+ * 格式化是纯文本转换；severity 省略时按错误处理，只有明确 warning 才不阻止门禁。
+ */
 // 门禁报错：每条都有错误码、位置、原因、修复方法，末尾附错误码册路径，agent 可以直接打开。
+/**
+ * 生成单条人类可读诊断及本地错误码册路径。
+ * @param f 原始诊断，缺位置或 fix 时对应行按实现省略。
+ * @returns 多行文本；不读取或验证目标文档。
+ */
 export function formatFinding(f) {
     const lines = [`  [${f.code}] ${f.at ?? ''}`.trimEnd(), `  原因：${f.reason}`];
     if (f.fix)
@@ -6,8 +16,18 @@ export function formatFinding(f) {
     lines.push(`  详见：docs/errors/${f.code}.md`);
     return lines.join('\n');
 }
+/**
+ * 按输入顺序拼接诊断，空列表返回空字符串。
+ * @param list 不会被修改的诊断数组。
+ * @returns 条目间空行分隔的终端文本。
+ */
 export function formatFindings(list) {
     return list.map(formatFinding).join('\n\n');
 }
+/**
+ * 筛选阻止门禁的诊断，只有显式 warning 被排除。
+ * @param list 原始列表，不会被修改。
+ * @returns severity 缺省或为 error 的条目。
+ */
 export const errorsOnly = (list) => list.filter((f) => f.severity !== 'warning');
 //# sourceMappingURL=findings.js.map

package/dist/findings.js.map

@@ -1 +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"}
+{"version":3,"file":"findings.js","sourceRoot":"","sources":["../src/findings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,kDAAkD;AAkBlD;;;;GAIG;AACH,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;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAe;IAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,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

@@ -1,6 +1,34 @@
+/**
+ * 将注册表转换为浏览器可用的契约源码字符串，由 generate 统一写盘。
+ * 按聚合组织读侧 schema、用户命令方法和 hooks，再生成查询与根公共入口。
+ * 不把 domain 或运行时导入浏览器；仅开放 user 命令，客户端校验保留可表达部分，服务端始终负责权威校验与授权。
+ */
 import { type AnyAggregate, type Registry } from '@yss123/cage-kernel';
 import type { DeclSite } from '../static-check.js';
+/**
+ * 生成单个聚合的浏览器契约文件文本。
+ * @param reg 注册表，用于筛选允许 user 调用的命令和关系目标。
+ * @param a 当前聚合。
+ * @param sites 静态位置，用于提取业务错误码。
+ * @returns schema、方法、hooks 与缓存键源码；不写盘、不发网络请求。
+ */
 export declare function aggregateFile(reg: Registry, a: AnyAggregate, sites: DeclSite[]): string;
+/**
+ * 生成所有显式查询的输入 schema、请求方法和 hooks。
+ * @param reg 已注册查询清单。
+ * @returns 源码文本；查询响应仍为通用记录数组，实际范围由服务器执行。
+ */
 export declare function queriesFile(reg: Registry): string;
+/**
+ * 生成契约根公共入口及能力名类型、客户端转导出。
+ * @param reg 当前注册表。
+ * @returns 根 index 源码，can/useCan 仅用于前端显示，不产生授权。
+ */
 export declare function indexFile(reg: Registry): string;
+/**
+ * 按稳定聚合名组织所有待生成契约，后端模块移动不改变契约公开入口。
+ * @param reg 注册表。
+ * @param sites 声明位置与业务错误码线索。
+ * @returns 相对路径到源码字符串的映射；实际写入由 generate 负责。
+ */
 export declare function contractsFiles(reg: Registry, sites: DeclSite[]): Record<string, string>;

package/dist/gen/contracts.js

@@ -1,42 +1,72 @@
-// 前端契约（packages/contracts）：每个聚合一个文件——字段 schema、错误码类型、调用方法和查询 hooks。
+/**
+ * 将注册表转换为浏览器可用的契约源码字符串，由 generate 统一写盘。
+ * 按聚合组织读侧 schema、用户命令方法和 hooks，再生成查询与根公共入口。
+ * 不把 domain 或运行时导入浏览器；仅开放 user 命令，客户端校验保留可表达部分，服务端始终负责权威校验与授权。
+ */
+// 前端契约（packages/contracts）：每个聚合一个目录，容纳 schema、调用方法和查询 hooks。
 // 前端只能从这里引入，所以调用方式、参数、错误码都有类型检查。
-import { kebab, lowerFirst, upperFirst, } from '@yss123/cage-kernel';
+import { kebab, isRelation, 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';
+/**
+ * 按新建或已有对象命令生成前端 URL 表达式，已有对象 ID 在生成代码中编码。
+ */
 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)}\``;
 }
+/**
+ * 根据状态、关系、约束和不变量推导命令可能的错误码联合，业务 domainCode 另由声明源码提取。
+ */
 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 (Object.values(c.cmd.agg.fields).some((f) => ['manyToMany', 'file', 'files'].includes(f.kind)))
+        codes.add('NOT_FOUND');
     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();
 }
+/**
+ * 识别输入只含 id 的 ZodObject，为生成方法选择省略 input 对象的便捷签名。
+ */
 function isIdOnly(c) {
     const s = c.cmd.input;
     return s instanceof z.ZodObject && Object.keys(s.shape).length === 1 && 'id' in s.shape;
 }
+/**
+ * 生成单个聚合的浏览器契约文件文本。
+ * @param reg 注册表，用于筛选允许 user 调用的命令和关系目标。
+ * @param a 当前聚合。
+ * @param sites 静态位置，用于提取业务错误码。
+ * @returns schema、方法、hooks 与缓存键源码；不写盘、不发网络请求。
+ */
 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 relations = Object.entries(a.fields).filter(([, field]) => isRelation(field));
     const out = [HEADER];
     out.push(`import { z } from 'zod';`);
-    out.push(`import { client, useCageList, useCageQuery } from '@yss123/cage-client';`);
+    out.push(`import { client, useCageList, useCageQuery, type TransferTask, type RequestOptions } from '@yss123/cage-client';`);
+    for (const target of new Set(relations.map(([, field]) => field.ref)))
+        if (target !== N)
+            out.push(`import { ${target}Schema, type ${target}, type ${target}ListParams } from '../${kebab(target)}';`);
     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;`);
+    const fileFields = Object.fromEntries(Object.entries(a.fields).filter(([, f]) => f.filePolicy).map(([key, f]) => [key, { ...f.filePolicy, multiple: f.kind === 'files' }]));
+    if (Object.keys(fileFields).length)
+        out.push(`/** 文件字段限制；服务端仍执行权威校验。 */\nexport const ${N}FileFields = ${JSON.stringify(fileFields)} as const;`);
     out.push('');
     out.push(`/** 命令输入：和后端命令的输入校验完全一致 */`);
     out.push(`export const ${N}Inputs = {`);
@@ -55,13 +85,13 @@ export function aggregateFile(reg, a, sites) {
     }
     out.push('');
     const fieldKeys = Object.entries(a.fields)
-        .filter(([, f]) => !f.isHidden && f.sql !== 'jsonb' && !f.sensitiveKind)
+        .filter(([, f]) => !f.isHidden && !isRelation(f) && f.sql !== 'jsonb' && !f.sensitiveKind)
         .map(([k]) => k);
     const sortKeys = [
         'createdAt',
         'updatedAt',
         ...Object.entries(a.fields)
-            .filter(([, f]) => !f.isHidden && f.sql !== 'jsonb')
+            .filter(([, f]) => !f.isHidden && !isRelation(f) && f.sql !== 'jsonb')
             .map(([k]) => k),
     ];
     out.push(`export type ${N}SortKey = ${sortKeys.map((k) => `'${k}'`).join(' | ')};`);
@@ -85,34 +115,52 @@ export function aggregateFile(reg, a, sites) {
         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),`);
+            out.push(`${desc}  ${c.name}: (input: z.input<typeof ${N}Inputs.${c.name}>, options: RequestOptions = {}) => client.post<${N}, ${E}>(${url}, input, options),`);
         }
         else if (isIdOnly(c)) {
-            out.push(`${desc}  ${c.name}: (id: string, expectedVersion?: number) => client.post<${N}, ${E}>(${url}, { expectedVersion }),`);
+            out.push(`${desc}  ${c.name}: (id: string, expectedVersion?: number, options: RequestOptions = {}) => client.post<${N}, ${E}>(${url}, { expectedVersion }, options),`);
         }
         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(`${desc}  ${c.name}: (id: string, input: Omit<z.input<typeof ${N}Inputs.${c.name}>, 'id'>, expectedVersion?: number, options: RequestOptions = {}) => client.post<${N}, ${E}>(${url}, { ...input, expectedVersion }, options),`);
         }
     }
-    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(`  /** 异步导出 CSV：返回任务，使用 client.transfer(id) 查状态，完成后下载。需要 ${N}.export 能力。 */`);
+    out.push(`  export: (params: ${N}ListParams = {}, options: RequestOptions = {}) => client.post<TransferTask, 'CONFLICT'>('/api/${kebab(N)}/export', params, options),`);
+    out.push(`  get: (id: string, options: RequestOptions = {}) => client.get<${N}>(\`/api/${kebab(N)}/\${encodeURIComponent(id)}\`, undefined, options),`);
+    out.push(`  list: (params: ${N}ListParams = {}, options: RequestOptions = {}) => client.get<{ items: ${N}[]; total: number; page: number; pageSize: number }>('/api/${kebab(N)}', params as Record<string, unknown>, options),`);
+    if (relations.length) {
+        out.push('  /** 关联对象按需分页读取；不会随主对象详情自动展开。 */', '  related: {');
+        for (const [key, field] of relations) {
+            const target = field.ref;
+            out.push(`    /** ${field.description ?? key}：同时需要 ${N}.read 和 ${target}.read。 */`);
+            out.push(`    ${key}: (id: string, params: ${target}ListParams = {}, options: RequestOptions = {}) => client.get<{ items: ${target}[]; total: number; page: number; pageSize: number }>(\`/api/${kebab(N)}/\${encodeURIComponent(id)}/relations/${kebab(key)}\`, params as Record<string, unknown>, options),`);
+        }
+        out.push('  },');
+    }
     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);`);
+    for (const [key, field] of relations) {
+        out.push(`/** ${field.description ?? key}：独立分页缓存，命令成功后使所属对象缓存失效。 */`);
+        out.push(`export const use${N}Related${upperFirst(key)} = (id: string, params: ${field.ref}ListParams = {}) => useCageList(['${kebab(N)}', id, 'relations', '${key}'], \`/api/${kebab(N)}/\${encodeURIComponent(id)}/relations/${kebab(key)}\`, params as Record<string, unknown>, ${field.ref}Schema, { enabled: !!id });`);
+    }
     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';
 }
+/**
+ * 生成所有显式查询的输入 schema、请求方法和 hooks。
+ * @param reg 已注册查询清单。
+ * @returns 源码文本；查询响应仍为通用记录数组，实际范围由服务器执行。
+ */
 export function queriesFile(reg) {
     const out = [
         HEADER,
         `import { z } from 'zod';`,
-        `import { client, useCageQuery } from '@yss123/cage-client';`,
+        `import { client, useCageQuery, type RequestOptions } from '@yss123/cage-client';`,
         '',
     ];
     out.push('/** 查询输入 */');
@@ -124,7 +172,7 @@ export function queriesFile(reg) {
     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(`  ${q.name}: (input: z.input<typeof QueryInputs.${q.name}> = {} as any, options: RequestOptions = {}) => client.get<Record<string, unknown>[]>('/api/queries/${kebab(q.name)}', input as Record<string, unknown>, options),`);
     }
     out.push('};');
     out.push('');
@@ -133,16 +181,21 @@ export function queriesFile(reg) {
     }
     return out.join('\n') + '\n';
 }
+/**
+ * 生成契约根公共入口及能力名类型、客户端转导出。
+ * @param reg 当前注册表。
+ * @returns 根 index 源码，can/useCan 仅用于前端显示，不产生授权。
+ */
 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 './aggregates/${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(`import { ${a.name}Inputs } from './aggregates/${kebab(a.name)}';`);
+    out.push(`export { client, configureClient, loadMe, currentUser, CageQueryError, CageCommandError, useTransfer, useFileUpload, FileUploadError, type FileUploadTask, type FileUploadSnapshot, type UploadSession, type FileInfo, type RequestOptions, type CageResult, type CommonError, type TransferTask, type ImportReport } from '@yss123/cage-client';`);
     out.push('');
     out.push('/** 能力目录（由代码派生）：写错能力点名会编译失败 */');
     out.push(`export const capabilities = [\n${caps.map((c) => `  '${c}',`).join('\n')}\n] as const;`);
@@ -152,15 +205,23 @@ export function indexFile(reg) {
     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('/** 各聚合的命令输入 schema：按聚合名、命令名访问，可直接供表单库校验 */');
     out.push(`export const schemas = {\n${reg.aggregates.map((a) => `  ${a.name}: ${a.name}Inputs,`).join('\n')}\n};`);
     return out.join('\n') + '\n';
 }
+/**
+ * 按稳定聚合名组织所有待生成契约，后端模块移动不改变契约公开入口。
+ * @param reg 注册表。
+ * @param sites 声明位置与业务错误码线索。
+ * @returns 相对路径到源码字符串的映射；实际写入由 generate 负责。
+ */
 export function contractsFiles(reg, sites) {
     const files = {};
+    // 路径只取稳定的聚合名，不依赖后端文件位置；移动领域模块不会改变前端公共 API。
+    // 根 index 保留统一导出，业务仍从 @app/contracts 引入，不绑定生成目录内部结构。
     for (const a of reg.aggregates)
-        files[`${kebab(a.name)}.ts`] = aggregateFile(reg, a, sites);
-    files['queries.ts'] = queriesFile(reg);
+        files[`aggregates/${kebab(a.name)}/index.ts`] = aggregateFile(reg, a, sites);
+    files['queries/index.ts'] = queriesFile(reg);
     files['index.ts'] = indexFile(reg);
     return files;
 }

package/dist/gen/contracts.js.map

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

package/dist/gen/index.d.ts

@@ -3,15 +3,41 @@ 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';
+/**
+ * 把一个聚合的迁移和资源持有标签转换为 Mermaid 状态图。
+ * @param g 当前本体。
+ * @param agg 聚合名。
+ * @returns 图源码字符串；静态标签不代表实际持有记录。
+ */
 export declare function stateDiagram(g: Ontology, agg: string): string;
+/**
+ * 生成阶段输出，written 为已写/清理路径，findings 为差异和限制，migrationDraft 可选。
+ */
 export interface GenResult {
+    /** 本次实际写入或清理的生成路径，用于命令报告。 */
     written: string[];
+    /** 生成不一致、不可完整表达的校验或迁移等诊断。 */
     findings: Finding[];
+    /** 本次计算出的迁移草稿路径，缺省表示没有草稿需要报告。 */
     migrationDraft?: string;
 }
+/**
+ * 生成契约、可再生阅读资料并比较迁移内嵌快照以产生新草稿。
+ * @param cfg 输出位置。
+ * @param reg 当前注册表。
+ * @param g 当前本体。
+ * @param sites 源码位置及业务错误码。
+ * @param opts check 只检查需提交产物，不写盘。
+ * @returns 修改清单与诊断；迁移只是草稿，不查询真实库或自动执行。
+ */
 export declare function generate(cfg: CageConfig, reg: Registry, g: Ontology, sites: DeclSite[], opts?: {
     check?: boolean;
 }): GenResult;
+/**
+ * 根据注册表列出可公开接口及所需能力说明。
+ * @param reg 当前领域与扩展声明。
+ * @returns 方法、URL 和能力文本；这是清单，不创建 HTTP 路由或替代服务端授权。
+ */
 export declare function routes(reg: Registry): {
     method: string;
     url: string;