@yss123/cage-cli 0.0.0-stage → 0.2.0

package/dist/gen/contracts.js

@@ -0,0 +1,188 @@
+// 前端契约（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';
+function commandUrlExpr(c) {
+    const base = `/api/${kebab(c.cmd.agg.name)}`;
+    return c.cmd.from === 'new'
+        ? `'${base}/${kebab(c.name)}'`
+        : `\`${base}/\${encodeURIComponent(id)}/${kebab(c.name)}\``;
+}
+function errorUnion(c) {
+    const codes = new Set(['FORBIDDEN', 'INVALID_INPUT', 'DOMAIN_ERROR', 'CONFLICT']);
+    if (c.cmd.from !== 'new')
+        ['NOT_FOUND', 'INVALID_TRANSITION'].forEach((x) => codes.add(x));
+    if (Object.values(c.cmd.agg.fields).some((f) => f.kind === 'manyToMany'))
+        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();
+}
+function isIdOnly(c) {
+    const s = c.cmd.input;
+    return s instanceof z.ZodObject && Object.keys(s.shape).length === 1 && 'id' in s.shape;
+}
+export function aggregateFile(reg, a, sites) {
+    const N = a.name;
+    const m = lowerFirst(N);
+    const cmds = reg.commands.filter((c) => c.cmd.agg === a && c.cmd.invokedBy.includes('user'));
+    const 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';`);
+    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;`);
+    out.push('');
+    out.push(`/** 命令输入：和后端命令的输入校验完全一致 */`);
+    out.push(`export const ${N}Inputs = {`);
+    for (const c of cmds)
+        out.push(`  ${c.name}: ${zodCodeOf(c.cmd.input)},`);
+    out.push('};');
+    out.push('');
+    for (const c of cmds) {
+        const site = sites.find((s) => s.exportName === c.exportName);
+        out.push(`/** ${c.capability} 可能返回的错误码${site?.domainCodes.length ? `；业务码（domainCode）：${site.domainCodes.join('、')}` : ''} */`);
+        out.push(`export type ${N}${upperFirst(c.name)}Error = ${errorUnion(c)
+            .map((x) => `'${x}'`)
+            .join(' | ')};`);
+        if (site?.domainCodes.length)
+            out.push(`export type ${N}${upperFirst(c.name)}DomainCode = ${site.domainCodes.map((x) => `'${x}'`).join(' | ')};`);
+    }
+    out.push('');
+    const fieldKeys = Object.entries(a.fields)
+        .filter(([, f]) => !f.isHidden && !isRelation(f) && f.sql !== 'jsonb' && !f.sensitiveKind)
+        .map(([k]) => k);
+    const sortKeys = [
+        'createdAt',
+        'updatedAt',
+        ...Object.entries(a.fields)
+            .filter(([, f]) => !f.isHidden && !isRelation(f) && f.sql !== 'jsonb')
+            .map(([k]) => k),
+    ];
+    out.push(`export type ${N}SortKey = ${sortKeys.map((k) => `'${k}'`).join(' | ')};`);
+    out.push(`export interface ${N}ListParams {`);
+    out.push('  page?: number;');
+    out.push('  pageSize?: number;');
+    out.push(`  /** 排序：字段名，前面加 - 表示倒序 */`);
+    out.push(`  sort?: ${N}SortKey | \`-\${${N}SortKey}\`;`);
+    out.push(`  /** 可以逗号分隔多个状态 */`);
+    out.push('  status?: string;');
+    out.push('  createdAfter?: string;');
+    out.push('  createdBefore?: string;');
+    for (const k of fieldKeys)
+        out.push(`  ${k}?: string | number | boolean;`);
+    out.push('}');
+    out.push('');
+    out.push(`/** 调用方法：每个命令一个；client 自动生成并附带幂等键和 CSRF 令牌 */`);
+    out.push(`export const ${m} = {`);
+    for (const c of cmds) {
+        const E = `${N}${upperFirst(c.name)}Error`;
+        const url = commandUrlExpr(c);
+        const desc = c.cmd.description ? `  /** ${c.cmd.description} */\n` : '';
+        if (c.cmd.from === 'new') {
+            out.push(`${desc}  ${c.name}: (input: z.input<typeof ${N}Inputs.${c.name}>) => client.post<${N}, ${E}>(${url}, input),`);
+        }
+        else if (isIdOnly(c)) {
+            out.push(`${desc}  ${c.name}: (id: string, expectedVersion?: number) => client.post<${N}, ${E}>(${url}, { expectedVersion }),`);
+        }
+        else {
+            out.push(`${desc}  ${c.name}: (id: string, input: Omit<z.input<typeof ${N}Inputs.${c.name}>, 'id'>, expectedVersion?: number) => client.post<${N}, ${E}>(${url}, { ...input, expectedVersion }),`);
+        }
+    }
+    out.push(`  /** 异步导出 CSV：返回任务，使用 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>),`);
+    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('  },');
+    }
+    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';
+}
+export function queriesFile(reg) {
+    const out = [
+        HEADER,
+        `import { z } from 'zod';`,
+        `import { client, useCageQuery } from '@yss123/cage-client';`,
+        '',
+    ];
+    out.push('/** 查询输入 */');
+    out.push('export const QueryInputs = {');
+    for (const q of reg.queries)
+        out.push(`  ${q.name}: ${zodCodeOf(q.input)},`);
+    out.push('};');
+    out.push('');
+    out.push('export const queries = {');
+    for (const q of reg.queries) {
+        out.push(`  /** ${q.description ?? q.name}（需要 ${q.reads.map((r) => `${r.name}.read`).join('、')}） */`);
+        out.push(`  ${q.name}: (input: z.input<typeof QueryInputs.${q.name}> = {} as any) => client.get<Record<string, unknown>[]>('/api/queries/${kebab(q.name)}', input as Record<string, unknown>),`);
+    }
+    out.push('};');
+    out.push('');
+    for (const q of reg.queries) {
+        out.push(`export const use${upperFirst(q.name)} = (input: z.input<typeof QueryInputs.${q.name}> = {} as any) => useCageQuery<Record<string, unknown>[]>(['query', '${q.name}'], '/api/queries/${kebab(q.name)}', undefined, { query: input as Record<string, unknown> });`);
+    }
+    return out.join('\n') + '\n';
+}
+export function indexFile(reg) {
+    const caps = reg.capabilityCatalog().map((c) => c.capability);
+    const out = [HEADER];
+    for (const a of reg.aggregates)
+        out.push(`export * from './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 './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('');
+    out.push('/** 能力目录（由代码派生）：写错能力点名会编译失败 */');
+    out.push(`export const capabilities = [\n${caps.map((c) => `  '${c}',`).join('\n')}\n] as const;`);
+    out.push('export type Capability = (typeof capabilities)[number];');
+    out.push('');
+    out.push('/** 当前用户有没有某个能力点。只影响界面显示：绕过前端直接调接口，内核一样会拒绝 */');
+    out.push('export const can = (capability: Capability): boolean => baseCan(capability);');
+    out.push('export const useCan = (capability: Capability): boolean => baseUseCan(capability);');
+    out.push('');
+    out.push('/** 各聚合的命令输入 schema：按聚合名、命令名访问，可直接供表单库校验 */');
+    out.push(`export const schemas = {\n${reg.aggregates.map((a) => `  ${a.name}: ${a.name}Inputs,`).join('\n')}\n};`);
+    return out.join('\n') + '\n';
+}
+export function contractsFiles(reg, sites) {
+    const files = {};
+    // 路径只取稳定的聚合名，不依赖后端文件位置；移动领域模块不会改变前端公共 API。
+    // 根 index 保留统一导出，业务仍从 @app/contracts 引入，不绑定生成目录内部结构。
+    for (const a of reg.aggregates)
+        files[`aggregates/${kebab(a.name)}/index.ts`] = aggregateFile(reg, a, sites);
+    files['queries/index.ts'] = queriesFile(reg);
+    files['index.ts'] = indexFile(reg);
+    return files;
+}
+//# sourceMappingURL=contracts.js.map

package/dist/gen/contracts.js.map

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

package/dist/gen/index.d.ts

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

package/dist/gen/index.js

@@ -0,0 +1,177 @@
+// cage gen：从声明生成 contracts、路由清单、安全视图与策略 DDL、迁移草稿、状态图、本体图。
+import { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from 'node:fs';
+import { dirname, join, relative } from 'node:path';
+import { isRelation, kebab } from '@yss123/cage-kernel';
+import { createTableSql, diffSchemas, embedSnapshot, latestSnapshot, readMigrations, safeLayerSql, schemaModel, } from '@yss123/cage-kernel/db';
+import { abs } from '../config.js';
+import { statesHoldingResources } from '../rules.js';
+import { contractsFiles } from './contracts.js';
+export function stateDiagram(g, agg) {
+    const lines = ['stateDiagram-v2'];
+    const states = g.nodes.filter((n) => n.kind === 'state' && n.id.startsWith(`${agg}.`));
+    const short = (id) => id.slice(agg.length + 1);
+    for (const t of g.edges.filter((e) => e.kind === 'transition' && e.to.startsWith(`${agg}.`))) {
+        const from = t.from.endsWith('.[new]') ? '[*]' : short(t.from);
+        lines.push(`  ${from} --> ${short(t.to)} : ${t.via.slice(agg.length + 1)}`);
+    }
+    for (const s of states)
+        if (s.attrs.terminal)
+            lines.push(`  ${short(s.id)} --> [*]`);
+    for (const h of statesHoldingResources(g).filter((x) => x.state.startsWith(`${agg}.`))) {
+        lines.push(`  note right of ${short(h.state)} : 持有 ${h.resource}`);
+    }
+    return lines.join('\n') + '\n';
+}
+function writeIf(path, content, check, written, findings, code = 'CAGE-GEN-001') {
+    const cur = existsSync(path) ? readFileSync(path, 'utf8') : null;
+    if (cur === content)
+        return;
+    if (check) {
+        findings.push({
+            code,
+            at: path,
+            reason: '生成物和声明不一致（有人手改了生成物，或声明改了没有重新生成）',
+            fix: '运行 cage gen，并提交生成结果',
+        });
+        return;
+    }
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, content);
+    written.push(path);
+}
+/**
+ * 升级目录布局或删除聚合后，旧契约不能继续留在包里参与编译和导出。
+ * 只清理由生成器签名标记的文件；用户自己添加的代码不属于生成器的删除范围。
+ * check 仅报告，不写文件，因此 CI 不会悄悄“修正”待审查的工作区。
+ */
+function removeStaleContracts(root, expected, check, written, findings) {
+    if (!existsSync(root))
+        return;
+    const visit = (directory) => {
+        for (const entry of readdirSync(directory, { withFileTypes: true })) {
+            const path = join(directory, entry.name);
+            if (entry.isDirectory())
+                visit(path);
+            else if (entry.name.endsWith('.ts') &&
+                !(relative(root, path).replace(/\\/g, '/') in expected) &&
+                readFileSync(path, 'utf8').startsWith('// 生成物：由 cage gen 从 domain 声明生成，不要手改。')) {
+                if (check)
+                    findings.push({
+                        code: 'CAGE-GEN-001',
+                        at: path,
+                        reason: '存在已过期的生成契约（聚合已删除或生成目录布局已更新）',
+                        fix: '运行 cage gen 清理旧生成文件，并提交目录变更',
+                    });
+                else {
+                    unlinkSync(path);
+                    written.push(path);
+                }
+            }
+        }
+    };
+    visit(root);
+}
+export function generate(cfg, reg, g, sites, opts = {}) {
+    const check = !!opts.check;
+    const written = [];
+    const findings = [];
+    const gen = abs(cfg, cfg.generated);
+    // 不入库的生成物：直接覆盖（check 模式不比较）
+    if (!check) {
+        const put = (rel, content) => {
+            const p = join(gen, rel);
+            mkdirSync(dirname(p), { recursive: true });
+            writeFileSync(p, content);
+            written.push(p);
+        };
+        mkdirSync(abs(cfg, '.cage'), { recursive: true });
+        writeFileSync(abs(cfg, '.cage/ontology.json'), JSON.stringify(g, null, 2));
+        const model = schemaModel(reg);
+        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('routes.json', JSON.stringify(routes(reg), null, 2));
+        const md = ['# 状态图（生成物）', ''];
+        for (const a of reg.aggregates) {
+            const d = stateDiagram(g, a.name);
+            put(`diagrams/${a.name}.mmd`, d);
+            md.push(`## ${a.description ?? a.name}（${a.name}）`, '', '```mermaid', d.trimEnd(), '```', '');
+        }
+        put('diagrams/README.md', md.join('\n'));
+    }
+    // 入库的生成物：前端契约
+    const files = contractsFiles(reg, sites);
+    removeStaleContracts(abs(cfg, cfg.contracts), files, check, written, findings);
+    for (const [name, content] of Object.entries(files))
+        writeIf(join(abs(cfg, cfg.contracts), name), content, check, written, findings);
+    // 迁移草稿：声明的期望结构 vs 最后一个迁移里内嵌的结构快照
+    const dir = abs(cfg, cfg.migrations);
+    const migrations = readMigrations(dir);
+    const model = schemaModel(reg);
+    const stmts = diffSchemas(latestSnapshot(migrations), model);
+    let migrationDraft;
+    if (stmts.length > 0) {
+        if (check) {
+            findings.push({
+                code: 'CAGE-GEN-002',
+                at: cfg.migrations,
+                reason: `声明的表结构与迁移不一致（${stmts.length} 处变化）`,
+                fix: '运行 cage gen 生成迁移草稿，人审后提交',
+            });
+        }
+        else {
+            const n = String(migrations.length + 1).padStart(4, '0');
+            const name = `${n}_${migrations.length === 0 ? 'init' : 'draft'}.sql`;
+            const body = [
+                `-- 迁移草稿：由 cage gen 生成，人审后提交；已发布的迁移不要修改`,
+                `-- 破坏性变更按「先扩展再收缩」分多次发布`,
+                '',
+                stmts.join('\n\n'),
+            ].join('\n');
+            mkdirSync(dir, { recursive: true });
+            migrationDraft = join(dir, name);
+            writeFileSync(migrationDraft, embedSnapshot(body, model));
+            written.push(migrationDraft);
+        }
+    }
+    return { written, findings, migrationDraft };
+}
+export function routes(reg) {
+    const out = [];
+    for (const c of reg.commands) {
+        if (!c.cmd.invokedBy.includes('user'))
+            continue;
+        const base = `/api/${kebab(c.cmd.agg.name)}`;
+        out.push({
+            method: 'POST',
+            url: c.cmd.from === 'new' ? `${base}/${kebab(c.name)}` : `${base}/:id/${kebab(c.name)}`,
+            capability: c.capability,
+        });
+    }
+    for (const a of reg.aggregates) {
+        const base = `/api/${kebab(a.name)}`;
+        out.push({ method: 'GET', url: base, capability: `${a.name}.read` }, { method: 'GET', url: `${base}/:id`, capability: `${a.name}.read` }, { method: 'POST', url: `${base}/export`, capability: `${a.name}.export` });
+        for (const [key, field] of Object.entries(a.fields))
+            if (isRelation(field))
+                out.push({
+                    method: 'GET',
+                    url: `${base}/:id/relations/${kebab(key)}`,
+                    capability: [...new Set([`${a.name}.read`, `${field.ref}.read`])].join(','),
+                });
+    }
+    for (const q of reg.queries)
+        out.push({
+            method: 'GET',
+            url: `/api/queries/${kebab(q.name)}`,
+            capability: q.reads.map((r) => `${r.name}.read`).join(' + '),
+        });
+    for (const e of reg.extensions)
+        if (e.kind === 'INBOUND')
+            out.push({
+                method: 'POST',
+                url: `/hooks/${e.value.connector.name}/${kebab(e.value.event)}`,
+                capability: `验签 ${e.value.verify.secret}`,
+            });
+    return out;
+}
+//# sourceMappingURL=index.js.map

package/dist/gen/index.js.map

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

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

@@ -0,0 +1,7 @@
+import { type AnyField, type Fields } from '@yss123/cage-kernel';
+import { z } from 'zod';
+export declare function zodCodeOf(schema: z.ZodType): string;
+export declare function jsonToZod(s: any, root: any): string;
+/** 读侧快照的字段 schema：敏感字段返回的是掩码值，所以只校验为字符串 */
+export declare function fieldReadCode(f: AnyField): string;
+export declare function snapshotCode(fields: Fields, states: readonly string[]): string;

package/dist/gen/zod-code.js

@@ -0,0 +1,163 @@
+// 把 Zod schema（经 JSON Schema 中转）或字段声明翻译成 Zod 源码，写进前端契约。前后端校验规则因此永远一致。
+import { isRelation } from '@yss123/cage-kernel';
+import { z } from 'zod';
+const str = (s) => JSON.stringify(s);
+export function zodCodeOf(schema) {
+    let js;
+    try {
+        js = z.toJSONSchema(schema, { unrepresentable: 'any', io: 'input' });
+    }
+    catch {
+        return 'z.unknown()';
+    }
+    return jsonToZod(js, js);
+}
+function withChecks(base, s) {
+    let out = base;
+    if (s.type === 'string' || base.startsWith('z.string')) {
+        if (typeof s.minLength === 'number')
+            out += `.min(${s.minLength})`;
+        if (typeof s.maxLength === 'number')
+            out += `.max(${s.maxLength})`;
+        if (typeof s.pattern === 'string' && !s.format)
+            out += `.regex(new RegExp(${str(s.pattern)}))`;
+    }
+    if (s.type === 'number' || s.type === 'integer') {
+        if (typeof s.minimum === 'number')
+            out += `.min(${s.minimum})`;
+        if (typeof s.maximum === 'number')
+            out += `.max(${s.maximum})`;
+        if (typeof s.exclusiveMinimum === 'number')
+            out += `.gt(${s.exclusiveMinimum})`;
+        if (typeof s.exclusiveMaximum === 'number')
+            out += `.lt(${s.exclusiveMaximum})`;
+    }
+    if (s.type === 'array') {
+        if (typeof s.minItems === 'number')
+            out += `.min(${s.minItems})`;
+        if (typeof s.maxItems === 'number')
+            out += `.max(${s.maxItems})`;
+    }
+    return out;
+}
+export function jsonToZod(s, root) {
+    if (!s || typeof s !== 'object' || Object.keys(s).length === 0)
+        return 'z.unknown()';
+    if (s.$ref) {
+        const name = String(s.$ref).split('/').pop();
+        const def = root.$defs?.[name] ?? root.definitions?.[name];
+        return def ? jsonToZod(def, root) : 'z.unknown()';
+    }
+    if (s.const !== undefined)
+        return `z.literal(${JSON.stringify(s.const)})`;
+    if (Array.isArray(s.enum)) {
+        if (s.enum.every((v) => typeof v === 'string'))
+            return `z.enum([${s.enum.map(str).join(', ')}])`;
+        return `z.union([${s.enum.map((v) => `z.literal(${JSON.stringify(v)})`).join(', ')}])`;
+    }
+    const variants = s.anyOf ?? s.oneOf;
+    if (Array.isArray(variants)) {
+        const nonNull = variants.filter((v) => v.type !== 'null');
+        const nullable = nonNull.length !== variants.length;
+        const inner = nonNull.length === 1
+            ? jsonToZod(nonNull[0], root)
+            : `z.union([${nonNull.map((v) => jsonToZod(v, root)).join(', ')}])`;
+        return nullable ? `${inner}.nullable()` : inner;
+    }
+    if (Array.isArray(s.type)) {
+        const nonNull = s.type.filter((t) => t !== 'null');
+        const inner = nonNull.length === 1 ? jsonToZod({ ...s, type: nonNull[0] }, root) : 'z.unknown()';
+        return s.type.includes('null') ? `${inner}.nullable()` : inner;
+    }
+    switch (s.type) {
+        case 'string': {
+            if (s.format === 'uuid')
+                return 'z.string().uuid()';
+            if (s.format === 'email')
+                return withChecks('z.string().email()', { ...s, pattern: undefined });
+            if (s.format === 'date-time')
+                return 'z.string().datetime({ offset: true })';
+            return withChecks('z.string()', s);
+        }
+        case 'integer':
+            return withChecks('z.number().int()', s);
+        case 'number':
+            return withChecks('z.number()', s);
+        case 'boolean':
+            return 'z.boolean()';
+        case 'null':
+            return 'z.null()';
+        case 'array':
+            return withChecks(`z.array(${jsonToZod(s.items ?? {}, root)})`, s);
+        case 'object': {
+            const props = Object.entries(s.properties ?? {});
+            if (props.length === 0 && s.additionalProperties && typeof s.additionalProperties === 'object') {
+                return `z.record(z.string(), ${jsonToZod(s.additionalProperties, root)})`;
+            }
+            if (props.length === 0)
+                return 'z.record(z.string(), z.unknown())';
+            const req = new Set(s.required ?? []);
+            const body = props
+                .map(([k, v]) => `${/^[A-Za-z_$][\w$]*$/.test(k) ? k : str(k)}: ${jsonToZod(v, root)}${req.has(k) ? '' : '.optional()'}`)
+                .join(', ');
+            return `z.object({ ${body} })`;
+        }
+        default:
+            return 'z.unknown()';
+    }
+}
+/** 读侧快照的字段 schema：敏感字段返回的是掩码值，所以只校验为字符串 */
+export function fieldReadCode(f) {
+    let base;
+    if (f.sensitiveKind)
+        base = 'z.string()';
+    else {
+        switch (f.kind) {
+            case 'int':
+                base = 'z.number().int()';
+                break;
+            case 'number':
+                base = 'z.number()';
+                break;
+            case 'bool':
+                base = 'z.boolean()';
+                break;
+            case 'id':
+            case 'ref':
+                base = 'z.string().uuid()';
+                break;
+            case 'enum':
+                base = `z.enum([${(f.values ?? []).map(str).join(', ')}])`;
+                break;
+            case 'list': {
+                const shape = f.shape ?? {};
+                if ('item' in shape && Object.keys(shape).length === 1)
+                    base = `z.array(${fieldReadCode(shape.item)})`;
+                else if (Object.keys(shape).length === 0)
+                    base = 'z.record(z.string(), z.unknown())';
+                else
+                    base = `z.array(z.object({ ${Object.entries(shape)
+                        .map(([k, sf]) => `${k}: ${fieldReadCode(sf)}`)
+                        .join(', ')} }))`;
+                break;
+            }
+            default:
+                base = 'z.string()';
+        }
+    }
+    return f.isOptional ? `${base}.nullable().optional()` : base;
+}
+export function snapshotCode(fields, states) {
+    const lines = [
+        'id: z.string().uuid()',
+        ...Object.entries(fields)
+            .filter(([, f]) => !f.isHidden && !isRelation(f))
+            .map(([k, f]) => `${k}: ${fieldReadCode(f)}`),
+        `status: z.enum([${states.map(str).join(', ')}])`,
+        'version: z.number().int()',
+        'createdAt: z.string()',
+        'updatedAt: z.string()',
+    ];
+    return `z.object({\n${lines.map((l) => `  ${l},`).join('\n')}\n})`;
+}
+//# sourceMappingURL=zod-code.js.map

package/dist/gen/zod-code.js.map

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

package/dist/graph-command.d.ts

@@ -0,0 +1,11 @@
+import { type CageConfig } from './config.js';
+interface QueryOptions {
+    depth?: string;
+    limit?: string;
+    kind?: string;
+    direction?: string;
+    format?: string;
+    out?: string;
+}
+export declare function graphCommand(cfg: CageConfig, action: 'context' | 'search' | 'inspect' | 'path', targets: string[], options: QueryOptions): Promise<number>;
+export {};