CLI-утилита для текста

Сделай файл запускаемый как CLI: shebang (#!/usr/bin/env node), chmod +x и одна команда читающая аргумент или stdin и пишущая в stdout. Запусти как ./tool hello и как echo hello | ./tool — оба должны работать. Exit-коды важны: 0 на успехе, не-ноль на отсутствующем вводе или плохом флаге, так что пайп вроде ./tool --bad 2>/dev/null; echo $? показывает код ошибки. Пока без библиотеки парсинга аргументов — только process.argv и process.stdin чтобы увидеть что прячет каждая библиотека.

Пусть утилита читает либо из stdin (когда пайп), либо из аргумента-пути к файлу (когда дан), как cat, grep и sort. Правило: если аргумент-файл есть — читай его, иначе читай stdin. Обрабатывай оба единообразно как readable stream чтобы остальная утилита не заботилась откуда байты. Обрабатывай ошибки: отсутствующий файл → stderr + не-нулевой exit, не краш и не тихий пустой вывод. Докажи: cat file.txt | ./tool --count и ./tool --count file.txt дают одинаковый count.

Добавь три флага покрывающих базовые паттерны Unix-текста: --filter <паттерн> оставляет только строки содержащие подстроку (как grep), --count печатает только число подходящих (или всех) строк (как wc -l), --slice <start>:<end> оставляет строки start..end (как sed -n). Парсь их руками из process.argv — без yargs/commander — чтобы обработать --help, неизвестный флаг → stderr + не-ноль и порядок флагов. Флаги компонуются: --filter foo --slice 1:5 означает 'отфильтровать затем нарезать отфильтрованный вывод'. Валидируй: --slice с плохим диапазоном (отрицательный, перевёрнутый) → stderr с не-нолём, не тихий неверный срез. Измерь: отфильтруй фикстуру 100k строк и покажи корректность и скорость.

Сделай обработку большого файла без удержания всего в памяти. Обрабатывай stdin/файл построчно потоком (разделение по \n, обработка хвостовой неполной строки) чтобы файл 500 МБ никогда не превышал нескольких МБ кучи. Наивный readFileSync + split даст OOM или давление GC на больших входах; поток держит память плоской. Обработай край: строка длиннее границы чанка должна быть пересобрана до фильтрации, не разрезана посередине. Докажи: сгенерируй фикстуру 10k строк и также 100 МБ фикстуру (или симулируй большим потоком), запусти утилиту и покажи ограниченность кучи (или хотя бы корректность числа строк и отсутствие краша). Объясни почему построчный буфер, а не буфер чанков — правильная гранулярность.

Докажи что утилита — настоящий гражданин Unix: она компонуется с другими утилитами через пайпы и редиректы без специального кода. Продемонстрируй: cat file | ./tool --filter foo | sort | uniq -c (пайп наружу), ./tool --filter foo file > out.txt (редирект), ./tool --filter foo file | ./tool --count (пайп в себя). Вывод каждого флага — построчный текст на stdout, ошибки на stderr, код выхода сигнализирует успех — так что > и | работают ровно как для cat/grep/wc. Добавь крошечный тестовый харнесс спавнящий CLI (child_process.spawn) и проверяющий stdout/stderr/код выхода на паре случаев — твои первые тесты CLI без фреймворка.