# toast-host

## Intent
A singleton overlay for brief command-result feedback (AGENT.md §6 polish). It
gives immediate, legible confirmation of what a UI action did — "Published",
"Merged & cleaned up PR #3", or an error — instead of only the activity feed or a
browser `alert()`. Any component can post to it without a reference to it.

## Public surface
- **Tag:** `<toast-host>` (place once, near the end of the page).
- **Listens:** `toast` on `document` — `detail: { message, kind?, timeout? }`,
  where `kind` ∈ `success | error | info` (default `info`).
- **Behavior:** toasts stack bottom-right, animate in, auto-dismiss (errors last
  longer — 6s vs 3.5s), and dismiss on click. Renders nothing until posted to.

## History
- 2026-09-20: created — slice 12; inline toasts for menu/PR command results.

## Notes / gotchas
- Posters build the `CustomEvent` themselves (components are standalone, no shared
  module); keep the detail shape in sync with this contract.
- Messages are set via `textContent` (no HTML injection).