Phase 9 of the rebrand cascade. Sweep covers everything the Phase 8
frontend pass deliberately skipped: docs/, root markdown, scripts,
Cargo.toml descriptions, code comments that survived earlier
word-boundary sed, plus a handful of identifiers caught on the final
verify pass.
transcription-app changes:
- README.md, HANDOVER.md, KNOWN-ISSUES.md, run.sh — magnotia/Magnotia
-> lumotia/Lumotia.
- docs/ — sweep across all subdirs except docs/handovers/ (preserved
as immutable audit trail). Includes architecture-map references
to magnotia_core::*, magnotia_storage::*, etc. now pointing at
lumotia_*; dev-setup.md tracing output examples (lumotia_startup
target); brief/ + superpowers/ + issues/ + whisper-ecosystem/ +
audit/.
- Cargo.toml descriptions on 9 crates (core, audio, cloud-providers,
hotkey, llm, mcp, plus referenced others).
- crates/core/src/{error,hardware,recommendation,paths}.rs +
crates/audio/src/wav.rs + crates/llm/src/model_manager.rs +
crates/cloud-providers/src/keystore.rs + crates/mcp/src/lib.rs —
doc comments and a model-manager user-agent string.
- Caught on final pass: BroadcastChannel("magnotia_task_sync") -> ...
("lumotia_task_sync"); magnotia_locale i18n localStorage key
renamed + migration shim added; CSS keyframe names
magnotiaPulse / magnotiaBar / magnotiaFade renamed in the design-
system kit; magnotia_viewer_item / magnotia_viewer_mode handoff
keys renamed in HistoryPage + viewer/+page.svelte; src/assets/
wordmark.svg text.
- src-tauri/src/lib.rs comment cleanup ("magnotia era" was sed'd
to "lumotia era" earlier — restored).
Preserved (intentional):
- crates/core/src/paths.rs — keeps "magnotia" / "Magnotia" / ".magnotia"
legacy detection strings in legacy_and_target_paths() so the
migration shim can still find user data from the magnotia era.
- src/lib/stores/{page,focusTimer}.svelte.ts + src/lib/i18n/index.ts
— migration call sites reference the legacy magnotia keys
deliberately.
- docs/handovers/ — historical audit trail.
cargo build --workspace passes. npm run check: 0 errors / 0 warnings
(3958 files). cargo test --workspace: 339 pass / 0 fail.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2.7 KiB
2.7 KiB
name, type, slice, last_verified
| name | type | slice | last_verified |
|---|---|---|---|
| First run page | architecture-map-page | 01-frontend | 2026/05/09 |
First run page
Where you are: Architecture map → Frontend → Pages overview → First run
Plain English summary. What the user sees the first time they launch Lumotia, before any model is on disk. Probes hardware, recommends a Whisper model size, and downloads the chosen model (Whisper or Parakeet). On success, transitions to the dictation page.
At a glance
- Path:
src/lib/pages/FirstRunPage.svelte - LOC: 337
- Imports:
- Tauri:
invoke,listen. - Stores:
page,settings,saveSettingsfrompage.svelte.ts.toasts. - Components:
UnicodeSpinner. - External:
lucide-svelte(Download,CheckCircle,Sunrise,Moon,Play).
- Tauri:
- Includes: also
ShutdownRitualPageis imported here (suggesting the "evening ritual" preview lives in this same flow). Verify on read; treat as a coupled flow.
What's in here
Probe
onMountcallsprobe_systemandrank_models(FirstRunPage.svelte:31-32) to compute recommended models given the user's RAM, GPU, OS.- Sets
probing = falseand renders the recommendation UI.
Download
downloadAndGo(modelId)(FirstRunPage.svelte:55-95):- Subscribes to
model-download-progressandparakeet-download-progressevents. - Calls
download_modelthenload_model(Whisper) ordownload_parakeet_modelthenload_parakeet_model. - On success, sets
ready = trueand routes to dictation (page.current = "dictation"). - Computes
estimatedMinutesfrom elapsed and progress percent (derived.by).
- Subscribes to
Triggering
- The shell auto sets
page.current = "first-run"iflist_modelsandlist_parakeet_modelsare both empty (+layout.svelte:346-353). - Skip path: clicking "Get started" without a model lets the user opt out (still routes to dictation).
Tauri command surface
probe_system, rank_models, download_model, load_model, download_parakeet_model, load_parakeet_model. Events: model-download-progress, parakeet-download-progress.
Watch outs
- The download is a single shot. There is no resume on cancel; if the user closes the app mid download, they restart from zero. Slice 02/05 may improve this later.
estimatedMinutesis a linear extrapolation. Network speed is not constant; expect the value to wiggle.- The page imports
ShutdownRitualPagebut the value of doing so should be confirmed (potential dead import).
See also
- Pages overview. When this page is forced.
- Frontend ↔ Tauri bridge. Probe and download commands.
- Windows and routes. Shell triggers.