feat: ship persistent ai playground and alerts foundation

backend/app/services/bgp_ai_brief_store.py

@@ -4,6 +4,7 @@ import json
 from dataclasses import dataclass
 from datetime import UTC, datetime
 from pathlib import Path
+from typing import Any
 from uuid import uuid4
 
 from app.core.config import ROOT_DIR
@@ -25,6 +26,8 @@ class _StoredBrief:
     request_id: str | None
     generated_at: str
     content_markdown: str
+    facts: list[str]
+    context: dict[str, Any]
     path: Path
 
 
@@ -33,7 +36,7 @@ def _ensure_storage_dir() -> Path:
     return _BRIEF_STORAGE_DIR
 
 
-def _build_metadata_line(metadata: dict[str, str | None]) -> str:
+def _build_metadata_line(metadata: dict[str, Any]) -> str:
     return f"{_METADATA_PREFIX}{json.dumps(metadata, ensure_ascii=False)}{_METADATA_SUFFIX}"
 
 
@@ -62,6 +65,8 @@ def _parse_brief_file(path: Path) -> _StoredBrief | None:
         request_id=metadata.get("request_id"),
         generated_at=str(metadata.get("generated_at") or datetime.fromtimestamp(path.stat().st_mtime, UTC).isoformat()),
         content_markdown=remainder.lstrip("\n"),
+        facts=list(metadata.get("facts") or []),
+        context=dict(metadata.get("context") or {}),
         path=path,
     )
 
@@ -104,6 +109,8 @@ def get_bgp_brief_record(brief_id: str) -> BGPBriefRecordResponse | None:
         request_id=parsed.request_id,
         generated_at=parsed.generated_at,
         content_markdown=parsed.content_markdown,
+        facts=parsed.facts,
+        context=parsed.context,
     )
 
 
@@ -118,6 +125,8 @@ def save_bgp_brief_record(
     analysis: SituationalAnalysisResponse,
     *,
     request_id: str | None,
+    facts: list[str] | None = None,
+    context: dict[str, Any] | None = None,
     generated_at: datetime | None = None,
 ) -> BGPBriefRecordResponse:
     created_at = generated_at or datetime.now(UTC)
@@ -131,6 +140,8 @@ def save_bgp_brief_record(
         "model": analysis.model,
         "request_id": request_id,
         "generated_at": created_at.isoformat(),
+        "facts": facts or [],
+        "context": context or {},
     }
 
     markdown_text = f"{_build_metadata_line(metadata)}\n\n{analysis.content.rstrip()}\n"
@@ -144,4 +155,6 @@ def save_bgp_brief_record(
         request_id=request_id,
         generated_at=created_at.isoformat(),
         content_markdown=analysis.content,
+        facts=facts or [],
+        context=context or {},
     )