l7report

type ExplainOpts struct {
	Heading    string // section heading (the source doc's heading)
	SourceRef  string // "file.md:123" or "" — the reference line
	Ipmt       string // the original ipmt, embedded as a fenced block
	SVGRelPath string // relative link to a rendered companion, "" = none
	Candidates bool   // include the per-candidate route story in a <details>
	Verbose    bool   // append the full raw trace in a <details>
	Color      bool   // wrap node names / kinds / arrows in as-token markers

	// PrinciplesHref / DebugDocHref are the CLICKABLE urls for the two
	// linked docs, relative to where the report is written (compute with
	// pkg/markdown.RelPath). Empty falls back to the repo-relative display
	// path, which only resolves from the repo root.
	PrinciplesHref string
	DebugDocHref   string
}

type Recording struct {
	Version int                  `json:"version"`
	Source  Source               `json:"source,omitempty"`
	Events  []layout7.TraceEvent `json:"events"`
	Graph   *layout.Graph        `json:"graph"`
}

type Report struct {
	Events []layout7.TraceEvent
	Graph  *layout.Graph
}

type Source struct {
	File string `json:"file,omitempty"`
	Line int    `json:"line,omitempty"`
}

type TextOpts struct {
	Sel        []string
	Candidates bool // include the per-candidate route story
	Verbose    bool // append the FULL raw trace (every event, one line each)
}