Struct ProjectManager 

pub struct ProjectManager { /* private fields */ }

Manages multiple Projects and routes file paths to the appropriate Project.

Per 02_DESIGN.md, ProjectManager:

• Resolves file paths to Projects based on ProjectRootMode
• Creates Projects on demand (lazy)
• Handles configuration changes (mode switch = teardown + rebuild)
• Thread-safe with RwLock + double-check pattern

Implementations

impl ProjectManager

pub fn new(mode: ProjectRootMode) -> Self

Create a new ProjectManager with the given mode.

pub fn with_default_mode() -> Self

Create a ProjectManager with default mode (GitRoot).

pub fn mode(&self) -> ProjectRootMode

Get the current mode.

pub fn set_workspace_folders(&self, folders: Vec<PathBuf>)

Set workspace folders.

Folders are canonicalized internally to ensure starts_with comparisons work correctly when project_for_path canonicalizes file paths. On Windows, this resolves 8.3 short names and adds the \\?\ prefix. Folders are stored in the order provided (typically LSP order).

pub fn workspace_folders(&self) -> Vec<PathBuf>

Get current workspace folders.

pub fn project_for_path( &self, file_path: &Path, ) -> Result<Arc<Project>, ProjectError>

Get or create Project for a file path.

Uses double-check pattern per 02_DESIGN.md C5:

1. Canonicalize path (outside lock)
2. Resolve index_root (outside lock)
3. Read lock: check if Project exists (fast path)
4. Write lock: double-check + create if needed (slow path)

Arguments

• file_path - Path to file (may be relative or contain symlinks)

Errors

Returns an error if path canonicalization fails.

pub fn get_project(&self, index_root: &Path) -> Option<Arc<Project>>

Get a Project by its index_root if it exists.

Does not create the Project if it doesn’t exist.

pub fn all_projects(&self) -> Vec<Arc<Project>>

Get all Projects.

pub fn project_count(&self) -> usize

Get the number of active Projects.

pub fn handle_config_change(&self, new_mode: ProjectRootMode)

Handle configuration change (mode switch).

Per 02_DESIGN.md M1, uses full teardown strategy:

1. Cancel all in-progress operations
2. Optionally persist state
3. Drop all Projects
4. New Projects created lazily on next access

pub fn remove_project(&self, index_root: &Path) -> Option<Arc<Project>>

Remove a Project by index_root.

Used when a workspace folder is removed.

pub fn shutdown(&self)

Shutdown: remove all Projects and clean up.

Trait Implementations

impl Debug for ProjectManager

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

Formats the value using the given formatter.

impl Default for ProjectManager

fn default() -> Self

Returns the “default value” for a type.