[sweep] Restore the `X` / `XParsed` house convention in two more spec partitions (#5507 #5975)

[os-project-manager]

Sweep card (maintainer-directed, 2026-08-07). One claim, one PR, two Fixes.

Admission criterion

The X / XParsed house convention (bare name = z.input = what the author writes; XParsed = z.infer = post-parse shape, per shared/retry-policy.zod.ts's JSDoc) is not applied in this partition — the bare name is wrongly z.infer, or the author-side twin is missing entirely.

Shipped precedents to copy, not re-derive: #4963 / PR #5514 (automation/etl.zod.ts, nine aliases) and #5551 (integration/connector.zod.ts, twenty aliases, closed 2026-08-07).

#	Partition	Defect
#5507	automation/execution.zod.ts	seven X / XParsed pairs where both sides are z.infer — pure synonyms, so the convention conveys nothing; plus ScreenFieldConfig missing its Parsed twin
#5975	spec/src/cloud/ request types	only z.infer (output) exported, no Input twin — cloud-repo callers are forced to hand-write the defaults zod fills in

Same failure mode in both: the one bare annotation an author would naturally reach for (const x: Connector = {…}) does not compile, because defaulted keys are required in the parsed view.

Two things to settle inside the PR (state both explicitly)

1. Enum-class aliases are exempt — z.input and z.infer are identical for them; flipping is churn. Only object-shaped aliases have a real difference. Enumerate which members were exempt and why.
2. Importer surface across the three repos must be checked before renaming anything — integration/connector.zod.ts 的 20 个裸名别名仍是 z.infer,与 #4963 确立的 X / XParsed house convention 相反(作者写的是 ConnectorInput) #5551 was a real breaking rename precisely because its parse path was live. If a rename here is breaking, it needs its own changeset wording, not a silent flip.

Scope discipline

• Zero changes beyond the two partitions; git diff --stat corresponds to the checklist.
• ⛔ 150 个已发布 schema 没有配套的 export type 别名,reference 页给不出 import type 示例 #4593 is deliberately NOT a member. It reads as the same family but is a different class: it adds ~150 new export type aliases, expanding api-surface.json — a public-surface expansion its own body says needs a maintainer ruling (补齐 / 按需补 / 维持现状). It waits for that ruling; do not absorb it.
• Out-of-scope findings filed separately per PD chore: version packages #10.

Landing constraints

Type exports move api-surface.json ⇒ os-regen four-step序 on every sync; check:authorable-surface green as the anchor assertion; ⛔ never hand-edit the anchor.

Review shape

By checklist: one line per alias touched — name | before (z.infer/absent) | after (z.input + XParsed twin) — with the exempt enum list stated separately.

Filed unassigned. Member issues keep pm:queue but are excluded from batch selection while this card is open; both close with the PR.

[qq9340100]

认领(sweep 卡整卡认领,成员 #5507 #5975 两条 Fixes 一 PR;云端工头执行,交付降级通道)

• 会话:session_011M7UwH25Unfi73UHim7ajY(spec 车道执行 PM;dev 为云端工头会话,无 GitHub 工具 —— dev push 分支,PM 代开 PR)
• 分支:claude/issue-6488-xparsed-convention-sweep
• 文件面:packages/spec/src/automation/execution.zod.ts(七对同义别名翻正 + ScreenFieldConfigParsed 补行)+ packages/spec/src/cloud/(request 类型补 Input 孪生)+ 迁移面消费点(service-automation / contracts/automation-service.ts 若裸名翻转波及)+ api-surface/docs 生成链 + changeset
• 前置已核:成员 automation/ 里还有两处 X / XParsed 未兑现:execution.zod.ts 的七对别名两边都是 z.infer,ScreenFieldConfig 缺 Parsed #5507 经维护者授权 findings sweep(2026-08-08 00:40,[PM seat] triage (objectstack-wide) — 🟢 Routine #6015 登记)晋级,08-05 的 hold(迁移面不为空)由该晋级解除;卡内两项待明说事项(枚举类豁免清单、三仓 importer 面核查 + breaking 措辞)已入派发令
• 在飞检查:与 150 个已发布 schema 没有配套的 export type 别名,reference 页给不出 import type 示例 #4593(system/ui/data 分区补别名)、ComparisonOperatorSchema 的 $gt/$gte/$lt/$lte 不含 string,与平台自己只产出字符串的日期宏解析器相矛盾 #5685(data/filter)、hook 注册契约只能表达「命中这些对象」,无法表达「全局但排除这些对象」—— #5860 因此在 plugin-audit 内无法落地 #5928(contracts/objectql-engine)、spec: ChartAggregateSchema 与 ChartGroupBySchema object 分支转 strictObject —— #5020 parse 接通后的收紧半边(#4001 后续批) #5583+把 44 个 strictUnknownKeyError 直调点批量迁到 strictObject,棘轮降到 0(路线 1 消不掉手抄数组与 shape 的漂移) #5593(ui/chart+直调点)、[sweep] Three routes serve a shape their responseSchema never declares (#5882 #5950 #6442) #6487(api/protocol+rest)文件面均不相交;api-surface 生成物共动按四步纪律吸收

---

Generated by Claude Code

[qq9340100]

关闭:两成员前提均被 upstream 吸收,零剩余工作(spec 车道 PM,session_011M7UwH25Unfi73UHim7ajY;工头 E 前提复核报告全文在分支 claude/issue-6488-xparsed-convention-sweep 的空提交 c012622dc,PM 已抽验)

• PR spec: ADR-0122 phase 2 — flip bare names to parsed semantics (#6083) #6279(ADR-0122 phase 2,53068c130,08-07 19:47Z 合并)把 packages/spec/src/**/*.zod.ts 全部 1384 个裸别名统一翻为 z.input,两成员分区均在覆盖内;其 commit message 明言吸收 automation/ 里还有两处 X / XParsed 未兑现:execution.zod.ts 的七对别名两边都是 z.infer,ScreenFieldConfig 缺 Parsed #5507 剩余范围。
• automation/ 里还有两处 X / XParsed 未兑现:execution.zod.ts 的七对别名两边都是 z.infer,ScreenFieldConfig 缺 Parsed #5507:七对已翻正(execution.zod.ts 裸名现均 z.input,PM 抽验 L203/L269/L413);ScreenFieldConfig 走 pin 路线(isomorphic,Iso753)—— 按 ADR-0122 此时补 Parsed 孪生反与 gate 分类相抵。迁移面三消费点消费的恰是 isomorphic 型(Eq 探针编译级证明 + 回退逆向验证 tsc 红,读数在报告),标注翻转为零类型效果的 churn,不做。
• spec/src/cloud/ 的 request 类型只导出 z.infer(OUTPUT)，没有 Input 孪生 —— cloud 仓调用方被迫手写 zod 自己负责填的默认值（#4963 house convention 的又一个分区） #5975:cloud/ 分区 93 个裸别名已全部翻转,双形状者配 Parsed、isomorphic 者已 pin;cloud 仓消费按 pin 滞后规则待 pin bump 统一消化(分叉窗口 08-07 19:47Z 起,方向已在报告留档)。
• 本卡 08-08 01:48 起草与成员晋级(00:40)均晚于 spec: ADR-0122 phase 2 — flip bare names to parsed semantics (#6083) #6279 合并却未对其后的 main 重验 —— 属过时读数,非流程失误的新形态;记入本关闭评论作后来者的判读先例:晋级/立卡时刻的前提核查须对当时 main,吸收类 upstream 尤其要查同族 ADR 的 phase 提交。

成员 #5507 / #5975 一并关闭,同引本据。

---

Generated by Claude Code