orchestration

type AgentRunner interface {
	RunAgent(ctx context.Context, worktree string, prompt string) error
}

type ChatDirective struct {
	ID       string                 `json:"id,omitempty"`
	Template string                 `json:"template,omitempty"`
	Model    string                 `json:"model,omitempty"`
	Type     string                 `json:"type,omitempty"` // Job type override for this turn
	Action   string                 `json:"action,omitempty"`
	Vars     map[string]interface{} `json:"vars,omitempty"`
}

type ChatTurn struct {
	Speaker   string         // "user" or "llm"
	Content   string         // The markdown content of the turn
	Directive *ChatDirective // Parsed from the grove HTML comment
	Timestamp time.Time      // When the turn was recorded
}

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

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

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

type ConceptInfo struct {
	ID    string
	Title string
	Path  string
}

type Config struct {
	OneshotModel         string
	TargetAgentContainer string
	PlansDirectory       string
	MaxConsecutiveSteps  int
}

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

type DynamicRecipe struct {
	Description string            `json:"description"`
	Jobs        map[string]string `json:"jobs"` // filename -> content
}

type ErrNotAJob struct {
	Reason string
}

type ExecutionContext struct {
	// PlanDirectory is where the plan files are stored
	PlanDirectory string

	// ProjectRoot is the root of the project (where grove.yml is located)
	ProjectRoot string

	// GitRoot is the root of the git repository
	GitRoot string

	// WorkingDirectory is where commands should be executed
	WorkingDirectory string

	// Config is the loaded grove configuration
	Config *config.Config
}

type ExecutionPlan struct {
	Stages [][]string // Each stage contains jobs that can run in parallel
}

type Executor interface {
	Execute(ctx context.Context, job *Job, plan *Plan) error
	Name() string
}

type ExecutorConfig struct {
	MaxPromptLength int
	Timeout         time.Duration
	RetryCount      int
	Model           string
	ModelOverride   string // Override model from CLI
	SkipInteractive bool   // Skip interactive prompts
}

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

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

type FrontmatterParser struct{}

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

type GitClient interface {
	WorktreeAdd(path, branch string) error
	WorktreeList() ([]Worktree, error)
	WorktreeRemove(name string, force bool) error
	CreateBranch(name string) error
	CurrentBranch() (string, error)
	IsGitRepo() bool
}

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

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

type InitAction struct {
	Type        string                 `yaml:"type"` // "shell" or "docker_compose"
	Description string                 `yaml:"description,omitempty"`
	Repo        string                 `yaml:"repo,omitempty"`         // Optional sub-repo for ecosystem worktrees
	Command     string                 `yaml:"command,omitempty"`      // For 'shell' type
	Files       []string               `yaml:"files,omitempty"`        // For 'docker_compose': list of user's compose files
	ProjectName string                 `yaml:"project_name,omitempty"` // For 'docker_compose' --project-name flag
	Overlay     map[string]interface{} `yaml:"overlay,omitempty"`      // For 'docker_compose': the generic overlay
}

type InlineCategory string

type InlineConfig struct {
	Categories []InlineCategory
}

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

type InteractiveAgentProvider interface {
	Launch(ctx context.Context, job *Job, plan *Plan, workDir string, agentArgs []string, briefingFilePath string) error
}

type Job struct {
	// From frontmatter
	ID                   string        `yaml:"id" json:"id"`
	Title                string        `yaml:"title" json:"title"`
	Status               JobStatus     `yaml:"status" json:"status"`
	Type                 JobType       `yaml:"type" json:"type"`
	Model                string        `yaml:"model,omitempty" json:"model,omitempty"`
	DependsOn            []string      `yaml:"depends_on,omitempty" json:"depends_on,omitempty"`
	Include              []string      `yaml:"include,omitempty" json:"include,omitempty"`
	SourceBlock          string        `yaml:"source_block,omitempty" json:"source_block,omitempty"`
	Template             string        `yaml:"template,omitempty" json:"template,omitempty"`
	Repository           string        `yaml:"repository,omitempty" json:"repository,omitempty"`
	Branch               string        `yaml:"branch,omitempty" json:"branch,omitempty"`
	Worktree             string        `yaml:"worktree" json:"worktree,omitempty"`
	TargetAgentContainer string        `yaml:"target_agent_container,omitempty" json:"target_agent_container,omitempty"`
	Inline               InlineConfig  `yaml:"inline,omitempty" json:"inline,omitempty"`                             // New field: controls which file types are inlined vs uploaded
	PrependDependencies  bool          `yaml:"prepend_dependencies,omitempty" json:"prepend_dependencies,omitempty"` // Deprecated: use inline: [dependencies] instead
	OnCompleteStatus     string        `yaml:"on_complete_status,omitempty" json:"on_complete_status,omitempty"`
	CreatedAt            time.Time     `yaml:"created_at,omitempty" json:"created_at,omitempty"`
	UpdatedAt            time.Time     `yaml:"updated_at,omitempty" json:"updated_at,omitempty"`
	CompletedAt          time.Time     `yaml:"completed_at,omitempty" json:"completed_at,omitempty"`
	Duration             time.Duration `yaml:"duration,omitempty" json:"duration,omitempty"`
	Summary              string        `yaml:"summary,omitempty" json:"summary,omitempty"`
	SourcePlan           string        `yaml:"source_plan,omitempty" json:"source_plan,omitempty"`
	RecipeName           string        `yaml:"recipe_name,omitempty" json:"recipe_name,omitempty"`
	GeneratePlanFrom     bool          `yaml:"generate_plan_from,omitempty" json:"generate_plan_from,omitempty"`
	GitChanges           bool          `yaml:"git_changes,omitempty" json:"git_changes,omitempty"`
	GatherConceptNotes   bool          `yaml:"gather_concept_notes,omitempty" json:"gather_concept_notes,omitempty"`
	GatherConceptPlans   bool          `yaml:"gather_concept_plans,omitempty" json:"gather_concept_plans,omitempty"`
	RulesFile            string        `yaml:"rules_file,omitempty" json:"rules_file,omitempty"`
	NoteRef              string        `yaml:"note_ref,omitempty" json:"note_ref,omitempty"`
	SourceFile           string        `yaml:"source_file,omitempty" json:"source_file,omitempty"` // Origin file path (e.g., Claude plan file)

	// Derived fields
	Filename     string      `json:"filename,omitempty"`   // The markdown filename
	FilePath     string      `json:"file_path,omitempty"`  // Full path to the file
	PromptBody   string      `json:"-"`                    // Content after frontmatter
	Dependencies []*Job      `json:"-"`                    // Resolved job references
	StartTime    time.Time   `json:"start_time,omitempty"` // When job started
	EndTime      time.Time   `json:"end_time,omitempty"`   // When job completed
	Metadata     JobMetadata `json:"metadata,omitempty"`
}

type JobMetadata struct {
	ExecutionTime time.Duration `yaml:"execution_time"`
	RetryCount    int           `yaml:"retry_count"`
	LastError     string        `yaml:"last_error"`
}

type JobOptions struct {
	DependsOn           []string
	Include             []string
	Worktree            string
	Prompt              string
	Inline              InlineConfig // New field: controls which file types are inlined
	PrependDependencies bool         // Deprecated: use Inline instead
}

type JobStatus string

type JobTemplate struct {
	Name        string                 `json:"name"`
	Path        string                 `json:"path"`
	Source      string                 `json:"source"`           // "project", "user", "builtin"
	Domain      string                 `json:"domain,omitempty"` // "generic" or "grove"
	Type        string                 `json:"type,omitempty"`   // "agent" or "oneshot"
	Description string                 `json:"description,omitempty" yaml:"description,omitempty"`
	Frontmatter map[string]interface{} `json:"frontmatter,omitempty"`
	Prompt      string                 `json:"prompt,omitempty"`
}

type JobType string

type LLMClient interface {
	Complete(ctx context.Context, job *Job, plan *Plan, prompt string, opts LLMOptions, output io.Writer) (string, error)
}

type LLMOptions struct {
	Model        string
	SchemaPath   string   // Path to JSON schema file for structured output
	WorkingDir   string   // Working directory for the LLM command
	ContextFiles []string // Paths to context files (.grove/context, CLAUDE.md)
	IncludeFiles []string // Paths to include files from job configuration
}

type Logger interface {
	Info(msg string, keysAndValues ...interface{})
	Error(msg string, keysAndValues ...interface{})
	Debug(msg string, keysAndValues ...interface{})
}

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

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

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

type Orchestrator struct {
	Plan *Plan
	// contains filtered or unexported fields
}

type OrchestratorConfig struct {
	MaxParallelJobs     int
	CheckInterval       time.Duration
	StateFile           string
	ModelOverride       string           // Override model for all jobs
	MaxConsecutiveSteps int              // Maximum consecutive steps before halting
	SkipInteractive     bool             // Skip interactive agent jobs
	SummaryConfig       *SummaryConfig   // Configuration for job summarization
	CommandExecutor     command.Executor // For dependency injection
}

type Plan struct {
	Name          string            // Name of the plan (directory name)
	Directory     string            // Root directory of the plan
	Jobs          []*Job            // List of all jobs
	JobsByID      map[string]*Job   // Keyed by job ID
	SpecFile      string            // Path to spec.md if exists
	Orchestration *Config           // Orchestration configuration
	Context       *ExecutionContext // Execution context for the plan
	Config        *PlanConfig       // Plan-specific configuration from .grove-plan.yml
}

type PlanConfig struct {
	Model                string            `yaml:"model,omitempty"`
	Worktree             string            `yaml:"worktree,omitempty"`
	TargetAgentContainer string            `yaml:"target_agent_container,omitempty"`
	Status               string            `yaml:"status,omitempty"`
	Repos                []string          `yaml:"repos,omitempty"`                // List of repos to include in ecosystem worktree
	Notes                string            `yaml:"notes,omitempty"`                // User notes/description for the plan
	Inline               InlineConfig      `yaml:"inline,omitempty"`               // New field: controls which file types are inlined by default
	PrependDependencies  bool              `yaml:"prepend_dependencies,omitempty"` // Deprecated: use inline instead
	Hooks                map[string]string `yaml:"hooks,omitempty"`
	Recipe               string            `yaml:"recipe,omitempty"` // Recipe used to create this plan
}

type PlanStatus struct {
	Total     int
	Pending   int
	Running   int
	Completed int
	Failed    int
	Blocked   int
	Progress  float64
}

type Recipe struct {
	Name              string                  `json:"name"`
	Description       string                  `json:"description"`
	Source            string                  `json:"source,omitempty"`  // [Built-in], [User], [Dynamic], or [Project]
	Domain            string                  `json:"domain,omitempty"`  // "generic" or "grove"
	DefaultNoteTarget string                  `json:"-"`                 // This will be populated from recipe.yml
	Jobs              map[string][]byte       `json:"-"`                 // Filename -> Content
	InitActions       []InitAction            `yaml:"init,omitempty"`    // Actions that run with --init flag
	NamedActions      map[string][]InitAction `yaml:"actions,omitempty"` // Named, on-demand action groups
}

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

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

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

type SummaryConfig struct {
	Enabled  bool
	Model    string
	Prompt   string
	MaxChars int
}

type TemplateManager struct {
}

type Worktree struct {
	Name      string
	Path      string
	Branch    string
	HEAD      string
	IsLocked  bool
	CreatedAt time.Time
}

type WorktreeConfig struct {
	AutoCleanup     bool          // Whether to auto-remove worktrees after job completion
	CleanupAge      time.Duration // Age after which stale worktrees are cleaned
	PreserveOnError bool          // Keep worktree if job fails
	CleanupPrompt   bool          // Ask user before cleanup
}

type WorktreeLock struct {
	WorktreeName string
	JobID        string
	LockedAt     time.Time
	PID          int
}

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