api

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 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"`
	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 {
	Status MetadataEvidenceStatus
	Ready  bool
	Count  int
}

type AssetFacts struct {
	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 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
}

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       string `json:"path"`
	IsDir      bool   `json:"isDir"`
	Size       int64  `json:"size"`
	ModifiedAt string `json:"modifiedAt"`
}

type BrowseDirectoryRequest struct {
	Path string `json:"path"`
	Mode string `json:"mode"`
}

type BrowseDirectoryResponse struct {
	CurrentPath string                 `json:"currentPath"`
	ParentPath  string                 `json:"parentPath"`
	Mode        string                 `json:"mode"`
	Entries     []BrowseDirectoryEntry `json:"entries"`
}

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 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
}

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 {
	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"`
	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 {
	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
	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"`
}

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

type DescriptionSet struct {
	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 {
	EffectiveMetadata          EffectiveMetadata
	ManualLanguages            ManualLanguageFacts
	HardcodedSubs              bool
	HardcodedSubtitleLanguages []string
	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
}

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 {
	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 {
	Tracker               string
	CanonicalReleaseName  string
	UploadReleaseName     string
	ProjectionFingerprint WorkflowFingerprint
	CriteriaFingerprint   WorkflowFingerprint
	ProjectionStatus      ReadinessStatus
	PolicyID              string
	PolicyFingerprint     WorkflowFingerprint
	TargetFingerprint     WorkflowFingerprint
	SearchFingerprint     WorkflowFingerprint
	Search                DupeSearchEvidence
	Evaluations           []DupeCandidateEvaluation
	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 DupeDecision string

type DupeEntry struct {
	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
	BDInfo        string
	Description   string
}

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

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 {
	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 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 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
	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 {
	Screenshots       []ScreenshotImage
	DVDMenus          []DVDMenuCaptureImage
	ScreenshotUploads []UploadedImageLink
	DVDMenuUploads    []UploadedImageLink
}

type ExecutionOptions struct {
	QueueName         string
	QueueLimit        int
	SiteCheck         bool
	SiteUploadTracker string
}

type ExternalIDInfo struct {
	Provider string
	ID       int
	Source   string
}

type ExternalIDOverrides struct {
	TMDBID   *int
	IMDBID   *int
	TVDBID   *int
	TVmazeID *int
	// MALID carries caller intent for the canonical MAL/AniList-compatible
	// anime identifier. Nil leaves resolution unchanged; zero clears it.
	MALID *int
}

type ExternalIdentity struct {
	SourcePath   string
	Generation   PreparedGeneration
	TMDBID       int
	IMDBID       int
	TVDBID       int
	TVmazeID     int
	MALID        int
	Category     CanonicalCategory
	Provenance   IdentityProvenanceSet
	Overrides    IdentityOverrideState
	Conflict     IdentityConflictStatus
	Resolution   IdentityResolutionKey
	Dependencies IdentityDependencySet
	ResolvedAt   time.Time `ts_type:"string"`
}

type ExternalIdentityCandidate struct {
	Provider      IdentityProvider
	ID            int
	Title         string
	OriginalTitle string
	Year          int
	Category      CanonicalCategory
	MediaType     string
	Overview      string
	PosterURL     string
	Similarity    float64
}

type FactProvenance string

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

type FileMetadata struct {
	Path       string
	InfoHash   string
	UpdatedAt  time.Time `ts_type:"string"`
	DiscType   string
	VideoPath  string
	FileList   []string
	SourceSize int64
	Scene      bool
	SceneName  string
	SceneIMDB  int
	// Category is the normalized movie/TV content category that drives upload
	// logic. It is seeded from release parsing but should be overridden by a
	// supported TrackerMetadata.Category when that value is available, since a
	// site-reported movie/TV category is the authoritative classification for
	// the upload.
	Category   Category
	Type       string
	Artist     string
	Title      string
	Subtitle   string
	Alt        string
	Year       int
	Month      int
	Day        int
	Source     string
	Resolution string
	Codec      []string
	Audio      []string
	HDR        []string
	Ext        string
	Language   []string
	Site       string
	Genre      string
	Channels   string
	Collection string
	Region     string
	Size       string
	Group      string
	Disc       string
	Edition    []string
	Other      []string
}

type FilesystemService interface {
	ValidatePaths(ctx context.Context, paths []string) ([]string, error)
}

type FramePreview struct {
	ID               PublicResourceID   `json:"id"`
	WorkflowID       WorkflowID         `json:"workflowId"`
	WorkflowRevision WorkflowRevision   `json:"workflowRevision"`
	Release          ReleaseSnapshotRef `json:"release"`
	// DiscID identifies the prepared disc used for the preview.
	DiscID string `json:"discId,omitempty"`
	// DiscName is the safe page-facing label for DiscID.
	DiscName         string    `json:"discName,omitempty"`
	TimestampSeconds float64   `json:"timestampSeconds"`
	ContentURL       string    `json:"contentUrl"`
	ExpiresAt        time.Time `json:"expiresAt" ts_type:"string"`
}

type GenerateReleaseWorkflowDescriptionsRequest struct {
	ReleaseWorkflowCommandContext
	Instructions DescriptionInstructions `json:"instructions"`
}

type GeneratedReleaseNameVariants struct {
	// IncludeEpisodeTitle retains the canonical single-episode title.
	IncludeEpisodeTitle ReleaseNameVariant
	// OmitEpisodeTitle removes only the automatically generated episode title.
	OmitEpisodeTitle ReleaseNameVariant
}

type GetReleaseWorkflowMediaPlanRequest struct {
	WorkflowID WorkflowID `json:"workflowId"`
}

type GetReleaseWorkflowRequest struct {
	WorkflowID WorkflowID `json:"workflowId"`
}

type GoalAvailability struct {
	Goal       WorkflowGoal `json:"goal"`
	Available  bool         `json:"available"`
	ReasonCode string       `json:"reasonCode,omitempty"`
	Reason     string       `json:"reason,omitempty"`
}

type HDREvidenceOrigin string

type HDREvidenceStatus string

type HDRFacts struct {
	Formats            []HDRFormat       `json:"formats,omitempty"`
	DolbyVisionProfile string            `json:"dolbyVisionProfile,omitempty"`
	FallbackFormats    []HDRFormat       `json:"fallbackFormats,omitempty"`
	Origin             HDREvidenceOrigin `json:"origin"`
	Status             HDREvidenceStatus `json:"status"`
	SourceFields       []string          `json:"sourceFields,omitempty"`
	Contradictions     []string          `json:"contradictions,omitempty"`
}

type HDRFormat string

type HistoryCleanupSnapshot struct {
	Metadata      *FileMetadata
	ArtifactPaths []string
}

type HistoryEntry struct {
	SourcePath         string
	ReleaseTitle       string
	ReleaseSource      string
	ReleaseResolution  string
	MetadataUpdatedAt  time.Time `ts_type:"string"`
	LatestUploadStatus string
	LatestUploadAt     time.Time `ts_type:"string"`
	RuleFailureCount   int
	// RuleAdvisoryCount contains non-blocking advisory rule results.
	RuleAdvisoryCount int
}

type HistoryOverview struct {
	SourcePath           string
	ReleaseTitle         string
	ReleaseSource        string
	ReleaseResolution    string
	MetadataUpdatedAt    time.Time `ts_type:"string"`
	LatestUploadStatus   string
	LatestUploadAt       time.Time `ts_type:"string"`
	StatusLabel          string
	Metadata             FileMetadata
	Release              ReleaseRef
	Identity             ExternalIdentity
	Display              PreparedReleaseDisplay
	ReleaseNameOverrides ReleaseNameOverrides
	DescriptionOverride  DescriptionOverride
	DescriptionOverrides []DescriptionOverride
	PlaylistSelection    PlaylistSelection
	TrackerMetadata      []TrackerMetadata
	TrackerRuleFailures  []TrackerRuleFailure
	Screenshots          []Screenshot
	FinalSelections      []ScreenshotFinalSelection
	UploadedImages       []UploadedImageLink
	UploadHistory        []UploadRecord
}

type HistoryRecord struct {
	Corrections          ReleaseCorrectionsSnapshot
	SourcePath           string
	ReleaseTitle         string
	ReleaseSource        string
	ReleaseResolution    string
	MetadataUpdatedAt    time.Time `ts_type:"string"`
	LatestUploadStatus   string
	LatestUploadAt       time.Time `ts_type:"string"`
	Metadata             FileMetadata
	PreparedRelease      *PreparedRelease
	ReleaseNameOverrides ReleaseNameOverrides
	DescriptionOverride  DescriptionOverride
	DescriptionOverrides []DescriptionOverride
	PlaylistSelection    PlaylistSelection
	TrackerMetadata      []TrackerMetadata
	TrackerRuleFailures  []TrackerRuleFailure
	Screenshots          []Screenshot
	FinalSelections      []ScreenshotFinalSelection
	UploadedImages       []UploadedImageLink
	UploadHistory        []UploadRecord
}

type HistoryRepository interface {
	ListHistoryEntries(ctx context.Context) ([]HistoryEntry, error)
	LoadHistoryRecord(ctx context.Context, sourcePath string) (HistoryRecord, error)
	LoadHistoryCleanupSnapshot(ctx context.Context, sourcePath string) (HistoryCleanupSnapshot, error)
	ListStoredReleasePaths(ctx context.Context) ([]string, error)
	PurgeContentData(ctx context.Context, path string) error
}

type HostedImageAttempt struct {
	ID          PublicResourceID    `json:"id"`
	Media       MediaArtifactSetRef `json:"media"`
	Host        string              `json:"host"`
	UsageScope  string              `json:"usageScope,omitempty"`
	TrackerIDs  []TrackerID         `json:"trackerIds,omitempty"`
	Fallback    bool                `json:"fallback"`
	Status      StageStatus         `json:"status"`
	ArtifactIDs []PublicResourceID  `json:"artifactIds"`
	Results     []MediaArtifact     `json:"results,omitempty"`
	Failures    []WorkflowFailure   `json:"failures,omitempty"`
	AttemptedAt time.Time           `json:"attemptedAt" ts_type:"string"`
}

type IMDBAKA struct {
	Title      string
	Country    string
	Language   string
	Attributes []string
}

type IMDBEditionDetail struct {
	DisplayName string
	Seconds     int
	Minutes     int
	Attributes  []string
}

type IMDBEpisode struct {
	ID          string
	Title       string
	ReleaseYear int
	ReleaseDate IMDBReleaseDate
	Season      int
	EpisodeText string
}

type IMDBMetadata struct {
	IMDBID           int
	IMDbIDText       string
	IMDbURL          string
	Title            string
	Year             int
	EndYear          int
	AKA              string
	Type             string
	Plot             string
	Rating           float64
	RatingCount      int
	RatingText       string
	RuntimeMinutes   int
	RuntimeText      string
	Genres           string
	Country          string
	CountryList      string
	Cover            string
	Directors        []IMDBPerson
	Creators         []IMDBPerson
	Writers          []IMDBPerson
	Stars            []IMDBPerson
	Editions         []string
	EditionDetails   map[string]IMDBEditionDetail
	Akas             []IMDBAKA
	Episodes         []IMDBEpisode
	SeasonsSummary   []IMDBSeasonSummary
	SoundMixes       []string
	TVYear           int
	OriginalLanguage string
}

type IMDBPerson struct {
	ID   string
	Name string
}

type IMDBReleaseDate struct {
	Year  int
	Month int
	Day   int
}

type IMDBSeasonSummary struct {
	Season    int
	Year      int
	YearRange string
}

type IdentityConflictStatus string

type IdentityDependency struct {
	ID       int
	TMDBID   int
	IMDBID   int
	TVDBID   int
	TVmazeID int
	MALID    int
}

type IdentityDependencySet struct {
	TMDB   IdentityDependency
	IMDB   IdentityDependency
	TVDB   IdentityDependency
	TVmaze IdentityDependency
	MAL    IdentityDependency
}

type IdentityOverrideState struct {
	TMDB     OverrideState
	IMDB     OverrideState
	TVDB     OverrideState
	TVmaze   OverrideState
	MAL      OverrideState
	Category OverrideState
}

type IdentityProvenance string

type IdentityProvenanceSet struct {
	TMDB     IdentityProvenance
	IMDB     IdentityProvenance
	TVDB     IdentityProvenance
	TVmaze   IdentityProvenance
	MAL      IdentityProvenance
	Category IdentityProvenance
}

type IdentityProvider string

type IdentityResolutionKey struct {
	SourceFingerprint string
	IntentFingerprint string
	ContractVersion   string
}

type ImageHostFeedback struct {
	Status       string
	SelectedHost string
	AllowedHosts []string
	Warnings     []ImageHostWarning
	Reuploaded   bool
	Message      string
}

type ImageHostOverrides struct {
	PreferredHost *string
	SkipUpload    *bool
	// FailedHosts lists image hosts whose earlier attempt failed for this run.
	// Later stages must not reuse or retry them.
	FailedHosts []string
}

type ImageHostWarning struct {
	Host    string
	Message string
}

type ImageHostingDiscSubject struct {
	ID   string
	Name string
}

type ImageHostingInput struct {
	Release       ReleaseRef
	Trackers      []string
	Host          string
	Scope         string
	ExcludedHosts []string
}

type ImageHostingService interface {
	ListCandidates(ctx context.Context, subject ImageHostingSubject) ([]ScreenshotImage, error)
	Upload(ctx context.Context, subject ImageHostingSubject, host string, usageScope string, images []ScreenshotImage) ([]UploadedImageLink, error)
}

type ImageHostingSubject struct {
	// MediaBinding owns persisted uploads and slot variants for one exact prepared generation.
	MediaBinding PreparedMediaBinding
	SourcePath   string
	GalleryName  string
	// Discs defines stable display and upload ordering without exposing private roots.
	Discs []ImageHostingDiscSubject
}

type ImageUploadProgressReporter func(update ImageUploadProgressUpdate)

type ImageUploadProgressStatus string

type ImageUploadProgressTarget struct {
	// AttemptID is stable for the host/scope pair within one command.
	AttemptID string
	// Host is the normalized configured image-host name.
	Host string
	// UsageScope distinguishes global and tracker-owned upload records.
	UsageScope string
	// Trackers lists upload targets served by this host attempt.
	Trackers []string
	// Fallback reports whether this attempt follows an earlier host failure.
	Fallback bool
	// Total is the number of selected images required on this host.
	Total int
	// Reused is the subset already available from persisted host records.
	Reused int
}

type ImageUploadProgressUpdate struct {
	// CorrelationID binds the update to one frontend upload command.
	CorrelationID string `json:"correlationID"`
	// AttemptID identifies the host/scope row updated by this snapshot.
	AttemptID string `json:"attemptID"`
	// Host is the normalized configured image-host name.
	Host string `json:"host"`
	// UsageScope distinguishes global and tracker-owned upload records.
	UsageScope string `json:"usageScope"`
	// Trackers lists upload targets served by this host attempt.
	Trackers []string `json:"trackers"`
	// Fallback reports whether this attempt follows an earlier host failure.
	Fallback bool `json:"fallback"`
	// Completed counts succeeded, failed, and reused images in terminal states.
	Completed int `json:"completed"`
	// Total is the number of selected images required on this host.
	Total int `json:"total"`
	// Succeeded counts completed network uploads in this attempt.
	Succeeded int `json:"succeeded"`
	// Failed counts completed network uploads that did not produce a usable link.
	Failed int `json:"failed"`
	// Reused counts images satisfied by existing persisted host records.
	Reused int `json:"reused"`
	// Status is the latest advisory state for this host attempt.
	Status ImageUploadProgressStatus `json:"status"`
	// Message provides frontend-safe detail about the latest transition.
	Message string `json:"message"`
	// Timestamp is an RFC3339 timestamp injected by the WebUI boundary.
	Timestamp string `json:"timestamp"`
}

type InputHistory struct {
	Release           ReleaseRef
	SourceFingerprint string
	Corrections       ReleaseCorrectionsSnapshot
	Tracks            []MediaTrackFacts
}

type InputReadinessEvaluation struct {
	Schemas                 []TrackerQuestionnaire       `json:"schemas,omitempty"`
	RequirementsFingerprint WorkflowFingerprint          `json:"requirementsFingerprint"`
	Fields                  []InputReadinessFieldOutcome `json:"fields,omitempty"`
	RequiredActions         []RequiredAction             `json:"requiredActions,omitempty"`
}

type InputReadinessFieldOutcome struct {
	Key             string                    `json:"key"`
	CorrectionField *CorrectionField          `json:"correctionField,omitempty"`
	TrackerIDs      []TrackerID               `json:"trackerIds,omitempty"`
	Status          InputReadinessFieldStatus `json:"status"`
	Disposition     RuleDisposition           `json:"disposition"`
	Message         string                    `json:"message,omitempty"`
}

type InputReadinessFieldStatus string

type InputReadinessSnapshot struct {
	Schemas                 []TrackerQuestionnaire            `json:"schemas,omitempty"`
	ID                      InputReadinessSnapshotID          `json:"id"`
	WorkflowID              WorkflowID                        `json:"workflowId"`
	Revision                WorkflowRevision                  `json:"revision"`
	Release                 ReleaseRef                        `json:"release"`
	FactInstructions        ReleaseFactInstructionSnapshotRef `json:"factInstructions"`
	CorrectionRevision      uint64                            `json:"correctionRevision,omitempty"`
	SelectedTrackerIDs      []TrackerID                       `json:"selectedTrackerIds,omitempty"`
	RequirementsFingerprint WorkflowFingerprint               `json:"requirementsFingerprint"`
	Fields                  []InputReadinessFieldOutcome      `json:"fields,omitempty"`
	RequiredActions         []RequiredAction                  `json:"requiredActions,omitempty"`
	Status                  StageStatus                       `json:"status"`
	CreatedAt               time.Time                         `json:"createdAt" ts_type:"string"`
}

type InputReadinessSnapshotID string

type InputReadinessSnapshotRef struct {
	ID       InputReadinessSnapshotID `json:"id"`
	Revision WorkflowRevision         `json:"revision"`
}

type InteractionMode string

type InvalidPlaylistSelectionError struct {
	// SourcePath identifies the requested local Blu-ray source.
	SourcePath string
	// Playlist identifies the rejected playlist when one was available.
	Playlist string
	// Reason explains the validation failure and is appended to Error's result.
	Reason string
}

type InvalidateReleaseWorkflowTrackersRequest struct {
	ReleaseWorkflowCommandContext
	TrackerIDs []TrackerID `json:"trackerIds"`
	Reason     string      `json:"reason"`
}

type LiveTestEffectCounts struct {
	RequestsDenied       uint64 `json:"requestsDenied"`
	MutationCallsDenied  uint64 `json:"mutationCallsDenied"`
	RemoteCallsStarted   uint64 `json:"remoteCallsStarted"`
	RemoteCallsSucceeded uint64 `json:"remoteCallsSucceeded"`
}

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

type Logger interface {
	Tracef(format string, args ...any)
	Debugf(format string, args ...any)
	Infof(format string, args ...any)
	Warnf(format string, args ...any)
	Errorf(format string, args ...any)
}

type ManualLanguageFacts struct {
	Audio              []string
	Subtitles          []string
	HardcodedSubtitles []string
}

type MediaArtifact struct {
	ID PublicResourceID `json:"id"`
	// DiscID identifies the prepared disc that produced this artifact.
	DiscID string `json:"discId,omitempty"`
	// DiscName is the safe page-facing label derived from prepared facts.
	DiscName         string            `json:"discName,omitempty"`
	Kind             MediaArtifactKind `json:"kind"`
	Purpose          ScreenshotPurpose `json:"purpose"`
	Selected         bool              `json:"selected"`
	Order            int               `json:"order,omitempty"`
	Index            int               `json:"index,omitempty"`
	TimestampSeconds float64           `json:"timestampSeconds,omitempty"`
	Source           string            `json:"source,omitempty"`
	Width            int               `json:"width,omitempty"`
	Height           int               `json:"height,omitempty"`
	SizeBytes        int64             `json:"sizeBytes,omitempty"`
	Host             string            `json:"host,omitempty"`
	URL              string            `json:"url,omitempty"`
}

type MediaArtifactKind string

type MediaArtifactSet struct {
	ID                        MediaArtifactSetID             `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"`
	CaptureFingerprint        WorkflowFingerprint            `json:"captureFingerprint"`
	RequirementsFingerprint   WorkflowFingerprint            `json:"requirementsFingerprint"`
	Artifacts                 []MediaArtifact                `json:"artifacts"`
	HostAttempts              []HostedImageAttempt           `json:"hostAttempts,omitempty"`
	FailedHosts               []string                       `json:"failedHosts,omitempty"`
	ImageRequirementsPrepared bool                           `json:"imageRequirementsPrepared"`
	Status                    StageStatus                    `json:"status"`
	RequiredActions           []RequiredAction               `json:"requiredActions,omitempty"`
	Failures                  []WorkflowFailure              `json:"failures,omitempty"`
	CreatedAt                 time.Time                      `json:"createdAt" ts_type:"string"`
}

type MediaArtifactSetID string

type MediaArtifactSetRef struct {
	ID       MediaArtifactSetID `json:"id"`
	Revision WorkflowRevision   `json:"revision"`
}

type MediaAssetRepository interface {
	ScreenshotLifecycleRepository
	LoadMediaAssetSnapshot(ctx context.Context, binding PreparedMediaBinding) (MediaAssetSnapshot, error)
	SaveScreenshot(ctx context.Context, binding PreparedMediaBinding, screenshot Screenshot) error
	ListScreenshotsByPath(ctx context.Context, binding PreparedMediaBinding) ([]Screenshot, error)
	DeleteScreenshot(ctx context.Context, binding PreparedMediaBinding, imagePath string) error
	SaveFinalSelections(ctx context.Context, binding PreparedMediaBinding, selections []ScreenshotFinalSelection) error
	ListFinalSelections(ctx context.Context, binding PreparedMediaBinding) ([]ScreenshotFinalSelection, error)
	DeleteFinalSelection(ctx context.Context, binding PreparedMediaBinding, imagePath string) error
	ReplaceScreenshotSlots(ctx context.Context, binding PreparedMediaBinding, slots []ScreenshotSlot) error
	ListScreenshotSlotsByPath(ctx context.Context, binding PreparedMediaBinding) ([]ScreenshotSlot, error)
	UpsertScreenshotSlotVariants(ctx context.Context, binding PreparedMediaBinding, variants []ScreenshotSlotVariant) error
	SaveUploadedImages(ctx context.Context, binding PreparedMediaBinding, host string, images []UploadedImageLink) error
	ListUploadedImagesByPath(ctx context.Context, binding PreparedMediaBinding) ([]UploadedImageLink, error)
	DeleteUploadedImage(ctx context.Context, binding PreparedMediaBinding, imagePath string, host string) error
}

type MediaAssetSnapshot struct {
	Screenshots     []Screenshot
	FinalSelections []ScreenshotFinalSelection
	ScreenshotSlots []ScreenshotSlot
	UploadedImages  []UploadedImageLink
}

type MediaAttachment struct {
	Resource WorkflowResourceRef `json:"resource"`
	Kind     MediaArtifactKind   `json:"kind"`
	Purpose  ScreenshotPurpose   `json:"purpose"`
	// DiscID is required for a multi-disc attachment and optional for single-disc compatibility.
	DiscID string `json:"discId,omitempty"`
	Order  int    `json:"order,omitempty"`
}

type MediaCaptureInstructions struct {
	ScreenshotCount int                   `json:"screenshotCount"`
	Purpose         ScreenshotPurpose     `json:"purpose"`
	Selections      []ScreenshotSelection `json:"selections,omitempty"`
	// ManualFrames applies the same raw frame numbers to every prepared disc.
	ManualFrames    []int `json:"manualFrames,omitempty"`
	CaptureDVDMenus bool  `json:"captureDvdMenus"`
	// MaxDVDMenuItems caps an explicitly requested automatic menu capture.
	MaxDVDMenuItems int `json:"maxDvdMenuItems,omitempty"`
}