Bounded Task Status Delivery Requirements

Overview

Task rows currently obtain compact status indicators by observing large, session-owned streams. With many agents working, one browser receives messages, shell activity, model updates, MCP state, and Git events from sessions that are not open. Switching tasks rebuilds those subscriptions. The resulting traffic can delay or drop request responses, producing an unknown message-send result and temporarily hiding active-session controls such as the model selector.

Requirements

REQ-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001: Bounded Task Status Delivery

Intent: Task rows currently obtain compact status indicators by observing large, session-owned streams. With many agents working, one browser receives messages, shell activity, model updates, MCP state, and Git events from sessions that are not open. Switching tasks rebuilds those subscriptions. The resulting traffic can delay or drop request responses, producing an unknown message-send result and temporarily hiding active-session controls such as the model selector.

Acceptance criteria

AC-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001.1: Every task snapshot may carry a status_summary containing the complete set of runtime facts needed by desktop and mobile task switchers.
AC-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001.2: The backend derives that summary from authoritative task, session, message, Git, and pull-request state. It is a rebuildable read model, not a second source of truth.
AC-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001.3: Summary updates use the existing workspace task feed. Task rows never subscribe to a session merely to obtain a badge.
AC-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001.4: Full session snapshots and live session notifications are delivered only to explicitly opened session detail surfaces.
AC-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001.5: Repeated subscribe/focus requests do not replay full session state. Git refresh has a targeted action that does not alter focus.
AC-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001.6: Correlated WebSocket responses and errors are prioritized over unsolicited notifications and cannot be silently dropped by notification pressure.
AC-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001.7: One session's streaming text or reasoning cannot monopolize persistence, notification delivery, or browser state work. Intermediate replacement updates are bounded while the final transcript remains lossless.
AC-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001.8: message.add uses a stable client-generated message ID so an uncertain send can be reconciled or retried without creating or dispatching a duplicate.
AC-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001.9: One frontend animation-frame flush shall apply all accepted session.message.updated replacements in one store transaction while preserving semantic barriers and final transcript content.
AC-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001.10: When task opening resumes an idle agent after a restart, status_summary.last_activity_at shall remain unchanged. A later task mutation, user prompt, or conversational agent turn can advance it.

System design

The migrated technical source is split into part 1.

3.4 KiB Raw Blame History