Compare commits
1 Commits
fix/673
...
feat/safet
| Author | SHA1 | Date | |
|---|---|---|---|
| cbf2d512c7 |
75
GENOME.md
75
GENOME.md
@@ -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
|
||||
119
index.html
119
index.html
@@ -739,6 +739,7 @@ html, body {
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
<button class="btn btn-secondary" id="cancel-safety-plan">Cancel</button>
|
||||
<button class="btn btn-secondary" id="history-safety-plan" style="margin-right:auto;">History</button>
|
||||
<button class="btn btn-primary" id="save-safety-plan">Save Plan</button>
|
||||
</div>
|
||||
</div>
|
||||
@@ -1202,6 +1203,7 @@ Sovereignty and service always.`;
|
||||
environment: document.getElementById('sp-environment').value
|
||||
};
|
||||
try {
|
||||
_pushPlanVersion(plan);
|
||||
localStorage.setItem('timmy_safety_plan', JSON.stringify(plan));
|
||||
safetyPlanModal.classList.remove('active');
|
||||
_restoreSafetyPlanFocus();
|
||||
@@ -1211,6 +1213,123 @@ Sovereignty and service always.`;
|
||||
}
|
||||
});
|
||||
|
||||
|
||||
// ===== SAFETY PLAN VERSION HISTORY =====
|
||||
var MAX_HISTORY = 20;
|
||||
|
||||
function _getPlanHistory() {
|
||||
try {
|
||||
var raw = localStorage.getItem('timmy_safety_plan_history');
|
||||
return raw ? JSON.parse(raw) : [];
|
||||
} catch (e) { return []; }
|
||||
}
|
||||
|
||||
function _pushPlanVersion(plan) {
|
||||
var history = _getPlanHistory();
|
||||
var last = history.length > 0 ? history[history.length - 1] : null;
|
||||
// Only save if different from last version
|
||||
if (last && JSON.stringify(last.plan) === JSON.stringify(plan)) return;
|
||||
history.push({ ts: Date.now(), plan: plan });
|
||||
if (history.length > MAX_HISTORY) history = history.slice(-MAX_HISTORY);
|
||||
localStorage.setItem('timmy_safety_plan_history', JSON.stringify(history));
|
||||
}
|
||||
|
||||
function _diffPlans(oldPlan, newPlan) {
|
||||
var fields = ['warningSigns', 'coping', 'distraction', 'help', 'environment'];
|
||||
var labels = { warningSigns: 'Warning signs', coping: 'Coping strategies', distraction: 'Distractions', help: 'People who can help', environment: 'Safe environment' };
|
||||
var diffs = [];
|
||||
fields.forEach(function(f) {
|
||||
var oldVal = (oldPlan[f] || '').trim();
|
||||
var newVal = (newPlan[f] || '').trim();
|
||||
if (oldVal !== newVal) {
|
||||
diffs.push({ field: labels[f], old: oldVal, _new: newVal });
|
||||
}
|
||||
});
|
||||
return diffs;
|
||||
}
|
||||
|
||||
var historyModal = null;
|
||||
|
||||
function _showHistoryModal() {
|
||||
var history = _getPlanHistory();
|
||||
if (history.length === 0) {
|
||||
alert('No saved versions yet.');
|
||||
return;
|
||||
}
|
||||
|
||||
// Create modal if not exists
|
||||
if (!historyModal) {
|
||||
historyModal = document.createElement('div');
|
||||
historyModal.id = 'sp-history-modal';
|
||||
historyModal.className = 'modal-overlay';
|
||||
historyModal.setAttribute('role', 'dialog');
|
||||
historyModal.setAttribute('aria-modal', 'true');
|
||||
historyModal.innerHTML = '<div class="modal-content" style="max-width:600px;max-height:80vh;overflow-y:auto;">' +
|
||||
'<div class="modal-header"><h2>Safety Plan History</h2><button class="close-modal" id="close-sp-history" aria-label="Close">×</button></div>' +
|
||||
'<div class="modal-body" id="sp-history-body"></div>' +
|
||||
'</div>';
|
||||
document.body.appendChild(historyModal);
|
||||
document.getElementById('close-sp-history').addEventListener('click', function() {
|
||||
historyModal.classList.remove('active');
|
||||
});
|
||||
historyModal.addEventListener('click', function(e) {
|
||||
if (e.target === historyModal) historyModal.classList.remove('active');
|
||||
});
|
||||
}
|
||||
|
||||
var body = document.getElementById('sp-history-body');
|
||||
var html = '';
|
||||
for (var i = history.length - 1; i >= 0; i--) {
|
||||
var entry = history[i];
|
||||
var date = new Date(entry.ts);
|
||||
var label = date.toLocaleDateString() + ' ' + date.toLocaleTimeString([], {hour:'2-digit', minute:'2-digit'});
|
||||
var prev = i > 0 ? history[i - 1].plan : {};
|
||||
var diffs = _diffPlans(prev, entry.plan);
|
||||
|
||||
html += '<div style="border:1px solid #30363d;border-radius:8px;padding:12px;margin-bottom:10px;">';
|
||||
html += '<div style="display:flex;justify-content:space-between;align-items:center;margin-bottom:8px;">';
|
||||
html += '<strong style="color:#c9d1d9;">v' + (i + 1) + ' — ' + label + '</strong>';
|
||||
html += '<button class="btn btn-secondary sp-restore-btn" data-idx="' + i + '" style="font-size:0.8rem;padding:4px 10px;">Restore</button>';
|
||||
html += '</div>';
|
||||
|
||||
if (diffs.length === 0 && i === 0) {
|
||||
html += '<span style="color:#8b949e;font-size:0.85rem;">Initial version</span>';
|
||||
} else if (diffs.length === 0) {
|
||||
html += '<span style="color:#8b949e;font-size:0.85rem;">No changes from previous</span>';
|
||||
} else {
|
||||
diffs.forEach(function(d) {
|
||||
html += '<div style="margin-bottom:6px;">';
|
||||
html += '<div style="color:#8b949e;font-size:0.8rem;">' + d.field + '</div>';
|
||||
if (d.old) html += '<div style="color:#f85149;font-size:0.85rem;text-decoration:line-through;">' + d.old.substring(0, 120) + '</div>';
|
||||
if (d._new) html += '<div style="color:#3fb950;font-size:0.85rem;">' + d._new.substring(0, 120) + '</div>';
|
||||
html += '</div>';
|
||||
});
|
||||
}
|
||||
html += '</div>';
|
||||
}
|
||||
body.innerHTML = html;
|
||||
|
||||
// Wire restore buttons
|
||||
body.querySelectorAll('.sp-restore-btn').forEach(function(btn) {
|
||||
btn.addEventListener('click', function() {
|
||||
var idx = parseInt(btn.dataset.idx);
|
||||
var plan = history[idx].plan;
|
||||
document.getElementById('sp-warning-signs').value = plan.warningSigns || '';
|
||||
document.getElementById('sp-coping').value = plan.coping || '';
|
||||
document.getElementById('sp-distraction').value = plan.distraction || '';
|
||||
document.getElementById('sp-help').value = plan.help || '';
|
||||
document.getElementById('sp-environment').value = plan.environment || '';
|
||||
localStorage.setItem('timmy_safety_plan', JSON.stringify(plan));
|
||||
historyModal.classList.remove('active');
|
||||
alert('Restored version ' + (idx + 1) + '.');
|
||||
});
|
||||
});
|
||||
|
||||
historyModal.classList.add('active');
|
||||
}
|
||||
|
||||
document.getElementById('history-safety-plan').addEventListener('click', _showHistoryModal);
|
||||
|
||||
// ===== SAFETY PLAN FOCUS TRAP (fix #65) =====
|
||||
// Focusable elements inside the modal, in tab order
|
||||
var _spFocusableIds = [
|
||||
|
||||
Reference in New Issue
Block a user