@vernikr/size-report 1.1.1 → 1.2.0

package/CHANGELOG.md

@@ -18,6 +18,53 @@
 где за основу взяты `fixtures/synthetic/config.json`, метрики — `raw`, `min`, `tok`, а
 способ минификации — `strip` или `esbuild`.
 
+## 1.2.0 — 2026-09-15
+
+Выпуск причины, а не измерения: проверка («таблица совпадает с историей?») теперь
+называет другой счёт, когда он есть, — и делает это всегда, а не только там, где
+всё сошлось. Нашлось это прогулкой по собственной инструкции (`WORKLOG.md` §54),
+починено по правилу «нарушение старше приближения» (`REFACTOR.md` R-4.23).
+
+- **`size` и `size check` печатают заметку о датчике всегда.** Раньше заметка
+  печаталась только при благополучном вердикте: если отчёт собран с настоящим
+  минификатором, а прогон идёт без него (установка без необязательных
+  зависимостей, платформа без `esbuild`), числа честно расходились, а причины
+  «счёт другой» в выводе не было вовсе — читатель видел расхождение строки
+  подписи и ничего о том, откуда оно.
+- **Вердикт остаётся первым по важности.** Нарушение старше приближения — тот же
+  порядок, что у `size check` и `size doctor`: код **4** утверждал бы, что
+  расхождение объясняется датчиком, а этого никто не проверял (расхождение может
+  быть и правкой мимо отчёта). Поэтому ответ в этом случае — по-прежнему **код 1**
+  плюс заметка с починкой: кода выхода выпуск не меняет ни в одном случае.
+- Ни сборка отчёта, ни его форма, ни смысл настроек не тронуты. Остальное в этом
+  выпуске — не про поставку: выпуск по тегу из CI (R-4.24) и снятые цели по
+  времени у набора проверок (R-5.8) касаются репозитория пакета, а не того, что
+  устанавливают.
+- Номер **1.2.0** назван владельцем пакета; по строгому SemVer содержимое —
+  исправление (PATCH): новых возможностей в поставке нет.
+
+### Что изменится в числах
+
+**Ничего.** Таблица ниже та же, что у 1.1.0 и 1.1.1, до последней клетки: этот
+выпуск меняет текст под расхождением, а не числа. Замер на фикстуре — тот же
+(16 коммитов, 10 колонок), доказано не словом: артефакт (22 112 Б), страница
+(59 376 Б) и оба замороженных эталона не переснимались, а `--json` и артефакт
+побайтово равны эталону на фикстуре и на живой истории проекта-потребителя.
+
+| Файл | raw | min со strip | min с esbuild | tok |
+|---|---|---|---|---|
+| code.js | 735 | 276 | 185 | 168 |
+| modern.js | 246 | 51 | 45 | 44 |
+| config.mjs | 172 | 45 | 40 | 40 |
+| заметки.md | 306 | 303 | 303 | 53 |
+| crlf.txt | 63 | 60 | 60 | 10 |
+| package.json | 87 | 69 | 69 | 34 |
+| style.css | 156 | 55 | 43 | 38 |
+| table.toml | 300 | 299 | 299 | 52 |
+| empty.js | 0 | 0 | 0 | 0 |
+| WORKLOG.md | 446 | 439 | 439 | 101 |
+| **ИТОГО** | **2511** | **1597** | **1483** | **540** |
+
 ## 1.1.1 — 2026-09-15
 
 Выпуск имени, а не измерения: пакет переехал в область владельца

package/README.md

@@ -100,7 +100,7 @@
 есть в дереве, таблица файлов сходится с ним в обе стороны),
 `test/docs-commands.test.js` (команды и ключи есть в справке, причины отказа
 совпадают с реестром движка, ссылки на разделы ведут в существующие),
-`test/docs-numbers.test.js` (числа проверок и целей — факт) и
+`test/docs-numbers.test.js` (числа проверок — факт) и
 `test/docs-pin.test.js` (пример установки ведёт на ревизию, чья справка знает
 названные команды), а с выпуском добавился пятый — `test/changelog.test.js`
 (версия выпуска — версия манифеста, а таблица «что изменится в числах» — не
@@ -176,8 +176,7 @@
 86 мс на каждую клетку, плюс разбор опирается на экспериментальный API (без него
 гард отступает к прежнему `node --check` — медленнее, но не мягче).
 Прогон подешевел втрое: `pnpm test` 15,7 → **5,6 с** (тогда в наборе было 39
-проверок), `pnpm run parity:live` 23,8 → **8,3 с**. Бюджет времени переснят с
-запасом на следующую проверку, а не под сегодняшнее число: набор стоит
+проверок), `pnpm run parity:live` 23,8 → **8,3 с**. Набор стоит
 **23,4–29,9 с** при 124 проверках — в зависимости от загрузки машины: окна с
 загрузкой 18–70 несравнимы (в спокойном — 23,4–24,2 с, в занятых — 26,6–29,9 с;
 в среде без настроек git — 27,4 с, с `CI=1` — 29,9 с), и это свойство окна, а не
@@ -193,41 +192,38 @@
 прибавило** — 23,2 с и до него, и после: обе новые проверки измерены отдельным
 прогоном, а не выведены из разброса. Из общего времени **+8,5 с** — десять проверок хука
 (`test/hook.test.js`: сам он идёт 17,9–18,5 с и становится самым долгим файлом
-набора, а та же ревизия без него — 15,8–16,6 с при 107 проверках). Цель не
-двигалась, и это решение, а не пропуск: цель тогда была одна — полный набор
-**≤ 28 с** (запас 2,3 с) — измеренное в неё укладывается, а поднимают цель по делу и с измерением,
-а не под занятую машину: интеграционные
+набора, а та же ревизия без него — 15,8–16,6 с при 107 проверках). Интеграционные
 прогоны (клон, коммиты, слияние, отказы) дешевле не сделать, не ослабив проверку.
-`pnpm run parity:live` **≤ 15 с** (9,3 с в обеих средах). Замеры, машина и разброс —
+`pnpm run parity:live` — 9,3 с в обеих средах. Замеры, машина и разброс —
 `REFACTOR.md` §5.
 
-**Прогонов два, и у каждого своя цель** (`REFACTOR.md` R-5.5). Цена проверки в этом
-наборе — не объём файла, а сколько раз файл запускает инструмент и git: запуск — это
-процесс Node, а клон фикстуры и сборка артефакта — сотни миллисекунд. Поэтому
-быстрый прогон собирает то, что доказывает по прочитанному (исходники, дерево,
-справка, эталонные числа на общей фикстуре), а полный добавляет то, что гоняет
-инструмент по многу раз на своих клонах, коммитит и ставит хуки; причина для каждого
-дорогого файла названа построчно в `tools/suites.js`, там же снимок стоимостей
-(перемерить — `pnpm run suites:measure`).
-
-| Прогон | Команда | Проверок | Цель |
-|---|---|---|---|
-| Быстрый — каждая правка | `pnpm test` | **57 из 131** | **≤ 10 с** |
-| Полный — выкладка и CI | `pnpm test:all` | **131** | **≤ 32 с** |
-
-Ни одна проверка не потеряна и не ослаблена: полный прогон запускает все 132 теми же
+**Прогонов два, и выбор между ними — по цене файла, а не по алфавиту**
+(`REFACTOR.md` R-5.5). Цена проверки в этом наборе — не объём файла, а сколько раз
+файл запускает инструмент и git: запуск — это процесс Node, а клон фикстуры и сборка
+артефакта — сотни миллисекунд. Поэтому быстрый прогон собирает то, что доказывает по
+прочитанному (исходники, дерево, справка, эталонные числа на общей фикстуре), а
+полный добавляет то, что гоняет инструмент по многу раз на своих клонах, коммитит и
+ставит хуки; причина для каждого дорогого файла названа построчно в
+`tools/suites.js`.
+
+| Прогон | Команда | Проверок |
+|---|---|---|
+| Быстрый — каждая правка | `pnpm test` | **57 из 135** |
+| Полный — выкладка и CI | `pnpm test:all` | **135** |
+
+Ни одна проверка не потеряна и не ослаблена: полный прогон запускает все 135 теми же
 файлами, а быстрый берёт их часть. Умолчание — полный: файл становится быстрым только
 явно и с причиной, поэтому новое дорогое не может тихо уехать в быстрый. Стерегут это
-двое, и по-разному: `test/suites.test.js` — объявление (полнота классификации,
-причины, потолок стоимости быстрого файла), а сам прогон (`tools/run-tests.js`) —
-замер: он печатает стоимость каждого файла своим запуском, складывает числа проверок
-и валится, если вышел за цель вдвое. Снимок стоимости проверяется только замером,
-и это его законное место: подделанная стоимость у быстрого файла объявление проходит,
-а прогон её ловит. Цель при этом не порог: занятое окно растягивает прогон, и
-прогон, не уложившийся в цель, говорит это словами («ЦЕЛЬ НЕ ДОСТИГНУТА»), а не
-показывает зелёную галку при 29 с. CI зовёт полный прогон дважды — обычной средой и
-без настроек машины. Числа и цели в этой таблице сверяются сторожем документации
-(`test/docs-numbers.test.js`), а не живут второй копией без присмотра.
+объявление `test/suites.test.js` (полнота классификации и причина у каждого файла) и
+сторож документации `test/docs-numbers.test.js` (числа в таблице выше).
+
+**Целей по времени у прогонов нет, и это решение, а не пропуск.** Секунды зависят от
+окна — машина бывает под очень разной нагрузкой, — поэтому ни набор, ни CI за время
+не валятся, и документ секунд не обещает: `pnpm run suites:measure` печатает
+длительность каждого файла отдельным прогоном (и сам прогон печатает её рядом с
+галочкой), но это измерение, а не порог. Разделение держится признаком файла — чем он
+занят, а не сколько идёт. CI зовёт полный прогон дважды: обычной средой и без настроек
+машины (`GIT_CONFIG_GLOBAL=/dev/null`).
 
 **Обещанное пакетом сведено к факту.** Список поставки называл четыре пути,
 которых в репозитории нет (`dist/`, `templates/`, `CHANGELOG.md`, `LICENSE`):
@@ -249,7 +245,22 @@ fixture`) и больше не зависит ни от того, держит
 Секретов job не требует: история потребителя лежит в репозитории бандлом на той
 же ревизии, что записана в эталоне (`fixtures/live/`), а пересъём идёт во временный
 каталог и сверяется с закоммиченным — рабочее дерево остаётся чистым. Матрицы по
-версиям Node и публикаций нет намеренно: этот проход про контроль.
+версиям Node нет намеренно: этот проход про контроль.
+
+**Выпуск — это тег (`.github/workflows/release.yml`).** `git push origin v1.2.3`
+прогоняет тот же полный набор, сверяет версию манифеста с тегом, проверяет работу
+из собранного пакета и отправляет его в реестр — без секрета и без кода из
+аутентификатора: публикация идёт по удостоверению GitHub Actions (trusted
+publishing), которое npm принимает вместо токена. Одна настройка делается человеком
+и один раз: на npmjs.com в настройках пакета (Trusted Publisher) нужно назвать
+владельца, репозиторий и файл `release.yml`. Черновой прогон из Actions («Run
+workflow»: по умолчанию он ничего не публикует) проходит весь список до самого пути
+публикации — гоняет полный набор, проверяет работу из тарболла и собирает пакет на
+черновой версии (`1.1.1` → `1.1.2-draft.0`, чтобы реестр не отказал в уже выпущенном
+номере), — и это же стережёт `test/release.test.js` со стороны текста. Только настроен
+ли издатель, он не проверяет: `--dry-run` не обменивается удостоверением и проходит
+вообще без учётных данных (проверено в пустом каталоге: код 0 без токена). Это делает
+первый настоящий тег.
 
 Первым же прогоном CI окупился: шаг живого паритета упал не на расхождении чисел,
 а на самой проверке — вывод процессов собирался как строка, и многобайтовый символ,
@@ -441,6 +452,7 @@ deльт задан один раз и по артефакту: рост зел
 | `tools/pack-check.js` | Собирает тарболл и проверяет, что из него всё работает: все исходники доехали, числа, артефакт и страница — как из репозитория (`pnpm run pack:check`) |
 | `tools/check-standards.js` | Проверяет, что оба эталона воспроизводятся: пересъём идёт в никуда и сверяется с закоммиченным (наши файлы — побайтово, бандл — по содержимому) и что бандл живой истории несёт `HEAD` (`pnpm run check:standards`) |
 | `.github/workflows/ci.yml` | CI: семь шагов на каждый пуш и запрос правки — те же команды, что локально, без секретов и матриц |
+| `.github/workflows/release.yml` | Выпуск по тегу: тот же полный набор, сверка версии манифеста с тегом и публикация в реестр по удостоверению GitHub Actions — без секрета и без кода из аутентификатора |
 | `templates/` | То, что проект берёт как есть: `size-report.config.json` (черновик настроек), `ci.yml` (описание проверки) и `README.md` (куда что кладётся и что в них менять); едут в поставке и стерегутся `pack:check` и `test/templates.test.js` |
 | `fixtures/parity/` | Эталон с `safe-resets` на коммите `bd6ef9d`: 95 строк × 27 колонок. Копия реализации, которой он снят, в дереве не лежит — её байты живут в истории и берутся оттуда по требованию (`REFACTOR.md` R-1.5) |
 | `fixtures/synthetic/` | Бандл фикстуры на 16 коммитов, её конфиг, эталонные числа и хеш артефакта |
@@ -479,9 +491,10 @@ deльт задан один раз и по артефакту: рост зел
 | `test/api.test.js` | Публичный API пакета: список имён заморожен, разбиение не имеет права его менять |
 | `eslint.config.js` | Правила оформления: те же, что у проекта-потребителя, плюс запрет склейки операторов в строке (`pnpm run lint`, `pnpm run lint:strict`) |
 | `tools/harness.js` | Обвязка проверок: пути, клоны фикстуры (в том числе общий на набор и с CRLF), запуск инструмента, разбор отказов, хеши |
-| `tools/suites.js` | Разделение набора: какие файлы идут в быстрый прогон (с причиной и снимком стоимости), почему каждый дорогой — в полном, и цели обоих прогонов |
-| `tools/run-tests.js` | Прогон набора (`pnpm test`, `pnpm test:all`, `pnpm run suites:measure`): стоимость каждого файла своим замером, сверка числа проверок, граница бюджета |
+| `tools/suites.js` | Разделение набора: какие файлы идут в быстрый прогон (с причиной для каждого), почему каждый дорогой — в полном |
+| `tools/run-tests.js` | Прогон набора (`pnpm test`, `pnpm test:all`, `pnpm run suites:measure`): длительность каждого файла своим замером и сверка числа проверок |
 | `tools/docs-facts.js` | Чтение фактов из документации — один слой на четыре проверки сторожа: что документ называет (пути, зовы, адреса разделов) против того, что есть в репозитории |
+| `tools/yaml.js` | Разбор подмножества YAML — один разборщик на два сторожа описаний (`templates/ci.yml` и `.github/workflows/release.yml`): вне подмножества — ошибка, а не молча пропущенная строка, включая двоеточие с пробелом в незакавыченном значении (именно оно делало описание выпуска неразбираемым, пока проверка искала подстроки) |
 | `tools/refusals.js` | Каталог отказов: по строке на каждый — причина, код выхода, обязательные фразы вывода, **что отказ советует** (`advice`: `run` — команда, `template` — форма с подстановкой, `manual` — действие человека с причиной, `coveredBy` — отдан другой проверке), а для непроверяемого — почему; карты мест отказа (`SITES`, `PRINTED`) держат числа, чтобы новый отказ не появился молча, а маркеры совета — чтобы не появился молча новый совет |
 | `test/parity.test.js` | Паритет движка с эталоном: числа, артефакт, локаль |
 | `test/frozen.test.js` | Замороженная копия: та ли это ревизия, с которой снят эталон, и воспроизводит ли она его |
@@ -496,9 +509,10 @@ deльт задан один раз и по артефакту: рост зел
 | `test/guard.test.js` | Разбор модуля: идёт потоком, оба пути дают один вердикт, отступление работает без файла потока, сотни разборов дешевле запуска |
 | `test/runner.test.js` | Чтение вывода процесса: куски склеиваются буферами, а не приклеиваются к строке — многобайтовый символ на границе кусков не превращается в два символа-заменителя |
 | `test/git-pins.test.js` | Сторож границы git: прямых вызовов git без общего списка закреплений нет, и незакреплённое чтение показывается свидетелем (путь кавычками) |
-| `test/docs-paths.test.js`, `test/docs-commands.test.js`, `test/docs-numbers.test.js`, `test/docs-pin.test.js` | Сторож документации, по файлу на обещание: пути и таблица файлов; зовы, причины отказа и адреса разделов; числа проверок и цели по времени; пин в примере установки |
+| `test/docs-paths.test.js`, `test/docs-commands.test.js`, `test/docs-numbers.test.js`, `test/docs-pin.test.js` | Сторож документации, по файлу на обещание: пути и таблица файлов; зовы, причины отказа и адреса разделов; числа проверок; пин в примере установки |
 | `test/changelog.test.js` | Сторож выпуска: версия в `CHANGELOG.md` — версия манифеста, а таблица «что изменится в числах» — это замер на фикстуре, сверенный с живым прогоном |
-| `test/suites.test.js` | Сторож разделения набора: полнота классификации (быстрый — явно, полный — с причиной), потолок стоимости быстрого файла, что быстрый прогон остаётся частью набора |
+| `test/release.test.js` | Сторож выпуска из CI: он начинается тегом, версия берётся из манифеста, секрета и одноразового кода не требует, prerelease не уезжает в `latest`, перед публикацией идёт полный набор — и подсказка на npmjs.com называет этот же файл |
+| `test/suites.test.js` | Сторож разделения набора: полнота классификации (быстрый — явно, полный — с причиной), причина у каждого файла, что быстрый прогон остаётся частью набора |
 | `test/check.test.js` | Полнота и объяснение на настоящих коммитах фикстуры: непокрытый путь, «только отчёт», «число не сдвинулось», «мимо колонок», слияние — и что починка настроек не двигает числа |
 | `test/doctor.test.js` | Диагностика на пяти состояниях проекта: без настроек (2), полное покрытие (0), неполное (1), обрезанная история (3), нет датчика (4) — и блок покрытия равен ответу `size check`, а не считается вторым разом |
 | `test/hook.test.js` | Хуки на свежем клоне: ставятся только командой, дают отдельный коммит отчёта (в том числе после слияния), повторный запуск молчит, чужая работа и индекс не тронуты, в CI и при отказе инструмента ничего не делают, снятие возвращает проект к прежнему |
@@ -555,16 +569,23 @@ JSX и TSX          выход зависит от настройки jsx сам
 ### 1. Установка
 
 ```bash
-pnpm add -D github:vernikr/size-report#v1.1.1
+pnpm add -D @vernikr/size-report
 ```
 
-`npm i -D` и `yarn add -D` принимают ту же ссылку. **В npm пакет не опубликован**,
-поэтому `pnpm add -D @vernikr/size-report` не сработает. Репозиторий публичный, и
-учётных данных установка не требует: `github:` pnpm разрешает в архив
-`codeload.github.com` и тянет его по HTTPS.
+Пакет **опубликован в реестре**, и публично: `npm view @vernikr/size-report
+version` отвечает `1.1.1`, `npm access get status @vernikr/size-report` — `public`,
+а анонимный запрос тарболла — код 200. `npm i -D` и `yarn add -D` принимают то же
+имя; ни ключа, ни ссылки на репозиторий не нужно.
+
+Тот же выпуск можно взять ссылкой на репозиторий — так установка не зависит от
+реестра, но остаётся привязанной к ревизии:
+
+```bash
+pnpm add -D github:vernikr/size-report#v1.2.0
+```
 
 Без сети (или если тянуть из codeload нечем) — тарболл: `pnpm pack` в клоне
-пакета, затем `pnpm add -D ./vernikr-size-report-1.1.1.tgz`.
+пакета, затем `pnpm add -D ./vernikr-size-report-1.2.0.tgz`.
 
 **Почему тег, а не sha.** Короткий sha pnpm разрешает только через видимые рефы, а
 `git ls-remote` отдаёт одни верхушки веток: пока ревизия — верхушка, короткий sha
@@ -591,11 +612,11 @@ pnpm add -D github:vernikr/size-report#v1.1.1
 GIT_SSH_COMMAND=false`): установка 3,4 с, дальше `size --write` и `size` работают
 (`WORKLOG.md` §44). Прежнее требование было ценой приватности: локально — ключ, а
 в CI — read-only deploy key перед `pnpm install` (то самое первое подключение,
-`WORKLOG.md` §18); шаг с ключом из шаблона ушёл вместе с приватностью. Что
-остаётся на потом — публикация в npm (`PLAN.md` §8.4), и там есть цена: имя
-`size-report` в npm занято чужим пакетом (2017 год, три версии), поэтому
-публикация — это имя в области владельца (`@vernikr/size-report`), а не выкладка
-под прежним именем; что затронуло переименование — `PLAN.md` §10.
+`WORKLOG.md` §18); шаг с ключом из шаблона ушёл вместе с приватностью. Публикация
+в npm сделана 2026-09-15, и у неё была цена: имя `size-report` в реестре занято чужим
+пакетом (2017 год, три версии), поэтому выкладка — это ещё и смена имени на имя в
+области владельца (`@vernikr/size-report`), а не только отправка архива; что
+затронуло переименование — `PLAN.md` §10, чем доказана выкладка — `WORKLOG.md` §53.
 
 ### 2. Черновик настроек
 
@@ -603,9 +624,18 @@ GIT_SSH_COMMAND=false`): установка 3,4 с, дальше `size --write`
 pnpm exec size --init      # создаёт size-table.config.json
 ```
 
-Черновик собирается по самому проекту: колонки — крупнейшие файлы каждого
-расширения, журнал — по знакомым именам (`WORKLOG.md`, `CHANGELOG.md`, …), вывод —
-в `docs/`, если он есть, `fixCommand` — под ваш менеджер пакетов. Он же печатает
+Черновик собирается по самому проекту: колонки — крупнейшие файлы по списку
+расширений исходников (список печатается тут же — «расширения в проекте»), журнал —
+по знакомым именам (`WORKLOG.md`, `CHANGELOG.md`, …), вывод — в `docs/`, если он
+есть, `fixCommand` — под ваш менеджер пакетов.
+
+> **Документации в черновике нет, и это заметно сразу.** Список расширений —
+> исходники (`.js`, `.css`, `.json`, …), а `README.md` и журнал в него не входят:
+> колонкой доки делает человек, потому что «важный документ» — не про расширение.
+> Поэтому первый же `size check` на проекте с README и журналом честно скажет, что
+> эти пути не отслеживаются и не исключены (код 1), — это и есть тот шаг, где доки
+> становятся колонками или попадают в `skip` (`§5`). Проверено покомандно на
+> живом проекте: `WORKLOG.md` §54. Он же печатает
 следующие три шага. Черновик ведёт метрику `min` на настоящее сжатие
 (`"minify": {"engine": "esbuild"}`) и сразу включает метрику `tok`
 (`"tokens": {"family": "openai", "encoding": "o200k_base"}`): и минификатор, и
@@ -723,7 +753,7 @@ pnpm exec size doctor     # 0 — делать нечего; иначе перв
 | 1 | таблица разошлась с историей (или правка на диске не закоммичена); у `size check` — путь истории не отслеживается и не исключён | `pnpm run sizes` и закоммитить таблицу; для `check` — дописать путь колонкой или в `skip` |
 | 2 | что-то в вызове или в проекте — **командная строка** (незнакомый ключ, ключ без значения, повтор ключа, два режима сразу, лишнее слово, команда и режим, неизвестная команда, несовместимый ключ, нет ответа в JSON, два ответа сразу, нет коммита); **настройки и проект** (нет файла настроек, настройки не разобраны, настройки неверны, нет git, не git-репозиторий, конфиг уже есть); **история** (нет такого коммита, коммит назван неточно, коммит вне истории); **хук** (чужой хук, чужой core.hooksPath, нечем звать инструмент); **измерение** (файл не JavaScript, минификатор не разобрал) | текст отказа называет причину и готовую команду — и она выполнима: это сторожит `test/refusals.test.js` |
 | 3 | неполная история (clone с `--depth`) | полный клон: `git fetch --unshallow` |
-| 4 | нет датчика | `minify.engine: "esbuild"`, а минификатора нет: числа получены упрощением. Отчёт собран, причина и починка — в тексте |
+| 4 | нет датчика | `minify.engine: "esbuild"`, а минификатора нет: числа получены упрощением. Отчёт собран, причина и починка — в тексте; если при этом таблица расходится с историей, код остаётся **1** (нарушение старше приближения), а заметка о другом счёте печатается рядом |
 | 5 | внутренняя ошибка | это дефект инструмента: текст нужен нам, см. «Ловушки» ниже |
 
 ### 6. Отчёт обновляется сам после коммита (по желанию)
@@ -768,7 +798,17 @@ pnpm exec size uninstall-hook   # снять и вернуть проект к
   при упрощении — `minify.guard`. Стеком такой случай не выглядит ни там, ни там;
 - **Минификатора нет** (установка без необязательных зависимостей, платформа без
   `esbuild`) — метрика честно отступает к упрощению: числа те же, что у `strip`,
-  способ говорит об этом словами, а прогон отдаёт **код 4** с готовой починкой.
+  способ говорит об этом словами, а **сборка** (`--write`) отдаёт **код 4** с
+  готовой починкой. У **проверки** в этом случае ответ из двух частей, и он назван
+  здесь потому, что именно её советует CI: если отчёт на диске собран с настоящим
+  минификатором, а прогон идёт без него, точность изменилась — значит числа в
+  таблице больше не совпадают с историей, и проверка скажет про расхождение
+  (**код 1**), показав разошедшуюся строку подписи, **и тут же назовёт другой счёт**
+  заметкой с готовой починкой. Вердикт при этом остаётся за расхождением: код 4
+  утверждал бы, что разница объясняется датчиком, а это никто не проверял —
+  расхождение может быть и правкой мимо отчёта (тот же порядок, что у `size check` и
+  у `doctor`: нарушение старше приближения). Починка в обоих случаях — `pnpm run
+  sizes`; на этом окружении она вернёт **код 4**.
   Проверить это без переустановки можно окружением `SIZE_REPORT_NO_OPTIONAL=1` —
   тем же приёмом это делает `test/minify.test.js`;
 - **Разбор модуля — рабочий поток, поднятый один раз на прогон** (`REFACTOR.md`
@@ -876,7 +916,7 @@ pnpm test                      # быстрый прогон (каждая пр
                                # контракт данных и страница, сторож документации и выпуска
 pnpm test:all                  # полный прогон (выкладка и CI): то же плюс интеграционные —
                                # сборка на дисках, сверка с деревом, хуки, метрики
-pnpm run suites:measure        # перемерить стоимости файлов набора
+pnpm run suites:measure        # замерить длительность каждого файла набора
 pnpm run parity:live           # паритет с живым проектом на клоне, две среды
 node bin/size.js --data        # контракт данных: страница и агент
 node bin/size.js --page        # минимальная страница отчёта

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vernikr/size-report",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "author": "vernikr",
   "repository": {
     "type": "git",

package/src/cli.js

@@ -39,6 +39,17 @@ function sensorNote(cfg) {
   return note(sensorGaps(cfg));
 }
 
+/* Вердикт режима вместе с заметками о датчиках: заметка печатается всегда — молчание
+ * о другом счёте читается как точное число, и расхождение остаётся без причины, — а
+ * код остаётся первым по важности. Нарушение старше приближения (тот же порядок, что
+ * у `size check` и у `doctor`): код 4 говорит «числа честные, но другим счётом», а
+ * когда таблица расходится, этого никто не проверял — расхождение может быть и
+ * настоящей правкой мимо отчёта. */
+function verdict(code, gaps) {
+  const sensors = note(gaps);
+  return code === EXIT.OK ? sensors : code;
+}
+
 export function check(cfg, want, root) {
   const out = path.join(root, cfg.output);
   if (!fs.existsSync(out)) {
@@ -89,9 +100,8 @@ function checkMode(cfg, root) {
   if (code === 0) {
     console.log('✓ таблица размеров: ' + rows.length + ' коммитов × ' + cfg.columns.length + ' файлов '
       + 'совпадает с историей (' + cfg.output + ', ' + kmb(byteLen(html)) + ')');
-    return sensorNote(cfg);
   }
-  return code;
+  return verdict(code, sensorGaps(cfg));
 }
 
 /* Полнота покрытия (`size check`): настройки, история, пути, датчики. Не путать с
@@ -104,8 +114,7 @@ function coverageMode(cfg, root, configFile, asJson) {
   const rep = coverage(cfg, root, configFile);
   if (asJson) process.stdout.write(JSON.stringify(rep, null, 2) + '\n');
   else console.log(coverageText(rep));
-  if (!rep.ok) return EXIT.VIOLATION;
-  return note(rep.sensors);
+  return verdict(rep.ok ? EXIT.OK : EXIT.VIOLATION, rep.sensors);
 }
 
 /* Диагностика одним ответом (`size doctor`): окружение, зависимости, настройки и

package/templates/README.md

@@ -17,10 +17,12 @@
 `size-table.config.json`. **Колонки в нём — пример**, а не список ваших файлов:
 в шаблоне стоят `README.md` и `package.json`, потому что они есть почти в любом
 проекте, и с ними первый отчёт соберётся сразу. Свои колонки даёт
-`size --init` (он подбирает крупнейшие файлы по расширениям) — можно взять его
-черновик целиком, а из шаблона перенести ключи, которых `--init` не пишет
-(`skip`, `rows`, `links.commitUrl`), или наоборот: скопировать шаблон и вписать
-колонки руками.
+`size --init` (он подбирает крупнейшие файлы по списку расширений исходников; доки
+в этот список не входят) — можно взять его черновик целиком, а из шаблона
+перенести ключи, которых `--init` не пишет (`skip`, `rows`, `links.commitUrl`),
+или наоборот: скопировать шаблон и вписать колонки руками. Отсюда же растёт
+ожидаемое: колонки примерные, поэтому `size check` на свежем проекте скажет, что
+README и журнал колонкой не отслеживаются, — так и задумано.
 
 Что стоит знать про значения шаблона: