retire page-header 的 description legacy alias —— 上游 conversion page-header-subtitle-alias 已 live,subtitle ?? description 回退具备退役条件

[yinlianghui]

状态(2026-08-08,objectui 分片 PM):测量门未过,阻塞于上游。
Blocked-by: objectstack-ai/objectstack#6775

阶段 1 实测(报告见评论):conversion page-header-subtitle-alias 虽 live,其 page-component 走查面只有 pages[].regions[].components[] 一层(walk.ts:193 mapPageComponents),7 条绕过路径不被改写,含 spec-valid 的 slots.header(objectui 文档推荐写法)与容器嵌套 properties.children[] —— #3226「现在删会静默丢副标题」的裁定原样成立。阶段 2 未启动,零代码改动。上游 #6775(走查面与 lint 的 page-walk.ts 对齐)落地后须重新测量再派发,不得复用本次测量。

---

以下为原正文:

跨仓跟进单(objectui 分片 PM 按 linkage-chore 规则代立,不认领)。#3226 PM 裁定「现在删 description 会让存量页面静默丢副标题」的前提是上游 conversion 未落地 —— 该前提已变化:

上游现状(objectstack origin/main,2026-08-08 实读)

• ADR-0087 D2 conversion 条目 page-header-subtitle-alias 已落地:docs/protocol-upgrade-guide.md:273 标 live — protocol 17 loader accepts the old shape;
• 语义:加载期(defineStack / validate / lint)把 page.component.page-header.description 改写为 subtitle(spec CHANGELOG 089767f,objectstack#4827;#5509 已入 retired-keys 登记);
• packages/lint/src/authoring-rules.ts:550 与 validate-component-props.test.ts:362 均以该改写为前提。

任务(测量门控 —— 先测后删,测不过即停)

1. 测量:核实 objectui 实际消费的 @objectstack/spec 版本包含该 conversion;枚举 objectui 侧所有 page-header 元数据进入渲染器的路径,确认每一条都经过执行改写的 loader(若存在 raw JSON 直喂 ComponentRegistry、绕过 loader 的路径,逐一列出)。
2. 测量通过则退役:删 packages/layout/src/PageHeader.tsx 的 description prop(:36)与 :143 的 subtitle ?? description 回退;清 packages/layout/src/index.ts:41-49 注释里的退役条件;同步 content/docs/layout/page-header.mdx 的 legacy 段与 content/docs/guide/layout.md Schema API 中的 legacy 行(PR docs(layout): page-header 两处文档按组件实读收敛到 subtitle,删掉不存在的 breadcrumbs #3785 的措辞已指向本单)。追加:packages/layout/README.md:49 也在教 <PageHeader description>,一并进 done-when;退役 pin(page-header-authorable-keys.test.tsx 末两测试)按其 SEQUENCING 注释与回退同一 change 删除。
3. 发现绕过路径则停:挂 needs_decision,附绕过面清单 —— 那时删除仍会静默丢副标题,page-header 与 page:header 对外声明了两套 authorable 键:description vs subtitle,消费端用 ?? 兜底 #3226 裁定继续有效。(2026-08-08:已触发,见状态头。)

语义化版本

删公开 prop 是 breaking:结合 check-changeset-no-major 门禁与仓内退役先例(PR #3793:fixed-group 下 minor + 正文写明破坏面)定档;两难无解时上报,不许静默降档。

Refs

#3226(原裁定)、#3267 / PR #3785(文档面,本单的措辞锚点)、objectstack#4827 / #5509、ADR-0087 D2、objectstack#6775(阻塞项)。

[yinlianghui]

🔒 认领(objectui 分片 PM,session_01GTRjn8xBqp75dk7kFupVRt)

• 分支:claude/issue-3789-page-header-description-retire
• 文件面:测量阶段只读;退役阶段 packages/layout/src/PageHeader.tsx + packages/layout/src/index.ts + content/docs/layout/page-header.mdx + content/docs/guide/layout.md(PR docs(layout): page-header 两处文档按组件实读收敛到 subtitle,删掉不存在的 breadcrumbs #3785 刚合入的措辞为锚点)。与在飞 记录页头的动作谓词走遗留 JS 求值器而非 CEL：.size() / .contains() / in / today() 在详情页一律抛错并静默隐藏按钮 #3521/record:highlights block 的 inputs 声明 readonly,使其进入 sdui.manifest.json(objectstack#5176 裁定 A 的 objectui 半边) #3407/ApproveOutcome/RejectOutcome 是 spec approve/reject 响应的手写镜像,已漂移(id 根本不在响应里),且因改名躲过 spec-symbol 守卫 #3783/DatasetWidget:metric 卡接上 widget.colorVariant 强调色 —— 让 spec 已声明、16 处已授权的键 declared = enforced(objectstack#5010 裁决 B) #3359 文件面不相交。
• 门控纪律:先测后删 —— 枚举所有 page-header 元数据到达渲染器的路径并证明每条都经过执行改写的 loader;发现绕过路径立即停在 needs_decision(那时 page-header 与 page:header 对外声明了两套 authorable 键:description vs subtitle,消费端用 ?? 兜底 #3226 裁定继续有效),不许带着未证明的前提删 prop。

即将派发 os-dev 实施。

---

Generated by Claude Code

[yinlianghui]

📋 测量门裁定(objectui 分片 PM,session_01GTRjn8xBqp75dk7kFupVRt):未过 —— 转 pm:blocked,Blocked-by objectstack#6775,解除认领。

实施 dev 阶段 1 只读测量(零代码、零 PR,正确停手)证伪了本单前提的关键一步:「conversion live ⇒ 每条路径都被覆盖」不成立。page-header-subtitle-alias 的走查面只有 pages[].regions[].components[] 一层(walk.ts:193),实测 7 条绕过路径不被改写,其中最重的两条是 spec-valid 的:slots.header(objectui 自家 slotted-pages.md 推荐写法,示例 regions: [] 使走查器零访问)与容器嵌套 properties.children[](对照:objectstack lint 的 page-walk.ts 会下钻 —— 同仓两个走查器覆盖面不同,conversion 建在浅的那个上)。删 subtitle ?? description 会在这些形状上静默丢副标题 —— #3226 裁定原样成立。

路线裁定:A 案为缺省(修上游走查面,objectstack#6775 已立并转 objectstack 车道)—— 它是生产端契约优先修法,顺带修掉每条建在 mapPageComponents 上的 page-component conversion 的同一个洞;B(objectui 自建第二个 conversion 执行器)违背 Prime Directive #12;C 即 #3226 已否且现有实测非空丢失集;D(删除+dev 警告)是对 #3226 保证的明示降级,仅维护者可选,如需不等上游解锁可在本单点名。#6775 落地后重新测量再派,不复用本次测量;届时 done-when 含 packages/layout/README.md:49 与退役 pin 的 SEQUENCING 同批删除(正文已更新)。

---

Generated by Claude Code