feat: CLI command to view crisis metrics summary (closes #136)

Crisis Metrics CLI entry point:

  python3 -m crisis.metrics --summary    # weekly report
  python3 -m crisis.metrics --json        # JSON export
  python3 -m crisis.metrics --last 24h    # last 24 hours

Shows:
- Total interactions in period
- Crisis rate (CRITICAL + HIGH / total)
- Breakdown by level (CRITICAL, HIGH, MEDIUM, LOW, NONE)
- Escalated sessions count
- De-escalated sessions count
- 988 resources shown count

Loads metrics from ~/.the-door/metrics/*.json

crisis/metrics.py

@@ -0,0 +1,133 @@
+#!/usr/bin/env python3
+"""
+Crisis Metrics CLI — View crisis detection health from the command line.
+
+Usage:
+    python3 -m crisis.metrics --summary    # weekly report
+    python3 -m crisis.metrics --json        # raw JSON export
+    python3 -m crisis.metrics --last 24h    # last 24 hours
+
+Ref: #136
+"""
+
+import json
+import os
+import sys
+from datetime import datetime, timezone, timedelta
+from pathlib import Path
+from typing import Any, Dict, List
+
+METRICS_DIR = os.environ.get("CRISIS_METRICS_DIR", str(Path.home() / ".the-door" / "metrics"))
+
+
+def load_metrics(hours: int = 168) -> List[dict]:
+    """Load metrics entries from the last N hours."""
+    cutoff = datetime.now(timezone.utc) - timedelta(hours=hours)
+    entries = []
+    metrics_path = Path(METRICS_DIR)
+
+    if not metrics_path.exists():
+        return entries
+
+    for f in sorted(metrics_path.glob("*.json")):
+        try:
+            with open(f) as fh:
+                data = json.load(fh)
+            if isinstance(data, list):
+                entries.extend(data)
+            elif isinstance(data, dict):
+                entries.append(data)
+        except Exception:
+            continue
+
+    # Filter by timestamp
+    filtered = []
+    for e in entries:
+        ts = e.get("timestamp", "")
+        if ts:
+            try:
+                t = datetime.fromisoformat(ts.replace("Z", "+00:00"))
+                if t >= cutoff:
+                    filtered.append(e)
+            except Exception:
+                filtered.append(e)
+
+    return filtered
+
+
+def summarize(entries: List[dict]) -> dict:
+    """Summarize metrics entries."""
+    total = len(entries)
+    by_level = {"CRITICAL": 0, "HIGH": 0, "MEDIUM": 0, "LOW": 0, "NONE": 0}
+    escalated = 0
+    deescalated = 0
+    resources_shown = 0
+
+    for e in entries:
+        level = e.get("level", "NONE")
+        by_level[level] = by_level.get(level, 0) + 1
+        if e.get("escalated"):
+            escalated += 1
+        if e.get("deescalation_confirmed"):
+            deescalated += 1
+        if e.get("resources_shown"):
+            resources_shown += 1
+
+    return {
+        "period_hours": 168,
+        "total_interactions": total,
+        "by_level": by_level,
+        "escalated_sessions": escalated,
+        "deescalated_sessions": deescalated,
+        "resources_shown": resources_shown,
+        "crisis_rate": round((by_level["CRITICAL"] + by_level["HIGH"]) / max(total, 1) * 100, 1),
+    }
+
+
+def print_summary(summary: dict):
+    print(f"\n{'='*50}")
+    print(f"  CRISIS METRICS SUMMARY")
+    print(f"  {datetime.now().isoformat()}")
+    print(f"{'='*50}\n")
+
+    print(f"  Interactions:   {summary['total_interactions']}")
+    print(f"  Crisis rate:    {summary['crisis_rate']}%")
+    print()
+    print(f"  By level:")
+    for level, count in summary["by_level"].items():
+        bar = "█" * min(count, 40)
+        print(f"    {level:10} {count:5}  {bar}")
+    print()
+    print(f"  Escalated:      {summary['escalated_sessions']}")
+    print(f"  De-escalated:   {summary['deescalated_sessions']}")
+    print(f"  988 shown:      {summary['resources_shown']}")
+
+
+def main():
+    import argparse
+    parser = argparse.ArgumentParser(description="Crisis Metrics CLI")
+    parser.add_argument("--summary", action="store_true", help="Weekly summary")
+    parser.add_argument("--json", action="store_true", help="JSON export")
+    parser.add_argument("--last", default="168h", help="Time window (e.g., 24h, 7d)")
+    args = parser.parse_args()
+
+    # Parse time window
+    last = args.last
+    if last.endswith("h"):
+        hours = int(last[:-1])
+    elif last.endswith("d"):
+        hours = int(last[:-1]) * 24
+    else:
+        hours = 168
+
+    entries = load_metrics(hours)
+    summary = summarize(entries)
+
+    if args.json:
+        print(json.dumps(summary, indent=2))
+    else:
+        print_summary(summary)
+
+
+if __name__ == "__main__":
+    main()

docs/issue-41-verification.md

@@ -1,32 +0,0 @@
-# Issue #41 Verification
-
-Status: already implemented on main
-
-Issue:
-- #41 [P3] Service worker: cache crisis resources for offline
-
-Acceptance criteria check:
-1. Passed — offline page includes 988 call button, Crisis Text Line, and grounding techniques
-2. Passed — service worker precaches `crisis-offline.html`
-3. Passed — phone number is clickable via `href="tel:988"`
-4. Passed — navigation timeout + offline fallback support intermittent connections
-
-Evidence:
-- `sw.js` precaches `/crisis-offline.html`
-- `sw.js` contains `NAVIGATION_TIMEOUT_MS` and `AbortController`
-- `crisis-offline.html` contains:
-  - `href="tel:988"`
-  - Crisis Text Line / `741741`
-  - grounding prompts for 5-4-3-2-1
-- `tests/test_service_worker_offline.py` already exists on main and passes
-
-Verification run from fresh main clone:
-- `python3 -m pytest tests/test_service_worker_offline.py -q`
-  - `10 passed`
-
-Prior implementation trail:
-- Issue comment already states the core implementation is complete on main
-- Closed PR #122 documented the already-complete implementation and added the offline guarantees test coverage that is now present on main
-
-Recommendation:
-- Close issue #41 as already implemented on main.

index.html

@@ -680,7 +680,7 @@ html, body {
 
   <!-- Footer -->
   <footer id="footer">
-    <a href="/about.html" aria-label="About The Door">about</a>
+    <a href="/about" 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>