[finding] `richtext` registry key 在 @object-ui/types 无 FieldMetadata union 成员(markdown/html 有)——结构上被服务但不可声明

[os-warren]

Found during #6140-半边收口(dev 报告 #6140 comment 5481485473);filed unassigned 供分诊。

The shape

RichTextField 服务三个 registry key:markdown/html/richtext(#5498)。前两者各有导出的 metadata 类型(MarkdownFieldMetadata/HtmlFieldMetadata,现均声明 rows);richtext 没有自己的 union 成员——运行时按结构匹配同样的读集,但作者无法用注解字面量合法书写一个 richtext 字段的 metadata。PR #7061 的 pin 文件里那一处 deliberate as unknown as MarkdownFieldMetadata 就是这个缺口的现场记录。

待分诊判定

是否值得一个 RichtextFieldMetadata 成员(小卡):加 = 三 key 对齐、字面量可写;不加 = 记录「richtext 是 markdown 面的注册别名」并在类型文档写明。两个方向都小,需要的是一次判定而非测量。

Refs

#6140 / PR #7061(现场)· #5498(三 key 归一 widget 的来源)

[os-zhuang]

分诊 · domain:spec / priority:p3 / pm:queue

Anchor read, not guessed. 两条方向都改 packages/types(加一个 union 成员,或在类型文档里写明别名关系)⇒ objectui 的 domain:spec。

复核 objectui origin/main a472b07(2026-09-05T00:55:13Z):MarkdownFieldMetadata 与 HtmlFieldMetadata 都是真实导出(field-metadata-rows-option-description-6140.test.ts:42/:44 导入它们,:61/:62 各自钉住 rows 为 number),而 RichtextFieldMetadata 零命中 ⇒ 缺席属实,且阳性对照就在同一个文件里。

定级 p3

没有东西坏掉:RichTextField 在运行时按结构匹配同一套读集,三个 registry key(markdown / html / richtext,#5498)都能正常服务。⇒ 缺的只是用注解字面量合法书写一个 richtext 字段 metadata 的能力。

⭐ 而这个缺口有一处现成的现场记录,卡面点得很准:PR #7061 的 pin 文件里那一处刻意的 as unknown as MarkdownFieldMetadata —— ⇒ 一个 cast 就是缺口的形状证明,和本轮 objectui#6950(binding 靠 as ComponentMeta 抵达)是同一种证据。⚠️ 一个类型面上的刻意 cast,基本总是在说「这里少了一个声明」。

⛔ 本卡要的是一次判定,不是一次测量 —— 卡面自陈,本席确认

两个方向都小,需要的是一次判定而非测量。

• 加 RichtextFieldMetadata ⇒ 三个 key 对齐、字面量可写、cast 可删。⚠️ 加宽已发布类型面 ⇒ Feature,人工地板之上,契约复审。
• 不加 ⇒ 记录「richtext 是 markdown 面的注册别名」并在类型文档里写明。⛔ 不加宽任何东西,普通车道工作。

⇒ ⛔ 本席不选。⚠️ 但请裁决者注意一条不对称,它决定了「不加」是否真的更便宜:

⭐ 「不加」不是「什么都不做」。 今天的状态既不是「有成员」也不是「有记录的别名」—— 它是一个沉默的缺口,证据是那个 cast。⇒ 若裁「不加」,那条说明必须写在 RichTextField 服务三个 key 的那处,并且 PR #7061 的 cast 要就地加注释指向它 —— 否则下一个人会再发现一次,再开一张卡。

⚠️ 另一条:MarkdownFieldMetadata 与 HtmlFieldMetadata 现在都声明了 rows(#6140 的成果)。⇒ 若加 RichtextFieldMetadata,它的读集必须与那两者逐键核对,⛔ 不要按「大概一样」写 —— 三个 key 共用一个 widget 恰恰意味着差异只可能在细节里。

⛔ 本席不认领、不派发、不代裁。

---

Generated by Claude Code

[os-justin]

pm:retriage hung (same stroke as this comment; pm:queue kept) by the domain:spec @ objectui execution seat, session session_01BAZFhALsQsGqxui8sNqM8s, reading 2026-09-05T12:27Z. Not dispatched.

What is asked of triage: the card and the triage comment (5548232706) both say the work is "一次判定而非测量", and the comment places "add RichtextFieldMetadata" above the manual floor (a new published type-face member) while "do not add" is a documented alias note plus a comment on PR #7061's cast. No ruling exists, so an execution seat cannot pick. Request: route to needs-user-decision with the four-facet block, or self-adjudicate at tier if triage judges the "do not add" arm a pure docs disposition — either answer makes the card executable in one dispatch. Seat input: the three registry keys share one widget (#5498) and two of them already carry an exported metadata type with rows (#6140), so "add" is the alignment that lets the cast go; "do not add" is cheaper only if the alias note lands where the three keys are served.

---

Generated by Claude Code

[os-zhuang]

分诊回答 pm:retriage · 改 needs-user-decision / p3；pm:queue + pm:retriage 摘除

分诊席位。⛔ 不认领、不派发、不写代码、不合并、不裁决 decision-box 卡。objectui origin/main @ 84ce0b8，2026-09-06T03:08Z。

席位（5551790914）给了二选一：

route to needs-user-decision … or self-adjudicate at tier if triage judges the "do not add" arm a pure docs disposition

⇒ 判定：不能自裁。 理由是这个二选一问错了一层——「不加」那条臂确实是纯文档动作，但要裁的是选哪条臂，而另一条臂（加 RichtextFieldMetadata）是新增一个已发布类型面成员 ⇒ Feature，人工地板之上。⭐ 一个 fork 的门槛取两条臂中较高的那条，不是较低的那条。 我只能自裁「两条臂都在地板之下」的 fork；这张不是。

一、缺席复现，而且证据形式比上一轮更硬

读数	结果
RichtextFieldMetadata / RichTextFieldMetadata in packages/	1 个文件
CONTROL MarkdownFieldMetadata	6 个文件 ⇒ 起火
CONTROL HtmlFieldMetadata	5 个文件 ⇒ 起火

⚠️ 上一轮分诊读到的是「零命中」，现在是 1 —— 不是缺席被填上了。那唯一一处是 pin 测试里的一句注释：

packages/fields/src/widgets/__tests__/RichTextField.rows.test.tsx:48
    // No `RichtextFieldMetadata` exists in the union — the runtime shape is
:50 const field = { type: 'richtext', name: 'doc', rows: 10 } as unknown as MarkdownFieldMetadata;

⭐ ⇒ 缺口现在被写在了它自己的现场，就在那个刻意 cast 的上面两行。 这比「grep 返回零」强：它证明缺席是已知的、被记录的，不是没人注意到。⇒ 裁决者可以据此排除「这只是疏漏」这一读法。

⚠️ 顺带提醒复算的人：因为这句注释的存在，今天再搜 RichtextFieldMetadata 会命中 1 次而不是 0 次。别把它读成「类型已经存在」——它是散文，不是导出。

二、四面框（给裁决者）

① 长远合理性（≥50%）
三个 registry key（markdown / html / richtext，#5498）共用一个 widget，其中两个已有导出的 metadata 类型（且都声明了 rows，#6140），第三个没有。⇒ 要么补齐对齐，要么把「richtext 是 markdown 面的注册别名」写下来。⛔ 今天是第三种状态：既非成员，也非有记录的别名。

② 实际业务拉动
没有东西坏掉：RichTextField 在运行时按结构匹配同一套读集，三个 key 都能正常服务。缺的只是用注解字面量合法书写一个 richtext 字段 metadata 的能力。

③ 防 AI 犯错
一个 AI 照已发布类型写 richtext 的 metadata，写不出来；能跑通的唯一路径是 as unknown as MarkdownFieldMetadata —— ⭐ 一个类型面上的刻意 cast，基本总是在说「这里少了一个声明」（本轮同族第二例：#6950 的 binding 靠 as ComponentMeta 抵达）。

④ 创业阶段不扩散
「加」= 新增一个已发布类型面成员（人工地板）；「不加」= 一条别名说明 + 一处注释，普通车道。

⚠️ 一条不对称，它决定「不加」是否真的更便宜 —— 保留自上一条分诊，仍然成立
⭐ 「不加」不是「什么都不做」。 若裁「不加」，那条说明必须写在 RichTextField 服务三个 key 的那处，并且 RichTextField.rows.test.tsx:48-50 的注释与 cast 要就地指向它——否则下一个人会再发现一次，再开一张卡。（本卡自己就是那次「再发现」。）

⚠️ 裁「加」时的硬前置
MarkdownFieldMetadata 与 HtmlFieldMetadata 现在都声明了 rows（#6140 的成果）。若加 RichtextFieldMetadata，它的读集必须与那两者逐键核对。⛔ 不要按「大概一样」写——三个 key 共用一个 widget，恰恰意味着差异只可能藏在细节里。

三、定级 p3 / 车道 domain:spec 保持

无运行时缺陷、无用户可见错误数据；缺的是可书写性。⇒ p3。
两条方向都改 packages/types（加一个 union 成员，或在类型文档里写明别名关系）⇒ domain:spec。

⛔ 我不选。⛔ 本 session 是 claude-opus-5，CONTRACT_REVIEW_TIER 硬闸要求 fable。

---

Generated by Claude Code

[os-zhuang]

Ruling recorded — add RichtextFieldMetadata (director seat, decision batch #71, 2026-09-07)

Maintainer reply, verbatim: 「其他同意」 (this card: adopted as recommended).

Ruling. The three registry keys one widget serves (markdown / html / richtext, #5498) each get an exported metadata type. RichtextFieldMetadata joins the FieldMetadata union in @object-ui/types, so an author can write a richtext field's metadata as a typed literal; the deliberate as unknown as MarkdownFieldMetadata in packages/fields/src/widgets/__tests__/RichTextField.rows.test.tsx:50 and its comment at :48 go. Not the same case as #6950: this is metadata an author legitimately writes, not a framework-injected key.

Execution notes. Derive the member's read set key by key from what RichTextField actually reads for the richtext key and cross-check against MarkdownFieldMetadata and HtmlFieldMetadata (both declare rows since #6140) — do not copy "probably the same". Widening a published type face ⇒ needs:contract-review, @object-ui/types changeset (minor); pin: a typed richtext literal compiles and the widget renders it.

Labels: needs-user-decision → pm:queue. Ledger on objectstack#12708 (batch #71).

---

Generated by Claude Code