Struct WorkspaceIndex 

pub struct WorkspaceIndex { /* private fields */ }

A workspace-level index that orchestrates queries across multiple repositories.

WorkspaceIndex delegates to SessionManager for individual repository queries, leveraging its caching and lazy-loading capabilities. Results are aggregated and tagged with repository metadata.

Implementations

impl WorkspaceIndex

pub fn open( workspace_root: impl Into<PathBuf>, registry_path: &Path, ) -> WorkspaceResult<Self>

Open a workspace index from the registry file at the given path.

Arguments

• workspace_root - Root directory of the workspace
• registry_path - Path to the .sqry-workspace registry file

Example

use sqry_core::workspace::WorkspaceIndex;
use std::path::Path;

let workspace = Path::new("/path/to/workspace");
let registry = workspace.join(".sqry-workspace");
let mut index = WorkspaceIndex::open(workspace, &registry).unwrap();

Errors

Returns WorkspaceError when registry loading or session creation fails.

pub fn new( workspace_root: impl Into<PathBuf>, registry: WorkspaceRegistry, session: SessionManager, ) -> Self

Create a new workspace index with an existing registry and session.

Useful for testing or when you want to provide a custom SessionManager.

pub fn query(&mut self, query: &str) -> WorkspaceResult<Vec<NodeWithRepo>>

Execute a query across all repositories in the workspace.

This method:

1. Parses the query into AST and extracts repo filter
2. Filters repositories based on the repo predicates
3. Executes the normalized query (repo predicates stripped) against each matching repository
4. Aggregates results with repository metadata

Arguments

• query - The query string to execute (may include repo: predicates)

Returns

A list of matches with their associated repository information.

Example

use sqry_core::workspace::WorkspaceIndex;
use std::path::Path;

let workspace = Path::new("/path/to/workspace");
let registry = workspace.join(".sqry-workspace");
let mut index = WorkspaceIndex::open(workspace, &registry).unwrap();

let results = index.query("kind:function AND repo:backend-*").unwrap();

Errors

Returns WorkspaceError when parsing the query or executing repository queries fails.

pub fn stats(&self) -> WorkspaceStats

Get workspace-level statistics.

Returns aggregated stats across all repositories in the workspace.

pub fn detailed_stats(&self) -> DetailedWorkspaceStats

Get detailed workspace statistics including staleness tracking.

Returns comprehensive stats with freshness buckets, health scores, and other detailed metrics.

pub fn registry(&self) -> &WorkspaceRegistry

Get a reference to the underlying registry.

pub fn registry_mut(&mut self) -> &mut WorkspaceRegistry

Get a mutable reference to the underlying registry.

pub fn workspace_root(&self) -> &Path

Get the workspace root directory.