app development context

docs/local-sidecar-protocol.md

@@ -49,12 +49,29 @@ The sidecar should send JSON text frames:
 { "type": "error", "error": "human-readable error" }
 ```
 
-Only `final` transcript events are sent to the local LLM. `partial` events are
-shown as status text.
+Only `final` transcript events enter local semantic reduction. `partial` events
+are transient status and must not be persisted.
 
 ## v1 Scope
 
-- STT target: English, `en-US`.
+- Required language modes: English (`en-US`), Russian (`ru-RU`), and automatic
+  or mixed Russian-English recognition (`auto` or an implementation-equivalent
+  mode).
 - Sidecar implementation is external to this repository.
 - The app does not require a specific Nemotron, NeMo, Riva, or ONNX runtime as
   long as the WebSocket protocol above is implemented.
+- The endpoint must be loopback-only. LAN and internet ASR endpoints are not
+  Local Providers.
+
+## Native macOS Client Compatibility
+
+The Swift-native app uses the same WebSocket protocol as the Electron client.
+Audio frames are raw 16 kHz mono signed 16-bit little-endian PCM.
+
+Microphone and system audio use independent client connections so the sidecar
+does not mix channel roles. The sidecar does not need to know whether a client
+is Electron or Swift; Mastermind associates each connection with its Source.
+
+Full transcripts are ephemeral sensitive input. The Swift client consumes a
+`final` event, derives structured local context, and then releases transcript
+content instead of storing it in Assistant History or the Context Graph.