@vernikr/size-report 1.1.1

package/CHANGELOG.md

@@ -0,0 +1,241 @@
+# CHANGELOG
+
+История выпусков `@vernikr/size-report`. Версии — SemVer (`PLAN.md` §8.2); версия данных —
+`schema: 1`, она заморожена выпуском 1.0.0 и меняется только вместе с MAJOR.
+
+## Что значит «изменились числа»
+
+Числа этого инструмента — его продукт, а не отладочная печать: у каждой метрики есть
+источник (`raw` — размер объекта git, `min` — сжатая форма, `tok` — токены) и есть
+честность (точный счёт или приближение с пометкой). Поэтому у выпуска обязателен
+раздел «Что изменится в числах»: он отвечает, **у кого числа поедут и почему**.
+Выпуск, после которого число меняется молча, — дефект этого инструмента, а не выпуск.
+
+Замеры в этих разделах сняты на фикстуре пакета — `fixtures/synthetic/history.bundle`,
+16 коммитов и 10 колонок, состояние на её верхушке. Таблица выпуска не пересказ: её
+сверяет с живым прогоном инструмента `test/changelog.test.js`, а повторить замер
+руками можно, склонировав бандл и прогнав `node bin/size.js --config <настройки> --data`,
+где за основу взяты `fixtures/synthetic/config.json`, метрики — `raw`, `min`, `tok`, а
+способ минификации — `strip` или `esbuild`.
+
+## 1.1.1 — 2026-09-15
+
+Выпуск имени, а не измерения: пакет переехал в область владельца
+(`@vernikr/size-report`) — имя `size-report` в реестре занято чужим пакетом, и
+опубликоваться под ним было нельзя (`PLAN.md` §10). Заодно в поставку вошёл файл
+лицензии, которого манифест обещал, а в дереве не было.
+
+- **Имя пакета — `@vernikr/size-report`.** `bin` остался `size`, установка —
+  `pnpm add -D @vernikr/size-report`, зов — `pnpm exec size`.
+- Тот же выпуск закрывает три правки после 1.1.0: совет отказа проверяется
+  исполнением, а не на слово (`REFACTOR.md` R-4.22), якорь фикстуры выведен из
+  дерева в историю (R-1.5, R-3.4) и числа переименования в `PLAN.md` §10 сверены
+  с фактом.
+- **Имя инструмента в данных (`--data`) совпадает с именем пакета** — оно же
+  входит в паспорт отчёта, от которого зависят ключ памяти страницы и якорь
+  ссылки. Поэтому у отчёта, пересобранного этим выпуском, **сохранённый выбор
+  читателя в браузере не подхватится один раз**: запись прошлого выпуска лежит
+  под другим ключом. Числа и разметка от этого не меняются, а первый читатель и
+  так видит умолчание.
+- В поставку добавлен `LICENSE` (MIT) — манифест называл лицензию, а файла в
+  тарболле не было.
+
+### Что изменится в числах
+
+**Ничего.** Это не обещание, а замер: таблица ниже снята выпуском 1.1.1 и
+совпадает с таблицей 1.1.0 до последней клетки — измерение этот выпуск не трогает
+вовсе, а правки лежат в имени пакета, текстах отказов и выводе якоря фикстуры.
+Доказано не словом: вывод `--json` и артефакт побайтово равны замороженному
+эталону на фикстуре и на живой истории проекта-потребителя, а его закоммиченная
+таблица пересобирается в те же байты (`sha256 863ce3e9…`).
+
+| Файл | 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.0.0 и 1.1.0, и читаются так же: `raw` — размер объекта
+git; `min` со `strip` — упрощение, под которым снят эталон паритета; `min` со
+`esbuild` — то, что даёт настоящий минификатор (`minify.engine`); `tok` — словарь
+`o200k_base` с `gpt-tokenizer 4.0.0`. У проекта прежние настройки означают
+`strip`, поэтому обновление «само» чисел не меняет. gzip в выпуск по-прежнему не
+входит (`PLAN.md` §10, D4).
+
+## 1.1.0 — 2026-09-15
+
+Первый выпуск после 1.0.0, и в нём **ни одной правки измерения** — только то, что
+нашлось живыми прогонами после выпуска, все в ответах инструмента человеку.
+
+- `explain` понимает то, чем коммиты зовут на самом деле: `HEAD`, ветку, тег,
+  `HEAD~1`, полный и короткий sha. Раньше имя ревизии выглядело как несуществующий
+  коммит («в истории нет коммита «HEAD»») — то есть отказ называл не ту причину.
+  Коммит вне истории отчёта теперь отдельная причина с названным sha.
+- У отказов появился **каталог и сторож** (`tools/refusals.js`): по строке на
+  каждый отказ с кодом выхода и обязательными фразами, карты мест отказа держат
+  числа, а две проверки делят обе половины обещания — одна вызывает отказ, другая
+  требует у каждого места пункт каталога. Новый отказ не может появиться без
+  проверки. Заодно исправлены шесть мест, где текст врал или молчал о починке, и
+  появилась одна новая причина: **`нет git`** — раньше «git не запустился» и
+  «здесь нет репозитория» назывались одним текстом с оговоркой «или», то есть не
+  назывались вовсе.
+- Проверка настроек отвергает колонку, у которой путь — не непустая строка
+  (`"paths": [123]`): раньше такая колонка ни с чем не совпадала, а отчёт отдавал
+  нули **за успех**.
+- `--init` в каталоге без знакомых расширений больше не печатает «✗» при коде
+  выхода 0: знак и код говорили разное.
+- **Репозиторий пакета стал публичным**, поэтому установка не требует ни ключа,
+  ни токена, ни шага в CI: `github:` pnpm разрешает в архив `codeload.github.com`
+  по HTTPS (`WORKLOG.md` §44).
+
+### Что изменится в числах
+
+**Ничего.** Это не обещание, а замер: таблица ниже снята выпуском 1.1.0 и совпадает
+с таблицей 1.0.0 до последней клетки — метрики, настройки по умолчанию и датчики те
+же, а правки этого выпуска лежат в текстах отказов, разборе аргументов командной
+строки и проверке настроек, куда измерение не заходит. Доказано не словом: вывод
+`--json` и артефакт побайтово равны замороженному эталону на фикстуре и на живой
+истории проекта-потребителя, а его закоммиченная таблица (211 КБ) тем же выпуском
+пересобирается в те же байты (`sha256 863ce3e9…`).
+
+| Файл | 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.0.0, и читаются так же: `raw` — размер объекта git (ни от
+чего, кроме него, не зависит); `min` со `strip` — умолчание, под которым снят
+эталон паритета; `min` со `esbuild` — то, что даёт настоящий минификатор, если его
+включить (`minify.engine`); `tok` — словарь `o200k_base` с `gpt-tokenizer 4.0.0`.
+У проекта прежние настройки означают `strip`, поэтому обновление «само» чисел не
+меняет; способ `esbuild` остаётся осознанным решением того, кто его включает.
+gzip в выпуск по-прежнему не входит (`PLAN.md` §10, D4).
+
+## 1.0.0 — 2026-09-14
+
+Первый выпуск: инструмент вынесен из проекта-потребителя в отдельный пакет
+(`PLAN.md` §5, шаги 0–5) — раньше он жил копией внутри чужого репозитория. Выпусков
+до него не было: версия в манифесте стояла `0.0.0`, а работа шла внутри этого
+репозитория (`WORKLOG.md`, `REFACTOR.md`, `PLAN.md`); номера `0.1.0`–`0.5.0` в
+`PLAN.md` §12 — план выпусков, а не их история.
+
+Версия `1.0.0` — не про объём изменений, а про заморозку: `schema: 1` данных этой
+версией объявлена стабильной, и сломать её теперь можно только MAJOR-выпуском с
+миграцией. Версия инструмента попадает в данные (`tool.version`), версии
+минификатора и словаря — в способ получения числа, поэтому «числа этого выпуска» —
+это числа с `esbuild 0.28.2` и `gpt-tokenizer 4.0.0` в тех разрезах, где они
+задействованы.
+
+### Что изменится в числах
+
+Замер на фикстуре, состояние на HEAD (`now`), метрики `raw`, `min`, `tok`, словарь
+`o200k_base`:
+
+| Файл | 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** |
+
+- **У проекта с прежними настройками не поедет ничего.** Существующие конфиги
+  `minify.engine` не задают, а умолчание — `strip`: те же комментарии и отступы, те
+  же имена, те же байты, что у инструмента до этого выпуска. Это доказано не словом:
+  вывод `--json` и собранный артефакт совпадают побайтово с замороженным эталоном —
+  на фикстуре и на живой истории проекта-потребителя (`fixtures/synthetic/`,
+  `fixtures/parity/`, проверки `test/parity.test.js`, `test/frozen.test.js`).
+- **`raw` не зависит ни от чего, кроме объекта git**: это его размер, содержимое
+  файла для этой метрики не читается вовсе. Ни настройки, ни способ минификации, ни
+  версия инструмента на него не влияют.
+- **`min` со `esbuild` меньше**, чем со `strip`, и это единственное, что меняет
+  числа, если включить настоящее сжатие: имена сокращены, пробелы убраны. На фикстуре
+  итог 1597 → **1483** (−7 %), по файлам — **−33 %** на `code.js` (276 → 185) и
+  **−22 %** на `style.css` (55 → 43). Для форматов, которых минификатор не берёт
+  (`.md`, `.txt`, `.toml`, `.json`), число то же, что со `strip`: 303, 60, 299, 69.
+  Именно поэтому метрика помечена приближением **целиком**: точность колонки
+  считается по худшей клетке, а не по большинству (пометка стоит и у отдельной
+  клетки — `test/minify.test.js`). Способ `esbuild` ставит `--init` новым проектам;
+  перевод существующего проекта на него — осознанное решение, а не побочный эффект
+  обновления.
+- **`tok` — число новое, сравнивать его не с чем**: метрики не было у прежнего
+  инструмента, это не «изменилось», а «появилось». Точный счёт словарём даёт на
+  фикстуре **540**; та же фикстура без словаря считается оценкой по длине
+  (1 токен ≈ 3 знака) и даёт **583** — число другое, поэтому оно помечено
+  приближением, а прогон отдаёт **код 4**, а не зелёный успех
+  (`SIZE_REPORT_NO_OPTIONAL` воспроизводит установку без необязательных
+  зависимостей).
+- **Без `esbuild`** `min` отступает к `strip`: те же 1597, с пометкой приближения и
+  кодом 4. Числа от этого не ломаются, но и не выдаются за сжатие.
+- **`gzip` в 1.0.0 не поставляется**: метрики нет ни в черновике настроек, ни в
+  документации; в реестре она пока принимается, а её удаление — `PLAN.md` §10 (D4),
+  изменение поведения, а не перенос.
+- **Окружение машины на числа не влияет — и это тоже изменение**, относительно
+  инструмента до этого выпуска: он читал пути и переводы строк так, как настроена
+  машина, и на установке Git «по умолчанию» либо давал неверные числа, либо падал
+  вовсе (`BLOCKERS.md` §B1, §B2, §N10). Теперь вывод одинаков в любой среде, и это
+  доказывается прогоном с погашенными настройками машины (`GIT_CONFIG_GLOBAL=/dev/null`).
+
+### Что вошло
+
+- Три метрики: `raw` (размер объекта git), `min` (в двух способах — снятие балласта
+  и настоящее сжатие через `esbuild`), `tok` (токены выбранного словаря). Числа
+  абсолютные, производные (дельты, суммы, фильтры) считает страница.
+- Интерактивный отчёт: дерево файлов, категории, переключение метрик, память выбора
+  между открытиями и передача выбора ссылкой; страница — один самодостаточный файл,
+  открывается с диска без сети.
+- Команды: сборка отчёта, сверка с историей (`size check`), объяснение пропущенной
+  строки (`size explain <sha>`), диагностика (`size doctor`), установка и снятие
+  хука автообновления отчёта, `--init` с черновиком настроек.
+- Шаблоны для подключаемого проекта: черновик настроек и описание проверки для CI.
+- Сторожа, которыми проверяется не код, а обещания: паритет с замороженным эталоном,
+  живая история, работа из собранного пака, утверждения документации, закрепления
+  настроек git на границе вызова.
+
+### Исправлено
+
+- Молчание при опечатках и в несовместимых сочетаниях ключей: неизвестное слово,
+  лишнее слово, два режима сразу, ключ без значения и `--json` там, где ответа в
+  JSON нет, — теперь отказ с названным виновником и готовой командой, а не код 0 с
+  чужой работой.
+- Колонка, чей файл жил в истории и был удалён до HEAD, роняла прогон с бессмысленным
+  текстом отказа; выбор пути перестал зависеть от настроек переименований
+  (`BLOCKERS.md` §B3, §N8).
+- Зависимость чисел от окружения машины (`BLOCKERS.md` §B1, §B2, §N10).
+
+### Не входит в 1.0.0
+
+- `docs/METHODS.md`, `docs/DATA-FORMAT.md`, `docs/ARCHITECTURE.md` — документация
+  пакета из `PLAN.md` §8.3; сегодня роль каждого числа описана в `README.md`.
+- Кэш замеров, разделение быстрого и медленного наборов проверок, профиль на истории
+  в пару тысяч коммитов — `PLAN.md` §5, шаг 6.
+- Удаление метрики `gzip` из реестра (`PLAN.md` §10, D4) и лицензионный файл
+  (открытый вопрос §10).
+- Поставка `dist/app.js` (пре-собранная программа отчёта) и публикация в npm:
+  установка идёт git-зависимостью из публичного репозитория (публичным он стал
+  2026-09-14, `WORKLOG.md` §44), а в npm пакет не опубликован — `PLAN.md` §8.4.
+- Минификация разметки (HTML), JSX/TSX и другие семейства токенизаторов, кроме
+  `openai`: у них нет своего словаря, а считать чужим — выдавать догадку за число.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vernikr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.