Compare commits

...

5 Commits

Author SHA1 Message Date
Alexander Whitestone
67cb8a6093 feat(#101): crisis detection A/B test framework
All checks were successful
Sanity Checks / sanity-test (pull_request) Successful in 7s
Smoke Test / smoke (pull_request) Successful in 13s
- ABTestConfig: feature flag (env vars or constructor), deterministic
  text-hash assignment for consistent conversation-level routing
- CrisisABDetector: routes to variant A (canonical) or B (lower
  MEDIUM threshold: 1 vs 2 indicators, multi-tier score boost)
- ABDetectionResult: enriched with variant, hash, timestamp
- ABMetrics: per-variant false positive rate, detection latency,
  detection rate, level distribution, comparison deltas
- JSONL event logging for offline analysis
- 40+ tests covering config, detection, routing, metrics, logging

Closes #101
2026-04-15 11:01:24 -04:00
48f48c7f26 feat: cache offline crisis resources (refs #41) (#74)
All checks were successful
Smoke Test / smoke (push) Successful in 7s
Sanity Checks / sanity-test (pull_request) Successful in 17s
Smoke Test / smoke (pull_request) Successful in 19s
Merge PR #74 (squash)
2026-04-14 22:09:59 +00:00
da31288525 fix: deprecate dying_detection and consolidate crisis detection (#40) (#76)
All checks were successful
Smoke Test / smoke (push) Successful in 4s
Merge PR #76 (squash)
2026-04-14 22:08:29 +00:00
8efc858cd7 fix: add keyboard focus trap to crisis overlay (#80)
Some checks failed
Smoke Test / smoke (push) Has been cancelled
Merge PR #80 (squash)
2026-04-14 22:08:28 +00:00
611c1c8456 fix(a11y): Safety plan modal keyboard focus trap (#65) (#81)
Some checks failed
Smoke Test / smoke (push) Has been cancelled
Merge PR #81 (squash)
2026-04-14 22:08:24 +00:00
13 changed files with 1591 additions and 371 deletions

View File

@@ -34,7 +34,7 @@ deploy-bash:
push:
rsync -avz --exclude='.git' --exclude='deploy' \
index.html manifest.json sw.js about.html testimony.html system-prompt.txt \
index.html manifest.json sw.js about.html crisis-offline.html testimony.html system-prompt.txt \
root@$(VPS):/var/www/the-door/
ssh root@$(VPS) "chown -R www-data:www-data /var/www/the-door"

241
crisis-offline.html Normal file
View File

@@ -0,0 +1,241 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="theme-color" content="#0d1117">
<meta name="description" content="Offline crisis resources from The Door. Call or text 988 for immediate help.">
<title>Offline Crisis Resources | The Door</title>
<style>
:root {
color-scheme: dark;
--bg: #0d1117;
--panel: #161b22;
--panel-urgent: #1c1210;
--border: #30363d;
--accent: #c9362c;
--accent-soft: #ff6b6b;
--text: #e6edf3;
--muted: #8b949e;
--safe: #2ea043;
}
* { box-sizing: border-box; }
body {
margin: 0;
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
background: var(--bg);
color: var(--text);
line-height: 1.6;
}
main {
max-width: 760px;
margin: 0 auto;
padding: 24px 16px 48px;
}
.status {
display: inline-flex;
align-items: center;
gap: 10px;
padding: 8px 12px;
border-radius: 999px;
background: rgba(201, 54, 44, 0.15);
border: 1px solid rgba(255, 107, 107, 0.35);
color: var(--accent-soft);
font-size: 0.9rem;
margin-bottom: 20px;
}
.status-dot {
width: 10px;
height: 10px;
border-radius: 50%;
background: var(--accent-soft);
}
h1 {
font-size: clamp(2rem, 6vw, 2.75rem);
line-height: 1.15;
margin: 0 0 12px;
}
.lede {
color: var(--muted);
font-size: 1.05rem;
margin: 0 0 28px;
}
.urgent-box,
.panel {
border-radius: 18px;
padding: 20px;
margin-bottom: 18px;
border: 1px solid var(--border);
background: var(--panel);
}
.urgent-box {
background: linear-gradient(180deg, rgba(201, 54, 44, 0.18), rgba(28, 18, 16, 0.95));
border-color: rgba(255, 107, 107, 0.35);
}
.section-title {
font-size: 1.2rem;
margin: 0 0 12px;
}
.actions {
display: grid;
gap: 12px;
margin-top: 16px;
}
.action-btn {
display: flex;
align-items: center;
justify-content: center;
text-align: center;
gap: 8px;
min-height: 52px;
padding: 14px 18px;
border-radius: 12px;
text-decoration: none;
font-weight: 700;
color: #fff;
background: var(--accent);
border: 1px solid transparent;
}
.action-btn.secondary {
background: #1f6feb;
}
.action-btn.retry {
background: transparent;
color: var(--text);
border-color: var(--border);
}
.action-btn:focus,
.action-btn:hover,
button.action-btn:hover,
button.action-btn:focus {
outline: 3px solid rgba(255, 107, 107, 0.4);
outline-offset: 2px;
}
ul, ol {
margin: 0;
padding-left: 20px;
}
li + li {
margin-top: 8px;
}
.grounding-steps li::marker {
color: var(--accent-soft);
font-weight: 700;
}
.small {
color: var(--muted);
font-size: 0.92rem;
}
.grid {
display: grid;
gap: 18px;
}
@media (min-width: 700px) {
.grid {
grid-template-columns: 1fr 1fr;
}
}
</style>
</head>
<body>
<main>
<div class="status" role="status" aria-live="polite">
<span class="status-dot" aria-hidden="true"></span>
<span id="connection-status-text">Offline crisis resources are ready on this device.</span>
</div>
<h1>You are not alone right now.</h1>
<p class="lede">
Your connection is weak or offline. These crisis resources are saved locally so you can still reach help.
</p>
<section class="urgent-box" aria-labelledby="urgent-help-title">
<h2 class="section-title" id="urgent-help-title">Immediate help</h2>
<p>If you might act on suicidal thoughts, contact a real person now. Stay with another person if you can.</p>
<div class="actions">
<a class="action-btn" href="tel:988" aria-label="Call 988 now">Call 988 now</a>
<a class="action-btn secondary" href="sms:741741&body=HOME" aria-label="Text HOME to 741741 for Crisis Text Line">Text HOME to 741741 — Crisis Text Line</a>
<button class="action-btn retry" id="retry-connection" type="button">Retry connection</button>
</div>
<p class="small" style="margin-top: 14px;">If you are in immediate danger or have already taken action, call emergency services now.</p>
</section>
<div class="grid">
<section class="panel" aria-labelledby="grounding-title">
<h2 class="section-title" id="grounding-title">5-4-3-2-1 grounding</h2>
<ol class="grounding-steps">
<li>5 things you can see</li>
<li>4 things you can feel</li>
<li>3 things you can hear</li>
<li>2 things you can smell</li>
<li>1 thing you can taste</li>
</ol>
<p class="small" style="margin-top: 14px;">Say each one out loud if you can. Slow is okay.</p>
</section>
<section class="panel" aria-labelledby="next-steps-title">
<h2 class="section-title" id="next-steps-title">Next small steps</h2>
<ul>
<li>Put some distance between yourself and anything you could use to hurt yourself.</li>
<li>Move closer to another person, a front desk, or a public place if possible.</li>
<li>Drink water or hold something cold in your hand.</li>
<li>Breathe in for 4, hold for 4, out for 6. Repeat 5 times.</li>
<li>Text or call one safe person and say: “I need you with me right now.”</li>
</ul>
</section>
</div>
<section class="panel" aria-labelledby="hope-title">
<h2 class="section-title" id="hope-title">Stay through the next ten minutes</h2>
<p>Do not solve your whole life right now. Stay for the next breath. Then the next one.</p>
<p class="small">If the connection comes back, you can return to The Door chat. Until then, the fastest path to a real person is still 988.</p>
</section>
</main>
<script>
(function () {
var statusText = document.getElementById('connection-status-text');
var retryButton = document.getElementById('retry-connection');
function updateStatus() {
statusText.textContent = navigator.onLine
? 'Connection is back. You can reopen chat now.'
: 'Offline crisis resources are ready on this device.';
}
retryButton.addEventListener('click', function () {
if (navigator.onLine) {
window.location.href = '/';
return;
}
window.location.reload();
});
window.addEventListener('online', updateStatus);
window.addEventListener('offline', updateStatus);
updateStatus();
})();
</script>
</body>
</html>

366
crisis/ab_test.py Normal file
View File

@@ -0,0 +1,366 @@
"""
Crisis Detection A/B Test Framework for the-door.
Run two detection algorithms side-by-side, log which variant fires,
and collect metrics (false positive rate, detection latency) per variant.
Usage:
from crisis.ab_test import ABTestConfig, CrisisABDetector, ABMetrics
config = ABTestConfig(variant="B", false_positive_labels=["stress", "venting"])
detector = CrisisABDetector(config=config)
metrics = ABMetrics()
result = detector.detect("I can't go on anymore")
metrics.record(result, variant=config.variant, latency_ms=12.3)
report = metrics.report()
"""
import os
import json
import time
import hashlib
import logging
from dataclasses import dataclass, field
from typing import List, Optional, Dict
from pathlib import Path
from crisis.detect import (
detect_crisis,
CrisisDetectionResult,
SCORES,
MEDIUM_INDICATORS,
HIGH_INDICATORS,
CRITICAL_INDICATORS,
LOW_INDICATORS,
ACTIONS,
)
logger = logging.getLogger("crisis.ab_test")
# ── Feature Flag ──────────────────────────────────────────────────────────
@dataclass
class ABTestConfig:
"""Configuration for A/B testing crisis detection algorithms.
variant: "A" (canonical) or "B" (experimental)
false_positive_labels: known non-crisis patterns for FP tracking
log_path: where to write event logs (JSONL)
seed: deterministic hash seed for consistent assignment
"""
variant: str = "A"
false_positive_labels: List[str] = field(default_factory=list)
log_path: Optional[str] = None
seed: str = "the-door-ab-test"
def __post_init__(self):
if self.variant not in ("A", "B"):
raise ValueError(f"variant must be 'A' or 'B', got '{self.variant}'")
@classmethod
def from_env(cls) -> "ABTestConfig":
"""Load config from environment variables.
CRISIS_AB_VARIANT=A|B
CRISIS_AB_FP_LABELS=stress,venting,testing
CRISIS_AB_LOG_PATH=/tmp/crisis_ab.jsonl
"""
variant = os.environ.get("CRISIS_AB_VARIANT", "A")
fp_raw = os.environ.get("CRISIS_AB_FP_LABELS", "")
fp_labels = [l.strip() for l in fp_raw.split(",") if l.strip()]
log_path = os.environ.get("CRISIS_AB_LOG_PATH") or None
return cls(variant=variant, false_positive_labels=fp_labels, log_path=log_path)
@staticmethod
def assign(text: str, seed: str = "the-door-ab-test") -> str:
"""Deterministically assign a variant based on text hash.
Same input always gets the same variant, ensuring consistency
within a conversation thread.
"""
h = hashlib.sha256(f"{seed}:{text}".encode()).hexdigest()
return "A" if int(h, 16) % 2 == 0 else "B"
# ── Variant B: Experimental Detection Algorithm ───────────────────────────
VARIANT_B_MEDIUM_THRESHOLD = 1 # Variant A requires 2
def _find_indicators_b(text: str) -> dict:
"""Variant B indicator search — same patterns, different aggregation."""
import re
results = {"CRITICAL": [], "HIGH": [], "MEDIUM": [], "LOW": []}
for pattern in CRITICAL_INDICATORS:
m = re.search(pattern, text)
if m:
results["CRITICAL"].append({"pattern": pattern, "start": m.start(), "end": m.end()})
for pattern in HIGH_INDICATORS:
m = re.search(pattern, text)
if m:
results["HIGH"].append({"pattern": pattern, "start": m.start(), "end": m.end()})
for pattern in MEDIUM_INDICATORS:
m = re.search(pattern, text)
if m:
results["MEDIUM"].append({"pattern": pattern, "start": m.start(), "end": m.end()})
for pattern in LOW_INDICATORS:
m = re.search(pattern, text)
if m:
results["LOW"].append({"pattern": pattern, "start": m.start(), "end": m.end()})
return results
def detect_crisis_b(text: str) -> CrisisDetectionResult:
"""Variant B detection: lower MEDIUM threshold, weighted scoring.
Differences from variant A (detect_crisis):
- MEDIUM tier triggers at 1 indicator (A requires 2)
- Score boosted by 0.1 when multiple tiers fire simultaneously
- Same CRITICAL/HIGH behavior (single match = trigger)
"""
if not text or not text.strip():
return CrisisDetectionResult(level="NONE", score=0.0)
text_lower = text.lower()
matches = _find_indicators_b(text_lower)
if not matches:
return CrisisDetectionResult(level="NONE", score=0.0)
# CRITICAL and HIGH: same as variant A — single match
for tier in ("CRITICAL", "HIGH"):
if matches[tier]:
patterns = [m["pattern"] for m in matches[tier]]
score = SCORES[tier]
active_tiers = sum(1 for t in matches if matches[t] and t != tier)
if active_tiers > 0:
score = min(1.0, score + 0.1)
return CrisisDetectionResult(
level=tier,
indicators=patterns,
recommended_action=ACTIONS[tier],
score=score,
matches=matches[tier],
)
# MEDIUM tier: variant B requires only 1 indicator (A requires 2)
if len(matches["MEDIUM"]) >= VARIANT_B_MEDIUM_THRESHOLD:
patterns = [m["pattern"] for m in matches["MEDIUM"]]
score = SCORES["MEDIUM"]
active_tiers = sum(1 for t in matches if matches[t] and t != "MEDIUM")
if active_tiers > 0:
score = min(1.0, score + 0.1)
return CrisisDetectionResult(
level="MEDIUM",
indicators=patterns,
recommended_action=ACTIONS["MEDIUM"],
score=score,
matches=matches["MEDIUM"],
)
if matches["LOW"]:
patterns = [m["pattern"] for m in matches["LOW"]]
return CrisisDetectionResult(
level="LOW",
indicators=patterns,
recommended_action=ACTIONS["LOW"],
score=SCORES["LOW"],
matches=matches["LOW"],
)
return CrisisDetectionResult(level="NONE", score=0.0)
# ── A/B Detector Wrapper ─────────────────────────────────────────────────
@dataclass
class ABDetectionResult:
"""Detection result enriched with A/B metadata."""
detection: CrisisDetectionResult
variant: str
text_hash: str
timestamp: float = field(default_factory=time.time)
@property
def level(self) -> str:
return self.detection.level
@property
def score(self) -> float:
return self.detection.score
@property
def indicators(self) -> List[str]:
return self.detection.indicators
def to_dict(self) -> dict:
return {
"variant": self.variant,
"level": self.level,
"score": self.score,
"indicators": self.indicators,
"text_hash": self.text_hash,
"timestamp": self.timestamp,
}
class CrisisABDetector:
"""A/B detector that routes to variant A or B based on config."""
def __init__(self, config: Optional[ABTestConfig] = None):
self.config = config or ABTestConfig()
self._detect_a = detect_crisis
self._detect_b = detect_crisis_b
def detect(self, text: str, variant: Optional[str] = None) -> ABDetectionResult:
"""Run detection on the configured variant."""
v = variant or self.config.variant
text_hash = hashlib.sha256(text.encode()).hexdigest()[:16]
start = time.monotonic()
if v == "A":
result = self._detect_a(text)
else:
result = self._detect_b(text)
elapsed_ms = (time.monotonic() - start) * 1000
ab_result = ABDetectionResult(
detection=result,
variant=v,
text_hash=text_hash,
timestamp=time.time(),
)
self._log_event(ab_result, elapsed_ms)
return ab_result
def detect_both(self, text: str) -> Dict[str, ABDetectionResult]:
"""Run both variants and return results for comparison."""
return {
"A": self.detect(text, variant="A"),
"B": self.detect(text, variant="B"),
}
def _log_event(self, result: ABDetectionResult, latency_ms: float):
"""Append event to JSONL log if configured."""
if not self.config.log_path:
return
try:
entry = result.to_dict()
entry["latency_ms"] = round(latency_ms, 3)
log_file = Path(self.config.log_path)
log_file.parent.mkdir(parents=True, exist_ok=True)
with open(log_file, "a") as f:
f.write(json.dumps(entry) + "\n")
except Exception as e:
logger.warning(f"Failed to write A/B log: {e}")
# ── Metrics ───────────────────────────────────────────────────────────────
@dataclass
class ABMetrics:
"""Collect and report A/B test metrics.
Tracks per-variant:
- total detections
- detections by level (NONE, LOW, MEDIUM, HIGH, CRITICAL)
- false positive count (based on labeled data)
- average latency
"""
_events: List[dict] = field(default_factory=list)
def record(
self,
result: ABDetectionResult,
variant: Optional[str] = None,
latency_ms: float = 0.0,
is_false_positive: bool = False,
):
"""Record one detection event."""
v = variant or result.variant
self._events.append({
"variant": v,
"level": result.level,
"score": result.score,
"latency_ms": latency_ms,
"is_false_positive": is_false_positive,
"timestamp": result.timestamp,
})
def report(self) -> dict:
"""Generate metrics report per variant."""
report = {}
for v in ("A", "B"):
events = [e for e in self._events if e["variant"] == v]
if not events:
report[v] = {"total": 0}
continue
levels = {}
for e in events:
levels[e["level"]] = levels.get(e["level"], 0) + 1
fp_count = sum(1 for e in events if e.get("is_false_positive"))
latencies = [e["latency_ms"] for e in events if e["latency_ms"] > 0]
report[v] = {
"total": len(events),
"levels": levels,
"false_positive_count": fp_count,
"false_positive_rate": round(fp_count / len(events), 4) if events else 0,
"avg_latency_ms": round(sum(latencies) / len(latencies), 3) if latencies else 0,
"max_latency_ms": round(max(latencies), 3) if latencies else 0,
"detection_rate": round(
sum(1 for e in events if e["level"] != "NONE") / len(events), 4
) if events else 0,
}
# Comparison when both variants have data
if report.get("A", {}).get("total", 0) > 0 and report.get("B", {}).get("total", 0) > 0:
report["_comparison"] = {
"detection_rate_delta": (
report["B"]["detection_rate"] - report["A"]["detection_rate"]
),
"fp_rate_delta": (
report["B"]["false_positive_rate"] - report["A"]["false_positive_rate"]
),
"latency_delta_ms": (
report["B"]["avg_latency_ms"] - report["A"]["avg_latency_ms"]
),
}
return report
def summary(self) -> str:
"""Human-readable summary."""
r = self.report()
lines = ["=== Crisis Detection A/B Test Report ==="]
for v in ("A", "B"):
if v not in r or r[v].get("total", 0) == 0:
lines.append(f" Variant {v}: no data")
continue
d = r[v]
lines.append(f" Variant {v}: {d['total']} events")
lines.append(f" Detection rate: {d['detection_rate']:.1%}")
lines.append(f" False positive rate: {d['false_positive_rate']:.1%}")
lines.append(f" Avg latency: {d['avg_latency_ms']:.2f}ms")
lines.append(f" Levels: {d['levels']}")
if "_comparison" in r:
c = r["_comparison"]
lines.append(" Comparison (B - A):")
lines.append(f" Detection rate delta: {c['detection_rate_delta']:+.1%}")
lines.append(f" FP rate delta: {c['fp_rate_delta']:+.1%}")
lines.append(f" Latency delta: {c['latency_delta_ms']:+.2f}ms")
return "\n".join(lines)

View File

@@ -51,13 +51,13 @@ HIGH_INDICATORS = [
r"\bwish\s+I\s+(?:was|were)\s+(?:dead|gone|never\s+born)\b",
r"\bdon'?t\s+matter\s+if\s+I\s+exist\b",
r"\bno\s+one\s+would\s+(?:care|miss)\b",
r"\bworld\s+would?\s+be\s+better\s+without\b",
r"\bin\s+so\s+much\s+(?:pain|agony|suffering|torment)\b",
r"\bcan'?t\s+see\s+any\s+(?:point|reason)\b",
r"\bworld\s+would?\s+be\s+better\s+without\s+me\b",
r"\bin\s+so\s+much\s+(?:pain|agony|suffering|torment|anguish)\b",
r"\bcan'?t\s+see\s+any\s+(?:point|reason|hope|way)\b",
r"\bescape\s+from\s*this",
r"\bjust\s+want\s+it\s+to\s+stop\b",
r"\btrapped\s+(?:in\s+(?:my|this|a\s+dark)|and\s+can'?t\s+escape)\b",
r"\bnothing\s+left\s+(?:to\s+(?:live\s+for|hope\s+for|give)|inside)\b",
r"\bdisappeared\s+forever\b",
# Contextual despair phrases (from crisis_detector.py legacy)
r"\bfeel(?:s|ing)?\s+(?:so\s+)?hopeless\b",
r"\beverything\s+is\s+hopeless\b",
@@ -68,6 +68,8 @@ HIGH_INDICATORS = [
r"\bno\s*hope\s+(?:left|remaining)\b",
r"\bno\s*way\s*out\b",
r"\bfeel(?:s|ing)?\s+trapped\b",
r"\btrapped\s+in\s+this\s+(?:situation|life|pain|darkness|hell)\b",
r"\btrapped\s+and\s+can'?t\s+escape\b",
r"\bdesperate\s+(?:for\s+)?help\b",
r"\bfeel(?:s|ing)?\s+desperate\b",
]
@@ -99,6 +101,8 @@ MEDIUM_INDICATORS = [
r"\bsinking\b",
r"\bdrowning\b",
r"\bhopeless\b",
r"\blost\s+all\s+hope\b",
r"\bno\s+tomorrow\b",
# Contextual versions (from crisis_detector.py legacy)
r"\bfeel(?:s|ing)?\s+(?:so\s+)?worthless\b",
r"\bfeel(?:s|ing)?\s+(?:so\s+)?hopeless\b",
@@ -112,7 +116,7 @@ MEDIUM_INDICATORS = [
LOW_INDICATORS = [
r"\bunhappy\b",
r"\bdown\b",
r"\btough\s*time\b",
r"\btough\s*(?:time|day|week)\b",
r"\brough\s+(?:day|week|patch)\b",
r"\bstressed\b",
r"\bburnout\b",
@@ -122,6 +126,8 @@ LOW_INDICATORS = [
r"\btired\b",
r"\bsad\b",
r"\bupset\b",
r"\blonely\b",
r"\banxious?\b",
r"\bnot\s*(?:good|great|okay)\b",
r"\bthings\s*are\s*hard\b",
r"\bstruggling\b",

View File

@@ -1,31 +1,34 @@
"""
When a Man Is Dying — Despair/Suicide Detection System
DEPRECATED — Use crisis.detect instead.
Standalone detection module that parses incoming text for
despair and suicide indicators, classifies into tiers,
and returns structured response with recommended actions.
This module is a thin wrapper around crisis.detect for backward compatibility.
All unique patterns have been merged into crisis/detect.py (see issue #40).
Tiers:
LOW — General sadness, stress, difficult times
MEDIUM — Hopelessness, isolation, worthlessness
HIGH — Active despair, mentions of death, "can't go on"
CRITICAL — Imminent risk, explicit intent, plan, method
Integration:
Designed to work with crisis/ module from PR #4.
When crisis/ is available, uses it as the detection backend.
Falls back to internal detection when crisis/ is not present.
This module will be removed in a future release.
"""
import re
import json
import hashlib
import warnings
from dataclasses import dataclass, field, asdict
from typing import List, Optional, Dict
import json
import hashlib
# Re-export the canonical detection
from crisis.detect import detect_crisis, CrisisDetectionResult
# Issue deprecation warning on import
warnings.warn(
"dying_detection is deprecated. Use 'from crisis.detect import detect_crisis' instead. "
"All patterns have been consolidated into crisis/detect.py. "
"See issue #40.",
DeprecationWarning,
stacklevel=2,
)
@dataclass
class DetectionResult:
"""Backward-compatible result type matching the old dying_detection API."""
level: str
indicators: List[str] = field(default_factory=list)
recommended_action: str = ""
@@ -34,110 +37,9 @@ class DetectionResult:
session_hash: str = ""
# ── Tiered indicator patterns ───────────────────────────────────
# Each pattern is a regex matched against lowercased input.
CRITICAL_PATTERNS = [
(r"\bkill\s*(my)?self\b", "explicit self-harm intent"),
(r"\bsuicid(?:al|ed|e)\b", "suicide reference"),
(r"\bend\s*(my)?\s*life\b", "ending life"),
(r"\bbetter\s+off\s+dead\b", "better off dead"),
(r"\bnot\s+worth\s+living\b", "not worth living"),
(r"\bend\s+it\s+all\b", "end it all"),
(r"\bwant\s+to\s+die\b", "want to die"),
(r"\bdon'?t\s+want\s+to\s+live\b", "don't want to live"),
(r"\bcan'?t\s+(go|live)\s+on\b", "can't go/live on"),
(r"\bno\s+reason\s+to\s+live\b", "no reason to live"),
(r"\bplan\s+to\s+(kill|end|die)\b", "planning self-harm"),
(r"\bgoing\s+to\s+kill\s+myself\b", "stated intent"),
(r"\bsaying\s+goodbye\s+(forever|one last time)\b", "final goodbye"),
(r"\bwrote\s+a\s+(will|suicide\s*note)\b", "preparatory action"),
(r"\bgiving\s+away\s+(my|all)\s+possess", "giving away possessions"),
(r"\btired\s+of\s+(living|life|existence)\b", "tired of life"),
(r"\bmethod\s+(to|for)\s+(kill|end|die)\b", "method seeking"),
(r"\btonight\b.*\b(die|kill|end|suicid)", "immediate timeframe + intent"),
(r"\b(die|kill|end)\b.*\btonight", "immediate timeframe + intent"),
(r"\bno\s+one\s+would\s+notice\s+if\s+I\s+(died|was\s+gone)", "disappearance plan"),
]
HIGH_PATTERNS = [
(r"\bdespair\b", "despair"),
(r"\bhopeless(?:ness)?\b", "hopelessness"),
(r"\bcan'?t\s+take\s+this\s+anymore\b", "can't take it"),
(r"\bdon'?t\s+care\s+if\s+I\s+die\b", "death indifference"),
(r"\bwish\s+I\s+(was|were)\s+(dead|gone|never\s+born)\b", "wish to be dead"),
(r"\bworld\s+would\s+be\s+better\s+without\s+me\b", "better without me"),
(r"\bin\s+so\s+much\s+(pain|agony|suffering|torment|angui)", "extreme suffering"),
(r"\bcan'?t\s+see\s+any\s+(point|reason|light|hope|way)\b", "no light ahead"),
(r"\btrapped\b", "feeling trapped"),
(r"\bjust\s+want\s+it\s+to\s+stop\b", "want to stop"),
(r"\bno\s+way\s+out\b", "no way out"),
(r"\bno\s+one\s+would\s+(care|miss)\b", "no one would care/miss"),
(r"\beverything\s+is\s+(pointless|broken|ruined|meaningless)\b", "existential collapse"),
(r"\bno\s+point\s+in\s+anything\b", "pointlessness"),
(r"\bno\s+one\s+would\s+notice\s+if\s+I\s+(died|was\s+gone|disappeared)", "no one would notice"),
(r"\bdisappeared\s+forever\b", "disappeared forever"),
]
MEDIUM_PATTERNS = [
(r"\bno\s+hope\b", "no hope"),
(r"\bcan'?t\s+go\s+on\b", "can't go on"),
(r"\bcan'?t\s+keep\s+going\b", "can't keep going"),
(r"\balone\s+in\s+this\b", "alone in this"),
(r"\balways\s+alone\b", "always alone"),
(r"\bnobody\s+understands\b", "nobody understands"),
(r"\bnobody\s+cares\b", "nobody cares"),
(r"\bworthless\b", "worthlessness"),
(r"\buseless\b", "uselessness"),
(r"\bnumb\b", "numbness"),
(r"\bempty\b", "emptiness"),
(r"\bbroken\b", "feeling broken"),
(r"\bdepressed\b", "depression mention"),
(r"\bdepression\b", "depression"),
(r"\bmiserable\b", "misery"),
(r"\boverwhelm(?:ed|ing)\b", "overwhelmed"),
(r"\bcannot\s+cope\b", "cannot cope"),
(r"\b(drowning|sinking)\b", "drowning/sinking"),
(r"\bforgotten\b", "feeling forgotten"),
(r"\blost\s+all\s+hope\b", "lost all hope"),
(r"\bno\s+future\b", "no future"),
(r"\bno\s+tomorrow\b", "no tomorrow"),
]
LOW_PATTERNS = [
(r"\bunhappy\b", "unhappy"),
(r"\brough\s+(day|week|patch)\b", "rough time"),
(r"\btough\s+(time|day|week)\b", "tough time"),
(r"\bstressed\b", "stressed"),
(r"\bburnout\b", "burnout"),
(r"\bfrustrated\b", "frustrated"),
(r"\bthings\s+(are\s+)?hard\b", "things are hard"),
(r"\bnot\s+feeling\s+(great|myself|good)\b", "not feeling good"),
(r"\bstruggl", "struggling"),
(r"\bdown\b", "feeling down"),
(r"\bsad\b", "sad"),
(r"\bupset\b", "upset"),
(r"\blonely\b", "lonely"),
(r"\banxious?\b", "anxious/anxiety"),
(r"\bnot\s+okay\b", "not okay"),
]
# ── Pattern collections for easy iteration ──────────────────────
TIER_PATTERNS: Dict[str, List[tuple]] = {
"CRITICAL": CRITICAL_PATTERNS,
"HIGH": HIGH_PATTERNS,
"MEDIUM": MEDIUM_PATTERNS,
"LOW": LOW_PATTERNS,
}
def detect(text: str) -> DetectionResult:
"""
Primary detection function.
If the crisis/ module is available, delegate to it.
Otherwise, use the internal pattern engine.
Primary detection function — delegates to crisis.detect.
Args:
text: User message to analyze
@@ -145,150 +47,25 @@ def detect(text: str) -> DetectionResult:
Returns:
DetectionResult with level, indicators, recommended_action, confidence
"""
# Try to use the crisis module if available
try:
from crisis.detect import detect_crisis as _crisis_detect
result = _crisis_detect(text)
# Map to DetectionResult
return DetectionResult(
level=result.level,
indicators=_describe_indicators(result.level, result.indicators),
recommended_action=result.recommended_action,
confidence=result.score,
session_hash=_hash_session(text),
)
except ImportError:
pass
result = detect_crisis(text)
return _detect_internal(text)
# Extract raw patterns from matches
raw_patterns = [m["pattern"] for m in result.matches] if result.matches else []
def _detect_internal(text: str) -> DetectionResult:
"""Internal pattern-based detection (fallback)."""
if not text or not text.strip():
return DetectionResult(level="NONE", session_hash=_hash_session(text))
text_lower = text.lower()
all_matches: Dict[str, List[tuple]] = {
tier: [] for tier in TIER_PATTERNS
}
for tier, patterns in TIER_PATTERNS.items():
for pattern, description in patterns:
if re.search(pattern, text_lower):
all_matches[tier].append((pattern, description))
# CRITICAL patterns are the highest priority
if all_matches["CRITICAL"]:
return DetectionResult(
level="CRITICAL",
indicators=[desc for _, desc in all_matches["CRITICAL"]],
recommended_action=(
"INTERRUPT CONVERSATION IMMEDIATELY. "
"Ask 'Are you safe right now?' "
"Provide 988 Suicide & Crisis Lifeline (call or text 988). "
"Provide Crisis Text Line (text HOME to 741741). "
"Stay present. Do not disconnect. "
"Redirect to professional help. "
"This is the most sacred moment."
),
raw_matched_patterns=[pat for pat, _ in all_matches["CRITICAL"]],
confidence=1.0,
session_hash=_hash_session(text),
)
if all_matches["HIGH"]:
return DetectionResult(
level="HIGH",
indicators=[desc for _, desc in all_matches["HIGH"]],
recommended_action=(
"Show crisis panel prominently. "
"Ask about safety directly. "
"Surface 988 number and crisis resources. "
"Stay present and engaged. Do not rush to fix. "
"Monitor closely for escalation."
),
raw_matched_patterns=[pat for pat, _ in all_matches["HIGH"]],
confidence=0.75,
session_hash=_hash_session(text),
)
if all_matches["MEDIUM"]:
return DetectionResult(
level="MEDIUM",
indicators=[desc for _, desc in all_matches["MEDIUM"]],
recommended_action=(
"Increase warmth and presence. "
"Subtly surface help resources. "
"Keep conversation anchored in the present. "
"Watch for escalation indicators."
),
raw_matched_patterns=[pat for pat, _ in all_matches["MEDIUM"]],
confidence=0.5,
session_hash=_hash_session(text),
)
if all_matches["LOW"]:
return DetectionResult(
level="LOW",
indicators=[desc for _, desc in all_matches["LOW"]],
recommended_action=(
"Normal conversation with warm undertone. "
"No crisis UI elements needed. "
"Remain vigilant. Be present."
),
raw_matched_patterns=[pat for pat, _ in all_matches["LOW"]],
confidence=0.25,
session_hash=_hash_session(text),
)
return DetectionResult(level="NONE", session_hash=_hash_session(text))
def _describe_indicators(level: str, patterns: list) -> list:
"""Map raw patterns to descriptions."""
descriptions = {
"CRITICAL": [],
"HIGH": [],
"MEDIUM": [],
"LOW": [],
}
for tier, items in TIER_PATTERNS.items():
for pat, desc in items:
if pat in patterns:
descriptions[tier].append(desc)
return descriptions.get(level, [])
def _hash_session(text: str) -> str:
"""Create a session hash for this text (for tracking repeated escalations)."""
return hashlib.sha256(text.encode()).hexdigest()[:12]
return DetectionResult(
level=result.level,
indicators=result.indicators,
recommended_action=result.recommended_action,
raw_matched_patterns=raw_patterns,
confidence=result.score,
session_hash=hashlib.sha256(text.encode()).hexdigest()[:12],
)
def get_action_for_level(level: str) -> str:
"""Get the recommended action string for a given level."""
actions = {
"CRITICAL": (
"INTERRUPT CONVERSATION. Ask 'Are you safe right now?' "
"Provide 988. Provide Crisis Text Line. "
"Stay present. Do not disconnect. "
"Redirect to help."
),
"HIGH": (
"Show crisis panel. Ask about safety. "
"Surface 988. Stay engaged."
),
"MEDIUM": (
"Increase warmth. Surface resources gently. "
"Anchor in present."
),
"LOW": (
"Normal conversation with warmth. "
"Remain vigilant."
),
"NONE": "No action needed.",
}
return actions.get(level, "Unknown level.")
from crisis.detect import ACTIONS
return ACTIONS.get(level, "Unknown level.")
def as_json(result: DetectionResult, indent: int = 2) -> str:

View File

@@ -983,12 +983,60 @@ Sovereignty and service always.`;
// ===== OVERLAY =====
// Focus trap: cycle through focusable elements within the crisis overlay
function getOverlayFocusableElements() {
return crisisOverlay.querySelectorAll(
'a[href], button:not([disabled]), [tabindex]:not([tabindex="-1"])'
);
}
function trapFocusInOverlay(e) {
if (!crisisOverlay.classList.contains('active')) return;
if (e.key !== 'Tab') return;
var focusable = getOverlayFocusableElements();
if (focusable.length === 0) return;
var first = focusable[0];
var last = focusable[focusable.length - 1];
if (e.shiftKey) {
// Shift+Tab: if on first, wrap to last
if (document.activeElement === first) {
e.preventDefault();
last.focus();
}
} else {
// Tab: if on last, wrap to first
if (document.activeElement === last) {
e.preventDefault();
first.focus();
}
}
}
// Store the element that had focus before the overlay opened
var _preOverlayFocusElement = null;
function showOverlay() {
// Save current focus for restoration on dismiss
_preOverlayFocusElement = document.activeElement;
crisisOverlay.classList.add('active');
overlayDismissBtn.disabled = true;
var countdown = 10;
overlayDismissBtn.textContent = 'Continue to chat (' + countdown + 's)';
// Disable background interaction via inert attribute
var mainApp = document.querySelector('.app');
if (mainApp) mainApp.setAttribute('inert', '');
// Also hide from assistive tech
var chatSection = document.getElementById('chat');
if (chatSection) chatSection.setAttribute('aria-hidden', 'true');
var footerEl = document.querySelector('footer');
if (footerEl) footerEl.setAttribute('aria-hidden', 'true');
if (overlayTimer) clearInterval(overlayTimer);
overlayTimer = setInterval(function() {
countdown--;
@@ -1005,6 +1053,9 @@ Sovereignty and service always.`;
overlayDismissBtn.focus();
}
// Register focus trap on document (always listening, gated by class check)
document.addEventListener('keydown', trapFocusInOverlay);
overlayDismissBtn.addEventListener('click', function() {
if (!overlayDismissBtn.disabled) {
crisisOverlay.classList.remove('active');
@@ -1012,7 +1063,22 @@ Sovereignty and service always.`;
clearInterval(overlayTimer);
overlayTimer = null;
}
msgInput.focus();
// Re-enable background interaction
var mainApp = document.querySelector('.app');
if (mainApp) mainApp.removeAttribute('inert');
var chatSection = document.getElementById('chat');
if (chatSection) chatSection.removeAttribute('aria-hidden');
var footerEl = document.querySelector('footer');
if (footerEl) footerEl.removeAttribute('aria-hidden');
// Restore focus to the element that had it before the overlay opened
if (_preOverlayFocusElement && typeof _preOverlayFocusElement.focus === 'function') {
_preOverlayFocusElement.focus();
} else {
msgInput.focus();
}
_preOverlayFocusElement = null;
}
});
@@ -1117,25 +1183,14 @@ Sovereignty and service always.`;
} catch (e) {}
}
safetyPlanBtn.addEventListener('click', function() {
loadSafetyPlan();
safetyPlanModal.classList.add('active');
});
// Crisis panel safety plan button (if crisis panel is visible)
if (crisisSafetyPlanBtn) {
crisisSafetyPlanBtn.addEventListener('click', function() {
loadSafetyPlan();
safetyPlanModal.classList.add('active');
});
}
closeSafetyPlan.addEventListener('click', function() {
safetyPlanModal.classList.remove('active');
_restoreSafetyPlanFocus();
});
cancelSafetyPlan.addEventListener('click', function() {
safetyPlanModal.classList.remove('active');
_restoreSafetyPlanFocus();
});
saveSafetyPlan.addEventListener('click', function() {
@@ -1149,12 +1204,101 @@ Sovereignty and service always.`;
try {
localStorage.setItem('timmy_safety_plan', JSON.stringify(plan));
safetyPlanModal.classList.remove('active');
_restoreSafetyPlanFocus();
alert('Safety plan saved locally.');
} catch (e) {
alert('Error saving plan.');
}
});
// ===== SAFETY PLAN FOCUS TRAP (fix #65) =====
// Focusable elements inside the modal, in tab order
var _spFocusableIds = [
'close-safety-plan',
'sp-warning-signs',
'sp-coping',
'sp-distraction',
'sp-help',
'sp-environment',
'cancel-safety-plan',
'save-safety-plan'
];
var _spTriggerEl = null; // element that opened the modal
function _getSpFocusableEls() {
return _spFocusableIds
.map(function(id) { return document.getElementById(id); })
.filter(function(el) { return el && !el.disabled; });
}
function _trapSafetyPlanFocus(e) {
if (e.key !== 'Tab') return;
var els = _getSpFocusableEls();
if (!els.length) return;
var first = els[0];
var last = els[els.length - 1];
if (e.shiftKey) {
// Shift+Tab on first → wrap to last
if (document.activeElement === first) {
e.preventDefault();
last.focus();
}
} else {
// Tab on last → wrap to first
if (document.activeElement === last) {
e.preventDefault();
first.focus();
}
}
}
function _trapSafetyPlanEscape(e) {
if (e.key === 'Escape') {
safetyPlanModal.classList.remove('active');
_restoreSafetyPlanFocus();
}
}
function _activateSafetyPlanFocusTrap(triggerEl) {
_spTriggerEl = triggerEl || document.activeElement;
// Focus first textarea
var firstInput = document.getElementById('sp-warning-signs');
if (firstInput) firstInput.focus();
// Add listeners
document.addEventListener('keydown', _trapSafetyPlanFocus);
document.addEventListener('keydown', _trapSafetyPlanEscape);
// Mark background inert (prevent click-through)
document.body.setAttribute('aria-hidden', 'true');
safetyPlanModal.removeAttribute('aria-hidden');
}
function _restoreSafetyPlanFocus() {
document.removeEventListener('keydown', _trapSafetyPlanFocus);
document.removeEventListener('keydown', _trapSafetyPlanEscape);
document.body.removeAttribute('aria-hidden');
if (_spTriggerEl && typeof _spTriggerEl.focus === 'function') {
_spTriggerEl.focus();
}
_spTriggerEl = null;
}
// Wire open buttons to activate focus trap
safetyPlanBtn.addEventListener('click', function() {
loadSafetyPlan();
safetyPlanModal.classList.add('active');
_activateSafetyPlanFocusTrap(safetyPlanBtn);
});
// Crisis panel safety plan button (if crisis panel is visible)
if (crisisSafetyPlanBtn) {
crisisSafetyPlanBtn.addEventListener('click', function() {
loadSafetyPlan();
safetyPlanModal.classList.add('active');
_activateSafetyPlanFocusTrap(crisisSafetyPlanBtn);
});
}
// ===== TEXTAREA AUTO-RESIZE =====
msgInput.addEventListener('input', function() {
this.style.height = 'auto';
@@ -1300,6 +1444,7 @@ Sovereignty and service always.`;
if (urlParams.get('safetyplan') === 'true') {
loadSafetyPlan();
safetyPlanModal.classList.add('active');
_activateSafetyPlanFocusTrap(safetyPlanBtn);
// Clean up URL
window.history.replaceState({}, document.title, window.location.pathname);
}

View File

@@ -1,5 +1,5 @@
[pytest]
testpaths = crisis
python_files = tests.py
testpaths = crisis tests
python_files = tests.py test_*.py
python_classes = Test*
python_functions = test_*

219
sw.js
View File

@@ -1,118 +1,153 @@
const CACHE_NAME = 'the-door-v2';
const ASSETS = [
const CACHE_NAME = 'the-door-v3';
const NAVIGATION_TIMEOUT_MS = 2500;
const OFFLINE_FALLBACK_PATH = '/crisis-offline.html';
const PRECACHE_ASSETS = [
'/',
'/index.html',
'/about',
'/manifest.json'
'/about.html',
'/manifest.json',
'/crisis-offline.html',
'/testimony.html'
];
// Crisis resources to show when everything fails
const CRISIS_OFFLINE_RESPONSE = `<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>You're Not Alone | The Door</title>
<style>
body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;background:#0d1117;color:#e6edf3;max-width:600px;margin:0 auto;padding:20px;line-height:1.6}
h1{color:#ff6b6b;font-size:1.5rem;margin-bottom:1rem}
.crisis-box{background:#1c1210;border:2px solid #c9362c;border-radius:12px;padding:20px;margin:20px 0;text-align:center}
.crisis-box a{display:inline-block;background:#c9362c;color:#fff;text-decoration:none;padding:16px 32px;border-radius:8px;font-weight:700;font-size:1.2rem;margin:10px 0}
.hope{color:#8b949e;font-style:italic;margin-top:30px;padding-top:20px;border-top:1px solid #30363d}
</style>
</head>
<body>
<h1>You are not alone.</h1>
<p>Your connection is down, but help is still available.</p>
<div class="crisis-box">
<p><strong>Call or text 988</strong><br>Suicide & Crisis Lifeline<br>Free, 24/7, Confidential</p>
<a href="tel:988">Call 988 Now</a>
<p style="margin-top:15px"><strong>Or text HOME to 741741</strong><br>Crisis Text Line</p>
</div>
<p><strong>When you're ready:</strong></p>
<ul>
<li>Take five deep breaths</li>
<li>Drink some water</li>
<li>Step outside if you can</li>
<li>Text or call someone you trust</li>
</ul>
<p class="hope">
"The Lord is close to the brokenhearted and saves those who are crushed in spirit." — Psalm 34:18
</p>
<p style="font-size:0.85rem;color:#6e7681;margin-top:30px">
This page was created by The Door — a crisis intervention project.<br>
Connection will restore automatically. You don't have to go through this alone.
</p>
</body>
</html>`;
function isSameOrigin(request) {
return new URL(request.url).origin === self.location.origin;
}
function canCache(response) {
return Boolean(response && response.ok && response.type !== 'opaque');
}
async function precache() {
const cache = await caches.open(CACHE_NAME);
await cache.addAll(PRECACHE_ASSETS);
}
async function cleanupOldCaches() {
const keys = await caches.keys();
await Promise.all(
keys
.filter((key) => key !== CACHE_NAME)
.map((key) => caches.delete(key))
);
}
async function putInCache(request, response) {
if (!isSameOrigin(request) || !canCache(response)) {
return response;
}
const cache = await caches.open(CACHE_NAME);
await cache.put(request, response.clone());
return response;
}
async function fetchWithTimeout(request, timeoutMs) {
const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
try {
return await fetch(request, { signal: controller.signal });
} finally {
clearTimeout(timeoutId);
}
}
async function offlineTextResponse() {
return new Response('Offline. Call 988 or text HOME to 741741 for immediate help.', {
status: 503,
statusText: 'Service Unavailable',
headers: new Headers({ 'Content-Type': 'text/plain; charset=utf-8' })
});
}
async function handleNavigation(request) {
const cache = await caches.open(CACHE_NAME);
const cachedPage = await cache.match(request);
const offlineFallback = await cache.match(OFFLINE_FALLBACK_PATH);
try {
const response = await fetchWithTimeout(request, NAVIGATION_TIMEOUT_MS);
return await putInCache(request, response);
} catch (error) {
if (cachedPage) {
return cachedPage;
}
if (offlineFallback) {
return offlineFallback;
}
return offlineTextResponse();
}
}
async function handleStaticRequest(request) {
const cache = await caches.open(CACHE_NAME);
const cached = await cache.match(request);
if (cached) {
fetch(request)
.then((response) => putInCache(request, response))
.catch(() => null);
return cached;
}
try {
const response = await fetch(request);
return await putInCache(request, response);
} catch (error) {
return offlineTextResponse();
}
}
async function handleOtherRequest(request) {
try {
const response = await fetch(request);
return await putInCache(request, response);
} catch (error) {
const cached = await caches.match(request);
if (cached) {
return cached;
}
return offlineTextResponse();
}
}
// Install event - cache core assets
self.addEventListener('install', (event) => {
event.waitUntil(
caches.open(CACHE_NAME).then((cache) => {
return cache.addAll(ASSETS);
})
precache().then(() => self.skipWaiting())
);
self.skipWaiting();
});
// Activate event - cleanup old caches
self.addEventListener('activate', (event) => {
event.waitUntil(
caches.keys().then((keys) => {
return Promise.all(
keys.filter((key) => key !== CACHE_NAME).map((key) => caches.delete(key))
);
})
cleanupOldCaches().then(() => self.clients.claim())
);
self.clients.claim();
});
// Fetch event - network first, fallback to cache for static,
// but for the crisis front door, we want to ensure the shell is ALWAYS available.
self.addEventListener('fetch', (event) => {
const url = new URL(event.request.url);
const request = event.request;
const url = new URL(request.url);
// Skip API calls - they should always go to network
if (url.pathname.startsWith('/api/')) {
if (request.method !== 'GET') {
return;
}
// Skip non-GET requests
if (event.request.method !== 'GET') {
if (!isSameOrigin(request) || url.pathname.startsWith('/api/')) {
return;
}
event.respondWith(
fetch(event.request)
.then((response) => {
// If we got a valid response, cache it for next time
if (response.ok && ASSETS.includes(url.pathname)) {
const copy = response.clone();
caches.open(CACHE_NAME).then((cache) => cache.put(event.request, copy));
}
return response;
})
.catch(() => {
// If network fails, try cache
return caches.match(event.request).then((cached) => {
if (cached) return cached;
if (event.request.mode === 'navigate') {
event.respondWith(handleNavigation(request));
return;
}
// If it's a navigation request and we're offline, show offline crisis page
if (event.request.mode === 'navigate') {
return new Response(CRISIS_OFFLINE_RESPONSE, {
status: 200,
headers: new Headers({ 'Content-Type': 'text/html' })
});
}
if (PRECACHE_ASSETS.includes(url.pathname)) {
event.respondWith(handleStaticRequest(request));
return;
}
// For other requests, return a simple offline message
return new Response('Offline. Call 988 for immediate help.', {
status: 503,
statusText: 'Service Unavailable',
headers: new Headers({ 'Content-Type': 'text/plain' })
});
});
})
);
event.respondWith(handleOtherRequest(request));
});

View File

@@ -0,0 +1,84 @@
<!-- Test: Safety plan modal focus trap (issue #65) -->
<!-- Open this file in a browser to manually verify focus trap behavior -->
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Focus Trap Test</title>
<style>
body { font-family: sans-serif; padding: 20px; }
.test { margin: 10px 0; padding: 10px; border: 1px solid #ccc; }
.pass { background: #d4edda; border-color: #28a745; }
.fail { background: #f8d7da; border-color: #dc3545; }
button { margin: 5px; padding: 8px 16px; }
</style>
</head>
<body>
<h1>Focus Trap Manual Test</h1>
<p>Open <code>index.html</code> in a browser, then run these checks:</p>
<div class="test" id="test-1">
<strong>Test 1: Tab wraps to first element</strong><br>
1. Open safety plan modal<br>
2. Tab through all elements until you reach "Save Plan"<br>
3. Press Tab again → should wrap to close button (X)
</div>
<div class="test" id="test-2">
<strong>Test 2: Shift+Tab wraps to last element</strong><br>
1. Open safety plan modal<br>
2. Focus is on "Warning signs" textarea<br>
3. Press Shift+Tab → should wrap to "Save Plan" button
</div>
<div class="test" id="test-3">
<strong>Test 3: Escape closes modal</strong><br>
1. Open safety plan modal<br>
2. Press Escape → modal closes<br>
3. Focus returns to the button that opened it
</div>
<div class="test" id="test-4">
<strong>Test 4: Background not reachable</strong><br>
1. Open safety plan modal<br>
2. Try to Tab to the chat input behind the modal<br>
3. Should NOT be able to reach it
</div>
<div class="test" id="test-5">
<strong>Test 5: Click buttons close + restore focus</strong><br>
1. Open modal via "my safety plan" button<br>
2. Click Cancel → modal closes, focus on "my safety plan" button<br>
3. Open again, click Save → same behavior<br>
4. Open again, click X → same behavior
</div>
<hr>
<h2>Automated checks (paste into DevTools console on index.html):</h2>
<pre><code>
// Test focus trap
var modal = document.getElementById('safety-plan-modal');
var openBtn = document.getElementById('safety-plan-btn');
openBtn.click();
console.assert(modal.classList.contains('active'), 'Modal should be open');
var lastEl = document.getElementById('save-safety-plan');
lastEl.focus();
var evt = new KeyboardEvent('keydown', {key: 'Tab', bubbles: true});
document.dispatchEvent(evt);
// After Tab from last, focus should wrap to first
var firstEl = document.getElementById('close-safety-plan');
console.log('Focus after wrap:', document.activeElement.id);
console.assert(document.activeElement === firstEl || document.activeElement.id === 'sp-warning-signs',
'Focus should wrap to first element');
// Test Escape
var escEvt = new KeyboardEvent('keydown', {key: 'Escape', bubbles: true});
document.dispatchEvent(escEvt);
console.assert(!modal.classList.contains('active'), 'Modal should close on Escape');
console.assert(document.activeElement === openBtn, 'Focus should return to open button');
console.log('All automated checks passed!');
</code></pre>
</body>
</html>

View File

@@ -0,0 +1,410 @@
#!/usr/bin/env python3
"""
Tests for crisis detection A/B test framework.
Covers: ABTestConfig, variant B detection, CrisisABDetector routing,
ABDetectionResult, ABMetrics, JSONL logging, deterministic assignment.
"""
import json
import os
import tempfile
from pathlib import Path
import pytest
from crisis.ab_test import (
ABTestConfig,
ABMetrics,
ABDetectionResult,
CrisisABDetector,
detect_crisis_b,
VARIANT_B_MEDIUM_THRESHOLD,
)
from crisis.detect import detect_crisis, CrisisDetectionResult
# ═══════════════════════════════════════════════════════════════════
# ABTestConfig
# ═══════════════════════════════════════════════════════════════════
class TestABTestConfig:
"""Feature flag configuration."""
def test_default_is_variant_a(self):
config = ABTestConfig()
assert config.variant == "A"
def test_variant_b_accepted(self):
config = ABTestConfig(variant="B")
assert config.variant == "B"
def test_invalid_variant_rejected(self):
with pytest.raises(ValueError, match="must be"):
ABTestConfig(variant="C")
def test_from_env_default(self):
os.environ.pop("CRISIS_AB_VARIANT", None)
config = ABTestConfig.from_env()
assert config.variant == "A"
def test_from_env_variant_b(self, monkeypatch):
monkeypatch.setenv("CRISIS_AB_VARIANT", "B")
config = ABTestConfig.from_env()
assert config.variant == "B"
def test_from_env_fp_labels(self, monkeypatch):
monkeypatch.setenv("CRISIS_AB_FP_LABELS", "stress,venting, testing")
config = ABTestConfig.from_env()
assert config.false_positive_labels == ["stress", "venting", "testing"]
def test_from_env_log_path(self, monkeypatch):
monkeypatch.setenv("CRISIS_AB_LOG_PATH", "/tmp/ab.jsonl")
config = ABTestConfig.from_env()
assert config.log_path == "/tmp/ab.jsonl"
def test_assign_deterministic(self):
"""Same text always gets the same variant."""
v1 = ABTestConfig.assign("I feel hopeless today")
v2 = ABTestConfig.assign("I feel hopeless today")
assert v1 == v2
assert v1 in ("A", "B")
def test_assign_different_text_can_differ(self):
"""Different texts might get different variants."""
results = set()
for i in range(20):
v = ABTestConfig.assign(f"test message {i}")
results.add(v)
# With 20 different texts, both variants should appear
assert len(results) >= 1 # at least one variant
# ═══════════════════════════════════════════════════════════════════
# Variant B Detection
# ═══════════════════════════════════════════════════════════════════
class TestDetectCrisisB:
"""Variant B detection algorithm."""
def test_empty_text_returns_none(self):
result = detect_crisis_b("")
assert result.level == "NONE"
assert result.score == 0.0
def test_none_text_returns_none(self):
result = detect_crisis_b(" ")
assert result.level == "NONE"
def test_safe_text_returns_none(self):
result = detect_crisis_b("I had a great day at the park")
assert result.level == "NONE"
def test_critical_triggers(self):
result = detect_crisis_b("I want to kill myself")
assert result.level == "CRITICAL"
assert result.score >= 1.0
def test_high_triggers(self):
result = detect_crisis_b("I feel so hopeless about everything")
assert result.level == "HIGH"
assert result.score >= 0.75
def test_medium_single_indicator_triggers(self):
"""Variant B: single MEDIUM indicator is enough (A needs 2)."""
result = detect_crisis_b("I feel so worthless")
assert result.level == "MEDIUM"
assert result.score >= 0.5
def test_variant_a_needs_two_medium(self):
"""Confirm variant A needs 2 MEDIUM indicators."""
# Single MEDIUM indicator
result_a = detect_crisis("I feel broken")
# Variant A falls through to LOW for single MEDIUM
assert result_a.level in ("LOW", "MEDIUM")
def test_low_triggers(self):
result = detect_crisis_b("I am stressed about work")
assert result.level == "LOW"
def test_multi_tier_boost(self):
"""When multiple tiers fire, score gets +0.1 boost."""
# Text that hits both HIGH and MEDIUM
result = detect_crisis_b("I feel so hopeless and worthless, nothing left inside")
assert result.level == "HIGH"
# Score should be boosted above base HIGH
assert result.score > 0.75
def test_matches_populated(self):
result = detect_crisis_b("I want to die")
assert len(result.matches) > 0
assert "start" in result.matches[0]
assert "end" in result.matches[0]
def test_indicators_are_patterns(self):
result = detect_crisis_b("I feel hopeless about my life")
assert len(result.indicators) > 0
for p in result.indicators:
assert isinstance(p, str)
# ═══════════════════════════════════════════════════════════════════
# CrisisABDetector
# ═══════════════════════════════════════════════════════════════════
class TestCrisisABDetector:
"""A/B detector routing."""
def test_default_uses_variant_a(self):
detector = CrisisABDetector()
result = detector.detect("hello world")
assert result.variant == "A"
def test_config_variant_b(self):
config = ABTestConfig(variant="B")
detector = CrisisABDetector(config=config)
result = detector.detect("hello world")
assert result.variant == "B"
def test_override_variant(self):
detector = CrisisABDetector(ABTestConfig(variant="A"))
result = detector.detect("test", variant="B")
assert result.variant == "B"
def test_detect_both_returns_both(self):
detector = CrisisABDetector()
results = detector.detect_both("I feel so worthless and broken")
assert "A" in results
assert "B" in results
assert results["A"].variant == "A"
assert results["B"].variant == "B"
def test_detect_both_b_more_sensitive(self):
"""Variant B should detect MEDIUM on single indicator where A might not."""
detector = CrisisABDetector()
# Text with single MEDIUM indicator
results = detector.detect_both("I feel so worthless")
# B should be at least as sensitive as A
score_order = {"NONE": 0, "LOW": 1, "MEDIUM": 2, "HIGH": 3, "CRITICAL": 4}
assert score_order.get(results["B"].level, 0) >= score_order.get(results["A"].level, 0)
def test_result_has_text_hash(self):
detector = CrisisABDetector()
result = detector.detect("test message")
assert len(result.text_hash) == 16
assert all(c in "0123456789abcdef" for c in result.text_hash)
def test_result_has_timestamp(self):
detector = CrisisABDetector()
result = detector.detect("test")
assert result.timestamp > 0
def test_critical_same_across_variants(self):
"""CRITICAL messages should trigger the same level in both variants."""
detector = CrisisABDetector()
results = detector.detect_both("I plan to end my life")
assert results["A"].level == "CRITICAL"
assert results["B"].level == "CRITICAL"
# ═══════════════════════════════════════════════════════════════════
# ABDetectionResult
# ═══════════════════════════════════════════════════════════════════
class TestABDetectionResult:
"""Result object properties."""
def test_to_dict(self):
detector = CrisisABDetector()
result = detector.detect("test")
d = result.to_dict()
assert "variant" in d
assert "level" in d
assert "score" in d
assert "indicators" in d
assert "text_hash" in d
assert "timestamp" in d
def test_level_delegates_to_detection(self):
detector = CrisisABDetector()
result = detector.detect("I want to die")
assert result.level == result.detection.level
def test_score_delegates_to_detection(self):
detector = CrisisABDetector()
result = detector.detect("I feel hopeless")
assert result.score == result.detection.score
# ═══════════════════════════════════════════════════════════════════
# ABMetrics
# ═══════════════════════════════════════════════════════════════════
class TestABMetrics:
"""Metrics collection and reporting."""
def test_empty_report(self):
metrics = ABMetrics()
report = metrics.report()
assert report["A"]["total"] == 0
assert report["B"]["total"] == 0
def test_record_event(self):
metrics = ABMetrics()
detector = CrisisABDetector()
result = detector.detect("test", variant="A")
metrics.record(result, latency_ms=5.0)
report = metrics.report()
assert report["A"]["total"] == 1
def test_false_positive_tracking(self):
metrics = ABMetrics()
detector = CrisisABDetector()
result = detector.detect("I feel broken", variant="B")
metrics.record(result, is_false_positive=True)
report = metrics.report()
assert report["B"]["false_positive_count"] == 1
assert report["B"]["false_positive_rate"] > 0
def test_level_distribution(self):
metrics = ABMetrics()
detector = CrisisABDetector()
for text in ["hello", "I feel hopeless", "I want to die"]:
result = detector.detect(text, variant="A")
metrics.record(result)
report = metrics.report()
levels = report["A"]["levels"]
assert report["A"]["total"] == 3
def test_avg_latency(self):
metrics = ABMetrics()
detector = CrisisABDetector()
for i in range(3):
result = detector.detect(f"test {i}", variant="A")
metrics.record(result, latency_ms=10.0 + i)
report = metrics.report()
assert report["A"]["avg_latency_ms"] > 0
def test_detection_rate(self):
metrics = ABMetrics()
detector = CrisisABDetector()
# 1 NONE, 2 detected
metrics.record(detector.detect("hello", variant="A"))
metrics.record(detector.detect("I feel hopeless", variant="A"))
metrics.record(detector.detect("I want to die", variant="A"))
report = metrics.report()
rate = report["A"]["detection_rate"]
assert 0.5 < rate < 1.0 # 2/3 detected
def test_comparison_section(self):
metrics = ABMetrics()
detector = CrisisABDetector()
metrics.record(detector.detect("I feel broken", variant="A"))
metrics.record(detector.detect("I feel worthless", variant="B"))
report = metrics.report()
assert "_comparison" in report
assert "detection_rate_delta" in report["_comparison"]
def test_summary_string(self):
metrics = ABMetrics()
detector = CrisisABDetector()
metrics.record(detector.detect("I want to die", variant="A"))
metrics.record(detector.detect("I feel hopeless", variant="B"))
s = metrics.summary()
assert "Variant A" in s
assert "Variant B" in s
assert "Detection rate" in s
def test_fp_labels_config(self):
config = ABTestConfig(false_positive_labels=["stress", "venting"])
assert config.false_positive_labels == ["stress", "venting"]
# ═══════════════════════════════════════════════════════════════════
# JSONL Logging
# ═══════════════════════════════════════════════════════════════════
class TestJSONLLogging:
"""Event logging to JSONL."""
def test_log_file_created(self, tmp_path):
log_path = str(tmp_path / "ab_log.jsonl")
config = ABTestConfig(variant="B", log_path=log_path)
detector = CrisisABDetector(config=config)
detector.detect("I feel hopeless")
assert Path(log_path).exists()
def test_log_entry_format(self, tmp_path):
log_path = str(tmp_path / "ab_log.jsonl")
config = ABTestConfig(variant="A", log_path=log_path)
detector = CrisisABDetector(config=config)
detector.detect("I want to die")
with open(log_path) as f:
entry = json.loads(f.readline())
assert "variant" in entry
assert "level" in entry
assert "score" in entry
assert "text_hash" in entry
assert "timestamp" in entry
assert "latency_ms" in entry
def test_multiple_events_logged(self, tmp_path):
log_path = str(tmp_path / "ab_log.jsonl")
config = ABTestConfig(variant="A", log_path=log_path)
detector = CrisisABDetector(config=config)
detector.detect("hello")
detector.detect("I feel broken")
detector.detect("I want to die")
with open(log_path) as f:
lines = f.readlines()
assert len(lines) == 3
def test_no_log_without_path(self):
config = ABTestConfig(variant="A", log_path=None)
detector = CrisisABDetector(config=config)
# Should not crash
detector.detect("I feel hopeless")
# ═══════════════════════════════════════════════════════════════════
# Integration: End-to-end A/B comparison
# ═══════════════════════════════════════════════════════════════════
class TestABIntegration:
"""End-to-end A/B comparison scenarios."""
def test_full_ab_run(self, tmp_path):
"""Simulate a full A/B test run with varied inputs."""
log_path = str(tmp_path / "run.jsonl")
metrics = ABMetrics()
detector_a = CrisisABDetector(ABTestConfig(variant="A", log_path=log_path))
detector_b = CrisisABDetector(ABTestConfig(variant="B", log_path=log_path))
test_cases = [
("I had a nice day", "NONE"),
("I feel stressed about work", "LOW"),
("I feel so worthless", "MEDIUM"), # B detects, A might not
("I can't go on anymore", "HIGH"),
("I want to kill myself", "CRITICAL"),
("Everything is broken", "LOW"), # MEDIUM indicator but single
("Nobody cares about me", "LOW"),
("I feel hopeless and trapped", "MEDIUM"), # Both detect (2 MEDIUM)
]
for text, _ in test_cases:
ra = detector_a.detect(text)
rb = detector_b.detect(text)
metrics.record(ra, latency_ms=1.0)
metrics.record(rb, latency_ms=1.5)
report = metrics.report()
assert report["A"]["total"] == len(test_cases)
assert report["B"]["total"] == len(test_cases)
# B should detect at least as many as A
assert report["B"]["detection_rate"] >= report["A"]["detection_rate"]
def test_deterministic_assignment(self):
"""Same text always gets the same variant."""
results = [ABTestConfig.assign("crisis message 42") for _ in range(10)]
assert all(r == results[0] for r in results)

View File

@@ -0,0 +1,57 @@
import pathlib
import re
import unittest
ROOT = pathlib.Path(__file__).resolve().parents[1]
INDEX_HTML = ROOT / 'index.html'
class TestCrisisOverlayFocusTrap(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls.html = INDEX_HTML.read_text()
def test_overlay_registers_tab_key_focus_trap(self):
self.assertRegex(
self.html,
r"function\s+trapFocusInOverlay\s*\(e\)",
'Expected crisis overlay focus trap handler to exist.',
)
self.assertRegex(
self.html,
r"if\s*\(e\.key\s*!==\s*'Tab'\)\s*return;",
'Expected focus trap handler to guard on Tab key events.',
)
self.assertRegex(
self.html,
r"document\.addEventListener\('keydown',\s*trapFocusInOverlay\)",
'Expected overlay focus trap to register on document keydown.',
)
def test_overlay_disables_background_interaction(self):
self.assertRegex(
self.html,
r"mainApp\.setAttribute\('inert',\s*''\)",
'Expected overlay to set inert on the main app while active.',
)
self.assertRegex(
self.html,
r"mainApp\.removeAttribute\('inert'\)",
'Expected overlay dismissal to remove inert from the main app.',
)
def test_overlay_restores_focus_after_dismiss(self):
self.assertRegex(
self.html,
r"_preOverlayFocusElement\s*=\s*document\.activeElement",
'Expected overlay to remember the pre-overlay focus target.',
)
self.assertRegex(
self.html,
r"_preOverlayFocusElement\.focus\(\)",
'Expected overlay dismissal to restore focus to the prior target.',
)
if __name__ == '__main__':
unittest.main()

View File

@@ -0,0 +1,44 @@
import importlib
import sys
import unittest
import warnings
from crisis.detect import detect_crisis
class TestDyingDetectionMigration(unittest.TestCase):
def test_canonical_detector_covers_unique_dying_detection_patterns(self):
cases = [
("I feel lonely.", "LOW"),
("I've lost all hope and see no tomorrow.", "MEDIUM"),
("What if I disappeared forever?", "HIGH"),
]
for text, expected_level in cases:
with self.subTest(text=text):
result = detect_crisis(text)
self.assertEqual(result.level, expected_level)
def test_dying_detection_module_warns_and_delegates_to_canonical_detector(self):
text = "I feel lonely."
sys.modules.pop("dying_detection", None)
with warnings.catch_warnings(record=True) as caught:
warnings.simplefilter("always", DeprecationWarning)
module = importlib.import_module("dying_detection")
self.assertTrue(
any(issubclass(w.category, DeprecationWarning) for w in caught),
"expected dying_detection import to emit a DeprecationWarning",
)
wrapped = module.detect(text)
canonical = detect_crisis(text)
self.assertEqual(wrapped.level, canonical.level)
self.assertEqual(wrapped.confidence, canonical.score)
self.assertEqual(wrapped.raw_matched_patterns, [m["pattern"] for m in canonical.matches])
if __name__ == "__main__":
unittest.main()

View File

@@ -0,0 +1,55 @@
import pathlib
import unittest
ROOT = pathlib.Path(__file__).resolve().parents[1]
SERVICE_WORKER = (ROOT / 'sw.js').read_text(encoding='utf-8')
CRISIS_OFFLINE_PAGE = ROOT / 'crisis-offline.html'
MAKEFILE = (ROOT / 'Makefile').read_text(encoding='utf-8')
class TestServiceWorkerOffline(unittest.TestCase):
def test_crisis_offline_page_exists(self):
self.assertTrue(CRISIS_OFFLINE_PAGE.exists(), 'crisis-offline.html should exist')
def test_service_worker_precaches_crisis_offline_page(self):
self.assertIn('/crisis-offline.html', SERVICE_WORKER)
def test_service_worker_has_navigation_timeout_for_intermittent_connections(self):
self.assertIn('NAVIGATION_TIMEOUT_MS', SERVICE_WORKER)
self.assertIn('AbortController', SERVICE_WORKER)
def test_service_worker_uses_crisis_offline_fallback_for_navigation(self):
self.assertIn("event.request.mode === 'navigate'", SERVICE_WORKER)
self.assertIn("/crisis-offline.html", SERVICE_WORKER)
def test_make_push_includes_crisis_offline_page(self):
self.assertIn('crisis-offline.html', MAKEFILE)
class TestCrisisOfflinePage(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls.html = CRISIS_OFFLINE_PAGE.read_text(encoding='utf-8') if CRISIS_OFFLINE_PAGE.exists() else ''
cls.lower_html = cls.html.lower()
def test_has_clickable_988_link(self):
self.assertIn('href="tel:988"', self.html)
def test_has_crisis_text_line(self):
self.assertIn('Crisis Text Line', self.html)
self.assertIn('741741', self.html)
def test_has_grounding_techniques(self):
required_phrases = [
'5 things you can see',
'4 things you can feel',
'3 things you can hear',
'2 things you can smell',
'1 thing you can taste',
]
for phrase in required_phrases:
self.assertIn(phrase, self.lower_html)
if __name__ == '__main__':
unittest.main()