build

type BuildContext struct {
	SpecPath     string
	SpecContent  string
	PriorDiffs   []string
	FailingTests string
	Conventions  string
	CurrentStep  PRStep
	SystemPrompt string
	// Skills holds the resolved skill bodies (Agent Skills markdown). Empty
	// when no skills are present under .spec/agent/skills/ or in config.
	Skills []string
	// SkillPaths is the deduplicated union of skill paths across all DAG nodes,
	// passed to skill-capable agents as the set the orchestrator may dispatch.
	SkillPaths []string
}

type Engine struct {
	// contains filtered or unexported fields
}

type Graph struct {
	// Nodes are stored in their original plan order.
	Nodes []PRStep
	// contains filtered or unexported fields
}

type MCPResource struct {
	URI     string `json:"uri"`
	Name    string `json:"name"`
	Content string `json:"content"`
}

type MCPServer struct {
	// contains filtered or unexported fields
}

type MCPToolResult struct {
	Success bool   `json:"success"`
	Message string `json:"message"`
}

type NodeState struct {
	ID       string `json:"id"`
	Status   string `json:"status"`
	Branch   string `json:"branch,omitempty"`
	BaseRef  string `json:"base_ref,omitempty"`
	Worktree string `json:"worktree,omitempty"`
	Reason   string `json:"reason,omitempty"`
	PRNumber int    `json:"pr_number,omitempty"`
	PRURL    string `json:"pr_url,omitempty"`
}

type Options struct {
	// Headless runs the agent autonomously (e.g. `spec fix --auto`).
	Headless bool
	// SkillRefs are explicit skill paths from config
	// (integrations.agent.settings.skill). They take precedence over
	// profile.yaml refs and the .spec/agent/skills/ directory.
	SkillRefs []string
	// TestCommand, when set, is run to populate FailingTests (best-effort).
	TestCommand string
	// Workspaces maps a PR-step repo name to a local directory. It is the
	// source-of-truth repo that worktrees are added to for each node.
	Workspaces map[string]string
	// MaxParallel bounds orchestrator fan-out across ready nodes. Surfaced to
	// the agent via the DAG resource; 0 means "use the default".
	MaxParallel int
}

type PRStep struct {
	Number      int    `yaml:"number" json:"number"`
	ID          string `yaml:"id" json:"id"`
	Repo        string `yaml:"repo" json:"repo"`
	Layer       string `yaml:"layer" json:"layer,omitempty"`
	Description string `yaml:"description" json:"description"`
	Branch      string `yaml:"branch" json:"branch"`
	Status      string `yaml:"status" json:"status"` // "pending", "in-progress", "complete", "failed"
	// DependsOn holds the step numbers this node depends on (parsed from the
	// `(after: 1,2)` edge annotation). Empty for a root node.
	DependsOn []int `yaml:"depends_on" json:"depends_on,omitempty"`
	// PRURL is the draft PR recorded for this node in §7.3 via a trailing
	// `<!-- pr: <url> -->` annotation. Empty until the finisher opens a PR.
	PRURL string `yaml:"pr_url" json:"pr_url,omitempty"`
	// BaseRef is the commit the step branch was created from. Used to capture
	// the step's diff for cumulative cross-step context.
	BaseRef string `yaml:"base_ref" json:"base_ref,omitempty"`
}

type SessionState struct {
	SpecID       string    `json:"spec_id"`
	CurrentStep  int       `json:"current_step"`
	Branch       string    `json:"branch"`
	Repo         string    `json:"repo"`
	WorkDir      string    `json:"work_dir"`
	LastActivity time.Time `json:"last_activity"`
	Steps        []PRStep  `json:"steps"`
	// Nodes is the per-node status ledger keyed by PRStep.ID. It is the DAG
	// source of truth for the orchestrated build; CurrentStep is retained only
	// for the legacy sequential walk and is removed once the DAG engine lands.
	Nodes map[string]*NodeState `json:"nodes,omitempty"`
}