Struct SourceRoot 

pub struct SourceRoot {
    pub path: PathBuf,
    pub index_path: PathBuf,
    pub language_hints: Option<Vec<String>>,
    pub classpath_dir: Option<PathBuf>,
    pub config_fingerprint: u64,
}

A directory that is auto-indexed by sqry. One .sqry/graph/manifest.json per source root.

Fields

path: PathBuf

Canonical absolute path to the source root.

index_path: PathBuf

Path to the per-source-root index manifest (always <path>/.sqry/graph/manifest.json).

language_hints: Option<Vec<String>>

Optional list of language hints to bias plugin selection.

classpath_dir: Option<PathBuf>

Optional path to the JVM classpath cache directory (<path>/.sqry/classpath/); populated by the JVM pipeline.

config_fingerprint: u64

Per-source-root override of the workspace-level config_fingerprint. 0 here; populated by the plugin-selection pipeline in a later step.

Implementations

impl SourceRoot

pub fn from_path(path: PathBuf) -> Self

Build a SourceRoot from a canonical path, deriving the standard .sqry/graph/manifest.json index path. language_hints is None; classpath_dir is None; config_fingerprint is 0.

pub fn populate_classpath_dir(&mut self) -> Result<()>

STEP_11_4 — populate Self::classpath_dir from a probe of <self.path>/.sqry/classpath/. The directory is set when the probe finds a directory at that path, leaving the field None when the path is missing or is not a directory.

Returns Ok(()) on a successful (possibly negative) probe. Returns the raw io::Error when the probe fails for a reason other than NotFound (e.g. permission denied) so callers can surface a super::cache::WorkspaceWarning::ClasspathProbeFailed without losing the underlying error detail.

Errors

Returns the underlying io::Error when fs::metadata fails for a reason other than NotFound.

pub fn with_config_fingerprint(self, fingerprint: u64) -> Self

STEP_11_4 — fluent builder for Self::config_fingerprint.

Used by call sites that hold a freshly computed crate::config::compute_workspace_config_fingerprint value alongside the source root. A fingerprint of 0 is the “unset” sentinel and the builder accepts it for the same reason WorkspaceKey::config_fingerprint = 0 is the default — call sites that want strict identity must supply a non-zero value.

pub fn effective_config_fingerprint(&self, workspace_default: u64) -> u64

STEP_11_4 — return the per-source-root config fingerprint with fallback to a workspace-level default supplied by the caller.

SourceRoot.config_fingerprint == 0 is treated as “use the workspace-level fingerprint” — the daemon WorkspaceKey dimension this powers must always carry the workspace’s fingerprint when no per-source-root override is set so two otherwise-identical paths under different workspaces stay in distinct cache entries.

Trait Implementations

impl Clone for SourceRoot

fn clone(&self) -> SourceRoot

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SourceRoot

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SourceRoot

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for SourceRoot

fn eq(&self, other: &SourceRoot) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for SourceRoot

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for SourceRoot

impl StructuralPartialEq for SourceRoot