@agimon-ai/po-runner 0.0.0-alpha.0

package/dist/bin/runnerHost.cjs

@@ -0,0 +1,131 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("../rolldown-runtime-VH7oDXx4.cjs");
+const require_services_lifeline_client = require("../services/lifeline/client.cjs");
+let node_fs = require("node:fs");
+node_fs = require_rolldown_runtime.__toESM(node_fs, 1);
+let node_url = require("node:url");
+let node_child_process = require("node:child_process");
+let node_os = require("node:os");
+node_os = require_rolldown_runtime.__toESM(node_os, 1);
+let _agimon_ai_po_telemetry = require("@agimon-ai/po-telemetry");
+//#region src/bin/runnerHost.ts
+const POLL_MS = 10;
+const FORWARDED_SIGNAL_GRACE_MS = 2e3;
+const HOST_FAILED_EVENT = "doom_runner.host_failed";
+const INVALID_COMMAND_SPEC_ERROR = "invalid runner command spec";
+async function main(argv = process.argv.slice(2)) {
+	const startedAt = Date.now();
+	const telemetry = (0, _agimon_ai_po_telemetry.createDoomTelemetry)({
+		serviceName: "doom-runner-host",
+		packageName: "@agimon-ai/po-runner",
+		env: process.env,
+		enableLogs: true,
+		enableTraces: true
+	});
+	const [specPath, gatePath, exitPath] = argv;
+	let spec;
+	try {
+		if (!specPath || !gatePath || !exitPath) throw new Error("runnerHost requires spec, gate, and exit paths");
+		spec = readSpec(specPath);
+		await waitForGate(gatePath);
+	} catch (error) {
+		await telemetry.recordError(HOST_FAILED_EVENT, error, { duration_ms: Date.now() - startedAt });
+		await telemetry.shutdown();
+		throw error;
+	}
+	let child;
+	let forwardedSignal = null;
+	let escalationTimer;
+	let ownerLost = false;
+	const signalChild = (signal) => {
+		if (!child?.pid) return;
+		try {
+			process.kill(-child.pid, signal);
+		} catch {
+			child.kill(signal);
+		}
+	};
+	const forward = (signal) => {
+		forwardedSignal = signal;
+		signalChild(signal);
+		escalationTimer ??= setTimeout(() => signalChild("SIGKILL"), FORWARDED_SIGNAL_GRACE_MS);
+	};
+	for (const signal of [
+		"SIGTERM",
+		"SIGINT",
+		"SIGHUP"
+	]) process.once(signal, () => forward(signal));
+	child = (0, node_child_process.spawn)(spec.command, {
+		cwd: spec.cwd,
+		env: spec.env,
+		shell: "/bin/bash",
+		stdio: "inherit",
+		detached: true
+	});
+	if (forwardedSignal) forward(forwardedSignal);
+	const detachLifeline = require_services_lifeline_client.watchOwner(() => {
+		ownerLost = true;
+		forward("SIGTERM");
+	}, spec.env[require_services_lifeline_client.LIFELINE_ENV]);
+	try {
+		const result = await new Promise((resolve, reject) => {
+			child?.once("error", reject);
+			child?.once("exit", (code, signal) => resolve({
+				code,
+				signal: signal ?? forwardedSignal
+			}));
+		});
+		writeAtomic(exitPath, {
+			...result,
+			...ownerLost ? {
+				reason: "stopped",
+				terminationReason: "owner_lost",
+				stopReason: "owner session ended"
+			} : {}
+		});
+		const exitCode = result.code !== null ? result.code : result.signal ? 128 + node_os.default.constants.signals[result.signal] : 1;
+		await telemetry.recordEvent("doom_runner.host_finished", {
+			outcome: result.signal || forwardedSignal ? "signaled" : exitCode === 0 ? "completed" : "failed",
+			"runner.exit_code": exitCode,
+			...result.signal || forwardedSignal ? { "runner.signal": result.signal ?? forwardedSignal ?? "" } : {},
+			duration_ms: Date.now() - startedAt
+		});
+		return exitCode;
+	} catch (error) {
+		await telemetry.recordError(HOST_FAILED_EVENT, error, { duration_ms: Date.now() - startedAt });
+		throw error;
+	} finally {
+		detachLifeline();
+		if (escalationTimer) clearTimeout(escalationTimer);
+		await telemetry.shutdown();
+	}
+}
+function readSpec(target) {
+	const value = JSON.parse(node_fs.default.readFileSync(target, "utf8"));
+	if (typeof value !== "object" || value === null) throw new Error(INVALID_COMMAND_SPEC_ERROR);
+	const spec = value;
+	if (typeof spec.command !== "string" || typeof spec.cwd !== "string" || !spec.env) throw new Error(INVALID_COMMAND_SPEC_ERROR);
+	return {
+		command: spec.command,
+		cwd: spec.cwd,
+		env: spec.env
+	};
+}
+async function waitForGate(target) {
+	while (!node_fs.default.existsSync(target)) await new Promise((resolve) => setTimeout(resolve, POLL_MS));
+}
+function writeAtomic(target, value) {
+	const temporary = `${target}.${process.pid}.tmp`;
+	node_fs.default.writeFileSync(temporary, `${JSON.stringify(value)}\n`, { mode: 384 });
+	node_fs.default.renameSync(temporary, target);
+}
+if (process.argv[1] && require("url").pathToFileURL(__filename).href === (0, node_url.pathToFileURL)(process.argv[1]).href) main().then((code) => {
+	process.exitCode = code;
+}, (error) => {
+	process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+	process.exitCode = 1;
+});
+//#endregion
+exports.main = main;
+
+//# sourceMappingURL=runnerHost.cjs.map

package/dist/bin/runnerHost.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnerHost.cjs","names":["createDoomTelemetry","spawn","watchOwner","LIFELINE_ENV","os","fs","pathToFileURL"],"sources":["../../src/bin/runnerHost.ts"],"sourcesContent":["import { type ChildProcess, spawn } from 'node:child_process';\nimport fs from 'node:fs';\nimport os from 'node:os';\nimport { pathToFileURL } from 'node:url';\n\nimport { createDoomTelemetry } from '@agimon-ai/po-telemetry';\n\nimport { LIFELINE_ENV, watchOwner } from '../services/lifeline/client';\n\ninterface CommandSpec {\n  command: string;\n  cwd: string;\n  env: Record<string, string>;\n}\n\nconst POLL_MS = 10;\nconst FORWARDED_SIGNAL_GRACE_MS = 2_000;\nconst HOST_FAILED_EVENT = 'doom_runner.host_failed';\nconst INVALID_COMMAND_SPEC_ERROR = 'invalid runner command spec';\n\nexport async function main(argv: readonly string[] = process.argv.slice(2)): Promise<number> {\n  const startedAt = Date.now();\n  const telemetry = createDoomTelemetry({\n    serviceName: 'doom-runner-host',\n    packageName: '@agimon-ai/po-runner',\n    env: process.env,\n    enableLogs: true,\n    enableTraces: true,\n  });\n  const [specPath, gatePath, exitPath] = argv;\n  let spec: CommandSpec;\n  try {\n    if (!specPath || !gatePath || !exitPath) throw new Error('runnerHost requires spec, gate, and exit paths');\n    spec = readSpec(specPath);\n    await waitForGate(gatePath);\n  } catch (error) {\n    await telemetry.recordError(HOST_FAILED_EVENT, error, { duration_ms: Date.now() - startedAt });\n    await telemetry.shutdown();\n    throw error;\n  }\n  let child: ChildProcess | undefined;\n  let forwardedSignal: NodeJS.Signals | null = null;\n  let escalationTimer: NodeJS.Timeout | undefined;\n  let ownerLost = false;\n  const signalChild = (signal: NodeJS.Signals): void => {\n    if (!child?.pid) return;\n    try {\n      process.kill(-child.pid, signal);\n    } catch {\n      child.kill(signal);\n    }\n  };\n  const forward = (signal: NodeJS.Signals): void => {\n    forwardedSignal = signal;\n    signalChild(signal);\n    escalationTimer ??= setTimeout(() => signalChild('SIGKILL'), FORWARDED_SIGNAL_GRACE_MS);\n  };\n  const signals: NodeJS.Signals[] = ['SIGTERM', 'SIGINT', 'SIGHUP'];\n  for (const signal of signals) process.once(signal, () => forward(signal));\n\n  child = spawn(spec.command, {\n    cwd: spec.cwd,\n    env: spec.env,\n    shell: '/bin/bash',\n    stdio: 'inherit',\n    detached: true,\n  });\n  if (forwardedSignal) forward(forwardedSignal);\n\n  // This process supervises the command for its whole life, so it is also the\n  // right place to notice an owner that died without stopping it.\n  //\n  // The lifeline comes from the spec rather than this process's environment: an\n  // rmux server outlives the session that started it, so its own environment can\n  // still name a previous session's socket.\n  const detachLifeline = watchOwner(() => {\n    ownerLost = true;\n    forward('SIGTERM');\n  }, spec.env[LIFELINE_ENV]);\n\n  try {\n    const result = await new Promise<{ code: number | null; signal: NodeJS.Signals | null }>((resolve, reject) => {\n      child?.once('error', reject);\n      child?.once('exit', (code, signal) => resolve({ code, signal: signal ?? forwardedSignal }));\n    });\n    writeAtomic(exitPath, {\n      ...result,\n      ...(ownerLost ? { reason: 'stopped', terminationReason: 'owner_lost', stopReason: 'owner session ended' } : {}),\n    });\n    const exitCode = result.code !== null ? result.code : result.signal ? 128 + os.constants.signals[result.signal] : 1;\n    await telemetry.recordEvent('doom_runner.host_finished', {\n      outcome: result.signal || forwardedSignal ? 'signaled' : exitCode === 0 ? 'completed' : 'failed',\n      'runner.exit_code': exitCode,\n      ...(result.signal || forwardedSignal ? { 'runner.signal': result.signal ?? forwardedSignal ?? '' } : {}),\n      duration_ms: Date.now() - startedAt,\n    });\n    return exitCode;\n  } catch (error) {\n    await telemetry.recordError(HOST_FAILED_EVENT, error, { duration_ms: Date.now() - startedAt });\n    throw error;\n  } finally {\n    detachLifeline();\n    if (escalationTimer) clearTimeout(escalationTimer);\n    await telemetry.shutdown();\n  }\n}\n\nfunction readSpec(target: string): CommandSpec {\n  const value: unknown = JSON.parse(fs.readFileSync(target, 'utf8'));\n  if (typeof value !== 'object' || value === null) throw new Error(INVALID_COMMAND_SPEC_ERROR);\n  const spec = value as Partial<CommandSpec>;\n  if (typeof spec.command !== 'string' || typeof spec.cwd !== 'string' || !spec.env) {\n    throw new Error(INVALID_COMMAND_SPEC_ERROR);\n  }\n  return { command: spec.command, cwd: spec.cwd, env: spec.env };\n}\n\nasync function waitForGate(target: string): Promise<void> {\n  while (!fs.existsSync(target)) await new Promise((resolve) => setTimeout(resolve, POLL_MS));\n}\n\nfunction writeAtomic(target: string, value: unknown): void {\n  const temporary = `${target}.${process.pid}.tmp`;\n  fs.writeFileSync(temporary, `${JSON.stringify(value)}\\n`, { mode: 0o600 });\n  fs.renameSync(temporary, target);\n}\n\nif (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {\n  main().then(\n    (code) => {\n      process.exitCode = code;\n    },\n    (error: unknown) => {\n      process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`);\n      process.exitCode = 1;\n    },\n  );\n}\n"],"mappings":"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"}

package/dist/bin/runnerHost.d.mts

@@ -0,0 +1,4 @@
+//#region src/bin/runnerHost.d.ts
+export declare function main(argv?: readonly string[]): Promise<number>;
+//#endregion
+//# sourceMappingURL=runnerHost.d.mts.map

package/dist/bin/runnerHost.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnerHost.d.mts","names":[],"sources":["../../src/bin/runnerHost.ts"],"mappings":";wBAoBsB,KAAK,2BAAkD"}

package/dist/bin/runnerHost.mjs

@@ -0,0 +1,127 @@
+import { LIFELINE_ENV, watchOwner } from "../services/lifeline/client.mjs";
+import fs from "node:fs";
+import { pathToFileURL } from "node:url";
+import { spawn } from "node:child_process";
+import os from "node:os";
+import { createDoomTelemetry } from "@agimon-ai/po-telemetry";
+//#region src/bin/runnerHost.ts
+const POLL_MS = 10;
+const FORWARDED_SIGNAL_GRACE_MS = 2e3;
+const HOST_FAILED_EVENT = "doom_runner.host_failed";
+const INVALID_COMMAND_SPEC_ERROR = "invalid runner command spec";
+async function main(argv = process.argv.slice(2)) {
+	const startedAt = Date.now();
+	const telemetry = createDoomTelemetry({
+		serviceName: "doom-runner-host",
+		packageName: "@agimon-ai/po-runner",
+		env: process.env,
+		enableLogs: true,
+		enableTraces: true
+	});
+	const [specPath, gatePath, exitPath] = argv;
+	let spec;
+	try {
+		if (!specPath || !gatePath || !exitPath) throw new Error("runnerHost requires spec, gate, and exit paths");
+		spec = readSpec(specPath);
+		await waitForGate(gatePath);
+	} catch (error) {
+		await telemetry.recordError(HOST_FAILED_EVENT, error, { duration_ms: Date.now() - startedAt });
+		await telemetry.shutdown();
+		throw error;
+	}
+	let child;
+	let forwardedSignal = null;
+	let escalationTimer;
+	let ownerLost = false;
+	const signalChild = (signal) => {
+		if (!child?.pid) return;
+		try {
+			process.kill(-child.pid, signal);
+		} catch {
+			child.kill(signal);
+		}
+	};
+	const forward = (signal) => {
+		forwardedSignal = signal;
+		signalChild(signal);
+		escalationTimer ??= setTimeout(() => signalChild("SIGKILL"), FORWARDED_SIGNAL_GRACE_MS);
+	};
+	for (const signal of [
+		"SIGTERM",
+		"SIGINT",
+		"SIGHUP"
+	]) process.once(signal, () => forward(signal));
+	child = spawn(spec.command, {
+		cwd: spec.cwd,
+		env: spec.env,
+		shell: "/bin/bash",
+		stdio: "inherit",
+		detached: true
+	});
+	if (forwardedSignal) forward(forwardedSignal);
+	const detachLifeline = watchOwner(() => {
+		ownerLost = true;
+		forward("SIGTERM");
+	}, spec.env[LIFELINE_ENV]);
+	try {
+		const result = await new Promise((resolve, reject) => {
+			child?.once("error", reject);
+			child?.once("exit", (code, signal) => resolve({
+				code,
+				signal: signal ?? forwardedSignal
+			}));
+		});
+		writeAtomic(exitPath, {
+			...result,
+			...ownerLost ? {
+				reason: "stopped",
+				terminationReason: "owner_lost",
+				stopReason: "owner session ended"
+			} : {}
+		});
+		const exitCode = result.code !== null ? result.code : result.signal ? 128 + os.constants.signals[result.signal] : 1;
+		await telemetry.recordEvent("doom_runner.host_finished", {
+			outcome: result.signal || forwardedSignal ? "signaled" : exitCode === 0 ? "completed" : "failed",
+			"runner.exit_code": exitCode,
+			...result.signal || forwardedSignal ? { "runner.signal": result.signal ?? forwardedSignal ?? "" } : {},
+			duration_ms: Date.now() - startedAt
+		});
+		return exitCode;
+	} catch (error) {
+		await telemetry.recordError(HOST_FAILED_EVENT, error, { duration_ms: Date.now() - startedAt });
+		throw error;
+	} finally {
+		detachLifeline();
+		if (escalationTimer) clearTimeout(escalationTimer);
+		await telemetry.shutdown();
+	}
+}
+function readSpec(target) {
+	const value = JSON.parse(fs.readFileSync(target, "utf8"));
+	if (typeof value !== "object" || value === null) throw new Error(INVALID_COMMAND_SPEC_ERROR);
+	const spec = value;
+	if (typeof spec.command !== "string" || typeof spec.cwd !== "string" || !spec.env) throw new Error(INVALID_COMMAND_SPEC_ERROR);
+	return {
+		command: spec.command,
+		cwd: spec.cwd,
+		env: spec.env
+	};
+}
+async function waitForGate(target) {
+	while (!fs.existsSync(target)) await new Promise((resolve) => setTimeout(resolve, POLL_MS));
+}
+function writeAtomic(target, value) {
+	const temporary = `${target}.${process.pid}.tmp`;
+	fs.writeFileSync(temporary, `${JSON.stringify(value)}\n`, { mode: 384 });
+	fs.renameSync(temporary, target);
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) main().then((code) => {
+	process.exitCode = code;
+}, (error) => {
+	process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+	process.exitCode = 1;
+});
+//#endregion
+export { main };
+
+//# sourceMappingURL=runnerHost.mjs.map

package/dist/bin/runnerHost.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnerHost.mjs","names":[],"sources":["../../src/bin/runnerHost.ts"],"sourcesContent":["import { type ChildProcess, spawn } from 'node:child_process';\nimport fs from 'node:fs';\nimport os from 'node:os';\nimport { pathToFileURL } from 'node:url';\n\nimport { createDoomTelemetry } from '@agimon-ai/po-telemetry';\n\nimport { LIFELINE_ENV, watchOwner } from '../services/lifeline/client';\n\ninterface CommandSpec {\n  command: string;\n  cwd: string;\n  env: Record<string, string>;\n}\n\nconst POLL_MS = 10;\nconst FORWARDED_SIGNAL_GRACE_MS = 2_000;\nconst HOST_FAILED_EVENT = 'doom_runner.host_failed';\nconst INVALID_COMMAND_SPEC_ERROR = 'invalid runner command spec';\n\nexport async function main(argv: readonly string[] = process.argv.slice(2)): Promise<number> {\n  const startedAt = Date.now();\n  const telemetry = createDoomTelemetry({\n    serviceName: 'doom-runner-host',\n    packageName: '@agimon-ai/po-runner',\n    env: process.env,\n    enableLogs: true,\n    enableTraces: true,\n  });\n  const [specPath, gatePath, exitPath] = argv;\n  let spec: CommandSpec;\n  try {\n    if (!specPath || !gatePath || !exitPath) throw new Error('runnerHost requires spec, gate, and exit paths');\n    spec = readSpec(specPath);\n    await waitForGate(gatePath);\n  } catch (error) {\n    await telemetry.recordError(HOST_FAILED_EVENT, error, { duration_ms: Date.now() - startedAt });\n    await telemetry.shutdown();\n    throw error;\n  }\n  let child: ChildProcess | undefined;\n  let forwardedSignal: NodeJS.Signals | null = null;\n  let escalationTimer: NodeJS.Timeout | undefined;\n  let ownerLost = false;\n  const signalChild = (signal: NodeJS.Signals): void => {\n    if (!child?.pid) return;\n    try {\n      process.kill(-child.pid, signal);\n    } catch {\n      child.kill(signal);\n    }\n  };\n  const forward = (signal: NodeJS.Signals): void => {\n    forwardedSignal = signal;\n    signalChild(signal);\n    escalationTimer ??= setTimeout(() => signalChild('SIGKILL'), FORWARDED_SIGNAL_GRACE_MS);\n  };\n  const signals: NodeJS.Signals[] = ['SIGTERM', 'SIGINT', 'SIGHUP'];\n  for (const signal of signals) process.once(signal, () => forward(signal));\n\n  child = spawn(spec.command, {\n    cwd: spec.cwd,\n    env: spec.env,\n    shell: '/bin/bash',\n    stdio: 'inherit',\n    detached: true,\n  });\n  if (forwardedSignal) forward(forwardedSignal);\n\n  // This process supervises the command for its whole life, so it is also the\n  // right place to notice an owner that died without stopping it.\n  //\n  // The lifeline comes from the spec rather than this process's environment: an\n  // rmux server outlives the session that started it, so its own environment can\n  // still name a previous session's socket.\n  const detachLifeline = watchOwner(() => {\n    ownerLost = true;\n    forward('SIGTERM');\n  }, spec.env[LIFELINE_ENV]);\n\n  try {\n    const result = await new Promise<{ code: number | null; signal: NodeJS.Signals | null }>((resolve, reject) => {\n      child?.once('error', reject);\n      child?.once('exit', (code, signal) => resolve({ code, signal: signal ?? forwardedSignal }));\n    });\n    writeAtomic(exitPath, {\n      ...result,\n      ...(ownerLost ? { reason: 'stopped', terminationReason: 'owner_lost', stopReason: 'owner session ended' } : {}),\n    });\n    const exitCode = result.code !== null ? result.code : result.signal ? 128 + os.constants.signals[result.signal] : 1;\n    await telemetry.recordEvent('doom_runner.host_finished', {\n      outcome: result.signal || forwardedSignal ? 'signaled' : exitCode === 0 ? 'completed' : 'failed',\n      'runner.exit_code': exitCode,\n      ...(result.signal || forwardedSignal ? { 'runner.signal': result.signal ?? forwardedSignal ?? '' } : {}),\n      duration_ms: Date.now() - startedAt,\n    });\n    return exitCode;\n  } catch (error) {\n    await telemetry.recordError(HOST_FAILED_EVENT, error, { duration_ms: Date.now() - startedAt });\n    throw error;\n  } finally {\n    detachLifeline();\n    if (escalationTimer) clearTimeout(escalationTimer);\n    await telemetry.shutdown();\n  }\n}\n\nfunction readSpec(target: string): CommandSpec {\n  const value: unknown = JSON.parse(fs.readFileSync(target, 'utf8'));\n  if (typeof value !== 'object' || value === null) throw new Error(INVALID_COMMAND_SPEC_ERROR);\n  const spec = value as Partial<CommandSpec>;\n  if (typeof spec.command !== 'string' || typeof spec.cwd !== 'string' || !spec.env) {\n    throw new Error(INVALID_COMMAND_SPEC_ERROR);\n  }\n  return { command: spec.command, cwd: spec.cwd, env: spec.env };\n}\n\nasync function waitForGate(target: string): Promise<void> {\n  while (!fs.existsSync(target)) await new Promise((resolve) => setTimeout(resolve, POLL_MS));\n}\n\nfunction writeAtomic(target: string, value: unknown): void {\n  const temporary = `${target}.${process.pid}.tmp`;\n  fs.writeFileSync(temporary, `${JSON.stringify(value)}\\n`, { mode: 0o600 });\n  fs.renameSync(temporary, target);\n}\n\nif (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {\n  main().then(\n    (code) => {\n      process.exitCode = code;\n    },\n    (error: unknown) => {\n      process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`);\n      process.exitCode = 1;\n    },\n  );\n}\n"],"mappings":"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"}

package/dist/cliApp-Dj9nwaOv.cjs

@@ -0,0 +1,244 @@
+const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.cjs");
+const require_bashResult = require("./bashResult-DNgtahGR.cjs");
+const require_session = require("./session-BC43uEyG.cjs");
+let node_fs = require("node:fs");
+node_fs = require_rolldown_runtime.__toESM(node_fs, 1);
+const STOPPED_REASON = "stopped";
+const TERMINATION_SIGNAL = "SIGTERM";
+//#endregion
+//#region src/services/cliApp/index.ts
+const MULTIPLEXER_BACKENDS = /* @__PURE__ */ new Set(["rmux", "tmux"]);
+async function runCli(argv, dependencies) {
+	const [command, ...args] = argv;
+	if (command !== void 0 && command !== "--help" && command !== "-h" && !require_session.inheritedSessionId(dependencies.env)) {
+		dependencies.stderr("PI_SESSION_ID is required for doom-runner commands");
+		return 1;
+	}
+	switch (command) {
+		case "list": return list(args, dependencies);
+		case "status": return status(args, dependencies);
+		case "logs": return logs(args, dependencies);
+		case "stop": return stop(args, dependencies);
+		case "stop-all": return stopAll(args, dependencies);
+		case "input": return input(args, dependencies);
+		case "--help":
+		case "-h":
+		case void 0:
+			dependencies.stdout(help());
+			return 0;
+		default:
+			dependencies.stderr(`Unknown command: ${command}\n\n${help()}`);
+			return 1;
+	}
+}
+async function list(args, dependencies) {
+	const sessionId = require_session.requiredSessionId(dependencies.env);
+	const records = args.includes("--all") ? await dependencies.registry.listAll(sessionId) : await dependencies.registry.listBySession(sessionId);
+	dependencies.stdout(records.length > 0 ? records.map(formatRecord).join("\n") : "No runners");
+	return 0;
+}
+async function status(args, dependencies) {
+	const record = await requiredRecord(args[0], dependencies);
+	if (!record) return 1;
+	dependencies.stdout([
+		`ID: ${record.id}`,
+		`Name: ${record.name}`,
+		`State: ${record.state}`,
+		`Backend: ${record.backend}`,
+		...record.backendTarget ? [`Backend target: ${record.backendTarget}`] : [],
+		`PID: ${record.pid}`,
+		`Command: ${record.command}`,
+		`CWD: ${record.cwd}`,
+		`Session: ${record.sessionId}`,
+		`Log: ${record.logPath}`,
+		...record.exit ? [`Exit: ${formatExit(record)}`] : []
+	].join("\n"));
+	return 0;
+}
+async function logs(args, dependencies) {
+	const record = await requiredRecord(args[0], dependencies);
+	if (!record) return 1;
+	const lines = positiveInteger(option(args, "--lines")) ?? 200;
+	const result = dependencies.logReader.read(record.logPath, { lines });
+	if (!result.exists) {
+		dependencies.stderr(`Runner ${record.id} has not written a log yet`);
+		return 1;
+	}
+	if (result.text) dependencies.stdout(result.text);
+	if (!args.includes("--follow")) return 0;
+	return follow(record, result.fileSize, dependencies);
+}
+async function stop(args, dependencies) {
+	const record = await requiredRecord(args[0], dependencies);
+	if (!record) return 1;
+	if (record.state !== "running") {
+		dependencies.stderr(`Runner ${record.id} is already ${record.state}`);
+		return 1;
+	}
+	const reason = option(args, "--reason");
+	if (!await stopRecord(record, dependencies, reason)) {
+		dependencies.stderr(`Could not stop runner ${record.id}`);
+		return 1;
+	}
+	await dependencies.registry.complete(record.id, {
+		reason: STOPPED_REASON,
+		code: null,
+		signal: TERMINATION_SIGNAL,
+		...reason ? { stopReason: reason } : {}
+	}, record.sessionId);
+	dependencies.stdout(`Stopped ${record.id}\nLog: ${record.logPath}`);
+	return 0;
+}
+async function stopAll(args, dependencies) {
+	const sessionId = require_session.requiredSessionId(dependencies.env);
+	const records = await dependencies.registry.listBySession(sessionId);
+	const reason = option(args, "--reason");
+	const stopped = [];
+	for (const record of records) {
+		if (!await stopRecord(record, dependencies, reason)) continue;
+		await dependencies.registry.complete(record.id, {
+			reason: STOPPED_REASON,
+			code: null,
+			signal: TERMINATION_SIGNAL,
+			...reason ? { stopReason: reason } : {}
+		}, record.sessionId);
+		stopped.push(record);
+	}
+	dependencies.stdout(records.length === 0 ? `No active runners for session ${sessionId}` : `Stopped ${stopped.length} runner(s) for session ${sessionId}: ${stopped.map((record) => record.id).join(", ")}`);
+	if (stopped.length !== records.length) {
+		dependencies.stderr(`Could not stop ${records.length - stopped.length} runner(s) for session ${sessionId}`);
+		return 1;
+	}
+	return 0;
+}
+async function input(args, dependencies) {
+	const record = await requiredRecord(args[0], dependencies);
+	if (!record) return 1;
+	if (record.state === "completed") {
+		dependencies.stderr(`Runner ${record.id} is already completed; use doom-runner logs ${record.id}`);
+		return 1;
+	}
+	if (!record.interactive) {
+		dependencies.stderr(`Runner ${record.id} was not started with interactive: true`);
+		return 1;
+	}
+	const text = option(args, "--text") ?? await dependencies.readStdin();
+	const payload = args.includes("--enter") && !text.endsWith("\n") ? `${text}\n` : text;
+	if (!MULTIPLEXER_BACKENDS.has(record.backend) || !record.backendTarget) {
+		dependencies.stderr(`Runner ${record.id} uses the ${record.backend} backend, which does not expose CLI input`);
+		return 1;
+	}
+	if (!await dependencies.rmuxBackend.input(record.backendTarget, payload)) {
+		dependencies.stderr(`Runner ${record.id} is no longer accepting RMUX input`);
+		return 1;
+	}
+	dependencies.stdout(`Sent input to ${record.id}`);
+	return 0;
+}
+async function requiredRecord(id, dependencies) {
+	if (!id) {
+		dependencies.stderr("A runner ID is required");
+		return;
+	}
+	const sessionId = require_session.requiredSessionId(dependencies.env);
+	const scopedRecord = await dependencies.registry.get(id, sessionId);
+	if (!scopedRecord) {
+		dependencies.stderr(`No runner with id ${id}`);
+		return;
+	}
+	return scopedRecord;
+}
+function formatRecord(record) {
+	const active = require_bashResult.formatRunnerLine(record, Date.now());
+	return `${record.id}  ${record.state}  ${record.backend}  ${active}`;
+}
+function formatExit(record) {
+	const exit = record.exit;
+	if (!exit) return "unknown";
+	const detail = exit.code !== null ? ` code ${exit.code}` : exit.signal ? ` ${exit.signal}` : "";
+	const attribution = exit.terminationReason ? ` [${exit.terminationReason}]` : "";
+	const note = exit.stopReason ? ` (${exit.stopReason})` : "";
+	return `${exit.reason}${detail}${attribution}${note}`;
+}
+function option(args, name) {
+	const index = args.indexOf(name);
+	return index >= 0 ? args[index + 1] : void 0;
+}
+function positiveInteger(value) {
+	if (value === void 0) return void 0;
+	const parsed = Number(value);
+	return Number.isInteger(parsed) && parsed > 0 ? parsed : void 0;
+}
+async function follow(record, initialSize, dependencies) {
+	let offset = initialSize;
+	return new Promise((resolve) => {
+		let stopped = false;
+		let stateTimer;
+		const listener = (current) => {
+			if (current.size < offset) offset = 0;
+			if (current.size === offset) return;
+			const length = current.size - offset;
+			const buffer = Buffer.alloc(length);
+			const descriptor = node_fs.default.openSync(record.logPath, "r");
+			try {
+				const bytesRead = node_fs.default.readSync(descriptor, buffer, 0, length, offset);
+				if (bytesRead > 0) dependencies.stdout(buffer.subarray(0, bytesRead).toString("utf8"));
+			} finally {
+				node_fs.default.closeSync(descriptor);
+			}
+			offset = current.size;
+		};
+		const stopFollowing = () => {
+			if (stopped) return;
+			stopped = true;
+			try {
+				listener(node_fs.default.statSync(record.logPath));
+			} catch (error) {
+				if (error.code !== "ENOENT") dependencies.stderr(`Runner ${record.id} failed to flush its final log output: ${error.message}`);
+			}
+			node_fs.default.unwatchFile(record.logPath, listener);
+			clearInterval(stateTimer);
+			process.off("SIGINT", stopFollowing);
+			resolve(0);
+		};
+		process.once("SIGINT", stopFollowing);
+		node_fs.default.watchFile(record.logPath, { interval: 250 }, listener);
+		stateTimer = setInterval(() => {
+			dependencies.registry.get(record.id).then((current) => {
+				if (current?.state === "completed") stopFollowing();
+			});
+		}, 250);
+	});
+}
+async function stopRecord(record, dependencies, reason) {
+	await dependencies.registry.requestTermination(record.id, {
+		reason: STOPPED_REASON,
+		terminationReason: "user_stop",
+		...reason ? { stopReason: reason } : {}
+	}, record.sessionId);
+	const stopped = MULTIPLEXER_BACKENDS.has(record.backend) && record.backendTarget ? await dependencies.rmuxBackend.stop(record.backendTarget, record.pid) : await dependencies.launcher.stop(record.pid);
+	if (!stopped) await dependencies.registry.requestTermination(record.id, void 0, record.sessionId);
+	return stopped;
+}
+function help() {
+	return [
+		"Usage: doom-runner <command>",
+		"",
+		"Commands:",
+		"  list [--all]",
+		"  status <id>",
+		"  logs <id> [--lines N] [--follow]",
+		"  stop <id> [--reason <text>]",
+		"  stop-all [--reason <text>]",
+		"  input <id> [--text <text>] [--enter]"
+	].join("\n");
+}
+//#endregion
+Object.defineProperty(exports, "runCli", {
+	enumerable: true,
+	get: function() {
+		return runCli;
+	}
+});
+
+//# sourceMappingURL=cliApp-Dj9nwaOv.cjs.map

package/dist/cliApp-Dj9nwaOv.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliApp-Dj9nwaOv.cjs","names":["inheritedSessionId","requiredSessionId","formatRunnerLine","fs"],"sources":["../src/constants/cliApp.ts","../src/services/cliApp/index.ts"],"sourcesContent":["export const DEFAULT_LOG_LINES = 200;\nexport const FOLLOW_INTERVAL_MS = 250;\nexport const COMPLETED_STATE = 'completed';\nexport const STOPPED_REASON = 'stopped';\nexport const TERMINATION_SIGNAL = 'SIGTERM';\n","import fs from 'node:fs';\n\nimport {\n  COMPLETED_STATE,\n  DEFAULT_LOG_LINES,\n  FOLLOW_INTERVAL_MS,\n  STOPPED_REASON,\n  TERMINATION_SIGNAL,\n} from '../../constants/cliApp';\nimport { formatRunnerLine } from '../../services/bashResult';\nimport { inheritedSessionId, requiredSessionId } from '../../services/session';\nimport type { ILauncher } from '../../types/launcher';\nimport type { ILogReader } from '../../types/logReader';\nimport type { IRmuxBackend } from '../../types/rmuxBackend';\nimport type { IRunnerRegistry, RunnerRecord } from '../../types/runnerRegistry';\n\nconst MULTIPLEXER_BACKENDS = new Set(['rmux', 'tmux']);\n\nexport interface CliDependencies {\n  registry: IRunnerRegistry;\n  launcher: ILauncher;\n  rmuxBackend: IRmuxBackend;\n  logReader: ILogReader;\n  env?: NodeJS.ProcessEnv;\n  stdout(text: string): void;\n  stderr(text: string): void;\n  readStdin(): Promise<string>;\n}\n\nexport async function runCli(argv: readonly string[], dependencies: CliDependencies): Promise<number> {\n  const [command, ...args] = argv;\n  if (command !== undefined && command !== '--help' && command !== '-h' && !inheritedSessionId(dependencies.env)) {\n    dependencies.stderr('PI_SESSION_ID is required for doom-runner commands');\n    return 1;\n  }\n  switch (command) {\n    case 'list':\n      return list(args, dependencies);\n    case 'status':\n      return status(args, dependencies);\n    case 'logs':\n      return logs(args, dependencies);\n    case 'stop':\n      return stop(args, dependencies);\n    case 'stop-all':\n      return stopAll(args, dependencies);\n    case 'input':\n      return input(args, dependencies);\n    case '--help':\n    case '-h':\n    case undefined:\n      dependencies.stdout(help());\n      return 0;\n    default:\n      dependencies.stderr(`Unknown command: ${command}\\n\\n${help()}`);\n      return 1;\n  }\n}\n\nasync function list(args: readonly string[], dependencies: CliDependencies): Promise<number> {\n  const sessionId = requiredSessionId(dependencies.env);\n  const records = args.includes('--all')\n    ? await dependencies.registry.listAll(sessionId)\n    : await dependencies.registry.listBySession(sessionId);\n  dependencies.stdout(records.length > 0 ? records.map(formatRecord).join('\\n') : 'No runners');\n  return 0;\n}\n\nasync function status(args: readonly string[], dependencies: CliDependencies): Promise<number> {\n  const record = await requiredRecord(args[0], dependencies);\n  if (!record) return 1;\n  dependencies.stdout(\n    [\n      `ID: ${record.id}`,\n      `Name: ${record.name}`,\n      `State: ${record.state}`,\n      `Backend: ${record.backend}`,\n      ...(record.backendTarget ? [`Backend target: ${record.backendTarget}`] : []),\n      `PID: ${record.pid}`,\n      `Command: ${record.command}`,\n      `CWD: ${record.cwd}`,\n      `Session: ${record.sessionId}`,\n      `Log: ${record.logPath}`,\n      ...(record.exit ? [`Exit: ${formatExit(record)}`] : []),\n    ].join('\\n'),\n  );\n  return 0;\n}\n\nasync function logs(args: readonly string[], dependencies: CliDependencies): Promise<number> {\n  const record = await requiredRecord(args[0], dependencies);\n  if (!record) return 1;\n  const lines = positiveInteger(option(args, '--lines')) ?? DEFAULT_LOG_LINES;\n  const result = dependencies.logReader.read(record.logPath, { lines });\n  if (!result.exists) {\n    dependencies.stderr(`Runner ${record.id} has not written a log yet`);\n    return 1;\n  }\n  if (result.text) dependencies.stdout(result.text);\n  if (!args.includes('--follow')) return 0;\n  return follow(record, result.fileSize, dependencies);\n}\n\nasync function stop(args: readonly string[], dependencies: CliDependencies): Promise<number> {\n  const record = await requiredRecord(args[0], dependencies);\n  if (!record) return 1;\n  if (record.state !== 'running') {\n    dependencies.stderr(`Runner ${record.id} is already ${record.state}`);\n    return 1;\n  }\n  const reason = option(args, '--reason');\n  if (!(await stopRecord(record, dependencies, reason))) {\n    dependencies.stderr(`Could not stop runner ${record.id}`);\n    return 1;\n  }\n  await dependencies.registry.complete(\n    record.id,\n    {\n      reason: STOPPED_REASON,\n      code: null,\n      signal: TERMINATION_SIGNAL,\n      ...(reason ? { stopReason: reason } : {}),\n    },\n    record.sessionId,\n  );\n  dependencies.stdout(`Stopped ${record.id}\\nLog: ${record.logPath}`);\n  return 0;\n}\n\nasync function stopAll(args: readonly string[], dependencies: CliDependencies): Promise<number> {\n  const sessionId = requiredSessionId(dependencies.env);\n  const records = await dependencies.registry.listBySession(sessionId);\n  const reason = option(args, '--reason');\n  const stopped: RunnerRecord[] = [];\n  for (const record of records) {\n    if (!(await stopRecord(record, dependencies, reason))) continue;\n    await dependencies.registry.complete(\n      record.id,\n      {\n        reason: STOPPED_REASON,\n        code: null,\n        signal: TERMINATION_SIGNAL,\n        ...(reason ? { stopReason: reason } : {}),\n      },\n      record.sessionId,\n    );\n    stopped.push(record);\n  }\n  dependencies.stdout(\n    records.length === 0\n      ? `No active runners for session ${sessionId}`\n      : `Stopped ${stopped.length} runner(s) for session ${sessionId}: ${stopped.map((record) => record.id).join(', ')}`,\n  );\n  if (stopped.length !== records.length) {\n    dependencies.stderr(`Could not stop ${records.length - stopped.length} runner(s) for session ${sessionId}`);\n    return 1;\n  }\n  return 0;\n}\n\nasync function input(args: readonly string[], dependencies: CliDependencies): Promise<number> {\n  const record = await requiredRecord(args[0], dependencies);\n  if (!record) return 1;\n  if (record.state === COMPLETED_STATE) {\n    dependencies.stderr(`Runner ${record.id} is already completed; use doom-runner logs ${record.id}`);\n    return 1;\n  }\n  if (!record.interactive) {\n    dependencies.stderr(`Runner ${record.id} was not started with interactive: true`);\n    return 1;\n  }\n  const supplied = option(args, '--text');\n  const text = supplied ?? (await dependencies.readStdin());\n  const payload = args.includes('--enter') && !text.endsWith('\\n') ? `${text}\\n` : text;\n  if (!MULTIPLEXER_BACKENDS.has(record.backend) || !record.backendTarget) {\n    dependencies.stderr(`Runner ${record.id} uses the ${record.backend} backend, which does not expose CLI input`);\n    return 1;\n  }\n  if (!(await dependencies.rmuxBackend.input(record.backendTarget, payload))) {\n    dependencies.stderr(`Runner ${record.id} is no longer accepting RMUX input`);\n    return 1;\n  }\n  dependencies.stdout(`Sent input to ${record.id}`);\n  return 0;\n}\n\nasync function requiredRecord(\n  id: string | undefined,\n  dependencies: CliDependencies,\n): Promise<RunnerRecord | undefined> {\n  if (!id) {\n    dependencies.stderr('A runner ID is required');\n    return undefined;\n  }\n  const sessionId = requiredSessionId(dependencies.env);\n  const scopedRecord = await dependencies.registry.get(id, sessionId);\n  if (!scopedRecord) {\n    dependencies.stderr(`No runner with id ${id}`);\n    return undefined;\n  }\n  return scopedRecord;\n}\n\nfunction formatRecord(record: RunnerRecord): string {\n  const active = formatRunnerLine(record, Date.now());\n  return `${record.id}  ${record.state}  ${record.backend}  ${active}`;\n}\n\nfunction formatExit(record: RunnerRecord): string {\n  const exit = record.exit;\n  if (!exit) return 'unknown';\n  const detail = exit.code !== null ? ` code ${exit.code}` : exit.signal ? ` ${exit.signal}` : '';\n  const attribution = exit.terminationReason ? ` [${exit.terminationReason}]` : '';\n  const note = exit.stopReason ? ` (${exit.stopReason})` : '';\n  return `${exit.reason}${detail}${attribution}${note}`;\n}\n\nfunction option(args: readonly string[], name: string): string | undefined {\n  const index = args.indexOf(name);\n  return index >= 0 ? args[index + 1] : undefined;\n}\n\nfunction positiveInteger(value: string | undefined): number | undefined {\n  if (value === undefined) return undefined;\n  const parsed = Number(value);\n  return Number.isInteger(parsed) && parsed > 0 ? parsed : undefined;\n}\n\nasync function follow(record: RunnerRecord, initialSize: number, dependencies: CliDependencies): Promise<number> {\n  let offset = initialSize;\n  return new Promise<number>((resolve) => {\n    let stopped = false;\n    let stateTimer: NodeJS.Timeout;\n    const listener = (current: fs.Stats): void => {\n      if (current.size < offset) offset = 0;\n      if (current.size === offset) return;\n      const length = current.size - offset;\n      const buffer = Buffer.alloc(length);\n      const descriptor = fs.openSync(record.logPath, 'r');\n      try {\n        const bytesRead = fs.readSync(descriptor, buffer, 0, length, offset);\n        if (bytesRead > 0) dependencies.stdout(buffer.subarray(0, bytesRead).toString('utf8'));\n      } finally {\n        fs.closeSync(descriptor);\n      }\n      offset = current.size;\n    };\n    const stopFollowing = (): void => {\n      if (stopped) return;\n      stopped = true;\n      try {\n        listener(fs.statSync(record.logPath));\n      } catch (error) {\n        // A missing log file was already reported by the initial read.\n        if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {\n          dependencies.stderr(`Runner ${record.id} failed to flush its final log output: ${(error as Error).message}`);\n        }\n      }\n      fs.unwatchFile(record.logPath, listener);\n      clearInterval(stateTimer);\n      process.off('SIGINT', stopFollowing);\n      resolve(0);\n    };\n    process.once('SIGINT', stopFollowing);\n    fs.watchFile(record.logPath, { interval: FOLLOW_INTERVAL_MS }, listener);\n    stateTimer = setInterval(() => {\n      void dependencies.registry.get(record.id).then((current) => {\n        if (current?.state === COMPLETED_STATE) stopFollowing();\n      });\n    }, FOLLOW_INTERVAL_MS);\n  });\n}\n\nasync function stopRecord(record: RunnerRecord, dependencies: CliDependencies, reason?: string): Promise<boolean> {\n  await dependencies.registry.requestTermination(\n    record.id,\n    {\n      reason: STOPPED_REASON,\n      terminationReason: 'user_stop',\n      ...(reason ? { stopReason: reason } : {}),\n    },\n    record.sessionId,\n  );\n  const stopped =\n    MULTIPLEXER_BACKENDS.has(record.backend) && record.backendTarget\n      ? await dependencies.rmuxBackend.stop(record.backendTarget, record.pid)\n      : await dependencies.launcher.stop(record.pid);\n  if (!stopped) await dependencies.registry.requestTermination(record.id, undefined, record.sessionId);\n  return stopped;\n}\n\nfunction help(): string {\n  return [\n    'Usage: doom-runner <command>',\n    '',\n    'Commands:',\n    '  list [--all]',\n    '  status <id>',\n    '  logs <id> [--lines N] [--follow]',\n    '  stop <id> [--reason <text>]',\n    '  stop-all [--reason <text>]',\n    '  input <id> [--text <text>] [--enter]',\n  ].join('\\n');\n}\n"],"mappings":"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"}