scenario

type AC struct {
	// Slug is the id from the `# AC: <slug>` heading.
	Slug string
	// Statement is the prose under the `## Statement` heading (what must be true).
	Statement string
	// Verifies is the `**Verifies:**` URL reference to the feature/requirement.
	Verifies string
	// Status is the `**Status:**` value (e.g. "accepted", "draft").
	Status string
	// AppliesTo lists the `**Applies-to:**` tags (e.g. sign-in methods). Never nil.
	AppliesTo []string
	// Path is the file the AC was parsed from.
	Path string
}

type Block struct {
	// Kind is the first info-string token (e.g. "bash", "sql"). Empty for a
	// bare “` fence.
	Kind string
	// Params holds the remaining info-string tokens as key=value pairs; a
	// bare token maps to the empty string.
	Params map[string]string
	// Body is the verbatim block content (without the fence lines).
	Body string
	// Line is the 1-based line number of the opening fence.
	Line int
}

type Check struct {
	// Slug is the check id from its `# Check: <slug>` heading (may be empty).
	Slug string
	// Params are the names declared on the `**Params:**` line. Never nil.
	Params []string
	// Body is the verbatim content of the check's first fenced block.
	Body string
}

type CheckUse struct {
	// Ref is the check URL from the Markdown link (relative to the scenario).
	Ref string
	// Params maps each `name=value` binding; values may be `{{context}}` refs.
	Params map[string]string
	// Line is the 1-based line number of the directive.
	Line int
}

type FileAssertion struct {
	// Path is the file path (relative or absolute) extracted from the heading.
	Path string
	// Kind is one of: exists, missing, contains, not-contains, permissions.
	Kind string
	// Expected is the content of the code block immediately following the
	// heading, if any (empty for kinds that do not require one, e.g. exists).
	Expected string
}

type Scenario struct {
	// Path is the file the scenario was parsed from.
	Path string
	// Verifies lists the AC ids from the `**Verifies:**` body metadata,
	// parenthetical annotations stripped. Never nil.
	Verifies []string
	// Status is the `**Status:**` body metadata value (e.g. "pending").
	Status string
	// Expect is the `**Expect:**` body metadata value: "fail" when the scenario
	// is expected to fail, "pass" otherwise (the default, and the value for any
	// unrecognized directive). Feature: cli/rehearse/expected-fail.
	Expect string
	// Blocks are all fenced blocks in document order.
	Blocks []Block
	// FileAssertions are all `### Assert: file` headings in document order.
	// Never nil.
	FileAssertions []FileAssertion
	// Uses are all `**Use:**` reusable-check invocations in document order.
	// Feature: cli/rehearse/reusable-checks. Never nil.
	Uses []CheckUse
}

type SuiteWhen struct {
	// Label is the branch heading text (e.g. "When he completes the callback").
	Label string
	// Content is the verbatim markdown of the branch.
	Content string
}