Function start

src/ops/lifecycle.js:573–615

(options)

// --- Lifecycle ---

function start(options) {
    var delayMs = (options && options.delayMs) || 0;
    var pids = getRunningPids();
    var ownedPids = getOwnedLoopPids(pids);
    if (ownedPids.length > 0) {
        if (shouldRestartForProxy(ownedPids, process.env)) {
            console.log('[Lifecycle] Loop running but proxy is unhealthy; restarting.');
            stopPids(ownedPids, { unlinkPidFile: true, unlinkLock: true });
            ownedPids = getOwnedLoopPids(getRunningPids());
        }
    }
    if (ownedPids.length > 0) {
        console.log('[Lifecycle] Already running (PIDs: ' + ownedPids.join(', ') + ').');
        return { status: 'already_running', pids: ownedPids };
    }
    if (delayMs > 0) {
        sleepMs(delayMs);
    }

    var script = getLoopScript();
    console.log('[Lifecycle] Starting: node ' + path.relative(WORKSPACE_ROOT, script) + ' --loop');

    var out = fs.openSync(LOG_FILE, 'a');
    var err = fs.openSync(LOG_FILE, 'a');

    var env = prepareStartEnv(process.env);
    // .npm-global/bin is a Unix-only convention; skip the PATH injection on Windows
    // to avoid polluting the environment with a path that does not exist.
    if (process.platform !== 'win32') {
        var npmGlobal = path.join(os.homedir(), '.npm-global', 'bin');
        if (env.PATH && !env.PATH.includes(npmGlobal)) {
            env.PATH = npmGlobal + ':' + env.PATH;
        }
    }

    var child = spawn(process.execPath, [script, '--loop'], {
        detached: true, stdio: ['ignore', out, err], cwd: WORKSPACE_ROOT, env: env, windowsHide: true
    });
    child.unref();
    fs.writeFileSync(PID_FILE, String(child.pid));
    console.log('[Lifecycle] Started PID ' + child.pid);
    return { status: 'started', pid: child.pid };
}

function stop() {
    var pids = getRunningPids();