Struct WorkspaceDir 

pub struct WorkspaceDir { /* private fields */ }

Per-project workspace directory (<project>/.astrid/).

Contains only committable project-level config. A workspace-id UUID links the project to its global state in ~/.astrid/.

Implementations

impl WorkspaceDir

pub fn detect(start_dir: &Path) -> Self

Detect the workspace directory by walking up from start_dir.

Detection order:

1. Directory containing .astrid/
2. Directory containing .git
3. Directory containing ASTRID.md
4. Fallback to start_dir itself

pub fn from_path(project_root: impl Into<PathBuf>) -> Self

Create from an explicit project root (useful for testing).

pub fn ensure(&self) -> Result<()>

Ensure the .astrid/ directory exists and generate a workspace ID if one does not already exist.

Errors

Returns an error if directory creation or workspace ID generation fails.

pub fn root(&self) -> &Path

Project root directory (parent of .astrid/).

pub fn dot_astrid(&self) -> PathBuf

The .astrid/ directory itself.

pub fn capsules_dir(&self) -> PathBuf

Workspace capsules directory (.astrid/capsules/).

pub fn workspace_id_path(&self) -> PathBuf

Path to the workspace-id file (.astrid/workspace-id).

pub fn workspace_id(&self) -> Result<Uuid>

Read or generate the workspace ID.

If the file exists (e.g. cloned from a repo), its UUID is adopted. Otherwise a new UUID is generated and written.

Errors

Returns an error if the file cannot be read or written.

pub fn instructions_path(&self) -> PathBuf

Path to the project-level instructions file (.astrid/ASTRID.md).

Trait Implementations

impl Clone for WorkspaceDir

fn clone(&self) -> WorkspaceDir

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkspaceDir

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

Formats the value using the given formatter.