dsh-repair

Troubleshooting a DSH instance is rarely one clean failure but a chain of subtle breakages: a missing module at boot, a silently dropped model id, a corrupt symlink that leaves a service half-alive with perfectly clean logs. dsh-repair packages this diagnostic and repair knowledge into a loadable skill, giving the agent a systematic playbook instead of ad-hoc trial and error.

It covers the full failure spectrum — ERR_MODULE_NOT_FOUND and profile-bundle resolution errors at startup, junction/symlink corruption in node_modules, silently missing providers on the model page, adapters discarding unknown model ids, and configuration that parses fine but throws on apply. Six bundled scripts (bridge-doctor, bridge-rebuild, dep-diff, inspect-session, link-doctor, and the shared probe library bridge-lib) support read-only health checks, dry-run rebuilds, version-table diffs, and symlink/junction audits. All paths resolve from --home or $DSH_HOME with no machine-specific hard-coding. The skill also includes a pre-upgrade isolation rehearsal, post-upgrade three-layer verification with a settings.yaml review, and a complete Windows remote-SSH task checklist covering process lifecycle, quote escaping, PowerShell quirks, and pnpm junction path drift.

Best suited for developers who maintain DSH instances locally or remotely, especially those working with link:-style out-of-tree plugins, operating across Windows over SSH, or performing major version upgrades and needing a structured review of runtime evidence and configuration consistency.