model

type AuditEventType string

type AuditRecord struct {
	Timestamp    time.Time      `json:"timestamp"`
	EventType    AuditEventType `json:"event_type"`
	SnapshotID   SnapshotID     `json:"snapshot_id,omitempty"`
	WorktreeName string         `json:"worktree_name,omitempty"`
	Details      map[string]any `json:"details,omitempty"`
	PrevHash     HashValue      `json:"prev_hash"`
	RecordHash   HashValue      `json:"record_hash"`
}

type CompressionInfo struct {
	Type  string `json:"type"`  // e.g., "gzip"
	Level int    `json:"level"` // Compression level (0-9)
}

type Descriptor struct {
	SnapshotID           SnapshotID            `json:"snapshot_id"`
	ParentID             *SnapshotID           `json:"parent_id,omitempty"`
	StartedFrom          *SnapshotID           `json:"started_from,omitempty"`
	RestoredFrom         *SnapshotID           `json:"restored_from,omitempty"`
	RestoredPaths        []RestoredPathSource  `json:"restored_paths,omitempty"`
	WorktreeName         string                `json:"worktree_name"`
	CreatedAt            time.Time             `json:"created_at"`
	Note                 string                `json:"note,omitempty"`
	Tags                 []string              `json:"tags,omitempty"`
	Engine               EngineType            `json:"engine"`
	ActualEngine         EngineType            `json:"actual_engine,omitempty"`
	EffectiveEngine      EngineType            `json:"effective_engine,omitempty"`
	DegradedReasons      []string              `json:"degraded_reasons,omitempty"`
	MetadataPreservation *MetadataPreservation `json:"metadata_preservation,omitempty"`
	PerformanceClass     string                `json:"performance_class,omitempty"`
	PayloadRootHash      HashValue             `json:"payload_root_hash"`
	DescriptorChecksum   HashValue             `json:"descriptor_checksum"`
	IntegrityState       IntegrityState        `json:"integrity_state"`
	// PartialPaths is set for partial snapshots, listing the specific paths included.
	// Empty or nil means a full worktree snapshot.
	PartialPaths []string `json:"partial_paths,omitempty"`
	// Compression stores compression metadata if the snapshot is compressed.
	Compression *CompressionInfo `json:"compression,omitempty"`
}

type EngineType string

type GCPlan struct {
	SchemaVersion          int                 `json:"schema_version"`
	RepoID                 string              `json:"repo_id"`
	PlanID                 string              `json:"plan_id"`
	CreatedAt              time.Time           `json:"created_at"`
	ProtectedSet           []SnapshotID        `json:"protected_set"`
	ProtectionGroups       []GCProtectionGroup `json:"protection_groups"`
	ProtectedByLineage     int                 `json:"protected_by_lineage"`
	CandidateCount         int                 `json:"candidate_count"`
	ToDelete               []SnapshotID        `json:"to_delete"`
	DeletableBytesEstimate int64               `json:"deletable_bytes_estimate"`
	ProtectedByRetention   int                 `json:"-"`
	RetentionPolicy        RetentionPolicy     `json:"-"`
}

type GCProtectionGroup struct {
	Reason     string       `json:"reason"`
	Count      int          `json:"count"`
	SavePoints []SnapshotID `json:"save_points"`
}

type HashValue string

type IntegrityState string

type IntentRecord struct {
	SnapshotID   SnapshotID `json:"snapshot_id"`
	WorktreeName string     `json:"worktree_name"`
	StartedAt    time.Time  `json:"started_at"`
	Engine       EngineType `json:"engine"`
}

type InvalidRetentionPolicyError struct {
	Field  string
	Reason string
	Value  interface{}
}

type MetadataPreservation struct {
	Symlinks   string `json:"symlinks"`
	Hardlinks  string `json:"hardlinks"`
	Mode       string `json:"mode"`
	Timestamps string `json:"timestamps"`
	Ownership  string `json:"ownership,omitempty"`
	Xattrs     string `json:"xattrs"`
	ACLs       string `json:"acls"`
}

type PathDirtySet map[string]PathDirtyState

type PathDirtyState string

type PathSource struct {
	SourceSnapshotID SnapshotID          `json:"source_snapshot_id"`
	SourcePath       string              `json:"source_path"`
	Status           PathSourceStatus    `json:"status"`
	Evidence         *PathSourceEvidence `json:"evidence,omitempty"`
}

type PathSourceEvidence struct {
	Hash HashValue `json:"hash,omitempty"`
}

type PathSourceStatus string

type PathSources map[string]PathSource

type Pin struct {
	PinID      string     `json:"pin_id,omitempty"`
	SnapshotID SnapshotID `json:"snapshot_id"`
	PinnedAt   time.Time  `json:"pinned_at,omitempty"`
	CreatedAt  time.Time  `json:"created_at,omitempty"`
	Reason     string     `json:"reason,omitempty"`
	ExpiresAt  *time.Time `json:"expires_at,omitempty"`
}

type ReadyMarker struct {
	SnapshotID         SnapshotID `json:"snapshot_id"`
	CompletedAt        time.Time  `json:"completed_at"`
	PayloadHash        HashValue  `json:"payload_root_hash"`
	Engine             EngineType `json:"engine"`
	DescriptorChecksum HashValue  `json:"descriptor_checksum"`
}

type RestoredPathSource struct {
	TargetPath       string              `json:"target_path"`
	SourceSnapshotID SnapshotID          `json:"source_snapshot_id"`
	SourcePath       string              `json:"source_path"`
	Status           PathSourceStatus    `json:"status"`
	Evidence         *PathSourceEvidence `json:"evidence,omitempty"`
}

type RetentionPolicy struct {
	// KeepMinSnapshots ensures at least N snapshots are always kept.
	// The most recent snapshots by creation time are protected.
	KeepMinSnapshots int `json:"-"`

	// KeepMinAge protects snapshots younger than this duration.
	// Snapshots created within this time window are never deleted.
	KeepMinAge time.Duration `json:"-"`
}

type SnapshotID string

type Tombstone struct {
	SnapshotID  SnapshotID `json:"snapshot_id"`
	DeletedAt   time.Time  `json:"deleted_at"`
	Reclaimable bool       `json:"reclaimable"`
	GCState     string     `json:"gc_state,omitempty"`
	Reason      string     `json:"reason,omitempty"`
}

type WorkspaceSaveLineage struct {
	SnapshotID    SnapshotID           `json:"snapshot_id,omitempty"`
	ParentID      *SnapshotID          `json:"parent_id,omitempty"`
	StartedFrom   *SnapshotID          `json:"started_from,omitempty"`
	RestoredFrom  *SnapshotID          `json:"restored_from,omitempty"`
	RestoredPaths []RestoredPathSource `json:"restored_paths,omitempty"`
}

type WorkspaceState struct {
	HistoryHead              *SnapshotID  `json:"history_head,omitempty"`
	ContentSource            *SnapshotID  `json:"content_source,omitempty"`
	StartedFrom              *SnapshotID  `json:"started_from,omitempty"`
	PathSources              PathSources  `json:"path_sources,omitempty"`
	DirtyPaths               PathDirtySet `json:"dirty_paths,omitempty"`
	HasUnknownUnsavedChanges bool         `json:"has_unknown_unsaved_changes,omitempty"`
	HasUnsavedChanges        bool         `json:"has_unsaved_changes"`
}

type WorktreeConfig struct {
	Name                  string      `json:"name"`
	RealPath              string      `json:"real_path,omitempty"`          // Canonical real folder path for adopted workspaces
	BaseSnapshotID        SnapshotID  `json:"base_snapshot_id,omitempty"`   // Immutable snapshot worktree was created from
	HeadSnapshotID        SnapshotID  `json:"head_snapshot_id,omitempty"`   // Current position (may differ from latest if detached)
	LatestSnapshotID      SnapshotID  `json:"latest_snapshot_id,omitempty"` // The most recent snapshot in this worktree's lineage
	StartedFromSnapshotID SnapshotID  `json:"started_from,omitempty"`       // Initial content source for a workspace with no inherited history
	PathSources           PathSources `json:"path_sources,omitempty"`       // Path-level restore provenance for the active workspace
	CreatedAt             time.Time   `json:"created_at"`
}