workflow

type ApprovalChoice struct {
	Value string `json:"value"`
	Label string `json:"label"`
}

type CapabilityContext struct {
	Note             string
	SkillDirectories []string
}

type Control struct {
	Status      string `json:"status"`
	ReviewKind  string `json:"review_kind,omitempty"`
	ReviewRound int    `json:"review_round"`
	MaxRounds   int    `json:"max_rounds"`
	CanReview   bool   `json:"can_review"`
	NextAction  string `json:"next_action"`
	// Keep the approval contract beside NextAction so even compact or
	// truncated host output retains the required confirmation flag.
	RequiresExplicitHumanConfirmation bool                       `json:"requires_explicit_human_confirmation,omitempty"`
	HumanConfirmationFlag             string                     `json:"human_confirmation_flag,omitempty"`
	ApprovalID                        string                     `json:"approval_id,omitempty"`
	ApprovalTaskID                    string                     `json:"approval_task_id,omitempty"`
	ApprovalKind                      string                     `json:"approval_kind,omitempty"`
	Question                          string                     `json:"question,omitempty"`
	Choices                           []ApprovalChoice           `json:"choices,omitempty"`
	ArtifactPath                      string                     `json:"artifact_path,omitempty"`
	Scope                             string                     `json:"scope,omitempty"`
	ChangedFiles                      []task.ApprovalChangedFile `json:"changed_files,omitempty"`
	Source                            string                     `json:"source,omitempty"`
	Events                            []task.WorkflowEvent       `json:"events,omitempty"`
	BudgetIssue                       *task.BudgetIssue          `json:"budget_issue,omitempty"`
	Progress                          *task.Progress             `json:"progress,omitempty"`
	ExternalReview                    *task.ExternalReview       `json:"external_review,omitempty"`
	ReviewOutdated                    bool                       `json:"review_outdated,omitempty"`
}

type ControlChoice = ApprovalChoice

type Error struct {
	Code      string
	Message   string
	Retryable bool
	TaskID    string
	ExitCode  int
	Cause     error
}

type ExternalReviewHost interface {
	Publish(context.Context, task.State, task.ApprovalRecord) (task.ExternalReview, error)
	FetchFeedback(context.Context, task.ExternalReview) (reviewhost.Feedback, error)
}

type Result struct {
	State  task.State
	Status string
}

type Service struct {
	RepoRoot string
	Store    *task.Store
	Config   config.Config
	Adapters map[string]runner.Adapter
	// ModelCachePath is explicit so library users and tests never inherit the
	// process owner's cache accidentally. An empty path disables caching.
	ModelCachePath string
	Capabilities   func(provider string, role runner.Role, taskText string) CapabilityContext
	Diagnostic     func(string)
	Observe        func(string) ([]task.FileEntry, error)
	Capture        func([]task.FileEntry, string, string) ([]task.FileEntry, error)
	WritePlan      func(string, string) error
	Now            func() time.Time
	Token          func() string
	ProcessID      func() int
	ProcessAlive   func(int) bool
	// ProgressHeartbeatInterval is configurable for deterministic tests. Zero
	// uses the production interval.
	ProgressHeartbeatInterval time.Duration
	ReviewHost                ExternalReviewHost
}

type WorkGraph struct {
	TaskID              string     `json:"task_id"`
	Phase               string     `json:"phase"`
	Complexity          string     `json:"complexity,omitempty"`
	Waves               [][]string `json:"waves"`
	Ready               []string   `json:"ready"`
	Nodes               []WorkNode `json:"nodes"`
	Control             Control    `json:"control"`
	CriticalPath        []string   `json:"critical_path,omitempty"`
	CriticalPathMinutes int        `json:"critical_path_minutes,omitempty"`
}

type WorkNode struct {
	task.WorkUnit
	TaskID    string   `json:"task_id"`
	Status    string   `json:"status"`
	Ready     bool     `json:"ready"`
	BlockedBy []string `json:"blocked_by,omitempty"`
}