a1f3f3f134
Five-slice navigable map of the entire codebase under
docs/architecture-map/. Each slice is a self-contained
breadcrumbed sub-tree:
01-frontend (16) Svelte/SvelteKit UI
02-tauri-runtime (26) src-tauri commands + lifecycle
03-audio-transcription (16) audio + transcription crates
04-llm-formatting-mcp (19) llm, ai-formatting, mcp, cloud
05-core-storage-hotkey-build core, storage, hotkey, workspace,
(26) CI, dev glue
Plus master README.md and data-flow-end-to-end.md tracing
audio bytes from microphone to FTS5 search to MCP read.
Generated by 5 parallel subagents on 2026/05/09 against
HEAD 3c47000. Each page has YAML frontmatter, file:line code
refs, sibling cross-links, plain-English summaries.
Aggregated debt surfaced (full lists in master README):
RB-08 macOS power assertion, schema head drift v14 vs v15,
VAD blocked on ort version conflict, streaming primitives
not wired into live.rs, no prompt versioning, MCP has no
auth, cloud-providers in-memory keystore, SettingsPage
2 484 LOC, commands/live.rs 1 737 LOC, dual theme system,
brand rename to Lumenote pending across the codebase.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
69 lines
5.1 KiB
Markdown
69 lines
5.1 KiB
Markdown
---
|
|
name: Commands index
|
|
type: architecture-map-page
|
|
slice: 02-tauri-runtime
|
|
last_verified: 2026/05/09
|
|
---
|
|
|
|
# Commands index
|
|
|
|
> **Where you are:** [Architecture map](../../README.md) → [Tauri runtime](../README.md) → Commands
|
|
|
|
**Plain English summary.** This is the registry of every Tauri command file. Each `.rs` file under `src-tauri/src/commands/` either declares one or more `#[tauri::command]` functions invoked from the frontend, or is a utility (state, security, power) that the command files share. The full list of commands actually exposed to the frontend is registered via the `tauri::generate_handler!` macro in `src-tauri/src/lib.rs:321`.
|
|
|
|
## At a glance
|
|
|
|
- Path: `src-tauri/src/commands/`.
|
|
- 22 command modules (declare `#[tauri::command]`s) plus 3 utility modules (`mod.rs`, `power.rs`, `security.rs`).
|
|
- 71 `#[tauri::command]` functions registered in `lib.rs`. A handful of additional `#[tauri::command]` functions exist in source but are NOT registered (notably the small `clipboard::copy_to_clipboard` IS registered; nothing meaningful is unregistered as of last verification).
|
|
- Total LOC across `commands/`: 6,939 (Rust source, excluding tests folder).
|
|
|
|
## Module list
|
|
|
|
| Module | LOC | Registered commands | One-liner |
|
|
|---|---|---|---|
|
|
| [audio](audio.md) | 540 | 4 | Native cpal mic capture, list devices, save WAV |
|
|
| [clipboard](small-commands.md#clipboardrs) | 11 | 1 | Copy text to system clipboard via arboard |
|
|
| [diagnostics](diagnostics.md) | 534 | 6 | Panic hook, frontend error log, crash files, diagnostic-report bundler, OS info |
|
|
| [feedback](feedback.md) | 110 | 2 | HITL feedback capture and retrieval (Phase 2) |
|
|
| [fs](small-commands.md#fsrs) | 44 | 1 | Write UTF-8 text to a user-chosen path (Phase 9) |
|
|
| [hardware](small-commands.md#hardwarers) | 69 | 2 | Probe RAM/CPU/GPU, rank models for current hardware |
|
|
| [hotkey](hotkey.md) | 105 | 5 | evdev hotkey listener bridge (Linux Wayland-compatible) |
|
|
| [intentions](intentions.md) | 308 | 5 | Phase 7 implementation-intention rules CRUD |
|
|
| [live](live.md) | 1,737 | 2 | Live transcription session orchestration (the big one) |
|
|
| [llm](llm.md) | 423 | 10 | LLM model lifecycle, transcript cleanup, content tags |
|
|
| [meeting](small-commands.md#meetingrs) | 50 | 1 | Process-list poll for known meeting apps (Phase 8) |
|
|
| [models](models.md) | 691 | 13 | Whisper / Parakeet model registry, download, load, runtime capabilities |
|
|
| [mod](mod.md) | 114 | n/a | `build_initial_prompt` helper + module re-exports |
|
|
| [nudges](small-commands.md#nudgesrs) | 63 | 1 | Phase 6 nudge delivery via tauri-plugin-notification |
|
|
| [paste](paste.md) | 790 | 3 | Auto-insert at cursor across Linux/macOS/Windows |
|
|
| [power](power-and-security.md#powerrs) | 208 | 0 | macOS App Nap power assertion (no commands) |
|
|
| [profiles](profiles.md) | 185 | 9 | Profile + profile-term CRUD, auto-learn from edits |
|
|
| [rituals](small-commands.md#ritualsrs) | 43 | 2 | Morning triage last-shown sentinel (Phase 5) |
|
|
| [security](power-and-security.md#securityrs) | 30 | 0 | `ensure_main_window` defence-in-depth helper |
|
|
| [tasks](tasks.md) | 402 | 11 | Task CRUD, decompose-and-store, extract-from-transcript |
|
|
| [transcription](transcription.md) | 413 | 3 | Transcribe PCM (Whisper / Parakeet), transcribe file |
|
|
| [transcripts](transcripts.md) | 253 | 8 | Transcripts CRUD + FTS5 search + meta patches |
|
|
| [tts](tts.md) | 444 | 3 | Read aloud via spd-say / say / PowerShell SAPI (Phase 4) |
|
|
| [update](small-commands.md#updaters) | 16 | 2 | Updater placeholder (returns "disabled" until signing wired) |
|
|
| [windows](windows.md) | 197 | 4 | Open / close the secondary windows (preview, viewer, task float) |
|
|
|
|
## Per-command page assignments
|
|
|
|
- Big files have their own page: [audio](audio.md), [live](live.md), [paste](paste.md), [models](models.md), [diagnostics](diagnostics.md), [llm](llm.md), [tts](tts.md), [transcription](transcription.md), [tasks](tasks.md), [transcripts](transcripts.md), [intentions](intentions.md), [profiles](profiles.md), [windows](windows.md), [hotkey](hotkey.md), [feedback](feedback.md).
|
|
- Utilities collapsed into one page: [Power assertions and security](power-and-security.md) covers `power.rs` and `security.rs`.
|
|
- Small modules grouped: [Small commands](small-commands.md) covers `clipboard.rs`, `fs.rs`, `hardware.rs`, `meeting.rs`, `nudges.rs`, `rituals.rs`, `update.rs`.
|
|
- Module entry: [mod.md](mod.md) covers `mod.rs` (re-exports + `build_initial_prompt` helper).
|
|
|
|
## How to navigate
|
|
|
|
- Looking for a frontend `invoke('foo', ...)` call? Search for `pub async fn foo` or `pub fn foo` under `commands/`. The page for that file lists all its commands with arg + return signatures.
|
|
- Looking for an event the frontend listens for? See the slice README's "events emitted" section, or grep for the event name across `commands/`.
|
|
- Looking for ACL gotchas? Pages flag the commands that include an `ensure_main_window` guard.
|
|
|
|
## See also
|
|
|
|
- [Slice README](../README.md) — back to the top of slice 02.
|
|
- [App lifecycle](../app-lifecycle.md) — `lib.rs::run` is what registers everything listed here.
|
|
- [Capabilities and ACL](../capabilities-and-acl.md) — the permission set that gates every invocation.
|