Struct WorkspaceFs 

pub struct WorkspaceFs { /* private fields */ }

Production workspace implementation using the real filesystem.

All file operations are performed relative to the repository root using std::fs.

Implementations

impl WorkspaceFs

pub fn new(repo_root: PathBuf) -> Self

Create a new workspace filesystem rooted at the given path.

Arguments

• repo_root - The repository root directory (typically discovered via git)

Trait Implementations

impl Clone for WorkspaceFs

fn clone(&self) -> WorkspaceFs

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkspaceFs

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

Formats the value using the given formatter.

impl Workspace for WorkspaceFs

fn root(&self) -> &Path

Get the repository root path.

fn read(&self, relative: &Path) -> Result<String>

Read a file relative to the repository root.

fn read_bytes(&self, relative: &Path) -> Result<Vec<u8>>

Read a file as bytes relative to the repository root.

fn write(&self, relative: &Path, content: &str) -> Result<()>

Write content to a file relative to the repository root. Creates parent directories if they don’t exist.

fn write_bytes(&self, relative: &Path, content: &[u8]) -> Result<()>

Write bytes to a file relative to the repository root. Creates parent directories if they don’t exist.

fn append_bytes(&self, relative: &Path, content: &[u8]) -> Result<()>

Append bytes to a file relative to the repository root. Creates the file if it doesn’t exist. Creates parent directories if needed.

fn exists(&self, relative: &Path) -> bool

Check if a path exists relative to the repository root.

fn is_file(&self, relative: &Path) -> bool

Check if a path is a file relative to the repository root.

fn is_dir(&self, relative: &Path) -> bool

Check if a path is a directory relative to the repository root.

fn remove(&self, relative: &Path) -> Result<()>

Remove a file relative to the repository root.

fn remove_if_exists(&self, relative: &Path) -> Result<()>

Remove a file if it exists, silently succeeding if it doesn’t.

fn remove_dir_all(&self, relative: &Path) -> Result<()>

Remove a directory and all its contents relative to the repository root.

fn remove_dir_all_if_exists(&self, relative: &Path) -> Result<()>

Remove a directory and all its contents if it exists, silently succeeding if it doesn’t.

fn create_dir_all(&self, relative: &Path) -> Result<()>

Create a directory and all parent directories relative to the repository root.

fn read_dir(&self, relative: &Path) -> Result<Vec<DirEntry>>

List entries in a directory relative to the repository root.

fn rename(&self, from: &Path, to: &Path) -> Result<()>

Rename/move a file from one path to another relative to the repository root.

fn write_atomic(&self, relative: &Path, content: &str) -> Result<()>

Write content to a file atomically using temp file + rename pattern.

fn set_readonly(&self, relative: &Path) -> Result<()>

Set a file to read-only permissions.

fn set_writable(&self, relative: &Path) -> Result<()>

Set a file to writable permissions.

fn absolute(&self, relative: &Path) -> PathBuf

Resolve a relative path to an absolute path.

fn absolute_str(&self, relative: &str) -> String

Resolve a relative path to an absolute path as a string.

fn agent_dir(&self) -> PathBuf

Path to the .agent directory.

fn agent_logs(&self) -> PathBuf

Path to the .agent/logs directory.

fn agent_tmp(&self) -> PathBuf

Path to the .agent/tmp directory.

fn plan_md(&self) -> PathBuf

Path to .agent/PLAN.md.

fn issues_md(&self) -> PathBuf

Path to .agent/ISSUES.md.

fn status_md(&self) -> PathBuf

Path to .agent/STATUS.md.

fn notes_md(&self) -> PathBuf

Path to .agent/NOTES.md.

fn commit_message(&self) -> PathBuf

Path to .agent/commit-message.txt.

fn checkpoint(&self) -> PathBuf

Path to .agent/checkpoint.json.

fn start_commit(&self) -> PathBuf

Path to .agent/start_commit.

fn review_baseline(&self) -> PathBuf

Path to .agent/review_baseline.txt.

fn prompt_md(&self) -> PathBuf

Path to PROMPT.md in the repository root.

fn prompt_backup(&self) -> PathBuf

Path to .agent/PROMPT.md.backup.

fn agent_config(&self) -> PathBuf

Path to .agent/config.toml.

fn agents_toml(&self) -> PathBuf

Path to .agent/agents.toml.

fn pipeline_log(&self) -> PathBuf

Path to .agent/logs/pipeline.log.

fn xsd_path(&self, name: &str) -> PathBuf

Path to an XSD schema file in .agent/tmp/.

fn xml_path(&self, name: &str) -> PathBuf

Path to an XML file in .agent/tmp/.

fn log_path(&self, name: &str) -> PathBuf

Path to a log file in .agent/logs/.