checkpoint

type AssignmentSnapshot struct {
	// BeadID is the assigned bead identifier
	BeadID string `json:"bead_id"`
	// BeadTitle is the bead title for display
	BeadTitle string `json:"bead_title"`
	// Pane is the pane index where the agent is working
	Pane int `json:"pane"`
	// AgentType is the agent type (cc, cod, gmi)
	AgentType string `json:"agent_type"`
	// AgentName is the Agent Mail name if registered
	AgentName string `json:"agent_name,omitempty"`
	// Status is the assignment status (assigned, working, completed, failed)
	Status string `json:"status"`
	// AssignedAt is when the bead was assigned
	AssignedAt time.Time `json:"assigned_at"`
}

type AutoCheckpointConfig struct {
	Enabled         bool // Master toggle
	IntervalMinutes int  // Periodic checkpoint interval (0 = disabled)
	MaxCheckpoints  int  // Max auto-checkpoints per session
	OnRotation      bool // Checkpoint before rotation
	OnError         bool // Checkpoint on error
	ScrollbackLines int  // Lines of scrollback to capture
	IncludeGit      bool // Capture git state
}

type AutoCheckpointOptions struct {
	SessionName     string
	Reason          AutoCheckpointReason
	Description     string // Additional context
	ScrollbackLines int
	IncludeGit      bool
	MaxCheckpoints  int // Max auto-checkpoints to keep (rotation)
}

type AutoCheckpointReason string

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

type AutoEvent struct {
	Type        AutoEventType
	SessionName string
	AgentID     string // Which agent triggered the event
	Description string // Additional context
}

type AutoEventType int

type BVSnapshot struct {
	// OpenCount is the number of open beads
	OpenCount int `json:"open_count"`
	// ActionableCount is beads ready for work (unblocked)
	ActionableCount int `json:"actionable_count"`
	// BlockedCount is beads blocked by dependencies
	BlockedCount int `json:"blocked_count"`
	// InProgressCount is beads currently being worked
	InProgressCount int `json:"in_progress_count"`
	// TopPicks contains IDs of top recommended beads
	TopPicks []string `json:"top_picks,omitempty"`
	// CapturedAt is when the BV snapshot was taken
	CapturedAt time.Time `json:"captured_at"`
}

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

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

type Checkpoint struct {
	// Version is the checkpoint format version (for compatibility)
	Version int `json:"version"`
	// ID is the unique identifier (timestamp-based)
	ID string `json:"id"`
	// Name is the user-provided checkpoint name
	Name string `json:"name"`
	// Description is an optional user description
	Description string `json:"description,omitempty"`
	// SessionName is the tmux session this checkpoint belongs to
	SessionName string `json:"session_name"`
	// WorkingDir is the working directory at checkpoint time
	WorkingDir string `json:"working_dir"`
	// CreatedAt is when the checkpoint was created
	CreatedAt time.Time `json:"created_at"`
	// Session contains the captured session state
	Session SessionState `json:"session"`
	// Git contains the captured git state
	Git GitState `json:"git,omitempty"`
	// PaneCount is the number of panes captured
	PaneCount int `json:"pane_count"`

	// Assignments contains bead-to-agent assignment state at checkpoint time (bd-32ck)
	// This field is optional for backward compatibility with older checkpoints.
	Assignments []AssignmentSnapshot `json:"assignments,omitempty"`

	// BVSummary contains BV triage summary at checkpoint time (bd-32ck)
	// This field is optional for backward compatibility with older checkpoints.
	BVSummary *BVSnapshot `json:"bv_summary,omitempty"`
}

type CheckpointOption func(*checkpointOptions)

type ExportFormat string

type ExportManifest struct {
	Version        int               `json:"version"`
	ExportedAt     time.Time         `json:"exported_at"`
	SessionName    string            `json:"session_name"`
	CheckpointID   string            `json:"checkpoint_id"`
	CheckpointName string            `json:"checkpoint_name"`
	OriginalPath   string            `json:"original_path"`
	Files          []ManifestEntry   `json:"files"`
	Checksums      map[string]string `json:"checksums"`
}

type ExportOptions struct {
	// Format specifies the archive format (default: tar.gz)
	Format ExportFormat
	// RedactSecrets removes potential secrets from scrollback
	RedactSecrets bool
	// RewritePaths makes paths portable across machines
	RewritePaths bool
	// IncludeScrollback includes scrollback files in export
	IncludeScrollback bool
	// IncludeGitPatch includes git patch file in export
	IncludeGitPatch bool
}

type FileManifest struct {
	// Files maps relative paths to SHA256 hex hashes.
	Files map[string]string `json:"files"`
	// CreatedAt is when the manifest was generated.
	CreatedAt string `json:"created_at,omitempty"`
}

type GitChange struct {
	// FromCommit is the base checkpoint's commit
	FromCommit string `json:"from_commit"`
	// ToCommit is the current commit
	ToCommit string `json:"to_commit"`
	// Branch may have changed
	Branch string `json:"branch,omitempty"`
	// PatchFile is the relative path to the incremental patch
	PatchFile string `json:"patch_file,omitempty"`
	// IsDirty indicates uncommitted changes
	IsDirty bool `json:"is_dirty"`
	// StagedCount changed
	StagedCount int `json:"staged_count"`
	// UnstagedCount changed
	UnstagedCount int `json:"unstaged_count"`
	// UntrackedCount changed
	UntrackedCount int `json:"untracked_count"`
}

type GitState struct {
	// Branch is the current branch name
	Branch string `json:"branch"`
	// Commit is the current HEAD commit SHA
	Commit string `json:"commit"`
	// IsDirty indicates uncommitted changes exist
	IsDirty bool `json:"is_dirty"`
	// PatchFile is the relative path to the git diff patch
	PatchFile string `json:"patch_file,omitempty"`
	// StagedCount is the number of staged files
	StagedCount int `json:"staged_count"`
	// UnstagedCount is the number of modified but unstaged files
	UnstagedCount int `json:"unstaged_count"`
	// UntrackedCount is the number of untracked files
	UntrackedCount int `json:"untracked_count"`
}

type ImportOptions struct {
	// TargetSession overrides the session name on import
	TargetSession string
	// TargetDir overrides the working directory on import
	TargetDir string
	// VerifyChecksums validates file integrity on import
	VerifyChecksums bool
	// AllowOverwrite permits overwriting existing checkpoints
	AllowOverwrite bool
}

type IncrementalChanges struct {
	// PaneChanges maps pane ID to its changes
	PaneChanges map[string]PaneChange `json:"pane_changes,omitempty"`
	// GitChange holds changes to git state
	GitChange *GitChange `json:"git_change,omitempty"`
	// SessionChange holds changes to session layout
	SessionChange *SessionChange `json:"session_change,omitempty"`
}

type IncrementalCheckpoint struct {
	// Version is the incremental checkpoint format version
	Version int `json:"version"`
	// ID is the unique identifier for this incremental
	ID string `json:"id"`
	// SessionName is the tmux session this belongs to
	SessionName string `json:"session_name"`
	// BaseCheckpointID is the ID of the full checkpoint this is based on
	BaseCheckpointID string `json:"base_checkpoint_id"`
	// BaseTimestamp is when the base checkpoint was created
	BaseTimestamp time.Time `json:"base_timestamp"`
	// CreatedAt is when this incremental was created
	CreatedAt time.Time `json:"created_at"`
	// Description is an optional description
	Description string `json:"description,omitempty"`
	// Changes holds the differential data
	Changes IncrementalChanges `json:"changes"`
}

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

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

type IntegrityResult struct {
	// Valid is true if all checks passed.
	Valid bool `json:"valid"`

	// SchemaValid indicates if the schema is valid.
	SchemaValid bool `json:"schema_valid"`
	// FilesPresent indicates if all referenced files exist.
	FilesPresent bool `json:"files_present"`
	// ChecksumsValid indicates if all checksums match (if manifest exists).
	ChecksumsValid bool `json:"checksums_valid"`
	// ConsistencyValid indicates if internal consistency checks pass.
	ConsistencyValid bool `json:"consistency_valid"`

	// Errors contains any validation errors.
	Errors []string `json:"errors,omitempty"`
	// Warnings contains non-fatal issues.
	Warnings []string `json:"warnings,omitempty"`
	// Details contains detailed check results.
	Details map[string]string `json:"details,omitempty"`

	// Manifest contains file checksums for verification.
	Manifest *FileManifest `json:"manifest,omitempty"`
}

type ManifestEntry struct {
	Path     string `json:"path"`
	Size     int64  `json:"size"`
	Checksum string `json:"checksum"`
}

type PaneChange struct {
	// NewLines is the number of new lines added since base
	NewLines int `json:"new_lines"`
	// DiffFile is the relative path to the scrollback diff file
	DiffFile string `json:"diff_file,omitempty"`
	// DiffContent is the new scrollback content (lines after base)
	DiffContent string `json:"-"` // Not serialized, held in memory during processing
	// Compressed is the compressed diff content
	Compressed []byte `json:"-"`
	// AgentType may have changed
	AgentType string `json:"agent_type,omitempty"`
	// Title may have changed
	Title string `json:"title,omitempty"`
	// Removed indicates pane was removed
	Removed bool `json:"removed,omitempty"`
	// Added indicates pane is new (not in base)
	Added bool `json:"added,omitempty"`
}

type PaneState struct {
	// Index is the pane index in the session
	Index int `json:"index"`
	// ID is the tmux pane ID (e.g., "%0")
	ID string `json:"id"`
	// Title is the pane title
	Title string `json:"title"`
	// AgentType is the detected agent type ("cc", "cod", "gmi", "user")
	AgentType string `json:"agent_type"`
	// Command is the running command
	Command string `json:"command,omitempty"`
	// Width is the pane width in columns
	Width int `json:"width"`
	// Height is the pane height in rows
	Height int `json:"height"`
	// ScrollbackFile is the relative path to scrollback capture
	ScrollbackFile string `json:"scrollback_file,omitempty"`
	// ScrollbackLines is the number of lines captured
	ScrollbackLines int `json:"scrollback_lines"`
}

type RestoreOptions struct {
	// Force kills any existing session with the same name
	Force bool
	// SkipGitCheck skips warning about git state mismatch
	SkipGitCheck bool
	// InjectContext sends scrollback/summary to agents after spawning
	InjectContext bool
	// DryRun shows what would be done without making changes
	DryRun bool
	// CustomDirectory overrides the checkpoint's working directory
	CustomDirectory string
	// ScrollbackLines is how many lines of scrollback to inject (0 = all captured)
	ScrollbackLines int
}

type RestoreResult struct {
	// SessionName is the restored session name
	SessionName string
	// PanesRestored is the number of panes created
	PanesRestored int
	// ContextInjected indicates if scrollback was sent to agents
	ContextInjected bool
	// Warnings contains non-fatal issues encountered
	Warnings []string
	// DryRun indicates this was a simulation
	DryRun bool
}

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

type ScrollbackCapture struct {
	// PaneID is the tmux pane identifier
	PaneID string
	// Lines is the number of lines captured
	Lines int
	// Content is the raw scrollback content
	Content string
	// Compressed is the gzip-compressed content
	Compressed []byte
	// Size is the size of the compressed content in bytes
	Size int64
	// Skipped indicates if capture was skipped (e.g., due to size limits)
	Skipped bool
	// SkipReason explains why capture was skipped
	SkipReason string
}

type ScrollbackConfig struct {
	// Lines is the number of lines to capture (default 5000)
	Lines int
	// Compress enables gzip compression (default true)
	Compress bool
	// MaxSizeMB is the maximum size in megabytes (0 = no limit)
	MaxSizeMB int
	// Timeout is the capture timeout (default 30s)
	Timeout time.Duration
}

type SessionChange struct {
	// Layout changed
	Layout string `json:"layout,omitempty"`
	// ActivePaneIndex changed
	ActivePaneIndex int `json:"active_pane_index,omitempty"`
	// PaneCount changed
	PaneCount int `json:"pane_count,omitempty"`
}

type SessionState struct {
	// Panes contains info about each pane in the session
	Panes []PaneState `json:"panes"`
	// Layout is the tmux layout string for restoration
	Layout string `json:"layout,omitempty"`
	// ActivePaneIndex is the currently selected pane
	ActivePaneIndex int `json:"active_pane_index"`
}

type Storage struct {
	// BaseDir is the base directory for all checkpoints
	BaseDir string
}

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