Struct AppContext 

pub struct AppContext { /* private fields */ }

Shared application context threaded through all command handlers.

Holds the language provider, backup/checkpoint stores, configuration, and call graph engine. Constructed once at startup and passed by reference to dispatch.

Stores use RefCell for interior mutability — the binary is single-threaded (one request at a time on the stdin read loop) so runtime borrow checking is safe and never contended.

Implementations

impl AppContext

pub fn new(provider: Box<dyn LanguageProvider>, config: Config) -> Self

pub fn provider(&self) -> &dyn LanguageProvider

Access the language provider.

pub fn backup(&self) -> &RefCell<BackupStore>

Access the backup store.

pub fn checkpoint(&self) -> &RefCell<CheckpointStore>

Access the checkpoint store.

pub fn config(&self) -> Ref<'_, Config>

Access the configuration (shared borrow).

pub fn config_mut(&self) -> RefMut<'_, Config>

Access the configuration (mutable borrow).

pub fn callgraph(&self) -> &RefCell<Option<CallGraph>>

Access the call graph engine.

pub fn watcher(&self) -> &RefCell<Option<RecommendedWatcher>>

Access the file watcher handle (kept alive to continue watching).

pub fn watcher_rx(&self) -> &RefCell<Option<Receiver<Result<Event>>>>

Access the watcher event receiver.

pub fn lsp(&self) -> RefMut<'_, LspManager>

Access the LSP manager.

pub fn lsp_notify_file_changed(&self, file_path: &Path, content: &str)

Notify LSP servers that a file was written. Call this after write_format_validate in command handlers.

pub fn lsp_notify_and_collect_diagnostics( &self, file_path: &Path, content: &str, timeout: Duration, ) -> Vec<StoredDiagnostic>

Notify LSP and optionally wait for diagnostics.

Call this after write_format_validate when the request has "diagnostics": true. Sends didChange to the server, waits briefly for publishDiagnostics, and returns any diagnostics for the file. If no server is running, returns empty immediately.

pub fn lsp_post_write( &self, file_path: &Path, content: &str, params: &Value, ) -> Vec<StoredDiagnostic>

Post-write LSP hook: notify server and optionally collect diagnostics.

This is the single call site for all command handlers after write_format_validate. When diagnostics is true, it notifies the server, waits briefly, drains queued LSP notifications, and returns diagnostics for the file. When false, it just notifies (fire-and-forget).

pub fn validate_path( &self, req_id: &str, path: &Path, ) -> Result<PathBuf, Response>

Validate that a file path falls within the configured project root.

When project_root is configured (normal plugin usage), this resolves the path and checks it starts with the root. Returns the canonicalized path on success, or an error response on violation.

When no project_root is configured (direct CLI usage), all paths pass through unrestricted for backward compatibility.