@vernikr/size-report 1.3.1 → 2.0.0

package/CHANGELOG.md

@@ -18,6 +18,52 @@
 где за основу взяты `fixtures/synthetic/config.json`, метрики — `raw`, `min`, `tok`, а
 способ минификации — `strip` или `esbuild`.
 
+## 2.0.0 — 2026-09-15
+
+Один отчёт вместо двух, и он же появляется сам: форма отчёта сведена к одному
+файлу, а обновление — к одному решению (хук ставится сам).
+
+- **Отчёт — один файл: самодостаточная страница `size-report.html`.** Данные,
+  оформление и программа лежат в нём же; внешних ссылок нет. Прежние две формы
+  (статическая таблица и рядом страница) убраны вместе с их кодом (`src/render.js`,
+  `src/artifact.css`): два вывода одной истории расходились бы молча, а выбрать,
+  какой верный, было бы нечем. Колонка движка — это файл, значит и отчёт — файл.
+- **Запись одна: `--write [файл]`** (прежняя `--page` убрана — это ломающее
+  изменение). Значение ключа пишет отчёт по названному пути (каталог создаётся сам)
+  и становится его же `output`: отчёт называет себя тем путём, по которому лежит.
+- **По умолчанию — `docs/size-report.html`**, если каталог `docs/` в проекте есть,
+  иначе в корне. Имя больше не выводится из настроек: файл это и есть отчёт.
+- **Хук ставится сам** — после постановки пакета (`bin/postinstall.js`) и при первом
+  запуске в проекте. Поэтому `docs/` с отчётом появляется первым же коммитом, без
+  ручного шага; ставится там, где это безопасно (обычный `.git/hooks`, нет чужого
+  хука, есть чем звать инструмент, не CI), и там же молчит, где нельзя.
+- Коммит отчёта виден в хуке как раньше: отдельным коммитом, только этим путём.
+  Отчёт остаётся **неподвижной точкой** — список пропущенных коммитов в файл не
+  идёт (он меняется от коммита самого отчёта), и хук не коммитит его бесконечно;
+  читателю этот список по-прежнему доступен: `--data`, `--json`, `size explain`.
+
+### Что изменится в числах
+
+**Ничего.** Измерение не тронуто: те же датчики, те же способы, те же колонки. Что
+меняется у потребителя — **форма файла и его путь**: `size` (проверка) на прежнем
+файле будет красным, пока отчёт не пересобран, а скрипты, звавшие `--page`,
+получат отказ с названным ключом. Таблица ниже та же, что у 1.3.1, до последней
+клетки.
+
+| Файл | 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.3.1 — 2026-09-15
 
 Правка раскладки страницы: на широком экране панель выбора встаёт слева от таблицы.

package/README.md

@@ -10,11 +10,14 @@
 
 ## Статус
 
-**Выпуск 1.3.1 (2026-09-15).** Инструмент живёт отдельным пакетом: имя в
+**Выпуск 2.0.0 (2026-09-15).** Инструмент живёт отдельным пакетом: имя в
 реестре — `@vernikr/size-report` (публикуется тегом из CI, без секрета). Настроек
 проект может не заводить вовсе: без файла инструмент выводит их из самого проекта и
 говорит об этом строкой, а `--init` закрепляет выведенное файлом (чем этот шаг
-отличается от прежнего — `CHANGELOG.md` 1.3.0).
+отличается от прежнего — `CHANGELOG.md` 1.3.0). Отчёт — **один файл**,
+самодостаточная страница `docs/size-report.html`, и он появляется сам: хук обновления
+ставится после установки пакета и при первом запуске (чем это отличается от двух
+файлов прежних выпусков — `CHANGELOG.md` 2.0.0).
 Версия — в манифесте, а у выпуска есть `CHANGELOG.md` с разделом «Что изменится
 в числах»:
 таблица чисел в нём не пересказ, а замер на фикстуре, который сверяется с живым
@@ -67,7 +70,7 @@
 
 **Шаг 2 начат первым срезом — контрактом данных.** Движок отдаёт абсолютные
 значения и устройство таблицы (`--data`), а дельты, суммы, «сейчас» и фильтры
-считает страница (`--page`, `size-report.html` рядом с таблицей): без этого
+считает страница (она же и есть отчёт — `size-report.html`): без этого
 фильтры и «итого по выбору» невозможны в принципе. В контракте едет и точность
 числа — рядом пометок `approx` по клеткам, — потому что это факт замера, а не
 вывод: страница показывает то, что сказал движок, и своего правила точности не
@@ -216,10 +219,10 @@
 
 | Прогон | Команда | Проверок |
 |---|---|---|
-| Быстрый — каждая правка | `pnpm test` | **65 из 167** |
-| Полный — выкладка и CI | `pnpm test:all` | **167** |
+| Быстрый — каждая правка | `pnpm test` | **65 из 168** |
+| Полный — выкладка и CI | `pnpm test:all` | **168** |
 
-Ни одна проверка не потеряна и не ослаблена: полный прогон запускает все 167 теми же
+Ни одна проверка не потеряна и не ослаблена: полный прогон запускает все 168 теми же
 файлами, а быстрый берёт их часть. Умолчание — полный: файл становится быстрым только
 явно и с причиной, поэтому новое дорогое не может тихо уехать в быстрый. Стерегут это
 объявление `test/suites.test.js` (полнота классификации и причина у каждого файла) и
@@ -432,8 +435,8 @@ deльт задан один раз и по артефакту: рост зел
 профиль ведёт новые проекты сразу на токены.
 
 **Волна 0 чистки пройдена** (`REFACTOR.md`): у отказов командной строки появились
-коды выхода и справка вместо стека, `--help` отвечает, `--page` и `--write`
-создают недостающий каталог, подсказка в отказе ведёт к работающей команде, а
+коды выхода и справка вместо стека, `--help` отвечает, `--write`
+создаёт недостающий каталог, подсказка в отказе ведёт к работающей команде, а
 вывод настроек больше не предлагает колонкой саму таблицу — иначе первая же
 проверка настроек его отвергала.
 
@@ -484,8 +487,8 @@ deльт задан один раз и по артефакту: рост зел
 | `tools/parity-freeze.js` | Снимает эталон паритета (`pnpm run parity`): замороженной копией, на ревизии проекта из манифеста — `--json`, конфиг, хеш артефакта, хеш инструмента |
 | `tools/make-fixture.js` | Собирает синтетическую фикстуру (`pnpm run fixture`): детерминированную историю с ловушками плюс эталонные числа |
 | `tools/synthetic/` | Сюжеты той сборки по предметам: `repo.js` — как говорим с git (закреплённые время, автор, настройки), `content.js` — что лежит в файлах, `history.js` — какие коммиты из этого получаются, `note.js` — записка к фикстуре со списком ловушек |
-| `tools/parity-live.js` | Сверяет движок с живым проектом на клоне: числа и артефакт (`pnpm run parity:live`) |
-| `tools/pack-check.js` | Собирает тарболл и проверяет, что из него всё работает: все исходники доехали, числа, артефакт и страница — как из репозитория (`pnpm run pack:check`) |
+| `tools/parity-live.js` | Сверяет движок с живым проектом на клоне: числа и самодостаточный отчёт по пути из настроек потребителя (`pnpm run parity:live`) |
+| `tools/pack-check.js` | Собирает тарболл и проверяет, что из него всё работает: все исходники доехали, числа и отчёт — как из репозитория (`pnpm run pack:check`) |
 | `tools/check-standards.js` | Проверяет, что оба эталона воспроизводятся: пересъём идёт в никуда и сверяется с закоммиченным (наши файлы — побайтово, бандл — по содержимому) и что бандл живой истории несёт `HEAD` (`pnpm run check:standards`) |
 | `.github/workflows/ci.yml` | CI: работа `verify` на каждый пуш и запрос правки зовёт `pnpm run verify` — тот же профиль, что локально; действия закреплены по SHA коммита |
 | `.github/workflows/verify-slow.yml` | Slow-профиль по расписанию: то же плюс покрытие под c8 — дорогое не в каждом прогоне |
@@ -497,6 +500,7 @@ deльт задан один раз и по артефакту: рост зел
 | `tools/gates/gatefiles.js` | Защита гейт-файлов: правка порогов, баз и обвязки без трейлера `Gate-Change:` — красный (хук `commit-msg` и CI по диапазону) |
 | `tools/gates/common.js`, `tools/gate-probe.js` | Общее у датчиков (корень, разбор ключей, отчёты) и обвязка их проб: датчик зовётся командой, а не импортом |
 | `.githooks/commit-msg`, `.githooks/pre-commit`, `.githooks/pre-push` | Хуки: защита гейт-файлов, быстрый профиль на правку и перед отправкой; ставятся `pnpm run hooks:install` (свой менеджер хуков не заводится) |
+| `.githooks/post-commit` | Обновление отчёта после коммита: зов установленной копии пакета (строка вписана человеком — инструмент чужие каталоги хуков не правит) |
 | `eslint.metrics.config.js`, `.eslint-suppressions.json` | Правила датчика раздувания и его база: пороги из замеров, всё, что выше, — в базе и разбирается постепенно |
 | `.jscpd.json`, `dup-baseline.json` | Настройки и база датчика дублей: отпечаток считается по содержимому клона, поэтому база переносима |
 | `.dependency-cruiser.cjs`, `.c8rc.json`, `coverage-baseline.json` | Правила графа связей, настройки снятия покрытия и его база по файлам |
@@ -504,16 +508,15 @@ deльт задан один раз и по артефакту: рост зел
 | `.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 коммитов, её конфиг, эталонные числа и хеш артефакта |
+| `fixtures/synthetic/` | Бандл фикстуры на 16 коммитов, её конфиг, эталонные числа (`--json` прежней копии) и хеш её артефакта прежней формы — запись того, с чем сверялся перенос |
 | `fixtures/live/history.bundle`, `fixtures/live/README.md` | История проекта-потребителя на ревизии эталона `bd6ef9d` и записка о том, какую ревизию бандл несёт и почему он лежит в репозитории: живая сверка работает без доступа к приватному проекту |
 | `bin/size.js` | Команда `size`: то, что ставит пакет (`package.json` → `bin`); сама ничего не считает, только зовёт точку входа |
 | `LICENSE` | MIT: условия лицензии едут в поставке вместе с пакетом |
 | `.gitignore`, `pnpm-lock.yaml` | Что в репозиторий не идёт; lock-файл pnpm, а версия менеджера — в поле `packageManager` (оттуда её берёт CI) |
-| `src/size-table.js` | Точка входа пакета: только реэкспорт публичного API (58 имён), ни одного расчёта |
-| `src/derived.js` | Общий расчёт отчёта: итоги, дельты, клетка, подпись коммита — одно место на артефакт и страницу |
+| `src/size-table.js` | Точка входа пакета: только реэкспорт публичного API (55 имён), ни одного расчёта |
+| `src/derived.js` | Общий расчёт отчёта: итоги, дельты, клетка, подпись коммита — один на движок и программу страницы |
 | `src/css.js` | Чтение оформления с диска: какие наборы стилей есть и какая у них роль |
-| `src/table.css` | Общая часть таблицы: геометрия клеток, липкие шапка и колонка, цвет дельт — одна на артефакт и страницу |
-| `src/artifact.css` | Оформление статического артефакта сверх общей части |
+| `src/table.css` | Таблица отчёта: геометрия клеток, липкие шапка и колонка, цвет дельт |
 | `src/page/app.css` | Оформление страницы сверх общей части: панель с деревом файлов (на широком экране — колонка слева от таблицы), состояния пустоты, узкое окно |
 | `src/page/state.js` | Состояние страницы: данные отчёта, вид галочек, паспорт записи, память браузера и обмен ссылкой — глава программы страницы |
 | `src/page/dom.js` | Узлы страницы: мелкие помощники разметки (`appEl`, `appBox`) — одни на панель и таблицу |
@@ -536,17 +539,17 @@ deльт задан один раз и по артефакту: рост зел
 | `src/check.js` | Полнота покрытия (`size check`): настройки, история, пути, датчики — что прошло мимо колонок и чем это чинится |
 | `src/explain.js` | Объяснение пропущенной строки (`size explain <коммит>`): причина, улики и готовая починка |
 | `src/doctor.js` | Диагностика одним ответом (`size doctor`): окружение, зависимости, настройки, покрытие, состояние хука — сборкой из существующих кусков |
-| `src/hook.js` | Хуки автообновления (`install-hook` / `uninstall-hook` / `hook-run`): установка и снятие, коммит только отчёта, замок и запись о запуске |
-| `src/artifact.js` | Артефакт на диске: единственное место, где отчёт превращается в файл (им пользуются и `--write`, и хук) |
+| `src/hook.js` | Хуки автообновления: постановка сама (`autoInstall` — из входа и `bin/postinstall.js`), снятие командой, коммит только отчёта, замок и запись о запуске |
+| `bin/postinstall.js` | Установка хука после постановки пакета: ищет проект-потребитель и молчит, если поставить негде |
+| `src/artifact.js` | Отчёт на диске: единственное место, где он превращается в файл (им пользуются и `--write`, и хук); отчёт — самодостаточная страница |
 | `src/journal.js` | Журнал и ссылки: к какому разделу относится коммит и куда ведёт описание |
 | `src/data.js` | Категории файлов и контракт со страницей (`--data`) |
-| `src/render.js` | Статический артефакт: клетки, таблица, примечание (стили — в `src/css.js`) |
 | `src/config.js` | Настройки проекта-потребителя: умолчания, чтение, проверка |
 | `src/project.js` | Настройки, выведенные из самого проекта (дерево и история): колонки, журнал, исключения. Без файла настроек он и есть настройки; `--init` закрепляет его файлом |
 | `src/locales.js`, `src/refusal.js`, `src/tool.js` | Тексты отчёта; коды выхода и справка; имя и версия пакета |
 | `src/cli.js` | Вход инструмента: разбор строки, чтение проекта и доставка запроса режиму; главный файл пакета |
 | `src/args.js` | Грамматика командной строки: режимы, ключи и команды плюс проверки их сочетаний — отказ называет виновника и готовую команду |
-| `src/modes.js` | Режимы: собрать таблицу, сверить её с историей, отдать данные или страницу, полноту покрытия и диагностику |
+| `src/modes.js` | Режимы: собрать отчёт, сверить его с историей, отдать данные, полноту покрытия и диагностику |
 | `src/init.js` | Закрепление настроек файлом (`--init`): то, что проект вывел о себе сам, ложится файлом — и проходит ту же проверку, что первый запуск |
 | `test/api.test.js` | Публичный API пакета: список имён заморожен, разбиение не имеет права его менять |
 | `eslint.config.js` | Правила оформления: те же, что у проекта-потребителя, плюс запрет склейки операторов в строке (`pnpm run lint`, `pnpm run lint:strict`) |
@@ -557,7 +560,7 @@ deльт задан один раз и по артефакту: рост зел
 | `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/parity.test.js` | Паритет движка с эталоном: числа, самодостаточность отчёта, локаль |
 | `test/frozen.test.js` | Замороженная копия: та ли это ревизия, с которой снят эталон, и воспроизводит ли она его |
 | `test/environment.test.js` | Герметичность: вывод не зависит от настроек git машины и локали |
 | `test/crlf.test.js` | Выкладка с CRLF (`core.autocrlf`) не мешает сверке |
@@ -639,7 +642,7 @@ pnpm add -D @vernikr/size-report
 ```
 
 Пакет **опубликован в реестре**, и публично: `npm view @vernikr/size-report
-version` отвечает `1.3.1`, `npm access get status @vernikr/size-report` — `public`,
+version` отвечает `2.0.0`, `npm access get status @vernikr/size-report` — `public`,
 а анонимный запрос тарболла — код 200. `npm i -D` и `yarn add -D` принимают то же
 имя; ни ключа, ни ссылки на репозиторий не нужно.
 
@@ -647,11 +650,11 @@ version` отвечает `1.3.1`, `npm access get status @vernikr/size-report`
 реестра, но остаётся привязанной к ревизии:
 
 ```bash
-pnpm add -D github:vernikr/size-report#v1.3.1
+pnpm add -D github:vernikr/size-report#v2.0.0
 ```
 
 Без сети (или если тянуть из codeload нечем) — тарболл: `pnpm pack` в клоне
-пакета, затем `pnpm add -D ./vernikr-size-report-1.3.1.tgz`.
+пакета, затем `pnpm add -D ./vernikr-size-report-2.0.0.tgz`.
 
 **Почему тег, а не sha.** Короткий sha pnpm разрешает только через видимые рефы, а
 `git ls-remote` отдаёт одни верхушки веток: пока ревизия — верхушка, короткий sha
@@ -659,7 +662,7 @@ pnpm add -D github:vernikr/size-report#v1.3.1
 <sha> to a commit`. Это не рассуждение, а проба: короткий пин `6530237` ставился,
 пока `main` стоял на нём, и перестал — на следующем же коммите, а тот же sha
 целиком поставился. Имя ветки (`#main`) или тег принимаются оба, но ветка —
-движущаяся цель, а тег постоянен: этот выпуск стоит на теге `v1.3.1`, он же и в
+движущаяся цель, а тег постоянен: этот выпуск стоит на теге `v2.0.0`, он же и в
 примере (сорок знаков тоже годятся, но их придётся брать глазами из истории).
 
 Ревизия в примере — не украшение, а часть утверждения: она закреплена за тем, что
@@ -719,7 +722,7 @@ stderr и называет команду, которая их закрепля
 проекту молча.
 
 > Subкоманды `size init` пока нет — CLI знает только флаги (`--init`, `--write`,
-> `--page`, `--data`, `--json`, без флага — проверка); полный список даёт `size --help`.
+> `--data`, `--json`, без флага — проверка); полный список даёт `size --help`.
 > Subкоманды — шаг 5 плана (`REFACTOR.md` R-4.5).
 
 ### 3. Что правится в конфиге
@@ -733,14 +736,14 @@ stderr и называет команду, которая их закрепля
 | `metrics` | из чего состоит число: `raw` (размер объекта git), `min` (минифицированная форма — какая именно, решает `minify.engine`), `tok` (токены), `gzip` |
 | `tokens.family`, `tokens.encoding` | словарь для `tok`: семейство (`openai`) и кодировка (`o200k_base` или `cl100k_base`) — кодировка меняет число, поэтому она и в настройках, и в подписи метрики |
 | `minify.engine` | чем считается `min`: `strip` (комментарии и отступы, точность не обещается) или `esbuild` (настоящее сжатие; форматы без минификатора — упрощение, и это видно в подписи метрики) |
-| `output` | файл таблицы (в выведенном профиле — `docs/size-table.html`, если каталог `docs/` есть, иначе в корне) |
+| `output` | файл отчёта (в выведенном профиле — `docs/size-report.html`, если каталог `docs/` есть, иначе в корне; имя отчёта — его имя, а каталог решает только где ему лежать) |
 | `journal` | где искать разделы журнала, на которые ссылаются строки |
 | `links.commitUrl` | шаблон ссылки на коммит, например `https://github.com/org/repo/commit/{sha}`; выводится из адреса `origin` у GitHub и GitLab (у остальных хозяев — пусто, а не догадка) |
 | `skip` | пути, которые колонкой не стали: и те, что ею быть не могут (сам отчёт, замки зависимостей), и те, что в колонки не поместились (выведенный профиль объявляет исключениями всё остальное — поэтому первый `check` полон) |
 | `fixCommand` | команда, которую цитирует подпись отчёта и подсказывает отказ; в выведенном профиле — ваш скрипт `sizes`, если он объявлен, иначе путь к установленному пакету внутри проекта (зов по имени пакета уходит в реестр — `REFACTOR.md` R-4.21) |
 | `locale`, `title`, `heading` | язык текстов отчёта и его заголовки; пустые `title`/`heading` значат «взять из локали» |
 | `minify.guard` | расширения, где результат стриппера проверяется разбором; модуль в `.js` гард понимает сам, трогать его не нужно |
-| `hooks.enabled` | выключатель хука автообновления (`false` — хук остаётся на месте, но молчит; убирается он только `size uninstall-hook`) |
+| `hooks.enabled` | выключатель хука автообновления (`false` — хук не ставится сам и молчит, если уже стоит; убирается он только `size uninstall-hook`) |
 
 Остальные ключи и умолчания — `src/config.js` (`DEFAULT_CONFIG`).
 
@@ -752,14 +755,13 @@ stderr и называет команду, которая их закрепля
 ```
 
 ```bash
-pnpm run sizes            # → docs/size-table.html — таблица коммитов и чисел
-pnpm exec size --page     # → docs/size-report.html — интерактивная страница
+pnpm run sizes            # → docs/size-report.html — отчёт: таблица, фильтры, ссылка
 ```
 
-Оба отчёта — самодостаточные файлы: открываются двойным щелчком, без сервера и
-без сети (внешних ссылок в них нет вовсе, данные и программа вклеены). Числа
-между ними одни и те же — страница считает производные (дельты, итоги, фильтры)
-из тех же абсолютных значений тем же кодом, что и таблица.
+Отчёт — один самодостаточный файл: открывается двойным щелчком, без сервера и без
+сети (внешних ссылок в нём нет вовсе, данные, оформление и программа вклеены).
+Производные (дельты, итоги, фильтры) считает сама страница — из абсолютных
+значений, которые даёт движок, и тем же кодом, что и его расчёт.
 
 **Порядок правок:** код → `pnpm run sizes` → коммит с одной таблицей. Таблица
 обновляется **отдельным коммитом**, потому что строка коммита не может попасть в
@@ -995,7 +997,7 @@ R-4.1): пути, таблица файлов, зовы и ключи инстр
 - `--json` — форма ответа, а не отдельный режим, и правило у него одно: ответ
   бывает ровно у четырёх вызовов. Без команды это прежняя форма данных
   (заморожена эталоном паритета), у `check`, `explain` и `doctor` — их ответ.
-  У команды без ответа и рядом с режимом (`--write`, `--data`, `--page`, `--init`)
+  У команды без ответа и рядом с режимом (`--write`, `--data`, `--init`)
   он отказ, а не тишина: просить JSON там, где его не бывает, — ошибка вызова.
 - `size doctor --json` — вся диагностика одним ответом: окружение, зависимости,
   настройки, покрытие и находки с уровнем (`action` — делать, `note` — знать).
@@ -1030,8 +1032,8 @@ pnpm test:all                  # полный прогон (выкладка и
                                # сборка на дисках, сверка с деревом, хуки, метрики
 pnpm run suites:measure        # замерить длительность каждого файла набора
 pnpm run parity:live           # паритет с живым проектом на клоне, две среды
-node bin/size.js --data        # контракт данных: страница и агент
-node bin/size.js --page        # минимальная страница отчёта
+node bin/size.js --data        # контракт данных: отчёт и агент
+node bin/size.js --write       # минимальный отчёт
 node bin/size.js --help        # справка и коды выхода
 pnpm run parity                # переснять эталон паритета: проект и ревизия — из манифеста
 pnpm run fixture               # пересобрать фикстуру и её эталон

package/bin/postinstall.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+/* Постановка хука после установки пакета: чтобы отчёт обновлялся с первого же
+ * коммита, не требуя ни запуска инструмента, ни файла настроек.
+ *
+ * Здесь только поиск проекта-потребителя: сам хук ставит `autoInstall`
+ * (`src/hook.js`) — то же место, что и при первом запуске, иначе «поставлено при
+ * установке» и «поставлено при запуске» могли бы разойтись содержимым файла.
+ *
+ * Код выхода всегда 0: установка зависимостей не должна падать из-за того, что
+ * услугу не удалось оказать (нет git, нет прав, чужой хук, CI). Причина не
+ * печатается: у фоновой работы нет читателя, а точная причина есть у команды
+ * `install-hook`.
+ *
+ * Отдельная тонкость: платформы, где скрипты зависимостей по умолчанию не
+ * исполняются (pnpm 10, yarn berry), зовут этот файл не всегда — тогда хук
+ * ставится при первом запуске инструмента в проекте. Оба пути ведут в одно место. */
+
+import fs from 'fs';
+import path from 'path';
+import { autoInstall } from '../src/hook.js';
+
+/* Каталог проекта-потребителя ищется в порядке убывания точности: `INIT_CWD`
+ * (его ставят npm и pnpm, запуская скрипт пакета), `npm_config_local_prefix`,
+ * затем подъём от текущего каталога вверх до ближайшего `.git`. Подъём нужен,
+ * потому что сам скрипт исполняется из `node_modules`, где репозитория нет. */
+function projectRoot() {
+  const candidates = [process.env.INIT_CWD, process.env.npm_config_local_prefix, process.cwd()];
+  for (const start of candidates) {
+    const found = gitRootOf(start);
+    if (found !== null) return found;
+  }
+  return null;
+}
+
+function gitRootOf(start) {
+  if (typeof start !== 'string' || start === '') return null;
+  let dir = path.resolve(start);
+  for (;;) {
+    if (fs.existsSync(path.join(dir, '.git'))) return dir;
+    const up = path.dirname(dir);
+    if (up === dir) return null;
+    dir = up;
+  }
+}
+
+const root = projectRoot();
+const files = root === null ? null : autoInstall(root, null);
+if (files !== null && process.env.SIZE_REPORT_QUIET !== '1') {
+  console.error('· size-report: хук поставлен (' + files.join(', ') + ') — отчёт обновляется после'
+    + ' каждого коммита; снять: size uninstall-hook');
+}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@vernikr/size-report",
-  "version": "1.3.1",
+  "version": "2.0.0",
   "author": "vernikr",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vernikr/size-report.git"
   },
-  "description": "Учёт роста объёма кода и документов по истории git: raw / min / токены, интерактивный отчёт вне git",
+  "description": "Учёт роста объёма кода и документов по истории git: raw / min / токены; отчёт — один самодостаточный файл, обновляется хуком сам",
   "type": "module",
   "license": "MIT",
   "packageManager": "pnpm@10.6.1",
@@ -32,6 +32,7 @@
   ],
   "sideEffects": false,
   "scripts": {
+    "postinstall": "node bin/postinstall.js",
     "test": "node tools/run-tests.js fast",
     "test:all": "node tools/run-tests.js full",
     "suites:measure": "node tools/run-tests.js measure",
@@ -65,7 +66,7 @@
     "report"
   ],
   "devDependencies": {
-    "@vernikr/size-report": "1.3.0",
+    "@vernikr/size-report": "1.3.1",
     "c8": "10",
     "dependency-cruiser": "17",
     "eslint": "^9.18.0",

package/src/args.js

@@ -21,15 +21,15 @@ import { cliCommand, advicePath, refuseCause } from './refusal.js';
  * места и требует проверки на каждое.
  */
 
-const MODES = ['--init', '--write', '--data', '--page'];
-const VALUE_FLAGS = ['--config', '--init', '--page'];
+const MODES = ['--init', '--write', '--data'];
+const VALUE_FLAGS = ['--config', '--init', '--write'];
 const FLAGS = ['--help', '-h'].concat(MODES, VALUE_FLAGS, ['--json', '--force']);
 const COMMANDS = ['check', 'explain', 'doctor', 'install-hook', 'uninstall-hook', 'hook-run'];
 const ANSWER_COMMANDS = ['check', 'explain', 'doctor'];
 export const HOOK_COMMANDS = ['install-hook', 'uninstall-hook', 'hook-run'];
 
 /* Ключ со значением: забирает следующий аргумент и возвращает, сколько съел. У
- * `--init` и `--page` пустое значение — законное «по умолчанию», а у `--config`
+ * `--init` и `--write` пустое значение — законное «по умолчанию», а у `--config`
  * это молчаливый пропуск: настройки были бы взяты не те, что назвал человек. */
 function takeValue(flag, args, i, values) {
   const next = args[i + 1];
@@ -95,7 +95,7 @@ function checkModes(plan) {
 
 /* Слово, которого команда не знает. Отдельным вопросом, потому что виновников
  * тут двое: опечатка в команде — и лишнее значение режима, который своё значение
- * уже забрал (у `--init` и `--page` оно одно). Оба случая обязаны назвать своего
+ * уже забрал (у `--init` и `--write` оно одно). Оба случая обязаны назвать своего
  * виновника: у `--config` остаток — именно команда, и зов её разбирается как
  * команда, а не как лишнее слово. */
 function checkUnknownWord(plan) {

package/src/artifact.js

@@ -1,28 +1,37 @@
 import fs from 'fs';
 import path from 'path';
-import { build } from './history.js';
-import { render } from './render.js';
+import { reportData } from './data.js';
+import { pageHtml } from './page/build.js';
 
-/* Артефакт на диске: единственное место, где отчёт превращается в файл. Им
- * пользуются оба потребителя — режим `--write` и хук после коммита (`src/hook.js`),
- * поэтому «что записано в файл» не может разойтись между ними: в коммит хук кладёт
- * ровно те байты, которые показывает `--write`.
+/* Отчёт — один файл: самодостаточная страница. Она и есть артефакт, потому что
+ * несёт всё сама (данные, оформление, программу), а второй формы того же отчёта не
+ * существует: два вывода одной истории разошлись бы молча, и выбрать, какой из них
+ * верный, было бы нечем.
  *
- * Каталог создаётся здесь же: `--write .size-report/report.html` в свежем проекте —
- * обычный запуск, а не ошибка пользователя. */
+ * Через это место проходят оба потребителя — режим записи (`--write`) и хук после
+ * коммита (`src/hook.js`), поэтому «что записано в файл» не может разойтись между
+ * ними: в коммит хук кладёт ровно те байты, которые показывает `--write`.
+ *
+ * Каталог создаётся здесь же: `--write docs/size-report.html` в свежем проекте —
+ * обычный запуск, а не ошибка пользователя. Тем же путём пишется черновик настроек
+ * (`--init`), поэтому он один на пакет. */
 
-/* Запись файла с созданием каталога: `--write .size-report/report.html` в свежем
- * проекте — обычный запуск, а не ошибка пользователя. Тем же путём пишутся
- * страница (`--page`) и черновик настроек (`--init`), поэтому он один на пакет. */
+/* Запись файла с созданием каталога: путь может не существовать ни одной своей
+ * частью — это не ошибка того, кто его назвал. */
 export function writeFileEnsured(file, text) {
   fs.mkdirSync(path.dirname(file), { recursive: true });
   fs.writeFileSync(file, text);
 }
 
+/* Собранные байты отчёта без записи: они же нужны проверке (`таблица совпадает с
+ * историей`), и собирать их вторым способом значило бы сверять не то, что пишется. */
+export function artifact(cfg, root) {
+  const data = reportData(cfg, root);
+  return { data: data, html: pageHtml(data, cfg), file: path.join(root, cfg.output) };
+}
+
 export function rebuild(cfg, root) {
-  const { rows, dropped, state } = build(cfg, root);
-  const html = render(rows, cfg);
-  const file = path.join(root, cfg.output);
-  writeFileEnsured(file, html);
-  return { rows: rows, dropped: dropped, state: state, html: html, file: file };
+  const out = artifact(cfg, root);
+  writeFileEnsured(out.file, out.html);
+  return out;
 }

package/src/cli.js

@@ -1,11 +1,12 @@
 import path from 'path';
-import { EXIT, Refusal, USAGE } from './refusal.js';
+import { EXIT, Refusal, USAGE, cliCommand } from './refusal.js';
 import { CONFIG_NAME, gitRoot, loadConfig } from './config.js';
 import { HOOK_COMMANDS, parseArgs } from './args.js';
 import { initMode } from './init.js';
 import { derivedLines } from './project.js';
+import { autoInstall } from './hook.js';
 import {
-  checkMode, coverageMode, dataMode, doctorMode, explainMode, hookMode, jsonMode, pageMode, writeMode
+  checkMode, coverageMode, dataMode, doctorMode, explainMode, hookMode, jsonMode, writeMode
 } from './modes.js';
 
 /* Вход инструмента: разбор строки, чтение проекта и доставка запроса режиму.
@@ -28,13 +29,23 @@ const RUNNERS = {
   check: (c, x) => coverageMode(x.cfg, x.root, x.configFile, c.json),
   explain: (c, x) => explainMode(x.cfg, x.root, c.arg[0], c.json),
   '--data': (c, x) => dataMode(x.cfg, x.root),
-  '--page': (c, x) => pageMode(x.cfg, x.root, c.values['--page']),
-  '--write': (c, x) => writeMode(x.cfg, x.root),
+  '--write': (c, x) => writeMode(x.cfg, x.root, c.values['--write']),
   '': (c, x) => (c.json ? jsonMode(x.cfg, x.root) : checkMode(x.cfg, x.root))
 };
 
 const asked = (cmd) => (cmd.verb === null ? (cmd.mode === null ? '' : cmd.mode) : cmd.verb);
 
+/* Постановка хука без спроса — здесь, а не в `doctor` и не в `hook-run`: первый
+ * только докладывает, а второй зовётся уже из поставленного хука. Ставится один раз
+ * в клоне и называется вслух, дальше молчит: отчёт обновляется после каждого
+ * коммита без ручного шага (устройство и границы — `src/hook.js`). */
+function ensureHook(root, cfg) {
+  const files = autoInstall(root, cfg);
+  if (files === null) return;
+  console.error('· хук поставлен: ' + files.join(', ') + ' — отчёт обновляется после каждого'
+    + ' коммита (снять: ' + cliCommand('uninstall-hook') + ')');
+}
+
 /* Доставка. Диагностика и хук отвечают до чтения настроек: им нужен не весь
  * проект, а окружение, и отказывать им из-за настроек было бы неверно — про
  * настройки они как раз и докладывают. */
@@ -45,6 +56,7 @@ function deliver(cmd, base) {
   // Примечание идёт в stderr: у `--json` и `--data` в stdout лежат данные, и
   // подмешивать в них рассказ о настройках значило бы ломать разбор.
   if (ctx.cfg.derived) derivedLines(ctx.cfg).forEach((line) => console.error(line));
+  ensureHook(base.root, ctx.cfg);
   return RUNNERS[asked(cmd)](cmd, ctx);
 }
 

package/src/config.js

@@ -16,7 +16,7 @@ import { projectConfig } from './project.js';
 export const CONFIG_NAME = 'size-table.config.json';
 
 export const DEFAULT_CONFIG = {
-  output: 'size-table.html',
+  output: 'size-report.html',
   locale: 'ru',
   title: '',          // по умолчанию — заголовок из локали
   heading: '',
@@ -30,9 +30,10 @@ export const DEFAULT_CONFIG = {
   minify: { engine: 'strip', ext: {}, guard: ['.js', '.mjs', '.cjs'] },
   // Токены: каким словарём считать. Семейство — про модели, кодировка — про число.
   tokens: Object.assign({}, TOKEN_DEFAULTS),
-  // Автоматика хука: хук ставится только явной командой (`install-hook`), а этот
-  // ключ — её выключатель (`.size-report/…` не нужен: снятие хука возвращает
-  // проект к прежнему поведению).
+  // Автоматика хука: хук обновляет отчёт после каждого коммита и ставится сам —
+  // после установки пакета (`bin/postinstall.js`) и при первом запуске в проекте
+  // (`src/hook.js`); этот ключ — её выключатель (`.size-report/…` не нужен: снятие
+  // хука возвращает проект к прежнему поведению).
   hooks: { enabled: true },
   journal: null,
   links: { commitUrl: '' },

package/src/css.js

@@ -5,31 +5,22 @@ import fs from 'node:fs';
  * редактор, а не только шаблонная строка. Читаются они с диска относительно
  * своего места, поэтому работают и у того, кто поставил пакет.
  *
- * Наборов три, и у каждого своя роль:
+ * Наборов два, и у каждого своя роль:
  *
- *   1. `table.css` — **общая часть таблицы**: геометрия клеток, липкие шапка и
- *      колонка коммита, подпись коммита, цвета дельт. Её берут оба вывода, поэтому
- *      расхождению в оформлении самой таблицы взяться неоткуда. Файл — дословный
- *      текст этой части, без шапки: он попадает в артефакт побайтово, а артефакт
- *      заморожен эталоном паритета, и любая добавленная строка меняла бы
- *      зафиксированный вывод проекта-потребителя.
- *   2. `artifact.css` — оформление статического артефакта **сверх таблицы**: холст,
- *      заголовок, примечание.
- *   3. `page/app.css` — оформление страницы **сверх таблицы**: холст, панель
+ *   1. `table.css` — **таблица**: геометрия клеток, липкие шапка и колонка коммита,
+ *      подпись коммита, цвета дельт.
+ *   2. `page/app.css` — оформление страницы **сверх таблицы**: холст, панель
  *      выбора, легенда, состояния пустоты и адаптации под узкое окно.
  *
  * Соглашение о цвете дельт задано один раз — в `table.css`: `.up` зелёный, `.down`
- * красный (рост — «больше логики», а не тревога). Артефакт заморожен побайтово, и
- * менять его цвета нельзя, не пересняв эталон; страница следует тому же
- * соглашению, потому что два отчёта одной истории не могут показывать рост
- * разными цветами. Смена соглашения — две строки в `table.css` и пересъёмка
- * эталона артефакта; отдельного места у цвета дельт нет намеренно.
+ * красный (рост — «больше логики», а не тревога). Второго места у него нет
+ * намеренно: рост не может быть показан разными цветами в двух местах одной
+ * страницы. Смена соглашения — две строки в `table.css`.
  *
  * Путь у `readCss` — от каталога `src/`: так его видит движок, где бы он ни лежал.
  */
 
 export const TABLE_CSS = readCss('./table.css');
-export const ARTIFACT_CSS = readCss('./artifact.css');
 export const PAGE_CSS = readCss('./page/app.css');
 
 function readCss(name) {

package/src/hook.js

@@ -15,10 +15,15 @@ import { rebuild } from './artifact.js';
  *
  * Что он делает и почему именно так:
  *
- * - **Ставится только явной командой** (`install-hook`) и снимается
- *   (`uninstall-hook`): установка — это правка чужого `.git`, и делать её вслепую
- *   нельзя. До установки проект не меняется ничем, после снятия — возвращается к
- *   прежнему поведению.
+ * - **Ставится сам** — после установки пакета (`bin/postinstall.js`) и при первом
+ *   запуске в проекте (`autoInstall`, зовётся из входа): от человека не требуется
+ *   ни ручного шага, ни файла настроек, иначе первого обновления отчёта он не
+ *   увидел бы вовсе. Ставится там, где это безопасно (обычный `.git/hooks`, нет
+ *   чужого хука, есть чем звать инструмент, не CI); где небезопасно — молчит.
+ *   Снимается явной командой (`uninstall-hook`), и проект возвращается к прежнему
+ *   поведению: и поставленное, и снятое — одно и то же место состояния (`git-dir`).
+ *   Ручная команда (`install-hook`) остаётся: она называет причину, когда поставить
+ *   не удалось, а тихая постановка причин не объясняет.
  * - **Сам коммитов не создаёт** — за одним исключением: отчёт, лежащий в git,
  *   коммитится отдельно от кода. Раньше это делал человек (отсюда ловушка «правка
  *   кода и таблицы в одном коммите»), и хук для того и нужен, чтобы ручного шага не
@@ -185,6 +190,7 @@ export function installHook(root, cfg) {
     return { code: EXIT.OK, lines: [
       '· хук уже установлен: ' + rels.join(', '),
       '  автоматика работает после каждого коммита и слияния',
+      '  выключить, не снимая: «"hooks": {"enabled": false}» в файле настроек',
       '  снять: ' + cliCommand('uninstall-hook')
     ] };
   }
@@ -208,6 +214,38 @@ export function installHook(root, cfg) {
   return { code: EXIT.OK, lines: lines };
 }
 
+/* Постановка без спроса. Отвечает списком путей, если поставила, и `null`, если не
+ * тронула ничего, — второй ответ не ошибка, а норма: эта услуга фоновая, и там, где
+ * она не к месту, её просто нет. Поэтому всё, что мешает поставить, решается
+ * молчанием, а не отказом: отказ от фоновой работы после каждого запуска был бы
+ * шумом, а причина уже названа точной командой (`install-hook`).
+ *
+ * Чужой `core.hooksPath` сюда же: этот каталог версионируется и часто лежит в
+ * другом репозитории — вписывать строку в чужой файл по своей воле нельзя, и
+ * человек берёт её у `install-hook` (готовую и без метки). */
+export function autoInstall(root, cfg) {
+  if (process.env.CI || process.env[NO_HOOK]) return null;
+  if (cfg !== null && cfg.hooks.enabled === false) return null;
+  try {
+    const hooks = hooksDir(root);
+    const entry = hookEntry(root);
+    if (hooks.custom || entry === null) return null;
+    const files = HOOKS.map((name) => path.join(hooks.dir, name));
+    if (files.some((f) => fs.existsSync(f) && !isOurs(f))) return null;
+    if (files.every(isOurs)) return null;
+    fs.mkdirSync(hooks.dir, { recursive: true });
+    files.forEach((file) => {
+      fs.writeFileSync(file, script(entry));
+      fs.chmodSync(file, 0o755);
+    });
+    return files.map((f) => path.relative(root, f));
+  } catch (_e) {
+    /* Не git-репозиторий, нет прав на `.git`, чужой формат — всё это значит одно:
+     * автоматики здесь не будет, а работа инструмента от неё не зависит. */
+    return null;
+  }
+}
+
 /* Снятие: убирается только то, что поставили мы. Файл не «похож на наш», а помечен
  * меткой, иначе чужой хук был бы стёрт молча. */
 export function uninstallHook(root) {

package/src/locales.js

@@ -12,14 +12,15 @@ export const LOCALES = {
     total: 'Общий объём',
     now: 'сейчас',
     categories: { code: 'Код', docs: 'Документация', chore: 'Служебные', assets: 'Ресурсы' },
-    /* Тексты страницы отчёта: в артефакт они не попадают, поэтому меняются
-     * независимо от его заморожённых байтов. */
+    /* Тексты страницы отчёта. Они лежат в самом файле отчёта (отдельным словарём,
+     * рядом с данными), поэтому меняются вместе с ним — и правка слова стоит
+     * пересборки отчёта, иначе файл разойдётся с историей. */
     page: {
       metrics: 'Метрики',
       files: 'Файлы',
       dir: 'все файлы папки {name} ({n})',
       all: 'все',
-      sub: '{tool} {version} · рядом со страницей — статическая таблица: {artifact}',
+      sub: '{tool} {version} · {artifact}',
       legendUp: 'рост',
       legendDown: 'спад',
       legendSame: 'пустая клетка — не менялось',
@@ -75,7 +76,7 @@ export const LOCALES = {
       files: 'Files',
       dir: 'all files in “{name}” ({n})',
       all: 'all',
-      sub: '{tool} {version} · a static table sits next to this page: {artifact}',
+      sub: '{tool} {version} · {artifact}',
       legendUp: 'growth',
       legendDown: 'fall',
       legendSame: 'an empty cell — no change',

package/src/modes.js

@@ -9,11 +9,9 @@ import { coverage, coverageText } from './check.js';
 import { explainCommit, explainText } from './explain.js';
 import { doctor, doctorText } from './doctor.js';
 import { hookRun, installHook, uninstallHook } from './hook.js';
-import { rebuild, writeFileEnsured } from './artifact.js';
+import { artifact, rebuild } from './artifact.js';
 import { sensorGaps } from './metrics.js';
-import { render } from './render.js';
 import { totalsOf } from './derived.js';
-import { pageHtml } from './page/build.js';
 
 /* Режимы: что инструмент делает по запросу. Разбор аргументов — в `src/args.js`, а
  * сюда приходит готовый план: какой режим, какой ключ, что печатать. Здесь же их
@@ -21,10 +19,10 @@ import { pageHtml } from './page/build.js';
  * на все режимы, потому что один и тот же счёт и один и тот же знак не должны
  * разойтись между `--write`, `--data`, `--page` и `size check`.
  *
- * Что где: сборка и сверка таблицы (`--write`, проверка), данные и страница
- * (`--data`, `--page`), полнота покрытия (`size check`), диагностика (`doctor`),
- * хук и объяснение пропущенной строки. Файл знает про все остальные модули сразу —
- * это его работа: связать их в одну команду.
+ * Что где: сборка и сверка отчёта (`--write`, проверка), данные контракта
+ * (`--data`), полнота покрытия (`size check`), диагностика (`doctor`), хук и
+ * объяснение пропущенной строки. Файл знает про все остальные модули сразу — это
+ * его работа: связать их в одну команду.
  */
 
 function kmb(bytes) {
@@ -81,23 +79,31 @@ export function check(cfg, want, root) {
   return 1;
 }
 
-export function writeMode(cfg, root) {
-  const { rows, dropped, state, html } = rebuild(cfg, root);
-  console.log('✓ ' + cfg.output + ': ' + rows.length + ' строк × ' + cfg.columns.length + ' файлов, '
-    + kmb(byteLen(html)) + ' (пропущено без строки: ' + dropped.length + ' — '
-    + dropped.map(skipLine).join(', ') + ')');
-  console.log('  состояние на HEAD: ' + cfg.columns.map((c, i) => c.label + ' '
-    + (state[i] === null ? '—' : cfg.metrics.map((m) => state[i].cells[m]).join('/'))).join(', '));
+/* Путь, названный ключом (`--write <файл>`), — это настройка `output` этого
+ * запуска: отчёт обязан называть себя тем путём, по которому лежит, иначе подпись в
+ * нём указывала бы на чужое место. */
+function withOutput(cfg, root, file) {
+  if (typeof file !== 'string') return cfg;
+  return Object.assign({}, cfg, { output: path.relative(root, path.resolve(file)) });
+}
+
+export function writeMode(cfg, root, file) {
+  const out = rebuild(withOutput(cfg, root, file), root);
+  const { rows, files, now, skipped } = out.data;
+  console.log('✓ ' + path.relative(root, out.file) + ': ' + rows.length + ' строк × ' + files.length + ' файлов, '
+    + kmb(byteLen(out.html)) + ' (пропущено без строки: ' + skipped.length + ' — '
+    + skipped.join(', ') + ')');
+  console.log('  состояние на HEAD: ' + files.map((f, i) => f.label + ' '
+    + (now[i] === null ? '—' : cfg.metrics.map((m) => now[i][m]).join('/'))).join(', '));
   return sensorNote(cfg);
 }
 
 export function checkMode(cfg, root) {
-  const { rows } = build(cfg, root);
-  const html = render(rows, cfg);
-  const code = check(cfg, html, root);
+  const out = artifact(cfg, root);
+  const code = check(cfg, out.html, root);
   if (code === 0) {
-    console.log('✓ таблица размеров: ' + rows.length + ' коммитов × ' + cfg.columns.length + ' файлов '
-      + 'совпадает с историей (' + cfg.output + ', ' + kmb(byteLen(html)) + ')');
+    console.log('✓ отчёт: ' + out.data.rows.length + ' коммитов × ' + out.data.files.length + ' файлов '
+      + 'совпадает с историей (' + cfg.output + ', ' + kmb(byteLen(out.html)) + ')');
   }
   return verdict(code, sensorGaps(cfg));
 }
@@ -162,21 +168,6 @@ export function dataMode(cfg, root) {
   return sensorNote(cfg);
 }
 
-/* Страница отчёта: собирается тем же проходом по истории, что и артефакт — иначе
- * два отчёта могли бы показывать разные числа. Файл кладётся рядом с таблицей,
- * потому что он из неё и растёт. */
-const PAGE_NAME = 'size-report.html';
-
-export function pageMode(cfg, root, file) {
-  const data = reportData(cfg, root);
-  const target = file ? path.resolve(file) : path.join(root, path.dirname(cfg.output), PAGE_NAME);
-  const html = pageHtml(data, cfg);
-  writeFileEnsured(target, html);
-  console.log('✓ ' + path.relative(root, target) + ': ' + data.rows.length + ' строк × '
-    + data.files.length + ' файлов, ' + kmb(byteLen(html)));
-  return sensorNote(cfg);
-}
-
 export function jsonMode(cfg, root) {
   const { rows, dropped } = build(cfg, root);
   process.stdout.write(JSON.stringify({

package/src/page/build.js

@@ -1,8 +1,13 @@
 import fs from 'fs';
 import { fill, LOCALES } from '../locales.js';
-import { esc } from '../render.js';
 import { PAGE_CSS, TABLE_CSS } from '../css.js';
 
+/* Экранирование текста в разметке — здесь, потому что единственный, кто собирает
+ * разметку из данных, — эта сборка: остальное рисует страница узлами. */
+export function esc(s) {
+  return String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+
 /* Сборка страницы отчёта: данные и программа в одном файле, внешних ссылок нет.
  * Оформление — тоже обычные файлы: общая часть таблицы (`table.css`) и своё
  * оформление страницы (`app.css`).
@@ -37,8 +42,8 @@ export function pageScript() {
   return pageSource('../derived.js') + '\n' + PAGE_PARTS.map((part) => pageSource(part)).join('');
 }
 
-/* Подпись под заголовком: чем собрана страница и что у неё рядом. Путь к таблице
- * текстом, а не ссылкой: страница открывается с диска и ни от чего не зависит. */
+/* Подпись под заголовком: чем собран отчёт и где он лежит. Путь — текстом, а не
+ * ссылкой: страница открывается с диска и ни от чего не зависит. */
 function subText(data, page) {
   return fill(page.sub, {
     tool: data.tool.name,
@@ -81,6 +86,20 @@ function uiText(page, loc) {
   };
 }
 
+/* Что в файл не идёт. Первое — список пропущенных коммитов: он меняется от
+ * коммита самого отчёта (тот, кому нечего сказать, попадает в список), и файл
+ * перестал бы быть **неподвижной точкой** — пересборка после его же коммита давала
+ * бы другие байты, а хук коммитил бы отчёт бесконечно. Странице этот список не
+ * нужен вовсе: она его не показывает. Читателю он по-прежнему доступен — `--data`,
+ * `--json` и `explain` отвечают этим же проходом. */
+const NOT_IN_FILE = ['skipped'];
+
+export function pagePayload(data) {
+  const out = Object.assign({}, data);
+  NOT_IN_FILE.forEach((key) => delete out[key]);
+  return out;
+}
+
 /* Страница отчёта — один файл: данные лежат в нём же, скрипт вклеен, внешних
  * ссылок нет. Поэтому она открывается двойным щелчком и работает без сети.
  * `<` в данных экранируется: иначе подпись коммита или путь закрыли бы тег
@@ -98,7 +117,7 @@ export function pageHtml(data, cfg) {
     + '<div id="shell" class="shell"><table id="grid"></table></div>\n'
     + '<p id="state" class="state" hidden></p>\n'
     + '<p id="note" class="note"></p>\n'
-    + '<script type="application/json" id="data">' + jsonInHtml(data) + '</script>\n'
+    + '<script type="application/json" id="data">' + jsonInHtml(pagePayload(data)) + '</script>\n'
     + '<script type="application/json" id="ui">' + jsonInHtml(uiText(loc.page, loc)) + '</script>\n'
     + '<script>\n' + pageScript() + '</script>\n</body>\n</html>\n';
 }

package/src/project.js

@@ -97,8 +97,11 @@ function exists(root, p) {
   return fs.existsSync(path.join(root, p));
 }
 
+/* Имя отчёта — одно на пакет и на проект: файл это и есть страница отчёта, и
+ * называться иначе она не может. Каталог решает только, где ей лежать: рядом с
+ * доками, если они в проекте есть, иначе в корне. */
 function outputOf(root) {
-  return (exists(root, 'docs') ? 'docs/' : '') + 'size-table.html';
+  return (exists(root, 'docs') ? 'docs/' : '') + 'size-report.html';
 }
 
 /* Менеджер пакетов — по lock-файлу, а не догадкой: команда обязана существовать

package/src/refusal.js

@@ -91,7 +91,8 @@ export function advicePath(p) {
 }
 
 export const USAGE = [
-  '@vernikr/size-report — таблица объёма файлов по коммитам.',
+  '@vernikr/size-report — отчёт об объёме файлов по коммитам: один файл,',
+  'самодостаточная страница (данные, оформление и программа лежат в ней же).',
   '',
   'Запуск: ' + invocation() + ' [команда] [режим] [ключи]',
   '',
@@ -101,19 +102,18 @@ export const USAGE = [
   '  explain <коммит>  почему у коммита нет строки (имя ревизии, sha или его начало)',
   '  doctor [--json]   диагностика одним ответом: окружение, зависимости, настройки,',
   '                    покрытие (код 0 — делать нечего, иначе — первый по важности)',
-  '  install-hook      поставить хуки post-commit и post-merge: отчёт пересобирается',
-  '                    сам после каждого коммита и слияния, а если он в git — ложится',
-  '                    отдельным коммитом',
+  '  install-hook      поставить хуки post-commit и post-merge (они ставятся сами при',
+  '                    первом запуске в проекте): отчёт пересобирается после каждого',
+  '                    коммита и слияния, а если он в git — ложится отдельным коммитом',
   '  uninstall-hook    убрать хук и его состояние (проект возвращается к прежнему)',
   '  hook-run          то, что зовёт хук: пересборка и коммит отчёта (вручную не нужно)',
   '',
   'Режимы:',
   '  --init [файл]   закрепить настройки файлом (--force — перезаписать существующий)',
-  '  --write         собрать таблицу в файл из настроек',
-  '  --data          данные контракта в stdout — для страницы и для агента',
-  '  --page [файл]   страница отчёта (по умолчанию рядом с таблицей)',
+  '  --write [файл]  собрать отчёт в файл из настроек (каталог создаётся сам)',
+  '  --data          данные контракта в stdout — для отчёта и для агента',
   '  --json          прежняя форма данных в stdout',
-  '  (без режима)    проверить, что таблица совпадает с историей',
+  '  (без режима)    проверить, что отчёт совпадает с историей',
   '',
   'Ключи: --config <файл> — другие настройки; --help — эта справка.',
   '',

package/src/size-table.js

@@ -37,13 +37,16 @@
  * начинает работать и для стратегии «пересобрать и дописать в тот же коммит»:
  * без sha артефакт становится неподвижной точкой сборки.
  *
+ * Отчёт один: самодостаточная страница (`size-report.html`), в которой лежат и
+ * данные, и оформление, и программа. Второй формы того же отчёта нет намеренно: два
+ * вывода одной истории разошлись бы молча, а выбрать, какой верный, было бы нечем.
+ *
  * Запуск (из любого места репозитория; `size` — когда пакет установлен, иначе
  * `node bin/size.js`):
- *   size                    проверка: таблица совпадает с историей (CI)
- *   size --write            перегенерировать таблицу
+ *   size                    проверка: отчёт совпадает с историей (CI)
+ *   size --write [файл]     перегенерировать отчёт
  *   size --json             строки как JSON в stdout
- *   size --data             данные для страницы и агента в stdout
- *   size --page [файл]      собрать страницу отчёта
+ *   size --data             данные для отчёта и агента в stdout
  *   size --init [файл]      закрепить настройки файлом (без него они выводятся из проекта)
  *   size --config <путь>    другой файл настроек
  *   size --help             справка и коды выхода
@@ -64,8 +67,8 @@
  *   config → project, git, refusal, locales, metrics, data — настройки проекта;
  *   history → git, metrics, journal, refusal           — сборка по истории;
  *   data → locales, metrics, journal, history, tool    — контракт со страницей;
- *   render → locales, metrics, journal, derived        — статический артефакт;
- *   page/build → locales, render                       — страница отчёта;
+ *   page/build → locales, css                          — отчёт одним файлом;
+ *   artifact → data, page/build                        — запись отчёта;
  *   modes → почти все                                  — что делать по запросу;
  *   init → config, project, refusal, artifact          — закрепление настроек файлом;
  *   cli → args, modes, init, config, refusal           — вход: разбор и доставка.
@@ -76,11 +79,10 @@
 export { main } from './cli.js';
 export { initMode } from './init.js';
 export { sniffColumns } from './project.js';
-export { check, dataMode, pageMode } from './modes.js';
+export { check, dataMode, writeMode } from './modes.js';
 export { reportData, categoryOf, CATEGORY_EXTS, CATEGORY_ORDER } from './data.js';
 export { measureHistory } from './history.js';
-export { render, noteText, cellHtml, valueHtml } from './render.js';
-export { pageHtml, pageScript, pageSource, stripModules } from './page/build.js';
+export { pageHtml, pageScript, pageSource, stripModules, esc } from './page/build.js';
 export { measureBlob, METRICS } from './metrics.js';
 export { minifyForm, strategyFor, stripCss, stripHtml, stripJs, stripLines, compactJson,
   STRATEGIES } from './strip.js';

package/templates/README.md

@@ -11,6 +11,11 @@
 | `size-report.config.json` | `size-table.config.json` в корне проекта | **Поправить колонки** и, если нужно, остальное |
 | `ci.yml` | `.github/workflows/size-report.yml` | Ничего: файл работает как есть |
 
+Отчёт в проекте появляется без ручной работы: после установки пакета и первого
+запуска инструмент сам ставит хуки `post-commit`/`post-merge`, и `docs/` с
+`size-report.html` создаётся первым же коммитом. Снять автоматику — `size
+uninstall-hook`, выключить, не снимая, — `"hooks": {"enabled": false}`.
+
 ## Настройки
 
 **Файл настроек заводить не нужно.** Без него инструмент выводит профиль из самого
@@ -51,7 +56,7 @@ README и журнал колонкой не отслеживаются, — т
   именно этот объект выводит `size --init`, когда журнал в проекте есть.
 - `paths` внутри колонки — псевдонимы одного файла: если файл переименовывали,
   перечислите и старое имя, и новое, и колонка не разорвётся.
-- `output: "docs/size-table.html"` — файл таблицы; каталог инструмент создаст сам.
+- `output: "docs/size-report.html"` — файл отчёта (он один: самодостаточная страница со всеми числами, фильтрами и ссылкой); каталог инструмент создаст сам, а хук — тоже: после установки пакета и первого запуска отчёт обновляется после каждого коммита без ручного шага.
 
 ## Проверка в CI
 

package/templates/ci.yml

@@ -2,7 +2,8 @@
 # Положите файл в .github/workflows/size-report.yml — правок он не требует.
 #
 # Что проверяется и почему так:
-#   * таблица объёма на диске сходится с историей git — это числа отчёта;
+#   * отчёт на диске сходится с историей git — это его числа (отчёт один:
+#     самодостаточная страница `size-report.html`);
 #   * тот же снимок чисел, снятый в среде, где настроек git нет вовсе,
 #     совпадает побайтово: вывод инструмента не должен зависеть от того, что
 #     настроено на машине (BLOCKERS.md §B1, §B2).
@@ -23,7 +24,7 @@
 # Нужен явный путь — `node node_modules/@vernikr/size-report/bin/size.js`.
 #
 # Отчёт не в git? Такое тоже задумано требованиями (отчёт — выводимый артефакт):
-# тогда вместо шага «Таблица объёма совпадает с историей» поставьте сборку —
+# тогда вместо шага «Отчёт совпадает с историей» поставьте сборку —
 # `pnpm exec size --write` — и этот шаг будет проверять, что отчёт собирается.
 
 name: size-report
@@ -34,7 +35,7 @@ jobs:
   size:
     runs-on: ubuntu-latest
     steps:
-      # История нужна целиком: таблица строится по коммитам, и на обрезанном
+      # История нужна целиком: отчёт строится по коммитам, и на обрезанном
       # клоне инструмент отказывается работать (код 3), а не пишет короткую.
       - uses: actions/checkout@v7
         with:
@@ -50,9 +51,9 @@ jobs:
       - name: Установка
         run: pnpm install --frozen-lockfile
 
-      # Проверка — та же команда `size` без ключей: она собирает таблицу заново
+      # Проверка — та же команда `size` без ключей: она собирает отчёт заново
       # и сверяет с файлом на диске. Своего набора тестов потребителю не нужно.
-      - name: Таблица объёма совпадает с историей
+      - name: Отчёт совпадает с историей
         run: pnpm exec size
 
       - name: Снимок чисел контракта

package/templates/size-report.config.json

@@ -1,5 +1,5 @@
 {
-  "output": "docs/size-table.html",
+  "output": "docs/size-report.html",
   "locale": "ru",
   "title": "Объём файлов по коммитам",
   "heading": "Объём файлов по коммитам",

package/src/artifact.css

@@ -1,8 +0,0 @@
-:root { color-scheme: light dark; }
-/* Фон и цвет текста заданы явно и одной парой (Canvas/CanvasText): без этого
- * страница берёт цвет текста из схемы, а фон — нет, и в тёмной схеме числа
- * оказывались белыми на белом. */
-body { margin: 0; padding: 20px; background: Canvas; color: CanvasText; font: 12.5px/1.4 ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif; }
-h1 { margin: 0 0 6px; font-size: 16px; }
-.note { margin: 0 0 14px; max-width: 80em; opacity: .75; font-size: 12px; }
-.note code { background: rgba(127, 127, 127, .15); padding: 0 3px; border-radius: 3px; }

package/src/render.js

@@ -1,139 +0,0 @@
-import { fill, LOCALES } from './locales.js';
-import { METRICS, metricView } from './metrics.js';
-import { rowHref } from './journal.js';
-import { cellParts, commitParts, nowModel, rowModel, valueParts } from './derived.js';
-import { ARTIFACT_CSS, TABLE_CSS } from './css.js';
-
-/* Статический отчёт: стили, разметка клетки и таблицы, примечание. Производные
- * величины берёт из общего расчёта («derived.js») — того же, который исполняет
- * страница. */
-
-/* Оформление артефакта — своё плюс общая часть таблицы: ровно тот же текст
- * таблицы получает и страница, поэтому оформление самой таблицы у двух отчётов
- * одно. Что именно входит в каждую часть — в `src/css.js`. */
-const CSS = ARTIFACT_CSS + '\n' + TABLE_CSS;
-
-export function esc(s) {
-  return String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
-}
-
-/* Разметка клетки строки-коммита: правила — в `cellParts`, здесь только тег и
- * классы. Клетка-дельта: абсолютные числа стоят один раз в верхней строке, иначе
- * крупное число повторялось бы в каждой строке и колонки расползались бы. */
-export function cellHtml(cell, first) {
-  const parts = cellParts(cell.value, cell.delta, '-');
-  const cls = 'num' + (first ? ' g' : '') + (parts.miss ? ' miss' : '');
-  if (parts.dir === null) return '<td class="' + cls + '">' + parts.text + '</td>';
-  return '<td class="' + cls + '"><span class="delta ' + parts.dir + '">' + parts.text + '</span></td>';
-}
-
-// Разметка клетки верхней строки: правила — в `valueParts`.
-export function valueHtml(value, first) {
-  const parts = valueParts(value);
-  return '<td class="num' + (first ? ' g' : '') + (parts.miss ? ' miss' : '') + '">' + parts.text + '</td>';
-}
-
-function commitCell(row, index, cfg) {
-  const loc = LOCALES[cfg.locale];
-  const parts = commitParts(row, cfg.rows.sha, rowHref(row.section, row.sha, cfg));
-  const when = '<span class="when">' + esc(parts.when) + '</span>';
-  const title = esc(parts.title);
-  const plain = row.section === null && parts.href === null;
-  const body = parts.href
-    ? '<a class="subj" title="' + title + '" href="' + esc(parts.href) + '">' + esc(parts.subject) + '</a>'
-    : '<span class="subj' + (plain ? ' plain' : '') + '" title="' + title + '">' + esc(parts.subject) + '</span>';
-  const markTitle = parts.mark.title === null
-    ? (cfg.journal ? fill(loc.note.noJournalMark, { journal: cfg.journal.path }) : loc.note.noJournal)
-    : parts.mark.title;
-  const id = cfg.rows.sha ? 'c-' + row.sha.slice(0, 7) : 'c-' + (index + 1);
-  return '<th class="c-commit" id="' + id + '">'
-    + '<div class="clip">' + when + body
-    + '<span class="sect" title="' + esc(markTitle) + '">' + esc(parts.mark.text) + '</span>'
-    + '</div></th>';
-}
-
-export function noteText(rows, cfg) {
-  const loc = LOCALES[cfg.locale];
-  const metrics = cfg.metrics.map((m) => {
-    const view = metricView(m, cfg);
-    return '<b>' + view.label + '</b> — ' + view.note;
-  }).join(loc.note.metricSep);
-  const journal = cfg.journal ? loc.note.journal : loc.note.noJournal;
-  return loc.note.intro + metrics + loc.note.metricEnd + fill(loc.note.numbers, { now: loc.now })
-    + (cfg.journal ? fill(journal, { journal: cfg.journal.path }) : journal)
-    + fill(loc.note.columns, { columns: cfg.columns.map((c) => c.label).join(', ') })
-    + fill(loc.note.rows, { rows: rows.length, command: cfg.fixCommand });
-}
-
-/* Шапка таблицы: строка групп (итог и колонки) и под ней строка метрик. */
-function tableHead(cfg, loc) {
-  const metrics = cfg.metrics;
-  const groupHead = (label, cls) => '<th colspan="' + metrics.length + '" class="' + cls + '">' + esc(label) + '</th>';
-  const subHead = () => metrics.map((m, i) => '<th' + (i === 0 ? ' class="g"' : '') + '>'
-    + esc(METRICS[m].label) + '</th>').join('');
-  return '<tr>'
-    + '<th rowspan="2" class="c-commit">' + esc(loc.commit) + '</th>'
-    + groupHead(loc.total, 'g')
-    + cfg.columns.map((c) => groupHead(c.label, 'g')).join('')
-    + '</tr>\n<tr>'
-    + subHead()
-    + cfg.columns.map(() => subHead()).join('')
-    + '</tr>';
-}
-
-/* Тело таблицы: строки-коммиты сверху вниз — от старых к новым, — а над ними
- * строка «сейчас» с абсолютными размерами.
- *
- * Дельта считается к предыдущему коммиту (в списке ниже он идёт строкой ниже),
- * а появление файла — рост на весь его объём: иначе сумма дельт по колонке не
- * сходилась бы с текущим размером, и верхняя строка была бы недоказуемой. Всё
- * это считает `rowModel` — тот же, что и на странице. */
-function tableBody(rows, cfg, loc) {
-  const metrics = cfg.metrics;
-  const cellsHtml = (make) => (cells) => cells.map((c, mi) => make(c, mi === 0)).join('');
-  const rowCells = cellsHtml((c, first) => cellHtml(c, first));
-  const nowCells = cellsHtml((v, first) => valueHtml(v, first));
-  const blocksHtml = (model, one) => one(model.total) + model.files.map(one).join('');
-  const body = rows.map((row, i) => {
-    const prev = i === 0 ? null : rows[i - 1];
-    return '<tr>' + commitCell(row, i, cfg)
-      + blocksHtml(rowModel(row.cells, prev === null ? null : prev.cells, metrics), rowCells)
-      + '</tr>';
-  }).reverse().join('\n');
-  const nowRow = rows.length === 0 ? '' : '<tr class="now">'
-    + '<th class="c-commit">' + esc(loc.now) + '</th>'
-    + blocksHtml(nowModel(rows[rows.length - 1].cells, metrics), nowCells)
-    + '</tr>';
-  return nowRow + '\n' + body;
-}
-
-export function render(rows, cfg) {
-  const loc = LOCALES[cfg.locale];
-  /* Подпись называет только то, что не меняется от самих служебных коммитов:
-   * число строк и список колонок. Иначе таблица считалась бы устаревшей сразу
-   * после собственного коммита — из-за пересчитанного «пропущено N» в тексте. */
-  return `<!doctype html>
-<html lang="${loc.html}">
-<head>
-<meta charset="utf-8">
-<meta name="viewport" content="width=device-width, initial-scale=1">
-<title>${esc(cfg.title || loc.heading)}</title>
-<style>
-${CSS}
-</style>
-</head>
-<body>
-<h1>${esc(cfg.heading || loc.heading)}</h1>
-<p class="note">${noteText(rows, cfg)}</p>
-<table>
-<thead>
-${tableHead(cfg, loc)}
-</thead>
-<tbody>
-${tableBody(rows, cfg, loc)}
-</tbody>
-</table>
-</body>
-</html>
-`;
-}