schema/CHANGELOG.md

Changelog

All schema changes will be documented in this file.

31-10-25

• Hello, World!
• Initial PCD 2.0 schema definition
• Core entity tables: quality_profiles, custom_formats, regular_expressions, languages, tags, qualities, quality_groups
• Custom format conditions system with 11 condition types (patterns, language, indexer_flag, source, resolution, quality_modifier, size, release_type, year)
• Quality profile system supporting individual qualities and quality groups
• Junction tables for tags, quality groups, profile qualities, and profile custom formats
• Unique index ensuring single upgrade_until per profile
• Add arr_type support for Radarr/Sonarr differentiation
  • custom_format_conditions.arr_type: conditions can be arr-specific or universal
  • quality_profile_custom_formats.arr_type: scores can differ between Radarr and Sonarr

3-11-25

• Better profile langauge procesing
• Make quality groups unique and not reusable across profiles

28-12-25

• Add quality API mappings for Radarr/Sonarr name translation
  • quality_api_mappings: maps canonical Profilarr quality names to arr-specific API names (e.g., Remux-1080p -> Bluray-1080p Remux for Sonarr)
• Add media management tables (arr-specific)
  • radarr_quality_definitions / sonarr_quality_definitions: size limits (min/max/preferred) per quality
  • radarr_naming / sonarr_naming: file/folder naming formats
  • radarr_media_settings / sonarr_media_settings: general settings (propers_repacks, enable_media_info)
• Add delay profiles for download timing control
  • delay_profiles: protocol preference, delays, bypass conditions
  • delay_profile_tags: junction table for tag associations
  • CHECK constraints for protocol/delay validation

31-12-25

• Add custom format testing table
  • custom_format_tests: stores test cases for validating custom format matching
  • Each test specifies a release title and whether it should match the format
  • Supports movie/series type differentiation for parser context
  • Unique constraint on (custom_format_id, title, type) prevents duplicate tests
• Add include_in_rename column to custom_formats table
  • Controls whether custom format name appears in renamed filenames

3-1-26

• Add quality profile testing tables
  • test_entities: stores movies/series from TMDB for testing quality profiles
  • test_releases: stores sample releases attached to test entities
  • Supports languages, indexers, and flags as JSON arrays for release metadata

19-1-26

Major FK Stability Overhaul

All tables now use stable name-based keys instead of autoincrement IDs for foreign key references. This ensures data remains correctly linked after database recompile from ops.

Core principle: Every FK now references a UNIQUE name column (or composite of names) instead of an autoincrement id column.

• test_releases: Changed from test_entity_id to composite FK (entity_type, entity_tmdb_id)
• custom_format_conditions: Changed custom_format_id to custom_format_name
  • Added UNIQUE(custom_format_name, name) - condition names must be unique within a CF
• All condition child tables (condition_patterns, condition_languages, condition_indexer_flags, condition_sources, condition_resolutions, condition_quality_modifiers, condition_sizes, condition_release_types, condition_years):
  • Use (custom_format_name, condition_name) composite FK
  • condition_patterns also uses regular_expression_name
  • condition_languages also uses language_name
• quality_groups: Changed quality_profile_id to quality_profile_name
• quality_group_members: Uses (quality_profile_name, quality_group_name, quality_name)
• quality_profile_qualities: Uses quality_profile_name, quality_name, quality_group_name
• quality_profile_custom_formats: Uses (quality_profile_name, custom_format_name)
• quality_profile_languages: Uses (quality_profile_name, language_name)
• quality_profile_tags: Uses (quality_profile_name, tag_name)
• regular_expression_tags: Uses (regular_expression_name, tag_name)
• custom_format_tags: Uses (custom_format_name, tag_name)
• delay_profile_tags: Uses (delay_profile_name, tag_name)
• quality_api_mappings: Uses (quality_name, arr_type)
• custom_format_tests: Uses custom_format_name
• radarr_quality_definitions / sonarr_quality_definitions: Uses quality_name as PK

21-1-26

• Removed delay_profile_tags table - tags not needed for syncing since only the default profile (id=1) can be updated, which must have empty tags
• Only one delay profile syncs per arr instance; others are ignored

27-1-26

• Media management tables now support multiple named configurations
  • Removed singleton constraints (CHECK (id = 1)) from naming and media settings tables
  • Added name as primary key to: radarr_naming, sonarr_naming, radarr_media_settings, sonarr_media_settings
  • Added name to composite primary key for: radarr_quality_definitions, sonarr_quality_definitions
  • Allows storing multiple independent configs per table (e.g., different naming schemes, different quality size limits)
• Added CHECK constraints for enum-like columns (enables type generation)
  • radarr_naming.colon_replacement_format: delete, dash, spaceDash, spaceDashSpace, smart
  • radarr_media_settings.propers_repacks: doNotPrefer, preferAndUpgrade, doNotUpgradeAutomatically
  • sonarr_media_settings.propers_repacks: doNotPrefer, preferAndUpgrade, doNotUpgradeAutomatically
• Added explicit NOT NULL to VARCHAR PRIMARY KEY columns for proper type inference
  • radarr_naming.name, sonarr_naming.name, radarr_media_settings.name, sonarr_media_settings.name
  • SQLite PRIMARY KEY doesn't imply NOT NULL for non-INTEGER columns; explicit declaration needed for type generators

10-2-26

• Added cleanup triggers for orphaned conditions
  • trg_condition_patterns_cleanup: when a condition_patterns row is cascade-deleted (e.g., referenced regex deleted upstream), the parent condition in custom_format_conditions is also deleted
  • trg_condition_languages_cleanup: same for condition_languages when a referenced language is deleted
  • Prevents orphaned conditions that exist without their type-specific data