Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
import { spawn } from './childProcess.js';
import { withSpawnCwdEnv } from './spawnCwd.js';
export const DEFAULT_CLI_TIMEOUT_MS = 15_000;
/**
* Run a CLI, resolving `{ code, stdout, stderr }` — never rejects and never
* hangs. A spawn error or a child still running after `timeoutMs` resolves
* `code: -1` (the timed-out child is killed); stderr accumulated before the
* fault is preserved, falling back to the error message / `timed out`.
* `options` pass through to spawn; PWD is pinned to `options.cwd` (#3193).
*/
export function runCliBounded(cmd, args, { timeoutMs = DEFAULT_CLI_TIMEOUT_MS, ...options } = {}) {
return new Promise((resolve) => {
let stdout = '', stderr = '', settled = false, timer;
const done = (result) => {
if (settled) return;
settled = true;
clearTimeout(timer);
resolve(result);
};
const child = spawn(cmd, args, {
shell: false,
...options,
env: withSpawnCwdEnv(options.env ?? process.env, options.cwd),
});
child.stdout?.on('data', d => { stdout += d.toString(); });
child.stderr?.on('data', d => { stderr += d.toString(); });
child.on('error', err => done({ code: -1, stdout, stderr: stderr || err.message }));
child.on('close', code => done({ code, stdout, stderr }));
timer = setTimeout(() => {
try { child.kill(); } catch { /* already gone */ }
done({ code: -1, stdout, stderr: stderr || 'timed out' });
}, timeoutMs);
timer.unref?.();
});
}