brockdsaver

DSH plugin loading depends on a composition tree (cordis.patch.yml plus bundle patches). When a duplicate entry id, unparseable YAML, or missing package slips in, DSH crashes on startup and the GUI never opens. You are locked out of the settings panel and cannot fix the profile from inside. brockdsaver exists for exactly this dead-end: it runs as a standalone CLI outside of DSH, so it can diagnose and repair a broken composition even while DSH itself is down.

As a CLI tool it detects duplicate entry ids (the number-one cause of startup crashes), unparseable YAML or invalid configs, and reports disabled entries. Paired with backup and restore subcommands, you can snapshot the current state, apply a fix, and verify the result without the DSH server ever needing to be running.

brockdsaver also lives inside DSH as a bundle plugin: a Health Check page in Settings shows composition status, duplicate-id count, runtime errors, and bundle sources in real time. A rescue notification banner appears in the bottom-right corner when a fresh rescue event is logged, and every rescue record is written to a local JSONL log readable by both the CLI and the plugin UI. If you run a deep plugin stack or hit occasional startup crashes, brockdsaver is the fuse that keeps your profile from burning down.