Update README.md

README.md

@@ -13,215 +13,98 @@ short_description: 'FOIA DECLASSIFIED DOCUMENTS SEARCH '
 
 # 🏛️ Federal FOIA Intelligence Search
 
-**Public FOIA Electronic Reading Rooms • Link-Out Only • Court-Aware**
+**Public FOIA Electronic Reading Rooms — Link-Out Search Only**
 
-A Hugging Face–hosted research, journalism, and legal-support tool for discovering, organizing, and exporting **public U.S. government FOIA materials** from official electronic reading rooms.
+This Hugging Face Space provides a **federated discovery interface** for official U.S. Government Freedom of Information Act (FOIA) Electronic Reading Rooms.
 
-This application **does not scrape, host, or redistribute documents**.  
-All results are **direct links to official government FOIA libraries**.
+⚠️ **This application does not scrape, crawl, mirror, store, or redistribute documents.**  
+All results link directly to authoritative government sources.
 
 ---
 
-## 🔍 Core Capabilities
+## 🎯 Purpose
 
-### ✔ Federated FOIA Search (LIVE)
-Search across multiple U.S. government FOIA libraries simultaneously.
-
-**LIVE Agencies (Public & Safe):**
-- CIA — FOIA Electronic Reading Room  
-- FBI — The Vault  
-- DOJ — FOIA Library  
-- DHS — FOIA Reading Room  
-- State Department — FOIA Search  
-- GSA — FOIA Library  
-- NSA — FOIA Reading Room  
-
-All results link directly to official government sources.
+- Accelerate public-interest research
+- Support journalism, litigation prep, and academic inquiry
+- Provide court-ready citations and documentation workflows
+- Enable **explicitly gated AI analysis** for public documents
 
 ---
 
-### 🧪 Extended Coverage (Clearly Labeled STUBS)
-Optional **non-exportable indicators** for agencies where automated access may be restricted or ambiguous.
-
-- DIA
-- NGA
-- NRO
-- TEN-CAP
-- AATIP
-- SAP / Special Activities
+## ✔️ Core Guarantees
 
-**STUB results:**
-- ❌ No URLs
-- ❌ No exports
-- ❌ No PDFs
-- ❌ No citations
-
-This separation is a **deliberate compliance safeguard**.
+- 🔗 **Link-out only** to official FOIA libraries  
+- 📄 **No document hosting or redistribution**  
+- 🧾 **Bluebook-formatted citations**  
+- 🧠 **AI analysis is explicit opt-in**  
+- ⚖️ **LIVE results only are exportable**  
+- 🚫 **STUB coverage is informational only**  
 
 ---
 
-### 📄 PDF Thumbnail Gallery
-For results that link directly to `.pdf` files:
-
-- Inline iframe preview (HF-safe)
-- Action buttons:
-  - **View**
-  - **Download**
-  - **Share** (device-native share API if supported)
-  - **Ask AI** (safe placeholder — no ingestion)
+## 🏛️ Live FOIA Sources
 
-> PDFs are never downloaded, cached, or stored by the app.
+| Agency | Official Source |
+|------|----------------|
+| CIA | cia.gov/readingroom |
+| FBI | vault.fbi.gov |
+| DOJ | justice.gov/foia |
+| DHS | dhs.gov/foia |
+| State Dept | foia.state.gov |
+| GSA | gsa.gov |
+| NSA | nsa.gov |
 
 ---
 
-### 🗂 Journalist ZIP Export (LIVE Only)
-Generates a ZIP package for editorial or investigative workflows.
+## 🧠 AI & Semantic Features (Opt-In)
 
-**Contents:**
-- `README.txt` — scope & disclaimer
-- `citations.txt` — Bluebook-ready citations
-- `links.csv` — agency, title, URL, timestamp
-- `pdf_links.txt` — direct PDF URLs (no files)
+AI functionality is **disabled by default**.
 
-✔ Public sources only  
-✔ No redistribution  
-✔ No STUB data  
+When enabled by the user:
+- PDFs are processed **only when explicitly selected**
+- AI analysis is **user-initiated**
+- Outputs include:
+  - Disclosure footer
+  - Integrity hash
+  - Source citation
+- AI output **is not a primary source** and **not legal advice**
 
----
-
-### 🌐 Public Shareable Result Pages
-Generate static, shareable result summaries containing:
-- Agency + title
-- Direct source links
-- Bluebook citations
-- Citation hash for integrity verification
+Optional FAISS semantic indexing operates on **metadata only** unless PDF analysis is explicitly requested.
 
 ---
 
-### ⚖️ Court-Aware Features
-Each LIVE result includes:
-- SHA-256 citation hash
-- Bluebook citation
-- Retrieval timestamp
+## 🗂️ Exports & Research Tools
 
-Supports:
-- Litigation appendices
-- Exhibit preparation
-- Evidentiary traceability
+- 🧾 Bluebook citations
+- 📦 Journalist ZIP (links + citations only)
+- 📄 FOIA request generator (PDF)
+- 🏛️ Litigation appendix generator
+- 📊 Entity graphs & timelines
 
 ---
 
-### 🧠 Semantic Mode (Opt-In)
-- FAISS + SentenceTransformers (optional)
-- Metadata embeddings only
-- Disabled by default
-- Auto-disabled if dependencies unavailable
+## 🔐 Trust & Safety
 
----
+- No scraping or crawling
+- No robots.txt bypass
+- No credentialed systems
+- No personal data collection
+- Stateless execution
 
-### 📊 Visual Analytics
-- Entity / domain frequency graphs
-- Retrieval timeline charts
+See:
+- `TRUST_SAFETY.md`
+- `LEGAL_MEMO.md`
 
 ---
 
-### 📝 FOIA Request Generator
-Generate a fillable FOIA request PDF using:
-- Requester name
-- Description of records
-- Agencies surfaced in LIVE results
+## 🚀 Deployment
 
----
-
-## 🧱 What This App Does NOT Do
-
-❌ No scraping  
-❌ No crawling behind authentication  
-❌ No hosting or redistributing documents  
-❌ No classified access  
-❌ No private datasets  
-❌ No surveillance or tracking  
+Designed for **Hugging Face Spaces (Gradio)**  
+No API keys required.
 
 ---
 
-# 🛡️ TRUST & SAFETY ADDENDUM (HF REVIEWERS)
-
-### Compliance Summary
-This Space is intentionally designed to comply with:
-- Hugging Face Spaces policies
-- U.S. FOIA public-access norms
-- Journalism ethics standards
-
-### Safety Controls
-- **Link-out only** (no content ingestion)
-- **Explicit STUB labeling**
-- **Export gating (LIVE-only)**
-- **No PDF storage**
-- **No background crawling**
-- **User-initiated queries only**
-
-### Risk Mitigation
-- No robots.txt violations (manual user navigation)
-- No automated retrieval of sensitive systems
-- No claims of completeness or authority
-
-This Space functions as a **research navigation and citation tool**, not a data collection system.
-
----
-
-# ⚖️ LEGAL REVIEW MEMO (NON-BINDING)
-
-### Scope
-This application operates entirely within:
-- Public FOIA Electronic Reading Rooms
-- User-directed navigation
-
-### Key Legal Characteristics
-- No republication of copyrighted works
-- No derivative document creation
-- No alteration of government records
-- No implied agency endorsement
-
-### Litigation Safety
-- Citation hashes provide integrity verification
-- Source URLs remain authoritative
-- Export artifacts include disclaimers
-
-This tool supports lawful research and reporting, not legal conclusions.
-
----
-
-# 📰 JOURNALIST ONBOARDING GUIDE
-
-### Typical Workflow
-1. Enter investigative topic
-2. Review LIVE agency coverage
-3. Examine PDF previews
-4. Export journalist ZIP
-5. Generate FOIA follow-up request
-6. Share result summary with editors
-
-### Best Practices
-- Always open documents at the source
-- Use citation hashes for verification
-- Treat STUB indicators as leads only
-- File FOIA requests directly with agencies
-
-### Ethical Use
-- Attribute sources accurately
-- Avoid implying classified access
-- Verify context before publication
-
----
-
-## ⚠️ Disclaimer
-This tool:
-- Is not affiliated with any U.S. government agency
-- Does not guarantee completeness
-- Does not provide legal advice
-
----
+## 📜 Disclaimer
 
-**Built for transparency.  
-Designed for accountability.  
-Safe by construction.**
+This tool assists discovery and analysis of public records.  
+Always verify information against the original government source.