Struct Workspace 

pub struct Workspace {
    pub root: PathBuf,
}

A located Aristo workspace.

Fields

root: PathBuf

Implementations

impl Workspace

pub fn find(start: Option<&Path>) -> Result<Self, WorkspaceError>

Find the workspace by walking upward from start (or cwd if None) looking for an aristo.toml. The first ancestor directory that contains one becomes the workspace root.

pub fn aristo_dir(&self) -> PathBuf

Path to the .aristo/ state directory.

pub fn index_path(&self) -> PathBuf

Path to .aristo/index.toml.

pub fn canon_matches_path(&self) -> PathBuf

Path to .aristo/canon-matches.toml — the per-repo cache of server-side canon match responses (committed by default). See aristo_core::canon::cache for the schema and ../aretta-sdk/docs/mockups/13-canon-and-matching/README.md §L5 for the design.

pub fn specs_dir(&self) -> PathBuf

Path to .aristo/specs/.

pub fn doc_dir(&self) -> PathBuf

Path to .aristo/doc/.

pub fn sessions_dir(&self) -> PathBuf

Path to .aristo/sessions/. Holds the review-session substrate’s local-only state — see docs/decisions/review-sessions.md §D5. Everything under this directory is gitignored.

pub fn sessions_active_pointer(&self) -> PathBuf

Pointer file holding the active session id (if any). Existence implies an active session; missing means none.

pub fn sessions_active_session_dir(&self) -> PathBuf

Per-session TOML state for in-flight sessions.

pub fn sessions_closed_dir(&self) -> PathBuf

Closed-session audit trail.

pub fn sessions_rejections_log(&self) -> PathBuf

Append-only JSONL log of rejected items across all sessions.

pub fn sessions_backlog_dir(&self) -> PathBuf

Per-kind backlog directory (backlog/<kind>.toml).

pub fn config_path(&self) -> PathBuf

Path to aristo.toml.

pub fn load_config(&self) -> ConfigFile

Read + parse aristo.toml. Returns ConfigFile::default() on any failure (missing file, parse error) — the per-command config-driven behaviors all degrade gracefully when their relevant section is absent, so a malformed config shouldn’t break read commands. Callers that need to surface parse errors (aristo lint’s aristo.toml validation in a future slice) should read + parse directly.

Trait Implementations

impl Clone for Workspace

fn clone(&self) -> Workspace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Workspace

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

Formats the value using the given formatter.