@radleta/just-one 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-01-22
+
+### Added
+
+- Initial release
+- CLI tool to ensure only one instance of a command runs at a time
+- PID file management for tracking processes
+- Cross-platform support (Windows, macOS, Linux)
+- Commands: run with `-n`, kill with `-k`, list with `-l`
+- Options: `--pid-dir`, `--quiet`, `--help`, `--version`
+- Signal handling for graceful shutdown (SIGINT, SIGTERM)
+- Published as scoped package `@radleta/just-one`

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Richard Adleta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,170 @@
+# just-one
+
+A CLI tool that ensures only one instance of a command runs at a time. Kills the previous instance before starting a new one.
+
+## Why This Exists
+
+When developing with dev servers (Storybook, Vite, webpack-dev-server, etc.), you often get:
+
+```
+Error: Port 6006 is already in use
+```
+
+Existing solutions have drawbacks:
+- **kill-port** - Kills ANY process on that port (imprecise, might kill unrelated processes)
+- **Manual** - Find PID, kill it, restart (tedious)
+- **pm2** - Overkill for dev servers
+
+`just-one` tracks processes by name using PID files. When you run a command, it kills the previous instance (if any) and starts fresh—precisely targeting only the process it started.
+
+## Features
+
+- **Named process tracking** - Each process gets a unique name for precise targeting
+- **Automatic cleanup** - Previous instance killed before starting new one
+- **Cross-platform** - Works on Windows, macOS, and Linux
+- **Zero dependencies** - Uses only Node.js built-ins
+- **PID file management** - Survives terminal closes and system restarts
+
+## Installation
+
+```bash
+npm install -g @radleta/just-one
+```
+
+Or use with npx (no install required):
+
+```bash
+npx @radleta/just-one -n myapp -- npm run dev
+```
+
+## Usage
+
+### Basic usage
+
+```bash
+# Run storybook, killing any previous instance named "storybook"
+just-one -n storybook -- npx storybook dev -p 6006
+
+# Run vite dev server
+just-one -n vite -- npm run dev
+
+# Run any command
+just-one -n myapp -- node server.js
+```
+
+### Kill a named process
+
+```bash
+just-one -k storybook
+just-one --kill myapp
+```
+
+### List tracked processes
+
+```bash
+just-one -l
+just-one --list
+```
+
+### Specify custom PID directory
+
+```bash
+# Default: ./.just-one/<name>.pid
+just-one -n storybook -- npx storybook dev
+
+# Custom directory
+just-one -n storybook -d /tmp -- npx storybook dev
+```
+
+## CLI Options
+
+| Option | Alias | Description |
+|--------|-------|-------------|
+| `--name <name>` | `-n` | Required for run. Name to identify this process |
+| `--kill <name>` | `-k` | Kill the named process and exit |
+| `--list` | `-l` | List all tracked processes and their status |
+| `--pid-dir <dir>` | `-d` | Directory for PID files (default: `.just-one/`) |
+| `--quiet` | `-q` | Suppress output |
+| `--help` | `-h` | Show help |
+| `--version` | `-v` | Show version |
+
+## package.json Scripts
+
+```json
+{
+  "scripts": {
+    "storybook": "just-one -n storybook -- storybook dev -p 6006",
+    "dev": "just-one -n vite -- vite",
+    "dev:api": "just-one -n api -- node server.js",
+    "stop": "just-one -k storybook && just-one -k vite && just-one -k api"
+  }
+}
+```
+
+## How It Works
+
+```
+.just-one/
+  storybook.pid    # Contains: 12345
+  vite.pid         # Contains: 67890
+```
+
+1. Check if a PID file exists for that name
+2. If yes, kill that specific process (and its children)
+3. Start the new process
+4. Save its PID for next time
+
+### Cross-Platform Process Handling
+
+| Platform | Kill Method |
+|----------|-------------|
+| Windows | `taskkill /PID <pid> /T /F` (kills process tree) |
+| Unix/Mac | `kill -SIGTERM -<pid>` (process group) |
+
+## Use Cases
+
+- **Dev servers** - Storybook, Vite, webpack-dev-server, Next.js
+- **Background processes** - API servers, database seeders, watchers
+- **CI/CD** - Ensure clean state before running tests
+- **Multiple instances** - Run named instances on different ports
+
+```bash
+# Run two storybooks on different ports
+just-one -n storybook-main -- storybook dev -p 6006
+just-one -n storybook-docs -- storybook dev -p 6007
+```
+
+## Comparison
+
+| Feature | just-one | kill-port | pm2 |
+|---------|----------|-----------|-----|
+| Kills by PID (precise) | Yes | No (by port) | Yes |
+| Cross-platform | Yes | Yes | Yes |
+| Zero config | Yes | Yes | No |
+| Remembers processes | Yes (PID file) | No | Yes (daemon) |
+| Lightweight | ~150 LOC | ~100 LOC | Heavy |
+| Daemon required | No | No | Yes |
+
+## Requirements
+
+- Node.js >= 18.0.0
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Lint + typecheck + test
+npm run validate
+```
+
+## License
+
+MIT

package/bin/just-one.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+declare function main(): Promise<number>;
+
+export { main };

package/dist/index.js

@@ -0,0 +1,448 @@
+#!/usr/bin/env node
+
+// src/lib/cli.ts
+var DEFAULT_PID_DIR = ".just-one";
+var MAX_NAME_LENGTH = 255;
+function isValidName(name) {
+  if (!name || name.length > MAX_NAME_LENGTH) {
+    return false;
+  }
+  if (name.includes("/") || name.includes("\\") || name.includes("..")) {
+    return false;
+  }
+  if (/^[\s.]*$/.test(name)) {
+    return false;
+  }
+  return true;
+}
+function isValidPidDir(dir) {
+  if (!dir || dir.length > 1024) {
+    return false;
+  }
+  if (dir.includes("..")) {
+    return false;
+  }
+  return true;
+}
+function parseArgs(args) {
+  const options = {
+    name: void 0,
+    kill: void 0,
+    list: false,
+    pidDir: DEFAULT_PID_DIR,
+    quiet: false,
+    help: false,
+    version: false,
+    command: []
+  };
+  let i = 0;
+  while (i < args.length) {
+    const arg = args[i];
+    if (arg === "--") {
+      options.command = args.slice(i + 1);
+      break;
+    }
+    if (arg === "--help" || arg === "-h") {
+      options.help = true;
+      i++;
+      continue;
+    }
+    if (arg === "--version" || arg === "-v") {
+      options.version = true;
+      i++;
+      continue;
+    }
+    if (arg === "--list" || arg === "-l") {
+      options.list = true;
+      i++;
+      continue;
+    }
+    if (arg === "--quiet" || arg === "-q") {
+      options.quiet = true;
+      i++;
+      continue;
+    }
+    if (arg === "--name" || arg === "-n") {
+      const value = args[i + 1];
+      if (!value || value.startsWith("-")) {
+        return { success: false, error: "Option --name requires a value" };
+      }
+      if (!isValidName(value)) {
+        return { success: false, error: "Invalid name: must not contain path separators or be too long" };
+      }
+      options.name = value;
+      i += 2;
+      continue;
+    }
+    if (arg === "--kill" || arg === "-k") {
+      const value = args[i + 1];
+      if (!value || value.startsWith("-")) {
+        return { success: false, error: "Option --kill requires a value" };
+      }
+      if (!isValidName(value)) {
+        return { success: false, error: "Invalid name: must not contain path separators or be too long" };
+      }
+      options.kill = value;
+      i += 2;
+      continue;
+    }
+    if (arg === "--pid-dir" || arg === "-d") {
+      const value = args[i + 1];
+      if (!value || value.startsWith("-")) {
+        return { success: false, error: "Option --pid-dir requires a value" };
+      }
+      if (!isValidPidDir(value)) {
+        return { success: false, error: "Invalid PID directory: must not contain path traversal sequences" };
+      }
+      options.pidDir = value;
+      i += 2;
+      continue;
+    }
+    if (arg.startsWith("-")) {
+      return { success: false, error: `Unknown option: ${arg}` };
+    }
+    return { success: false, error: `Unexpected argument: ${arg}` };
+  }
+  return { success: true, options };
+}
+function validateOptions(options) {
+  if (options.help || options.version) {
+    return { success: true, options };
+  }
+  if (options.list) {
+    return { success: true, options };
+  }
+  if (options.kill) {
+    return { success: true, options };
+  }
+  if (!options.name) {
+    return { success: false, error: "Option --name is required when running a command" };
+  }
+  if (options.command.length === 0) {
+    return { success: false, error: "No command specified. Use: just-one -n <name> -- <command>" };
+  }
+  return { success: true, options };
+}
+function getHelpText() {
+  return `just-one - Ensure only one instance of a command runs at a time
+
+Usage:
+  just-one -n <name> -- <command>    Run command, killing any previous instance
+  just-one -k <name>                 Kill a named process
+  just-one -l                        List all tracked processes
+
+Options:
+  -n, --name <name>     Name to identify this process (required for running)
+  -k, --kill <name>     Kill the named process and exit
+  -l, --list            List all tracked processes and their status
+  -d, --pid-dir <dir>   Directory for PID files (default: .just-one/)
+  -q, --quiet           Suppress output
+  -h, --help            Show this help message
+  -v, --version         Show version number
+
+Examples:
+  # Run storybook, killing any previous instance
+  just-one -n storybook -- npx storybook dev -p 6006
+
+  # Run vite dev server
+  just-one -n vite -- npm run dev
+
+  # Kill a named process
+  just-one -k storybook
+
+  # List all tracked processes
+  just-one -l
+`;
+}
+
+// src/lib/pid.ts
+import { readFileSync, writeFileSync, unlinkSync, existsSync, mkdirSync, readdirSync } from "fs";
+import { join, dirname } from "path";
+function getPidFilePath(name, pidDir) {
+  return join(pidDir, `${name}.pid`);
+}
+function readPid(name, pidDir) {
+  const pidFile = getPidFilePath(name, pidDir);
+  if (!existsSync(pidFile)) {
+    return null;
+  }
+  try {
+    const content = readFileSync(pidFile, "utf8").trim();
+    const pid = parseInt(content, 10);
+    if (isNaN(pid) || pid <= 0) {
+      return null;
+    }
+    return pid;
+  } catch {
+    return null;
+  }
+}
+function writePid(name, pid, pidDir) {
+  const pidFile = getPidFilePath(name, pidDir);
+  const dir = dirname(pidFile);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  writeFileSync(pidFile, String(pid), "utf8");
+}
+function deletePid(name, pidDir) {
+  const pidFile = getPidFilePath(name, pidDir);
+  if (!existsSync(pidFile)) {
+    return false;
+  }
+  try {
+    unlinkSync(pidFile);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function listPids(pidDir) {
+  if (!existsSync(pidDir)) {
+    return [];
+  }
+  const files = readdirSync(pidDir);
+  const pidFiles = files.filter((f) => f.endsWith(".pid"));
+  return pidFiles.map((file) => {
+    const name = file.slice(0, -4);
+    const pid = readPid(name, pidDir);
+    return {
+      name,
+      pid: pid ?? 0,
+      exists: pid !== null
+    };
+  });
+}
+
+// src/lib/process.ts
+import { spawn, execSync } from "child_process";
+var isWindows = process.platform === "win32";
+var DEFAULT_WAIT_TIMEOUT_MS = 2e3;
+var CHECK_INTERVAL_MS = 100;
+function isValidPid(pid) {
+  return Number.isInteger(pid) && pid > 0 && pid <= 4194304;
+}
+function isProcessAlive(pid) {
+  try {
+    if (!isValidPid(pid)) {
+      return false;
+    }
+    if (isWindows) {
+      const output = execSync(`tasklist /FI "PID eq ${pid}" /NH`, {
+        encoding: "utf8",
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+      return output.includes(String(pid));
+    } else {
+      process.kill(pid, 0);
+      return true;
+    }
+  } catch {
+    return false;
+  }
+}
+function killProcess(pid) {
+  if (!isValidPid(pid) || !isProcessAlive(pid)) {
+    return false;
+  }
+  try {
+    if (isWindows) {
+      execSync(`taskkill /PID ${pid} /T /F`, {
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+    } else {
+      const killed = tryKillUnix(-pid) || tryKillUnix(pid);
+      if (!killed) {
+        return false;
+      }
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+function tryKillUnix(pid) {
+  try {
+    process.kill(pid, "SIGTERM");
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function waitForProcessToDie(pid, timeoutMs = DEFAULT_WAIT_TIMEOUT_MS) {
+  const startTime = Date.now();
+  while (Date.now() - startTime < timeoutMs) {
+    if (!isProcessAlive(pid)) {
+      return true;
+    }
+    await new Promise((resolve) => setTimeout(resolve, CHECK_INTERVAL_MS));
+  }
+  return !isProcessAlive(pid);
+}
+function spawnCommand(command, args) {
+  const spawnCmd = isWindows ? `${command} ${args.join(" ")}` : command;
+  const spawnArgs = isWindows ? [] : args;
+  const child = spawn(spawnCmd, spawnArgs, {
+    stdio: "inherit",
+    shell: isWindows,
+    detached: !isWindows
+  });
+  if (child.pid === void 0) {
+    throw new Error("Failed to spawn process");
+  }
+  return {
+    child,
+    pid: child.pid
+  };
+}
+function setupSignalHandlers(child, onExit) {
+  const handleSignal = (_signal) => {
+    if (child.pid && isValidPid(child.pid)) {
+      if (isWindows) {
+        try {
+          execSync(`taskkill /PID ${child.pid} /T /F`, {
+            stdio: ["pipe", "pipe", "pipe"]
+          });
+        } catch {
+        }
+      } else {
+        child.kill("SIGTERM");
+      }
+    }
+  };
+  process.on("SIGINT", () => handleSignal("SIGINT"));
+  process.on("SIGTERM", () => handleSignal("SIGTERM"));
+  child.on("exit", (code, signal) => {
+    if (onExit) {
+      onExit();
+    }
+    if (signal) {
+      process.exit(128 + (signal === "SIGTERM" ? 15 : signal === "SIGINT" ? 2 : 1));
+    }
+    process.exit(code ?? 0);
+  });
+  child.on("error", (err) => {
+    console.error(`Failed to start process: ${err.message}`);
+    process.exit(1);
+  });
+}
+
+// src/index.ts
+var VERSION = "0.1.0";
+function log(message, options) {
+  if (!options.quiet) {
+    console.log(message);
+  }
+}
+function logError(message) {
+  console.error(message);
+}
+async function handleKill(name, options) {
+  const pid = readPid(name, options.pidDir);
+  if (pid === null) {
+    log(`No process found with name: ${name}`, options);
+    return 0;
+  }
+  if (!isProcessAlive(pid)) {
+    log(`Process ${name} (PID: ${pid}) is not running, cleaning up PID file`, options);
+    deletePid(name, options.pidDir);
+    return 0;
+  }
+  log(`Killing process ${name} (PID: ${pid})...`, options);
+  const killed = killProcess(pid);
+  if (killed) {
+    await waitForProcessToDie(pid);
+    deletePid(name, options.pidDir);
+    log(`Process ${name} killed`, options);
+    return 0;
+  } else {
+    logError(`Failed to kill process ${name} (PID: ${pid})`);
+    return 1;
+  }
+}
+function handleList(options) {
+  const pids = listPids(options.pidDir);
+  if (pids.length === 0) {
+    log("No tracked processes", options);
+    return 0;
+  }
+  log("Tracked processes:", options);
+  for (const info of pids) {
+    const status = info.exists && isProcessAlive(info.pid) ? "running" : "stopped";
+    const pidStr = info.pid > 0 ? String(info.pid) : "unknown";
+    log(`  ${info.name}: PID ${pidStr} (${status})`, options);
+  }
+  return 0;
+}
+async function handleRun(options) {
+  const name = options.name;
+  const [command, ...args] = options.command;
+  if (!command) {
+    logError("No command specified");
+    return 1;
+  }
+  const existingPid = readPid(name, options.pidDir);
+  if (existingPid !== null) {
+    if (isProcessAlive(existingPid)) {
+      log(`Killing existing process ${name} (PID: ${existingPid})...`, options);
+      killProcess(existingPid);
+      await waitForProcessToDie(existingPid);
+    }
+    deletePid(name, options.pidDir);
+  }
+  log(`Starting: ${command} ${args.join(" ")}`, options);
+  try {
+    const { child, pid } = spawnCommand(command, args);
+    writePid(name, pid, options.pidDir);
+    log(`Process started with PID: ${pid}`, options);
+    setupSignalHandlers(child);
+    return 0;
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    logError(`Failed to start process: ${message}`);
+    return 1;
+  }
+}
+async function main() {
+  const args = process.argv.slice(2);
+  const parseResult = parseArgs(args);
+  if (!parseResult.success) {
+    logError(`Error: ${parseResult.error}`);
+    logError("Use --help for usage information");
+    return 1;
+  }
+  const options = parseResult.options;
+  const validateResult = validateOptions(options);
+  if (!validateResult.success) {
+    logError(`Error: ${validateResult.error}`);
+    logError("Use --help for usage information");
+    return 1;
+  }
+  if (options.help) {
+    console.log(getHelpText());
+    return 0;
+  }
+  if (options.version) {
+    console.log(`just-one v${VERSION}`);
+    return 0;
+  }
+  if (options.list) {
+    return handleList(options);
+  }
+  if (options.kill) {
+    return await handleKill(options.kill, options);
+  }
+  return await handleRun(options);
+}
+main().then((code) => {
+  if (code !== 0) {
+    process.exit(code);
+  }
+}).catch((err) => {
+  console.error("Unexpected error:", err);
+  process.exit(1);
+});
+export {
+  main
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/cli.ts","../src/lib/pid.ts","../src/lib/process.ts","../src/index.ts"],"sourcesContent":["/**\r\n * CLI argument parsing for just-one\r\n */\r\n\r\nexport interface CliOptions {\r\n  name?: string;\r\n  kill?: string;\r\n  list: boolean;\r\n  pidDir: string;\r\n  quiet: boolean;\r\n  help: boolean;\r\n  version: boolean;\r\n  command: string[];\r\n}\r\n\r\nexport interface ParseResult {\r\n  success: true;\r\n  options: CliOptions;\r\n}\r\n\r\nexport interface ParseError {\r\n  success: false;\r\n  error: string;\r\n}\r\n\r\nexport type ParseOutput = ParseResult | ParseError;\r\n\r\nconst DEFAULT_PID_DIR = '.just-one';\r\nconst MAX_NAME_LENGTH = 255;\r\n\r\n/**\r\n * Validate a process name for safe file operations\r\n * Rejects names containing path separators or traversal sequences\r\n */\r\nfunction isValidName(name: string): boolean {\r\n  if (!name || name.length > MAX_NAME_LENGTH) {\r\n    return false;\r\n  }\r\n  // Reject path separators and traversal sequences\r\n  if (name.includes('/') || name.includes('\\\\') || name.includes('..')) {\r\n    return false;\r\n  }\r\n  // Reject names that are only dots or whitespace\r\n  if (/^[\\s.]*$/.test(name)) {\r\n    return false;\r\n  }\r\n  return true;\r\n}\r\n\r\n/**\r\n * Validate a PID directory path for safe file operations\r\n * Rejects paths containing traversal sequences\r\n */\r\nfunction isValidPidDir(dir: string): boolean {\r\n  if (!dir || dir.length > 1024) {\r\n    return false;\r\n  }\r\n  // Reject path traversal sequences\r\n  if (dir.includes('..')) {\r\n    return false;\r\n  }\r\n  return true;\r\n}\r\n\r\n/**\r\n * Parse command line arguments\r\n */\r\nexport function parseArgs(args: string[]): ParseOutput {\r\n  const options: CliOptions = {\r\n    name: undefined,\r\n    kill: undefined,\r\n    list: false,\r\n    pidDir: DEFAULT_PID_DIR,\r\n    quiet: false,\r\n    help: false,\r\n    version: false,\r\n    command: [],\r\n  };\r\n\r\n  let i = 0;\r\n  while (i < args.length) {\r\n    // TypeScript requires this check due to noUncheckedIndexedAccess\r\n    const arg = args[i]!;\r\n\r\n    // Everything after -- is the command\r\n    if (arg === '--') {\r\n      options.command = args.slice(i + 1);\r\n      break;\r\n    }\r\n\r\n    // Help\r\n    if (arg === '--help' || arg === '-h') {\r\n      options.help = true;\r\n      i++;\r\n      continue;\r\n    }\r\n\r\n    // Version\r\n    if (arg === '--version' || arg === '-v') {\r\n      options.version = true;\r\n      i++;\r\n      continue;\r\n    }\r\n\r\n    // List\r\n    if (arg === '--list' || arg === '-l') {\r\n      options.list = true;\r\n      i++;\r\n      continue;\r\n    }\r\n\r\n    // Quiet\r\n    if (arg === '--quiet' || arg === '-q') {\r\n      options.quiet = true;\r\n      i++;\r\n      continue;\r\n    }\r\n\r\n    // Name (requires value)\r\n    if (arg === '--name' || arg === '-n') {\r\n      const value = args[i + 1];\r\n      if (!value || value.startsWith('-')) {\r\n        return { success: false, error: 'Option --name requires a value' };\r\n      }\r\n      if (!isValidName(value)) {\r\n        return { success: false, error: 'Invalid name: must not contain path separators or be too long' };\r\n      }\r\n      options.name = value;\r\n      i += 2;\r\n      continue;\r\n    }\r\n\r\n    // Kill (requires value)\r\n    if (arg === '--kill' || arg === '-k') {\r\n      const value = args[i + 1];\r\n      if (!value || value.startsWith('-')) {\r\n        return { success: false, error: 'Option --kill requires a value' };\r\n      }\r\n      if (!isValidName(value)) {\r\n        return { success: false, error: 'Invalid name: must not contain path separators or be too long' };\r\n      }\r\n      options.kill = value;\r\n      i += 2;\r\n      continue;\r\n    }\r\n\r\n    // PID directory (requires value)\r\n    if (arg === '--pid-dir' || arg === '-d') {\r\n      const value = args[i + 1];\r\n      if (!value || value.startsWith('-')) {\r\n        return { success: false, error: 'Option --pid-dir requires a value' };\r\n      }\r\n      if (!isValidPidDir(value)) {\r\n        return { success: false, error: 'Invalid PID directory: must not contain path traversal sequences' };\r\n      }\r\n      options.pidDir = value;\r\n      i += 2;\r\n      continue;\r\n    }\r\n\r\n    // Unknown option\r\n    if (arg.startsWith('-')) {\r\n      return { success: false, error: `Unknown option: ${arg}` };\r\n    }\r\n\r\n    // Unexpected positional argument\r\n    return { success: false, error: `Unexpected argument: ${arg}` };\r\n  }\r\n\r\n  return { success: true, options };\r\n}\r\n\r\n/**\r\n * Validate parsed options\r\n */\r\nexport function validateOptions(options: CliOptions): ParseOutput {\r\n  // Help and version don't need validation\r\n  if (options.help || options.version) {\r\n    return { success: true, options };\r\n  }\r\n\r\n  // List doesn't need name or command\r\n  if (options.list) {\r\n    return { success: true, options };\r\n  }\r\n\r\n  // Kill only needs a name\r\n  if (options.kill) {\r\n    return { success: true, options };\r\n  }\r\n\r\n  // Running a command requires both name and command\r\n  if (!options.name) {\r\n    return { success: false, error: 'Option --name is required when running a command' };\r\n  }\r\n\r\n  if (options.command.length === 0) {\r\n    return { success: false, error: 'No command specified. Use: just-one -n <name> -- <command>' };\r\n  }\r\n\r\n  return { success: true, options };\r\n}\r\n\r\n/**\r\n * Get help text\r\n */\r\nexport function getHelpText(): string {\r\n  return `just-one - Ensure only one instance of a command runs at a time\r\n\r\nUsage:\r\n  just-one -n <name> -- <command>    Run command, killing any previous instance\r\n  just-one -k <name>                 Kill a named process\r\n  just-one -l                        List all tracked processes\r\n\r\nOptions:\r\n  -n, --name <name>     Name to identify this process (required for running)\r\n  -k, --kill <name>     Kill the named process and exit\r\n  -l, --list            List all tracked processes and their status\r\n  -d, --pid-dir <dir>   Directory for PID files (default: .just-one/)\r\n  -q, --quiet           Suppress output\r\n  -h, --help            Show this help message\r\n  -v, --version         Show version number\r\n\r\nExamples:\r\n  # Run storybook, killing any previous instance\r\n  just-one -n storybook -- npx storybook dev -p 6006\r\n\r\n  # Run vite dev server\r\n  just-one -n vite -- npm run dev\r\n\r\n  # Kill a named process\r\n  just-one -k storybook\r\n\r\n  # List all tracked processes\r\n  just-one -l\r\n`;\r\n}\r\n","/**\r\n * PID file operations for just-one\r\n */\r\n\r\nimport { readFileSync, writeFileSync, unlinkSync, existsSync, mkdirSync, readdirSync } from 'fs';\r\nimport { join, dirname } from 'path';\r\n\r\nexport interface PidInfo {\r\n  name: string;\r\n  pid: number;\r\n  exists: boolean;\r\n}\r\n\r\n/**\r\n * Get the path to a PID file for a given name\r\n */\r\nexport function getPidFilePath(name: string, pidDir: string): string {\r\n  return join(pidDir, `${name}.pid`);\r\n}\r\n\r\n/**\r\n * Read the PID from a PID file\r\n * Returns null if the file doesn't exist or is invalid\r\n */\r\nexport function readPid(name: string, pidDir: string): number | null {\r\n  const pidFile = getPidFilePath(name, pidDir);\r\n\r\n  if (!existsSync(pidFile)) {\r\n    return null;\r\n  }\r\n\r\n  try {\r\n    const content = readFileSync(pidFile, 'utf8').trim();\r\n    const pid = parseInt(content, 10);\r\n\r\n    if (isNaN(pid) || pid <= 0) {\r\n      return null;\r\n    }\r\n\r\n    return pid;\r\n  } catch {\r\n    return null;\r\n  }\r\n}\r\n\r\n/**\r\n * Write a PID to a PID file\r\n * Creates the directory if it doesn't exist\r\n */\r\nexport function writePid(name: string, pid: number, pidDir: string): void {\r\n  const pidFile = getPidFilePath(name, pidDir);\r\n  const dir = dirname(pidFile);\r\n\r\n  if (!existsSync(dir)) {\r\n    mkdirSync(dir, { recursive: true });\r\n  }\r\n\r\n  writeFileSync(pidFile, String(pid), 'utf8');\r\n}\r\n\r\n/**\r\n * Delete a PID file\r\n * Returns true if the file was deleted, false if it didn't exist\r\n */\r\nexport function deletePid(name: string, pidDir: string): boolean {\r\n  const pidFile = getPidFilePath(name, pidDir);\r\n\r\n  if (!existsSync(pidFile)) {\r\n    return false;\r\n  }\r\n\r\n  try {\r\n    unlinkSync(pidFile);\r\n    return true;\r\n  } catch {\r\n    return false;\r\n  }\r\n}\r\n\r\n/**\r\n * List all PID files in the directory\r\n * Returns information about each tracked process\r\n */\r\nexport function listPids(pidDir: string): PidInfo[] {\r\n  if (!existsSync(pidDir)) {\r\n    return [];\r\n  }\r\n\r\n  const files = readdirSync(pidDir);\r\n  const pidFiles = files.filter(f => f.endsWith('.pid'));\r\n\r\n  return pidFiles.map(file => {\r\n    // Remove .pid suffix (use slice to only remove from end)\r\n    const name = file.slice(0, -4);\r\n    const pid = readPid(name, pidDir);\r\n\r\n    return {\r\n      name,\r\n      pid: pid ?? 0,\r\n      exists: pid !== null,\r\n    };\r\n  });\r\n}\r\n","/**\r\n * Cross-platform process handling for just-one\r\n */\r\n\r\nimport { spawn, execSync, ChildProcess } from 'child_process';\r\n\r\nconst isWindows = process.platform === 'win32';\r\n\r\n// Constants for process polling\r\nconst DEFAULT_WAIT_TIMEOUT_MS = 2000;\r\nconst CHECK_INTERVAL_MS = 100;\r\n\r\n/**\r\n * Validate that a PID is a safe positive integer for use in system calls\r\n */\r\nfunction isValidPid(pid: number): boolean {\r\n  return Number.isInteger(pid) && pid > 0 && pid <= 4194304; // Max PID on most systems\r\n}\r\n\r\n/**\r\n * Check if a process with the given PID is still running\r\n */\r\nexport function isProcessAlive(pid: number): boolean {\r\n  try {\r\n    if (!isValidPid(pid)) {\r\n      return false;\r\n    }\r\n    if (isWindows) {\r\n      // Windows: tasklist returns exit code 0 if process found\r\n      // PID is validated as a safe integer above before interpolation\r\n      const output = execSync(`tasklist /FI \"PID eq ${pid}\" /NH`, {\r\n        encoding: 'utf8',\r\n        stdio: ['pipe', 'pipe', 'pipe'],\r\n      });\r\n      return output.includes(String(pid));\r\n    } else {\r\n      // Unix/Mac: kill -0 checks if process exists without killing it\r\n      process.kill(pid, 0);\r\n      return true;\r\n    }\r\n  } catch {\r\n    return false;\r\n  }\r\n}\r\n\r\n/**\r\n * Kill a process by PID\r\n * Returns true if the process was killed, false if it wasn't running\r\n */\r\nexport function killProcess(pid: number): boolean {\r\n  if (!isValidPid(pid) || !isProcessAlive(pid)) {\r\n    return false;\r\n  }\r\n\r\n  try {\r\n    if (isWindows) {\r\n      // Windows: taskkill with /T kills the process tree, /F forces\r\n      // PID is validated as a safe integer above before interpolation\r\n      execSync(`taskkill /PID ${pid} /T /F`, {\r\n        stdio: ['pipe', 'pipe', 'pipe'],\r\n      });\r\n    } else {\r\n      // Unix: try to kill process group first (catches child processes),\r\n      // fall back to killing just the process if group kill fails\r\n      const killed = tryKillUnix(-pid) || tryKillUnix(pid);\r\n      if (!killed) {\r\n        return false;\r\n      }\r\n    }\r\n    return true;\r\n  } catch {\r\n    return false;\r\n  }\r\n}\r\n\r\n/**\r\n * Helper to attempt Unix kill with error handling\r\n */\r\nfunction tryKillUnix(pid: number): boolean {\r\n  try {\r\n    process.kill(pid, 'SIGTERM');\r\n    return true;\r\n  } catch {\r\n    return false;\r\n  }\r\n}\r\n\r\n/**\r\n * Wait for a process to die, with timeout\r\n * @param pid - Process ID to wait for\r\n * @param timeoutMs - Maximum time to wait (default: 2000ms)\r\n */\r\nexport async function waitForProcessToDie(\r\n  pid: number,\r\n  timeoutMs: number = DEFAULT_WAIT_TIMEOUT_MS\r\n): Promise<boolean> {\r\n  const startTime = Date.now();\r\n\r\n  while (Date.now() - startTime < timeoutMs) {\r\n    if (!isProcessAlive(pid)) {\r\n      return true;\r\n    }\r\n    await new Promise(resolve => setTimeout(resolve, CHECK_INTERVAL_MS));\r\n  }\r\n\r\n  return !isProcessAlive(pid);\r\n}\r\n\r\nexport interface SpawnResult {\r\n  child: ChildProcess;\r\n  pid: number;\r\n}\r\n\r\n/**\r\n * Spawn a command with stdio forwarding\r\n */\r\nexport function spawnCommand(command: string, args: string[]): SpawnResult {\r\n  // On Windows, pass entire command as a single string to avoid escaping issues\r\n  // with shell: true (DEP0190 warning and argument handling)\r\n  const spawnCmd = isWindows ? `${command} ${args.join(' ')}` : command;\r\n  const spawnArgs = isWindows ? [] : args;\r\n\r\n  const child = spawn(spawnCmd, spawnArgs, {\r\n    stdio: 'inherit',\r\n    shell: isWindows,\r\n    detached: !isWindows,\r\n  });\r\n\r\n  if (child.pid === undefined) {\r\n    throw new Error('Failed to spawn process');\r\n  }\r\n\r\n  return {\r\n    child,\r\n    pid: child.pid,\r\n  };\r\n}\r\n\r\n/**\r\n * Set up signal handlers to forward signals to child process\r\n * Note: Both SIGINT and SIGTERM are forwarded as SIGTERM to ensure\r\n * consistent graceful shutdown behavior across different termination methods.\r\n */\r\nexport function setupSignalHandlers(child: ChildProcess, onExit?: () => void): void {\r\n  const handleSignal = (_signal: NodeJS.Signals) => {\r\n    if (child.pid && isValidPid(child.pid)) {\r\n      if (isWindows) {\r\n        try {\r\n          // PID is validated as a safe integer above before interpolation\r\n          execSync(`taskkill /PID ${child.pid} /T /F`, {\r\n            stdio: ['pipe', 'pipe', 'pipe'],\r\n          });\r\n        } catch {\r\n          // Process might already be dead\r\n        }\r\n      } else {\r\n        // Forward as SIGTERM for graceful shutdown\r\n        child.kill('SIGTERM');\r\n      }\r\n    }\r\n  };\r\n\r\n  // Forward both SIGINT (Ctrl+C) and SIGTERM to child as SIGTERM\r\n  process.on('SIGINT', () => handleSignal('SIGINT'));\r\n  process.on('SIGTERM', () => handleSignal('SIGTERM'));\r\n\r\n  child.on('exit', (code, signal) => {\r\n    if (onExit) {\r\n      onExit();\r\n    }\r\n    if (signal) {\r\n      process.exit(128 + (signal === 'SIGTERM' ? 15 : signal === 'SIGINT' ? 2 : 1));\r\n    }\r\n    process.exit(code ?? 0);\r\n  });\r\n\r\n  child.on('error', err => {\r\n    console.error(`Failed to start process: ${err.message}`);\r\n    process.exit(1);\r\n  });\r\n}\r\n","#!/usr/bin/env node\r\n/**\r\n * just-one - Ensure only one instance of a command runs at a time\r\n */\r\n\r\nimport { parseArgs, validateOptions, getHelpText, type CliOptions } from './lib/cli.js';\r\nimport { readPid, writePid, deletePid, listPids } from './lib/pid.js';\r\nimport {\r\n  isProcessAlive,\r\n  killProcess,\r\n  waitForProcessToDie,\r\n  spawnCommand,\r\n  setupSignalHandlers,\r\n} from './lib/process.js';\r\n\r\n// Read version from package.json at build time\r\nconst VERSION = '0.1.0';\r\n\r\nfunction log(message: string, options: CliOptions): void {\r\n  if (!options.quiet) {\r\n    console.log(message);\r\n  }\r\n}\r\n\r\nfunction logError(message: string): void {\r\n  console.error(message);\r\n}\r\n\r\nasync function handleKill(name: string, options: CliOptions): Promise<number> {\r\n  const pid = readPid(name, options.pidDir);\r\n\r\n  if (pid === null) {\r\n    log(`No process found with name: ${name}`, options);\r\n    return 0;\r\n  }\r\n\r\n  if (!isProcessAlive(pid)) {\r\n    log(`Process ${name} (PID: ${pid}) is not running, cleaning up PID file`, options);\r\n    deletePid(name, options.pidDir);\r\n    return 0;\r\n  }\r\n\r\n  log(`Killing process ${name} (PID: ${pid})...`, options);\r\n  const killed = killProcess(pid);\r\n\r\n  if (killed) {\r\n    await waitForProcessToDie(pid);\r\n    deletePid(name, options.pidDir);\r\n    log(`Process ${name} killed`, options);\r\n    return 0;\r\n  } else {\r\n    logError(`Failed to kill process ${name} (PID: ${pid})`);\r\n    return 1;\r\n  }\r\n}\r\n\r\nfunction handleList(options: CliOptions): number {\r\n  const pids = listPids(options.pidDir);\r\n\r\n  if (pids.length === 0) {\r\n    log('No tracked processes', options);\r\n    return 0;\r\n  }\r\n\r\n  log('Tracked processes:', options);\r\n  for (const info of pids) {\r\n    const status = info.exists && isProcessAlive(info.pid) ? 'running' : 'stopped';\r\n    const pidStr = info.pid > 0 ? String(info.pid) : 'unknown';\r\n    log(`  ${info.name}: PID ${pidStr} (${status})`, options);\r\n  }\r\n\r\n  return 0;\r\n}\r\n\r\nasync function handleRun(options: CliOptions): Promise<number> {\r\n  const name = options.name!;\r\n  const [command, ...args] = options.command;\r\n\r\n  if (!command) {\r\n    logError('No command specified');\r\n    return 1;\r\n  }\r\n\r\n  // Check for existing process\r\n  const existingPid = readPid(name, options.pidDir);\r\n  if (existingPid !== null) {\r\n    if (isProcessAlive(existingPid)) {\r\n      log(`Killing existing process ${name} (PID: ${existingPid})...`, options);\r\n      killProcess(existingPid);\r\n      await waitForProcessToDie(existingPid);\r\n    }\r\n    deletePid(name, options.pidDir);\r\n  }\r\n\r\n  // Spawn the new process\r\n  log(`Starting: ${command} ${args.join(' ')}`, options);\r\n\r\n  try {\r\n    const { child, pid } = spawnCommand(command, args);\r\n\r\n    // Save PID\r\n    writePid(name, pid, options.pidDir);\r\n    log(`Process started with PID: ${pid}`, options);\r\n\r\n    // Set up signal handlers\r\n    // Note: We intentionally do NOT delete the PID file on exit.\r\n    // If the process exits unexpectedly, the PID file allows the next run\r\n    // to find and kill any orphaned processes.\r\n    setupSignalHandlers(child);\r\n\r\n    // The process will keep running until it exits or is killed\r\n    // The exit handler in setupSignalHandlers will call process.exit\r\n    return 0;\r\n  } catch (err) {\r\n    const message = err instanceof Error ? err.message : String(err);\r\n    logError(`Failed to start process: ${message}`);\r\n    return 1;\r\n  }\r\n}\r\n\r\nasync function main(): Promise<number> {\r\n  const args = process.argv.slice(2);\r\n\r\n  // Parse arguments\r\n  const parseResult = parseArgs(args);\r\n  if (!parseResult.success) {\r\n    logError(`Error: ${parseResult.error}`);\r\n    logError('Use --help for usage information');\r\n    return 1;\r\n  }\r\n\r\n  const options = parseResult.options;\r\n\r\n  // Validate options\r\n  const validateResult = validateOptions(options);\r\n  if (!validateResult.success) {\r\n    logError(`Error: ${validateResult.error}`);\r\n    logError('Use --help for usage information');\r\n    return 1;\r\n  }\r\n\r\n  // Handle help\r\n  if (options.help) {\r\n    console.log(getHelpText());\r\n    return 0;\r\n  }\r\n\r\n  // Handle version\r\n  if (options.version) {\r\n    console.log(`just-one v${VERSION}`);\r\n    return 0;\r\n  }\r\n\r\n  // Handle list\r\n  if (options.list) {\r\n    return handleList(options);\r\n  }\r\n\r\n  // Handle kill\r\n  if (options.kill) {\r\n    return await handleKill(options.kill, options);\r\n  }\r\n\r\n  // Handle run\r\n  return await handleRun(options);\r\n}\r\n\r\n// Run the CLI\r\nmain()\r\n  .then(code => {\r\n    // Only exit if we're not running a child process\r\n    // The child process exit handler will call process.exit\r\n    if (code !== 0) {\r\n      process.exit(code);\r\n    }\r\n  })\r\n  .catch(err => {\r\n    console.error('Unexpected error:', err);\r\n    process.exit(1);\r\n  });\r\n\r\n// Export for testing\r\nexport { main };\r\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "@radleta/just-one",
+  "version": "0.1.0",
+  "description": "A CLI tool that ensures only one instance of a command runs at a time",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "just-one": "bin/just-one.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "prebuild": "npm run clean",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src",
+    "format": "prettier --write \"src/**/*.ts\" \"*.{json,md,yml,yaml}\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"*.{json,md,yml,yaml}\"",
+    "typecheck": "tsc --noEmit",
+    "validate": "npm run lint && npm run typecheck && npm run test",
+    "pack:dry": "npm pack --dry-run",
+    "size:check": "npm pack --dry-run 2>&1 | grep 'package size' | head -1 || echo 'Run npm pack to see size'",
+    "verify:package": "node scripts/verify-package.js",
+    "release:prepare": "npm run validate && npm run build && npm run verify:package && npm run size:check && echo '\nReady for release. Run: npm version [patch|minor|major]'",
+    "preversion": "npm run validate",
+    "postversion": "git push && git push --tags",
+    "prepublishOnly": "npm run validate && npm run build",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "cli",
+    "process",
+    "singleton",
+    "pid",
+    "kill",
+    "dev-server",
+    "storybook",
+    "vite",
+    "webpack"
+  ],
+  "homepage": "https://github.com/radleta/just-one#readme",
+  "bugs": {
+    "url": "https://github.com/radleta/just-one/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/radleta/just-one.git"
+  },
+  "author": {
+    "name": "Richard Adleta",
+    "email": "radleta@gmail.com",
+    "url": "https://github.com/radleta"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.20.0",
+    "@typescript-eslint/parser": "^8.20.0",
+    "@vitest/coverage-v8": "^3.0.0",
+    "eslint": "^9.18.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.4",
+    "prettier": "^3.4.2",
+    "tsup": "^8.0.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.0.0"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{json,md,yml,yaml}": [
+      "prettier --write"
+    ]
+  }
+}