@zendero/runctl 0.1.7 → 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,22 +330,61 @@ 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+}"
+  }
+
+  _resolve_git_ref_sha() {
+    local base_url="$1"
+    local ref="$2"
+    local remote sha
+    remote="$(_git_base_for_ls_remote "$base_url")"
+    command -v git >/dev/null 2>&1 || return 1
+    sha="$(git ls-remote "$remote" "$ref" 2>/dev/null | awk 'NR==1{print $1}')"
+    [[ "$sha" =~ ^[0-9a-fA-F]{40}$ ]] || return 1
+    printf '%s' "$sha"
+  }
+
   _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 "$spec"
+      pnpm add -g --force "$spec"
     else
-      npm install -g "$spec"
+      npm install -g --force "$spec"
     fi
   }
 
   _update_git() {
-    echo "runctl update: installing from Git ($git_target)..."
+    local sha spec
+    if sha="$(_resolve_git_ref_sha "$GIT_BASE" "$GIT_REF")"; then
+      spec="${GIT_BASE}#${sha}"
+      echo "runctl update: installing from Git ref $GIT_REF (resolved to ${sha:0:12})..."
+    else
+      spec="$git_target"
+      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 "$git_target"
+      pnpm add -g --force "$spec"
     else
-      npm install -g "$git_target"
+      npm install -g --force "$spec"
     fi
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zendero/runctl",
-  "version": "0.1.7",
+  "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