`owner` widget 拿不到表单下发的 dataSource,而 plugin-grid 认为它需要 —— 且 `owner` 根本不在 spec 的 FieldType 里(enforce-or-remove 待判)

[yinlianghui]

发现于 #4790 的实施(表单 data-source 允许表收敛)。测量副产物,不在该卡范围内,单独立此单。

事实(实读 origin/main @ f2dc8fa)

1. packages/fields/src/field-type-alias.ts:105 把字段类型 owner 映射到 field:owner;packages/fields/src/index.tsx:2435 把 field:owner 注册到 UserField(与 user 同一个 widget);index.tsx:2190 另有 registerFieldRenderer('owner', UserCellRenderer) 管单元格展示。即 owner 在本仓是一个活的 widget 键。

2. 但 owner 不在 @objectstack/spec 的 FieldType 枚举里(17.0.0-rc.6,dist/percent-scale-DQMCB4dC.d.ts 的 declare const FieldType:… lookup / master_detail / tree / user / image … 全表 48 个成员,无 owner)。所以没有任何对象 schema 能声明 type: 'owner' —— 它只能经 widget: 'field:owner' 这条手写 SDUI 路径到达。

3. 两个消费面对它的判断相反:

   • packages/plugin-grid/src/components/bulkParamToField.ts:43 USER_WIDGET_TYPES = new Set(['user', 'owner']),并入 DATA_SOURCE_WIDGET_TYPES,批量动作对话框会给 owner 线上 dataSource(BulkActionDialog.tsx:600);
   • 对象表单的 data-source 规则(DATA_SOURCE_FIELD_TYPES(form 层)与 core 的 EXPANDABLE_FIELD_TYPES 已知不同集且零 gate —— 同 #4770 的第二张允许表待收敛 #4790 后是 needsDataSourceWiring,此前是 DATA_SOURCE_FIELD_TYPES)不含 owner —— 实测 probe(真渲染 field:owner,跑完即删)读数:{hasDataSource:false, hasDependentValues:false, hasDependsOnLabels:false},与 field:user 修复前完全同形。

4. 同一 probe 还读到 field:grid 三项皆 false。而 packages/fields/src/widgets/types.ts:166 的 dataSource TSDoc 写的是「DataSource for widgets that query records (lookup / user / object-ref / recipient-picker / grid). Injected by the form renderer for the field types that need it」—— grid 从来不在任何 data-source 表里,GridField.tsx 也 grep 不到 dataSource。这句契约文档的 grid 是零消费者的声明。(user 那半已由 DATA_SOURCE_FIELD_TYPES(form 层)与 core 的 EXPANDABLE_FIELD_TYPES 已知不同集且零 gate —— 同 #4770 的第二张允许表待收敛 #4790 / PR 补齐。)

影响

• owner:手写 widget: 'field:owner' 的字段落到 UserField → LookupField。dataSource / dependentValues 各有 SchemaRendererContext 兜底,所以有 provider 时能瘸着跑;dependsOnLabels 没有任何兜底,于是带 depends_on 的 owner 选择器把裸 API 名插进「先选 … 」提示句 —— objectstack#5407 给 lookup 关掉、这里仍开着的同一个洞。
• grid:纯文档失真,今天没有用户碰得到。

需要裁决的是「接线还是退役」,不是补一个 string

owner 既然不是 spec 声明得出来的类型,把它加进表单的 DATA_SOURCE_ONLY_WIDGET_TYPES 等于新造一条 declared-but-unexercised 条目 —— 正是 ADR-0049 enforce-or-remove 要消灭的东西,也正是 #4790 这一族在关的失效模式。所以 #4790 的实施故意没有顺手加,留给分诊:

• A. 退役 owner 别名:删 field-type-alias.ts 的 owner 映射、index.tsx 的 field:owner 注册与 plugin-grid 的 USER_WIDGET_TYPES 成员,cell renderer 另议。前提是确认没有产品在用 widget: 'field:owner'。
• B. 承认它是一个 widget-hint-only 名(与 object-ref / filter-condition / recipient-picker同类),补进表单规则并在 paramValueShape.ts 之类的地方登记 widgetHintOnly: true,让「声明即强制」。
• grid 那句 TSDoc 无论 A/B 都应改掉或补消费者。

参考

• DATA_SOURCE_FIELD_TYPES(form 层)与 core 的 EXPANDABLE_FIELD_TYPES 已知不同集且零 gate —— 同 #4770 的第二张允许表待收敛 #4790 / 本卡 PR(表单 data-source 规则改为派生自 core 的 EXPANDABLE_FIELD_TYPES)
• packages/fields/src/field-type-alias.ts:104-105、packages/fields/src/index.tsx:2435、packages/plugin-grid/src/components/bulkParamToField.ts:43-46、packages/fields/src/widgets/types.ts:166

[os-zhuang]

Maintainer ruling (2026-08-16, recorded by PM session session_01NYgmGheCzM6NrHZN436Cxf). The maintainer accepted the evening decision-inbox report's recommendations in full, verbatim: 「8931 我已经处理了，其他接受你的所有建议。」 For this card:

Ruled: Option A — retire the owner alias, preconditioned on a zero-consumer measurement.

• Precondition (first step of the dispatch): search all four repos + examples/catalog for field:owner / 'owner' widget usage. Zero hits ⇒ proceed with A (drop the field-type-alias.ts mapping, the field:owner registration, and the USER_WIDget_TYPES membership in plugin-grid; cell renderer disposition per measurement). Any real consumer ⇒ fork report back to the decision box — do not migrate silently.
• Rationale on record: owner is not a spec FieldType, adds nothing over user (same widget), and is reachable only via hand-written SDUI with broken plumbing (dependsOnLabels has no fallback — the objectstack#5407 hole still open here).
• Either way: the grid claim in packages/fields/src/widgets/types.ts dataSource TSDoc (zero consumers) is corrected in the same batch.

First-touch grading completes: label flipped needs-user-decision → pm:queue in the same stroke.

---

Generated by Claude Code

[yinlianghui]

【认领】objectui 分片 PM(session_01GTRjn8xBqp75dk7kFupVRt)批次 12 派发,os-dev 实施。分支:claude/issue-4814-retire-owner-alias。

按 2026-08-16 维护者裁定(评论 5307574997)执行:方案 A 退役 owner 别名,前置零消费者测量 —— 第一步扫可达仓 + examples/catalog 的 field:owner / 'owner' widget 用法(零命中须带邻近词反查;任何真消费者 ⇒ 停手回报决策箱,⛔ 静默迁移);零消费者 ⇒ 删 field-type-alias.ts 映射、index.tsx 的 field:owner 注册、plugin-grid USER_WIDGET_TYPES 成员(cell renderer 按测量定夺)。types.ts dataSource TSDoc 的 grid 零消费者声明同批更正。

文件面:packages/fields/src/field-type-alias.ts、packages/fields/src/index.tsx、packages/plugin-grid/src/components/bulkParamToField.ts、packages/fields/src/widgets/types.ts + 测试。与在飞 #4788(⛔ widgets 零改动)、#4824(TextAreaField/RichTextField)无文件交集。

---

Generated by Claude Code

[yinlianghui]

测量结论:前置零消费者条件 不成立 —— 停手,未迁移,无 PR

按裁定评论 5307574997 的前置条件执行第一步扫描。结果:owner 不是零消费者。命中 3 处代码 + 4 处文档/示例消费面,其中一处是裁定与本单正文都未列出的第三个代码消费者。按「Any real consumer ⇒ fork report back to the decision box — do not migrate silently」,本次不实施退役、不开 PR,把命中清单交回决策箱。

扫描面(诚实记录)

仓	版本	状态
objectstack-ai/objectui	origin/main @ 1ef236e18	全仓已扫(含 examples/schema-catalog、content/docs、apps、scripts)
objectstack-ai/objectstack	origin/main @ d491625c1	全仓已扫(含 examples/app-showcase、content/docs、packages/spec)
objectstack-ai/cloud	—	未扫描 —— 本会话凭据无访问权(add_repo 返回 "you don't have access to objectstack-ai/cloud")。裁定要求的「四仓」我只够到两仓,这一面是空白,不是绿。

扫描器反查对照(证明零命中处确实是零、而不是扫描器没够到):field:user 在 objectui 命中 3 文件;type: 'user' 在 objectstack 命中 8 处以上(含 examples/app-showcase/src/automation/flows/*.flow.ts)—— 即扫描确实到达了两仓的 examples / docs / metadata 面。

真消费者命中(widget 键 / 字段类型命名空间)

代码 3 处,全部在活路径上:

1. packages/app-shell/src/utils/paramToField.ts:94 —— if (LOOKUP_WIDGET_TYPES.has(type) || type === 'user' || type === 'owner')。本单正文与裁定都没列这一处;它是 plugin-grid bulkParamToField 的孪生面(后者注释自陈 "mirrors app-shell's paramToField")。只删裁定点名的三处,会把这一支留成悬空分支。
2. packages/plugin-grid/src/components/bulkParamToField.ts:43 —— USER_WIDGET_TYPES = new Set(['user', 'owner'])(裁定已点名)。
3. packages/fields/src/index.tsx:2190 —— registerFieldRenderer('owner', UserCellRenderer)。它被现有门钉住:packages/fields/src/field-type-coverage.test.ts:48 的 CELL_RENDERER_TYPES 显式含 'owner',断言「resolves "owner" to a dedicated cell renderer (not TextCellRenderer)」。删它 = 现有测试直接变红。

示例 / 文档 4 处,用户可见,其中一条是被真实渲染的活例子:

4. examples/schema-catalog/src/schemas/fields-user/record-owner-read-only.json:9 —— "type": "owner"。它不是死文件:在目录索引里注册(examples/schema-catalog/src/index.ts:379 的 import、:3730 的条目),并被文档站渲染 —— content/docs/fields/user.mdx:18 是 < SchemaExample id="fields-user/record-owner-read-only" / >(此处 < 后特意加了空格,避开 GitHub 正文的 HTML 清洗;原文无空格)。它还被 examples/schema-catalog/test/fields-form-hosted.test.tsx 经真 SchemaRenderer + 真表单渲染器实跑。
5. content/docs/fields/user.mdx:24 —— 公开类型联合 type: 'user' | 'owner';;:93-94 的 "Permission Patterns" 可复制片段 { type: 'owner', name: 'owner', ... };正文「How it works」把 user / owner 并列描述为 sys_user 的特化 lookup。
6. content/docs/components/complex/filter-builder.mdx:27 —— FilterField.type 联合含 | 'user' | 'owner'。
7. content/docs/core/report-schema.mdx:99 —— 报表列 type 联合含 | 'user' | 'owner'。

顺带一提:fields-form-hosted.test.tsx 的文件头自陈这批 fields-* 例子是「the docs site's field demos and a few-shot retrieval source for AI authors, so what they show is what gets copied」—— 即第 4、5 条不只是文档,还是 AI 作者的抄写样本。

关键新事实:方案 A 按字面执行是静默降级,现有门只红一半

这一条决定了它不是「删三行」:

• 表单侧无门。mapFieldTypeToFormType 的未知类型兜底是 packages/fields/src/field-type-alias.ts:155 的 return typeMap[fieldType] || 'field:text';,resolveFormWidgetType 的兜底是 packages/fields/src/index.tsx:2486 的 return fieldWidgetMap[mapped] ? mapped : 'text'; —— 两者都是静默的,不告警不报错。而 field-type-coverage.test.ts 的 FORM_WIDGET_TYPES 名单里没有 owner(也没有 user),所以删表单别名不会让它红。
• 于是第 4 条那个目录例子会从人员选择器静默退化成一个普通文本框,而 fields-form-hosted.test.tsx 依然绿 —— 它只断言 form 元素存在、[data-field="record_owner"] 存在、label 文本 "Owner" 落在该字段的 chrome 里,一个 TextField 全部满足。文档站会展示一个错的示例,而没有任何门会报。
• 单元格侧有门且会红(上面第 3 条)。即现有测试对「删 cell renderer」变红、对「删表单别名」不变红 —— 两半方向相反。

这也顺带回答了派发里「cell renderer 按测量定夺」:它不但被 field-type-coverage.test.ts:48 钉住,还有文档(第 7 条)把 owner 当作报表/表格列类型宣传,即数据侧 owner 列确实会流到单元格路径。读数支持保留 cell renderer。

objectstack 的 4 处 type: 'owner' 不是消费者(不同命名空间)

packages/spec/src/conversions/registry.ts:354,365、packages/spec/src/security/sharing.test.ts:200、content/docs/permissions/permissions-matrix.mdx:184、content/docs/protocol/objectql/security.mdx:387 —— 全部是 sharing rule 的 type 判别式(sharingRules[].type),与字段 widget 类型无关。附带一提,那个 sharing 的 owner 规则形状自己也已经退役(sharing.test.ts:194 "should reject the retired owner-based rule shape")。同理,objectui 里 role === 'owner'(组织成员角色)与 "owner" 作字段名(dashboard / grid / report 示例)也都不算消费者,已逐条排除。

交回决策箱的问题

方案 A 的前提已被证伪,「A 还是 B」需重裁,且无论走哪条都多出一个迁移决定:

1. 目录例子 + 三处文档类型联合怎么处置? 若仍走 A,record-owner-read-only.json 必须同批迁到 type: 'user' —— 但那样它就和同目录的 single-user-selection 重复、失去存在理由,可能该连同 user.mdx 的 "Owner Field" 小节整条删除;三处公开类型联合也要去掉 'owner'。这是用户可见的文档契约收缩,不该由实施 agent 自行定夺。
2. 静默兜底要不要一并堵? 即便退役,field:text 静默兜底意味着任何存量手写 type: 'owner' 都会无声退化成文本框。要不要同批给「已退役 widget 名」加显式告警或拒绝(参照 field:capability-multiselect 的 TOMBSTONE 约定)?否则退役对线上手写 SDUI 是无声破坏 —— 而无声正是 ADR-0049 要消灭的那类失效。
3. paramToField.ts:94 这个第三消费者要不要纳入同一张单?它与 plugin-grid 那处必须同进同退,否则两个 param 面再次漂移 —— 正是 bulkParamToField 的注释想防的。

grid TSDoc 那一条(裁定说「无论 A/B 都改」)

已独立复核,零消费者属实:packages/fields/src/widgets/types.ts:166-167 的 dataSource TSDoc 写着 "(lookup / user / object-ref / recipient-picker / grid)",而 packages/fields/src/widgets/GridField.tsx 里 grep 不到 dataSource(零命中)。这一条与 owner 的 A/B 完全解耦,且只是注释。因为本单主体已停手,我没有单独为它开 PR(免得一个只改注释的 PR 挂在一张处置未定的单上),建议决策箱要么并入重裁后的批次,要么单独派一张小单 —— 请指示。

---

Generated by Claude Code

[yinlianghui]

【PM 处置 · 测量证伪前提,转回决策箱】objectui 分片 PM(session_01GTRjn8xBqp75dk7kFupVRt):pm:queue → needs-user-decision。dev 按 2026-08-16 裁定(评论 5307574997)的停手条款执行正确 —— 零消费者前置不成立,零代码零 PR 零 worktree,完整命中清单见 dev 评论 5308145625。

测量要点:①代码消费者 3 处,含裁定与正文都未列出的第三面 packages/app-shell/src/utils/paramToField.ts:94(plugin-grid bulkParamToField 的孪生,注释自陈互为镜像);②文档/示例消费者 4 处,其中 record-owner-read-only.json 被 content/docs/fields/user.mdx 真实渲染、被 hosted 测试实跑,且该测试文件自陈是 AI 作者的 few-shot 检索源;③方案 A 按字面执行是静默降级:表单别名走 field:text 兜底,删后无任何门变红、catalog 测试空绿(dev 已做红绿不对称预判:cell renderer 有钉、表单别名无钉);④objectstack 仓 owner-as-widget 真零(带 field:user 邻近词反查);⑤ cloud 仓未扫(凭据无权限),该面是空白不是绿。

重裁一问(dev 建议 B,PM 附议):

• A′ 完整退役:删 3 处代码消费者 + 迁移/删除 catalog 例子 + 收缩三处公开文档类型联合 + 必须为已退役键加显式拒绝/告警(否则 AI 作者从文档抄 type: 'owner' 无声得到文本框 —— A 不带显式失败等于亲手新增一类肉眼才能发现的元数据错误);
• B 承认 widget-hint-only:补进表单 data-source 规则 + 登记 widgetHintOnly: true,同批修掉 dependsOnLabels 无兜底(objectstack#5407 同源洞)。enforce-or-remove 的 enforce 侧同样合规,且此处 enforce 明显更便宜 —— owner 不是「无人用的顺手别名」,是 4 处公开契约在宣传的词汇。

附属两件随主裁:paramToField.ts:94 无论 A′/B 都与 plugin-grid 同单同进退(拆单必产生两面判断相反的时间窗);types.ts grid TSDoc 更正(零消费者已独立复核属实)并入重裁后批次。关联:#4815(Blocked-by 本单,继续持有)、#4855(dev 顺手立的 FORM_WIDGET_TYPES 守卫缺口 finding,排重裁后)。

---

Generated by Claude Code