chore: remove toast code, delete planning docs, rewrite README

[ComBba]

Summary

• Remove all toast/showToast code paths from source (plugin.ts, coexistence.ts, api.ts, channels/) and tests (5 files updated)
• Delete dead code: emit-controller.ts, channels/toast.ts, emit-controller.test.ts
• Delete 18 planning/spike documents from root and docs/ that were internal development artifacts
• Rewrite README.md as a clean product page with npm/CI/license badges
• Rewrite AGENTS.md to reflect the shipped architecture
• Update installation.md to remove toast-related env vars

Details

Toast removal

Toast was an early output channel that was superseded by the blockquote output channel. All toast-related code, types, configs, and tests have been removed:

• HudChannelMode, channelMode, showToast, usageWantsToast, buildAssistantUsageToast — all gone
• emit-controller.ts (192 lines) and channels/toast.ts (3 lines) — deleted
• Coexistence module simplified to prompt + publisher only
• 332 tests pass (down from 337 — 5 toast-specific tests removed)

Docs cleanup

Removed 18 internal planning documents that were development artifacts, not user-facing:

• Architecture analyses, implementation issues, behavior matrices
• Release checklists, rollback drills, spike documents
• Compatibility matrices, version pin policies

README rewrite

Clean product page format: what it does, install, features, format table, config table, uninstall.

Verification

• npm run ci passes (typecheck + 332 tests + build)
• Zero LSP errors across all changed files

[gemini-code-assist]

Warning

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

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, add credits to your account and enable them for code reviews in your settings.

[coderabbitai]

Warning

Rate limit exceeded

@ComBba has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 27 minutes and 20 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📥 Commits

Reviewing files that changed from the base of the PR and between 3b7a803 and ecf2a0a.

📒 Files selected for processing (33)

• AGENTS.md
• OH_MY_OPENCODE_ARCHITECTURE_ANALYSIS.md
• OPENCODE_ARCHITECTURE_ANALYSIS.md
• OPENCODE_HUD_EVENT_CONTRACT_ALLOWLIST.md
• OPENCODE_HUD_IMPLEMENTATION_ISSUES.md
• OPENCODE_HUD_OUTPUT_CHANNEL_BEHAVIOR_MATRIX.md
• OPENCODE_HUD_UNIVERSAL_PLAN.md
• OPENCODE_HUD_UNIVERSAL_PLAN_VNEXT.md
• PHASE5_PROVIDER_USAGE_API_PLAN.md
• README.md
• docs/COEXISTENCE.md
• docs/COMPATIBILITY_MATRIX.md
• docs/COMPATIBILITY_MATRIX_TEMPLATE.md
• docs/MVP_ACCEPTANCE_CHECKLIST.md
• docs/TMUX_RUNTIME_VALIDATION.md
• docs/VERSION_PIN_POLICY.md
• docs/guide/installation.md
• docs/releases/ALPHA_CHECKLIST.md
• docs/releases/BETA_CHECKLIST.md
• docs/releases/BETA_ROLLBACK_DRILL.md
• docs/spikes/P4_TRANSPORT_FEASIBILITY_SPIKE.md
• src/api.ts
• src/plugin.ts
• src/runtime/channels/index.ts
• src/runtime/channels/toast.ts
• src/runtime/coexistence.ts
• src/runtime/emit-controller.ts
• tests/baseline-validation.test.ts
• tests/coexistence.test.ts
• tests/emit-controller.test.ts
• tests/plugin-api-usage.test.ts
• tests/plugin-entrypoint.test.ts
• tests/publisher.test.ts

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch chore/cleanup-and-readme-rewrite

---

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