Method provision_sandbox

atomic-repository/src/repository/sandbox.rs:203–220

Provision an agent's private working tree as a copy-on-write clone of this repository's working tree. Copies every tracked-or-untracked working file into `dest`, reflinking where the filesystem supports it (so unchanged blocks are shared on disk) and falling back to a plain copy otherwise. The `.atomic/` directory is **never** cloned — the sandbox shares the canonical graph via [`Repository::open

(
        &self,
        dest: P,
        view: &str,
    )

    /// commands run inside the sandbox resolve to this repository's canonical
    /// graph and the given `view`.
    pub fn provision_sandbox<P: AsRef<Path>>(
        &self,
        dest: P,
        view: &str,
    ) -> Result<usize, RepositoryError> {
        let dest = dest.as_ref();
        let count = provision_working_tree(&self.root, dest)?;

        let pointer = SandboxPointer {
            canonical: self.root.clone(),
            view: view.to_string(),
        };
        let bytes = serde_json::to_vec_pretty(&pointer)
            .map_err(|e| RepositoryError::Database(e.to_string()))?;
        std::fs::write(dest.join(SANDBOX_POINTER), bytes)?;

        Ok(count)
    }

    /// Materialize a view's visible file content into `dir` (created if needed).
    ///