Task 03: Add the Auto-run switch

Intent

Project the server-owned policy in the queue panel, remove misleading header actions, and keep exact Send Now on every row with full desktop/mobile accessibility.

Acceptance

Queue API, WebSocket status handling, Zustand meta, and useQueue carry the authoritative Auto-run boolean. Toggling sends the exact boolean, uses the existing mutation gate, and refetches after both success and failure.
The header renders one labeled Switch with state-specific localized helper copy. Header Run Next and bulk Send Now, their callbacks, and their test IDs are absent. Generic drain and all-scope Send Now API compatibility remains.
Every row, including index zero, exposes targeted Send Now. Clicking any row uses its persisted entry ID; no head-only Skip action exists.
The switch is disabled during queue mutation or backend cancellation, exposes checked/disabled semantics, wraps without overflow, and has a 44-pixel effective coarse-pointer target.
English, Portuguese, simplified/traditional Chinese, and generated pseudo locales are complete. Obsolete Run Next keys have no remaining consumer.

Verification

cd apps
pnpm install --frozen-lockfile
pnpm --filter @kandev/web exec vitest run components/task/chat/queued-ghost-list.test.tsx components/task/chat/queued-ghost-message.test.tsx components/task/chat/queued-ghost-pin.test.tsx hooks/domains/session/use-queue.test.ts lib/api/domains/queue-api.test.ts lib/state/slices/session/session-slice.upsert.test.ts lib/ws/handlers/agent-session.test.ts
cd web
pnpm run typecheck
pnpm exec eslint --max-warnings 0 components/task/chat/queued-ghost-panel-header.tsx components/task/chat/queued-ghost-list.tsx components/task/chat/queued-ghost-list.test.tsx components/task/chat/queued-ghost-message.tsx components/task/chat/queued-ghost-message.test.tsx hooks/domains/session/use-queue.ts hooks/domains/session/use-queue.test.ts lib/api/domains/queue-api.ts lib/api/domains/queue-api.test.ts lib/state/slices/session/types.ts lib/state/slices/session/session-slice.ts lib/state/slices/session/session-slice.upsert.test.ts lib/ws/handlers/agent-session.ts lib/ws/handlers/agent-session.test.ts
pnpm run i18n:pseudo
pnpm run i18n:check
pnpm run i18n:ratchet

If implementation keeps the switch inside the header instead of extracting the named component, update the focused file/test list and record the reason.

Files likely touched

apps/web/lib/api/domains/queue-api.ts
apps/web/lib/api/domains/queue-api.test.ts
apps/web/lib/state/slices/session/types.ts
apps/web/lib/state/slices/session/session-slice.ts
apps/web/lib/state/slices/session/session-slice.upsert.test.ts
apps/web/lib/ws/handlers/agent-session.ts
apps/web/lib/ws/handlers/agent-session.test.ts
apps/web/hooks/domains/session/use-queue.ts
apps/web/hooks/domains/session/use-queue.test.ts
apps/web/components/task/chat/queued-ghost-auto-run-control.tsx (new)
apps/web/components/task/chat/queued-ghost-auto-run-control.test.tsx (new)
apps/web/components/task/chat/queued-ghost-panel-header.tsx
apps/web/components/task/chat/queued-ghost-list.tsx
apps/web/components/task/chat/queued-ghost-list.test.tsx
apps/web/components/task/chat/queued-ghost-message.tsx
apps/web/components/task/chat/queued-ghost-message.test.tsx
apps/web/components/task/chat/queued-ghost-pin.test.tsx
apps/web/src/locales/en/chat.json
apps/web/src/locales/pt-pt/chat.json
apps/web/src/locales/zh-cn/chat.json
apps/web/src/locales/zh-hk/chat.json
apps/web/src/locales/zh-tw/chat.json
apps/web/src/locales/pseudo/chat.json

Dependencies

Task 02. The API action and status projection must be final.

Parallelism

Sequential. This task owns selectors, copy, and UI behavior consumed by E2E.

Inputs

Spec: What, API Surface, Responsive and Mobile Behavior.
Mobile contract in plan.md.
Existing compact labeled switch pattern in components/quick-chat/configuration-chat-toggle.tsx.

Risks

The queue panel renders only when entries exist, but OFF must still survive an empty queue in the store/backend and reappear when later work arrives.
Do not optimistically claim ON if the server rejected the mutation.
Header wrapping must not create a second scroll owner or shrink touch targets.
Remove only first-party bulk/drain plumbing, not backward-compatible API methods or row Send Now.

Output contract

Report user-visible behavior, accessible semantics, locale changes, files changed, exact commands and test counts, compatibility audits, blockers, and residual risks. Set this task to done, record results below, and synchronize plan.md before Task 04.

Results

Added the exact message.queue.auto_run.set client action, authoritative fetch/broadcast projection, queue meta, and reconciled hook mutation. Missing additive status fields default to ON for rolling compatibility.
Replaced both legacy header dispatch actions with a labeled, described Switch. It wraps on a dedicated header row, exposes checked/disabled state, and expands its coarse-pointer hit area. Targeted Send Now remains on every queued row, including the head.
Kept the control in queued-ghost-panel-header.tsx: its presentation is header-only and small enough that a one-use component would add indirection without reducing the large list component.
Added all five real-locale strings, removed unused Run Next/bulk Send Now copy, and regenerated pseudo locale output.
vitest: 7 files, 220 tests passed. pnpm run typecheck, focused ESLint, i18n:check, and i18n:ratchet passed. The i18n checker retained its existing advisory real-locale parity backlog; this task's chat keys are complete.

5.9 KiB Raw Blame History