refactor: generate OpenAPI JSON and docs.json

[impoiler]

Summary

Briefly explain the purpose of this PR and the problem it solves.

Changes

• What was changed and why
• Any notable design decisions or trade-offs

Type of change

• Bug fix
• Feature
• Refactor
• Documentation
• Chore/CI

Affected areas

• Core (Go)
• Transports (HTTP)
• Providers/Integrations
• Plugins
• UI (React)
• Docs

How to test

Describe the steps to validate this change. Include commands and expected outcomes.

# Core/Transports
go version
go test ./...

# UI
cd ui
pnpm i || npm i
pnpm test || npm test
pnpm build || npm run build

If adding new configs or environment variables, document them here.

Screenshots/Recordings

If UI changes, add before/after screenshots or short clips.

Breaking changes

• Yes
• No

If yes, describe impact and migration instructions.

Related issues

Link related issues and discussions. Example: Closes #123

Security considerations

Note any security implications (auth, secrets, PII, sandboxing, etc.).

Checklist

• I read docs/contributing/README.md and followed the guidelines
• I added/updated tests where appropriate
• I updated documentation where needed
• I verified builds succeed (Go and UI)
• I verified the CI pipeline passes locally if applicable

[coderabbitai]

📝 Walkthrough

Summary by CodeRabbit

• Documentation
  • Added a governance API migration guide to the OSS documentation navigation.
  • Reorganized API documentation into categories for inference, integrations, platform, governance, and deprecated endpoints.
  • Expanded navigation for OpenAI-compatible, provider-specific, asynchronous, realtime, administrative, governance, and legacy APIs.
  • Clarified legacy audit-log endpoints for listing, filtering, exporting, lookup, and verification while retaining compatibility aliases.

Walkthrough

The API documentation navigation now covers categorized inference, integration, platform, governance, and deprecated endpoints. The OpenAPI specification repositions legacy audit-log route declarations and retains their existing references.

Changes

API Documentation and Governance

Layer / File(s)	Summary
Migration guide and inference navigation docs/docs.json	Adds the governance namespace migration guide and expands inference API entries.
Integration and platform navigation docs/docs.json	Adds categorized integration and platform API documentation entries.
Governance and deprecated navigation docs/docs.json	Adds governance API groups and documents legacy routes in a Deprecated API section.
Legacy audit-log route definitions docs/openapi/openapi.yaml	Moves the legacy audit-log declarations and adds a labeled alias block with the existing specification references.

Estimated code review effort: 4 (Complex) | ~45 minutes

Possibly related PRs

• maximhq/bifrost#5838: Synchronizes related API navigation and deprecated-operation documentation.
• maximhq/bifrost#5840: Restructures related governance OpenAPI specifications and legacy audit-log definitions.
• maximhq/bifrost#5841: Updates related governance migration and legacy audit-log documentation.

Suggested reviewers: akshaydeo, bearts

🚥 Pre-merge checks | ✅ 2 | ❌ 3

❌ Failed checks (3 warnings)

Check name	Status	Explanation	Resolution
Linked Issues check	⚠️ Warning	The changes do not implement or document the requested File APIs, including POST /v1/files, from issue [#123].	Implement the provider File APIs and document their supported workflows, or replace [#123] with an issue that matches the documentation and audit-log changes.
Out of Scope Changes check	⚠️ Warning	The docs navigation update and legacy audit-log alias changes are unrelated to the linked Files API objective [#123].	Limit this PR to Files API support, or link the documentation and audit-log work to the correct issues and split unrelated changes.
Description check	⚠️ Warning	The description contains only the unfilled template and does not document the changes, testing, affected areas, risks, or checklist status.	Replace the template with a completed summary, change list, test steps, affected areas, breaking-change status, security considerations, related issues, and checklist results.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Title check	✅ Passed	The title identifies the main documentation-generation change and names the two primary generated artifacts.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch 07-29-refactor_api_structure

---

_{Comment @coderabbitai help to get the list of available commands.}

[impoiler]

• refactor: generate OpenAPI JSON and docs.json #5650 : 2 dependent PRs (#5652 , #6017 ) 👈 (View in Graphite)
• docs: add governance API namespace migration guide #5841
• docs(openapi): add missing management endpoints and split governance specs #5840
• refactor(governance): allow editions to override governance route families #5839
• chore(docs): add OpenAPI bundler and Mintlify nav sync scripts #5838
• feat: adds missing endpoints to e2e api tests #5831
• dev

This stack of pull requests is managed by Graphite. Learn more about stacking.

[coderabbitai]

Note

GitHub couldn't provide a complete incremental comparison for this pull request, so CodeRabbit is performing a full review instead. This review may take a little longer.

[akshaydeo]

Merge activity

• Aug 11, 7:01 AM UTC: A user started a stack merge that includes this pull request via Graphite.
• Aug 11, 7:07 AM UTC: Graphite rebased this pull request as part of a merge.
• Aug 11, 7:08 AM UTC: @akshaydeo merged this pull request with Graphite.

The base branch was changed.