jake/Lumotia
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
Lumotia/docs/architecture-map/01-frontend/frontend-tauri-bridge.md
Jake 26c7307607
Some checks failed
check / cargo check (macos-latest) (push) Has been cancelled
Details
check / cargo check (ubuntu-22.04) (push) Has been cancelled
Details
check / cargo check (windows-latest) (push) Has been cancelled
Details
check / svelte build + lint (push) Has been cancelled
Details
agent: lumotia-rebrand — docs, scripts, root config, residuals 
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>
2026-05-13 12:38:03 +01:00

164 lines
10 KiB
Markdown
Raw Permalink Blame History

---
name: Frontend ↔ Tauri bridge
type: architecture-map-page
slice: 01-frontend
last_verified: 2026/05/09
---
# Frontend ↔ Tauri bridge
> **Where you are:** [Architecture map](../README.md) → [Frontend](README.md) → Frontend ↔ Tauri bridge
**Plain English summary.** The complete surface where the Svelte frontend talks to the Rust runtime. Two channels: synchronous request/response via `invoke()`, and asynchronous events via `listen()` / `emit()`. Every command name and every event name the frontend touches is listed here so slice 02 can verify reciprocal mentions.
## At a glance
- **Direction in (Rust → frontend):** events listed under "Tauri events listened to".
- **Direction out (frontend → Rust):** all `invoke()` commands listed under "Tauri commands invoked".
- **DOM-only events:** `lumotia:*` `CustomEvent`s on `window`. These never cross the Rust boundary.
- **Cross-window event:** `lumotia:preferences-changed` is the only one that goes through `emit()`.
## Tauri commands invoked (alphabetical)
Discovered via `grep -rho 'invoke([\"\\']\\([a-zA-Z_][a-zA-Z0-9_]*\\)' src/`. Each name appears at least once in the frontend.
| Command | Caller(s) |
|---|---|
| `add_transcript` | `stores/page.svelte.ts:234` (`addToHistory`) |
| `check_engine` | `pages/SettingsPage.svelte:826` |
| `check_for_update` | `routes/+layout.svelte:356` |
| `check_hotkey_access` | `routes/+layout.svelte:86` |
| `check_llm_model` | `pages/DictationPage.svelte:241`, `pages/SettingsPage.svelte:597` |
| `check_parakeet_engine` | `pages/SettingsPage.svelte:857` |
| `check_parakeet_model` | `pages/SettingsPage.svelte:858` |
| `cleanup_transcript_text_cmd` | `pages/DictationPage.svelte:472` |
| `complete_task_cmd` | `stores/page.svelte.ts:474` |
| `copy_to_clipboard` | DictationPage, FilesPage, HistoryPage, viewer/+page, preview/+page |
| `delete_implementation_rule` | `stores/implementationIntentions.svelte.ts:82` |
| `delete_llm_model` | `pages/SettingsPage.svelte:660` |
| `delete_profile_cmd` | `stores/profiles.svelte.ts:93` |
| `delete_profile_term_cmd` | `stores/profiles.svelte.ts:121` |
| `delete_task_cmd` | `stores/page.svelte.ts:456` |
| `delete_transcript` | `stores/page.svelte.ts:320`, `pages/HistoryPage.svelte:285` |
| `deliver_nudge` | `stores/nudgeBus.svelte.ts:112` |
| `detect_meeting_processes` | `routes/+layout.svelte:399` |
| `detect_paste_backends` | `pages/SettingsPage.svelte:850` |
| `download_llm_model` | `pages/SettingsPage.svelte:619` |
| `download_model` | `pages/SettingsPage.svelte:929`, `pages/FirstRunPage.svelte:59` |
| `download_parakeet_model` | `pages/SettingsPage.svelte:988`, `pages/FirstRunPage.svelte:73` |
| `extract_content_tags_cmd` | `pages/HistoryPage.svelte:433, 470` |
| `extract_tasks_from_transcript_cmd` | `pages/DictationPage.svelte:491` |
| `generate_diagnostic_report` | `pages/SettingsPage.svelte:377` |
| `get_llm_status` | DictationPage, SettingsPage, layout (refresh path) |
| `get_runtime_capabilities` | `pages/DictationPage.svelte:134`, `pages/SettingsPage.svelte:543` |
| `is_wayland_session` | `routes/+layout.svelte:82` |
| `list_audio_devices` | `pages/SettingsPage.svelte:187` |
| `list_models` | `routes/+layout.svelte:346`, `pages/SettingsPage.svelte:846, 930` |
| `list_parakeet_models` | `routes/+layout.svelte:347` |
| `load_llm_model` | `pages/DictationPage.svelte:243`, `pages/SettingsPage.svelte:634` |
| `load_model` | `pages/DictationPage.svelte:272`, `pages/SettingsPage.svelte:944`, `pages/FirstRunPage.svelte:60` |
| `load_parakeet_model` | `pages/DictationPage.svelte:270`, `pages/SettingsPage.svelte:1003`, `pages/FirstRunPage.svelte:74` |
| `log_frontend_error` | `routes/+layout.svelte:282` |
| `open_preview_window` | `pages/DictationPage.svelte:385` |
| `open_task_window` | `pages/TasksPage.svelte:231` |
| `open_viewer_window` | `pages/HistoryPage.svelte:392, 556` |
| `paste_text` | `pages/DictationPage.svelte:544` |
| `paste_text_replacing` | `routes/preview/+page.svelte:92` |
| `prewarm_default_model_cmd` | `routes/+layout.svelte:371` |
| `probe_system` | `pages/SettingsPage.svelte:822`, `pages/FirstRunPage.svelte:31` |
| `rank_models` | `pages/FirstRunPage.svelte:32` |
| `recommend_llm_tier` | `pages/SettingsPage.svelte:587` |
| `save_diagnostic_report` | `pages/SettingsPage.svelte:405` |
| `save_preferences` | `stores/preferences.svelte.ts:109` |
| `start_evdev_hotkey` | `routes/+layout.svelte:129` |
| `start_live_transcription_session` | `pages/DictationPage.svelte:344` |
| `stop_evdev_hotkey` | `routes/+layout.svelte:424` |
| `stop_live_transcription_session` | `pages/DictationPage.svelte:415` |
| `test_llm_model` | `pages/SettingsPage.svelte:684` |
| `transcribe_file` | `pages/FilesPage.svelte:76` |
| `tts_list_voices` | `pages/SettingsPage.svelte:750` |
| `tts_speak` | `pages/SettingsPage.svelte:769`, `stores/implementationIntentions.svelte.ts:170`, `stores/nudgeBus.svelte.ts:119` |
| `tts_stop` | `components/SpeakerButton.svelte` (cancel current TTS) |
| `uncomplete_task_cmd` | `stores/page.svelte.ts:491` |
| `unload_llm_model` | `pages/SettingsPage.svelte:648` |
| `update_evdev_hotkey` | `routes/+layout.svelte:127` |
| `update_profile_cmd` | `stores/profiles.svelte.ts:77` |
| `update_transcript` | `stores/page.svelte.ts:272`, `routes/viewer/+page.svelte:326` |
Plus any commands invoked by `saveMarkdown.ts` via the dialog/file-write plugin imports rather than direct `invoke`. (Verified the truncated `tts_s...` resolves to `tts_speak` and `tts_stop`; both are listed.)
## Tauri events listened to (Rust → frontend)
| Event | Listener |
|---|---|
| `lumotia:hotkey-pressed` | `routes/+layout.svelte:177` (evdev backend) |
| `lumotia:llm-download-progress` | `pages/SettingsPage.svelte:873` |
| `lumotia:open-wind-down` | `routes/+layout.svelte:251` (tray menu hook) |
| `lumotia:preferences-changed` | `routes/+layout.svelte:263`, `routes/float/+layout@.svelte`, `routes/viewer/+layout@.svelte`, `routes/preview/+layout@.svelte:41` |
| `model-download-progress` | `pages/SettingsPage.svelte:864`, `pages/FirstRunPage.svelte:46`, `components/ModelDownloader.svelte:31` |
| `parakeet-download-progress` | `pages/SettingsPage.svelte:880`, `pages/FirstRunPage.svelte:50` |
| `preview-cleanup` | `routes/preview/+page.svelte:141` |
| `preview-hide` | `routes/preview/+page.svelte:161` |
| `preview-listening` | `routes/preview/+page.svelte:113` |
| `task-window-focus` | `routes/float/+layout@.svelte` |
| `tauri://drag-drop` | `pages/FilesPage.svelte:28` |
| `tauri://drag-enter` | `pages/FilesPage.svelte:34` |
| `tauri://drag-leave` | `pages/FilesPage.svelte:35` |
## Tauri events emitted (frontend → Rust or other windows)
| Event | Emitter | Purpose |
|---|---|---|
| `lumotia:preferences-changed` | `stores/preferences.svelte.ts` (`broadcastPreferences`) | Cross-window preference sync. |
| `preview-append` | `pages/DictationPage.svelte:165` | Stream partial text to overlay window. |
| `preview-listening` | `pages/DictationPage.svelte:381` | Tell overlay to enter listening state. |
| `preview-cleanup` | `pages/DictationPage.svelte:531` | Tell overlay to enter cleanup state. |
| `preview-final` | `pages/DictationPage.svelte:539` | Tell overlay to render final text. |
| `preview-hide` | `pages/DictationPage.svelte:606` | Tell overlay to dismiss. |
## DOM-only `lumotia:*` window events (intra-frontend bus)
| Event | Dispatcher | Listener(s) |
|---|---|---|
| `lumotia:focus-timer-cancelled` | `stores/focusTimer.svelte.ts` | `completionStats` (indirectly), components subscribed to focus timer. |
| `lumotia:focus-timer-complete` | `stores/focusTimer.svelte.ts` | Same as above. |
| `lumotia:implementation-rules-changed` | `stores/implementationIntentions.svelte.ts` | `ImplementationRulesEditor`. |
| `lumotia:microstep-generated` | `stores/nudgeBus.svelte.ts` (around micro step generation) | `MicroSteps.svelte`. |
| `lumotia:morning-triage-finished` | `MorningTriageModal.svelte` | `nudgeBus`. |
| `lumotia:start-timer` | `WipTaskList.svelte`, `MicroSteps.svelte` | `FocusTimer.svelte` + `focusTimer` store. |
| `lumotia:step-completed` | `MicroSteps.svelte` | `completionStats` refresh. |
| `lumotia:task-completed` | `stores/page.svelte.ts` (`completeTask`) | `completionStats`. |
| `lumotia:task-deleted` | `stores/page.svelte.ts` (`deleteTask`) | `completionStats`. |
| `lumotia:task-uncompleted` | `stores/page.svelte.ts` (`uncompleteTask`) | `completionStats`. |
| `lumotia:toggle-recording` | `routes/+layout.svelte` (after hotkey debounce, both backends) | `pages/DictationPage.svelte`. |
## Window APIs
- `getCurrentWindow().minimize()` and `.toggleMaximize()`. `Titlebar.svelte`.
- `getCurrentWindow().label`. Used to guard hotkey registration to the main window only and to filter own-source preference echoes.
- `convertFileSrc(absolutePath)`. HistoryPage and viewer use this for `<audio>` elements.
## Plugins
| Plugin | Used by |
|---|---|
| `@tauri-apps/plugin-dialog` | `utils/saveMarkdown.ts`, `pages/FilesPage.svelte:handleBrowse`. |
| `@tauri-apps/plugin-global-shortcut` | `routes/+layout.svelte` (X11 / macOS / Windows hotkey backend). |
| `@tauri-apps/plugin-autostart` | SettingsPage launch-at-login toggle. |
| `@tauri-apps/plugin-notification` | Available, used by nudge bus or a related path. Confirm specific call sites. |
| `@tauri-apps/plugin-opener` | Available, used to open external URLs. Confirm specific call sites. |
## Watch outs
- The truncated grep returned `tts_s...` as a unique prefix. Verify every TTS command name (`tts_speak`, possibly `tts_stop`) against `lib.rs` to make sure the table above is exhaustive.
- The "preview-*" events have two flavours: `lumotia:` namespaced (`preferences-changed`) and bare (`preview-listening`, `preview-cleanup`, `preview-hide`, `preview-append`, `preview-final`). The bare names are scoped to the overlay window's two-way handshake. Do not rename.
- `lumotia:open-wind-down` listener is in `+layout.svelte` so the page opens regardless of which window the tray click came from. If you ever isolate windows further, this assumption breaks.
- `task-window-focus` is the only event sent specifically to the float window.
- DOM `CustomEvent` handlers do not survive across windows (they are window-local). The tasks list refresh trick on focus relies on this.
## See also
- [Windows and routes](windows-and-routes.md). For the listener mounting points.
- [Stores](stores.md). For the dispatch points of intra-frontend events.
- [../02-tauri-runtime/README.md](../02-tauri-runtime/README.md). For the matching Rust handlers (slice 02 will mirror this table from the other side).
Reference in New Issue View Git Blame Copy Permalink