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>
2.8 KiB
2.8 KiB
name, type, slice, last_verified
| name | type | slice | last_verified |
|---|---|---|---|
| HANDOVER and root README pointer | architecture-map-page | 05-core-storage-hotkey-build | 2026/05/09 |
HANDOVER.md and root README.md pointer
Where you are: Architecture map → Core, Storage, Hotkey, Build → Handover and README pointer
Plain English summary. Two human-facing documents at the repo root: HANDOVER.md (the live session-handover note Jake reads at the start of each session) and README.md (the standing project README). This page does not duplicate either — it just points readers in the right direction.
HANDOVER.md (repo root)
- File:
HANDOVER.md(~11 KB). - Purpose: end-of-session handover. Captures what shipped, what is in flight, what to do next session, and the open release-blockers.
- Status as of 2026/04/25: Phase 9 (LLM content tags + bulk export) mostly shipped. One open MAJOR (RB-08, macOS power assertion) gates v0.1 tagging.
- Drift watch:
HANDOVER.mdrecords schema head as v14 (the migration that landed in that session). Migration v15 (idx_transcripts_profile_created) has since landed on disk; the next handover should reflect head = v15. Tracked inREADME.mdof this slice.
The handover is the source of truth for "what state is this project actually in right now". Read it first when picking up the project after a break. Do not transcribe it into the architecture map.
README.md (repo root)
- File:
README.md(~24 KB). - Purpose: standing project README for a contributor or curious reader. Covers what Magnotia is, why it exists, quick-start instructions, the
magnotia-crate map, the rebrand history (Magnotia / Lumenote), and pointers into the documentation. - Audience: external. The architecture map is internal.
The architecture map (this slice) is the implementation-level reference; the README is the introduction.
Other reference docs in docs/
docs/audit/phase0-cartography.md— earlier crate-graph cartography.docs/audit/phase1-lean-pass.md— phase-1 lean pass findings.docs/audit/phases-1-8-playbook.md— playbook for the multi-phase audit.docs/code-review-2026-04-22.md— the full audit findings, source of every RB-N reference.docs/dev-setup.md— local development setup notes.docs/handovers/HANDOVER-2026-04-24.md— archived handover from 24 April.docs/issues/*— critical-issue write-ups. SeeREADME.mdof this slice for the slice-5-relevant ones.docs/roadmap/*— feature roadmaps.docs/superpowers/*— design specs and audit specs (the most recent specs are the source of truth for current direction).docs/whisper-ecosystem/*— research notes on the Whisper / Parakeet / Moonshine ecosystem.