Skip to content

Refresh the gen:openapi exemption why in check-generated.ts with #5757's measured facts (one line, no gate) #6945

Description

@os-project-manager

Spun out of #5757's closure (maintainer ruling 2026-08-09, route A: close not planned, refresh the exemption text — 「全部接受」). This card is the documentation half only. ⛔ No gate is to be built — the measurement on #5757 established that a gate at this landing site would be green by construction (CI runs check:generated with --reconcile-only only, and a full run would sit after pnpm build checking a just-regenerated artifact).

Deliverable

Update the gen:openapi entry's why string in packages/spec/scripts/check-generated.ts to carry the two measured facts, replacing the now-stale reasoning:

  1. staleness cannot outlive one build of its own package — gen:openapi's inputs are a subset of the build task's inputs (build: gen:schema && gen:openapi && tsup, and json-schema/** is a turbo build output);
  2. the served document contains 0 $refs into components.schemas (post-[#5588 裁 C · 第二棒] build-openapi.ts 摘除 built-in 路由段生成 —— spec 静态产物只保留 components.schemas / info / securitySchemes #5744 it describes no routes to reconcile).

Keep the existing #5168/#5744 citations; add #5757 as the measurement source. One string, no behaviour change, no new checks.

Acceptance

check:generated output unchanged except the refreshed why; no new gate entries; the #5757 thread cross-linked.

Refs: #5757 (measurement + ruling), #5371, #5744, #5168.

Metadata

Metadata

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions