@glassmkr/crucible 0.10.4 → 0.12.0

package/dist/collect/dmesg-events.js

@@ -0,0 +1,196 @@
+// dmesg structured event parsing.
+//
+// dmesg is line-by-line text; several event classes carry structured
+// information that's currently parsed only by humans. C18 extracts
+// three well-formed classes that have the highest signal-to-noise:
+//
+//   - SCSI sense codes (sense key + ASC/ASCQ)
+//   - NVMe controller resets
+//   - ext4 remount-readonly (filesystem error)
+//
+// Per CC_SPEC_CRUCIBLE_C11_C18_FULL_BUNDLE_2026-05-19.md §4. Spec's
+// original list included PCIe AER + XFS; deferred from this release
+// per karpathy simplicity-first to keep regex patterns auditable. PCIe
+// AER format varies across kernel versions (5.x vs 6.x has distinct
+// shapes); XFS error patterns vary by mount option set. Adding both
+// would double the test surface without delivering proportional
+// operational value — accept-rate signal from the three included
+// classes is high. Future Crucible release picks them up if customer
+// signal warrants.
+//
+// Capability gating: dmesg missing or unreadable -> available: false.
+// Window: last 3600 seconds (one hour) by default. Events older than
+// the window are excluded.
+//
+// Dedup within snapshot: same (event_type, primary_id, error_class)
+// tuple within 60 seconds collapses to one entry; not implemented in
+// v1 (each occurrence ships as a separate event for now). Dashboard's
+// side can collapse if needed via cross-snapshot library primitives.
+import { run } from "../lib/exec.js";
+const WINDOW_SECONDS = 3600;
+/**
+ * SCSI sense codes. Format observed across kernel 5.x and 6.x:
+ *   sd 1:0:0:0: [sda] Sense Key : Medium Error [current]
+ *   sd 1:0:0:0: [sda] Add. Sense: Read retries exhausted
+ *
+ * We parse the Sense Key line; the Add. Sense line follows but is
+ * captured by a separate handler if surfaced. Sense Key alone is the
+ * canonical severity signal: Medium Error / Hardware Error / Aborted
+ * Command are P1 candidates.
+ */
+const SCSI_SENSE_HANDLER = {
+    event_type: "scsi_sense",
+    pattern: /sd\s+\S+:\s+\[(\w+)\]\s+Sense Key\s*:\s*([\w ]+?)(?:\s+\[(?:current|deferred)\])?\s*$/,
+    parse: (m) => {
+        const [, device, senseKey] = m;
+        const sk = senseKey.trim();
+        const severityMajor = sk === "Medium Error" ||
+            sk === "Hardware Error" ||
+            sk === "Aborted Command";
+        return {
+            event_type: "scsi_sense",
+            severity: severityMajor ? "critical" : "warning",
+            details: { device, sense_key: sk },
+        };
+    },
+};
+/**
+ * NVMe controller reset. Format:
+ *   nvme nvme0: I/O 256 QID 1 timeout, reset controller
+ *   nvme nvme0: I/O 256 QID 1 timeout, aborting
+ *
+ * Either pattern indicates a controller-side fault that the NVMe
+ * driver responded to with a reset. P1.
+ */
+const NVME_RESET_HANDLER = {
+    event_type: "nvme_reset",
+    pattern: /nvme\s+(nvme\d+):\s+.*?(timeout|reset|aborting|disabling)/i,
+    parse: (m) => {
+        const [, controller, action] = m;
+        return {
+            event_type: "nvme_reset",
+            severity: "critical",
+            details: { controller, action: action.toLowerCase() },
+        };
+    },
+};
+/**
+ * ext4 "Remounting filesystem read-only". The kernel only does this
+ * after detecting an inconsistency it can't recover from; always P0
+ * in Dashboard's filesystem_readonly rule.
+ *
+ *   EXT4-fs (sda1): Remounting filesystem read-only
+ *   EXT4-fs error (device sda1): __ext4_read_inode_lock:5234: ...
+ */
+const EXT4_READONLY_HANDLER = {
+    event_type: "ext4_remount_readonly",
+    pattern: /EXT4-fs\s+\(([^)]+)\):\s+Remounting filesystem read-only/,
+    parse: (m) => {
+        const [, device] = m;
+        return {
+            event_type: "ext4_remount_readonly",
+            severity: "critical",
+            details: { device, remount_readonly: true },
+        };
+    },
+};
+const HANDLERS = [
+    SCSI_SENSE_HANDLER,
+    NVME_RESET_HANDLER,
+    EXT4_READONLY_HANDLER,
+];
+export async function collectDmesgEvents() {
+    const empty = (reason) => ({
+        available: false,
+        reason,
+        events: [],
+        events_by_type: { scsi_sense: 0, nvme_reset: 0, ext4_remount_readonly: 0 },
+        window_seconds: WINDOW_SECONDS,
+    });
+    // `--time-format=iso` for kernel 5.10+; older kernels ignore the
+    // flag and produce relative-time output we tolerate downstream.
+    const out = await run("dmesg", ["--time-format=iso", "--no-pager", "--ctime"]).catch(() => null);
+    // Fall back without --time-format if first call fails (no privileges
+    // is more common than missing flag).
+    const dmesgOut = out ?? (await run("dmesg", ["--no-pager"]));
+    if (!dmesgOut) {
+        return empty("dmesg not readable (CAP_SYSLOG missing or kernel.dmesg_restrict=1?)");
+    }
+    const cutoffMs = Date.now() - WINDOW_SECONDS * 1000;
+    const events = parseDmesgOutput(dmesgOut, cutoffMs);
+    const eventsByType = {
+        scsi_sense: 0,
+        nvme_reset: 0,
+        ext4_remount_readonly: 0,
+    };
+    for (const e of events)
+        eventsByType[e.event_type]++;
+    return {
+        available: true,
+        events,
+        events_by_type: eventsByType,
+        window_seconds: WINDOW_SECONDS,
+    };
+}
+/**
+ * Parse a full dmesg output buffer; return structured events whose
+ * inferred timestamp is at or after `cutoffMs`. When the timestamp
+ * cannot be parsed (relative-time fallback), the event is included
+ * unconditionally (fail-open: better to over-report than silently
+ * drop a real hardware fault).
+ */
+export function parseDmesgOutput(raw, cutoffMs) {
+    const events = [];
+    for (const line of raw.split("\n")) {
+        if (!line.trim())
+            continue;
+        const ts = parseDmesgTimestamp(line);
+        if (ts !== null && ts < cutoffMs)
+            continue;
+        for (const handler of HANDLERS) {
+            const m = line.match(handler.pattern);
+            if (!m)
+                continue;
+            const partial = handler.parse(m, line);
+            if (!partial)
+                continue;
+            events.push({
+                timestamp_iso: ts !== null ? new Date(ts).toISOString() : new Date().toISOString(),
+                raw_line: line.trim(),
+                ...partial,
+            });
+            break; // one match per line
+        }
+    }
+    return events;
+}
+/**
+ * Extract a unix-ms timestamp from a dmesg line. Two shapes:
+ *   ISO:        "2026-05-19T12:34:56,789012+00:00 ..."  (--time-format=iso)
+ *   ctime:      "[Mon May 19 12:34:56 2026] ..."       (--ctime)
+ *
+ * Relative-time format ("[12345.678]") returns null (no absolute
+ * anchor available without `uptime`).
+ */
+export function parseDmesgTimestamp(line) {
+    const isoMatch = line.match(/^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:[,.]\d+)?(?:[+-]\d{2}:?\d{2}|Z)?)/);
+    if (isoMatch) {
+        // Normalise the comma fractional separator to dot.
+        const iso = isoMatch[1].replace(",", ".");
+        const t = Date.parse(iso);
+        return Number.isFinite(t) ? t : null;
+    }
+    const ctimeMatch = line.match(/^\[([A-Z][a-z]{2}\s+[A-Z][a-z]{2}\s+\d+\s+\d{2}:\d{2}:\d{2}\s+\d{4})\]/);
+    if (ctimeMatch) {
+        const t = Date.parse(ctimeMatch[1]);
+        return Number.isFinite(t) ? t : null;
+    }
+    return null;
+}
+export const __test_only = {
+    parseDmesgOutput,
+    parseDmesgTimestamp,
+    HANDLERS,
+    WINDOW_SECONDS,
+};
+//# sourceMappingURL=dmesg-events.js.map

package/dist/collect/dmesg-events.js.map

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

package/dist/collect/ethtool.d.ts

@@ -0,0 +1,29 @@
+export interface EthtoolInterface {
+    iface: string;
+    advertised_auto_negotiation: boolean | null;
+    advertised_link_modes: string[];
+}
+export interface EthtoolSnapshot {
+    available: boolean;
+    reason?: string;
+    interfaces: EthtoolInterface[];
+}
+export declare function collectEthtool(): Promise<EthtoolSnapshot>;
+/**
+ * Parse the relevant subset of `ethtool <iface>` output.
+ *
+ * The two fields of interest:
+ *
+ *   Advertised auto-negotiation: Yes|No
+ *   Advertised link modes:  10baseT/Half 10baseT/Full
+ *                           100baseT/Half 100baseT/Full
+ *                           1000baseT/Full
+ *
+ * Advertised link modes can span multiple lines (continuation lines
+ * are indented). We collect everything from the colon to the next
+ * non-continuation line.
+ */
+export declare function parseEthtoolOutput(iface: string, raw: string): EthtoolInterface;
+export declare const __test_only: {
+    parseEthtoolOutput: typeof parseEthtoolOutput;
+};

package/dist/collect/ethtool.js

@@ -0,0 +1,99 @@
+// ethtool advertised link-mode collection.
+//
+// network.ts collects current speed via /sys/class/net/<iface>/speed.
+// C15 (2026-05-19) adds the advertised modes from `ethtool <iface>` so
+// Dashboard's link_speed_mismatch rule can compare current vs highest
+// advertised. A 1 Gb/s link on a 10 Gb/s NIC isn't always wrong (the
+// switch port might also be 1 Gb/s) but is worth surfacing.
+//
+// Per CC_SPEC_CRUCIBLE_C11_C18_FULL_BUNDLE_2026-05-19.md §1.3.
+//
+// Capability gating: `ethtool` missing (some containers lack it) ->
+// available: false. Per-interface read failures are tolerated; the
+// snapshot ships data for whatever interfaces returned cleanly.
+import { readdirSync } from "fs";
+import { run } from "../lib/exec.js";
+const VIRTUAL_PREFIXES = ["lo", "veth", "docker", "br-", "virbr"];
+function listPhysicalInterfaces() {
+    try {
+        const all = readdirSync("/sys/class/net");
+        return all.filter((iface) => iface !== "lo" &&
+            !VIRTUAL_PREFIXES.some((p) => iface.startsWith(p)));
+    }
+    catch {
+        return [];
+    }
+}
+export async function collectEthtool() {
+    const probe = await run("ethtool", ["--version"]);
+    if (!probe) {
+        return {
+            available: false,
+            reason: "ethtool not installed",
+            interfaces: [],
+        };
+    }
+    const interfaces = listPhysicalInterfaces();
+    if (interfaces.length === 0) {
+        return { available: true, interfaces: [] };
+    }
+    const results = [];
+    for (const iface of interfaces) {
+        const out = await run("ethtool", [iface]);
+        if (!out)
+            continue; // per-interface read failure tolerated
+        results.push(parseEthtoolOutput(iface, out));
+    }
+    return { available: true, interfaces: results };
+}
+/**
+ * Parse the relevant subset of `ethtool <iface>` output.
+ *
+ * The two fields of interest:
+ *
+ *   Advertised auto-negotiation: Yes|No
+ *   Advertised link modes:  10baseT/Half 10baseT/Full
+ *                           100baseT/Half 100baseT/Full
+ *                           1000baseT/Full
+ *
+ * Advertised link modes can span multiple lines (continuation lines
+ * are indented). We collect everything from the colon to the next
+ * non-continuation line.
+ */
+export function parseEthtoolOutput(iface, raw) {
+    const lines = raw.split("\n");
+    let auto = null;
+    const modes = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (/^\s*Advertised auto-negotiation:/i.test(line)) {
+            const val = line.split(":").slice(1).join(":").trim();
+            auto = val.toLowerCase() === "yes";
+        }
+        else if (/^\s*Advertised link modes:/i.test(line)) {
+            // Continuation lines are indented and have no colon at the
+            // expected key position. Walk forward until we hit a line that
+            // looks like a new key (Word: at start).
+            let buf = line.split(":").slice(1).join(":").trim();
+            for (let j = i + 1; j < lines.length; j++) {
+                const cont = lines[j];
+                if (/^\s*[A-Za-z][^:]*:/.test(cont) && !/^\s/.test(cont))
+                    break;
+                if (!/^\s+\S/.test(cont))
+                    break;
+                buf += " " + cont.trim();
+            }
+            for (const token of buf.split(/\s+/)) {
+                if (token.length > 0)
+                    modes.push(token);
+            }
+        }
+    }
+    return {
+        iface,
+        advertised_auto_negotiation: auto,
+        advertised_link_modes: modes,
+    };
+}
+export const __test_only = { parseEthtoolOutput };
+//# sourceMappingURL=ethtool.js.map

package/dist/collect/ethtool.js.map

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

package/dist/collect/fd.d.ts

@@ -4,4 +4,50 @@ export interface FileDescriptorData {
     max: number;
     percent: number;
 }
+export interface ProcessFdEntry {
+    pid: number;
+    comm: string;
+    fd_count: number;
+    rlimit_nofile_soft: number;
+    rlimit_nofile_hard: number;
+    percent_of_soft_limit: number;
+}
+export interface ProcessFdSnapshot {
+    available: boolean;
+    reason?: string;
+    top_consumers: ProcessFdEntry[];
+    total_processes_scanned: number;
+    highest_percent_of_limit: number | null;
+}
 export declare function collectFileDescriptors(): FileDescriptorData;
+/**
+ * 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 declare function collectProcessFd(): ProcessFdSnapshot;
+/**
+ * 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).
+ */
+declare function parseOpenFilesLimit(raw: string): {
+    soft: number;
+    hard: number;
+} | null;
+export declare const __test_only: {
+    parseOpenFilesLimit: typeof parseOpenFilesLimit;
+    TOP_N: number;
+};
+export {};

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":"AAAA,8BAA8B;AAC9B,EAAE;AACF,uEAAuE;AACvE,2EAA2E;AAC3E,EAAE;AACF,kFAAkF;AAClF,uEAAuE;AACvE,uEAAuE;AACvE,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,+DAA+D;AAE/D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA0B/C,MAAM,KAAK,GAAG,EAAE,CAAC;AAEjB,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;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,yBAAyB,OAAO,CAAC,GAAG,CAAC,EAAE;YAC/C,aAAa,EAAE,EAAE;YACjB,uBAAuB,EAAE,CAAC;YAC1B,wBAAwB,EAAE,IAAI;SAC/B,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,MAAM,QAAQ,GAA6C,EAAE,CAAC;IAC9D,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;YAAE,SAAS;QACjD,OAAO,EAAE,CAAC;QACV,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,WAAW,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC;YAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;QACrE,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAE5C,yDAAyD;IACzD,MAAM,aAAa,GAAqB,EAAE,CAAC;IAC3C,KAAK,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,UAAU,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,eAAe,CAAC,SAAS,GAAG,OAAO,CAAC,CAAC;QAClD,IAAI,IAAI,KAAK,IAAI;YAAE,SAAS,CAAC,uBAAuB;QACpD,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;QACtD,IAAI,MAAM,KAAK,IAAI;YAAE,SAAS;QAC9B,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM;YAAE,SAAS,CAAC,0BAA0B;QACjD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9B,MAAM,OAAO,GACX,IAAI,GAAG,CAAC;YACN,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE;YAC3C,CAAC,CAAC,CAAC,CAAC;QACR,aAAa,CAAC,IAAI,CAAC;YACjB,GAAG;YACH,IAAI;YACJ,QAAQ;YACR,kBAAkB,EAAE,IAAI;YACxB,kBAAkB,EAAE,IAAI;YACxB,qBAAqB,EAAE,OAAO;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GACX,aAAa,CAAC,MAAM,GAAG,CAAC;QACtB,CAAC,CAAC,aAAa,CAAC,MAAM,CAClB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,qBAAqB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,EACrE,CAAC,CACF;QACH,CAAC,CAAC,IAAI,CAAC;IAEX,OAAO;QACL,SAAS,EAAE,IAAI;QACf,aAAa;QACb,uBAAuB,EAAE,OAAO;QAChC,wBAAwB,EAAE,OAAO;KAClC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,GAAY;IAC3B,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QACpD,MAAM,IAAI,GAAI,GAAyB,CAAC,IAAI,CAAC;QAC7C,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;IAC5C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,mBAAmB,CAC1B,GAAW;IAEX,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;YAAE,SAAS;QACjD,sEAAsE;QACtE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAChD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,eAAe,CAAC,CAAS;IAChC,IAAI,CAAC,KAAK,WAAW;QAAE,OAAO,CAAC,CAAC,CAAC,4CAA4C;IAC7E,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,mBAAmB;IACnB,KAAK;CACN,CAAC"}

package/dist/collect/ipmi.d.ts

@@ -1,4 +1,17 @@
-import type { IpmiInfo, FanStatus, Vendor, IpmiCapability } from "../lib/types.js";
+import type { BmcVendor, IpmiInfo, FanStatus, Vendor, IpmiCapability } from "../lib/types.js";
+/**
+ * C11 (2026-05-19): map DMI vendor to BMC vendor + parser quality tier.
+ *
+ * Fleet-tested: dell, hpe, supermicro (years of fleet validation; SEL
+ *   classifier confirmed against real-host event streams).
+ * Stub: lenovo, cisco, openbmc (parser ships but unvalidated against
+ *   real fleet data; first real customer per vendor surfaces gaps).
+ * Unknown: everything else (asrockrack, inspur, generic, virtual, ...);
+ *   classifier still runs (it's keyword-driven, vendor-agnostic) but
+ *   we tag the events honestly.
+ */
+declare function mapVendorToBmcVendor(vendor: Vendor): BmcVendor;
+declare function parserQualityFor(bmcVendor: BmcVendor): "fleet-tested" | "stub" | "unknown";
 /**
  * Collect IPMI snapshot.
  *
@@ -10,6 +23,10 @@ import type { IpmiInfo, FanStatus, Vendor, IpmiCapability } from "../lib/types.j
  *                    and back-compat).
  */
 export declare function collectIpmi(vendor?: Vendor, capability?: IpmiCapability): Promise<IpmiInfo>;
+export declare const __test_only_c11: {
+    mapVendorToBmcVendor: typeof mapVendorToBmcVendor;
+    parserQualityFor: typeof parserQualityFor;
+};
 /**
  * Re-parse the full SEL elist counting ECC events on the Memory entity.
  * Used for vendors (notably Dell) that don't expose ECC counters as
@@ -29,3 +46,4 @@ export declare function parseSelTimestamp(date: string, time: string): string;
 export declare function classifySensor(sensor: string): string;
 export declare function deriveSelSeverity(event: string, sensorType: string): string;
 export declare function parseFanStatus(output: string): FanStatus[];
+export {};

package/dist/collect/ipmi.js

@@ -1,4 +1,34 @@
 import { run } from "../lib/exec.js";
+/**
+ * C11 (2026-05-19): map DMI vendor to BMC vendor + parser quality tier.
+ *
+ * Fleet-tested: dell, hpe, supermicro (years of fleet validation; SEL
+ *   classifier confirmed against real-host event streams).
+ * Stub: lenovo, cisco, openbmc (parser ships but unvalidated against
+ *   real fleet data; first real customer per vendor surfaces gaps).
+ * Unknown: everything else (asrockrack, inspur, generic, virtual, ...);
+ *   classifier still runs (it's keyword-driven, vendor-agnostic) but
+ *   we tag the events honestly.
+ */
+function mapVendorToBmcVendor(vendor) {
+    if (vendor === "dell" || vendor === "hpe" || vendor === "supermicro")
+        return vendor;
+    if (vendor === "lenovo" || vendor === "cisco")
+        return vendor;
+    // OpenBMC isn't a DMI vendor; it would surface as "generic" with a
+    // BMC manufacturer of "OpenBMC Project" in ipmitool mc info. We'd
+    // need to probe that to identify; deferred to a follow-up.
+    return "unknown";
+}
+function parserQualityFor(bmcVendor) {
+    if (bmcVendor === "dell" || bmcVendor === "hpe" || bmcVendor === "supermicro") {
+        return "fleet-tested";
+    }
+    if (bmcVendor === "lenovo" || bmcVendor === "cisco" || bmcVendor === "openbmc") {
+        return "stub";
+    }
+    return "unknown";
+}
 import { isPsuRedundancySensor, classifyPsuRedundancyState } from "../lib/vendor-sensors.js";
 import { filterRedundantCpuDtsSensors } from "../lib/ipmi-sensor-filter.js";
 /**
@@ -83,8 +113,13 @@ export async function collectIpmi(vendor = "generic", capability) {
         if (match)
             selCount = parseInt(match[1], 10);
     }
-    // SEL recent events
-    const selEvents = await collectSelEvents();
+    // SEL recent events. C11 (2026-05-19): tag each event with the BMC
+    // vendor's parser_quality so Dashboard can render an honesty surface
+    // for stub-parser BMCs (Lenovo, Cisco, OpenBMC).
+    const bmcVendor = mapVendorToBmcVendor(vendor);
+    const selParserQuality = parserQualityFor(bmcVendor);
+    const selEventsRaw = await collectSelEvents();
+    const selEvents = selEventsRaw.map((e) => ({ ...e, parser_quality: selParserQuality }));
     // ECC errors from SEL events (Dell iDRAC reports memory ECC only via SEL).
     // Counts ALL events since last SEL clear, not just the recent window —
     // re-parse the full SEL elist for accurate cumulative counts.
@@ -104,6 +139,7 @@ export async function collectIpmi(vendor = "generic", capability) {
     const fans = await collectFanStatus();
     return {
         available: true,
+        bmc_vendor: bmcVendor,
         sensors,
         ecc_errors: { correctable, uncorrectable },
         ecc_errors_from_sel: selEccCounts,
@@ -114,6 +150,7 @@ export async function collectIpmi(vendor = "generic", capability) {
         detection: capability,
     };
 }
+export const __test_only_c11 = { mapVendorToBmcVendor, parserQualityFor };
 /**
  * Re-parse the full SEL elist counting ECC events on the Memory entity.
  * Used for vendors (notably Dell) that don't expose ECC counters as