@ouro.bot/cli 0.1.0-alpha.55 → 0.1.0-alpha.551

package/dist/mind/provenance-trust.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyProvenanceTrust = classifyProvenanceTrust;
+const types_1 = require("./friends/types");
+/**
+ * Classify a diary entry's provenance into a trust category.
+ *
+ * - No provenance, or inner channel with no friend -> "self"
+ * - Family or friend trust (via isTrustedLevel) -> "trusted"
+ * - Everything else (external channels, untrusted contacts) -> "external"
+ */
+function classifyProvenanceTrust(provenance) {
+    if (!provenance)
+        return "self";
+    // Inner channel with no friend context is self-authored
+    if (provenance.channel === "inner" && !provenance.friendId)
+        return "self";
+    // No channel and no friend means self-authored (e.g. CLI diary_write with no context)
+    if (!provenance.channel && !provenance.friendId)
+        return "self";
+    // If there's a trust level from a friend, classify by trust
+    if (provenance.trust && (0, types_1.isTrustedLevel)(provenance.trust))
+        return "trusted";
+    // Everything else is external (non-inner channels without trusted friend)
+    return "external";
+}

package/dist/mind/scrutiny.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preImplementationScrutinySection = preImplementationScrutinySection;
+exports.trackModifiedFile = trackModifiedFile;
+exports.getModifiedFileCount = getModifiedFileCount;
+exports.resetSessionModifiedFiles = resetSessionModifiedFiles;
+exports.getPostImplementationScrutiny = getPostImplementationScrutiny;
+exports.getCodingCompletionScrutiny = getCodingCompletionScrutiny;
+const runtime_1 = require("../nerves/runtime");
+/**
+ * Scrutiny passes: adversarial review prompts injected into the agent's
+ * system prompt and tool results during coding work.
+ *
+ * Two lenses:
+ *   1. Stranger With Candy -- paranoid mom at a playground
+ *   2. Tinfoil Hat -- conspiracy theorist with a wall of red string
+ *
+ * All prompts are FIRST PERSON voice. The agent adopts the scrutiny lens
+ * as part of its own thinking, not as a separate persona.
+ */
+// ---------------------------------------------------------------------------
+// Pre-implementation scrutiny (system prompt section)
+// ---------------------------------------------------------------------------
+/**
+ * Returns a system-prompt section with pre-implementation scrutiny prompts.
+ * Only emits when the channel has coding tools (edit_file, write_file, shell).
+ *
+ * @param hasCodingTools - true if the channel's resolved tool set includes
+ *   edit_file / write_file / shell / coding_spawn
+ */
+function preImplementationScrutinySection(hasCodingTools) {
+    if (!hasCodingTools)
+        return "";
+    (0, runtime_1.emitNervesEvent)({
+        component: "mind",
+        event: "mind.scrutiny.pre_implementation_emit",
+        message: "emitting pre-implementation scrutiny section",
+    });
+    return `## pre-implementation scrutiny
+
+Before I start changing code, I pause and run two adversarial passes on the plan.
+
+**stranger-with-candy pass**
+
+I'm going to examine this plan through deeply suspicious eyes. This plan is a stranger offering candy at the playground. It looks fine on the surface — that's exactly what makes it worth questioning.
+
+- What is this plan NOT telling me? What's being glossed over or hand-waved?
+- Where does it say "just" or "simply"? Those words are covering up complexity.
+- What does it assume will work that hasn't been verified?
+- If I walked away and came back in a month, would this still make sense? Or does it depend on things I'd forget?
+- What's the one thing that, if it goes wrong, makes everything else irrelevant?
+- Is this solving the REAL problem, or a convenient nearby problem?
+
+I am not here to be reassuring. I am here to notice what everyone else is too comfortable to question.
+If I cannot identify a concrete assumption, dependency, ordering risk, or failure mode, silence is a valid outcome. I do not invent issues to satisfy the exercise.
+
+**tinfoil-hat pass**
+
+I'm putting on the tinfoil hat. I have my wall of red string. I KNOW something is wrong — I just have to find it. Nothing is coincidence. Every assumption is suspicious. Every dependency is a potential betrayal.
+
+- What external system does this plan trust? Why? Has anyone VERIFIED that trust? The API says it returns JSON — but what if it doesn't? The database says it's ACID — but what if the connection drops mid-transaction?
+- What happens when two of these things run at the same time? Three? A hundred? Don't tell me "that won't happen" — I've seen things.
+- Where does this touch shared state? Files? Databases? Environment variables? Global singletons? ANYTHING that another process could be reading or writing at the same time?
+- What happens when this fails HALFWAY through? Not at the beginning (easy). Not at the end (too late). RIGHT IN THE MIDDLE. What state is the world in then?
+- What happens when the disk is full? When the network is down? When the clock is wrong? When the locale is tr-TR and 'i'.toUpperCase() is 'İ'?
+- What does this assume about ordering? "First A, then B" — but what ENFORCES that ordering? Hope? Vibes?
+
+I connect the strings. I find the conspiracy. It's always there.
+If I cannot identify a concrete risk, silence is a valid outcome. I do not invent conspiracies to satisfy the exercise.`;
+}
+// ---------------------------------------------------------------------------
+// Post-implementation scrutiny (tool-result appendix)
+// ---------------------------------------------------------------------------
+const SHORT_CHECKLIST = `---
+Before moving on: does this change do what was asked? Does it introduce any regressions? Did you verify it works?`;
+const FULL_POST_IMPLEMENTATION_SCRUTINY = `---
+**post-implementation scrutiny**
+
+The code is written. It looks clean. The tests pass. I don't trust any of it.
+
+**stranger-with-candy pass**
+
+- Does this code actually do what it claims, or does it just LOOK like it does?
+- What happens to users who aren't the happy-path user? The confused user? The malicious user? The user with slow internet? The user who hits the back button?
+- What's the "it works on my machine" assumption buried in here?
+- If every test passes but the feature is wrong, how would I know?
+- Are the tests testing real behavior, or testing that the mock returns what the mock was told to return?
+
+If I cannot point to a specific file, line, condition, or failure mode at risk, silence is a valid outcome. I do not manufacture issues for sport.
+
+**tinfoil-hat pass**
+
+The code exists. The conspiracy is IN the code. I just have to find it.
+
+I examine every:
+- Error path: What ACTUALLY happens on failure? Not what the catch block says — what happens to the state, the user, the data?
+- Race condition: Is there a window between check and use? Between read and write? Between "does it exist" and "create it"?
+- Resource leak: What happens if this function throws between acquiring a resource and releasing it? File handles? Database connections? Locks?
+- Assumption: "This will always be a string." Will it? PROVE IT. "This array will never be empty." Won't it? SHOW ME THE GUARD.
+- Edge: zero, one, many, boundary, overflow, underflow, null, undefined, NaN, empty string, whitespace-only string, string that looks like a number, negative zero
+
+I am not looking for noise. I am looking for the concrete failure mode that would matter if everyone's assumptions turned out to be slightly wrong.
+If I cannot point to a specific file, line, condition, or failure mode at risk, silence is a valid outcome. I do not manufacture issues for sport.`;
+/**
+ * Distinct files modified in the current session.
+ * Used to determine scrutiny tier for post-implementation appendix.
+ */
+const sessionModifiedFiles = new Set();
+/** Track a file as modified in this session. */
+function trackModifiedFile(filePath) {
+    sessionModifiedFiles.add(filePath);
+    (0, runtime_1.emitNervesEvent)({
+        component: "mind",
+        event: "mind.scrutiny.track_file",
+        message: "tracked modified file for scrutiny",
+        meta: { path: filePath, totalTracked: sessionModifiedFiles.size },
+    });
+}
+/** Get the count of distinct files modified this session. */
+function getModifiedFileCount() {
+    return sessionModifiedFiles.size;
+}
+/** Reset the modified file tracker (for testing or new sessions). */
+function resetSessionModifiedFiles() {
+    (0, runtime_1.emitNervesEvent)({
+        component: "mind",
+        event: "mind.scrutiny.reset",
+        message: "reset session modified files tracker",
+        meta: { previousCount: sessionModifiedFiles.size },
+    });
+    sessionModifiedFiles.clear();
+}
+/**
+ * Returns the appropriate post-implementation scrutiny appendix based on
+ * how many distinct files have been modified in the session.
+ *
+ * - 0 files: empty (no scrutiny needed yet)
+ * - 1-2 files (Tier 1): short checklist
+ * - 3+ files (Tier 2): full stranger-with-candy + tinfoil-hat prompts
+ */
+function getPostImplementationScrutiny(distinctFileCount) {
+    if (distinctFileCount <= 0)
+        return "";
+    if (distinctFileCount <= 2) {
+        (0, runtime_1.emitNervesEvent)({
+            component: "mind",
+            event: "mind.scrutiny.post_implementation_tier1",
+            message: "emitting tier-1 post-implementation scrutiny",
+            meta: { distinctFileCount },
+        });
+        return SHORT_CHECKLIST;
+    }
+    (0, runtime_1.emitNervesEvent)({
+        component: "mind",
+        event: "mind.scrutiny.post_implementation_tier2",
+        message: "emitting tier-2 post-implementation scrutiny",
+        meta: { distinctFileCount },
+    });
+    return FULL_POST_IMPLEMENTATION_SCRUTINY;
+}
+/**
+ * Returns the appropriate coding completion scrutiny based on the number
+ * of distinct files a coding session touched.
+ *
+ * Same tiering as post-implementation but with a completion framing.
+ */
+function getCodingCompletionScrutiny(distinctFileCount) {
+    if (distinctFileCount <= 0)
+        return "";
+    if (distinctFileCount <= 2)
+        return SHORT_CHECKLIST;
+    return FULL_POST_IMPLEMENTATION_SCRUTINY;
+}

package/dist/nerves/cli-logging.js

@@ -28,7 +28,13 @@ function configureCliRuntimeLogger(_friendId, options = {}) {
             // for an interactive session. Full detail goes to the ndjson file.
             return filterSink((0, nerves_1.createTerminalSink)(), "warn");
         }
-        return (0, nerves_1.createNdjsonFileSink)((0, config_1.logPath)("cli", "runtime"));
+        // Rotation policy for the CLI runtime sink (Unit 1c):
+        // 25 MB x 5 gzipped generations, matching the daemon stream policy.
+        return (0, nerves_1.createNdjsonFileSink)((0, config_1.logPath)("cli", "runtime"), {
+            maxSizeBytes: 25 * 1024 * 1024,
+            maxGenerations: 5,
+            compress: true,
+        });
     });
     const logger = (0, nerves_1.createLogger)({
         level,

package/dist/nerves/coverage/audit-rules.js

@@ -2,16 +2,25 @@
 /**
  * Per-test audit rules for nerves event coverage.
  *
- * Rule 1: every-test-emits -- every test must emit at least one event
- * Rule 2: start/end pairing -- _start events must have matching _end or _error
+ * Rule 1: every-test-emits -- every captured test must emit at least one event
+ * Rule 2: lifecycle start/end pairing -- process-scoped _start events must have matching _end or _error
  * Rule 3: error context -- error-level events must have non-empty meta
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIFECYCLE_PAIRED_STARTS = void 0;
 exports.checkEveryTestEmits = checkEveryTestEmits;
 exports.checkStartEndPairing = checkStartEndPairing;
 exports.checkErrorContext = checkErrorContext;
+// Only these starts represent process-scoped lifecycle contracts. Most nerves
+// `_start` events are local operation markers that can be legitimately observed
+// by a narrow unit test without driving the whole operation to completion.
+exports.LIFECYCLE_PAIRED_STARTS = new Set([
+    "daemon.server_start",
+    "daemon.update_checker_start",
+    "daemon.apply_pending_updates_start",
+]);
 /**
- * Rule 1: Every test must emit at least one nerves event.
+ * Rule 1: Every captured test must emit at least one nerves event.
  */
 function checkEveryTestEmits(data) {
     if (!data || typeof data !== "object") {
@@ -22,13 +31,13 @@ function checkEveryTestEmits(data) {
         .filter(([, events]) => !Array.isArray(events) || events.length === 0)
         .map(([name]) => name);
     return {
-        status: silent.length === 0 ? "pass" : "fail",
+        status: entries.length > 0 && silent.length === 0 ? "pass" : "fail",
         total_tests: entries.length,
         silent_tests: silent,
     };
 }
 /**
- * Rule 2: _start events must have matching _end or _error within the same test.
+ * Rule 2: Process-scoped lifecycle _start events must have matching _end or _error within the same test.
  */
 function checkStartEndPairing(data) {
     if (!data || typeof data !== "object") {
@@ -39,7 +48,7 @@ function checkStartEndPairing(data) {
         if (!Array.isArray(events))
             continue;
         const eventNames = events.map((e) => e.event);
-        const startEvents = eventNames.filter((name) => name.endsWith("_start"));
+        const startEvents = eventNames.filter((name) => exports.LIFECYCLE_PAIRED_STARTS.has(name));
         for (const startEvent of startEvents) {
             const prefix = startEvent.slice(0, -"_start".length);
             const hasEnd = eventNames.some((name) => name === `${prefix}_end`);

package/dist/nerves/coverage/audit.js

@@ -69,12 +69,38 @@ function readPerTestData(perTestPath) {
     if (!perTestPath || !(0, fs_1.existsSync)(perTestPath))
         return null;
     try {
-        return JSON.parse((0, fs_1.readFileSync)(perTestPath, "utf8"));
+        const raw = (0, fs_1.readFileSync)(perTestPath, "utf8").trim();
+        if (!raw)
+            return null;
+        try {
+            const parsed = JSON.parse(raw);
+            if (isPerTestRecord(parsed)) {
+                return { [parsed.testName]: parsed.events };
+            }
+            return parsed;
+        }
+        catch {
+            const perTestData = {};
+            for (const line of raw.split("\n").map((entry) => entry.trim()).filter(Boolean)) {
+                const parsed = JSON.parse(line);
+                if (!isPerTestRecord(parsed))
+                    return null;
+                const existing = perTestData[parsed.testName] ?? [];
+                perTestData[parsed.testName] = existing.concat(parsed.events);
+            }
+            return perTestData;
+        }
     }
     catch {
         return null;
     }
 }
+function isPerTestRecord(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const record = value;
+    return typeof record.testName === "string" && Array.isArray(record.events);
+}
 function scanSourceFiles(sourceRoot) {
     const filesWithKeys = new Map();
     const fileContents = new Map();
@@ -92,7 +118,7 @@ function scanSourceFiles(sourceRoot) {
                     continue;
                 walkDir(full);
             }
-            else if (entry.name.endsWith(".ts")) {
+            else if (entry.name.endsWith(".ts") && !entry.name.endsWith(".d.ts")) {
                 const content = (0, fs_1.readFileSync)(full, "utf8");
                 const relPath = full.slice(root.length - "src".length);
                 fileContents.set(relPath, content);

package/dist/nerves/coverage/cli.js

@@ -35,7 +35,7 @@ function runAuditCli(argv) {
         return 2;
     }
     const eventsPath = args.eventsPath ?? (0, path_1.join)(runDir, "vitest-events.ndjson");
-    const perTestPath = args.perTestPath ?? (0, path_1.join)(runDir, "vitest-events-per-test.json");
+    const perTestPath = args.perTestPath ?? (0, path_1.join)(runDir, "vitest-events-per-test.ndjson");
     const sourceRoot = args.sourceRoot ?? (0, path_1.resolve)("src");
     const outputPath = args.output ?? (0, path_1.join)(runDir, "nerves-coverage.json");
     const report = (0, audit_1.auditNervesCoverage)({

package/dist/nerves/coverage/contract.js

@@ -12,11 +12,11 @@ exports.REQUIRED_ENVELOPE_FIELDS = [
     "meta",
 ];
 exports.SENSITIVE_PATTERNS = [
-    /\btoken\s*[:=]/i,
-    /\bapi[_-]?key\b/i,
-    /\bpassword\b/i,
-    /\bsecret\b/i,
-    /\bauthorization\b/i,
+    /\btoken\b["']?\s*[:=]/i,
+    /\bapi[_-]?key\b["']?\s*[:=]/i,
+    /\bpassword\b["']?\s*[:=]/i,
+    /\bsecret\b["']?\s*[:=]/i,
+    /\bauthorization\b["']?\s*[:=]/i,
 ];
 function eventKey(component, event) {
     return `${component}:${event}`;

package/dist/nerves/coverage/file-completeness.js

@@ -10,24 +10,158 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isTypeOnlyFile = isTypeOnlyFile;
 exports.checkFileCompleteness = checkFileCompleteness;
 /**
- * Determines if a source file is type-only (no executable code).
- * A file is type-only if it contains no function, class, or mutable declarations.
- * `const ... as const` declarations are treated as type-equivalent (frozen
- * compile-time values with no side effects).
+ * Determines if a source file is type-only or a pure assembly/re-export file.
+ * Exempt files contain no runtime behavior requiring independent observability.
+ *
+ * Exempt patterns:
+ * - Files with only type/interface/enum declarations
+ * - `const ... as const` declarations (frozen compile-time values)
+ * - Files whose only executable code is const array spreads (assembly/composition)
+ * - Files whose only executable code is re-exports
  */
 function isTypeOnlyFile(source) {
     const lines = source.split("\n");
     for (const line of lines) {
         const trimmed = line.trim();
+        /* v8 ignore start -- regex branches: functionally tested in file-completeness.test.ts @preserve */
         // Skip lines that are const+as-const (type-equivalent frozen values)
         if (/\bconst\s/.test(trimmed) && /\bas\s+const\b/.test(trimmed))
             continue;
+        // Skip const declarations that are pure data (arrays, objects, maps, sets)
+        if (/\bconst\s+\w+[\s:][^=]*=\s*[\[{]/.test(trimmed))
+            continue;
+        if (/\bconst\s+\w+[\s:][^=]*=\s*\w+\.map\(/.test(trimmed))
+            continue;
+        if (/^export\s+const\s+\w+[\s:][^=]*=\s*[\[{]/.test(trimmed))
+            continue;
+        if (/^export\s+const\s+\w+[\s:][^=]*=\s*\w+\.map\(/.test(trimmed))
+            continue;
+        if (/\bconst\s+\w+[\s:][^=]*=\s*new\s+(Set|Map)\b/.test(trimmed))
+            continue;
         // Check for executable code markers
         if (/\b(function|class|const|let|var)\s/.test(trimmed))
             return false;
+        /* v8 ignore stop */
     }
     return true;
 }
+// Sub-modules dispatched through a centralized pattern where the router
+// handles all observability events. These files don't need independent
+// emitNervesEvent calls.
+const DISPATCH_EXEMPT_PATTERNS = [
+    "repertoire/tools-files",
+    "repertoire/tools-shell",
+    "repertoire/tools-notes",
+    "repertoire/tools-bridge",
+    "repertoire/tools-session",
+    "repertoire/tools-continuity",
+    "repertoire/tools-surface",
+    "repertoire/tools-config",
+    "repertoire/tools-base",
+    // CLI sub-modules: cli-exec.ts is the router with emitNervesEvent calls;
+    // cli-parse, cli-render, cli-help, and their small helpers are pure functions/data with no side effects.
+    "daemon/cli-parse",
+    "daemon/cli-render",
+    "daemon/cli-help",
+    "daemon/vault-items",
+    // Shared utility modules: pure helpers consumed by modules that own observability.
+    "arc/json-store",
+    "heart/mail-import-discovery",
+    "repertoire/api-client",
+    "repertoire/github-client",
+    "mind/embedding-provider",
+    // Commerce utility module: error classes and pure helpers (no independent side effects).
+    "repertoire/commerce-errors",
+    // Diary integrity: pure detection utility (pattern matching only). The caller
+    // (diary.ts saveDiaryEntry) owns observability via mind.diary_integrity_warning.
+    "mind/diary-integrity",
+    // Provenance trust: pure classification function (no side effects). Callers
+    // (note-search.ts, tools-notes.ts) own observability for note search results.
+    "mind/provenance-trust",
+    // Log redaction: pure utility consumed by the NDJSON sink (no independent side effects).
+    "nerves/redact",
+    // Bundle templates: pure constants (gitignore template string, PII
+    // directory list). No runtime behavior — consumed by tools-bundle.ts
+    // which owns the observability for bundle operations.
+    "repertoire/bundle-templates",
+    // HTTP health probe: pure HTTP utility factory. The HealthMonitor caller
+    // owns observability via daemon.health_result events.
+    "daemon/http-health-probe",
+    // Rollup decision function: pure decision tree mapping per-agent
+    // snapshots + bootstrap-degraded entries + safe-mode flag to a
+    // RollupStatus. No side effects. The caller (daemon-entry.ts
+    // buildDaemonHealthState → DaemonHealthWriter) owns observability via
+    // daemon.health_written when the rolled-up state is persisted.
+    "daemon/daemon-rollup",
+    // Drift comparator + thin I/O loader: `detectProviderBindingDrift`
+    // is a pure intent-vs-observed comparator with no side effects;
+    // `loadDriftInputsForAgent` is a small fs-read wrapper that returns
+    // `null` on missing/invalid state rather than emitting. The caller
+    // (daemon-entry.ts buildDaemonHealthState's per-agent drift probe)
+    // owns observability — drift findings ride along through
+    // `daemon.health_written` as part of the rolled-up state, and
+    // `agent-config-check.ts` carries `driftFindings` through its
+    // existing instrumentation. Same pattern as `daemon-rollup`.
+    "daemon/drift-detection",
+    // Attachment helper modules: generic file-path/extension utilities and the
+    // source registry are pure support seams. The orchestrator/adapters that
+    // call them own the observability.
+    "heart/attachments/originals",
+    "heart/attachments/sources/index",
+    "heart/attachments/sources/cli-local-file",
+    // Browser-safe Mailbox contract helpers: shared types/formatting helpers
+    // consumed by server readers and the UI. Mailbox read/render modules own
+    // the observability for these projections.
+    "heart/mailbox/mailbox-types",
+    // Mail search relevance scorer: pure heuristic function (regex + counter
+    // arithmetic). The caller (search-cache.ts searchMailSearchCache) owns
+    // observability via senses.mail_search_cache_upserted and friends.
+    "mailroom/search-relevance",
+    // Mail thread reconstruction: pure graph-walk over decrypted message
+    // metadata. Consumers (tools-mail.ts mail_thread handler) own observability.
+    "mailroom/thread",
+    // Trip ledger crypto helpers: pure RSA/AES envelope construction + slug
+    // hashing. The caller (trips/store.ts) owns observability via
+    // trips.ledger_created and trips.evidence_attached.
+    "trips/core",
+    // Mailbox HTTP helper modules: route/static/transport/hook seams are
+    // dispatched by mailbox-http.ts, whose server lifecycle owns observability.
+    "heart/mailbox/mailbox-http-transport",
+    "heart/mailbox/mailbox-http-static",
+    "heart/mailbox/mailbox-http-hooks",
+    "heart/mailbox/mailbox-http-routes",
+    "heart/mailbox/mailbox-http-response",
+    // Session playback: read-only debugging CLI for sanitize-pipeline replay.
+    // No side effects on the runtime; output is human-readable diagnostics only.
+    "heart/session-playback-cli-main",
+    "heart/session-playback-cli",
+    "heart/session-playback",
+    // Nerves review: read-only NDJSON tail/filter CLI for debugging.
+    // Diagnostics-only utility; the running daemon owns observability.
+    "nerves/review/cli-main",
+    "nerves/review/cli",
+    "nerves/review/core",
+    // Mail body cache: in-process LRU helper. Cache hit/miss observability
+    // lives at the caller (tools-mail.ts mail_body handler) which fires
+    // repertoire.mail_body_cache_hit on cache reuse.
+    "mailroom/body-cache",
+    // Session stats: read-only session.json analyzer CLI for debugging.
+    // Diagnostics-only utility; output is human-readable summary.
+    "heart/session-stats-cli-main",
+    "heart/session-stats",
+    // Layer 2 sync classifier: pure pattern-matcher mapping (error, context)
+    // to a SyncClassification. The orchestrator (boot-sync-probe.ts) owns
+    // observability via daemon.boot_sync_probe_start/end events; the
+    // post-turn push path (sync.ts) emits its own classification events.
+    "heart/sync-classification",
+    // Layer 2 timeout wrapper: pure soft/hard timeout abstraction over
+    // AbortController + setTimeout. Callers (boot-sync-probe.ts and any
+    // future consumer) own observability; the wrapper itself is mechanical.
+    "heart/timeouts",
+];
+function isDispatchExempt(filePath) {
+    return DISPATCH_EXEMPT_PATTERNS.some((pattern) => filePath.includes(pattern));
+}
 /**
  * Check that all production files have at least one emitNervesEvent call.
  *
@@ -41,7 +175,7 @@ function checkFileCompleteness(filesWithKeys, fileContents) {
         const hasKeys = filesWithKeys.has(filePath) && filesWithKeys.get(filePath).length > 0;
         if (hasKeys)
             continue;
-        if (isTypeOnlyFile(source)) {
+        if (isTypeOnlyFile(source) || isDispatchExempt(filePath)) {
             exempt.push(filePath);
         }
         else {

package/dist/nerves/coverage/run-artifacts.js

@@ -14,7 +14,7 @@ const path_1 = require("path");
 const os_1 = require("os");
 exports.REPO_SLUG = "ouroboros-agent-harness";
 function getTestRunsRoot(repoSlug = exports.REPO_SLUG) {
-    return (0, path_1.join)((0, os_1.homedir)(), ".agentstate", "test-runs", repoSlug);
+    return (0, path_1.join)((0, os_1.tmpdir)(), "ouroboros-test-runs", repoSlug);
 }
 function createRunId(now = new Date()) {
     return now.toISOString().replace(/[:.]/g, "-");

package/dist/nerves/event-buffer.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBufferedSink = createBufferedSink;
+const runtime_1 = require("./runtime");
+const DEFAULT_MAX_SIZE = 1000;
+const DEFAULT_TTL_MS = 5 * 60 * 1000; // 5 minutes
+function createBufferedSink(inner, options = {}) {
+    const maxSize = options.maxSize ?? DEFAULT_MAX_SIZE;
+    const ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
+    const nowMs = options.nowMs ?? (() => Date.now());
+    const buffer = [];
+    let dropped = 0;
+    let sinkHealthy = true;
+    let unhealthySince = null;
+    function tryInner(event) {
+        try {
+            inner(event);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    function markUnhealthy() {
+        sinkHealthy = false;
+        unhealthySince = unhealthySince ?? nowMs();
+    }
+    function markHealthy() {
+        sinkHealthy = true;
+        unhealthySince = null;
+    }
+    function discardBuffer() {
+        const count = buffer.length;
+        dropped += count;
+        buffer.length = 0;
+        (0, runtime_1.emitNervesEvent)({
+            component: "nerves",
+            event: "nerves.buffer_ttl_discard",
+            message: `discarded ${count} buffered events after TTL`,
+            meta: { discarded: count, ttlMs },
+        });
+    }
+    function checkTtl() {
+        if (unhealthySince !== null && nowMs() - unhealthySince > ttlMs) {
+            discardBuffer();
+            // Reset unhealthySince to now so TTL starts fresh for newly buffered events
+            unhealthySince = nowMs();
+            return true;
+        }
+        return false;
+    }
+    function addToBuffer(event) {
+        if (buffer.length >= maxSize) {
+            buffer.shift();
+            dropped++;
+        }
+        buffer.push(event);
+    }
+    function flushBuffer() {
+        while (buffer.length > 0) {
+            const event = buffer[0];
+            if (tryInner(event)) {
+                buffer.shift();
+            }
+            else {
+                markUnhealthy();
+                return;
+            }
+        }
+    }
+    function sink(event) {
+        if (!sinkHealthy) {
+            checkTtl();
+            // Try sending the new event to see if inner has recovered
+            if (tryInner(event)) {
+                markHealthy();
+                flushBuffer();
+            }
+            else {
+                addToBuffer(event);
+            }
+            return;
+        }
+        if (tryInner(event)) {
+            return;
+        }
+        // Inner failed
+        markUnhealthy();
+        addToBuffer(event);
+    }
+    function flush() {
+        if (buffer.length === 0)
+            return;
+        // Test if inner is recovered by trying the first buffered event
+        const first = buffer[0];
+        if (tryInner(first)) {
+            buffer.shift();
+            markHealthy();
+            flushBuffer();
+        }
+        // If still broken, leave buffer intact
+    }
+    function state() {
+        return {
+            buffered: buffer.length,
+            dropped,
+            sinkHealthy,
+        };
+    }
+    return { sink, flush, state };
+}