@ouro.bot/cli 0.1.0-alpha.92 → 0.1.0-alpha.921

package/dist/nerves/index.js

@@ -1,5 +1,39 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MAX_GENERATIONS = exports.DEFAULT_MAX_LOG_SIZE_BYTES = void 0;
 exports.createTraceId = createTraceId;
 exports.ensureTraceId = ensureTraceId;
 exports.createFanoutSink = createFanoutSink;
@@ -7,18 +41,44 @@ exports.formatTerminalEntry = formatTerminalEntry;
 exports.registerSpinnerHooks = registerSpinnerHooks;
 exports.createTerminalSink = createTerminalSink;
 exports.createStderrSink = createStderrSink;
+exports.rotateIfNeeded = rotateIfNeeded;
 exports.createNdjsonFileSink = createNdjsonFileSink;
 exports.registerGlobalLogSink = registerGlobalLogSink;
 exports.createLogger = createLogger;
 const fs_1 = require("fs");
 const path_1 = require("path");
 const crypto_1 = require("crypto");
+const zlib = __importStar(require("zlib"));
+// NOTE: runtime.ts imports `createLogger` and `ensureTraceId` from this file.
+// The cycle is safe in CommonJS because runtime.ts only uses those values
+// lazily inside `getRuntimeLogger()`, and we only call `emitNervesEvent` from
+// inside `rotateIfNeeded` — never at module top level.
+const runtime_1 = require("./runtime");
+const redact_1 = require("./redact");
 const LEVEL_PRIORITY = {
     debug: 10,
     info: 20,
     warn: 30,
     error: 40,
 };
+function fsyncFileAndDirectory(filePath) {
+    if ((0, fs_1.existsSync)(filePath)) {
+        const fileDescriptor = (0, fs_1.openSync)(filePath, "r");
+        try {
+            (0, fs_1.fsyncSync)(fileDescriptor);
+        }
+        finally {
+            (0, fs_1.closeSync)(fileDescriptor);
+        }
+    }
+    const directoryDescriptor = (0, fs_1.openSync)((0, path_1.dirname)(filePath), "r");
+    try {
+        (0, fs_1.fsyncSync)(directoryDescriptor);
+    }
+    finally {
+        (0, fs_1.closeSync)(directoryDescriptor);
+    }
+}
 const GLOBAL_SINKS_KEY = Symbol.for("ouroboros.nerves.global-sinks");
 function resolveGlobalSinks() {
     const scope = globalThis;
@@ -82,7 +142,10 @@ function registerSpinnerHooks(pause, resume) {
     _pauseSpinner = pause;
     _resumeSpinner = resume;
 }
-function createTerminalSink(write = (chunk) => process.stderr.write(chunk), colorize = true) {
+function createTerminalSink(write = (chunk) => { try {
+    process.stderr.write(chunk);
+}
+catch { /* EPIPE: daemon detached, no terminal */ } }, colorize = true) {
     return (entry) => {
         _pauseSpinner?.();
         const line = formatTerminalEntry(entry);
@@ -96,27 +159,241 @@ function createTerminalSink(write = (chunk) => process.stderr.write(chunk), colo
         _resumeSpinner?.();
     };
 }
-function createStderrSink(write = (chunk) => process.stderr.write(chunk)) {
+function createStderrSink(write) {
     return createTerminalSink(write);
 }
-function createNdjsonFileSink(filePath) {
+exports.DEFAULT_MAX_LOG_SIZE_BYTES = 25 * 1024 * 1024; // 25 MB per active stream
+exports.DEFAULT_MAX_GENERATIONS = 5; // keep 5 gzipped historical generations
+const DEFAULT_ROTATION_CHECK_INTERVAL_BYTES = 1024 * 1024; // ~1MB between stat checks
+/** Internal: compute the gzipped generation path for a given ndjson file. */
+function generationGzPath(base, ext, n) {
+    return ext === ".ndjson" ? `${base}.${n}.ndjson.gz` : `${base}.${n}.gz`;
+}
+/** Internal: compute the legacy uncompressed generation path for a given file. */
+function generationPlainPath(base, ext, n) {
+    return ext === ".ndjson" ? `${base}.${n}.ndjson` : `${base}.${n}`;
+}
+/**
+ * Rotate a log file in place.
+ *
+ * Scheme (25 MB × 5 gzipped generations by default):
+ *   active       : foo.ndjson
+ *   newest gen   : foo.1.ndjson.gz
+ *   oldest gen   : foo.5.ndjson.gz (dropped on next rotation)
+ *
+ * Legacy tolerance: uncompressed `foo.1.ndjson` / `foo.2.ndjson` files from the
+ * old scheme are treated as the corresponding generation and gzipped on first
+ * rotation.
+ *
+ * Concurrent-writer safety: the active file is renamed (inode stays alive for
+ * any open writer fd) then gzipped at the renamed path. An active writer
+ * continues writing to its original fd; on the next write cycle it sees the
+ * old path is missing and creates a fresh file.
+ *
+ * Backwards-compatible signature: passing a `number` as the second argument
+ * (the old API) is still accepted and interpreted as `maxSizeBytes`.
+ */
+function rotateIfNeeded(filePath, optionsOrMaxSize) {
+    const options = typeof optionsOrMaxSize === "number"
+        ? { maxSizeBytes: optionsOrMaxSize }
+        : optionsOrMaxSize ?? {};
+    const maxSizeBytes = options.maxSizeBytes ?? exports.DEFAULT_MAX_LOG_SIZE_BYTES;
+    const maxGenerations = options.maxGenerations ?? exports.DEFAULT_MAX_GENERATIONS;
+    const compress = options.compress ?? true;
+    let size;
+    try {
+        size = (0, fs_1.statSync)(filePath).size;
+    }
+    catch {
+        return false;
+    }
+    if (size < maxSizeBytes)
+        return false;
+    const ext = filePath.endsWith(".ndjson") ? ".ndjson" : "";
+    const base = ext ? filePath.slice(0, -ext.length) : filePath;
+    const traceId = (0, crypto_1.randomUUID)();
+    (0, runtime_1.emitNervesEvent)({
+        component: "nerves",
+        event: "nerves.rotation_start",
+        trace_id: traceId,
+        message: "rotating log file",
+        meta: { path: filePath, currentSize: size, threshold: maxSizeBytes, generation: 1 },
+    });
+    let completed = false;
+    try {
+        // Step 1: drop / shift existing generations starting from the oldest.
+        // For each slot N (maxGenerations..2), find whatever occupies slot (N-1)
+        // (as .gz or legacy uncompressed) and move it to slot N. Slot N occupants
+        // get overwritten (oldest is dropped). Non-existent slots are skipped.
+        for (let n = maxGenerations; n >= 2; n--) {
+            const destGz = generationGzPath(base, ext, n);
+            const srcGz = generationGzPath(base, ext, n - 1);
+            const srcPlain = generationPlainPath(base, ext, n - 1);
+            // Drop whatever currently occupies the destination slot (oldest generation).
+            if ((0, fs_1.existsSync)(destGz)) {
+                (0, fs_1.unlinkSync)(destGz);
+            }
+            const destPlain = generationPlainPath(base, ext, n);
+            if ((0, fs_1.existsSync)(destPlain)) {
+                (0, fs_1.unlinkSync)(destPlain);
+            }
+            // Prefer moving .gz → .gz (cheap rename).
+            if ((0, fs_1.existsSync)(srcGz)) {
+                (0, fs_1.renameSync)(srcGz, destGz);
+                continue;
+            }
+            // Legacy migration: if a plain .ndjson generation file exists from the
+            // old scheme, read it, gzip it into the destination slot, and delete
+            // the plain source.
+            if ((0, fs_1.existsSync)(srcPlain)) {
+                if (compress) {
+                    const buf = (0, fs_1.readFileSync)(srcPlain);
+                    const compressed = zlib.gzipSync(buf);
+                    (0, fs_1.writeFileSync)(destGz, compressed);
+                    (0, fs_1.unlinkSync)(srcPlain);
+                }
+                else {
+                    // compress=false: just rename
+                    (0, fs_1.renameSync)(srcPlain, destPlain);
+                }
+            }
+        }
+        // Step 2: rename the active file to the generation-1 plain path. The
+        // active writer keeps its open fd; the file path now points elsewhere.
+        const plain1 = generationPlainPath(base, ext, 1);
+        // If a stale .1 plain path exists (e.g. a previous compress=false run),
+        // remove it so the rename can claim the slot cleanly.
+        if ((0, fs_1.existsSync)(plain1)) {
+            (0, fs_1.unlinkSync)(plain1);
+        }
+        fsyncFileAndDirectory(filePath);
+        (0, fs_1.renameSync)(filePath, plain1);
+        // Step 3: gzip (or keep plain) the renamed file into the .1 generation.
+        if (compress) {
+            const gz1 = generationGzPath(base, ext, 1);
+            // Remove any lingering .1.ndjson.gz to avoid "file exists" on write.
+            if ((0, fs_1.existsSync)(gz1)) {
+                (0, fs_1.unlinkSync)(gz1);
+            }
+            const buf = (0, fs_1.readFileSync)(plain1);
+            const compressed = zlib.gzipSync(buf);
+            (0, fs_1.writeFileSync)(gz1, compressed);
+            fsyncFileAndDirectory(gz1);
+            (0, fs_1.unlinkSync)(plain1);
+        }
+        fsyncFileAndDirectory(compress ? generationGzPath(base, ext, 1) : plain1);
+        completed = true;
+        (0, runtime_1.emitNervesEvent)({
+            component: "nerves",
+            event: "nerves.rotation_end",
+            trace_id: traceId,
+            message: "log rotation complete",
+            meta: { path: filePath, compressedPath: compress ? generationGzPath(base, ext, 1) : plain1, bytesFreed: size },
+        });
+        return true;
+    }
+    catch (err) {
+        /* v8 ignore next -- defensive: completed=true only reached after the try block's return @preserve */
+        if (!completed) {
+            /* v8 ignore next -- defensive: fs ops throw real Errors @preserve */
+            const reason = err instanceof Error ? err.message : String(err);
+            (0, runtime_1.emitNervesEvent)({
+                component: "nerves",
+                event: "nerves.rotation_error",
+                trace_id: traceId,
+                level: "error",
+                message: "log rotation failed",
+                meta: { path: filePath, error: reason },
+            });
+        }
+        throw err;
+    }
+}
+function createNdjsonFileSink(filePath, optionsOrMaxSize) {
     (0, fs_1.mkdirSync)((0, path_1.dirname)(filePath), { recursive: true });
+    const options = typeof optionsOrMaxSize === "number"
+        ? { maxSizeBytes: optionsOrMaxSize }
+        : optionsOrMaxSize ?? {};
+    const rotationCheckInterval = options.rotationCheckIntervalBytes ?? DEFAULT_ROTATION_CHECK_INTERVAL_BYTES;
+    const verbose = process.env.OURO_LOG_VERBOSE === "1";
     const queue = [];
     let flushing = false;
+    let bytesSinceCheck = 0;
+    let enqueued = 0;
+    let completed = 0;
+    let appendFailure = null;
+    const barriers = [];
+    function settleBarriers() {
+        const ready = barriers.filter((barrier) => barrier.target <= completed);
+        if (ready.length === 0)
+            return;
+        for (const barrier of ready)
+            barriers.splice(barriers.indexOf(barrier), 1);
+        if (appendFailure) {
+            for (const barrier of ready)
+                barrier.reject(appendFailure);
+            return;
+        }
+        try {
+            fsyncFileAndDirectory(filePath);
+            for (const barrier of ready)
+                barrier.resolve();
+        }
+        catch (error) {
+            const failure = error instanceof Error ? error : new Error(String(error));
+            appendFailure = failure;
+            for (const barrier of ready)
+                barrier.reject(failure);
+        }
+    }
     function flush() {
         if (flushing || queue.length === 0)
             return;
         flushing = true;
         const line = queue.shift();
-        (0, fs_1.appendFile)(filePath, line, "utf8", () => {
+        const checkBeforeAppend = bytesSinceCheck >= rotationCheckInterval;
+        const checkAfterAppend = checkBeforeAppend || line.length >= rotationCheckInterval;
+        if (checkBeforeAppend) {
+            bytesSinceCheck = 0;
+            try {
+                rotateIfNeeded(filePath, options);
+            }
+            catch (rotationError) {
+                appendFailure ??= rotationError instanceof Error ? rotationError : new Error(String(rotationError));
+            }
+        }
+        (0, fs_1.appendFile)(filePath, line, "utf8", (error) => {
+            completed += 1;
+            if (error)
+                appendFailure ??= error;
+            if (checkAfterAppend) {
+                try {
+                    fsyncFileAndDirectory(filePath);
+                    rotateIfNeeded(filePath, options);
+                }
+                catch (rotationError) {
+                    appendFailure ??= rotationError instanceof Error ? rotationError : new Error(String(rotationError));
+                }
+            }
+            settleBarriers();
             flushing = false;
             flush();
         });
     }
-    return (entry) => {
-        queue.push(`${JSON.stringify(entry)}\n`);
+    const sink = ((entry) => {
+        const line = verbose
+            ? `${JSON.stringify(entry)}\n`
+            : `${(0, redact_1.redactString)(JSON.stringify((0, redact_1.redactLogEntry)(entry)))}\n`;
+        bytesSinceCheck += line.length;
+        enqueued += 1;
+        queue.push(line);
         flush();
-    };
+    });
+    sink.barrier = () => new Promise((resolve, reject) => {
+        barriers.push({ target: enqueued, resolve, reject });
+        settleBarriers();
+    });
+    return sink;
 }
 function registerGlobalLogSink(sink) {
     globalSinks.add(sink);
@@ -138,9 +415,10 @@ function createLogger(options = {}) {
     const configuredLevel = options.level ?? "info";
     const sinks = options.sinks ?? [createStderrSink()];
     const sink = createFanoutSink(sinks);
+    const durableSinks = sinks.filter((candidate) => "barrier" in candidate && typeof candidate.barrier === "function");
     const now = options.now ?? (() => new Date());
-    function emit(level, entry) {
-        if (!shouldEmit(configuredLevel, level)) {
+    function emit(level, entry, force = false) {
+        if (!force && !shouldEmit(configuredLevel, level)) {
             return;
         }
         const payload = {
@@ -160,5 +438,11 @@ function createLogger(options = {}) {
         info: (entry) => emit("info", entry),
         warn: (entry) => emit("warn", entry),
         error: (entry) => emit("error", entry),
+        durabilityBarrier: async () => {
+            if (durableSinks.length === 0)
+                throw new Error("No durable Nerves sink is configured");
+            await Promise.all(durableSinks.map((durableSink) => durableSink.barrier()));
+        },
+        emitDurable: (level, entry) => emit(level, entry, true),
     };
 }

package/dist/nerves/observation.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Nerves observation layer — shared typed readers for runtime state.
+ *
+ * This module re-exports domain types that multiple consumers need
+ * (Mailbox, CLI, agent tools) so they don't maintain parallel type universes.
+ *
+ * The Mailbox UI consumes these through the HTTP API, but the same
+ * observation functions back CLI commands and future native clients.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+/* v8 ignore start — module-level observability event */
+const runtime_1 = require("./runtime");
+(0, runtime_1.emitNervesEvent)({
+    component: "nerves",
+    event: "nerves.observation_loaded",
+    message: "observation layer loaded",
+    meta: {},
+});
+/* v8 ignore stop */

package/dist/nerves/redact.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SENSITIVE_PATTERNS = exports.SENSITIVE_KEYS = void 0;
+exports.redactMeta = redactMeta;
+exports.redactString = redactString;
+exports.redactLogEntry = redactLogEntry;
+/**
+ * Lowercase key names that trigger structured redaction.
+ * Matched case-insensitively against meta object keys.
+ */
+exports.SENSITIVE_KEYS = new Set([
+    "password",
+    "secret",
+    "token",
+    "accesstoken",
+    "refreshtoken",
+    "clientsecret",
+    "apikey",
+    "oauthaccesstoken",
+    "authorization",
+    "cookie",
+    "set-cookie",
+]);
+/**
+ * Regex patterns for string-level fallback redaction.
+ * Applied in order; each match is replaced with `[REDACTED:name]`.
+ */
+exports.SENSITIVE_PATTERNS = [
+    { name: "anthropic_key", pattern: /sk-ant-[A-Za-z0-9_-]+/g },
+    { name: "openai_key", pattern: /sk-proj-[A-Za-z0-9_-]+/g },
+    { name: "bearer_token", pattern: /Bearer [A-Za-z0-9\-_.]+/g },
+    { name: "api_key_assignment", pattern: /api[_-]?key[=:]\s*["']?[A-Za-z0-9\-_.]+/g },
+    { name: "url_token", pattern: /[?&](?:token|key|api_key|access_token)=[A-Za-z0-9\-_.%]+/g },
+];
+/**
+ * Deep-clone meta and replace values at sensitive keys with `[REDACTED:key_name]`.
+ * Recurses into nested objects. Case-insensitive key matching.
+ */
+function redactMeta(meta) {
+    const result = {};
+    for (const key of Object.keys(meta)) {
+        const value = meta[key];
+        if (exports.SENSITIVE_KEYS.has(key.toLowerCase())) {
+            result[key] = `[REDACTED:${key}]`;
+        }
+        else if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+            result[key] = redactMeta(value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Apply all regex patterns to a string, replacing matches with `[REDACTED:pattern_name]`.
+ */
+function redactString(text) {
+    let result = text;
+    for (const { name, pattern } of exports.SENSITIVE_PATTERNS) {
+        // Reset lastIndex for global regexes reused across calls
+        pattern.lastIndex = 0;
+        result = result.replace(pattern, `[REDACTED:${name}]`);
+    }
+    return result;
+}
+/**
+ * Full redaction pipeline: redact meta (structured keys), then redact message (regex patterns).
+ * Returns a new LogEvent -- never mutates the input.
+ */
+function redactLogEntry(entry) {
+    const redactedMeta = redactMeta(entry.meta);
+    const redactedMessage = redactString(entry.message);
+    return {
+        ...entry,
+        meta: redactedMeta,
+        message: redactedMessage,
+    };
+}

package/dist/nerves/review/cli-main.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("./cli");
+const code = (0, cli_1.runNervesReviewCli)(process.argv.slice(2));
+process.exit(code);

package/dist/nerves/review/cli.js

@@ -0,0 +1,156 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runNervesReviewCli = runNervesReviewCli;
+const path = __importStar(require("node:path"));
+const identity_1 = require("../../heart/identity");
+const core_1 = require("./core");
+function parseArgs(argv) {
+    const args = { process: core_1.DEFAULT_NERVES_PROCESS, json: false, help: false };
+    for (let i = 0; i < argv.length; i++) {
+        const token = argv[i];
+        const next = argv[i + 1];
+        switch (token) {
+            case "--help":
+            case "-h":
+                args.help = true;
+                break;
+            case "--process":
+                if (next)
+                    args.process = next;
+                i++;
+                break;
+            case "--agent":
+                if (next)
+                    args.agent = next;
+                i++;
+                break;
+            case "--component":
+                if (next)
+                    args.componentSubstring = next;
+                i++;
+                break;
+            case "--event":
+                if (next)
+                    args.eventSubstring = next;
+                i++;
+                break;
+            case "--level":
+                if (next)
+                    args.level = next;
+                i++;
+                break;
+            case "--since":
+                if (next)
+                    args.since = next;
+                i++;
+                break;
+            case "--limit":
+                if (next) {
+                    const parsed = Number.parseInt(next, 10);
+                    if (Number.isFinite(parsed) && parsed > 0)
+                        args.limit = parsed;
+                }
+                i++;
+                break;
+            case "--json":
+                args.json = true;
+                break;
+        }
+    }
+    return args;
+}
+function printHelp() {
+    // eslint-disable-next-line no-console -- meta-tooling
+    console.log([
+        "usage: ouro nerves-review [options]",
+        "",
+        "Tail the agent's nerves ndjson and filter recent events. Read-only.",
+        "",
+        "options:",
+        `  --process <name>      log stream to read (default: ${core_1.DEFAULT_NERVES_PROCESS})`,
+        "  --agent <name>        agent bundle to read from (default: current)",
+        "  --component <substr>  filter by component substring (case-insensitive)",
+        "  --event <substr>      filter by event-name substring (case-insensitive)",
+        "  --level <level>       filter by exact level (debug|info|warn|error)",
+        "  --since <duration>    only events newer than e.g. 5m, 2h, 1d",
+        "  --limit <N>           cap returned events (default: 50)",
+        "  --json                output one JSON object per line",
+    ].join("\n"));
+}
+function runNervesReviewCli(argv) {
+    const args = parseArgs(argv);
+    if (args.help) {
+        printHelp();
+        return 0;
+    }
+    let sinceMs;
+    if (args.since) {
+        const parsed = (0, core_1.parseDuration)(args.since);
+        if (parsed === null) {
+            // eslint-disable-next-line no-console -- meta-tooling
+            console.error(`nerves-review: --since '${args.since}' is not a valid duration (e.g. 5m, 2h, 1d)`);
+            return 2;
+        }
+        sinceMs = parsed;
+    }
+    const logsDir = (0, identity_1.getAgentDaemonLogsDir)(args.agent);
+    const filePath = path.join(logsDir, `${args.process}.ndjson`);
+    const filter = {
+        componentSubstring: args.componentSubstring,
+        eventSubstring: args.eventSubstring,
+        level: args.level,
+        sinceMs,
+        limit: args.limit,
+        nowMs: Date.now(),
+    };
+    const entries = (0, core_1.reviewNerveEvents)(filePath, filter);
+    if (entries.length === 0) {
+        // eslint-disable-next-line no-console -- meta-tooling
+        console.log(`(no matching nerves events in ${filePath})`);
+        return 0;
+    }
+    for (const entry of entries) {
+        if (args.json) {
+            // eslint-disable-next-line no-console -- meta-tooling
+            console.log(entry.raw);
+        }
+        else {
+            // eslint-disable-next-line no-console -- meta-tooling
+            console.log((0, core_1.formatNerveEntry)(entry));
+        }
+    }
+    return 0;
+}