Function formatCommandErrorDetails

src/core/command-error.ts:28–59

(error: unknown)

}

function formatCommandErrorDetails(error: unknown): string[] {
  const details: string[] = [];
  if (!error || typeof error !== 'object') {
    details.push('Unknown error occurred');
    return details;
  }

  const commandError = error as CommandError;

  for (const [label, stream] of [
    ['stderr', commandError.stderr],
    ['stdout', commandError.stdout],
  ] as const) {
    const cleaned = cleanCommandOutput(streamToText(stream));
    if (cleaned) {
      details.push(`${label}:\n${cleaned}`);
    }
  }

  if (details.length === 0) {
    const reason = commandError.killed
      ? 'Process was killed (likely timed out)'
      : commandError.code === 'ETIMEDOUT'
        ? 'Process timed out'
        : commandError.code === 'ENOENT'
          ? 'Command not found — check that the required CLI is installed and on PATH'
          : 'No error output captured';
    details.push(reason);
  }

  return details;
}

function printCommandErrorDetails(error: unknown, indent = '    '): void {
  for (const detail of formatCommandErrorDetails(error)) {