Skip to content

gen:schema silently drops PageTabsProps since #2967 — references regen would delete real docs #2978

Closed
#3012
Closed
gen:schema silently drops PageTabsProps since #2967 — references regen would delete real docs#2978
#3012
Assignees
os-zhuang

Description

@os-zhuang
os-zhuang
opened on Jul 15, 2026

现象

pnpm --filter @objectstack/spec build(gen:schema)日志:

⊘ UI.PageTabsProps: Transforms cannot be represented in JSON Schema (skipped)

#2967(conditional tabs,#2606 的 visibleWhen CEL 谓词)给 PageTabsProps 引入了 .transform,zod-to-json-schema 无法表示,build-schemas.ts 按既有策略静默跳过。后果链:

  1. json-schema/ui/PageTabsProps.json 消失(下游任何依赖 JSON Schema 校验/IDE 提示的场景失去该 schema);
  2. gen:docs 以 json-schema/ 为输入 → 全量重新生成 content/docs/references/ 会删除 ui/component.mdx 里整个 PageTabsProps 章节及其 import 列表条目——一个真实存在、刚发布的 schema 从公开参考文档消失;
  3. 已提交的 references 目前仍含 PageTabsProps(feat(spec): conditional tabs — page:tabs items accept a visibleWhen CEL predicate (#2606) #2967 合并时未 regen),处于「文档比管线正确」的倒挂状态——在修复前请勿全量 regen references。

建议

  • 修复:把 transform 改为 JSON-Schema 可表示的形态(z.preprocess/pipe 外移、或为文档/JSON-Schema 提供无 transform 的 source-shape 变体);
  • 加固:build-schemas.ts 对「上一次存在、本次消失」的 schema 应响亮失败(棘轮),静默跳过只适用于从未支持过的类型——否则任何人加一个 transform 都会无声地从 JSON Schema 面上撤下一个公开契约,违反 Prime Directive chore: version packages #10(declared ≠ delivered 不宣传的反面:delivered 却悄悄不再 declared)。

复现

pnpm --filter @objectstack/spec build 2>&1 | grep "PageTabsProps"
ls packages/spec/json-schema/ui/ | grep -i tabs   # 空
pnpm --filter @objectstack/spec gen:docs
git diff content/docs/references/ui/component.mdx  # PageTabsProps 章节被删

发现于品牌命名清理的 references 漂移排查(#2963 后续)。当前 references 与 spec 的其余漂移(ADR-0091/0095 时期 7 个文件)已被 #2965/#2967 等合并顺带修复,唯一剩余差异就是本回归。

🤖 Generated with Claude Code

https://claude.ai/code/session_0162o68e5w3bpUBEVRQboUGG

Activity

  1. os-zhuang
    self-assigned this
    on Jul 16, 2026
  2. os-zhuang
    closed this as completedin #3012on Jul 16, 2026
  3. akarma-synetal
    added a commit that references this issue on Jul 17, 2026

    fix(spec): gen:schema io:'input' fallback + disappearance ratchet — r…

    c435e29
  4. os-zhuang
    added 2 commits that reference this issue on Jul 28, 2026

    refactor(spec)!: drop the second field-prune orphan, ComputedFieldCac…

    826bfa9

    refactor(spec)!: 补完 2026-06 字段剪除 — 删除两个孤儿 value schema (#3726, #3733) (…

    f31cc8d
  5. xuyushun441-sys
    added a commit that references this issue on Jul 30, 2026

    fix(spec): move the generated artefacts with the deletions, and keep …

    a021d68
  6. os-zhuang
    added 2 commits that reference this issue on Jul 30, 2026

    refactor(spec)!: retire three orphan operator vocabularies (objectui#…

    3ca34c1

    ci(spec): retire the `generated` paths filter — every artifact gate m…

    c65e529
  7. akarma-synetal
    added a commit that references this issue on Aug 2, 2026

    feat(spec)!: converge the dual-source MetadataFormat and CacheStrateg…

    0222d3c
  8. os-zhuang
    added 3 commits that reference this issue on Aug 3, 2026

    feat(spec)!: 退役 RestServerConfig.openApi31 整块 —— declared ≠ enforced,…

    77cd00e

    feat(spec)!: EnvironmentArtifact 信封收敛为单一声明 —— C10 双源清账,./system 持活 wi…

    498b991

    feat(spec)!: EnvironmentArtifact 信封收敛为单一声明 —— C10 双源清账,./system 持活 wi…

    702ac73
  9. akarma-synetal
    added 7 commits that reference this issue on Aug 3, 2026

    fix(spec): anchor the Schema-suffix strip when deriving published sch…

    0c0fbd9

    feat(spec)!: 移除 `./automation` 的孤儿 `EventSchema` —— C6 双源清账,信封唯一真源在 `…

    51c5227

    feat(spec)!: 删除 ./system 的 declared-only tenant-provisioning 家族 —— C1…

    5647006

    feat(spec)!: 双源清账 C13+C15 —— 退役 L1「Simple Sync」整层,integration 冲突枚举改名 …

    891d345

    feat(spec)!: 退役 RestServerConfig.openApi31 整块 —— declared ≠ enforced,…

    695cfbd

    feat(spec)!: EnvironmentArtifact 信封收敛为单一声明 —— C10 双源清账,./system 持活 wi…

    9f601e8

    refactor(spec)!: retire the plugin-runtime family — the "Dynamic Load…

    d51bed2
  10. os-zhuang
    added a commit that references this issue on Aug 4, 2026

    chore(spec): 与 main 同步后整体重生成生成物(#5289 落地后)

    36ab4bb
  11. akarma-synetal
    added 2 commits that reference this issue on Aug 6, 2026

    refactor(spec)!: 退役 `HttpServerConfigSchema` —— 九个键零 reader 且没有任何作者面入口 (

    175d789

    feat(spec)!: 退役 NotificationActionSchema / EmbedConfigSchema —— 两个没有授…

    26e1029
  12. lemonhub-io
    added a commit that references this issue on Aug 8, 2026

    feat(spec)!: ADR-0049 enforce-or-remove —— ui/widget + ui/i18n 家族 13 …

    f7bd4e2
  13. akarma-synetal
    added a commit that references this issue on Aug 17, 2026

    feat(spec): retire ApiKeySchema — sys_api_key has one declaration, th…

    2c86fe3
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions