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

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 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 {
	// 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 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 {
	// Code is a stable machine-readable warning identifier.
	Code string
	// Message is a redacted user-facing description of the incomplete coverage.
	Message 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 {
	SourcePath string
	DiscType   string
}

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 {
	SourcePath            string
	DiscType              string
	MediaInfoTextPath     string
	DVDVOBMediaInfoText   string
	DescriptionTemplate   string
	EpisodeOverview       string
	Options               UploadOptions
	Release               ReleaseInfo
	SelectedBDMVPlaylists []PlaylistInfo
	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 DiscFacts struct {
	Type            string
	Summary         string
	DurationSeconds float64
	PlaylistCount   int
	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 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 {
	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
	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 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
	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 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"`
	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 {
	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 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 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 {
	SourcePath  string
	GalleryName string
}

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 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 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 MediaArtifact struct {
	ID               PublicResourceID  `json:"id"`
	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, path string) (MediaAssetSnapshot, error)
	SaveScreenshot(ctx context.Context, screenshot Screenshot) error
	ListScreenshotsByPath(ctx context.Context, path string) ([]Screenshot, error)
	DeleteScreenshot(ctx context.Context, imagePath string) error
	SaveFinalSelections(ctx context.Context, path string, selections []ScreenshotFinalSelection) error
	ListFinalSelections(ctx context.Context, path string) ([]ScreenshotFinalSelection, error)
	DeleteFinalSelection(ctx context.Context, imagePath string) error
	ReplaceScreenshotSlots(ctx context.Context, path string, slots []ScreenshotSlot) error
	ListScreenshotSlotsByPath(ctx context.Context, path string) ([]ScreenshotSlot, error)
	UpsertScreenshotSlotVariants(ctx context.Context, path string, variants []ScreenshotSlotVariant) error
	SaveUploadedImages(ctx context.Context, path string, host string, images []UploadedImageLink) error
	ListUploadedImagesByPath(ctx context.Context, path string) ([]UploadedImageLink, error)
	DeleteUploadedImage(ctx context.Context, path string, 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"`
	Order    int                 `json:"order,omitempty"`
}

type MediaCaptureInstructions struct {
	ScreenshotCount int                   `json:"screenshotCount"`
	Purpose         ScreenshotPurpose     `json:"purpose"`
	Selections      []ScreenshotSelection `json:"selections,omitempty"`
	CaptureDVDMenus bool                  `json:"captureDvdMenus"`
	// MaxDVDMenuItems caps an explicitly requested automatic menu capture.
	MaxDVDMenuItems int `json:"maxDvdMenuItems,omitempty"`
}

type MediaCaptureRequirement struct {
	TrackerID       TrackerID         `json:"trackerId"`
	ScreenshotCount int               `json:"screenshotCount"`
	DVDMenuCount    int               `json:"dvdMenuCount"`
	Purpose         ScreenshotPurpose `json:"purpose"`
}

type MediaFacts struct {
	AudioLanguages    []string
	SubtitleLanguages []string
	Container         string
	Audio             string
	Channels          string
	Commentary        bool
	ThreeD            string
	Source            string
	Type              string
	UHD               string
	HDR               string
	HDRFacts          HDRFacts
	Distributor       string
	Region            string
	VideoCodec        string
	VideoEncode       string
	HasEncodeSettings bool
	BitDepth          string
	Edition           string
	Repack            string
	WebDV             bool
	StreamOptimized   int
	Service           string
	ServiceLongName   string
	MediaInfoUniqueID string
	Anime             bool
}

type MediaFileFact struct {
	FileName          string
	Primary           bool
	Container         string
	Source            string
	Resolution        string
	VideoCodec        string
	VideoEncode       string
	BitDepth          string
	VideoTrackCount   int
	AudioLanguages    []string
	SubtitleLanguages []string
}

type MediaFileFacts struct {
	Status            MetadataEvidenceStatus
	TechnicalStatus   MetadataEvidenceStatus
	LanguageStatus    MetadataEvidenceStatus
	ExpectedFileCount int
	OriginalLanguage  string
	Files             []MediaFileFact
}

type MediaPlan struct {
	ID                  MediaPlanID                    `json:"id"`
	WorkflowID          WorkflowID                     `json:"workflowId"`
	Revision            WorkflowRevision               `json:"revision"`
	Release             ReleaseSnapshotRef             `json:"release"`
	ProjectionSet       TrackerReleaseProjectionSetRef `json:"projectionSet"`
	DurationSeconds     float64                        `json:"durationSeconds"`
	FrameRate           float64                        `json:"frameRate"`
	DiscType            string                         `json:"discType,omitempty"`
	SuggestedSelections []ScreenshotSelection          `json:"suggestedSelections,omitempty"`
	Requirements        []MediaCaptureRequirement      `json:"requirements,omitempty"`
	ExistingArtifacts   []MediaArtifact                `json:"existingArtifacts,omitempty"`
	CreatedAt           time.Time                      `json:"createdAt" ts_type:"string"`
}

type MediaPlanID string

type MediaPlanInput struct {
	Release ReleaseRef
	Count   int
	Purpose ScreenshotPurpose
	Options ScreenshotOverrides
}

type MediaPlanRef struct {
	ID       MediaPlanID      `json:"id"`
	Revision WorkflowRevision `json:"revision"`
}

type MetadataEvidenceStatus string

type MetadataOverrides struct {
	Distributor      *string
	OriginalLanguage *string
	PersonalRelease  *bool
	Commentary       *bool
	WebDV            *bool
	StreamOptimized  *bool
	Anime            *bool
}

type MetadataPreview struct {
	SourcePath           string
	TrackerName          string
	ReleaseName          string
	ReleaseNameOverrides ReleaseNameOverrides
	Release              ReleaseRef
	Identity             ExternalIdentity
	Display              PreparedReleaseDisplay
	Bluray               *BlurayMetadata
	Diagnostics          []PreparationDiagnostic
	TrackerData          []TrackerPreview
	// TrackerRuleFailures is keyed by normalized tracker code and contains
	// upload rule failures known at preview time.
	TrackerRuleFailures map[string][]RuleFailure
}

type MissingRequirementError struct {
	Requirement RequirementKind
	Provider    IdentityProvider
}

type NamingAssessment struct {
	Status  NamingStatus
	Missing []NamingRequirement
}

type NamingFacts struct {
	Filename       string
	ReleaseName    string
	NameWithoutTag string
	CleanName      string
	// GeneratedReleaseNames contains safe canonical structural alternatives.
	// Empty variants mean ReleaseName must remain exact.
	GeneratedReleaseNames GeneratedReleaseNameVariants
	Tag                   string
	Type                  string
	Artist                string
	Title                 string
	Subtitle              string
	AlternateTitle        string
	Year                  int
	Month                 int
	Day                   int
	Source                string
	Resolution            string
	Codecs                []string
	Audio                 []string
	HDR                   []string
	Extension             string
	Languages             []string
	Site                  string
	Genre                 string
	Channels              string
	Collection            string
	Region                string
	Size                  string
	Group                 string
	Disc                  string
	Editions              []string
	Other                 []string
	Scene                 bool
	SceneName             string
	Personal              bool
}

type NamingRequirement string

type NamingStatus string

type NopLogger struct{}

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

type OperationFailure struct {
	Code      OperationFailureCode
	Operation OperationKind
	Message   string
	Recovery  OperationRecovery
}

type OperationFailureCode string

type OperationKind string

type OperationLifecycle string

type OperationRecovery string

type OverrideState string

type PackageFacts struct {
	Status                    MetadataEvidenceStatus
	KnownFileCount            int
	MediaFileCount            int
	ArchiveFileCount          int
	ExternalSubtitleFileCount int
	ExternalFileCount         int
	NestedFileCount           int
	Extensions                []string
	DetectedSeasons           []int
	DetectedEpisodes          []SeasonEpisodeFacts
	ExtraKinds                []PackageFileKind
	SingleFileFolder          bool
}

type PackageFileKind string

type PlaylistInfo struct {
	File     string         `json:"file"`
	Duration float64        `json:"duration"`
	Items    []PlaylistItem `json:"items"`
	Score    float64        `json:"score"`
	Edition  string         `json:"edition"`
}

type PlaylistInstruction struct {
	Set      bool
	Selected []string
	UseAll   bool
}

type PlaylistItem struct {
	File string `json:"file"`
	Size int64  `json:"size"`
}

type PlaylistSelection struct {
	SourcePath        string
	SelectedPlaylists []string
	UseAll            bool
	UpdatedAt         time.Time `ts_type:"string"`
}

type PlaylistSelectionRequiredError struct {
	// SourcePath identifies the requested local Blu-ray source.
	SourcePath string
	// Candidates contains the discovered playlists available for selection.
	Candidates []PlaylistInfo
}

type PreflightReleaseWorkflowTrackersRequest struct {
	ReleaseWorkflowCommandContext
	InputFingerprint WorkflowFingerprint   `json:"inputFingerprint,omitempty"`
	Interaction      InteractionMode       `json:"interaction,omitempty"`
	ExecutionMode    WorkflowExecutionMode `json:"executionMode,omitempty"`
}

type PreparationCompatibility struct {
	SourceFingerprint          string
	FactInstructionFingerprint string
	PolicyFingerprint          string
	ContractVersion            string
}

type PreparationControls struct {
	// Interaction determines whether preparation may request manual input.
	Interaction InteractionMode
	// ConfirmBDMVRescan permits replacing a partial cached Blu-ray analysis.
	ConfirmBDMVRescan bool
	// ForceRecheck forwards an explicit torrent-client hash recheck choice.
	ForceRecheck *bool
}

type PreparationDescription struct {
	GroupKey           string
	Trackers           []string
	RawDescription     string
	RawDescriptionHTML string
	Description        string
	DescriptionHTML    string
	HasOverride        bool
	ImageHost          ImageHostFeedback
}

type PreparationDiagnostic struct {
	Code       string
	Severity   DiagnosticSeverity
	Message    string
	Candidates []ExternalIdentityCandidate
}

type PreparationIntent string

type PreparationPolicy struct {
	KeepFolder bool
	// KeepImages preserves tracker-sourced images while collecting metadata evidence.
	KeepImages bool
	OnlyID     bool
}

type PreparationPreview struct {
	SourcePath      string
	Descriptions    []PreparationDescription
	ContentFailures []TrackerContentFailure
}

type PreparationProgressPhase string

type PreparationProgressReporter func(update PreparationProgressUpdate)

type PreparationProgressStatus string

type PreparationProgressUpdate struct {
	// CorrelationID binds the update to one frontend preparation command.
	CorrelationID string `json:"correlationID"`
	// Phase identifies the stable preparation stage.
	Phase PreparationProgressPhase `json:"phase"`
	// Order is the canonical presentation order, not a completion percentage.
	Order int `json:"order"`
	// Label is the user-facing stage name.
	Label string `json:"label"`
	// Message describes the current stage transition.
	Message string `json:"message"`
	// Status is the latest advisory state for Phase.
	Status PreparationProgressStatus `json:"status"`
	// Timestamp is an RFC3339 timestamp injected by the WebUI boundary.
	Timestamp string `json:"timestamp"`
}

type PrepareInput struct {
	SourcePath   string
	Intent       PreparationIntent
	Instructions ReleaseFactInstructions
	Policy       PreparationPolicy
	// Search contains fact-producing client search choices included in compatibility.
	Search ClientSearchPolicy
	// Controls contains one-shot permissions excluded from compatibility.
	Controls PreparationControls
	Force    bool
	// RequirePrepared rejects collection when no compatible prepared generation exists.
	RequirePrepared bool
}

type PrepareReleaseWorkflowRequest struct {
	ReleaseWorkflowCommandContext
	Input PrepareInput `json:"input"`
}

type PrepareResult struct {
	Release     PreparedRelease
	Diagnostics []PreparationDiagnostic
}