chore: remove stale openapi.yaml

[willwashburn]

Summary

The root openapi.yaml documented an older "Agent Relay Daemon API" that no longer matches the broker's actual HTTP surface in crates/broker/src/listen_api.rs. It was orphaned — not referenced by docs, build tooling, or generated clients.

Drift examples

• /agents, /agents/{name}/kill, /release → consolidated under /api/spawned (DELETE /api/spawned/{name})
• /spawn → /api/spawn (auth required)
• /messages (GET/POST) → /api/send (history endpoint dropped)
• /who, /consensus/status → removed
• Many real endpoints missing from the YAML: /api/session{,/renew}, /api/config, /api/spawned/{name}/{model,subscribe,unsubscribe,snapshot,delivery-mode,pending,flush}, /api/agents/by-name/{name}/interrupt, /api/crash-insights, /api/threads, /api/agent-result, /ws

The authoritative API reference lives at web/content/docs/reference-broker-api.mdx.

Test plan

• CI passes (no references to openapi.yaml exist in the repo)

---

Generated by Claude Code

[gemini-code-assist]

Code Review

This pull request completely removes the OpenAPI specification file for the Agent Relay Daemon API. Since there are no review comments provided, there is no additional feedback to address.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 53874f88-aaad-49af-b83c-6be6a165cdb4

📥 Commits

Reviewing files that changed from the base of the PR and between 48bc831 and 10b99df.

📒 Files selected for processing (1)

• openapi.yaml

💤 Files with no reviewable changes (1)

• openapi.yaml

---

📝 Walkthrough

Walkthrough

The entire OpenAPI specification document (openapi.yaml) has been removed from the repository, eliminating the previously maintained REST API contract including all endpoint definitions, component schemas, and authentication configuration.

Changes

Cohort / File(s)	Summary
OpenAPI contract removal openapi.yaml	Complete removal of the OpenAPI specification file (486 lines). This includes all documented API endpoints (/health, /status, /agents, /spawn, /messages, /who, /metrics, /consensus/status), component schemas, and the apiKey security scheme definition.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Suggested reviewers

• khaliqgant

Poem

🐰 The spec once lived in YAML bright,
With paths and schemas, clean and tight,
But now it vanishes from sight—
A rabbit whispers, "Off you go!"
Let the contract live, let the old doc flow. ✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately summarizes the main change: removing the stale openapi.yaml file, which is the primary action in this changeset.
Description check	✅ Passed	The description covers required sections with clear context: explains what was removed and why (API drift), provides concrete examples, references the authoritative API docs, and includes a test plan.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch claude/zen-tesla-0oAEk

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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

[cubic-dev-ai]

No issues found across 1 file

_{Re-trigger cubic}