fix: make SEC quality gating terminal-safe

tests/unit/test_fundamentals_quality_service.py

@@ -67,27 +67,23 @@ async def test_sec_quality_gate_is_inactive_before_cutover(db_session):
 
 
 
-async def test_promoted_gap_is_blocked_during_queue_migration_bootstrap(db_session):
+async def test_active_gap_is_blocked_until_a_later_filing_supersedes_it(db_session):
     ticker = Ticker(symbol="HIST", cik="0000000043")
+    now = datetime.now(timezone.utc)
     db_session.add_all([
         ticker,
         SystemSetting(
             key="fundamental_data_sec_dolt_cutover_enabled",
             value="true",
         ),
-        DataImportRun(
-            source="sec_facts",
-            status="promoted",
-            validation_json=json.dumps({
-                "missing_xbrl": [{"cik": ticker.cik, "accession": "HIST-Q"}],
-            }),
-            started_at=datetime.now(timezone.utc),
-        ),
-        DataImportRun(
-            source="sec_facts",
-            status="promoted",
-            validation_json=json.dumps({"missing_xbrl": []}),
-            started_at=datetime.now(timezone.utc),
+        SecFilingGap(
+            cik=ticker.cik,
+            accession="HIST-Q",
+            form="10-Q",
+            index_date=date.today().replace(day=1),
+            reason="coregistrant_facts_rejected",
+            first_seen_at=now,
+            last_attempted_at=now,
         ),
     ])
     await db_session.flush()
@@ -99,7 +95,7 @@ async def test_promoted_gap_is_blocked_during_queue_migration_bootstrap(db_sessi
     db_session.add(
         FundamentalSnapshot(
             cik=ticker.cik,
-            accession="HIST-Q",
+            accession="LATER-Q",
             form="10-Q",
             filed_date=date.today(),
             accepted_at=datetime.now(timezone.utc),
@@ -111,3 +107,29 @@ async def test_promoted_gap_is_blocked_during_queue_migration_bootstrap(db_sessi
     await db_session.flush()
 
     assert await fundamentals_quality_service.blocked_ticker_ids(db_session) == set()
+
+
+async def test_ticker_quality_explains_no_xbrl_block(db_session):
+    ticker = Ticker(symbol="NEWREG", cik="0000000044")
+    db_session.add_all([
+        ticker,
+        SystemSetting(
+            key="fundamental_data_sec_dolt_cutover_enabled",
+            value="true",
+        ),
+        DataImportRun(
+            source="sec_facts",
+            status="promoted",
+            validation_json=json.dumps({
+                "setup_blocked_ciks": [ticker.cik],
+                "no_xbrl_filings": [{"cik": ticker.cik}],
+            }),
+            started_at=datetime.now(timezone.utc),
+        ),
+    ])
+    await db_session.flush()
+
+    quality = await fundamentals_quality_service.ticker_quality(db_session, "NEWREG")
+    assert quality.eligible is False
+    assert quality.code == "no_xbrl_filings"
+    assert "CIK override" in (quality.message or "")