Expand description
haz why <TASK> per AUX-013..AUX-016.
Read-only introspection of a single task. The executor:
- Loads the workspace + validated graph
(
DISC-001..DISC-009,DAG-001..DAG-018). - Resolves the positional task reference to exactly one node
(P, A)perREF-001..REF-008; rejects zero-match and multi-match cases with diagnostics directing the user to a more specific form. - Walks the transitive hard-predecessor closure, deriving
each predecessor’s cache key and reading its
stdout_hash/stderr_hashfrom the cached manifest. If any predecessor lacks a cache entry, derivation of the target’s key would be ambiguous; the executor surfaces a typed diagnostic naming the missing predecessor. - Derives the target’s cache key per
CACHE-001..CACHE-009and performs a read-only manifest lookup perCACHE-014, discriminating the fourAUX-015step 11 sub-states. - Enumerates materialised input paths (
AUX-015step 3) and annotates each with its producer set perDAG-013/AUX-015step 3 (“produced by”, “producer: undetermined”, or no annotation when zero producers). - Renders the
AUX-015report. Optional sections (inputs:,outputs:,deps:,weakDeps:,mutex:,env.from_host:,env.override:) are omitted when the underlying field is absent so headers never dangle.
Functions§
- execute
- Execute
haz why <TASK>againstcwd.