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 build_status_snapshot(&self) -> StatusPayload

pub fn build_status_snapshot_for_session( &self, session_id: &str, ) -> StatusPayload

impl AppContext

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

pub fn gitignore(&self) -> Option<Arc<Gitignore>>

Borrow the cached project gitignore matcher. Returns None when no project_root is configured or when the project has no gitignore files.

pub fn rebuild_gitignore(&self)

Rebuild the gitignore matcher from the current project_root and cache it. Called by the configure handler whenever the project root changes, and by the watcher event drain when a .gitignore file itself is modified.

The builder honors:

• <project_root>/.gitignore
• <project_root>/.git/info/exclude (loaded explicitly because GitignoreBuilder::new does not auto-discover it)
• nested .gitignore files (each .gitignore discovered during the recursive walk)

Stores None if there’s no project_root or no matchable gitignore files. Logs build errors but never fails configure.

pub fn bash_compress_flag(&self) -> Arc<AtomicBool>

Shared atomic mirror of experimental.bash.compress. Updated by the configure handler. Read by the BgTaskRegistry compressor closure.

pub fn sync_bash_compress_flag(&self)

Update the shared bash_compress_flag mirror. Call this from the configure handler whenever experimental.bash.compress changes so the BgTaskRegistry watchdog sees the new value on the next completion.

pub fn set_bash_compress_enabled(&self, enabled: bool)

pub fn filter_registry(&self) -> RwLockReadGuard<'_, FilterRegistry>

Read-only access to the TOML filter registry, building it lazily on first use. Returns an RwLockReadGuard that callers can lookup against directly.

pub fn shared_filter_registry(&self) -> SharedFilterRegistry

Returns the shared Arc<RwLock<FilterRegistry>> handle so threads outside AppContext (notably the bash watchdog) can read it without touching the rest of the context.

pub fn reset_filter_registry(&self)

Force a fresh load of the TOML filter registry. Called when configure changes the project root, storage_dir, or trust state so subsequent compress::compress calls pick up new filters.

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 status_emitter(&self) -> &StatusEmitter

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 set_canonical_cache_root(&self, root: PathBuf)

pub fn canonical_cache_root(&self) -> PathBuf

pub fn canonical_cache_root_opt(&self) -> Option<PathBuf>

pub fn set_cache_role( &self, is_worktree_bridge: bool, git_common_dir: Option<PathBuf>, )

pub fn is_worktree_bridge(&self) -> bool

pub fn cache_role(&self) -> &'static str

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.