letopis 0.5.0

package/CHANGELOG.md

@@ -0,0 +1,77 @@
+# Changelog
+
+Формат: [Keep a Changelog](https://keepachangelog.com/), версии — semver.
+
+## [0.5.0] — 2026-07-10
+
+### Changed
+- **Пакет переименован: `entity-chain` → `letopis`** (летопись — append-only хроника; история
+  священна). Первая публикация в npm. Префикс сообщений об ошибках теперь `letopis:`.
+  API не менялся.
+
+### Added
+- Лицензия MIT, keywords, `ARTICLE.md` — статья о проекте.
+
+## [0.4.1] — 2026-07-10
+
+### Changed
+- **Hypertable — только временная размерность** `updated` (чанки 30 дней): hash-размерности
+  partition/class/id убраны. Бенчмарк на 1.1M строк (год истории): точечный доступ равен
+  PK-btree, простые фильтры теряют 10–20%, зато LATERAL-цепочки быстрее в ×2…×140
+  (3-хоповый count: 1 с против 150 с) и 14 чанков/год вместо 93. Существующие БД:
+  пересоздание таблицы (размерность из hypertable не удаляется).
+
+### Added
+- `bench/dimensions.bench.mjs` — сравнение вариантов партиционирования на одинаковых данных
+  (>1.1M строк, реплика сквозных операций API, p50/p95 + чанки + planning time);
+  результаты — `bench/dimensions.results.json`.
+
+## [0.4.0] — 2026-07-10
+
+### Added
+- `db/policies.mjs` — политики хранения Timescale: сжатие чанков старше N (`segmentby` по сущности,
+  история не теряется) + опциональный retention (осознанный drop). Чтение сжатых чанков покрыто тестом.
+- `scripts/schema-sync.mjs` — diff JSON-файла классов и таблицы Schema + отчёт совместимости:
+  живые строки прогоняются новой строгой валидацией ДО применения; `--apply` применяет
+  (lineage пересчитывает триггер).
+- `connect({ onQuery, slowMs })` — наблюдаемость: событие `{mode, classes, ms, rows, slow}`
+  на каждый запрос цепочки; `slowMs` без хука — `console.warn`.
+- `test/api-full.test.ts` — сквозной тест ВСЕХ публичных методов API (15 групп; суммарно 86 тестов).
+
+### Fixed
+- `db/apply.mjs` заменял строку `"booking"` внутри jsonb-сидов (enum `busy.kind` получал имя
+  целевой схемы) — теперь заменяются только идентификаторы схемы. Баг найден schema-sync-ом.
+
+## [0.3.0] — 2026-07-10
+
+### Added
+- `.asOf(t)` — чтение «как было на момент», `.versions()` — полная история сущности.
+- `.after(cursor)` + `cursorOf()` — keyset-пагинация (стабильная на объёме).
+- `scripts/gen-types.mjs` — TS-типы классов и `TypedDb` из таблицы Schema.
+- `connect({enforceAccount})` — жёсткая изоляция арендатора (чтение и запись).
+- `.anonymize(fields)` — GDPR-затирание string-полей + тег `anonymized` (история сохраняется).
+- Операторы `or(...)`/`not(...)`; агрегации `.sum/.avg/.min/.max/.countBy` (считает БД).
+- `.deep(max)` — рекурсивный обход детей (self-hop) одним запросом, `$depth` в Row.
+- `db.watch()` — realtime-события версий (триггер `entity_notify` → LISTEN/NOTIFY).
+
+### Fixed
+- timestamptz возвращается строкой: JS Date терял микросекунды (ломал asOf/cursorOf по updated).
+- Канал `entity_notify` — литерал схемы (на чанках hypertable `TG_TABLE_SCHEMA` — служебный).
+
+## [0.2.0] — 2026-07-10
+
+### Added
+- `db/apply.mjs` — применение движка в любую PG-схему одной командой (замена sed-подхода).
+- CI (GitHub Actions): typecheck + 59 тестов против живого timescaledb + сборка npm-пакета артефактом.
+- `test/real-life.test.ts` — 16 сцен «дня салона»: 4 руки, гонки, переносы, отмены, no-show, walk-in, отчёты.
+- `RESEARCH.md` — обзор 30+ аналогов и gap-анализ.
+
+### Fixed
+- `Класс()` без аргумента = INSERT, `Класс({})` = UPDATE всех в контексте (раньше оба означали INSERT — массовые обновления связей молча создавали строки-сироты).
+- Связи, довешенные после `set()`, больше не участвуют в фильтре поиска целей (только значения записи).
+
+## [0.1.0] — 2026-07-09
+
+Первый срез: append-only движок (Entity/Schema + триггеры CRUD/lineage, FK), dot-цепочки
+(чтение путями, set-билдер с контекст-связями, deep-merge, строгая валидация), транзакции
+с advisory-locks, именованные батчи, auth-таблицы, 43 теста.