model

type ArchiveConfig struct {
	WorkspaceRoot string
	RootDir       string
	Name          string
	TasksDir      string
	Force         bool
}

type ArchiveResult struct {
	Target               string            `json:"target"`
	ArchiveRoot          string            `json:"archive_root"`
	WorkflowsScanned     int               `json:"workflows_scanned"`
	Archived             int               `json:"archived"`
	Skipped              int               `json:"skipped"`
	Forced               bool              `json:"forced,omitempty"`
	CompletedTasks       int               `json:"completed_tasks,omitempty"`
	ResolvedReviewIssues int               `json:"resolved_review_issues,omitempty"`
	ArchivedAt           *time.Time        `json:"archived_at,omitempty"`
	ArchivedPaths        []string          `json:"archived_paths,omitempty"`
	SkippedPaths         []string          `json:"skipped_paths,omitempty"`
	SkippedReasons       map[string]string `json:"skipped_reasons,omitempty"`
}

type BaseRunScope struct {
	Artifacts RunArtifacts
	Journal   *journal.Journal
	EventBus  *events.Bus[events.Event]
}

type ContentBlock struct {
	Type ContentBlockType `json:"type"`
	Data json.RawMessage  `json:"-"`
}

type ContentBlockType string

type DiffBlock struct {
	Type     ContentBlockType `json:"type"`
	FilePath string           `json:"filePath"`
	Diff     string           `json:"diff"`
	OldText  *string          `json:"oldText,omitempty"`
	NewText  string           `json:"newText,omitempty"`
}

type ExecutionMode string

type ExplicitRuntimeFlags struct {
	IDE             bool
	Model           bool
	ReasoningEffort bool
	AccessMode      bool
}

type FetchConfig struct {
	ReviewsDir      string `json:"reviews_dir,omitempty"`
	IncludeResolved bool   `json:"include_resolved,omitempty"`
}

type FetchResult struct {
	Name       string
	Provider   string
	PR         string
	Round      int
	ReviewsDir string
	Total      int
}

type FixOutcome struct {
	Status string `json:"status"`
	Error  string `json:"error,omitempty"`
}

type ImageBlock struct {
	Type     ContentBlockType `json:"type"`
	Data     string           `json:"data"`
	MimeType string           `json:"mimeType"`
	URI      *string          `json:"uri,omitempty"`
}

type IssueEntry struct {
	Name     string
	AbsPath  string
	Content  string
	CodeFile string
}

type Job struct {
	CodeFiles       []string
	Groups          map[string][]IssueEntry
	TaskTitle       string
	TaskType        string
	SafeName        string
	IDE             string
	Model           string
	ReasoningEffort string
	Prompt          []byte
	SystemPrompt    string
	MCPServers      []MCPServer
	OutPromptPath   string
	OutLog          string
	ErrLog          string
}

type JobArtifacts struct {
	PromptPath string
	OutLogPath string
	ErrLogPath string
}

type JobResult struct {
	Status     string `json:"status"`
	ExitCode   int    `json:"exit_code,omitempty"`
	Attempts   int    `json:"attempts,omitempty"`
	DurationMS int64  `json:"duration_ms,omitempty"`
	Error      string `json:"error,omitempty"`
}

type MCPServer struct {
	Stdio *MCPServerStdio
}

type MCPServerStdio struct {
	Name    string
	Command string
	Args    []string
	Env     map[string]string
}

type MigrationConfig struct {
	WorkspaceRoot string
	RootDir       string
	Name          string
	TasksDir      string
	ReviewsDir    string
	DryRun        bool
}

type MigrationResult struct {
	Target                  string
	DryRun                  bool
	FilesScanned            int
	FilesMigrated           int
	V1ToV2Migrated          int
	LegacyReviewMetaRemoved int
	FilesAlreadyFrontmatter int
	FilesSkipped            int
	FilesInvalid            int
	MigratedPaths           []string
	UnmappedTypeFiles       []string
	InvalidPaths            []string
}

type OpenRunScopeOptions struct {
	EnableExecutableExtensions bool
}

type OutputFormat string

type ReviewContext struct {
	Provider       string
	PR             string
	Round          int
	RoundCreatedAt time.Time

	Status      string
	File        string
	Line        int
	Severity    string
	Author      string
	ProviderRef string
	ReviewHash  string

	SourceReviewID          string
	SourceReviewSubmittedAt string
}

type ReviewFileMeta struct {
	Provider       string    `yaml:"provider,omitempty"`
	PR             string    `yaml:"pr,omitempty"`
	Round          int       `yaml:"round,omitempty"`
	RoundCreatedAt time.Time `yaml:"round_created_at,omitempty"`

	Status      string `yaml:"status"`
	File        string `yaml:"file,omitempty"`
	Line        int    `yaml:"line,omitempty"`
	Severity    string `yaml:"severity,omitempty"`
	Author      string `yaml:"author,omitempty"`
	ProviderRef string `yaml:"provider_ref,omitempty"`
	ReviewHash  string `yaml:"review_hash,omitempty"`

	SourceReviewID          string `yaml:"source_review_id,omitempty"`
	SourceReviewSubmittedAt string `yaml:"source_review_submitted_at,omitempty"`
}

type RoundMeta struct {
	Provider   string
	PR         string
	Round      int
	CreatedAt  time.Time
	Total      int
	Resolved   int
	Unresolved int
}

type RunArtifacts struct {
	RunID       string
	RunDir      string
	RunDBPath   string
	RunMetaPath string
	EventsPath  string
	TurnsDir    string
	JobsDir     string
	ResultPath  string
}

type RunScope interface {
	RunArtifacts() RunArtifacts
	RunJournal() *journal.Journal
	RunEventBus() *events.Bus[events.Event]
	RunManager() RuntimeManager
	Close(context.Context) error
}

type RunSummary struct {
	Status        string `json:"status"`
	JobsTotal     int    `json:"jobs_total"`
	JobsSucceeded int    `json:"jobs_succeeded,omitempty"`
	JobsFailed    int    `json:"jobs_failed,omitempty"`
	JobsCanceled  int    `json:"jobs_canceled,omitempty"`
	Error         string `json:"error,omitempty"`
	TeardownError string `json:"teardown_error,omitempty"`
}

type RuntimeConfig struct {
	WorkspaceRoot              string
	Name                       string
	Round                      int
	Provider                   string
	PR                         string
	Nitpicks                   bool
	ReviewsDir                 string
	TasksDir                   string
	DryRun                     bool
	AutoCommit                 bool
	Concurrent                 int
	BatchSize                  int
	IDE                        string
	Model                      string
	AddDirs                    []string
	TailLines                  int
	ReasoningEffort            string
	AccessMode                 string
	AgentName                  string
	ExplicitRuntime            ExplicitRuntimeFlags
	TaskRuntimeRules           []TaskRuntimeRule
	Mode                       ExecutionMode
	OutputFormat               OutputFormat
	Verbose                    bool
	Persist                    bool
	EnableExecutableExtensions bool
	DaemonOwned                bool
	RunID                      string
	ParentRunID                string
	PromptText                 string
	PromptFile                 string
	ReadPromptStdin            bool
	ResolvedPromptText         string
	IncludeCompleted           bool
	IncludeResolved            bool
	Timeout                    time.Duration
	MaxRetries                 int
	RetryBackoffMultiplier     float64
	SoundEnabled               bool
	SoundOnCompleted           string
	SoundOnFailed              string
}

type RuntimeManager interface {
	Start(context.Context) error
	DispatchMutableHook(context.Context, string, any) (any, error)
	DispatchObserverHook(context.Context, string, any)
	Shutdown(context.Context) error
}

type SessionAvailableCommand struct {
	Name         string `json:"name"`
	Description  string `json:"description,omitempty"`
	ArgumentHint string `json:"argumentHint,omitempty"`
}

type SessionPlanEntry struct {
	Content  string `json:"content"`
	Priority string `json:"priority"`
	Status   string `json:"status"`
}

type SessionStatus string

type SessionUpdate struct {
	Kind              SessionUpdateKind         `json:"kind,omitempty"`
	ToolCallID        string                    `json:"toolCallId,omitempty"`
	ToolCallState     ToolCallState             `json:"toolCallState,omitempty"`
	Blocks            []ContentBlock            `json:"blocks,omitempty"`
	ThoughtBlocks     []ContentBlock            `json:"thoughtBlocks,omitempty"`
	PlanEntries       []SessionPlanEntry        `json:"planEntries,omitempty"`
	AvailableCommands []SessionAvailableCommand `json:"availableCommands,omitempty"`
	CurrentModeID     string                    `json:"currentModeId,omitempty"`
	Usage             Usage                     `json:"usage,omitempty"`
	Status            SessionStatus             `json:"status"`
}

type SessionUpdateKind string

type SolvePreparation struct {
	Jobs         []Job
	RunArtifacts RunArtifacts
	// RunScope carries the runtime resources that were allocated before
	// planning began. Kernel/runtime flows retain responsibility for closing it.
	RunScope         RunScope
	InputDir         string
	InputDirPath     string
	ResolvedName     string
	ResolvedPR       string
	ResolvedProvider string
	ResolvedRound    int
}

type SyncConfig struct {
	WorkspaceRoot string
	RootDir       string
	Name          string
	TasksDir      string
}

type SyncResult struct {
	Target                 string
	WorkflowsScanned       int
	WorkflowsPruned        int
	MetaCreated            int
	MetaUpdated            int
	SnapshotsUpserted      int
	TaskItemsUpserted      int
	ReviewRoundsUpserted   int
	ReviewIssuesUpserted   int
	CheckpointsUpdated     int
	LegacyArtifactsRemoved int
	SyncedPaths            []string
	PrunedWorkflows        []string
	Warnings               []string
}

type TaskEntry struct {
	Content      string
	Status       string
	Title        string
	TaskType     string
	Complexity   string
	Dependencies []string
}

type TaskFileMeta struct {
	Status       string   `yaml:"status"`
	Title        string   `yaml:"title"`
	TaskType     string   `yaml:"type"`
	Complexity   string   `yaml:"complexity,omitempty"`
	Dependencies []string `yaml:"dependencies"`
}

type TaskMeta struct {
	CreatedAt time.Time
	UpdatedAt time.Time
	Total     int
	Completed int
	Pending   int
}

type TaskRuntime struct {
	IDE             string `json:"ide,omitempty"`
	Model           string `json:"model,omitempty"`
	ReasoningEffort string `json:"reasoning_effort,omitempty"`
}

type TaskRuntimeRule struct {
	ID              *string `toml:"id"               json:"id,omitempty"`
	Type            *string `toml:"type"             json:"type,omitempty"`
	IDE             *string `toml:"ide"              json:"ide,omitempty"`
	Model           *string `toml:"model"            json:"model,omitempty"`
	ReasoningEffort *string `toml:"reasoning_effort" json:"reasoning_effort,omitempty"`
}

type TaskRuntimeTarget struct {
	ID   string
	Type string
}

type TaskRuntimeTask struct {
	ID       string `json:"id,omitempty"`
	SafeName string `json:"safe_name,omitempty"`
	Title    string `json:"title,omitempty"`
	Type     string `json:"type,omitempty"`
}

type TerminalOutputBlock struct {
	Type       ContentBlockType `json:"type"`
	Command    string           `json:"command,omitempty"`
	Output     string           `json:"output,omitempty"`
	ExitCode   int              `json:"exitCode"`
	TerminalID string           `json:"terminalId,omitempty"`
}

type TextBlock struct {
	Type ContentBlockType `json:"type"`
	Text string           `json:"text"`
}

type ToolCallState string

type ToolResultBlock struct {
	Type      ContentBlockType `json:"type"`
	ToolUseID string           `json:"toolUseId"`
	Content   string           `json:"content"`
	IsError   bool             `json:"isError,omitempty"`
}

type ToolUseBlock struct {
	Type     ContentBlockType `json:"type"`
	ID       string           `json:"id"`
	Name     string           `json:"name"`
	Title    string           `json:"title,omitempty"`
	ToolName string           `json:"toolName,omitempty"`
	Input    json.RawMessage  `json:"input,omitempty"`
	RawInput json.RawMessage  `json:"rawInput,omitempty"`
}

type Usage struct {
	InputTokens  int `json:"inputTokens,omitempty"`
	OutputTokens int `json:"outputTokens,omitempty"`
	TotalTokens  int `json:"totalTokens,omitempty"`
	CacheReads   int `json:"cacheReads,omitempty"`
	CacheWrites  int `json:"cacheWrites,omitempty"`
}