instar 1.3.664 → 1.3.665

package/dist/core/paneTail.d.ts

@@ -0,0 +1,29 @@
+/**
+ * paneTail — ONE definition of "the live tail" of a tmux pane capture, shared by
+ * every pane-signal consumer (StuckSignatureClassifier, IdleErrorClassifier, …).
+ *
+ * Extracted (CMT-1785) so the tail-gating + line-lead-stripping logic is not COPIED
+ * per consumer (the copies were already drifting: tailLines 12 / 20 / 8). A single
+ * definition is the only way "what counts as the live tail" stays consistent.
+ *
+ * Pure, dependency-free, allocation-cheap. No tmux, no I/O — it operates on an
+ * already-captured string.
+ */
+/**
+ * The last `tailLines` NON-EMPTY (non-whitespace-after-trim) lines of a capture,
+ * AS LINES (trimmed). The "live tail" — the region right above the prompt. Callers
+ * that need a joined string do `.join('\n')`.
+ */
+export declare function liveTail(text: string, tailLines: number): string[];
+/**
+ * Strip a leading run of ANSI SGR escapes + Claude Code lead glyphs + whitespace
+ * (any interleaving) so the first *content* token of the line is exposed. Idempotent.
+ */
+export declare function stripLineLead(line: string): string;
+/**
+ * True iff the line's stripped lead contained at least one known Claude lead glyph —
+ * i.e. the line was rendered as a Claude TUI line-lead (the discriminator that
+ * separates a Claude-emitted frame from raw column-0 content / prose).
+ */
+export declare function wasGlyphLed(line: string): boolean;
+//# sourceMappingURL=paneTail.d.ts.map

package/dist/core/paneTail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paneTail.d.ts","sourceRoot":"","sources":["../../src/core/paneTail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAGlE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGjD"}

package/dist/core/paneTail.js

@@ -0,0 +1,52 @@
+/**
+ * paneTail — ONE definition of "the live tail" of a tmux pane capture, shared by
+ * every pane-signal consumer (StuckSignatureClassifier, IdleErrorClassifier, …).
+ *
+ * Extracted (CMT-1785) so the tail-gating + line-lead-stripping logic is not COPIED
+ * per consumer (the copies were already drifting: tailLines 12 / 20 / 8). A single
+ * definition is the only way "what counts as the live tail" stays consistent.
+ *
+ * Pure, dependency-free, allocation-cheap. No tmux, no I/O — it operates on an
+ * already-captured string.
+ */
+/**
+ * Claude Code line-lead glyphs (the bullet / tree-branch / box-drawing characters
+ * the TUI prints at the start of a rendered line) plus the box-drawing range.
+ * These are CONTENT (Unicode), not ANSI escapes — tmux `capture-pane -p` preserves
+ * them. The set is the static contract pinned by IdleErrorClassifier's fixture tests.
+ */
+const LEAD_GLYPH_CLASS = '\\u23FA\\u23BF\\u273B\\u25CF\\u2502\\u00B7\\u276F\\u203A\\u2570\\u256D\\u2717\\u2500-\\u257F';
+/** A leading ANSI SGR colour run (absent under `-p`, stripped defensively in case a
+ *  future caller captures with `-e`). */
+const ANSI_SGR = '\\x1b\\[[0-9;]*m';
+/** Matches the leading run of (ANSI SGR | whitespace | lead-glyph), in any interleaving. */
+const LEAD_RE = new RegExp(`^(?:${ANSI_SGR}|[\\s${LEAD_GLYPH_CLASS}])+`);
+/** True iff the (single) char is one of the known lead glyphs. */
+const GLYPH_RE = new RegExp(`[${LEAD_GLYPH_CLASS}]`);
+/**
+ * The last `tailLines` NON-EMPTY (non-whitespace-after-trim) lines of a capture,
+ * AS LINES (trimmed). The "live tail" — the region right above the prompt. Callers
+ * that need a joined string do `.join('\n')`.
+ */
+export function liveTail(text, tailLines) {
+    const lines = text.split('\n').map((l) => l.trim()).filter(Boolean);
+    return tailLines >= 0 ? lines.slice(-tailLines) : lines;
+}
+/**
+ * Strip a leading run of ANSI SGR escapes + Claude Code lead glyphs + whitespace
+ * (any interleaving) so the first *content* token of the line is exposed. Idempotent.
+ */
+export function stripLineLead(line) {
+    const m = LEAD_RE.exec(line);
+    return m ? line.slice(m[0].length) : line;
+}
+/**
+ * True iff the line's stripped lead contained at least one known Claude lead glyph —
+ * i.e. the line was rendered as a Claude TUI line-lead (the discriminator that
+ * separates a Claude-emitted frame from raw column-0 content / prose).
+ */
+export function wasGlyphLed(line) {
+    const m = LEAD_RE.exec(line);
+    return m ? GLYPH_RE.test(m[0]) : false;
+}
+//# sourceMappingURL=paneTail.js.map

package/dist/core/paneTail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paneTail.js","sourceRoot":"","sources":["../../src/core/paneTail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;GAKG;AACH,MAAM,gBAAgB,GACpB,8FAA8F,CAAC;AAEjG;yCACyC;AACzC,MAAM,QAAQ,GAAG,kBAAkB,CAAC;AAEpC,4FAA4F;AAC5F,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,OAAO,QAAQ,QAAQ,gBAAgB,KAAK,CAAC,CAAC;AAEzE,kEAAkE;AAClE,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,IAAI,gBAAgB,GAAG,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,SAAiB;IACtD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpE,OAAO,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACzC,CAAC"}

package/dist/monitoring/StuckSignatureClassifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StuckSignatureClassifier.d.ts","sourceRoot":"","sources":["../../src/monitoring/StuckSignatureClassifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,MAAM,MAAM,SAAS,GACjB,cAAc,GACd,cAAc,GACd,eAAe,GACf,kBAAkB,CAAC;AAEvB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA2CD,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,SAAS,SAAK,GACb,mBAAmB,GAAG,IAAI,CAqD5B"}
+{"version":3,"file":"StuckSignatureClassifier.d.ts","sourceRoot":"","sources":["../../src/monitoring/StuckSignatureClassifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAKH,MAAM,MAAM,SAAS,GACjB,cAAc,GACd,cAAc,GACd,eAAe,GACf,kBAAkB,CAAC;AAEvB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4CD,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,SAAS,SAAK,GACb,mBAAmB,GAAG,IAAI,CAqD5B"}

package/dist/monitoring/StuckSignatureClassifier.js

@@ -30,6 +30,7 @@
  * incident, and adds tail-gated rate-limit + context-too-long detection.
  */
 import { classifyWedgeTail } from './ContextWedgeSentinel.js';
+import { liveTail as sharedLiveTail } from '../core/paneTail.js';
 /** Rate-limit / usage-limit pane signatures (the Claude usage-limit form the
  *  RateLimitSentinel does NOT auto-handle — it only owns the capacity throttle).
  *  Anchored on the STATIVE/blocking forms Claude Code prints when it actually
@@ -57,10 +58,11 @@ const NORMAL_COMPACTION_TAIL_PATTERNS = [
     /compaction[^.\n]{0,20}resumed/i,
     /compaction recovery/i,
 ];
-/** The last `tailLines` non-empty, trimmed lines of a capture, joined. */
+/** The last `tailLines` non-empty, trimmed lines of a capture, joined.
+ *  Delegates to the shared paneTail.liveTail (CMT-1785: one definition of the live
+ *  tail) and joins to preserve this module's byte-identical string-matching behavior. */
 function liveTail(text, tailLines) {
-    const lines = text.split('\n').map(l => l.trim()).filter(Boolean);
-    return lines.slice(-tailLines).join('\n');
+    return sharedLiveTail(text, tailLines).join('\n');
 }
 function anyMatch(text, patterns) {
     for (const p of patterns)

package/dist/monitoring/StuckSignatureClassifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"StuckSignatureClassifier.js","sourceRoot":"","sources":["../../src/monitoring/StuckSignatureClassifier.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"StuckSignatureClassifier.js","sourceRoot":"","sources":["../../src/monitoring/StuckSignatureClassifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAgBjE;;;;;gFAKgF;AAChF,MAAM,wBAAwB,GAAsB;IAClD,8DAA8D;IAC9D,sBAAsB;IACtB,yCAAyC;IACzC,mCAAmC,EAAI,yCAAyC;CACjF,CAAC;AAEF;8EAC8E;AAC9E,MAAM,8BAA8B,GAAsB;IACxD,gCAAgC;IAChC,8CAA8C;IAC9C,0CAA0C;CAC3C,CAAC;AAEF;2EAC2E;AAC3E,MAAM,+BAA+B,GAAsB;IACzD,yBAAyB;IACzB,gCAAgC;IAChC,gCAAgC;IAChC,sBAAsB;CACvB,CAAC;AAEF;;yFAEyF;AACzF,SAAS,QAAQ,CAAC,IAAY,EAAE,SAAiB;IAC/C,OAAO,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,QAA2B;IACzD,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,CAAC,GACL,uDAAuD,CAAC,IAAI,CAAC,IAAI,CAAC;QAClE,mEAAmE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjF,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACrC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAe,EACf,SAAS,GAAG,EAAE;IAEd,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAE1C,wEAAwE;IACxE,2EAA2E;IAC3E,0DAA0D;IAC1D,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,KAAK,KAAK,eAAe,EAAE,CAAC;QAC9B,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,OAAO,EACL,sFAAsF;gBACtF,iEAAiE;SACpE,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,KAAK,oBAAoB,EAAE,CAAC;QACnC,OAAO;YACL,IAAI,EAAE,eAAe;YACrB,OAAO,EACL,0EAA0E;gBAC1E,gEAAgE;SACnE,CAAC;IACJ,CAAC;IAED,wEAAwE;IACxE,2CAA2C;IAC3C,IAAI,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,OAAO,EACL,qEAAqE;gBACrE,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjC,iFAAiF;YACnF,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;SAC5C,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,wEAAwE;IACxE,4EAA4E;IAC5E,oDAAoD;IACpD,IAAI,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC,EAAE,CAAC;QACvG,OAAO;YACL,IAAI,EAAE,kBAAkB;YACxB,OAAO,EACL,0GAA0G;gBAC1G,wDAAwD;SAC3D,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "1.3.664",
+  "version": "1.3.665",
   "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-06-25T10:17:36.090Z",
-  "instarVersion": "1.3.664",
+  "generatedAt": "2026-06-25T18:41:44.708Z",
+  "instarVersion": "1.3.665",
   "entryCount": 202,
   "entries": {
     "hook:session-start": {
@@ -1538,7 +1538,7 @@
       "type": "subsystem",
       "domain": "sessions",
       "sourcePath": "src/core/SessionManager.ts",
-      "contentHash": "7ea591c3a48b752c066a2fdf0179804a6319177b3664bde1bcc20d9fc0a0d508",
+      "contentHash": "d6bacb543ff87514a6a650bce3269c4d6377b1b411ef0f651fdb88d196d11717",
       "since": "2025-01-01"
     },
     "subsystem:auto-updater": {

package/upgrades/1.3.665.md

@@ -0,0 +1,68 @@
+# Upgrade Guide — vNEXT
+
+<!-- assembled-by: assemble-next-md -->
+<!-- bump: patch -->
+
+## What Changed
+
+CMT-1785: the idle-error detector that decides "did this paused session stall on a transient API
+error (nudge it) or stop normally (leave it)?" is migrated from a brittle bare-substring scan to a
+tail-gated, frame-discriminated SIGNAL.
+
+- New pure modules `src/core/paneTail.ts` (shared `liveTail`/`stripLineLead`/`wasGlyphLed` — ONE
+  definition of "the live tail", extracted so it is no longer copied per consumer) and
+  `src/core/IdleErrorClassifier.ts` (`classifyIdleError`).
+- The old gate `TERMINAL_ERROR_PATTERNS.some(p => recentOutput.includes(p))` (a bare `.includes()`
+  over the whole capture) is replaced by `classifyIdleError`, which fires only when a terminal-error
+  token sits in the live tail (last 20 non-empty lines) on a Claude-EMITTED error frame — a two-tier
+  begins-with rule: **Tier A** the line begins with `API Error:`; **Tier B** the line is glyph-led
+  (`⏺`/`⎿`/…) and begins with one of the 11 patterns. The match set is a strict subset of the old
+  buffer-wide match, so the change can only SUPPRESS spurious fires, never add one.
+- The idle-error capture is widened 30→45 rows (`RATE_LIMIT_SETTLED_CAPTURE_LINES`): Claude Code's
+  input box + footer render 15-25 rows BELOW the error, so a 30-row capture could miss it entirely.
+- `StuckSignatureClassifier` is migrated onto the shared `liveTail` (behavior-preserving via
+  `.join('\n')`; its existing test corpus is the characterization guard).
+- A once-per-idle-episode structured record (`{event:'idle-error-classify', result:'fired'|'suppressed', …}`)
+  lands in `logs/server.log` so a wave of suppressions on genuine errors (the under-fire risk) is
+  observable. Cleared in both the re-arm block and `sessionComplete` (no leak on the death path).
+
+The signal still feeds the existing `apiErrorAtIdle` → `rateLimitSentinel` recovery actuator and gains
+no blocking authority (Signal vs Authority).
+
+## What to Tell Your User
+
+Nothing you need to do. Under the hood, the agent got more reliable at telling a session that genuinely
+stalled on an API error (which it nudges back to life) apart from one that's merely *showing* an old or
+quoted error on screen. The old check was a blunt text search that sometimes kicked off a needless
+recovery on a healthy session, and — more importantly — sometimes read too little of the screen and
+missed a real stall. The new check looks at the live bottom of the screen, reads enough of it to clear
+the input box, and only counts a line the tool actually emitted as an error. Net: fewer false recoveries
+AND fewer missed real ones, so paused sessions get the right treatment faster. No new setting; behavior
+is otherwise unchanged, and it's a one-line revert if ever needed.
+
+## Summary of New Capabilities
+
+- `paneTail` + `IdleErrorClassifier` — a precise, tail-gated, frame-discriminated idle-error signal
+  replacing the bare buffer-wide substring scan; widened capture (45 rows) so the input-box chrome can
+  no longer hide a real error; structured once-per-episode observability of fired-vs-suppressed
+  decisions. Internal robustness improvement to session-stall recovery; no user-facing surface to
+  configure.
+
+## Evidence
+
+- `tests/unit/IdleErrorClassifier.test.ts` (28) — both sides of every boundary, pinned to REAL captured
+  render fixtures: fires on `⏺ API Error:` / `  ⎿  API Error:` / glyph-led network tokens / wrapped
+  errors; suppresses stale-scrollback, prose mentions, quoted source literals (the self-collision case),
+  a tool's own `Error: …ECONNREFUSED`; the 45-vs-30 input-box-chrome capture test; parametrized over all
+  11 patterns; bounded audit fields; paneTail helpers.
+- `tests/integration/idle-error-classifier-production-wiring.test.ts` (7) — the REAL exported
+  `TERMINAL_ERROR_PATTERNS` produce correct decisions on real panes; the SessionManager call-site is
+  wired to the classifier, the 45-row capture, the dual once-per-episode clears, and the structured record.
+- `tests/e2e/idle-error-classifier-lifecycle.test.ts` (2) — the real SessionManager constructs and the
+  `apiErrorAtIdle` recovery handoff is attachable; the production-pattern live decision is correct.
+- `tests/unit/monitoring/StuckSignatureClassifier.test.ts` (13) — unchanged, the characterization guard
+  proving the shared-`liveTail` migration is behavior-preserving.
+- `npm run build` + `tsc --noEmit` clean; full unit suite green.
+- Driven by the converged + approved spec; convergence report at
+  `docs/specs/reports/idle-error-tailgate-corroboration-convergence.md` (4 rounds; the review caught a
+  CRITICAL under-fire-on-the-common-error-form flaw before any code).

package/upgrades/side-effects/idle-error-tailgate-corroboration.md

@@ -0,0 +1,65 @@
+# Side-Effects Review — Idle-Error Detection: Tail-Gated, Frame-Discriminated Signal (CMT-1785)
+
+Spec: `docs/specs/idle-error-tailgate-corroboration.md` (converged 4 rounds, approved).
+Change: replace the bare `TERMINAL_ERROR_PATTERNS.some(includes)` idle-error detector at the
+`SessionManager` idle path with a tail-gated, frame-discriminated classifier (`IdleErrorClassifier`)
+fed by a shared `paneTail` helper; widen the idle-error capture 30→45 rows; add a once-per-episode
+structured observability record.
+
+## 1. Over-block (what legitimate inputs does this reject that it shouldn't?)
+The classifier can SUPPRESS a fire the old bare match would have made — that is the whole point —
+but the risk is suppressing a GENUINE error (under-fire). Mitigated: (a) the two-tier begins-with
+grammar fires on real Claude render forms (`⏺ API Error:` / `  ⎿  API Error:`), pinned by tests using
+the actual captured fixtures; (b) the 45-row capture clears the input-box chrome that pushes the
+error up; (c) the 20-line non-empty tail clears realistic chrome with margin; (d) a missed error
+falls through to the pre-existing 15m idle-kill (slower recovery, never silent loss); (e) the
+`result:'suppressed'` structured record makes a wave of real misses observable.
+
+## 2. Under-block (what failure modes does it still miss?)
+- A genuine Claude error rendered in a form that is neither `API Error:`-led nor a glyph-led
+  begins-with-pattern line (unknown future render) → missed → 15m idle-kill fallback. The drift
+  test fails loudly if the known render fixtures stop matching.
+- A residual false-POSITIVE (accepted): a tool result rendered glyph-led whose line begins with a
+  terminal token (e.g. `⎿ fetch failed`) fires. Bounded: the actuator is non-destructive (one wasted
+  nudge the verify step proves a no-op). Documented in the spec §5.
+
+## 3. Level-of-abstraction fit
+Correct layer: this is a deterministic SIGNAL-emitter (Signal vs Authority), feeding the existing
+`apiErrorAtIdle` → `rateLimitSentinel` recovery actuator. It gains no blocking authority. The shared
+`paneTail` helper is the right home for the tail-gating logic (was being copied per consumer). The
+recovery actuator it feeds is honestly named a deterministic Tier-0 non-destructive self-heal (nudge
+→ verify → escalate-to-notice + zombie-kill veto; no respawn).
+
+## 4. Signal vs authority compliance
+Compliant. The classifier returns a boolean SIGNAL; the actuator decides and verifies before any
+action. The match set is a strict subset of the old buffer-wide match (tail + frame ⊂ buffer-wide),
+so the change is monotonic-suppressing — it can only reduce spurious actuations, never add one.
+
+## 5. Interactions
+- The `detectRateLimited` branch runs FIRST and is untouched — a server throttle still routes to
+  `rateLimitedAtIdle` and never reaches the classifier (pinned by the wiring test's intent; the
+  branch order is preserved). The wider 45-row capture is a no-op for `detectRateLimited` (it slices
+  its own last ~20 lines).
+- `errorNudgedSessions` (the nudge episode guard) is unchanged; the new `idleErrorClassified` set
+  mirrors its full lifecycle (armed once/episode; cleared in BOTH the re-arm block AND
+  `sessionComplete` — no leak on the session-death path).
+- `StuckSignatureClassifier` migrates to the shared `liveTail` via `.join('\n')` — behavior-preserving
+  (its existing 13-test corpus passes unchanged = the characterization guard).
+
+## 6. External surfaces
+None new. No HTTP route, no config, no agent-installed file, no user-facing message. The only new
+output is structured `console.log` records to `logs/server.log` (operator log), once per idle episode,
+credential-free (matchedPattern is a fixed token; no raw pane content is logged).
+
+## 7. Multi-machine posture (Cross-Machine Coherence)
+Machine-local BY DESIGN. The classifier reads one local tmux pane on the host running the session —
+no cross-machine state, no generated URL, no replicated surface. The downstream `rateLimitSentinel`
+has a Telegram-notify surface, but the change is monotonic-suppressing, so it can only REDUCE
+user-facing cross-machine notices, never add one. Correct posture, declared explicitly.
+
+## 8. Rollback cost
+Single-commit revert: restore the bare `.some(includes)` gate + the 30-row capture, delete
+`IdleErrorClassifier.ts` + `paneTail.ts` + tests + the `idleErrorClassified` field/clears + the
+structured record, and revert the `StuckSignatureClassifier` import (behavior-preserving, mechanical).
+No migration, no durable state, no config. The revert IS the immediate operator action if a future
+Claude render change is ever suspected of under-firing.