Carlos Florêncio
2.3 KiB
2.3 KiB
id, title, status, wave, depends_on, plan, spec
| id | title | status | wave | depends_on | plan | spec |
|---|---|---|---|---|---|---|
| 01-foreground-recovery | Foreground recovery | done | 1 | plan.md | ../../specs/ui/requirements/task-surface-refresh.md |
Task 01: Foreground recovery
Acceptance
- One shared hook emits refresh on visible
visibilitychange,focus,pageshow, andonlineindependent of WebSocket status, while coalescing burst and in-flight calls. - Open task details, session lists, active chat messages, and queued messages reload from their existing authoritative endpoints without changing task or session selection.
- Hidden events, stale task responses, and failed foreground requests retain the last usable UI and remain retryable.
Verification
cd apps && pnpm --filter @kandev/web test -- --run hooks/use-foreground-refresh.test.ts hooks/use-task-sessions.test.ts hooks/domains/session/use-visibility-backfill.test.ts hooks/domains/session/use-queue.test.ts
Files likely touched
apps/web/hooks/use-foreground-refresh.tsapps/web/hooks/use-foreground-refresh.test.tsapps/web/hooks/use-task-sessions.tsapps/web/hooks/use-task-sessions.test.tsapps/web/hooks/domains/session/use-session-messages.tsapps/web/hooks/domains/session/use-visibility-backfill.test.tsapps/web/hooks/domains/session/use-queue.tsapps/web/hooks/domains/session/use-queue.test.tsapps/web/components/task/task-page-content.tsx
Dependencies
None.
Parallelism
Sequential. Task 02 consumes this task's lifecycle hook.
Inputs
- Spec:
Whatforeground and task-detail bullets; task-detail and event-burst scenarios; failure modes. - Existing forced reload behavior in
useTaskSessions. - Existing visibility-only message and queue backfills.
- Existing task identity/request guard in
TaskPageContent.
Risks
- React callback identity churn must not re-register global listeners or bypass coalescing.
- Task navigation during an in-flight foreground request must not commit the old task.
Output contract
Completed 2026-07-27.
Verification passed:
cd apps && pnpm --filter @kandev/web test -- --run hooks/use-foreground-refresh.test.ts hooks/use-task-sessions.test.ts hooks/domains/session/use-visibility-backfill.test.ts hooks/domains/session/use-queue.test.ts
Result: 4 files, 27 tests passed.