Pixir.VirtualOverlay (pixir v0.1.5)

Copy Markdown View Source

BEAM-native virtual workspace runner for future virtual_overlay Subagent work.

The runner imports an explicit, bounded read set from a real Pixir Workspace into a Bashex in-memory filesystem, executes virtual shell commands there, and returns an ADR 0029 virtual_diff artifact. It is deliberately not a model-visible Tool and it does not apply virtual writes back to the parent Workspace.

Summary

Functions

run(workspace, params, opts \\ [])

Run virtual shell commands over a bounded import from workspace.

Functions

run(workspace, params, opts \\ [])

@spec run(String.t(), map(), keyword()) :: {:ok, map()} | {:error, map()}

Run virtual shell commands over a bounded import from workspace.

Parameters are string-keyed for parity with Tool and Workflow inputs:

  • "read_set": explicit files or bounded glob patterns to import.
  • "commands": virtual shell commands to execute in order.
  • "limits": optional numeric overrides for the built-in default limits.