fix(telegram): support matrix source contracts in container

apps/api/src/services/telegram_alert_ai_automation_matrix.py

@@ -355,29 +355,29 @@ def _require_safe_boundaries(*payloads: dict[str, Any]) -> None:
 def _inspect_source_contract(repo_root: Path) -> dict[str, int | bool]:
     source_checks = {
         "telegram_gateway_mirror_present": (
-            repo_root / "apps/api/src/services/telegram_gateway.py",
+            "apps/api/src/services/telegram_gateway.py",
             "_mirror_outbound_message",
         ),
         "telegram_gateway_record_outbound_present": (
-            repo_root / "apps/api/src/services/telegram_gateway.py",
+            "apps/api/src/services/telegram_gateway.py",
             "record_outbound_message",
         ),
         "ai_alert_card_metadata_present": (
-            repo_root / "apps/api/src/services/telegram_gateway.py",
+            "apps/api/src/services/telegram_gateway.py",
             "ai_automation_alert_card_mirror_v1",
         ),
         "outbound_message_model_present": (
-            repo_root / "apps/api/src/db/awooop_models.py",
+            "apps/api/src/db/awooop_models.py",
             "__tablename__ = \"awooop_outbound_message\"",
         ),
         "ai_alert_card_delivery_readback_endpoint_present": (
-            repo_root / "apps/api/src/api/v1/platform/operator_runs.py",
+            "apps/api/src/api/v1/platform/operator_runs.py",
             "/runs/ai-alert-cards",
         ),
     }
     result: dict[str, int | bool] = {}
-    for key, (path, marker) in source_checks.items():
-        text = path.read_text(encoding="utf-8", errors="replace") if path.exists() else ""
+    for key, (relative_path, marker) in source_checks.items():
+        text = _read_source_contract_text(repo_root, relative_path)
         present = marker in text
         result[key] = present
         if key == "ai_alert_card_delivery_readback_endpoint_present":
@@ -389,6 +389,18 @@ def _inspect_source_contract(repo_root: Path) -> dict[str, int | bool]:
     return result
 
 
+def _read_source_contract_text(repo_root: Path, relative_path: str) -> str:
+    candidates = [repo_root / relative_path]
+    api_prefix = "apps/api/"
+    if relative_path.startswith(api_prefix):
+        candidates.append(repo_root / relative_path.removeprefix(api_prefix))
+
+    for path in candidates:
+        if path.exists():
+            return path.read_text(encoding="utf-8", errors="replace")
+    return ""
+
+
 def _next_priority_action(
     *,
     api_direct_gap_count: int,

apps/api/tests/test_telegram_alert_ai_automation_matrix_api.py

@@ -7,6 +7,7 @@ from fastapi.testclient import TestClient
 
 from src.api.v1.agents import router
 from src.services.telegram_alert_ai_automation_matrix import (
+    _inspect_source_contract,
     load_latest_telegram_alert_ai_automation_matrix,
 )
 
@@ -90,6 +91,35 @@ def test_telegram_alert_ai_automation_matrix_loader_returns_gap_matrix():
         assert marker not in serialized
 
 
+def test_telegram_matrix_source_contract_supports_container_layout(tmp_path):
+    (tmp_path / "src/services").mkdir(parents=True)
+    (tmp_path / "src/db").mkdir(parents=True)
+    (tmp_path / "src/api/v1/platform").mkdir(parents=True)
+    (tmp_path / "src/services/telegram_gateway.py").write_text(
+        "_mirror_outbound_message\n"
+        "record_outbound_message\n"
+        "ai_automation_alert_card_mirror_v1\n",
+        encoding="utf-8",
+    )
+    (tmp_path / "src/db/awooop_models.py").write_text(
+        '__tablename__ = "awooop_outbound_message"\n',
+        encoding="utf-8",
+    )
+    (tmp_path / "src/api/v1/platform/operator_runs.py").write_text(
+        '"/runs/ai-alert-cards"\n',
+        encoding="utf-8",
+    )
+
+    proof = _inspect_source_contract(tmp_path)
+
+    assert proof["telegram_gateway_mirror_present"] is True
+    assert proof["telegram_gateway_record_outbound_present"] is True
+    assert proof["ai_alert_card_metadata_present"] is True
+    assert proof["outbound_message_model_present"] is True
+    assert proof["ai_alert_card_delivery_readback_endpoint_present"] is True
+    assert proof["ai_alert_card_delivery_readback_endpoint_count"] == 1
+
+
 def test_telegram_alert_ai_automation_matrix_endpoint_returns_readback():
     app = FastAPI()
     app.include_router(router, prefix="/api/v1")