yaml

Overview ¶

Package yaml is the YAML frontend: parses YAML workflows into the ir.Workflow IR. The decode path is YAML → any (goccy) → JSON (stdlib) → IR (the existing JSON unmarshalers in ir/), reusing the key-presence Node dispatch, the standard-surface Skip and Parallel marshalers, Duration's string/integer forms, and the digest-stable map-key ordering — without duplicating any of that.

Parse-time errors from goccy carry line:column inside *goccy/go-yaml/errors.SyntaxError (reachable via errors.As), so callers can surface position-aware diagnostics for YAML syntax issues. Position-aware SEMANTIC diagnostics (e.g. "field X at line Y is invalid") are deferred — a re-parse of the YAML AST by future validation would recover them when needed.