Files
Lumotia/HANDOVER.md

72 lines
3.1 KiB
Markdown

---
name: handover-2026-04-18
type: reference
tags: [handover, session, kon]
description: Session handover — 2026/04/18 dogfooding sprint
---
# Kon Handover — 2026/04/18
## Current state
Phase 1 brand migration and Phase 2 polish are both **complete and committed**. Today was the first dogfood attempt — Vulkan GPU build is in progress but not yet confirmed working. Three bugs were caught and fixed during the first launch attempt.
## What's working
- **18/18 automated validation checks pass** (Playwright, `python3 /tmp/kon_validation.py`)
- **Pre-warm fixed** — `tauri::async_runtime::spawn` instead of `tokio::spawn`; model loads in background before first dictation
- **Preferences infinite loop fixed** — `Object.assign` mutation instead of object reassignment; Svelte 5 module state now stable
- **DOM hydration fixed** — `applyToDOM` called on store init so `data-theme` is always set, even without Tauri webview injection
- **Vulkan feature flag committed** — `whisper-vulkan` in `crates/transcription/Cargo.toml`
- **`docs/dev-setup.md`** — authoritative dependency and launch reference
## What's left
### Immediate — Vulkan GPU build
Vulkan build was not yet confirmed. Three system packages needed before it will compile:
```bash
sudo dnf install vulkan-headers vulkan-loader-devel glslc
```
Then launch:
```bash
cd /home/jake/Documents/CORBEL-Projects/kon
LIBCLANG_PATH=/usr/lib64/llvm21/lib64 npm run tauri dev
```
Confirm GPU active in startup logs:
```
whisper_backend_init_gpu: device 0: NVIDIA GeForce RTX 4070
```
### Manual validation (requires running app)
Three items from the validation checklist that need real Tauri runtime:
- [ ] Persistence test — set non-default zone/font, close, relaunch, verify zero flash
- [ ] Cross-window preferences — open float/viewer windows, check they hydrate correctly
- [ ] 90-second onboarding — fresh-model launch, first dictation under 90s
### Pre-release (before any build beyond Jake's machine)
- [ ] Updater signing key — `tauri signer generate`, public key → `tauri.conf.json`, private key → CI secrets
- [ ] ggml dedup — plan at `docs/superpowers/plans/2026-04-18-kon-ggml-dedup.md`, Option A (system-ggml shared lib), execute at Phase 3
## Gotchas discovered today
| Issue | Fix |
|---|---|
| `libclang` not on PATH | `set -Ux LIBCLANG_PATH /usr/lib64/llvm21/lib64` |
| `tokio::spawn` panics in Tauri `setup()` | Use `tauri::async_runtime::spawn` — Tokio runtime isn't live yet during setup |
| Svelte 5 `$effect` infinite loop on `updatePreferences` | Module-level `$state` must be mutated (`Object.assign`), never reassigned — stale references break loop guards |
| Duplicate theme sync `$effect` in both `+layout.svelte` and `SettingsPage.svelte` | Removed from SettingsPage — layout handles it |
| Vulkan build needs dev headers + shader compiler | `sudo dnf install vulkan-headers vulkan-loader-devel glslc` |
## Resume prompt
```
Picking up Kon dogfooding from the 2026/04/18 session.
HANDOVER is at HANDOVER.md in the project root.
First job: confirm Vulkan GPU build compiles and check startup logs for RTX 4070.
Then run the three manual validation items from the handover.
```