Function handleStartCommand

projects/electron/src/modules/code/process.ts:364–420

* Start a command process

(params: StartCommandParams)

 * Start a command process
 */
async function handleStartCommand(params: StartCommandParams): Promise<StartProcessResponse> {
    const startTime = Date.now()
    logger.info("[Process:startCommand] Starting command", JSON.stringify({
        cmd: params.cmd,
        args: params.args,
        cwd: params.cwd,
        hasEnv: !!params.env,
        timeoutMs: params.timeoutMs,
    }))

    try {
        validateCwd(params.cwd)

        // Check process limit
        if (activeProcesses.size >= MAX_ACTIVE_PROCESSES) {
            throw new Error(`Maximum active processes (${MAX_ACTIVE_PROCESSES}) reached`)
        }

        const processId = generateProcessId()
        const timeoutMs = params.timeoutMs ?? DEFAULT_TIMEOUT_MS

        // Spawn the process in a new process group so we can kill the entire tree
        const childProcess = spawn(params.cmd, params.args || [], {
            cwd: params.cwd,
            env: { ...process.env, ...params.env },
            stdio: ["ignore", "pipe", "pipe"],
            detached: true,
        })

        // Store in active processes
        activeProcesses.set(processId, {
            process: childProcess,
            outputBuffer: [],
            bufferSizeBytes: 0,
            exitCode: null,
            signal: null,
            completed: false,
        })

        // Setup handlers
        setupProcessHandlers(processId, childProcess, timeoutMs)
        emitLifecycle({
            type: "started",
            processId,
            pid: childProcess.pid,
            cwd: params.cwd,
            label: [params.cmd, ...(params.args || [])].join(" "),
        })

        logger.info("[Process:startCommand] Command started", JSON.stringify({ processId, pid: childProcess.pid, duration: Date.now() - startTime }))
        return { processId }
    } catch (error: unknown) {
        const errorMessage = error instanceof Error ? error.message : "Unknown error"
        logger.error("[Process:startCommand] Error:", JSON.stringify({ error: errorMessage, duration: Date.now() - startTime }))
        throw error
    }
}