@@ -0,0 +1,16 @@
+---
+'@objectstack/skills': patch
+'@objectstack/spec': patch
+---
+
+docs(skills, spec): the approval-flow example and the `HookSchema.condition` example guard their nullable `amount` comparison with `record.amount != null`
+
+Clause-②: no
+Metadata-protocol: none
+
+The publish-time null-guard rule refuses an ordering comparison on a declared-nullable field in a hook `condition` and in a record-triggered flow's start, edge and `decision` conditions unless an explicit `!= null` test dominates it. Two published examples compared `record.amount` without one:
+
+- `skills/objectstack-automation/references/state-machines-and-approvals.md`: the approval flow's start condition now reads `record.amount != null && record.amount > 100000`. What the start condition proves non-null is presumed at every edge and `decision` branch, so the `e1`, `e4` and `e5` edge conditions pass as written, and a null `amount` never launches the flow.
+- `packages/spec/src/data/hook.zod.ts`: the `condition` `@example` and `.describe()` text now read `record.status == 'closed' && record.amount != null && record.amount > 1000`, and the generated `content/docs/references/data/hook.mdx` row follows.
+
+The spec change is description text only: no schema shape changes, and no accept set moves.
@@ -36,7 +36,7 @@ const result = HookSchema.parse(data);
 | **body** | `{ language: 'expression'; source: string } \| { language: 'js'; source: string; capabilities?: Enum<'api.read' \| 'api.write' \| 'api.transaction' \| 'crypto.uuid' \| 'log'>[]; timeoutMs?: integer; … }` | optional | Hook body — expression (L1) or sandboxed JS (L2) |
 | **priority** | `number` | optional (default: `100`) | Execution priority |
 | **async** | `boolean` | optional (default: `false`) | Run specifically as fire-and-forget |
-| **condition** | `string \| { dialect: Enum<'cel' \| 'cron' \| 'template'>; source: string; ast?: any; meta?: object }` | optional | Predicate (CEL); hook runs only when TRUE. e.g. P`record.status == "closed" && record.amount > 1000` |
+| **condition** | `string \| { dialect: Enum<'cel' \| 'cron' \| 'template'>; source: string; ast?: any; meta?: object }` | optional | Predicate (CEL); hook runs only when TRUE. e.g. P`record.status == "closed" && record.amount != null && record.amount > 1000` |
 | **description** | `string` | optional | Human-readable description of what this hook does |
 | **retryPolicy** | `{ maxRetries?: number; backoffMs?: number }` | optional | Retry policy for failed hook executions |
 | **timeoutMs** | `number` | optional | Maximum execution time in milliseconds before the hook is aborted |
 
@@ -521,9 +521,9 @@ export const HookSchema = lazySchema(() => strictObject(
    * If provided and evaluates to FALSE, the hook is skipped entirely.
    * Useful for filtering by record data without writing handler code.
    * 
-   * @example "record.status == 'closed' && record.amount > 1000"
+   * @example "record.status == 'closed' && record.amount != null && record.amount > 1000"
    */
-  condition: EvaluatedExpressionInputSchema.optional().describe('Predicate (CEL); hook runs only when TRUE. e.g. P`record.status == "closed" && record.amount > 1000`'),
+  condition: EvaluatedExpressionInputSchema.optional().describe('Predicate (CEL); hook runs only when TRUE. e.g. P`record.status == "closed" && record.amount != null && record.amount > 1000`'),
 
   /**
    * Human-readable description
 
@@ -87,7 +87,7 @@ is one diagram a reviewer (or AI) can read end-to-end.
       config: {
         objectName: 'opportunity',
         triggerType: 'record-after-update',
-        condition: cel`record.amount > 100000`,
+        condition: cel`record.amount != null && record.amount > 100000`,
       },
     },
     {
Original file line number	Diff line number	Diff line change
`@@ -87,7 +87,7 @@ is one diagram a reviewer (or AI) can read end-to-end.`
`87`	`87`	`config: {`
`88`	`88`	`objectName: 'opportunity',`
`89`	`89`	`triggerType: 'record-after-update',`
`90`		- condition: cel`record.amount > 100000`,
	`90`	+ condition: cel`record.amount != null && record.amount > 100000`,
`91`	`91`	`},`
`92`	`92`	`},`
`93`	`93`	`{`