@glassmkr/crucible 0.10.3 → 0.11.0

package/dist/collect/bonding.js

@@ -0,0 +1,246 @@
+// LACP partner state from /proc/net/bonding.
+//
+// Per CC_SPEC_CRUCIBLE_C7_C10_NETWORK_PROCESS_COLLECTION_2026-05-19.md §2.
+//
+// Existing network.ts has bond-master discovery (which interface is
+// slaved to which bond); this collector parses the bond protocol-level
+// state that bond_slave_down's MII check doesn't surface. A bond's
+// MII layer can report up while its LACP partner has timed out.
+//
+// LACP port state bitfield (IEEE 802.3ad clause 43.4.2.2):
+//   bit 0 (0x01): LACP Activity
+//   bit 1 (0x02): LACP Timeout
+//   bit 2 (0x04): Aggregation
+//   bit 3 (0x08): Synchronization
+//   bit 4 (0x10): Collecting
+//   bit 5 (0x20): Distributing
+//   bit 6 (0x40): Defaulted
+//   bit 7 (0x80): Expired
+//
+// A healthy partner reports Synchronization + Collecting + Distributing
+// (bits 3,4,5 set; aggregation usually also set). Loss of synchronization
+// is the signal this collector surfaces.
+import { readdirSync } from "fs";
+import { readProcFile } from "../lib/parse.js";
+const LACP_SYNCHRONIZATION_BIT = 0x08;
+export function collectBonding() {
+    let entries;
+    try {
+        entries = readdirSync("/proc/net/bonding");
+    }
+    catch (err) {
+        return {
+            available: false,
+            reason: bondReason(err),
+            bonds: [],
+        };
+    }
+    const bondNames = entries.filter((e) => /^bond/.test(e));
+    if (bondNames.length === 0) {
+        return { available: false, reason: "no bond interfaces", bonds: [] };
+    }
+    const bonds = [];
+    for (const name of bondNames) {
+        const raw = readProcFile(`/proc/net/bonding/${name}`);
+        if (!raw)
+            continue;
+        const parsed = parseBondFile(name, raw);
+        if (parsed)
+            bonds.push(parsed);
+    }
+    return { available: true, bonds };
+}
+function bondReason(err) {
+    if (err && typeof err === "object" && "code" in err) {
+        const code = err.code;
+        if (code === "ENOENT")
+            return "bonding module not loaded";
+        if (typeof code === "string") {
+            return `/proc/net/bonding not accessible: ${code}`;
+        }
+    }
+    return "/proc/net/bonding not accessible";
+}
+export function parseBondFile(name, raw) {
+    const lines = raw.split("\n");
+    // Parse the global bond-level block first (the part before any
+    // "Slave Interface:" block).
+    const slaveSectionStart = lines.findIndex((l) => l.startsWith("Slave Interface:"));
+    const globalLines = slaveSectionStart === -1 ? lines : lines.slice(0, slaveSectionStart);
+    let mode = "";
+    let lacpRate = null;
+    for (const line of globalLines) {
+        if (line.startsWith("Bonding Mode:")) {
+            mode = line.slice("Bonding Mode:".length).trim();
+        }
+        else if (line.startsWith("LACP rate:")) {
+            lacpRate = line.slice("LACP rate:".length).trim();
+        }
+    }
+    const isLacp = mode.includes("802.3ad");
+    // Optional Active Aggregator block (LACP only).
+    const activeAggregator = isLacp ? parseActiveAggregator(globalLines) : null;
+    // Per-slave blocks.
+    const slaves = [];
+    if (slaveSectionStart !== -1) {
+        let block = [];
+        for (let i = slaveSectionStart; i < lines.length; i++) {
+            const line = lines[i];
+            if (line.startsWith("Slave Interface:")) {
+                if (block.length > 0) {
+                    const slave = parseSlaveBlock(block);
+                    if (slave)
+                        slaves.push(slave);
+                }
+                block = [line];
+            }
+            else {
+                block.push(line);
+            }
+        }
+        if (block.length > 0) {
+            const slave = parseSlaveBlock(block);
+            if (slave)
+                slaves.push(slave);
+        }
+    }
+    return {
+        name,
+        mode,
+        is_lacp: isLacp,
+        lacp_rate: lacpRate,
+        slaves,
+        configured_port_count: slaves.length,
+        active_aggregator: activeAggregator,
+    };
+}
+function parseActiveAggregator(lines) {
+    const start = lines.findIndex((l) => l.trim().startsWith("Active Aggregator Info"));
+    if (start === -1)
+        return null;
+    // Indented key:value lines follow until a blank line or a non-indented
+    // line (typically the next section header).
+    let id = null;
+    let numberOfPorts = null;
+    let actorKey = null;
+    let partnerKey = null;
+    let partnerMac = null;
+    for (let i = start + 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === "" || /^\S/.test(line)) {
+            // End of indented block (blank line or new top-level section).
+            if (line.startsWith("Slave Interface"))
+                break;
+            if (line === "") {
+                // Indented block can include blank lines in some kernel versions;
+                // tolerate one blank but bail if the next line is non-indented.
+                continue;
+            }
+            break;
+        }
+        const m = line.match(/^\s*([^:]+):\s*(.+)$/);
+        if (!m)
+            continue;
+        const key = m[1].trim();
+        const val = m[2].trim();
+        if (key === "Aggregator ID")
+            id = parseIntSafe(val);
+        else if (key === "Number of ports")
+            numberOfPorts = parseIntSafe(val);
+        else if (key === "Actor Key")
+            actorKey = parseIntSafe(val);
+        else if (key === "Partner Key")
+            partnerKey = parseIntSafe(val);
+        else if (key === "Partner Mac Address")
+            partnerMac = val;
+    }
+    if (id === null || numberOfPorts === null)
+        return null;
+    return {
+        id,
+        number_of_ports: numberOfPorts,
+        actor_key: actorKey,
+        partner_key: partnerKey,
+        partner_mac_address: partnerMac,
+    };
+}
+function parseSlaveBlock(lines) {
+    let name = "";
+    let miiStatus = "";
+    let linkFailureCount = 0;
+    let hwAddr = "";
+    let aggregatorId = null;
+    let partnerChurn = null;
+    let partnerPortState = null;
+    let inPartnerPdu = false;
+    for (const line of lines) {
+        if (line.startsWith("Slave Interface:")) {
+            name = line.slice("Slave Interface:".length).trim();
+            inPartnerPdu = false;
+            continue;
+        }
+        if (line.startsWith("MII Status:")) {
+            miiStatus = line.slice("MII Status:".length).trim();
+            inPartnerPdu = false;
+            continue;
+        }
+        if (line.startsWith("Link Failure Count:")) {
+            linkFailureCount = parseIntSafe(line.slice("Link Failure Count:".length).trim()) ?? 0;
+            inPartnerPdu = false;
+            continue;
+        }
+        if (line.startsWith("Permanent HW addr:")) {
+            hwAddr = line.slice("Permanent HW addr:".length).trim();
+            inPartnerPdu = false;
+            continue;
+        }
+        if (line.startsWith("Aggregator ID:")) {
+            aggregatorId = parseIntSafe(line.slice("Aggregator ID:".length).trim());
+            inPartnerPdu = false;
+            continue;
+        }
+        if (line.startsWith("Partner Churn State:")) {
+            partnerChurn = line.slice("Partner Churn State:".length).trim();
+            inPartnerPdu = false;
+            continue;
+        }
+        if (/^\s*details partner lacp pdu:/.test(line)) {
+            inPartnerPdu = true;
+            continue;
+        }
+        if (/^\s*details actor lacp pdu:/.test(line)) {
+            inPartnerPdu = false;
+            continue;
+        }
+        if (inPartnerPdu) {
+            const m = line.match(/^\s*port state:\s*(\d+)/);
+            if (m) {
+                partnerPortState = parseIntSafe(m[1]);
+            }
+        }
+    }
+    if (!name)
+        return null;
+    const synchronized = partnerPortState !== null
+        ? (partnerPortState & LACP_SYNCHRONIZATION_BIT) !== 0
+        : null;
+    return {
+        name,
+        mii_status: miiStatus,
+        link_failure_count: linkFailureCount,
+        permanent_hw_addr: hwAddr,
+        aggregator_id: aggregatorId,
+        partner_churn_state: partnerChurn,
+        partner_lacp_port_state: partnerPortState,
+        partner_lacp_synchronized: synchronized,
+    };
+}
+function parseIntSafe(v) {
+    const n = Number.parseInt(v, 10);
+    return Number.isFinite(n) ? n : null;
+}
+export const __test_only = {
+    parseBondFile,
+    LACP_SYNCHRONIZATION_BIT,
+};
+//# sourceMappingURL=bonding.js.map

package/dist/collect/bonding.js.map

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

package/dist/collect/conntrack.d.ts

@@ -3,5 +3,24 @@ export interface ConntrackData {
     count: number;
     max: number;
     percent: number;
+    insert_failed_total?: number;
+    drop_total?: number;
+    insert_failed_rate_per_sec?: number | null;
+    drop_rate_per_sec?: number | null;
 }
 export declare function collectConntrack(): ConntrackData;
+/**
+ * Parse /proc/net/stat/nf_conntrack. Format: tab/space-separated header
+ * + one row per CPU with hex values. Returns sums across all CPUs for
+ * insert_failed and drop columns. Null on read failure or unexpected
+ * format.
+ */
+declare function parseConntrackStat(): {
+    insert_failed: number;
+    drop: number;
+} | null;
+export declare const __test_only: {
+    parseConntrackStat: typeof parseConntrackStat;
+    resetForTests: () => void;
+};
+export {};

package/dist/collect/conntrack.js

@@ -1,4 +1,13 @@
+// Conntrack collection.
+//
+// Pre-C9: count + max + percent from /proc/sys/net/netfilter/nf_conntrack_*.
+// C9 (2026-05-19): adds insert_failed_total + drop_total cumulative counters
+// from /proc/net/stat/nf_conntrack plus agent-computed per-second rates,
+// following the vmstat (C3) rate-calculation pattern.
+//
+// Per CC_SPEC_CRUCIBLE_C7_C10_NETWORK_PROCESS_COLLECTION_2026-05-19.md §3.
 import { readProcFile } from "../lib/parse.js";
+let previous = null;
 export function collectConntrack() {
     const countRaw = readProcFile("/proc/sys/net/netfilter/nf_conntrack_count");
     const maxRaw = readProcFile("/proc/sys/net/netfilter/nf_conntrack_max");
@@ -11,6 +20,78 @@ export function collectConntrack() {
         return { available: false, count: 0, max: 0, percent: 0 };
     }
     const percent = Math.round(((count / max) * 100) * 10) / 10;
-    return { available: true, count, max, percent };
+    // Try the C9 enrichment. If /proc/net/stat/nf_conntrack isn't readable
+    // we still return the original ConntrackData shape (older kernels
+    // expose count/max without per-CPU stats).
+    const stat = parseConntrackStat();
+    if (!stat) {
+        return { available: true, count, max, percent };
+    }
+    const nowMs = Date.now();
+    let insertRate = null;
+    let dropRate = null;
+    if (previous) {
+        const elapsedSec = (nowMs - previous.capturedAtMs) / 1000;
+        if (elapsedSec > 0) {
+            const insertDelta = stat.insert_failed - previous.insert_failed;
+            const dropDelta = stat.drop - previous.drop;
+            // Negative delta = counter reset (host reboot, container restart,
+            // or rollover). Treat as a fresh baseline; rates null this tick.
+            if (insertDelta >= 0)
+                insertRate = insertDelta / elapsedSec;
+            if (dropDelta >= 0)
+                dropRate = dropDelta / elapsedSec;
+        }
+    }
+    previous = { ...stat, capturedAtMs: nowMs };
+    return {
+        available: true,
+        count,
+        max,
+        percent,
+        insert_failed_total: stat.insert_failed,
+        drop_total: stat.drop,
+        insert_failed_rate_per_sec: insertRate,
+        drop_rate_per_sec: dropRate,
+    };
+}
+/**
+ * Parse /proc/net/stat/nf_conntrack. Format: tab/space-separated header
+ * + one row per CPU with hex values. Returns sums across all CPUs for
+ * insert_failed and drop columns. Null on read failure or unexpected
+ * format.
+ */
+function parseConntrackStat() {
+    const raw = readProcFile("/proc/net/stat/nf_conntrack");
+    if (!raw)
+        return null;
+    const lines = raw.split("\n").filter((l) => l.trim().length > 0);
+    if (lines.length < 2)
+        return null;
+    const header = lines[0].trim().split(/\s+/);
+    const insertFailedIdx = header.indexOf("insert_failed");
+    const dropIdx = header.indexOf("drop");
+    if (insertFailedIdx === -1 || dropIdx === -1)
+        return null;
+    let insertFailedTotal = 0;
+    let dropTotal = 0;
+    for (let i = 1; i < lines.length; i++) {
+        const parts = lines[i].trim().split(/\s+/);
+        if (parts.length <= Math.max(insertFailedIdx, dropIdx))
+            continue;
+        const insertFailed = parseInt(parts[insertFailedIdx], 16);
+        const drop = parseInt(parts[dropIdx], 16);
+        if (Number.isFinite(insertFailed))
+            insertFailedTotal += insertFailed;
+        if (Number.isFinite(drop))
+            dropTotal += drop;
+    }
+    return { insert_failed: insertFailedTotal, drop: dropTotal };
 }
+export const __test_only = {
+    parseConntrackStat,
+    resetForTests: () => {
+        previous = null;
+    },
+};
 //# sourceMappingURL=conntrack.js.map

package/dist/collect/conntrack.js.map

@@ -1 +1 @@
-{"version":3,"file":"conntrack.js","sourceRoot":"","sources":["../../src/collect/conntrack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAS/C,MAAM,UAAU,gBAAgB;IAC9B,MAAM,QAAQ,GAAG,YAAY,CAAC,4CAA4C,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,YAAY,CAAC,0CAA0C,CAAC,CAAC;IAExE,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC5D,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAExC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC5D,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;IAC5D,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAClD,CAAC"}
+{"version":3,"file":"conntrack.js","sourceRoot":"","sources":["../../src/collect/conntrack.ts"],"names":[],"mappings":"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"}

package/dist/collect/edac.d.ts

@@ -0,0 +1,2 @@
+import type { EdacSnapshot } from "../lib/types.js";
+export declare function collectEdac(): EdacSnapshot | null;

package/dist/collect/edac.js

@@ -0,0 +1,104 @@
+// EDAC (Error Detection and Correction) counter collection.
+//
+// Per CC_SPEC_FORGE_FOLLOWUP_C1_C6_ACTIVATION_2026-05-19.md (C1).
+//
+// Kernel surface: /sys/devices/system/edac/mc/mcN/{ce_count,ue_count}
+//   ce_count  = correctable errors (memory controller saw and fixed)
+//   ue_count  = uncorrectable errors (memory error couldn't be fixed;
+//               kernel may have killed the process or panicked)
+//
+// Per-DIMM granularity: /sys/devices/system/edac/mc/mcN/dimmM/
+//   dimm_ce_count, dimm_ue_count, dimm_label, dimm_location, size
+//
+// Capability gate: if no `mcN` directories exist under
+// /sys/devices/system/edac/mc/, EDAC is not loaded (no memory
+// controller driver compiled in or no DIMMs reporting) and this
+// collector returns null. The dashboard ecc_errors evaluator falls
+// back to its IPMI-SEL path.
+//
+// On hosts where EDAC is loaded but counters stay at zero, this
+// collector emits zero counters — that's the correct baseline.
+import { readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+const EDAC_ROOT = "/sys/devices/system/edac/mc";
+function readUint(path) {
+    try {
+        const s = readFileSync(path, "utf8").trim();
+        if (!/^\d+$/.test(s))
+            return null;
+        return parseInt(s, 10);
+    }
+    catch {
+        return null;
+    }
+}
+function readString(path) {
+    try {
+        return readFileSync(path, "utf8").trim();
+    }
+    catch {
+        return null;
+    }
+}
+function listMcDirs() {
+    try {
+        return readdirSync(EDAC_ROOT)
+            .filter((n) => /^mc\d+$/.test(n))
+            .map((n) => join(EDAC_ROOT, n));
+    }
+    catch {
+        return [];
+    }
+}
+function listDimmDirs(mcPath) {
+    try {
+        return readdirSync(mcPath)
+            .filter((n) => /^dimm\d+$/.test(n) || /^rank\d+$/.test(n))
+            .map((n) => join(mcPath, n));
+    }
+    catch {
+        return [];
+    }
+}
+function collectDimm(dimmPath) {
+    const ce = readUint(join(dimmPath, "dimm_ce_count"));
+    const ue = readUint(join(dimmPath, "dimm_ue_count"));
+    if (ce === null && ue === null)
+        return null;
+    const label = readString(join(dimmPath, "dimm_label"));
+    const location = readString(join(dimmPath, "dimm_location"));
+    const sizeStr = readString(join(dimmPath, "size"));
+    const sizeMb = sizeStr && /^\d+$/.test(sizeStr) ? parseInt(sizeStr, 10) : null;
+    return {
+        label: label ?? "",
+        location: location ?? "",
+        size_mb: sizeMb,
+        ce_count: ce ?? 0,
+        ue_count: ue ?? 0,
+    };
+}
+export function collectEdac() {
+    const mcDirs = listMcDirs();
+    if (mcDirs.length === 0)
+        return null;
+    let totalCe = 0;
+    let totalUe = 0;
+    const dimms = [];
+    for (const mc of mcDirs) {
+        const ce = readUint(join(mc, "ce_count")) ?? 0;
+        const ue = readUint(join(mc, "ue_count")) ?? 0;
+        totalCe += ce;
+        totalUe += ue;
+        for (const dimm of listDimmDirs(mc)) {
+            const d = collectDimm(dimm);
+            if (d)
+                dimms.push(d);
+        }
+    }
+    return {
+        edac_corrected_total: totalCe,
+        edac_uncorrected_total: totalUe,
+        dimms,
+    };
+}
+//# sourceMappingURL=edac.js.map

package/dist/collect/edac.js.map

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