aokamoaki/dsh-startup-guard
Boot-time guard that repairs corrupt session logs, preflights plugin composition, vm-checks client artifacts, smoke-tests host apply() and quarantines crash-causing bundles, so a broken plugin can never brick startup.
dsh-startup-guard is a boot-time guard for DeepSeek Harness that runs seven checks early in boot and can auto-repair, roll back or quarantine the source of a startup failure so a broken plugin or corrupt log cannot brick startup. The README describes a four-layer defence (parse -> compose -> execute -> crash-containment): session-log repair (jsonl/zstd sequence corruption, permanent torn tails, stale cache pruning, with originals backed up), manifest snapshots with per-bundle content fingerprints, bundle preflight with rollback to the newest resolvable snapshot, composition preflight that auto-disables rows whose name no longer resolves, client-bundle validity checks that actually execute the bundle in a vm sandbox, host apply() smoke tests in a throwaway child process, and crash quarantine driven by crash/boot markers that forces a full smoke sweep on the next boot.
Install
dsh plugin --profile web add dsh-startup-guardnpm package dsh-startup-guard 1.0.0 (registry re-verified 2026-09-30; repository field points back at github.com/aokamoaki/dsh-startup-guard, MIT); a from-source install is also documented. Node >= 22.13 per the README badge. It is zero-configuration and the README states typical overhead is under 0.5s per boot.
Compatibility
DeepSeek Harness. The README states it works for a bare dsh web with no launcher/shell as well as for the desktop app, and that its results are cached by content fingerprint.
Details
- Repo: aokamoaki/dsh-startup-guard
- Category: Development & Runtime
- Stars: 2
- Version: npm dsh-startup-guard 1.0.0 (registry re-verified 2026-09-30); MIT; Node >= 22.13
- Last push: 2026-08-16
- First seen: 2026-08-16
Recent updates
The README documents the seven checks, the sub-0.5s typical overhead, the 24h rollback-loop grace, the strict-mode block marker the launcher refuses to boot past, and that the crash-quarantine loop works even for a bare dsh web launch.
FAQ
- How do I install dsh-startup-guard?
- Run dsh plugin --profile web add dsh-startup-guard (prebuilt npm package, no build approval) or install from source; the README states it is zero-configuration.
- What does it protect against?
- Per the README a missing package, malformed patch, unbuilt client artifact or a runtime exception thrown from a host apply() can crash DSH at startup; the guard runs seven checks and can repair, roll back or quarantine the source.
- How much overhead does it add?
- The README states typical overhead is under 0.5 seconds per boot, and results are cached by content fingerprint.
Alternatives
aokamoaki/dsh-notify · 23swccp/dsh-undo-plugin · 2768651338/dsh-plugin-manager