Function stopInstance

scripts/stop-obsidian-e2e-instance.mjs:249–284

(instancePath, options = {})

// running — it then just removes a leftover directory. All side effects are
// injectable so the orchestration is unit-testable without real processes.
export async function stopInstance(instancePath, options = {}) {
	const {
		dryRun = false,
		kill = process.kill.bind(process),
		runPs = defaultRunPs,
		removeDir = (dir) => fs.rm(dir, { recursive: true, force: true }),
		selfPid = process.pid,
		graceMs = TERM_GRACE_MS,
		pollMs = TERM_POLL_MS,
		profileRoot,
	} = options;

	assertSafeInstancePath(instancePath, profileRoot);

	const processes = parsePsOutput(await runPs());
	const pids = collectInstancePids(processes, instancePath, { selfPid });

	if (dryRun) {
		return { instancePath, pids, terminated: [], killed: [], removed: false };
	}

	signalPids(pids, "SIGTERM", kill);

	let survivors = pids;
	const deadline = monotonicNow() + graceMs;
	while (survivors.length > 0 && monotonicNow() < deadline) {
		await sleep(pollMs);
		survivors = survivors.filter((pid) => pidAlive(pid, kill));
	}
	const killed =
		survivors.length > 0 ? signalPids(survivors, "SIGKILL", kill) : [];

	await removeDir(instancePath);

	return { instancePath, pids, terminated: pids, killed, removed: true };
}

// Reads the vault paths an instance registered in its private obsidian.json.
// Returns null when the registration is unreadable (so callers can stay