dsh-plugin-doctor

The DSH plugin ecosystem iterates quickly, and many plugins are still in early rc stages. When a plugin declares peerDependencies that do not line up with the DSH version on your machine, the consequences range from silently broken tools to a web UI that refuses to boot at all. dsh-plugin-doctor turns the check-before-you-install step into a single natural-language prompt, catching rc-mismatch risks before they ever become a crash.

The health report covers five dimensions: the actual local versions of DSH, cordis, dsh-tools, and dsh-workflow; whether the plugin repository is publicly accessible (a 404 blocks phantom plugins outright); whether a dsh.bundle.patch declaration is present for official installability; a line-by-line semver comparison of peer ranges against your real versions (a built-in zero-dependency pure-function matcher that handles prerelease rules correctly); and whether the main entry file is actually committed to the repo. The verdict comes in three tiers — green for go, yellow for caution, red for stop — so you always know whether it is safe to proceed.

This plugin is built for developers who regularly experiment with rc-stage plugins and juggle multiple tooling packages inside the DSH ecosystem. Instead of memorising version matrices, you simply ask the doctor to check a repo and let the report tell you, at a glance, whether to install or walk away.