feat: modular Charity Recon tool as single canonical app

README.md

@@ -2,19 +2,19 @@
 
 *Your essential companion for promoting transparency, accountability, and excellence in the animal welfare community.*
 
-**Last Verified**: 2026-03-15  
-**Recent Update**: Puerto Rico (U.S. Territory) resources added — now covers all 50 states, DC, **and U.S. Territories**.
+**Last Verified**: 2026-07-22  
+**Recent Update**: Single canonical web tool at `tools/index.html` (OSINT + checklists). Shared `state_data.json` covers all 50 states, DC, and Puerto Rico.
 
 Welcome to Charity Recon! This guide and integrated web tool empower animal rescue organizations, donors, and the public to find and verify legitimate charities, report fraudulent activity, understand key compliance requirements, and track assessment findings.
 
 ---
 
 ## Quick Start Guide for Donors
-In a hurry? Here are three essential steps to quickly vet an organization using the tool:
- 1. **Launch the Tool**: Open the [Charity Recon Tool](https://elitegreyit67.github.io/Charity_Recon/tools/osint_app/index.html).
+In a hurry? Here are essential steps to quickly vet an organization using the tool:
+ 1. **Launch the Tool**: Open the [Charity Recon Tool](https://elitegreyit67.github.io/Charity_Recon/tools/index.html).
  2. **Generate Links**: On the "OSINT Tool" tab, enter the organization's name and click "Generate".
  3. **Verify Status**: Use the generated links in the "Federal Financial & Legal" section to check their 501(c)(3) status on the IRS website and review financials on ProPublica.
- 4. **Start a Checklist**: Switch to the "Compliance Checklists" tab within the same tool. Click "Start New Checklist," enter the organization's name, and use the checklist items to assess their transparency based on your findings. Checklists are saved securely to your account.
+ 4. **Start a Checklist**: Switch to the "Compliance Checklists" tab in the same tool. Click "Start New Checklist," enter the organization's name, and assess transparency based on your findings. Checklists are saved in **this browser only** (local storage)—not to a cloud account.
 
 ---
 
@@ -42,11 +42,13 @@ In a hurry? Here are three essential steps to quickly vet an organization using
 ---
 
 ## The Charity Recon Tool
-This project features a single, powerful web application that integrates two key functionalities:
+This project features a **single integrated web application** with two tabs:
 
--   **[Launch the Charity Recon Tool](https://elitegreyit67.github.io/Charity_Recon/tools/osint_app/index.html)**
-    -   **OSINT Dashboard Tab**: Provides a centralized interface to quickly generate direct search links to a wide array of public records (federal/state registrations, financials), news archives, review sites, and online platforms relevant to investigating nonprofit animal rescue organizations.
-    -   **Compliance Checklists Tab**: An interactive, Firebase-powered tool to help donors, volunteers, and adopters assess an organization's transparency and compliance. Create, save, edit, and securely share checklists in the cloud based on a standardized template or your own custom items.
+-   **[Launch the Charity Recon Tool](https://elitegreyit67.github.io/Charity_Recon/tools/index.html)**
+    -   **OSINT Tool tab** (`#osint`): Generates direct search links to public records (federal and state/territory registrations, financials), news, reputation sites, personnel, domain intelligence, and court-record starting points.
+    -   **Compliance Checklists tab** (`#checklist`): Interactive assessments of transparency and compliance. Create, edit, and save checklists **locally in your browser** (no account required). Data stays on this device unless you export/copy it yourself.
+
+**Note:** Older URLs under `tools/osint_app/` and `tools/animal_checklist_app/` redirect to this integrated tool so bookmarks keep working.
 
 ---
 
@@ -74,7 +76,7 @@ This guide and the integrated tool are designed for everyone in the animal welfa
 
 ### For Donors & Supporters
 Your goal is to ensure your contributions make a real impact.
-- **Start Research**: Use the "OSINT Tool" tab in the [Charity Recon Tool](https://elitegreyit67.github.io/Charity_Recon/tools/osint_app/index.html) to perform initial checks (501c3 status, financials, state registration).
+- **Start Research**: Use the "OSINT Tool" tab in the [Charity Recon Tool](https://elitegreyit67.github.io/Charity_Recon/tools/index.html) to perform initial checks (501c3 status, financials, state registration).
 - **Identify Red Flags**: Review the [Spotting Red Flags](#spotting-red-flags-a-deeper-look) section to learn what warrants a closer look during your research.
 - **Assess Systematically**: Switch to the "Compliance Checklists" tab. Use the checklist to systematically evaluate the organization's transparency and practices based on your OSINT findings.
 - **Report Concerns**: If you suspect fraud after your investigation, use the links in the [Resource Hub](#resource-hub) (e.g., FTC, State Attorney General) to file a report.
@@ -92,7 +94,7 @@ You are entrusting an organization to provide you with a healthy, well-cared-for
 ### For Rescue Founders & Operators
 You are dedicated to running a compliant, ethical, and effective organization.
 - **Understand Obligations**: Thoroughly review the [Key Legal & Compliance Requirements](#key-legal--compliance-requirements) section. This is critical for legal operation.
-- **Self-Assess**: Use the "Compliance Checklists" tab in the [Charity Recon Tool](https://elitegreyit67.github.io/Charity_Recon/tools/index.html) as a self-audit tool. Ensure your organization meets transparency and compliance standards. Save and update your checklist as policies evolve.
+- **Self-Assess**: Use the "Compliance Checklists" tab in the [Charity Recon Tool](https://elitegreyit67.github.io/Charity_Recon/tools/index.html#checklist) as a self-audit tool. Ensure your organization meets transparency and compliance standards. Save and update your checklist as policies evolve (browser local storage).
 - **Build Trust**: Use the checklist results to identify areas for improvement in transparency. Proactively publish information like your Form 990, board list, and clear operational policies.
 - **Register Correctly**: Ensure you are registered with the IRS, your Secretary of State, and your state's charity office for fundraising. Use the OSINT tool's links to quickly access relevant state agency websites.
 
@@ -151,7 +153,7 @@ Animal rescues must comply with a web of federal, state, and local laws. Failure
 ---
 
 ## Resource Hub
-Use these resources to conduct your research. The OSINT tab of the [Charity Recon Tool](https://elitegreyit67.github.io/Charity_Recon/tools/osint_app/index.html) provides direct search links for many of these.
+Use these resources to conduct your research. The OSINT tab of the [Charity Recon Tool](https://elitegreyit67.github.io/Charity_Recon/tools/index.html) provides direct search links for many of these.
 
 ### National Resources (U.S.)
 **Charity Databases & Watchdogs**:

STATE_RESOURCES.md

@@ -1,7 +1,7 @@
 <a id="contents"></a>
 # State-Specific Resources for Animal Rescue Organizations
 
-*Last Updated: October 26, 2025*
+*Last Updated: July 22, 2026*
 
 *Government agency information, websites, and contact details can change. To ensure the accuracy of this valuable resource, consider periodically verifying the links and information provided below.*
 
@@ -53,6 +53,7 @@ Use the expandable section below for direct links to your state’s:
 - [Oklahoma](#oklahoma)
 - [Oregon](#oregon)
 - [Pennsylvania](#pennsylvania)
+- [Puerto Rico](#puerto-rico)
 - [Rhode Island](#rhode-island)
 - [South Carolina](#south-carolina)
 - [South Dakota](#south-dakota)

tools/README.md

@@ -0,0 +1,44 @@
+# Charity Recon Tools
+
+## Canonical app
+
+| File | Role |
+|------|------|
+| [`index.html`](./index.html) | UI shell (markup + styles only) |
+| [`js/app.js`](./js/app.js) | Boot, routing (`#osint` / `#checklist`) |
+| [`js/osint-links.js`](./js/osint-links.js) | **Pure** OSINT link builder (no DOM) |
+| [`js/osint.js`](./js/osint.js) | OSINT tab UI |
+| [`js/checklist.js`](./js/checklist.js) | Checklists (localStorage) |
+| [`js/util.js`](./js/util.js) | Theme, toast, escapeHtml, modals |
+| [`state_data.json`](./state_data.json) | 50 states + DC + Puerto Rico link data |
+| [`manifest.json`](./manifest.json) | PWA manifest |
+
+| Tab | Hash |
+|-----|------|
+| OSINT Tool | `#osint` |
+| Compliance Checklists | `#checklist` |
+
+Checklists use browser **local storage** only (key `charity_recon_checklists`). No account.
+
+## Legacy redirects
+
+| Path | Redirects to |
+|------|----------------|
+| [`osint_app/`](./osint_app/) | `index.html#osint` |
+| [`animal_checklist_app/`](./animal_checklist_app/) | `index.html#checklist` |
+
+Unused Firebase / PWA leftovers: [`_legacy/`](./_legacy/).
+
+## Local development
+
+```bash
+# from repo root (ES modules require HTTP)
+python3 -m http.server 8080
+# open http://localhost:8080/tools/index.html
+```
+
+## Tests
+
+```bash
+node tools/js/osint-links.test.mjs
+```

tools/_legacy/README.md

@@ -0,0 +1,25 @@
+# Legacy (unused) Charity Recon assets
+
+These files are **not used** by the current integrated app (`tools/index.html` + `tools/js/`).
+
+They are retained only as historical reference from an earlier Firebase-backed checklist design and old standalone PWA shells.
+
+| Path | Former role |
+|------|-------------|
+| `functions/` | Cloud Functions to sync `memberIds` on checklist docs |
+| `firestore.rules` | Artifact-path Firestore rules |
+| `animal_checklist_app/` | Standalone checklist PWA rules, styles, service worker |
+| `osint_app/` | Old OSINT PWA service worker + manifest |
+
+Do **not** re-enable without an intentional product decision to restore cloud accounts.
+
+Active app layout:
+
+```
+tools/index.html
+tools/js/{app,util,osint,osint-links,checklist}.js
+tools/state_data.json
+tools/manifest.json
+tools/osint_app/index.html          → redirect #osint
+tools/animal_checklist_app/index.html → redirect #checklist
+```