@yss123/cage-cli 0.2.0 → 0.3.1

package/dist/gen/contracts.js

@@ -1,20 +1,31 @@
+/**
+ * 将注册表转换为浏览器可用的契约源码字符串，由 generate 统一写盘。
+ * 按聚合组织读侧 schema、用户命令方法和 hooks，再生成查询与根公共入口。
+ * 不把 domain 或运行时导入浏览器；仅开放 user 命令，客户端校验保留可表达部分，服务端始终负责权威校验与授权。
+ */
 // 前端契约（packages/contracts）：每个聚合一个目录，容纳 schema、调用方法和查询 hooks。
 // 前端只能从这里引入，所以调用方式、参数、错误码都有类型检查。
 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) => f.kind === 'manyToMany'))
+    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');
@@ -22,10 +33,20 @@ function errorUnion(c) {
         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);
@@ -33,7 +54,7 @@ export function aggregateFile(reg, a, sites) {
     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, type TransferTask } 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)}';`);
@@ -43,6 +64,9 @@ export function aggregateFile(reg, a, sites) {
     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 = {`);
@@ -91,25 +115,25 @@ 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：返回任务，使用 client.transfer(id) 查状态，完成后下载。需要 ${N}.export 能力。 */`);
-    out.push(`  export: (params: ${N}ListParams = {}, options: { idempotencyKey?: string } = {}) => client.post<TransferTask, 'CONFLICT'>('/api/${kebab(N)}/export', params, options),`);
-    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(`  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 = {}) => client.get<{ items: ${target}[]; total: number; page: number; pageSize: number }>(\`/api/${kebab(N)}/\${encodeURIComponent(id)}/relations/${kebab(key)}\`, params as Record<string, unknown>),`);
+            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('  },');
     }
@@ -127,11 +151,16 @@ export function aggregateFile(reg, a, sites) {
     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('/** 查询输入 */');
@@ -143,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('');
@@ -152,6 +181,11 @@ 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];
@@ -161,7 +195,7 @@ export function indexFile(reg) {
     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 './aggregates/${kebab(a.name)}';`);
-    out.push(`export { client, configureClient, loadMe, currentUser, CageQueryError, useTransfer, type CageResult, type CommonError, type TransferTask, type ImportReport } from '@yss123/cage-client';`);
+    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;`);
@@ -175,6 +209,12 @@ export function indexFile(reg) {
     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。

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;

package/dist/gen/index.js

@@ -1,3 +1,8 @@
+/**
+ * 声明生成器的写盘协调层，生成契约、阅读资料以及待审查迁移草稿。
+ * 先收集 schema 表达限制，再更新可再生资料、清理带生成器签名的旧契约，最后比较迁移内嵌结构快照。
+ * check 模式只比较需提交的结果，不写文件；不会连接真实库扫描漂移，也不会执行迁移或改写已执行迁移。
+ */
 // cage gen：从声明生成 contracts、路由清单、安全视图与策略 DDL、迁移草稿、状态图、本体图。
 import { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from 'node:fs';
 import { dirname, join, relative } from 'node:path';
@@ -6,6 +11,14 @@ import { createTableSql, diffSchemas, embedSnapshot, latestSnapshot, readMigrati
 import { abs } from '../config.js';
 import { statesHoldingResources } from '../rules.js';
 import { contractsFiles } from './contracts.js';
+import { runtimeOntology } from '@yss123/cage-ontology';
+import { schemaDiagnostics } from './zod-code.js';
+/**
+ * 把一个聚合的迁移和资源持有标签转换为 Mermaid 状态图。
+ * @param g 当前本体。
+ * @param agg 聚合名。
+ * @returns 图源码字符串；静态标签不代表实际持有记录。
+ */
 export function stateDiagram(g, agg) {
     const lines = ['stateDiagram-v2'];
     const states = g.nodes.filter((n) => n.kind === 'state' && n.id.startsWith(`${agg}.`));
@@ -22,6 +35,15 @@ export function stateDiagram(g, agg) {
     }
     return lines.join('\n') + '\n';
 }
+/**
+ * 仅内容有差异时写入文件，check 模式改为记录诊断。
+ * @param path 目标文件路径。
+ * @param content 期望文本。
+ * @param check 是否只比较。
+ * @param written 累积实际修改路径。
+ * @param findings 累积差异诊断。
+ * @param code 差异错误码，默认契约不一致。
+ */
 function writeIf(path, content, check, written, findings, code = 'CAGE-GEN-001') {
     const cur = existsSync(path) ? readFileSync(path, 'utf8') : null;
     if (cur === content)
@@ -44,6 +66,10 @@ function writeIf(path, content, check, written, findings, code = 'CAGE-GEN-001')
  * 只清理由生成器签名标记的文件；用户自己添加的代码不属于生成器的删除范围。
  * check 仅报告，不写文件，因此 CI 不会悄悄“修正”待审查的工作区。
  */
+/**
+ * 递归识别旧契约，只清理带本生成器签名且不在期望集合内的文件。
+ * check 模式仅报告；不删除用户手写文件，不递归清空整个契约目录。
+ */
 function removeStaleContracts(root, expected, check, written, findings) {
     if (!existsSync(root))
         return;
@@ -71,11 +97,26 @@ function removeStaleContracts(root, expected, check, written, findings) {
     };
     visit(root);
 }
+/**
+ * 生成契约、可再生阅读资料并比较迁移内嵌快照以产生新草稿。
+ * @param cfg 输出位置。
+ * @param reg 当前注册表。
+ * @param g 当前本体。
+ * @param sites 源码位置及业务错误码。
+ * @param opts check 只检查需提交产物，不写盘。
+ * @returns 修改清单与诊断；迁移只是草稿，不查询真实库或自动执行。
+ */
 export function generate(cfg, reg, g, sites, opts = {}) {
     const check = !!opts.check;
     const written = [];
     const findings = [];
     const gen = abs(cfg, cfg.generated);
+    for (const entry of [...reg.commands.map(c => ({ name: c.capability, input: c.cmd.input })), ...reg.queries.map(q => ({ name: q.name, input: q.input }))])
+        for (const diagnostic of schemaDiagnostics(entry.input))
+            findings.push({
+                code: 'CAGE-GEN-003', severity: 'warning', at: `${entry.name}:${diagnostic.path}`,
+                reason: diagnostic.reason, fix: '前端校验只提供即时提示，以服务端命令校验为准；不要复制可执行函数到契约。',
+            });
     // 不入库的生成物：直接覆盖（check 模式不比较）
     if (!check) {
         const put = (rel, content) => {
@@ -90,6 +131,7 @@ export function generate(cfg, reg, g, sites, opts = {}) {
         put('sql/schema.sql', `-- 生成物：期望的表结构（不要手改）\n\n${model.tables.map(createTableSql).join('\n\n')}\n`);
         put('sql/safe-layer.sql', `-- 生成物：安全层（函数、行级策略、安全视图），cage migrate 每次整体重建\n${safeLayerSql(reg)}\n`);
         put('capabilities.json', JSON.stringify(reg.capabilityCatalog(), null, 2));
+        put('ai/ontology.json', JSON.stringify(runtimeOntology(reg), null, 2));
         put('routes.json', JSON.stringify(routes(reg), null, 2));
         const md = ['# 状态图（生成物）', ''];
         for (const a of reg.aggregates) {
@@ -136,8 +178,22 @@ export function generate(cfg, reg, g, sites, opts = {}) {
     }
     return { written, findings, migrationDraft };
 }
+/**
+ * 根据注册表列出可公开接口及所需能力说明。
+ * @param reg 当前领域与扩展声明。
+ * @returns 方法、URL 和能力文本；这是清单，不创建 HTTP 路由或替代服务端授权。
+ */
 export function routes(reg) {
-    const out = [];
+    const out = [
+        { method: 'POST', url: '/api/sys/uploads', capability: '目标用户命令能力及字段限制' },
+        { method: 'GET', url: '/api/sys/uploads', capability: '本人会话及目标命令能力' },
+        { method: 'GET', url: '/api/sys/uploads/:id', capability: '本人会话及目标命令能力' },
+        { method: 'POST', url: '/api/sys/uploads/:id/parts/:number', capability: '本人会话及目标命令能力' },
+        { method: 'POST', url: '/api/sys/uploads/:id/complete', capability: '本人会话及目标命令能力' },
+        { method: 'POST', url: '/api/sys/uploads/:id/cancel', capability: '本人会话及目标命令能力' },
+        { method: 'GET', url: '/api/sys/files/:id', capability: '所属对象 read/范围；临时文件限本人' },
+        { method: 'GET', url: '/api/sys/files/:id/download', capability: '所属对象 read/范围；临时文件限本人' },
+    ];
     for (const c of reg.commands) {
         if (!c.cmd.invokedBy.includes('user'))
             continue;
@@ -172,6 +228,18 @@ export function routes(reg) {
                 url: `/hooks/${e.value.connector.name}/${kebab(e.value.event)}`,
                 capability: `验签 ${e.value.verify.secret}`,
             });
+    if (reg.extensions.some(e => e.kind === 'RUNTIME' && e.value.name === 'ai')) {
+        for (const [method, url] of [['GET', '/api/ai/sessions'], ['POST', '/api/ai/sessions'], ['GET', '/api/ai/sessions/:id/runs'],
+            ['POST', '/api/ai/sessions/:id/messages'], ['GET', '/api/ai/runs/:id'], ['GET', '/api/ai/runs/:id/events'],
+            ['POST', '/api/ai/runs/:id/cancel'], ['POST', '/api/ai/runs/:id/interactions/:interactionId'], ['GET', '/api/ai/memory'], ['DELETE', '/api/ai/memory/:id'],
+            ['GET', '/api/ai/personalities'], ['POST', '/api/ai/sessions/:id/personality']])
+            out.push({ method, url, capability: 'Sys.ai.use' });
+        for (const [method, url] of [['GET', '/api/ai/admin/models'], ['POST', '/api/ai/admin/models/:key'], ['POST', '/api/ai/admin/models/:key/test']])
+            out.push({ method, url, capability: 'Sys.ai.models.manage' });
+        for (const [method, url] of [['GET', '/api/ai/admin/personalities'], ['POST', '/api/ai/admin/personalities/:key'],
+            ['POST', '/api/ai/admin/assistant-settings'], ['POST', '/api/ai/admin/personality-preview']])
+            out.push({ method, url, capability: 'Sys.ai.personalities.manage' });
+    }
     return out;
 }
 //# sourceMappingURL=index.js.map

package/dist/gen/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gen/index.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,KAAK,EAA8B,MAAM,qBAAqB,CAAC;AACpF,OAAO,EACL,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,EACd,cAAc,EACd,YAAY,EACZ,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,GAAG,EAAmB,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAGrD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,UAAU,YAAY,CAAC,CAAW,EAAE,GAAW;IACnD,MAAM,KAAK,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;IACvF,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;QAC7F,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,GAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,MAAM;QAAE,IAAI,CAAC,CAAC,KAAK,CAAC,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;IACrF,KAAK,MAAM,CAAC,IAAI,sBAAsB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;QACvF,KAAK,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC;AAQD,SAAS,OAAO,CACd,IAAY,EACZ,OAAe,EACf,KAAc,EACd,OAAiB,EACjB,QAAmB,EACnB,IAAI,GAAG,cAAc;IAErB,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,IAAI,GAAG,KAAK,OAAO;QAAE,OAAO;IAC5B,IAAI,KAAK,EAAE,CAAC;QACV,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI;YACJ,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,iCAAiC;YACzC,GAAG,EAAE,qBAAqB;SAC3B,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,SAAS,oBAAoB,CAC3B,IAAY,EACZ,QAAgC,EAChC,KAAc,EACd,OAAiB,EACjB,QAAmB;IAEnB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO;IAC9B,MAAM,KAAK,GAAG,CAAC,SAAiB,EAAE,EAAE;QAClC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,KAAK,CAAC,WAAW,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC;iBAChC,IACH,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAC1B,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,QAAQ,CAAC;gBACvD,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,uCAAuC,CAAC,EAC9E,CAAC;gBACD,IAAI,KAAK;oBACP,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,cAAc;wBACpB,EAAE,EAAE,IAAI;wBACR,MAAM,EAAE,6BAA6B;wBACrC,GAAG,EAAE,6BAA6B;qBACnC,CAAC,CAAC;qBACA,CAAC;oBACJ,UAAU,CAAC,IAAI,CAAC,CAAC;oBACjB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,GAAe,EACf,GAAa,EACb,CAAW,EACX,KAAiB,EACjB,OAA4B,EAAE;IAE9B,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IAEpC,4BAA4B;IAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,OAAe,EAAE,EAAE;YAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACzB,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3C,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,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,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3E,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC/B,GAAG,CACD,gBAAgB,EAChB,0BAA0B,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAC5E,CAAC;QACF,GAAG,CACD,oBAAoB,EACpB,iDAAiD,YAAY,CAAC,GAAG,CAAC,IAAI,CACvE,CAAC;QACF,GAAG,CAAC,mBAAmB,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3E,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,EAAE,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YAClC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC;YACjC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAChG,CAAC;QACD,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,cAAc;IACd,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzC,oBAAoB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/E,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAElF,iCAAiC;IACjC,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,WAAW,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7D,IAAI,cAAkC,CAAC;IACvC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,IAAI,KAAK,EAAE,CAAC;YACV,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,cAAc;gBACpB,EAAE,EAAE,GAAG,CAAC,UAAU;gBAClB,MAAM,EAAE,gBAAgB,KAAK,CAAC,MAAM,OAAO;gBAC3C,GAAG,EAAE,0BAA0B;aAChC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACzD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC;YACtE,MAAM,IAAI,GAAG;gBACX,wCAAwC;gBACxC,wBAAwB;gBACxB,EAAE;gBACF,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;aACnB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACjC,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;YAC1D,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAa;IAClC,MAAM,GAAG,GAA0D,EAAE,CAAC;IACtE,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,SAAS;QAChD,MAAM,IAAI,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,IAAI,CAAC;YACP,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,QAAQ,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE;YACvF,UAAU,EAAE,CAAC,CAAC,UAAU;SACzB,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,GAAG,CAAC,IAAI,CACN,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,OAAO,EAAE,EAC1D,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,OAAO,EAAE,EACnE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,SAAS,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,SAAS,EAAE,CAC1E,CAAC;QACF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAgB,CAAC;YAC3D,IAAI,UAAU,CAAC,KAAK,CAAC;gBACnB,GAAG,CAAC,IAAI,CAAC;oBACP,MAAM,EAAE,KAAK;oBACb,GAAG,EAAE,GAAG,IAAI,kBAAkB,KAAK,CAAC,GAAG,CAAC,EAAE;oBAC1C,UAAU,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,EAAE,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;iBAC5E,CAAC,CAAC;IACT,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO;QACzB,GAAG,CAAC,IAAI,CAAC;YACP,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,gBAAgB,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE;YACpC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;SAC7D,CAAC,CAAC;IACL,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,UAAU;QAC5B,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;YACtB,GAAG,CAAC,IAAI,CAAC;gBACP,MAAM,EAAE,MAAM;gBACd,GAAG,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;gBAC/D,UAAU,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE;aAC1C,CAAC,CAAC;IACP,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gen/index.ts"],"names":[],"mappings":"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"}

package/dist/gen/zod-code.d.ts

@@ -1,7 +1,49 @@
+/**
+ * 把后端输入和字段定义转换为契约中的 Zod 源码，并报告无法完整迁移到浏览器的规则。
+ * 先借助 JSON Schema 表达结构，再重建可支持的约束；递归、refine、transform 等保留明确边界。
+ * 这里只返回代码字符串和诊断，不运行生成代码；客户端校验不能替代服务端，掩码及可空读值按读侧语义处理。
+ */
 import { type AnyField, type Fields } from '@yss123/cage-kernel';
 import { z } from 'zod';
+/**
+ * 输入规则不能无损进入契约时的字段路径与原因，供生成器报告服务端校验边界。
+ */
+export interface SchemaDiagnostic {
+    path: string; /** 不能完整序列化或需要服务端校验的具体原因。 */
+    reason: string;
+}
+/** Inspect the original schema: JSON Schema intentionally cannot retain executable refinements. */
+/**
+ * 递归检查原始 Zod 结构中的可执行转换、校验及循环。
+ * @param schema 原始输入 schema。
+ * @param path 诊断起始路径，默认 $。
+ * @returns 服务端专属规则列表；祖先集合防止递归无限展开，不运行校验函数。
+ */
+export declare function schemaDiagnostics(schema: z.ZodType, path?: string): SchemaDiagnostic[];
+/**
+ * 把 Zod 输入转成可表达的客户端代码，对转换/带 flags 正则避免生成比服务器更严格的规则。
+ * @param schema 后端输入 schema。
+ * @returns Zod 源码表达式；不可转换的结构抛 CAGE-GEN-003，服务端仍权威。
+ */
 export declare function zodCodeOf(schema: z.ZodType): string;
+/**
+ * 带递归保护地转换 JSON Schema，并保留有 default 属性的默认值。
+ * @param s 当前 JSON Schema 节点。
+ * @param root 本地 $ref 的根。
+ * @returns Zod 表达式；递归继续部分放宽为 unknown 并标注，finally 清除当前活动节点。
+ */
 export declare function jsonToZod(s: any, root: any): string;
 /** 读侧快照的字段 schema：敏感字段返回的是掩码值，所以只校验为字符串 */
+/**
+ * 根据聚合字段生成读侧 schema，敏感字段按掩码字符串处理。
+ * @param f 字段定义。
+ * @returns Zod 源码；可选字段同时接受 null 和 undefined，不复制服务端业务约束。
+ */
 export declare function fieldReadCode(f: AnyField): string;
+/**
+ * 生成聚合读快照 schema，附 ID、状态、版本与时间系统列。
+ * @param fields 聚合字段，隐藏字段和虚拟关系不内嵌。
+ * @param states 允许状态列表。
+ * @returns 对象 schema 源码；关联通过独立分页接口读取。
+ */
 export declare function snapshotCode(fields: Fields, states: readonly string[]): string;