maintain-chat

name	maintain-chat
description	Maintain Chat rendering, composer submission, Local/ChatGPT/OpenRouter turns, streaming/tool events, visible statuses, speech controls, and Chat accessibility. Use when changing typed prompts, message rendering, send gating, or Chat reply behavior.

Maintain Chat

Role and boundary

Keep Chat as the typed conversation surface for the active ChatStore session. It coordinates composer admission, visible message projection, and optional Chat speech through existing owners; it must not invent provider policy, persistence, native playback, or Live state.

Source map

• src/main.ts: renderApp() Chat markup, app composition, wireStatusChrome, and initializeVoiceFeatures; src/chat.ts: required element lookup, transcript/session rendering, DOM listeners, copy actions, composer gate, and the single wireChat composition seam; src/chat-turn.ts: ChatController, provider admission, speech replacement, shared Stop-speaking settlement, mutually exclusive turn/session mutations, user-message commit, draft/provenance handling, tool projection, and final UI settlement.
• src/chat-store.ts: message/session types and appendUser, streaming/complete/interrupted/error assistant updates, tool call/result/toggle, persistence, and subscribers.
• src/chat-message-view.ts: text, voice-provenance, tool, streaming, error, and diagnostic-reference rendering.
• src/composer-send-gate.ts, src/voice.ts, src/voice-draft-provenance.ts: send enablement, editable transcription insertion, and provenance admission.
• src/assistant-coordinator.ts, src/assistant-ipc.ts, src/llm.ts, src/tts.ts, src/sentence-chunks.ts: correlated generation and optional ordered speech; tests in tests/chat-turn.test.ts, tests/chat-store.test.ts, tests/assistant-coordinator.test.ts, tests/llm.test.ts, tests/composer-send-gate.test.ts, and tests/assistant-activity.test.ts.

Cover

• Keep the complete submission transaction in ChatController: trim and reserve provider work before appending/persisting a non-empty prompt; keep blocked account operations from creating orphan turns, retain the draft and voice provenance when admission fails, and always release busy/focus state on settlement.
• Route Stop speaking, New task, activation, deletion, and clear-all through the same controller. Keep one controller-level in-flight speech-stop promise for UI ordering, and keep the underlying ChatReplySpeechController cancellation promise shared across direct user, replacement, navigation, and Live callers. Make session mutations mutually exclusive with turn admission while native speech or Live teardown is pending; disabled DOM buttons are a projection of that guard, not the guard itself.
• Snapshot provider/model/thinking/verbosity/tool route at generation start. Stream only correlated visible deltas; surface tool calls/results as expandable local messages without putting tool records into provider history.
• Persist partial assistant text as interrupted on replacement/cancel and error with a diagnostic reference on failures; keep speech cancellation separate from visible LLM cancellation when Stop speaking is used.
• Keep composer accessibility, send gating, Enter/Shift+Enter behavior, editable transcription insertion (never auto-submit), scroll preservation, aria-busy, and focus restoration.
• Keep Chat speech outside the composer and preserve speechSessionId/requestId correlation, bounded sentence chunking, and local-first privacy. Inspect current source when markup differs from older prose.

Validate and accept

• Run bun test tests/chat-turn.test.ts tests/tts.test.ts tests/chat-store.test.ts tests/assistant-coordinator.test.ts tests/llm.test.ts tests/composer-send-gate.test.ts tests/assistant-activity.test.ts.
• Run git diff --check against the actual files changed; run just check when the change crosses TypeScript/Rust/build boundaries. Exercise typed, empty, blocked-account, tool, interrupted, and speech-stop paths in the packaged app via $test-voice-layer-app.
• Treat real local llama-server/ChatGPT account routing, audible Chat playback, and human keyboard/accessibility acceptance as separate gates.

Relationships

Use $maintain-assistant-orchestration for request/cancellation sequencing, $maintain-assistant-providers for provider policy, $maintain-sessions for persistence, $maintain-voice-input for recording/drafts, $maintain-voice-output for playback, and $maintain-local-tools for native tools.