@glassmkr/crucible 0.10.3 → 0.11.0

package/dist/collect/fd.js

@@ -1,4 +1,18 @@
+// File descriptor collection.
+//
+// Host-wide path (collectFileDescriptors): reads /proc/sys/fs/file-nr.
+// Predates C7; still consumed by dashboard's host-wide fd_exhaustion path.
+//
+// Per-process path (collectProcessFd): reads /proc/<pid>/fd/ + /proc/<pid>/limits
+// to surface processes approaching their RLIMIT_NOFILE soft limit. Per
+// CC_SPEC_CRUCIBLE_C7_C10_NETWORK_PROCESS_COLLECTION_2026-05-19.md §1.
+//
+// Two-pass strategy: cheap readdir over /proc to count FDs per PID, then
+// expensive read of limits + comm only for the top 50 consumers. Process-
+// disappeared races are tolerated silently (ENOENT swallowed).
+import { readdirSync, readFileSync } from "fs";
 import { readProcFile } from "../lib/parse.js";
+const TOP_N = 50;
 export function collectFileDescriptors() {
     const raw = readProcFile("/proc/sys/fs/file-nr");
     if (!raw) {
@@ -17,4 +31,138 @@ export function collectFileDescriptors() {
     const percent = Math.round(((allocated / max) * 100) * 10) / 10;
     return { allocated, free: isNaN(free) ? 0 : free, max, percent };
 }
+/**
+ * Per-process FD scan. Walks /proc, counts FDs per PID, then reads
+ * `/proc/<pid>/limits` for the top-N consumers to compute proximity
+ * to each process's RLIMIT_NOFILE soft limit.
+ *
+ * Returns `{ available: false }` when /proc/1 is not a directory
+ * (essentially never on Linux; defensive).
+ */
+export function collectProcessFd() {
+    let pidNames;
+    try {
+        pidNames = readdirSync("/proc");
+    }
+    catch (err) {
+        return {
+            available: false,
+            reason: `/proc not accessible: ${errCode(err)}`,
+            top_consumers: [],
+            total_processes_scanned: 0,
+            highest_percent_of_limit: null,
+        };
+    }
+    // Cheap pass: just count FDs per numeric PID directory.
+    const fdCounts = [];
+    let scanned = 0;
+    for (const entry of pidNames) {
+        const pid = Number(entry);
+        if (!Number.isInteger(pid) || pid <= 0)
+            continue;
+        scanned++;
+        try {
+            const fds = readdirSync(`/proc/${pid}/fd`);
+            fdCounts.push({ pid, fd_count: fds.length });
+        }
+        catch {
+            // Process disappeared or no permission to read fd/; skip silently.
+        }
+    }
+    // Top-N by fd_count.
+    fdCounts.sort((a, b) => b.fd_count - a.fd_count);
+    const candidates = fdCounts.slice(0, TOP_N);
+    // Expensive pass: read comm + limits for the candidates.
+    const top_consumers = [];
+    for (const { pid, fd_count } of candidates) {
+        const comm = safeReadTrimmed(`/proc/${pid}/comm`);
+        if (comm === null)
+            continue; // Process disappeared.
+        const limits = safeReadTrimmed(`/proc/${pid}/limits`);
+        if (limits === null)
+            continue;
+        const parsed = parseOpenFilesLimit(limits);
+        if (!parsed)
+            continue; // Malformed limits; skip.
+        const { soft, hard } = parsed;
+        const percent = soft > 0
+            ? Math.round((fd_count / soft) * 1000) / 10
+            : 0;
+        top_consumers.push({
+            pid,
+            comm,
+            fd_count,
+            rlimit_nofile_soft: soft,
+            rlimit_nofile_hard: hard,
+            percent_of_soft_limit: percent,
+        });
+    }
+    const highest = top_consumers.length > 0
+        ? top_consumers.reduce((m, e) => (e.percent_of_soft_limit > m ? e.percent_of_soft_limit : m), 0)
+        : null;
+    return {
+        available: true,
+        top_consumers,
+        total_processes_scanned: scanned,
+        highest_percent_of_limit: highest,
+    };
+}
+function safeReadTrimmed(path) {
+    try {
+        return readFileSync(path, "utf-8").trim();
+    }
+    catch {
+        return null;
+    }
+}
+function errCode(err) {
+    if (err && typeof err === "object" && "code" in err) {
+        const code = err.code;
+        if (typeof code === "string")
+            return code;
+    }
+    return "unknown";
+}
+/**
+ * Parse the "Max open files" line from /proc/<pid>/limits.
+ *
+ * Format (fixed-width, header + rows):
+ *   Limit                     Soft Limit           Hard Limit           Units
+ *   Max open files            1024                 4096                 files
+ *
+ * Returns null when the line is missing or fields are unparseable.
+ * "unlimited" maps to Infinity which Number.MAX_SAFE_INTEGER would
+ * misrepresent; we use 0 as a sentinel meaning "no useful soft limit"
+ * which makes percent_of_soft_limit zero (and the dashboard rule
+ * treats that as a no-emission case).
+ */
+function parseOpenFilesLimit(raw) {
+    for (const line of raw.split("\n")) {
+        if (!line.startsWith("Max open files"))
+            continue;
+        // After the label there are at least two whitespace-separated values.
+        const rest = line.slice("Max open files".length).trim();
+        const parts = rest.split(/\s+/);
+        if (parts.length < 2)
+            return null;
+        const soft = parseLimitValue(parts[0]);
+        const hard = parseLimitValue(parts[1]);
+        if (soft === null || hard === null)
+            return null;
+        return { soft, hard };
+    }
+    return null;
+}
+function parseLimitValue(v) {
+    if (v === "unlimited")
+        return 0; // sentinel; see parseOpenFilesLimit comment
+    const n = Number(v);
+    if (!Number.isFinite(n) || n < 0)
+        return null;
+    return n;
+}
+export const __test_only = {
+    parseOpenFilesLimit,
+    TOP_N,
+};
 //# sourceMappingURL=fd.js.map

package/dist/collect/fd.js.map

@@ -1 +1 @@
-{"version":3,"file":"fd.js","sourceRoot":"","sources":["../../src/collect/fd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAS/C,MAAM,UAAU,sBAAsB;IACpC,MAAM,GAAG,GAAG,YAAY,CAAC,sBAAsB,CAAC,CAAC;IACjD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEnC,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;IAChE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AACnE,CAAC"}
+{"version":3,"file":"fd.js","sourceRoot":"","sources":["../../src/collect/fd.ts"],"names":[],"mappings":"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"}

package/dist/collect/hardware-raid.d.ts

@@ -0,0 +1,2 @@
+import type { HardwareRaidSnapshot } from "../lib/types.js";
+export declare function collectHardwareRaid(): Promise<HardwareRaidSnapshot | null>;

package/dist/collect/hardware-raid.js

@@ -0,0 +1,152 @@
+// Hardware RAID controller scraping.
+//
+// Per CC_SPEC_FORGE_FOLLOWUP_C1_C6_ACTIVATION_2026-05-19.md (C5).
+//
+// Detects four vendor CLIs:
+//   - perccli  (Dell PERC)
+//   - ssacli   (HPE Smart Array)
+//   - storcli  (LSI / Broadcom MegaRAID)
+//   - arcconf  (Adaptec)
+//
+// For each installed CLI, queries the controller state and returns
+// a normalized HardwareRaidController. The vendor-specific output
+// formats vary considerably; this module's parsers are intentionally
+// conservative — they extract a state string ("Optimal", "Degraded",
+// etc.) plus an optional degraded_disks counter when the vendor output
+// makes it easy to find. The dashboard's raid_degraded evaluator pages
+// on any state != "Optimal"; that's the contract.
+//
+// Implementation scope (2026-05-19): perccli + storcli parsers are
+// best-effort because the validation fleet has no hardware RAID
+// controllers to verify against. Real parsing precision lands in
+// follow-up PRs as customers with each vendor surface. The framework
+// here ensures:
+//   - empty controllers[] on hosts without any vendor CLI (capability
+//     gate; dashboard rule no-ops),
+//   - empty controllers[] on hosts with the CLI but no controllers
+//     present (rare configurations).
+//
+// The dashboard's mdadm path is unaffected by this module.
+import { run } from "../lib/exec.js";
+async function hasCli(name) {
+    const out = await run("which", [name], 2000);
+    return !!(out && out.trim());
+}
+async function scrapePerccli() {
+    // perccli /c0 show all J — JSON output for controller 0.
+    // Multi-controller hosts are rare; query c0 only and let follow-ups
+    // expand if a customer surfaces multi-controller hardware.
+    const raw = await run("perccli", ["/c0", "show", "all", "J"], 10000);
+    if (!raw)
+        return [];
+    try {
+        const obj = JSON.parse(raw);
+        const ctrlList = obj?.Controllers ?? [];
+        return ctrlList.map((c) => ({
+            vendor: "dell",
+            controller_id: String(c?.["Command Status"]?.Controller ?? "0"),
+            state: String(c?.["Response Data"]?.["Status"]?.["Controller Status"] ?? "Unknown"),
+            degraded_disks: null,
+            raw_summary: null,
+        }));
+    }
+    catch {
+        // Output wasn't JSON (older perccli, or controller missing).
+        return [];
+    }
+}
+async function scrapeStorcli() {
+    const raw = await run("storcli", ["/call", "show", "all", "J"], 10000);
+    if (!raw)
+        return [];
+    try {
+        const obj = JSON.parse(raw);
+        const ctrlList = obj?.Controllers ?? [];
+        return ctrlList.map((c) => ({
+            vendor: "lsi",
+            controller_id: String(c?.["Command Status"]?.Controller ?? "?"),
+            state: String(c?.["Response Data"]?.["Status"]?.["Controller Status"] ?? "Unknown"),
+            degraded_disks: null,
+            raw_summary: null,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+async function scrapeSsacli() {
+    // ssacli ctrl all show — text format. Conservative: extract one
+    // line per "in slot X" entry; status reported on a "Controller Status"
+    // line. Real parsing lands when an HPE customer surfaces.
+    const raw = await run("ssacli", ["ctrl", "all", "show", "status"], 10000);
+    if (!raw)
+        return [];
+    const lines = raw.split("\n").map((l) => l.trim()).filter(Boolean);
+    const controllers = [];
+    let pending = null;
+    for (const line of lines) {
+        const slotMatch = line.match(/in Slot (\S+)/);
+        if (slotMatch) {
+            if (pending)
+                controllers.push(pendingToController(pending));
+            pending = { slot: slotMatch[1], status: "Unknown" };
+            continue;
+        }
+        const statusMatch = line.match(/Controller Status:\s*(.+)/);
+        if (statusMatch && pending)
+            pending.status = statusMatch[1].trim();
+    }
+    if (pending)
+        controllers.push(pendingToController(pending));
+    return controllers;
+}
+function pendingToController(p) {
+    return {
+        vendor: "hpe",
+        controller_id: p.slot,
+        state: p.status,
+        degraded_disks: null,
+        raw_summary: null,
+    };
+}
+async function scrapeArcconf() {
+    // arcconf has no JSON mode. Best-effort: detect controllers via
+    // `arcconf list` and surface a placeholder state. Real parser
+    // for Adaptec lands when a customer surfaces.
+    const raw = await run("arcconf", ["list"], 10000);
+    if (!raw)
+        return [];
+    const controllers = [];
+    for (const line of raw.split("\n")) {
+        const m = line.match(/Controller (\d+):/i);
+        if (m) {
+            controllers.push({
+                vendor: "adaptec",
+                controller_id: m[1],
+                state: "Unknown",
+                degraded_disks: null,
+                raw_summary: "arcconf parsing pending — surface a customer with Adaptec hardware",
+            });
+        }
+    }
+    return controllers;
+}
+export async function collectHardwareRaid() {
+    const hasPerccli = await hasCli("perccli");
+    const hasStorcli = await hasCli("storcli");
+    const hasSsacli = await hasCli("ssacli");
+    const hasArcconf = await hasCli("arcconf");
+    if (!hasPerccli && !hasStorcli && !hasSsacli && !hasArcconf)
+        return null;
+    const controllers = [];
+    if (hasPerccli)
+        controllers.push(...(await scrapePerccli()));
+    if (hasStorcli)
+        controllers.push(...(await scrapeStorcli()));
+    if (hasSsacli)
+        controllers.push(...(await scrapeSsacli()));
+    if (hasArcconf)
+        controllers.push(...(await scrapeArcconf()));
+    return { controllers };
+}
+//# sourceMappingURL=hardware-raid.js.map

package/dist/collect/hardware-raid.js.map

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

package/dist/collect/psi.d.ts

@@ -0,0 +1,20 @@
+import type { PsiResource, PsiSnapshot } from "../lib/types.js";
+declare function parsePsiLine(line: string): PsiResource | null;
+interface PsiFile {
+    some: PsiResource;
+    /** Only present for memory + io; cpu has no "full" line in current kernels. */
+    full?: PsiResource;
+}
+declare function parsePsiFile(contents: string): PsiFile | null;
+/**
+ * Collect PSI for all three resources. Returns null if /proc/pressure/
+ * is unavailable (older kernel or PSI disabled). Per resource: returns
+ * undefined if that specific file is unreadable (rare; usually all
+ * three present or none).
+ */
+export declare function collectPsi(): PsiSnapshot | null;
+export declare const __test_only: {
+    parsePsiLine: typeof parsePsiLine;
+    parsePsiFile: typeof parsePsiFile;
+};
+export {};

package/dist/collect/psi.js

@@ -0,0 +1,90 @@
+// PSI (Pressure Stall Information) collection.
+//
+// Reads /proc/pressure/{cpu,memory,io}. The kernel exposes this on
+// 4.20+ when PSI is compiled in (most modern distros). Older kernels
+// or those built without `CONFIG_PSI=y` return an empty result; the
+// snapshot then omits the `psi` field entirely, and the dashboard
+// alert evaluator's capability gates treat that as `available: false`.
+//
+// Per CC_SPEC_FORGE_FOLLOWUP_C1_C6_ACTIVATION_2026-05-19.md (C2).
+//
+// File format (all three resources share the same shape):
+//
+//   some avg10=0.06 avg60=0.04 avg300=0.05 total=12345
+//   full avg10=0.00 avg60=0.00 avg300=0.00 total=678
+//
+// "some" = % of time at least one task was stalled on the resource.
+// "full" = % of time ALL non-idle tasks were stalled (only present
+//          for memory and io; cpu has only "some" per kernel docs).
+// "total" = cumulative microseconds since boot.
+import { readProcFile } from "../lib/parse.js";
+function parsePsiLine(line) {
+    // Expect: "some avg10=N avg60=N avg300=N total=N"
+    const parts = line.trim().split(/\s+/);
+    if (parts.length < 5)
+        return null;
+    const out = {};
+    for (const part of parts.slice(1)) {
+        const [k, v] = part.split("=");
+        if (k === "avg10")
+            out.avg10 = parseFloat(v);
+        else if (k === "avg60")
+            out.avg60 = parseFloat(v);
+        else if (k === "avg300")
+            out.avg300 = parseFloat(v);
+        else if (k === "total")
+            out.total = parseInt(v, 10);
+    }
+    if (out.avg10 === undefined ||
+        out.avg60 === undefined ||
+        out.avg300 === undefined ||
+        out.total === undefined) {
+        return null;
+    }
+    return out;
+}
+function parsePsiFile(contents) {
+    let some = null;
+    let full = null;
+    for (const line of contents.split("\n")) {
+        if (line.startsWith("some "))
+            some = parsePsiLine(line);
+        else if (line.startsWith("full "))
+            full = parsePsiLine(line);
+    }
+    if (!some)
+        return null;
+    return full ? { some, full } : { some };
+}
+/**
+ * Collect PSI for all three resources. Returns null if /proc/pressure/
+ * is unavailable (older kernel or PSI disabled). Per resource: returns
+ * undefined if that specific file is unreadable (rare; usually all
+ * three present or none).
+ */
+export function collectPsi() {
+    const cpu = readProcFile("/proc/pressure/cpu");
+    const memory = readProcFile("/proc/pressure/memory");
+    const io = readProcFile("/proc/pressure/io");
+    if (!cpu && !memory && !io)
+        return null;
+    const out = {};
+    if (cpu) {
+        const parsed = parsePsiFile(cpu);
+        if (parsed)
+            out.cpu = parsed;
+    }
+    if (memory) {
+        const parsed = parsePsiFile(memory);
+        if (parsed)
+            out.memory = parsed;
+    }
+    if (io) {
+        const parsed = parsePsiFile(io);
+        if (parsed)
+            out.io = parsed;
+    }
+    return Object.keys(out).length > 0 ? out : null;
+}
+export const __test_only = { parsePsiLine, parsePsiFile };
+//# sourceMappingURL=psi.js.map

package/dist/collect/psi.js.map

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

package/dist/collect/reboot-evidence.d.ts

@@ -0,0 +1,2 @@
+import type { RebootEvidence } from "../lib/types.js";
+export declare function collectRebootEvidence(): Promise<RebootEvidence>;

package/dist/collect/reboot-evidence.js

@@ -0,0 +1,109 @@
+// Reboot-evidence collection: pstore + kdump + wtmp.
+//
+// Per CC_SPEC_FORGE_FOLLOWUP_C1_C6_ACTIVATION_2026-05-19.md (C4).
+//
+// Three independent signals corroborate a reboot:
+//
+//   - /sys/fs/pstore/    — persistent storage records the kernel
+//     wrote during the previous shutdown / panic. Presence of
+//     dmesg-* records indicates the prior kernel left a forensic
+//     trail before halting.
+//
+//   - /var/crash/        — kdump's vmcore dump from the prior
+//     kernel panic. Path varies by distro; check the standard
+//     location plus the systemd default.
+//
+//   - wtmp                — accounting log. `last reboot -F` shows
+//     `reboot system boot ...` events plus optional `shutdown`
+//     events that preceded them. A clean shutdown (poweroff/halt)
+//     produces a `shutdown` record; a hard reset or power loss
+//     leaves only the boot record with no prior shutdown.
+//
+// The dashboard's unexpected_reboot rule consumes this to enrich
+// the alert's evidence; the kernel_panic_detected rule (C4
+// follow-up) consumes pstore_present + vmcore_present to fire its
+// own P0 alert.
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { run } from "../lib/exec.js";
+const PSTORE_PATH = "/sys/fs/pstore";
+const VAR_CRASH_PATH = "/var/crash";
+function pstoreRecords() {
+    try {
+        const entries = readdirSync(PSTORE_PATH);
+        return entries.filter((n) => n.startsWith("dmesg-") || n.startsWith("console-") || n.startsWith("ftrace-"));
+    }
+    catch {
+        return [];
+    }
+}
+function vmcorePresent() {
+    try {
+        if (!existsSync(VAR_CRASH_PATH))
+            return false;
+        // /var/crash typically contains dated subdirectories per crash
+        // (e.g. /var/crash/2026-05-13-04:22:54/vmcore). Recursive check
+        // would be expensive; we just check if any subdirectory contains
+        // a file named `vmcore` or `vmcore.flat`.
+        const top = readdirSync(VAR_CRASH_PATH);
+        for (const sub of top) {
+            try {
+                const subPath = `${VAR_CRASH_PATH}/${sub}`;
+                const st = statSync(subPath);
+                if (!st.isDirectory())
+                    continue;
+                const children = readdirSync(subPath);
+                if (children.some((c) => c === "vmcore" || c === "vmcore.flat" || c.startsWith("vmcore."))) {
+                    return true;
+                }
+            }
+            catch {
+                // Skip unreadable subdirs.
+            }
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+async function readWtmp() {
+    const output = await run("last", ["reboot", "-F"], 5000);
+    if (!output) {
+        return { last_reboot_raw: null, prior_shutdown_clean: false };
+    }
+    const lines = output.split("\n").filter((l) => l.trim().length > 0);
+    // The first non-empty line is the most recent reboot record.
+    const lastReboot = lines[0] ?? null;
+    // Look for a `shutdown` record between the most recent reboot and
+    // the second-most-recent reboot. `last -F` interleaves shutdown
+    // records when present; on a clean shutdown they sit immediately
+    // before the boot record.
+    const shutdownOutput = await run("last", ["shutdown", "-F"], 5000);
+    let priorShutdownClean = false;
+    if (shutdownOutput && lastReboot) {
+        // Extract a date marker from the lastReboot line; if any shutdown
+        // record predates this reboot by <= 5 minutes, treat as clean.
+        // Conservative: if any shutdown record exists in the wtmp at all,
+        // assume the most recent one was clean. Defensive against parsing
+        // glitches; refined by the dashboard evaluator.
+        const sLines = shutdownOutput.split("\n").filter((l) => l.trim().length > 0 && l.startsWith("shutdown"));
+        priorShutdownClean = sLines.length > 0;
+    }
+    return {
+        last_reboot_raw: lastReboot,
+        prior_shutdown_clean: priorShutdownClean,
+    };
+}
+export async function collectRebootEvidence() {
+    const records = pstoreRecords();
+    const vmcore = vmcorePresent();
+    const wtmp = await readWtmp();
+    return {
+        pstore_present: records.length > 0,
+        pstore_record_count: records.length,
+        vmcore_present: vmcore,
+        wtmp_reboot_record: wtmp.last_reboot_raw,
+        prior_shutdown_clean: wtmp.prior_shutdown_clean,
+    };
+}
+//# sourceMappingURL=reboot-evidence.js.map

package/dist/collect/reboot-evidence.js.map

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

package/dist/collect/tcp-stats.d.ts

@@ -0,0 +1,37 @@
+export interface TcpStatsSnapshot {
+    available: boolean;
+    reason?: string;
+    out_segs_total?: number;
+    retrans_segs_total?: number;
+    in_segs_total?: number;
+    retrans_ratio?: number | null;
+    retrans_rate_per_sec?: number | null;
+    listen_overflows_total?: number;
+    listen_drops_total?: number;
+    listen_overflows_rate_per_sec?: number | null;
+    listen_drops_rate_per_sec?: number | null;
+}
+export declare function collectTcpStats(): TcpStatsSnapshot;
+/**
+ * Parse /proc/net/snmp's `Tcp:` two-line section (header + values).
+ *
+ * Lines look like:
+ *   Tcp: RtoAlgorithm RtoMin ... InSegs OutSegs RetransSegs InErrs OutRsts InCsumErrors
+ *   Tcp: 1 200 ... 9876543 8765432 1234 0 100 0
+ */
+export declare function parseTcpSnmp(): {
+    out_segs: number;
+    retrans_segs: number;
+    in_segs: number;
+} | null;
+/**
+ * Parse /proc/net/netstat's `TcpExt:` two-line section for the listen-
+ * queue counters.
+ */
+export declare function parseTcpExt(): {
+    listen_overflows: number;
+    listen_drops: number;
+} | null;
+export declare const __test_only: {
+    resetForTests: () => void;
+};