[dimastatz]

Summary

Adds docs/specs/0002-whisper-flow-transcription.md. It requires whisper-flow as the streaming transcription framework. The extension captures audio and streams it to a whisper-flow server's /ws endpoint, and does not run Whisper itself.

Requirements have IDs and are marked must or should:

• Engine (TR): whisper-flow only, no bundled model and no cloud STT. Minimum version 1.1.0, checked with GET /ready.
• Configuration (CF): whisperCode.serverUrl (default http://localhost:8181), API key in SecretStorage sent as x-api-key, and explicit consent before streaming to a non-local host.
• Audio (AU): 16 kHz mono int16 PCM in binary frames of 1024 samples, captured by a sidecar process rather than a webview.
• Results (RS): partials are not monotonic, so a pending range is replaced on each partial and committed when is_partial is false. One undo step per segment.
• Errors (ER): close codes 1008 and 1013, retry on disconnect, no orphaned sidecar processes.
• Testing (TS): client logic lives in modules that don't import vscode and counts toward the 95% gate. CI uses a fake WebSocket server, so it doesn't need whisper-flow or a microphone.

The spec also lists gaps in whisper-flow 1.1.0 that affect whisper-code: no finalize-on-stop, no protocol_version, no initial_prompt for vocabulary, a fixed model per server, a window cap of about 64 s, and endpointing based on unchanged text.

Changes elsewhere

• Spec 0001: goal 1 changes from "local-only" to "self-hosted whisper-flow server, localhost by default, no cloud STT". The architecture diagram is updated, and the runtime and mic-capture open questions are marked resolved.
• CLAUDE.md and README: updated to name whisper-flow as the only transcription engine.

Review notes

• This changes the privacy promise. Audio can now go to a remote host the user configures, with consent (CF-4).
• Workspace-symbol biasing (0001 goal 2) is blocked until whisper-flow accepts a vocabulary prompt.

🤖 Generated with Claude Code

https://claude.ai/code/session_01TC6WCRgEsuzNtiSyAN59vi