dsh-web-restart

In the dsh workflow, the agent runs inside the web service process itself. If the agent simply kills the web service with Stop-Process, it is effectively destroying its own process tree and the restart command never completes—what developers call a suicidal restart.

This plugin moves the birthplace of the new service process out of the agent process tree. It invokes WMI Win32_Process.Create so that the launch script is owned by the WMI host; the new process parents to WMI rather than the agent, making it immune to process-tree reclamation. Two modes are provided: ensure automatically starts the service when the port is not listening and leaves it alone otherwise; rotate lets the caller return safely first, then kills the old process and spawns a fresh one in a fully detached manner, ideal for loading new plugins or code. A flag-file trigger is also supported—drop a flag inside the profile and the next session turn automatically performs a detached restart.

This is for Windows-based dsh developers who frequently swap plugins or code and want to avoid the restart-kill cycle. On non-Windows platforms the plugin gracefully falls back to a detached spawn, so it works everywhere.