blocks

type BinaryDependent interface {
	// RequiredBinary returns the name of the external binary the executor
	// needs on PATH.
	RequiredBinary() string
}

type Block interface {
	// Kind returns the fenced-block info-string kind this executor handles.
	Kind() string
	// Run executes one step. Implementations report failures through the
	// StepResult; the runner recovers panics on their behalf.
	Run(ctx StepCtx) StepResult
}

type Capture struct {
	Name  string
	Value string
}

type Registry map[string]Block

type StepCtx struct {
	// WorkDir is the scenario-scoped temp working directory shared by all
	// steps of one scenario (REQ: scenario-shape).
	WorkDir string
	// Body is the fenced block's verbatim content.
	Body string
	// Params are the info-string key=value parameters (e.g. dsn=..., url=...).
	Params map[string]string
	// Vars is the scenario's context bag as ordered name/value pairs
	// (REQ: context-bag). For bash/sql/dtql the runner has already textually
	// interpolated {{name}} into Body/Params before dispatch; hurl-derived
	// executors (hurl, graphql) instead pass Vars to Hurl as
	// `--variable name=value` flags — no textual interpolation for them.
	Vars []Capture
}

type StepResult struct {
	// Status is StatusPass or StatusFail.
	Status string
	// Detail is the failure diagnostic (empty on pass).
	Detail string
	// Output is the captured stdout/stderr, already truncated to
	// MaxStepOutput via Truncate.
	Output string
	// Captures are the values the step captured for the scenario's context
	// bag, in capture order (REQ: context-bag). The runner merges them into
	// the bag after the step.
	Captures []Capture
}