Struct ProgrammaticAnalysisContext 

pub struct ProgrammaticAnalysisContext { /* private fields */ }

Resolved common programmatic analysis context.

This owns validation, root/config/diff resolution, production overrides, workspace scope, and the per-call thread pool shared by programmatic analysis families. API runtimes and engine-backed runners use it directly.

Implementations

impl ProgrammaticAnalysisContext

pub fn install<R: Send>(&self, f: impl FnOnce() -> R + Send) -> R

Run work inside the per-call Rayon pool.

pub fn root(&self) -> &Path

Resolved analysis root.

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

Config path supplied by the caller, if any.

pub const fn allow_remote_extends(&self) -> bool

Whether this call permits remote config inheritance.

pub const fn no_cache(&self) -> bool

Whether parser cache use is disabled for this call.

pub const fn threads(&self) -> usize

Effective parser thread count for this call.

pub const fn diff_index(&self) -> Option<&DiffIndex>

Parsed diff for this call, explicit or ambient, if one applied.

pub fn request_outcomes(&self) -> Option<RequestOutcomes>

The call’s request_outcomes, or None when it was asked for nothing.

Carries the diff-filter entry, which is the one request this context resolves and can stand down. Same object as the CLI publishes for the same diff.

pub const fn production_override(&self) -> Option<bool>

Explicit production override supplied by the caller.

pub fn changed_since(&self) -> Option<&str>

Git ref used to scope changed files.

pub fn workspace(&self) -> Option<&[String]>

Workspace filter patterns supplied by the caller.

pub fn changed_workspaces(&self) -> Option<&str>

Git ref used to scope changed workspaces.

pub const fn explain_enabled(&self) -> bool

Whether API JSON should include explanatory metadata.

pub fn cancellation(&self) -> Option<&Arc<AtomicBool>>

The caller’s cancellation token for this analysis, if it supplied one.

pub fn is_cancelled(&self) -> bool

Whether the caller has asked this analysis to stop.

pub fn ensure_not_cancelled(&self, stage: &str) -> Result<(), ProgrammaticError>

Stop the analysis at a stage boundary once the caller has cancelled it.

stage names the work that has not been started, so the error says how far the run got rather than only that it was stopped.

Errors

Returns a FALLOW_CANCELLED programmatic error when the caller’s token is set. Cancellation is always an error, never an empty success: an empty report reads downstream as a clean project.