@zendero/runctl 0.1.4 → 0.1.6

package/README.md

@@ -136,6 +136,7 @@ Add scripts to your `package.json`:
 | `runctl start` \| `runctl dev` | Start dev server (same command; picks free port, backgrounds) |
 | `runctl stop [dir]` | Stop daemons & release ports |
 | `runctl status [dir]` | Show `.run` state for this package |
+| `runctl ps` | List running programs with PID, port, service, project |
 | `runctl logs [dir] [service]` | Tail `.run/logs/<service>.log` (default service: `web`) |
 | `runctl ports` | List user-wide port registry (`~/.run`) |
 | `runctl ports gc` | Clean up stale port claims |

package/bin/runctl

@@ -20,6 +20,7 @@ ${_y}Commands${_r}
   ${_c}open${_r}  [dir]                   Open running dev server in browser
   ${_c}stop${_r}  [dir]                   Stop daemons & release ports
   ${_c}status${_r} [dir]                  Show running state
+  ${_c}ps${_r}                            List running programs with ports/projects
   ${_c}logs${_r} [dir] [service]         Tail .run/logs/<service>.log ${_d}(default service: web)${_r}
   ${_c}ports${_r}                         List user-wide port registry (~/.run)
   ${_c}ports gc${_r}                      Clean up stale port claims
@@ -156,6 +157,23 @@ cmd_ports() {
   esac
 }
 
+cmd_ps() {
+  # shellcheck source=../lib/run-lib.sh
+  source "$RUNCTL_PKG_ROOT/lib/run-lib.sh"
+  run_global_list_running
+  local stale="${RUN_LAST_STALE_COUNT:-0}"
+  if [[ "$stale" =~ ^[0-9]+$ ]] && (( stale > 0 )); then
+    echo ""
+    echo "runctl ps: found $stale stale registry entr$( (( stale == 1 )) && echo "y" || echo "ies" ); cleaning..."
+    (run_global_gc >/dev/null 2>&1) &
+    local gc_pid=$!
+    wait "$gc_pid" || true
+    echo "runctl ps: refreshed"
+    echo ""
+    run_global_list_running
+  fi
+}
+
 cmd_env() {
   local sub="${1:-}"
   shift || true
@@ -449,6 +467,7 @@ main() {
     open)     cmd_open "$@" ;;
     stop)     cmd_stop "$@" ;;
     status)   cmd_status "$@" ;;
+    ps)       cmd_ps "$@" ;;
     logs)     cmd_logs "$@" ;;
     ports)    cmd_ports "$@" ;;
     env)      cmd_env "$@" ;;

package/lib/run-lib.sh

@@ -501,6 +501,64 @@ run_global_list_ports() {
   rm -f "$tmp"
 }
 
+run_pid_program_name() {
+  local pid="$1"
+  [[ -n "$pid" ]] || return 1
+  ps -p "$pid" -o comm= 2>/dev/null | awk '{$1=$1; print}'
+}
+
+run_global_list_running() {
+  mkdir -p "$RUN_GLOBAL_STATE/ports"
+  local f port tmp pid svc proot _line _k _v prog stale_count
+  stale_count=0
+  tmp="$(mktemp "${TMPDIR:-/tmp}/runlib-running.XXXXXX")"
+  shopt -s nullglob
+  for f in "$RUN_GLOBAL_STATE/ports"/*; do
+    [[ -f "$f" ]] || continue
+    port="$(basename "$f")"
+    [[ "$port" =~ ^[0-9]+$ ]] || continue
+    pid="" svc="" proot="" prog=""
+    while IFS= read -r _line; do
+      [[ -z "$_line" ]] && continue
+      _k="${_line%%=*}"
+      _v="${_line#*=}"
+      case "$_k" in
+        pid) pid="$_v" ;;
+        service) svc="$_v" ;;
+        project_root) proot="$_v" ;;
+      esac
+    done <"$f"
+    if [[ -z "$pid" ]]; then
+      stale_count=$((stale_count + 1))
+      continue
+    fi
+    if ! run_pid_alive "$pid"; then
+      stale_count=$((stale_count + 1))
+      continue
+    fi
+    if ! run_pid_listens_on_port "$pid" "$port"; then
+      stale_count=$((stale_count + 1))
+      continue
+    fi
+    prog="$(run_pid_program_name "$pid" || true)"
+    [[ -n "$prog" ]] || prog="(unknown)"
+    printf '%s\t%s\t%s\t%s\t%s\n' "$pid" "$prog" "$port" "${svc:--}" "${proot:--}" >>"$tmp"
+  done
+  shopt -u nullglob
+  printf '%-8s %-20s %-6s %-10s %s\n' "PID" "PROGRAM" "PORT" "SERVICE" "PROJECT"
+  printf '%-8s %-20s %-6s %-10s %s\n' "--------" "--------------------" "------" "----------" "-------"
+  if [[ -s "$tmp" ]]; then
+    sort -n -k1,1 "$tmp" | while IFS=$'\t' read -r pid prog port svc proot; do
+      printf '%-8s %-20s %-6s %-10s %s\n' "$pid" "$prog" "$port" "$svc" "$proot"
+    done
+  else
+    printf '%s\n' "(no running programs)"
+  fi
+  rm -f "$tmp"
+  RUN_LAST_STALE_COUNT="$stale_count"
+  export RUN_LAST_STALE_COUNT
+}
+
 run_local_status() {
   printf 'runctl status\n'
   printf '  %-10s %s\n' "project:" "$RUN_PROJECT_ROOT"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zendero/runctl",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "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",
@@ -37,6 +37,7 @@
   ],
   "scripts": {
     "run": "bash ./run.sh",
+    "test": "bash ./tests/runctl-ps.test.sh",
     "doctor": "bash ./run.sh doctor",
     "release-check": "bash ./run.sh release-check",
     "promote": "bash ./run.sh promote",