AI Agent Hub
Back to plugins
🧩

dsh-upgrade-guard

admin-security Updated 2026.09.15

Run the following command in DeepSeek Harness:

dsh plugin install zzy6-a/dsh-upgrade-guard

Paste the following prompt into your AI chat to install this plugin:

Run dsh plugin install zzy6-a/dsh-upgrade-guard in DeepSeek Harness to install; the source code is available at https://github.com/zzy6-a/dsh-upgrade-guard

About this plugin

DSH is in its developer-preview phase, and breaking changes ship with every host update. A single incompatible community plugin after an upgrade can leave the entire harness unbootable, and once the plugin tree fails to load, no in-host guard can intervene. dsh-upgrade-guard is the safety net built for exactly this expected failure mode.

The first launch after a host version change triggers an automatic full audit: it cross-checks every installed plugin's engines.dsh and peerDependencies against the resolved host and core version, inspects Loader fiber state, and validates the compose-layer patch file. When issues are found, the guard walks a guided repair chain of installing the highest compatible release, repairing the local install, or disabling the offending entry, backing up files before every write. If the plugin tree fails to load entirely, a standalone supervisor process outside the host parses boot logs, disables the bad entry, and restarts; as a last resort it boots the previous host directly from a snapshot with no sudo or npm required.

It is aimed at users who frequently install third-party plugins from the community registry, dshmarket, or local repos and keep pace with DSH's mainline releases. If you want a background safety net that turns a boot failure into a single confirmation dialog without manually auditing compatibility or rolling back your entire toolchain, this guard has you covered.

Use Cases

  • Auto-audits all installed plugins after a host upgrade and guides step-by-step repair
  • Supervisor outside the host parses boot logs, disables the bad entry, and restarts when the plugin tree fails to load
  • One-click cleanup of duplicated or stale compose-layer patch entries with automatic backup before every write

Best For

  • Day-to-day users who track DSH mainline releases frequently
  • Workflow maintainers who rely on multiple community plugins
  • Developers who prefer automatic compatibility safeguards over manual auditing