Struct WorkspaceRoot 

pub struct WorkspaceRoot { /* private fields */ }

The server’s one workspace root, resolved once and read everywhere.

Carries the RESULT of resolution rather than requiring it: a server whose home cannot resolve must still boot (nothing else needs the root), so the failure is held here and surfaces as a terminal refusal at the first dispatch of a placeholder-bearing body.

Implementations

impl WorkspaceRoot

pub fn resolve() -> Self

Resolve the workspace root from the server’s aion home: crate::config::aion_home → <home>/clones.

This is the ONE derivation of the value. Everything downstream — the declared-body dispatcher, the startup banner, any composition point reading the banner — consumes the resolved value rather than re-deriving it, so two components can never disagree about where workspaces live.

pub const fn from_resolution( resolution: Result<PathBuf, WorkspaceRootError>, ) -> Self

Build a root from an already-decided resolution.

For embedders and tests that need a known root (or a known failure) without touching the process environment the production WorkspaceRoot::resolve reads. Single derivation is a convention the production path upholds, not an enforced invariant: nothing stops a caller constructing a second, disagreeing root here.

pub fn banner_value(&self) -> String

The one-line rendering of this root for the startup banner: the resolved path’s display form, or unresolvable: <reason> when resolution failed — never a fabricated value.

pub fn resolved(&self) -> Result<&Path, &WorkspaceRootError>

The resolved root, or why there is none.

Read-only: reporting the value (the startup banner) must not create the directory. Creation happens at expansion time, where a failure has a dispatch to refuse.

Errors

Returns the held WorkspaceRootError when resolution failed.

pub fn expand( &self, command: &str, ) -> Result<Option<ExpandedCommand>, WorkspaceRootError>

Expand every WORKSPACE_ROOT_PLACEHOLDER occurrence in command with the resolved root.

A command without the placeholder is untouched — Ok(None), no resolution requirement, no filesystem side effect — so an unresolved root never affects a body that does not use it. A command WITH the placeholder requires the full chain: every occurrence standing alone as one whole, unquoted argv word, then a resolved, absolute, UTF-8 root with no shape-changing characters, and an existing directory (created here, idempotently and owner-only 0700, if missing — an already-existing root keeps whatever permissions the operator gave it; they are the operator’s own).

Errors

Returns WorkspaceRootError when a placeholder occurrence is not a whole unquoted argv word, when the root is unresolved, not absolute, not valid UTF-8, contains a character that would change the command’s parsed shape, or does not exist and cannot be created.

Trait Implementations

impl Clone for WorkspaceRoot

fn clone(&self) -> WorkspaceRoot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkspaceRoot

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

Formats the value using the given formatter.