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

10 KiB
Raw Permalink Blame History

name, type, slice, last_verified
name type slice last_verified
Frontend ↔ Tauri bridge architecture-map-page 01-frontend 2026/05/09

Frontend ↔ Tauri bridge

Where you are: Architecture map → Frontend → 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:* CustomEvents 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

Reference in New Issue View Git Blame Copy Permalink