Skip to content

Attention watermark + return-from-away briefing ("brief me") #51

Description

@heavygee

Goal

Let the operator ask the Overseer "brief me" / "what changed since I was last here?" and get a synthesized return-from-away fleet briefing — deltas since last attention + current blockers/decisions + recommended focus. The near-term, trackable primitive is a per-operator last-seen watermark + since-last-seen delta over the event stream; the briefing interaction rides the nascent Overseer (#25).

Spec

  • docs/plans/2026-06-05-overseer-rollout-and-diagrams.md §5 (return-from-away briefing)
  • docs/plans/2026-06-03-overseer-prioritization.md §9 (the briefing is the digest's content, minus the schedule)
  • The per-session "Greet me / Brief me" precedent (discussion Voice roadmap: picker -> provider abstraction -> local stack -> fleet command centre tiann/hapi#691 dogfooding notes) — this is the fleet-level "Brief me"
  • docs/chad-operator-overseer-chat.md ("3 agents finished. Two routine. One needs your decision…")

Why not scrum, why no schedule

  • Scrum standup ceremony (per-agent roll-call, fixed daily time) is meatspace baggage — humans schedule standups because they need to converge. An agent fleet does not. Scheduling dropped entirely.
  • Adopt the scrum function, not the ritual: deltas-since-last + current blockers + recommended focus, SYNTHESIZED, never a per-agent roll-call (a roll-call is the "narrating log file" failure mode at standup scale).
  • Trigger = operator-initiated ("brief me") + attention-gap (return after being away > N). Not clock-driven. "Day start" is the wrong boundary; "return from away" is the right one (could be morning or after a 2-hour meeting).

Acceptance

  • Near-term primitive (can land with the inbox substrate): record a per-operator last_seen_at / attention watermark, and support a since-last-seen delta query over events/inbox (done-while-away, newly-blocked, resolved-while-away, new-since-last).
  • Briefing interaction (rides Step 3: Read-only Overseer wired to voice #25): on operator-initiated "brief me" or a detected return-from-away, produce a synthesized briefing — deltas + blockers/decisions + recommended focus order. Not an enumeration.
  • No scheduled/clock-driven standup — operator-initiated + attention-gap only.
  • Second consumer falls out for free: "what did you handle while I was away?" — audit of auto-resolved/dispatched items against the same watermark.

Out of scope

Dependencies

Notes

The briefing is the narrative front-end of the attention queue at a return-from-away boundary — same data as the inbox, different intent from the "what's next?" single-item query. "What's next?" is pull-one (Brazil bang-bang); "brief me" is orient-all-with-deltas. Keep both; don't merge.

Metadata

Metadata

Assignees

No one assigned

    Labels

    architectureArchitectural / substrate workfleet-overseerFleet attention-arbitration architecturepost-mvpPost-MVP polish / future workstream

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions