@zendero/runctl 0.1.8 → 0.1.9

package/README.md

@@ -102,6 +102,14 @@ Use npm explicitly (e.g. no pnpm on the machine):
 curl -fsSL "https://raw.githubusercontent.com/DoctorKhan/runctl/main/scripts/install-global.sh" | bash -s -- --pm npm --registry
 ```
 
+If `runctl --help` still looks old after install/update, remove the legacy package that can shadow this CLI and reinstall:
+
+```bash
+pnpm remove -g runctl
+pnpm add -g @zendero/runctl@latest
+hash -r
+```
+
 `--help` on the script prints the same usage summary.
 
 ---

package/bin/runctl

@@ -330,6 +330,19 @@ cmd_update() {
   pm="$(cmd_update_pick_pm "$PM")" || exit 1
   git_target="${GIT_BASE}#${GIT_REF}"
 
+  _remove_conflicting_global_runctl() {
+    # A legacy package named "runctl" can own the same binary name and shadow @zendero/runctl.
+    # Best-effort remove before reinstalling the intended package.
+    if [[ "$PKG" != "@zendero/runctl" ]]; then
+      return 0
+    fi
+    if [[ "$pm" == "pnpm" ]]; then
+      pnpm remove -g runctl >/dev/null 2>&1 || true
+    else
+      npm uninstall -g runctl >/dev/null 2>&1 || true
+    fi
+  }
+
   _git_base_for_ls_remote() {
     local base="$1"
     printf '%s' "${base#git+}"
@@ -349,6 +362,7 @@ cmd_update() {
   _update_registry() {
     local spec="${PKG}@latest"
     echo "runctl update: installing latest from registry ($spec)..."
+    _remove_conflicting_global_runctl
     if [[ "$pm" == "pnpm" ]]; then
       pnpm add -g --force "$spec"
     else
@@ -366,6 +380,7 @@ cmd_update() {
       echo "runctl update: installing from Git ($git_target)..."
       echo "runctl update: could not resolve ref to SHA; proceeding with ref directly." >&2
     fi
+    _remove_conflicting_global_runctl
     if [[ "$pm" == "pnpm" ]]; then
       pnpm add -g --force "$spec"
     else

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zendero/runctl",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Picks a free port, runs your dev server in the background, and keeps PID + port state in .run/ so projects don't collide.",
   "author": "DoctorKhan",
   "homepage": "https://github.com/DoctorKhan/runctl#readme",

package/scripts/install-global.sh

@@ -132,10 +132,20 @@ run_install() {
   local source_kind="$2"
   local target="$3"
 
+  # A legacy package named "runctl" can shadow the same CLI binary.
+  # Remove it before installing @zendero/runctl.
+  if [[ "$PKG" == "@zendero/runctl" ]]; then
+    if [[ "$manager" == "pnpm" ]]; then
+      pnpm remove -g runctl >/dev/null 2>&1 || true
+    else
+      npm uninstall -g runctl >/dev/null 2>&1 || true
+    fi
+  fi
+
   if [[ "$manager" == "pnpm" ]]; then
-    pnpm add -g "$target"
+    pnpm add -g --force "$target"
   else
-    npm install -g "$target"
+    npm install -g --force "$target"
   fi
 
   say