Merge pull request #2705 from langbot-app/test/required-contract-suites

test(ci): decouple required suites from test names and counts

tests/integration/persistence/test_migration_branch_convergence.py

@@ -39,7 +39,7 @@ ACCOUNT = '41100000-0000-4000-8000-000000000002'
 NOW = datetime.datetime(2026, 9, 1)
 
 
-@pytest.fixture(params=['sqlite', pytest.param('postgresql', marks=pytest.mark.slow)])
+@pytest.fixture(params=['sqlite', pytest.param('postgresql', marks=[pytest.mark.slow, pytest.mark.postgres])])
 async def convergence_engine(request, tmp_path):
     if request.param == 'sqlite':
         engine = create_async_engine(f'sqlite+aiosqlite:///{tmp_path / "convergence.db"}')
@@ -354,6 +354,7 @@ async def _assert_merged_schema_and_data(engine, source):
         ('beta', None),
     ],
 )
+@pytest.mark.contract('migration_history')
 async def test_historical_schema_and_populated_branch_upgrade(convergence_engine, source, checkpoint):
     engine = convergence_engine
     fixture = json.loads((FIXTURES / f'{source}_schema.json').read_text())
@@ -395,6 +396,7 @@ async def test_historical_schema_and_populated_branch_upgrade(convergence_engine
 
 
 @pytest.mark.asyncio
+@pytest.mark.contract('migration_fresh_schema')
 async def test_empty_database_startup_schema_then_real_migrations(convergence_engine):
     engine = convergence_engine
     async with engine.begin() as conn:

tests/integration/persistence/test_pipeline_admission_postgres.py

@@ -12,7 +12,11 @@ from langbot.pkg.persistence.pipeline_admission import lock_pipeline_admission
 from langbot.pkg.entity.persistence.agent_interaction import AgentInteraction
 
 URL = os.environ.get('LANGBOT_ADMISSION_TEST_URL')
-pytestmark = [pytest.mark.asyncio, pytest.mark.skipif(not URL, reason='disposable PostgreSQL URL required')]
+pytestmark = [
+    pytest.mark.postgres,
+    pytest.mark.asyncio,
+    pytest.mark.skipif(not URL, reason='disposable PostgreSQL URL required'),
+]
 
 
 @pytest.fixture
@@ -111,6 +115,7 @@ async def test_real_writer_waits_and_revalidates_after_transaction(env, outcome)
         assert (await writer)[0]['status'] == 'pending'
 
 
+@pytest.mark.contract('admission_isolation')
 async def test_real_writer_first_blocks_migration_and_other_tenant_isolated(env):
     await write(env)
     async with env.pm.tenant_uow(base.WS) as uow:

tests/integration/persistence/test_rag_document_identity.py

@@ -54,7 +54,7 @@ DOCUMENT_IDENTITY_REVISION = '0025_rag_document_identity'
 CONTEXT = ExecutionContext(instance_uuid='instance-a', workspace_uuid='workspace-a', placement_generation=5)
 
 
-@pytest_asyncio.fixture(params=['sqlite', 'postgres'])
+@pytest_asyncio.fixture(params=['sqlite', pytest.param('postgres', marks=pytest.mark.postgres)])
 async def database(request, tmp_path):
     admin = None
     schema = 'ke_identity_' + uuid.uuid4().hex
@@ -183,6 +183,7 @@ async def read_file_row(runtime, file_id='host-id'):
 @pytest.mark.parametrize(
     'engine_id', ['dify-upstream', 'fastgpt-collection', 'ragflow-upstream', 'host-id', ' opaque ID ']
 )
+@pytest.mark.contract('rag_identity')
 async def test_ingest_persists_exact_engine_identity_and_restart_delete(runtime, engine_id):
     file = await seed(runtime)
     runtime.ap.plugin_connector.call_rag_ingest.return_value['document_id'] = engine_id

tests/integration/persistence/test_rag_interrupted_ingestion.py

@@ -25,6 +25,7 @@ def attach_task_manager(runtime):
 
 
 @pytest.mark.asyncio
+@pytest.mark.contract('rag_recovery')
 async def test_cancelled_ingestion_retains_recovery_resources(runtime):
     """Local cancellation is interrupted observation, not remote quiescence."""
     file = await seed(runtime)

tests/integration/persistence/test_runner_timestamps_postgres.py

@@ -25,7 +25,12 @@ from langbot.pkg.entity.persistence.base import Base
 from langbot.pkg.entity.persistence.event_log import EventLog
 from langbot.pkg.entity.persistence.transcript import Transcript
 
-pytestmark = [pytest.mark.integration, pytest.mark.slow, pytest.mark.asyncio]
+pytestmark = [
+    pytest.mark.postgres,
+    pytest.mark.integration,
+    pytest.mark.slow,
+    pytest.mark.asyncio,
+]
 
 UTC = dt.timezone.utc
 NOW = dt.datetime(2026, 9, 22, 4, 5, 6, 123000, tzinfo=UTC)
@@ -110,6 +115,7 @@ async def _legacy_run(engine, *, status='queued'):
         )
 
 
+@pytest.mark.contract('runner_timestamps')
 async def test_run_lifecycle_deadline_events_and_stats(pg_engine):
     store = run_ledger_store.RunLedgerStore(pg_engine)
     deadline = NOW + dt.timedelta(minutes=5)

tests/integration/vector/test_seekdb.py

@@ -14,16 +14,14 @@ import uuid
 
 import pytest
 
-pytest.importorskip('pyseekdb')
-
-from langbot.pkg.vector.vdbs.seekdb import SeekDBVectorDatabase
-
-
-pytestmark = [pytest.mark.integration, pytest.mark.slow]
+pytestmark = [pytest.mark.integration, pytest.mark.slow, pytest.mark.seekdb]
 
 
 @pytest.fixture
 async def backend(tmp_path):
+    pytest.importorskip('pyseekdb')
+    from langbot.pkg.vector.vdbs.seekdb import SeekDBVectorDatabase
+
     app = SimpleNamespace(
         instance_config=SimpleNamespace(
             data={
@@ -51,6 +49,7 @@ async def backend(tmp_path):
 
 
 @pytest.mark.asyncio
+@pytest.mark.contract('vector_round_trip')
 async def test_upsert_and_text_round_trip(backend) -> None:
     database, collection = backend
     original = 'He said "hello".\nC:\\notes\\file.txt isn\'t empty. 中文'
@@ -80,6 +79,7 @@ async def test_upsert_and_text_round_trip(backend) -> None:
 
 
 @pytest.mark.asyncio
+@pytest.mark.contract('hybrid_relevance')
 async def test_full_text_and_hybrid_results_keep_relevance_order(backend) -> None:
     database, collection = backend
     documents = [