feat(bus): add pkg/bus skeleton and Bus interface

[Flo4604]

What does this PR do?

Fixes # (issue)

If there is not an issue for this, please create one first. This is used to tracking purposes and also helps us understand why this PR exists

Type of change

• Bug fix (non-breaking change which fixes an issue)
• Chore (refactoring code, technical debt, workflow improvements)
• Enhancement (small improvements)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

How should this be tested?

• Test A
• Test B

Checklist

Required

• Filled out the "How to test" section in this PR
• Read Contributing Guide
• Self-reviewed my own code
• Commented on my code in hard-to-understand areas
• Ran pnpm build
• Ran pnpm fmt
• Ran make fmt on /go directory
• Checked for warnings, there are none
• Removed all console.logs
• Merged the latest changes from main onto my branch with git pull origin main
• My changes don't cause any responsiveness issues

Appreciated

• If a UI change was made: Added a screen recording or screenshots to this PR
• Updated the Unkey Docs if changes were necessary

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
dashboard	Ready	Preview, Comment	May 13, 2026 10:58am

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 46792f6d-25ea-4fd4-9e83-0e9b3df0c653

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch 05-05-feat_bus_skeleton

---

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

[Flo4604]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• chore: delete pkg/cluster, proto/cluster, WAN gossip fields #6177
• chore(metrics): drop pkg/cache/clustering/metrics #6176
• feat(bus): admin Pause/Resume on loopback listener #6175
• feat(svc): wire bus.New in api and frontline run.go #6174
• feat(cache): collapse pkg/cache/clustering onto pkg/bus #6173
• feat(bus): replay-on-join via Serf query #6172
• feat(bus): add Serf-backed Bus implementation #6171
• feat(bus): add pkg/bus skeleton and Bus interface #6170 👈 (View in Graphite)
• feat: gossip rfc #6050
• main

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