bgproc 0.0.0 → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +38 -0
- package/dist/cli.mjs +38 -8
- package/dist/cli.mjs.map +1 -1
- package/package.json +13 -13
package/README.md
CHANGED
|
@@ -8,6 +8,8 @@ Manage background processes like dev servers from the command line. Designed to
|
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
10
|
npm install -g bgproc
|
|
11
|
+
# or using npx
|
|
12
|
+
npx bgproc start -n myserver -- npm run dev
|
|
11
13
|
```
|
|
12
14
|
|
|
13
15
|
## Usage
|
|
@@ -99,6 +101,42 @@ bgproc status -n myserver # equivalent
|
|
|
99
101
|
|
|
100
102
|
- `BGPROC_DATA_DIR`: Override data directory (default: `~/.local/share/bgproc`)
|
|
101
103
|
|
|
104
|
+
## Usage with AI Agents
|
|
105
|
+
|
|
106
|
+
### Just ask the agent
|
|
107
|
+
|
|
108
|
+
The simplest approach - just tell your agent to use it:
|
|
109
|
+
|
|
110
|
+
```
|
|
111
|
+
Use bgproc to start and manage the dev server. Run bgproc --help to see available commands.
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
### AI Coding Assistants
|
|
115
|
+
|
|
116
|
+
Add the skill to your AI coding assistant for richer context:
|
|
117
|
+
|
|
118
|
+
```bash
|
|
119
|
+
npx skills add ascorbic/bgproc
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
This works with Claude Code, Cursor, Codex, and other AI coding tools.
|
|
123
|
+
|
|
124
|
+
### AGENTS.md / CLAUDE.md
|
|
125
|
+
|
|
126
|
+
For more consistent results, add to your project instructions:
|
|
127
|
+
|
|
128
|
+
```markdown
|
|
129
|
+
## Background Processes
|
|
130
|
+
|
|
131
|
+
Use `bgproc` to manage dev servers and background processes. All commands output JSON.
|
|
132
|
+
|
|
133
|
+
Workflow:
|
|
134
|
+
1. `bgproc start -n devserver -- npm run dev` - Start a process
|
|
135
|
+
2. `bgproc status devserver` - Check if running, get port
|
|
136
|
+
3. `bgproc logs devserver` - View output if something's wrong
|
|
137
|
+
4. `bgproc stop devserver` - Stop when done
|
|
138
|
+
```
|
|
139
|
+
|
|
102
140
|
## Platform Support
|
|
103
141
|
|
|
104
142
|
macOS and Linux only. Windows is not supported.
|
package/dist/cli.mjs
CHANGED
|
@@ -6,6 +6,14 @@ import { homedir } from "node:os";
|
|
|
6
6
|
import path, { join } from "node:path";
|
|
7
7
|
|
|
8
8
|
//#region src/registry.ts
|
|
9
|
+
/**
|
|
10
|
+
* Validate process name to prevent path traversal and code injection
|
|
11
|
+
*/
|
|
12
|
+
function validateName(name) {
|
|
13
|
+
if (!name) throw new Error("Process name required");
|
|
14
|
+
if (!/^[a-zA-Z0-9_-]+$/.test(name)) throw new Error("Process name must contain only alphanumeric characters, hyphens, and underscores");
|
|
15
|
+
if (name.length > 64) throw new Error("Process name must be 64 characters or less");
|
|
16
|
+
}
|
|
9
17
|
function getDataDir() {
|
|
10
18
|
return process.env.BGPROC_DATA_DIR || join(homedir(), ".local", "share", "bgproc");
|
|
11
19
|
}
|
|
@@ -93,6 +101,12 @@ const startCommand = defineCommand({
|
|
|
93
101
|
},
|
|
94
102
|
run({ args, rawArgs }) {
|
|
95
103
|
const name = args.name;
|
|
104
|
+
try {
|
|
105
|
+
validateName(name);
|
|
106
|
+
} catch (err) {
|
|
107
|
+
console.error(`Error: ${err.message}`);
|
|
108
|
+
process.exit(1);
|
|
109
|
+
}
|
|
96
110
|
const timeout = args.timeout ? parseInt(args.timeout, 10) : void 0;
|
|
97
111
|
const dashDashIdx = rawArgs.indexOf("--");
|
|
98
112
|
const command = dashDashIdx >= 0 ? rawArgs.slice(dashDashIdx + 1) : [];
|
|
@@ -154,13 +168,17 @@ function scheduleKill(pid, seconds, name) {
|
|
|
154
168
|
try {
|
|
155
169
|
process.kill(${pid}, 0); // check if alive
|
|
156
170
|
process.kill(${pid}, 'SIGTERM');
|
|
157
|
-
console.error('bgproc:
|
|
171
|
+
console.error('bgproc: ' + process.env.BGPROC_NAME + ' killed after ${seconds}s timeout');
|
|
158
172
|
} catch {}
|
|
159
173
|
process.exit(0);
|
|
160
174
|
}, ${seconds * 1e3});
|
|
161
175
|
`], {
|
|
162
176
|
detached: true,
|
|
163
|
-
stdio: "ignore"
|
|
177
|
+
stdio: "ignore",
|
|
178
|
+
env: {
|
|
179
|
+
...process.env,
|
|
180
|
+
BGPROC_NAME: name
|
|
181
|
+
}
|
|
164
182
|
}).unref();
|
|
165
183
|
}
|
|
166
184
|
|
|
@@ -222,8 +240,10 @@ const statusCommand = defineCommand({
|
|
|
222
240
|
} },
|
|
223
241
|
run({ args, rawArgs }) {
|
|
224
242
|
const name = args.name ?? rawArgs[0];
|
|
225
|
-
|
|
226
|
-
|
|
243
|
+
try {
|
|
244
|
+
validateName(name);
|
|
245
|
+
} catch (err) {
|
|
246
|
+
console.error(`Error: ${err.message}`);
|
|
227
247
|
process.exit(1);
|
|
228
248
|
}
|
|
229
249
|
const entry = getProcess(name);
|
|
@@ -328,8 +348,10 @@ const logsCommand = defineCommand({
|
|
|
328
348
|
},
|
|
329
349
|
run({ args, rawArgs }) {
|
|
330
350
|
const name = args.name ?? rawArgs[0];
|
|
331
|
-
|
|
332
|
-
|
|
351
|
+
try {
|
|
352
|
+
validateName(name);
|
|
353
|
+
} catch (err) {
|
|
354
|
+
console.error(`Error: ${err.message}`);
|
|
333
355
|
process.exit(1);
|
|
334
356
|
}
|
|
335
357
|
if (!getProcess(name)) {
|
|
@@ -381,8 +403,10 @@ const stopCommand = defineCommand({
|
|
|
381
403
|
},
|
|
382
404
|
run({ args, rawArgs }) {
|
|
383
405
|
const name = args.name ?? rawArgs[0];
|
|
384
|
-
|
|
385
|
-
|
|
406
|
+
try {
|
|
407
|
+
validateName(name);
|
|
408
|
+
} catch (err) {
|
|
409
|
+
console.error(`Error: ${err.message}`);
|
|
386
410
|
process.exit(1);
|
|
387
411
|
}
|
|
388
412
|
const entry = getProcess(name);
|
|
@@ -484,6 +508,12 @@ const cleanCommand = defineCommand({
|
|
|
484
508
|
cleaned.push(procName);
|
|
485
509
|
}
|
|
486
510
|
} else if (name) {
|
|
511
|
+
try {
|
|
512
|
+
validateName(name);
|
|
513
|
+
} catch (err) {
|
|
514
|
+
console.error(`Error: ${err.message}`);
|
|
515
|
+
process.exit(1);
|
|
516
|
+
}
|
|
487
517
|
const entry = registry[name];
|
|
488
518
|
if (!entry) {
|
|
489
519
|
console.error(`Process '${name}' not found`);
|
package/dist/cli.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
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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"}
|
|
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\n/**\n * Validate process name to prevent path traversal and code injection\n */\nexport function validateName(name: string): void {\n if (!name) {\n throw new Error(\"Process name required\");\n }\n if (!/^[a-zA-Z0-9_-]+$/.test(name)) {\n throw new Error(\n \"Process name must contain only alphanumeric characters, hyphens, and underscores\",\n );\n }\n if (name.length > 64) {\n throw new Error(\"Process name must be 64 characters or less\");\n }\n}\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, validateName } 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\n try {\n validateName(name);\n } catch (err) {\n console.error(`Error: ${(err as Error).message}`);\n process.exit(1);\n }\n\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: ' + process.env.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 env: { ...process.env, BGPROC_NAME: name },\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, validateName } 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\n try {\n validateName(name);\n } catch (err) {\n console.error(`Error: ${(err as Error).message}`);\n process.exit(1);\n }\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, validateName } 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\n try {\n validateName(name);\n } catch (err) {\n console.error(`Error: ${(err as Error).message}`);\n process.exit(1);\n }\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, validateName } 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\n try {\n validateName(name);\n } catch (err) {\n console.error(`Error: ${(err as Error).message}`);\n process.exit(1);\n }\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 validateName,\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 try {\n validateName(name);\n } catch (err) {\n console.error(`Error: ${(err as Error).message}`);\n process.exit(1);\n }\n\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
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "bgproc",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.1.0",
|
|
4
4
|
"description": "Simple process manager for agents",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"background",
|
|
@@ -25,17 +25,6 @@
|
|
|
25
25
|
"dist"
|
|
26
26
|
],
|
|
27
27
|
"type": "module",
|
|
28
|
-
"scripts": {
|
|
29
|
-
"build": "tsdown",
|
|
30
|
-
"dev": "tsdown --watch",
|
|
31
|
-
"format": "oxfmt",
|
|
32
|
-
"lint": "oxlint",
|
|
33
|
-
"lint:fix": "oxlint --fix",
|
|
34
|
-
"start": "node dist/cli.mjs",
|
|
35
|
-
"test": "vitest",
|
|
36
|
-
"changeset": "changeset",
|
|
37
|
-
"release": "changeset publish"
|
|
38
|
-
},
|
|
39
28
|
"dependencies": {
|
|
40
29
|
"citty": "^0.1.6"
|
|
41
30
|
},
|
|
@@ -49,5 +38,16 @@
|
|
|
49
38
|
"tsdown": "^0.20.1",
|
|
50
39
|
"typescript": "^5.9.3",
|
|
51
40
|
"vitest": "^4.0.18"
|
|
41
|
+
},
|
|
42
|
+
"scripts": {
|
|
43
|
+
"build": "tsdown",
|
|
44
|
+
"dev": "tsdown --watch",
|
|
45
|
+
"format": "oxfmt",
|
|
46
|
+
"lint": "oxlint",
|
|
47
|
+
"lint:fix": "oxlint --fix",
|
|
48
|
+
"start": "node dist/cli.mjs",
|
|
49
|
+
"test": "vitest",
|
|
50
|
+
"changeset": "changeset",
|
|
51
|
+
"release": "changeset publish"
|
|
52
52
|
}
|
|
53
|
-
}
|
|
53
|
+
}
|