letopis 0.20.0 → 0.20.3

package/CHANGELOG.md

@@ -2,6 +2,146 @@
 
 Формат: [Keep a Changelog](https://keepachangelog.com/), версии — semver.
 
+## [0.20.3] — 2026-07-31
+
+### Fixed — релиз доезжает до npm
+
+0.20.2 опубликовался на GitHub, но в npm **не уехал**: шаг заметок падал, а из-за `set -e`
+вместе с ним пропускался `npm publish`.
+
+Причина оказалась не в правах, а в том, откуда GitHub берёт workflow: для события `release`
+файл читается **из коммита, на который указывает тег**, а не из `main`. Тег `v0.20.2` был
+создан до правки, поэтому все перевыпуски крутили старую версию шага — тот, что ходил в PR-API
+и получал `Resource not accessible by integration`. Исправление доехало только с новым тегом.
+
+Сам шаг переписан: тело релиза берётся из `lib/CHANGELOG.md` тем же `scripts/release-notes.mjs`,
+которым собирается описание релизного PR. Зависимости от PR-API нет, из прав нужен только
+`contents: write`. Релиз 0.20.2 удалён как не дошедший до npm — его содержимое здесь, ниже.
+
+## [0.20.2] — 2026-07-31
+
+### Changed — заметки релиза перестали дублироваться
+
+Тело GitHub Release собиралось `git-cliff`-ом, то есть из заголовков коммитов — вместо
+осмысленного описания. Теперь текст живёт в одном месте и переиспользуется по цепочке:
+
+```
+lib/CHANGELOG.md (руками) → описание PR → тело релиза → npm
+```
+
+- `release.yml` при публикации ставит в тело релиза **описание релизного PR** `dev→main`. PR
+  находится по коммиту, на который указывает тег; не нашёлся или пуст — тело не трогается.
+- Новый `lib/scripts/release-notes.mjs` печатает секцию `## [x.y.z]` **текущей** версии пакета —
+  это и есть тело PR:
+  `gh pr create … --body "$(cd lib && node scripts/release-notes.mjs)"`.
+  Версия берётся из `package.json`, а не из аргумента: иначе можно выпустить заметки одной
+  версии под тегом другой. Нет записи для версии — exit 1 с той же подсказкой, что у `check:docs`.
+- `git-cliff` и `cliff.toml` удалены. После перехода на заметки из PR от них оставались только
+  аннотация тега и подсказка про bump: первое даёт обычный `git log`, второе избыточно —
+  забытый бамп и так виден (тег такой версии уже есть → шаг пропускается → релиза нет).
+  Побочно: в job, который делает `npm publish`, больше нет стороннего экшена; из workflow
+  осталось только first-party (`actions/checkout`, `actions/setup-node`).
+
+- `release.yml` берёт тело релиза **тем же скриптом из CHANGELOG**, а не через PR-API. Первая
+  попытка читала описание PR (`gh pr list/view`) и падала `Resource not accessible by
+  integration` — GITHUB_TOKEN на release-событии не получает доступ к PR-API этого репозитория,
+  и `pull-requests: read` не помог. Из-за `set -e` падал весь job, то есть `npm publish`
+  пропускался. Теперь зависимости от PR нет: чекаут стоит на теге, значит CHANGELOG и
+  package.json — ровно той версии, что публикуется; из прав нужен только `contents: write`.
+
+Тег остался **аннотированным** — в сообщении список коммитов от предыдущего тега
+(`git log --no-merges --pretty='- %s'`), так что `git show <tag>` показывает состав версии.
+Шагов в workflow стало меньше: `tag` 3 (было 6), `release` 6 (было 8).
+
+## [0.20.1] — 2026-07-31
+
+### Fixed — движок схемы больше не отстаёт молча
+
+`ddl.sql` растёт аддитивно внутри одной версии движка (в 0.19.0 так появились
+`purge`/`purge_closure`/`purge_account`), а существующая схема этих правок **не получала**:
+приложение обновляло пакет и падало сырым
+`PostgresError: function "v1.booking".purge(...) does not exist`. Обнаружено смоук-тестом
+опубликованного пакета на схеме, накатанной до 0.19.0.
+
+- Последняя строка `ddl.sql` штампует метку `COMMENT ON SCHEMA … IS 'letopis ddl_revision=N'`
+  (последней — чтобы метка не встала при частично применённом файле). `connect()` сверяет её
+  с новой константой `DDL_REVISION` и **один раз на схему за процесс** предупреждает, называя
+  команду апгрейда. Предупреждение, а не отказ: правки аддитивны.
+- Апгрейд движка на месте: `up({ upgrade: true })` и `node db/apply.mjs … --upgrade`
+  перекатывают **только** `ddl.sql` (сиды не трогаются). Безопасно, потому что файл
+  идемпотентен — `CREATE OR REPLACE` у функций, `DROP IF EXISTS` + `CREATE` у триггеров,
+  `IF NOT EXISTS` у таблиц/индексов. Механизм существовал, но был недостижим: `applySchema`
+  при существующей схеме молча выходил.
+- Ревизия ≠ версия схемы: несовместимая правка структуры таблиц по-прежнему означает смену
+  `version` в имени схемы (`v1` → `v2`). README § 10.8a, грабля #18 в шпаргалке.
+
+### Fixed — под `enforceAcl` каждый `db.as()` делал три SELECT вместо одного
+
+Словарь `Resource`/`Rule` одинаков для всех субъектов, но снимался на каждый scope — то есть
+в вебе (scope на HTTP-запрос) два лишних запроса к БД на каждый запрос приложения. Теперь
+снимок берётся один раз на подключение и переиспользуется; per-scope остались чтение своего
+аккаунта и компиляция энфорсера (один энфорсер = один субъект — иначе memo отдаст чужое
+решение). Снимок сбрасывает `db.reloadSchema()`. Провал чтения не кэшируется.
+
+### Added — проверки и воспроизводимость
+
+- `check:docs` — десятая проверка: маркер `-- DDL_REVISION:` в `ddl.sql`, штамп `COMMENT` и
+  константа в `types.ts` обязаны совпадать, а штамп — быть последним выражением файла.
+- `release.yml` — смоук **артефакта** после публикации: пакет ставится из реестра в чистую
+  папку, проверяются ESM-импорт, ключевые экспорты и наличие `dist`/`sql`/`scripts` в тарболе.
+  Тесты гоняют `lib/src`, а в npm уезжает сборка — сломанные `exports`/`files` иначе
+  обнаружил бы первый пользователь.
+- `bench/tenants-seed.mjs` + `bench/isolation.bench.mjs` — многоарендаторный полигон
+  (10 аккаунтов, перекос 50 %…0.3 %, 1 млн строк) и цена изоляции. Таблица README § 10.6
+  была измерена временным скриптом; попутно из неё убрана колонка «без сужения» — это форма
+  SQL, которой в публичном API нет.
+- Тайминги README § 11 перенесены с проанализированного полигона точным сопоставлением по
+  коду вызова (151 из 208; остальные — иллюстративные фрагменты, у них добавлена оговорка).
+- Тесты: 198 (было 193 на 0.20.0). Новые — ревизия движка и апгрейд, `ANALYZE` при накате,
+  кэш словаря ACL. Каждый проверен негативно.
+
+### Changed — на каждое событие ровно одно действие в Actions
+
+Тесты гонялись трижды на одном и том же коммите: прогон от push в `dev`, второй от
+`pull_request` при открытии релизного PR и третий от push в `main` при merge. Причём на merge
+`ci` и `tag` стартовали **одновременно** — тег мог встать раньше, чем закончатся тесты.
+
+Контур приведён к одному действию на событие:
+
+```
+push dev            →  ci  (typecheck + check:docs + 198 тестов)
+merge dev→main      →  tag (аннотированный тег из lib/package.json)
+publish Release     →  release (описание из PR + npm publish + смоук артефакта)
+```
+
+- `ci.yml` — только `push: dev`. Ни `pull_request`, ни `push: main`: релизный PR и сам merge
+  несут ТОТ ЖЕ коммит, что уже проверен на `dev` (ветка всегда пушится до PR). `concurrency` —
+  быстрые последовательные пуши в `dev` отменяют предыдущий прогон.
+- `tag.yml` — `push: main`, тегирует сразу: ждать нечего, тесты прошли на `dev`.
+- убраны шаги `npm run build` + `npm pack` с выгрузкой артефакта: тарбол никто не забирал —
+  `release.yml` публикует сам (`prepublishOnly` гоняет typecheck + build), а результат
+  проверяется смоуком уже из реестра; компиляция дублировала шаг Typecheck. CI — 7 шагов.
+
+**Остаётся настройкой репозитория:** branch protection на `main` с обязательной проверкой
+`test`. Без неё запрет «не мерджить на красном» держится на дисциплине: у PR своей проверки
+нет, гарантию даёт зелёный прогон того же SHA на `dev`.
+
+### Changed — флоу релиза: тег с историей, заметки из PR, без сторонних экшенов
+
+`tag.yml` ставит **аннотированный** тег: в сообщении — список коммитов от предыдущего тега,
+поэтому `git show <tag>` и GitHub → Tags показывают состав версии без GitHub Release.
+
+`release.yml` при публикации ставит в тело релиза **описание релизного PR** `dev→main`: оно
+писалось осмысленно (что и почему, с замерами), в отличие от списка заголовков коммитов. PR
+находится по коммиту, на который указывает тег; если PR не нашёлся или пуст — тело не трогается.
+
+Источник версии — `lib/package.json`: тег обязан равняться тому, что уедет в npm. Забытый бамп
+виден сразу — тег такой версии уже существует, шаг пропускается, релиза нет.
+
+`git-cliff` и `cliff.toml` (заводились по образцу VP) удалены: после перехода на заметки из PR
+от них оставались только аннотация тега и подсказка про bump — первое даёт обычный `git log`,
+второе избыточно. Побочно ушла и зависимость от стороннего экшена в job, который публикует в npm.
+
 ## [0.20.0] — 2026-07-29
 
 ### Fixed — `ANALYZE` при накате схемы: чтения были медленнее на порядок