v0.3.0 — Linux runtime parity

The GUI is now mostly stable on macOS and Linux for daily local use. Phase 8 of the PRD ships in this release.

What's new

• Linux runtime parity (WSL2 Ubuntu 22.04 validated) — apply_linux_runtime_defaults() silences libEGL /dev/dri/* warnings and forces Mesa's software path on Linux. host.docker.internal:host-gateway confirmed working under WSL2 + Docker Desktop. Apt prerequisites for emoji rendering (fonts-noto-color-emoji) and xdg-open (wslu) documented in gui/CONTRIBUTING.md.
• Image pinning — core → core:v2.0.0, chat (mock + Ollama) → chat:v1.2.0, feedback-db → postgres:17-alpine, frontend git clone pinned to --branch v2.0.0 via _FRONTEND_GIT_REF constant.
• Frontend image renamed — f13-frontend:configurator-v1 → f13-frontend:v2.0.0_based. Tag is derived from _FRONTEND_GIT_REF so future bumps cascade automatically.
• Frontend source always cloned — the local ../frontend/ fast-path was removed since arbitrary local trees could diverge from the pinned ref.
• UX polish — embedding-model alert in the Ollama picker (with auto-scroll-into-view), soft warnings about embedding models in both shell wizard and GUI banner.
• Bug fixes — secret files written 0644 so the non-root container user can read through Linux bind-mounts (was breaking core startup); edit re-run reuses the existing feedback_db password so the postgres volume + new secret stay aligned; Tailwind v4 + <script lang="ts"> + <style> interaction in ProgressBar.svelte worked around by hoisting the keyframe to global CSS.

Breaking change

⚠️ Postgres major bump (16 → 17) — the feedback-db-data named volume from a postgres:16 install will not auto-upgrade. Existing stacks must run ./bin/f13-reset (drops the volume) before pulling this version, or perform a manual pg_upgrade outside the configurator.

Known loose ends

• HF4 — GUI reconfigure flow on a running stack silently no-ops on backend swap (mock ↔ Ollama). Two compounding bugs (GUI doesn't pass stateAction: "edit", and state::read clobbers env-set vars). Doesn't block normal use; the unblocker for "in-flight model swaps" is documented in the PRD.
• HF2 (Cancel button doesn't kill subprocess) and HF3 (sporadic frontend pull-access-denied) carried forward from v0.2.x.

Validated on

• macOS (Apple Silicon, prior releases)
• Ubuntu 22.04 + WSL2 + Docker Desktop (this release)

Other Linux distros (Fedora, Arch, native Ubuntu without WSLg) should largely work but haven't been smoke-tested.

---

Full Changelog: v0.2.2...v0.3.0