release v0.2.2

Network migration: the gateway's default Tatlock URL is now the docker
container name (http://tatlock:8000); the retiring tatlock.schweitz.internal
domain is gone from config and docs. Deployments that set
DESKLOCK_TATLOCK_BASE_URL are unaffected.

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

.gitea/workflows/build.yml

@@ -49,7 +49,7 @@ jobs:
       - name: Login to Gitea Registry
         uses: docker/login-action@v3
         with:
-          registry: git.schweitz.internal
+          registry: git.schweitz.net
           username: ${{ secrets.REGISTRY_USER }}
           password: ${{ secrets.REGISTRY_PASSWORD }}
 
@@ -61,8 +61,8 @@ jobs:
           provenance: false
           sbom: false
           tags: |
-            git.schweitz.internal/jpmschweitzer/desklock-gateway:latest
+            git.schweitz.net/jpmschweitzer/desklock-gateway:latest
-            git.schweitz.internal/jpmschweitzer/desklock-gateway:${{ github.ref_name }}
+            git.schweitz.net/jpmschweitzer/desklock-gateway:${{ github.ref_name }}
 
       - name: Trigger Watchtower update
         if: success()

AGENTS.md

@@ -6,8 +6,8 @@
 ## What this project is
 
 DeskLock is the living-room visual/audio endpoint for **Tatlock**, the homelab butler
-(`/mnt/media/Projects/tatlock`, API at `http://tatlock.schweitz.internal:8000`). Two halves,
+(`/mnt/media/Projects/tatlock`, API at `http://tatlock:8000` on `docker-dataplane`).
-one repo:
+Two halves, one repo:
 
 - `firmware/` — ESP-IDF (C, LVGL 9) app for the Waveshare ESP32-P4-WIFI6-Touch-LCD-3.4C
   (3.4" round 800×800 touch display, dual mics + ES7210 AEC, ES8311 codec + speaker).
@@ -124,7 +124,8 @@ make typecheck      # mypy
 ## Homelab context
 
 - This server **is** tower-of-joy; the device, gateway, and Tatlock all share the LAN.
-- Use `tatlock.schweitz.internal:8000` (direct, no SSO) — the public
+- Machine-to-machine traffic uses container names on the `docker-dataplane` network —
-  `tatlock.schweitz.net` route sits behind Authentik and is not for machine-to-machine
+  `http://tatlock:8000` (the deployed stack overrides `DESKLOCK_TATLOCK_BASE_URL` to
-  traffic.
+  the host LAN IP while Tatlock runs on the host). Browser-facing URLs use
+  `https://<name>.schweitz.net` (NPM, Authentik SSO) — never for M2M traffic.
 - Git remote: `git.schweitz.net` (Gitea).

CHANGELOG.md

@@ -8,6 +8,25 @@ until the first tagged release.
 
 ## [Unreleased]
 
+## [0.2.2] — 2026-07-19
+
+### Changed
+
+- The gateway's default Tatlock URL is now `http://tatlock:8000` (docker
+  container name) — the retiring `tatlock.schweitz.internal` domain is gone
+  from config and docs. Deployments setting `DESKLOCK_TATLOCK_BASE_URL` are
+  unaffected.
+
+## [0.2.1] — 2026-07-15
+
+### Fixed
+
+- A spoken volume command no longer leaves the face stuck in the thinking
+  spinner — the feedback gong is a UI cue and no longer holds the busy state,
+  so the return-to-idle isn't swallowed.
+- The butler filler line reads as one phrase instead of two — reworded to "Let
+  me check on that, sir." to avoid a text-to-speech pause before "for you".
+
 ## [0.2.0] — 2026-07-15
 
 ### Added

README.md

@@ -38,8 +38,8 @@ happens on this server.
                                      ▼       │  Speaches  (container, GPU) │
                      ┌────────────────────┐  │  • STT: faster-whisper      │
                      │  Tatlock (butler)  │  │  • TTS: Kokoro / Piper      │
-                     │  tatlock.schweitz. │  │  also usable by Open WebUI, │
+                     │  http://tatlock    │  │  also usable by Open WebUI, │
-                     │  internal :8000    │  │  Home Assistant, …          │
+                     │  :8000             │  │  Home Assistant, …          │
                      └────────────────────┘  └─────────────────────────────┘
 ```
 

docs/architecture.md

@@ -74,7 +74,7 @@ models — the container stays a slim pure-Python image with no CUDA/ML dependen
 2. Buffers inbound PCM until end-of-utterance (client-signalled in phase 1; VAD later).
 3. **STT**: POST to Speaches `/v1/audio/transcriptions`.
 4. **Chat**: POST the transcript to Tatlock `/v1/chat/completions`
-   (`http://tatlock.schweitz.internal:8000`, OpenAI-compatible, **streaming**),
+   (`http://tatlock:8000`, OpenAI-compatible, **streaming**),
    maintaining the conversation history so follow-ups have context.
 5. **TTS**: as Tatlock's token stream completes each sentence, POST it to Speaches
    `/v1/audio/speech` and forward the PCM immediately — see
@@ -335,7 +335,7 @@ Gitea Actions (`.gitea/workflows/build.yml`), following the tatlock/tatlock-ui p
 
 - **Every push to `main`**: lint + tests for the gateway (Python 3.12).
 - **Version tags (`v0.1.0`, …)**: tests, then build `gateway/` into
-  `git.schweitz.internal/jpmschweitzer/desklock-gateway:{latest,tag}`, push to the
+  `git.schweitz.net/jpmschweitzer/desklock-gateway:{latest,tag}`, push to the
   Gitea registry, create a release, and trigger Watchtower to roll the running
   container.
 - Required repo/org secrets: `REGISTRY_USER`, `REGISTRY_PASSWORD`,

firmware/main/audio.c

@@ -161,8 +161,10 @@ static void audio_task(void *arg)
          * returns, preventing a playback-boundary false wake. */
         if (job == JOB_GONG && s_gong != NULL) {
             /* Play in chunks so a new request (a fresh volume change) cuts the
-             * current gong off and restarts, instead of queueing another 5 s. */
+             * current gong off and restarts, instead of queueing another 5 s.
-            s_playing = true;
+             * Note: the gong is a UI cue, not "playback" — it deliberately does
+             * NOT set s_playing, so a following state:idle isn't swallowed (that
+             * guard is for reply audio) and it doesn't gate wake for 5 s. */
             uint32_t gen;
             do {
                 gen = s_gong_gen;
@@ -172,7 +174,6 @@ static void audio_task(void *arg)
                     esp_codec_dev_write(s_spk, s_gong + off, n * sizeof(int16_t));
                 }
             } while (s_gong_gen != gen);   /* a new request arrived mid-play → restart */
-            s_playing = false;
             s_gong_active = false;
         } else if (job == JOB_CHIME && s_chime != NULL) {
             s_playing = true;

gateway/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "desklock-gateway"
-version = "0.2.0"
+version = "0.2.2"
 description = "Voice gateway bridging the DeskLock device to the Tatlock butler (STT/chat/TTS)"
 requires-python = ">=3.11"
 dependencies = [

gateway/src/desklock_gateway/config.py

@@ -4,7 +4,7 @@ from pydantic_settings import BaseSettings
 class Settings(BaseSettings):
     """Gateway configuration, overridable via DESKLOCK_* environment variables."""
 
-    tatlock_base_url: str = "http://tatlock.schweitz.internal:8000"
+    tatlock_base_url: str = "http://tatlock:8000"
     tatlock_model: str = "Tatlock"
 
     # PCM rate of the device WebSocket contract (docs/architecture.md)
@@ -20,7 +20,8 @@ class Settings(BaseSettings):
     tts_voice: str = "bm_george"
 
     # Spoken immediately after a query is accepted, to fill the long Tatlock wait.
-    filler_text: str = "Let me check on that for you, sir."
+    # Avoid "for you" — Kokoro inserts an unnatural mid-phrase pause before it.
+    filler_text: str = "Let me check on that, sir."
 
     # embedded fallback only (requires the [speech] extra)
     embedded_stt_model: str = "small"