hyperhive/TODO.md

1.2 KiB

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

Reminder Tool

  • 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: handle partial failures (e.g. delivery succeeds but mark_reminder_sent fails) to avoid resending
  • Unbounded batches: implement per-cycle delivery limit so burst of 10k reminders doesn't flood the broker in one cycle
  • Scheduler shutdown: add graceful shutdown signal when coordinator is destroyed (currently runs forever)
  • DB lock contention: under high reminder volume, many concurrent mark_reminder_sent calls may serialize behind the Mutex lock — consider batch updates

Dashboard

  • Per-agent reminder status (pending, delivered)
  • Reminder query interface for debugging
  • Display reminder delivery errors (failed sends, mark failures)