@lumpcode/core 0.0.14 → 0.0.16

package/dist/index.js

@@ -1,4 +1,4 @@
-import { exec, spawn } from 'node:child_process';
+import { execFile, exec, spawn } from 'node:child_process';
 import { promisify } from 'node:util';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
@@ -3403,6 +3403,152 @@ function parseGitLogHashSubjectLines(stdout) {
     });
 }
 
+/** Node-style `code` from a caught unknown error (e.g. `ENOENT`), or undefined. */
+function nodeErrnoCode(error) {
+    if (error && typeof error === 'object' && 'code' in error) {
+        const code = error.code;
+        return typeof code === 'string' ? code : undefined;
+    }
+    return undefined;
+}
+
+/** Returns whether a process id is still running (signal 0 probe). */
+function isProcessAlive(pid, options) {
+    const onProbeError = options?.onProbeError ?? 'throw';
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        if (nodeErrnoCode(error) === 'ESRCH')
+            return false;
+        if (onProbeError === 'throw')
+            throw error;
+        return onProbeError === 'alive';
+    }
+}
+
+const execFileAsync = promisify(execFile);
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function listUnixProcessTreePids(rootPid) {
+    const { stdout } = await execFileAsync('ps', ['-eo', 'pid=,ppid=']);
+    const childrenByParent = new Map();
+    for (const line of stdout.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        const parts = trimmed.split(/\s+/);
+        if (parts.length < 2)
+            continue;
+        const pid = Number.parseInt(parts[0] ?? '', 10);
+        const ppid = Number.parseInt(parts[1] ?? '', 10);
+        if (Number.isNaN(pid) || Number.isNaN(ppid))
+            continue;
+        const siblings = childrenByParent.get(ppid) ?? [];
+        siblings.push(pid);
+        childrenByParent.set(ppid, siblings);
+    }
+    const ordered = [];
+    const queue = [rootPid];
+    while (queue.length > 0) {
+        const pid = queue.shift();
+        if (pid === undefined)
+            break;
+        ordered.push(pid);
+        const children = childrenByParent.get(pid) ?? [];
+        for (const childPid of children) {
+            queue.push(childPid);
+        }
+    }
+    return ordered;
+}
+function killPid(pid, signal) {
+    try {
+        process.kill(pid, signal);
+    }
+    catch (error) {
+        const code = nodeErrnoCode(error);
+        if (code !== 'ESRCH') {
+            throw error;
+        }
+    }
+}
+async function killUnixProcessTreeImmediate(rootPid) {
+    const pids = await listUnixProcessTreePids(rootPid);
+    for (let index = pids.length - 1; index >= 0; index -= 1) {
+        killPid(pids[index], 'SIGKILL');
+    }
+}
+async function killUnixProcessTreeWithGrace(rootPid, graceMs) {
+    const pids = await listUnixProcessTreePids(rootPid);
+    for (let index = pids.length - 1; index >= 0; index -= 1) {
+        killPid(pids[index], 'SIGTERM');
+    }
+    const deadline = Date.now() + graceMs;
+    while (Date.now() < deadline) {
+        const anyAlive = pids.some((pid) => isProcessAlive(pid, { onProbeError: 'dead' }));
+        if (!anyAlive) {
+            return;
+        }
+        await sleep(25);
+    }
+    const remaining = await listUnixProcessTreePids(rootPid);
+    for (let index = remaining.length - 1; index >= 0; index -= 1) {
+        killPid(remaining[index], 'SIGKILL');
+    }
+}
+async function killWindowsProcessTree(rootPid) {
+    try {
+        await execFileAsync('taskkill', ['/PID', String(rootPid), '/T', '/F'], {
+            windowsHide: true,
+        });
+    }
+    catch (error) {
+        const stderr = error && typeof error === 'object' && 'stderr' in error
+            ? String(error.stderr ?? '')
+            : '';
+        const message = error instanceof Error ? error.message : String(error);
+        const combined = `${message}\n${stderr}`;
+        if (/not found|no running instance|ne existe pas|introuvable/i.test(combined)) {
+            return;
+        }
+        // taskkill can fail to terminate some descendants while the root exits (SEA/agent trees).
+        if (!isProcessAlive(rootPid)) {
+            return;
+        }
+        throw error;
+    }
+}
+/**
+ * Kill a process and its descendants.
+ * `graceMs` default 0 → immediate SIGKILL / taskkill /T /F.
+ * When `graceMs > 0` (Unix), SIGTERM first, then SIGKILL after the grace window.
+ */
+async function killProcessTree(input) {
+    const { pid, graceMs = 0 } = input;
+    if (!Number.isInteger(pid) || pid <= 0) {
+        return failure(`Invalid pid: ${pid}`);
+    }
+    try {
+        if (process.platform === 'win32') {
+            await killWindowsProcessTree(pid);
+        }
+        else if (graceMs > 0) {
+            await killUnixProcessTreeWithGrace(pid, graceMs);
+        }
+        else {
+            await killUnixProcessTreeImmediate(pid);
+        }
+        return success(undefined);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return failure(`Could not kill process tree for pid ${pid}: ${message}`);
+    }
+}
+
 const execAsyncBase = promisify(exec);
 async function execAsync(command, options) {
     const { stdout, stderr, hasErrored } = await execAsyncBase(command, { cwd: options?.cwd })
@@ -3432,38 +3578,86 @@ async function execAsync(command, options) {
     });
 }
 
-function execBinary(binaryPath, args, timeoutMillis = 1000 * 60 * 10, options) {
+function execBinary(input) {
+    const { binaryPath, args, timeoutMillis = 1000 * 60 * 10, cwd, env, stdio, signal, killGraceMs = 5000, } = input;
     return new Promise((resolve) => {
         let settled = false;
+        let canceling = false;
+        let child;
+        let stdout = '';
+        let stderr = '';
+        let timeout;
         const finish = (result) => {
             if (settled)
                 return;
             settled = true;
-            clearTimeout(timeout);
+            if (timeout !== undefined)
+                clearTimeout(timeout);
+            if (signal) {
+                signal.removeEventListener('abort', onAbort);
+            }
             resolve(result);
         };
-        const timeout = setTimeout(() => {
+        const cancelWith = async (reason, message) => {
+            if (settled || canceling)
+                return;
+            canceling = true;
+            const pid = child?.pid;
+            if (pid != null) {
+                await killProcessTree({ pid, graceMs: killGraceMs });
+            }
             finish(failure({
-                message: `Process timed out after ${timeoutMillis} milliseconds`,
+                message,
                 binaryPath,
                 args,
+                stdout,
+                stderr,
+                reason,
             }));
-        }, timeoutMillis);
+        };
+        const onAbort = () => {
+            void cancelWith('aborted', 'Process aborted');
+        };
+        if (signal?.aborted) {
+            void cancelWith('aborted', 'Process aborted');
+            return;
+        }
+        if (signal) {
+            signal.addEventListener('abort', onAbort, { once: true });
+        }
         const { executable: resolvedExecutable, args: resolvedArgs } = resolveSpawnExecutable(binaryPath, args);
-        const child = spawn(resolvedExecutable, resolvedArgs, options || {});
-        let stdout = '', stderr = '';
+        const spawnOptions = {
+            ...(cwd !== undefined ? { cwd } : {}),
+            ...(env !== undefined ? { env } : {}),
+            ...(stdio !== undefined ? { stdio } : {}),
+        };
+        child = spawn(resolvedExecutable, resolvedArgs, spawnOptions);
+        // Start the timeout only after the OS has spawned the process so
+        // timeoutMillis measures command runtime, not spawn/setup overhead.
+        child.on('spawn', () => {
+            if (settled || canceling)
+                return;
+            timeout = setTimeout(() => {
+                void cancelWith('timeout', `Process timed out after ${timeoutMillis} milliseconds`);
+            }, timeoutMillis);
+        });
         child.stdout?.on('data', (data) => { stdout += data; });
         child.stderr?.on('data', (data) => { stderr += data; });
         child.on('error', (err) => {
+            if (settled || canceling)
+                return;
             finish(failure({
                 message: err.message,
                 binaryPath,
                 args,
                 stdout,
                 stderr,
+                reason: 'spawn',
             }));
         });
         child.on('close', (code) => {
+            if (settled || canceling)
+                return;
             if (code === 0) {
                 finish(success({ stdout, stderr }));
                 return;
@@ -3475,6 +3669,7 @@ function execBinary(binaryPath, args, timeoutMillis = 1000 * 60 * 10, options) {
                 code: code ?? undefined,
                 stdout,
                 stderr,
+                reason: 'exit',
             }));
         });
     });
@@ -3550,7 +3745,7 @@ async function collectStepsForContext(params) {
     return collectedSteps;
 }
 
-async function executeStepsForContextList({ baseBranch, branchFn, lumpVariables, contextList, gitAddCommandFn, gitCommitCommandFn, gitPushCommandFn, gitCommitMessageFn, projectRoot, steps, setupFn, setupWorkspaceFn, teardownFn, teardownWorkspaceFn, getKeepHistoryFilePathFn, logger: loggerInput, }) {
+async function executeStepsForContextList({ baseBranch, branchFn, lumpVariables, contextList, gitAddCommandFn, gitCommitCommandFn, gitPushCommandFn, gitCommitMessageFn, projectRoot, steps, setupFn, setupWorkspaceFn, teardownFn, teardownWorkspaceFn, getKeepHistoryFilePathFn, logger: loggerInput, signal, }) {
     const logger = loggerInput ?? createConsoleLogger({});
     const contextNames = contextList.map(context => context.name);
     logger.verbose(`contextNames ${JSON.stringify(contextNames)}`);
@@ -3585,180 +3780,232 @@ async function executeStepsForContextList({ baseBranch, branchFn, lumpVariables,
     const gitStatusCommand = await execAsync(`git status`, { cwd: workspacePath });
     logger.verbose(`gitStatusCommand ${JSON.stringify(gitStatusCommand.data)}`);
     injectedGitAndWorkspaceFnsInput.workspacePath = workspacePath;
-    for (let i = 0; i < contextList.length; i++) {
-        const context = contextList[i];
-        logger.info(contextList.length > 1
-            ? `Running context "${context.name}" (${i + 1}/${contextList.length})`
-            : `Running context "${context.name}"`);
-        const setupResult = await setupFn({
-            contextList,
-            lumpVariables,
-            currentContextIndex: i,
-        });
-        const contextRunState = setupResult?.contextRunState || {};
-        let stepWalkFailure;
-        async function walkAndExecuteSteps(stepsToExec, currStepIndex) {
-            for (let stepIndex = 0; stepIndex < stepsToExec.length; stepIndex++) {
-                if (stepWalkFailure) {
-                    return;
-                }
-                const step = stepsToExec[stepIndex];
-                const nextCallHeadIndex = [...currStepIndex, stepIndex];
-                const compositeStepIndex = nextCallHeadIndex.length === 1 ? nextCallHeadIndex[0] : nextCallHeadIndex;
-                if (typeof step === 'function' || Array.isArray(step)) {
-                    let subSteps = [];
-                    if (typeof step === 'function') {
-                        subSteps = await step({
+    let runFailure;
+    try {
+        for (let i = 0; i < contextList.length; i++) {
+            const context = contextList[i];
+            logger.info(contextList.length > 1
+                ? `Running context "${context.name}" (${i + 1}/${contextList.length})`
+                : `Running context "${context.name}"`);
+            const setupResult = await setupFn({
+                contextList,
+                lumpVariables,
+                currentContextIndex: i,
+            });
+            const contextRunState = setupResult?.contextRunState || {};
+            let stepWalkFailure;
+            async function walkAndExecuteSteps(stepsToExec, currStepIndex) {
+                for (let stepIndex = 0; stepIndex < stepsToExec.length; stepIndex++) {
+                    if (stepWalkFailure) {
+                        return;
+                    }
+                    const step = stepsToExec[stepIndex];
+                    const nextCallHeadIndex = [...currStepIndex, stepIndex];
+                    const compositeStepIndex = nextCallHeadIndex.length === 1 ? nextCallHeadIndex[0] : nextCallHeadIndex;
+                    if (typeof step === 'function' || Array.isArray(step)) {
+                        let subSteps = [];
+                        if (typeof step === 'function') {
+                            subSteps = await step({
+                                context,
+                                stepIndex: compositeStepIndex,
+                                contextRunState,
+                                lumpVariables,
+                            });
+                        }
+                        else {
+                            subSteps = step;
+                        }
+                        await walkAndExecuteSteps(subSteps, nextCallHeadIndex);
+                        continue;
+                    }
+                    logger.verbose(`step ${JSON.stringify(step)}`);
+                    const { commandFn = () => null, stepVariables, promptFn, postCommandExecFn, continueOnError, timeoutMillis = 1000 * 60 * 30, } = step;
+                    const prompt = promptFn
+                        ? await promptFn({
                             context,
                             stepIndex: compositeStepIndex,
                             contextRunState,
                             lumpVariables,
-                        });
-                    }
-                    else {
-                        subSteps = step;
-                    }
-                    await walkAndExecuteSteps(subSteps, nextCallHeadIndex);
-                    continue;
-                }
-                logger.verbose(`step ${JSON.stringify(step)}`);
-                const { commandFn = () => null, stepVariables, promptFn, postCommandExecFn, continueOnError, timeoutMillis = 1000 * 60 * 30, } = step;
-                const prompt = promptFn
-                    ? await promptFn({
+                            stepVariables,
+                        })
+                        : '';
+                    const command = await commandFn({
                         context,
+                        prompt,
                         stepIndex: compositeStepIndex,
                         contextRunState,
                         lumpVariables,
                         stepVariables,
-                    })
-                    : '';
-                const command = await commandFn({
-                    context,
-                    prompt,
-                    stepIndex: compositeStepIndex,
-                    contextRunState,
-                    lumpVariables,
-                    stepVariables,
-                    projectRoot,
-                    workspacePath,
-                });
-                let commandResult = '';
-                let commandSucceeded = true;
-                if (command != null) {
-                    const { executable, args, env } = command;
-                    logger.verbose(`command for prompt ${executable} ${args.join(' ')}`);
-                    if (env != null) {
-                        logger.verbose(`command env overrides ${JSON.stringify(env)}`);
-                    }
-                    logger.verbose(`workspacePath ${workspacePath}`);
-                    const commandExec = await execBinary(executable, args, timeoutMillis, {
-                        stdio: ['inherit', 'pipe', 'pipe'],
-                        cwd: workspacePath,
-                        ...(env != null ? { env: { ...process.env, ...env } } : {}),
+                        projectRoot,
+                        workspacePath,
                     });
-                    logger.verbose(`commandExec ${JSON.stringify(commandExec)}`);
-                    if (!commandExec.success) {
-                        if (!continueOnError) {
-                            stepWalkFailure = set(commandExec, ['data', 'message'], `Failed to run the command: ${commandExec.data.message}. Command: ${executable} ${args.join(' ')}`);
-                            return;
+                    let commandResult = '';
+                    let commandSucceeded = true;
+                    if (command != null) {
+                        const { executable, args, env } = command;
+                        logger.verbose(`command for prompt ${executable} ${args.join(' ')}`);
+                        if (env != null) {
+                            logger.verbose(`command env overrides ${JSON.stringify(env)}`);
+                        }
+                        logger.verbose(`workspacePath ${workspacePath}`);
+                        const commandExec = await execBinary({
+                            binaryPath: executable,
+                            args,
+                            timeoutMillis,
+                            stdio: ['inherit', 'pipe', 'pipe'],
+                            cwd: workspacePath,
+                            signal,
+                            ...(env != null ? { env: { ...process.env, ...env } } : {}),
+                        });
+                        logger.verbose(`commandExec ${JSON.stringify(commandExec)}`);
+                        if (!commandExec.success) {
+                            const aborted = commandExec.data.reason === 'aborted';
+                            if (aborted || !continueOnError) {
+                                stepWalkFailure = {
+                                    success: false,
+                                    data: {
+                                        message: `Failed to run the command: ${commandExec.data.message}. Command: ${executable} ${args.join(' ')}`,
+                                        reason: 'stepWalkFailed',
+                                    },
+                                };
+                                return;
+                            }
+                            commandSucceeded = false;
+                            commandResult = (commandExec.data.stdout
+                                || commandExec.data.stderr
+                                || commandExec.data.message
+                                || '').toString();
+                            logger.verbose(`commandResult ${commandResult}`);
+                        }
+                        else {
+                            commandResult = (commandExec.data.stdout || commandExec.data.stderr || '').toString();
+                            logger.verbose(`commandResult ${commandResult}`);
+                        }
+                        if (commandSucceeded) {
+                            const gitStatusAfterCommand = await execAsync(`git status`, { cwd: workspacePath });
+                            logger.verbose(`gitStatusCommand ${JSON.stringify(gitStatusAfterCommand.data)}`);
                         }
-                        commandSucceeded = false;
-                        commandResult = (commandExec.data.stdout
-                            || commandExec.data.stderr
-                            || commandExec.data.message
-                            || '').toString();
-                        logger.verbose(`commandResult ${commandResult}`);
                     }
-                    else {
-                        commandResult = (commandExec.data.stdout || commandExec.data.stderr || '').toString();
-                        logger.verbose(`commandResult ${commandResult}`);
+                    const postCommandExecFnInput = {
+                        commandResult,
+                        commandSucceeded,
+                        context,
+                        prompt,
+                        stepIndex: compositeStepIndex,
+                        contextRunState,
+                        lumpVariables,
+                        stepVariables,
+                        projectRoot,
+                    };
+                    logger.verbose(`context is ${JSON.stringify(context)}`);
+                    const keepHistoryFilePath = getKeepHistoryFilePathFn(context) || '';
+                    logger.verbose(`keepHistoryFilePath ${keepHistoryFilePath}`);
+                    if (!!command && keepHistoryFilePath.length > 0) {
+                        const appendResult = await appendHistoryEntry({
+                            filePath: keepHistoryFilePath,
+                            entry: postCommandExecFnInput,
+                        });
+                        if (!appendResult.success) {
+                            // TODO: sanitize history appending to avoid this warning for certain commands outputs
+                            logger.warn(`Failed to append history entry to ${keepHistoryFilePath}: ${appendResult.data}`);
+                        }
                     }
-                    if (commandSucceeded) {
-                        const gitStatusAfterCommand = await execAsync(`git status`, { cwd: workspacePath });
-                        logger.verbose(`gitStatusCommand ${JSON.stringify(gitStatusAfterCommand.data)}`);
+                    if (postCommandExecFn) {
+                        const returnedSteps = await postCommandExecFn(postCommandExecFnInput);
+                        if (returnedSteps != null && returnedSteps.length > 0) {
+                            await walkAndExecuteSteps(returnedSteps, nextCallHeadIndex);
+                        }
                     }
                 }
-                const postCommandExecFnInput = {
-                    commandResult,
-                    commandSucceeded,
-                    context,
-                    prompt,
-                    stepIndex: compositeStepIndex,
-                    contextRunState,
-                    lumpVariables,
-                    stepVariables,
-                    projectRoot,
-                };
-                logger.verbose(`context is ${JSON.stringify(context)}`);
-                const keepHistoryFilePath = getKeepHistoryFilePathFn(context) || '';
-                logger.verbose(`keepHistoryFilePath ${keepHistoryFilePath}`);
-                if (!!command && keepHistoryFilePath.length > 0) {
-                    const appendResult = await appendHistoryEntry({
-                        filePath: keepHistoryFilePath,
-                        entry: postCommandExecFnInput,
+            }
+            try {
+                await walkAndExecuteSteps(steps, []);
+            }
+            finally {
+                try {
+                    await teardownFn({
+                        lumpVariables,
+                        contextList,
+                        currentContextIndex: i,
+                        contextRunState,
                     });
-                    if (!appendResult.success) {
-                        // TODO: sanitize history appending to avoid this warning for certain commands outputs
-                        logger.warn(`Failed to append history entry to ${keepHistoryFilePath}: ${appendResult.data}`);
-                    }
                 }
-                if (postCommandExecFn) {
-                    const returnedSteps = await postCommandExecFn(postCommandExecFnInput);
-                    if (returnedSteps != null && returnedSteps.length > 0) {
-                        await walkAndExecuteSteps(returnedSteps, nextCallHeadIndex);
-                    }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    logger.error(`Failed to run teardownFn: ${message}`);
                 }
             }
+            if (stepWalkFailure) {
+                runFailure = stepWalkFailure;
+                break;
+            }
+            const perContextInput = {
+                ...injectedGitAndWorkspaceFnsInput,
+                context,
+            };
+            const gitAddCommand = await execAsync(gitAddCommandFn(perContextInput), { cwd: workspacePath });
+            logger.verbose(`gitAddCommand ${JSON.stringify(gitAddCommand)}`);
+            if (!gitAddCommand.success) {
+                runFailure = {
+                    success: false,
+                    data: {
+                        message: `Failed to add the changes for context ${context.name}: ${gitAddCommand.data.message}`,
+                    },
+                };
+                break;
+            }
+            const commitMessage = gitCommitMessageFn({ context, lumpVariables, baseBranch });
+            const commitCommand = await execAsync(gitCommitCommandFn({
+                ...perContextInput,
+                commitMessage,
+            }), { cwd: workspacePath });
+            logger.verbose(`commitCommand ${JSON.stringify(commitCommand)}`);
+            if (!commitCommand.success) {
+                logger.error(formatExecFailureMessage({
+                    label: `git commit for context ${context.name}`,
+                    failure: commitCommand,
+                }));
+            }
         }
-        await walkAndExecuteSteps(steps, []);
-        if (stepWalkFailure) {
-            return stepWalkFailure;
-        }
-        await teardownFn({
-            lumpVariables,
-            contextList,
-            currentContextIndex: i,
-            contextRunState,
-        });
-        const perContextInput = {
-            ...injectedGitAndWorkspaceFnsInput,
-            context,
-        };
-        const gitAddCommand = await execAsync(gitAddCommandFn(perContextInput), { cwd: workspacePath });
-        logger.verbose(`gitAddCommand ${JSON.stringify(gitAddCommand)}`);
-        if (!gitAddCommand.success) {
-            return set(gitAddCommand, ['data', 'message'], `Failed to add the changes for context ${context.name}: ${gitAddCommand.data.message}`);
-        }
-        const commitMessage = gitCommitMessageFn({ context, lumpVariables, baseBranch });
-        const commitCommand = await execAsync(gitCommitCommandFn({
-            ...perContextInput,
-            commitMessage,
-        }), { cwd: workspacePath });
-        logger.verbose(`commitCommand ${JSON.stringify(commitCommand)}`);
-        if (!commitCommand.success) {
-            logger.error(formatExecFailureMessage({
-                label: `git commit for context ${context.name}`,
-                failure: commitCommand,
-            }));
+        if (!runFailure) {
+            const pushCommand = await execAsync(gitPushCommandFn(injectedGitAndWorkspaceFnsInput), { cwd: workspacePath });
+            logger.verbose(`pushCommand ${JSON.stringify(pushCommand)}`);
+            if (!pushCommand.success) {
+                logger.error(formatExecFailureMessage({
+                    label: `git push on branch ${branchName}`,
+                    failure: pushCommand,
+                }));
+            }
         }
     }
-    const pushCommand = await execAsync(gitPushCommandFn(injectedGitAndWorkspaceFnsInput), { cwd: workspacePath });
-    logger.verbose(`pushCommand ${JSON.stringify(pushCommand)}`);
-    if (!pushCommand.success) {
-        logger.error(formatExecFailureMessage({
-            label: `git push on branch ${branchName}`,
-            failure: pushCommand,
-        }));
-    }
-    const teardownWorkspaceCommand = await teardownWorkspaceFn(injectedGitAndWorkspaceFnsInput);
-    logger.verbose(`teardownWorkspaceCommand ${teardownWorkspaceCommand}`);
-    if (teardownWorkspaceCommand) {
-        const teardownWorkspaceCommandExec = await execAsync(teardownWorkspaceCommand, { cwd: workspacePath });
-        logger.verbose(`teardownWorkspaceCommandExec ${JSON.stringify(teardownWorkspaceCommandExec)}`);
-        if (!teardownWorkspaceCommandExec.success) {
-            return set(teardownWorkspaceCommandExec, ['data', 'message'], `Failed to teardown the workspace: ${teardownWorkspaceCommandExec.data.message}`);
+    finally {
+        const teardownWorkspaceCommand = await teardownWorkspaceFn(injectedGitAndWorkspaceFnsInput);
+        logger.verbose(`teardownWorkspaceCommand ${teardownWorkspaceCommand}`);
+        if (teardownWorkspaceCommand) {
+            const teardownWorkspaceCommandExec = await execAsync(teardownWorkspaceCommand, { cwd: workspacePath });
+            logger.verbose(`teardownWorkspaceCommandExec ${JSON.stringify(teardownWorkspaceCommandExec)}`);
+            if (!teardownWorkspaceCommandExec.success) {
+                if (runFailure) {
+                    logger.error(formatExecFailureMessage({
+                        label: 'teardown workspace',
+                        failure: teardownWorkspaceCommandExec,
+                    }));
+                }
+                else {
+                    runFailure = {
+                        success: false,
+                        data: {
+                            message: `Failed to teardown the workspace: ${teardownWorkspaceCommandExec.data.message}`,
+                            reason: 'workspaceTeardownFailed',
+                        },
+                    };
+                }
+            }
         }
     }
+    if (runFailure) {
+        return runFailure;
+    }
     return success({
         branchName,
         contextNames,
@@ -4015,7 +4262,7 @@ const defaultSetupWorkspaceFnWithWorktree = async (input) => {
 };
 
 async function runLump(input) {
-    const { baseBranch, branchFn, lumpVariables: lumpVariablesInput, getContextListFn, gitAddCommandFn = defaultGitAddCommandFn, gitCommitCommandFn = defaultGitCommitCommandFn, gitCommitMessageFn = defaultGitCommitMessageFn, gitPushCommandFn = defaultGitPushCommandFn, numberOfContextsPerBranch = 1, projectRoot, steps, setupFn = () => ({ contextRunState: {} }), setupWorkspaceFn = defaultSetupWorkspaceFn, teardownFn = () => undefined, teardownWorkspaceFn = defaultTeardownWorkspaceFn, getKeepHistoryFilePathFn = () => undefined, logger: loggerInput, } = input;
+    const { baseBranch, branchFn, lumpVariables: lumpVariablesInput, getContextListFn, gitAddCommandFn = defaultGitAddCommandFn, gitCommitCommandFn = defaultGitCommitCommandFn, gitCommitMessageFn = defaultGitCommitMessageFn, gitPushCommandFn = defaultGitPushCommandFn, numberOfContextsPerBranch = 1, projectRoot, steps, setupFn = () => ({ contextRunState: {} }), setupWorkspaceFn = defaultSetupWorkspaceFn, teardownFn = () => undefined, teardownWorkspaceFn = defaultTeardownWorkspaceFn, getKeepHistoryFilePathFn = () => undefined, logger: loggerInput, signal, } = input;
     const lumpVariables = (lumpVariablesInput ?? {});
     const logger = loggerInput ?? createConsoleLogger({});
     const contextListToDoResult = await getToDoContextList({
@@ -4061,6 +4308,7 @@ async function runLump(input) {
         teardownWorkspaceFn,
         logger,
         getKeepHistoryFilePathFn,
+        signal,
     });
     if (!executeStepsResult.success) {
         return set(executeStepsResult, ['data', 'message'], "Error in runLump: Failed to execute steps for context list. Original Error: " + executeStepsResult.data.message);
@@ -4070,5 +4318,5 @@ async function runLump(input) {
     });
 }
 
-export { appendHistoryEntry, collectStepsForContext, contextStatus, createConsoleLogger, defaultGitAddCommandFn, defaultGitCommitCommandFn, defaultGitCommitMessageFn, defaultGitPushCommandFn, defaultSetupWorkspaceFn, defaultSetupWorkspaceFnWithWorktree, defaultTeardownWorkspaceFn, defaultTeardownWorkspaceFnWithWorktree, execAsync, execBinary, executeStepsForContextList, failure, formatExecFailureMessage, getCodeBasePaths, getContextStatus, getToDoContextList, historyFormatFromPath, parseGitLogHashSubjectLines, pathExists, readHistoryFile, resolveSpawnExecutable, runLump, set, shellSingleQuote, success, validateContextListNames, windowsNpmCmdShimBody, writeHistoryFile };
+export { appendHistoryEntry, collectStepsForContext, contextStatus, createConsoleLogger, defaultGitAddCommandFn, defaultGitCommitCommandFn, defaultGitCommitMessageFn, defaultGitPushCommandFn, defaultSetupWorkspaceFn, defaultSetupWorkspaceFnWithWorktree, defaultTeardownWorkspaceFn, defaultTeardownWorkspaceFnWithWorktree, execAsync, execBinary, executeStepsForContextList, failure, formatExecFailureMessage, getCodeBasePaths, getContextStatus, getToDoContextList, historyFormatFromPath, isProcessAlive, killProcessTree, nodeErrnoCode, parseGitLogHashSubjectLines, pathExists, readHistoryFile, resolveSpawnExecutable, runLump, set, shellSingleQuote, success, validateContextListNames, windowsNpmCmdShimBody, writeHistoryFile };
 //# sourceMappingURL=index.js.map