Pretty-print Vendored OpenAPI Spec · Entire

Fresh Branch Update

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 downloaded spec through jq . for better formatting. Then, pull fresh and commit.

Recent Changes:

• 2 weeks ago · 7 mins · 34 calls
  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.

Breakdown:

• 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.

Further Developments:

• 2 weeks ago · 3 mins · 13 calls
  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.

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.

Commit Message:

[c1e0559chore(coreapi): pretty-print vendored openapi spec via jq

Refresh docs now pipe the download through jq . so core.openapi.json lands multi-line instead of minified. Reformatted the spec in place; content-identical, core.gen.json, and generated client unchanged.

Co-Authored-By: Claude Opus 4.8 (1M context) noreply@anthropic.com
Entire-Checkpoint: d4905717debc+8440/-3](/content/gh/entireio/cli/commit/c1e0559064f1be3fc80c311a98bdc31173245a9b/index.html)