Struct WorkspaceKey 

pub struct WorkspaceKey {
    pub workspace_id: Option<WorkspaceId>,
    pub source_root: PathBuf,
    pub root_mode: ProjectRootMode,
    pub config_fingerprint: u64,
}

Composite identity for a loaded workspace.

Two workspaces with the same Self::source_root but different Self::root_mode or Self::config_fingerprint are distinct cache entries — this prevents cache collisions when the same repo is opened with different client configurations.

source_root is always the canonical absolute path (caller responsibility; Self::new does not canonicalise because a path may not exist on disk yet at the moment a key is synthesised).

STEP_6 augmentation

workspace_id lifts the key into a four-dimensional space so a single logical workspace can group multiple source roots under one stable identity. With workspace_id = None, the key collapses to today’s three-dimensional behaviour: each source root is its own anonymous / per-repo entry. With workspace_id = Some(id), every WorkspaceKey sharing the same id belongs to the same logical workspace; the manager LRU still operates per-source-root so partial eviction is observable, but daemon/workspaceStatus aggregates across source roots that share the id.

Fields

workspace_id: Option<WorkspaceId>

Optional identity of the logical workspace this key belongs to.

None reproduces today’s per-source-root / anonymous behaviour. Some(id) groups this entry with every other WorkspaceKey carrying the same id — daemon/workspaceStatus { workspace_id } returns the aggregate, but the LRU still operates per-source-root.

#[serde(default)] so v1 JSON fixtures (which never carry the field) round-trip into None. Serialisation skips None so the new wire form is identical to v1 for the anonymous case.

source_root: PathBuf

Canonical absolute path to the source-root directory (the per-source-root index unit).

#[serde(alias = "index_root")] keeps every v1 payload that emitted the legacy index_root field name parsing without migration; the new wire form emits source_root.

root_mode: ProjectRootMode

How the project root was determined for this workspace.

config_fingerprint: u64

64-bit fingerprint of the config values that materially affect the graph (plugin selection, cost tiering, macro expansion toggles, etc). Callers compute the fingerprint deterministically from the client-declared options; an unchanged fingerprint means the daemon is free to return the cached graph.

Implementations

impl WorkspaceKey

pub fn new( source_root: PathBuf, root_mode: ProjectRootMode, config_fingerprint: u64, ) -> Self

Construct a new anonymous (per-source-root) key. Caller is responsible for passing a canonical absolute path.

Equivalent to today’s three-dimensional WorkspaceKey. For logical-workspace-grouped keys, use Self::with_workspace_id.

pub fn with_workspace_id( workspace_id: WorkspaceId, source_root: PathBuf, root_mode: ProjectRootMode, config_fingerprint: u64, ) -> Self

Construct a logical-workspace-grouped key. Two keys sharing the same workspace_id are aggregated by daemon/workspaceStatus; they remain distinct cache entries (admission, LRU, eviction all operate per source root).

pub fn index_root(&self) -> &Path

Backwards-compat accessor for the source-root path. Pre-STEP_6 the field was named index_root; the rename to source_root preserves the new wire form while this accessor lets internal call sites that read the path continue to compile without a per-site rename.

Trait Implementations

impl Clone for WorkspaceKey

fn clone(&self) -> WorkspaceKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkspaceKey

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WorkspaceKey

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for WorkspaceKey

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

Formats the value using the given formatter.

impl Hash for WorkspaceKey

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for WorkspaceKey

fn eq(&self, other: &WorkspaceKey) -> 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 WorkspaceKey

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 WorkspaceKey

impl StructuralPartialEq for WorkspaceKey