Pretty-print Vendored OpenAPI Spec

Claude Code·Fable 5·toothbrush·3mo ago·44min·2 Checkpoints·3 file changes·+8440/-3·35.5K tokens

fresh branch off origin/main. our vendored openapi json spec is horrible, it's just one line. adjust the script so that we run the downloded spec through jq . so it's nicely formatted. then, pull fresh and commit.

3mo ago·7m

Done. Committed on fresh branch vendor/openapi-jq-format (off origin/main), not pushed.

Bottom line: Refresh docs now pipe through jq .; vendored spec reformatted to 8456 lines. A true "pull fresh" was not safe — I reformatted the existing spec instead.

  • Why not a live pull: live upstream (us.console.entire.io) no longer serves the post/delete on /mirrors/collaborators (grantMirrorCollaborator/revokeMirrorCollaborator). Those were hand-authored into the committed spec ahead of deployment; a fresh pull drops them and breaks cmd/entire/cli. (I asked how to proceed; you were away, so I took the safe path.)
  • What I committed: jq . in the refresh docs (gen.go, normalize.go) + the existing core.openapi.json pretty-printed in place. Content is byte-identical modulo whitespace — verified via jq -S diff; regeneration produced zero changes to core.gen.json or the generated Go.
  • Verified: go build ./... OK, mise run fmt clean, mise run lint 0 issues.

If you want the actual upstream refresh, we need to either re-graft the grant/revoke ops each time or wait for upstream to ship them — say the word and I'll do the re-graft variant.

what we can do is create a PR with base https://github.com/entireio/cli/pull/1602, that will mean no ogen changes, just the jq formatting machinery.

3mo ago·3m

Done. PR #1603 → https://github.com/entireio/cli/pull/1603

  • Base: paul/mirror-suspended-warning-and-collaborator-cleanup (#1602), so the diff is exactly 3 files — no ogen churn.
  • Changes: gen.go + normalize.go refresh docs pipe through jq .; core.openapi.json reformatted multi-line in place.
  • Safe: spec content byte-identical modulo whitespace (jq -S diff), core.gen.json + generated client unchanged, build/fmt/lint all green.

Note: #1602 must merge first (or merge into your target) since #1603 stacks on it. The earlier standalone commit on vendor/openapi-jq-format (off main) is now superseded — leave it or delete it, your call.