docs: OpenWiki-Dokumentation und Auto-Update-Workflow hinzufügen

Fügt generierte OpenWiki-Docs (Architektur, Domain, Betrieb, Tests, Workflows)
sowie den GitHub-Actions-Workflow zur automatischen Aktualisierung hinzu.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

openwiki/workflows/recording-cycle.md

@@ -0,0 +1,71 @@
+---
+type: Workflow
+title: Aufnahme-Zyklus (Push-to-Talk)
+description: "Der Kern-Workflow von whisper-local: Hotkey drücken → Audio aufnehmen → Medien pausieren → Hotkey loslassen → transkribieren → Text einfügen → Medien fortsetzen. Sowie Mikrofon-Überwachung und Config-Reload."
+tags: [workflow, push-to-talk, recording, transcription, media-pause, microphone-monitor]
+---
+
+# Aufnahme-Zyklus (Push-to-Talk)
+
+Der zentrale Workflow wird durch die `App`-Klasse in [`__main__.py`](../../whisper_local/__main__.py) orchestriert. Die beiden Callbacks `on_press` und `on_release` bilden den vollständigen Zyklus.
+
+## Push-to-Talk-Flow
+
+```
+Hotkey gedrückt (on_press)
+  1. Tray.set_state(RECORDING)          — Icon wird rot
+  2. await media.pause()                — alle Playing-Sessions pausieren
+  3. recorder.start()                   — sounddevice.InputStream öffnet
+
+Hotkey losgelassen (on_release)
+  1. recorder.stop()                    — Stream schließen, Audio-Array zurück
+  2. await media.resume()               — pausierte Sessions fortsetzen (im finally-Block)
+  3. Wenn audio == None → Tray WAITING, return
+  4. Tray.set_state(TRANSCRIBING)       — Icon wird gelb
+  5. transcriber.transcribe(audio)      — faster-whisper transkribiert lokal
+  6. await inserter.insert(text)        — Text ins aktive Textfeld einfügen
+  7. Tray.set_state(WAITING)            — Icon wird grau
+```
+
+### Mindestdauer-Filter
+
+`Recorder.stop()` verwirft Aufnahmen kürzer als `min_duration` (Standard: 0,5 s). In diesem Fall gibt `stop()` `None` zurück und der Zyklus wird abgebrochen — keine Transkription, kein Einfügen. Das verhindert versehentliche Trigger bei kurzen Hotkey-Berührungen.
+
+### Text-Einfügung mit Clipboard-Restaurierung
+
+Beide Inserter-Backends (Wayland und Win32) folgen demselben Muster:
+
+1. Alten Clipboard-Inhalt sichern.
+2. Transkribierten Text ins Clipboard setzen.
+3. `Ctrl+V` simulieren (ydotool unter Wayland, pynput unter Windows).
+4. Kurz warten (`PASTE_DELAY = 0.2s`).
+5. Alten Clipboard-Inhalt wiederherstellen (im `finally`-Block).
+
+Dadurch bleibt der bisherige Clipboard-Inhalt des Nutzers erhalten. Details siehe [Plattform-Abstraktionen → Inserter](../domain/platform-abstractions.md#inserter).
+
+## Medien-Pause während Aufnahme
+
+Wenn `pause_media_during_recording = true` (Standard), pausiert der [MediaController](../domain/platform-abstractions.md#mediacontroller) alle aktiv wiedergebenden Sessions bei Aufnahmestart und setzt nur diejenigen fort, die er selbst pausiert hat. Der Circuit-Breaker deaktiviert die Funktion dauerhaft, wenn D-Bus (Linux) oder SMTC (Windows) nicht verfügbar ist.
+
+## Mikrofon-Überwachung
+
+Der `MicrophoneMonitor` läuft als Hintergrund-Task und überwacht Audio-Geräte-Änderungen:
+
+- **Gerät entfernt**: Wenn das konfigurierte Mikrofon getrennt wird, wechselt `App._on_configured_microphone_missing` auf das Standard-Gerät, zeigt eine Desktop-Benachrichtigung via [notify-py](../../whisper_local/tray/_notification.py) und setzt eine Tray-Warnung (`set_warning("Mikrofon nicht gefunden")`).
+- **Gerät hinzugefügt**: Wenn das konfigurierte Mikrofon wieder verfügbar wird, stellt `App._on_microphone_added` es wieder her, benachrichtigt den Nutzer und entfernt die Tray-Warnung.
+- **Start-Check**: Beim Start meldet `PollMonitor` sofort, wenn das konfigurierte Gerät nicht gefunden wird.
+
+Windows verwendet `IMMNotificationClient` (COM Core Audio API) für Event-basierte Benachrichtigungen mit automatischem Polling-Fallback. Linux verwendet den `PollMonitor` (2,5 s Intervall). Details siehe [Plattform-Abstraktionen → Mikrofon-Monitor](../domain/platform-abstractions.md#mikrofon-monitor).
+
+## Config-Reload zur Laufzeit
+
+`App._on_config_reload` wird vom [Einstellungs-Dialog](../../whisper_local/tray/_settings.py) aufgerufen und tauscht alle dynamischen Komponenten ohne Neustart aus:
+
+1. Neue Config übernehmen.
+2. Recorder neu instanziieren (neues Mikrofon/Sample-Rate).
+3. Mikrofon-Monitor stoppen und neu starten.
+4. Tray-Warnung zurücksetzen.
+5. Alten Media-Controller fortsetzen, neuen erstellen.
+6. Hotkey-Listener stoppen und neu starten (`_restart_hotkey`).
+
+Der Hotkey-Restart benötigt ein kurzes `await asyncio.sleep(0.1)` zwischen Stop und Start, um den alten Listener sauber abzubauen.