model

type AppState struct {
	Compare          ResolvedCompare
	CompareBasis     CompareBasis
	Files            []FileSummary
	SelectedFile     int // Index into Files. -1 when Files is empty.
	Patches          map[string]PatchLoadState
	CacheGeneration  int
	IgnoreWhitespace bool
	SearchQuery      string
	FocusPane        Pane
	Layout           LayoutMode
	PatchLineMode    LineMode
	PatchDiffMode    PatchDiffMode

	// Watch mode state (v0.2).
	WatchEnabled    bool
	WatchInterval   time.Duration
	LastFingerprint string
	RefreshInFlight bool
	LastRefreshAt   time.Time

	// Commit generation state (v0.2).
	CommitEnabled bool
	CommitAuto    bool
	CommitState   CommitState

	// Freshness tracking (v0.3).
	GroupByDirectory bool           // config-driven directory grouping in file list
	FileChangeGen    map[string]int // path → CacheGeneration when file last changed

	// Worktree dashboard mode (v0.2).
	WorktreeMode   bool
	DashboardState DashboardState

	// Discard confirmation state.
	ConfirmDiscard   bool
	DiscardPath      string
	DiscardUntracked bool
	DiscardInFlight  bool
	DiscardErr       string
}

type CommitState struct {
	GeneratedMessage string
	Provider         string
	InFlight         bool
	Err              error
	Generation       int // monotonic counter to discard stale async results

	// Execution state (V2-T8).
	Executing bool
	CommitSHA string
	CommitErr error
}

type CompareBasis string

type CompareMode string

type CompareRequest struct {
	Repo             RepoContext
	BaseRef          string
	Basis            CompareBasis
	HeadRef          string
	Mode             CompareMode
	IgnoreWhitespace bool
}

type DashboardState struct {
	Worktrees         []WorktreeInfo
	SelectedIdx       int
	ScrollOffset      int
	DrillDown         bool // true when viewing a worktree's diff
	DrillGeneration   int  // monotonic counter to discard stale drill-down results
	RefreshGeneration int  // monotonic counter to discard stale worktree refresh results

	// Preview pane state.
	PreviewCache map[string]PreviewEntry // cache key (snap) → preview data
	PreviewFiles []FileSummary           // current selection's preview (for rendering)

	// Deletion state.
	ConfirmDelete  bool   // true when awaiting deletion confirmation
	DeletePath     string // path of worktree to delete
	DeleteBranch   string // branch name of worktree being deleted
	DeleteDirty    bool   // true if the worktree is dirty (requires force)
	DeleteErr      string // error message from failed deletion
	DeleteIsMain   bool   // true if user tried to delete main worktree
	DeleteInFlight bool   // true while async deletion is running
}

type DiffLine struct {
	Kind  LineKind
	OldNo *int
	NewNo *int
	Text  string
}

type FilePatch struct {
	Summary FileSummary
	Hunks   []Hunk
}

type FileStatus string

type FileSummary struct {
	Path        string
	OldPath     string
	Status      FileStatus
	Additions   int
	Deletions   int
	IsBinary    bool
	IsSubmodule bool
}

type Hunk struct {
	Header           string
	OldStart, OldLen int
	NewStart, NewLen int
	Lines            []DiffLine
}

type LayoutMode string

type LineKind string

type LineMode int

type LoadStatus string

type Pane string

type PatchDiffMode int

type PatchLoadState struct {
	Status      LoadStatus
	Patch       *FilePatch
	Err         error
	Generation  int
	ContentHash string // SHA-256 of patch content for scroll preservation
}

type PreviewEntry struct {
	Files []FileSummary
}

type RepoContext struct {
	WorktreeRoot     string // git rev-parse --show-toplevel
	GitDir           string // git rev-parse --absolute-git-dir (per-worktree)
	GitCommonDir     string // git rev-parse --git-common-dir (shared across worktrees)
	IsLinkedWorktree bool   // GitDir != GitCommonDir after path canonicalization
}

type ResolvedCompare struct {
	Repo         RepoContext
	BaseRef      string
	Basis        CompareBasis
	HeadRef      string
	WorkingTree  bool   // true when diffing against the working tree (no head ref).
	MergeBase    string // SHA of merge-base in three-dot mode; empty string in two-dot mode.
	DiffRange    string // Range string passed to git diff: "base...head", "base..head", or just "base" in working tree mode.
	WatchBaseRef string // Symbolic base ref for watch fingerprinting (e.g. "origin/main"); empty when @{upstream} was used.
}

type WorktreeInfo struct {
	Path            string    // absolute path
	Branch          string    // short branch name (e.g. "main", "feature")
	CommitHash      string    // short commit hash
	Subject         string    // first line of commit message
	Dirty           bool      // true if worktree has uncommitted changes
	Bare            bool      // true if bare worktree
	ChangedFiles    int       // number of changed files from git status
	HeadCommittedAt time.Time // committer date of HEAD commit (git-based staleness)
	LastActivityAt  time.Time // updated when snapshot state changes (dirty, count, commit)
}