instar 0.28.102 → 0.28.103

package/dist/monitoring/DegradationReporter.js

@@ -30,6 +30,9 @@ import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
 import { detectJargon } from '../core/JargonDetector.js';
+import { Redactor } from './Redactor.js';
+import { ErrorCodeExtractor } from './ErrorCodeExtractor.js';
+import { SafeFsExecutor } from '../core/SafeFsExecutor.js';
 /**
  * Safe fallback template used when the tone gate blocks the candidate
  * health-alert message. Plain English, ends with a yes/no the user can
@@ -38,6 +41,30 @@ import { detectJargon } from '../core/JargonDetector.js';
 const SAFE_HEALTH_ALERT_TEMPLATE = 'Something on my end stopped working and I haven\'t been able to fix it on my own. Want me to dig in?';
 // How long before the same feature can trigger another Telegram alert (ms)
 const ALERT_COOLDOWN_MS = 60 * 60 * 1000; // 1 hour
+/**
+ * Monotonic timestamp source. Prefers `performance.now()` (high-resolution,
+ * monotonic across process lifetime). Falls back to `Date.now()` on
+ * environments that don't expose it. Returns a Number, not a bigint, so
+ * the value JSON-serializes cleanly into the durable queue.
+ */
+function monotonicNow() {
+    try {
+        if (typeof performance !== 'undefined' && typeof performance.now === 'function') {
+            return performance.now();
+        }
+    }
+    catch { /* environments without performance API */ }
+    return Date.now();
+}
+// Durable RestartPending queue caps (per §A5). When `_setRestartPending(true)`
+// is asserted (e.g., by the lifeline supervisor staging a restart), incoming
+// events are appended to a JSONL queue instead of dispatched immediately.
+// Drop-and-counter on overflow — older events stay on disk, new events past
+// the cap increment a counter and are discarded so the queue can't grow
+// unbounded during a long restart-pending window.
+const RESTART_QUEUE_MAX_ENTRIES = 1000;
+const RESTART_QUEUE_MAX_BYTES = 5 * 1024 * 1024; // 5 MiB
+const RESTART_QUEUE_REL_PATH = path.join('remediation', 'degradations-queue.jsonl');
 export class DegradationReporter {
     static instance = null;
     events = [];
@@ -52,6 +79,24 @@ export class DegradationReporter {
     healers = new Map();
     // Dedup: track last alert time per feature to avoid spamming Telegram
     lastAlertTime = new Map();
+    // F-3 additions ─────────────────────────────────────────────
+    // The Remediator dispatch hook (F-8 wires the consumer). When set, the
+    // legacy `.report(...)` and the new `.reportStructured(...)` both route
+    // their normalized events to `remediator.dispatch()` instead of the
+    // legacy alert path. When unset, the legacy alert path runs unchanged
+    // (backward compat — F-3 ships a shim only, no emit-site migration).
+    remediator = null;
+    // Centralized redactor for the `reason.full → reason.redacted` step.
+    // Lazily instantiated so tests that don't exercise normalization don't pay
+    // the (cheap) construction cost.
+    redactor = null;
+    // RestartPending — when true, events queue to disk instead of dispatching.
+    // Flipped by the lifeline supervisor (or test harness) via _setRestartPending.
+    restartPending = false;
+    // Overflow counter — incremented when the queue cap is hit so we know
+    // how many events were dropped during a restart-pending window. Persisted
+    // alongside the queue file as a sidecar JSON.
+    queueDropCount = 0;
     constructor() { }
     static getInstance() {
         if (!DegradationReporter.instance) {
@@ -104,6 +149,12 @@ export class DegradationReporter {
      *
      * This is the primary API. Call this whenever a fallback activates.
      * If downstream systems aren't ready yet, the event is queued.
+     *
+     * Per spec §A33 (F-3), legacy `.report(...)` callers continue to work
+     * unchanged. Internally the event is normalized via `_normalize()` and
+     * either dispatched to the registered Remediator (if `setRemediator()`
+     * has been called) or sent through the legacy alert path (backward
+     * compat). RestartPending re-routes everything to the durable queue.
      */
     report(event) {
         const full = {
@@ -119,9 +170,157 @@ export class DegradationReporter {
             `  Impact: ${event.impact}`);
         this.events.push(full);
         this.persistToDisk(full);
-        // Try to report immediately if downstream is connected
+        // F-3 path: produce a NormalizedDegradationEvent and either dispatch
+        // it to the Remediator (if set) or queue it (if RestartPending).
+        const normalized = this._normalize(full);
+        if (this.restartPending) {
+            this.enqueueRestartPending(normalized);
+            return;
+        }
+        if (this.remediator) {
+            // Fire-and-forget — dispatch errors land in console.error but never
+            // crash the caller. The legacy `.report(...)` API is sync-shaped.
+            this.remediator.dispatch(normalized).catch((err) => {
+                console.error(`[DEGRADATION] Remediator dispatch failed for ${full.feature}: ${err instanceof Error ? err.message : err}`);
+            });
+            return;
+        }
+        // No Remediator wired — legacy alert path runs unchanged.
         this.reportEvent(full);
     }
+    /**
+     * Report a structured degradation event (F-3 / §A33 go-forward API).
+     *
+     * Callers that have already produced a NormalizedDegradationEvent (e.g.,
+     * via the ErrorCodeExtractor with a verified probe emission) skip the
+     * legacy normalization step. The caller's provenance is preserved verbatim
+     * — F-3 does NOT downgrade structured callers to `free-text`.
+     *
+     * Behaviour:
+     * - Always logged with `[DEGRADATION-NORMALIZED]` prefix for grep-ability.
+     * - If RestartPending → queue to disk.
+     * - Else if Remediator wired → dispatch.
+     * - Else → no consumer (event is recorded but not alerted). Structured
+     *   callers must wire the Remediator (F-8) for it to route anywhere; this
+     *   is intentional, since structured callers bypass the legacy alert path.
+     */
+    reportStructured(event) {
+        const stamped = {
+            ...event,
+            // Preserve caller-provided timestamp/monotonicTs if present; fill if not.
+            timestamp: event.timestamp || new Date().toISOString(),
+            monotonicTs: typeof event.monotonicTs === 'number'
+                ? event.monotonicTs
+                : monotonicNow(),
+        };
+        console.warn(`[DEGRADATION-NORMALIZED] ${stamped.subsystem}: ${stamped.errorCode} (provenance=${stamped.provenance})`);
+        if (this.restartPending) {
+            this.enqueueRestartPending(stamped);
+            return;
+        }
+        if (this.remediator) {
+            this.remediator.dispatch(stamped).catch((err) => {
+                console.error(`[DEGRADATION] Remediator dispatch failed for ${stamped.subsystem}: ${err instanceof Error ? err.message : err}`);
+            });
+        }
+    }
+    /**
+     * Register the Remediator dispatcher (F-8 wires the consumer). When set,
+     * incoming events route to `remediator.dispatch()` instead of the legacy
+     * alert path. Passing `null` clears the hook.
+     *
+     * F-3 only exposes the hook surface — there is no consumer in this PR.
+     */
+    setRemediator(remediator) {
+        this.remediator = remediator;
+    }
+    /**
+     * Internal: convert a legacy `DegradationEvent` into the normalized form.
+     * Public for testability — F-8 / downstream consumers should never call
+     * this directly. Exposed as `_normalize` (leading underscore) per the
+     * project's "private-ish" convention.
+     *
+     * Mapping (per §A33):
+     *   feature   → subsystem
+     *   reason    → reason.full (and .redacted, via Redactor)
+     *   errorCode → extracted via ErrorCodeExtractor from free text → 'LEGACY_DEGRADATION' fallback
+     *   provenance → always 'free-text' (legacy callers are unstructured by definition)
+     *
+     * §A6 forbids matchers against `free-text` provenance — legacy events
+     * therefore route to `no-matching-runbook` once F-8 ships.
+     */
+    _normalize(legacy) {
+        const redactor = this.getRedactor();
+        const { text: redacted } = redactor.redact(legacy.reason);
+        // Attempt errorCode extraction from the legacy reason. Per §A33 the
+        // canonical fallback is the literal 'LEGACY_DEGRADATION' sentinel so
+        // downstream observability can count legacy emit-sites distinctly.
+        const extracted = ErrorCodeExtractor.extract({ freeText: legacy.reason });
+        const errorCode = extracted.code === 'UNKNOWN_ERROR'
+            ? 'LEGACY_DEGRADATION'
+            : extracted.code;
+        return {
+            subsystem: legacy.feature,
+            errorCode,
+            provenance: 'free-text',
+            reason: { redacted, full: legacy.reason },
+            timestamp: legacy.timestamp,
+            monotonicTs: monotonicNow(),
+            legacy,
+        };
+    }
+    /**
+     * Flip the RestartPending flag. When true, incoming events queue to disk
+     * (`<stateDir>/remediation/degradations-queue.jsonl`) instead of being
+     * dispatched. When flipped back to false, the queue replays through the
+     * normal dispatch path.
+     *
+     * Caller contract (per §A5): the lifeline supervisor asserts this flag
+     * during a staged restart window; flips it off once the restart has
+     * completed (or aborted). F-3 exposes the hook; F-8 wires the supervisor.
+     */
+    _setRestartPending(pending) {
+        const prev = this.restartPending;
+        this.restartPending = pending;
+        if (prev && !pending) {
+            // Edge transition true→false: replay queued events.
+            this.replayRestartPendingQueue();
+        }
+    }
+    /**
+     * Read the durable RestartPending queue file. Public for testability /
+     * external observability. Returns an empty array if no queue file exists.
+     */
+    _readRestartPendingQueue() {
+        const queuePath = this.restartQueuePath();
+        if (!queuePath || !fs.existsSync(queuePath))
+            return [];
+        try {
+            const raw = fs.readFileSync(queuePath, 'utf-8');
+            return raw
+                .split('\n')
+                .filter(Boolean)
+                .map((line) => {
+                try {
+                    return JSON.parse(line);
+                }
+                catch {
+                    return null;
+                }
+            })
+                .filter((x) => x !== null);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * How many events were dropped during a RestartPending window because the
+     * queue hit its cap. Persists across the queue's lifetime.
+     */
+    _getQueueDropCount() {
+        return this.queueDropCount;
+    }
     /**
      * Get all degradation events (for health check API).
      */
@@ -328,6 +527,115 @@ export class DegradationReporter {
             }
         }
     }
+    /** Lazily construct the shared Redactor used by `_normalize`. */
+    getRedactor() {
+        if (!this.redactor)
+            this.redactor = new Redactor();
+        return this.redactor;
+    }
+    /**
+     * Absolute path to the RestartPending queue JSONL file. Returns null if
+     * no stateDir is configured — in that case events are dropped (and counted
+     * via `queueDropCount`) since there's nowhere durable to persist them.
+     */
+    restartQueuePath() {
+        if (!this.stateDir)
+            return null;
+        return path.join(this.stateDir, RESTART_QUEUE_REL_PATH);
+    }
+    /**
+     * Append a normalized event to the durable RestartPending queue. Enforces
+     * the §A5 cap (1000 entries / 5 MiB) via drop-and-counter.
+     */
+    enqueueRestartPending(event) {
+        const queuePath = this.restartQueuePath();
+        if (!queuePath) {
+            // No stateDir → no durable surface → count as dropped so callers can
+            // observe the loss via _getQueueDropCount.
+            this.queueDropCount += 1;
+            return;
+        }
+        try {
+            const dir = path.dirname(queuePath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            // Check current size + entry count for the cap.
+            let entryCount = 0;
+            let byteSize = 0;
+            try {
+                const stat = fs.statSync(queuePath);
+                byteSize = stat.size;
+                const raw = fs.readFileSync(queuePath, 'utf-8');
+                entryCount = raw.split('\n').filter(Boolean).length;
+            }
+            catch { /* first write */ }
+            const line = JSON.stringify(event) + '\n';
+            if (entryCount >= RESTART_QUEUE_MAX_ENTRIES || byteSize + line.length > RESTART_QUEUE_MAX_BYTES) {
+                this.queueDropCount += 1;
+                // Sidecar drop-count file so it survives across processes.
+                try {
+                    fs.writeFileSync(queuePath + '.drops.json', JSON.stringify({ dropped: this.queueDropCount, ts: new Date().toISOString() }, null, 2));
+                }
+                catch { /* best-effort */ }
+                return;
+            }
+            fs.appendFileSync(queuePath, line);
+        }
+        catch (err) {
+            // Disk failure inside the durable queue is itself a degradation. Log it
+            // and bump the drop counter — the legacy alert path is unavailable
+            // during RestartPending so there's nothing else to do.
+            console.error(`[DEGRADATION] RestartPending enqueue failed: ${err instanceof Error ? err.message : err}`);
+            this.queueDropCount += 1;
+        }
+    }
+    /**
+     * Replay the durable queue once `_setRestartPending(false)` fires. Each
+     * event is dispatched (or sent through the legacy alert path) in the order
+     * it was enqueued; the queue file is then removed on success.
+     *
+     * Replay is best-effort — if dispatch throws, the queue file is kept on
+     * disk so the next replay attempt can retry. Per §A30 the higher-layer
+     * Remediator dispatcher owns the 5s wall-time cap and coalescing; F-3
+     * does not impose its own.
+     */
+    replayRestartPendingQueue() {
+        const queuePath = this.restartQueuePath();
+        if (!queuePath || !fs.existsSync(queuePath))
+            return;
+        const queued = this._readRestartPendingQueue();
+        if (queued.length === 0) {
+            // Empty / unreadable — clean up the file.
+            try {
+                SafeFsExecutor.safeUnlinkSync(queuePath, {
+                    operation: 'DegradationReporter.replayRestartPendingQueue: empty queue cleanup',
+                });
+            }
+            catch { /* ignore */ }
+            return;
+        }
+        for (const event of queued) {
+            if (this.remediator) {
+                // Fire-and-forget; replay does not wait for individual dispatches.
+                this.remediator.dispatch(event).catch((err) => {
+                    console.error(`[DEGRADATION] Replay dispatch failed for ${event.subsystem}: ${err instanceof Error ? err.message : err}`);
+                });
+            }
+            else if (event.legacy) {
+                // Fall back to the legacy alert path for legacy-shaped queued events.
+                this.reportEvent(event.legacy);
+            }
+        }
+        // Truncate the queue file. We don't delete the drop-count sidecar — it
+        // records cumulative drops across restart windows.
+        try {
+            SafeFsExecutor.safeUnlinkSync(queuePath, {
+                operation: 'DegradationReporter.replayRestartPendingQueue: drain queue after replay',
+            });
+        }
+        catch { /* ignore */ }
+    }
     persistToDisk(event) {
         if (!this.stateDir)
             return;

package/dist/monitoring/DegradationReporter.js.map

@@ -1 +1 @@
-{"version":3,"file":"DegradationReporter.js","sourceRoot":"","sources":["../../src/monitoring/DegradationReporter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DegradationReporter.js","sourceRoot":"","sources":["../../src/monitoring/DegradationReporter.ts"],"names":[],"mappings":"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"}

package/dist/monitoring/ErrorCodeExtractor.d.ts

@@ -0,0 +1,69 @@
+/**
+ * ErrorCodeExtractor — structured errorCode extraction with provenance.
+ *
+ * Owns the contract that NormalizedDegradationEvent.errorCode carries a
+ * provenance tag. Per SELF-HEALING-REMEDIATOR-V2-SPEC.md §A6, runbooks
+ * may only match against events whose errorCode came from a structured
+ * source ("native-binding", "probe-id", "subsystem-explicit"). Free-text
+ * extraction is allowed at the event layer (so events aren't dropped)
+ * but the registry-load-time validator REFUSES to register any runbook
+ * whose eventPrefilter.errorCode matches free-text-provenance events.
+ *
+ * Extraction priority (highest first):
+ *   1. probeEmission with verified signature → "probe-id"
+ *   2. subsystemExplicit                     → "subsystem-explicit"
+ *   3. nativeError.code (Node Error.code)    → "native-binding"
+ *   4. freeText regex extraction             → "free-text"
+ *   5. Fallback                              → "UNKNOWN_ERROR" / "free-text"
+ *
+ * F-2 foundation module — built before any v2 wrapper PR (W-*) so the
+ * provenance contract exists before runbook matchers consume it.
+ */
+export type ErrorProvenance = 'native-binding' | 'probe-id' | 'subsystem-explicit' | 'free-text';
+export interface ExtractedErrorCode {
+    /** Canonical errorCode string, e.g. 'NATIVE_MODULE_ABI_MISMATCH'. */
+    code: string;
+    /** Where the code came from — gates runbook matching. */
+    provenance: ErrorProvenance;
+}
+export interface ProbeEmission {
+    probeId: string;
+    errorCode: string;
+    /** HMAC signature of (probeId|errorCode) — must verify before trust. */
+    signature: string;
+}
+export interface ErrorCodeExtractorInput {
+    /** The original Error object, if available. */
+    nativeError?: unknown;
+    /** Probe-supplied errorCode + signature, if probe-emitted. */
+    probeEmission?: ProbeEmission;
+    /** Subsystem-supplied explicit errorCode, if caller set one. */
+    subsystemExplicit?: string;
+    /** Free-form error text for fallback regex extraction. */
+    freeText?: string;
+    /**
+     * Probe signature verifier. Injected so tests don't need real HMAC keys.
+     * Returns true if the probe emission is trustworthy. If not provided,
+     * probe emissions are treated as unverified and skipped (falling through
+     * to lower-priority sources). Per A6, only verified probe emissions are
+     * allowed to populate provenance: "probe-id".
+     */
+    verifyProbeSignature?: (emission: ProbeEmission) => boolean;
+}
+export declare class ErrorCodeExtractor {
+    /**
+     * Extract a single ExtractedErrorCode following the priority ladder
+     * documented at the top of this file. Always returns a result — never
+     * throws — so callers can normalize unconditionally.
+     */
+    static extract(input: ErrorCodeExtractorInput): ExtractedErrorCode;
+    /**
+     * Used by the runbook registry validator to refuse runbooks whose
+     * `eventPrefilter.errorCode` could match free-text-provenance events
+     * (§A6). Free-text matchers create an injection surface — attacker
+     * shapes error message → forces unintended runbook to fire — and are
+     * structurally forbidden at registry load.
+     */
+    static isAllowedForRunbookMatch(extracted: ExtractedErrorCode): boolean;
+}
+//# sourceMappingURL=ErrorCodeExtractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorCodeExtractor.d.ts","sourceRoot":"","sources":["../../src/monitoring/ErrorCodeExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,MAAM,eAAe,GACvB,gBAAgB,GAChB,UAAU,GACV,oBAAoB,GACpB,WAAW,CAAC;AAEhB,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,UAAU,EAAE,eAAe,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,OAAO,CAAC;CAC7D;AAqDD,qBAAa,kBAAkB;IAC7B;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB;IA4ClE;;;;;;OAMG;IACH,MAAM,CAAC,wBAAwB,CAAC,SAAS,EAAE,kBAAkB,GAAG,OAAO;CAOxE"}

package/dist/monitoring/ErrorCodeExtractor.js

@@ -0,0 +1,131 @@
+/**
+ * ErrorCodeExtractor — structured errorCode extraction with provenance.
+ *
+ * Owns the contract that NormalizedDegradationEvent.errorCode carries a
+ * provenance tag. Per SELF-HEALING-REMEDIATOR-V2-SPEC.md §A6, runbooks
+ * may only match against events whose errorCode came from a structured
+ * source ("native-binding", "probe-id", "subsystem-explicit"). Free-text
+ * extraction is allowed at the event layer (so events aren't dropped)
+ * but the registry-load-time validator REFUSES to register any runbook
+ * whose eventPrefilter.errorCode matches free-text-provenance events.
+ *
+ * Extraction priority (highest first):
+ *   1. probeEmission with verified signature → "probe-id"
+ *   2. subsystemExplicit                     → "subsystem-explicit"
+ *   3. nativeError.code (Node Error.code)    → "native-binding"
+ *   4. freeText regex extraction             → "free-text"
+ *   5. Fallback                              → "UNKNOWN_ERROR" / "free-text"
+ *
+ * F-2 foundation module — built before any v2 wrapper PR (W-*) so the
+ * provenance contract exists before runbook matchers consume it.
+ */
+/**
+ * Free-text fallback patterns. Order matters — more specific patterns
+ * (NODE_MODULE_VERSION, SQLITE_*) run before generic ones so they win.
+ *
+ * NOTE: matchers consuming free-text-provenance results are refused at
+ * registry load (§A6). These patterns exist for observability and for
+ * SystemReviewer clustering (proposing new runbooks), not for matching.
+ */
+const FREE_TEXT_PATTERNS = [
+    {
+        // Node native module ABI mismatches surface NODE_MODULE_VERSION first.
+        pattern: /NODE_MODULE_VERSION\s+\d+/,
+        mapper: () => 'NATIVE_MODULE_ABI_MISMATCH',
+    },
+    {
+        // better-sqlite3 / sqlite3 module errors prefix with SQLITE_*.
+        pattern: /SQLITE_([A-Z0-9]+)/,
+        mapper: (m) => `SQLITE_${m[1]}`,
+    },
+    {
+        pattern: /\b(EACCES|EPERM)\b/,
+        mapper: () => 'PERMISSION_DENIED',
+    },
+    {
+        pattern: /\b(ECONNREFUSED|ECONNRESET)\b/,
+        mapper: () => 'CONNECTION_FAILURE',
+    },
+];
+function extractFromFreeText(text) {
+    for (const { pattern, mapper } of FREE_TEXT_PATTERNS) {
+        const m = pattern.exec(text);
+        if (m)
+            return mapper(m);
+    }
+    return 'UNKNOWN_ERROR';
+}
+/**
+ * Read a `.code` property off a thrown value if present and string-typed.
+ * Node native modules and several stdlib paths set this (`ERR_*`, `EACCES`,
+ * etc.). We trust this field because it comes from a structured property,
+ * not parsed text — hence provenance: "native-binding".
+ */
+function readNativeCode(err) {
+    if (err && typeof err === 'object' && 'code' in err) {
+        const code = err.code;
+        if (typeof code === 'string' && code.length > 0)
+            return code;
+    }
+    return null;
+}
+export class ErrorCodeExtractor {
+    /**
+     * Extract a single ExtractedErrorCode following the priority ladder
+     * documented at the top of this file. Always returns a result — never
+     * throws — so callers can normalize unconditionally.
+     */
+    static extract(input) {
+        // 1. Verified probe emission wins. Without a verifier, probe emissions
+        //    are untrusted (an attacker could shape errorCode by spoofing the
+        //    probe path) so we fall through to the next source.
+        if (input.probeEmission) {
+            const verifier = input.verifyProbeSignature;
+            if (verifier && verifier(input.probeEmission)) {
+                return {
+                    code: input.probeEmission.errorCode,
+                    provenance: 'probe-id',
+                };
+            }
+            // Unverified probe emission — skip and try lower-priority sources.
+            // We don't trust the emission, but we also don't reject the whole
+            // event; the subsystem may still have supplied a structured code.
+        }
+        // 2. Subsystem-explicit errorCode — caller set this with no string
+        //    extraction, so we trust the structured source.
+        if (typeof input.subsystemExplicit === 'string' && input.subsystemExplicit.length > 0) {
+            return {
+                code: input.subsystemExplicit,
+                provenance: 'subsystem-explicit',
+            };
+        }
+        // 3. Native binding: Error.code from Node native modules.
+        const nativeCode = readNativeCode(input.nativeError);
+        if (nativeCode) {
+            return {
+                code: nativeCode,
+                provenance: 'native-binding',
+            };
+        }
+        // 4. Free-text fallback. Always free-text provenance, even when a
+        //    known pattern matches — the input was untrusted parsed text.
+        const freeText = typeof input.freeText === 'string' ? input.freeText : '';
+        return {
+            code: extractFromFreeText(freeText),
+            provenance: 'free-text',
+        };
+    }
+    /**
+     * Used by the runbook registry validator to refuse runbooks whose
+     * `eventPrefilter.errorCode` could match free-text-provenance events
+     * (§A6). Free-text matchers create an injection surface — attacker
+     * shapes error message → forces unintended runbook to fire — and are
+     * structurally forbidden at registry load.
+     */
+    static isAllowedForRunbookMatch(extracted) {
+        return (extracted.provenance === 'native-binding' ||
+            extracted.provenance === 'probe-id' ||
+            extracted.provenance === 'subsystem-explicit');
+    }
+}
+//# sourceMappingURL=ErrorCodeExtractor.js.map

package/dist/monitoring/ErrorCodeExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorCodeExtractor.js","sourceRoot":"","sources":["../../src/monitoring/ErrorCodeExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAyCH;;;;;;;GAOG;AACH,MAAM,kBAAkB,GAAuE;IAC7F;QACE,uEAAuE;QACvE,OAAO,EAAE,2BAA2B;QACpC,MAAM,EAAE,GAAG,EAAE,CAAC,4BAA4B;KAC3C;IACD;QACE,+DAA+D;QAC/D,OAAO,EAAE,oBAAoB;QAC7B,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE;KAChC;IACD;QACE,OAAO,EAAE,oBAAoB;QAC7B,MAAM,EAAE,GAAG,EAAE,CAAC,mBAAmB;KAClC;IACD;QACE,OAAO,EAAE,+BAA+B;QACxC,MAAM,EAAE,GAAG,EAAE,CAAC,oBAAoB;KACnC;CACF,CAAC;AAEF,SAAS,mBAAmB,CAAC,IAAY;IACvC,KAAK,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,kBAAkB,EAAE,CAAC;QACrD,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,GAAY;IAClC,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QACpD,MAAM,IAAI,GAAI,GAAyB,CAAC,IAAI,CAAC;QAC7C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;IAC/D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,OAAO,kBAAkB;IAC7B;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,KAA8B;QAC3C,uEAAuE;QACvE,sEAAsE;QACtE,wDAAwD;QACxD,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,oBAAoB,CAAC;YAC5C,IAAI,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC9C,OAAO;oBACL,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,SAAS;oBACnC,UAAU,EAAE,UAAU;iBACvB,CAAC;YACJ,CAAC;YACD,mEAAmE;YACnE,kEAAkE;YAClE,kEAAkE;QACpE,CAAC;QAED,mEAAmE;QACnE,oDAAoD;QACpD,IAAI,OAAO,KAAK,CAAC,iBAAiB,KAAK,QAAQ,IAAI,KAAK,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtF,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,iBAAiB;gBAC7B,UAAU,EAAE,oBAAoB;aACjC,CAAC;QACJ,CAAC;QAED,0DAA0D;QAC1D,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACrD,IAAI,UAAU,EAAE,CAAC;YACf,OAAO;gBACL,IAAI,EAAE,UAAU;gBAChB,UAAU,EAAE,gBAAgB;aAC7B,CAAC;QACJ,CAAC;QAED,kEAAkE;QAClE,kEAAkE;QAClE,MAAM,QAAQ,GAAG,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,OAAO;YACL,IAAI,EAAE,mBAAmB,CAAC,QAAQ,CAAC;YACnC,UAAU,EAAE,WAAW;SACxB,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,wBAAwB,CAAC,SAA6B;QAC3D,OAAO,CACL,SAAS,CAAC,UAAU,KAAK,gBAAgB;YACzC,SAAS,CAAC,UAAU,KAAK,UAAU;YACnC,SAAS,CAAC,UAAU,KAAK,oBAAoB,CAC9C,CAAC;IACJ,CAAC;CACF"}

package/dist/monitoring/PromptGate.d.ts

@@ -50,6 +50,27 @@ export declare class InputDetector extends EventEmitter {
     private static readonly REJECTED_COOLING_MS;
     /** Track pending LLM detection calls to prevent overlap */
     private pendingLlmDetection;
+    /**
+     * NO_PROMPT classification cache: session → bounded set of recent context
+     * fingerprints already classified by the LLM as not a blocking prompt.
+     *
+     * Without this, an idle session showing the same terminal output across every
+     * monitor tick re-asks the LLM "is this stuck?" every 5 seconds forever,
+     * because the existing rate limit (lastLlmRelay) is only updated on a
+     * successful emit. The cache short-circuits that loop: once we've classified
+     * a given context as NO_PROMPT, we don't re-classify the identical context.
+     * Cache is cleared in onInputSent() and cleanup().
+     */
+    private noPromptCache;
+    private static readonly NO_PROMPT_CACHE_MAX;
+    /**
+     * Per-session cache generation counter. Incremented whenever the cache is
+     * cleared for a session (onInputSent, cleanup). An in-flight llmDetect call
+     * captures the generation at start; if it changes before the call's
+     * recordNoPrompt write, the write is dropped — we don't want a stale
+     * pre-input verdict to repopulate the cache after a clear.
+     */
+    private cacheGeneration;
     constructor(config: InputDetectorConfig);
     /**
      * Called every monitor tick with captured terminal output.
@@ -82,6 +103,19 @@ export declare class InputDetector extends EventEmitter {
      * Clean up stale state for a session that has ended.
      */
     cleanup(sessionName: string): void;
+    /**
+     * Record a NO_PROMPT classification for the given session and context
+     * fingerprint, evicting the oldest entry if the per-session cache exceeds
+     * NO_PROMPT_CACHE_MAX. FIFO is sufficient — these are pure memoizations of
+     * an LLM verdict on a specific terminal-output snapshot.
+     *
+     * Drops the write if the cache generation has advanced since llmDetect
+     * started — that means onInputSent or cleanup fired during the LLM call,
+     * and our verdict was computed against output the session has now moved
+     * past. Without this guard, the post-input cache could get repopulated
+     * with a stale pre-input verdict.
+     */
+    private recordNoPrompt;
     /**
      * Prune expired entries from rejectedFingerprints.
      */