api

type ActiveInputAuthority struct {
	CoordinatorID string
	Fence         uint64
}

type ActiveInputRecord struct {
	State              ActiveInputState
	Revision           uint64
	Fence              uint64
	OwnerID            string
	CoordinatorID      string
	LeaseExpiresAt     time.Time
	InputID            string
	SourceVersion      string
	WorkflowID         WorkflowID
	ReservationID      string
	RequestedPath      string
	IdempotencyKey     string
	RequestFingerprint WorkflowFingerprint
}

type ActiveInputRepository interface {
	LoadActiveInput(context.Context) (ActiveInputRecord, error)
	CompareAndSwapActiveInput(context.Context, ActiveInputRecord, ActiveInputRecord, time.Time) error
	CloseIdleActiveInput(context.Context, ActiveInputRecord, time.Time) error
	// FinalizeActiveInput atomically publishes the verified input, workflow and slot.
	// Non-nil retention requires the exact generation and correction revision for the canonical input path.
	FinalizeActiveInput(context.Context, ActiveInputRecord, ActiveInputRecord, InputRecord, *ReleaseWorkflowStateRecord, time.Time, *ActiveInputRetention) error
	RenewActiveInput(context.Context, string, uint64, time.Time, time.Time) error
	RelinquishActiveInput(context.Context, string, uint64, time.Time) error
	LoadInputRecord(context.Context, string) (InputRecord, error)
	LoadInputWorkflowAssociation(context.Context, string, string, string) (InputWorkflowAssociation, error)
	LoadInputRecordByID(context.Context, string) (InputRecord, error)
	SaveInputRecord(context.Context, InputRecord) (InputRecord, error)
}

type ActiveInputRetention struct {
	Release            ReleaseRef
	CorrectionRevision uint64
}

type ActiveInputSnapshot struct {
	State    ActiveInputState `json:"state"`
	Revision uint64           `json:"revision"`
	InputID  string           `json:"inputId,omitempty"`
	// SourcePath is the verified canonical path, exposed only to the current input's owner.
	// It remains available before preparation produces a release.
	SourcePath    string                  `json:"sourcePath,omitempty"`
	SourceVersion string                  `json:"sourceVersion,omitempty"`
	Current       *ReleaseWorkflowCurrent `json:"current,omitempty"`
	// RecoveryWorkflowIDs lists this owner's unresolved migrated workflows only
	// while no input is active. Selecting one starts reconciliation; it never
	// resumes preparation or submission.
	RecoveryWorkflowIDs []WorkflowID `json:"recoveryWorkflowIds,omitempty"`
}

type ActiveInputState string

type AnalyzeReleaseWorkflowAudioRequest struct {
	ReleaseWorkflowCommandContext
	Instructions AudioAnalysisInstructions `json:"instructions"`
}

type AnalyzeReleaseWorkflowHDRRequest struct {
	ReleaseWorkflowCommandContext
	Instructions HDRAnalysisInstructions `json:"instructions"`
}

type AniListAiringEpisode struct {
	// AiringAt is a Unix timestamp in seconds.
	AiringAt int
	// TimeUntilAiring is seconds from AniList's response time until AiringAt.
	TimeUntilAiring int
	Episode         int
}

type AniListExternalLink struct {
	Site     string
	URL      string
	Type     string
	Language string
}

type AniListMetadata struct {
	// AniListID is the AniList media ID used in AniList URLs.
	AniListID int
	// MALID is the MyAnimeList media ID used as upbrr's canonical anime ID.
	MALID int
	// SiteURL is the canonical AniList media page URL.
	SiteURL string
	// Title* fields preserve AniList's localized title variants.
	TitleRomaji        string
	TitleEnglish       string
	TitleNative        string
	TitleUserPreferred string
	// Description is AniList's plain-text media description.
	Description string
	// Format, Status, Season, and Source are AniList enum values.
	Format string
	Status string
	// StartDate is formatted as YYYY, YYYY-MM, or YYYY-MM-DD depending on AniList precision.
	StartDate string
	// EndDate is formatted as YYYY, YYYY-MM, or YYYY-MM-DD depending on AniList precision.
	EndDate    string
	Season     string
	SeasonYear int
	Episodes   int
	// Duration is AniList's average episode duration in minutes.
	Duration        int
	CountryOfOrigin string
	Source          string
	// Cover* and BannerImage are AniList image URLs or color metadata used by previews.
	CoverExtraLarge string
	CoverLarge      string
	CoverMedium     string
	CoverColor      string
	BannerImage     string
	Genres          []string
	Synonyms        []string
	// AverageScore and MeanScore are AniList percentage scores from 0 to 100.
	AverageScore      int
	MeanScore         int
	Popularity        int
	Favourites        int
	IsAdult           bool
	Tags              []AniListTag
	Studios           []AniListStudio
	Trailer           AniListTrailer
	NextAiringEpisode AniListAiringEpisode
	ExternalLinks     []AniListExternalLink
}

type AniListStudio struct {
	ID   int
	Name string
	// SiteURL is the AniList studio page URL.
	SiteURL string
}

type AniListTag struct {
	Name string
	// Rank is AniList's tag relevance percentage from 0 to 100.
	Rank     int
	Category string
	// IsAdult and Is*Spoiler let UI consumers omit sensitive tag labels.
	IsAdult          bool
	IsGeneralSpoiler bool
	IsMediaSpoiler   bool
}

type AniListTrailer struct {
	ID   string
	Site string
	// Thumbnail is the provider thumbnail URL when AniList supplies one.
	Thumbnail string
}

type ApplicationDependency struct {
	Path string `json:"path"`
	// Version is a release tag or commit and UTC date, including replacement metadata.
	// Local replacements are labeled "local build" without exposing their paths.
	Version string `json:"version"`
}

type ApplicationInfo struct {
	// TestRuntime is present only when the process enforces live-testing restrictions.
	TestRuntime     *TestRuntimeInfo `json:"testRuntime,omitempty"`
	Version         string           `json:"version"`
	BuildIdentifier string           `json:"buildIdentifier"`
	// BuildTime is the embedded VCS commit time in RFC3339 UTC, or empty when unavailable.
	BuildTime string `json:"buildTime"`
	// Dependencies lists linked autobrr modules; CurrentApplicationInfo returns an empty slice when unavailable.
	Dependencies  []ApplicationDependency `json:"dependencies"`
	GoVersion     string                  `json:"goVersion"`
	GOOS          string                  `json:"goos"`
	GOARCH        string                  `json:"goarch"`
	Uptime        string                  `json:"uptime"`
	UptimeSeconds int64                   `json:"uptimeSeconds"`
	// DVDMenuEngine contains path-free engine and FFmpeg probe metadata.
	DVDMenuEngine DVDMenuEngineInfo `json:"dvdMenuEngine"`
	// DVDMenuCapabilityStatus is available, incompatible, or unavailable.
	DVDMenuCapabilityStatus string `json:"dvdMenuCapabilityStatus"`
	// DVDMenuCapabilityMessage is the user-facing reason for the capability status.
	DVDMenuCapabilityMessage string `json:"dvdMenuCapabilityMessage"`
}

type AssetEvidence struct {
	// LosslessCount and InspectedFormatCount describe decoded image bytes.
	LosslessCount        int
	InspectedFormatCount int
	Status               MetadataEvidenceStatus
	Ready                bool
	Count                int
}

type AssetFacts struct {
	// ScreenshotFingerprint binds selected images and tracker-usable hosted variants.
	ScreenshotFingerprint WorkflowFingerprint
	ScreenshotReferences  []ScreenshotReference
	HDRArtifacts          []HDRArtifactEvidence
	EvidenceFingerprint   WorkflowFingerprint
	Status                MetadataEvidenceStatus
	MediaInfoJSON         AssetEvidence
	MediaInfoText         AssetEvidence
	DVDVOBMediaInfo       AssetEvidence
	BDInfo                AssetEvidence
	NFO                   AssetEvidence
	Screenshots           AssetEvidence
	HostedScreenshots     AssetEvidence
	DVDMenus              AssetEvidence
	HostedDVDMenus        AssetEvidence
}

type AttachReleaseWorkflowMediaRequest struct {
	ReleaseWorkflowCommandContext
	Media       *MediaArtifactSetRef `json:"media,omitempty"`
	Attachments []MediaAttachment    `json:"attachments"`
}

type AudioAnalysisArtifact struct {
	ID      PublicResourceID      `json:"id"`
	Variant AudioAnalysisVariant  `json:"variant"`
	Status  StageStatus           `json:"status"`
	Width   int                   `json:"width,omitempty"`
	Height  int                   `json:"height,omitempty"`
	Text    string                `json:"text,omitempty"`
	Failure *AudioAnalysisFailure `json:"failure,omitempty"`
}

type AudioAnalysisError struct {
	Failure AudioAnalysisFailure
	// contains filtered or unexported fields
}

type AudioAnalysisFailure struct {
	Code    AudioAnalysisFailureCode `json:"code"`
	Message string                   `json:"message"`
}

type AudioAnalysisFailureCode string

type AudioAnalysisInstructions struct {
	Release        ReleaseRef                  `json:"release"`
	ResourceID     string                      `json:"resourceId"`
	Selection      AudioAnalysisSelectionMode  `json:"selection"`
	TrackIDs       []string                    `json:"trackIds"`
	Variants       []AudioAnalysisVariant      `json:"variants"`
	ProfileVersion string                      `json:"profileVersion"`
	ResourceLimits AudioAnalysisResourceLimits `json:"resourceLimits,omitempty"`
}

type AudioAnalysisRef struct {
	ID       AudioAnalysisResultID `json:"id"`
	Revision WorkflowRevision      `json:"revision"`
}

type AudioAnalysisResourceLimits struct {
	// DecoderThreads requests FFmpeg decoder threads; zero uses the default.
	DecoderThreads int `json:"decoderThreads,omitempty"`
}

type AudioAnalysisResult struct {
	ID                  AudioAnalysisResultID       `json:"id"`
	WorkflowID          WorkflowID                  `json:"workflowId"`
	Revision            WorkflowRevision            `json:"revision"`
	Release             ReleaseRef                  `json:"release"`
	ResourceID          string                      `json:"resourceId"`
	ManifestFingerprint string                      `json:"manifestFingerprint"`
	AttemptID           string                      `json:"attemptId"`
	Selection           AudioAnalysisSelectionMode  `json:"selection"`
	TrackIDs            []string                    `json:"trackIds"`
	Variants            []AudioAnalysisVariant      `json:"variants"`
	ProfileVersion      string                      `json:"profileVersion"`
	ResourceLimits      AudioAnalysisResourceLimits `json:"resourceLimits"`
	Status              StageStatus                 `json:"status"`
	Tracks              []AudioAnalysisTrackResult  `json:"tracks"`
	CreatedAt           time.Time                   `json:"createdAt" ts_type:"string"`
	CompletedAt         *time.Time                  `json:"completedAt,omitempty" ts_type:"string"`
}

type AudioAnalysisResultID string

type AudioAnalysisSelectionMode string

type AudioAnalysisSubject struct {
	MediaBinding        PreparedMediaBinding
	Release             ReleaseRef
	SourcePath          string
	VideoPath           string
	SourceFingerprint   string
	ResourceID          string
	ManifestFingerprint string
	PrimaryTrackID      string
	Tracks              []MediaTrackFacts
}

type AudioAnalysisTrackResult struct {
	TrackID       string                  `json:"trackId"`
	Ordinal       int                     `json:"ordinal"`
	Title         string                  `json:"title,omitempty"`
	Codec         string                  `json:"codec,omitempty"`
	Language      string                  `json:"language,omitempty"`
	ChannelLayout string                  `json:"channelLayout,omitempty"`
	Channels      int                     `json:"channels"`
	SampleRate    int                     `json:"sampleRate"`
	SampleFrames  int64                   `json:"sampleFrames"`
	Duration      float64                 `json:"durationSeconds"`
	Status        StageStatus             `json:"status"`
	Artifacts     []AudioAnalysisArtifact `json:"artifacts"`
	Failure       *AudioAnalysisFailure   `json:"failure,omitempty"`
}

type AudioAnalysisVariant string

type AudioDescriptionTrack struct {
	Ordinal int
	Images  []ScreenshotImage
	Stats   string
}

type AudioTrackRole string

type AvailabilityFacts struct {
	// Status describes the completeness of Providers as a set, not the result
	// of any one provider lookup.
	Status    MetadataEvidenceStatus
	Providers []ProviderAvailabilityEvidence
}

type BDMVRescanRequiredError struct {
	// SourcePath identifies the requested local Blu-ray source.
	SourcePath string
	// SelectedPlaylists contains the complete requested playlist set.
	SelectedPlaylists []string
	// CachedPlaylists contains the playlists already present in the cache.
	CachedPlaylists []string
	// MissingPlaylists contains the selected playlists that require a rescan.
	MissingPlaylists []string
}

type BlurayCandidateSelection struct {
	ReleaseID string             `json:"releaseId"`
	Release   ReleaseSnapshotRef `json:"release"`
}

type BlurayDiscSpec struct {
	Type   string
	Count  int
	Format string
}

type BlurayImage struct {
	Kind       string
	URL        string
	PreviewURL string
}

type BlurayMetadata struct {
	SourcePath        string
	IMDBID            int
	SearchURL         string
	SelectedReleaseID string
	SelectedURL       string
	AutoSelected      bool
	SelectionReason   string
	BestScore         float64
	Threshold         float64
	Candidates        []BlurayReleaseCandidate
	UpdatedAt         time.Time `ts_type:"string"`
}

type BlurayPlaybackSpec struct {
	Region      string
	RegionNotes string
}

type BlurayReleaseCandidate struct {
	ReleaseID    string
	ProductID    string
	MovieTitle   string
	MovieYear    string
	Title        string
	URL          string
	Price        string
	Publisher    string
	Country      string
	Region       string
	Score        float64
	Accepted     bool
	Warnings     []string
	MatchNotes   []string
	Specs        BluraySpecs
	CoverImages  []BlurayImage
	GenericDisc  bool
	SpecsMissing bool
}

type BluraySpecs struct {
	Video     BlurayVideoSpec
	Audio     []string
	Subtitles []string
	Discs     BlurayDiscSpec
	Playback  BlurayPlaybackSpec
}

type BlurayVideoSpec struct {
	Codec      string
	Resolution string
}

type BrowseDirectoryEntry struct {
	Name string `json:"name"`
	// Path preserves the listed host path, including an allowed symlink's spelling.
	Path  string `json:"path"`
	IsDir bool   `json:"isDir"`
	// Size is the filesystem-reported byte size; virtual root entries leave it zero.
	Size int64 `json:"size"`
	// ModifiedAt is UTC RFC3339 when available; virtual root entries leave it empty.
	ModifiedAt string `json:"modifiedAt"`
}

type BrowseDirectoryRequest struct {
	// Path is a host filesystem path; a file path lists its containing directory.
	// Roots scope requires an empty path.
	Path string `json:"path"`
	// Mode defaults to "folder". "file" includes recognized video files alongside directories.
	Mode string `json:"mode"`
	// Scope selects "roots" for a root listing or recursive search, or "directory" for a listing.
	// Omitting it preserves initial-path fallback and automatic root selection.
	Scope string `json:"scope,omitempty"`
	// Query searches entry names recursively in roots scope and is limited to 1024 UTF-8 bytes.
	// An empty query after name normalization returns the roots themselves.
	Query string `json:"query,omitempty"`
}

type BrowseDirectoryResponse struct {
	// CurrentPath is the listed host directory and is empty for roots scope.
	CurrentPath string `json:"currentPath"`
	// ParentPath is empty when navigation would leave the authorized root.
	ParentPath string                 `json:"parentPath"`
	Mode       string                 `json:"mode"`
	Entries    []BrowseDirectoryEntry `json:"entries"`
	// Scope describes the returned view, which can be "roots" for an initial directory request.
	Scope string `json:"scope"`
	// Incomplete means a recursive search reached a time, entry, or result limit,
	// or could not inspect a directory or matching entry. Returned matches remain usable.
	Incomplete bool `json:"incomplete,omitempty"`
}

type CancelReleaseWorkflowRequest struct {
	ReleaseWorkflowCommandContext
	Reason string `json:"reason,omitempty"`
}

type CanonicalCategory string

type CaptureReleaseWorkflowMediaRequest struct {
	ReleaseWorkflowCommandContext
	Instructions MediaCaptureInstructions `json:"instructions"`
}

type Category string

type CheckReleaseWorkflowDuplicatesRequest struct {
	ReleaseWorkflowCommandContext
	SkipRemote bool `json:"skipRemote"`
}

type ClientInjectionOutcome struct {
	Status   StageStatus       `json:"status"`
	Message  string            `json:"message,omitempty"`
	Failures []WorkflowFailure `json:"failures,omitempty"`
}

type ClientInjectionRetryRef struct {
	Result     UploadResultRef `json:"result"`
	TrackerIDs []TrackerID     `json:"trackerIds"`
}

type ClientOverrides struct {
	Client       *string
	QbitCategory *string
	QbitTag      *string
	ForceRecheck *bool
}

type ClientSearchPolicy struct {
	// Skip disables torrent-client discovery for this preparation.
	Skip bool
	// Client optionally selects one configured client; nil uses normal client selection.
	Client *string
}

type ClientSearchResult struct {
	InfoHash            string
	TrackerIDs          map[string]string
	FoundTrackerMatch   bool
	TorrentComments     []TorrentMatch
	PieceSizeConstraint string
	FoundPreferredPiece string
	MatchedTrackers     []string
	TorrentPath         string
	// TorrentDataVerified reports that TorrentPath was selected from a complete
	// client record whose content path exactly matched the searched source.
	TorrentDataVerified bool
}

type ClientService interface {
	Inject(ctx context.Context, subject ClientSubject, torrent TorrentResult) error
	SearchPathedTorrents(ctx context.Context, subject ClientSubject) (ClientSearchResult, error)
}

type ClientSubject struct {
	SourcePath      string
	FileList        []string
	DiscType        string
	ClientOverrides ClientOverrides
}

type Config interface {
	Validate() error
}

type ConfigActivation struct {
	Status            ConfigActivationStatus      `json:"status"`
	ActivationID      string                      `json:"activationId,omitzero"`
	ActiveGeneration  uint64                      `json:"activeGeneration"`
	Fingerprint       WorkflowFingerprint         `json:"-"`
	PendingGeneration uint64                      `json:"pendingGeneration,omitzero"`
	FailureCode       ConfigActivationFailureCode `json:"failureCode,omitzero"`
	Impacts           []ConfigImpact              `json:"impacts"`
	UpdatedAt         time.Time                   `json:"updatedAt"`
}

type ConfigActivationAuthority struct {
	Generation  uint64
	Fingerprint WorkflowFingerprint
}

type ConfigActivationFailureCode string

type ConfigActivationPendingError struct {
	Activation ConfigActivation
}

type ConfigActivationStatus string

type ConfigImpact string

type ConfigImpactDetail struct {
	Kind       ConfigImpact `json:"kind"`
	TrackerIDs []TrackerID  `json:"trackerIds,omitempty"`
}

type ContentBinding struct {
	SourceFingerprint string            `json:"sourceFingerprint"`
	Category          CanonicalCategory `json:"category"`
	ProviderIDs       ProviderIDSet     `json:"providerIds"`
}

type ContinueReleaseWorkflowRequest struct {
	Authority       *WorkflowAuthority     `json:"authority,omitempty"`
	IdempotencyKey  string                 `json:"idempotencyKey"`
	Goal            WorkflowGoal           `json:"goal"`
	Intent          WorkflowIntent         `json:"intent"`
	Answers         []RequiredActionAnswer `json:"answers,omitempty"`
	TrackerApproval *TrackerApproval       `json:"trackerApproval,omitempty"`
	// Deprecated: final upload approval is no longer required by runtime workflows.
	Approval *UploadApproval `json:"approval,omitempty"`
}

type CoreDependencies struct {
	// LiveTest is process-owned and must survive configuration activation.
	LiveTest *LiveTestPolicy
	// Config is validated before the core is created.
	Config Config
	// Logger receives core initialization and runtime messages. Nil uses NopLogger.
	Logger Logger
	// Services supplies optional service overrides; zero values use the core defaults.
	Services ServiceSet
	// Repository supplies immutable borrowed persistence capabilities. Its zero
	// value opens and owns a SQLite repository from Config.
	Repository RepositoryCapabilities
	// RepositoryOwner identifies the externally owned adapter used to build
	// Repository. It remains borrowed and is used only for owner-specific setup.
	RepositoryOwner RepositoryOwner
	// SkipCookieMigration skips legacy cookie migration for callers that already
	// synchronize cookie encryption state with the shared repository.
	SkipCookieMigration bool
	// EnforceConfigActivationGeneration fences workflow admission against the
	// durable active config generation owned by the WebUI runtime host.
	EnforceConfigActivationGeneration bool
	// ConfigActivationGeneration is the durable generation this Core was built
	// to serve when EnforceConfigActivationGeneration is enabled.
	ConfigActivationGeneration uint64
	// ConfigActivationFingerprint is the private effective-config fingerprint
	// expected for ConfigActivationGeneration. It never enters public state.
	ConfigActivationFingerprint WorkflowFingerprint
}

type CorrectionConfirmation struct {
	Revision         uint64                             `json:"revision"`
	Fields           []CorrectionField                  `json:"fields"`
	PreviousBindings map[CorrectionField]ContentBinding `json:"previousBindings"`
	CurrentBinding   ContentBinding                     `json:"currentBinding"`
}

type CorrectionConflictError struct {
	Field   CorrectionField
	TrackID string
	Reason  string
}

type CorrectionField string

type CorrectionFieldRef struct {
	Field   CorrectionField `json:"field"`
	TrackID string          `json:"trackId,omitempty"`
}

type CorrectionRevisionConflictError struct {
	Expected uint64
	Actual   uint64
}

type CreateReleaseWorkflowRequest struct {
	Instructions   ReleaseFactInstructions `json:"instructions"`
	IdempotencyKey string                  `json:"idempotencyKey"`
}

type CreateReleaseWorkflowUploadRequest struct {
	// Authority continues an already-open input without repeating source verification.
	Authority              *WorkflowAuthority                `json:"authority,omitempty"`
	Source                 ReleaseWorkflowUploadSource       `json:"source"`
	Unattended             *ReleaseWorkflowUploadUnattended  `json:"unattended"`
	Execution              ReleaseWorkflowUploadExecution    `json:"execution,omitempty"`
	Trackers               ReleaseWorkflowUploadTrackers     `json:"trackers,omitempty"`
	Preparation            ReleaseWorkflowUploadPreparation  `json:"preparation,omitempty"`
	Duplicates             ReleaseWorkflowUploadDuplicates   `json:"duplicates,omitempty"`
	HDRComparisonSelection *HDRComparisonSelection           `json:"hdrComparisonSelection,omitempty"`
	HDRAnalysis            *HDRAnalysisRequest               `json:"hdrAnalysis,omitempty"`
	Media                  ReleaseWorkflowUploadMedia        `json:"media,omitempty"`
	Descriptions           ReleaseWorkflowUploadDescriptions `json:"descriptions,omitempty"`
	ImageHosting           ReleaseWorkflowUploadImageHosting `json:"imageHosting,omitempty"`
	Client                 ReleaseWorkflowUploadClient       `json:"client,omitempty"`
	Torrent                ReleaseWorkflowUploadTorrent      `json:"torrent,omitempty"`
	IdempotencyKey         string                            `json:"-"`
}

type DVDMediaInfo struct {
	SourcePath      string
	IFOPath         string
	VOBPath         string
	VOBSet          string
	Width           int
	Height          int
	FrameRate       string
	ScanType        string
	Resolution      string
	HighFrameRate   bool
	MediaInfoJSON   string
	MediaInfoText   string
	VOBMediaInfoRaw string
	UpdatedAt       time.Time `ts_type:"string"`
}

type DVDMenuCapabilityProvider interface {
	// DVDMenuCapability probes the current FFmpeg executable without exposing its path.
	DVDMenuCapability(ctx context.Context) (DVDMenuEngineInfo, error)
}

type DVDMenuCaptureImage struct {
	// ScreenshotImage contains the persisted local image metadata.
	ScreenshotImage
	// Discovery records whether navigation or structural inventory found the screen.
	Discovery DVDMenuDiscovery
}

type DVDMenuCaptureResult struct {
	// SourcePath is the host filesystem path of the prepared DVD source.
	SourcePath string
	// Images contains captures persisted for SourcePath in display order.
	Images []DVDMenuCaptureImage
	// SelectedLanguage is the menu language requested from the DVD engine.
	SelectedLanguage string
	// Region is the DVD region selection used for capture; zero means no override.
	Region int
	// DiscoveredMenus is the number of structurally inventoried menu programs.
	DiscoveredMenus int
	// VisitedStates is the number of distinct VM states evaluated during traversal.
	VisitedStates int
	// VisitedButtons is the number of authored button commands evaluated.
	VisitedButtons int
	// MaxItems is the configured upper bound on persisted automatic captures.
	MaxItems int
	// Complete reports that every selected screen was captured without coverage warnings.
	Complete bool
	// Partial reports that warnings prevented complete navigation or rendering coverage.
	Partial bool
	// Truncated reports that MaxItems prevented one or more eligible captures.
	Truncated bool
	// Warnings contains deduplicated, stable, path-free coverage diagnostics.
	Warnings []DVDMenuCaptureWarning
	// Engine describes the pure-Go engine and FFmpeg capability used for capture.
	Engine DVDMenuEngineInfo
}

type DVDMenuCaptureWarning struct {
	// DiscID identifies the uncovered prepared disc when applicable.
	DiscID string
	// DiscName is the safe page-facing label for the uncovered disc.
	DiscName string
	// Code is a stable machine-readable warning identifier.
	Code string
	// Message is a redacted user-facing description of the incomplete coverage.
	Message string
}

type DVDMenuDiscSubject struct {
	ID   string
	Name string
	Root string
}

type DVDMenuDiscovery string

type DVDMenuEngineInfo struct {
	// EngineVersion identifies the bundled pure-Go DVD navigation engine.
	EngineVersion string
	// SchemaVersion identifies the capture metadata contract version.
	SchemaVersion int
	// SupportedFeatures lists the engine stages available in this build.
	SupportedFeatures []string
	// FFmpegVersion is the bounded first line of FFmpeg version output.
	FFmpegVersion string
	// FFmpegDVDVideo reports whether the required dvdvideo demuxer options are available.
	FFmpegDVDVideo bool
	// MissingFFmpegOptions lists required dvdvideo options absent from the probe.
	MissingFFmpegOptions []string
}

type DVDMenuProgressReporter func(update DVDMenuProgressUpdate)

type DVDMenuProgressUpdate struct {
	// Phase is a stable capture stage such as preflight, discovering, capturing, or persisting.
	Phase string `json:"phase"`
	// Message is a user-facing summary of the current phase.
	Message string `json:"message"`
	// DiscoveredMenus is the current structural inventory count.
	DiscoveredMenus int `json:"discoveredMenus"`
	// VisitedStates is the current count of evaluated VM states.
	VisitedStates int `json:"visitedStates"`
	// VisitedButtons is the current count of evaluated button commands.
	VisitedButtons int `json:"visitedButtons"`
	// CapturedCount is the number of rendered menu images so far.
	CapturedCount int `json:"capturedCount"`
	// WarningCount is the number of distinct coverage warnings so far.
	WarningCount int `json:"warningCount"`
}

type DVDMenuService interface {
	// Capture replaces automatic captures up to maxItems while preserving manual menus.
	Capture(ctx context.Context, subject DVDMenuSubject, maxItems int) (DVDMenuCaptureResult, error)
	// List returns persisted manual and automatic menu images in selection order.
	List(ctx context.Context, subject DVDMenuSubject) ([]ScreenshotImage, error)
	// Delete removes one managed menu image and its local repository references.
	Delete(ctx context.Context, subject DVDMenuSubject, imagePath string) error
	// Capability reports path-free engine and FFmpeg dvdvideo support.
	Capability(ctx context.Context) (DVDMenuEngineInfo, error)
}

type DVDMenuSubject struct {
	MediaBinding PreparedMediaBinding
	SourcePath   string
	DiscType     string
	Discs        []DVDMenuDiscSubject
}

type DecideReleaseWorkflowDuplicatesRequest struct {
	// StaffTokenConfirmations binds each staff-required ignored decision to the
	// current assessment ID; stale or absent confirmation cannot authorize an override.
	StaffTokenConfirmations map[TrackerID]DupeAssessmentID `json:"staffTokenConfirmations,omitempty"`
	ReleaseWorkflowCommandContext
	Decisions map[TrackerID]DupeDecision `json:"decisions"`
}

type DeleteReleaseWorkflowMediaRequest struct {
	ReleaseWorkflowCommandContext
	Media       MediaArtifactSetRef `json:"media"`
	ArtifactIDs []PublicResourceID  `json:"artifactIds"`
}

type DescriptionBuilderGroup struct {
	GroupKey           string
	Trackers           []string
	Description        string
	DescriptionHTML    string
	RawDescription     string
	RawDescriptionHTML string
	HasOverride        bool
	// Final marks complete edited output whose generated sections must not be rebuilt.
	Final     bool
	ImageHost ImageHostFeedback
}

type DescriptionBuilderPreview struct {
	SourcePath      string
	Groups          []DescriptionBuilderGroup
	ContentFailures []TrackerContentFailure
}

type DescriptionImageHostStatus struct {
	Trackers  []string
	ImageHost ImageHostFeedback
}

type DescriptionInput struct {
	Release           ReleaseRef
	Trackers          []string
	GroupKey          string
	Groups            []DescriptionBuilderGroup
	ImageHost         ImageHostOverrides
	QuestionnaireData map[string]map[string]string
	Options           UploadOptions
}

type DescriptionInstructions struct {
	Overrides            []DescriptionOverrideInput      `json:"overrides,omitempty"`
	QuestionnaireAnswers map[TrackerID]map[string]string `json:"questionnaireAnswers,omitempty"`
	Options              UploadOptions                   `json:"options"`
	ImageHost            ImageHostOverrides              `json:"imageHost"`
	TrackerConfig        TrackerConfigOverrides          `json:"trackerConfig,omitempty"`
	TrackerSite          TrackerSiteOverrides            `json:"trackerSite,omitempty"`
	Client               ClientOverrides                 `json:"client,omitempty"`
	Torrent              TorrentOverrides                `json:"torrent,omitempty"`
	TemplateVersion      string                          `json:"templateVersion,omitempty"`
}

type DescriptionOverride struct {
	SourcePath  string
	GroupKey    string
	Description string
	UpdatedAt   time.Time `ts_type:"string"`
}

type DescriptionOverrideInput struct {
	GroupKey string `json:"groupKey"`
	Source   string `json:"source"`
	// Final preserves saved editor output instead of composing generated sections again.
	Final bool `json:"final,omitempty"`
	// TrackerIDs binds a saved composite group to its original tracker members.
	// Omitted membership retains the group-wide behavior of custom input notes.
	TrackerIDs []TrackerID `json:"trackerIds,omitempty"`
}

type DescriptionOverrideMutation struct {
	Descriptions DescriptionSetRef `json:"descriptions"`
	GroupKey     string            `json:"groupKey"`
	Source       string            `json:"source"`
}

type DescriptionReuseRepository interface {
	LoadReusableDescription(context.Context, string) (ReusableDescription, bool, error)
}

type DescriptionSet struct {
	// HDRArtifacts is server-owned evidence from this exact description generation.
	HDRArtifacts        map[TrackerID][]HDRArtifactEvidence `json:"hdrArtifacts,omitempty"`
	ID                  DescriptionSetID                    `json:"id"`
	WorkflowID          WorkflowID                          `json:"workflowId"`
	Revision            WorkflowRevision                    `json:"revision"`
	Release             ReleaseSnapshotRef                  `json:"release"`
	ReleaseRef          ReleaseRef                          `json:"releaseRef"`
	ProjectionSet       TrackerReleaseProjectionSetRef      `json:"projectionSet"`
	TrackerApproval     *TrackerApprovalSnapshotRef         `json:"trackerApproval,omitempty"`
	Media               *MediaArtifactSetRef                `json:"media,omitempty"`
	InputFingerprint    WorkflowFingerprint                 `json:"inputFingerprint"`
	TemplateFingerprint WorkflowFingerprint                 `json:"templateFingerprint"`
	Descriptions        []RenderedDescription               `json:"descriptions"`
	TrackerResults      []DescriptionTrackerResult          `json:"trackerResults,omitempty"`
	Status              StageStatus                         `json:"status"`
	RequiredActions     []RequiredAction                    `json:"requiredActions,omitempty"`
	Failures            []WorkflowFailure                   `json:"failures,omitempty"`
	CreatedAt           time.Time                           `json:"createdAt" ts_type:"string"`
}

type DescriptionSetID string

type DescriptionSetRef struct {
	ID       DescriptionSetID `json:"id"`
	Revision WorkflowRevision `json:"revision"`
}

type DescriptionSubject struct {
	// SuppressImportedScreenshotReferences preserves exact user selections during composition.
	SuppressImportedScreenshotReferences map[string]bool `json:"-"`
	TrackerHDRArtifacts                  map[string][]HDRArtifactEvidence
	VideoCodec                           string
	HasEncodeSettings                    bool
	TrackerQuestionnaireAnswers          map[string]map[string]string
	EffectiveMetadata                    EffectiveMetadata
	ManualLanguages                      ManualLanguageFacts
	HardcodedSubs                        bool
	HardcodedSubtitleLanguages           []string
	HardcodedSubtitleCoverage            []SubtitleLanguageCoverage
	MediaBinding                         PreparedMediaBinding
	SourcePath                           string
	DiscType                             string
	MediaInfoTextPath                    string
	DVDVOBMediaInfoText                  string
	DescriptionTemplate                  string
	DescriptionGroups                    []DescriptionBuilderGroup
	EpisodeOverview                      string
	Options                              UploadOptions
	Release                              ReleaseInfo
	SelectedBDMVPlaylists                []PlaylistInfo
	Disc                                 DiscFacts
	Discs                                []DiscEvidenceResource
	Tag                                  string
	Identity                             ExternalIdentity
	ProviderMetadata                     SourceScopedMetadata
	SeasonInt                            int
	EpisodeInt                           int
	Filename                             string
	ReleaseName                          string
	ReleaseNameNoTag                     string
	ServiceLongName                      string
	Type                                 string
	HDR                                  string
	ArrReleaseGroup                      string
	Trackers                             []string
	TrackerConfig                        TrackerConfigOverrides
	TrackerSite                          TrackerSiteOverrides
	ImageHost                            ImageHostOverrides
	TrackerData                          []TrackerMetadata
	ExactMedia                           *ExactMediaAssets
}

type DescriptionTrackerResult struct {
	TrackerID TrackerID   `json:"trackerId"`
	Status    StageStatus `json:"status"`
	Message   string      `json:"message,omitempty"`
}

type DiagnosticSeverity string

type DiscEvidenceResource struct {
	ID                  string
	Name                string
	Type                string
	Root                string
	SelectedPlaylists   []PlaylistInfo
	VideoPath           string
	FileList            []string
	Reports             []DiscReportResource
	MediaInfoJSONPath   string
	MediaInfoTextPath   string
	DVDIFOPath          string
	DVDVOBPath          string
	DVDVOBSet           string
	DurationSeconds     float64
	DVDVOBMediaInfoJSON string
	DVDVOBMediaInfoText string
}

type DiscFacts struct {
	Type            string
	Summary         string
	DurationSeconds float64
	PlaylistCount   int
	DVDVOBSet       string
	PrimaryDiscID   string
	PrimaryReportID string
	Items           []DiscItemFacts
}

type DiscItemFacts struct {
	ID              string
	Name            string
	Type            string
	Reports         []DiscReportFacts
	DurationSeconds float64
	DVDVOBSet       string
}

type DiscMenuDeleteResult struct {
	// Selection is the deleted manual or automatic menu selection.
	Selection ScreenshotFinalSelection
	// Screenshot is the deleted local screenshot record when one existed.
	Screenshot *Screenshot
	// UploadedImages are deleted local upload records. Remote assets are unchanged.
	UploadedImages []UploadedImageLink
	// ScreenshotSlots are deleted slot records whose selected image was removed.
	ScreenshotSlots []ScreenshotSlot
	// ScreenshotSlotVariants are variants deleted with a slot or because they
	// referenced the removed image.
	ScreenshotSlotVariants []ScreenshotSlotVariant
	// UploadedLinks counts local upload records removed with the selection.
	UploadedLinks int
}

type DiscReportFacts struct {
	Playlist PlaylistInfo
	Summary  string
	// HDR10PlusConfirmed records native HDR10+ confirmation for this selected timeline.
	HDR10PlusConfirmed bool
}

type DiscReportResource struct {
	Playlist        PlaylistInfo
	Summary         string
	ExtSummary      string
	FullSummary     string
	SummaryPath     string
	ExtSummaryPath  string
	FullSummaryPath string
}

type DryRunReleaseWorkflowRequest struct {
	ReleaseWorkflowCommandContext
	NoSeed     bool        `json:"noSeed"`
	TrackerIDs []TrackerID `json:"trackerIds,omitempty"`
}

type DupeAssessment struct {
	ID               DupeAssessmentID               `json:"id"`
	WorkflowID       WorkflowID                     `json:"workflowId"`
	Revision         WorkflowRevision               `json:"revision"`
	Release          ReleaseSnapshotRef             `json:"release"`
	ReleaseRef       ReleaseRef                     `json:"releaseRef"`
	Selection        TrackerSelectionRef            `json:"selection"`
	ProjectionSet    TrackerReleaseProjectionSetRef `json:"projectionSet"`
	Preflight        *TrackerPreflightAssessmentRef `json:"preflight,omitempty"`
	InputFingerprint WorkflowFingerprint            `json:"inputFingerprint"`
	CheckOrdinal     uint8                          `json:"checkOrdinal,omitempty"`
	Results          []TrackerDupeAssessment        `json:"results"`
	Status           StageStatus                    `json:"status"`
	CreatedAt        time.Time                      `json:"createdAt" ts_type:"string"`
	ExpiresAt        time.Time                      `json:"expiresAt" ts_type:"string"`
}

type DupeAssessmentEvidence interface {
	Apply(*DuplicateSubject)
	MarshalBinary() ([]byte, error)
}

type DupeAssessmentID string

type DupeAssessmentRef struct {
	ID       DupeAssessmentID `json:"id"`
	Revision WorkflowRevision `json:"revision"`
}

type DupeCandidateEvaluation struct {
	EvidenceFingerprint WorkflowFingerprint `json:"evidenceFingerprint,omitempty"`

	ID             string            `json:"id,omitempty"`
	Name           string            `json:"name"`
	Link           string            `json:"link,omitempty"`
	SizeBytes      int64             `json:"sizeBytes,omitempty"`
	Relation       DupeRelation      `json:"relation"`
	Reasons        []DupeReason      `json:"reasons"`
	Flags          []string          `json:"flags,omitempty"`
	HDR            HDRFacts          `json:"hdr"`
	Category       string            `json:"category,omitempty"`
	Type           string            `json:"type,omitempty"`
	Resolution     string            `json:"resolution,omitempty"`
	Source         string            `json:"source,omitempty"`
	Codec          string            `json:"codec,omitempty"`
	Container      string            `json:"container,omitempty"`
	Provider       string            `json:"provider,omitempty"`
	Group          string            `json:"group,omitempty"`
	ReleaseOrigin  string            `json:"releaseOrigin,omitempty"`
	Edition        string            `json:"edition,omitempty"`
	Region         string            `json:"region,omitempty"`
	ThreeD         string            `json:"threeD,omitempty"`
	Repack         string            `json:"repack,omitempty"`
	Season         int               `json:"season,omitempty"`
	Episode        int               `json:"episode,omitempty"`
	Date           string            `json:"date,omitempty"`
	Pack           bool              `json:"pack"`
	Internal       bool              `json:"internal"`
	Trumpable      bool              `json:"trumpable"`
	EvidenceStatus HDREvidenceStatus `json:"evidenceStatus"`
}

type DupeCheckResult struct {
	// RequiresStaffToken requires explicit owner attestation before overriding
	// duplicate or incomplete-search evidence; it carries no token contents.
	RequiresStaffToken    bool
	Tracker               string
	CanonicalReleaseName  string
	UploadReleaseName     string
	ProjectionFingerprint WorkflowFingerprint
	CriteriaFingerprint   WorkflowFingerprint
	ProjectionStatus      ReadinessStatus
	PolicyID              string
	PolicyFingerprint     WorkflowFingerprint
	TargetFingerprint     WorkflowFingerprint
	SearchFingerprint     WorkflowFingerprint
	Search                DupeSearchEvidence
	Evaluations           []DupeCandidateEvaluation
	// ReviewReasons require target-level policy acknowledgement, even without candidates.
	ReviewReasons []DupeReason
	HasDupes      bool
	Notes         []string
	Skipped       bool
	SkipReason    string
	// SkipCode is a stable machine-readable skip reason.
	SkipCode  string
	Status    string
	Error     string
	CheckedAt time.Time `ts_type:"string"`
}

type DupeCheckSummary struct {
	SourcePath string
	Results    []DupeCheckResult
	Notes      []string
}

type DupeComparisonEvidence struct {
	CandidateID          string              `json:"candidateId,omitempty"`
	CandidateFingerprint WorkflowFingerprint `json:"candidateFingerprint,omitempty"`
	Candidate            DupeReleaseEvidence `json:"candidate"`
	VisualImprovement    bool                `json:"visualImprovement,omitempty"`
	MeaningfulBenefit    string              `json:"meaningfulBenefit,omitempty"`
	Quality              string              `json:"quality,omitempty"`
	DefectImproved       bool                `json:"defectImproved,omitempty"`
	Replacement          string              `json:"replacement,omitempty"`
	Reviewed             bool                `json:"reviewed,omitempty"`
	Source               string              `json:"source,omitempty"`
}

type DupeDecision string

type DupeEntry struct {
	Evidence DupeReleaseEvidence
	// EnglishSubtitles records positive inspected subtitle-language evidence, never a title inference.
	EnglishSubtitles      bool
	EnglishSubtitlesKnown bool

	// TrackerSlot is opaque tracker-native slot evidence, which may be partial.
	TrackerSlot   string
	Name          string
	SizeBytes     int64
	SizeKnown     bool
	SizeText      string
	Files         []string
	FileCount     int
	Trumpable     bool
	Link          string
	Download      string
	Flags         []string
	FlagsPresent  bool
	FlagsComplete bool
	HDR           HDRFacts
	ID            string
	Type          string
	CanonicalType string
	Res           string
	Category      string
	Source        string
	Codec         string
	Container     string
	Provider      string
	ProviderIDs   []TrackerProviderID
	Group         string
	ReleaseOrigin string
	Edition       string
	Region        string
	ThreeD        string
	Repack        string
	Attributes    map[string]string
	Season        int
	Episode       int
	Pack          bool
	Internal      bool
	MediaInfo     string
	BDInfo        string
	Description   string
}

type DupeEpisodeMatch struct {
	ID       string
	Name     string
	Link     string
	Tracker  string
	Internal bool
}

type DupeEvidenceContext struct {
	// SlotEvidenceComplete requires authoritative work, content, resolution, media kind and HDR facts.
	SlotEvidenceComplete bool
	Target               TrackerDuplicateTarget
	Candidate            TrackerDuplicateTarget
	CandidateID          string
	CandidateFingerprint WorkflowFingerprint
	Trumpable            bool
	Relation             DupeRelation
	Reason               string
}

type DupeEvidenceDecision struct {
	Relation DupeRelation
	Reason   string
}

type DupeMatch struct {
	FilenameMatch             string
	FileCountMatch            int
	SizeMatch                 string
	TrumpableID               string
	MatchedID                 string
	MatchedName               string
	MatchedLink               string
	MatchedDownload           string
	MatchedReason             string
	SeasonPackExists          bool
	SeasonPackName            string
	SeasonPackLink            string
	SeasonPackID              string
	SeasonPackContainsEpisode bool
	MatchedEpisodeIDs         []DupeEpisodeMatch
}

type DupeMatchProjection struct {
	EvidenceFingerprint WorkflowFingerprint `json:"evidenceFingerprint,omitempty"`
	ID                  string              `json:"id,omitempty"`
	Name                string              `json:"name"`
	Link                string              `json:"link,omitempty"`
	SizeBytes           int64               `json:"sizeBytes,omitempty"`
	Flags               []string            `json:"flags,omitempty"`
	Reason              string              `json:"reason,omitempty"`
	Relation            DupeRelation        `json:"relation,omitempty"`
	Reasons             []DupeReason        `json:"reasons,omitempty"`
	HDR                 HDRFacts            `json:"hdr"`
	Category            string              `json:"category,omitempty"`
	Type                string              `json:"type,omitempty"`
	Resolution          string              `json:"resolution,omitempty"`
	Source              string              `json:"source,omitempty"`
	Codec               string              `json:"codec,omitempty"`
	Container           string              `json:"container,omitempty"`
	Provider            string              `json:"provider,omitempty"`
	Group               string              `json:"group,omitempty"`
	ReleaseOrigin       string              `json:"releaseOrigin,omitempty"`
	Edition             string              `json:"edition,omitempty"`
	Region              string              `json:"region,omitempty"`
	ThreeD              string              `json:"threeD,omitempty"`
	Repack              string              `json:"repack,omitempty"`
	Season              int                 `json:"season,omitempty"`
	Episode             int                 `json:"episode,omitempty"`
	Date                string              `json:"date,omitempty"`
	Pack                bool                `json:"pack"`
	Internal            bool                `json:"internal"`
	Trumpable           bool                `json:"trumpable"`
	EvidenceStatus      HDREvidenceStatus   `json:"evidenceStatus,omitempty"`
}

type DupeProgressReporter func(update DupeProgressUpdate)

type DupeProgressUpdate struct {
	SourcePath string          `json:"sourcePath"`
	Tracker    string          `json:"tracker"`
	Status     string          `json:"status"`
	Message    string          `json:"message"`
	Completed  int             `json:"completed"`
	Total      int             `json:"total"`
	Result     DupeCheckResult `json:"result"`
}

type DupeReason struct {
	Code    string `json:"code"`
	Message string `json:"message,omitempty"`
}

type DupeRelation string

type DupeReleaseEvidence struct {
	PersonalRelease bool   `json:"personalRelease,omitempty"`
	InternalStatus  string `json:"internalStatus,omitempty"`
	Group           string `json:"group,omitempty"`
	BackCatalogue   string `json:"backCatalogue,omitempty"`
	HDRLayerSource  string `json:"hdrLayerSource,omitempty"`
	DiscIdentity    string `json:"discIdentity,omitempty"`
	DiscForm        string `json:"discForm,omitempty"`
}

type DupeSearchEvidence struct {
	Complete       bool   `json:"complete"`
	Pages          int    `json:"pages"`
	CandidateCount int    `json:"candidateCount"`
	Scope          string `json:"scope,omitempty"`
	// WorkScope reports how the search was bound to one work
	// (provider_id, tracker_group, or title_fallback).
	WorkScope string `json:"workScope,omitempty"`
	// WrongWorkCount is the number of returned rows excluded because they
	// belonged to a conflicting work.
	WrongWorkCount int      `json:"wrongWorkCount,omitempty"`
	Warnings       []string `json:"warnings,omitempty"`
}

type DuplicateCheckInput struct {
	Release        ReleaseRef
	Trackers       []string
	Interaction    InteractionMode
	IgnoreFor      []string
	Skip           bool
	SkipAsActual   bool
	DoubleCheck    bool
	Authorizations []string
	// TrackerIDs contains explicit tracker IDs that override discovered client evidence.
	TrackerIDs map[string]string
}

type DuplicateSubject struct {
	EffectiveMetadata    EffectiveMetadata
	SourcePath           string
	SourceSize           int64
	VideoPath            string
	FileList             []string
	Filename             string
	SceneName            string
	ReleaseName          string
	Release              ReleaseInfo
	ReleaseNameOverrides ReleaseNameOverrides
	Identity             ExternalIdentity
	ProviderMetadata     SourceScopedMetadata
	TrackerIDs           map[string]string
	DiscType             string
	Disc                 DiscFacts
	Type                 string
	Source               string
	Tag                  string
	HDR                  string
	HDRFacts             HDRFacts
	UHD                  string
	VideoEncode          string
	VideoCodec           string
	HasEncodeSettings    bool
	SeasonInt            int
	EpisodeInt           int
	SeasonStr            string
	EpisodeStr           string
	DailyEpisodeDate     string
	TVPack               bool
	Anime                bool
	MatchedTrackers      []string
	TrackerRuleFailures  map[string][]RuleFailure
	BlockedTrackers      map[string][]TrackerBlockReason
	CrossSeedTorrents    []UploadedTorrent
	// Projection is the exact safe tracker-local interpretation used for this search.
	Projection *TrackerReleaseProjection
}

type EditionDisplayPart struct {
	Text    string
	Feature ReleaseFeature `json:",omitempty"`
}

type EffectiveMetadata struct {
	Title                      string
	AlternateTitle             string
	OriginalTitle              string
	Year                       int
	Genres                     []string
	OriginalLanguage           string
	Distributor                string
	TitleProvenance            FactProvenance
	AlternateTitleProvenance   FactProvenance
	OriginalTitleProvenance    FactProvenance
	YearProvenance             FactProvenance
	GenresProvenance           FactProvenance
	OriginalLanguageProvenance FactProvenance
	DistributorProvenance      FactProvenance
}

type EncodeSettingsStatus string

type EpisodeFacts struct {
	Season  int
	Episode int
	// MultipleEpisodes retains known combined or conflicting source episode membership.
	MultipleEpisodes  bool
	SeasonLabel       string
	EpisodeLabel      string
	DailyDate         string
	Pack              bool
	Title             string
	Overview          string
	Year              int
	AiredDate         string
	AirDays           []string
	AirTime           string
	AirTimezone       string
	AirTimezoneSource string
	DateMatched       bool
}

type EpisodeTitleMode string

type ExactMediaAssets struct {
	// ImageHostUploadSkipped preserves the workflow's explicit upload opt-out.
	// Compatible cached links remain usable, but missing variants must not trigger uploads.
	ImageHostUploadSkipped bool
	HDRAnalysis            *HDRAnalysisRef
	HDRPlots               []HDRDescriptionPlot
	HDRStats               []HDRDescriptionStats
	HDRUploads             []UploadedImageLink
	HDRUploadHosts         map[string]string
	Screenshots            []ScreenshotImage
	DVDMenus               []DVDMenuCaptureImage
	ScreenshotUploads      []UploadedImageLink
	DVDMenuUploads         []UploadedImageLink
	AudioAnalysis          *AudioAnalysisRef
	AudioTracks            []AudioDescriptionTrack
	AudioUploads           []UploadedImageLink
	AudioUploadHosts       map[string]string
}