mkdocs

type GraphEdge struct {
	From     string `json:"from"`
	To       string `json:"to"`
	Relation string `json:"relation"` // implements, depends_on, traces_to, validates
}

type GraphEmbedOptions struct {
	// Format is the graph output format: "mermaid", "iframe", "svg"
	Format string
	// Width is the iframe/svg width (e.g., "100%", "800px")
	Width string
	// Height is the iframe/svg height (e.g., "600px")
	Height string
	// GraphURL is the URL to the graph HTML file for iframe embedding
	GraphURL string
	// GraphPath is the local path to the graph file
	GraphPath string
	// Title is the optional title for the graph section
	Title string
	// Description is the optional description
	Description string
}

type GraphNode struct {
	ID       string `json:"id"`
	Label    string `json:"label"`
	Type     string `json:"type"` // requirement, feature, task, acceptance
	Status   string `json:"status,omitempty"`
	Category string `json:"category,omitempty"`
}

type NavItem struct {
	Title    string    `yaml:"title,omitempty"`
	Path     string    `yaml:"-"`
	Children []NavItem `yaml:"-"`
}

type ProjectIndexOptions struct {
	// IncludeGraphLink adds a link to the graph visualization if available.
	IncludeGraphLink bool
	// GraphPath is the relative path to the graph HTML file.
	GraphPath string
}

type ProjectSummary struct {
	Name          string
	Path          string
	Status        string // ready, in_progress, not_ready
	StatusEmoji   string
	Progress      int // Percentage
	LastUpdated   time.Time
	SpecCount     int
	EvalCount     int
	ApprovalCount int
}

type RenderEvalOptions struct {
	// IncludeEvidence includes evidence snippets in findings.
	IncludeEvidence bool
	// IncludeJudgeMetadata includes information about the LLM judge.
	IncludeJudgeMetadata bool
}

type SpecsLandingOptions struct {
	// IncludeConstitution adds a link to CONSTITUTION.md if it exists.
	IncludeConstitution bool
	// IncludeRoadmap adds a link to ROADMAP.md if it exists.
	IncludeRoadmap bool
	// ConstitutionPath is the relative path to CONSTITUTION.md.
	ConstitutionPath string
	// RoadmapPath is the relative path to ROADMAP.md.
	RoadmapPath string
}