@glassmkr/crucible 0.6.6 → 0.7.0

package/README.md

@@ -92,6 +92,8 @@ Images are published to [ghcr.io/glassmkr/crucible](https://github.com/glassmkr/
 
 ```
 glassmkr-crucible [options]
+glassmkr-crucible mark-reboot [--reason TEXT] [--ttl DURATION]
+glassmkr-crucible reboot      [--reason TEXT] [--ttl DURATION]
 
 Options:
   -v, --version    Print version and exit
@@ -101,6 +103,29 @@ Options:
 
 `--config=PATH` and the legacy positional form `glassmkr-crucible /path/to.yaml` both work. Without options, Crucible runs as a long-lived collector daemon.
 
+## Rebooting without noise
+
+Crucible distinguishes planned reboots from unplanned ones and gives each rule a short grace period after boot so that transient conditions (bond slave still negotiating, clock not synced yet) do not page you.
+
+Before a planned reboot:
+
+```
+sudo glassmkr-crucible reboot --reason "kernel update"
+```
+
+Or, if you prefer to trigger the reboot yourself:
+
+```
+sudo glassmkr-crucible mark-reboot --reason "kernel update"
+sudo reboot
+```
+
+Both write a short-lived marker to `/var/lib/crucible/reboot-expected`. The agent reads it once on startup, sets `expected_reboot: true` on the first post-boot snapshot, and deletes the file. Forge reads that flag and suppresses the `server_rebooted_unexpectedly` alert for that boot only.
+
+The marker is single-use and expires 10 minutes after it is written (override with `--ttl 5m` / `--ttl 1h`), so a forgotten marker cannot silence a genuine crash reboot next week. If systemd fails to reboot the host, the marker simply expires on its own.
+
+Per-rule grace windows are applied separately: bond-slave-down and CPU-temperature get 60 s, interface errors 120 s, clock-sync / NTP 300 s, others 0 s. Suppressed evaluations are recorded in alert history with status `suppressed_boot_grace` or `suppressed_planned_reboot` so you can audit exactly why a rule didn't fire during a given boot.
+
 ## Systemd Service
 
 Create `/etc/systemd/system/glassmkr-crucible.service`:

package/dist/__tests__/reboot-marker.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/reboot-marker.test.js

@@ -0,0 +1,110 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, existsSync, writeFileSync, statSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { consumeRebootMarker, writeRebootMarker, parseDuration, } from "../lib/reboot-marker.js";
+import { parseCliArgs } from "../cli.js";
+let tmpDir;
+let path;
+beforeEach(() => {
+    tmpDir = mkdtempSync(join(tmpdir(), "crucible-test-"));
+    path = join(tmpDir, "reboot-expected");
+});
+afterEach(() => {
+    try {
+        rmSync(tmpDir, { recursive: true, force: true });
+    }
+    catch { }
+});
+describe("consumeRebootMarker", () => {
+    it("7. marker present, not expired: returns flag, deletes file", () => {
+        const future = new Date(Date.now() + 5 * 60_000).toISOString();
+        writeFileSync(path, JSON.stringify({ expires_at: future, reason: "kernel update" }));
+        const out = consumeRebootMarker(path);
+        expect(out).toEqual({ expected: true, reason: "kernel update" });
+        expect(existsSync(path)).toBe(false);
+    });
+    it("8. marker present, expired: returns null, deletes file", () => {
+        const past = new Date(Date.now() - 60_000).toISOString();
+        writeFileSync(path, JSON.stringify({ expires_at: past, reason: "stale" }));
+        expect(consumeRebootMarker(path)).toBeNull();
+        expect(existsSync(path)).toBe(false);
+    });
+    it("9. marker absent: returns null, no throw", () => {
+        expect(consumeRebootMarker(path)).toBeNull();
+    });
+    it("15. malformed JSON: returns null, file deleted, no crash", () => {
+        writeFileSync(path, "{not json at all");
+        expect(consumeRebootMarker(path)).toBeNull();
+        expect(existsSync(path)).toBe(false);
+    });
+    it("invalid expires_at (missing): returns null, file deleted", () => {
+        writeFileSync(path, JSON.stringify({ reason: "oops" }));
+        expect(consumeRebootMarker(path)).toBeNull();
+        expect(existsSync(path)).toBe(false);
+    });
+    it("consumed marker cannot be re-read (single-use)", () => {
+        const future = new Date(Date.now() + 60_000).toISOString();
+        writeFileSync(path, JSON.stringify({ expires_at: future }));
+        expect(consumeRebootMarker(path)).not.toBeNull();
+        expect(consumeRebootMarker(path)).toBeNull();
+    });
+});
+describe("writeRebootMarker", () => {
+    it("13. writes file at given path with correct TTL and reason, 0600 mode", () => {
+        const now = new Date("2026-04-21T22:00:00Z");
+        const res = writeRebootMarker({ path, reason: "kernel update", ttlMs: 10 * 60_000, now });
+        expect(res.path).toBe(path);
+        expect(res.expires_at).toBe("2026-04-21T22:10:00.000Z");
+        expect(existsSync(path)).toBe(true);
+        const mode = statSync(path).mode & 0o777;
+        expect(mode).toBe(0o600);
+        const round = consumeRebootMarker(path, new Date("2026-04-21T22:05:00Z"));
+        expect(round).toEqual({ expected: true, reason: "kernel update" });
+    });
+    it("default TTL is 10 minutes", () => {
+        const now = new Date("2026-04-21T22:00:00Z");
+        const res = writeRebootMarker({ path, now });
+        expect(res.expires_at).toBe("2026-04-21T22:10:00.000Z");
+    });
+});
+describe("parseDuration", () => {
+    it.each([
+        ["10m", 600_000],
+        ["2h", 7_200_000],
+        ["600s", 600_000],
+        ["500ms", 500],
+        ["30", 30_000], // bare number -> seconds
+    ])("%s -> %d ms", (input, ms) => {
+        expect(parseDuration(input)).toBe(ms);
+    });
+    it("rejects garbage", () => {
+        expect(parseDuration("forever")).toBeNull();
+        expect(parseDuration("-5m")).toBeNull();
+        expect(parseDuration("")).toBeNull();
+    });
+});
+describe("CLI parseCliArgs subcommands", () => {
+    it("14. `reboot` subcommand captured with flags", () => {
+        const { result } = parseCliArgs(["reboot", "--reason", "kernel update"], "1.0.0");
+        expect(result.mode).toBe("reboot");
+        expect(result.reason).toBe("kernel update");
+    });
+    it("`mark-reboot` with --ttl parsed through", () => {
+        const { result } = parseCliArgs(["mark-reboot", "--ttl=5m", "--reason=test"], "1.0.0");
+        expect(result.mode).toBe("mark-reboot");
+        expect(result.ttl).toBe("5m");
+        expect(result.reason).toBe("test");
+    });
+    it("`mark-reboot --help` returns help output without running", () => {
+        const { result, output } = parseCliArgs(["mark-reboot", "--help"], "1.0.0");
+        expect(result.mode).toBe("help");
+        expect(output).toContain("mark-reboot");
+    });
+    it("top-level help lists the new subcommands", () => {
+        const { output } = parseCliArgs(["--help"], "1.0.0");
+        expect(output).toMatch(/mark-reboot/);
+        expect(output).toMatch(/reboot/);
+    });
+});
+//# sourceMappingURL=reboot-marker.test.js.map

package/dist/__tests__/reboot-marker.test.js.map

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

package/dist/cli.d.ts

@@ -1,6 +1,9 @@
+export type CliMode = "version" | "help" | "run" | "mark-reboot" | "reboot";
 export interface CliArgs {
-    mode: "version" | "help" | "run";
+    mode: CliMode;
     configPath: string;
+    reason?: string;
+    ttl?: string;
 }
 export declare const DEFAULT_CONFIG_PATH = "/etc/glassmkr/collector.yaml";
 export declare function parseCliArgs(argv: string[], version: string): {

package/dist/cli.js

@@ -5,6 +5,36 @@ export const DEFAULT_CONFIG_PATH = "/etc/glassmkr/collector.yaml";
 export function parseCliArgs(argv, version) {
     // argv is typically process.argv.slice(2)
     let configPath = DEFAULT_CONFIG_PATH;
+    // Subcommand dispatch: `mark-reboot` and `reboot` take their own flags
+    // (--reason, --ttl) but re-use --help.
+    if (argv[0] === "mark-reboot" || argv[0] === "reboot") {
+        const mode = argv[0];
+        let reason;
+        let ttl;
+        for (let i = 1; i < argv.length; i++) {
+            const a = argv[i];
+            if (a === "--help" || a === "-h") {
+                return { result: { mode: "help", configPath: "" }, output: subcommandHelp(mode, version) };
+            }
+            if (a === "--reason") {
+                reason = argv[++i];
+                continue;
+            }
+            if (a.startsWith("--reason=")) {
+                reason = a.slice("--reason=".length);
+                continue;
+            }
+            if (a === "--ttl") {
+                ttl = argv[++i];
+                continue;
+            }
+            if (a.startsWith("--ttl=")) {
+                ttl = a.slice("--ttl=".length);
+                continue;
+            }
+        }
+        return { result: { mode, configPath: "", reason, ttl }, output: null };
+    }
     for (let i = 0; i < argv.length; i++) {
         const arg = argv[i];
         if (arg === "--version" || arg === "-v") {
@@ -40,14 +70,40 @@ export function helpText(version) {
         "",
         "Usage:",
         "  glassmkr-crucible [options]",
+        "  glassmkr-crucible mark-reboot [--reason TEXT] [--ttl DURATION]",
+        "  glassmkr-crucible reboot      [--reason TEXT] [--ttl DURATION]",
         "",
         "Options:",
         "  -v, --version    Print version and exit",
         "  -h, --help       Print this help and exit",
         `  -c, --config     Path to config file (default: ${DEFAULT_CONFIG_PATH})`,
         "",
+        "Subcommands:",
+        "  mark-reboot      Write a planned-reboot marker so the next boot",
+        "                   does not fire `server_rebooted_unexpectedly`.",
+        "                   You run the reboot yourself afterwards.",
+        "  reboot           Write the marker, then invoke `systemctl reboot`.",
+        "",
         "Without options, starts the collector daemon using the config file.",
         "Docs: https://github.com/glassmkr/crucible",
     ].join("\n");
 }
+function subcommandHelp(mode, version) {
+    const action = mode === "reboot"
+        ? "Write a planned-reboot marker and invoke `systemctl reboot`."
+        : "Write a planned-reboot marker; operator triggers the reboot.";
+    return [
+        `glassmkr-crucible ${mode} - ${action}`,
+        "",
+        "Usage:",
+        `  glassmkr-crucible ${mode} [--reason TEXT] [--ttl DURATION]`,
+        "",
+        "Options:",
+        '  --reason TEXT    Free-text reason (e.g. "kernel update")',
+        "  --ttl DURATION   Expiry window; e.g. 5m, 10m, 1h (default 10m)",
+        "",
+        `Marker path: /var/lib/crucible/reboot-expected (requires root).`,
+        `v${version}`,
+    ].join("\n");
+}
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,6EAA6E;AAC7E,8EAA8E;AAO9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAA8B,CAAC;AAElE,MAAM,UAAU,YAAY,CAAC,IAAc,EAAE,OAAe;IAC1D,0CAA0C;IAC1C,IAAI,UAAU,GAAG,mBAAmB,CAAC;IAErC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACxC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,sBAAsB,OAAO,EAAE,EAAE,CAAC;QAClG,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACrC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACjF,CAAC;QACD,+BAA+B;QAC/B,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACzB,IAAI,IAAI,EAAE,CAAC;gBACT,UAAU,GAAG,IAAI,CAAC;gBAClB,CAAC,EAAE,CAAC;YACN,CAAC;YACD,SAAS;QACX,CAAC;QACD,kBAAkB;QAClB,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAC3C,SAAS;QACX,CAAC;QACD,mDAAmD;QACnD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,UAAU,GAAG,GAAG,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,OAAO;QACL,sBAAsB,OAAO,uCAAuC;QACpE,EAAE;QACF,QAAQ;QACR,+BAA+B;QAC/B,EAAE;QACF,UAAU;QACV,2CAA2C;QAC3C,6CAA6C;QAC7C,oDAAoD,mBAAmB,GAAG;QAC1E,EAAE;QACF,qEAAqE;QACrE,4CAA4C;KAC7C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/collect/__tests__/system.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/collect/__tests__/system.test.js

@@ -0,0 +1,25 @@
+import { describe, it, expect } from "vitest";
+import { readOsReleaseField } from "../system.js";
+describe("readOsReleaseField", () => {
+    it("parses unquoted Ubuntu values", () => {
+        const s = 'NAME="Ubuntu"\nID=ubuntu\nID_LIKE=debian\nVERSION_ID="24.04"';
+        expect(readOsReleaseField(s, "ID")).toBe("ubuntu");
+        expect(readOsReleaseField(s, "ID_LIKE")).toBe("debian");
+    });
+    it("parses quoted RHEL-family values", () => {
+        const s = 'NAME="Rocky Linux"\nID="rocky"\nID_LIKE="rhel centos fedora"';
+        expect(readOsReleaseField(s, "ID")).toBe("rocky");
+        expect(readOsReleaseField(s, "ID_LIKE")).toBe("rhel centos fedora");
+    });
+    it("lowercases the result (some distros uppercase their ID)", () => {
+        expect(readOsReleaseField("ID=Alpine", "ID")).toBe("alpine");
+    });
+    it("returns undefined for a missing key", () => {
+        expect(readOsReleaseField("ID=arch", "ID_LIKE")).toBeUndefined();
+    });
+    it("does not confuse ID with VERSION_ID", () => {
+        const s = 'VERSION_ID="24.04"\nID=ubuntu';
+        expect(readOsReleaseField(s, "ID")).toBe("ubuntu");
+    });
+});
+//# sourceMappingURL=system.test.js.map

package/dist/collect/__tests__/system.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.test.js","sourceRoot":"","sources":["../../../src/collect/__tests__/system.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,GAAG,8DAA8D,CAAC;QACzE,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,GAAG,8DAA8D,CAAC;QACzE,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,kBAAkB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,GAAG,+BAA+B,CAAC;QAC1C,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/collect/system.d.ts

@@ -1,2 +1,3 @@
 import type { SystemInfo } from "../lib/types.js";
+export declare function readOsReleaseField(osRelease: string, key: string): string | undefined;
 export declare function collectSystem(): Promise<SystemInfo>;

package/dist/collect/system.js

@@ -1,9 +1,17 @@
 import { hostname } from "os";
 import { readProcFile } from "../lib/parse.js";
 import { run } from "../lib/exec.js";
+// Matches KEY=value with optional surrounding double quotes. Handles both
+// `ID=ubuntu` and `ID="rocky"` styles found in the wild.
+export function readOsReleaseField(osRelease, key) {
+    const m = osRelease.match(new RegExp(`^${key}=("?)(.+?)\\1$`, "m"));
+    return m ? m[2].toLowerCase() : undefined;
+}
 export async function collectSystem() {
     const osRelease = readProcFile("/etc/os-release") || "";
     const osName = osRelease.match(/PRETTY_NAME="(.+?)"/)?.[1] || "Unknown";
+    const os_id = readOsReleaseField(osRelease, "ID");
+    const os_id_like = readOsReleaseField(osRelease, "ID_LIKE");
     const kernel = (await run("uname", ["-r"]))?.trim() || "unknown";
     const uptimeRaw = readProcFile("/proc/uptime") || "0";
     const uptimeSeconds = Math.floor(parseFloat(uptimeRaw.split(" ")[0]));
@@ -12,6 +20,8 @@ export async function collectSystem() {
         hostname: hostname(),
         ip,
         os: osName,
+        ...(os_id ? { os_id } : {}),
+        ...(os_id_like ? { os_id_like } : {}),
         kernel,
         uptime_seconds: uptimeSeconds,
     };

package/dist/collect/system.js.map

@@ -1 +1 @@
-{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/collect/system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAGrC,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,SAAS,GAAG,YAAY,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;IACxD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;IACxE,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IACjE,MAAM,SAAS,GAAG,YAAY,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC;IACtD,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;IAE9E,OAAO;QACL,QAAQ,EAAE,QAAQ,EAAE;QACpB,EAAE;QACF,EAAE,EAAE,MAAM;QACV,MAAM;QACN,cAAc,EAAE,aAAa;KAC9B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/collect/system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAGrC,0EAA0E;AAC1E,yDAAyD;AACzD,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,GAAW;IAC/D,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAC;IACpE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,SAAS,GAAG,YAAY,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;IACxD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;IACxE,MAAM,KAAK,GAAG,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IACjE,MAAM,SAAS,GAAG,YAAY,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC;IACtD,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;IAE9E,OAAO;QACL,QAAQ,EAAE,QAAQ,EAAE;QACpB,EAAE;QACF,EAAE,EAAE,MAAM;QACV,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,MAAM;QACN,cAAc,EAAE,aAAa;KAC9B,CAAC;AACJ,CAAC"}

package/dist/index.js

@@ -13,14 +13,46 @@ const PKG_VERSION = (() => {
         return "0.0.0";
     }
 })();
-// Handle --version and --help before importing collectors, loading config, or
-// starting the Prometheus server. This keeps the CLI responsive even on hosts
-// missing the config file or external tools.
+// Handle --version, --help, and planned-reboot subcommands before
+// importing collectors, loading config, or starting the Prometheus
+// server. Keeps the CLI responsive even on hosts missing the config
+// file or external tools.
 const { result: cliArgs, output: cliOutput } = parseCliArgs(process.argv.slice(2), PKG_VERSION);
-if (cliArgs.mode !== "run") {
+if (cliArgs.mode === "version" || cliArgs.mode === "help") {
     console.log(cliOutput);
     process.exit(0);
 }
+if (cliArgs.mode === "mark-reboot" || cliArgs.mode === "reboot") {
+    const { writeRebootMarker, parseDuration, DEFAULT_TTL_MS } = await import("./lib/reboot-marker.js");
+    const ttlMs = cliArgs.ttl ? parseDuration(cliArgs.ttl) : DEFAULT_TTL_MS;
+    if (ttlMs === null) {
+        console.error(`[mark-reboot] invalid --ttl value: ${cliArgs.ttl}. Use e.g. 10m, 2h, 600s.`);
+        process.exit(2);
+    }
+    try {
+        const { path, expires_at } = writeRebootMarker({
+            reason: cliArgs.reason, ttlMs,
+        });
+        console.log(`[${cliArgs.mode}] marker written: ${path} (expires ${expires_at}${cliArgs.reason ? `, reason: ${cliArgs.reason}` : ""})`);
+    }
+    catch (err) {
+        console.error(`[${cliArgs.mode}] failed to write marker: ${err?.message || err}`);
+        console.error(`  Most likely cause: need root privileges to write under /var/lib/crucible/.`);
+        process.exit(1);
+    }
+    if (cliArgs.mode === "reboot") {
+        const { execFileSync } = await import("node:child_process");
+        console.log("[reboot] invoking systemctl reboot");
+        try {
+            execFileSync("systemctl", ["reboot"], { stdio: "inherit" });
+        }
+        catch (err) {
+            console.error(`[reboot] systemctl reboot failed: ${err?.message || err}`);
+            process.exit(1);
+        }
+    }
+    process.exit(0);
+}
 import { loadConfig } from "./config.js";
 import { checkForUpdates } from "./lib/version-check.js";
 import { startMetricsServer, updateMetrics } from "./metrics-server.js";
@@ -47,6 +79,16 @@ import { collectConntrack } from "./collect/conntrack.js";
 import { collectSystemd } from "./collect/systemd.js";
 import { collectNtp } from "./collect/ntp.js";
 import { collectFileDescriptors } from "./collect/fd.js";
+import { consumeRebootMarker } from "./lib/reboot-marker.js";
+// Consume the planned-reboot marker once at startup. If the operator ran
+// `crucible-agent mark-reboot` / `reboot` before this boot, the marker
+// exists, we flag it on the first snapshot, and we delete the file (so
+// subsequent snapshots don't keep claiming the reboot was planned).
+const plannedRebootFlag = consumeRebootMarker();
+if (plannedRebootFlag) {
+    console.log(`[collector] Planned reboot acknowledged${plannedRebootFlag.reason ? `: ${plannedRebootFlag.reason}` : ""}`);
+}
+let plannedRebootConsumed = false;
 const config = loadConfig(cliArgs.configPath);
 console.log(`[collector] Starting. Server: ${config.server_name}. Interval: ${config.collection.interval_seconds}s`);
 console.log(`[collector] IPMI: ${config.collection.ipmi ? "enabled" : "disabled"}, SMART: ${config.collection.smart ? "enabled" : "disabled"}`);
@@ -96,6 +138,14 @@ async function collect() {
         system, cpu, memory, disks, smart, network, raid, ipmi, os_alerts: osAlerts,
         security: cachedSecurity,
     };
+    // Single-shot: the very first snapshot after a marked reboot carries
+    // the flag, subsequent snapshots do not.
+    if (plannedRebootFlag && !plannedRebootConsumed) {
+        snapshot.expected_reboot = true;
+        if (plannedRebootFlag.reason)
+            snapshot.expected_reboot_reason = plannedRebootFlag.reason;
+        plannedRebootConsumed = true;
+    }
     // ZFS and I/O errors: collect every cycle (lightweight checks)
     try {
         snapshot.zfs = await collectZfs() ?? undefined;

package/dist/index.js.map

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

package/dist/lib/reboot-marker.d.ts

@@ -0,0 +1,35 @@
+export declare const DEFAULT_MARKER_PATH = "/var/lib/crucible/reboot-expected";
+export declare const DEFAULT_TTL_MS: number;
+export interface PlannedReboot {
+    expected: true;
+    reason?: string;
+}
+export interface RebootMarker {
+    expires_at: string;
+    reason?: string;
+}
+/**
+ * Read and delete the marker at `path`. Returns the resolved reboot flag
+ * if the file existed, was parseable JSON, and hasn't expired; otherwise
+ * returns null. The file is unlinked in every branch where it existed,
+ * so a malformed or stale marker is one-shot (can't linger).
+ */
+export declare function consumeRebootMarker(path?: string, now?: Date): PlannedReboot | null;
+/**
+ * Write a planned-reboot marker. Used by the `mark-reboot` and `reboot`
+ * CLI subcommands. `ttlMs` defaults to 10 minutes. Creates the parent
+ * directory if needed. Chmod 600 so other users on the host can't read
+ * or modify it.
+ */
+export declare function writeRebootMarker(opts: {
+    reason?: string;
+    ttlMs?: number;
+    path?: string;
+    now?: Date;
+}): {
+    path: string;
+    expires_at: string;
+};
+/** Parse a duration like "10m", "2h", "600s" into milliseconds. Used by
+ *  the CLI for the `--ttl` flag. */
+export declare function parseDuration(s: string): number | null;

package/dist/lib/reboot-marker.js

@@ -0,0 +1,95 @@
+// Planned-reboot marker handling.
+//
+// An operator signals "the next reboot is expected, don't page me"
+// by writing a short-lived JSON file to disk BEFORE rebooting. The
+// collector reads and deletes it on agent startup; the first
+// post-boot snapshot then carries `expected_reboot: true` so Forge's
+// unexpected_reboot rule stays quiet.
+//
+// Single-use (deleted on read regardless of validity) and TTL-guarded
+// (default 10 min) so a forgotten marker cannot silence a genuine
+// crash reboot weeks later.
+import { existsSync, readFileSync, unlinkSync, writeFileSync, mkdirSync, chmodSync } from "node:fs";
+import { dirname } from "node:path";
+export const DEFAULT_MARKER_PATH = "/var/lib/crucible/reboot-expected";
+export const DEFAULT_TTL_MS = 10 * 60 * 1000;
+/**
+ * Read and delete the marker at `path`. Returns the resolved reboot flag
+ * if the file existed, was parseable JSON, and hasn't expired; otherwise
+ * returns null. The file is unlinked in every branch where it existed,
+ * so a malformed or stale marker is one-shot (can't linger).
+ */
+export function consumeRebootMarker(path = DEFAULT_MARKER_PATH, now = new Date()) {
+    if (!existsSync(path))
+        return null;
+    let raw;
+    try {
+        raw = readFileSync(path, "utf-8");
+    }
+    catch {
+        try {
+            unlinkSync(path);
+        }
+        catch { }
+        return null;
+    }
+    // Always delete after read, regardless of validity.
+    try {
+        unlinkSync(path);
+    }
+    catch { }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== "object" || typeof parsed.expires_at !== "string")
+        return null;
+    const expiresAt = new Date(parsed.expires_at);
+    if (isNaN(expiresAt.getTime()))
+        return null;
+    if (expiresAt.getTime() <= now.getTime())
+        return null; // stale
+    return { expected: true, reason: parsed.reason };
+}
+/**
+ * Write a planned-reboot marker. Used by the `mark-reboot` and `reboot`
+ * CLI subcommands. `ttlMs` defaults to 10 minutes. Creates the parent
+ * directory if needed. Chmod 600 so other users on the host can't read
+ * or modify it.
+ */
+export function writeRebootMarker(opts) {
+    const path = opts.path ?? DEFAULT_MARKER_PATH;
+    const now = opts.now ?? new Date();
+    const ttlMs = opts.ttlMs ?? DEFAULT_TTL_MS;
+    const expiresAt = new Date(now.getTime() + ttlMs);
+    const body = { expires_at: expiresAt.toISOString() };
+    if (opts.reason)
+        body.reason = opts.reason;
+    try {
+        mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    }
+    catch { }
+    writeFileSync(path, JSON.stringify(body), { mode: 0o600 });
+    try {
+        chmodSync(path, 0o600);
+    }
+    catch { }
+    return { path, expires_at: body.expires_at };
+}
+/** Parse a duration like "10m", "2h", "600s" into milliseconds. Used by
+ *  the CLI for the `--ttl` flag. */
+export function parseDuration(s) {
+    const m = /^(\d+)\s*(ms|s|m|h)?$/.exec(s.trim());
+    if (!m)
+        return null;
+    const n = parseInt(m[1], 10);
+    if (!Number.isFinite(n) || n < 0)
+        return null;
+    const unit = m[2] ?? "s";
+    const mult = unit === "ms" ? 1 : unit === "s" ? 1000 : unit === "m" ? 60_000 : 3_600_000;
+    return n * mult;
+}
+//# sourceMappingURL=reboot-marker.js.map

package/dist/lib/reboot-marker.js.map

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

package/dist/lib/types.d.ts

@@ -27,6 +27,8 @@ export interface Snapshot {
     systemd?: SystemdData;
     ntp?: NtpData;
     file_descriptors?: FileDescriptorData;
+    expected_reboot?: boolean;
+    expected_reboot_reason?: string;
 }
 export interface ConntrackData {
     available: boolean;
@@ -98,6 +100,12 @@ export interface SystemInfo {
     hostname: string;
     ip: string;
     os: string;
+    /** `ID=` from /etc/os-release, lowercased. e.g. "ubuntu", "debian", "rocky", "arch", "alpine". */
+    os_id?: string;
+    /** `ID_LIKE=` from /etc/os-release, lowercased, space-separated. Used by Forge
+     *  to pick distro-family-specific fix command variants. e.g. on Rocky this
+     *  is "rhel centos fedora"; on Ubuntu it is "debian". */
+    os_id_like?: string;
     kernel: string;
     uptime_seconds: number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glassmkr/crucible",
-  "version": "0.6.6",
+  "version": "0.7.0",
   "description": "Lightweight bare metal server monitoring. IPMI, SMART, OS, network. Opinionated alerts.",
   "type": "module",
   "main": "./dist/index.js",

package/src/__tests__/reboot-marker.test.ts

@@ -0,0 +1,122 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, existsSync, writeFileSync, statSync, rmSync, chmodSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import {
+  consumeRebootMarker,
+  writeRebootMarker,
+  parseDuration,
+} from "../lib/reboot-marker.js";
+import { parseCliArgs } from "../cli.js";
+
+let tmpDir: string;
+let path: string;
+
+beforeEach(() => {
+  tmpDir = mkdtempSync(join(tmpdir(), "crucible-test-"));
+  path = join(tmpDir, "reboot-expected");
+});
+afterEach(() => {
+  try { rmSync(tmpDir, { recursive: true, force: true }); } catch {}
+});
+
+describe("consumeRebootMarker", () => {
+  it("7. marker present, not expired: returns flag, deletes file", () => {
+    const future = new Date(Date.now() + 5 * 60_000).toISOString();
+    writeFileSync(path, JSON.stringify({ expires_at: future, reason: "kernel update" }));
+    const out = consumeRebootMarker(path);
+    expect(out).toEqual({ expected: true, reason: "kernel update" });
+    expect(existsSync(path)).toBe(false);
+  });
+
+  it("8. marker present, expired: returns null, deletes file", () => {
+    const past = new Date(Date.now() - 60_000).toISOString();
+    writeFileSync(path, JSON.stringify({ expires_at: past, reason: "stale" }));
+    expect(consumeRebootMarker(path)).toBeNull();
+    expect(existsSync(path)).toBe(false);
+  });
+
+  it("9. marker absent: returns null, no throw", () => {
+    expect(consumeRebootMarker(path)).toBeNull();
+  });
+
+  it("15. malformed JSON: returns null, file deleted, no crash", () => {
+    writeFileSync(path, "{not json at all");
+    expect(consumeRebootMarker(path)).toBeNull();
+    expect(existsSync(path)).toBe(false);
+  });
+
+  it("invalid expires_at (missing): returns null, file deleted", () => {
+    writeFileSync(path, JSON.stringify({ reason: "oops" }));
+    expect(consumeRebootMarker(path)).toBeNull();
+    expect(existsSync(path)).toBe(false);
+  });
+
+  it("consumed marker cannot be re-read (single-use)", () => {
+    const future = new Date(Date.now() + 60_000).toISOString();
+    writeFileSync(path, JSON.stringify({ expires_at: future }));
+    expect(consumeRebootMarker(path)).not.toBeNull();
+    expect(consumeRebootMarker(path)).toBeNull();
+  });
+});
+
+describe("writeRebootMarker", () => {
+  it("13. writes file at given path with correct TTL and reason, 0600 mode", () => {
+    const now = new Date("2026-04-21T22:00:00Z");
+    const res = writeRebootMarker({ path, reason: "kernel update", ttlMs: 10 * 60_000, now });
+    expect(res.path).toBe(path);
+    expect(res.expires_at).toBe("2026-04-21T22:10:00.000Z");
+    expect(existsSync(path)).toBe(true);
+    const mode = statSync(path).mode & 0o777;
+    expect(mode).toBe(0o600);
+    const round = consumeRebootMarker(path, new Date("2026-04-21T22:05:00Z"));
+    expect(round).toEqual({ expected: true, reason: "kernel update" });
+  });
+
+  it("default TTL is 10 minutes", () => {
+    const now = new Date("2026-04-21T22:00:00Z");
+    const res = writeRebootMarker({ path, now });
+    expect(res.expires_at).toBe("2026-04-21T22:10:00.000Z");
+  });
+});
+
+describe("parseDuration", () => {
+  it.each([
+    ["10m", 600_000],
+    ["2h", 7_200_000],
+    ["600s", 600_000],
+    ["500ms", 500],
+    ["30", 30_000], // bare number -> seconds
+  ])("%s -> %d ms", (input, ms) => {
+    expect(parseDuration(input)).toBe(ms);
+  });
+  it("rejects garbage", () => {
+    expect(parseDuration("forever")).toBeNull();
+    expect(parseDuration("-5m")).toBeNull();
+    expect(parseDuration("")).toBeNull();
+  });
+});
+
+describe("CLI parseCliArgs subcommands", () => {
+  it("14. `reboot` subcommand captured with flags", () => {
+    const { result } = parseCliArgs(["reboot", "--reason", "kernel update"], "1.0.0");
+    expect(result.mode).toBe("reboot");
+    expect(result.reason).toBe("kernel update");
+  });
+  it("`mark-reboot` with --ttl parsed through", () => {
+    const { result } = parseCliArgs(["mark-reboot", "--ttl=5m", "--reason=test"], "1.0.0");
+    expect(result.mode).toBe("mark-reboot");
+    expect(result.ttl).toBe("5m");
+    expect(result.reason).toBe("test");
+  });
+  it("`mark-reboot --help` returns help output without running", () => {
+    const { result, output } = parseCliArgs(["mark-reboot", "--help"], "1.0.0");
+    expect(result.mode).toBe("help");
+    expect(output).toContain("mark-reboot");
+  });
+  it("top-level help lists the new subcommands", () => {
+    const { output } = parseCliArgs(["--help"], "1.0.0");
+    expect(output).toMatch(/mark-reboot/);
+    expect(output).toMatch(/reboot/);
+  });
+});

package/src/cli.ts

@@ -2,9 +2,13 @@
 // or collector initialization so --version and --help exit cleanly even when
 // the config file is missing or the host lacks the tools the collectors need.
 
+export type CliMode = "version" | "help" | "run" | "mark-reboot" | "reboot";
+
 export interface CliArgs {
-  mode: "version" | "help" | "run";
+  mode: CliMode;
   configPath: string;
+  reason?: string;
+  ttl?: string; // raw duration string, parsed by caller
 }
 
 export const DEFAULT_CONFIG_PATH = "/etc/glassmkr/collector.yaml";
@@ -13,6 +17,25 @@ export function parseCliArgs(argv: string[], version: string): { result: CliArgs
   // argv is typically process.argv.slice(2)
   let configPath = DEFAULT_CONFIG_PATH;
 
+  // Subcommand dispatch: `mark-reboot` and `reboot` take their own flags
+  // (--reason, --ttl) but re-use --help.
+  if (argv[0] === "mark-reboot" || argv[0] === "reboot") {
+    const mode: "mark-reboot" | "reboot" = argv[0];
+    let reason: string | undefined;
+    let ttl: string | undefined;
+    for (let i = 1; i < argv.length; i++) {
+      const a = argv[i];
+      if (a === "--help" || a === "-h") {
+        return { result: { mode: "help", configPath: "" }, output: subcommandHelp(mode, version) };
+      }
+      if (a === "--reason") { reason = argv[++i]; continue; }
+      if (a.startsWith("--reason=")) { reason = a.slice("--reason=".length); continue; }
+      if (a === "--ttl") { ttl = argv[++i]; continue; }
+      if (a.startsWith("--ttl=")) { ttl = a.slice("--ttl=".length); continue; }
+    }
+    return { result: { mode, configPath: "", reason, ttl }, output: null };
+  }
+
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
     if (arg === "--version" || arg === "-v") {
@@ -50,13 +73,40 @@ export function helpText(version: string): string {
     "",
     "Usage:",
     "  glassmkr-crucible [options]",
+    "  glassmkr-crucible mark-reboot [--reason TEXT] [--ttl DURATION]",
+    "  glassmkr-crucible reboot      [--reason TEXT] [--ttl DURATION]",
     "",
     "Options:",
     "  -v, --version    Print version and exit",
     "  -h, --help       Print this help and exit",
     `  -c, --config     Path to config file (default: ${DEFAULT_CONFIG_PATH})`,
     "",
+    "Subcommands:",
+    "  mark-reboot      Write a planned-reboot marker so the next boot",
+    "                   does not fire `server_rebooted_unexpectedly`.",
+    "                   You run the reboot yourself afterwards.",
+    "  reboot           Write the marker, then invoke `systemctl reboot`.",
+    "",
     "Without options, starts the collector daemon using the config file.",
     "Docs: https://github.com/glassmkr/crucible",
   ].join("\n");
 }
+
+function subcommandHelp(mode: "mark-reboot" | "reboot", version: string): string {
+  const action = mode === "reboot"
+    ? "Write a planned-reboot marker and invoke `systemctl reboot`."
+    : "Write a planned-reboot marker; operator triggers the reboot.";
+  return [
+    `glassmkr-crucible ${mode} - ${action}`,
+    "",
+    "Usage:",
+    `  glassmkr-crucible ${mode} [--reason TEXT] [--ttl DURATION]`,
+    "",
+    "Options:",
+    '  --reason TEXT    Free-text reason (e.g. "kernel update")',
+    "  --ttl DURATION   Expiry window; e.g. 5m, 10m, 1h (default 10m)",
+    "",
+    `Marker path: /var/lib/crucible/reboot-expected (requires root).`,
+    `v${version}`,
+  ].join("\n");
+}

package/src/collect/__tests__/system.test.ts

@@ -0,0 +1,29 @@
+import { describe, it, expect } from "vitest";
+import { readOsReleaseField } from "../system.js";
+
+describe("readOsReleaseField", () => {
+  it("parses unquoted Ubuntu values", () => {
+    const s = 'NAME="Ubuntu"\nID=ubuntu\nID_LIKE=debian\nVERSION_ID="24.04"';
+    expect(readOsReleaseField(s, "ID")).toBe("ubuntu");
+    expect(readOsReleaseField(s, "ID_LIKE")).toBe("debian");
+  });
+
+  it("parses quoted RHEL-family values", () => {
+    const s = 'NAME="Rocky Linux"\nID="rocky"\nID_LIKE="rhel centos fedora"';
+    expect(readOsReleaseField(s, "ID")).toBe("rocky");
+    expect(readOsReleaseField(s, "ID_LIKE")).toBe("rhel centos fedora");
+  });
+
+  it("lowercases the result (some distros uppercase their ID)", () => {
+    expect(readOsReleaseField("ID=Alpine", "ID")).toBe("alpine");
+  });
+
+  it("returns undefined for a missing key", () => {
+    expect(readOsReleaseField("ID=arch", "ID_LIKE")).toBeUndefined();
+  });
+
+  it("does not confuse ID with VERSION_ID", () => {
+    const s = 'VERSION_ID="24.04"\nID=ubuntu';
+    expect(readOsReleaseField(s, "ID")).toBe("ubuntu");
+  });
+});

package/src/collect/system.ts

@@ -3,9 +3,18 @@ import { readProcFile } from "../lib/parse.js";
 import { run } from "../lib/exec.js";
 import type { SystemInfo } from "../lib/types.js";
 
+// Matches KEY=value with optional surrounding double quotes. Handles both
+// `ID=ubuntu` and `ID="rocky"` styles found in the wild.
+export function readOsReleaseField(osRelease: string, key: string): string | undefined {
+  const m = osRelease.match(new RegExp(`^${key}=("?)(.+?)\\1$`, "m"));
+  return m ? m[2].toLowerCase() : undefined;
+}
+
 export async function collectSystem(): Promise<SystemInfo> {
   const osRelease = readProcFile("/etc/os-release") || "";
   const osName = osRelease.match(/PRETTY_NAME="(.+?)"/)?.[1] || "Unknown";
+  const os_id = readOsReleaseField(osRelease, "ID");
+  const os_id_like = readOsReleaseField(osRelease, "ID_LIKE");
   const kernel = (await run("uname", ["-r"]))?.trim() || "unknown";
   const uptimeRaw = readProcFile("/proc/uptime") || "0";
   const uptimeSeconds = Math.floor(parseFloat(uptimeRaw.split(" ")[0]));
@@ -15,6 +24,8 @@ export async function collectSystem(): Promise<SystemInfo> {
     hostname: hostname(),
     ip,
     os: osName,
+    ...(os_id ? { os_id } : {}),
+    ...(os_id_like ? { os_id_like } : {}),
     kernel,
     uptime_seconds: uptimeSeconds,
   };

package/src/index.ts

@@ -15,14 +15,44 @@ const PKG_VERSION = (() => {
   }
 })();
 
-// Handle --version and --help before importing collectors, loading config, or
-// starting the Prometheus server. This keeps the CLI responsive even on hosts
-// missing the config file or external tools.
+// Handle --version, --help, and planned-reboot subcommands before
+// importing collectors, loading config, or starting the Prometheus
+// server. Keeps the CLI responsive even on hosts missing the config
+// file or external tools.
 const { result: cliArgs, output: cliOutput } = parseCliArgs(process.argv.slice(2), PKG_VERSION);
-if (cliArgs.mode !== "run") {
+if (cliArgs.mode === "version" || cliArgs.mode === "help") {
   console.log(cliOutput);
   process.exit(0);
 }
+if (cliArgs.mode === "mark-reboot" || cliArgs.mode === "reboot") {
+  const { writeRebootMarker, parseDuration, DEFAULT_TTL_MS } = await import("./lib/reboot-marker.js");
+  const ttlMs = cliArgs.ttl ? parseDuration(cliArgs.ttl) : DEFAULT_TTL_MS;
+  if (ttlMs === null) {
+    console.error(`[mark-reboot] invalid --ttl value: ${cliArgs.ttl}. Use e.g. 10m, 2h, 600s.`);
+    process.exit(2);
+  }
+  try {
+    const { path, expires_at } = writeRebootMarker({
+      reason: cliArgs.reason, ttlMs,
+    });
+    console.log(`[${cliArgs.mode}] marker written: ${path} (expires ${expires_at}${cliArgs.reason ? `, reason: ${cliArgs.reason}` : ""})`);
+  } catch (err: any) {
+    console.error(`[${cliArgs.mode}] failed to write marker: ${err?.message || err}`);
+    console.error(`  Most likely cause: need root privileges to write under /var/lib/crucible/.`);
+    process.exit(1);
+  }
+  if (cliArgs.mode === "reboot") {
+    const { execFileSync } = await import("node:child_process");
+    console.log("[reboot] invoking systemctl reboot");
+    try {
+      execFileSync("systemctl", ["reboot"], { stdio: "inherit" });
+    } catch (err: any) {
+      console.error(`[reboot] systemctl reboot failed: ${err?.message || err}`);
+      process.exit(1);
+    }
+  }
+  process.exit(0);
+}
 
 import { loadConfig } from "./config.js";
 import { checkForUpdates } from "./lib/version-check.js";
@@ -51,6 +81,17 @@ import { collectSystemd } from "./collect/systemd.js";
 import { collectNtp } from "./collect/ntp.js";
 import { collectFileDescriptors } from "./collect/fd.js";
 import type { Snapshot, IpmiInfo } from "./lib/types.js";
+import { consumeRebootMarker, type PlannedReboot } from "./lib/reboot-marker.js";
+
+// Consume the planned-reboot marker once at startup. If the operator ran
+// `crucible-agent mark-reboot` / `reboot` before this boot, the marker
+// exists, we flag it on the first snapshot, and we delete the file (so
+// subsequent snapshots don't keep claiming the reboot was planned).
+const plannedRebootFlag: PlannedReboot | null = consumeRebootMarker();
+if (plannedRebootFlag) {
+  console.log(`[collector] Planned reboot acknowledged${plannedRebootFlag.reason ? `: ${plannedRebootFlag.reason}` : ""}`);
+}
+let plannedRebootConsumed = false;
 
 const config = loadConfig(cliArgs.configPath);
 
@@ -106,6 +147,14 @@ async function collect() {
     security: cachedSecurity,
   };
 
+  // Single-shot: the very first snapshot after a marked reboot carries
+  // the flag, subsequent snapshots do not.
+  if (plannedRebootFlag && !plannedRebootConsumed) {
+    (snapshot as any).expected_reboot = true;
+    if (plannedRebootFlag.reason) (snapshot as any).expected_reboot_reason = plannedRebootFlag.reason;
+    plannedRebootConsumed = true;
+  }
+
   // ZFS and I/O errors: collect every cycle (lightweight checks)
   try { snapshot.zfs = await collectZfs() ?? undefined; } catch { /* skip if ZFS not available */ }
   try { snapshot.io_errors = await collectIoErrors() ?? undefined; } catch { /* skip on error */ }

package/src/lib/reboot-marker.ts

@@ -0,0 +1,88 @@
+// Planned-reboot marker handling.
+//
+// An operator signals "the next reboot is expected, don't page me"
+// by writing a short-lived JSON file to disk BEFORE rebooting. The
+// collector reads and deletes it on agent startup; the first
+// post-boot snapshot then carries `expected_reboot: true` so Forge's
+// unexpected_reboot rule stays quiet.
+//
+// Single-use (deleted on read regardless of validity) and TTL-guarded
+// (default 10 min) so a forgotten marker cannot silence a genuine
+// crash reboot weeks later.
+
+import { existsSync, readFileSync, unlinkSync, writeFileSync, mkdirSync, chmodSync } from "node:fs";
+import { dirname } from "node:path";
+
+export const DEFAULT_MARKER_PATH = "/var/lib/crucible/reboot-expected";
+export const DEFAULT_TTL_MS = 10 * 60 * 1000;
+
+export interface PlannedReboot {
+  expected: true;
+  reason?: string;
+}
+
+export interface RebootMarker {
+  expires_at: string; // ISO timestamp
+  reason?: string;
+}
+
+/**
+ * Read and delete the marker at `path`. Returns the resolved reboot flag
+ * if the file existed, was parseable JSON, and hasn't expired; otherwise
+ * returns null. The file is unlinked in every branch where it existed,
+ * so a malformed or stale marker is one-shot (can't linger).
+ */
+export function consumeRebootMarker(
+  path: string = DEFAULT_MARKER_PATH,
+  now: Date = new Date(),
+): PlannedReboot | null {
+  if (!existsSync(path)) return null;
+  let raw: string;
+  try { raw = readFileSync(path, "utf-8"); } catch { try { unlinkSync(path); } catch {} return null; }
+  // Always delete after read, regardless of validity.
+  try { unlinkSync(path); } catch {}
+
+  let parsed: RebootMarker;
+  try { parsed = JSON.parse(raw); } catch { return null; }
+  if (!parsed || typeof parsed !== "object" || typeof parsed.expires_at !== "string") return null;
+  const expiresAt = new Date(parsed.expires_at);
+  if (isNaN(expiresAt.getTime())) return null;
+  if (expiresAt.getTime() <= now.getTime()) return null; // stale
+  return { expected: true, reason: parsed.reason };
+}
+
+/**
+ * Write a planned-reboot marker. Used by the `mark-reboot` and `reboot`
+ * CLI subcommands. `ttlMs` defaults to 10 minutes. Creates the parent
+ * directory if needed. Chmod 600 so other users on the host can't read
+ * or modify it.
+ */
+export function writeRebootMarker(opts: {
+  reason?: string;
+  ttlMs?: number;
+  path?: string;
+  now?: Date;
+}): { path: string; expires_at: string } {
+  const path = opts.path ?? DEFAULT_MARKER_PATH;
+  const now = opts.now ?? new Date();
+  const ttlMs = opts.ttlMs ?? DEFAULT_TTL_MS;
+  const expiresAt = new Date(now.getTime() + ttlMs);
+  const body: RebootMarker = { expires_at: expiresAt.toISOString() };
+  if (opts.reason) body.reason = opts.reason;
+  try { mkdirSync(dirname(path), { recursive: true, mode: 0o700 }); } catch {}
+  writeFileSync(path, JSON.stringify(body), { mode: 0o600 });
+  try { chmodSync(path, 0o600); } catch {}
+  return { path, expires_at: body.expires_at };
+}
+
+/** Parse a duration like "10m", "2h", "600s" into milliseconds. Used by
+ *  the CLI for the `--ttl` flag. */
+export function parseDuration(s: string): number | null {
+  const m = /^(\d+)\s*(ms|s|m|h)?$/.exec(s.trim());
+  if (!m) return null;
+  const n = parseInt(m[1], 10);
+  if (!Number.isFinite(n) || n < 0) return null;
+  const unit = m[2] ?? "s";
+  const mult = unit === "ms" ? 1 : unit === "s" ? 1000 : unit === "m" ? 60_000 : 3_600_000;
+  return n * mult;
+}

package/src/lib/types.ts

@@ -18,6 +18,12 @@ export interface Snapshot {
   systemd?: SystemdData;
   ntp?: NtpData;
   file_descriptors?: FileDescriptorData;
+  // Planned-reboot flag: set only on the first snapshot after a reboot
+  // that was marked with `crucible-agent mark-reboot` / `reboot`. Forge
+  // reads this to suppress the `unexpected_reboot` rule. Single-use:
+  // subsequent snapshots don't carry it.
+  expected_reboot?: boolean;
+  expected_reboot_reason?: string;
 }
 
 export interface ConntrackData {
@@ -73,6 +79,12 @@ export interface SystemInfo {
   hostname: string;
   ip: string;
   os: string;
+  /** `ID=` from /etc/os-release, lowercased. e.g. "ubuntu", "debian", "rocky", "arch", "alpine". */
+  os_id?: string;
+  /** `ID_LIKE=` from /etc/os-release, lowercased, space-separated. Used by Forge
+   *  to pick distro-family-specific fix command variants. e.g. on Rocky this
+   *  is "rhel centos fedora"; on Ubuntu it is "debian". */
+  os_id_like?: string;
   kernel: string;
   uptime_seconds: number;
 }