How It Works

1. Resolve Paths Converts input and output to absolute paths and ensures the output file itself is excluded.

2. Directory Walk Recursively walks directories sequentially to avoid concurrency deadlocks.

   • Directories are traversed first.
   • Files are processed concurrently, respecting the concurrency limit.

3. File Processing For each file:

   • Skips if hidden, excluded, or exceeds maxFileSize.
   • Reads file contents (utf-8).
   • Generates a Markdown header using filenameFormatter.
   • Wraps the content in a fenced code block with language derived from the file extension.
   • Appends content to the output Markdown file.
   • Calls onprogress callback.

4. Summary Generation After all files are processed:

   • Calls summaryFormatter with the list of processed files.
   • Appends the generated summary to the Markdown file.

5. Error Handling

   • Wraps file system operations in safeRun to catch errors without stopping execution unless stopOnError is true.
   • Logs warnings and errors for files that fail to process.