@jevitate/cli 0.1.0 → 0.2.0

package/dist/log-lines.js

@@ -0,0 +1,389 @@
+import { messageClass, normalizeRoute } from "@jevitate/explore";
+import { contentHash } from "@jevitate/domain";
+const LEVEL_RANK = { unknown: 0, debug: 1, info: 2, warn: 3, error: 4 };
+/** True when `a` is at least as severe as `b`. `unknown` is never >= a NAMED level (fail closed). */
+export function levelAtLeast(a, b) {
+    if (b === "unknown")
+        return true;
+    if (a === "unknown")
+        return false;
+    return LEVEL_RANK[a] >= LEVEL_RANK[b];
+}
+function normalizeLevelName(raw) {
+    const v = raw.trim().toLowerCase();
+    // "fail"/"crit" are .NET's `Microsoft.Extensions.Logging` console-formatter tokens (#165): `fail`
+    // maps to `error`, and `crit`("critical") also maps to `error` — this LogLevel enum has no
+    // separate "critical" tier, so both collapse the same way `fatal` already did. "err"/"ftl" are
+    // Serilog's own 3-letter abbreviations (its default console theme: VRB/DBG/INF/WRN/ERR/FTL).
+    if (v === "error" || v === "err" || v === "fatal" || v === "critical" || v === "crit" || v === "fail" || v === "ftl")
+        return "error";
+    if (v === "warn" || v === "warning" || v === "wrn")
+        return "warn";
+    if (v === "info" || v === "notice" || v === "inf")
+        return "info";
+    // "dbug"/"trce" are .NET's own short tokens for debug/trace; "dbg"/"vrb" are Serilog's.
+    if (v === "debug" || v === "trace" || v === "verbose" || v === "dbug" || v === "trce" || v === "dbg" || v === "vrb")
+        return "debug";
+    return "unknown";
+}
+const ISO_TS_SRC = String.raw `\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:?\d{2})?`;
+const ISO_TS = new RegExp(ISO_TS_SRC);
+/** Seconds vs ms heuristic: a value under 10^10 is (almost) certainly seconds — ms would be before
+ *  2001-09-09, never a real log line's own timestamp — so it is scaled up. */
+function parseTimeValue(v) {
+    if (typeof v === "number" && Number.isFinite(v))
+        return v < 10_000_000_000 ? v * 1000 : v;
+    if (typeof v === "string") {
+        const t = Date.parse(v);
+        return Number.isNaN(t) ? null : t;
+    }
+    return null;
+}
+function firstDefined(obj, keys) {
+    for (const k of keys)
+        if (obj[k] !== undefined)
+            return obj[k];
+    return undefined;
+}
+const LEVEL_KEYS = ["level", "severity", "loglevel", "log_level", "LogLevel"];
+// "Timestamp" (capital T, #165/#169): the .NET JSON console formatter's own key
+// (`{"Timestamp":…,"LogLevel":"Error","Category":…,"Message":…}`).
+const TIME_KEYS = ["time", "timestamp", "ts", "@timestamp", "Timestamp"];
+/** Top-level message-ish keys, highest priority first. */
+const TOP_MESSAGE_KEYS = ["message", "msg", "Message"];
+/** `fields.<key>` — Rust `tracing`/`tracing-subscriber`'s JSON formatter (#169) nests the actual
+ *  message under `fields`, not at the top level; the top-level object is otherwise just envelope
+ *  (timestamp/level/target/span). */
+const NESTED_FIELD_KEYS = ["fields"];
+const NESTED_MESSAGE_KEYS = ["message", "msg"];
+const FALLBACK_MESSAGE_KEYS = ["@message", "error", "err"];
+const TARGET_KEYS = ["target", "logger", "Category"];
+/**
+ * The human message of a JSON log line (#169): `message`/`msg` at the top level, else
+ * `fields.message`/`fields.msg` (tracing-subscriber), else `@message`, else `error`/`err` as a last
+ * resort for a line with no explicit message key. Anything else (a whole nested object with no
+ * string message anywhere) falls back to the raw line in the caller, rather than JSON.stringify-ing
+ * an object through `messageClass` into unreadable `{<s>:<s>…}` noise.
+ */
+function extractMessage(rec) {
+    const top = firstDefined(rec, TOP_MESSAGE_KEYS);
+    if (typeof top === "string")
+        return top;
+    for (const fk of NESTED_FIELD_KEYS) {
+        const nestedObj = rec[fk];
+        if (nestedObj !== null && typeof nestedObj === "object" && !Array.isArray(nestedObj)) {
+            const nested = firstDefined(nestedObj, NESTED_MESSAGE_KEYS);
+            if (typeof nested === "string")
+                return nested;
+        }
+    }
+    const fallback = firstDefined(rec, FALLBACK_MESSAGE_KEYS);
+    return typeof fallback === "string" ? fallback : undefined;
+}
+function parseJsonLine(trimmed, source, arrivalEpochMs) {
+    let obj;
+    try {
+        obj = JSON.parse(trimmed);
+    }
+    catch {
+        return null;
+    }
+    if (obj === null || typeof obj !== "object" || Array.isArray(obj))
+        return null;
+    const rec = obj;
+    const levelRaw = firstDefined(rec, LEVEL_KEYS);
+    const level = typeof levelRaw === "string" || typeof levelRaw === "number" ? normalizeLevelName(String(levelRaw)) : "unknown";
+    const parsedTime = parseTimeValue(firstDefined(rec, TIME_KEYS));
+    const message = extractMessage(rec);
+    const targetRaw = firstDefined(rec, TARGET_KEYS);
+    const target = typeof targetRaw === "string" && targetRaw !== "" ? targetRaw : undefined;
+    return {
+        level,
+        message: message ?? trimmed,
+        raw: trimmed,
+        epochMs: parsedTime ?? arrivalEpochMs,
+        ownTimestamp: parsedTime !== null,
+        source,
+        ...(target === undefined ? {} : { target }),
+    };
+}
+/** `key=value key2="quoted value" level=error` — a bare word with no `=` is not a pair. */
+const LOGFMT_PAIR = /([a-zA-Z_][\w.-]*)=("(?:[^"\\]|\\.)*"|\S+)/g;
+function parseLogfmtLine(trimmed, source, arrivalEpochMs) {
+    const pairs = {};
+    let matched = 0;
+    for (const m of trimmed.matchAll(LOGFMT_PAIR)) {
+        matched += 1;
+        const key = (m[1] ?? "").toLowerCase();
+        let value = m[2] ?? "";
+        if (value.startsWith('"') && value.endsWith('"')) {
+            try {
+                value = JSON.parse(value);
+            }
+            catch {
+                value = value.slice(1, -1);
+            }
+        }
+        pairs[key] = value;
+    }
+    // Require at least two pairs AND a level or message key — a stray "a=b" inside free text is not logfmt.
+    if (matched < 2 || (pairs.level === undefined && pairs.severity === undefined && pairs.msg === undefined && pairs.message === undefined)) {
+        return null;
+    }
+    const levelRaw = firstDefined(pairs, LEVEL_KEYS);
+    const level = typeof levelRaw === "string" ? normalizeLevelName(levelRaw) : "unknown";
+    const parsedTime = parseTimeValue(firstDefined(pairs, TIME_KEYS));
+    const msgRaw = firstDefined(pairs, [...TOP_MESSAGE_KEYS, ...FALLBACK_MESSAGE_KEYS]);
+    return {
+        level,
+        message: typeof msgRaw === "string" ? msgRaw : trimmed,
+        raw: trimmed,
+        epochMs: parsedTime ?? arrivalEpochMs,
+        ownTimestamp: parsedTime !== null,
+        source,
+    };
+}
+/**
+ * The .NET default console formatter's entry header (#165, `Microsoft.Extensions.Logging`):
+ * `lvl: Category.Name[EventId]`, e.g. `fail: OutboundLabs...StripeReconciliationHostedService[0]`.
+ * The message is on the following indented line(s) — see `DotnetEntryGrouper`, which joins them
+ * into one multi-line entry BEFORE it reaches this parser.
+ */
+const DOTNET_HEADER_RE = /^(trce|dbug|info|warn|fail|crit):\s+(.+)\[(-?\d+)\]\s*$/i;
+/**
+ * Parses an entry already joined by `DotnetEntryGrouper` (header line + its indented continuation
+ * lines, `\n`-separated) — or a bare header line with no continuation, for direct unit testing.
+ * `null` when the first line is not a `lvl: Category[id]` header, so this format never claims a
+ * line meant for another parser.
+ */
+function parseDotnetLine(trimmedWhole, source, arrivalEpochMs) {
+    const lines = trimmedWhole.split("\n");
+    const headerLine = (lines[0] ?? "").trim();
+    const m = DOTNET_HEADER_RE.exec(headerLine);
+    if (m === null)
+        return null;
+    const level = normalizeLevelName(m[1] ?? "");
+    const category = (m[2] ?? "").trim();
+    // Continuation lines (the message, and any exception stack trace) are dedented and collapsed into
+    // one message string — `normalizeLogMessage`/`messageClass` collapse whitespace anyway, and a
+    // single-line message reads better in `topMessages`/a defect title than a raw multi-line blob.
+    const body = lines
+        .slice(1)
+        .map((l) => l.trim())
+        .filter((l) => l !== "")
+        .join(" ");
+    return {
+        level,
+        message: body !== "" ? body : category,
+        raw: trimmedWhole,
+        epochMs: arrivalEpochMs,
+        ownTimestamp: false,
+        source,
+        ...(category === "" ? {} : { target: category }),
+    };
+}
+/**
+ * Serilog's default console theme: `[HH:mm:ss(.fff) LVL] rest`, `LVL` one of its 3-letter
+ * abbreviations (VRB/DBG/INF/WRN/ERR/FTL). A custom output template commonly puts `SourceContext`
+ * right after the bracket (`[10:00:00 ERR] MyApp.Services.FooService request failed`) — detected as
+ * a dotted identifier with no spaces, immediately followed by the rest of the message.
+ */
+const SERILOG_RE = /^\[(\d{1,2}:\d{2}:\d{2}(?:\.\d+)?)\s+(VRB|DBG|INF|WRN|ERR|FTL)\]\s*(.*)$/i;
+const SERILOG_SOURCE_CONTEXT_RE = /^([A-Za-z_][\w]*(?:\.[A-Za-z_][\w]*)+)\s+(.+)$/;
+function parseSerilogLine(trimmed, source, arrivalEpochMs) {
+    const m = SERILOG_RE.exec(trimmed);
+    if (m === null)
+        return null;
+    const level = normalizeLevelName(m[2] ?? "");
+    const rest = (m[3] ?? "").trim();
+    const scMatch = SERILOG_SOURCE_CONTEXT_RE.exec(rest);
+    const target = scMatch === null ? undefined : scMatch[1];
+    const message = scMatch === null ? rest : (scMatch[2] ?? "").trim();
+    return {
+        level,
+        message: message !== "" ? message : rest,
+        raw: trimmed,
+        // Serilog's default theme has no date, only a time-of-day — too ambiguous to trust as the
+        // line's own epoch (which day?); the arrival time is the honest choice.
+        epochMs: arrivalEpochMs,
+        ownTimestamp: false,
+        source,
+        ...(target === undefined ? {} : { target }),
+    };
+}
+const BRACKETED_LEVEL = /\[(ERROR|ERR|FATAL|CRITICAL|CRIT|WARN(?:ING)?|INFO|NOTICE|DEBUG|TRACE)\]/i;
+const BARE_LEVEL = /\b(ERROR|FATAL|WARN(?:ING)?|INFO|DEBUG|TRACE)\b:?/;
+function parseBracketedLine(trimmed, source, arrivalEpochMs) {
+    const tsMatch = ISO_TS.exec(trimmed);
+    const parsedTime = tsMatch === null ? null : parseTimeValue(tsMatch[0]);
+    const levelMatch = BRACKETED_LEVEL.exec(trimmed) ?? BARE_LEVEL.exec(trimmed);
+    const level = levelMatch === null ? "unknown" : normalizeLevelName(levelMatch[1] ?? levelMatch[0]);
+    return { level, message: trimmed, raw: trimmed, epochMs: parsedTime ?? arrivalEpochMs, ownTimestamp: parsedTime !== null, source };
+}
+/**
+ * Parses one raw log line — or, for the .NET console format (#165), one already-grouped multi-line
+ * entry (see `DotnetEntryGrouper`): JSON (`level`/`severity` + `time`/`timestamp`/`ts`), then logfmt
+ * (`level=error msg="…" time=…`), then the .NET default console formatter (`lvl: Category[id]` +
+ * indented continuation lines), then Serilog's bracketed console theme (`[HH:mm:ss ERR] …`), then a
+ * generic bracketed/bare level with an optional leading ISO timestamp, else falls back to the line
+ * verbatim with an `unknown` level and the arrival time. Never throws.
+ */
+export function parseLogLine(raw, arrivalEpochMs, source) {
+    const trimmed = raw.trim();
+    if (trimmed === "")
+        return { level: "unknown", message: "", raw, epochMs: arrivalEpochMs, ownTimestamp: false, source };
+    return (parseJsonLine(trimmed, source, arrivalEpochMs) ??
+        parseLogfmtLine(trimmed, source, arrivalEpochMs) ??
+        parseDotnetLine(trimmed, source, arrivalEpochMs) ??
+        parseSerilogLine(trimmed, source, arrivalEpochMs) ??
+        parseBracketedLine(trimmed, source, arrivalEpochMs));
+}
+/** A line that only extends a pending .NET entry when one is open: indented and non-blank. */
+function isDotnetContinuation(line) {
+    return /^[ \t]/.test(line) && line.trim() !== "";
+}
+/**
+ * Groups the .NET default console formatter's multi-line entries (#165) — a `lvl: Category[id]`
+ * header followed by one or more indented message/exception-stack-trace lines — into ONE logical
+ * entry before it reaches `parseLogLine`. Stateful and meant for ONE `--log-source` (`log-
+ * correlation.ts` keeps one instance per source): lines arrive one at a time, in order, from `log-
+ * sources.ts`'s line splitter.
+ *
+ * A header line always starts a NEW pending entry (flushing whatever was pending first); an
+ * indented, non-blank line — while an entry is pending — extends it instead of starting its own;
+ * anything else (not indented, not itself a header) is its own one-line entry. Every other log
+ * format (JSON, logfmt, bracketed/bare) never triggers buffering: `feed` only holds a line back
+ * when it is itself a header or it is indented AND a header is already pending, so a single
+ * already-indented stray line with no pending entry passes straight through unchanged.
+ */
+export class DotnetEntryGrouper {
+    #pending;
+    #pendingEpochMs = 0;
+    /** Feed one raw line. Returns the entries this line completed — usually 0 or 1, occasionally 2
+     *  (a pending entry flushed by, immediately followed by, this line's own one-line entry). */
+    feed(raw, epochMs) {
+        const isHeader = DOTNET_HEADER_RE.test(raw.trim());
+        if (this.#pending !== undefined && !isHeader && isDotnetContinuation(raw)) {
+            this.#pending.push(raw);
+            return [];
+        }
+        const out = [];
+        if (this.#pending !== undefined) {
+            out.push({ raw: this.#pending.join("\n"), epochMs: this.#pendingEpochMs });
+            this.#pending = undefined;
+        }
+        if (isHeader) {
+            this.#pending = [raw];
+            this.#pendingEpochMs = epochMs;
+            return out;
+        }
+        out.push({ raw, epochMs });
+        return out;
+    }
+    /** Flushes a still-pending entry (call when the source is closing: the log's last entry has no
+     *  following header/non-continuation line to trigger its own flush). `undefined` when idle. */
+    flush() {
+        if (this.#pending === undefined)
+            return undefined;
+        const out = { raw: this.#pending.join("\n"), epochMs: this.#pendingEpochMs };
+        this.#pending = undefined;
+        return out;
+    }
+}
+const UUID_RE = /\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/gi;
+const ISO_TS_G = new RegExp(ISO_TS_SRC, "g");
+/**
+ * The CLASS of a log message, for correlation-noise dedup and the `server-log` defect fingerprint:
+ * an ISO timestamp, then a uuid, are replaced by placeholders first (so a timestamp's own digits
+ * don't collide with the generic number-stripping below), then `@jevitate/explore`'s `messageClass`
+ * strips URLs, quoted values, long hex ids and remaining numbers. Two occurrences of one bug that
+ * differ only in an id, a count or a timestamp share a class.
+ */
+export function normalizeLogMessage(message) {
+    return messageClass(message.replace(ISO_TS_G, "<ts>").replace(UUID_RE, "<uuid>"));
+}
+/**
+ * A `server-log` defect's fingerprint (#142): the templated route the line correlated to, plus the
+ * normalized message class, plus — when known (#169) — the logger's own `target`/`logger`/category
+ * (Rust `tracing`'s `target`, a JSON log's `logger`, a .NET entry's category). Two lines whose
+ * message happens to normalize the same, from two different loggers/modules, are DISTINCT defects:
+ * without `target` they would collapse into one fingerprint, hiding one of the two real bugs.
+ * Unattributed lines (outside every step window) are fingerprinted with `route = "(run)"` — still
+ * stable across repeated occurrences of the same line.
+ */
+export function serverLogFingerprint(route, normalizedMessage, target) {
+    const targetPart = target === undefined || target === "" ? "" : `|${target}`;
+    return contentHash(`server-log|${route === "(run)" ? route : normalizeRoute(route)}|${normalizedMessage}${targetPart}`).slice(0, 16);
+}
+export class LogSpecError extends Error {
+    code = "E_LOG_SPEC";
+    constructor(message) {
+        super(message);
+        this.name = "LogSpecError";
+    }
+}
+const REGEX_SPEC = /^\/(.*)\/([a-z]*)$/s;
+const MAX_PATTERN_LENGTH = 500;
+/**
+ * Parses one `--log-defect` value: `/pattern/flags` (bounded length, compiled once via `new
+ * RegExp` — never `eval`ed) or a level name (`error`, `warn`, `info`, `debug`), matched as
+ * `level >= this`. Throws `LogSpecError` on anything else, so a bad spec is refused before any
+ * browser opens (the same fail-closed discipline as `--invariants`).
+ */
+export function parseLogDefectSpec(raw) {
+    const m = REGEX_SPEC.exec(raw);
+    if (m !== null) {
+        const pattern = m[1] ?? "";
+        const flags = m[2] ?? "";
+        if (pattern.length > MAX_PATTERN_LENGTH) {
+            throw new LogSpecError(`--log-defect pattern is too long (max ${MAX_PATTERN_LENGTH} chars): ${raw.slice(0, 40)}…`);
+        }
+        try {
+            return { kind: "pattern", re: new RegExp(pattern, flags), raw };
+        }
+        catch (e) {
+            throw new LogSpecError(`--log-defect: invalid regex ${JSON.stringify(raw)}: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    const level = normalizeLevelName(raw);
+    if (level === "unknown") {
+        throw new LogSpecError(`--log-defect must be a level (error|warn|info|debug) or a /regex/: got ${JSON.stringify(raw)}`);
+    }
+    return { kind: "level", level, raw };
+}
+/** Whether a parsed line matches a `--log-defect` matcher. */
+export function matchesLogDefect(line, matcher) {
+    return matcher.kind === "level" ? levelAtLeast(line.level, matcher.level) : matcher.re.test(line.raw);
+}
+const MAX_IGNORE_LENGTH = 500;
+/**
+ * Parses one `--log-ignore` value: `/pattern/flags` (bounded length, compiled once via `new RegExp`
+ * — never `eval`ed) or a plain substring, matched against the line's RAW text. Throws `LogSpecError`
+ * on anything empty/invalid/too long, failing closed before any browser opens.
+ */
+export function parseLogIgnoreSpec(raw) {
+    const m = REGEX_SPEC.exec(raw);
+    if (m !== null) {
+        const pattern = m[1] ?? "";
+        const flags = m[2] ?? "";
+        if (pattern.length > MAX_IGNORE_LENGTH) {
+            throw new LogSpecError(`--log-ignore pattern is too long (max ${MAX_IGNORE_LENGTH} chars): ${raw.slice(0, 40)}…`);
+        }
+        try {
+            return { kind: "pattern", re: new RegExp(pattern, flags), raw };
+        }
+        catch (e) {
+            throw new LogSpecError(`--log-ignore: invalid regex ${JSON.stringify(raw)}: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    if (raw === "")
+        throw new LogSpecError("--log-ignore: empty pattern");
+    if (raw.length > MAX_IGNORE_LENGTH)
+        throw new LogSpecError(`--log-ignore substring is too long (max ${MAX_IGNORE_LENGTH} chars)`);
+    return { kind: "substring", value: raw, raw };
+}
+/** Whether a parsed line matches a `--log-ignore` matcher (substring/regex over the RAW line). */
+export function matchesLogIgnore(line, matcher) {
+    return matcher.kind === "pattern" ? matcher.re.test(line.raw) : line.raw.includes(matcher.value);
+}
+//# sourceMappingURL=log-lines.js.map

package/dist/log-lines.js.map

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

package/dist/log-sources.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Backend log sources (#142): operator-declared, read-only, bounded. `file:<path>` tails from the
+ * CURRENT end (never a file's history); `docker:<container>` spawns `docker logs -f --since 0s
+ * <container>`; `cmd:<command>` streams an arbitrary command's stdout/stderr, refused unless the
+ * caller opted in (`--allow-log-cmd`) — a bigger trust step than reading a file or a container's
+ * own logs, since it runs a process. A source is NEVER chosen by the model: every spec comes from
+ * the CLI invocation only (never MissionRequest/MCP — see `packages/missions/src/schema.ts`).
+ *
+ * Bounded and non-blocking: a source never gates a mission's own progress (lines are delivered via
+ * callback, not awaited), and each source stops accepting lines past `maxLines` (`truncated: true`)
+ * rather than growing without bound on a noisy log.
+ */
+export type LogSourceSpec = {
+    readonly kind: "file";
+    readonly path: string;
+    readonly raw: string;
+} | {
+    readonly kind: "docker";
+    readonly container: string;
+    readonly raw: string;
+} | {
+    readonly kind: "cmd";
+    readonly command: string;
+    readonly raw: string;
+};
+export declare class LogSourceSpecError extends Error {
+    readonly code: "E_LOG_SOURCE_SPEC";
+    constructor(message: string);
+}
+/** Parses one `--log-source` value. Throws `LogSourceSpecError` on an unrecognized/empty spec. */
+export declare function parseLogSourceSpec(raw: string): LogSourceSpec;
+/**
+ * Validates every spec up front, INCLUDING the `cmd:` + `--allow-log-cmd` gate — so a run refuses
+ * before any browser opens, the same fail-closed discipline as `--invariants`.
+ */
+export declare function parseLogSourceSpecs(raw: readonly string[], allowLogCmd: boolean): LogSourceSpec[];
+export interface LogSourceOpenOptions {
+    /** Called for every raw line, in arrival order. Must not throw; never awaited. */
+    readonly onLine: (raw: string, arrivalEpochMs: number) => void;
+    /** File tail poll interval (ms). Default 250. */
+    readonly filePollMs?: number;
+    /** Max lines delivered per source before later ones are dropped (`truncated` becomes true). */
+    readonly maxLines?: number;
+}
+export interface LogSourceHandle {
+    readonly spec: LogSourceSpec;
+    /** True once the source is confirmed open (file exists / process spawned without an immediate error). */
+    opened: boolean;
+    /** Lines delivered so far. */
+    linesRead: number;
+    /** Set once `maxLines` was hit: later lines are dropped, not delivered. */
+    truncated: boolean;
+    /** The open/spawn error, when the source never became readable. */
+    error?: string;
+    /** Stops tailing / kills the child process group. Idempotent; never throws. */
+    close(): Promise<void>;
+    /**
+     * Synchronous best-effort kill (a `docker`/`cmd:` child only; a no-op for `file:`) — for use from
+     * a `process.on("exit", …)` handler, where async work is not possible. Idempotent.
+     */
+    killSync(): void;
+}
+/**
+ * Opens one already-validated `--log-source`. Never throws: an unreadable/unspawnable source comes
+ * back with `.error` set rather than aborting a run that has other sources (the caller decides
+ * whether that's fatal — a `--log-defect` oracle must not count an unreadable source as "held").
+ */
+export declare function openLogSource(spec: LogSourceSpec, opts: LogSourceOpenOptions): LogSourceHandle;
+export declare function openLogSources(specs: readonly LogSourceSpec[], opts: LogSourceOpenOptions): LogSourceHandle[];
+/** Closes every handle, best-effort, in parallel. Never throws. */
+export declare function closeLogSources(handles: readonly LogSourceHandle[]): Promise<void>;