Notice. This is a clean-room, illustrative reference written to accompany a defensive publication. It contains no proprietary code, no real endpoints, and no credentials. Every external provider — the baseboard management controller (BMC/Redfish) and the in-band reachability probe — is an injectable stub. It is dependency-free and runs offline with only Node.js (ESM). Empirically-tuned production constants are replaced with safe demo defaults and annotated
[WITHHELD — trade secret].
node example.jsExpected: a transcript showing (1) the verify-first phase contract; (2) three unreachable nodes, each diagnosed from its out-of-band sensor pair and healed by a different actuator; (3) crash-resume (a second run skips satisfied phases); and (4) the firmware-inventory symmetry diff. The script ends with a few console.assert checks that the right actuator was chosen for each sensor pair.
| File | Purpose |
|---|---|
core.js |
The mechanism, provider-agnostic and pure. Exports attempt(name, {max, work, verify, heal}) (the verify-first phase contract — verify before work, work at most once, heal-or-hard-escalate), runPipeline(phases), selectRemediation({link, bootState}) (the two-dimensional OOB differential-diagnosis selector — the defensible element), firmwareDiff(invA, invB) (the node-symmetry verifier), the REMEDIATION action enum, and DEFAULTS (demo constants; production values withheld). |
oob-stub.js |
In-memory, network-free stand-in for a BMC/Redfish management controller and an in-band probe. Read sensors (getLinkStatus, getBootState, getFirmwareInventory, inbandReachable) and actuators (insertVirtualMedia, ejectVirtualMedia, installStagedDrivers, unstickInstaller, coldCycle). Each node carries injectable effects callbacks so a fired actuator mutates the simulated node's state — the "physics" that lets a heal actually converge. Swap this module for a real Redfish client to run against hardware; the engine in core.js is unchanged. |
example.js |
Wires phases and stub nodes, runs the pipeline, and prints the transcript. Demonstrates all three differential-diagnosis branches, crash-resume, hard-escalation on hardware asymmetry, and the firmware diff. |
schema.sql |
The audit/analytics data model: phase_run, sensor_reading, remediation_decision, actuator_invocation, firmware_inventory, firmware_diff, escalation. Credentials are never stored — the model records mechanism, sensor values, and decisions only. |
core.js ships unchanged. Replace oob-stub.js with a real Redfish/BMC client (virtual media, ComputerSystem.Reset, boot-device attributes, FirmwareInventory) and a real in-band probe (WinRM/SSH/ping), and back schema.sql with a real database. See ../docs/OPEN-SOURCE-APP.md.
Dual-licensed AGPL-3.0-or-later + commercial (Gus IT LLC, gus@gusit.de).