Struct FileWrite 

pub struct FileWrite { /* private fields */ }

Capability that writes file contents with backup-before-mutate.

Every write creates a timestamped backup via BackupManager, enabling rollback through the undo system. The backup is created before the mutation, so a failed write still leaves a recoverable state.

Implementations

impl FileWrite

pub fn new() -> Result<Self>

Create a new FileWrite capability backed by the default backup directory.

The backup directory is derived from data_dir() as data_dir().join("backups"). This eliminates external configuration of the backup path (ADR-C28).

Trait Implementations

impl TypedCapability for FileWrite

type Args = FileWriteArgs

The typed arguments struct for this capability.

fn name(&self) -> &'static str

Returns the capability name (e.g., "FileRead").

fn description(&self) -> &'static str

Returns a one-line description of what this capability does.

fn schema(&self) -> Value

Returns the JSON Schema for the capability’s arguments.

fn execute( &self, args: FileWriteArgs, ctx: &Context, ) -> Result<Output, CapabilityError>

Executes the capability with typed arguments.

fn dry_run( &self, args: Self::Args, ctx: &Context, ) -> Result<Output, CapabilityError>

Dry-run execution — same as execute but the capability should skip side effects.