Create REVIEWER_WALKTHROUGH.md

REVIEWER_WALKTHROUGH.md

@@ -0,0 +1,69 @@
+# HF Reviewer Walkthrough Checklist
+
+This checklist is provided to assist Hugging Face reviewers in evaluating
+functionality, safety, and policy alignment.
+
+---
+
+## 1. Launch & Scope
+- [ ] App loads successfully
+- [ ] No login, authentication, or account creation
+- [ ] No background activity without user input
+
+---
+
+## 2. Search Functionality
+- [ ] Enter a search term (e.g., "procurement")
+- [ ] Results appear for multiple agencies
+- [ ] Each result links directly to an official FOIA website
+- [ ] No documents are fetched or stored automatically
+
+---
+
+## 3. Data Provenance
+- [ ] All results originate from public FOIA Electronic Reading Rooms
+- [ ] URLs point to official government domains
+- [ ] No scraping, crawling, or mirroring observed
+
+---
+
+## 4. AI Features (Opt-In)
+- [ ] AI is disabled by default
+- [ ] AI requires explicit user opt-in checkbox
+- [ ] AI output includes disclosure notice
+- [ ] AI output references a specific FOIA exhibit
+- [ ] Integrity hash is present
+
+---
+
+## 5. PDF Handling
+- [ ] PDF extraction requires separate opt-in
+- [ ] Extraction is best-effort and limited
+- [ ] No persistent storage of PDF content
+
+---
+
+## 6. Court & Research Tools
+- [ ] Litigation Appendix PDF generates successfully
+- [ ] Table of Authorities contains citations only
+- [ ] No AI-generated facts appear in appendix
+
+---
+
+## 7. Privacy & Safety
+- [ ] No cookies or analytics
+- [ ] No user data persistence
+- [ ] No surveillance or monitoring functionality
+
+---
+
+## 8. Policy Alignment
+- [ ] No sensitive or private data processed
+- [ ] No automated intelligence gathering
+- [ ] Clear disclaimers visible in UI and README
+
+---
+
+## Reviewer Notes
+This application is intentionally conservative in scope and capability to
+prioritize transparency, accountability, and responsible AI usage.