Create README.md

README.md

@@ -1,54 +1,60 @@
----
-title: Federal FOIA Intelligence Search
-emoji: 🏛️
-colorFrom: blue
-colorTo: indigo
-sdk: gradio
-sdk_version: 6.3.0
-app_file: app.py
-pinned: false
-tags:
-- foia
-- public-records
-- journalism
-- government
-- transparency
-- research
-- intelligence-history
----
+# 🏛️ Federal FOIA Intelligence Search
 
-# Federal FOIA Intelligence Search
-### *Public Electronic Reading Rooms Only*
+**Public Electronic Reading Rooms Only**
 
-A public-interest research platform for discovering documents **already
-released by U.S. Government agencies** under the Freedom of Information Act (FOIA).
+A federated discovery system for **lawfully published U.S. Government FOIA Electronic Reading Rooms**.
 
 ---
 
 ## What This Is
 
-- Federated search across FOIA Electronic Reading Rooms
-- Journalism, academic, and historical research focused
-- Lawful, public-only source indexing
-- Clear agency attribution and transparency
+This application enables journalists, researchers, and the public to:
+
+- Search FOIA Electronic Reading Rooms across U.S. agencies
+- View document previews and citations
+- Analyze coverage, timelines, and semantic clusters
+- Export selected documents for reporting or research
 
 ---
 
-## What This Is Not
+## What This Is NOT
 
-- ❌ No classified access
-- ❌ No scraping of restricted systems
-- ❌ No bypass of agency controls
-- ❌ No inference beyond the public record
+- ❌ Not a classified system
+- ❌ No access to restricted or internal databases
+- ❌ No circumvention of access controls
+- ❌ No declassification or inference of sensitive data
 
 ---
 
-## Safety & Compliance
+## Safeguards
 
-- Robots.txt enforcement per agency
+- Robots.txt enforcement per adapter
+- Public-only URLs
 - Per-agency kill switches
-- Redaction-aware previews
-- Extended features are **opt-in and clearly labeled**
+- Adapter compliance tests
+- Latency & health monitoring
+
+---
+
+## Features
+
+- 🔍 Federated keyword search
+- 🧠 FAISS-backed semantic clustering
+- 🗺️ Agency coverage heatmap
+- ⏱️ Adapter latency / health badges
+- ⚖️ FOIA exemption (b-code) classification
+- 🧾 Journalist ZIP export
+- 🧪 CI adapter compliance tests
+- 📊 Explainability & regulator-facing reporting
+
+---
+
+## Intended Use
+
+Research, journalism, historical analysis, and public accountability.
+
+---
+
+## License
 
-This Space exists to **increase transparency and accessibility** of
-records the public already has a legal right to access.
+MIT — with explicit restriction against misuse or misrepresentation of access level.