plan

type AgentRunner interface {
	// Research runs a read-only research subagent with the given
	// instructions and returns its final text response, plus the
	// subagent's usage — pre-costed against the subagent's own model
	// schedule — so the caller can fold it into the parent session.
	Research(ctx context.Context, instructions string) (string, usage.SessionUsage, error)

	// ReviewDiff runs all reviewer agents concurrently against the diff
	// from baseSHA to HEAD in the session's working directory and returns
	// the findings plus the aggregated subagent usage — pre-costed against
	// the subagents' own model schedule — so the caller can fold it into
	// the parent session.
	ReviewDiff(ctx context.Context, baseSHA string) (ReviewResults, usage.SessionUsage, error)
}

type Deps struct {
	Store    *planengine.Store
	Runner   AgentRunner
	WorkDir  string
	RepoRoot string
	// HooksRegistry, when non-nil, receives lifecycle events fired by the
	// plan tools (plan.created, plan.completed, ticket.started,
	// ticket.completed). A nil registry silently skips all hook calls.
	HooksRegistry *hooksreg.Registry
}

type PhaseCommittedEvent struct {
	PhaseName     string
	CommitSHA     string
	CommitMessage string
	TicketSlug    string
	TicketName    string
	BranchName    string
	PlanSlug      string
	Dir           string
}

type PlanCompletedEvent struct {
	PlanSlug string
	RepoRoot string
	Dir      string
}

type PlanCreatedEvent struct {
	PlanSlug string
	RepoRoot string
	Dir      string
}

type ReviewResults struct {
	// Findings maps perspective name (e.g. "security") to the agent's raw
	// text output.
	Findings map[string]string
	// Errors maps perspective name to the error message when that agent
	// failed, so the synthesis step can surface which perspectives are
	// missing.
	Errors map[string]string
}

type TicketCompletedEvent struct {
	TicketSlug string
	TicketName string
	BranchName string
	BaseRef    string
	PhaseNames string
	PlanSlug   string
	Dir        string
}

type TicketReadyForReviewEvent struct {
	TicketSlug string
	TicketName string
	BranchName string
	BaseRef    string
	PhaseNames string
	PlanSlug   string
	Dir        string
}

type TicketReviewedEvent struct {
	TicketSlug string
	TicketName string
	BranchName string
	BaseRef    string
	PhaseNames string
	PlanSlug   string
	Dir        string
}

type TicketStartedEvent struct {
	TicketSlug string
	TicketName string
	BranchName string
	BaseRef    string
	PlanSlug   string
	Dir        string
}