phase 0+1: project scaffold, k8s manifests, CI pipeline, steering, hooks, tests

- Repository structure for all services, infra, lakehouse, dashboards - K8s manifests targeting stonks-oracle namespace with GHCR images - Ingress via Traefik with ca-issuer TLS for internal services - ConfigMap wired to existing cluster services (pg, redis, minio, ollama) - GitHub Actions workflow for lint, test, multi-service container builds - Dockerfile with build-arg CMD per service - Makefile for local build/push/deploy - Steering rules for TDD workflow, K8s conventions, project context - Agent hooks for lint-on-save, test-on-save, k8s-validate, phase-commit - Ruff linter config, all lint issues fixed - 14 passing tests for schemas, config, redis keys - PostgreSQL migrations, Trino catalogs, Superset config, MinIO lifecycle
2026-04-11 03:25:08 -07:00
parent 8cfc4f423b
commit ebea70573b
90 changed files with 3590 additions and 19 deletions
@@ -0,0 +1,58 @@
+"""Filings / Regulatory API adapter - fetches SEC-style submissions."""
+import hashlib
+import logging
+from datetime import datetime
+from typing import Any, Dict
+
+import httpx
+
+from .base import AdapterResult, BaseAdapter
+
+logger = logging.getLogger("filings_adapter")
+
+
+class FilingsAdapter(BaseAdapter):
+    """Concrete adapter for SEC EDGAR or similar filings API."""
+
+    def __init__(self, base_url: str = "https://efts.sec.gov", user_agent: str = "StonksOracle/1.0"):
+        self.base_url = base_url
+        self.user_agent = user_agent
+
+    def source_type(self) -> str:
+        return "filings_api"
+
+    async def fetch(self, ticker: str, config: Dict[str, Any]) -> AdapterResult:
+        _cik = config.get("cik", "")
+        endpoint = config.get("endpoint", f"/LATEST/search-index?q=%22{ticker}%22&dateRange=custom&startdt=2026-01-01&forms=8-K,10-Q,10-K")
+        url = f"{self.base_url}{endpoint}"
+
+        headers = {"User-Agent": self.user_agent}
+
+        async with httpx.AsyncClient(timeout=30) as client:
+            try:
+                resp = await client.get(url, headers=headers)
+                resp.raise_for_status()
+                raw = resp.content
+                data = resp.json()
+                content_hash = hashlib.sha256(raw).hexdigest()
+
+                hits = data.get("hits", {}).get("hits", [])
+                return AdapterResult(
+                    source_type="filings_api",
+                    ticker=ticker,
+                    items=hits,
+                    raw_payload=raw,
+                    content_hash=content_hash,
+                    fetched_at=datetime.utcnow(),
+                )
+            except Exception as e:
+                logger.error(f"Filings fetch failed for {ticker}: {e}")
+                return AdapterResult(
+                    source_type="filings_api",
+                    ticker=ticker,
+                    items=[],
+                    raw_payload=b"",
+                    content_hash="",
+                    fetched_at=datetime.utcnow(),
+                    error=str(e),
+                )