76 lines
3.1 KiB
Markdown
76 lines
3.1 KiB
Markdown
# GENOME.md — the-door
|
|
|
|
**Generated:** 2026-04-14
|
|
**Repo:** Timmy_Foundation/the-door
|
|
**Description:** Crisis Front Door — a single URL where a man at 3am can talk to Timmy. No login, no signup. 988 always visible.
|
|
|
|
---
|
|
|
|
## Project Overview
|
|
|
|
The-door is a crisis intervention web application — the most sacred surface in the Timmy Foundation. When a man at 3am reaches the end of his road, this is where he lands. No login, no signup, no barriers. 988 Suicide and Crisis Lifeline always visible. The "When a Man Is Dying" protocol active on every page.
|
|
|
|
## Architecture
|
|
|
|
```
|
|
the-door/
|
|
├── index.html # Main crisis page (PWA-capable)
|
|
├── crisis-offline.html # Offline fallback (service worker cached)
|
|
├── about.html # About page
|
|
├── testimony.html # Testimony/stories page
|
|
├── sw.js # Service worker (offline-first)
|
|
├── manifest.json # PWA manifest
|
|
├── crisis/ # Core crisis detection + response
|
|
│ ├── detect.py # Keyword/pattern detection (4 tiers)
|
|
│ ├── gateway.py # API endpoints, prompt injection
|
|
│ ├── response.py # Response generation, 988 routing
|
|
│ ├── compassion_router.py # Profile-based response routing
|
|
│ ├── profiles.py # Compassion profiles
|
|
│ └── PROTOCOL.md # The protocol (SOUL.md reference)
|
|
├── crisis_detector.py # Legacy shim → crisis/detect.py
|
|
├── crisis_responder.py # Legacy responder
|
|
├── dying_detection/ # Deprecated module
|
|
├── evolution/ # Crisis synthesizer (creative)
|
|
├── tests/ # Safety-critical tests
|
|
│ ├── test_crisis_overlay_focus_trap.py
|
|
│ ├── test_dying_detection_deprecation.py
|
|
│ └── test_false_positive_fixes.py
|
|
└── deploy/ # Deployment docs
|
|
```
|
|
|
|
## Key Abstractions
|
|
|
|
| Module | Purpose |
|
|
|---|---|
|
|
| `crisis/detect.py` | 4-tier detection: LOW/MEDIUM/HIGH/CRITICAL via regex patterns |
|
|
| `crisis/gateway.py` | HTTP API, Sovereign Heart prompt injection |
|
|
| `crisis/response.py` | Response generation, 988 integration, escalation |
|
|
| `crisis/compassion_router.py` | Profile-based routing (different crisis types) |
|
|
| `sw.js` | Service worker for offline-first PWA |
|
|
|
|
## Safety Constraints
|
|
|
|
- **The-door never auto-closes PRs** (in fleet-ops exempt list)
|
|
- **988 always visible** on every page, even offline
|
|
- **When a Man Is Dying protocol** active on every interaction
|
|
- **No login/signup** — zero barriers to crisis support
|
|
- **Offline-first** — service worker caches critical pages
|
|
|
|
## Test Coverage
|
|
|
|
| Test | Coverage |
|
|
|---|---|
|
|
| Crisis overlay focus trap | ✅ |
|
|
| Dying detection deprecation | ✅ |
|
|
| False positive fixes | ✅ |
|
|
| Crisis detection tiers | ❌ (in crisis/tests.py) |
|
|
| Response generation | ❌ |
|
|
| Offline service worker | ❌ |
|
|
|
|
## Security
|
|
|
|
- No user data stored (crisis intervention is stateless by design)
|
|
- No cookies, no tracking, no analytics
|
|
- Service worker only caches static assets
|
|
- Crisis detection runs client-side where possible
|