fix(lint,cli): os lint / os compile 不再放行一个 os validate 会拒绝的 react 页面 (#4340 后续)

[os-zhuang]

#4340（#4353）后续。

validateReactPageProps 只手工接在 os validate 上，os lint 和 os compile 从来没跑过它：

$ grep -o "validateReferenceIntegrity\|validateReactPageProps" packages/cli/src/commands/{lint,compile,validate}.ts
lint.ts:    validateReferenceIntegrity
compile.ts: validateReferenceIntegrity
validate.ts:validateReferenceIntegrity  validateReactPageProps   ← 只有它

实测

在 showcase 的 react 页面植入一处 gating 违规——<ListView filters={['no_such_col','=',stage]}>，谓词命中不了任何行，SqlDriver 吞掉 "no such column" 后 return []，列表回空且与「本来就没数据」无法区分：

	os lint	os compile	os validate
修复前	exit 0 放行	exit 0 放行	exit 1 拒绝
修复后	exit 1 拒绝	exit 1 拒绝	exit 1 拒绝

干净语料上三个命令仍全部 exit 0。

「修复前」是把 suite 那一行 stash 掉、只重建 @objectstack/lint 后实测的，不是推断。

为什么漏接这一条特别贵

#4340 之后，这条规则已经是整个 react 页面表面唯一的字段解析闸门：

• <ListView> 的 columns/fields/sort/grouping/userFilters/hiddenFields/fieldOrder/filterableFields
• <ObjectForm> 的 fields、initialValues 键、sections[].fields[]、subforms
• record:* 一族 + <Block type="…">（与元数据表面共用同一张 COMPONENT_FIELD_SPECS）
• <ObjectChart> 的 aggregate / axes（<ObjectChart> aggregate result-column naming is undefined, so its axis bindings cannot be validated #3701/图表绑定方言统一：ObjectChart 运行时兑现 ChartConfig 后，把 react 契约与 lint 切回 spec 形状（#3701 后续） #3729）、searchableFields（lint: <ListView searchableFields> on a React page is not checked against the object's fields #4329）

所以漏接不是少几条警告——而是这些绑定在 build 路径上完全没人看，包括其中会 gate 的那些（缺必需绑定、filter 位置命名不存在的字段）。

改了什么

接入 REFERENCE_INTEGRITY_RULES，validate.ts 那处手工接线（import + 约 32 行）随之删除。三个命令的答案由构造保证一致，而不是靠三个人记得——这正是 suite 设立要终结的漂移（#3583 §5 D5），也是 validateReadonlyFlowWrites 在 #4394 里刚走过的同一条路：那次是「一张 config.fields map、两个检查、两套命令集合」，这次是「一次 JSX parse、七个 rule id、一套命令集合」。

删掉 validate.ts 的直接 import 不是顺手整理，是被 #4402 的接线守卫逼出来的——它断言三个命令都不许直接 import suite 成员，加进 suite 后不删就红。

一个 charter 上的诚实交代

按 suite 的 charter，react-prop-missing-required 和 react-prop-typo 是 shape 而非解析问题，本不属于这里。它们随行的理由与 validateActionBodyWrites 完全相同（其注释已写明）：落在同一次 parse 的同一份 source 上，拆成第二个 member 就要把每个 react 页面 parse 两遍去说同一次遍历的两件事，而改回手工接线正是 suite 要终结的漂移。

顺带更正了那条注释里 “The ONE member here that emits two rule ids” 的说法——现在不止一个了。

零行为变化

规则的 id、严重级、文案都不动。输入也不变：os validate 原本就传 result.data，suite 拿到的是同一个对象，所以 validate 侧连 finding 集合都完全一致（#4394 需要实测 pre/post-parse 等价，这次不存在这个问题）。惰性约定沿用 validateHookBodyWrites / validateActionBodyWrites——只有真的存在 kind:'react' 页面时才加载 TypeScript 编译器。

验证

• packages/lint 727 通过（suite 测试新增一个 react 页面 fixture + 一条 gating 断言）
• packages/cli 636 通过，含 test(cli): 钉住三个命令都跑 reference-integrity suite(#4384) #4402 的接线守卫
• typecheck / eslint 干净
• 两个 example app 在干净语料下 os lint / os validate / os compile 全部 exit 0

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
objectstack	Ignored		Jul 31, 2026 1:12pm

[github-actions]

📓 Docs Drift Check

This PR changes 2 package(s): @objectstack/cli, @objectstack/lint.

20 hand-written doc(s) reference the affected code and may need an implementation-accuracy re-verification:

• content/docs/ai/skills-reference.mdx (via packages/cli)
• content/docs/api/client-sdk.mdx (via @objectstack/cli)
• content/docs/api/data-flow.mdx (via @objectstack/cli)
• content/docs/api/environment-routing.mdx (via @objectstack/cli)
• content/docs/api/error-catalog.mdx (via @objectstack/cli)
• content/docs/automation/hook-bodies.mdx (via packages/cli, @objectstack/lint)
• content/docs/deployment/backup-restore.mdx (via @objectstack/cli)
• content/docs/deployment/cli.mdx (via @objectstack/cli)
• content/docs/deployment/self-hosting.mdx (via @objectstack/cli)
• content/docs/getting-started/your-first-project.mdx (via @objectstack/cli)
• content/docs/kernel/runtime-services/data-service.mdx (via packages/cli)
• content/docs/kernel/runtime-services/index.mdx (via packages/cli)
• content/docs/permissions/authentication.mdx (via @objectstack/cli)
• content/docs/permissions/authorization.mdx (via @objectstack/lint)
• content/docs/plugins/index.mdx (via @objectstack/cli)
• content/docs/plugins/packages.mdx (via @objectstack/cli)
• content/docs/protocol/kernel/plugin-spec.mdx (via @objectstack/cli)
• content/docs/protocol/kernel/realtime-protocol.mdx (via @objectstack/cli)
• content/docs/releases/implementation-status.mdx (via @objectstack/cli)
• content/docs/releases/v16.mdx (via @objectstack/cli)

Advisory only. To re-verify, run the docs-accuracy-audit workflow scoped to these files:
node scripts/docs-audit/affected-docs.mjs origin/main → pass the list as args.docs.