"""
Regulator-Facing Explainability Report
Federal FOIA Intelligence Search
Public Electronic Reading Rooms Only
"""

from datetime import datetime


def generate_report(stats: dict) -> str:
    return f"""
Federal FOIA Intelligence Search
Explainability Report

Generated: {datetime.utcnow().isoformat()} UTC

Scope
-----
This system indexes only documents already released to the public
via U.S. Government FOIA Electronic Reading Rooms.

Data Sources
------------
- Agency-managed FOIA portals
- Public PDFs and HTML disclosures
- No internal or restricted systems

Safeguards
----------
- Robots.txt enforcement
- Per-agency kill switches
- Adapter compliance testing
- No authentication bypass
- No scraping beyond published endpoints

Analytics
---------
- Keyword-based retrieval
- Optional semantic clustering (FAISS)
- No predictive inference
- No content alteration

Results Summary
---------------
Total Documents: {stats.get('total_docs', 'N/A')}
Agencies Covered: {len(stats.get('agencies', []))}

Compliance Statement
--------------------
This system complies with FOIA, CFAA, and platform terms by design.
"""