feat: add operator augmentation sidebar for #135

Fixes #59

The footer links to /about but the repo ships about.html. On a plain static server this results in a 404. Changed to /about.html so the link resolves correctly.

Makefile

@@ -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"
 

augmentation.py

@@ -0,0 +1,142 @@
+"""Local-only counselor augmentation helpers for the-door."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import List
+import re
+
+from crisis.detect import detect_crisis
+
+
+@dataclass(frozen=True)
+class SignalGuide:
+    label: str
+    patterns: List[str]
+    talking_point: str
+    deescalation: str
+    follow_up: str
+
+
+@dataclass
+class CounselorAugmentation:
+    risk_level: str
+    risk_score: int
+    signals: List[str]
+    suggested_talking_points: List[str]
+    deescalation_techniques: List[str]
+    follow_up_prompt: str
+    operator_notice: str
+    local_only: bool = True
+    advisory_only: bool = True
+
+
+SIGNAL_GUIDES: List[SignalGuide] = [
+    SignalGuide(
+        label="Explicit self-harm intent",
+        patterns=[
+            r"\bkill\s*(my)?self\b",
+            r"\bend\s*my\s*life\b",
+            r"\bwrote\s+a\s+suicide\s*(?:note|letter)\b",
+            r"\bgoing\s+to\s+(?:kill\s+myself|die)\b",
+        ],
+        talking_point="Ask directly whether they are safe right now and keep the next question concrete.",
+        deescalation="Move to immediate safety: ask about means, people nearby, and whether they can call or text 988 now.",
+        follow_up="You said you're ready to die. Are you alone right now, and can you tell me what is within reach?",
+    ),
+    SignalGuide(
+        label="Hopelessness / collapse",
+        patterns=[
+            r"\bhopeless\b",
+            r"\bcan'?t\s+go\s+on\b",
+            r"\bno\s+future\b",
+            r"\bnothing\s+left\b",
+        ],
+        talking_point="Reflect the hopelessness plainly before offering options. Avoid arguing with the feeling.",
+        deescalation="Narrow the time horizon: focus on the next ten minutes, one breath, one call, one person.",
+        follow_up="You said things feel hopeless. What feels most dangerous about the next hour?",
+    ),
+    SignalGuide(
+        label="Isolation / burden",
+        patterns=[
+            r"\bnobody\s+cares\b",
+            r"\bbetter\s+off\s+without\s+me\b",
+            r"\balone\b",
+            r"\bburden\b",
+        ],
+        talking_point="Counter isolation with immediacy: name one real person or service they can contact now.",
+        deescalation="Invite a tiny reconnection step: text one safe person, unlock the door, move closer to others, or stay in the chat.",
+        follow_up="You said you feel alone. Who is the safest real person we could bring into this moment with you?",
+    ),
+    SignalGuide(
+        label="Overwhelm / panic",
+        patterns=[
+            r"\bdesperate\b",
+            r"\boverwhelm(?:ed|ing)\b",
+            r"\btrapped\b",
+            r"\bpanic\b",
+        ],
+        talking_point="Offer one regulating action at a time instead of a list. Slow the pace of the chat.",
+        deescalation="Ground in the room: feet on the floor, name five visible objects, one sip of water, one slow exhale.",
+        follow_up="You said this feels overwhelming. What is the smallest thing in the room you can touch right now?",
+    ),
+]
+
+
+class CounselorAugmentationEngine:
+    BASE_SCORES = {
+        "NONE": 5,
+        "LOW": 25,
+        "MEDIUM": 55,
+        "HIGH": 75,
+        "CRITICAL": 95,
+    }
+
+    def _matched_guides(self, text: str) -> List[SignalGuide]:
+        lowered = text.lower()
+        matched: List[SignalGuide] = []
+        for guide in SIGNAL_GUIDES:
+            if any(re.search(pattern, lowered) for pattern in guide.patterns):
+                matched.append(guide)
+        return matched
+
+    def build_augmented_guidance(self, text: str, assistant_text: str = "") -> CounselorAugmentation:
+        detection = detect_crisis(text)
+        guides = self._matched_guides(text)
+
+        risk_level = detection.level
+        signals = [guide.label for guide in guides]
+        if risk_level == "CRITICAL" and "Explicit self-harm intent" not in signals:
+            signals.insert(0, "Explicit self-harm intent")
+
+        risk_score = self.BASE_SCORES.get(risk_level, 5) + min(len(signals) * 5, 10)
+        if risk_level == "CRITICAL":
+            risk_score = max(risk_score, 95)
+
+        talking_points = [guide.talking_point for guide in guides] or [
+            "Keep the response advisory and grounded in immediate safety, not abstract reassurance."
+        ]
+        deescalation = [guide.deescalation for guide in guides] or [
+            "Use short sentences, slow the conversation, and invite one concrete grounding step."
+        ]
+
+        quote = text.strip().replace("\n", " ")[:120]
+        follow_up = (guides[0].follow_up if guides else "What feels most dangerous or heavy for you right now?")
+        follow_up_prompt = f'You said "{quote}". Consider following up with: {follow_up}'
+
+        if assistant_text and "988" not in assistant_text and risk_level in {"HIGH", "CRITICAL"}:
+            talking_points.append("Surface 988 or Crisis Text Line explicitly if the assistant has not already done so.")
+
+        return CounselorAugmentation(
+            risk_level=risk_level,
+            risk_score=min(risk_score, 100),
+            signals=signals,
+            suggested_talking_points=talking_points,
+            deescalation_techniques=deescalation,
+            follow_up_prompt=follow_up_prompt,
+            operator_notice="Local-only advisory. This never replaces human judgment.",
+        )
+
+
+def build_augmented_guidance(text: str, assistant_text: str = "") -> CounselorAugmentation:
+    return CounselorAugmentationEngine().build_augmented_guidance(text, assistant_text=assistant_text)

crisis-offline.html

@@ -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>

crisis/__init__.py

@@ -7,7 +7,7 @@ Stands between a broken man and a machine that would tell him to die.
 from .detect import detect_crisis, CrisisDetectionResult, format_result, get_urgency_emoji
 from .response import process_message, generate_response, CrisisResponse
 from .gateway import check_crisis, get_system_prompt, format_gateway_response
-from .session_tracker import CrisisSessionTracker, CrisisSessionState
+from .session_tracker import CrisisSessionTracker, SessionState, check_crisis_with_session
 
 __all__ = [
     "detect_crisis",
@@ -21,5 +21,6 @@ __all__ = [
     "format_gateway_response",
     "get_urgency_emoji",
     "CrisisSessionTracker",
-    "CrisisSessionState",
+    "SessionState",
+    "check_crisis_with_session",
 ]

crisis/detect.py

@@ -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",

crisis/gateway.py

@@ -22,6 +22,7 @@ from .response import (
     get_system_prompt_modifier,
     CrisisResponse,
 )
+from .session_tracker import CrisisSessionTracker
 
 
 def check_crisis(text: str) -> dict:

crisis/session_tracker.py

@@ -1,261 +1,259 @@
 """
-Session-Level Crisis Tracking for the-door.
+Session-level crisis tracking and escalation for the-door (P0 #35).
 
-Tracks crisis signals across a conversation session to detect escalation
-patterns and de-escalation. Privacy-first: state lives in memory only,
-resets on new session, never persists to disk.
+Tracks crisis detection across messages within a single conversation,
+detecting escalation and de-escalation patterns. Privacy-first: no
+persistence beyond the conversation session.
 
-Key behaviors:
-  - Escalation: LOW → HIGH in 3 messages triggers heightened awareness
-  - De-escalation: CRITICAL → LOW for 5+ messages allows stepping down
-  - Session state enriches the system prompt with trajectory context
+Each message is analyzed in isolation by detect.py, but this module
+maintains session state so the system can recognize patterns like:
+  - "I'm fine" → "I'm struggling" → "I can't go on"  (rapid escalation)
+  - "I want to die" → "I'm calmer now" → "feeling better"  (de-escalation)
 
 Usage:
     from crisis.session_tracker import CrisisSessionTracker
 
     tracker = CrisisSessionTracker()
-    tracker.record("I'm feeling down")
-    tracker.record("Things are really hard")
-    tracker.record("I can't go on anymore")  # escalation detected
-    print(tracker.get_prompt_context())
-    # "User has escalated from LOW to HIGH over 3 messages."
+
+    # Feed each message's detection result
+    state = tracker.record(detect_crisis("I'm having a tough day"))
+    print(state.current_level)  # "LOW"
+    print(state.is_escalating)  # False
+
+    state = tracker.record(detect_crisis("I feel hopeless"))
+    print(state.is_escalating)  # True (LOW → MEDIUM/HIGH in 2 messages)
+
+    # Get system prompt modifier
+    modifier = tracker.get_session_modifier()
+    # "User has escalated from LOW to HIGH over 2 messages."
+
+    # Reset for new session
+    tracker.reset()
 """
 
 from dataclasses import dataclass, field
-from typing import List, Optional, Tuple
+from typing import List, Optional
 
-from .detect import detect_crisis, CrisisDetectionResult, SCORES
+from .detect import CrisisDetectionResult, SCORES
 
-
-# Level hierarchy for ordering comparisons
+# Level ordering for comparison (higher = more severe)
 LEVEL_ORDER = {"NONE": 0, "LOW": 1, "MEDIUM": 2, "HIGH": 3, "CRITICAL": 4}
 
 
 @dataclass
-class CrisisSessionState:
+class SessionState:
     """Immutable snapshot of session crisis tracking state."""
+
     current_level: str = "NONE"
     peak_level: str = "NONE"
     message_count: int = 0
-    level_history: List[Tuple[int, str]] = field(default_factory=list)  # (message_index, level)
-    escalated: bool = False
-    escalation_messages: int = 0  # messages from first level to peak
-    deescalation_count: int = 0  # consecutive messages at lower level
-    deescalating: bool = False
-    deescalation_confirmed: bool = False  # True once de-escalation threshold met
+    level_history: List[str] = field(default_factory=list)
+    is_escalating: bool = False
+    is_deescalating: bool = False
+    escalation_rate: float = 0.0  # levels gained per message
+    consecutive_low_messages: int = 0  # for de-escalation tracking
 
 
 class CrisisSessionTracker:
     """
-    Session-level crisis tracker.
+    Session-level crisis state tracker.
 
-    Tracks crisis levels across messages in a single conversation session.
-    Detects rapid escalation and gradual de-escalation. Provides context
-    strings for system prompt injection.
-
-    State is in-memory only. New session = new instance.
+    Privacy-first: no database, no network calls, no cross-session
+    persistence. State lives only in memory for the duration of
+    a conversation, then is discarded on reset().
     """
 
-    # How many messages for escalation detection
-    ESCALATION_WINDOW = 3
-
-    # How many consecutive messages at lower level for de-escalation
-    DEESCALATION_THRESHOLD = 5
+    # Thresholds (from issue #35)
+    ESCALATION_WINDOW = 3   # messages: LOW → HIGH in ≤3 messages = rapid escalation
+    DEESCALATION_WINDOW = 5  # messages: need 5+ consecutive LOW messages after CRITICAL
 
     def __init__(self):
-        self._state = CrisisSessionState()
-
-    @property
-    def state(self) -> CrisisSessionState:
-        """Read-only snapshot of current state."""
-        return CrisisSessionState(
-            current_level=self._state.current_level,
-            peak_level=self._state.peak_level,
-            message_count=self._state.message_count,
-            level_history=list(self._state.level_history),
-            escalated=self._state.escalated,
-            escalation_messages=self._state.escalation_messages,
-            deescalation_count=self._state.deescalation_count,
-            deescalating=self._state.deescalating,
-        )
+        self.reset()
 
     def reset(self):
-        """Reset all state. Called on new session."""
-        self._state = CrisisSessionState()
+        """Reset all session state. Call on new conversation."""
+        self._current_level = "NONE"
+        self._peak_level = "NONE"
+        self._message_count = 0
+        self._level_history: List[str] = []
+        self._consecutive_low = 0
 
-    def record(self, text: str) -> CrisisDetectionResult:
+    @property
+    def state(self) -> SessionState:
+        """Return immutable snapshot of current session state."""
+        is_escalating = self._detect_escalation()
+        is_deescalating = self._detect_deescalation()
+        rate = self._compute_escalation_rate()
+
+        return SessionState(
+            current_level=self._current_level,
+            peak_level=self._peak_level,
+            message_count=self._message_count,
+            level_history=list(self._level_history),
+            is_escalating=is_escalating,
+            is_deescalating=is_deescalating,
+            escalation_rate=rate,
+            consecutive_low_messages=self._consecutive_low,
+        )
+
+    def record(self, detection: CrisisDetectionResult) -> SessionState:
         """
-        Record a message and update session state.
+        Record a crisis detection result for the current message.
 
-        Returns the single-message detection result (unchanged from detect.py).
-        Session-level intelligence is tracked internally.
+        Returns updated SessionState.
         """
-        detection = detect_crisis(text)
-        self._record_level(detection.level)
-        return detection
+        level = detection.level
+        self._message_count += 1
+        self._level_history.append(level)
 
-    def record_level(self, level: str):
-        """Record an already-detected crisis level (for when detection ran separately)."""
-        self._record_level(level)
+        # Update peak
+        if LEVEL_ORDER.get(level, 0) > LEVEL_ORDER.get(self._peak_level, 0):
+            self._peak_level = level
 
-    def _record_level(self, level: str):
-        """Internal: update state with a new crisis level."""
-        self._state.message_count += 1
-        idx = self._state.message_count
-        self._state.level_history.append((idx, level))
+        # Track consecutive LOW/NONE messages for de-escalation
+        if LEVEL_ORDER.get(level, 0) <= LEVEL_ORDER["LOW"]:
+            self._consecutive_low += 1
+        else:
+            self._consecutive_low = 0
 
-        prev_level = self._state.current_level
-        prev_order = LEVEL_ORDER.get(prev_level, 0)
-        new_order = LEVEL_ORDER.get(level, 0)
+        self._current_level = level
+        return self.state
 
-        # Update current level
-        self._state.current_level = level
-
-        # Track peak
-        if new_order > LEVEL_ORDER.get(self._state.peak_level, 0):
-            self._state.peak_level = level
-
-        # ── Escalation detection ──────────────────────────────
-        if new_order > prev_order:
-            # User is going up — reset de-escalation counter
-            self._state.deescalation_count = 0
-            self._state.deescalating = False
-
-        # Always check for escalation pattern in recent window
-        if not self._state.escalated:
-            window = self._get_recent_levels(self.ESCALATION_WINDOW)
-            if len(window) >= self.ESCALATION_WINDOW:
-                first_in_window = window[0][1]
-                last_in_window = window[-1][1]
-                first_order = LEVEL_ORDER.get(first_in_window, 0)
-                last_order = LEVEL_ORDER.get(last_in_window, 0)
-
-                if last_order > first_order:
-                    self._state.escalated = True
-                    self._state.escalation_messages = self.ESCALATION_WINDOW
-
-        # ── De-escalation detection ───────────────────────────
-        elif new_order < prev_order:
-            self._state.deescalation_count += 1
-            self._state.deescalating = True
-
-            # If de-escalation counter meets threshold AND we were escalated
-            if (self._state.escalated and
-                    self._state.deescalation_count >= self.DEESCALATION_THRESHOLD):
-                self._state.escalated = False
-                self._state.deescalating = False
-                self._state.deescalation_confirmed = True
-                self._state.deescalation_count = 0
-
-        # Same level — increment de-escalation counter if already de-escalating
-        elif self._state.deescalating:
-            self._state.deescalation_count += 1
-            if (self._state.escalated and
-                    self._state.deescalation_count >= self.DEESCALATION_THRESHOLD):
-                self._state.escalated = False
-                self._state.deescalating = False
-                self._state.deescalation_confirmed = True
-                self._state.deescalation_count = 0
-
-    def _get_recent_levels(self, n: int) -> List[Tuple[int, str]]:
-        """Get the last n entries from level history."""
-        return self._state.level_history[-n:]
-
-    def get_prompt_context(self) -> str:
+    def _detect_escalation(self) -> bool:
         """
-        Generate a human-readable context string for system prompt injection.
+        Detect rapid escalation: LOW → HIGH within ESCALATION_WINDOW messages.
 
-        Returns empty string if no session-level crisis context is needed.
+        Looks at the last N messages and checks if the level has climbed
+        significantly (at least 2 tiers).
         """
-        s = self._state
+        if len(self._level_history) < 2:
+            return False
 
-        if s.message_count == 0:
+        window = self._level_history[-self.ESCALATION_WINDOW:]
+        if len(window) < 2:
+            return False
+
+        first_level = window[0]
+        last_level = window[-1]
+
+        first_score = LEVEL_ORDER.get(first_level, 0)
+        last_score = LEVEL_ORDER.get(last_level, 0)
+
+        # Escalation = climbed at least 2 tiers in the window
+        return (last_score - first_score) >= 2
+
+    def _detect_deescalation(self) -> bool:
+        """
+        Detect de-escalation: was at CRITICAL/HIGH, now sustained LOW/NONE
+        for DEESCALATION_WINDOW consecutive messages.
+        """
+        if LEVEL_ORDER.get(self._peak_level, 0) < LEVEL_ORDER["HIGH"]:
+            return False
+
+        return self._consecutive_low >= self.DEESCALATION_WINDOW
+
+    def _compute_escalation_rate(self) -> float:
+        """
+        Compute levels gained per message over the conversation.
+
+        Positive = escalating, negative = de-escalating, 0 = stable.
+        """
+        if self._message_count < 2:
+            return 0.0
+
+        first = LEVEL_ORDER.get(self._level_history[0], 0)
+        current = LEVEL_ORDER.get(self._current_level, 0)
+
+        return (current - first) / (self._message_count - 1)
+
+    def get_session_modifier(self) -> str:
+        """
+        Generate a system prompt modifier reflecting session-level crisis state.
+
+        Returns empty string if no session context is relevant.
+        """
+        if self._message_count < 2:
             return ""
 
-        parts = []
+        s = self.state
 
-        # Escalation alert
-        if s.escalated and s.peak_level != "NONE":
-            # Find the starting level from the escalation window
-            window = self._get_recent_levels(self.ESCALATION_WINDOW)
-            if window:
-                start_level = window[0][1]
-                parts.append(
-                    f"User has escalated from {start_level} to {s.peak_level} "
-                    f"over {s.message_count} message{'s' if s.message_count != 1 else ''}."
-                )
-                parts.append("Heightened crisis awareness is warranted.")
-
-        # Confirmed de-escalation
-        elif s.deescalation_confirmed and s.peak_level in ("HIGH", "CRITICAL"):
-            parts.append(
-                f"User has de-escalated from {s.peak_level} to {s.current_level}."
+        if s.is_escalating:
+            return (
+                f"User has escalated from {self._level_history[0]} to "
+                f"{s.current_level} over {s.message_count} messages. "
+                f"Peak crisis level this session: {s.peak_level}. "
+                "Respond with heightened awareness. The trajectory is "
+                "worsening — prioritize safety and connection."
             )
-            parts.append("De-escalation confirmed. Continue gentle presence.")
 
-        # Active de-escalation (not yet confirmed)
-        elif s.deescalating and s.peak_level != "NONE":
-            parts.append(
-                f"User has de-escalated from {s.peak_level} to {s.current_level} "
-                f"over {s.deescalation_count} message{'s' if s.deescalation_count != 1 else ''}."
+        if s.is_deescalating:
+            return (
+                f"User previously reached {s.peak_level} crisis level "
+                f"but has been at {s.current_level} or below for "
+                f"{s.consecutive_low_messages} consecutive messages. "
+                "The situation appears to be stabilizing. Continue "
+                "supportive engagement while remaining vigilant."
             )
-            parts.append("Still in de-escalation. Maintain supportive awareness.")
 
-        # Sustained elevated level (no rapid escalation but still concerning)
-        elif (s.current_level in ("HIGH", "CRITICAL") and
-              not s.escalated and s.message_count >= 3):
-            parts.append(
-                f"User has been at {s.current_level} level for {s.message_count} messages."
+        if s.peak_level in ("CRITICAL", "HIGH") and s.current_level not in ("CRITICAL", "HIGH"):
+            return (
+                f"User previously reached {s.peak_level} crisis level "
+                f"this session (currently {s.current_level}). "
+                "Continue with care and awareness of the earlier crisis."
             )
-            parts.append("Continue crisis-aware response.")
 
-        # Peak was higher than current (user improved but may still be fragile)
-        elif (LEVEL_ORDER.get(s.peak_level, 0) > LEVEL_ORDER.get(s.current_level, 0) and
-              s.peak_level in ("HIGH", "CRITICAL") and
-              not s.deescalating):
-            parts.append(
-                f"Note: session peak was {s.peak_level}. "
-                f"User is now at {s.current_level}."
+        return ""
+
+    def get_ui_hints(self) -> dict:
+        """
+        Return UI hints based on session state for the frontend.
+
+        These are advisory — the frontend decides what to show.
+        """
+        s = self.state
+
+        hints = {
+            "session_escalating": s.is_escalating,
+            "session_deescalating": s.is_deescalating,
+            "session_peak_level": s.peak_level,
+            "session_message_count": s.message_count,
+        }
+
+        if s.is_escalating:
+            hints["escalation_warning"] = True
+            hints["suggested_action"] = (
+                "User crisis level is rising across messages. "
+                "Consider increasing intervention level."
             )
-            parts.append("Remain attentive.")
 
-        return " ".join(parts)
+        return hints
 
-    def get_escalation_flag(self) -> bool:
-        """True if session shows active escalation pattern."""
-        return self._state.escalated
 
-    def get_effective_level(self) -> str:
-        """
-        Get the effective crisis level considering session state.
+def check_crisis_with_session(
+    text: str,
+    tracker: CrisisSessionTracker,
+) -> dict:
+    """
+    Convenience: detect crisis and update session state in one call.
 
-        Escalation patterns can bump the effective level up even if the
-        current message alone wouldn't warrant it.
-        """
-        s = self._state
+    Returns combined single-message detection + session-level context.
+    """
+    from .detect import detect_crisis
+    from .gateway import check_crisis
 
-        if s.escalated and s.peak_level in ("HIGH", "CRITICAL"):
-            return s.peak_level
+    single_result = check_crisis(text)
+    detection = detect_crisis(text)
+    session_state = tracker.record(detection)
 
-        return s.current_level
-
-    def should_heighten_awareness(self) -> bool:
-        """
-        True when the session trajectory warrants heightened awareness
-        beyond what a single-message detection would provide.
-        """
-        return self._state.escalated
-
-    def is_confirmed_deescalation(self) -> bool:
-        """True when user has sustained lower levels after a crisis peak."""
-        s = self._state
-        return s.deescalation_confirmed
-
-    def __repr__(self) -> str:
-        s = self._state
-        return (
-            f"CrisisSessionTracker("
-            f"current={s.current_level}, peak={s.peak_level}, "
-            f"msgs={s.message_count}, escalated={s.escalated}, "
-            f"deescalating={s.deescalating})"
-        )
+    return {
+        **single_result,
+        "session": {
+            "current_level": session_state.current_level,
+            "peak_level": session_state.peak_level,
+            "message_count": session_state.message_count,
+            "is_escalating": session_state.is_escalating,
+            "is_deescalating": session_state.is_deescalating,
+            "modifier": tracker.get_session_modifier(),
+            "ui_hints": tracker.get_ui_hints(),
+        },
+    }

crisis/tests_session_tracker.py

@@ -1,407 +0,0 @@
-"""
-Tests for session-level crisis tracking (Issue #35).
-
-Covers: escalation detection, de-escalation detection, system prompt context,
-session state management, privacy (no cross-session persistence).
-
-Run with: python -m pytest crisis/tests_session_tracker.py -v
-"""
-
-import unittest
-import sys
-import os
-
-sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
-
-from crisis.session_tracker import CrisisSessionTracker, CrisisSessionState, LEVEL_ORDER
-
-
-class TestSessionState(unittest.TestCase):
-    """Test basic session state management."""
-
-    def test_initial_state(self):
-        tracker = CrisisSessionTracker()
-        s = tracker.state
-        self.assertEqual(s.current_level, "NONE")
-        self.assertEqual(s.peak_level, "NONE")
-        self.assertEqual(s.message_count, 0)
-        self.assertEqual(s.level_history, [])
-        self.assertFalse(s.escalated)
-
-    def test_record_increments_count(self):
-        tracker = CrisisSessionTracker()
-        tracker.record("hello")
-        self.assertEqual(tracker.state.message_count, 1)
-        tracker.record("world")
-        self.assertEqual(tracker.state.message_count, 2)
-
-    def test_record_tracks_history(self):
-        tracker = CrisisSessionTracker()
-        tracker.record("I'm struggling")  # LOW
-        tracker.record("I feel hopeless and nobody cares")  # MEDIUM
-        history = tracker.state.level_history
-        self.assertEqual(len(history), 2)
-        self.assertEqual(history[0], (1, "LOW"))
-        self.assertIn(history[1][1], ("MEDIUM", "LOW", "HIGH"))
-
-    def test_reset_clears_state(self):
-        tracker = CrisisSessionTracker()
-        tracker.record("I want to die")  # CRITICAL
-        self.assertEqual(tracker.state.peak_level, "CRITICAL")
-        tracker.reset()
-        s = tracker.state
-        self.assertEqual(s.current_level, "NONE")
-        self.assertEqual(s.peak_level, "NONE")
-        self.assertEqual(s.message_count, 0)
-        self.assertEqual(s.level_history, [])
-
-    def test_peak_tracking(self):
-        tracker = CrisisSessionTracker()
-        tracker.record("I'm feeling down")  # LOW
-        tracker.record("I feel hopeless with no way out")  # HIGH
-        tracker.record("Actually I'm a bit better")  # back to LOW
-        self.assertEqual(tracker.state.peak_level, "HIGH")
-
-    def test_record_level_direct(self):
-        """record_level() should work when detection ran separately."""
-        tracker = CrisisSessionTracker()
-        tracker.record_level("LOW")
-        tracker.record_level("MEDIUM")
-        tracker.record_level("HIGH")
-        self.assertEqual(tracker.state.message_count, 3)
-        self.assertEqual(tracker.state.peak_level, "HIGH")
-
-
-class TestEscalationDetection(unittest.TestCase):
-    """Test rapid escalation detection: LOW → HIGH in N messages."""
-
-    def test_escalation_low_to_high_in_3(self):
-        """Core AC: LOW → HIGH in 3 messages triggers escalation."""
-        tracker = CrisisSessionTracker()
-        tracker.ESCALATION_WINDOW = 3
-        tracker.record("I'm having a tough time")  # LOW
-        tracker.record("I feel really hopeless about everything")  # HIGH
-        tracker.record("I can't take this anymore")  # HIGH
-        self.assertTrue(tracker.get_escalation_flag())
-
-    def test_escalation_low_to_critical_in_3(self):
-        tracker = CrisisSessionTracker()
-        tracker.ESCALATION_WINDOW = 3
-        tracker.record("I'm struggling")  # LOW
-        tracker.record("Nobody would miss me")  # HIGH
-        tracker.record("I want to end my life")  # CRITICAL
-        self.assertTrue(tracker.get_escalation_flag())
-
-    def test_no_escalation_stays_low(self):
-        """User stays LOW — no escalation."""
-        tracker = CrisisSessionTracker()
-        tracker.record("rough day")
-        tracker.record("tough week")
-        tracker.record("feeling down")
-        self.assertFalse(tracker.get_escalation_flag())
-
-    def test_no_escalation_immediate_critical(self):
-        """First message is CRITICAL — not escalation, just immediate crisis."""
-        tracker = CrisisSessionTracker()
-        tracker.ESCALATION_WINDOW = 3
-        tracker.record("I want to kill myself")  # CRITICAL on first message
-        # Not escalated because there's no upward trajectory — it started high
-        self.assertFalse(tracker.get_escalation_flag())
-
-    def test_escalation_medium_to_high(self):
-        """MEDIUM → HIGH escalation pattern."""
-        tracker = CrisisSessionTracker()
-        tracker.ESCALATION_WINDOW = 3
-        tracker.record("I feel alone and nobody cares")  # MEDIUM
-        tracker.record("I feel completely hopeless")  # HIGH
-        tracker.record("There's no way out")  # HIGH
-        self.assertTrue(tracker.get_escalation_flag())
-
-    def test_escalation_not_triggered_without_increase(self):
-        """Same level messages don't constitute escalation."""
-        tracker = CrisisSessionTracker()
-        tracker.ESCALATION_WINDOW = 3
-        tracker.record("I feel hopeless")  # HIGH
-        tracker.record("I'm in so much pain")  # HIGH
-        tracker.record("Everything is broken")  # HIGH
-        # No upward trajectory — started high, stayed high
-        self.assertFalse(tracker.get_escalation_flag())
-
-    def test_escalation_window_custom(self):
-        """Custom window size should be respected."""
-        tracker = CrisisSessionTracker()
-        tracker.ESCALATION_WINDOW = 2
-        tracker.record("I'm unhappy")  # LOW
-        tracker.record("I can't go on anymore")  # HIGH
-        self.assertTrue(tracker.get_escalation_flag())
-
-
-class TestDeescalationDetection(unittest.TestCase):
-    """Test de-escalation: CRITICAL → LOW for 5+ messages."""
-
-    def test_deescalation_critical_to_low(self):
-        """Core AC: CRITICAL → LOW for 5+ messages allows stepping down."""
-        tracker = CrisisSessionTracker()
-        tracker.ESCALATION_WINDOW = 3
-        tracker.DEESCALATION_THRESHOLD = 5
-
-        # Escalate to CRITICAL
-        tracker.record("I'm struggling")  # LOW
-        tracker.record("I can't go on")  # HIGH
-        tracker.record("I want to die")  # CRITICAL
-        self.assertTrue(tracker.get_escalation_flag())
-
-        # De-escalate over 5 messages
-        tracker.record("I called 988")  # NONE/LOW
-        tracker.record("I'm calmer now")  # NONE
-        tracker.record("Thank you for being here")  # NONE
-        tracker.record("I'm going to be okay")  # NONE
-        tracker.record("Taking it one moment at a time")  # NONE
-
-        self.assertTrue(tracker.is_confirmed_deescalation())
-        self.assertFalse(tracker.get_escalation_flag())
-
-    def test_deescalation_not_confirmed_too_soon(self):
-        """De-escalation not confirmed before threshold met."""
-        tracker = CrisisSessionTracker()
-        tracker.ESCALATION_WINDOW = 3
-        tracker.DEESCALATION_THRESHOLD = 5
-
-        tracker.record("I'm struggling")
-        tracker.record("I can't go on")
-        tracker.record("I want to die")
-        self.assertTrue(tracker.get_escalation_flag())
-
-        # Only 3 messages of de-escalation
-        tracker.record("I called someone")
-        tracker.record("I'm calmer")
-        tracker.record("Feeling better")
-
-        self.assertFalse(tracker.is_confirmed_deescalation())
-        self.assertTrue(tracker.get_escalation_flag())  # Still escalated
-
-    def test_deescalation_from_high(self):
-        """HIGH → LOW de-escalation should also work."""
-        tracker = CrisisSessionTracker()
-        tracker.DEESCALATION_THRESHOLD = 5
-
-        # Build up to HIGH
-        tracker.record("I'm down")  # LOW
-        tracker.record("I feel hopeless")  # HIGH
-        tracker.record("No way out")  # HIGH
-        tracker.record("Everything is pointless")  # HIGH
-
-        # De-escalate
-        for _ in range(5):
-            tracker.record("I'm doing a bit better")  # LOW/NONE
-
-        self.assertTrue(tracker.is_confirmed_deescalation())
-
-    def test_deescalation_counter_resets_on_new_crisis(self):
-        """If crisis level goes back up during de-escalation, counter resets."""
-        tracker = CrisisSessionTracker()
-        tracker.ESCALATION_WINDOW = 3
-        tracker.DEESCALATION_THRESHOLD = 5
-
-        # Escalate
-        tracker.record("I'm struggling")  # LOW
-        tracker.record("I feel hopeless")  # HIGH
-        tracker.record("I want to die")  # CRITICAL
-
-        # Start de-escalating
-        tracker.record("I called someone")  # LOW
-        tracker.record("I'm calmer")  # NONE
-
-        # Go back up
-        tracker.record("Actually I can't do this")  # HIGH
-
-        self.assertFalse(tracker.is_confirmed_deescalation())
-
-
-class TestSystemPromptContext(unittest.TestCase):
-    """Test system prompt context generation."""
-
-    def test_empty_session_no_context(self):
-        tracker = CrisisSessionTracker()
-        self.assertEqual(tracker.get_prompt_context(), "")
-
-    def test_escalation_context(self):
-        tracker = CrisisSessionTracker()
-        tracker.ESCALATION_WINDOW = 3
-        tracker.record("I'm having a tough time")
-        tracker.record("Things are really hard")
-        tracker.record("I can't go on anymore")
-
-        ctx = tracker.get_prompt_context()
-        self.assertIn("escalated", ctx.lower())
-        self.assertIn("LOW", ctx)
-        self.assertIn("heightened", ctx.lower())
-
-    def test_deescalation_context(self):
-        tracker = CrisisSessionTracker()
-        tracker.ESCALATION_WINDOW = 3
-        tracker.DEESCALATION_THRESHOLD = 5
-
-        # Escalate
-        tracker.record("I'm struggling")
-        tracker.record("I feel hopeless")
-        tracker.record("I want to die")
-
-        # De-escalate
-        for _ in range(5):
-            tracker.record("I'm okay now")
-
-        ctx = tracker.get_prompt_context()
-        self.assertIn("de-escalated", ctx.lower())
-        self.assertIn("confirmed", ctx.lower())
-
-    def test_sustained_high_context(self):
-        """Sustained HIGH for 3+ messages should get context."""
-        tracker = CrisisSessionTracker()
-        tracker.record("I'm in so much pain")  # HIGH
-        tracker.record("Everything is pointless")  # HIGH
-        tracker.record("I can't go on")  # HIGH
-
-        ctx = tracker.get_prompt_context()
-        self.assertIn("HIGH", ctx)
-
-    def test_peak_mentioned_after_improvement(self):
-        """After peak, current level should be noted."""
-        tracker = CrisisSessionTracker()
-        tracker.record("I'm in so much pain")  # HIGH
-        tracker.record("Everything is pointless")  # HIGH
-        tracker.record("I feel a bit better")  # back to LOW
-
-        ctx = tracker.get_prompt_context()
-        self.assertIn("peak", ctx.lower())
-        self.assertIn("HIGH", ctx)
-
-
-class TestEffectiveLevel(unittest.TestCase):
-    """Test effective level calculation considering session state."""
-
-    def test_effective_level_normal(self):
-        tracker = CrisisSessionTracker()
-        tracker.record("I'm struggling")  # LOW
-        self.assertEqual(tracker.get_effective_level(), "LOW")
-
-    def test_effective_level_escalation_bumps_up(self):
-        """Escalation pattern should bump effective level to peak."""
-        tracker = CrisisSessionTracker()
-        tracker.ESCALATION_WINDOW = 3
-        tracker.record("I'm having a tough time")  # LOW
-        tracker.record("I feel completely hopeless")  # HIGH
-        tracker.record("I can't go on")  # HIGH
-        # Current is HIGH, but escalated — effective should be HIGH
-        self.assertEqual(tracker.get_effective_level(), "HIGH")
-
-
-class TestPrivacy(unittest.TestCase):
-    """Test privacy requirements — no cross-session persistence."""
-
-    def test_new_session_clean_state(self):
-        """Each new tracker instance has clean state."""
-        t1 = CrisisSessionTracker()
-        t1.record("I want to die")
-        self.assertEqual(t1.state.peak_level, "CRITICAL")
-
-        t2 = CrisisSessionTracker()
-        self.assertEqual(t2.state.peak_level, "NONE")
-        self.assertEqual(t2.state.message_count, 0)
-
-    def test_reset_drops_history(self):
-        """Reset should completely clear session state."""
-        t = CrisisSessionTracker()
-        t.record("I'm struggling")
-        t.record("I can't go on")
-        t.reset()
-        self.assertEqual(t.state.level_history, [])
-        self.assertEqual(t.state.message_count, 0)
-        self.assertFalse(t.state.escalated)
-
-
-class TestEdgeCases(unittest.TestCase):
-    """Edge cases and boundary conditions."""
-
-    def test_single_message_none(self):
-        tracker = CrisisSessionTracker()
-        tracker.record("Hello Timmy")
-        self.assertFalse(tracker.get_escalation_flag())
-        self.assertEqual(tracker.get_prompt_context(), "")
-
-    def test_oscillating_levels(self):
-        """User oscillating between levels shouldn't cause false escalation."""
-        tracker = CrisisSessionTracker()
-        tracker.ESCALATION_WINDOW = 3
-        tracker.record("I'm fine")
-        tracker.record("I'm struggling")
-        tracker.record("I'm fine")
-        tracker.record("I'm struggling")
-        # Oscillation without sustained escalation
-        self.assertFalse(tracker.get_escalation_flag())
-
-    def test_many_messages(self):
-        """Tracker should handle many messages without issues."""
-        tracker = CrisisSessionTracker()
-        for i in range(100):
-            tracker.record("Hello there")
-        self.assertEqual(tracker.state.message_count, 100)
-
-    def test_empty_string(self):
-        tracker = CrisisSessionTracker()
-        tracker.record("")
-        self.assertEqual(tracker.state.message_count, 1)
-        self.assertEqual(tracker.state.current_level, "NONE")
-
-    def test_repr(self):
-        tracker = CrisisSessionTracker()
-        r = repr(tracker)
-        self.assertIn("CrisisSessionTracker", r)
-        self.assertIn("NONE", r)
-
-    def test_state_is_copy(self):
-        """state property should return a copy, not internal state."""
-        tracker = CrisisSessionTracker()
-        s1 = tracker.state
-        tracker.record("I'm struggling")
-        s2 = tracker.state
-        self.assertEqual(s1.message_count, 0)
-        self.assertEqual(s2.message_count, 1)
-
-
-class TestLevelOrder(unittest.TestCase):
-    """Test level ordering is correct."""
-
-    def test_level_ordering(self):
-        self.assertLess(LEVEL_ORDER["NONE"], LEVEL_ORDER["LOW"])
-        self.assertLess(LEVEL_ORDER["LOW"], LEVEL_ORDER["MEDIUM"])
-        self.assertLess(LEVEL_ORDER["MEDIUM"], LEVEL_ORDER["HIGH"])
-        self.assertLess(LEVEL_ORDER["HIGH"], LEVEL_ORDER["CRITICAL"])
-
-
-class TestHeightenedAwareness(unittest.TestCase):
-    """Test heightened awareness flag."""
-
-    def test_heightened_on_escalation(self):
-        tracker = CrisisSessionTracker()
-        tracker.ESCALATION_WINDOW = 3
-        tracker.record("I'm unhappy")
-        tracker.record("I feel hopeless")
-        tracker.record("I can't go on")
-        self.assertTrue(tracker.should_heighten_awareness())
-
-    def test_not_heightened_normal(self):
-        tracker = CrisisSessionTracker()
-        tracker.record("Hello")
-        self.assertFalse(tracker.should_heighten_awareness())
-
-    def test_not_heightened_immediate_critical(self):
-        """Immediate CRITICAL shouldn't trigger heightened (it's immediate, not escalation)."""
-        tracker = CrisisSessionTracker()
-        tracker.ESCALATION_WINDOW = 3
-        tracker.record("I want to kill myself")
-        self.assertFalse(tracker.should_heighten_awareness())
-
-
-if __name__ == "__main__":
-    unittest.main()

dying_detection/__init__.py

@@ -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:

index.html

@@ -241,6 +241,105 @@ html, body {
   opacity: 0.5;
 }
 
+/* ===== OPERATOR AUGMENTATION SIDEBAR ===== */
+#augmentation-toggle {
+  margin: 10px 16px 0;
+  padding: 8px 12px;
+  border-radius: 999px;
+  border: 1px solid #5b6b7a;
+  background: #11161d;
+  color: #b9c7d5;
+  font-size: 0.9rem;
+  cursor: pointer;
+}
+
+#augmentation-toggle.active {
+  border-color: #b388ff;
+  color: #e2d4ff;
+  background: #1a1324;
+}
+
+#augmentation-sidebar {
+  position: fixed;
+  top: 90px;
+  right: 16px;
+  width: 320px;
+  max-height: calc(100vh - 120px);
+  overflow-y: auto;
+  background: #11161d;
+  border: 1px solid #30363d;
+  border-left: 3px solid #b388ff;
+  border-radius: 8px;
+  padding: 14px;
+  box-shadow: 0 12px 32px rgba(0,0,0,0.35);
+  display: none;
+  z-index: 70;
+}
+
+#augmentation-sidebar.visible {
+  display: block;
+}
+
+#augmentation-sidebar .augmentation-heading {
+  color: #d2b8ff;
+  font-size: 0.78rem;
+  letter-spacing: 0.08em;
+  margin-bottom: 10px;
+}
+
+#augmentation-risk-score {
+  color: #fff;
+  font-size: 1rem;
+  font-weight: 700;
+  margin-bottom: 10px;
+}
+
+#augmentation-sidebar .augmentation-section {
+  margin-top: 10px;
+}
+
+#augmentation-sidebar .augmentation-section h3 {
+  color: #c9d1d9;
+  font-size: 0.78rem;
+  margin: 0 0 6px;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+}
+
+#augmentation-sidebar ul {
+  margin: 0;
+  padding-left: 18px;
+  color: #b9c7d5;
+  font-size: 0.9rem;
+  line-height: 1.45;
+}
+
+#augmentation-follow-up,
+#augmentation-notice {
+  color: #b9c7d5;
+  font-size: 0.9rem;
+  line-height: 1.45;
+  margin: 0;
+}
+
+#augmentation-notice {
+  color: #8b949e;
+  margin-top: 12px;
+  border-top: 1px solid #21262d;
+  padding-top: 10px;
+}
+
+@media (max-width: 980px) {
+  #augmentation-sidebar {
+    left: 16px;
+    right: 16px;
+    width: auto;
+    top: auto;
+    bottom: 82px;
+    max-height: 40vh;
+  }
+}
+
 /* ===== CHAT AREA ===== */
 #chat-area {
   flex: 1;
@@ -649,6 +748,29 @@ html, body {
     </div>
   </div>
 
+  <button id="augmentation-toggle" type="button" aria-pressed="false" aria-controls="augmentation-sidebar">Operator assist: off</button>
+  <aside id="augmentation-sidebar" aria-live="polite" aria-label="Local operator augmentation sidebar">
+    <div class="augmentation-heading">LOCAL OPERATOR AUGMENTATION</div>
+    <div id="augmentation-risk-score">Risk score: —</div>
+    <div class="augmentation-section">
+      <h3>Signals</h3>
+      <ul id="augmentation-signals"><li>No signals yet.</li></ul>
+    </div>
+    <div class="augmentation-section">
+      <h3>Talking points</h3>
+      <ul id="augmentation-talking-points"><li>Enable operator assist to surface local advisory guidance.</li></ul>
+    </div>
+    <div class="augmentation-section">
+      <h3>De-escalation</h3>
+      <ul id="augmentation-techniques"><li>Suggestions stay local and never replace human judgment.</li></ul>
+    </div>
+    <div class="augmentation-section">
+      <h3>Follow-up</h3>
+      <p id="augmentation-follow-up">No follow-up prompt yet.</p>
+    </div>
+    <p id="augmentation-notice">Local-only advisory. Never replaces human judgment.</p>
+  </aside>
+
   <!-- Chat messages -->
   <div id="chat-area" role="log" aria-label="Chat messages" aria-live="polite" tabindex="0">
     <!-- Messages inserted here -->
@@ -680,7 +802,7 @@ html, body {
 
   <!-- Footer -->
   <footer id="footer">
-    <a href="/about" aria-label="About The Door">about</a>
+    <a href="/about.html" aria-label="About The Door">about</a>
     <button id="safety-plan-btn" aria-label="Open My Safety Plan">my safety plan</button>
     <button id="clear-chat-btn" aria-label="Clear chat history">clear chat</button>
   </footer>
@@ -806,8 +928,17 @@ Sovereignty and service always.`;
   var sendBtn = document.getElementById('send-btn');
   var typingIndicator = document.getElementById('typing-indicator');
   var crisisPanel = document.getElementById('crisis-panel');
+  var augmentationToggle = document.getElementById('augmentation-toggle');
+  var augmentationSidebar = document.getElementById('augmentation-sidebar');
+  var augmentationRiskScore = document.getElementById('augmentation-risk-score');
+  var augmentationSignals = document.getElementById('augmentation-signals');
+  var augmentationTalkingPoints = document.getElementById('augmentation-talking-points');
+  var augmentationTechniques = document.getElementById('augmentation-techniques');
+  var augmentationFollowUp = document.getElementById('augmentation-follow-up');
+  var augmentationNotice = document.getElementById('augmentation-notice');
   var crisisOverlay = document.getElementById('crisis-overlay');
   var overlayDismissBtn = document.getElementById('overlay-dismiss-btn');
+  var overlayCallLink = document.querySelector('.overlay-call');
   var statusDot = document.querySelector('.status-dot');
   var statusText = document.getElementById('status-text');
   
@@ -825,6 +956,8 @@ Sovereignty and service always.`;
   var isStreaming = false;
   var overlayTimer = null;
   var crisisPanelShown = false;
+  var lastUserMessage = '';
+  var augmentationEnabled = false;
 
   // ===== SERVICE WORKER =====
   if ('serviceWorker' in navigator) {
@@ -965,76 +1098,7 @@ Sovereignty and service always.`;
   }
 
   // ===== GET SYSTEM PROMPT (wraps with crisis context) =====
-    // ===== SESSION CRISIS TRACKING (#35) =====
-  var sessionCrisis = {
-    currentLevel: 0,      // 0=NONE, 1=LOW, 2=MEDIUM, 3=HIGH, 4=CRITICAL
-    peakLevel: 0,
-    messageCount: 0,
-    history: [],          // [{level, timestamp}]
-    escalationRate: 0,    // levels per message
-    lastEscalation: null  // timestamp of last escalation
-  };
-
-  function trackCrisis(text) {
-    var level = getCrisisLevel(text);
-    sessionCrisis.messageCount++;
-    sessionCrisis.history.push({ level: level, time: Date.now() });
-    
-    if (level > sessionCrisis.currentLevel) {
-      sessionCrisis.lastEscalation = Date.now();
-    }
-    
-    sessionCrisis.currentLevel = Math.max(sessionCrisis.currentLevel, level);
-    sessionCrisis.peakLevel = Math.max(sessionCrisis.peakLevel, level);
-    
-    // Calculate escalation rate over last 5 messages
-    var recent = sessionCrisis.history.slice(-5);
-    if (recent.length >= 2) {
-      var first = recent[0].level;
-      var last = recent[recent.length - 1].level;
-      sessionCrisis.escalationRate = (last - first) / recent.length;
-    }
-    
-    return getSessionContext();
-  }
-
-  function getSessionContext() {
-    var ctx = '';
-    
-    if (sessionCrisis.history.length < 2) return ctx;
-    
-    // Escalation detection: LOW -> HIGH in <= 3 messages
-    if (sessionCrisis.escalationRate > 0.5 && sessionCrisis.history.length <= 3) {
-      ctx += 'ESCALATION ALERT: User crisis level is rising rapidly. ';
-    }
-    
-    // De-escalation detection: CRITICAL -> LOW for 5+ messages
-    if (sessionCrisis.peakLevel >= 3 && sessionCrisis.currentLevel <= 1 && sessionCrisis.messageCount >= 5) {
-      ctx += 'DE-ESCALATION: User appears to be calming. Maintain presence but reduce urgency. ';
-    }
-    
-    // Persistent high state
-    if (sessionCrisis.currentLevel >= 2 && sessionCrisis.messageCount >= 3) {
-      ctx += 'User has been in crisis for ' + sessionCrisis.messageCount + ' messages. ';
-    }
-    
-    // Level history summary
-    var levels = sessionCrisis.history.map(function(h) { return h.level; });
-    if (levels.length >= 2) {
-      ctx += 'Crisis trajectory: ' + levels.join(' → ') + '. ';
-    }
-    
-    return ctx;
-  }
-
-  function resetSessionCrisis() {
-    sessionCrisis = {
-      currentLevel: 0, peakLevel: 0, messageCount: 0,
-      history: [], escalationRate: 0, lastEscalation: null
-    };
-  }
-
-function getSystemPrompt(userText) {
+  function getSystemPrompt(userText) {
     var level = getCrisisLevel(userText);
     if (level === 0) return SYSTEM_PROMPT;
 
@@ -1047,19 +1111,201 @@ function getSystemPrompt(userText) {
     var directive = 'DIRECTIVE: ' + profile.directive + '\n';
     var tone = 'TONE: ' + profile.tone + '\n';
 
-    var sessionCtx = getSessionContext();
-    var sessionBlock = sessionCtx ? '\nSESSION CONTEXT: ' + sessionCtx : '';
-    return SYSTEM_PROMPT + divider + header + directive + tone + sessionBlock;
+    return SYSTEM_PROMPT + divider + header + directive + tone;
   }
 
 
+  function escapeHtml(text) {
+    return String(text || '')
+      .replace(/&/g, '&amp;')
+      .replace(/</g, '&lt;')
+      .replace(/>/g, '&gt;')
+      .replace(/"/g, '&quot;')
+      .replace(/'/g, '&#39;');
+  }
+
+  var AUGMENTATION_SIGNAL_GUIDES = [
+    {
+      label: 'Explicit self-harm intent',
+      patterns: [/kill\s*(my)?self/i, /end\s*my\s*life/i, /suicide\s*(note|letter)/i, /going\s+to\s+(kill\s+myself|die)/i],
+      talkingPoint: 'Ask directly whether they are safe right now and keep the next question concrete.',
+      technique: 'Move to immediate safety: ask about means, people nearby, and whether 988 can be called or texted now.',
+      followUp: 'You said you might die tonight. Are you alone right now, and what is within reach?'
+    },
+    {
+      label: 'Hopelessness / collapse',
+      patterns: [/hopeless/i, /can'?t\s+go\s+on/i, /no\s+future/i, /nothing\s+left/i],
+      talkingPoint: 'Reflect the hopelessness plainly before offering options. Avoid arguing with the feeling.',
+      technique: 'Narrow the time horizon to the next ten minutes and one immediate action.',
+      followUp: 'You said things feel hopeless. What feels most dangerous about the next hour?'
+    },
+    {
+      label: 'Isolation / burden',
+      patterns: [/nobody\s+cares/i, /better\s+off\s+without\s+me/i, /\balone\b/i, /\bburden\b/i],
+      talkingPoint: 'Counter isolation with one real contact point: a person, 988, or Crisis Text Line.',
+      technique: 'Invite a tiny reconnection step: text one safe person, unlock the door, or stay in the chat.',
+      followUp: 'You said you feel alone. Who is the safest real person we could bring into this moment with you?'
+    },
+    {
+      label: 'Overwhelm / panic',
+      patterns: [/desperate/i, /overwhelm(?:ed|ing)/i, /trapped/i, /panic/i],
+      talkingPoint: 'Offer one regulating step at a time instead of a long list.',
+      technique: 'Ground in the room: feet on the floor, name five visible objects, one sip of water, one slow exhale.',
+      followUp: 'You said this feels overwhelming. What is the smallest thing in the room you can touch right now?'
+    }
+  ];
+
+  function deriveAugmentationSignals(userText) {
+    var text = (userText || '').toLowerCase();
+    return AUGMENTATION_SIGNAL_GUIDES.filter(function(guide) {
+      return guide.patterns.some(function(pattern) { return pattern.test(text); });
+    });
+  }
+
+  function buildAugmentationState(userText, assistantText) {
+    var text = userText || '';
+    var guides = deriveAugmentationSignals(text);
+    var level = getCrisisLevel(userText);
+    var signals = guides.map(function(guide) { return guide.label; });
+    var explicitIntent = signals.indexOf('Explicit self-harm intent') !== -1;
+    var riskLevel = explicitIntent ? 'CRITICAL' : (level === 2 ? 'CRITICAL' : level === 1 ? 'HIGH' : (guides.length ? 'LOW' : 'NONE'));
+    var riskScore = riskLevel === 'CRITICAL' ? 95 : riskLevel === 'HIGH' ? 75 : riskLevel === 'LOW' ? 25 : 5;
+    riskScore = Math.min(100, riskScore + Math.min(guides.length * 5, 10));
+
+    if (riskLevel === 'CRITICAL' && signals.indexOf('Explicit self-harm intent') === -1) {
+      signals.unshift('Explicit self-harm intent');
+      riskScore = Math.max(riskScore, 95);
+    }
+
+    var talkingPoints = guides.map(function(guide) { return guide.talkingPoint; });
+    var techniques = guides.map(function(guide) { return guide.technique; });
+    if (!talkingPoints.length) {
+      talkingPoints = ['Keep the response advisory, local-only, and focused on immediate safety rather than abstract reassurance.'];
+    }
+    if (!techniques.length) {
+      techniques = ['Slow the pace. Use short sentences. Invite one concrete grounding step.'];
+    }
+    if ((assistantText || '').indexOf('988') === -1 && (riskLevel === 'HIGH' || riskLevel === 'CRITICAL')) {
+      talkingPoints.push('Surface 988 or Crisis Text Line explicitly if the assistant has not already done so.');
+    }
+
+    var quoted = (text || '').replace(/\s+/g, ' ').slice(0, 120);
+    var followUp = guides.length ? guides[0].followUp : 'What feels heaviest or most dangerous for you right now?';
+
+    return {
+      riskLevel: riskLevel,
+      riskScore: riskScore,
+      signals: signals,
+      talkingPoints: talkingPoints,
+      techniques: techniques,
+      followUpPrompt: 'You said "' + quoted + '". Consider following up with: ' + followUp,
+      operatorNotice: 'Local-only advisory. Never replaces human judgment.',
+      localOnly: true,
+      advisoryOnly: true
+    };
+  }
+
+  function renderAugmentationSidebar(state) {
+    if (!augmentationSidebar) return;
+    augmentationRiskScore.textContent = 'Risk score: ' + state.riskScore + ' / 100 (' + state.riskLevel + ')';
+    augmentationSignals.innerHTML = state.signals.length
+      ? state.signals.map(function(signal) { return '<li>' + escapeHtml(signal) + '</li>'; }).join('')
+      : '<li>No crisis signals detected.</li>';
+    augmentationTalkingPoints.innerHTML = state.talkingPoints.map(function(item) { return '<li>' + escapeHtml(item) + '</li>'; }).join('');
+    augmentationTechniques.innerHTML = state.techniques.map(function(item) { return '<li>' + escapeHtml(item) + '</li>'; }).join('');
+    augmentationFollowUp.textContent = state.followUpPrompt;
+    augmentationNotice.textContent = state.operatorNotice;
+    augmentationSidebar.classList.add('visible');
+  }
+
+  function updateAugmentationState(userText, assistantText) {
+    if (!augmentationEnabled) return;
+    renderAugmentationSidebar(buildAugmentationState(userText, assistantText));
+  }
+
+  function setOperatorAugmentationEnabled(enabled) {
+    augmentationEnabled = !!enabled;
+    try { localStorage.setItem('door_operator_augmentation_enabled', augmentationEnabled ? '1' : '0'); } catch (e) {}
+    if (!augmentationToggle) return;
+    augmentationToggle.setAttribute('aria-pressed', augmentationEnabled ? 'true' : 'false');
+    augmentationToggle.classList.toggle('active', augmentationEnabled);
+    augmentationToggle.textContent = augmentationEnabled ? 'Operator assist: on' : 'Operator assist: off';
+    if (!augmentationEnabled && augmentationSidebar) {
+      augmentationSidebar.classList.remove('visible');
+      return;
+    }
+    if (augmentationEnabled && lastUserMessage) {
+      var lastAssistant = '';
+      for (var i = messages.length - 1; i >= 0; i--) {
+        if (messages[i].role === 'assistant') { lastAssistant = messages[i].content; break; }
+      }
+      updateAugmentationState(lastUserMessage, lastAssistant);
+    }
+  }
+
+  function loadOperatorAugmentationPreference() {
+    try {
+      return localStorage.getItem('door_operator_augmentation_enabled') === '1';
+    } catch (e) {
+      return false;
+    }
+  }
+
   // ===== 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--;
@@ -1073,9 +1319,13 @@ function getSystemPrompt(userText) {
       }
     }, 1000);
 
-    overlayDismissBtn.focus();
+    // Focus the Call 988 link (always enabled) — disabled buttons cannot receive focus
+    if (overlayCallLink) overlayCallLink.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');
@@ -1083,7 +1333,22 @@ function getSystemPrompt(userText) {
         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;
     }
   });
 
@@ -1188,25 +1453,14 @@ function getSystemPrompt(userText) {
     } 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() {
@@ -1220,12 +1474,101 @@ function getSystemPrompt(userText) {
     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';
@@ -1240,10 +1583,10 @@ function getSystemPrompt(userText) {
 
     addMessage('user', text);
     messages.push({ role: 'user', content: text });
-    var lastUserMessage = text;
+    lastUserMessage = text;
 
     checkCrisis(text);
-    trackCrisis(text);
+    updateAugmentationState(text, '');
 
     msgInput.value = '';
     msgInput.style.height = 'auto';
@@ -1332,6 +1675,7 @@ function getSystemPrompt(userText) {
           messages.push({ role: 'assistant', content: fullText });
           saveMessages();
           checkCrisis(fullText);
+          updateAugmentationState(lastUserMessage || '', fullText);
         }
         isStreaming = false;
         sendBtn.disabled = msgInput.value.trim().length === 0;
@@ -1358,6 +1702,11 @@ function getSystemPrompt(userText) {
   });
 
   sendBtn.addEventListener('click', sendMessage);
+  if (augmentationToggle) {
+    augmentationToggle.addEventListener('click', function() {
+      setOperatorAugmentationEnabled(!augmentationEnabled);
+    });
+  }
 
   // ===== WELCOME MESSAGE =====
   function init() {
@@ -1372,10 +1721,12 @@ function getSystemPrompt(userText) {
     if (urlParams.get('safetyplan') === 'true') {
       loadSafetyPlan();
       safetyPlanModal.classList.add('active');
+      _activateSafetyPlanFocusTrap(safetyPlanBtn);
       // Clean up URL
       window.history.replaceState({}, document.title, window.location.pathname);
     }
     
+    setOperatorAugmentationEnabled(loadOperatorAugmentationPreference());
     msgInput.focus();
   }
 

pytest.ini

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

sw.js

@@ -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));
 });

tests/focus-trap-test.html

@@ -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>

tests/test_crisis_overlay_focus_trap.py

@@ -0,0 +1,85 @@
+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.',
+        )
+
+    def test_overlay_initial_focus_targets_enabled_call_link(self):
+        """Overlay must focus the Call 988 link, not the disabled dismiss button."""
+        # Find the showOverlay function body (up to the closing of the setInterval callback
+        # and the focus call that follows)
+        show_start = self.html.find('function showOverlay()')
+        self.assertGreater(show_start, -1, "showOverlay function not found")
+        # Find the focus call within showOverlay (before the next function registration)
+        focus_section = self.html[show_start:show_start + 2000]
+        self.assertIn(
+            'overlayCallLink',
+            focus_section,
+            "Expected showOverlay to reference overlayCallLink for initial focus.",
+        )
+        # Ensure the old buggy pattern is gone
+        focus_line_region = self.html[show_start + 800:show_start + 1200]
+        self.assertNotIn(
+            'overlayDismissBtn.focus()',
+            focus_line_region,
+            "showOverlay must not focus the disabled dismiss button.",
+        )
+
+    def test_overlay_call_link_variable_is_declared(self):
+        self.assertIn(
+            "querySelector('.overlay-call')",
+            self.html,
+            "Expected a JS reference to the .overlay-call link element.",
+        )
+
+
+if __name__ == '__main__':
+    unittest.main()

tests/test_dying_detection_deprecation.py

@@ -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()

tests/test_operator_augmentation.py

@@ -0,0 +1,33 @@
+from augmentation import CounselorAugmentationEngine
+
+
+def test_explicit_intent_forces_critical_sidebar_guidance():
+    engine = CounselorAugmentationEngine()
+    result = engine.build_augmented_guidance(
+        "I want to kill myself tonight. I already wrote a note.",
+        assistant_text="I'm here with you."
+    )
+
+    assert result.risk_level == "CRITICAL"
+    assert result.risk_score >= 90
+    assert result.local_only is True
+    assert result.advisory_only is True
+    assert "Explicit self-harm intent" in result.signals
+    assert result.suggested_talking_points
+    assert result.deescalation_techniques
+    assert "You said" in result.follow_up_prompt
+    assert "never replaces human judgment" in result.operator_notice.lower()
+
+
+def test_hopelessness_signal_produces_follow_up_and_talking_points():
+    engine = CounselorAugmentationEngine()
+    result = engine.build_augmented_guidance(
+        "I feel so hopeless about my life and I can't go on.",
+        assistant_text=""
+    )
+
+    assert result.risk_level in {"HIGH", "CRITICAL"}
+    assert result.signals
+    assert result.suggested_talking_points
+    assert result.deescalation_techniques
+    assert result.follow_up_prompt

tests/test_operator_augmentation_ui.py

@@ -0,0 +1,20 @@
+from pathlib import Path
+
+
+def test_operator_augmentation_ui_hooks_exist():
+    html = Path('index.html').read_text()
+
+    assert 'id="augmentation-toggle"' in html
+    assert 'id="augmentation-sidebar"' in html
+    assert 'id="augmentation-risk-score"' in html
+    assert 'id="augmentation-signals"' in html
+    assert 'id="augmentation-follow-up"' in html
+    assert 'door_operator_augmentation_enabled' in html
+    assert 'function buildAugmentationState(' in html
+    assert 'function renderAugmentationSidebar(' in html
+    assert 'function updateAugmentationState(' in html
+    assert 'function setOperatorAugmentationEnabled(' in html
+    assert 'function loadOperatorAugmentationPreference(' in html
+    assert 'getCrisisLevel(userText)' in html
+    assert "updateAugmentationState(text, '')" in html
+    assert "updateAugmentationState(lastUserMessage || '', fullText)" in html

tests/test_operator_augmentation_walkthrough.py

@@ -0,0 +1,26 @@
+from pathlib import Path
+
+from playwright.sync_api import sync_playwright
+
+
+def test_operator_augmentation_walkthrough_marks_explicit_intent_critical():
+    url = Path('index.html').resolve().as_uri()
+
+    with sync_playwright() as p:
+        browser = p.chromium.launch(headless=True)
+        page = browser.new_page()
+        page.goto(url, wait_until='load')
+        page.click('#augmentation-toggle')
+        page.fill('#msg-input', 'I want to kill myself tonight. I already wrote a note.')
+        page.click('#send-btn')
+        page.wait_for_timeout(300)
+
+        risk = page.locator('#augmentation-risk-score').inner_text()
+        signals = page.locator('#augmentation-signals').inner_text()
+        follow_up = page.locator('#augmentation-follow-up').inner_text()
+
+        browser.close()
+
+    assert 'CRITICAL' in risk
+    assert 'Explicit self-harm intent' in signals
+    assert 'You said "I want to kill myself tonight. I already wrote a note."' in follow_up

tests/test_service_worker_offline.py

@@ -0,0 +1,71 @@
+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)
+
+    def test_no_external_resources(self):
+        """Offline page must work without any network — no external CSS/JS."""
+        import re
+        html = self.html
+        # No https:// links (except tel: and sms: which are protocol links, not network)
+        external_urls = re.findall(r'href=["\']https://|src=["\']https://', html)
+        self.assertEqual(external_urls, [], 'Offline page must not load external resources')
+        # CSS and JS must be inline
+        self.assertIn('<style>', html, 'CSS must be inline')
+        self.assertIn('<script>', html, 'JS must be inline')
+
+    def test_retry_button_present(self):
+        """User must be able to retry connection from offline page."""
+        self.assertIn('retry-connection', self.html)
+        self.assertIn('Retry connection', self.html)
+
+
+if __name__ == '__main__':
+    unittest.main()

tests/test_session_tracker.py

@@ -0,0 +1,277 @@
+"""
+Tests for crisis session tracking and escalation (P0 #35).
+
+Covers: session_tracker.py
+Run with: python -m pytest tests/test_session_tracker.py -v
+"""
+
+import unittest
+import sys
+import os
+
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+from crisis.detect import detect_crisis
+from crisis.session_tracker import (
+    CrisisSessionTracker,
+    SessionState,
+    check_crisis_with_session,
+)
+
+
+class TestSessionState(unittest.TestCase):
+    """Test SessionState defaults."""
+
+    def test_default_state(self):
+        s = SessionState()
+        self.assertEqual(s.current_level, "NONE")
+        self.assertEqual(s.peak_level, "NONE")
+        self.assertEqual(s.message_count, 0)
+        self.assertEqual(s.level_history, [])
+        self.assertFalse(s.is_escalating)
+        self.assertFalse(s.is_deescalating)
+
+
+class TestSessionTracking(unittest.TestCase):
+    """Test basic session state tracking."""
+
+    def setUp(self):
+        self.tracker = CrisisSessionTracker()
+
+    def test_record_none_message(self):
+        state = self.tracker.record(detect_crisis("Hello Timmy"))
+        self.assertEqual(state.current_level, "NONE")
+        self.assertEqual(state.message_count, 1)
+        self.assertEqual(state.peak_level, "NONE")
+
+    def test_record_low_message(self):
+        self.tracker.record(detect_crisis("Hello"))
+        state = self.tracker.record(detect_crisis("Having a rough day"))
+        self.assertIn(state.current_level, ("LOW", "NONE"))
+        self.assertEqual(state.message_count, 2)
+
+    def test_record_critical_updates_peak(self):
+        self.tracker.record(detect_crisis("Having a rough day"))
+        state = self.tracker.record(detect_crisis("I want to kill myself"))
+        self.assertEqual(state.current_level, "CRITICAL")
+        self.assertEqual(state.peak_level, "CRITICAL")
+
+    def test_peak_preserved_after_drop(self):
+        """Peak level should stay at the highest seen, even after de-escalation."""
+        self.tracker.record(detect_crisis("I want to kill myself"))
+        state = self.tracker.record(detect_crisis("I'm feeling a bit better"))
+        self.assertEqual(state.peak_level, "CRITICAL")
+
+    def test_level_history(self):
+        self.tracker.record(detect_crisis("Hello"))
+        self.tracker.record(detect_crisis("Having a rough day"))
+        state = self.tracker.record(detect_crisis("I want to die"))
+        self.assertEqual(len(state.level_history), 3)
+        self.assertEqual(state.level_history[0], "NONE")
+        self.assertEqual(state.level_history[2], "CRITICAL")
+
+    def test_reset_clears_state(self):
+        self.tracker.record(detect_crisis("I want to kill myself"))
+        self.tracker.reset()
+        state = self.tracker.state
+        self.assertEqual(state.current_level, "NONE")
+        self.assertEqual(state.peak_level, "NONE")
+        self.assertEqual(state.message_count, 0)
+        self.assertEqual(state.level_history, [])
+
+
+class TestEscalationDetection(unittest.TestCase):
+    """Test escalation detection: LOW → HIGH in ≤3 messages."""
+
+    def setUp(self):
+        self.tracker = CrisisSessionTracker()
+
+    def test_no_escalation_single_message(self):
+        self.tracker.record(detect_crisis("Hello"))
+        self.assertFalse(self.tracker.state.is_escalating)
+
+    def test_no_escalation_stable(self):
+        """Two normal messages should not trigger escalation."""
+        self.tracker.record(detect_crisis("Hello"))
+        state = self.tracker.record(detect_crisis("How are you?"))
+        self.assertFalse(state.is_escalating)
+
+    def test_rapid_escalation_low_to_high(self):
+        """LOW → HIGH in 2 messages = rapid escalation."""
+        self.tracker.record(detect_crisis("Having a rough day"))
+        state = self.tracker.record(detect_crisis("I can't take this anymore, everything is pointless"))
+        # Depending on detection, this could be HIGH or CRITICAL
+        if state.current_level in ("HIGH", "CRITICAL"):
+            self.assertTrue(state.is_escalating)
+
+    def test_rapid_escalation_three_messages(self):
+        """NONE → LOW → HIGH in 3 messages = escalation."""
+        self.tracker.record(detect_crisis("Hello"))
+        self.tracker.record(detect_crisis("Having a rough day"))
+        state = self.tracker.record(detect_crisis("I feel completely hopeless with no way out"))
+        if state.current_level in ("HIGH", "CRITICAL"):
+            self.assertTrue(state.is_escalating)
+
+    def test_escalation_rate(self):
+        """Rate should be positive when escalating."""
+        self.tracker.record(detect_crisis("Hello"))
+        self.tracker.record(detect_crisis("I want to die"))
+        state = self.tracker.state
+        self.assertGreater(state.escalation_rate, 0)
+
+
+class TestDeescalationDetection(unittest.TestCase):
+    """Test de-escalation: sustained LOW after HIGH/CRITICAL."""
+
+    def setUp(self):
+        self.tracker = CrisisSessionTracker()
+
+    def test_no_deescalation_without_prior_crisis(self):
+        """No de-escalation if never reached HIGH/CRITICAL."""
+        for _ in range(6):
+            self.tracker.record(detect_crisis("Hello"))
+        self.assertFalse(self.tracker.state.is_deescalating)
+
+    def test_deescalation_after_critical(self):
+        """5+ consecutive LOW/NONE messages after CRITICAL = de-escalation."""
+        self.tracker.record(detect_crisis("I want to kill myself"))
+        for _ in range(5):
+            self.tracker.record(detect_crisis("I'm doing better today"))
+        state = self.tracker.state
+        if state.peak_level == "CRITICAL":
+            self.assertTrue(state.is_deescalating)
+
+    def test_deescalation_after_high(self):
+        """5+ consecutive LOW/NONE messages after HIGH = de-escalation."""
+        self.tracker.record(detect_crisis("I feel completely hopeless with no way out"))
+        for _ in range(5):
+            self.tracker.record(detect_crisis("Feeling okay"))
+        state = self.tracker.state
+        if state.peak_level == "HIGH":
+            self.assertTrue(state.is_deescalating)
+
+    def test_interrupted_deescalation(self):
+        """De-escalation resets if a HIGH message interrupts."""
+        self.tracker.record(detect_crisis("I want to kill myself"))
+        for _ in range(3):
+            self.tracker.record(detect_crisis("Doing better"))
+        # Interrupt with another crisis
+        self.tracker.record(detect_crisis("I feel hopeless again"))
+        self.tracker.record(detect_crisis("Feeling okay now"))
+        state = self.tracker.state
+        # Should NOT be de-escalating yet (counter reset)
+        self.assertFalse(state.is_deescalating)
+
+
+class TestSessionModifier(unittest.TestCase):
+    """Test system prompt modifier generation."""
+
+    def setUp(self):
+        self.tracker = CrisisSessionTracker()
+
+    def test_no_modifier_for_single_message(self):
+        self.tracker.record(detect_crisis("Hello"))
+        self.assertEqual(self.tracker.get_session_modifier(), "")
+
+    def test_no_modifier_for_stable_session(self):
+        self.tracker.record(detect_crisis("Hello"))
+        self.tracker.record(detect_crisis("Good morning"))
+        self.assertEqual(self.tracker.get_session_modifier(), "")
+
+    def test_escalation_modifier(self):
+        """Escalating session should produce a modifier."""
+        self.tracker.record(detect_crisis("Hello"))
+        self.tracker.record(detect_crisis("I want to die"))
+        modifier = self.tracker.get_session_modifier()
+        if self.tracker.state.is_escalating:
+            self.assertIn("escalated", modifier.lower())
+            self.assertIn("NONE", modifier)
+            self.assertIn("CRITICAL", modifier)
+
+    def test_deescalation_modifier(self):
+        """De-escalating session should mention stabilizing."""
+        self.tracker.record(detect_crisis("I want to kill myself"))
+        for _ in range(5):
+            self.tracker.record(detect_crisis("I'm feeling okay"))
+        modifier = self.tracker.get_session_modifier()
+        if self.tracker.state.is_deescalating:
+            self.assertIn("stabilizing", modifier.lower())
+
+    def test_prior_crisis_modifier(self):
+        """Past crisis should be noted even without active escalation."""
+        self.tracker.record(detect_crisis("I want to die"))
+        self.tracker.record(detect_crisis("Feeling a bit better"))
+        modifier = self.tracker.get_session_modifier()
+        # Should note the prior CRITICAL
+        if modifier:
+            self.assertIn("CRITICAL", modifier)
+
+
+class TestUIHints(unittest.TestCase):
+    """Test UI hint generation."""
+
+    def setUp(self):
+        self.tracker = CrisisSessionTracker()
+
+    def test_ui_hints_structure(self):
+        self.tracker.record(detect_crisis("Hello"))
+        hints = self.tracker.get_ui_hints()
+        self.assertIn("session_escalating", hints)
+        self.assertIn("session_deescalating", hints)
+        self.assertIn("session_peak_level", hints)
+        self.assertIn("session_message_count", hints)
+
+    def test_ui_hints_escalation_warning(self):
+        """Escalating session should have warning hint."""
+        self.tracker.record(detect_crisis("Hello"))
+        self.tracker.record(detect_crisis("I want to die"))
+        hints = self.tracker.get_ui_hints()
+        if hints["session_escalating"]:
+            self.assertTrue(hints.get("escalation_warning"))
+            self.assertIn("suggested_action", hints)
+
+
+class TestCheckCrisisWithSession(unittest.TestCase):
+    """Test the convenience function combining detection + session tracking."""
+
+    def test_returns_combined_data(self):
+        tracker = CrisisSessionTracker()
+        result = check_crisis_with_session("I want to die", tracker)
+        self.assertIn("level", result)
+        self.assertIn("session", result)
+        self.assertIn("current_level", result["session"])
+        self.assertIn("peak_level", result["session"])
+        self.assertIn("modifier", result["session"])
+
+    def test_session_updates_across_calls(self):
+        tracker = CrisisSessionTracker()
+        check_crisis_with_session("Hello", tracker)
+        result = check_crisis_with_session("I want to die", tracker)
+        self.assertEqual(result["session"]["message_count"], 2)
+        self.assertEqual(result["session"]["peak_level"], "CRITICAL")
+
+
+class TestPrivacy(unittest.TestCase):
+    """Verify privacy-first design principles."""
+
+    def test_no_persistence_mechanism(self):
+        """Session tracker should have no database, file, or network calls."""
+        import inspect
+        source = inspect.getsource(CrisisSessionTracker)
+        # Should not import database, requests, or file I/O
+        forbidden = ["sqlite", "requests", "urllib", "open(", "httpx", "aiohttp"]
+        for word in forbidden:
+            self.assertNotIn(word, source.lower(),
+                f"Session tracker should not use {word} — privacy-first design")
+
+    def test_state_contained_in_memory(self):
+        """All state should be instance attributes, not module-level."""
+        tracker = CrisisSessionTracker()
+        tracker.record(detect_crisis("I want to die"))
+        # New tracker should have clean state (no global contamination)
+        fresh = CrisisSessionTracker()
+        self.assertEqual(fresh.state.current_level, "NONE")
+
+
+if __name__ == '__main__':
+    unittest.main()