instar 1.3.5 → 1.3.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "1.3.5",
+  "version": "1.3.6",
   "description": "Coherence infrastructure for self-evolving AI agents — on the Claude Code or Codex subscription you already have.",
   "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-27T03:21:57.444Z",
-  "instarVersion": "1.3.5",
+  "generatedAt": "2026-05-27T03:42:33.009Z",
+  "instarVersion": "1.3.6",
   "entryCount": 192,
   "entries": {
     "hook:session-start": {
@@ -401,7 +401,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:agents": {
@@ -409,7 +409,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:backups": {
@@ -417,7 +417,7 @@
       "type": "route-group",
       "domain": "operations",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:git": {
@@ -425,7 +425,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:memory": {
@@ -433,7 +433,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:semantic": {
@@ -441,7 +441,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:status": {
@@ -449,7 +449,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:capabilities": {
@@ -457,7 +457,7 @@
       "type": "route-group",
       "domain": "mapping",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:project-map": {
@@ -465,7 +465,7 @@
       "type": "route-group",
       "domain": "mapping",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:coherence": {
@@ -473,7 +473,7 @@
       "type": "route-group",
       "domain": "coherence",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:topic-bindings": {
@@ -481,7 +481,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:context": {
@@ -489,7 +489,7 @@
       "type": "route-group",
       "domain": "context",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:scope-coherence": {
@@ -497,7 +497,7 @@
       "type": "route-group",
       "domain": "coherence",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:canonical-state": {
@@ -505,7 +505,7 @@
       "type": "route-group",
       "domain": "state",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:ci": {
@@ -513,7 +513,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:sessions": {
@@ -521,7 +521,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:jobs": {
@@ -529,7 +529,7 @@
       "type": "route-group",
       "domain": "scheduling",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:skip-ledger": {
@@ -537,7 +537,7 @@
       "type": "route-group",
       "domain": "scheduling",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:telegram": {
@@ -545,7 +545,7 @@
       "type": "route-group",
       "domain": "communication",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:attention": {
@@ -553,7 +553,7 @@
       "type": "route-group",
       "domain": "communication",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:relationships": {
@@ -561,7 +561,7 @@
       "type": "route-group",
       "domain": "relationships",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:feedback": {
@@ -569,7 +569,7 @@
       "type": "route-group",
       "domain": "feedback",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:updates": {
@@ -577,7 +577,7 @@
       "type": "route-group",
       "domain": "updates",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:dispatches": {
@@ -585,7 +585,7 @@
       "type": "route-group",
       "domain": "dispatches",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:quota": {
@@ -593,7 +593,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:publishing": {
@@ -601,7 +601,7 @@
       "type": "route-group",
       "domain": "publishing",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:private-views": {
@@ -609,7 +609,7 @@
       "type": "route-group",
       "domain": "publishing",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:tunnel": {
@@ -617,7 +617,7 @@
       "type": "route-group",
       "domain": "networking",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:events": {
@@ -625,7 +625,7 @@
       "type": "route-group",
       "domain": "networking",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:evolution": {
@@ -633,7 +633,7 @@
       "type": "route-group",
       "domain": "evolution",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:watchdog": {
@@ -641,7 +641,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:topic-memory": {
@@ -649,7 +649,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:state-sync": {
@@ -657,7 +657,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:intent": {
@@ -665,7 +665,7 @@
       "type": "route-group",
       "domain": "intent",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:triage": {
@@ -673,7 +673,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:operations": {
@@ -681,7 +681,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:sentinel": {
@@ -689,7 +689,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:trust": {
@@ -697,7 +697,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:monitoring": {
@@ -705,7 +705,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:commitments": {
@@ -713,7 +713,7 @@
       "type": "route-group",
       "domain": "commitments",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:episodes": {
@@ -721,7 +721,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:messages": {
@@ -729,7 +729,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:system-reviews": {
@@ -737,7 +737,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "route-group:machine-mesh": {
@@ -753,7 +753,7 @@
       "type": "route-group",
       "domain": "security",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "0edb0fd01df3bd455fba083bcbcbb334340fae7a4c0893eef842b6c68de1f644",
+      "contentHash": "2347b1bdaa18ac50c52ac5acceb0438a813754db0f1fb486f91864930be9830a",
       "since": "2025-01-01"
     },
     "cli:init": {

package/upgrades/1.3.6.md

@@ -0,0 +1,43 @@
+# Instar Upgrade Guide — NEXT
+
+<!-- bump: patch -->
+
+## What Changed
+
+**Framework-Onboarding Mentor System — Stage-B auto-capture (§19.2).** Building on the issue
+ledger shipped last release, this adds the *write path*: a single atomic `captureRun()` entry
+point that the mentor tick will call after observing a framework, plus a **capture funnel** that
+logs **every** run — including runs that found nothing. That funnel is the structural guard
+against a silent, broken writer: because a zero-finding run is still recorded as a run, "ran and
+found nothing" is always distinguishable from "never ran / writer is dead." Regression candidates
+(a new issue matching a previously-fixed one) are *surfaced for review, never auto-linked* — the
+writer doesn't get to decide a regression.
+
+A new read-only route `GET /framework-issues/capture-stats` exposes the funnel (runs vs
+observations written, broken down per framework). Still observability-only — nothing gates, and
+there is no production caller yet (the mentor job that calls `captureRun` ships in a later staged
+PR), so this is dormant infrastructure with full test coverage.
+
+## What to Tell Your User
+
+- The "notebook" now has a guaranteed *hand that writes* — whatever I notice while inspecting a
+  framework gets recorded automatically, and there's a visible counter so a broken writer can't
+  hide by looking quiet.
+- Nothing changes in your day-to-day yet; it's the next layer of a system that's still rolling
+  out gradually and stays off by default.
+
+## Summary of New Capabilities
+
+| Capability | How to Use |
+|-----------|-----------|
+| Stage-B auto-capture | `FrameworkIssueLedger.captureRun({ framework, tickId, findings })` — one atomic call the mentor tick makes; writes findings + logs the run |
+| Capture funnel | `curl -H "Authorization: Bearer $AUTH" http://localhost:<port>/framework-issues/capture-stats` — runs vs observations written, per framework (inert-writer guard) |
+
+## Evidence
+
+Net-new feature, not a bug fix — no prior failure to reproduce. Behavior is verified by tests:
+the inert-writer guard is proven by a unit test asserting a **zero-finding `captureRun` still
+increments the funnel's run count while observations stay at 0** (so "ran, found nothing" ≠ "never
+ran"), and a Tier-3 e2e boots the real server, runs a capture against the live ledger, and confirms
+`GET /framework-issues/capture-stats` reflects both the run and the written observation. 46 feature
+tests + 299 capability tests green; affected push-config suite (842) green vs canonical main.

package/upgrades/side-effects/framework-issue-capture.md

@@ -0,0 +1,68 @@
+# Side-Effects Review — Stage-B auto-capture + funnel (Mentor System §19.2)
+
+**Spec:** `docs/specs/FRAMEWORK-ONBOARDING-MENTOR-SPEC.md` (converged 5 iters, approved by Justin)
+**Change:** Adds the Stage-B auto-capture entry point `FrameworkIssueLedger.captureRun()` + a
+`framework_capture_runs` funnel table + `captureStats()` + a read-only route
+`GET /framework-issues/capture-stats`. Builds on §19.1 (the ledger foundation, PR #405).
+**Files:** `src/monitoring/FrameworkIssueLedger.ts`, `src/server/routes.ts`,
+`src/server/CapabilityIndex.ts`, `tests/unit/FrameworkIssueLedger.test.ts`,
+`tests/integration/framework-issues-routes.test.ts`,
+`tests/e2e/framework-issue-ledger-lifecycle.test.ts`, `upgrades/NEXT.md`.
+
+## Principle check (Phase 1)
+
+Does this involve a decision point that gates info flow / blocks actions / constrains behavior?
+**No.** `captureRun()` is the write-path the mentor tick will call after forensics — it records
+findings and logs the run. It holds no blocking authority. The capture-stats route is read-only
+observability. Signal-only. The decision-bearing components (Stage A, the job, graduation) are
+§19.3–5.
+
+## The seven questions
+
+1. **Over-block.** None. `captureRun` writes whatever findings it's given (validated against the
+   same enum allowlists as `recordObservation`); it rejects only structurally-invalid findings
+   (bad bucket/severity), which is correct.
+
+2. **Under-block.** The funnel is the explicit guard against the under-detection failure mode it
+   exists for: a run that writes nothing is still logged, so an inert/broken writer (runs climbing,
+   observations flat) is visible. It does not *interpret* that signal (no alerting yet) — surfacing
+   is via the read-only route; an alert/threshold is a later concern (§19.5 observability surface),
+   not under-blocking here. There is still no public write route, so no untrusted-write surface.
+
+3. **Level-of-abstraction fit.** `captureRun` lives ON the ledger (not a separate DI component)
+   because better-sqlite3 has no nested transactions and the capture is a thin orchestration over
+   `recordObservation` + `suggestRegressions` + a run-log insert. One atomic entry point for the
+   tick to call is the right seam; a separate service would add wiring with no benefit.
+
+4. **Signal vs authority.** Compliant. `captureRun` writes signal; regression candidates are
+   *surfaced, never auto-linked* (the writer doesn't get to decide a regression — §13.5). Promotion
+   and graduation authority stay with the human (§6/§8).
+
+5. **Interactions.** `captureRun` calls `recordObservation` per finding (each its own txn — no
+   nested-transaction violation), then writes one `framework_capture_runs` row. Episode-collapsing
+   in `recordObservation` already prevents double-counting across runs, so re-observing the same
+   open issue next tick does not inflate `observationsWritten`. The funnel table is independent of
+   the issues/observations tables — no shadowing.
+
+6. **External surfaces.** One new read-only route (`/framework-issues/capture-stats`) behind the
+   standard Bearer middleware, added to the existing `frameworkIssues` CapabilityIndex entry (no
+   new prefix → no discoverability-classification gap). No agent-facing template change needed
+   beyond §19.1's. No timing/conversation-state dependence.
+
+7. **Rollback cost.** Low. Still dormant — no production caller until the mentor job (§19.4). The
+   `framework_capture_runs` table auto-creates at startup (idempotent `CREATE TABLE IF NOT EXISTS`)
+   and is harmless read-only data. Back-out = revert; the table can stay or be dropped.
+
+## Phase 5 — second-pass
+
+**Not required.** Read-only observability + a signal-only write-path; no block/allow, no
+session-lifecycle, nothing named sentinel/guard/gate/watchdog. The spec passed full convergence.
+
+## Testing
+
+- Tier 1 (unit, +6 = 28 total): captureRun writes findings + reports summary; **every run logged
+  to the funnel including a zero-finding run** (inert-writer guard); no double-count across runs;
+  regression candidates surfaced not auto-linked; per-framework funnel breakdown; enum guard.
+- Tier 2 (integration, +2 = 11 total): `/framework-issues/capture-stats` 503 + 200-with-funnel.
+- Tier 3 (e2e, +1 = 7 total): a real capture run surfaces in the funnel route on the live server.
+- Affected push-config suite (vs JKHeadley/main): 842 + 299 capability tests green, no regressions.