[finding] driver-sql / driver-mongodb 的 docblock 断言「reference_to is a REJECTED ALIAS, not a normalised one」在 #13847 后半陈旧——存量/migrate 路径现已归一化,编写面才仍是纯拒绝

[os-warren]

Found during #13700(PR #13847)收口移交,pre-existing 文档漂移的镜像面;filed unassigned 供分诊。无严重度断言。

The shape

两处驱动 docblock 逐字断言 reference_to 是「REJECTED ALIAS, not a normalised one」:

• packages/drivers/driver-sql/src/sql-driver.ts([finding] docs vs driver disagree on whether lookup columns get a real FOREIGN KEY — and the driver branch keys on reference_to, not reference #11567 现场)
• packages/drivers/driver-mongodb/src/mongodb-schema.ts:114(driver-mongodb indexes lookup joins off reference_to — a key the spec REFUSES — so no authored lookup field has ever been indexed on MongoDB #13222 现场)

PR #13847 落地 field-reference-to-alias conversion(retiredFromLoadPath)后,这句话只对编写面为真:FieldSchema 仍命名拒绝,但存量 sys_metadata 再水化与 os migrate meta 现在归一化该键。两处 docblock 需要补半句(编写面拒绝 / 存量归一化的分割),否则下一个读者会从驱动注释推出「存量 reference_to 永远原样」的错误结论。

修复方向

纯注释对齐,S 机械;跨包(drivers),#13847 尊重文件面申报未顺手改。措辞可引 conversion registry 里 fieldReferenceToAlias docblock 的分割表述。

Refs

• serve 面保证 stored metadata 规范拼写：reference_to → reference 归一化 + spec 裁定 reference_field/referenceField 协议归属（ui#6837 半 1） #13700 / PR Add field-reference-to-alias conversion so stored reference_to serves as reference #13847 — conversion 落地现场(其 registry docblock 已写清双面分割)
• [finding] docs vs driver disagree on whether lookup columns get a real FOREIGN KEY — and the driver branch keys on reference_to, not reference #11567 · driver-mongodb indexes lookup joins off reference_to — a key the spec REFUSES — so no authored lookup field has ever been indexed on MongoDB #13222 — 两句断言各自的引入现场

[os-warren]

第二实例并入(#13632/PR #13927 收口移交):packages/drivers/driver-mongodb/src/__tests__/mongodb-13222-reference-to-refusal.test.ts 的注释记录「两种 targetless lookup 形状在 FieldSchema 上 parse successfully」——测量当时为真,PR #13927(lookup/master_detail 要求非空 reference)落地后陈旧。与本卡主体同类:驱动侧散文断言被 spec 收紧甩在身后。修复时一并一行刷新。

---

Generated by Claude Code