Struct Walker 

pub struct Walker<'a> { /* private fields */ }

Recursive walker. Composes a PackLoader (for manifests) with a GitBackend (for child hydration).

The walker owns no state across calls: each invocation of Walker::walk produces a fresh PackGraph and leaves no footprint.

Implementations

impl<'a> Walker<'a>

pub fn new( loader: &'a dyn PackLoader, backend: &'a dyn GitBackend, workspace: PathBuf, ) -> Self

Construct a new walker.

workspace is the directory under which child packs will be cloned, using each ChildRef::effective_path as the sub-directory name.

pub fn with_ref_override(self, ref: Option<String>) -> Self

Set a global ref override applied to every child pack.

Surfaced as grex sync --ref <sha|branch|tag> (M4-D). The override replaces each child’s declared ref in its parent manifest. An empty string is treated as “no override” — callers should reject empty values at the CLI layer before reaching this point.

pub fn walk(&self, root_pack_path: &Path) -> Result<PackGraph, TreeError>

Walk the tree rooted at root_pack_path, returning the fully hydrated graph.

Errors

Returns TreeError on any loader, git, cycle, or name-mismatch failure. The walk aborts on the first failure — the spec-level “fail loud, fail fast” default.