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>
This commit is contained in:
@@ -9,19 +9,19 @@ last_verified: 2026/05/09
|
||||
|
||||
> **Where you are:** [Architecture map](../README.md) → Audio + Transcription
|
||||
|
||||
**Plain English summary.** Two Rust workspace crates form the backbone of Magnotia's speech-to-text path. `magnotia-audio` captures microphone input via `cpal`, decodes audio files via `symphonia`, resamples to 16 kHz mono via `rubato`, and writes WAV files via `hound`. `magnotia-transcription` loads Whisper or Parakeet models, runs inference, and provides streaming primitives (VAD chunking, LocalAgreement-n commit policy, commit-bounded buffer trim) so live captures stay responsive.
|
||||
**Plain English summary.** Two Rust workspace crates form the backbone of Lumotia's speech-to-text path. `lumotia-audio` captures microphone input via `cpal`, decodes audio files via `symphonia`, resamples to 16 kHz mono via `rubato`, and writes WAV files via `hound`. `lumotia-transcription` loads Whisper or Parakeet models, runs inference, and provides streaming primitives (VAD chunking, LocalAgreement-n commit policy, commit-bounded buffer trim) so live captures stay responsive.
|
||||
|
||||
## At a glance
|
||||
|
||||
| Crate | LOC (`src/`) | Purpose |
|
||||
|---|---|---|
|
||||
| `magnotia-audio` | 1,533 | Capture, VAD stub, resample, decode, WAV I/O |
|
||||
| `magnotia-transcription` | 2,266 (incl. tests + build) | Engines, model manager, streaming primitives |
|
||||
| `lumotia-audio` | 1,533 | Capture, VAD stub, resample, decode, WAV I/O |
|
||||
| `lumotia-transcription` | 2,266 (incl. tests + build) | Engines, model manager, streaming primitives |
|
||||
|
||||
Public crate surface (re-exports from `lib.rs`):
|
||||
|
||||
```rust
|
||||
// magnotia-audio
|
||||
// lumotia-audio
|
||||
pub use capture::{AudioChunk, CaptureRuntimeError, DeviceInfo, MicrophoneCapture};
|
||||
pub use concurrency::decode_and_resample;
|
||||
pub use decode::{decode_audio_file, decode_audio_file_limited, probe_audio_duration_secs};
|
||||
@@ -30,7 +30,7 @@ pub use streaming_resample::StreamingResampler;
|
||||
pub use vad::SpeechDetector;
|
||||
pub use wav::{read_wav, write_wav, WavWriter};
|
||||
|
||||
// magnotia-transcription
|
||||
// lumotia-transcription
|
||||
pub use concurrency::run_inference;
|
||||
#[cfg(feature = "whisper")]
|
||||
pub use local_engine::load_whisper;
|
||||
@@ -57,7 +57,7 @@ External deps that matter:
|
||||
- `tracing 0.1` — backend boundary observability.
|
||||
- `voice_activity_detector` / `silero-vad-rust` — **deferred** (ort 2.0.0-rc.10 vs 2.0.0-rc.12 conflict; see `audio-vad.md`).
|
||||
|
||||
Cargo feature matrix (`magnotia-transcription`):
|
||||
Cargo feature matrix (`lumotia-transcription`):
|
||||
|
||||
| Feature | Default | Gates |
|
||||
|---|---|---|
|
||||
@@ -65,7 +65,7 @@ Cargo feature matrix (`magnotia-transcription`):
|
||||
| `whisper-vulkan` | yes | `whisper-rs/vulkan` (Vulkan GPU offload) |
|
||||
| Parakeet (`transcribe-rs`) | always on | unconditional dep, no feature flag |
|
||||
|
||||
`magnotia-audio` has no Cargo features.
|
||||
`lumotia-audio` has no Cargo features.
|
||||
|
||||
## Map of this slice
|
||||
|
||||
@@ -79,7 +79,7 @@ Cargo feature matrix (`magnotia-transcription`):
|
||||
- [`transcription-whisper.md`](transcription-whisper.md) — `WhisperRsBackend`, `WhisperContext`, params, `initial_prompt`, GPU offload.
|
||||
- [`transcription-parakeet.md`](transcription-parakeet.md) — `SpeechModelAdapter` + `ParakeetWordGranularity`.
|
||||
- [`transcription-streaming.md`](transcription-streaming.md) — `VadChunker` trait, `RmsVadChunker`, `LocalAgreement`, `trim_buffer_to_commit_point`.
|
||||
- [`transcription-model-manager.md`](transcription-model-manager.md) — download flow, SHA verify, `.magnotia-verified` manifest, Range resume.
|
||||
- [`transcription-model-manager.md`](transcription-model-manager.md) — download flow, SHA verify, `.lumotia-verified` manifest, Range resume.
|
||||
- [`transcription-concurrency.md`](transcription-concurrency.md) — `run_inference` async wrapper around `spawn_blocking`.
|
||||
- [`cargo-features.md`](cargo-features.md) — feature matrix, build commands, rationale.
|
||||
- [`build-tokenizers-guard.md`](build-tokenizers-guard.md) — `build.rs` Windows-MSVC-CRT guard against `tokenizers`.
|
||||
@@ -90,13 +90,13 @@ Cargo feature matrix (`magnotia-transcription`):
|
||||
- **Slice 2 (Tauri runtime)** owns `src-tauri/src/commands/{audio,transcription,live,models}.rs`. Those wrappers call into this slice via the `pub use` exports above. The live command in particular drives `MicrophoneCapture` + `StreamingResampler` + `RmsVadChunker` + `LocalAgreement` + `WavWriter` together. This crate publishes the primitives; slice 2 publishes the orchestrator.
|
||||
- **Slice 4 (LLM + AI formatting)** runs after this slice produces a `Transcript`. It consumes the segment text via the storage layer, never directly. No type traffic flows back into this slice from formatting.
|
||||
- **Slice 5 (core / storage / hotkey / build)** provides the shared types this slice depends on:
|
||||
- `magnotia_core::error::{MagnotiaError, Result}` — error envelope.
|
||||
- `magnotia_core::types::{AudioSamples, Segment, Transcript, TranscriptionOptions, EngineName, ModelId, DownloadProgress, Megabytes}`.
|
||||
- `magnotia_core::constants::{WHISPER_SAMPLE_RATE, VAD_SPEECH_THRESHOLD}`.
|
||||
- `magnotia_core::hardware::vulkan_loader_available` — runtime Vulkan probe used by `WhisperRsBackend`.
|
||||
- `magnotia_core::tuning::{inference_thread_count, Workload}` — power-aware thread count picker.
|
||||
- `magnotia_core::paths::app_paths` — `models_dir()` / `speech_model_dir()` resolution.
|
||||
- `magnotia_core::model_registry::{find_model, all_models, ModelEntry, ModelFile}` — declarative model catalogue.
|
||||
- `lumotia_core::error::{MagnotiaError, Result}` — error envelope.
|
||||
- `lumotia_core::types::{AudioSamples, Segment, Transcript, TranscriptionOptions, EngineName, ModelId, DownloadProgress, Megabytes}`.
|
||||
- `lumotia_core::constants::{WHISPER_SAMPLE_RATE, VAD_SPEECH_THRESHOLD}`.
|
||||
- `lumotia_core::hardware::vulkan_loader_available` — runtime Vulkan probe used by `WhisperRsBackend`.
|
||||
- `lumotia_core::tuning::{inference_thread_count, Workload}` — power-aware thread count picker.
|
||||
- `lumotia_core::paths::app_paths` — `models_dir()` / `speech_model_dir()` resolution.
|
||||
- `lumotia_core::model_registry::{find_model, all_models, ModelEntry, ModelFile}` — declarative model catalogue.
|
||||
- Storage (slice 5) writes the produced `Transcript` to disk; this slice does not call into it directly.
|
||||
|
||||
## Open questions / debt
|
||||
@@ -116,7 +116,7 @@ Cargo feature matrix (`magnotia-transcription`):
|
||||
- `docs/whisper-ecosystem/brief.md` — top-level Whisper-ecosystem audit (the items #6, #8, #13, #19, #21, #24, #25, #26 referenced throughout this slice).
|
||||
- `docs/whisper-ecosystem/workstream-A.md` — VAD / streaming roadmap (the source of `RmsVadChunker` thresholds).
|
||||
- `docs/whisper-ecosystem/workstream-B.md` — UI commit/tentative contract that drives `LocalAgreement`.
|
||||
- `docs/whisper-ecosystem/magnotia-context.md` — context summary for the workstreams.
|
||||
- `docs/whisper-ecosystem/lumotia-context.md` — context summary for the workstreams.
|
||||
- `docs/code-review-2026-04-22.md` — audit pass that flagged decode.rs RB-09 and `read_wav` filter_map bug (both fixed in tree).
|
||||
- `docs/issues/decoder-partial-audio-on-error.md` — the RB-09 ticket.
|
||||
- `docs/issues/native-capture-worker-join.md`, `c1-live-session-race.md`, `run-live-session-monolith.md` — slice 2's live-session debt; they reference primitives in this slice.
|
||||
|
||||
Reference in New Issue
Block a user