normalize: document the transforms as spec-bug workarounds to retire

main

Commit

Soph3mo ago

Reframe the normalizer's doc comment: both transforms exist only to compensate for bugs in the upstream OpenAPI document, and the goal is to delete the whole command once the spec is fixed at the source and ogen generates straight from core.openapi.json. Each transform now names the exact spec fix that retires it — non-nullable arrays for the type-union collapse, real per-operation success codes (201/204/200) for the 2XX collapse — and notes that fixing the response codes also removes the *…StatusCode wrapper the 2XX range forces.

Comment-only; regenerating produces an identical core.gen.json.

Co-Authored-By: Claude Opus 4.7 (1M context) noreply@anthropic.com Entire-Checkpoint: c63782f44a08

Checkpoints

CoreAPI Command Output and Mirror Improvements

CodexGPT-5.5
View session
Checkpoint 1

Integrate EntireDB Commands into CLI

Claude Code
View session
Checkpoint 1