initial commit — cassandra v0.1

Containerised macro-strategy dashboard: 4-panel web UI (indicators,
portfolio, flash news, AI strategic log), MariaDB store, hourly
ingestion jobs, OpenRouter-backed AI analysis.

Ports the four prototype scripts in the parent dir (market_pulse,
flash_news, trading212, strategic_log) into async services backed by a
persistent DB and served via FastAPI + Jinja2 + HTMX. APScheduler runs
as a separate compose service for crash-safety and easier restarts.

Portfolio composition + position names come live from Trading 212;
news per-ticker headlines reuse those names. Tone (NOVICE/INTERMEDIATE/
PRO) and analysis style (DRY/SPECULATIVE) are env-configurable and
stored on each log row so historical entries show what produced them.

Default model is deepseek/deepseek-v4-flash (overridable via env).
Light/dark theme toggle, sans-serif for prose surfaces, monospace for
data. Bearer-token auth, OpenRouter monthly cost cap, RSS feeds auto-
disabled on consecutive failures.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

tests/test_api_helpers.py

@@ -0,0 +1,37 @@
+"""Tests for tiny helpers in app.routers.api."""
+from __future__ import annotations
+
+import pytest
+
+pytest.importorskip("fastapi")
+pytest.importorskip("sqlalchemy")
+
+from datetime import datetime, timedelta, timezone
+
+from app.routers.api import _fmt_age, _md_to_html
+
+
+def test_fmt_age_none():
+    assert _fmt_age(datetime.now(timezone.utc), None) == "—"
+
+
+def test_fmt_age_units():
+    now = datetime(2026, 5, 15, 12, 0, tzinfo=timezone.utc)
+    assert _fmt_age(now, now - timedelta(seconds=30)) == "30s"
+    assert _fmt_age(now, now - timedelta(minutes=5)) == "5m"
+    assert _fmt_age(now, now - timedelta(hours=3)) == "3h"
+    assert _fmt_age(now, now - timedelta(days=2)) == "2d"
+
+
+def test_md_to_html_headers_and_bold():
+    src = "## Section one\n\nBody text with **bold** word.\n\n## Section two\n\nMore."
+    out = _md_to_html(src)
+    assert "<h3>Section one</h3>" in out
+    assert "<strong>bold</strong>" in out
+    assert "<p>" in out
+
+
+def test_md_to_html_preserves_line_breaks_inside_block():
+    src = "Line one\nLine two"
+    out = _md_to_html(src)
+    assert "Line one<br>Line two" in out