graph

type ActionInfo struct {
	Type     string `json:"type"`               // "create", "inject", "append"
	Target   string `json:"target"`             // output file path (raw frontmatter value)
	Marker   string `json:"marker,omitempty"`   // for inject actions
	Position string `json:"position,omitempty"` // "after" or "before"
}

type BundleInfo struct {
	Name       string   `json:"name"`
	Order      []string `json:"order"`       // generator names in execution order
	ValidOrder bool     `json:"valid_order"` // true if create-before-inject respected
}

type GeneratorNode struct {
	Name    string       `json:"name"`
	Actions []ActionInfo `json:"actions"`
}

type GraphReport struct {
	Generators []GeneratorNode `json:"generators"`
	Bundles    []BundleInfo    `json:"bundles"`
	Markers    []MarkerInfo    `json:"markers"`
	Warnings   []Warning       `json:"warnings"`
}

type MarkerInfo struct {
	File   string   `json:"file"`
	Line   int      `json:"line"`
	Text   string   `json:"text"`
	UsedBy []string `json:"used_by"` // generator names that inject at this marker
}

type Warning struct {
	Code      string `json:"code"`      // e.g. "missing_target", "file_conflict", "order_violation"
	Generator string `json:"generator"` // generator name
	Message   string `json:"message"`
}