@@ -0,0 +1,16 @@
+---
+'@object-ui/plugin-detail': patch
+'@object-ui/i18n': patch
+---
+
+feat(plugin-detail): `record:path` with `allowStageChange: true` lets the reader press a stage to move the record there
+
+Clause-②: yes
+Metadata-protocol: none
+
+`RecordPathProps.allowStageChange` was declared in `@objectstack/spec` but read by nothing: the path stayed a read-only progress rail. The renderer now honours it, and the block's registry `inputs` publish it, so it appears in `sdui.manifest.json` and the component reference.
+
+- **Who can press.** With `allowStageChange: true`, each stage other than the current one is a button, for a reader who may edit `statusField` on this record: the record page's edit session allows editing the record, the field is not read-only or computed, and the caller's field edit grant holds, asked of the stored row. Everyone else, and every path without the key or with `false`, keeps the readout exactly as before. While the record's inline edit holds unsaved changes the path is a readout too.
+- **The write.** A press asks for confirmation, then saves `{ statusField: value }` through the same record update the inline-edit save bar uses, with the record's `updated_at` as the `ifMatch` concurrency token, and re-reads the record.
+- **Refusals.** The server decides which moves are legal: the object's `state_machine` rule (ADR-0020), required fields and edit rights. A refused move is shown under the path: the server's own sentence for each refused field (a field other than the status field is named by its label), a fixed line for a permission refusal, and on a stale concurrency token a line saying the record changed, after the record is re-read.
+- **Copy.** Seven `detail.pathStageChange*` keys, in all ten language packs.
@@ -122,7 +122,7 @@ regenerates from the renderer registry. Regenerate it with
 | [`record:highlights`](/docs/ui/components/record#record-highlights) | `record` | 7 | [Record](/docs/ui/components/record) |
 | [`record:history`](/docs/ui/components/record#record-history) | `record` | 3 | [Record](/docs/ui/components/record) |
 | [`record:line_items`](/docs/ui/components/record#record-line_items) | `record` | 16 | [Record](/docs/ui/components/record) |
-| [`record:path`](/docs/ui/components/record#record-path) | `record` | 2 | [Record](/docs/ui/components/record) |
+| [`record:path`](/docs/ui/components/record#record-path) | `record` | 3 | [Record](/docs/ui/components/record) |
 | [`record:quick_actions`](/docs/ui/components/record#record-quick_actions) | `record` | 9 | [Record](/docs/ui/components/record) |
 | [`record:reference_rail`](/docs/ui/components/record#record-reference_rail) | `record` | 1 | [Record](/docs/ui/components/record) |
 | [`record:related_list`](/docs/ui/components/record#record-related_list) | `record` | 16 | [Record](/docs/ui/components/record) |
 
@@ -132,6 +132,7 @@ Namespace `record`.
 | :--- | :--- | :--- | :--- |
 | `statusField` | `string` | yes | Field representing the current status/stage |
 | `stages` | `array` of `object` |  | Explicit stage definitions [\{ value, label \}] (else derived from field metadata) |
+| `allowStageChange` | `boolean` |  | Let the reader change the record's stage by pressing a stage on the path (default: off, a read-only progress rail). Each press asks for confirmation, then saves `statusField` through the record's ordinary update, guarded by the record's version, so the object's state machine and validation rules decide; a refused move is shown under the path. Stages are pressable only for a reader who may edit `statusField` on this record, and not while the record's inline edit holds unsaved changes. |
 
 ## `record:quick_actions` [#record-quick_actions]
 
 
@@ -13,8 +13,8 @@
   ],
   "source": "built-tree",
   "generator": "scripts/gen-sdui-manifest-node.mjs",
-  "generatedAt": "2026-10-29",
-  "sha256": "d55576794739e7893f7ffdfeadfe8a0ebdd480469e95f431dc7bc80565f4e229",
+  "generatedAt": "2026-10-31",
+  "sha256": "5030c05123d51da87188ea9a0569aeafee106fa612e251765adb254e84bb7144",
   "components": 106,
   "inTree": {
     "modulesRoot": "ui/apps/console",
 
@@ -1805,6 +1805,11 @@
           "type": "array",
           "of": "object",
           "description": "Explicit stage definitions [{ value, label }] (else derived from field metadata)"
+        },
+        {
+          "name": "allowStageChange",
+          "type": "boolean",
+          "description": "Let the reader change the record's stage by pressing a stage on the path (default: off, a read-only progress rail). Each press asks for confirmation, then saves `statusField` through the record's ordinary update, guarded by the record's version, so the object's state machine and validation rules decide; a refused move is shown under the path. Stages are pressable only for a reader who may edit `statusField` on this record, and not while the record's inline edit holds unsaved changes."
         }
       ]
     },
 
@@ -1663,12 +1663,6 @@ const UNPUBLISHED_EXEMPTIONS: Record<string, string> = {
     'Unpublished by measurement (objectui#13047): read by nothing on a page `list-view` node. The node draws, queries and hands its view the same thing with and without it — the view\'s own `name` is its identity in metadata, which an embedded list has no use for.',
   'list-view.sharing':
     'Unpublished by measurement (objectui#13047): `sharing.type` draws a Share button with no click handler, and the sharing config is enforced nowhere in the renderer. Publishing it would advertise a dead control (objectui#13047\'s report).',
-  // Spec-first opt-in (objectstack#28061): the spec half landed before the
-  // console half, so the path renderer does not read it yet. The console card
-  // that makes `record-path.tsx` honour it publishes the input, and the stale
-  // check above then demands this entry's deletion in the same change.
-  'record:path.allowStageChange':
-    'Unpublished until the renderer reads it (objectstack#28061): the spec declares the opt-in that turns path stages into presses requesting that status, and `record-path.tsx` still draws a read-only rail. Publishing it now would advertise a control that does nothing.',
 };
 
 /**
 
@@ -1464,6 +1464,13 @@ const ar = {
     pathStageLostCurrent: '{{stage}}، خاسرة، المرحلة الحالية',
     pathStageLostUpcoming: '{{stage}}، خاسرة، لم يتم الوصول إليها',
     pathStageWonUpcoming: '{{stage}}، المرحلة الهدف، لم يتم الوصول إليها',
+    pathStageChangeAction: 'الانتقال إلى {{stage}}',
+    pathStageChangeTitle: 'تغيير المرحلة؟',
+    pathStageChangeDescription: 'هل تريد نقل هذا السجل إلى {{stage}}؟',
+    pathStageChangeConfirm: 'نقل',
+    pathStageChangeConflict: 'قام شخص آخر بتغيير هذا السجل، ويتم الآن عرض أحدث إصدار. اضغط على المرحلة مرة أخرى إذا كان النقل لا يزال مطلوبًا.',
+    pathStageChangeDenied: 'ليس لديك إذن لتغيير مرحلة هذا السجل.',
+    pathStageChangeFailed: 'تعذر تغيير المرحلة.',
     linkCopied: "تم نسخ الرابط إلى الحافظة",
     commentFailed: "لم يُنشر تعليقك. لم يُحفظ أي شيء — يُرجى المحاولة مرة أخرى.",
     reactionFailed: "لم يُحفظ تفاعلك. يُرجى المحاولة مرة أخرى.",
 
@@ -1306,6 +1306,13 @@ const de = {
     pathStageLostCurrent: '{{stage}}, verloren, aktuelle Phase',
     pathStageLostUpcoming: '{{stage}}, verloren, nicht erreicht',
     pathStageWonUpcoming: '{{stage}}, Zielphase, nicht erreicht',
+    pathStageChangeAction: 'Zu {{stage}} verschieben',
+    pathStageChangeTitle: 'Phase ändern?',
+    pathStageChangeDescription: 'Diesen Datensatz zu {{stage}} verschieben?',
+    pathStageChangeConfirm: 'Verschieben',
+    pathStageChangeConflict: 'Jemand anderes hat diesen Datensatz geändert; die aktuelle Version wird jetzt angezeigt. Klicken Sie erneut auf die Phase, wenn die Verschiebung weiterhin gilt.',
+    pathStageChangeDenied: 'Sie sind nicht berechtigt, die Phase dieses Datensatzes zu ändern.',
+    pathStageChangeFailed: 'Die Phase konnte nicht geändert werden.',
     linkCopied: "Link in die Zwischenablage kopiert",
     commentFailed: "Ihr Kommentar wurde nicht veröffentlicht. Es wurde nichts gespeichert – bitte versuchen Sie es erneut.",
     reactionFailed: "Ihre Reaktion wurde nicht gespeichert. Bitte versuchen Sie es erneut.",
 
@@ -1433,6 +1433,13 @@ const en = {
     pathStageLostCurrent: '{{stage}}, closed lost, current stage',
     pathStageLostUpcoming: '{{stage}}, closed lost, not reached',
     pathStageWonUpcoming: '{{stage}}, goal stage, not reached',
+    pathStageChangeAction: 'Move to {{stage}}',
+    pathStageChangeTitle: 'Change stage?',
+    pathStageChangeDescription: 'Move this record to {{stage}}?',
+    pathStageChangeConfirm: 'Move',
+    pathStageChangeConflict: 'Someone else changed this record, and the latest version is now shown. Press the stage again if the move still applies.',
+    pathStageChangeDenied: "You don't have permission to change this record's stage.",
+    pathStageChangeFailed: 'The stage could not be changed.',
     linkCopied: 'Link copied to clipboard',
     commentFailed: 'Your comment was not posted. Nothing was saved — please try again.',
     reactionFailed: 'Your reaction was not saved. Please try again.',
 
@@ -1347,6 +1347,13 @@ const es = {
     pathStageLostCurrent: '{{stage}}, perdida, etapa actual',
     pathStageLostUpcoming: '{{stage}}, perdida, no alcanzada',
     pathStageWonUpcoming: '{{stage}}, etapa objetivo, no alcanzada',
+    pathStageChangeAction: 'Mover a {{stage}}',
+    pathStageChangeTitle: '¿Cambiar de etapa?',
+    pathStageChangeDescription: '¿Mover este registro a {{stage}}?',
+    pathStageChangeConfirm: 'Mover',
+    pathStageChangeConflict: 'Otra persona ha modificado este registro y ahora se muestra la versión más reciente. Vuelve a pulsar la etapa si el cambio sigue siendo válido.',
+    pathStageChangeDenied: 'No tienes permiso para cambiar la etapa de este registro.',
+    pathStageChangeFailed: 'No se ha podido cambiar la etapa.',
     linkCopied: "Enlace copiado al portapapeles",
     commentFailed: "Tu comentario no se ha publicado. No se ha guardado nada; inténtalo de nuevo.",
     reactionFailed: "Tu reacción no se ha guardado. Inténtalo de nuevo.",
Original file line number	Diff line number	Diff line change
`@@ -1805,6 +1805,11 @@`
`1805`	`1805`	`"type": "array",`
`1806`	`1806`	`"of": "object",`
`1807`	`1807`	`"description": "Explicit stage definitions [{ value, label }] (else derived from field metadata)"`
	`1808`	`+ },`
	`1809`	`+ {`
	`1810`	`+ "name": "allowStageChange",`
	`1811`	`+ "type": "boolean",`
	`1812`	+ "description": "Let the reader change the record's stage by pressing a stage on the path (default: off, a read-only progress rail). Each press asks for confirmation, then saves `statusField` through the record's ordinary update, guarded by the record's version, so the object's state machine and validation rules decide; a refused move is shown under the path. Stages are pressable only for a reader who may edit `statusField` on this record, and not while the record's inline edit holds unsaved changes."
`1808`	`1813`	`}`
`1809`	`1814`	`]`
`1810`	`1815`	`},`