letopis 0.20.1 → 0.20.3

package/CHANGELOG.md

@@ -2,6 +2,57 @@
 
 Формат: [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 — движок схемы больше не отстаёт молча
@@ -60,7 +111,7 @@
 ```
 push dev            →  ci  (typecheck + check:docs + 198 тестов)
 merge dev→main      →  tag (аннотированный тег из lib/package.json)
-publish Release     →  release (заметки git-cliff + npm publish + смоук артефакта)
+publish Release     →  release (описание из PR + npm publish + смоук артефакта)
 ```
 
 - `ci.yml` — только `push: dev`. Ни `pull_request`, ни `push: main`: релизный PR и сам merge
@@ -75,18 +126,21 @@ publish Release     →  release (заметки git-cliff + npm publish + см
 `test`. Без неё запрет «не мерджить на красном» держится на дисциплине: у PR своей проверки
 нет, гарантию даёт зелёный прогон того же SHA на `dev`.
 
-### Changed — флоу релиза по логике VP
+### Changed — флоу релиза: тег с историей, заметки из PR, без сторонних экшенов
+
+`tag.yml` ставит **аннотированный** тег: в сообщении — список коммитов от предыдущего тега,
+поэтому `git show <tag>` и GitHub → Tags показывают состав версии без GitHub Release.
 
-`tag.yml` ставит **аннотированный** тег: аннотация несёт changelog коммитов по Conventional
-Commits (`git-cliff`, конфиг `cliff.toml`), так что `git show <tag>` и GitHub → Tags
-показывают состав версии без GitHub Release.
+`release.yml` при публикации ставит в тело релиза **описание релизного PR** `dev→main`: оно
+писалось осмысленно (что и почему, с замерами), в отличие от списка заголовков коммитов. PR
+находится по коммиту, на который указывает тег; если PR не нашёлся или пуст — тело не трогается.
 
-`release.yml` при публикации **сам собирает тело релиза**: тот же `git-cliff`, диапазон — от
-предыдущего **опубликованного** релиза до этого тега (черновики и pre-release не считаются,
-поэтому заметки не теряют коммиты между публикациями). Описание релиза писать руками не нужно.
+Источник версии — `lib/package.json`: тег обязан равняться тому, что уедет в npm. Забытый бамп
+виден сразу — тег такой версии уже существует, шаг пропускается, релиза нет.
 
-Источник версии — `lib/package.json` (тег обязан равняться тому, что уедет в npm); расчёт
-`git-cliff` печатается предупреждением, если бамп забыли.
+`git-cliff` и `cliff.toml` (заводились по образцу VP) удалены: после перехода на заметки из PR
+от них оставались только аннотация тега и подсказка про bump — первое даёт обычный `git log`,
+второе избыточно. Побочно ушла и зависимость от стороннего экшена в job, который публикует в npm.
 
 ## [0.20.0] — 2026-07-29
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "letopis",
-  "version": "0.20.1",
+  "version": "0.20.3",
   "description": "Letopis (летопись): append-only versioned entity store on TimescaleDB with dot-notation chains — every change is a new row, history is first-class (asOf, versions, watch, cascade tombstones)",
   "keywords": [
     "timescaledb",

package/scripts/release-notes.mjs

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+/**
+ * Печатает в stdout секцию CHANGELOG для ТЕКУЩЕЙ версии пакета — тело релизного PR.
+ *
+ *   cd lib && node scripts/release-notes.mjs                     # посмотреть
+ *   gh pr create --base main --head dev --title "Release: …" \
+ *     --body "$(cd lib && node scripts/release-notes.mjs)"        # так и создавать PR
+ *
+ * Зачем: описание PR было единственным местом контура, где текст писался заново, хотя тот же
+ * текст уже есть в lib/CHANGELOG.md — источнике истины версии (его сверяет check-docs.mjs с
+ * package.json). Цепочка становится без дублирования:
+ *
+ *   lib/CHANGELOG.md (руками) → описание PR → тело релиза (release.yml берёт из PR) → npm
+ *
+ * Версия НЕ передаётся аргументом намеренно: берётся из package.json, чтобы нельзя было
+ * выпустить заметки одной версии под тегом другой.
+ */
+//
+// FILE: lib/scripts/release-notes.mjs
+// VERSION: 1.0.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Вырезать из lib/CHANGELOG.md секцию текущей версии пакета и напечатать её — тело релизного PR, из которого release.yml берёт заметки релиза.
+//   SCOPE: чтение package.json + CHANGELOG, извлечение секции, печать в stdout.
+//   DEPENDS: none
+//   LINKS: M-RELEASE-NOTES, V-M-RELEASE-NOTES
+//   ROLE: SCRIPT
+//   MAP_MODE: LOCALS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   section - (local) секция CHANGELOG по версии: от "## [x.y.z]" до следующей "## ["
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v1.0.0 - Новый скрипт: тело релизного PR берётся из CHANGELOG, а не пишется заново]
+// END_CHANGE_SUMMARY
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { join } from 'node:path';
+
+const LIB = fileURLToPath(new URL('..', import.meta.url));
+
+// START_CONTRACT: section
+//   PURPOSE: Достать из текста CHANGELOG секцию конкретной версии (без её заголовка).
+//   INPUTS: { changelog: string - текст lib/CHANGELOG.md; version: string - x.y.z }
+//   OUTPUTS: { string - тело секции; пусто, если версии в файле нет }
+//   SIDE_EFFECTS: none
+//   LINKS: M-RELEASE-NOTES, V-M-RELEASE-NOTES
+// END_CONTRACT: section
+function section(changelog, version) {
+  const start = changelog.indexOf(`## [${version}]`);
+  if (start < 0) return '';
+  const after = changelog.indexOf('\n## [', start + 1);
+  const body = changelog.slice(changelog.indexOf('\n', start) + 1, after < 0 ? undefined : after);
+  return body.trim();
+}
+
+const [pkgRaw, changelog] = await Promise.all([
+  readFile(join(LIB, 'package.json'), 'utf8'),
+  readFile(join(LIB, 'CHANGELOG.md'), 'utf8'),
+]);
+const { version } = JSON.parse(pkgRaw);
+const body = section(changelog, version);
+
+if (!body) {
+  console.error(
+    `release-notes: в lib/CHANGELOG.md нет записи "## [${version}]" — подними версию в ` +
+      'package.json или добавь запись (то же самое проверяет npm run check:docs)',
+  );
+  process.exit(1);
+}
+
+// Ссылку на полный changelog добавляем всегда: релиз читают из GitHub, а не из репозитория.
+process.stdout.write(
+  `${body}\n\n---\n\nПолный changelog — [lib/CHANGELOG.md](https://github.com/alepri51/letopis/blob/main/lib/CHANGELOG.md).\n`,
+);