Struct Context 

pub struct Context { /* private fields */ }

Per-invocation handle binding the cwd, the discovered workspace, the validated task graph, and the host filesystem.

Constructed once per haz invocation by Context::open in crate::dispatch and moved into the matched subcommand by value; per-command execute functions take Context directly and no longer carry a cwd parameter (it lives on the Context). A future change to the loading pipeline (e.g. the AUX-010 error-accumulating shape) lands in one place.

Implementations

impl Context

pub fn open(cwd: &Path) -> Result<Self>

Open the workspace rooted at or above cwd and build the per-invocation Context.

This runs the full discovery + DAG-construction pipeline (DISC-001..DISC-009, DAG-001..DAG-018) via load_workspace and pairs the result with the cwd and a fresh StdFilesystem handle.

Errors

Returns a miette::Report for any discovery, parse, or graph-construction failure. The binary maps the report to crate::EXIT_INTERNAL_OR_CONFIG_ERROR.

pub fn open_accumulating(cwd: &Path) -> Result<Self>

haz check variant of Context::open that surfaces every per-file load diagnostic at once rather than promoting only the first parse error, per AUX-010 / AUX-011. See load_workspace_accumulating.

Used only by the Cmd::Check dispatch arm; the other subcommands open through Context::open, whose first-error short-circuit is spec-compliant for them.

Errors

As Context::open.

pub fn cwd(&self) -> &Path

The cwd the Context was opened against.

pub fn workspace(&self) -> &Workspace

The effective workspace value object (post-overlay-merge per DAG-001..DAG-006).

pub fn graph(&self) -> &TaskGraph

The validated task graph (DAG-008/DAG-009/DAG-013 edges over DAG-007 nodes).

pub fn fs(&self) -> &StdFilesystem

The host filesystem the binary speaks against.

Exposed for callers that need a &StdFilesystem outside the cache surface (notably the haz_exec RunContext’s fs field, which borrows it through the cache writer in commands::run).

pub fn bearing(&self) -> Option<&ProjectName>

The bearing project for this invocation, per EXEC-022.

Resolved against Context::cwd.

pub fn hash_algo(&self) -> HashAlgo

The hash algorithm in effect for this workspace, per CFG-027 (cache.hash).

Defaults to HashAlgo::Blake3 when the workspace omits the setting (the WorkspaceSettings::default path used by implicit-mode workspaces and by explicit-mode workspaces whose workspace.yml omits the cache: mapping).

pub fn cache_reader(&self) -> CacheReader<StdFilesystem>

Build a fresh CacheReader bound to this workspace’s cache root and hash algorithm.

Read-only consumers (haz cache info per AUX-018, the cache-introspection step of haz why per AUX-014) take this handle and gain the compile-time read-only guarantee of the cache reader / writer split.

pub fn cache_writer(&self) -> CacheWriter<StdFilesystem>

Build a fresh CacheWriter bound to this workspace’s cache root and hash algorithm.

Write-side consumers (haz run for stores; haz cache clear and haz cache clean for invalidation) take this handle.

Trait Implementations

impl Clone for Context

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Context

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.