Struct AnalysisSession 

pub struct AnalysisSession { /* private fields */ }

Reusable engine session for one resolved project.

The session owns the resolved config and discovered file set so future consumers can share graph-sensitive inputs without each surface recreating its own partial orchestration.

Implementations

impl AnalysisSession

pub fn load(root: &Path, config_path: Option<&Path>) -> EngineResult<Self>

Load config and discover files for a project root.

Errors

Returns an error when config loading fails.

pub fn load_with_config( root: &Path, config_path: Option<&Path>, configure: impl FnOnce(&mut ResolvedConfig), ) -> EngineResult<Self>

Load config, apply one caller-supplied config adjustment, then discover files for a project root.

Errors

Returns an error when config loading fails.

pub fn load_default(root: &Path) -> Self

Build a session from built-in defaults, ignoring project config files.

This is intended for editor fallback paths that have already reported a config-load warning but should still surface best-effort diagnostics.

pub fn from_config(project_config: ProjectConfig) -> Self

Build a session from a previously resolved config.

pub fn from_resolved_config(config: ResolvedConfig) -> Self

Build a session from a resolved config when the caller already owns command-specific config loading.

pub fn root(&self) -> &Path

Resolved project root.

pub fn config(&self) -> &ResolvedConfig

Resolved project config.

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

Config file path when one was loaded.

pub fn files(&self) -> &[DiscoveredFile]

Discovered files for this session.

pub fn workspaces(&self) -> &[WorkspaceInfo]

Workspace packages discovered during config/session setup.

pub fn source_fingerprints(&self) -> FxHashMap<PathBuf, SourceFingerprint>

Source metadata fingerprints for every discovered source file.

pub fn changed_files_since( &self, git_ref: &str, ) -> Result<FxHashSet<PathBuf>, ChangedFilesError>

Resolve files changed since a git ref against this session root.

Errors

Returns an error when the ref is invalid, git is unavailable, or the root is not part of a repository.

pub fn workspace_diagnostics(&self) -> &[WorkspaceDiagnostic]

Workspace and source-discovery diagnostics captured for this session.

pub fn into_parts(self) -> AnalysisSessionParts

Consume the session and return the resolved config plus discovery data.

pub fn into_parsed_parts( self, need_complexity: bool, ) -> ParsedAnalysisSessionParts

Consume the session, load the parser cache, and parse discovered files.

pub fn parsed_parts(&self, need_complexity: bool) -> ParsedAnalysisSessionParts

Parse discovered files without consuming the session.

pub fn parsed_parts_uncached( &self, need_complexity: bool, ) -> ParsedAnalysisSessionParts

Parse discovered files without consuming the session or retaining parser output in the session cache.

pub fn analyze_dead_code(&self) -> EngineResult<DeadCodeAnalysis>

Run dead-code analysis for this session.

Errors

Returns an error if parsing or analysis fails.

pub fn analyze_dead_code_with_complexity( &self, ) -> EngineResult<DeadCodeAnalysisOutput>

Run dead-code analysis with retained complexity artifacts.

Errors

Returns an error if parsing or analysis fails.

pub fn analyze_dead_code_with_artifacts( &self, need_complexity: bool, retain_graph: bool, ) -> EngineResult<DeadCodeAnalysisArtifacts>

Run dead-code analysis with retained modules, discovered files and graph.

Errors

Returns an error if parsing or analysis fails.

pub fn analyze_dead_code_retaining_files( &self, need_complexity: bool, retain_graph: bool, ) -> EngineResult<DeadCodeAnalysisArtifacts>

Run dead-code analysis while retaining discovered files for downstream command stages that reuse discovery but do not need parser modules.

Errors

Returns an error if parsing or analysis fails.

pub fn analyze_dead_code_with_parsed_modules( &self, modules: &[ModuleInfo], ) -> EngineResult<DeadCodeAnalysisArtifacts>

Run dead-code analysis from modules already parsed through this session.

This preserves the session’s resolved config and discovered file set for follow-up analyses that reuse parser output without redoing discovery.

Errors

Returns an error if graph construction or analysis fails.

pub fn analyze_dead_code_with_session_artifacts( &self, need_complexity: bool, retain_graph: bool, changed_files: Option<FxHashSet<PathBuf>>, ) -> EngineResult<AnalysisSessionArtifacts>

Run dead-code analysis and return the session-scoped reuse artifacts.

Callers pass a changed-file set they have already resolved for the command. The returned value keeps that set beside parser, graph, and source-fingerprint data so downstream runners do not have to rebuild or rediscover the same inputs.

Errors

Returns an error if parsing or analysis fails.

pub fn find_duplicates(&self) -> DuplicationReport

Run duplication detection using the session’s discovered files.

pub fn find_duplicates_with( &self, config: &DuplicatesConfig, ) -> DuplicationReport

Run duplication detection using custom duplicate options.

pub fn analyze_project_with( &self, duplicates_config: &DuplicatesConfig, retain_complexity_artifacts: bool, ) -> EngineResult<ProjectAnalysisOutput>

Run dead-code and duplication analysis for this session.

When retain_complexity_artifacts is true, the dead-code result keeps parser artifacts needed by editor overlays such as inline complexity.

Errors

Returns an error if dead-code parsing or analysis fails.

pub fn analyze_project_with_artifacts( &self, duplicates_config: &DuplicatesConfig, options: ProjectAnalysisArtifactOptions, ) -> EngineResult<ProjectAnalysisArtifacts>

Run dead-code and duplication analysis with retained session reuse data.

This is the engine-owned project artifact boundary for callers that need to hand one analysis result across audit, decision, editor, or follow-up analysis surfaces without rediscovering session metadata.

Errors

Returns an error if dead-code parsing or analysis fails.

pub fn find_duplicates_with_defaults( &self, config: &DuplicatesConfig, cache_dir: Option<&Path>, ) -> DuplicationAnalysis

Run duplication detection and return report sidecar metadata.

pub fn find_duplicates_touching_files_with_defaults( &self, config: &DuplicatesConfig, changed_files: &[PathBuf], cache_dir: Option<&Path>, ) -> DuplicationAnalysis

Run focused duplication detection for a changed-file set.

Trait Implementations

impl Debug for AnalysisSession

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

Formats the value using the given formatter.