Правила фільтрування команд

rtok run (а також rtok filter --stdin і переписування Bash на PreToolUse, яке викликає rtok run) скорочує вивід команд за правилами для кожного сімейства, перш ніж його побачить модель. Сирий вивід завжди спершу архівується, тож кожен скорочений результат можна отримати через rtok expand <id> (типово без втрат, D4). Правила ніколи нічого не приховують: рядок, що містить помилку, попередження чи секрет, проходить без змін.

Три рівні об'єднуються в такому порядку; пізніший рівень перемагає для кожного сімейства команд:

1. Вбудовані — rules/default.toml у репозиторії (grep, rg, sed, cat, make, curl, npm, pnpm, node, а також форматувальники cargo/git/test/tree у коді).
2. Файл користувача — [plugins.cmd] rules (типово ~/.rtok/rules.toml).
3. Drop-in-файли — кожен *.toml у [plugins.cmd] rules_dir (типово ~/.rtok/rules.d/), об'єднані в порядку назв файлів.

Відсутній файл чи каталог — не помилка: цей рівень пропускається. Некоректний файл пропускається під час виконання (fail open), а rtok config validate повідомляє про нього, називаючи кожен поганий файл.

Схема

Одна таблиця TOML на сімейство команд. Назва таблиці — перше слово команди ([grep], [pytest]); для невідомих сімейств використовується типове правило (max_lines = 40, head = 10, tail = 10, дедуплікацію увімкнено). Один виняток: один рядок Bash, що з'єднує 2+ РІЗНІ програми через &&, ; або новий рядок (T177), — це не вивід одного сімейства: його зіставляють із [script]. Ланцюжок однієї програми (cargo build && cargo test або з початковим cd/export) і далі використовує власний форматувальник/правило цієї програми.

Той самий рушій обрізає результати сторонніх MCP-серверів за rtok mcp -- <server argv> (T59.4): розділ [mcp] — це правило для текстового блоку tools/call кожного обгорнутого сервера, а якщо його немає — типове правило. Змінюються лише текстові блоки результату без isError, довші за max_lines; сирий блок спершу архівується, а обрізаний текст закінчується тим самим рядком [rtok <id> · N lines · expand: rtok expand <id>], який друкує rtok run. Економія записується як вимірювання cmd / wrap з ref_id = <server>/<tool>:<id>.

Будь-яке інше поле, неправильний тип чи зламаний TOML — це некоректний файл. Ненульовий код виходу скасовує все це: останні [plugins.cmd] fail_tail_lines рядків (типово 80) друкуються дослівно, бо помилка команди, що впала, — це і є корисні дані.

Розібраний приклад

~/.rtok/rules.d/pytest.toml — зводити тихі запуски pytest до вказівника, але ніколи не втрачати збій:

[pytest]
max_lines = 30
head = 5
tail = 15
drop = ["PASSED", "passed"]
keep = ["FAILED|failed|ERROR|error"]
dedupe = true

До (212 рядків крапок і пройдених тестів), після (12 рядків):

tests/test_auth.py::test_login PASSED
tests/test_auth.py::test_refresh FAILED
… 200 lines omitted (expand abc123)
E   assert False is True

Перевірте, перш ніж на нього покладатися:

rtok config validate   # називає файли rules.d/*.toml, які не розбираються

validate перевіряє файл, названий у командному рядку (або конфігурацію користувача), плюс окремий файл rules і кожен rules.d/*.toml, до якого вона веде. Файл, про який повідомлено, пропускається під час виконання, доки його не виправлять; усе інше й далі фільтрується.

Сімейства (T50.1)

Виміряно на golden-фікстурах у tests/cmd_golden/ (rtok filter --stdin, Rule проти Rule::default() на тому самому тексті; оцінка токенів = байти/4).

Форматувальники (T58.5)

Виміряно на тих самих golden-текстах (formatters::compress, Measurement.kind = formatter проти Rule::default() на тій самій фікстурі; оцінка токенів = байти/4). Кожен форматувальник зберігає один рядок на об'єкт і повертає None для нерозпізнаного виводу, тож шлях правил лишається запасним варіантом.

Групування (T64.1)

Виміряно на golden-фікстурах у tests/cmd_golden/ (formatters::compress із вбудованим правилом проти того самого правила з вимкненим group; оцінка токенів = байти/4). Для сімейства групування вмикається, лише коли згрупований текст менший. tree, git status, pytest і python лишаються як є: псевдографіка tree і форматувальники git/pytest — це не потоки «шлях на рядок» чи діагностики з кодами, а traceback python з T50.1 не стискається у вигляді NameError ×1.

JSON (T65.2)

Текст, який serde_json розбирає як об'єкт або масив, переписується після групування й до обрізання head/tail: поля з null / порожнім рядком / порожнім контейнером видаляються, елементи масивів понад json_items показуються як … +K more, ключі об'єктів зберігаються, рядки, довші за json_string, обрізаються із зазначенням довжини, один рядок на ключ верхнього рівня. Тексти, що не розбираються, лишаються недоторканими. Табличні форматувальники (kubectl get, docker ps) поступаються, коли текст — JSON, тож kubectl get -o json доходить до цього проходу. toon лишається поза шляхом хука. Сирі байти лишаються в архіві; скорочений результат і далі несе завершальний рядок expand.

Виміряно на tests/cmd_golden/{gh,aws,kubectl}_json.in (formatters::compress проти обрізання head/tail того самого відформатованого тексту; оцінка токенів = байти/4).