docs(spec): the related-list column keys diverge on purpose — say so in both comments

Widening `record:related_list.columns` to the saved-view `ListColumn` union
falsified one clause in two in-repo comments, both of which claimed the
page-block sibling was "the same strings-only shape" as
`field.relatedListColumns`.

Both now state what is true after the change AND that the divergence is
deliberate: the block key takes the saved-view union because objectui composes
a saved view's columns onto it verbatim, while `field.relatedListColumns` stays
child field-name strings only by ruling and its
`field-column-lists-canonicalized` conversion still folds object entries to the
identity string. Comment text only — no schema, no refusal behaviour, no
conversion and no assertion is touched, and the diff carries no non-comment
line.

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

Author: claude

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

@@ -1454,8 +1454,19 @@ export const FieldSchema = lazySchema(() => {
    * Deliberately narrower than `inlineColumns`: the related list is not an
    * editable grid, and per-column display overrides are not part of its
    * measured renderer contract (objectui RelatedList hydrates string entries
-   * fully; the page-block sibling `record:related_list.columns` is the same
-   * strings-only shape). Column OBJECTS are refused with a prescription.
+   * fully). Column OBJECTS are refused with a prescription.
+   *
+   * ⚠️ AND deliberately narrower than the PAGE-BLOCK sibling, which is no
+   * longer the same shape (#18639). `record:related_list.columns`
+   * (`ui/component.zod.ts`) now declares the SAME union as the saved-view key
+   * `listViews[].columns` — field-name strings OR `ListColumnSchema` entries —
+   * because objectui composes a saved view's `columns` onto that block
+   * VERBATIM, so a decorated list arrives there already in the `ListColumn`
+   * spelling. THIS key stays strings-only BY RULING: objectui#9593 ruling A
+   * widened that one and fenced this one in the same breath, and the
+   * `field-column-lists-canonicalized` conversion still folds an object entry
+   * here down to its identity string. The two keys diverge ON PURPOSE —
+   * ⛔ do not "align" them.
    */
   relatedListColumns: z.array(z.string({
     error: (issue) => issue.code === 'invalid_type'

packages/spec/src/data/inline-related-columns.test.ts

@@ -25,9 +25,14 @@
  *      parse clean and render every computed cell '—'. The refusal is the
  *      producer-side guard for that renderer fact.
  *   4. `relatedListColumns`: child field-name STRINGS only, matching every
- *      in-repo usage and the strings-only page-block sibling
- *      (`record:related_list.columns`, ui/component.zod.ts). A column OBJECT
- *      is refused with the derivation prescription.
+ *      in-repo usage. A column OBJECT is refused with the derivation
+ *      prescription. ⚠️ Since #18639 this is NO LONGER the same shape as the
+ *      page-block sibling: `record:related_list.columns`
+ *      (ui/component.zod.ts) declares the saved-view `ListColumnSchema` union,
+ *      because a saved view's columns are composed onto that block verbatim.
+ *      THIS key stays strings-only by ruling — objectui#9593 ruling A widened
+ *      that one and fenced this one — so the divergence is DELIBERATE, and
+ *      every pin below is unchanged by it.
  *   5. The showcase invoice fixture form — identity-only `{ name }` entries —
  *      parses, so the one authored in-repo usage stays green in the spelling
  *      the renderer actually reads.