feat(spec): the two retired spellings' refusals name the release that refuses them, joined in the removal-version pin

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

Author: claude

packages/spec/src/shared/retired-key-removal-version.pin.test.ts

@@ -88,6 +88,7 @@ import {
   ActionMenuPropsSchema,
   ElementNumberPropsSchema,
   ElementRecordPickerPropsSchema,
+  ElementButtonPropsSchema,
   ElementRepeaterPropsSchema,
   ObjectGridPropsSchema,
   ObjectKanbanPropsSchema,
@@ -239,6 +240,19 @@ const JOIN: Readonly<Record<string, readonly Renderer[]>> = {
       'sharingModel',
     ),
   ],
+  // Two protocol-17 live-window conversions retired from the load path at 18
+  // (`toMajor: 17`, unlike every other row): the prescription is the refusal
+  // the surface answers once the loader stops rewriting the old spelling.
+  'page-header-subtitle-alias': [
+    refusal("page:header property 'description'", () => PageHeaderProps.safeParse({ title: 'Leads', description: 'All open leads' })),
+  ],
+  'inline-action-api-params-to-body-extra': [
+    refusal(
+      "an inline type:'api' action's object-form params",
+      () => ElementButtonPropsSchema.safeParse({ label: 'Go', action: { type: 'api', target: '/x', params: { a: 1 } } }),
+      'action',
+    ),
+  ],
   // Shipped by a 17.x minor; `toMajor: 18` like the rows above.
   'page-header-breadcrumb-removed': [tombstone(PageHeaderProps, 'page:header', 'breadcrumb')],
   'object-grid-default-sort-removed': [tombstone(ObjectGridPropsSchema, 'object-grid', 'defaultSort')],

packages/spec/src/ui/action.zod.ts

@@ -1295,11 +1295,13 @@ const actionObject = () => strictObject({
         && typeof iss.input === 'object'
         && !Array.isArray(iss.input)
         ? "`params` is the parameter DEFINITION array (fields collected from the user before the action runs), not a values map. "
-          + "For a `type:'api'` action's static request body — including `{{page.<var>}}` tokens — use `bodyExtra: { … }` instead. "
+          + "For a `type:'api'` action's static request body — including `{{page.<var>}}` tokens — use `bodyExtra: { … }` instead; "
+          + "the loader rewrote that object form to `bodyExtra` on an inline page button until @objectstack/spec 18, which refuses it (ADR-0087 D2). "
           + "For a `type:'url'` action there is nowhere to move it to, by decision: put static values straight into the `target` string "
           + "(`${param.X}` interpolates a value collected by the params dialog, `${ctx.X}` one from the action context), and open a new tab with "
           + "`openIn: 'new-tab'`. The url-side readings of an object `params` — a static `${param.X}` scope, and `params.newTab` — are RETIRED, not renamed. "
-          + 'Expected an array of ActionParam, received an object.'
+          + 'Expected an array of ActionParam, received an object. '
+          + 'Run `os migrate meta --from 16` to list the mechanical edits for the inline `element:button` action case; `--write` applies the ones it can prove, and a registered action keeps its object form until you move it by hand.'
         : undefined
     ),
   }).optional().describe('Input parameters required from user — an ActionParam[] DEFINITION array, never a payload map (a static request body goes in `bodyExtra`).'),

packages/spec/src/ui/component.zod.ts

@@ -588,7 +588,7 @@ export const PageHeaderProps = strictObject({
   surface: 'this `page:header`',
   history: PROPS_HISTORY,
   guidanceSets: COMPONENT_LEVEL_GUIDANCE,
-  aliases: {
+  guidance: {
     /**
      * The ADR-0087 D2 conversion `page-header-subtitle-alias` (#4827,
      * objectui#3226) renamed this on load for protocol 17's window; retired
@@ -601,12 +601,21 @@ export const PageHeaderProps = strictObject({
      * (`description` is a live declared prop on other components), got no
      * diagnostic at a nested site from any layer".
      *
-     * An alias rather than a `retiredKey` tombstone precisely because of that
-     * parenthesis: `description` is a live prop elsewhere in this file
-     * (`element:text_input`), so the answer is a rename on THIS surface, not a
-     * removal notice. Grounded in the conversion registry rather than guessed.
+     * A guidance row rather than a `retiredKey` tombstone: `PageHeaderProps`
+     * never declared `description`, so there is no property for a tombstone to
+     * replace, and `description` is a live prop elsewhere in this file
+     * (`element:text_input`), so the answer is a rename on THIS surface. It was
+     * an `aliases` row (a bare "did you mean") while the conversion was live;
+     * retired, it is the upgrade prescription, naming the release that refuses
+     * the spelling (#23421). Grounded in the conversion registry rather than
+     * guessed.
      */
-    description: 'subtitle',
+    description:
+      '`page:header` property `description` was removed in @objectstack/spec 18 (ADR-0087 D2) — it was an '
+      + 'off-spec second spelling of the header\'s second line, which the loader rewrote to `subtitle` until '
+      + 'this release; `subtitle` is the declared key. Use `subtitle`. Rename the key; the value '
+      + '(the second line\'s text) is unchanged. '
+      + 'Run `os migrate meta --from 16` to list the mechanical edits for existing sources; `--write` applies the ones it can prove, and you apply the rest by hand.',
   },
 }, {
   /**