Pixir.Subagents.WorkspaceSnapshot (pixir v0.1.5)

Copy Markdown View Source

BEAM-local physical workspace snapshots for isolated Subagents.

This module is the snapshot half of ADR 0011's isolated child workspace contract. It deliberately walks and copies with Elixir filesystem APIs instead of shelling out to git, find, or another host process. That keeps Subagent fanout aligned with ADR 0027: BEAM coordination can scale broadly, while host-boundary crossings stay scarce and explicit.

The first policy is intentionally conservative. It skips common dependency, build, cache, and Pixir runtime-state directories by basename at any depth, enforces copy limits, and returns string-keyed metadata/errors suitable for Tool results and Events.

Summary

Functions

Copy a bounded, policy-filtered snapshot from src into existing directory dest.

Functions

copy(src, dest, opts \\ [])

Copy a bounded, policy-filtered snapshot from src into existing directory dest.

Returns {:ok, metadata} when copying succeeds, or {:error, details} where details is a string-keyed map ready to embed inside a structured Tool error.