karaoke-gen 0.96.0__py3-none-any.whl → 0.99.3__py3-none-any.whl

backend/tests/emulator/conftest.py

@@ -39,6 +39,24 @@ os.environ["ADMIN_TOKENS"] = "test-admin-token"
 
 # Only import app if emulators are running
 if emulators_running():
+    from unittest.mock import Mock
+
+    # Mock theme service BEFORE importing app to ensure all jobs get theme_id="nomad"
+    _mock_theme_service = Mock()
+    _mock_theme_service.get_default_theme_id.return_value = "nomad"
+    _mock_theme_service.get_theme.return_value = None
+
+    # Apply patch at module load time (before app imports the service)
+    _theme_patches = [
+        patch("backend.services.theme_service.get_theme_service", return_value=_mock_theme_service),
+        patch("backend.api.routes.audio_search.get_theme_service", return_value=_mock_theme_service),
+        patch("backend.api.routes.file_upload.get_theme_service", return_value=_mock_theme_service),
+        patch("backend.api.routes.users.get_theme_service", return_value=_mock_theme_service),
+        patch("backend.api.routes.jobs.get_theme_service", return_value=_mock_theme_service),
+    ]
+    for p in _theme_patches:
+        p.start()
+
     from fastapi.testclient import TestClient
     from backend.main import app
 else:
@@ -76,7 +94,10 @@ def mock_worker_service():
 
 @pytest.fixture(scope="session")
 def client(mock_worker_service):
-    """Create FastAPI test client with mocked workers."""
+    """Create FastAPI test client with mocked workers.
+
+    Theme service is mocked at module load time (see above).
+    """
     with patch("backend.api.routes.file_upload.worker_service", mock_worker_service):
         return TestClient(app)
 

backend/tests/test_job_manager.py

@@ -33,13 +33,28 @@ def job_manager(mock_firestore_service):
 
 class TestJobCreation:
     """Test job creation logic."""
-    
+
+    def test_create_job_requires_theme_id(self, job_manager, mock_firestore_service):
+        """Test that jobs without theme_id are rejected."""
+        job_create = JobCreate(
+            artist="Test Artist",
+            title="Test Song"
+            # No theme_id - should fail
+        )
+
+        with pytest.raises(ValueError, match="theme_id is required"):
+            job_manager.create_job(job_create)
+
+        # Verify Firestore was NOT called
+        mock_firestore_service.create_job.assert_not_called()
+
     def test_create_job_with_url(self, job_manager, mock_firestore_service):
         """Test creating a job with YouTube URL."""
         job_create = JobCreate(
             url="https://youtube.com/watch?v=test",
             artist="Test Artist",
-            title="Test Song"
+            title="Test Song",
+            theme_id="nomad"  # Required for all jobs
         )
         
         # The actual create_job method creates the job and returns it
@@ -59,7 +74,8 @@ class TestJobCreation:
         """Test creating a job without URL (for file upload)."""
         job_create = JobCreate(
             artist="Test Artist",
-            title="Test Song"
+            title="Test Song",
+            theme_id="nomad"  # Required for all jobs
         )
         
         job = job_manager.create_job(job_create)
@@ -70,8 +86,8 @@ class TestJobCreation:
     
     def test_create_job_generates_unique_id(self, job_manager, mock_firestore_service):
         """Test that each job gets a unique ID."""
-        job_create = JobCreate()
-        
+        job_create = JobCreate(theme_id="nomad")  # Required for all jobs
+
         # Create multiple jobs
         ids = []
         for i in range(5):
@@ -89,8 +105,8 @@ class TestJobCreation:
     
     def test_create_job_sets_initial_status(self, job_manager, mock_firestore_service):
         """Test that new jobs start with PENDING status."""
-        job_create = JobCreate()
-        
+        job_create = JobCreate(theme_id="nomad")  # Required for all jobs
+
         mock_firestore_service.create_job.return_value = Job(
             job_id="test123",
             status=JobStatus.PENDING,
@@ -105,13 +121,14 @@ class TestJobCreation:
     
     def test_create_job_with_distribution_settings(self, job_manager, mock_firestore_service):
         """Test that distribution settings are passed from JobCreate to Job.
-        
+
         This was a bug where brand_prefix, dropbox_path, gdrive_folder_id, and
         discord_webhook_url were NOT being passed to the Job constructor.
         """
         job_create = JobCreate(
             artist="Test Artist",
             title="Test Song",
+            theme_id="nomad",  # Required for all jobs
             brand_prefix="NOMAD",
             discord_webhook_url="https://discord.com/webhook/test",
             dropbox_path="/Karaoke/Tracks-Organized",

backend/tests/test_jobs_api.py

@@ -50,7 +50,16 @@ def mock_worker_service():
 
 
 @pytest.fixture
-def client(mock_job_manager, mock_worker_service):
+def mock_theme_service():
+    """Create a mock ThemeService that returns 'nomad' as default theme."""
+    service = MagicMock()
+    service.get_default_theme_id.return_value = "nomad"
+    service.get_theme.return_value = None
+    return service
+
+
+@pytest.fixture
+def client(mock_job_manager, mock_worker_service, mock_theme_service):
     """Create TestClient with mocked dependencies."""
     mock_creds = MagicMock()
     mock_creds.universe_domain = 'googleapis.com'
@@ -63,6 +72,7 @@ def client(mock_job_manager, mock_worker_service):
     # Also patch JobManager class used in dependencies.py for auth checks
     with patch('backend.api.routes.jobs.job_manager', mock_job_manager), \
          patch('backend.api.routes.jobs.worker_service', mock_worker_service), \
+         patch('backend.api.routes.jobs.get_theme_service', return_value=mock_theme_service), \
          patch('backend.services.job_manager.JobManager', mock_job_manager_factory), \
          patch('backend.services.firestore_service.firestore'), \
          patch('backend.services.storage_service.storage'), \

backend/tests/test_spacy_preloader.py

@@ -0,0 +1,119 @@
+"""Tests for SpaCy preloader service."""
+
+import pytest
+from unittest.mock import patch, MagicMock
+
+from backend.services.spacy_preloader import (
+    preload_spacy_model,
+    get_preloaded_model,
+    is_model_preloaded,
+    clear_preloaded_models,
+)
+
+
+class TestSpacyPreloader:
+    """Tests for SpaCy preloading functionality."""
+
+    def setup_method(self):
+        """Clear preloaded models before each test."""
+        clear_preloaded_models()
+
+    def teardown_method(self):
+        """Clear preloaded models after each test."""
+        clear_preloaded_models()
+
+    def test_preload_spacy_model_loads_and_stores(self):
+        """GIVEN no preloaded models
+        WHEN preload_spacy_model is called
+        THEN model should be loaded and stored in singleton."""
+        mock_nlp = MagicMock()
+
+        with patch("spacy.load", return_value=mock_nlp) as mock_load:
+            preload_spacy_model("en_core_web_sm")
+
+            mock_load.assert_called_once_with("en_core_web_sm")
+            assert is_model_preloaded("en_core_web_sm")
+            assert get_preloaded_model("en_core_web_sm") is mock_nlp
+
+    def test_preload_is_idempotent(self):
+        """GIVEN a model already preloaded
+        WHEN preload_spacy_model is called again
+        THEN model should not be reloaded."""
+        mock_nlp = MagicMock()
+
+        with patch("spacy.load", return_value=mock_nlp) as mock_load:
+            preload_spacy_model("en_core_web_sm")
+            preload_spacy_model("en_core_web_sm")  # Second call
+
+            # Should only load once
+            assert mock_load.call_count == 1
+
+    def test_get_preloaded_model_returns_none_if_not_loaded(self):
+        """GIVEN no preloaded models
+        WHEN get_preloaded_model is called
+        THEN should return None."""
+        assert get_preloaded_model("en_core_web_sm") is None
+        assert not is_model_preloaded("en_core_web_sm")
+
+    def test_preload_different_models(self):
+        """GIVEN no preloaded models
+        WHEN preload_spacy_model is called with different model names
+        THEN each model should be loaded and stored separately."""
+        mock_nlp_sm = MagicMock(name="en_core_web_sm")
+        mock_nlp_md = MagicMock(name="en_core_web_md")
+
+        def mock_load(model_name):
+            if model_name == "en_core_web_sm":
+                return mock_nlp_sm
+            elif model_name == "en_core_web_md":
+                return mock_nlp_md
+            raise ValueError(f"Unknown model: {model_name}")
+
+        with patch("spacy.load", side_effect=mock_load):
+            preload_spacy_model("en_core_web_sm")
+            preload_spacy_model("en_core_web_md")
+
+            assert is_model_preloaded("en_core_web_sm")
+            assert is_model_preloaded("en_core_web_md")
+            assert get_preloaded_model("en_core_web_sm") is mock_nlp_sm
+            assert get_preloaded_model("en_core_web_md") is mock_nlp_md
+
+    def test_clear_preloaded_models(self):
+        """GIVEN preloaded models
+        WHEN clear_preloaded_models is called
+        THEN all models should be removed."""
+        mock_nlp = MagicMock()
+
+        with patch("spacy.load", return_value=mock_nlp):
+            preload_spacy_model("en_core_web_sm")
+            assert is_model_preloaded("en_core_web_sm")
+
+            clear_preloaded_models()
+            assert not is_model_preloaded("en_core_web_sm")
+            assert get_preloaded_model("en_core_web_sm") is None
+
+    def test_preload_failure_raises_exception(self):
+        """GIVEN spacy.load raises an exception
+        WHEN preload_spacy_model is called
+        THEN exception should be propagated."""
+        with patch(
+            "spacy.load",
+            side_effect=OSError("Model not found"),
+        ):
+            with pytest.raises(OSError, match="Model not found"):
+                preload_spacy_model("nonexistent_model")
+
+            # Model should not be marked as preloaded
+            assert not is_model_preloaded("nonexistent_model")
+
+    def test_preload_uses_default_model_name(self):
+        """GIVEN no model name specified
+        WHEN preload_spacy_model is called without arguments
+        THEN should use en_core_web_sm as default."""
+        mock_nlp = MagicMock()
+
+        with patch("spacy.load", return_value=mock_nlp) as mock_load:
+            preload_spacy_model()
+
+            mock_load.assert_called_once_with("en_core_web_sm")
+            assert is_model_preloaded("en_core_web_sm")

backend/utils/test_data.py

@@ -0,0 +1,27 @@
+"""
+Utilities for identifying test data.
+
+Test data is generated by automated E2E tests and should be filterable
+in admin dashboards to show only real user data by default.
+"""
+
+# Email domains used by automated testing frameworks
+TEST_EMAIL_DOMAINS = [
+    "inbox.testmail.app",  # Used by E2E happy path tests
+]
+
+
+def is_test_email(email: str) -> bool:
+    """
+    Check if an email address belongs to automated test data.
+
+    Args:
+        email: Email address to check
+
+    Returns:
+        True if the email matches a test email domain pattern
+    """
+    if not email:
+        return False
+    email_lower = email.lower()
+    return any(email_lower.endswith(f"@{domain}") for domain in TEST_EMAIL_DOMAINS)

backend/workers/screens_worker.py

@@ -218,26 +218,36 @@ async def generate_screens(job_id: str) -> bool:
 def _validate_prerequisites(job) -> bool:
     """
     Validate that both audio and lyrics processing are complete.
-    
+
     Single Responsibility: Validation logic separated from main flow.
-    
+
     Args:
         job: Job object
-        
+
     Returns:
         True if prerequisites met, False otherwise
     """
+    # SAFETY NET: Enforce theme requirement at processing time
+    # This catches any jobs that somehow bypassed JobManager.create_job() validation
+    if not job.theme_id:
+        logger.error(
+            f"Job {job.job_id}: CRITICAL - No theme_id configured. "
+            "All jobs must have a theme to generate styled videos. "
+            "This job should have been rejected at creation time."
+        )
+        return False
+
     audio_complete = job.state_data.get('audio_complete', False)
     lyrics_complete = job.state_data.get('lyrics_complete', False)
-    
+
     if not audio_complete:
         logger.error(f"Job {job.job_id}: Audio processing not complete")
         return False
-    
+
     if not lyrics_complete:
         logger.error(f"Job {job.job_id}: Lyrics processing not complete")
         return False
-    
+
     if not job.artist or not job.title:
         logger.error(f"Job {job.job_id}: Missing artist or title")
         return False

{karaoke_gen-0.96.0.dist-info → karaoke_gen-0.99.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: karaoke-gen
-Version: 0.96.0
+Version: 0.99.3
 Summary: Generate karaoke videos with synchronized lyrics. Handles the entire process from downloading audio and lyrics to creating the final video with title screens.
 License: MIT
 License-File: LICENSE

{karaoke_gen-0.96.0.dist-info → karaoke_gen-0.99.3.dist-info}/RECORD

@@ -7,18 +7,18 @@ backend/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 backend/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 backend/api/dependencies.py,sha256=-61nHBhiihUDSVMQd3VuHLP7uvKrUbm1y-j9RmV6_zc,16871
 backend/api/routes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-backend/api/routes/admin.py,sha256=QJ2B-90HySVd8la1DN2IGeKPq6Qzj4TVFZhgZOOoKBo,26060
-backend/api/routes/audio_search.py,sha256=wJ_5j_q3yaHs5W03M2B5FdTYUrAVqHV5tW0cBdRrzxI,39153
+backend/api/routes/admin.py,sha256=r9Q7cOnDJjLnQVQ5ql3S6eUOXiVss9hEanHMz6I0Mp4,30499
+backend/api/routes/audio_search.py,sha256=r8VPlyA40DUoFPcvNVM_p4faJsjv_Ta_qsY7PhvAzfw,39678
 backend/api/routes/auth.py,sha256=G1U2KwS3uqBJpgvg2PIe_mZOWCJKPFhhewrmKbW3Z_s,11531
-backend/api/routes/file_upload.py,sha256=Skh4ewXo5I8XReXhXlJZO7tUbvdwz1YdNxFmJqYIFnM,92290
-backend/api/routes/health.py,sha256=6HSLJVtNaYHA-xaXgHsXMZUJayYYXXNdX-oThDLDCcw,11609
+backend/api/routes/file_upload.py,sha256=GQ_m1ZQxFOxxkrjPY6a-9K3jvBC-Jwo_1mRYjZ6cxic,94156
+backend/api/routes/health.py,sha256=iZlhJpmz4vminUy_qrzkyk_1tgG1gmITz4jEWaCWJnM,14010
 backend/api/routes/internal.py,sha256=N_Fv0hYQ9gleYNehjHaZb1OKzM78PXDbcqTmHasll2w,15276
-backend/api/routes/jobs.py,sha256=xAIbcNrYLHlWYHvsv1C5BakdvgXdN5mpa_RRzJ3QSeI,59905
+backend/api/routes/jobs.py,sha256=L0Aot-BEgOlNv-_AqEVIkO5Uv4BTP5gjmBvPzjWmlR8,60866
 backend/api/routes/review.py,sha256=hEvLUcb07DWcBc6E4fTa91zam3Z_a-x2vIvLP_OKR9o,28256
 backend/api/routes/themes.py,sha256=_fPZg9N2KN-yyr1YR2vAy8FIm8PqVowboQ4WEpFTYiQ,4721
-backend/api/routes/users.py,sha256=1EaBzR4qEzUklC3P3Yz-15Usm9tys3VPee0azmKzLj8,34355
+backend/api/routes/users.py,sha256=9ffodZUGzxjoHXLQdOZ-PLEqK0k-wd4zK4xp_GD2wZk,56781
 backend/config.py,sha256=-HsMaacaKuRftYXUXZJr8GBHPdmacFbrNnFDMk7DHNI,8187
-backend/main.py,sha256=nmm-0GWYoqKaWXRQSrRxbyZ5kUnv2BGpAtTvCyhVV_Q,4675
+backend/main.py,sha256=xYxdM9GT0vLVPmyXGgoa0_BW1JQMGEX5m7lXm_xYnaw,5666
 backend/middleware/__init__.py,sha256=lUSMQqQc4UxPazrE1XmyNNEvTKRk7tddAdFmxbTzz7M,157
 backend/middleware/audit_logging.py,sha256=oGdgbfH_M_3hIMAGrS5HpRvri2jjLxGFnFuA6IiU9BU,4170
 backend/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -41,7 +41,7 @@ backend/services/discord_service.py,sha256=LnEasOgaSRlmebDKsVT2yKCdWNDmskUToP3o2
 backend/services/dropbox_service.py,sha256=R47MUKCqK2BEXXmQxMLG6zkPWw02htFoES9q9xiaYAw,10717
 backend/services/email_service.py,sha256=fxwcL-n6ZRGLQ7SHXhxUQK1MkprtgE3GcuL5ulUR-90,44699
 backend/services/encoding_interface.py,sha256=Y8hPskDyX9DOyAD557F3-SdHjymaBkGXcoC9E_OW7SE,15825
-backend/services/encoding_service.py,sha256=d_1M9DucihOHNqXI1pR4QLj16FhmtMoONRu2YGPvhGY,14570
+backend/services/encoding_service.py,sha256=XAX4hyL2wIHdpBCTc8yglcjVJboZxRVAjc07lUTxgFg,18025
 backend/services/firestore_service.py,sha256=XOuXUNd91eVeyEx82uh-A-WMwcyUa2HVxqTfYnGPw-Q,18512
 backend/services/flacfetch_client.py,sha256=zj4VToKamR8bShXZifLvjDmUVa1HHvDhZuaw_b7g4lU,19901
 backend/services/gce_encoding/README.md,sha256=frTFrp7-ugFAvUd_K9EgE4ud8Xu4Qf1V7BNirQn6qJk,2515
@@ -50,16 +50,19 @@ backend/services/gce_encoding/main.py,sha256=2A0Bd3zYzbV66ikShB3avpqfNoDFBxr8Ja6
 backend/services/gce_encoding/requirements.txt,sha256=-hW5ot-PnVoKkxrpY3yV6l68wx7AvzgnLYAWEgDGWNc,408
 backend/services/gdrive_service.py,sha256=3JTXmPBuxpKopAbWDrh6YhqR5L9BLop1R7caXBnIk2A,13266
 backend/services/job_logging.py,sha256=theCkAlwMbqyqAbu7vCCRpVRscaIpkam3UrCs_4Yi1g,8052
-backend/services/job_manager.py,sha256=YPXFJD9oIMSZvVl2Ed4czo-4M-HqMxJrYCfZXV_MkhE,31256
+backend/services/job_manager.py,sha256=y7TCwJal7rPJm4QRuOEviv_SE9RvDiNGHz33MSgGY3M,31701
 backend/services/job_notification_service.py,sha256=ywGJUMUDqV23OSDsugOUufpXO6N_24bM9YVaPp8bOk4,9557
+backend/services/langfuse_preloader.py,sha256=t-Rt_ThjZm4K8W3jlyLn2H3cEy7KNUlhrvOPmdg-gYM,3100
 backend/services/local_encoding_service.py,sha256=Q6yK2-QL9tHM_pUBoxdyfT7ln2L5xMx82JB2nC5OfNQ,20680
 backend/services/local_preview_encoding_service.py,sha256=WLuJuIx-kH6u35gcYnvogf4Gt7iEokL2IdfxlrkY5po,14394
 backend/services/lyrics_cache_service.py,sha256=53EIZuDs5jIKr6QiOhIKJjE2mx1Jd1_x15_uAeLnc4A,7598
 backend/services/metrics.py,sha256=hlEeLG4jOR1i_QbWaNQthoko9CSpe-Zn_LHJ2huEFeY,12728
+backend/services/nltk_preloader.py,sha256=TZFghQrpDTi6COcW_rkjL15SlzdRNvPmrdy690fq0hw,3579
 backend/services/packaging_service.py,sha256=MUuBk0jtG3vGQhuOWbDv9u1uIMwbBC4NknLpJYFcWhs,10259
 backend/services/rclone_service.py,sha256=Q6wRAjlBiMMh9FBbbFRp4SHK1ljOQBed9zUJaJgAuhU,3646
+backend/services/spacy_preloader.py,sha256=rpsMZB0CQWcoXjq8nyZCwJBkyjGheKaCFrfhxCOln5w,1836
 backend/services/storage_service.py,sha256=gA7Snz1pihzYpRKZjEZx3eDwyMUBezl3ccLuBdpTwE4,8573
-backend/services/stripe_service.py,sha256=gmw1mQr_TezXFHnjN77df6KOUTpEuuzYewNMmbozaGg,9379
+backend/services/stripe_service.py,sha256=154TbTuysOiuUFKEmIG3RFZYKYEYhLJR2Weyb4xAhxs,13243
 backend/services/structured_logging.py,sha256=daGgZUdc1xIiOdxL9-YtWHDy51hwZqd8ELpomkh2QH4,9063
 backend/services/template_service.py,sha256=5CdSxBGhdBtxIUz24AhvltUfSWcFqZzBIxb9MjlN4YU,11212
 backend/services/theme_service.py,sha256=6lJqMpFjmRY09CMJcW9IJ6DVPffLmwE0DnpXDUKaJ0U,17374
@@ -71,7 +74,7 @@ backend/services/youtube_upload_service.py,sha256=fvo4WxLQaKY_I75ViBMLk6vm87ym2A
 backend/tests/__init__.py,sha256=jTjELMqIzpgHG9dcXwwkszTAAC4Wf-c93C6D1k-toZg,44
 backend/tests/conftest.py,sha256=c4_jH0FIHsiKeUfo3ECPN78MlbW_IARTWwKr9RKLOSM,7843
 backend/tests/emulator/__init__.py,sha256=yOGPU5e0JPNYyUpy-u13jW4gEfWQs3dCJxfincptaCY,156
-backend/tests/emulator/conftest.py,sha256=gBZe23yPM4N2enFVO81ow67GcfGou8HZi7qWK5SI8GU,2858
+backend/tests/emulator/conftest.py,sha256=VXhoJ3NZg3uiLzSAsushQtozFS7Lt6lmjk7ym-k6V8o,3844
 backend/tests/emulator/test_e2e_cli_backend.py,sha256=BTrWDv4sRTeOlheZ-d4R37tZsvJ2MhdFLbDb9tjbF08,41018
 backend/tests/emulator/test_emulator_integration.py,sha256=pm_JzgA2bmjcnHmGA-mZfJhUAYwGx10jv48A2deujRs,11822
 backend/tests/emulator/test_style_loading_direct.py,sha256=e-FzlCVW_-ealM9hTGa2qgpwoVRiYKrcXDWB1FjkwXc,16842
@@ -102,10 +105,10 @@ backend/tests/test_gdrive_service.py,sha256=fh02KPaFqLEWfPaDQvSehn6r6RLq0bgt6MdX
 backend/tests/test_instrumental_api.py,sha256=2eWaoEAYVY02HZgY4esn5echuWGv_sznoO6FYWIgTbQ,17210
 backend/tests/test_internal_api.py,sha256=qMGSDCkYd5OY_Z85vQu10xjqJn1JtaQcaKSnSBpVijw,12980
 backend/tests/test_job_creation_regression.py,sha256=C1KgyNhpJzchl10QK8trfmACs2BrEwYd-WK1YMMS-7I,22602
-backend/tests/test_job_manager.py,sha256=Y1MqanjqARh7HUSntzu2LkG3TFt0UYdIQHZisY7DP2A,12452
+backend/tests/test_job_manager.py,sha256=Y5De6L0BvK4yk6D4w-pDBKBk2R7w89SfSyUz5krgphE,13187
 backend/tests/test_job_manager_notifications.py,sha256=WlzXXxTCmHHCrD4XWu2j2fDYODlHGKThOQpZQeyhPXM,12996
 backend/tests/test_job_notification_service.py,sha256=YbXqCWbsK8O5WICItb3VCrEY8qKqoJ3NBEZtwCs7AYM,17892
-backend/tests/test_jobs_api.py,sha256=HOdP-ULWQFgrL7JDRaaE14HF9xiuHHRt4-5UrgBQGoI,10713
+backend/tests/test_jobs_api.py,sha256=z3pGTawTpt75a1bQ5x4ynw3pTlNihLA6vqktTc6mBAU,11092
 backend/tests/test_local_encoding_service.py,sha256=TbBaFOB-8Re09G-qXIQCl8mS9WlQMFNQF01V64IekyI,14638
 backend/tests/test_local_preview_encoding_service.py,sha256=VwxpcAjDdYaVauSsrJ609U575VWRZbLsXew8BqBXpJY,20228
 backend/tests/test_main.py,sha256=BvzcadLUV0SEUO1ViKm0djgy_TEKXm8PPvgfcCCEJAY,3348
@@ -116,6 +119,7 @@ backend/tests/test_routes_jobs.py,sha256=iqOZ93ACKpizSzLEJUx5hIo0vkKe2oIT7s7iZqQ
 backend/tests/test_routes_review.py,sha256=ENo6_wFUDcyXZhRy_NBqajan9dvqV_7f1rIQ7LLLS-U,14334
 backend/tests/test_services.py,sha256=JSsZZSpa0HjNZBSIrXXzBxZfJewfdR9RC3P8tHV8M8E,24288
 backend/tests/test_services_extended.py,sha256=cBcaEicz4WdBo5WZB77AoGZTwWAOC6W4OslpT6VmFI8,4124
+backend/tests/test_spacy_preloader.py,sha256=uWpkrOPUOOcW1-fWClKMKVhXHGk30FXq537kQH5jpd0,4437
 backend/tests/test_storage_service.py,sha256=gorn3aFwKSr8lihxcG7kza7fYvDsTvxJhOxzuTtPK_o,19069
 backend/tests/test_style_upload.py,sha256=8G2dGgvyMGXsh1jk8PcGpTlSdBQAlHn13kpZcKn6rTY,10491
 backend/tests/test_template_service.py,sha256=BKURQ1M-hXXgdBl9LqhPQKfpItWOYDRBSt1y5FXQzaM,10431
@@ -130,6 +134,7 @@ backend/tests/test_workers.py,sha256=BW-MDQx5HrgICKOcd1KkvzyBO4sOfJXeLVlMiJDfmBw
 backend/tests/test_workers_extended.py,sha256=uFznO4Q2v_H7xjfje5eYXXjS72EnhwXNRcT9YshuB8M,6763
 backend/tests/test_youtube_service.py,sha256=HPm3HUJcu9rKcyRpBfufU6tzMP1lwZ9ZSe0vOoKNypI,9134
 backend/tests/test_youtube_upload_service.py,sha256=o58DXYWLOtp8nmaowO_UHdOErVCDl8YxHJUgI-xvyMs,21428
+backend/utils/test_data.py,sha256=0H0GmV0UnLXe-l0NKAug7COORyQI3PQtbC_qQHllIpI,713
 backend/validate.py,sha256=u8lXKnC1ocXKAaYxNoCE9dRrhvoYI11XrTtaWIp-HLw,5040
 backend/version.py,sha256=Ai-O0n-W-iBIYY_c71-QZikxAsmTpcel4X3T3p8AqVI,677
 backend/workers/README.md,sha256=JYfLyngGkzxl1mRpkppIZB3ou9GR3sRVmZAxIAdURPY,15935
@@ -137,7 +142,7 @@ backend/workers/__init__.py,sha256=Eswp1Jvb6-97r7zUe7FUXSexsCZvghR08qwx1L_4298,3
 backend/workers/audio_worker.py,sha256=9RWIzuhU24fpRMj9JW8cpWODeYsZrbaXhtxddrMFKIo,29088
 backend/workers/lyrics_worker.py,sha256=nsy90pb0BPAl_lbZ0E7d7jIclcXK7W8d9RxxEdJaHVg,35149
 backend/workers/render_video_worker.py,sha256=L6-VCxSBY6MbXBBm0-wu_DXxcIWKfW6ynTv9K03WCjY,25163
-backend/workers/screens_worker.py,sha256=HvSrgpY4X0imu81HygAG-qS024puBWUONx-0fJ4sOe8,20998
+backend/workers/screens_worker.py,sha256=vCS7j4dQRQ_tsWNhz-XH5nau7kGyUSzSp-dzyZpeJEo,21402
 backend/workers/style_helper.py,sha256=7-PM79dAUAZHTj-bnATy43ImqNdl_00E9pm94CYg1BM,6906
 backend/workers/video_worker.py,sha256=49Q7D3bNg38iJk26q2k8y3v-oUscUtE50qaUymlFQbk,55292
 backend/workers/video_worker_orchestrator.py,sha256=NInZjFwztqcYneuxrkDqEFWV7z5BzGlaaoJxj812KA4,27510
@@ -193,7 +198,7 @@ lyrics_transcriber/core/controller.py,sha256=zRjdxOrJEaa2depvzZvwVQiEFmf8Ew3Aek8
 lyrics_transcriber/correction/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lyrics_transcriber/correction/agentic/__init__.py,sha256=p7PHiebuvRs8RDlPDs-9gLZKzXG5KfWg3fFCdDhY6pE,222
 lyrics_transcriber/correction/agentic/adapter.py,sha256=Z0JBTAA7xlSdctCHqO9nBMl78C4XmqsLKKtS6BvNZNI,2912
-lyrics_transcriber/correction/agentic/agent.py,sha256=GV6TkrIQBhibJllXDnp9zBBmaf_vnoSVuJZmm6WVhS0,12722
+lyrics_transcriber/correction/agentic/agent.py,sha256=73E2ouAiE0RUiIvxIb_lVaiIo_DJr_YaH3CAaqdjh08,13274
 lyrics_transcriber/correction/agentic/feedback/aggregator.py,sha256=323t8LDbE26ni83woyN7uVMSuSQhnqTgwJc-d-KuDbs,273
 lyrics_transcriber/correction/agentic/feedback/collector.py,sha256=HT-2cAP_bx7Iv-0-tpZv534do111g0FlTUt2XaKoUtA,415
 lyrics_transcriber/correction/agentic/feedback/retention.py,sha256=dUCUsKPCzHVQxiLLBXcdfAZ5NqiG25go0Z6GFXeK0vY,881
@@ -231,8 +236,8 @@ lyrics_transcriber/correction/agentic/providers/circuit_breaker.py,sha256=D3Jg4Y
 lyrics_transcriber/correction/agentic/providers/config.py,sha256=7m4I3imOZyv-6eR8mxuK9vVdqPEDcGuVAkEgdGWu10w,4299
 lyrics_transcriber/correction/agentic/providers/constants.py,sha256=cXLzKTyFVt9q6wQd_gWcv3EZ5Sm27AOAz6NyPapcess,695
 lyrics_transcriber/correction/agentic/providers/health.py,sha256=F8pHY5BQYvylGRDGXUHplcAJooAyiqVLRhBl4kHC1H8,710
-lyrics_transcriber/correction/agentic/providers/langchain_bridge.py,sha256=KrvjM0jY-7xrP65mW5TfsXnqN2BHcUgaDzcmWv1Rh_U,10423
-lyrics_transcriber/correction/agentic/providers/model_factory.py,sha256=90EjVwoKTWo8jXTrroI7GXM9AU-_ACx9g_fHB4vnR2w,9919
+lyrics_transcriber/correction/agentic/providers/langchain_bridge.py,sha256=fgWZjzWiClBZ1NA6E8pf0kp23j6p56Htry_h7vtJ3ZM,12607
+lyrics_transcriber/correction/agentic/providers/model_factory.py,sha256=ZsPdjSwnN1hFZxPwJkH-2rtgv59f9BmNRJmsLYtK67Q,10805
 lyrics_transcriber/correction/agentic/providers/response_cache.py,sha256=Byr7fQJsgUMFlsvHeVCxTiFjjnbsg3KIlEmEEtAo-Gw,7047
 lyrics_transcriber/correction/agentic/providers/response_parser.py,sha256=c2KypM-yHbIXXakHV5s-qh8fl8FhssLPVo3pJbyAiG4,4301
 lyrics_transcriber/correction/agentic/providers/retry_executor.py,sha256=hX21Zwy2cSECAw7k13ndEinWRqwjo4xYoSCQ2B2CUf0,3912
@@ -241,7 +246,7 @@ lyrics_transcriber/correction/agentic/workflows/__init__.py,sha256=OsBExAbIIKxJg
 lyrics_transcriber/correction/agentic/workflows/consensus_workflow.py,sha256=gMuLTUxkgYaciMsI4yrZSC3wi--7V_PgaDNE-Vd6FE8,575
 lyrics_transcriber/correction/agentic/workflows/correction_graph.py,sha256=kgZKnz0h9cG1EfhW7BSSl-kSpQtJrRM_S86kAniXfE4,1815
 lyrics_transcriber/correction/agentic/workflows/feedback_workflow.py,sha256=KsKLD3AP66YYmXfUn-mVZjERYLtU1Zs4a-7CB2zDfas,596
-lyrics_transcriber/correction/anchor_sequence.py,sha256=5tl4Cjiw5UlLbEb1Oy-g3ebKCinXSwohdaCB9-rTMtI,43798
+lyrics_transcriber/correction/anchor_sequence.py,sha256=-FT4NoNjwGnoxgm4m117Z3DPlJAJAlFYcTe4BeUj9pQ,48974
 lyrics_transcriber/correction/corrector.py,sha256=zqmpwt_LMG1VdijXUIMGr42ny2qIiBqwEIDCslqi2dE,42622
 lyrics_transcriber/correction/feedback/__init__.py,sha256=i1gd0Vb4qvlzZQ3lqA3fJjt288YP7f-MBPwOzZ7Rjh4,68
 lyrics_transcriber/correction/feedback/schemas.py,sha256=OiF_WUqcqiEKIoburYM8kWAIundy82PQE7ImsdP8UCk,4416
@@ -254,11 +259,11 @@ lyrics_transcriber/correction/handlers/no_space_punct_match.py,sha256=jY2fa547Qc
 lyrics_transcriber/correction/handlers/relaxed_word_count_match.py,sha256=x4k__6gav4-STk_TycLcg5Sw4x2vUFAj5fWmOv7Yd_w,3911
 lyrics_transcriber/correction/handlers/repeat.py,sha256=1PJADW44egYh7N9D2fN-gDIusWVglFjGHrCZuTQYNpA,4313
 lyrics_transcriber/correction/handlers/sound_alike.py,sha256=75IvDSfoGUG2xVbYp-xsYuQXf7Jo-0ymsTzdBSOrwwQ,11935
-lyrics_transcriber/correction/handlers/syllables_match.py,sha256=c9_hrJb_xkkqd2SuDjrsSmUF7OMYV65LRzBfAhCHxEY,11217
+lyrics_transcriber/correction/handlers/syllables_match.py,sha256=CV_sYISqPhA2VFbaU2XuX4SbjQcpeuMH7LTw91pgH4I,13103
 lyrics_transcriber/correction/handlers/word_count_match.py,sha256=OltTEs6eYnslxdvak97M5gXDiqXJxMHKk__Q9F_akXc,3595
 lyrics_transcriber/correction/handlers/word_operations.py,sha256=410xhyO9tiqezV5yd5JKwKbxSGwXK9LWHJ7-zNIuOWA,7423
 lyrics_transcriber/correction/operations.py,sha256=rmSxDdlu5H2drbVvR1A9KuaZT60vbHeZKKaB7olD4ns,14659
-lyrics_transcriber/correction/phrase_analyzer.py,sha256=dtO_2LjxnPdHJM7De40mYIdHCkozwhizVVQp5XGO7x0,16962
+lyrics_transcriber/correction/phrase_analyzer.py,sha256=bEGz3KlH8iFAudMK7L0eC-CyVSwZkIZtXr8qh_k4_u8,17576
 lyrics_transcriber/correction/text_utils.py,sha256=7QHK6-PY7Rx1G1E31sWiLBw00mHorRDo-M44KMHFaZs,833
 lyrics_transcriber/frontend/.gitignore,sha256=cR2ofyyWArkna_jByfaWi8gTeMhsKTSoK128PmIw218,262
 lyrics_transcriber/frontend/.yarn/releases/yarn-4.7.0.cjs,sha256=KTYy2KCV2OpHhussV5jIPDdUSr7RftMRhqPsRUmgfAY,2765465
@@ -431,8 +436,8 @@ lyrics_transcriber/transcribers/whisper.py,sha256=YcCB1ic9H6zL1GS0jD0emu8-qlcH0Q
 lyrics_transcriber/types.py,sha256=UJjaxhVd2o14AG4G8ToU598p0JeYdiTFjpG38jGCoYQ,27917
 lyrics_transcriber/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lyrics_transcriber/utils/word_utils.py,sha256=-cMGpj9UV4F6IsoDKAV2i1aiqSO8eI91HMAm_igtVMk,958
-karaoke_gen-0.96.0.dist-info/METADATA,sha256=7yJr3KPMRKSUFYK-U05SfBDGHk9ZpYMGMDmeTPsAf1Q,23115
-karaoke_gen-0.96.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-karaoke_gen-0.96.0.dist-info/entry_points.txt,sha256=xIyLe7K84ZyjO8L0_AmNectz93QjGSs5AkApMtlAd4g,160
-karaoke_gen-0.96.0.dist-info/licenses/LICENSE,sha256=81R_4XwMZDODHD7JcZeUR8IiCU8AD7Ajl6bmwR9tYDk,1074
-karaoke_gen-0.96.0.dist-info/RECORD,,
+karaoke_gen-0.99.3.dist-info/METADATA,sha256=unsN1sCERd0RAJ-G2KFKw1UI_1sUpM-ZG6Sl3FODVJ8,23115
+karaoke_gen-0.99.3.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+karaoke_gen-0.99.3.dist-info/entry_points.txt,sha256=xIyLe7K84ZyjO8L0_AmNectz93QjGSs5AkApMtlAd4g,160
+karaoke_gen-0.99.3.dist-info/licenses/LICENSE,sha256=81R_4XwMZDODHD7JcZeUR8IiCU8AD7Ajl6bmwR9tYDk,1074
+karaoke_gen-0.99.3.dist-info/RECORD,,

lyrics_transcriber/correction/agentic/agent.py

@@ -86,28 +86,39 @@ class AgenticCorrector:
     
     @classmethod
     def from_model(
-        cls, 
-        model: str, 
+        cls,
+        model: str,
         config: ProviderConfig | None = None,
         session_id: Optional[str] = None,
-        cache_dir: Optional[str] = None
+        cache_dir: Optional[str] = None,
+        warmup: bool = True
     ) -> "AgenticCorrector":
         """Factory method to create corrector from model specification.
-        
+
         This is a convenience method for the common case where you want
         to use LangChainBridge with a model spec string.
-        
+
         Args:
             model: Model identifier in format "provider/model"
             config: Optional provider configuration
             session_id: Optional Langfuse session ID to group related traces
             cache_dir: Optional cache directory (uses default if not provided)
-            
+            warmup: If True, eagerly initialize the model to avoid delays when
+                    multiple threads call classify_gap() simultaneously (default: True)
+
         Returns:
             AgenticCorrector instance with LangChainBridge provider
         """
         config = config or ProviderConfig.from_env(cache_dir=cache_dir)
         provider = LangChainBridge(model=model, config=config)
+
+        # Eagerly initialize the model to avoid lazy initialization delays
+        # when multiple threads call classify_gap() simultaneously
+        if warmup:
+            logger.info(f"🤖 Warming up model {model} before parallel processing...")
+            if not provider.warmup():
+                logger.warning(f"🤖 Model warmup failed for {model}, will retry on first use")
+
         return cls(provider=provider, session_id=session_id)
 
     def classify_gap(