letopis 2.0.0 → 3.0.1

package/dist/messages/log.d.ts

@@ -0,0 +1,232 @@
+export declare const log: {
+    'log.bad_level': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'log.bad_logger': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'log.bad_redact': {
+        code: "invalid_data";
+        ru: string;
+        hint: string;
+    };
+    'log.db_error': {
+        code: "internal";
+        ru: string;
+    };
+    'log.logger_failed': {
+        code: "internal";
+        ru: string;
+    };
+    'log.notify_failed': {
+        code: "internal";
+        ru: string;
+    };
+    'log.renew_failed': {
+        code: "no_session";
+        ru: string;
+    };
+};
+/** Уровень события. */
+export type LogEventLevel = 'debug' | 'info' | 'warn' | 'error';
+/** Запись каталога событий: уровень по умолчанию и что значит событие. */
+export interface LogEventInfo {
+    level: LogEventLevel;
+    ru: string;
+}
+/**
+ * Каталог событий логирования — объект (не массив): имя события → `{ level, ru }`, где `level` — уровень события по
+ * умолчанию (`debug`, `info`, `warn`, `error`), `ru` — что значит событие. Тип — `Readonly<Record<LogEventName,
+ * LogEventInfo>>`: `LOG_EVENTS.write.level` — `'info'`, список имён — `Object.keys(LOG_EVENTS)`. Основные события:
+ * connect, close, up, migrate, sync, read, cache.hit, cache.miss, write, delete.preview, delete, restore, tx.*,
+ * auth.login, auth.logout, auth.revoke, auth.switch, watch.start, watch.stop, signal, maintain, warning, error, sql;
+ * остальные — дополнительные.
+ */
+export declare const LOG_EVENTS: {
+    readonly connect: {
+        readonly level: "info";
+        readonly ru: "connect() готов: схема, режим сигналов, кэш, способ входа";
+    };
+    readonly close: {
+        readonly level: "info";
+        readonly ru: "db.close(): пул, подписки и таймеры закрыты";
+    };
+    readonly 'registry.refresh': {
+        readonly level: "debug";
+        readonly ru: "реестр классов перечитан";
+    };
+    readonly 'session.renew': {
+        readonly level: "info";
+        readonly ru: "сессия по ключу сервиса истекла — ключ обменян на новую";
+    };
+    readonly up: {
+        readonly level: "info";
+        readonly ru: "up() завершён: схема поставлена, обновлена или накатана повторно";
+    };
+    readonly 'up.step': {
+        readonly level: "info";
+        readonly ru: "шаг up(): то, что без логгера печатается в консоль";
+    };
+    readonly migrate: {
+        readonly level: "info";
+        readonly ru: "up() обновил ревизию схемы миграциями";
+    };
+    readonly 'tenant.create': {
+        readonly level: "info";
+        readonly ru: "арендатор (и его первый пользователь) заведён или найден";
+    };
+    readonly sync: {
+        readonly level: "info";
+        readonly ru: "syncModels(): классы созданы, изменены или сверены (сухой прогон)";
+    };
+    readonly read: {
+        readonly level: "debug";
+        readonly ru: "терминал чтения цепочки: rows, first, ids, count, paths, versions, агрегаты";
+    };
+    readonly 'cache.hit': {
+        readonly level: "debug";
+        readonly ru: "ответ взят из кэша результатов";
+    };
+    readonly 'cache.miss': {
+        readonly level: "debug";
+        readonly ru: "ответа нет в кэше результатов — запрос к базе";
+    };
+    readonly raw: {
+        readonly level: "debug";
+        readonly ru: "сырой SQL db.sql";
+    };
+    readonly write: {
+        readonly level: "info";
+        readonly ru: "запись цепочкой (create, update, upsert, шаги ролей) или батч";
+    };
+    readonly 'delete.preview': {
+        readonly level: "debug";
+        readonly ru: "предпросмотр удаления: delete() без confirm, ничего не удалено";
+    };
+    readonly delete: {
+        readonly level: "info";
+        readonly ru: "удаление выполнено: состав каскада, сверка с expect";
+    };
+    readonly restore: {
+        readonly level: "info";
+        readonly ru: "восстановление выполнено: восстановленные и пропущенные цели";
+    };
+    readonly load: {
+        readonly level: "info";
+        readonly ru: "db.load(): массовая загрузка завершена";
+    };
+    readonly lock: {
+        readonly level: "debug";
+        readonly ru: "db.lock(): advisory-блокировка в транзакции";
+    };
+    readonly 'tx.begin': {
+        readonly level: "debug";
+        readonly ru: "открыта транзакция: db.begin() или db.transaction()";
+    };
+    readonly 'tx.commit': {
+        readonly level: "debug";
+        readonly ru: "транзакция зафиксирована; с записью (db.begin()) и у db.transaction() — уровень info и detail.writes: доказательство фиксации событий с тем же tx";
+    };
+    readonly 'tx.rollback': {
+        readonly level: "info";
+        readonly ru: "транзакция откачена: явно или из-за ошибки";
+    };
+    readonly 'tx.retry': {
+        readonly level: "warn";
+        readonly ru: "повтор операции после конфликта (взаимная блокировка, сериализация, журнал)";
+    };
+    readonly 'auth.login': {
+        readonly level: "info";
+        readonly ru: "успешный вход: пароль, ключ, код, привязка";
+    };
+    readonly 'auth.fail': {
+        readonly level: "warn";
+        readonly ru: "неудачный вход или неверный второй фактор";
+    };
+    readonly 'auth.logout': {
+        readonly level: "info";
+        readonly ru: "выход: гашение текущей сессии";
+    };
+    readonly 'auth.revoke': {
+        readonly level: "info";
+        readonly ru: "отзыв: сессии по токену, все сессии аккаунта или кред";
+    };
+    readonly 'auth.switch': {
+        readonly level: "info";
+        readonly ru: "auth.switch(): сменён рабочий арендатор сессии";
+    };
+    readonly 'auth.as': {
+        readonly level: "debug";
+        readonly ru: "db.as(): фасад от имени другого аккаунта или арендатора";
+    };
+    readonly 'auth.session': {
+        readonly level: "info";
+        readonly ru: "сервис выпустил сессию пользователю (sessionFor)";
+    };
+    readonly 'auth.credential': {
+        readonly level: "info";
+        readonly ru: "кред заведён или изменён: пароль, ключ, TOTP, код, привязка, флаги";
+    };
+    readonly 'auth.call': {
+        readonly level: "debug";
+        readonly ru: "прочие вызовы db.auth: сведения о сессии, кредах, арендаторах";
+    };
+    readonly 'account.purge': {
+        readonly level: "info";
+        readonly ru: "аккаунт удалён с данными своего арендатора";
+    };
+    readonly 'acl.change': {
+        readonly level: "info";
+        readonly ru: "права изменены: grant, deny, revoke, roles";
+    };
+    readonly 'acl.check': {
+        readonly level: "debug";
+        readonly ru: "проверка или список прав";
+    };
+    readonly 'watch.start': {
+        readonly level: "info";
+        readonly ru: "подписка watch() открыта";
+    };
+    readonly 'watch.fetch': {
+        readonly level: "debug";
+        readonly ru: "подписка прочитала пачку событий журнала";
+    };
+    readonly 'watch.stop': {
+        readonly level: "info";
+        readonly ru: "подписка закрыта";
+    };
+    readonly signal: {
+        readonly level: "debug";
+        readonly ru: "получен сигнал базы (NOTIFY) или слушатель переподключился";
+    };
+    readonly 'signal.send': {
+        readonly level: "debug";
+        readonly ru: "отправлены накопленные сигналы записи";
+    };
+    readonly maintain: {
+        readonly level: "info";
+        readonly ru: "maintain(): обслуживание выполнено или пропущено";
+    };
+    readonly 'mcp.call': {
+        readonly level: "info";
+        readonly ru: "вызов инструмента MCP";
+    };
+    readonly warning: {
+        readonly level: "warn";
+        readonly ru: "предупреждение letopis";
+    };
+    readonly error: {
+        readonly level: "error";
+        readonly ru: "ошибка операции letopis: код, ключ каталога, подробности, причина; штатный отказ (exists, conflict, target_not_found, нарушения данных и т. п.) — уровень warn; у ошибки PostgreSQL — только SQLSTATE и имена объектов схемы";
+    };
+    readonly sql: {
+        readonly level: "debug";
+        readonly ru: "SQL-запрос: текст без значений параметров, время, число строк";
+    };
+};
+/** Имя события логирования. */
+export type LogEventName = keyof typeof LOG_EVENTS;

package/dist/messages/log.js

@@ -0,0 +1,105 @@
+export const log = {
+    // log.ts, makeLog: logLevel не из списка; value — как передан (строка — в кавычках)
+    'log.bad_level': {
+        code: 'invalid_data',
+        ru: "logLevel {value}: ожидается 'debug', 'info', 'warn', 'error' или 'off'",
+        hint: "передать logLevel одной из строк 'debug', 'info', 'warn', 'error', 'off' (по умолчанию 'info')",
+    },
+    // log.ts, makeLog: log — не функция и не объект с методами уровней
+    'log.bad_logger': {
+        code: 'invalid_data',
+        ru: 'log: ожидается функция (событие) => void или объект с методами debug, info, warn, error (pino, console)',
+        hint: 'передать в log функцию или объект логгера (pino, console)',
+    },
+    // log.ts, makeLog: redact — не массив строк
+    'log.bad_redact': {
+        code: 'invalid_data',
+        ru: 'redact: ожидается массив имён полей (строк)',
+        hint: "передать redact списком имён полей, например ['email', 'phone']",
+    },
+    // log.ts, errorFields и causeOf: ошибка PostgreSQL в событии — только SQLSTATE и имена объектов схемы; её текст,
+    // DETAIL, WHERE и HINT могут нести значения параметров и данных и в журнал не идут (полный текст — у самой ошибки)
+    'log.db_error': {
+        code: 'internal',
+        ru: 'ошибка PostgreSQL {sqlstate} (текст, DETAIL, WHERE и HINT базы в журнал не пишутся — они у самой ошибки)',
+    },
+    // log.ts, deliver: исключение в логгере приложения — один раз на процесс в stderr; операция не прерывается
+    'log.logger_failed': {
+        code: 'internal',
+        ru: 'логгер бросил исключение на событии {event}: {message} — событие пропущено, операции это не мешает',
+    },
+    // index.ts, Notifier: отправка сигналов не удалась — предупреждение (warning); повтор — следующим интервалом
+    'log.notify_failed': {
+        code: 'internal',
+        ru: 'сигналы не отправлены: {message} — повтор следующим интервалом',
+    },
+    // index.ts, ctx.renew: обмен ключа сервиса на новую сессию не удался — предупреждение (warning)
+    'log.renew_failed': {
+        code: 'no_session',
+        ru: 'сессия по ключу сервиса истекла, а обмен ключа на новую не удался',
+    },
+};
+/**
+ * Каталог событий логирования — объект (не массив): имя события → `{ level, ru }`, где `level` — уровень события по
+ * умолчанию (`debug`, `info`, `warn`, `error`), `ru` — что значит событие. Тип — `Readonly<Record<LogEventName,
+ * LogEventInfo>>`: `LOG_EVENTS.write.level` — `'info'`, список имён — `Object.keys(LOG_EVENTS)`. Основные события:
+ * connect, close, up, migrate, sync, read, cache.hit, cache.miss, write, delete.preview, delete, restore, tx.*,
+ * auth.login, auth.logout, auth.revoke, auth.switch, watch.start, watch.stop, signal, maintain, warning, error, sql;
+ * остальные — дополнительные.
+ */
+export const LOG_EVENTS = {
+    // подключение
+    'connect': { level: 'info', ru: 'connect() готов: схема, режим сигналов, кэш, способ входа' },
+    'close': { level: 'info', ru: 'db.close(): пул, подписки и таймеры закрыты' },
+    'registry.refresh': { level: 'debug', ru: 'реестр классов перечитан' },
+    'session.renew': { level: 'info', ru: 'сессия по ключу сервиса истекла — ключ обменян на новую' },
+    // установка
+    'up': { level: 'info', ru: 'up() завершён: схема поставлена, обновлена или накатана повторно' },
+    'up.step': { level: 'info', ru: 'шаг up(): то, что без логгера печатается в консоль' },
+    'migrate': { level: 'info', ru: 'up() обновил ревизию схемы миграциями' },
+    'tenant.create': { level: 'info', ru: 'арендатор (и его первый пользователь) заведён или найден' },
+    'sync': { level: 'info', ru: 'syncModels(): классы созданы, изменены или сверены (сухой прогон)' },
+    // чтение
+    'read': { level: 'debug', ru: 'терминал чтения цепочки: rows, first, ids, count, paths, versions, агрегаты' },
+    'cache.hit': { level: 'debug', ru: 'ответ взят из кэша результатов' },
+    'cache.miss': { level: 'debug', ru: 'ответа нет в кэше результатов — запрос к базе' },
+    'raw': { level: 'debug', ru: 'сырой SQL db.sql' },
+    // запись
+    'write': { level: 'info', ru: 'запись цепочкой (create, update, upsert, шаги ролей) или батч' },
+    'delete.preview': { level: 'debug', ru: 'предпросмотр удаления: delete() без confirm, ничего не удалено' },
+    'delete': { level: 'info', ru: 'удаление выполнено: состав каскада, сверка с expect' },
+    'restore': { level: 'info', ru: 'восстановление выполнено: восстановленные и пропущенные цели' },
+    'load': { level: 'info', ru: 'db.load(): массовая загрузка завершена' },
+    'lock': { level: 'debug', ru: 'db.lock(): advisory-блокировка в транзакции' },
+    // транзакции
+    'tx.begin': { level: 'debug', ru: 'открыта транзакция: db.begin() или db.transaction()' },
+    'tx.commit': { level: 'debug', ru: 'транзакция зафиксирована; с записью (db.begin()) и у db.transaction() — уровень info и detail.writes: доказательство фиксации событий с тем же tx' },
+    'tx.rollback': { level: 'info', ru: 'транзакция откачена: явно или из-за ошибки' },
+    'tx.retry': { level: 'warn', ru: 'повтор операции после конфликта (взаимная блокировка, сериализация, журнал)' },
+    // вход и права
+    'auth.login': { level: 'info', ru: 'успешный вход: пароль, ключ, код, привязка' },
+    'auth.fail': { level: 'warn', ru: 'неудачный вход или неверный второй фактор' },
+    'auth.logout': { level: 'info', ru: 'выход: гашение текущей сессии' },
+    'auth.revoke': { level: 'info', ru: 'отзыв: сессии по токену, все сессии аккаунта или кред' },
+    'auth.switch': { level: 'info', ru: 'auth.switch(): сменён рабочий арендатор сессии' },
+    'auth.as': { level: 'debug', ru: 'db.as(): фасад от имени другого аккаунта или арендатора' },
+    'auth.session': { level: 'info', ru: 'сервис выпустил сессию пользователю (sessionFor)' },
+    'auth.credential': { level: 'info', ru: 'кред заведён или изменён: пароль, ключ, TOTP, код, привязка, флаги' },
+    'auth.call': { level: 'debug', ru: 'прочие вызовы db.auth: сведения о сессии, кредах, арендаторах' },
+    'account.purge': { level: 'info', ru: 'аккаунт удалён с данными своего арендатора' },
+    'acl.change': { level: 'info', ru: 'права изменены: grant, deny, revoke, roles' },
+    'acl.check': { level: 'debug', ru: 'проверка или список прав' },
+    // время
+    'watch.start': { level: 'info', ru: 'подписка watch() открыта' },
+    'watch.fetch': { level: 'debug', ru: 'подписка прочитала пачку событий журнала' },
+    'watch.stop': { level: 'info', ru: 'подписка закрыта' },
+    'signal': { level: 'debug', ru: 'получен сигнал базы (NOTIFY) или слушатель переподключился' },
+    'signal.send': { level: 'debug', ru: 'отправлены накопленные сигналы записи' },
+    'maintain': { level: 'info', ru: 'maintain(): обслуживание выполнено или пропущено' },
+    // MCP
+    'mcp.call': { level: 'info', ru: 'вызов инструмента MCP' },
+    // общее
+    'warning': { level: 'warn', ru: 'предупреждение letopis' },
+    'error': { level: 'error', ru: 'ошибка операции letopis: код, ключ каталога, подробности, причина; штатный отказ (exists, conflict, target_not_found, нарушения данных и т. п.) — уровень warn; у ошибки PostgreSQL — только SQLSTATE и имена объектов схемы' },
+    'sql': { level: 'debug', ru: 'SQL-запрос: текст без значений параметров, время, число строк' },
+};

package/dist/messages/mcp.js

@@ -1,7 +1,7 @@
 /** Неизвестное имя класса, алиаса или роли: агенту доступна не db.registry, а letopis_model. */
 const NAME_HINT = 'проверить имя: похожие названы в тексте и в similar, классы, алиасы и концы — letopis_model';
-/** Удаление сорвалось после превью: превью — заново. */
-const PREVIEW_HINT = 'посмотреть превью заново (delete без confirm) и повторить удаление с confirm: true';
+/** Удаление сорвалось после предпросмотра: предпросмотр — заново. */
+const PREVIEW_HINT = 'посмотреть предпросмотр заново (delete без confirm) и повторить удаление с confirm: true';
 /** Неверная опция createMcpServer. */
 const OPTION_HINT = 'исправить опцию createMcpServer: допустимые значения названы в тексте';
 export const mcp = {
@@ -300,7 +300,7 @@ export const mcp = {
     // mcp.ts, write: код операции агента не совпал с превью (detail.operation — нынешний)
     'mcp.delete_operation_changed': {
         code: 'confirmation_required',
-        ru: 'letopis_write: операция изменилась после превью — посмотрите превью заново',
+        ru: 'letopis_write: операция изменилась после предпросмотра — посмотрите предпросмотр заново',
         hint: PREVIEW_HINT,
     },
     // mcp.ts, write: целей удаления не видно
@@ -308,10 +308,10 @@ export const mcp = {
         code: 'target_not_found',
         ru: 'letopis_write: удалять нечего — целей не видно',
     },
-    // mcp.ts, write: в превью есть $action restrict (detail.preview)
+    // mcp.ts, write: в превью есть $action restrict или сводка скрытых строк $hidden restrict (detail.preview)
     'mcp.delete_restricted': {
         code: 'delete_restricted',
-        ru: 'letopis_write: удалению мешают строки с $action: restrict',
+        ru: 'letopis_write: удалению мешают строки с $action: restrict (или скрытые правами — сводка $hidden: restrict)',
     },
     // mcp.ts, confirmDelete (stateError): requestState не той операции, не того пользователя или подделан
     'mcp.delete_foreign_answer': {
@@ -321,7 +321,7 @@ export const mcp = {
     // mcp.ts, confirmDelete (stateError): срок requestState истёк
     'mcp.delete_answer_expired': {
         code: 'confirmation_required',
-        ru: 'letopis_write: удаление не выполнено — подтверждение устарело — посмотрите превью и подтвердите удаление заново',
+        ru: 'letopis_write: удаление не выполнено — подтверждение устарело — посмотрите предпросмотр и подтвердите удаление заново',
         hint: PREVIEW_HINT,
     },
     // mcp.ts, confirmDelete: человек отказал или закрыл окно
@@ -337,7 +337,7 @@ export const mcp = {
     // mcp.ts, write: повторное превью в транзакции разошлось с подтверждённым
     'mcp.delete_data_changed': {
         code: 'confirmation_required',
-        ru: 'letopis_write: данные изменились после подтверждения — посмотрите превью заново',
+        ru: 'letopis_write: данные изменились после подтверждения — посмотрите предпросмотр заново',
         hint: PREVIEW_HINT,
     },
     // mcp.ts, limitsOf: maxRows, maxBytes — не целое из диапазона

package/dist/messages/model.d.ts

@@ -136,11 +136,19 @@ export declare const model: {
         code: "invalid_data";
         ru: string;
     };
+    'model.issue_additional': {
+        code: "invalid_data";
+        ru: string;
+    };
     'model.issue_date': {
         code: "invalid_data";
         ru: string;
     };
-    'model.issue_string_length': {
+    'model.issue_string_too_short': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'model.issue_string_too_long': {
         code: "invalid_data";
         ru: string;
     };
@@ -165,6 +173,16 @@ export declare const model: {
         ru: string;
         hint: string;
     };
+    'model.end_role_system': {
+        code: "invalid_class";
+        ru: string;
+        hint: string;
+    };
+    'model.end_role_taken': {
+        code: "invalid_class";
+        ru: string;
+        hint: string;
+    };
     'model.models_cycle': {
         code: "invalid_class";
         ru: string;
@@ -226,8 +244,29 @@ export declare const model: {
         code: "invalid_query";
         ru: string;
     };
+    'model.cli_unknown_flag': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'model.cli_flag_needs_value': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'model.cli_flag_no_value': {
+        code: "invalid_query";
+        ru: string;
+    };
+    'model.cli_unexpected_arg': {
+        code: "invalid_query";
+        ru: string;
+    };
     'model.types_header': {
         code: "invalid_query";
         ru: string;
     };
+    'model.transform_unsupported': {
+        code: "invalid_class";
+        ru: string;
+        hint: string;
+    };
 };

package/dist/messages/model.js

@@ -168,15 +168,25 @@ export const model = {
     // validate.ts, compileValidator: сообщения нарушений issues[].message — тексты не для ошибки (lmsg), те же, что у базы
     'model.issue_enum': {
         code: 'invalid_data',
-        ru: 'значение не из перечисления',
+        ru: 'значение не из перечисления: допустимо {values}',
+    },
+    // лишний ключ объекта (additionalProperties: false); keys — имена лишних ключей через запятую
+    'model.issue_additional': {
+        code: 'invalid_data',
+        ru: 'лишний ключ {keys}',
     },
     'model.issue_date': {
         code: 'invalid_data',
         ru: 'такой даты не бывает',
     },
-    'model.issue_string_length': {
+    // minLength, maxLength: limit — граница из описания (длина в символах)
+    'model.issue_string_too_short': {
         code: 'invalid_data',
-        ru: 'длина строки вне границ',
+        ru: 'длина строки меньше {limit}',
+    },
+    'model.issue_string_too_long': {
+        code: 'invalid_data',
+        ru: 'длина строки больше {limit}',
     },
     'model.issue_unique_items': {
         code: 'invalid_data',
@@ -202,6 +212,20 @@ export const model = {
         ru: 'syncModels: имя хаба {name} занято методом цепочки или корня db — шаг с таким именем до класса не дойдёт',
         hint: 'дать классу другое имя: зарезервированные имена — в README, «Справочник API → Зарезервированные имена»',
     },
+    // sync.ts, syncModels: роль конца модели занята системным классом (member: User, Tenant → Account; rule: Group,
+    // Object → Resource) и ведёт на другой класс — отказ до записи (база отклонила бы sql-write.end_other_class)
+    'model.end_role_system': {
+        code: 'invalid_class',
+        ru: 'syncModels: имя роли {end} в классе {model} занято системным классом {cls} (там {end} ведёт на {target}) — выберите другое имя роли, например Team вместо Group',
+        hint: 'переименовать роль конца: имена ролей User, Tenant (системный класс member, ведут на Account), Group, Object (системный класс rule, ведут на Resource) можно брать, только если конец ведёт туда же; список — в README, «Зарезервированные имена»',
+    },
+    // sync.ts, syncModels: роль конца модели уже ведёт на другой класс в другом классе арендатора (или в другой модели
+    // того же вызова) — отказ до записи (база отклонила бы sql-write.end_other_class)
+    'model.end_role_taken': {
+        code: 'invalid_class',
+        ru: 'syncModels: роль {end} в классе {model} ведёт на {mine}, а в классе {cls} — на {target}: имя роли одно на арендатора (это имя шага цепочки)',
+        hint: 'дать роли другое имя или направить её на тот же класс, что и в другом классе',
+    },
     // sync.ts, syncModels: родители замыкают круг; cycle — имена моделей через стрелку
     'model.models_cycle': {
         code: 'invalid_class',
@@ -275,9 +299,34 @@ export const model = {
         code: 'invalid_query',
         ru: 'правило {kind} в {path} проверяется только в библиотеке — в базе его нет',
     },
+    // cli.ts, main: ошибка разбора аргументов (node:util parseArgs) — текст по-русски вместо английского текста Node (lmsg,
+    // код не печатается; выход с кодом 2). flag — флаг, как его передали (--aply, -x); arg — лишний аргумент
+    'model.cli_unknown_flag': {
+        code: 'invalid_query',
+        ru: 'неизвестный флаг {flag}; см. letopis --help',
+    },
+    'model.cli_flag_needs_value': {
+        code: 'invalid_query',
+        ru: 'флагу {flag} нужно значение: {flag} <значение> или {flag}=<значение>; см. letopis --help',
+    },
+    'model.cli_flag_no_value': {
+        code: 'invalid_query',
+        ru: 'флаг {flag} не принимает значения — уберите «=…» после него; см. letopis --help',
+    },
+    'model.cli_unexpected_arg': {
+        code: 'invalid_query',
+        ru: 'лишний аргумент {arg}; см. letopis --help',
+    },
     // sync.ts, generateTypes: пометка в первой строке файла типов (после «// ») — текст не для ошибки
     'model.types_header': {
         code: 'invalid_query',
         ru: 'Сгенерировано letopis types — не править руками.',
     },
+    // sync.ts, syncModels: в модели есть преобразование Zod (.trim(), .toLowerCase(), .transform(), z.preprocess …) — база
+    // и валидатор letopis его не исполняют, данные записались бы как есть; rules — пути и виды через запятую
+    'model.transform_unsupported': {
+        code: 'invalid_class',
+        ru: 'в модели есть преобразования Zod, а при записи их никто не исполняет — значение записалось бы как есть; поля с преобразованием: {rules}',
+        hint: 'уберите из модели .trim(), .toLowerCase(), .transform(), z.preprocess() и .pipe() и приводите значение в коде сервиса до записи (например, name.trim()); проверку без изменения значения дают .regex(), .min(), .refine()',
+    },
 };

package/dist/messages/query.d.ts

@@ -3,6 +3,11 @@ export declare const query: {
         code: "invalid_query";
         ru: string;
     };
+    'query.sort_field_data': {
+        code: "invalid_query";
+        ru: string;
+        hint: string;
+    };
     'query.unknown_field': {
         code: "invalid_query";
         ru: string;
@@ -124,6 +129,11 @@ export declare const query: {
         code: "invalid_query";
         ru: string;
     };
+    'query.bad_uuid': {
+        code: "invalid_query";
+        ru: string;
+        hint: string;
+    };
     'query.agg_field': {
         code: "invalid_query";
         ru: string;

package/dist/messages/query.js

@@ -4,6 +4,12 @@ export const query = {
         code: 'invalid_query',
         ru: "sort: поле 'at', 'rev', 'id' или 'data.<путь>', а не '{field}'",
     },
+    // sql.ts, sortSpec: поле sort() похоже на имя поля данных без префикса data. (sort('code'))
+    'query.sort_field_data': {
+        code: 'invalid_query',
+        ru: "sort: поле 'at', 'rev', 'id' или 'data.<путь>', а не '{field}' — может быть, data.{field}?",
+        hint: "поле данных в sort() — с префиксом data.: sort('data.code'); колонки строки — 'at' (время версии), 'rev', 'id'",
+    },
     // sql.ts, checkField: поле фильтра, sort() или агрегата не описано ни в одном классе шага (в 1.5 — предупреждение, с 2.0 —
     // отказ); where — шаг или вызов, как в коде: Shop({ nmae }), sort('data.nmae'), sum('data.nmae')
     'query.unknown_field': {
@@ -150,6 +156,13 @@ export const query = {
         code: 'invalid_query',
         ru: 'after(cursor) требует sort(поле)',
     },
+    // sql.ts, compileFilter: id шага, фильтра { id } или конца — не uuid (раньше — сырая ошибка PostgreSQL 22P02, у
+    // null — TypeError); value — значение, как в коде
+    'query.bad_uuid': {
+        code: 'invalid_query',
+        ru: '{where}: {value} — не uuid',
+        hint: 'id — строка uuid (row.id из ответа или db.idOf(…)); проверьте переменную: undefined и null — не id',
+    },
     // sql.ts, buildRead: агрегат не по полю данных
     'query.agg_field': {
         code: 'invalid_query',

package/dist/messages/sql-core.d.ts

@@ -11,6 +11,11 @@ export declare const sqlCore: {
         code: "acl_denied";
         ru: string;
     };
+    'sql-core.impersonation_no_account': {
+        code: "target_not_found";
+        ru: string;
+        hint: string;
+    };
     'sql-core.impersonation_denied': {
         code: "acl_denied";
         ru: string;
@@ -22,6 +27,7 @@ export declare const sqlCore: {
     'sql-core.bad_api_key': {
         code: "no_session";
         ru: string;
+        hint: string;
     };
     'sql-core.pattern_trailing_backslash': {
         code: "invalid_class";
@@ -83,7 +89,11 @@ export declare const sqlCore: {
         code: "invalid_class";
         ru: string;
     };
-    'sql-core.issue_string_length': {
+    'sql-core.issue_string_too_short': {
+        code: "invalid_data";
+        ru: string;
+    };
+    'sql-core.issue_string_too_long': {
         code: "invalid_data";
         ru: string;
     };
@@ -103,6 +113,10 @@ export declare const sqlCore: {
         code: "invalid_data";
         ru: string;
     };
+    'sql-core.issue_additional': {
+        code: "invalid_data";
+        ru: string;
+    };
     'sql-core.issue_rule': {
         code: "invalid_data";
         ru: string;