domain

type ADRConflict struct {
	ExistingADRID string `json:"existing_adr_id"`
	Description   string `json:"description"`
}

type ADRGeneratedPayload struct {
	ADRID string `json:"adr_id"`
	Title string `json:"title"`
}

type ActionResult struct {
	Type    string `json:"type"`
	IssueID string `json:"issue_id"`
	Success bool   `json:"success"`
	Error   string `json:"error,omitempty"`
}

type AppendResult struct {
	BytesWritten int // total bytes written to event files
}

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

type ApplyResult struct {
	WaveID          string         `json:"wave_id"`
	AppliedActions  []ActionResult `json:"applied_actions"`
	RippleEffects   []Ripple       `json:"ripple_effects,omitempty"`
	NewCompleteness float64        `json:"new_completeness"`
	CompletedWave   *Wave          `json:"completed_wave,omitempty"`
	RemainingWaves  []Wave         `json:"remaining_waves,omitempty"`
}

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

type ApprovalChoice int

type ApproverConfig interface {
	IsAutoApprove() bool
	ApproveCmdString() string
}

type ArchitectDiscussPromptData struct {
	ClusterName     string
	WaveTitle       string
	WaveActions     string
	Topic           string
	OutputPath      string
	StrictnessLevel string
}

type ArchitectResponse struct {
	Analysis     string `json:"analysis"`
	ModifiedWave *Wave  `json:"modified_wave"`
	Reasoning    string `json:"reasoning"`
	Decision     string `json:"decision,omitempty"`
}

type AutoDiscussArchitectPromptData struct {
	ClusterName     string
	WaveTitle       string
	WaveActions     string
	PriorContent    string // prior Devil's Advocate remarks (empty for round 0)
	FeedbackSection string // design-feedback D-Mails
	OutputPath      string
	StrictnessLevel string
}

type AutoDiscussDevilsAdvocatePromptData struct {
	ClusterName     string
	WaveTitle       string
	WaveActions     string
	PriorContent    string // prior Architect remarks
	ExistingADRs    []ExistingADR
	CLAUDEMDContent string // CLAUDE.md content (may be empty)
	OutputPath      string
	StrictnessLevel string
	RoundIndex      int
	TotalRounds     int
	IsFinalRound    bool
}

type AutoDiscussResult struct {
	Rounds     []AutoDiscussRound `json:"rounds"`
	OpenIssues []string           `json:"open_issues"`
	Summary    string             `json:"summary"`
}

type AutoDiscussRound struct {
	Round   int    `json:"round"`
	Speaker string `json:"speaker"` // "architect" or "devils_advocate"
	Content string `json:"content"`
}

type BannerDirection int

type BannerLogger interface {
	Banner(dir BannerDirection, kind, name, description string)
	Header(toolName, version string)
	Section(title string)
}

type CheckStatus int

type ClassifyPromptData struct {
	TeamFilter      string
	ProjectFilter   string
	CycleFilter     string
	OutputPath      string
	StrictnessLevel string
	LabelsEnabled   bool
	LabelPrefix     string
	IsWaveMode      bool
}

type ClassifyResult struct {
	Clusters        []ClusterClassification `json:"clusters"`
	TotalIssues     int                     `json:"total_issues"`
	ShibitoWarnings []ShibitoWarning        `json:"shibito_warnings,omitempty"`
}

type ClusterClassification struct {
	Name     string   `json:"name"`
	IssueIDs []string `json:"issue_ids"`
	Labels   []string `json:"labels,omitempty"`
}

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

type ClusterScanOutcome struct {
	ClusterName string
	Succeeded   bool
}

type ClusterScanResult struct {
	Name                string        `json:"name"`
	Key                 string        `json:"key"`
	Completeness        float64       `json:"completeness"`
	Issues              []IssueDetail `json:"issues"`
	Observations        []string      `json:"observations"`
	Labels              []string      `json:"labels,omitempty"`
	EstimatedStrictness string        `json:"estimated_strictness,omitempty"`
	StrictnessReasoning string        `json:"strictness_reasoning,omitempty"`
	IssueCount          int           `json:"-"` // computed; used when Issues is nil (e.g. show command)
}

type ClusterState struct {
	Name         string  `json:"name"`
	Completeness float64 `json:"completeness"`
	IssueCount   int     `json:"issue_count"`
}

type CodingSessionRecord struct {
	ID                string
	ProviderSessionID string
	Provider          Provider
	Status            SessionStatus
	Model             string
	WorkDir           string
	CreatedAt         time.Time
	UpdatedAt         time.Time
	Metadata          map[string]string
}

type CompletenessUpdatedPayload struct {
	ClusterName         string  `json:"cluster_name"`
	ClusterCompleteness float64 `json:"cluster_completeness"`
	OverallCompleteness float64 `json:"overall_completeness"`
}

type ComputedConfig struct {
	EstimatedStrictness map[string]StrictnessLevel `yaml:"estimated_strictness,omitempty"`
}

type Config struct {
	Tracker      IssueTrackerConfig     `yaml:"tracker"`
	Scan         ScanConfig             `yaml:"scan"`
	ClaudeCmd    string                 `yaml:"claude_cmd,omitempty"`
	Model        string                 `yaml:"model,omitempty"`
	TimeoutSec   int                    `yaml:"timeout_sec,omitempty"`
	Scribe       ScribeConfig           `yaml:"scribe"`
	Strictness   StrictnessConfig       `yaml:"strictness"`
	Retry        RetryConfig            `yaml:"retry"`
	Labels       LabelsConfig           `yaml:"labels"`
	Gate         GateConfig             `yaml:"gate"`
	DoDTemplates map[string]DoDTemplate `yaml:"dod_templates"`
	Lang         string                 `yaml:"lang"`
	Computed     ComputedConfig         `yaml:"computed,omitempty"`

	// Runtime-only: set from --linear flag, not persisted in config.yaml
	Mode TrackingMode `yaml:"-"`
}

type DeepScanPromptData struct {
	ClusterName     string
	IssueIDs        string
	OutputPath      string
	StrictnessLevel string
	IsWaveMode      bool
}

type DeviationError struct {
	TotalIssues int
}

type DiscussResult struct {
	WaveID        string             `json:"wave_id"`
	Analysis      string             `json:"analysis"`
	Reasoning     string             `json:"reasoning"`
	Decision      string             `json:"decision"`
	Modifications []WaveModification `json:"modifications,omitempty"`
	ADRWorthy     bool               `json:"adr_worthy"`
	ADRTitle      string             `json:"adr_title,omitempty"`
}

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

type DoDCoverageReport struct {
	TotalClusters     int
	CoveredClusters   int
	UncoveredClusters []string
}

type DoDTemplate struct {
	Must   []string `yaml:"must"`
	Should []string `yaml:"should"`
}

type DoctorCheck struct {
	Name    string
	Status  CheckStatus
	Message string
	Hint    string // optional remediation hint shown on failure
}

type ErrorKind string

type Event struct {
	SchemaVersion uint8           `json:"schema_version,omitempty"`
	ID            string          `json:"id"`
	Type          EventType       `json:"type"`
	Timestamp     time.Time       `json:"timestamp"`
	Data          json.RawMessage `json:"data"`
	SessionID     string          `json:"session_id"`
	CorrelationID string          `json:"correlation_id,omitempty"`
	CausationID   string          `json:"causation_id,omitempty"`
	AggregateID   string          `json:"aggregate_id,omitempty"`
	AggregateType string          `json:"aggregate_type,omitempty"`
	SeqNr         uint64          `json:"seq_nr,omitempty"`
}

type EventApplier interface {
	Apply(event Event) error
	Rebuild(events []Event) error
}

type EventType string

type ExistingADR struct {
	Filename string
	Content  string
}

type FeedbackReceivedPayload struct {
	Kind  string `json:"kind"`
	Name  string `json:"name"`
	Count int    `json:"count"`
}

type GateConfig struct {
	NotifyCmd    string        `yaml:"notify_cmd"`
	ApproveCmd   string        `yaml:"approve_cmd"`
	AutoApprove  bool          `yaml:"auto_approve"`
	ReviewCmd    string        `yaml:"review_cmd"`
	ReviewBudget int           `yaml:"review_budget"` // max review cycles (0 = default 3)
	IdleTimeout  time.Duration `yaml:"idle_timeout"`  // idle timeout — exit after no D-Mail activity (0 = 24h safety cap, <0 = disable waiting)
}

type HandoffResult struct {
	IssueID string // Linear issue identifier
	Status  string // "success", "failed", "skipped"
	Error   string // non-empty when Status is "failed"
}

type HandoverState struct {
	Tool         string // "sightjack"
	Operation    string // "wave"
	Timestamp    time.Time
	InProgress   string            // Current task description
	Completed    []string          // What was done
	Remaining    []string          // What's left
	PartialState map[string]string // Tool-specific state (key=label, value=detail)
}

type IndexEntry struct {
	Timestamp string `json:"ts"`
	Operation string `json:"op"`
	Issue     string `json:"issue"`
	Status    string `json:"status"`
	Tool      string `json:"tool"`
	Path      string `json:"path"`
	Summary   string `json:"summary"`
}

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

type InsightContext struct {
	Insights []InsightSummary `yaml:"insights,omitempty" json:"insights,omitempty"`
}

type InsightEntry struct {
	Title       string
	What        string
	Why         string
	How         string
	When        string
	Who         string
	Constraints string
	Extra       map[string]string // tool-specific optional fields
}

type InsightFile struct {
	SchemaVersion string         `yaml:"insight-schema-version"`
	Kind          string         `yaml:"kind"`
	Tool          string         `yaml:"tool"`
	UpdatedAt     time.Time      `yaml:"updated_at"`
	Entries       []InsightEntry `yaml:"-"` // parsed from Markdown body
}

type InsightSummary struct {
	Source  string `yaml:"source" json:"source"`
	Summary string `yaml:"summary" json:"summary"`
}

type IssueDetail struct {
	ID           string   `json:"id"`
	Identifier   string   `json:"identifier"`
	Title        string   `json:"title"`
	Status       string   `json:"status"`
	Completeness float64  `json:"completeness"`
	Gaps         []string `json:"gaps"`
	Labels       []string `json:"labels,omitempty"`
}

type IssueTrackerConfig struct {
	Team    string `yaml:"team"`
	Project string `yaml:"project"`
	Cycle   string `yaml:"cycle"`
}

type LabelsConfig struct {
	Enabled    bool   `yaml:"enabled"`
	Prefix     string `yaml:"prefix"`
	ReadyLabel string `yaml:"ready_label"`
}

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

type LoadResult struct {
	FileCount        int // number of .jsonl files scanned
	CorruptLineCount int // number of lines skipped due to parse errors
}

type Logger interface {
	Info(format string, args ...any)
	OK(format string, args ...any)
	Warn(format string, args ...any)
	Error(format string, args ...any)
	Debug(format string, args ...any)
}

type NextGenPromptData struct {
	ClusterName     string
	Completeness    string
	Issues          string
	CompletedWaves  string
	ExistingADRs    []ExistingADR
	RejectedActions string
	FeedbackSection string
	ReportSection   string
	DoDSection      string
	OutputPath      string
	StrictnessLevel string
}

type NextGenResult struct {
	ClusterName string `json:"cluster_name"`
	Waves       []Wave `json:"waves"`
	Reasoning   string `json:"reasoning"`
}

type NextGenWavesAddedPayload struct {
	ClusterName string      `json:"cluster_name"`
	Waves       []WaveState `json:"waves"`
}

type NopLogger struct{}

type PipeType int

type Policy struct {
	Name    string    // unique identifier for the policy
	Trigger EventType // domain event that activates this policy
	Action  string    // description of the resulting command
}

type Provider string

type ProviderErrorInfo struct {
	Kind    ProviderErrorKind
	ResetAt time.Time // parsed reset time (zero if unknown)
}

type ProviderErrorKind int

type ReadyLabelPromptData struct {
	ReadyLabel    string
	ReadyIssueIDs string
}

type ReadyLabelsAppliedPayload struct {
	IssueIDs []string `json:"issue_ids"`
}

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

type ResumeChoice int

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

type RetryConfig struct {
	MaxAttempts  int `yaml:"max_attempts"`
	BaseDelaySec int `yaml:"base_delay_sec"`
}

type ReviewResult struct {
	Passed   bool   // true if no actionable comments were found
	Output   string // raw review output
	Comments string // extracted review comments (empty if passed)
}

type Ripple struct {
	ClusterName string `json:"cluster_name"`
	Description string `json:"description"`
}

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

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

type ScanCompletedPayload struct {
	Clusters       []ClusterState `json:"clusters"`
	Completeness   float64        `json:"completeness"`
	ShibitoCount   int            `json:"shibito_count"`
	ScanResultPath string         `json:"scan_result_path"`
	LastScanned    time.Time      `json:"last_scanned"`
}

type ScanConfig struct {
	ChunkSize      int `yaml:"chunk_size"`
	MaxConcurrency int `yaml:"max_concurrency"`
}

type ScanRecoveryReport struct {
	// Outcomes contains one entry per cluster in the original scan order.
	Outcomes       []ClusterScanOutcome
	SucceededCount int
	FailedCount    int
}

type ScanResult struct {
	Clusters        []ClusterScanResult `json:"clusters"`
	TotalIssues     int                 `json:"total_issues"`
	Completeness    float64             `json:"completeness"`
	Observations    []string            `json:"observations"`
	ShibitoWarnings []ShibitoWarning    `json:"shibito_warnings,omitempty"`
	ScanWarnings    []string            `json:"scan_warnings,omitempty"`
}

type ScribeADRPromptData struct {
	ClusterName     string
	WaveTitle       string
	WaveActions     string
	Analysis        string
	Reasoning       string
	ADRNumber       string
	OutputPath      string
	StrictnessLevel string
	ExistingADRs    []ExistingADR
}

type ScribeConfig struct {
	Enabled           bool `yaml:"enabled"`
	AutoDiscussRounds int  `yaml:"auto_discuss_rounds"`
}

type ScribeResponse struct {
	ADRID     string        `json:"adr_id"`
	Title     string        `json:"title"`
	Content   string        `json:"content"`
	Reasoning string        `json:"reasoning"`
	Conflicts []ADRConflict `json:"conflicts,omitempty"`
}

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

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

type SessionRescannedPayload struct {
	OriginalSessionID string `json:"original_session_id"`
}

type SessionResumedPayload struct {
	OriginalSessionID string `json:"original_session_id"`
}

type SessionStartedPayload struct {
	Project         string `json:"project"`
	StrictnessLevel string `json:"strictness_level"`
}

type SessionState struct {
	Version         string         `json:"version"`
	SessionID       string         `json:"session_id"`
	Project         string         `json:"project"`
	LastScanned     time.Time      `json:"last_scanned"`
	Completeness    float64        `json:"completeness"`
	Clusters        []ClusterState `json:"clusters"`
	Waves           []WaveState    `json:"waves,omitempty"`
	ADRCount        int            `json:"adr_count,omitempty"`
	ShibitoCount    int            `json:"shibito_count,omitempty"`
	FeedbackCount   int            `json:"feedback_count,omitempty"`
	StrictnessLevel string         `json:"strictness_level,omitempty"`
	ScanResultPath  string         `json:"scan_result_path,omitempty"`
}

type SessionStatus string

type SessionStreamEvent struct {
	SchemaVersion     uint8           `json:"v"`
	ID                string          `json:"id"`
	Timestamp         time.Time       `json:"ts"`
	Tool              string          `json:"tool"`
	SessionID         string          `json:"session_id"`
	Provider          Provider        `json:"provider"`
	ProviderSessionID string          `json:"provider_session_id,omitempty"`
	Type              StreamEventType `json:"type"`
	ParentSessionID   string          `json:"parent_session_id,omitempty"`
	SubagentID        string          `json:"subagent_id,omitempty"`
	Data              json.RawMessage `json:"data"`
	Raw               string          `json:"raw,omitempty"`
	RawTruncated      bool            `json:"raw_truncated,omitempty"`
}

type ShibitoWarning struct {
	ClosedIssueID  string `json:"closed_issue_id"`
	CurrentIssueID string `json:"current_issue_id"`
	Description    string `json:"description"`
	RiskLevel      string `json:"risk_level"`
}

type SilentError struct{ Err error }

type StatusReport struct {
	LastScanned  time.Time `json:"last_scanned"`
	WavesTotal   int       `json:"waves_total"`
	InboxCount   int       `json:"inbox_count"`
	ArchiveCount int       `json:"archive_count"`
	SuccessRate  float64   `json:"success_rate"`
}

type StreamEventType string

type StrictnessConfig struct {
	Default   StrictnessLevel            `yaml:"default"`
	Overrides map[string]StrictnessLevel `yaml:"overrides"`
}

type StrictnessLevel string

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

type TrackingMode string

type Wave struct {
	ID              string             `json:"id"`
	ClusterName     string             `json:"cluster_name"`
	ClusterKey      string             `json:"cluster_key,omitempty"`
	Title           string             `json:"title"`
	Description     string             `json:"description"`
	Actions         []WaveAction       `json:"actions"`
	Prerequisites   []string           `json:"prerequisites"`
	Delta           WaveDelta          `json:"delta"`
	Status          string             `json:"status"`
	ClusterContext  *ClusterScanResult `json:"cluster_context,omitempty"`
	ComplexityScore float64            `json:"complexity_score,omitempty"`
}

type WaveAction struct {
	Type        string `json:"type"`
	IssueID     string `json:"issue_id"`
	Description string `json:"description"`
	Detail      string `json:"detail"`
}

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

type WaveAppliedPayload struct {
	WaveID      string   `json:"wave_id"`
	ClusterName string   `json:"cluster_name"`
	Applied     int      `json:"applied"`
	TotalCount  int      `json:"total_count"`
	Errors      []string `json:"errors,omitempty"`
}

type WaveApplyPromptData struct {
	WaveID          string
	ClusterName     string
	Title           string
	Actions         string
	DoDSection      string
	OutputPath      string
	StrictnessLevel string
	LabelsEnabled   bool
	LabelPrefix     string
	IsWaveMode      bool
}

type WaveApplyResult struct {
	WaveID     string   `json:"wave_id"`
	Applied    int      `json:"applied"`
	TotalCount int      `json:"total_count,omitempty"`
	Errors     []string `json:"errors"`
	Ripples    []Ripple `json:"ripples"`
}

type WaveCompletedPayload struct {
	WaveID      string `json:"wave_id"`
	ClusterName string `json:"cluster_name"`
	Applied     int    `json:"applied"`
	TotalCount  int    `json:"total_count"`
}

type WaveDelta struct {
	Before float64 `json:"before"`
	After  float64 `json:"after"`
}

type WaveGeneratePromptData struct {
	ClusterName     string
	Completeness    string
	Issues          string
	Observations    string
	DoDSection      string
	OutputPath      string
	StrictnessLevel string
}

type WaveGenerateResult struct {
	ClusterName string `json:"cluster_name"`
	Waves       []Wave `json:"waves"`
}

type WaveIdentityPayload struct {
	WaveID      string `json:"wave_id"`
	ClusterName string `json:"cluster_name"`
}

type WaveModification struct {
	ActionIndex int    `json:"action_index"`
	Change      string `json:"change"`
}

type WaveModifiedPayload struct {
	WaveID      string    `json:"wave_id"`
	ClusterName string    `json:"cluster_name"`
	UpdatedWave WaveState `json:"updated_wave"`
}

type WavePlan struct {
	Waves      []Wave      `json:"waves"`
	ScanResult *ScanResult `json:"scan_result,omitempty"`
}

type WaveReference struct {
	ID    string        `yaml:"id" json:"id"`
	Step  string        `yaml:"step,omitempty" json:"step,omitempty"`
	Steps []WaveStepDef `yaml:"steps,omitempty" json:"steps,omitempty"`
}

type WaveStalledPayload struct {
	WaveID      string `json:"wave_id"`
	ClusterName string `json:"cluster_name"`
	Reason      string `json:"reason"`
}

type WaveState struct {
	ID            string       `json:"id"`
	ClusterName   string       `json:"cluster_name"`
	Title         string       `json:"title"`
	Status        string       `json:"status"`
	Prerequisites []string     `json:"prerequisites,omitempty"`
	ActionCount   int          `json:"action_count"`
	Actions       []WaveAction `json:"actions,omitempty"`
	Description   string       `json:"description,omitempty"`
	Delta         WaveDelta    `json:"delta,omitempty"`
}

type WaveStepDef struct {
	ID            string   `yaml:"id" json:"id"`
	Title         string   `yaml:"title" json:"title"`
	Description   string   `yaml:"description,omitempty" json:"description,omitempty"`
	Targets       []string `yaml:"targets,omitempty" json:"targets,omitempty"`
	Acceptance    string   `yaml:"acceptance,omitempty" json:"acceptance,omitempty"`
	Prerequisites []string `yaml:"prerequisites,omitempty" json:"prerequisites,omitempty"`
}

type WavesGeneratedPayload struct {
	Waves []WaveState `json:"waves"`
}

type WavesUnlockedPayload struct {
	UnlockedWaveIDs []string `json:"unlocked_wave_ids"`
}