Compare commits

..

2 Commits

Author SHA1 Message Date
d2352ed589 test: add Escape key handler test for crisis overlay
Some checks failed
Sanity Checks / sanity-test (pull_request) Successful in 13s
Smoke Test / smoke (pull_request) Failing after 18s
2026-04-15 03:15:30 +00:00
8d309723aa feat: add Escape key handler for crisis overlay
Escape closes the overlay and returns focus to chat input.
Respects the 10s cooldown (won't dismiss if button is disabled).

Fixes #95
2026-04-15 03:15:05 +00:00
3 changed files with 23 additions and 75 deletions

View File

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

View File

@@ -1056,6 +1056,15 @@ Sovereignty and service always.`;
// Register focus trap on document (always listening, gated by class check)
document.addEventListener('keydown', trapFocusInOverlay);
// Escape key closes crisis overlay (returns focus to chat input)
document.addEventListener('keydown', function(e) {
if (e.key === 'Escape' && crisisOverlay.classList.contains('active')) {
if (!overlayDismissBtn.disabled) {
overlayDismissBtn.click();
}
}
});
overlayDismissBtn.addEventListener('click', function() {
if (!overlayDismissBtn.disabled) {
crisisOverlay.classList.remove('active');

View File

@@ -53,5 +53,19 @@ class TestCrisisOverlayFocusTrap(unittest.TestCase):
)
def test_overlay_escape_key_closes_overlay(self):
"""Escape key closes crisis overlay and returns focus to chat input."""
# Verify the Escape handler exists in the HTML
self.assertRegex(
self.html,
r"e\.key\s*===\s*['"]Escape['"].*crisisOverlay\.classList\.contains\('active'\)",
'Expected Escape key handler to check for active crisis overlay.',
)
self.assertRegex(
self.html,
r"overlayDismissBtn\.click\(\)",
'Expected Escape key handler to trigger overlay dismiss button click.',
)
if __name__ == '__main__':
unittest.main()