feat: v0.1.0 — client Sailfish per hermes-webui con voce

- ApiClient HTTP/SSE: login, sessioni, chat/start, stream SSE, transcribe, tts
- ChatModel: streaming live + risincronizzazione dallo stato del server
- CookieJar persistente (0600, mai la password); Settings
- Recorder OGG/Opus (fallback WAV/PCM, retry); Player TTS (QMediaPlayer)
- UI Silica: splash, login, sessioni, chat (dettatura + read-aloud), settings, cover
- Sailjail Internet;Audio;Microphone; icone; spec RPM; docs PROTOCOL/BUILD
- tests/core_test: unit parser SSE + integrazione live (probe :8899)

docs/BUILD.md

@@ -0,0 +1,93 @@
+# Build: compilazione, test e deploy
+
+## 1. Prerequisiti SDK
+
+- Sailfish SDK (testato su 5.1.0.11) con target del dispositivo aarch64:
+  `SailfishOS-5.0.0.62-aarch64` (Jolla Phone 2026) o equivalente.
+- Nel target SDK serve **QtMultimedia** (registrazione/riproduzione):
+  se `pkgconfig(Qt5Multimedia)` non è trovato in fase di build, installa il
+  pacchetto devel nel target:
+
+  ```bash
+  sfdk tools exec SailfishOS-5.0.0.62-aarch64 zypper install -y qt5-qtmultimedia-devel
+  ```
+
+  (oppure via Qt Creator: Tools → Sailfish OS → Manage targets → Packages,
+  oppure `sfdk target install` con un RPM locale.)
+
+## 2. Build e deploy dell'app
+
+```bash
+cd harbour-hermes
+sfdk build          # genera RPMS/
+sfdk deploy         # installa sul device collegato
+```
+
+Note:
+- Il target è Qt 5.6: il codice del core è scritto per compilare anche lì
+  (niente API Qt > 5.6; per il TTS si usa `audio/mpeg` di edge-tts).
+- Il profilo SailJail è nel `rpm/harbour-hermes.desktop`
+  (`Internet;Audio;Microphone`) e deve restare allineato a
+  `setOrganizationName("harbour")` / `setApplicationName("hermes")` in `main.cpp`.
+- Al primo uso del microfono Sailfish chiede il consenso al permesso
+  **Microphone**.
+
+## 3. Test del core in locale (senza SDK)
+
+Il core (ApiClient, ChatModel, parser SSE, Recorder, Player) si compila anche
+su desktop con Qt 5.15 per i test:
+
+```bash
+# Qt desktop (qui: Qt 5.15.2 nel kit locali)
+export PATH=<Qt5.15>/gcc_64/bin:$PATH
+mkdir -p /tmp/hh-test && cd /tmp/hh-test
+qmake /percorso/harbour-hermes/tests/core_test.pro
+make -j4
+```
+
+- **Unit** (parser SSE): `./core-test`
+- **Integrazione live**: `./core-test --live`
+  richiede un'istanza di prova di hermes-webui su `http://127.0.0.1:8899`
+  con password in `/tmp/hermes-probe/pw` e l'audio di prova in
+  `/tmp/hermes-probe/out/prova.ogg` (vedi note in `tests/core_test.cpp`).
+  Il flusso coperto: login → nuova sessione → turno con streaming → TTS →
+  trascrizione.
+
+Nota desktop: se manca `libGL.so` di sviluppo, creare un symlink
+`libGL.so -> /usr/lib/x86_64-linux-gnu/libGL.so.1` e assicurarsi che
+`core_test.pro` punti lì (`GLSTUB`), oppure lanciare con `LD_LIBRARY_PATH`
+puntato alla lib dir di Qt.
+
+## 4. Tarball per la build da Qt Creator
+
+```bash
+cd /home/kaneda/workspace
+tar czf harbour-hermes-0.1.0.tar.gz \
+    --transform 's,^harbour-hermes,harbour-hermes-0.1.0,' \
+    --exclude='.git' harbour-hermes
+```
+
+Lo spec si aspetta la directory `harbour-hermes-0.1.0/` (pattern degli altri
+progetti: cercato in modo robusto anche per i sorgenti live di sfdk).
+
+## 5. Dipendenze lato server (WebUI)
+
+- `/api/transcribe` richiede un provider STT attivo sul server
+  (qui: faster-whisper locale — verificato con `/api/transcribe/capability`).
+- `/api/tts` con engine `edge` non richiede chiavi API.
+- Le voci italiane di edge sono state aggiunte all'allowlist del server
+  (patch a `hermes-webui/api/routes.py` + test
+  `tests/test_italian_voices_tts_allowlist.py`): per attivarle **riavviare
+  il servizio WebUI** (`sudo systemctl restart hermes-webui`).
+- Per una dettatura italiana corretta impostare in `~/.hermes/config.yaml`:
+
+  ```yaml
+  stt:
+    provider: local
+    local:
+      model: base
+      language: it
+  ```
+
+  (senza, whisper può tradurre/maltrascrivere l'italiano). Richiede il
+  riavvio del WebUI.