=== Операторский GC журнала идемпотентности (проверка детерминированного SQL)
captured_at 2026-10-15T20:25:04Z
commit: 06431d824bea50776d91836fded8788f3066f877

Сценарий: в журнал вставлены две записи одного пользователя — просроченная
(created_at = now() - 2 days) и свежая (created_at = now()); затем выполнен
операторский прогон GC внутри контейнера API и проверено, что удалена ровно
просроченная запись. Команда (из корня репозитория):
  docker compose --env-file .env exec -T api node dist/messages/idempotency/idempotency-gc.cli.js
На хосте без Docker: npm run idempotency:gc (нужен доступный DATABASE_URL).

--- вставка записей: INSERT 0 1 / INSERT 0 1, всего 2
--- вывод GC: Purged 1 idempotency key(s) older than 86400 seconds
--- проверка после GC: expired_left=0, fresh_left=1 (свежая запись не тронута)

Порог берётся из IDEMPOTENCY_TTL_SECONDS (по умолчанию 86400 s = 24 ч, как
требует контракт); фоновый проход с тем же SQL выполняется на реплике не чаще
одного раза на 512 успешных записей под pg_try_advisory_xact_lock.
