bgproc 0.0.0

package/README.md

@@ -0,0 +1,108 @@
+# bgproc
+
+Simple process manager for agents.
+
+Manage background processes like dev servers from the command line. Designed to be agent-friendly with JSON output and easy status checking.
+
+## Install
+
+```bash
+npm install -g bgproc
+```
+
+## Usage
+
+```bash
+# Start a process
+bgproc start -n myserver -- npm run dev
+
+# Check status (returns JSON with port detection)
+bgproc status myserver
+# {"name":"myserver","pid":12345,"running":true,"port":3000,...}
+
+# View logs
+bgproc logs myserver
+bgproc logs myserver --tail 50
+bgproc logs myserver --follow
+bgproc logs myserver --errors  # stderr only
+
+# List all processes
+bgproc list
+bgproc list --cwd              # filter to current directory
+bgproc list --cwd /path/to/dir # filter to specific directory
+
+# Stop a process
+bgproc stop myserver
+bgproc stop myserver --force   # SIGKILL
+
+# Clean up dead processes
+bgproc clean myserver
+bgproc clean --all
+```
+
+## Features
+
+- **JSON output**: All commands output JSON to stdout, errors to stderr
+- **Port detection**: Automatically detects listening ports via `lsof`
+- **Duplicate prevention**: Prevent starting multiple processes with the same name
+- **Log management**: Stdout/stderr captured, capped at 1MB
+- **Timeout support**: `--timeout 60` kills after N seconds
+- **Auto-cleanup**: Starting a process with the same name as a dead one auto-cleans it
+- **CWD filtering**: Filter process list by working directory
+
+## Options
+
+### `start`
+
+```
+-n, --name     Process name (required)
+-t, --timeout  Kill after N seconds
+```
+
+### `status`, `stop`, `logs`, `clean`
+
+All accept process name as positional arg or `-n`:
+
+```bash
+bgproc status myserver
+bgproc status -n myserver  # equivalent
+```
+
+### `logs`
+
+```
+-t, --tail     Number of lines (default: 100)
+-f, --follow   Tail the log
+-e, --errors   Show stderr only
+-a, --all      Show all logs
+```
+
+### `stop`
+
+```
+-f, --force    Use SIGKILL instead of SIGTERM
+```
+
+### `list`
+
+```
+-c, --cwd      Filter by directory (no arg = current dir)
+```
+
+### `clean`
+
+```
+-a, --all      Clean all dead processes
+```
+
+## Environment
+
+- `BGPROC_DATA_DIR`: Override data directory (default: `~/.local/share/bgproc`)
+
+## Platform Support
+
+macOS and Linux only. Windows is not supported.
+
+## License
+
+MIT © Matt Kane 2026

package/dist/cli.d.mts

@@ -0,0 +1,2 @@
+
+export { };

package/dist/cli.mjs

@@ -0,0 +1,537 @@
+#!/usr/bin/env node
+import { defineCommand, runMain } from "citty";
+import { execSync, spawn } from "node:child_process";
+import { existsSync, mkdirSync, openSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import path, { join } from "node:path";
+
+//#region src/registry.ts
+function getDataDir() {
+	return process.env.BGPROC_DATA_DIR || join(homedir(), ".local", "share", "bgproc");
+}
+function getRegistryPath() {
+	return join(getDataDir(), "registry.json");
+}
+function getLogsDir() {
+	return join(getDataDir(), "logs");
+}
+function ensureDataDir() {
+	mkdirSync(getDataDir(), { recursive: true });
+	mkdirSync(getLogsDir(), { recursive: true });
+}
+function readRegistry() {
+	ensureDataDir();
+	const registryPath = getRegistryPath();
+	if (!existsSync(registryPath)) return {};
+	try {
+		const content = readFileSync(registryPath, "utf-8");
+		return JSON.parse(content);
+	} catch {
+		return {};
+	}
+}
+function writeRegistry(registry) {
+	ensureDataDir();
+	writeFileSync(getRegistryPath(), JSON.stringify(registry, null, 2));
+}
+function addProcess(name, entry) {
+	const registry = readRegistry();
+	const existing = registry[name];
+	if (existing) {
+		if (isProcessRunning(existing.pid)) throw new Error(`Process '${name}' is already running (PID ${existing.pid}). Use 'bgproc stop ${name}' first.`);
+		const logPaths = getLogPaths(name);
+		try {
+			if (existsSync(logPaths.stdout)) unlinkSync(logPaths.stdout);
+			if (existsSync(logPaths.stderr)) unlinkSync(logPaths.stderr);
+		} catch {}
+	}
+	registry[name] = entry;
+	writeRegistry(registry);
+}
+function removeProcess(name) {
+	const registry = readRegistry();
+	delete registry[name];
+	writeRegistry(registry);
+}
+function getProcess(name) {
+	return readRegistry()[name];
+}
+function isProcessRunning(pid) {
+	try {
+		process.kill(pid, 0);
+		return true;
+	} catch {
+		return false;
+	}
+}
+function getLogPaths(name) {
+	return {
+		stdout: join(getLogsDir(), `${name}.stdout.log`),
+		stderr: join(getLogsDir(), `${name}.stderr.log`)
+	};
+}
+
+//#endregion
+//#region src/commands/start.ts
+const startCommand = defineCommand({
+	meta: {
+		name: "start",
+		description: "Start a background process\n\nUsage: bgproc start -n <name> [-t <seconds>] -- <command...>"
+	},
+	args: {
+		name: {
+			type: "string",
+			alias: "n",
+			description: "Name for the process",
+			required: true
+		},
+		timeout: {
+			type: "string",
+			alias: "t",
+			description: "Kill after N seconds"
+		}
+	},
+	run({ args, rawArgs }) {
+		const name = args.name;
+		const timeout = args.timeout ? parseInt(args.timeout, 10) : void 0;
+		const dashDashIdx = rawArgs.indexOf("--");
+		const command = dashDashIdx >= 0 ? rawArgs.slice(dashDashIdx + 1) : [];
+		if (command.length === 0) {
+			console.error("Error: No command specified. Use: bgproc start -n <name> -- <command>");
+			process.exit(1);
+		}
+		ensureDataDir();
+		const logPaths = getLogPaths(name);
+		const cwd = process.cwd();
+		const stdoutFd = openSync(logPaths.stdout, "a");
+		const stderrFd = openSync(logPaths.stderr, "a");
+		const child = spawn(command[0], command.slice(1), {
+			cwd,
+			detached: true,
+			stdio: [
+				"ignore",
+				stdoutFd,
+				stderrFd
+			]
+		});
+		child.unref();
+		const entry = {
+			pid: child.pid,
+			command,
+			cwd,
+			startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			...timeout && {
+				timeout,
+				killAt: new Date(Date.now() + timeout * 1e3).toISOString()
+			}
+		};
+		try {
+			addProcess(name, entry);
+		} catch (err) {
+			try {
+				process.kill(child.pid, "SIGTERM");
+			} catch {}
+			console.error(err.message);
+			process.exit(1);
+		}
+		if (timeout && child.pid) scheduleKill(child.pid, timeout, name);
+		console.log(JSON.stringify({
+			name,
+			pid: child.pid,
+			cwd,
+			command: command.join(" "),
+			...timeout && { killAt: entry.killAt }
+		}));
+	}
+});
+/**
+* Fork a small process to kill after timeout
+* This survives the parent CLI exiting
+*/
+function scheduleKill(pid, seconds, name) {
+	spawn(process.execPath, ["-e", `
+      setTimeout(() => {
+        try {
+          process.kill(${pid}, 0); // check if alive
+          process.kill(${pid}, 'SIGTERM');
+          console.error('bgproc: ${name} killed after ${seconds}s timeout');
+        } catch {}
+        process.exit(0);
+      }, ${seconds * 1e3});
+      `], {
+		detached: true,
+		stdio: "ignore"
+	}).unref();
+}
+
+//#endregion
+//#region src/ports.ts
+/**
+* Detect listening ports for a given PID using lsof
+*/
+function detectPorts(pid) {
+	try {
+		const output = execSync(`lsof -p ${pid} -P -n 2>/dev/null | grep LISTEN`, { encoding: "utf-8" });
+		const ports = [];
+		for (const line of output.split("\n")) {
+			const match = line.match(/:(\d+)\s+\(LISTEN\)/);
+			if (match) ports.push(parseInt(match[1], 10));
+		}
+		return [...new Set(ports)];
+	} catch {
+		return [];
+	}
+}
+/**
+* Try to detect port from log output (for when lsof doesn't show it yet)
+*/
+function detectPortFromLogs(logPath) {
+	if (!existsSync(logPath)) return null;
+	try {
+		const lines = readFileSync(logPath, "utf-8").split("\n").slice(-50);
+		const patterns = [
+			/localhost:(\d+)/i,
+			/127\.0\.0\.1:(\d+)/,
+			/0\.0\.0\.0:(\d+)/,
+			/port\s+(\d+)/i,
+			/listening\s+(?:on\s+)?(?:port\s+)?:?(\d+)/i,
+			/:\/\/[^:]+:(\d+)/
+		];
+		for (const line of lines.reverse()) for (const pattern of patterns) {
+			const match = line.match(pattern);
+			if (match) {
+				const port = parseInt(match[1], 10);
+				if (port > 0 && port < 65536) return port;
+			}
+		}
+	} catch {}
+	return null;
+}
+
+//#endregion
+//#region src/commands/status.ts
+const statusCommand = defineCommand({
+	meta: {
+		name: "status",
+		description: "Get status of a background process, including pid and open ports"
+	},
+	args: { name: {
+		type: "string",
+		alias: "n",
+		description: "Process name"
+	} },
+	run({ args, rawArgs }) {
+		const name = args.name ?? rawArgs[0];
+		if (!name) {
+			console.error("Error: Process name required");
+			process.exit(1);
+		}
+		const entry = getProcess(name);
+		if (!entry) {
+			console.error(`Process '${name}' not found`);
+			process.exit(1);
+		}
+		const running = isProcessRunning(entry.pid);
+		const logPaths = getLogPaths(name);
+		let ports = [];
+		if (running) {
+			ports = detectPorts(entry.pid);
+			if (ports.length === 0) {
+				const logPort = detectPortFromLogs(logPaths.stdout);
+				if (logPort) ports = [logPort];
+			}
+		}
+		const uptime = running ? formatUptime(new Date(entry.startedAt)) : null;
+		console.log(JSON.stringify({
+			name,
+			pid: entry.pid,
+			running,
+			ports,
+			port: ports[0] ?? null,
+			cwd: entry.cwd,
+			command: entry.command.join(" "),
+			startedAt: entry.startedAt,
+			uptime,
+			...entry.killAt && { killAt: entry.killAt }
+		}));
+	}
+});
+function formatUptime(startedAt) {
+	const seconds = Math.floor((Date.now() - startedAt.getTime()) / 1e3);
+	if (seconds < 60) return `${seconds}s`;
+	if (seconds < 3600) return `${Math.floor(seconds / 60)}m${seconds % 60}s`;
+	return `${Math.floor(seconds / 3600)}h${Math.floor(seconds % 3600 / 60)}m`;
+}
+
+//#endregion
+//#region src/logs.ts
+const MAX_LOG_SIZE = 1 * 1024 * 1024;
+const KEEP_SIZE = 512 * 1024;
+/**
+* Read the last N lines from a log file
+*/
+function readLastLines(path, n) {
+	if (!existsSync(path)) return [];
+	try {
+		const lines = readFileSync(path, "utf-8").split("\n");
+		if (lines[lines.length - 1] === "") lines.pop();
+		return lines.slice(-n);
+	} catch {
+		return [];
+	}
+}
+/**
+* Read entire log file
+*/
+function readLog(path) {
+	if (!existsSync(path)) return "";
+	try {
+		return readFileSync(path, "utf-8");
+	} catch {
+		return "";
+	}
+}
+
+//#endregion
+//#region src/commands/logs.ts
+const logsCommand = defineCommand({
+	meta: {
+		name: "logs",
+		description: "View logs for a background process"
+	},
+	args: {
+		name: {
+			type: "string",
+			alias: "n",
+			description: "Process name"
+		},
+		tail: {
+			type: "string",
+			alias: "t",
+			description: "Number of lines to show (default: 100)"
+		},
+		follow: {
+			type: "boolean",
+			alias: "f",
+			description: "Follow log output (tail -f)"
+		},
+		errors: {
+			type: "boolean",
+			alias: "e",
+			description: "Show only stderr"
+		},
+		all: {
+			type: "boolean",
+			alias: "a",
+			description: "Show all logs (no line limit)"
+		}
+	},
+	run({ args, rawArgs }) {
+		const name = args.name ?? rawArgs[0];
+		if (!name) {
+			console.error("Error: Process name required");
+			process.exit(1);
+		}
+		if (!getProcess(name)) {
+			console.error(`Process '${name}' not found`);
+			process.exit(1);
+		}
+		const logPaths = getLogPaths(name);
+		const logPath = args.errors ? logPaths.stderr : logPaths.stdout;
+		if (!existsSync(logPath)) {
+			console.error(`No logs found for '${name}'`);
+			process.exit(1);
+		}
+		if (args.follow) {
+			const tail = spawn("tail", ["-f", logPath], { stdio: "inherit" });
+			process.on("SIGINT", () => {
+				tail.kill();
+				process.exit(0);
+			});
+			return;
+		}
+		if (args.all) {
+			const content = readLog(logPath);
+			process.stdout.write(content);
+			return;
+		}
+		const output = readLastLines(logPath, parseInt(args.tail ?? "100", 10));
+		console.log(output.join("\n"));
+	}
+});
+
+//#endregion
+//#region src/commands/stop.ts
+const stopCommand = defineCommand({
+	meta: {
+		name: "stop",
+		description: "Stop a background process"
+	},
+	args: {
+		name: {
+			type: "string",
+			alias: "n",
+			description: "Process name"
+		},
+		force: {
+			type: "boolean",
+			alias: "f",
+			description: "Force kill (SIGKILL instead of SIGTERM)"
+		}
+	},
+	run({ args, rawArgs }) {
+		const name = args.name ?? rawArgs[0];
+		if (!name) {
+			console.error("Error: Process name required");
+			process.exit(1);
+		}
+		const entry = getProcess(name);
+		if (!entry) {
+			console.error(`Process '${name}' not found`);
+			process.exit(1);
+		}
+		const wasRunning = isProcessRunning(entry.pid);
+		if (!wasRunning) process.stderr.write(`Warning: Process '${name}' (PID ${entry.pid}) was already dead\n`);
+		else {
+			const signal = args.force ? "SIGKILL" : "SIGTERM";
+			try {
+				process.kill(entry.pid, signal);
+			} catch (err) {
+				console.error(`Failed to kill process: ${err.message}`);
+				process.exit(1);
+			}
+		}
+		removeProcess(name);
+		console.log(JSON.stringify({
+			name,
+			pid: entry.pid,
+			stopped: true,
+			wasRunning,
+			signal: wasRunning ? args.force ? "SIGKILL" : "SIGTERM" : null
+		}));
+	}
+});
+
+//#endregion
+//#region src/commands/list.ts
+const listCommand = defineCommand({
+	meta: {
+		name: "list",
+		description: "List all background processes"
+	},
+	args: { cwd: {
+		type: "string",
+		alias: "c",
+		description: "Filter by cwd (no arg = current directory)"
+	} },
+	run({ args }) {
+		const registry = readRegistry();
+		let cwdFilter;
+		if (args.cwd !== void 0) cwdFilter = args.cwd === "" ? process.cwd() : path.resolve(args.cwd);
+		const entries = Object.entries(registry).filter(([_, entry]) => {
+			if (cwdFilter && entry.cwd !== cwdFilter) return false;
+			return true;
+		}).map(([name, entry]) => {
+			const running = isProcessRunning(entry.pid);
+			let ports = [];
+			if (running) {
+				ports = detectPorts(entry.pid);
+				if (ports.length === 0) {
+					const logPort = detectPortFromLogs(getLogPaths(name).stdout);
+					if (logPort) ports = [logPort];
+				}
+			}
+			return {
+				name,
+				pid: entry.pid,
+				running,
+				port: ports[0] ?? null,
+				cwd: entry.cwd,
+				command: entry.command.join(" "),
+				startedAt: entry.startedAt
+			};
+		});
+		console.log(JSON.stringify(entries, null, 2));
+	}
+});
+
+//#endregion
+//#region src/commands/clean.ts
+const cleanCommand = defineCommand({
+	meta: {
+		name: "clean",
+		description: "Remove dead processes and their logs"
+	},
+	args: {
+		name: {
+			type: "string",
+			alias: "n",
+			description: "Process name"
+		},
+		all: {
+			type: "boolean",
+			alias: "a",
+			description: "Clean all dead processes"
+		}
+	},
+	run({ args, rawArgs }) {
+		const registry = readRegistry();
+		const cleaned = [];
+		const name = args.name ?? rawArgs[0];
+		if (args.all) {
+			for (const [procName, entry] of Object.entries(registry)) if (!isProcessRunning(entry.pid)) {
+				cleanProcess(procName);
+				cleaned.push(procName);
+			}
+		} else if (name) {
+			const entry = registry[name];
+			if (!entry) {
+				console.error(`Process '${name}' not found`);
+				process.exit(1);
+			}
+			if (isProcessRunning(entry.pid)) {
+				console.error(`Process '${name}' is still running. Use 'bgproc stop ${name}' first.`);
+				process.exit(1);
+			}
+			cleanProcess(name);
+			cleaned.push(name);
+		} else {
+			console.error("Specify a process name or use --all");
+			process.exit(1);
+		}
+		console.log(JSON.stringify({
+			cleaned,
+			count: cleaned.length
+		}));
+	}
+});
+function cleanProcess(name) {
+	removeProcess(name);
+	const logPaths = getLogPaths(name);
+	try {
+		if (existsSync(logPaths.stdout)) unlinkSync(logPaths.stdout);
+		if (existsSync(logPaths.stderr)) unlinkSync(logPaths.stderr);
+	} catch {}
+}
+
+//#endregion
+//#region src/cli.ts
+await runMain(defineCommand({
+	meta: {
+		name: "bgproc",
+		version: "0.1.0",
+		description: "Simple process manager for agents. All commands output JSON to stdout.\nExample: bgproc start -n myserver -- npm run dev"
+	},
+	subCommands: {
+		start: startCommand,
+		status: statusCommand,
+		logs: logsCommand,
+		stop: stopCommand,
+		list: listCommand,
+		clean: cleanCommand
+	}
+}));
+
+//#endregion
+export {  };
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/registry.ts","../src/commands/start.ts","../src/ports.ts","../src/commands/status.ts","../src/logs.ts","../src/commands/logs.ts","../src/commands/stop.ts","../src/commands/list.ts","../src/commands/clean.ts","../src/cli.ts"],"sourcesContent":["import { readFileSync, writeFileSync, mkdirSync, existsSync, unlinkSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\nexport interface ProcessEntry {\n  pid: number;\n  command: string[];\n  cwd: string;\n  startedAt: string;\n  timeout?: number; // seconds, if set\n  killAt?: string; // ISO timestamp when to kill\n}\n\nexport interface Registry {\n  [name: string]: ProcessEntry;\n}\n\nfunction getDataDir(): string {\n  return (\n    process.env.BGPROC_DATA_DIR || join(homedir(), \".local\", \"share\", \"bgproc\")\n  );\n}\n\nfunction getRegistryPath(): string {\n  return join(getDataDir(), \"registry.json\");\n}\n\nexport function getLogsDir(): string {\n  return join(getDataDir(), \"logs\");\n}\n\nexport function ensureDataDir(): void {\n  mkdirSync(getDataDir(), { recursive: true });\n  mkdirSync(getLogsDir(), { recursive: true });\n}\n\nexport function readRegistry(): Registry {\n  ensureDataDir();\n  const registryPath = getRegistryPath();\n  if (!existsSync(registryPath)) {\n    return {};\n  }\n  try {\n    const content = readFileSync(registryPath, \"utf-8\");\n    return JSON.parse(content);\n  } catch {\n    return {};\n  }\n}\n\nexport function writeRegistry(registry: Registry): void {\n  ensureDataDir();\n  writeFileSync(getRegistryPath(), JSON.stringify(registry, null, 2));\n}\n\nexport function addProcess(name: string, entry: ProcessEntry): void {\n  const registry = readRegistry();\n  const existing = registry[name];\n\n  if (existing) {\n    if (isProcessRunning(existing.pid)) {\n      throw new Error(\n        `Process '${name}' is already running (PID ${existing.pid}). Use 'bgproc stop ${name}' first.`,\n      );\n    }\n    // Dead process - auto-clean old logs before starting fresh\n    const logPaths = getLogPaths(name);\n    try {\n      if (existsSync(logPaths.stdout)) unlinkSync(logPaths.stdout);\n      if (existsSync(logPaths.stderr)) unlinkSync(logPaths.stderr);\n    } catch {\n      // ignore\n    }\n  }\n\n  registry[name] = entry;\n  writeRegistry(registry);\n}\n\nexport function removeProcess(name: string): void {\n  const registry = readRegistry();\n  delete registry[name];\n  writeRegistry(registry);\n}\n\nexport function getProcess(name: string): ProcessEntry | undefined {\n  const registry = readRegistry();\n  return registry[name];\n}\n\nexport function isProcessRunning(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport function getLogPaths(name: string): { stdout: string; stderr: string } {\n  return {\n    stdout: join(getLogsDir(), `${name}.stdout.log`),\n    stderr: join(getLogsDir(), `${name}.stderr.log`),\n  };\n}\n","import { defineCommand } from \"citty\";\nimport { spawn } from \"node:child_process\";\nimport { openSync } from \"node:fs\";\nimport { addProcess, getLogPaths, ensureDataDir } from \"../registry.js\";\n\nexport const startCommand = defineCommand({\n  meta: {\n    name: \"start\",\n    description:\n      \"Start a background process\\n\\nUsage: bgproc start -n <name> [-t <seconds>] -- <command...>\",\n  },\n  args: {\n    name: {\n      type: \"string\",\n      alias: \"n\",\n      description: \"Name for the process\",\n      required: true,\n    },\n    timeout: {\n      type: \"string\",\n      alias: \"t\",\n      description: \"Kill after N seconds\",\n    },\n  },\n  run({ args, rawArgs }) {\n    const name = args.name;\n    const timeout = args.timeout ? parseInt(args.timeout, 10) : undefined;\n\n    // Get command from rawArgs after \"--\"\n    const dashDashIdx = rawArgs.indexOf(\"--\");\n    const command = dashDashIdx >= 0 ? rawArgs.slice(dashDashIdx + 1) : [];\n\n    if (command.length === 0) {\n      console.error(\n        \"Error: No command specified. Use: bgproc start -n <name> -- <command>\",\n      );\n      process.exit(1);\n    }\n\n    ensureDataDir();\n    const logPaths = getLogPaths(name);\n    const cwd = process.cwd();\n\n    // Open log files\n    const stdoutFd = openSync(logPaths.stdout, \"a\");\n    const stderrFd = openSync(logPaths.stderr, \"a\");\n\n    // Spawn detached process\n    const child = spawn(command[0]!, command.slice(1), {\n      cwd,\n      detached: true,\n      stdio: [\"ignore\", stdoutFd, stderrFd],\n    });\n\n    child.unref();\n\n    const entry = {\n      pid: child.pid!,\n      command,\n      cwd,\n      startedAt: new Date().toISOString(),\n      ...(timeout && {\n        timeout,\n        killAt: new Date(Date.now() + timeout * 1000).toISOString(),\n      }),\n    };\n\n    try {\n      addProcess(name, entry);\n    } catch (err) {\n      // Kill the process we just started since we can't register it\n      try {\n        process.kill(child.pid!, \"SIGTERM\");\n      } catch {\n        // ignore\n      }\n      console.error((err as Error).message);\n      process.exit(1);\n    }\n\n    // If timeout specified, schedule kill\n    if (timeout && child.pid) {\n      scheduleKill(child.pid, timeout, name);\n    }\n\n    console.log(\n      JSON.stringify({\n        name,\n        pid: child.pid,\n        cwd,\n        command: command.join(\" \"),\n        ...(timeout && { killAt: entry.killAt }),\n      }),\n    );\n  },\n});\n\n/**\n * Fork a small process to kill after timeout\n * This survives the parent CLI exiting\n */\nfunction scheduleKill(pid: number, seconds: number, name: string): void {\n  const killer = spawn(\n    process.execPath,\n    [\n      \"-e\",\n      `\n      setTimeout(() => {\n        try {\n          process.kill(${pid}, 0); // check if alive\n          process.kill(${pid}, 'SIGTERM');\n          console.error('bgproc: ${name} killed after ${seconds}s timeout');\n        } catch {}\n        process.exit(0);\n      }, ${seconds * 1000});\n      `,\n    ],\n    {\n      detached: true,\n      stdio: \"ignore\",\n    },\n  );\n  killer.unref();\n}\n","import { execSync } from \"node:child_process\";\nimport { readFileSync, existsSync } from \"node:fs\";\n\n/**\n * Detect listening ports for a given PID using lsof\n */\nexport function detectPorts(pid: number): number[] {\n  try {\n    // Just filter by PID and look for LISTEN in the output\n    // -P = show port numbers, -n = no DNS resolution\n    const output = execSync(`lsof -p ${pid} -P -n 2>/dev/null | grep LISTEN`, {\n      encoding: \"utf-8\",\n    });\n    const ports: number[] = [];\n    for (const line of output.split(\"\\n\")) {\n      // Format: COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME\n      // NAME is like *:3000 or 127.0.0.1:3000 or [::1]:3000\n      const match = line.match(/:(\\d+)\\s+\\(LISTEN\\)/);\n      if (match) {\n        ports.push(parseInt(match[1], 10));\n      }\n    }\n    return [...new Set(ports)]; // dedupe\n  } catch {\n    return [];\n  }\n}\n\n/**\n * Try to detect port from log output (for when lsof doesn't show it yet)\n */\nexport function detectPortFromLogs(logPath: string): number | null {\n  if (!existsSync(logPath)) return null;\n\n  try {\n    const content = readFileSync(logPath, \"utf-8\");\n    // Check last 50 lines for port announcements\n    const lines = content.split(\"\\n\").slice(-50);\n\n    const patterns = [\n      /localhost:(\\d+)/i,\n      /127\\.0\\.0\\.1:(\\d+)/,\n      /0\\.0\\.0\\.0:(\\d+)/,\n      /port\\s+(\\d+)/i,\n      /listening\\s+(?:on\\s+)?(?:port\\s+)?:?(\\d+)/i,\n      /:\\/\\/[^:]+:(\\d+)/,\n    ];\n\n    for (const line of lines.reverse()) {\n      for (const pattern of patterns) {\n        const match = line.match(pattern);\n        if (match) {\n          const port = parseInt(match[1], 10);\n          if (port > 0 && port < 65536) {\n            return port;\n          }\n        }\n      }\n    }\n  } catch {\n    // ignore\n  }\n\n  return null;\n}\n","import { defineCommand } from \"citty\";\nimport { getProcess, isProcessRunning, getLogPaths } from \"../registry.js\";\nimport { detectPorts, detectPortFromLogs } from \"../ports.js\";\n\nexport const statusCommand = defineCommand({\n  meta: {\n    name: \"status\",\n    description: \"Get status of a background process, including pid and open ports\",\n  },\n  args: {\n    name: {\n      type: \"string\",\n      alias: \"n\",\n      description: \"Process name\",\n    },\n  },\n  run({ args, rawArgs }) {\n    const name = args.name ?? rawArgs[0];\n    if (!name) {\n      console.error(\"Error: Process name required\");\n      process.exit(1);\n    }\n    const entry = getProcess(name);\n\n    if (!entry) {\n      console.error(`Process '${name}' not found`);\n      process.exit(1);\n    }\n\n    const running = isProcessRunning(entry.pid);\n    const logPaths = getLogPaths(name);\n\n    let ports: number[] = [];\n    if (running) {\n      ports = detectPorts(entry.pid);\n      // Fallback to log parsing if lsof didn't find anything\n      if (ports.length === 0) {\n        const logPort = detectPortFromLogs(logPaths.stdout);\n        if (logPort) ports = [logPort];\n      }\n    }\n\n    const uptime = running ? formatUptime(new Date(entry.startedAt)) : null;\n\n    console.log(\n      JSON.stringify({\n        name,\n        pid: entry.pid,\n        running,\n        ports,\n        port: ports[0] ?? null, // convenience: first port\n        cwd: entry.cwd,\n        command: entry.command.join(\" \"),\n        startedAt: entry.startedAt,\n        uptime,\n        ...(entry.killAt && { killAt: entry.killAt }),\n      }),\n    );\n  },\n});\n\nfunction formatUptime(startedAt: Date): string {\n  const seconds = Math.floor((Date.now() - startedAt.getTime()) / 1000);\n  if (seconds < 60) return `${seconds}s`;\n  if (seconds < 3600) return `${Math.floor(seconds / 60)}m${seconds % 60}s`;\n  const hours = Math.floor(seconds / 3600);\n  const mins = Math.floor((seconds % 3600) / 60);\n  return `${hours}h${mins}m`;\n}\n","import { createWriteStream, statSync, readFileSync, writeFileSync, existsSync } from \"node:fs\";\nimport type { WriteStream } from \"node:fs\";\n\nconst MAX_LOG_SIZE = 1 * 1024 * 1024; // 1MB\nconst KEEP_SIZE = 512 * 1024; // Keep last 512KB when truncating\n\n/**\n * Create a write stream that caps file size at 1MB\n */\nexport function createCappedWriteStream(path: string): WriteStream {\n  const stream = createWriteStream(path, { flags: \"a\" });\n\n  // Check and truncate periodically\n  let bytesWritten = 0;\n  const originalWrite = stream.write.bind(stream);\n\n  stream.write = function (chunk: any, ...args: any[]): boolean {\n    bytesWritten += Buffer.byteLength(chunk);\n\n    // Every ~100KB written, check total size\n    if (bytesWritten > 100 * 1024) {\n      bytesWritten = 0;\n      try {\n        const stats = statSync(path);\n        if (stats.size > MAX_LOG_SIZE) {\n          // Truncate asynchronously - next writes will be to truncated file\n          truncateLogFile(path);\n        }\n      } catch {\n        // ignore\n      }\n    }\n\n    return originalWrite(chunk, ...args);\n  } as typeof stream.write;\n\n  return stream;\n}\n\n/**\n * Truncate log file to keep only the last KEEP_SIZE bytes\n */\nfunction truncateLogFile(path: string): void {\n  try {\n    const content = readFileSync(path);\n    if (content.length > MAX_LOG_SIZE) {\n      const kept = content.slice(-KEEP_SIZE);\n      // Find first newline to avoid cutting mid-line\n      const newlineIdx = kept.indexOf(10); // \\n\n      const trimmed = newlineIdx > 0 ? kept.slice(newlineIdx + 1) : kept;\n      writeFileSync(path, trimmed);\n    }\n  } catch {\n    // ignore\n  }\n}\n\n/**\n * Read the last N lines from a log file\n */\nexport function readLastLines(path: string, n: number): string[] {\n  if (!existsSync(path)) return [];\n\n  try {\n    const content = readFileSync(path, \"utf-8\");\n    const lines = content.split(\"\\n\");\n    // Remove trailing empty line if present\n    if (lines[lines.length - 1] === \"\") {\n      lines.pop();\n    }\n    return lines.slice(-n);\n  } catch {\n    return [];\n  }\n}\n\n/**\n * Read entire log file\n */\nexport function readLog(path: string): string {\n  if (!existsSync(path)) return \"\";\n  try {\n    return readFileSync(path, \"utf-8\");\n  } catch {\n    return \"\";\n  }\n}\n","import { defineCommand } from \"citty\";\nimport { spawn } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { getProcess, getLogPaths } from \"../registry.js\";\nimport { readLastLines, readLog } from \"../logs.js\";\n\nexport const logsCommand = defineCommand({\n  meta: {\n    name: \"logs\",\n    description: \"View logs for a background process\",\n  },\n  args: {\n    name: {\n      type: \"string\",\n      alias: \"n\",\n      description: \"Process name\",\n    },\n    tail: {\n      type: \"string\",\n      alias: \"t\",\n      description: \"Number of lines to show (default: 100)\",\n    },\n    follow: {\n      type: \"boolean\",\n      alias: \"f\",\n      description: \"Follow log output (tail -f)\",\n    },\n    errors: {\n      type: \"boolean\",\n      alias: \"e\",\n      description: \"Show only stderr\",\n    },\n    all: {\n      type: \"boolean\",\n      alias: \"a\",\n      description: \"Show all logs (no line limit)\",\n    },\n  },\n  run({ args, rawArgs }) {\n    const name = args.name ?? rawArgs[0];\n    if (!name) {\n      console.error(\"Error: Process name required\");\n      process.exit(1);\n    }\n    const entry = getProcess(name);\n\n    if (!entry) {\n      console.error(`Process '${name}' not found`);\n      process.exit(1);\n    }\n\n    const logPaths = getLogPaths(name);\n    const logPath = args.errors ? logPaths.stderr : logPaths.stdout;\n\n    if (!existsSync(logPath)) {\n      console.error(`No logs found for '${name}'`);\n      process.exit(1);\n    }\n\n    if (args.follow) {\n      // Use tail -f for follow mode\n      const tail = spawn(\"tail\", [\"-f\", logPath], {\n        stdio: \"inherit\",\n      });\n\n      process.on(\"SIGINT\", () => {\n        tail.kill();\n        process.exit(0);\n      });\n\n      return;\n    }\n\n    if (args.all) {\n      const content = readLog(logPath);\n      process.stdout.write(content);\n      return;\n    }\n\n    const lines = parseInt(args.tail ?? \"100\", 10);\n    const output = readLastLines(logPath, lines);\n    console.log(output.join(\"\\n\"));\n  },\n});\n","import { defineCommand } from \"citty\";\nimport { getProcess, removeProcess, isProcessRunning } from \"../registry.js\";\n\nexport const stopCommand = defineCommand({\n  meta: {\n    name: \"stop\",\n    description: \"Stop a background process\",\n  },\n  args: {\n    name: {\n      type: \"string\",\n      alias: \"n\",\n      description: \"Process name\",\n    },\n    force: {\n      type: \"boolean\",\n      alias: \"f\",\n      description: \"Force kill (SIGKILL instead of SIGTERM)\",\n    },\n  },\n  run({ args, rawArgs }) {\n    const name = args.name ?? rawArgs[0];\n    if (!name) {\n      console.error(\"Error: Process name required\");\n      process.exit(1);\n    }\n    const entry = getProcess(name);\n\n    if (!entry) {\n      console.error(`Process '${name}' not found`);\n      process.exit(1);\n    }\n\n    const wasRunning = isProcessRunning(entry.pid);\n\n    if (!wasRunning) {\n      process.stderr.write(\n        `Warning: Process '${name}' (PID ${entry.pid}) was already dead\\n`,\n      );\n    } else {\n      const signal = args.force ? \"SIGKILL\" : \"SIGTERM\";\n      try {\n        process.kill(entry.pid, signal);\n      } catch (err) {\n        console.error(`Failed to kill process: ${(err as Error).message}`);\n        process.exit(1);\n      }\n    }\n\n    removeProcess(name);\n\n    console.log(\n      JSON.stringify({\n        name,\n        pid: entry.pid,\n        stopped: true,\n        wasRunning,\n        signal: wasRunning ? (args.force ? \"SIGKILL\" : \"SIGTERM\") : null,\n      }),\n    );\n  },\n});\n","import path from \"node:path\";\nimport { defineCommand } from \"citty\";\nimport { readRegistry, isProcessRunning, getLogPaths } from \"../registry.js\";\nimport { detectPorts, detectPortFromLogs } from \"../ports.js\";\n\nexport const listCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description: \"List all background processes\",\n  },\n  args: {\n    cwd: {\n      type: \"string\",\n      alias: \"c\",\n      description: \"Filter by cwd (no arg = current directory)\",\n    },\n  },\n  run({ args }) {\n    const registry = readRegistry();\n\n    // Handle --cwd with no value: use current directory\n    // citty will set it to \"\" if flag present with no value\n    let cwdFilter: string | undefined;\n    if (args.cwd !== undefined) {\n      cwdFilter = args.cwd === \"\" ? process.cwd() : path.resolve(args.cwd);\n    }\n\n    const entries = Object.entries(registry)\n      .filter(([_, entry]) => {\n        if (cwdFilter && entry.cwd !== cwdFilter) {\n          return false;\n        }\n        return true;\n      })\n      .map(([name, entry]) => {\n        const running = isProcessRunning(entry.pid);\n        let ports: number[] = [];\n\n        if (running) {\n          ports = detectPorts(entry.pid);\n          if (ports.length === 0) {\n            const logPaths = getLogPaths(name);\n            const logPort = detectPortFromLogs(logPaths.stdout);\n            if (logPort) ports = [logPort];\n          }\n        }\n\n        return {\n          name,\n          pid: entry.pid,\n          running,\n          port: ports[0] ?? null,\n          cwd: entry.cwd,\n          command: entry.command.join(\" \"),\n          startedAt: entry.startedAt,\n        };\n      });\n\n    console.log(JSON.stringify(entries, null, 2));\n  },\n});\n","import { defineCommand } from \"citty\";\nimport { unlinkSync, existsSync } from \"node:fs\";\nimport {\n  readRegistry,\n  removeProcess,\n  isProcessRunning,\n  getLogPaths,\n} from \"../registry.js\";\n\nexport const cleanCommand = defineCommand({\n  meta: {\n    name: \"clean\",\n    description: \"Remove dead processes and their logs\",\n  },\n  args: {\n    name: {\n      type: \"string\",\n      alias: \"n\",\n      description: \"Process name\",\n    },\n    all: {\n      type: \"boolean\",\n      alias: \"a\",\n      description: \"Clean all dead processes\",\n    },\n  },\n  run({ args, rawArgs }) {\n    const registry = readRegistry();\n    const cleaned: string[] = [];\n    const name = args.name ?? rawArgs[0];\n\n    if (args.all) {\n      // Clean all dead processes\n      for (const [procName, entry] of Object.entries(registry)) {\n        if (!isProcessRunning(entry.pid)) {\n          cleanProcess(procName);\n          cleaned.push(procName);\n        }\n      }\n    } else if (name) {\n      const entry = registry[name];\n\n      if (!entry) {\n        console.error(`Process '${name}' not found`);\n        process.exit(1);\n      }\n\n      if (isProcessRunning(entry.pid)) {\n        console.error(\n          `Process '${name}' is still running. Use 'bgproc stop ${name}' first.`,\n        );\n        process.exit(1);\n      }\n\n      cleanProcess(name);\n      cleaned.push(name);\n    } else {\n      console.error(\"Specify a process name or use --all\");\n      process.exit(1);\n    }\n\n    console.log(\n      JSON.stringify({\n        cleaned,\n        count: cleaned.length,\n      }),\n    );\n  },\n});\n\nfunction cleanProcess(name: string): void {\n  removeProcess(name);\n\n  const logPaths = getLogPaths(name);\n  try {\n    if (existsSync(logPaths.stdout)) unlinkSync(logPaths.stdout);\n    if (existsSync(logPaths.stderr)) unlinkSync(logPaths.stderr);\n  } catch {\n    // ignore\n  }\n}\n","import { defineCommand, runMain } from \"citty\";\nimport { startCommand } from \"./commands/start.js\";\nimport { statusCommand } from \"./commands/status.js\";\nimport { logsCommand } from \"./commands/logs.js\";\nimport { stopCommand } from \"./commands/stop.js\";\nimport { listCommand } from \"./commands/list.js\";\nimport { cleanCommand } from \"./commands/clean.js\";\n\nconst main = defineCommand({\n  meta: {\n    name: \"bgproc\",\n    version: \"0.1.0\",\n    description: \"Simple process manager for agents. All commands output JSON to stdout.\\nExample: bgproc start -n myserver -- npm run dev\",\n  },\n  subCommands: {\n    start: startCommand,\n    status: statusCommand,\n    logs: logsCommand,\n    stop: stopCommand,\n    list: listCommand,\n    clean: cleanCommand,\n  },\n});\n\nawait runMain(main);\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "bgproc",
+  "version": "0.0.0",
+  "description": "Simple process manager for agents",
+  "keywords": [
+    "background",
+    "cli",
+    "dev-server",
+    "process"
+  ],
+  "license": "MIT",
+  "author": "Matt Kane",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ascorbic/bgproc.git"
+  },
+  "homepage": "https://github.com/ascorbic/bgproc#readme",
+  "bugs": {
+    "url": "https://github.com/ascorbic/bgproc/issues"
+  },
+  "bin": {
+    "bgproc": "dist/cli.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "format": "oxfmt",
+    "lint": "oxlint",
+    "lint:fix": "oxlint --fix",
+    "start": "node dist/cli.mjs",
+    "test": "vitest",
+    "changeset": "changeset",
+    "release": "changeset publish"
+  },
+  "dependencies": {
+    "citty": "^0.1.6"
+  },
+  "devDependencies": {
+    "@changesets/changelog-github": "^0.5.2",
+    "@changesets/cli": "^2.29.8",
+    "@types/node": "^22.0.0",
+    "oxfmt": "^0.27.0",
+    "oxlint": "^1.0.0",
+    "oxlint-tsgolint": "^0.11.3",
+    "tsdown": "^0.20.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
+}