Struct App 

pub struct App {
    pub current_screen: Box<dyn AppScreen>,
    pub settings: SharedSettings,
    pub vault: Option<Arc<NoteVault>>,
    pub screen_generation: u64,
    pub update: Option<UpdateStatus>,
    pub parked_flashes: Vec<String>,
    pub rag_sync_task: Option<JoinHandle<()>>,
    pub rag_status: RagStatus,
}

Fields

current_screen: Box<dyn AppScreen>

The live Screen. There is always exactly one: the app starts on Start and every transition swaps the box whole in switch_screen, so there is no in-between state to represent.

settings: SharedSettings

vault: Option<Arc<NoteVault>>

The active vault. None until a workspace path is configured. Rebuilt only when the workspace path changes in settings.

screen_generation: u64

Monotonic counter bumped by every screen swap (see switch_screen below). The main event loop breaks its inner drain when this changes, so the new screen is drawn before any event still queued is delivered to it. The queued events are not dropped — filtering stale results is the job of the addressed event families (OverlayData, Ask) and per-event guards, not of this counter.

update: Option<UpdateStatus>

A newer release found by the background update check at startup, if any. Seeded into each editor screen so the footer can show the indicator.

parked_flashes: Vec<String>

One-shot flashes waiting for a screen that can show them, oldest first: the notice that some key binding cannot reach this terminal, and whatever AppEvent::ParkFlash sent (Start’s “your last note is gone”).

Parked rather than sent, because they are decided while Start is the live screen, and FlashMessage is only handled by the editor. switch_screen drains them the first time it opens an editor, so each is shown once and not re-flashed on every later screen swap (unlike update, which is a standing indicator and is re-seeded).

rag_sync_task: Option<JoinHandle<()>>

The background RAG sync task for the current vault, when a server is configured. Aborted and respawned when the vault is rebuilt.

rag_status: RagStatus

Latest RAG status from the background task, held app-globally so a freshly-opened editor can be seeded immediately (like update) instead of showing nothing until the next sync tick.

Implementations

impl App

pub async fn new(config_path: Option<PathBuf>) -> Result<Self>

Load settings from config_path (or the default location) and build the app on them.

pub async fn from_settings(settings: SharedSettings) -> Self

The app over already-loaded settings: opens the vault those settings name (if any) and starts on the Start screen. The door tests use — nothing here touches the config file.

pub async fn open_vault(settings: &SharedSettings) -> Option<Arc<NoteVault>>

A fresh NoteVault for whatever workspace the settings currently resolve to, wired to the configured index and the workspace’s inbox. None if no workspace is configured or the vault fails to open.

Used at startup and every time the workspace changes (preferences saved, onboarding finished, workspace switched).