Version: Current
Historical release snapshot. These docs are frozen. Read current docs.
Search Restoration Runbook
Search Restoration Runbook
Section titled “Search Restoration Runbook”Status as of 2026-11-05: Search is not operational. Restore in order with safety checks.
Phases
Section titled “Phases”| Phase | Status (2026-11-05) | Goal |
|---|---|---|
| 1. Massprox pool | Partially present (16 verified, 2026-10-20, as of 2026-11-05) | Verify egress and grow pool |
| 2. Federation layer | Not deployed (as of 2026-11-05) | Add source routing and permissions |
| 3. Fetch and extract | Not deployed (as of 2026-11-05) | Add fetchers and parsing |
| 4. Rerank | Not deployed (as of 2026-11-05) | Add RRF and weights |
| 5. Cited synthesis | Not deployed (as of 2026-11-05) | Add attribution and citations |
| 6. Validate | Not started (as of 2026-11-05) | Tests, audits, monitoring |
Phase 1: Massprox
Section titled “Phase 1: Massprox”- Verify egress:
sudo -u massprox massprox-ops egress-testmust pass. - Check status:
cat /home/ubuntu/search/proxies/mass-status.json. - Start
mass-proxy-gather.serviceonly after passing egress tests. - Monitor pool growth and failure rates.
Phase 2 to 5
Section titled “Phase 2 to 5”Follow the service repos and DB-first rules:
- Put runtime config in PostgreSQL
suitewith audits. - Use prepared statements and indexes.
- Run
EXPLAINfor new hot queries. - Enforce egress law at every layer.
- Do not add file-based runtime state.
Phase 6: Validate
Section titled “Phase 6: Validate”- Egress guard passes on all hosts.
- Proxy pool has acceptable size.
- Federation routes with permissions.
- Fetch/extract work through proxies.
- Rerank and synthesis pass tests.
- All claims are dated.
- No secrets or customer data in docs.