Struct Workspace 

pub struct Workspace<'a, R: CommandRunner, D: DependencyResolver = ManifestWalkResolver> {
    pub root: PathBuf,
    pub config: ResolvedConfig,
    pub graph: D,
    pub tags: OnceCell<TagIndex>,
    pub runner: &'a R,
    pub manifest_cache: RefCell<BTreeMap<PathBuf, Arc<dyn Manifest>>>,
}

Fields

root: PathBuf

config: ResolvedConfig

graph: D

tags: OnceCell<TagIndex>

Deferred TagIndex: built at most once, the first time Workspace::tags is called, not eagerly by Workspace::load.

TagIndex::build fetches the repository’s full tag list – via native gix discovery, or (when gix is unavailable, permanently the case on wasm32) a CommandRunner-shelled git tag --list call, a full Extism guest<->host round-trip there. Several command paths never consult tags at all (e.g. add’s non-interactive path only needs Workspace::root to write a changeset file; add’s interactive package-selection step and init only need package names/root), so building the index unconditionally inside Workspace::load charged every caller for work only some of them need. All of TagIndex::build’s inputs (runner, root, graph, config) are already fields on Workspace itself, so deferring construction behind a OnceCell needs no extra state and is transparent to every existing caller – go through Workspace::tags rather than this field directly.

runner: &'a R

manifest_cache: RefCell<BTreeMap<PathBuf, Arc<dyn Manifest>>>

Path-keyed cache of manifest handles opened read-only during this workspace’s lifetime. Populated during graph discovery (ManifestWalkResolver::build) and reused by read-only accessors such as Workspace::base_versions so a given manifest is opened (read + parsed) at most once per command run. Never consulted by the manifest-open-for-write path in apply.rs, which always needs a fresh, exclusively-owned &mut handle.

Implementations

impl<'a, R: CommandRunner> Workspace<'a, R, ManifestWalkResolver>

pub fn load<L: ProjectLocator>( root: PathBuf, locator: &L, runner: &'a R, ) -> Result<Self, GraphError>

impl<'a, R: CommandRunner, D: DependencyResolver> Workspace<'a, R, D>

pub fn tags(&self) -> Result<&TagIndex, GraphError>

Returns the workspace’s TagIndex, building it on first access and reusing the cached result afterwards. See the doc comment on the tags field for why this is deferred rather than built eagerly by Workspace::load.

pub fn base_versions(&self) -> Result<BTreeMap<PackageId, Version>, GraphError>

pub fn pre_json_key<'b>(&self, id: &'b PackageId) -> Result<&'b str, GraphError>

pub fn initial_versions(&self) -> Result<Vec<(String, Version)>, GraphError>