Function readFiles

packages/just-bash/src/utils/file-reader.ts:58–128

(
  ctx: CommandContext,
  files: string[],
  options: ReadFilesOptions,
)

 * }
 */
export async function readFiles(
  ctx: CommandContext,
  files: string[],
  options: ReadFilesOptions,
): Promise<ReadFilesResult> {
  const {
    cmdName,
    allowStdinMarker = true,
    stopOnError = false,
    batchSize = DEFAULT_BATCH_SIZE,
  } = options;

  // No files - read from stdin
  if (files.length === 0) {
    return {
      files: [{ filename: "", content: ctx.stdin }],
      stderr: "",
      exitCode: 0,
    };
  }

  const result: FileContent[] = [];
  let stderr = "";
  let exitCode = 0;

  // Process files in parallel batches for better performance
  for (let i = 0; i < files.length; i += batchSize) {
    const batch = files.slice(i, i + batchSize);
    const batchResults = await Promise.all(
      batch.map(async (file) => {
        if (allowStdinMarker && file === "-") {
          return {
            filename: "-",
            content: ctx.stdin,
            error: null as string | null,
          };
        }
        try {
          const filePath = ctx.fs.resolvePath(ctx.cwd, file);
          // Use binary encoding to preserve all bytes (including non-UTF-8).
          // This is important for piping binary data through commands like cat.
          // Text-processing commands must explicitly call `decodeBytesToUtf8`
          // on the content before regex / parsing.
          const content = await readBytesFrom(ctx.fs, filePath);
          return { filename: file, content, error: null as string | null };
        } catch {
          return {
            filename: file,
            content: EMPTY_BYTES,
            error: `${cmdName}: ${file}: No such file or directory\n`,
          };
        }
      }),
    );

    // Process results in order
    for (const r of batchResults) {
      if (r.error) {