create-hedgeboard 1.0.7 → 1.0.8

package/hedgeboard/brand/base.css

@@ -1,419 +0,0 @@
-/* === HedgeBoard Dashboard Styles === */
-/* Used by viz/dashboard.py — loaded into every generated dashboard */
-
-/* Fonts */
-@import url('https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;500;600;700&family=IBM+Plex+Mono:wght@400;500;600&display=swap');
-
-/* ---------------------------------------------------------------------------
-   Grid Layout
-   --------------------------------------------------------------------------- */
-.hb-grid {
-    display: grid;
-    gap: 16px;
-    margin-bottom: 24px;
-}
-
-.hb-grid-2 {
-    grid-template-columns: 1fr 1fr;
-}
-
-.hb-grid-3 {
-    grid-template-columns: 1fr 1fr 1fr;
-}
-
-.hb-grid-cell {
-    min-width: 0;
-    /* prevent overflow */
-}
-
-/* ---------------------------------------------------------------------------
-   KPI Row
-   --------------------------------------------------------------------------- */
-.hb-kpi-row {
-    display: grid;
-    grid-template-columns: repeat(auto-fit, minmax(160px, 1fr));
-    gap: 1px;
-    background: var(--color-surface, #2A2A33);
-    border: 1px solid var(--color-surface, #2A2A33);
-    border-radius: 2px;
-    margin-bottom: 24px;
-    overflow: hidden;
-}
-
-.hb-kpi {
-    background: var(--color-bg, #0C0C10);
-    padding: 20px 24px;
-    display: flex;
-    flex-direction: column;
-    gap: 4px;
-}
-
-.hb-kpi-label {
-    font-family: 'IBM Plex Mono', monospace;
-    font-size: 11px;
-    font-weight: 500;
-    text-transform: uppercase;
-    letter-spacing: 1.5px;
-    color: var(--color-muted, #6B6B78);
-}
-
-.hb-kpi-value {
-    font-family: 'IBM Plex Mono', monospace;
-    font-size: 28px;
-    font-weight: 700;
-    color: var(--color-text, #EAEAEA);
-    letter-spacing: -0.5px;
-    line-height: 1.2;
-}
-
-.hb-kpi-delta {
-    font-family: 'IBM Plex Mono', monospace;
-    font-size: 12px;
-    font-weight: 500;
-}
-
-.hb-delta-up,
-.hb-delta-badge.hb-delta-up {
-    color: #4ADE80;
-}
-
-.hb-delta-down,
-.hb-delta-badge.hb-delta-down {
-    color: #F87171;
-}
-
-.hb-delta-flat,
-.hb-delta-badge.hb-delta-flat {
-    color: #FBBF24;
-}
-
-/* ---------------------------------------------------------------------------
-   Delta Badge (inline)
-   --------------------------------------------------------------------------- */
-.hb-delta-badge {
-    display: inline-flex;
-    font-family: 'IBM Plex Mono', monospace;
-    font-size: 12px;
-    font-weight: 600;
-    padding: 2px 8px;
-    border-radius: 2px;
-    border: 1px solid currentColor;
-    line-height: 1.4;
-}
-
-/* ---------------------------------------------------------------------------
-   Callout Boxes
-   --------------------------------------------------------------------------- */
-.hb-callout {
-    display: flex;
-    gap: 12px;
-    align-items: flex-start;
-    padding: 16px 20px;
-    border-radius: 2px;
-    border-left: 3px solid;
-    margin-bottom: 16px;
-    font-size: 14px;
-    line-height: 1.6;
-    color: var(--color-text, #EAEAEA);
-}
-
-.hb-callout-icon {
-    font-size: 16px;
-    flex-shrink: 0;
-    margin-top: 1px;
-}
-
-.hb-callout-info {
-    background: rgba(96, 165, 250, 0.08);
-    border-color: #60A5FA;
-}
-
-.hb-callout-success {
-    background: rgba(74, 222, 128, 0.08);
-    border-color: #4ADE80;
-}
-
-.hb-callout-warning {
-    background: rgba(251, 191, 36, 0.08);
-    border-color: #FBBF24;
-}
-
-.hb-callout-danger {
-    background: rgba(248, 113, 113, 0.08);
-    border-color: #F87171;
-}
-
-/* ---------------------------------------------------------------------------
-   Scorecard
-   --------------------------------------------------------------------------- */
-.hb-scorecard {
-    background: var(--color-surface, #151519);
-    border: 1px solid var(--color-surface, #2A2A33);
-    border-radius: 2px;
-    padding: 24px;
-    margin-bottom: 24px;
-}
-
-.hb-scorecard-verdict {
-    font-family: 'Space Grotesk', sans-serif;
-    font-size: 28px;
-    font-weight: 700;
-    margin: 8px 0 12px;
-}
-
-.hb-scorecard-reason {
-    font-size: 14px;
-    color: var(--color-muted, #6B6B78);
-    line-height: 1.6;
-}
-
-/* ---------------------------------------------------------------------------
-   Comparison & Heatmap Tables
-   --------------------------------------------------------------------------- */
-.hb-table-title {
-    font-family: 'IBM Plex Mono', monospace;
-    font-size: 11px;
-    font-weight: 500;
-    text-transform: uppercase;
-    letter-spacing: 1.5px;
-    color: var(--color-muted, #6B6B78);
-    margin-bottom: 12px;
-}
-
-.hb-table-wrap {
-    overflow-x: auto;
-    margin-bottom: 24px;
-}
-
-.hb-comp-table {
-    width: 100%;
-    border-collapse: collapse;
-    font-family: 'IBM Plex Mono', monospace;
-    font-size: 13px;
-}
-
-.hb-comp-table th {
-    text-align: left;
-    padding: 10px 16px;
-    font-size: 11px;
-    font-weight: 500;
-    text-transform: uppercase;
-    letter-spacing: 1px;
-    color: var(--color-muted, #6B6B78);
-    border-bottom: 1px solid var(--color-surface, #2A2A33);
-    background: var(--color-surface, #151519);
-}
-
-.hb-comp-table th:not(:first-child) {
-    text-align: right;
-}
-
-.hb-comp-table td {
-    padding: 10px 16px;
-    color: var(--color-text, #B0B0B8);
-    border-bottom: 1px solid var(--color-surface, #2A2A33);
-    font-variant-numeric: tabular-nums;
-}
-
-.hb-comp-table td:not(:first-child) {
-    text-align: right;
-}
-
-.hb-cell-label {
-    color: var(--color-text, #EAEAEA) !important;
-    font-weight: 600;
-}
-
-.hb-cell-best {
-    color: #4ADE80 !important;
-    font-weight: 600;
-}
-
-.hb-cell-worst {
-    color: #F87171 !important;
-    opacity: 0.8;
-}
-
-.hb-comp-table tbody tr:hover {
-    background: rgba(234, 234, 234, 0.03);
-}
-
-/* ---------------------------------------------------------------------------
-   Section Headers
-   --------------------------------------------------------------------------- */
-.hb-section-header {
-    margin: 32px 0 20px;
-    padding-top: 24px;
-    border-top: 1px solid var(--color-surface, #2A2A33);
-}
-
-.hb-section-lbl {
-    display: block;
-    font-family: 'IBM Plex Mono', monospace;
-    font-size: 11px;
-    font-weight: 500;
-    text-transform: uppercase;
-    letter-spacing: 2px;
-    color: var(--color-muted, #6B6B78);
-    margin-bottom: 8px;
-}
-
-.hb-section-title {
-    font-family: 'Space Grotesk', sans-serif;
-    font-size: 22px;
-    font-weight: 700;
-    color: var(--color-text, #EAEAEA);
-    margin-bottom: 8px;
-}
-
-.hb-section-desc {
-    font-size: 14px;
-    color: var(--color-muted, #B0B0B8);
-    line-height: 1.6;
-    max-width: 600px;
-}
-
-/* ---------------------------------------------------------------------------
-   Source Citation Panel
-   --------------------------------------------------------------------------- */
-.hb-sources {
-    margin-top: 32px;
-    border-top: 1px solid var(--color-surface, #2A2A33);
-    padding-top: 16px;
-}
-
-.hb-sources-toggle {
-    font-family: 'IBM Plex Mono', monospace;
-    font-size: 11px;
-    font-weight: 500;
-    text-transform: uppercase;
-    letter-spacing: 1.5px;
-    color: var(--color-muted, #6B6B78);
-    cursor: pointer;
-    padding: 4px 0;
-    list-style: none;
-}
-
-.hb-sources-toggle::marker,
-.hb-sources-toggle::-webkit-details-marker {
-    display: none;
-}
-
-.hb-sources-toggle::before {
-    content: '▸ ';
-}
-
-details[open] .hb-sources-toggle::before {
-    content: '▾ ';
-}
-
-.hb-sources-list {
-    list-style: none;
-    margin-top: 12px;
-    display: flex;
-    flex-direction: column;
-    gap: 6px;
-}
-
-.hb-sources-list li {
-    font-family: 'IBM Plex Mono', monospace;
-    font-size: 11px;
-    color: var(--color-muted, #6B6B78);
-    padding-left: 16px;
-    position: relative;
-}
-
-.hb-sources-list li::before {
-    content: '—';
-    position: absolute;
-    left: 0;
-}
-
-/* ---------------------------------------------------------------------------
-   Timeline
-   --------------------------------------------------------------------------- */
-.hb-timeline {
-    display: flex;
-    gap: 0;
-    overflow-x: auto;
-    padding: 16px 0;
-    margin-bottom: 24px;
-}
-
-.hb-timeline-item {
-    display: flex;
-    flex-direction: column;
-    align-items: center;
-    gap: 8px;
-    min-width: 120px;
-    flex: 1;
-    position: relative;
-}
-
-.hb-timeline-item:not(:last-child)::after {
-    content: '';
-    position: absolute;
-    top: 32px;
-    left: 50%;
-    width: 100%;
-    height: 1px;
-    background: var(--color-surface, #2A2A33);
-}
-
-.hb-timeline-date {
-    font-family: 'IBM Plex Mono', monospace;
-    font-size: 11px;
-    color: var(--color-muted, #6B6B78);
-}
-
-.hb-timeline-dot {
-    width: 8px;
-    height: 8px;
-    border-radius: 50%;
-    background: var(--color-text, #EAEAEA);
-    border: 2px solid var(--color-bg, #0C0C10);
-    z-index: 1;
-}
-
-.hb-timeline-label {
-    font-family: 'Space Grotesk', sans-serif;
-    font-size: 12px;
-    font-weight: 600;
-    color: var(--color-text, #EAEAEA);
-    text-align: center;
-}
-
-.hb-timeline-detail {
-    font-size: 11px;
-    color: var(--color-muted, #6B6B78);
-    text-align: center;
-}
-
-/* ---------------------------------------------------------------------------
-   Sparklines
-   --------------------------------------------------------------------------- */
-.hb-sparkline {
-    display: block;
-    margin-top: 6px;
-}
-
-/* ---------------------------------------------------------------------------
-   Responsive
-   --------------------------------------------------------------------------- */
-@media (max-width: 768px) {
-    .hb-grid-2 {
-        grid-template-columns: 1fr;
-    }
-
-    .hb-grid-3 {
-        grid-template-columns: 1fr;
-    }
-
-    .hb-kpi-row {
-        grid-template-columns: repeat(2, 1fr);
-    }
-
-    .hb-kpi-value {
-        font-size: 22px;
-    }
-}

package/hedgeboard/brand/theme.json

@@ -1,25 +0,0 @@
-{
-    "name": "HedgeBoard",
-    "logo": "",
-    "colors": {
-        "primary": "#EAEAEA",
-        "accent": "#CACACA",
-        "accent_dim": "#888888",
-        "positive": "#4ADE80",
-        "negative": "#F87171",
-        "warning": "#FBBF24",
-        "background": "#0C0C10",
-        "surface": "#151519",
-        "hover": "#1E1E24",
-        "text": "#EAEAEA",
-        "text_secondary": "#B0B0B8",
-        "text_muted": "#6B6B78",
-        "border": "#2A2A33"
-    },
-    "font": {
-        "family": "Space Grotesk",
-        "headings": "Space Grotesk",
-        "mono": "IBM Plex Mono"
-    },
-    "mode": "dark"
-}

package/hedgeboard/data/__init__.py

@@ -1 +0,0 @@
-"""HedgeBoard data access layer."""

package/hedgeboard/data/sec.py

@@ -1,218 +0,0 @@
-"""HedgeBoard SEC data client.
-
-Provides access to SEC filings, XBRL financial facts, and company
-metadata through the HedgeBoard API.
-
-Usage:
-    from data.sec import HedgeBoardClient
-
-    hb = HedgeBoardClient()
-    company = hb.get_company("AAPL")
-    filings = hb.get_filings("AAPL", form_type="10-K")
-    facts = hb.get_xbrl("AAPL", concept="Revenues")
-"""
-
-from __future__ import annotations
-
-import json
-import os
-import sys
-from pathlib import Path
-from typing import Optional
-
-import requests
-from dotenv import load_dotenv
-
-# Load .env from the hedgeboard root
-_root = Path(__file__).resolve().parent.parent
-load_dotenv(_root / ".env")
-
-API_BASE = os.environ.get("HEDGEBOARD_API_URL", "https://3oy6d0glul.execute-api.us-east-1.amazonaws.com/v1")
-API_KEY = os.environ.get("HEDGEBOARD_API_KEY", "")
-
-# Local cache to avoid re-fetching in the same session
-_cache: dict[str, any] = {}
-
-
-class HedgeBoardClient:
-    """Client for the HedgeBoard data API."""
-
-    def __init__(self, api_key: str | None = None, base_url: str | None = None):
-        self.api_key = api_key or API_KEY
-        self.base_url = (base_url or API_BASE).rstrip("/")
-
-        if not self.api_key:
-            print(
-                "⚠️  No API key found. Set HEDGEBOARD_API_KEY in hedgeboard/.env",
-                file=sys.stderr,
-            )
-
-    # ------------------------------------------------------------------
-    # Internal helpers
-    # ------------------------------------------------------------------
-
-    def _get(self, path: str, params: dict | None = None) -> dict | list | str:
-        """Make an authenticated GET request to the HedgeBoard API."""
-        cache_key = f"{path}|{json.dumps(params or {}, sort_keys=True)}"
-        if cache_key in _cache:
-            return _cache[cache_key]
-
-        url = f"{self.base_url}{path}"
-        headers = {"x-api-key": self.api_key}
-        resp = requests.get(url, headers=headers, params=params, timeout=30)
-
-        if resp.status_code == 403:
-            raise PermissionError("Invalid API key. Check HEDGEBOARD_API_KEY in .env")
-        if resp.status_code == 404:
-            return None
-        if resp.status_code == 429:
-            raise RuntimeError("Rate limit exceeded. Wait a moment and try again.")
-        resp.raise_for_status()
-
-        # Filing HTML comes as text, everything else as JSON
-        content_type = resp.headers.get("content-type", "")
-        if "text/html" in content_type:
-            data = resp.text
-        else:
-            data = resp.json()
-
-        _cache[cache_key] = data
-        return data
-
-    # ------------------------------------------------------------------
-    # Companies
-    # ------------------------------------------------------------------
-
-    def get_company(self, ticker: str) -> dict | None:
-        """Get company metadata by ticker.
-
-        Returns:
-            Dict with keys: cik, name, ticker, exchange, sic, sic_description,
-            category, entity_type, state, etc. None if not found.
-        """
-        return self._get("/v1/companies", params={"ticker": ticker.upper()})
-
-    def search_companies(self, query: str, limit: int = 20) -> list[dict]:
-        """Search companies by name, ticker, or sector.
-
-        Returns:
-            List of matching company dicts.
-        """
-        result = self._get(
-            "/v1/companies/search",
-            params={"q": query, "limit": limit},
-        )
-        return result if result else []
-
-    # ------------------------------------------------------------------
-    # Filings
-    # ------------------------------------------------------------------
-
-    def get_filings(
-        self,
-        ticker: str,
-        form_type: str | None = None,
-        limit: int = 10,
-    ) -> list[dict]:
-        """Get SEC filing metadata for a company.
-
-        Args:
-            ticker: Company ticker symbol.
-            form_type: Filter by form type (e.g., "10-K", "10-Q").
-            limit: Maximum number of filings to return.
-
-        Returns:
-            List of filing dicts with keys: filing_date, form_type,
-            accession_number, s3_key, primary_doc_url, etc.
-            Sorted by filing_date descending (newest first).
-        """
-        params = {"ticker": ticker.upper(), "limit": limit}
-        if form_type:
-            params["type"] = form_type
-        result = self._get("/v1/filings", params=params)
-        return result if result else []
-
-    def get_filing_html(self, s3_key: str) -> str | None:
-        """Get the raw cleaned HTML of a filing document.
-
-        Args:
-            s3_key: The S3 key from a filing record (e.g., "raw/...").
-
-        Returns:
-            HTML string, or None if not found.
-        """
-        return self._get("/v1/filings/html", params={"key": s3_key})
-
-    # ------------------------------------------------------------------
-    # XBRL Financial Facts
-    # ------------------------------------------------------------------
-
-    def get_xbrl(
-        self,
-        ticker: str,
-        concept: str | None = None,
-        form_type: str | None = None,
-        limit: int = 40,
-    ) -> list[dict]:
-        """Get structured XBRL financial facts for a company.
-
-        Args:
-            ticker: Company ticker symbol.
-            concept: XBRL concept name to filter (e.g., "Revenues",
-                     "NetIncomeLoss", "EarningsPerShareBasic").
-                     If None, returns all concepts.
-            form_type: Filter by form type (e.g., "10-K" for annual only).
-            limit: Maximum number of facts to return.
-
-        Returns:
-            List of fact dicts with keys: concept, label, value, unit,
-            period_start, period_end, form, filed, taxonomy.
-            Sorted by period_end descending (newest first).
-        """
-        params = {"ticker": ticker.upper(), "limit": limit}
-        if concept:
-            params["concept"] = concept
-        if form_type:
-            params["form"] = form_type
-        result = self._get("/v1/xbrl", params=params)
-        return result if result else []
-
-    def get_key_financials(
-        self,
-        ticker: str,
-        form_type: str = "10-K",
-        periods: int = 5,
-    ) -> dict[str, list[dict]]:
-        """Convenience: get key financial metrics for a company.
-
-        Returns a dict mapping concept name to list of fact records:
-            {
-                "Revenues": [{period_end, value, ...}, ...],
-                "NetIncomeLoss": [...],
-                "EarningsPerShareBasic": [...],
-                "Assets": [...],
-                "StockholdersEquity": [...],
-            }
-        """
-        key_concepts = [
-            "Revenues",
-            "RevenueFromContractWithCustomerExcludingAssessedTax",
-            "NetIncomeLoss",
-            "EarningsPerShareBasic",
-            "EarningsPerShareDiluted",
-            "Assets",
-            "Liabilities",
-            "StockholdersEquity",
-            "OperatingIncomeLoss",
-            "CashAndCashEquivalentsAtCarryingValue",
-        ]
-
-        results: dict[str, list[dict]] = {}
-        for concept in key_concepts:
-            facts = self.get_xbrl(
-                ticker, concept=concept, form_type=form_type, limit=periods
-            )
-            if facts:
-                results[concept] = facts
-
-        return results

package/hedgeboard/modules/__init__.py

@@ -1 +0,0 @@
-"""HedgeBoard analysis modules."""