instar 1.2.59 → 1.2.60

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "1.2.59",
+  "version": "1.2.60",
   "description": "Persistent autonomy infrastructure for AI agents",
   "type": "module",
   "main": "dist/index.js",

package/src/data/builtin-manifest.json

@@ -1,8 +1,8 @@
 {
   "$schema": "./builtin-manifest.schema.json",
   "schemaVersion": 1,
-  "generatedAt": "2026-05-24T20:16:57.281Z",
-  "instarVersion": "1.2.59",
+  "generatedAt": "2026-05-24T21:07:21.363Z",
+  "instarVersion": "1.2.60",
   "entryCount": 191,
   "entries": {
     "hook:session-start": {
@@ -392,7 +392,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:agents": {
@@ -400,7 +400,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:backups": {
@@ -408,7 +408,7 @@
       "type": "route-group",
       "domain": "operations",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:git": {
@@ -416,7 +416,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:memory": {
@@ -424,7 +424,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:semantic": {
@@ -432,7 +432,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:status": {
@@ -440,7 +440,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:capabilities": {
@@ -448,7 +448,7 @@
       "type": "route-group",
       "domain": "mapping",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:project-map": {
@@ -456,7 +456,7 @@
       "type": "route-group",
       "domain": "mapping",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:coherence": {
@@ -464,7 +464,7 @@
       "type": "route-group",
       "domain": "coherence",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:topic-bindings": {
@@ -472,7 +472,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:context": {
@@ -480,7 +480,7 @@
       "type": "route-group",
       "domain": "context",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:scope-coherence": {
@@ -488,7 +488,7 @@
       "type": "route-group",
       "domain": "coherence",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:canonical-state": {
@@ -496,7 +496,7 @@
       "type": "route-group",
       "domain": "state",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:ci": {
@@ -504,7 +504,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:sessions": {
@@ -512,7 +512,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:jobs": {
@@ -520,7 +520,7 @@
       "type": "route-group",
       "domain": "scheduling",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:skip-ledger": {
@@ -528,7 +528,7 @@
       "type": "route-group",
       "domain": "scheduling",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:telegram": {
@@ -536,7 +536,7 @@
       "type": "route-group",
       "domain": "communication",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:attention": {
@@ -544,7 +544,7 @@
       "type": "route-group",
       "domain": "communication",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:relationships": {
@@ -552,7 +552,7 @@
       "type": "route-group",
       "domain": "relationships",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:feedback": {
@@ -560,7 +560,7 @@
       "type": "route-group",
       "domain": "feedback",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:updates": {
@@ -568,7 +568,7 @@
       "type": "route-group",
       "domain": "updates",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:dispatches": {
@@ -576,7 +576,7 @@
       "type": "route-group",
       "domain": "dispatches",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:quota": {
@@ -584,7 +584,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:publishing": {
@@ -592,7 +592,7 @@
       "type": "route-group",
       "domain": "publishing",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:private-views": {
@@ -600,7 +600,7 @@
       "type": "route-group",
       "domain": "publishing",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:tunnel": {
@@ -608,7 +608,7 @@
       "type": "route-group",
       "domain": "networking",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:events": {
@@ -616,7 +616,7 @@
       "type": "route-group",
       "domain": "networking",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:evolution": {
@@ -624,7 +624,7 @@
       "type": "route-group",
       "domain": "evolution",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:watchdog": {
@@ -632,7 +632,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:topic-memory": {
@@ -640,7 +640,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:state-sync": {
@@ -648,7 +648,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:intent": {
@@ -656,7 +656,7 @@
       "type": "route-group",
       "domain": "intent",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:triage": {
@@ -664,7 +664,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:operations": {
@@ -672,7 +672,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:sentinel": {
@@ -680,7 +680,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:trust": {
@@ -688,7 +688,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:monitoring": {
@@ -696,7 +696,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:commitments": {
@@ -704,7 +704,7 @@
       "type": "route-group",
       "domain": "commitments",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:episodes": {
@@ -712,7 +712,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:messages": {
@@ -720,7 +720,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:system-reviews": {
@@ -728,7 +728,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "route-group:machine-mesh": {
@@ -744,7 +744,7 @@
       "type": "route-group",
       "domain": "security",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "9c3a0b58c578a392d4a299917fd71f43911c282963247611122739eb59c2415e",
+      "contentHash": "1397612a42656f1c9bc6649aee811f7eb3842fbc14f7bcec7438644b187ea6d6",
       "since": "2025-01-01"
     },
     "cli:init": {

package/upgrades/1.2.60.md

@@ -0,0 +1,57 @@
+# Upgrade Guide — NEXT (human-as-detector)
+
+<!-- bump: minor -->
+<!-- minor = new capability, backward compatible -->
+
+## What Changed
+
+**New: instar now treats a human-caught coherence break as a first-class diagnostic signal.**
+
+When the user has to point something out — "that's wrong", "you already said the opposite",
+"that's out of date", "why didn't you catch this" — that correction is no longer just an
+input to fix quietly. It is evidence that some automated guardian (CoherenceGate,
+CoherenceMonitor, a freshness check) *should* have caught it and didn't. The new
+`HumanAsDetectorLog` (`src/monitoring/HumanAsDetectorLog.ts`) observes inbound human
+messages, classifies corrections with a conservative, precision-biased regex set (no LLM,
+no network), and records each as a signal mapped to the guardian layer that plausibly
+failed. Over time this builds a heat map of "where the human is doing the system's job",
+exposed read-only at `GET /human-as-detector/summary`.
+
+This is the user-feedback half of the Continuous Working Awareness north star: never let a
+user correction go to waste. It mirrors `DegradationReporter`: a singleton configured at
+startup, append-only JSONL persistence at `.instar/metrics/human-as-detector.jsonl`,
+best-effort, and it never throws into message handling. The observe hook is chained onto the
+inbound Telegram message callback (preserving prior callbacks; only inbound human messages
+are observed).
+
+## What to Tell Your User
+
+When you point out something I got wrong or stale, I now treat that as a sign one of my own
+safety checks missed it — not just a one-off to fix and forget. I quietly keep score of which
+checks keep letting things slip past, so we can see where my automated guardrails are weak and
+strengthen them over time. Nothing for you to set up; existing agents get it on their next
+update. You can ask me to show the heat map of where you've had to catch my mistakes.
+
+## Summary of New Capabilities
+
+- New `HumanAsDetectorLog` monitor: classifies inbound human corrections into categories
+  (factual-correction, staleness, contradiction, source-of-truth-drift, repeat-ask,
+  meta-failure), each mapped to the guardian layer that should have caught it.
+- New read-only endpoint `GET /human-as-detector/summary` — the heat map grouped by suspected
+  failed layer, plus recent signals.
+- Append-only audit trail at `.instar/metrics/human-as-detector.jsonl`.
+- Always-on, no config, no LLM, no network; best-effort and never throws into message handling.
+
+## Evidence
+
+- Tier 1 (unit): 19 tests — 15 on the classifier/observe/heat-map core, 4 on the
+  inbound-human gating helper (`observeInboundMessage`). All pass.
+- Tier 2 (integration): 3 tests against the real `createRoutes` pipeline — empty map,
+  recorded correction surfaces, non-correction ignored. All pass.
+- Tier 3 (e2e): 2 tests booting the real route tree on a live HTTP server — endpoint alive
+  (200), and an observed correction flows to the live endpoint AND to the JSONL on disk.
+  All pass.
+- `npx tsc --noEmit` clean.
+- Ported from Dawn's reference implementation (the-portal handoff); built fresh on current
+  `origin/main`, not from the stale local checkout (avoids reverting SafeFsExecutor /
+  iMessage-attachment features per the handoff's critical warnings).

package/upgrades/side-effects/human-as-detector.md

@@ -0,0 +1,43 @@
+# Side-Effects Review — HumanAsDetectorLog
+
+**Change**: Ports Dawn's human-as-detector pattern into Instar. Treats every human-caught
+coherence break as a first-class signal about which automated layer failed to catch it.
+
+## Files
+- `src/monitoring/HumanAsDetectorLog.ts` (new) — singleton, deterministic no-LLM classifier,
+  append-only `.instar/metrics/human-as-detector.jsonl`, `summarizeByLayer()` heat map, plus
+  the `observeInboundMessage()` gating helper (inbound-human-only).
+- `tests/unit/HumanAsDetectorLog.test.ts` (new) — 19 unit tests (classifier/observe/heat-map +
+  gating-helper wiring integrity).
+- `tests/integration/human-as-detector-routes.test.ts` (new) — 3 tests via real `createRoutes`.
+- `tests/e2e/human-as-detector-lifecycle.test.ts` (new) — 2 tests, live HTTP boot + disk.
+- `src/server/routes.ts` — adds read-only `GET /human-as-detector/summary` (singleton-backed).
+- `src/commands/server.ts` — configure() at startup; `observeInboundMessage()` chained onto
+  `telegram.onMessageLogged` (chains prior callbacks; only inbound human messages).
+
+## Side effects
+- **New disk write**: appends to `.instar/metrics/human-as-detector.jsonl` only when an
+  inbound human message matches a correction signal. Best-effort; wrapped in try/catch; never
+  throws into message handling.
+- **Console**: one `[HUMAN-AS-DETECTOR]` warn line per detected signal (mirrors
+  DegradationReporter's loud-not-silent convention).
+- **No network, no LLM, no external calls.** Classifier is pure regex over a conservative set.
+- **No behavior change to message handling**: the hook only observes; prior `onMessageLogged`
+  callbacks (TopicMemory dual-write, PresenceProxy, keep-watching) are preserved via chaining.
+- **New endpoint** is read-only and singleton-backed (always available; no 503 path).
+
+## Risk
+- Low. Additive, isolated module. Worst case on a logic bug: a spurious JSONL line or a missed
+  signal — neither affects message delivery (observe never throws into the caller).
+- False-positive risk on the classifier is bounded by the `totalWeight >= 2` threshold (lone
+  weak signals like "actually," are ignored).
+- Rollback cost: trivial — drop the module, the endpoint, and the ~6 wiring lines; no schema,
+  no migration, no config default.
+
+## Signal vs authority
+- Pure signal. The log only *records* and *summarizes*; it has no blocking authority and gates
+  nothing. Consumers (a human reading the heat map, or future evolution tooling) decide.
+
+## Verification
+- `npx tsc --noEmit` — clean (no new errors).
+- `npx vitest run` on the three new test files — 24/24 pass across unit + integration + e2e.