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 lsp_child_registry(&self) -> LspChildRegistry

Clone the LSP child registry handle. Used by main.rs to give the signal handler thread a way to SIGKILL LSP children on shutdown.

pub fn stdout_writer(&self) -> SharedStdoutWriter

pub fn set_progress_sender(&self, sender: Option<ProgressSender>)

pub fn emit_progress(&self, frame: ProgressFrame)

pub fn progress_sender_handle(&self) -> Option<ProgressSender>

Get a clone of the current progress sender for use from background threads. Returns None when the main loop hasn’t installed one (tests, CLI without push frames).

Used by configure’s deferred file-walk thread to push warnings after configure has already returned, so configure latency stays sub-100 ms even on huge directories.

pub fn bash_background(&self) -> &BgTaskRegistry

pub fn drain_bg_completions(&self) -> Vec<BgCompletion>

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 search_index(&self) -> &RefCell<Option<SearchIndex>>

Access the search index.

pub fn search_index_rx(&self) -> &RefCell<Option<Receiver<SearchIndex>>>

Access the search-index build receiver.

pub fn symbol_cache(&self) -> SharedSymbolCache

Access the shared symbol cache.

pub fn reset_symbol_cache(&self) -> u64

Clear the shared symbol cache and return the new active generation.

pub fn semantic_index(&self) -> &RefCell<Option<SemanticIndex>>

Access the semantic search index.

pub fn semantic_index_rx( &self, ) -> &RefCell<Option<Receiver<SemanticIndexEvent>>>

Access the semantic-index build receiver.

pub fn semantic_index_status(&self) -> &RefCell<SemanticIndexStatus>

pub fn semantic_embedding_model(&self) -> &RefCell<Option<EmbeddingModel>>

Access the cached semantic embedding model.

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, ) -> PostEditWaitOutcome

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.

v0.17.3: this is the version-aware path. Pre-edit cached diagnostics are NEVER returned — only entries whose version matches the post-edit document version (or, for unversioned servers, whose epoch advanced past the pre-edit snapshot).

pub fn lsp_notify_watched_config_file( &self, file_path: &Path, change_type: FileChangeType, )

pub fn lsp_post_multi_file_write( &self, file_path: &Path, content: &str, file_paths: &[PathBuf], params: &Value, ) -> Option<PostEditWaitOutcome>

Post-write LSP hook for multi-file edits. When the patch includes config-file edits, notify active workspace servers via workspace/didChangeWatchedFiles before sending the per-document didOpen/didChange for the current file.

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

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

This is the single call site for all command handlers after write_format_validate. Behavior:

• When diagnostics: true is in params, notifies the server, waits until matching diagnostics arrive or the timeout expires, and returns Some(outcome) with the verified-fresh diagnostics + per-server status.
• When diagnostics: false (or absent), just notifies (fire-and-forget) and returns None. Callers must NOT wrap this in Some(...); the None is what tells the response builder to omit the LSP fields entirely (preserves the no-diagnostics-requested response shape).

v0.17.3: default wait_ms raised from 1500 to 3000 because real-world tsserver re-analysis on monorepo files routinely takes 2-5s. Still capped at 10000ms.

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.

pub fn lsp_server_count(&self) -> usize

Count active LSP server instances.

pub fn symbol_cache_stats(&self) -> Value

Symbol cache statistics from the language provider.