internal/app/config

type AgentInstructions struct {
	Role         string   `json:"role" yaml:"role"`
	Deliverables []string `json:"deliverables" yaml:"deliverables"`
	Rules        []string `json:"rules" yaml:"rules"`
}

type CommandSuggestion struct {
	ID      string   `json:"id" yaml:"id"`
	Command string   `json:"command" yaml:"command"`
	Sources []string `json:"sources" yaml:"sources"`
}

type ConfigPatch struct {
	Invariants map[string]string `json:"invariants" yaml:"invariants"`
	Execution  *ExecutionPatch   `json:"execution,omitempty" yaml:"execution,omitempty"`
}

type Evidence struct {
	Path string `json:"path" yaml:"path"`
	Role string `json:"role" yaml:"role"`
}

type ExecutionPatch struct {
	PathPrepend []string          `json:"path_prepend,omitempty" yaml:"path_prepend,omitempty"`
	Env         map[string]string `json:"env,omitempty" yaml:"env,omitempty"`
}

type ExecutionSuggestion struct {
	PathPrepend []string          `json:"path_prepend,omitempty" yaml:"path_prepend,omitempty"`
	Env         map[string]string `json:"env,omitempty" yaml:"env,omitempty"`
	Sources     []string          `json:"sources" yaml:"sources"`
}

type InvariantSuggestion struct {
	ID          string   `json:"id" yaml:"id"`
	Description string   `json:"description" yaml:"description"`
	Sources     []string `json:"sources" yaml:"sources"`
}

type Output struct {
	Path     string   `json:"path"`
	Proposal Proposal `json:"proposal"`
	Prompt   string   `json:"prompt"`
}

type Proposal struct {
	Version           string            `json:"version" yaml:"version"`
	Purpose           string            `json:"purpose" yaml:"purpose"`
	AgentInstructions AgentInstructions `json:"agent_instructions" yaml:"agent_instructions"`
	Evidence          []Evidence        `json:"evidence" yaml:"evidence"`
	ConfigPatch       ConfigPatch       `json:"config_patch" yaml:"config_patch"`
	SpecGuidance      SpecGuidance      `json:"spec_guidance,omitempty" yaml:"spec_guidance,omitempty"`
	Warnings          []Warning         `json:"warnings,omitempty" yaml:"warnings,omitempty"`
	OpenQuestions     []Question        `json:"open_questions,omitempty" yaml:"open_questions,omitempty"`
}

type Question struct {
	Question string   `json:"question" yaml:"question"`
	Reason   string   `json:"reason" yaml:"reason"`
	Sources  []string `json:"sources,omitempty" yaml:"sources,omitempty"`
}

type Scanner interface {
	Scan(context.Context) (Snapshot, error)
}

type Snapshot struct {
	Root       string
	Files      []Evidence
	Commands   []CommandSuggestion
	Invariants []InvariantSuggestion
	Execution  *ExecutionSuggestion
	Warnings   []Warning
	Questions  []Question
}

type SpecGuidance struct {
	Commands    []CommandSuggestion   `json:"commands,omitempty" yaml:"commands,omitempty"`
	ReviewFocus []InvariantSuggestion `json:"review_focus,omitempty" yaml:"review_focus,omitempty"`
	Execution   *ExecutionSuggestion  `json:"execution,omitempty" yaml:"execution,omitempty"`
}

type Warning struct {
	ID      string   `json:"id" yaml:"id"`
	Message string   `json:"message" yaml:"message"`
	Sources []string `json:"sources,omitempty" yaml:"sources,omitempty"`
}