Skip to content

docs(bifrost): operator guide + migration playbook + ADR-031 - #4975

Closed
KooshaPari wants to merge 1 commit into
diegosouzapw:mainfrom
KooshaPari:upstream-pr/bifrost-docs
Closed

KooshaPari wants to merge 1 commit into
diegosouzapw:mainfrom
KooshaPari:upstream-pr/bifrost-docs

Conversation

@KooshaPari

Copy link
Copy Markdown
Contributor

Summary

Cherry-picks 3 Bifrost Tier-1 documentation files from the v8.1 track work. Pure documentation, zero runtime change.

Files (3 changed, +886 / -0)

  • docs/frameworks/BIFROST-BACKEND.md (296 lines) — operator-facing guide covering activation, provider matrix, migration phases
  • docs/operations/bifrost-migration.md (412 lines) — 4-phase migration playbook (Inventory, Ladder, Cutover, Sustain) with 7 appendixes, 4 rollback procedures
  • docs/adr/0031-bifrost-tier1-router.md (178 lines) — canonical MADR-format decision record

Why this matters

  • diegosouzapw/OmniRoute has zero Bifrost-specific docs as of 2026-06-24 (just a 1-line mention in ENVIRONMENT.md)
  • New integrators hitting the sidecar integration get zero guidance
  • These 3 docs fill that gap and pre-stage the 30-day decision review

Compatibility

  • Pure documentation; zero runtime change
  • No new dependencies
  • Single landing; one commit

Refs: maximhq/bifrost (upstream), ADR-031 (this PR)

Cherry-picks 3 Bifrost Tier-1 documentation files from the v8.1 track
work that landed in the KP fork. Pure documentation; zero runtime
change.

### Files (3 changed, +886 / -0)

- docs/frameworks/BIFROST-BACKEND.md (296 lines) — operator guide
  covering activation, provider matrix, migration phases
- docs/operations/bifrost-migration.md (412 lines) — 4-phase
  migration playbook (Inventory, Ladder, Cutover, Sustain)
  with 7 appendixes and 4 rollback procedures
- docs/adr/0031-bifrost-tier1-router.md (178 lines) — canonical
  MADR-format decision record

### Why this matters

- diegosouzapw/OmniRoute has zero Bifrost-specific docs as of 2026-06-24
  (just the 1-line BIFROST_BASE_URL mention in ENVIRONMENT.md)
- New integrators hitting the sidecar integration get zero guidance
- These 3 docs fill that gap and are pre-staging for the 30-day
  decision review per ADR-031 § Decision Review

### Compatibility

- Pure documentation; zero runtime change
- No new dependencies
- Single landing; lands in one commit

Refs: maximhq/bifrost (upstream), ADR-031 (this PR)
@KooshaPari
KooshaPari requested a review from diegosouzapw as a code owner June 25, 2026 02:10
@gemini-code-assist

Copy link
Copy Markdown
Contributor

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@KooshaPari

Copy link
Copy Markdown
Contributor Author

Closing — base is main, not release/v3.8.36. The PR carries 676 files of a full fork-sync (i18n translations for 40+ locales, full docs/ tree, bin/ scripts, tray runtime, open-sse/ executors, hundreds of test files, CHANGELOG, README, electron/package.json). This is bulk-rebase noise, not a focused contribution.

The valuable forks are the focused refactor PRs (#4777 tokenRefresh extraction, #4778 apiKeyProviders constants) + the composite-tiers back-compat shim (#4979), all already on release/v3.8.36 and ready for review.

@KooshaPari KooshaPari closed this Jun 25, 2026
@KooshaPari
KooshaPari deleted the upstream-pr/bifrost-docs branch August 13, 2026 06:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant