Enum AppEvent 

pub enum AppEvent {
    Input(InputEvent),
    OpenScreen(ScreenEvent),
    Quit,
    Redraw,
    RagStatus(RagStatus),
    Autosave,
    AutosaveCompleted {
        path: VaultPath,
        saved_revision: Option<NonZeroU64>,
        title: Option<String>,
    },
    OpenPath {
        path: VaultPath,
        emphasis: Option<Vec<String>>,
    },
    OpenAttachment(VaultPath),
    FocusSidebar,
    OpenDrawerView(DrawerView),
    RunTagQuery(String),
    JumpToHeading(String),
    ExecuteLeaderAction(LeaderAction),
    FlashMessage(String),
    Update(UpdateFlow),
    ApplyTheme {
        theme: Box<Theme>,
        persist: bool,
    },
    LinkTargetMeta {
        target: String,
        count: usize,
    },
    BacklinkCountLoaded {
        path: VaultPath,
        count: usize,
    },
    GitStatusLoaded(Option<String>),
    PreferencesSaved,
    OnboardingFinished,
    ClosePreferences,
    OpenFileBrowser,
    TriggerFastReindex,
    TriggerFullReindex,
    IndexingDone(Result<Duration, String>),
    OpenJournal,
    CloseOverlay,
    FollowLink(String),
    FollowLabel(String),
    InsertAtCursor(String),
    FileOp(FileOp),
    OverlayData(OverlayData),
    Ask(AskData),
    VaultConflict(String),
    WorkspaceSwitched(String),
    SavedSearch(SavedSearchFlow),
    SortChanged {
        target: SortTarget,
        field: SortField,
        order: SortOrder,
        group_directories: bool,
        persist: bool,
    },
}

All events that flow through the system — both input events (from crossterm) and app-level messages sent by components / screens to the main loop.

Variants

Input(InputEvent)

OpenScreen(ScreenEvent)

Quit

Redraw

RagStatus(RagStatus)

Background RAG sync task reporting its connection/sync status. Rendered in the editor footer.

Autosave

AutosaveCompleted

Background autosave task finished. saved_revision carries the editor’s content_revision at the moment the save was issued on success, None if the write failed. The editor screen uses path to ignore stale completions for notes the user has already navigated away from, and saved_revision to clear the dirty flag iff the buffer is still at that revision (i.e. no edits during the save). NonZeroU64 because the editor’s content_revision is never zero.

Fields

path: VaultPath

saved_revision: Option<NonZeroU64>

title: Option<String>

The note’s recomputed title (first body line) from the save, so the sidebar row can be retitled. None when the save failed.

OpenPath

Open a note (or directory) — emphasis carries the originating query’s needles when the open comes from a query result, so the editor lights up the matched spans (spec §5.1). Use AppEvent::open for the plain case.

Fields

path: VaultPath

emphasis: Option<Vec<String>>

OpenAttachment(VaultPath)

Open an attachment (a non-note file) in the editor area’s read-only attachment view. Sent by the file browser when an attachment row is activated.

FocusSidebar

OpenDrawerView(DrawerView)

Switch the drawer to the given view and reveal it (sent by the activity rail and, later, by leader paths / mouse clicks).

RunTagQuery(String)

Run the query #<label> in the FIND drawer (sent by the TAGS drawer).

JumpToHeading(String)

Jump the editor cursor to the first heading with this text (sent by the OUTLINE drawer).

ExecuteLeaderAction(LeaderAction)

Run a leader-tree action (sent by the command palette after it has closed itself, so the action sees no open overlay).

FlashMessage(String)

Show a transient footer flash — async tasks report results with it.

Update(UpdateFlow)

The self-update lifecycle (one owner in main.rs for the app-global bookkeeping, one in the editor screen for display).

ApplyTheme

Apply (and optionally persist) a resolved theme — sent by the theme picker: previews on selection move, persists on Enter. Carries the full Theme so applying never re-reads the themes directory.

Fields

theme: Box<Theme>

persist: bool

LinkTargetMeta

Async-loaded backlink count for the link target under the editor cursor (status line 2’s → target · N backlinks affordance).

Fields

target: String

count: usize

BacklinkCountLoaded

Async-loaded backlink count for the note at path (status line 2).

Fields

path: VaultPath

count: usize

GitStatusLoaded(Option<String>)

Async-loaded workspace git summary for the status bar, None when the workspace is not a git repository.

PreferencesSaved

Sent by PreferencesScreen when user confirms Save. The shared settings reference already contains the updated values.

OnboardingFinished

Sent by OnboardingScreen when the user confirms Finish on the summary step. The shared settings already contain the committed draft; main.rs rebuilds the vault and navigates to Start (same as PreferencesSaved).

ClosePreferences

Sent by PreferencesScreen when user discards or closes unchanged.

OpenFileBrowser

Sent by VaultSection; PreferencesScreen::handle_app_message intercepts.

TriggerFastReindex

Sent by IndexingSection; PreferencesScreen intercepts.

TriggerFullReindex

IndexingDone(Result<Duration, String>)

Sent by indexing tokio task on completion.

OpenJournal

Open (or create) today’s journal entry and switch to it in the editor.

CloseOverlay

Dismiss the active editor overlay (note browser, Saved Searches modal, or dialog). The single close path for everything owned by OverlayHost.

FollowLink(String)

Follow the link under the editor cursor: note name/path or external URL.

FollowLabel(String)

Open the search modal pre-filled with #<name> to browse notes by label.

InsertAtCursor(String)

Insert raw text at the editor’s cursor (replacing any active selection). Used by the screen layer to deliver async results back to the editor — e.g. the markdown link generated after a clipboard image is saved as an attachment.

FileOp(FileOp)

File-operation requests and confirmations — owned by the editor screen’s handle_file_op.

OverlayData(OverlayData)

An async result addressed to the open overlay (see Overlay data in CONTEXT.md). Routed only to the OverlayHost; with no (or the wrong) overlay open it is stale by definition and dropped.

Ask(AskData)

An async result addressed to the Ask workspace (see CONTEXT.md: Ask workspace). Its own family — Ask is a panel, not an overlay, so it is never routed through OverlayData.

VaultConflict(String)

A vault was found to be structurally unusable (conflicts, invalid layout, etc.). Carries a formatted, human-readable error message.

Handled by handle_app_message in main.rs, which clears the workspace, saves settings, and opens the settings screen with an error overlay. To add a new conflict source: emit this event from the detection site; no other files need to change.

WorkspaceSwitched(String)

User switched to a different workspace. Carries the workspace name. Handled by main.rs to rebuild the vault and navigate to StartScreen.

SavedSearch(SavedSearchFlow)

The saved-search save/select flow — owned by the editor screen’s handle_saved_search.

SortChanged

Sort selection changed in the sort dialog — apply live to target. When persist is set (sidebar’s “save as default”), also write the choice to settings. group_directories is sidebar-only (the query panel ignores it).

Fields

target: SortTarget

field: SortField

order: SortOrder

group_directories: bool

persist: bool

Implementations

impl AppEvent

pub fn send_input(event: InputEvent) -> Self

pub fn open(path: VaultPath) -> Self

OpenPath without query emphasis — the common case.

Trait Implementations

impl Debug for AppEvent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.