workflow/

Package engine implements the wave-scheduling execution engine for Shipwright's declarative workflow layer (design.md D-K, workflow-execution spec).

Package graph implements stage 5 of the manifest's fixed seven-stage validation pipeline (design.md D-H): dependency-graph construction from each step's needs[], cycle detection via Kahn's algorithm (design.md D-J), rejection of an undeclared data reference (a steps.<id>.output interpolation reference to a step not present in the consuming step's own needs[]), and the output-kind/input-kind checks that are statically knowable without a resolved provider.

Package interp implements stage 4 (references) of the manifest's fixed seven-stage validation pipeline (design.md D-H): a hand-written scanner over a CLOSED interpolation grammar (design.md D-L), plus the typed Value carrier that makes secrecy a structural property rather than a runtime discipline.

Package manifest defines Shipwright's declarative workflow manifest schema (design.md D-H, the workflow-manifest spec): the typed Go structs a YAML workflow document decodes into, plus stages 1-3 of the fixed seven-stage validation pipeline — size-capped read + decode (stage 1), document identity (stage 2), and structure (stage 3).

Package providers implements stage 6 (provider resolution) of the manifest's fixed seven-stage validation pipeline (design.md D-H) and, via WithSchema-checked resolution, the general-with-value-kind-mismatch portion of stage 7 (design.md D-H's "type mismatch in with") — see registry.go's checkWithSchema and this package's doc comment on WithSchemaMismatchError for the exact boundary this closes from WU5 (internal/workflow/interp, Reference.StaticKind) and WU6 (internal/workflow/graph, build.go's package doc comment).