docs(spec): HookEvent 枚举注释不再声称批量写把行级谓词放在 input (#5899) (#5964)

枚举注释里「row-scoping predicate carried in `input`」与同文件 200 行外的
`HookContextSchema.input` 契约表(":340" 起,PR #5668 落地 #5273 时写下的
「NOT reachable from `input` at all」)自相矛盾。引擎从不在写路径的
HookContext.input 上放谓词,它在引擎内部 OperationContext.ast(#2982)。

改为与契约表一致的措辞,并把读者指向该表与其钉子测试
packages/objectql/src/hook-input-shape-contract.test.ts。主句(批量写触发同名
事件、没有 *Many 事件)保留。纯注释订正,未触及 .describe()、键或类型。


Claude-Session: https://claude.ai/code/session_011M7UwH25Unfi73UHim7ajY

Co-authored-by: Claude <noreply@anthropic.com>

Author: qq9340100

packages/spec/src/data/hook.zod.ts

@@ -134,10 +134,16 @@ export const HookEvent = z.enum([
 
   // Write — before/after per mutation kind. These fire on BOTH single-id and
   // bulk (`multi: true`) writes: a bulk update/delete runs the SAME
-  // `beforeUpdate`/`beforeDelete`/`afterUpdate`/`afterDelete` with the
-  // row-scoping predicate carried in `input` (there is no per-cardinality
-  // `*Many` event — one write event covers one row or many, Salesforce's
-  // bulk-first model). See #3195.
+  // `beforeUpdate`/`beforeDelete`/`afterUpdate`/`afterDelete` (there is no
+  // per-cardinality `*Many` event — one write event covers one row or many,
+  // Salesforce's bulk-first model). The row-scoping predicate is NOT reachable
+  // from `input` on those write events: it lives on the engine-internal
+  // `OperationContext.ast` (#2982) so that the filters middleware composes onto
+  // it, where no handler can widen it — scope a bulk batch through
+  // `options.where` at the CALLER, or work per row on the `after*` events. Full
+  // per-event shapes in the `HookContextSchema.input` contract table below,
+  // pinned against the real engine by
+  // `packages/objectql/src/hook-input-shape-contract.test.ts`. See #3195.
   'beforeInsert', 'afterInsert',
   'beforeUpdate', 'afterUpdate',
   'beforeDelete', 'afterDelete',