fix(driver-sql,lint): classify dueLike and settledWhen in FIELD_KEY_STORAGE_CLASS; settledWhen joins the docs gate's field-rule slots and the consumer census's behaviour segments

FIELD_KEY_STORAGE_CLASS is pinned against Object.keys(FieldSchema.shape)
(builtin-column-collision.test.ts): both keys are presentation, read by the
renderer's date cells and never by createColumn. The docs-corpus gate now
root-judges a settledWhen example (slot list and text tripwire together,
three self-test cases), and validate-field-consumers counts a settledWhen
read as behaviour beside its three siblings.

Claude-Session: https://claude.ai/code/session_01VZqqwTj2wsihZEbfT6yyYN
Co-authored-by: Claude <noreply@anthropic.com>

Author: claude

packages/drivers/driver-sql/src/builtin-column-collision.ts

@@ -120,6 +120,8 @@ export const FIELD_KEY_STORAGE_CLASS: Readonly<Record<string, FieldKeyClass>> =
   readonlyWhen: 'presentation',
   requiredWhen: 'presentation',
   conditionalRequired: 'presentation',
+  dueLike: 'presentation',     // declares a date a deadline (#22227) — read by the renderer's date cells, never by `createColumn`: the column is the date the type already sizes
+  settledWhen: 'presentation', // the deadline's settle predicate (#22227), display only like `visibleWhen` — no DDL reads it
   requiredPermissions: 'presentation',
   maskingRule: 'presentation',
   ackPlaintextMasking: 'presentation',

packages/lint/scripts/check-doc-formula-expressions.mjs

@@ -635,7 +635,12 @@ function scan(files) {
  * same rule would fail the build on correct docs. The loudness requirement is
  * met by the skip list instead — printed, counted, and pinned by the self-test.
  */
-const FIELD_RULE_SLOTS = ['visibleWhen', 'readonlyWhen', 'requiredWhen'];
+// `settledWhen` (#22227) is the deadline's settle predicate, judged by the
+// metadata walk exactly as `visibleWhen` is — so a docs example of it gets the
+// same verdict here. Keep this list and FIELD_RULE_TEXT_RE below in step: the
+// text tripwire reconciles against the parse, so a slot in one and not the
+// other is either an invisible site or a phantom skip.
+const FIELD_RULE_SLOTS = ['visibleWhen', 'readonlyWhen', 'requiredWhen', 'settledWhen'];
 
 /** The property key of a property assignment, when it is a plain name. */
 function keyText(p) {
@@ -751,7 +756,7 @@ function fieldRuleSkipReason(prop) {
  * `docs/adr/0089-unify-visibility-predicate-naming.md` quotes the SCHEMA rather
  * than authoring a predicate — three text hits that are not sites at all.
  */
-const FIELD_RULE_TEXT_RE = /\b(visibleWhen|readonlyWhen|requiredWhen)\s*:\s*(?:[A-Za-z_$][\w$]*\s*)?["'`]/g;
+const FIELD_RULE_TEXT_RE = /\b(visibleWhen|readonlyWhen|requiredWhen|settledWhen)\s*:\s*(?:[A-Za-z_$][\w$]*\s*)?["'`]/g;
 
 export function textFieldRuleSites(code) {
   const out = [];
@@ -1742,6 +1747,23 @@ const FIELD_RULE_SELF_TEST_CASES = [
     code: "ObjectSchema.create({ fields: { due_date: { type: 'date', requiredWhen: 'stage == \"closed\"' } } })",
     expect: { admitted: 1, errors: 1, match: /bare reference `stage`/ },
   },
+  {
+    // #22227 — the deadline's settle predicate is a field-rule slot, so a docs
+    // example of it is root-judged exactly as `visibleWhen` is.
+    name: 'RED — `settledWhen` on a deadline is the same field-rule slot: a bare reference is refused',
+    code: "due_date: Field.date({ dueLike: true, settledWhen: P`status == 'done'` }),",
+    expect: { admitted: 1, errors: 1, match: /bare reference `status`/ },
+  },
+  {
+    name: 'RED — `settledWhen` reading `current_user` gets the family\'s root verdict',
+    code: "due_date: Field.date({ dueLike: true, settledWhen: \"current_user.profile == 'admin'\" }),",
+    expect: { admitted: 1, errors: 1, match: /`settledWhen` reads `current_user`/ },
+  },
+  {
+    name: 'GREEN — the `fields.mdx` deadline example: a record-scoped `settledWhen`',
+    code: "due_date: Field.date({ label: 'Due Date', dueLike: true, settledWhen: P`record.status == 'done'` }),",
+    expect: { admitted: 1, errors: 0 },
+  },
   {
     name: 'GREEN — the canonical record-scoped predicate',
     code: "x: Field.text({ visibleWhen: \"record.status == 'closed'\" }),",

packages/lint/src/validate-field-consumers.ts

@@ -310,7 +310,9 @@ const BEHAVIOUR_SEGMENTS: ReadonlySet<string> = new Set([
   'titleField', 'colorField', 'latitudeField', 'longitudeField', 'locationField',
   'addressField', 'parentField', 'statusField', 'kanban', 'calendar', 'gantt', 'timeline',
   'map', 'tree', 'rowColor', 'rowTint', 'conditionalFormatting',
-  'expression', 'formula', 'visibleWhen', 'readonlyWhen', 'requiredWhen', 'validations',
+  // `settledWhen` (#22227) is the fourth field-rule predicate slot, a deadline's
+  // settle condition — a read of the fields it names, like its three siblings.
+  'expression', 'formula', 'visibleWhen', 'readonlyWhen', 'requiredWhen', 'settledWhen', 'validations',
   'rules', 'summaryOperations', 'dimensions', 'measures', 'handler', 'body', 'script',
   'nameField', 'displayNameField', 'externalId', 'upsertKey',
 ]);