"""
report_store.py — Opportunity Report Archive
STATUS: DOCUMENTED_ONLY

Stores and retrieves generated opportunity reports.
In documented_only mode, in-memory only (no persistence).
"""

MODULE_STATUS = "documented_only"

_REPORT_ARCHIVE: list = []


def save_report(report: dict) -> dict:
    if MODULE_STATUS == "documented_only":
        return {"saved": False, "note": "documented_only"}
    _REPORT_ARCHIVE.append(report)
    return {"saved": True, "report_id": report.get("report_id")}


def get_all(limit: int = 20) -> list:
    if MODULE_STATUS == "documented_only":
        return []
    return _REPORT_ARCHIVE[-limit:]


def get_by_id(report_id: str) -> dict:
    for r in _REPORT_ARCHIVE:
        if r.get("report_id") == report_id:
            return r
    return {}


def module_status() -> dict:
    return {
        "module": "report_store",
        "status": MODULE_STATUS,
        "count":  len(_REPORT_ARCHIVE),
    }