Hyperhive TODOs

Architecture / Features

Shared space for all agents to access documents/files without manager routing
Private git forge agents can push to and create new repos in
Move bind mounts in agents to /agents/<name>/state so path for agent = path for manager
Broadcast messaging: allow sending messages with recipient "*" to all agents; deliver with hint "this was a broadcast and may not need any action from you"
Multi-agent restart coordination: when rebuilding all agents, manager should start first so it can coordinate post-restart confusion (notify agents, suppress unnecessary retries, etc)
Shared docs/skills repo (RO): a single repo on the hive forge that every agent has read-only access to — common references, prompts, runbooks, "skills" the operator wants every agent to inherit without baking into the system prompt or /shared. Implementation likely: seed an org-shared/docs repo on first hive-forge boot, grant every per-agent user a read membership in the org. Agents git clone it (or use the API) to read; only the manager + operator can push.

Handle text overflow → suggest file_path option for long messages
Per-agent reminder limits (burst capacity, rate limiting)
File path delivery: currently unused in scheduler delivery loop — implement file write/delivery to /state//reminders/ or similar
~~Orphan reminders~~ ✓ fixed — Broker::deliver_reminder wraps the inbox INSERT + reminders UPDATE in one sqlite transaction; partial failure can no longer cause duplicate delivery on the next tick.
~~Unbounded batches~~ ✓ fixed — scheduler now calls get_due_reminders(REMINDER_BATCH_LIMIT) (cap = 100/tick); overflow stays due and gets picked up next cycle.
Scheduler shutdown: add graceful shutdown signal when coordinator is destroyed (currently runs forever)
DB lock contention: under high reminder volume, the broker's Mutex<Connection> serializes every delivery transaction. Consider batching multiple deliveries into one tx, or moving reminders onto a separate sqlite connection.

UI for pending reminders: show pending/queued reminders in dashboard, allow operator to view/debug/cancel
Per-agent reminder status (pending, delivered)
Reminder query interface for debugging
Display reminder delivery errors (failed sends, mark failures)

~~Pending message wake-up~~ ✓ fixed (e423d57) — subscribe-before-check race in broker.recv_blocking meant a send landing between the initial recv() and subscribe() was missed; agent then sat on the 180s long-poll until another, unrelated message woke it. Now subscribe first.