task-runner-native

Task Runner Native

Run shell commands natively on the host system using Node.js child_process.

Usage

import { NativeTaskRunner } from '@lde/task-runner-native';

const runner = new NativeTaskRunner({
  cwd: '/path/to/working/dir', // Optional working directory
  gracefulShutdownTimeout: 5000, // Optional timeout before SIGKILL (default: 5000ms)
});

// Run a command
const task = await runner.run('echo "Hello World"');

// Wait for completion
const output = await runner.wait(task);
console.log(output); // "Hello World"

// Or stop a long-running task
const task2 = await runner.run('sleep 60');
await runner.stop(task2); // Sends SIGTERM, then SIGKILL after timeout

Options

Option	Type	Default	Description
cwd	string	Current directory	Working directory for spawned processes
gracefulShutdownTimeout	number	5000	Milliseconds to wait after SIGTERM before sending SIGKILL

Features

• Spawns commands in a detached process group
• Graceful shutdown with SIGTERM → SIGKILL escalation
• Handles already-exited processes in stop()
• Captures stdout and stderr output