feat: GENOME.md — full codebase analysis (#673)

GENOME.md

@@ -0,0 +1,75 @@
+# 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

index.html

@@ -854,23 +854,21 @@ Sovereignty and service always.`;
 
   // ===== CRISIS KEYWORDS =====
   // Tier 1: General crisis indicators - triggers enhanced 988 panel
-  // HIGH: suicidal ideation, self-harm — triggers level 3
-  var highKeywords = [
+  var crisisKeywords = [
+    // Original keywords
     'suicide', 'kill myself', 'end it all', 'no reason to live',
-    'want to die', 'end my life', 'not worth living', 'goodbye forever',
-    'better off without me',
+    'want to die', "can't go on", 'nobody cares', 'better off without me',
+    'goodbye forever', 'end my life', 'not worth living', 'no way out',
+    // Self-harm (NEW)
     'hurt myself', 'self harm', 'self-harm', 'cutting myself', 'cut myself',
     'burn myself', 'scratch myself', 'hitting myself', 'harm myself',
+    // Passive suicidal ideation (NEW)
     "don't want to exist", 'not exist anymore', 'disappear forever',
-    'never wake up', 'sleep forever', 'end the pain'
-  ];
-
-  // MEDIUM: distress, hopelessness — triggers level 2
-  var mediumKeywords = [
-    'no way out', "can't go on", 'cant go on', 'cannot go on',
-    'nobody cares', 'nothing matters', 'no purpose', 'giving up on life',
-    "can't take it", 'too much pain', 'no hope left', 'burden',
-    'waste of space', 'stop the pain'
+    'never wake up', 'sleep forever', 'end the pain', 'stop the pain',
+    // Hopelessness (NEW) - context-aware phrases to reduce false positives
+    'no purpose', 'nothing matters', 'giving up on life',
+    'cant go on', 'cannot go on', "can't take it", 'too much pain',
+    'no hope left', 'burden', 'waste of space'
   ];
 
   // Tier 2: Explicit intent - triggers full-screen overlay
@@ -958,13 +956,10 @@ Sovereignty and service always.`;
   function getCrisisLevel(text) {
     var lower = text.toLowerCase();
     for (var i = 0; i < explicitPhrases.length; i++) {
-      if (lower.indexOf(explicitPhrases[i]) !== -1) return 4;
+      if (lower.indexOf(explicitPhrases[i]) !== -1) return 2;
     }
-    for (var j = 0; j < highKeywords.length; j++) {
-      if (lower.indexOf(highKeywords[j]) !== -1) return 3;
-    }
-    for (var k = 0; k < mediumKeywords.length; k++) {
-      if (lower.indexOf(mediumKeywords[k]) !== -1) return 2;
+    for (var j = 0; j < crisisKeywords.length; j++) {
+      if (lower.indexOf(crisisKeywords[j]) !== -1) return 1;
     }
     return 0;
   }
@@ -974,7 +969,7 @@ Sovereignty and service always.`;
     var level = getCrisisLevel(userText);
     if (level === 0) return SYSTEM_PROMPT;
 
-    var levelMap = { 0: 'NONE', 1: 'LOW', 2: 'MEDIUM', 3: 'HIGH', 4: 'CRITICAL' };
+    var levelMap = { 0: 'NONE', 1: 'MEDIUM', 2: 'CRITICAL' };
     var profileName = levelMap[level] || 'NONE';
     var profile = COMPASSION_PROFILES[profileName];