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 BuildStrategy interface {
	// Name identifies the strategy (advertised via spec://current/capabilities).
	Name() string
	// FinishingTools lists the finishing tool names this strategy exposes, a
	// subset of {spec_push, spec_open_pr, spec_link_prs}. Empty means local-only:
	// the kernel commits to per-node branches and no remote/PR tools are offered.
	FinishingTools() []string
	// Complete reports terminal status given the node ledger and the DAG. It is
	// consulted once every node is complete to decide whether the build is fully
	// done (e.g. draft PRs present on stack leaves) or still needs a finishing
	// pass.
	Complete(session *SessionState, graph *Graph) Completion
}

type Completion struct {
	// Done reports whether the build is fully finished under the strategy.
	Done bool
	// Summary is a human-readable one-line status.
	Summary string
	// Hint is an optional next action shown when the build is not yet done.
	Hint 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. They are the
	// per-node worker fallback used when registry routing does not match.
	SkillRefs []string
	// ConductorSkills are the orchestrator-level skills handed to an MCP-capable
	// agent (integrations.agent.settings.conductor_skill). They are resolved
	// from the start dir only and are kept distinct from per-node worker skills,
	// which reach workers solely via spec_provision_node.
	ConductorSkills []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
	// Router selects the Tier-1 SkillRouter: "registry" (default), or
	// "none"/"discovery" to route nothing and let the harness discover skills.
	// Empty means the default.
	Router string
	// Strategy selects the Tier-2 BuildStrategy: "stacked-draft-pr" (default), or
	// "none"/"local" to keep work on local branches with no finishing tools.
	// Empty means the default.
	Strategy string
}

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"`
	// ACs holds the 1-based acceptance-criteria indices this node satisfies,
	// parsed from a trailing `(ac: 3,4)` annotation in §7.3. Empty when the
	// author did not map the node to specific criteria.
	ACs []int `yaml:"acs" json:"acs,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"`
}

type SkillRouter interface {
	// Route returns absolute skill paths for a node, or nil when it does not
	// route (the harness/model then discovers skills itself).
	Route(node PRStep) []string
}

type ToolSpec struct {
	Name        string
	Description string
	InputSchema map[string]interface{}
}