dsh-task-watcher-plugin

DshTaskWatcher is a standalone Windows tray watcher that used to demand a manual ritual on every deploy or upgrade: visit the GitHub Releases page, download the installer, extract it, drop it into the local app-data folder, and launch the tray by hand. This plugin collapses that entire chain into a single install step. Once the plugin is in place the watcher is deployed and running; the built-in web settings page offers a live status view and a one-click start/stop toggle, so the download-unzip-copy-launch dance is gone for good.

The tray process is spawned via a bare PowerShell call with CREATE_NO_WINDOW, fully decoupled from the DSH host. Restarting the host, disabling the plugin, or even uninstalling it will not kill a watcher that is already running. Two safety nets keep behaviour predictable: a stopping-intent flag (stopped.flag) prevents the host from silently reviving the tray after a crash restart, and a built-in mutex guarantees you will never end up with two identical trays even if a manually installed copy lingers. All management endpoints bind to loopback only, and the stop route anchors on the exact launch command line so it can never collateral-damage an editor, a script, or a test harness that merely references the same file name.

This plugin is for the Windows user who already runs DSH, wants a task-watcher tray to live quietly on the desktop, and would rather never think about the deployment pipeline again. There are no third-party runtime dependencies and no build step — the library code is hand-written ESM and the assets folder is the runtime payload itself. Upgrades are incremental: the plugin overwrites its deployed files on start, but a user-authored config.json is only written when one does not yet exist, so local customisations survive every update.