test(rag): make RAG server e2e tests opt-in via RAG_E2E

The e2e suite targets a live stack on localhost:9446 with specific env
(ENABLE_GRAPH_RAG, etc.), so it fails by default in unit-test runs.
Gate the module with a skipif so it only runs when RAG_E2E=1, keeping
the default `pytest` run green.

Assisted-by: Claude:claude-opus-4-8
Signed-off-by: Sri Aradhyula <sraradhy@cisco.com>
Co-authored-by: Cursor <cursoragent@cursor.com>

Author: sriaradhyula

ai_platform_engineering/knowledge_bases/rag/server/tests/test_e2e.py

@@ -15,6 +15,19 @@
 import uuid
 
 
+# These tests run against a live RAG server started via docker-compose (see the
+# module docstring). They mutate real state and assert that the server's runtime
+# config matches ENABLE_GRAPH_RAG, so they cannot pass in a plain unit run. They
+# are opt-in: set RAG_E2E=1 (with a matching stack up) to enable them. By default
+# they are skipped so `pytest tests/` stays green without a live stack.
+# assisted-by Cursor claude-opus-4-7
+_RAG_E2E_ENABLED = os.getenv("RAG_E2E", "").strip().lower() in {"1", "true", "yes", "on"}
+pytestmark = pytest.mark.skipif(
+    not _RAG_E2E_ENABLED,
+    reason="Live-stack e2e tests are opt-in; set RAG_E2E=1 with a running docker-compose stack to enable",
+)
+
+
 class TestRAGEndToEnd:
   """End-to-end tests for RAG server functionality."""