Struct Project 

pub struct Project {
    pub id: ProjectId,
    pub index_root: PathBuf,
    /* private fields */
}

Represents a single code base with its own CodeGraph and caches.

Fields

id: ProjectId

Unique identifier for this Project.

index_root: PathBuf

Canonical path to the project root.

Implementations

impl Project

pub fn new(index_root: PathBuf) -> Result<Self, ProjectError>

Create a new Project shell.

The Project is created but not initialized - call initialize() to set up the CodeGraph and caches.

Configuration is loaded from .sqry-config.toml by walking up from index_root per 02_DESIGN.md [M3].

Errors

Returns an error if project configuration fails to load or validate.

pub fn initialize(&self) -> Result<(), ProjectError>

Initialize the Project (detect repos, prepare graph caching).

This is separate from new() to allow lazy initialization. Per PROJECT_ROOT_SPEC.md Section 6.1-6.3, initialization includes:

1. Attempts to load persisted state (if cache.persistent = true)
2. Falls back to detecting all git repositories under the index_root
3. Populates the repo_index with RepoIds
4. Graph caching is lazy-loaded via graph() method

Note: File watchers are handled by the LSP layer, not the Project.

Errors

Returns an error if repository discovery or persistence initialization fails.

pub fn repo_id_for_file(&self, file_path: &Path) -> Result<RepoId, ProjectError>

Get the RepoId for a file path using the cached repo index.

Implements “nearest .git wins” rule per 02_DESIGN.md M2:

• Uses the repo_index populated during initialize()
• Returns RepoId::NONE if no git root found in ancestry

Arguments

• file_path - Path to the file (will be canonicalized)

Errors

Returns an error if path canonicalization fails.

pub fn repo_index(&self) -> HashMap<PathBuf, RepoId>

Get the cached repo index (for advanced use cases).

Returns a copy of the repo index mapping git root paths to RepoIds.

pub fn is_initialized(&self) -> bool

Check if the Project has been initialized.

pub fn cancel_operations(&self)

Cancel any in-progress background operations.

pub fn graph(&self) -> Result<Option<Arc<CodeGraph>>, ProjectError>

Load (or reuse) the cached unified graph for this project.

Each Project caches its own CodeGraph to avoid repeated disk I/O on every handler request.

Errors

Returns an error when the graph cannot be loaded from disk.

pub fn clear_graph_cache(&self)

Clear the cached unified graph.

Call this when the graph is rebuilt or invalidated.

pub fn is_cancelled(&self) -> bool

Check if operations have been cancelled.

pub fn register_repo(&self, git_root: PathBuf, repo_id: RepoId)

Register a repository in this Project’s repo index.

pub fn get_repo_id(&self, git_root: &Path) -> Option<RepoId>

Get the RepoId for a git root path.

pub fn register_file(&self, entry: FileEntry)

Register a file in this Project’s file table.

pub fn get_file(&self, path: &str) -> Option<FileEntry>

Get a file entry by path.

pub fn file_count(&self) -> usize

Get the number of registered files.

pub fn repo_count(&self) -> usize

Get the number of registered repositories.

pub fn persist_if_configured(&self)

Persist state if configured.

When cache.persistent = true:

1. Persists repo_index + file_table as versioned JSON

Per 02_DESIGN.md, uses atomic temp + rename for safety.

Errors

Logs warnings on failure but does not panic. Returns quietly to allow shutdown to proceed.

pub fn config(&self) -> &ProjectConfig

Get the project configuration.

Returns a reference to the loaded .sqry-config.toml configuration.

pub fn effective_ignored_dirs(&self) -> Vec<&str>

Get the effective ignored directories for this project.

Combines default ignored directories with any additional directories specified in the project configuration.

pub fn is_path_ignored(&self, path: &Path) -> bool

Check if a path should be ignored during indexing.

Returns true if the path matches any ignore pattern (and doesn’t match an override include pattern).

pub fn language_for_path(&self, path: &Path) -> Option<&str>

Get the language ID for a path based on configuration hints.

Returns the configured language if found, or None for default detection.

Trait Implementations

impl Debug for Project

A Project represents a single code base with its own CodeGraph and caches.

Per PROJECT_ROOT_SPEC and 02_DESIGN.md, each Project:

• Has a unique canonical index_root
• Owns a CodeGraph (future enhancement), symbol/index caches
• Tracks repository metadata via RepoIndex
• Manages file metadata via FileTable
• Loads configuration from .sqry-config.toml

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

Formats the value using the given formatter.