letopis 0.20.1 → 0.21.0

package/CHANGELOG.md

@@ -2,6 +2,92 @@
 
 Формат: [Keep a Changelog](https://keepachangelog.com/), версии — semver.
 
+## [0.21.0] — 2026-08-23
+
+### Added — no-history классы: `meta.history: false` (DDL_REVISION 2)
+
+Класс, помеченный в `Schema.meta` флагом `history: false`, хранит **одну актуальную строку
+на id**: новый AFTER INSERT триггер `entity_collapse` после каждой вставки физически удаляет
+более старые версии этого id. Дефолт (`history` отсутствует или `true`) — прежнее поведение,
+все версии копятся; фича строго opt-in, существующие схемы и сервисы не затронуты.
+
+Зачем: у мутабельных статус-сущностей (очереди, outbox — статус живёт в `data`) история
+версий делает jsonb-фильтры неселективными: GIN по `data` матчит каждую версию, что
+когда-либо была в искомом статусе, и сканы растут O(вся история). Под `history:false`
+фильтр матчит только актуальные строки — скан остаётся O(активных) при любом росте данных.
+
+Механика:
+- `entity_collapse` — AFTER INSERT (как `entity_notify`; collapse по алфавиту раньше —
+  один NOTIFY на выжившую строку). In-place UPDATE не годится: Entity — гипертаблица по
+  `updated` (перенос между чанками), а `entity_notify` слушает только INSERT.
+- DELETE старых версий идёт под `letopis.purge='on'` (save+restore флага):
+  `entity_delete` пропущен — без tombstone и каскада. Advisory-lock тем же ключом,
+  что `entity_delete`/`purge`, сериализует конкурентные вставки одного id.
+- `.delete()` под no-history оставляет один tombstone (его `updated` строго больше),
+  `purge()` работает как прежде.
+- Новая серверная функция `compact(partition, class) → bigint` — разовая чистка УЖЕ
+  накопленной истории при переводе класса на `history:false` (оставить последнюю версию
+  каждого id, вернуть число удалённых). Идемпотентна. После вызова — `ANALYZE "Entity"`.
+- `ClassDef.history` в реестре; `.versions()`/`.asOf()` по no-history классу предупреждают
+  в console.warn (один раз на класс+метод за процесс) — результат не отражает историю.
+
+Накат на существующие схемы: `up({ upgrade: true })` или `node db/apply.mjs --upgrade`
+(файл идемпотентен, данные целы); до наката `connect()` предупредит о ревизии (1 → 2).
+
+- `test/no-history.test.ts` — 7 сцен: реестр, схлопывание, соседний history-класс,
+  NOTIFY, tombstone, `compact()`, warning; суммарно 205 тестов.
+
+## [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 +146,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 +161,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/README.md

@@ -3838,6 +3838,9 @@ cd lib && npm test    # весь набор против живого docker (ti
             # idgen         — генерация id по Schema (§ 3.2): v4/v7/v5 из концов и полей,
             #                 гонка без локов, наследование attributes и правила id, гарды
             # integration   — E2E-барбершоп (8 сцен)
+            # no-history    — meta.history=false: одна строка на id (entity_collapse),
+            #                 NOTIFY один на вставку, tombstone цел, compact() идемпотентна,
+            #                 warning на .versions()/.asOf()
             # real-life     — 16 сцен «дня салона»: 4 руки, гонки ×3, переносы, no-show
             # tables        — auth/ACL-таблицы
             # up            — up(): docker-argv, probe-ветка, идемпотентность, fresh,

package/dist/chain.js

@@ -23,6 +23,21 @@ function normalizeFilter(f) {
     return f;
 }
 const clsOf = (steps) => steps.map((s) => s.cls.id);
+// no-history класс (meta.history=false): в БД одна актуальная строка на id — .versions()
+// вернёт её одну, .asOf() отдаст «текущее» вместо point-in-time. Предупреждаем (не бросаем:
+// вызовы могли жить до перевода класса), один раз на класс+метод за процесс.
+const noHistoryWarned = new Set();
+function warnNoHistory(steps, method) {
+    const cls = steps[steps.length - 1]?.cls;
+    if (!cls || cls.history)
+        return;
+    const key = `${cls.id}|${method}`;
+    if (noHistoryWarned.has(key))
+        return;
+    noHistoryWarned.add(key);
+    console.warn(`letopis: .${method}() on no-history class "${cls.id}" (meta.history=false) — ` +
+        `хранится одна актуальная версия на id, результат не отражает историю`);
+}
 /** Внутренний канал: план чужой ленивой цепочки (слот-значения, entity()). */
 export const PLAN = Symbol('letopis.plan');
 const peekPlan = (x) => x !== null && typeof x === 'object' ? x[PLAN] : undefined;
@@ -353,7 +368,10 @@ function makeChain(ctx, steps, mods, batch, nodes = NO_NODES) {
                 case 'sort':
                     return (field, dir) => withMods({ order: field, desc: dir === true || dir === 'desc' });
                 case 'asOf':
-                    return (t) => withMods({ asOf: t instanceof Date ? t.toISOString() : t });
+                    return (t) => {
+                        warnNoHistory(steps, 'asOf');
+                        return withMods({ asOf: t instanceof Date ? t.toISOString() : t });
+                    };
                 case 'withDeleted':
                     return () => withMods({ withDeleted: true });
                 case 'deep':
@@ -406,6 +424,7 @@ function makeChain(ctx, steps, mods, batch, nodes = NO_NODES) {
                 case 'versions':
                     return async () => {
                         guardBatch();
+                        warnNoHistory(steps, 'versions');
                         if (hasOps)
                             return runPlan(ctx, steps, mods, 'versions');
                         const q = buildRead(ctx, steps, mods, 'versions');

package/dist/schema.js

@@ -281,6 +281,7 @@ function buildDef(row, byId) {
         idGen,
         meta: row.meta ?? {},
         abstract: row.meta?.abstract === true || row.meta?.abstract === 'true',
+        history: row.meta?.history !== false && row.meta?.history !== 'false', // дефолт true; только явный false отключает историю
         order: row.order,
         check,
         fieldTypes,

package/dist/types.d.ts

@@ -64,6 +64,8 @@ export interface ClassDef {
     strictEnds: boolean;
     meta: Record<string, unknown>;
     abstract: boolean;
+    /** false — движок хранит одну актуальную строку на id (триггер entity_collapse), .versions()/.asOf() теряют смысл. */
+    history: boolean;
     order: number;
     /** Как генерить id новой сущности (attributes.id). */
     idGen: IdGen;
@@ -285,6 +287,6 @@ export declare function reservedNamesOf(def: {
  * Совпадение константы с маркером `-- DDL_REVISION:` в ddl.sql проверяет
  * `scripts/check-docs.mjs` — иначе одно уедет без другого.
  */
-export declare const DDL_REVISION = 1;
+export declare const DDL_REVISION = 2;
 /** Метка ревизии в комментарии схемы: 'letopis ddl_revision=N' → N; иначе null. */
 export declare function parseDdlRevision(comment: string | null | undefined): number | null;

package/dist/types.js

@@ -104,7 +104,7 @@ export function reservedNamesOf(def) {
  * Совпадение константы с маркером `-- DDL_REVISION:` в ddl.sql проверяет
  * `scripts/check-docs.mjs` — иначе одно уедет без другого.
  */
-export const DDL_REVISION = 1;
+export const DDL_REVISION = 2;
 /** Метка ревизии в комментарии схемы: 'letopis ddl_revision=N' → N; иначе null. */
 export function parseDdlRevision(comment) {
     const m = /letopis ddl_revision=(\d+)/.exec(comment ?? '');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "letopis",
-  "version": "0.20.1",
+  "version": "0.21.0",
   "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`,
+);

package/sql/ddl.sql

@@ -8,10 +8,10 @@
 
 -- FILE: lib/sql/ddl.sql
 -- VERSION: 1.1.0
--- DDL_REVISION: 1   (последняя строка файла штампует её в COMMENT ON SCHEMA; см. там же)
+-- DDL_REVISION: 2   (последняя строка файла штампует её в COMMENT ON SCHEMA; см. там же)
 -- START_MODULE_CONTRACT
 --   PURPOSE: Движок-хранилище PostgreSQL/TimescaleDB — таблицы, Entity-hypertable, индексы и триггеры целостности (валидация, версионирование, каскад-tombstone, lineage, notify).
---   SCOPE: таблицы Schema/Entity/Account/Credential/Resource/Rule + триггеры schema_lineage/entity_check/entity_update/entity_delete/entity_notify.
+--   SCOPE: таблицы Schema/Entity/Account/Credential/Resource/Rule + триггеры schema_lineage/entity_check/entity_update/entity_delete/entity_notify/entity_collapse + compact.
 --   DEPENDS: none
 --   LINKS: M-DDL, V-M-DDL
 --   ROLE: RUNTIME
@@ -571,6 +571,91 @@ CREATE TRIGGER entity_notify
     AFTER INSERT ON "<SCHEMA-NAME>"."Entity"
     FOR EACH ROW EXECUTE FUNCTION "<SCHEMA-NAME>".entity_notify();
 
+-- -----------------------------------------------------------------------------
+-- Триггер 5: no-history — класс с Schema.meta.history=false хранит ОДНУ актуальную
+-- строку на id: после вставки новой версии старые физически удаляются.
+-- Зачем: у мутабельных статус-сущностей (очереди, outbox) история версий делает
+-- jsonb-фильтры неселективными (GIN матчит каждую версию, что когда-либо была в
+-- статусе) — сканы растут O(вся история). Дефолт (meta.history отсутствует/true) —
+-- поведение прежнее, все версии копятся.
+-- Почему AFTER INSERT, а не in-place UPDATE: Entity — гипертаблица по updated
+-- (апдейт time-колонки = перенос между чанками), а entity_notify слушает только
+-- INSERT (in-place UPDATE потерял бы NOTIFY). Оба AFTER INSERT триггера идут по
+-- алфавиту: entity_collapse раньше entity_notify — один NOTIFY на выжившую строку.
+-- -----------------------------------------------------------------------------
+-- START_CONTRACT: entity_collapse
+--   PURPOSE: Для класса с meta.history=false удалить версии старее только что вставленной (одна актуальная строка на id).
+--   INPUTS: { trigger: AFTER INSERT ON Entity (NEW) }
+--   OUTPUTS: { NULL }
+--   SIDE_EFFECTS: DELETE старых версий под letopis.purge='on' (entity_delete пропущен: без tombstone/каскада); pg_advisory_xact_lock на partition|class|id
+--   LINKS: M-DDL, V-M-DDL
+-- END_CONTRACT: entity_collapse
+CREATE OR REPLACE FUNCTION "<SCHEMA-NAME>".entity_collapse() RETURNS trigger
+LANGUAGE plpgsql AS $$
+DECLARE prev text;
+BEGIN
+    -- per-class флаг из Schema.meta (PK-lookup; зеркало чтения abstract в entity_check).
+    -- jsonb ->> отдаёт текст: boolean false -> 'false'.
+    IF NOT EXISTS (SELECT 1 FROM "<SCHEMA-NAME>"."Schema"
+                    WHERE partition = NEW.partition AND id = NEW.class
+                      AND meta->>'history' = 'false') THEN
+        RETURN NULL;                                   -- history-класс (дефолт): версии копятся
+    END IF;
+    -- сериализация конкурентных INSERT одного id: тот же ключ, что в entity_delete/purge.
+    -- Лок транзакционный и реентерабельный — tombstone-INSERT внутри entity_delete
+    -- (он уже держит этот лок) не дедлочится.
+    PERFORM pg_advisory_xact_lock(
+        hashtextextended(NEW.partition || '|' || NEW.class || '|' || NEW.id, 0));
+    -- purge-guard: entity_delete висит с WHEN (letopis.purge IS DISTINCT FROM 'on') —
+    -- DELETE ниже идёт физически, без tombstone и каскада. save+restore, чтобы не
+    -- затереть флаг, выставленный снаружи, до конца транзакции.
+    prev := current_setting('letopis.purge', true);
+    PERFORM set_config('letopis.purge', 'on', true);
+    DELETE FROM "<SCHEMA-NAME>"."Entity" e
+     WHERE e.partition = NEW.partition AND e.class = NEW.class AND e.id = NEW.id
+       AND e.updated < NEW.updated;                    -- выживает ровно вставленная версия
+    PERFORM set_config('letopis.purge', COALESCE(prev, ''), true);
+    RETURN NULL;
+END $$;
+
+DROP TRIGGER IF EXISTS entity_collapse ON "<SCHEMA-NAME>"."Entity";
+CREATE TRIGGER entity_collapse
+    AFTER INSERT ON "<SCHEMA-NAME>"."Entity"
+    FOR EACH ROW EXECUTE FUNCTION "<SCHEMA-NAME>".entity_collapse();
+
+-- -----------------------------------------------------------------------------
+-- compact(): разовая компакция класса — оставить по одной (последней) версии на id.
+-- Для перевода класса на meta.history=false с уже накопленной историей: триггер
+-- entity_collapse останавливает накопление ВПЕРЁД, старые версии убирает compact().
+-- Идемпотентна (повторный вызов вернёт 0). GROUP BY покрыт entity_latest_idx.
+-- Не по ctid: в гипертаблице он не уникален между чанками — только PK-условие.
+-- После вызова: ANALYZE "Entity" (статистика для планировщика гипертаблицы).
+-- -----------------------------------------------------------------------------
+-- START_CONTRACT: compact
+--   PURPOSE: Удалить все версии класса, кроме последней на каждый id; вернуть число удалённых строк.
+--   INPUTS: { p_partition: text; p_class: text }
+--   OUTPUTS: { bigint - удалено строк }
+--   SIDE_EFFECTS: физический DELETE под letopis.purge='on' (SET LOCAL, сброс в '' как в purge)
+--   LINKS: M-DDL, V-M-DDL
+-- END_CONTRACT: compact
+CREATE OR REPLACE FUNCTION "<SCHEMA-NAME>".compact(p_partition text, p_class text)
+RETURNS bigint LANGUAGE plpgsql AS $$
+DECLARE n bigint;
+BEGIN
+    PERFORM set_config('letopis.purge', 'on', true);   -- SET LOCAL: физический DELETE
+    WITH keep AS (
+        SELECT partition, class, id, max(updated) AS mx
+        FROM "<SCHEMA-NAME>"."Entity"
+        WHERE partition = p_partition AND class = p_class
+        GROUP BY partition, class, id)
+    DELETE FROM "<SCHEMA-NAME>"."Entity" e USING keep
+     WHERE e.partition = keep.partition AND e.class = keep.class AND e.id = keep.id
+       AND e.updated < keep.mx;
+    GET DIAGNOSTICS n = ROW_COUNT;
+    PERFORM set_config('letopis.purge', '', true);
+    RETURN n;
+END $$;
+
 -- -----------------------------------------------------------------------------
 -- Метка ревизии движка — ПОСЛЕДНЕЙ строкой: комментарий появляется только если весь
 -- файл применился. Её читает connect() и предупреждает, если схема отстала от либы
@@ -582,7 +667,7 @@ CREATE TRIGGER entity_notify
 -- Несовместимая правка СТРУКТУРЫ таблиц — это смена version в имени схемы (v1 → v2),
 -- а не ревизия.
 -- -----------------------------------------------------------------------------
-COMMENT ON SCHEMA "<SCHEMA-NAME>" IS 'letopis ddl_revision=1';
+COMMENT ON SCHEMA "<SCHEMA-NAME>" IS 'letopis ddl_revision=2';
 
 -- -----------------------------------------------------------------------------
 -- Опционально (включать по мере роста данных):