@yss123/cage-kernel 0.2.0 → 0.3.0

package/dist/primitives/command.d.ts

@@ -1,3 +1,7 @@
+/**
+ * 声明唯一领域写入口及 handler 可使用的输入、草稿、读依赖和调用信息。
+ * command 构造冻结规格，注册表确定能力名称，内核流水线执行状态、权限、版本、约束、事务、审计和事件；本文件不发 HTTP、不连接数据库、不执行 handler。
+ */
 import { z } from 'zod';
 import { COMMAND } from '../brands.js';
 import { type DomainError } from '../errors.js';
@@ -7,31 +11,54 @@ import type { Constraint } from './constraints.js';
 import { type AnyEvent, type EmitSpec } from './event.js';
 /** reads 的形状：别名 → 聚合 */
 export type Reads = Record<string, AnyAggregate>;
+/** handler 读依赖的有界查询选项；orderBy 使用业务字段名，底层负责映射与校验。 */
 export interface FindOptions {
+    /**
+     * 期望返回条数；实现默认 1000、最多 5000，不提供 offset 或全量保证，业务应选择合理正整数。
+     */
     limit?: number;
+    /**
+     * 排序业务字段或系统字段名；省略时按 createdAt 升序，未知字段及集合关系拒绝。
+     */
     orderBy?: string;
+    /**
+     * 提供 orderBy 时是否降序，省略/false 为升序；未指定排序字段时不改变默认创建时间顺序。
+     */
     desc?: boolean;
 }
-/** 注入给 handler 的只读仓储：自动附加数据范围，范围外等于不存在 */
+/**
+ * 注入 handler 的只读仓储，绑定本次命令事务及当前数据范围，范围外对象按不存在处理。
+ * 返回供服务端业务计算使用的内部快照，不是浏览器安全呈现 DTO；不要直接把它作为公开响应或绕过掩码输出。
+ * 没有写方法，find/findOne 只接受声明列的等值条件；事务内读取本身不保证其他聚合的后续并发写已被锁定。
+ */
 export interface ReadRepo<A extends AnyAggregate> {
-    /** 按 id 取一条，范围外返回 null */
+    /** 按 UUID 取一条内部快照，不存在、范围外或明显非法 ID 返回 null；不会取得业务更新行锁。 */
     get(id: string): Promise<SnapshotOf<A> | null>;
-    /** 等值条件查询，自动附加范围 */
+    /** 按等值条件读取范围内列表，省略 where 不加额外业务筛选；undefined 条件忽略，null 使用 IS NULL，集合/JSON 不能作主表筛选。 */
     find(where?: Partial<SnapshotOf<A>>, opts?: FindOptions): Promise<SnapshotOf<A>[]>;
-    /** 按条件取第一条 */
+    /** 按等值条件取默认创建时间升序的第一条，未命中为 null；不表示条件在数据库中具有唯一约束。 */
     findOne(where: Partial<SnapshotOf<A>>): Promise<SnapshotOf<A> | null>;
-    /** 计数，同样自动附加范围 */
+    /** 统计相同租户/范围内的等值条件记录数，不使用 find 的返回数量上限；未知字段及 JSON/集合条件会拒绝。 */
     count(where?: Partial<SnapshotOf<A>>): Promise<number>;
 }
+/**
+ * 按 reads 的每个别名推导只读仓储类型；只读映射禁止替换依赖，不提供写接口。
+ * 运行时访问未声明别名仍会失败，类型擦除不能绕过 CAGE-READS-001 门禁。
+ */
 export type DepsOf<R extends Reads> = {
     readonly [K in keyof R]: ReadRepo<R[K]>;
 };
 /** handler 拿到的草稿：业务字段可改；状态、主键、版本号只读，handler 改不了 */
 export type Draft<A extends AnyAggregate> = FieldValuesOf<A> & {
+    /** 新建草稿或当前对象的 UUID，只读，handler 不得更换对象身份。 */
     readonly id: string;
+    /** 执行 handler 时的草稿/当前状态，只读；目标状态由命令 to 在合并后确定。 */
     readonly status: StateOf<A>;
+    /** handler 所见草稿版本或已加载版本，只读；内核提交时维护版本递增。 */
     readonly version: number;
+    /** 原始创建时间字符串，新建使用本次固定时间，handler 不改写。 */
     readonly createdAt: string;
+    /** 本次草稿或已加载记录的更新时间字符串，最终更新时间由流水线设定。 */
     readonly updatedAt: string;
 };
 /** handler 的第四个参数：只读的调用信息 */
@@ -41,24 +68,64 @@ export interface HandlerCtx {
     /** 真人操作者（系统身份时为它代表的人） */
     readonly actorUserId: string | null;
 }
+/** 可直接修改草稿并返回 void，或返回字段补丁；DomainError 会终止整笔命令事务。 */
 export type HandlerResult<A extends AnyAggregate> = Draft<A> | Partial<FieldValuesOf<A>> | DomainError | void;
+/**
+ * 命令声明可选择的调用入口种类。
+ * 用户/匿名入口必须包含 user；框架反应按 process 入口解释，内部系统身份有专用路径。声明入口不等于授权，能力、范围和调度器 calls 白名单仍分别检查。
+ */
 export type Invoker = 'user' | 'process' | 'job' | 'external';
+/**
+ * 一次业务写入的完整规格。input 验证调用参数，reads 列明只读依赖，constraints 在 handler 前执行，
+ * emits 在业务写入成功后进入同事务 outbox；handler 不能代替权限、版本或状态检查。
+ */
 export interface Command<A extends AnyAggregate = AnyAggregate, R extends Reads = Reads, I extends z.ZodType = z.ZodType> {
+    /**
+     * 声明品牌标记，供注册表识别顶层导出，不表示命令已执行。
+     */
     readonly [COMMAND]: true;
+    /**
+     * 本命令唯一写入的聚合定义；跨聚合变化通过声明反应/其他命令组合。
+     */
     readonly agg: A;
+    /**
+     * new 表示创建；否则为规范化冻结的允许起始状态列表，实际当前状态不匹配返回 INVALID_TRANSITION。
+     */
     readonly from: readonly StateOf<A>[] | 'new';
     /** null 表示保持加锁读到的当前状态；仍检查 from、权限、版本并写审计。 */
     readonly to: StateOf<A> | null;
+    /**
+     * 命令输入 Zod schema，handler 接收 z.output 转换后的值；expectedVersion 由流水线单独处理。
+     */
     readonly input: I;
+    /**
+     * 别名到聚合的冻结声明，运行时在当前事务/范围内绑定只读仓储；不因声明获得任意数据库连接。
+     */
     readonly reads: R;
+    /**
+     * 规范化事件及可选载荷映射列表；最终状态通过校验后与业务写入共同进入事务/outbox。
+     */
     readonly emits: readonly EmitSpec[];
+    /**
+     * handler 前依次执行的硬约束，拒绝会回滚命令事务；与最终不变量检查职责不同。
+     */
     readonly constraints: readonly Constraint<A>[];
+    /**
+     * 规范化调用入口列表，默认 [user]；仍需能力和数据范围检查，不能把被流程选中当作授权。
+     */
     readonly invokedBy: readonly Invoker[];
-    /** 匿名用户也能调用（极少使用） */
+    /** 显式公开命令，默认 false；允许 anonymous 主体并跳过能力点检查，但不跳过调用身份、范围、状态、版本及业务约束。 */
     readonly public: boolean;
     /** 显式命令名；不写时取导出名 */
     readonly name?: string;
+    /**
+     * 可选命令用途说明，供目录、本体和生成文档展示，不改变能力名称或执行策略。
+     */
     readonly description?: string;
+    /**
+     * 在框架草稿、已解析输入和已声明只读依赖上描述业务字段变化。
+     * 可返回草稿、字段补丁、void 或 DomainError；状态/版本由流水线维护，外部 IO 应走连接器，不由此回调自行提交数据库事务。
+     */
     readonly handler: (o: Draft<A>, input: z.output<I>, deps: DepsOf<R>, ctx: HandlerCtx) => MaybePromise<HandlerResult<A>>;
 }
 /**
@@ -68,34 +135,66 @@ export interface Command<A extends AnyAggregate = AnyAggregate, R extends Reads
  * command() 的返回值仍保留 A/R/I，调用处的类型推导不受这个内部容器类型影响。
  */
 export type AnyCommand = Omit<Command<AnyAggregate, Reads, z.ZodType>, 'handler'> & {
+    /** 注册表内部擦除 handler 参数类型以容纳不同聚合/reads；业务 command 返回类型仍精确保留输入与依赖。 */
     readonly handler: (...args: any[]) => MaybePromise<any>;
 };
+/**
+ * 已有对象命令省略 input 时使用的默认 schema，只接收 UUID id；expectedVersion 由流水线作为并发元数据单独拆分。
+ */
 export declare const idOnly: z.ZodObject<{
     id: z.ZodString;
 }, z.core.$strip>;
+/**
+ * 新建命令省略 input 时使用的默认空对象 schema；需要业务参数时应显式声明，聚合字段不会自动成为命令输入。
+ */
 export declare const empty: z.ZodObject<{}, z.core.$strip>;
+/**
+ * 根据 from 是否为 new 推导省略 input 时的 schema，新建为空对象、已有对象默认 idOnly。
+ */
 type DefaultInput<F> = F extends 'new' ? typeof empty : typeof idOnly;
+/**
+ * 应用传给 command 的原始声明选项，保留 from 与输入/读依赖泛型推导。
+ * 构造时规范化默认值和冻结容器；后续注册与执行仍检查跨声明关系、输入、授权和业务状态，不能把成功构造当作可执行证明。
+ */
 export interface CommandDef<A extends AnyAggregate, R extends Reads, I extends z.ZodType, F> {
     /** 起始状态；'new' 表示新建 */
     from: F;
     /** 目标状态；非新建命令可显式写 null，只更新业务字段而不迁移状态。 */
     to: F extends 'new' ? StateOf<A> : StateOf<A> | null;
-    /** 输入校验；非新建命令的输入必须包含 id */
+    /** 输入校验，handler 收到解析后的值；省略时新建为 {}、已有记录为 { id: uuid }，已有记录显式 schema 必须提供 id。 */
     input?: I;
-    /** 读依赖，决定 handler 能拿到什么 */
+    /** 别名到聚合的只读依赖，默认空；handler 只获得这些仓储，运行时访问未声明别名会报 CAGE-READS-001。 */
     reads?: R;
-    /** 发出的事件 */
+    /** 默认空；可传事件声明或 emit 显式映射，载荷在最终快照形成后校验，并与命令写入同事务保存。 */
     emits?: (AnyEvent | EmitSpec)[];
-    /** 硬约束组合子 */
+    /** 默认空；handler 前按声明顺序执行的硬约束，拒绝或异常中止整笔命令，不代替最终不变量。 */
     constraints?: NoInfer<Constraint<A>>[];
     /** 谁能调用，默认 user */
     invokedBy?: Invoker | Invoker[];
+    /**
+     * 默认 false；true 允许显式匿名主体且跳过该命令能力检查，仍受调用身份、状态、范围、版本及业务约束限制，不能用于普通业务提权。
+     */
     public?: boolean;
+    /**
+     * 可选小驼峰命令名；省略时由顶层导出名推导，能力最终为 Aggregate.commandName。
+     */
     name?: string;
+    /**
+     * 面向能力目录和本体的业务说明，应写操作意图及边界，不承担运行时约束。
+     */
     description?: string;
-    /** AI 写的业务逻辑：纯函数，返回新草稿、字段变更或业务错误 */
+    /**
+     * 用可写业务草稿、解析后输入及受限读依赖描述业务变化，可同步或异步返回草稿、补丁、void 或 DomainError。
+     * 允许等待声明的只读依赖；状态/系统列由内核维护，外部副作用应声明连接器和事件，不在 handler 自行开连接或提交事务。
+     */
     handler: (o: Draft<A>, input: z.output<[I] extends [never] ? DefaultInput<F> : I>, deps: DepsOf<R>, ctx: HandlerCtx) => MaybePromise<HandlerResult<A>>;
 }
+/**
+ * 构造命令描述，不执行业务，也不注册全局状态。新建默认空输入，更新默认只要求 id。
+ * from/to 必须属于聚合状态；更新可用 to:null 保留当前状态，新建必须指定真实目标状态。
+ * 命令名称可显式给出，也可稍后从 domain 导出名推断，因此仅写文件还不足以注册能力。
+ */
 export declare function command<A extends AnyAggregate, const F extends StateOf<A> | readonly StateOf<A>[] | 'new', R extends Reads = {}, I extends z.ZodType = never>(agg: A, def: CommandDef<A, R, I, F>): Command<A, R, [I] extends [never] ? DefaultInput<F> : I>;
+/** 注册表识别顶层导出时使用；具体结构和跨声明关系由后续注册校验负责。 */
 export declare function isCommand(v: unknown): v is AnyCommand;
 export {};

package/dist/primitives/command.js

@@ -1,3 +1,7 @@
+/**
+ * 声明唯一领域写入口及 handler 可使用的输入、草稿、读依赖和调用信息。
+ * command 构造冻结规格，注册表确定能力名称，内核流水线执行状态、权限、版本、约束、事务、审计和事件；本文件不发 HTTP、不连接数据库、不执行 handler。
+ */
 // command 原语：一次写操作。命令名由导出的变量名决定：export const approve = command(PurchaseOrder, …)
 // 的能力点就是 PurchaseOrder.approve。
 import { z } from 'zod';
@@ -5,8 +9,19 @@ import { COMMAND } from '../brands.js';
 import { declError } from '../errors.js';
 import { hasStates, } from './aggregate.js';
 import { toEmitSpec } from './event.js';
+/**
+ * 已有对象命令省略 input 时使用的默认 schema，只接收 UUID id；expectedVersion 由流水线作为并发元数据单独拆分。
+ */
 export const idOnly = z.object({ id: z.string().uuid() });
+/**
+ * 新建命令省略 input 时使用的默认空对象 schema；需要业务参数时应显式声明，聚合字段不会自动成为命令输入。
+ */
 export const empty = z.object({});
+/**
+ * 构造命令描述，不执行业务，也不注册全局状态。新建默认空输入，更新默认只要求 id。
+ * from/to 必须属于聚合状态；更新可用 to:null 保留当前状态，新建必须指定真实目标状态。
+ * 命令名称可显式给出，也可稍后从 domain 导出名推断，因此仅写文件还不足以注册能力。
+ */
 export function command(agg, def) {
     const from = def.from;
     if (from !== 'new' && !hasStates(agg, from)) {
@@ -43,6 +58,7 @@ export function command(agg, def) {
         handler: def.handler,
     });
 }
+/** 注册表识别顶层导出时使用；具体结构和跨声明关系由后续注册校验负责。 */
 export function isCommand(v) {
     return !!v && typeof v === 'object' && v[COMMAND] === true;
 }

package/dist/primitives/command.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/primitives/command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/primitives/command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,iFAAiF;AACjF,gCAAgC;AAChC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,SAAS,EAAoB,MAAM,cAAc,CAAC;AAE3D,OAAO,EACkC,SAAS,GACjD,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAgC,UAAU,EAAE,MAAM,YAAY,CAAC;AA+ItE;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC1D;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAkDlC;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAKrB,GAAM,EAAE,GAA2B;IACnC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAoC,CAAC;IACtD,IAAI,IAAI,KAAK,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,SAAS,CAAC,gBAAgB,EAAE,GAAG,GAAG,CAAC,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,oCAAoC;IACpC,gDAAgD;IAChD,IAAI,IAAI,KAAK,KAAK,IAAI,GAAG,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;QACtC,MAAM,SAAS,CAAC,cAAc,EAAE,GAAG,GAAG,CAAC,IAAI,8BAA8B,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,GAAG,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,EAAY,CAAC,EAAE,CAAC;QACzD,MAAM,SAAS,CAAC,gBAAgB,EAAE,GAAG,GAAG,CAAC,IAAI,mBAAmB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAc,CAAC;IAC5E,IAAI,IAAI,KAAK,KAAK,IAAI,KAAK,YAAY,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7E,MAAM,SAAS,CAAC,cAAc,EAAE,GAAG,GAAG,CAAC,IAAI,kBAAkB,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACpE,MAAM,SAAS,CAAC,eAAe,EAAE,OAAO,GAAG,CAAC,IAAI,SAAS,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,CAAC,OAAO,CAAC,EAAE,IAAa;QACxB,GAAG;QACH,IAAI,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAQ;QACpE,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,KAAK,EAAE,KAAY;QACnB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAM;QACnD,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvD,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC;QACxD,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,KAAK;QAC3B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,OAAO,EAAE,GAAG,CAAC,OAAc;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,SAAS,CAAC,CAAU;IAClC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAK,CAAS,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;AACtE,CAAC"}

package/dist/primitives/constraints.d.ts

@@ -1,12 +1,28 @@
+/**
+ * 提供命令 handler 之前执行的硬约束协议与职责分离、额度、二次认证组合子。
+ * 流水线在读取当前对象后传入可信 ctx 和受限元数据，约束只判断是否允许继续；最终字段与不变量校验仍在 handler 后进行，约束通过不等于命令必然提交。
+ */
 import type { CapabilityParams, Ctx, MaybePromise } from '../types.js';
+/** 预期拒绝用失败结果表达；内部故障可抛异常，不能被伪装成约束通过。 */
 export type ConstraintResult = {
     ok: true;
 } | {
-    ok: false;
+    ok: false; /** 业务拒绝说明，可能进入诊断；不要拼入不应公开的敏感数据。 */
     message: string;
 };
+/**
+ * 构造明确的约束通过结果；仅表示当前规则通过，不授予能力或跳过后续规则。
+ */
 export declare const ok: () => ConstraintResult;
+/**
+ * 构造预期业务拒绝结果并保留说明，流水线据此抛约束失败、回滚命令。
+ * 说明可能进入业务诊断，避免拼入密钥或无权公开的明文。
+ */
 export declare const violation: (message: string) => ConstraintResult;
+/**
+ * 框架为当前约束提供的命令能力名、当前租户能力查询和范围读取工具。
+ * 不暴露任意数据库写入；自定义约束应把所用业务字段记入 fields 以支持影响分析。
+ */
 export interface ConstraintMeta {
     /** 正在执行的命令的能力点，例如 PurchaseOrder.approve */
     capability: string;
@@ -17,11 +33,19 @@ export interface ConstraintMeta {
     /** 能力目录 */
     catalog(): string[];
 }
+/**
+ * 命令加载记录后、handler 前执行的守卫；current 是当前记录，input 尚未成为持久状态。
+ * fields 为静态依赖证据，check 才是实际判断。约束通过不代表随后 handler 或不变量一定成功。
+ */
 export interface Constraint<_A = any> {
     /** 约束名，出现在本体图和报错里 */
     readonly name: string;
     /** 用到的字段，抽取器据此画 uses 边，影响分析能找到它 */
     readonly fields?: readonly string[];
+    /**
+     * 接收当前快照、可信身份、已解析输入和框架元数据，返回同步或异步 ConstraintResult。
+     * 返回 ok:false 表示业务拒绝，抛异常表示依赖/实现故障；不得把失败吞成 ok，也不在检查中提交业务副作用。
+     */
     readonly check: (current: any, ctx: Ctx, input: any, meta: ConstraintMeta) => MaybePromise<ConstraintResult>;
 }
 /** 职责分离：操作人（或系统身份代表的真人）不能是该字段记录的人，例如提单人不能审批 */
@@ -29,8 +53,13 @@ export declare const sod: {
     notSameAs(field: string): Constraint;
 };
 /** 额度：字段值不得超过操作人在该能力点上的 ceiling 参数；多角色取最大值 */
+/**
+ * 审批等系统身份优先读取 onBehalfOf 真人当前能力参数，避免流程本身的能力集合绕过额度。
+ * 未配置参数即拒绝；金额字符串在此转成 Number 比较，业务仍需在字段/handler 中保证值合法。
+ */
 export declare function ceiling(field: string, param?: string): Constraint;
 /** 二次认证：最近 maxAgeSec 秒内完成过二次认证 */
+/** maxAgeSec 单位为秒，ctx.stepUpAt 单位为毫秒；缺失认证证据时返回拒绝而非跳过。 */
 export declare function stepUp(maxAgeSec?: number): Constraint;
 /** 自定义约束（仍然是一个纯函数，必须写清楚用到哪些字段） */
 export declare function constraint(name: string, fields: string[], check: Constraint['check']): Constraint;

package/dist/primitives/constraints.js

@@ -1,4 +1,11 @@
+/**
+ * 构造明确的约束通过结果；仅表示当前规则通过，不授予能力或跳过后续规则。
+ */
 export const ok = () => ({ ok: true });
+/**
+ * 构造预期业务拒绝结果并保留说明，流水线据此抛约束失败、回滚命令。
+ * 说明可能进入业务诊断，避免拼入密钥或无权公开的明文。
+ */
 export const violation = (message) => ({ ok: false, message });
 /** 职责分离：操作人（或系统身份代表的真人）不能是该字段记录的人，例如提单人不能审批 */
 export const sod = {
@@ -8,12 +15,18 @@ export const sod = {
             fields: [field],
             check: (cur, ctx) => {
                 const who = ctx.onBehalfOf ?? ctx.userId;
+                if (!who)
+                    return violation('职责分离需要可核验的操作人身份');
                 return who && cur[field] === who ? violation(`操作人不能是 ${field} 记录的人（职责分离）`) : ok();
             },
         });
     },
 };
 /** 额度：字段值不得超过操作人在该能力点上的 ceiling 参数；多角色取最大值 */
+/**
+ * 审批等系统身份优先读取 onBehalfOf 真人当前能力参数，避免流程本身的能力集合绕过额度。
+ * 未配置参数即拒绝；金额字符串在此转成 Number 比较，业务仍需在字段/handler 中保证值合法。
+ */
 export function ceiling(field, param = 'ceiling') {
     return Object.freeze({
         name: `ceiling(${field})`,
@@ -28,6 +41,7 @@ export function ceiling(field, param = 'ceiling') {
     });
 }
 /** 二次认证：最近 maxAgeSec 秒内完成过二次认证 */
+/** maxAgeSec 单位为秒，ctx.stepUpAt 单位为毫秒；缺失认证证据时返回拒绝而非跳过。 */
 export function stepUp(maxAgeSec = 300) {
     return Object.freeze({
         name: 'stepUp',

package/dist/primitives/constraints.js.map

@@ -1 +1 @@
-{"version":3,"file":"constraints.js","sourceRoot":"","sources":["../../src/primitives/constraints.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,EAAE,GAAG,GAAqB,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;AACzD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAe,EAAoB,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AAqBzF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,SAAS,CAAC,KAAa;QACrB,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,iBAAiB,KAAK,GAAG;YAC/B,MAAM,EAAE,CAAC,KAAK,CAAC;YACf,KAAK,EAAE,CAAC,GAAQ,EAAE,GAAQ,EAAE,EAAE;gBAC5B,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,MAAM,CAAC;gBACzC,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACpF,CAAC;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,8CAA8C;AAC9C,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,KAAK,GAAG,SAAS;IACtD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,WAAW,KAAK,GAAG;QACzB,MAAM,EAAE,CAAC,KAAK,CAAC;QACf,KAAK,EAAE,KAAK,EAAE,GAAQ,EAAE,GAAQ,EAAE,MAAW,EAAE,IAAoB,EAAE,EAAE;YACrE,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;YAC3F,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;YACjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,SAAS,CAAC,OAAO,IAAI,CAAC,UAAU,SAAS,KAAK,EAAE,CAAC,CAAC;YACpG,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;QACxG,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,MAAM,CAAC,SAAS,GAAG,GAAG;IACpC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,CAAC,IAAS,EAAE,GAAQ,EAAE,EAAE,CAC7B,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,QAAQ,IAAI,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC;KAC7F,CAAC,CAAC;AACL,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,MAAgB,EAAE,KAA0B;IACnF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAChD,CAAC"}
+{"version":3,"file":"constraints.js","sourceRoot":"","sources":["../../src/primitives/constraints.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,CAAC,MAAM,EAAE,GAAG,GAAqB,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;AACzD;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAe,EAAoB,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AAiCzF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,SAAS,CAAC,KAAa;QACrB,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,iBAAiB,KAAK,GAAG;YAC/B,MAAM,EAAE,CAAC,KAAK,CAAC;YACf,KAAK,EAAE,CAAC,GAAQ,EAAE,GAAQ,EAAE,EAAE;gBAC5B,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,MAAM,CAAC;gBACzC,IAAI,CAAC,GAAG;oBAAE,OAAO,SAAS,CAAC,iBAAiB,CAAC,CAAC;gBAC9C,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACpF,CAAC;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,8CAA8C;AAC9C;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,KAAK,GAAG,SAAS;IACtD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,WAAW,KAAK,GAAG;QACzB,MAAM,EAAE,CAAC,KAAK,CAAC;QACf,KAAK,EAAE,KAAK,EAAE,GAAQ,EAAE,GAAQ,EAAE,MAAW,EAAE,IAAoB,EAAE,EAAE;YACrE,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;YAC3F,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;YACjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,SAAS,CAAC,OAAO,IAAI,CAAC,UAAU,SAAS,KAAK,EAAE,CAAC,CAAC;YACpG,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;QACxG,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,kCAAkC;AAClC,yDAAyD;AACzD,MAAM,UAAU,MAAM,CAAC,SAAS,GAAG,GAAG;IACpC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,CAAC,IAAS,EAAE,GAAQ,EAAE,EAAE,CAC7B,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,QAAQ,IAAI,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC;KAC7F,CAAC,CAAC;AACL,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,MAAgB,EAAE,KAA0B;IACnF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/primitives/event.d.ts

@@ -1,26 +1,62 @@
+/**
+ * 定义领域事件及从命令前后快照构造载荷的映射规格。
+ * 命令流水线校验载荷并与业务写入同事务保存 outbox，再交给同事务反应或异步消费者；声明函数本身不会投递消息，也不保证第三方恰好一次收到。
+ */
 import { z } from 'zod';
 import { EVENT } from '../brands.js';
 import { type FieldValues, type Fields } from './fields.js';
+/** 事件描述已发生的事实；字段是稳定传输载荷，不是聚合表结构或关联集合声明。 */
 export interface Event<N extends string = string, F extends Fields = Fields> {
+    /**
+     * 事件品牌标记，供注册表与 emits 归一化识别。
+     */
     readonly [EVENT]: true;
+    /**
+     * 稳定大驼峰事件名，作为持久 outbox 和消费者协议标识，已部署后修改含义需考虑兼容。
+     */
     readonly name: N;
+    /**
+     * 冻结载荷字段映射，不是持久聚合表；禁止集合关系和文件生命周期原语，关联使用 ID 值传递。
+     */
     readonly fields: F;
+    /**
+     * 由字段生成的载荷校验器，在事件持久化前验证必填、类型和可空规则。
+     */
     readonly schema: z.ZodObject<any>;
+    /**
+     * 可选事实含义说明，供目录和本体展示，不改变投递或事务行为。
+     */
     readonly description?: string;
 }
+/**
+ * 不同事件名称/字段的异构容器类型，用于命令 emits、反应和注册表；事件声明返回值仍保留载荷字段类型。
+ */
 export type AnyEvent = Event<string, any>;
+/**
+ * 从事件 Field 映射推导载荷业务值，不添加对象系统列；需要对象 ID 或旧状态时必须在事件 fields 中显式声明。
+ */
 export type PayloadOf<E> = E extends Event<any, infer F> ? FieldValues<F> : never;
+/**
+ * 声明事件名称与严格字段规格；拒绝关系/文件生命周期原语，引用对象时应发送 ID。
+ * 此函数不投递事件；只有命令流水线完成载荷映射、校验并写入 outbox 后才形成事件事实。
+ */
 export declare function event<const N extends string, F extends Fields>(name: N, fields: F, opts?: {
     description?: string;
 }): Event<N, F>;
+/** 区分裸事件声明与 emit 映射对象，避免构造命令时丢失显式载荷映射。 */
 export declare function isEvent(v: unknown): v is AnyEvent;
 /** 显式指定载荷怎么从快照得到：emits: [emit(OrderApproved, (o) => ({ orderId: o.id, items: o.items }))] */
 export interface EmitSpec<E extends AnyEvent = AnyEvent> {
+    /**
+     * 待发出的事件声明，决定载荷 schema 和后续反应订阅。
+     */
     readonly event: E;
     /** snapshot：写入后的快照；input：命令输入；previous：写入前的快照（新建时为 null） */
     readonly map?: (snapshot: any, input: any, previous: any) => PayloadOf<E>;
 }
+/** 保存纯映射回调；previous 对新建为 null，可用于取消等需要旧状态决定资源释放的事件。 */
 export declare function emit<E extends AnyEvent>(ev: E, map: (snapshot: any, input: any, previous: any) => PayloadOf<E>): EmitSpec<E>;
+/** 将两种 emits 写法归一化；裸事件留空 map，在执行时使用 defaultPayload。 */
 export declare function toEmitSpec(e: AnyEvent | EmitSpec): EmitSpec;
 /**
  * 默认载荷映射规则（没有写 emit(...) 时）：

package/dist/primitives/event.js

@@ -1,11 +1,17 @@
 import { EVENT } from '../brands.js';
 import { declError } from '../errors.js';
-import { isRelation, objectSchema } from './fields.js';
+import { isRelation, isFile, objectSchema } from './fields.js';
+/**
+ * 声明事件名称与严格字段规格；拒绝关系/文件生命周期原语，引用对象时应发送 ID。
+ * 此函数不投递事件；只有命令流水线完成载荷映射、校验并写入 outbox 后才形成事件事实。
+ */
 export function event(name, fields, opts) {
     if (!/^[A-Z][A-Za-z0-9]*$/.test(name))
         throw declError('CAGE-NAME-003', `事件名 ${name} 必须是大驼峰`);
     if (Object.values(fields).some(isRelation))
         throw declError('CAGE-REL-001', '事件载荷不声明持久化关系；传递 ID 数组请使用 list(id())');
+    if (Object.values(fields).some(isFile))
+        throw declError('CAGE-FILE-001', '事件传递文件 ID 请使用 id/list(id())，不声明文件生命周期');
     return Object.freeze({
         [EVENT]: true,
         name,
@@ -14,12 +20,15 @@ export function event(name, fields, opts) {
         description: opts?.description,
     });
 }
+/** 区分裸事件声明与 emit 映射对象，避免构造命令时丢失显式载荷映射。 */
 export function isEvent(v) {
     return !!v && typeof v === 'object' && v[EVENT] === true;
 }
+/** 保存纯映射回调；previous 对新建为 null，可用于取消等需要旧状态决定资源释放的事件。 */
 export function emit(ev, map) {
     return Object.freeze({ event: ev, map });
 }
+/** 将两种 emits 写法归一化；裸事件留空 map，在执行时使用 defaultPayload。 */
 export function toEmitSpec(e) {
     return isEvent(e) ? { event: e } : e;
 }

package/dist/primitives/event.js.map

@@ -1 +1 @@
-{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/primitives/event.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAiC,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAatF,MAAM,UAAU,KAAK,CAA2C,IAAO,EAAE,MAAS,EAAE,IAA+B;IACjH,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,MAAM,SAAS,CAAC,eAAe,EAAE,OAAO,IAAI,SAAS,CAAC,CAAC;IAC9F,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,MAAM,SAAS,CAAC,cAAc,EAAE,qCAAqC,CAAC,CAAC;IACnH,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,CAAC,KAAK,CAAC,EAAE,IAAa;QACtB,IAAI;QACJ,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;QACpC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC;QAC5B,WAAW,EAAE,IAAI,EAAE,WAAW;KAC/B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,CAAU;IAChC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAK,CAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;AACpE,CAAC;AASD,MAAM,UAAU,IAAI,CAAqB,EAAK,EAAE,GAA+D;IAC7G,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAsB;IAC/C,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,EAAY,EAAE,QAAiC,EAAE,KAA8B;IAC5G,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,QAAQ;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;aACnC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;aAC3C,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/primitives/event.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAiC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAmC9F;;;GAGG;AACH,MAAM,UAAU,KAAK,CAA2C,IAAO,EAAE,MAAS,EAAE,IAAwE;IAC1J,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,MAAM,SAAS,CAAC,eAAe,EAAE,OAAO,IAAI,SAAS,CAAC,CAAC;IAC9F,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,MAAM,SAAS,CAAC,cAAc,EAAE,qCAAqC,CAAC,CAAC;IACnH,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,MAAM,SAAS,CAAC,eAAe,EAAE,uCAAuC,CAAC,CAAC;IAClH,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,CAAC,KAAK,CAAC,EAAE,IAAa;QACtB,IAAI;QACJ,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;QACpC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC;QAC5B,WAAW,EAAE,IAAI,EAAE,WAAW;KAC/B,CAAC,CAAC;AACL,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,OAAO,CAAC,CAAU;IAChC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAK,CAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;AACpE,CAAC;AAYD,uDAAuD;AACvD,MAAM,UAAU,IAAI,CAAqB,EAAK,EAAE,GAA+D;IAC7G,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,UAAU,CAAC,CAAsB;IAC/C,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,EAAY,EAAE,QAAiC,EAAE,KAA8B;IAC5G,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,QAAQ;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;aACnC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;aAC3C,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}