letopis 1.4.1 → 1.4.2

package/dist/admin.js

@@ -29,8 +29,17 @@ export async function maintain(a, opts = {}) {
         // запуск по расписанию остановлен (close()): следующая пачка не начинается, отчёт — с more: true
         if (i > 0 && opts[MAINTAIN_STOP]?.())
             break;
-        // блокировку берёт сама maintain() базы — строку-замок, которую посторонняя роль не займёт; занята — null
-        const [{ r }] = await runTx(a.txc, (q) => q.unsafe(`select ${a.S}.maintain($1::text::timestamptz, $2::int) as r`, [now, opts.limit ?? 10_000]));
+        // блокировку берёт сама maintain() базы — строку-замок, которую посторонняя роль не займёт; занята — null.
+        // Истёкшие сессии и коды — только в первой пачке (план 2.0, 7.3 №4); схема, функции которой ещё не обновил up()
+        // (нет третьего аргумента, 42883), — прежний вызов: он чистит в каждой пачке
+        const call = (cleanup) => runTx(a.txc, (q) => q.unsafe(cleanup === null
+            ? `select ${a.S}.maintain($1::text::timestamptz, $2::int) as r`
+            : `select ${a.S}.maintain($1::text::timestamptz, $2::int, $3::boolean) as r`, (cleanup === null ? [now, opts.limit ?? 10_000] : [now, opts.limit ?? 10_000, cleanup])));
+        const [{ r }] = await call(i === 0).catch((e) => {
+            if (e.code === '42883')
+                return call(null);
+            throw e;
+        });
         if (r === null) {
             if (i === 0)
                 return { ...report, skipped: true };

package/dist/cache.js

@@ -85,7 +85,8 @@ export class ResultCache {
             return undefined;
         }
         this.st.hits++;
-        return e.value;
+        // копия: правка выданного ответа не портит запись кэша (план 2.0, 7.2 №5)
+        return structuredClone(e.value);
     }
     /** Положить ответ, если с момента снимка не было сигналов о его классах и сессии. */
     set(key, value, classes, session, tok, ttlMs, sessionExpires) {
@@ -100,7 +101,7 @@ export class ResultCache {
         }
         if (this.map.size >= this.max)
             this.map.delete(this.map.keys().next().value);
-        this.map.set(key, { value, classes: [...classes], session, tenant: tok.tenant, expires: Date.now() + ttlMs, sessionExpires });
+        this.map.set(key, { value: structuredClone(value), classes: [...classes], session, tenant: tok.tenant, expires: Date.now() + ttlMs, sessionExpires });
         this.st.stores++;
         return true;
     }

package/dist/chain.d.ts

@@ -122,7 +122,8 @@ export interface ChainCore {
     /**
      * Постраничный вывод по курсору: ответ начинается строго после строки, на которой кончилась прошлая страница, в
      * порядке `sort()` (без `sort()` — ошибка `invalid_query`). Курсор этой строки даёт `cursorOf(строка, поле)` с тем же
-     * полем, что в `sort()`.
+     * полем, что в `sort()`. Листает `rows()`, `ids()`, `versions()` и `paths()` (курсор пути — `cursorOf(путь, поле)`);
+     * `count()`, агрегаты, `diff()` и `blame()` курсор не учитывают.
      */
     after(cursor: Cursor): Chain;
     /**

package/dist/chain.js

@@ -244,8 +244,11 @@ const rowOf = (r) => (r.done ? r.row : toRow(r.row));
 /** Значение слота: id, список id, строка ответа или ленивая цепочка. */
 function slotValue(v) {
     const peek = peekPlan(v);
-    if (peek)
+    if (peek) {
+        // модификатор сразу после глагола вложенной цепочки — тот же отказ, что у терминала (план 2.0, 7.2 №3)
+        checkAfterVerb(peek.steps, peek.mods);
         return { plan: peek.steps, mods: peek.mods };
+    }
     if (v === null || typeof v === 'string')
         return v;
     if (Array.isArray(v))
@@ -398,9 +401,12 @@ export function makeChain(ctx, steps, mods, nodes = NO_NODES) {
                 case 'paths':
                     return async () => {
                         checkAfterVerb(steps, mods);
-                        // q === null — пути из результата глагола: строки уже готовы
+                        // q === null — пути из результата глагола: строки уже готовы. Ключи — в порядке шагов (jsonb хранит их
+                        // по длине), узел последнего шага — последним: по нему cursorOf(путь, поле) берёт курсор (план 2.0, 7.1 №3)
                         const { q, res } = await read(ctx, steps, mods, 'paths');
-                        return res.map((r) => Object.fromEntries(Object.entries(r.path).map(([k, v]) => [k, q === null ? v : toRow(v)])));
+                        if (q === null)
+                            return res.map((r) => r.path);
+                        return res.map((r) => Object.fromEntries(q.keys.map((k) => [k, toRow(r.path[k])])));
                     };
                 case 'rows':
                     return async () => {

package/dist/cli.js

@@ -24,6 +24,7 @@ import { resolve } from 'node:path';
 import { connect, describeText } from './index.js';
 import { syncModels, generateTypes } from './sync.js';
 import { import021 } from './import.js';
+import { LetopisError } from './errors.js';
 const USAGE = `letopis sync <модуль> --dsn <строка> --schema <v2.имя> (--token <токен> | --api-key <ключ>) [--apply]
 letopis types --dsn <строка> --schema <v2.имя> (--token <токен> | --api-key <ключ>) [--out <файл>]
 letopis load <файлы…> --dsn <строка> --schema <v2.имя> (--token <токен> | --api-key <ключ>) [--class <Класс>]
@@ -35,6 +36,8 @@ letopis import --from <строка 0.21> --from-schema <v1.имя> --dsn <ст
   [--rename <Старое>=<Новое>]… [--update] [--commit-every <N>] [--partition <имя>] [--initial]
 letopis mcp --dsn <строка> --schema <v2.имя> --token <токен пользователя> [--write]
   (или LETOPIS_DSN, LETOPIS_SCHEMA, LETOPIS_TOKEN; ключ сервиса --api-key не принимается)`;
+/** Команды CLI: остальное — USAGE с кодом 2 ещё до подключения. */
+const COMMANDS = new Set(['sync', 'types', 'load', 'verify', 'maintain', 'describe', 'import', 'mcp']);
 const isModel = (v) => typeof v === 'object' && v !== null && typeof v.describe === 'function' && typeof v.name === 'string';
 export async function main(argv) {
     const { values, positionals } = parseArgs({
@@ -58,7 +61,12 @@ export async function main(argv) {
         values.schema ??= process.env.LETOPIS_SCHEMA || undefined;
         values.token ??= process.env.LETOPIS_TOKEN || undefined;
     }
-    if (values.help || !cmd || !values.dsn || !values.schema) {
+    // --help — всегда код 0; неизвестная команда — USAGE до подключения к базе (план 2.0, 7.5 №4)
+    if (values.help) {
+        console.log(USAGE);
+        return 0;
+    }
+    if (!cmd || !COMMANDS.has(cmd) || !values.dsn || !values.schema) {
         console.log(USAGE);
         return cmd ? 2 : 0;
     }
@@ -117,7 +125,7 @@ export async function main(argv) {
                 return 2;
             }
             if (values.trust)
-                throw new Error('letopis: removed: --trust снят в 1.0.0 — запрос по целям вне загрузки стоит 0,1–1,3 % её времени');
+                throw new LetopisError('removed', '--trust снят в 1.0.0 — запрос по целям вне загрузки стоит 0,1–1,3 % её времени');
             // несколько файлов — одна загрузка и одна транзакция; в файле — объект на строку
             const rows = [];
             for (const f of files) {

package/dist/errors.js

@@ -17,7 +17,7 @@ export const REMOVED_IN = '1.0.0';
 /** Охранник снесённого API (план, этап 3, п. 11): понятная ошибка с версией и заменой. */
 export function removed(name, replacement) {
     // «опция …» — женского рода; методы и свойства — мужского
-    const verb = name.startsWith('опция ') ? 'снята' : 'снят';
+    const verb = name.startsWith('опция ') ? 'снята' : / и /.test(name) ? 'сняты' : 'снят';
     return new LetopisError('removed', `${name} ${verb} в ${REMOVED_IN} — ${replacement}`);
 }
 /** Данные не проходят описание класса (`invalid_data`). */

package/dist/index.d.ts

@@ -170,8 +170,7 @@ export interface DbCore {
         owner?: string;
         tenant?: string;
     }): Promise<Db>;
-    /** Явная транзакция `read committed`: те же цепочки, `commit()`, `rollback()`, `lock()`, `forUpdate()`. */
-    /** Явная транзакция; `reason` — причина изменения для всех операций блока (план 1.1). */
+    /** Явная транзакция `read committed`: те же цепочки, `commit()`, `rollback()`, `lock()`, `forUpdate()`; `reason` — причина изменения для всех операций блока (план 1.1). */
     begin(opts?: {
         reason?: string;
     }): Promise<DbTx>;

package/dist/index.js

@@ -12,7 +12,7 @@ import { LetopisError, fromDbError, removed } from './errors.js';
 import { Registry } from './registry.js';
 import { AclPasses, ExplicitTx, Notifier, poolExecutor, runTx } from './tx.js';
 import { checkReason } from './write.js';
-import { registerDb } from './internal.js';
+import { limits, registerDb } from './internal.js';
 import { makeAuth } from './auth.js';
 import { makeAcl } from './acl.js';
 import { idOf as idOfClass } from './uuid.js';
@@ -120,13 +120,23 @@ function makeDb(sh, scope, exec, owner, tx) {
                 throw removed('watch(cb) и watch(класс, cb)', 'watch({ from }) — подписка по курсору');
             const reg = scope.registry();
             const classes = o.classes ? [...new Set(o.classes.flatMap((c) => reg.family(c).map((x) => x.name)))] : null;
-            return new Subscription({
-                S: sh.S, exec: poolExecutor(txc), classes,
+            return sh.track(new Subscription({
+                S: sh.S, exec: poolExecutor(txc), classes, onClose: (s) => void sh.subs.delete(s),
+                // не бросает: класс удалили — список, снятый при watch(); иначе ошибка в общем разборе сигналов остановила бы
+                // доставку другим подписчикам
+                ...(o.classes ? { classesOf: () => {
+                        try {
+                            return [...new Set(o.classes.flatMap((c) => scope.registry().family(c).map((x) => x.name)))];
+                        }
+                        catch {
+                            return classes;
+                        }
+                    } } : {}),
                 ...(sh.listen ? {
                     onSignal: (fn) => { sh.signals.add(fn); return () => void sh.signals.delete(fn); },
                     tenant: () => (sh.allTenants ? null : sh.sig.tenantToken(scope.tenant())),
                 } : {}),
-            }, o);
+            }, o));
         },
         cache: {
             clear: () => sh.cache?.clear(),
@@ -152,7 +162,7 @@ function makeDb(sh, scope, exec, owner, tx) {
                 const tenant = r.tenant;
                 const registry = await sh.registryFor(tenant, scoped);
                 if (registry)
-                    return makeDb(sh, { txc: scoped, tenant: () => tenant, registry: () => registry, root: false }, poolExecutor(scoped), nextOwner);
+                    return makeDb(sh, { txc: scoped, tenant: () => tenant, registry: () => sh.registryOf(tenant, registry, scoped), root: false }, poolExecutor(scoped), nextOwner);
                 if (attempt === 3)
                     throw new LetopisError('no_session', 'db.as(): контекст сессии меняется — реестр арендатора не загружен');
                 [r] = await runTx(scoped, (q) => q.unsafe(`select account, tenant from ${sh.S}.ctx()`), { read: true });
@@ -246,6 +256,10 @@ export async function connect(opts) {
     const owner = opts.owner ?? 'letopis_owner';
     try {
         // роль, которая обходит RLS, видела бы данные всех арендаторов (§2.9)
+        // роли владельца нет (опечатка в owner) — понятная ошибка, а не сырая 42704 PostgreSQL (план 2.0, 7.5 №3)
+        const [known] = await sql `select exists (select 1 from pg_roles where rolname = ${owner}) as ok`;
+        if (!known.ok)
+            throw new LetopisError('invalid_data', `connect: роли владельца ${owner} в базе нет — проверьте опцию owner (по умолчанию letopis_owner)`);
         const [role] = await sql `select r.rolsuper, r.rolbypassrls,
         pg_has_role(current_user, ${owner}, 'USAGE') as inherits, pg_has_role(current_user, ${owner}, 'SET') as can_set
       from pg_roles r where r.rolname = current_user`;
@@ -316,8 +330,18 @@ export async function connect(opts) {
                 return null;
             return q.unsafe(`select tenant, rev, data from ${S}.entity where class = 'Class' and tenant in (${S}.ctx_tenant(), '${SYSTEM_ID}')`);
         }, { read: true });
-        // реестры db.as() — общие на арендатора; txc — контекст последнего успешного as() этого арендатора
+        // реестры db.as() — общие на арендатора; txc — контекст последнего успешного as() этого арендатора. Порядок карты —
+        // давность обращения: сверх limits.asRegistries вытесняется самый давний (план 2.0, 7.4 №8 — иначе процесс,
+        // который ходит от имени многих арендаторов, копил бы реестры и перечитывал их все на каждый сигнал классов)
         const others = new Map();
+        let latest = null;
+        const keep = (tenant, entry) => {
+            latest = tenant;
+            others.delete(tenant);
+            others.set(tenant, entry);
+            while (others.size > Math.max(1, limits.asRegistries))
+                others.delete(others.keys().next().value);
+        };
         const loading = new Map();
         // токены классов (режим opaque) — по именам всех реестров подключения
         const tokens = () => sig.setClasses([root.registry, ...[...others.values()].map((o) => o.registry)].flatMap((r) => r.all().map((c) => c.name)));
@@ -343,7 +367,7 @@ export async function connect(opts) {
         const registryFor = async (tenant, txc) => {
             const known = others.get(tenant);
             if (known) {
-                known.txc = txc;
+                keep(tenant, { registry: known.registry, txc });
                 return known.registry;
             }
             // одновременные as() нового арендатора получают один реестр
@@ -355,7 +379,7 @@ export async function connect(opts) {
                         return null;
                     const registry = new Registry();
                     registry.load(rows);
-                    others.set(tenant, { registry, txc });
+                    keep(tenant, { registry, txc });
                     tokens();
                     return registry;
                 })().finally(() => loading.delete(tenant));
@@ -363,6 +387,20 @@ export async function connect(opts) {
             }
             return pending;
         };
+        // фасад db.as() берёт реестр через карту: свежий реестр арендатора, если его перечитал другой as(); вытесненный —
+        // обратно в карту (его снова обновляют сигналы) и перечитать фоном: пока он был вне карты, сигналы его не трогали
+        const registryOf = (tenant, registry, txc) => {
+            const cur = others.get(tenant);
+            if (cur) {
+                if (latest !== tenant)
+                    keep(tenant, cur);
+                return cur.registry;
+            }
+            keep(tenant, { registry, txc });
+            void loadClasses(txc, tenant).then((rows) => { if (rows)
+                registry.load(rows); }).catch(() => { }).finally(tokens);
+            return registry;
+        };
         // ключ сигналов (режимы tenant и opaque) — сессии с правом letopis.signals; без права процесс
         // работает без ключа: арендатора (а в opaque — и класса) в сигнале не различает
         const fetchKey = async () => {
@@ -468,8 +506,9 @@ export async function connect(opts) {
             stamper.unref?.();
         }
         let stopMaintain = null;
+        const subs = new Set();
         const shared = {
-            sql, schema: opts.schema, S, notifier, passes, root, registryFor, refresh, onQuery: opts.onQuery, slowMs: opts.slowMs,
+            sql, schema: opts.schema, S, notifier, passes, root, registryFor, registryOf, refresh, onQuery: opts.onQuery, slowMs: opts.slowMs,
             admin: Boolean(bypass && (role.rolsuper || role.can_set)),
             ownerRole: owner,
             cache,
@@ -477,7 +516,16 @@ export async function connect(opts) {
             allTenants: Boolean(bypass),
             signals,
             listen,
+            subs,
+            track: (s) => {
+                subs.add(s);
+                return s;
+            },
             async close() {
+                // живые подписки закрываются: иначе с чужим пулом (connect({ sql })) они опрашивали бы журнал и после close()
+                // (план 2.0, 7.4 №8)
+                for (const s of [...subs])
+                    s.close();
                 // идущий maintain() по расписанию доделывает пачку: пул закрывается после неё, а не посреди транзакции
                 await stopMaintain?.();
                 resync.stop();

package/dist/internal.d.ts

@@ -10,6 +10,13 @@ export interface DbInternals {
     /** Фасад явной транзакции db.begin(). */
     readonly explicit: boolean;
 }
+/**
+ * Пределы подключения, которых нет в опциях: реестров классов db.as() — не больше asRegistries арендаторов (план 2.0,
+ * 7.4 №8). Тест меняет предел, чтобы проверить вытеснение без тысячи арендаторов.
+ */
+export declare const limits: {
+    asRegistries: number;
+};
 /** Запомнить фасад (зовёт makeDb для каждого фасада, который отдаёт наружу). */
 export declare function registerDb(db: object, info: DbInternals): void;
 /** Свойства фасада; undefined — объект не фасад connect() этого пакета. */

package/dist/internal.js

@@ -4,6 +4,11 @@
  * фасад db обходит RLS, не полагаясь на то, что сообщает о себе сам вызывающий.
  */
 const facades = new WeakMap();
+/**
+ * Пределы подключения, которых нет в опциях: реестров классов db.as() — не больше asRegistries арендаторов (план 2.0,
+ * 7.4 №8). Тест меняет предел, чтобы проверить вытеснение без тысячи арендаторов.
+ */
+export const limits = { asRegistries: 1000 };
 /** Запомнить фасад (зовёт makeDb для каждого фасада, который отдаёт наружу). */
 export function registerDb(db, info) {
     facades.set(db, info);

package/dist/load.js

@@ -26,6 +26,7 @@ import { v5Id } from './uuid.js';
 import { applyDefaults } from './validate.js';
 import { isInc } from './write.js';
 import { ACL_CLASS_NAMES } from './types.js';
+import { isConnectionError, release, rollbackAfter } from './tx.js';
 const SYSTEM_ID = '2eba6d0a-1edd-4bb6-a85a-a703dab49035';
 const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 /** Классы, строки которых первая заливка сохраняет и возвращает: описания классов, аккаунты, членства, права. */
@@ -568,14 +569,15 @@ export async function load(env, input, opts = {}) {
             const classesTouched = new Set();
             // существующие объекты — только в режимах skip и update, одним запросом на пачку и до проверок:
             // пропущенный объект для ссылок на него — вне загрузки (его сверит запрос в конце)
-            const live = new Set();
+            // живые строки пачки: id → класс (existing: 'update' правит только объект того же класса)
+            const live = new Map();
             const past = new Map();
             if (existing !== 'error' && !opts.withHistory) {
                 for (let b = 0; b < portion.length; b += batch) {
                     const ids = portion.slice(b, b + batch).map((i) => p1[i].id);
                     const lock = existing === 'update' ? ' order by e.id for no key update' : '';
-                    for (const r of await conn.unsafe(`select e.id from ${S}.entity e where e.id = any ($1::uuid[])${lock}`, [ids]))
-                        live.add(r.id);
+                    for (const r of await conn.unsafe(`select e.id, e.class from ${S}.entity e where e.id = any ($1::uuid[])${lock}`, [ids]))
+                        live.set(r.id, r.class);
                     for (const r of await conn.unsafe(`select distinct on (l.id) l.id, l.rev, l.hash, l.at::text as at from ${S}.log l
               where l.id = any ($1::uuid[]) order by l.id, l.rev desc`, [ids]))
                         past.set(r.id, r);
@@ -690,12 +692,13 @@ export async function load(env, input, opts = {}) {
         }
         catch (e) {
             failed = e;
+            // обрыв: в мёртвое соединение не пишут и в пул его не возвращают (план 2.0, 7.4 №7)
             if (!ini)
-                await conn.unsafe('rollback').catch(() => { });
+                await rollbackAfter(conn, e);
         }
         finally {
             if (!ini)
-                conn.release();
+                release(conn, failed);
         }
         if (failed) {
             const err = failed;
@@ -848,6 +851,13 @@ export async function load(env, input, opts = {}) {
             if (!sh || issues.any)
                 continue;
             if (live.has(id)) {
+                // строка с тем же id, но другого класса (класс без ключа после reclass, повторный импорт по $ext): правка
+                // прошла бы мимо триггеров с данными, проверенными по чужой схеме, — exists (план 2.0, 7.2 №4)
+                const was = live.get(id);
+                if (was !== cls.name) {
+                    issues.add({ line: i + 1, code: 'exists', message: `объект с этим id уже есть в классе ${was}: строка класса ${cls.name} его не правит`, id, class: cls.name });
+                    continue;
+                }
                 updates.push({ id, data: sh.data, links: sh.links, tags: sh.tags ?? null, line: i + 1 });
                 continue;
             }
@@ -1068,6 +1078,7 @@ export async function initialSession(env, fn, tune = {}) {
     const ident = (n) => `"${n.replace(/"/g, '""')}"`;
     const conn = await env.sql.reserve();
     const q = (text, params = []) => conn.unsafe(text, params);
+    let initialFailure = null;
     try {
         await q('begin isolation level read committed');
         await q(`set local role ${ident(env.ownerRole)}`);
@@ -1177,10 +1188,12 @@ export async function initialSession(env, fn, tune = {}) {
         return out;
     }
     catch (e) {
-        await q('rollback').catch(() => { });
+        initialFailure = e;
+        if (!isConnectionError(e))
+            await q('rollback').catch(() => { });
         throw e instanceof LetopisError ? e : fromDbError(e);
     }
     finally {
-        conn.release();
+        release(conn, initialFailure);
     }
 }

package/dist/mcp.js

@@ -78,7 +78,7 @@ const describeQuery = (o) => [
     'Чтение JSON-цепочкой, без SQL. Старт: class (класс, алиас или роль) и filter, id или ids.',
     'steps — переходы по связям: [{ step: "Роль или Класс", filter? | id? | ids? }].',
     'Фильтр: { поле: значение } — равенство; вложенные поля — вложенным объектом; конец — { Роль: id };',
-    'операторы — { поле: { $gt: 5 } }: $ne, $gt, $gte, $lt, $lte, $between [a, b], $in [..], $like, $ilike, $starts, $ends, $has, $hasAny [..], $hasAll [..], $exists true|false, $isNull true, $not; ИЛИ — { $or: [фильтр, …] }.',
+    'операторы — { поле: { $gt: 5 } }: $ne, $gt, $gte, $lt, $lte, $between [a, b], $in [..], $like, $ilike, $starts, $ends (% и _ в значении $starts и $ends — шаблон LIKE, не экранируются), $has, $hasAny [..], $hasAll [..], $exists true|false, $isNull true, $not; ИЛИ — { $or: [фильтр, …] }.',
     'Модификаторы: asOf (момент ISO — срез на дату), withDeleted, sort { field: "at" | "rev" | "id" | "data.<путь>", dir }, limit, cursor (из прошлого ответа).',
     'terminal: rows (по умолчанию), first, ids, count, sum, avg, min, max, countBy — с field "data.<путь>".',
     `Ответ — не больше ${o.maxRows} строк и ${o.maxBytes} байт; дальше — cursor. Без sort строки идут по id. Только чтение.`,
@@ -522,7 +522,9 @@ async function query(db, a, o) {
     const got = await chain.limit(want + 1).rows();
     const page = got.slice(0, fit(got.slice(0, want), o));
     const more = got.length > page.length;
-    const next = more && page.length ? encodeCursor({ f: field, d: dir, ...cursorOf(page[page.length - 1], field) }) : undefined;
+    const last = more && page.length ? cursorOf(page[page.length - 1], field) : undefined;
+    // курсор MCP — { f, d, v, id }: списки rows и ids листаются без rev (он разводит только версии)
+    const next = last ? encodeCursor({ f: field, d: dir, v: last.v, id: last.id }) : undefined;
     const body = terminal === 'ids' ? { ids: page.map((r) => r.id) } : { rows: page };
     return ok({ ...body, count: page.length, more, ...(next ? { cursor: next } : {}) });
 }

package/dist/model.js

@@ -64,6 +64,8 @@ export function many(target, opts = {}) {
     return new End(targets, { many: true, required: (opts.min ?? 0) > 0, min: opts.min, max: opts.max, onDelete: opts.onDelete });
 }
 const NAME = /^[A-Za-zА-Яа-яЁё_][A-Za-zА-Яа-яЁё0-9_]{0,62}$/;
+/** Ключи полной формы описания класса (ClassDef). */
+const DEF_KEYS = new Set(['alias', 'extends', 'abstract', 'ends', 'fields', 'key', 'onDelete', 'history', 'ownerDefault', 'cache', 'meta', 'derivedBy', 'aggregate']);
 function isZod(v) {
     return typeof v === 'object' && v !== null && '_zod' in v;
 }
@@ -94,7 +96,11 @@ function makeModel(kind, name, defArg, optsArg) {
         throw new LetopisError('invalid_class', `имя класса ${name} недопустимо`);
     // короткая форма: hub(name, { поле: z…, … }, { key, meta, … })
     let def;
-    const isShape = defArg && typeof defArg === 'object' && Object.values(defArg).length > 0 && Object.values(defArg).every(isZod);
+    // { fields: z.object(…) } без других ключей описания — полная форма, а не класс с единственным полем fields (план 2.0,
+    // 7.5 №2); короткая форма — все значения Zod и хотя бы один ключ вне описания класса
+    const fullForm = !!defArg && typeof defArg === 'object' && defArg.fields instanceof z.ZodObject
+        && Object.keys(defArg).every((k) => DEF_KEYS.has(k));
+    const isShape = !fullForm && defArg && typeof defArg === 'object' && Object.values(defArg).length > 0 && Object.values(defArg).every(isZod);
     if (optsArg !== undefined || isShape) {
         def = { ...optsArg, fields: (defArg ?? {}) };
     }

package/dist/project.d.ts

@@ -195,6 +195,10 @@ export declare class Projector {
     /** Источники арендатора без журнала (history: false): их изменений проектор не увидит — арендатор выбывает. */
     private blind;
     private stale;
+    /** Когда состав читался в последний раз: без LISTEN сигнала о новых классах нет (план 2.0, 7.4 №6). */
+    private resolvedAt;
+    /** Участники, которых чекпоинт ещё не знает: им начальная перестройка пачками (tenantWork). */
+    private newcomers;
     /** В чекпоинте есть начатая перестройка арендатора пачками (по последней пачке; до первой — проверить). */
     private tenantsPending;
     private running;
@@ -208,6 +212,11 @@ export declare class Projector {
     /** Проходов подряд, в которых запись арендатора упиралась в lockTimeout (lockRetries). */
     private readonly lockHits;
     private readonly only;
+    /**
+     * Перечитать состав: по сигналу классов, а без LISTEN (сигналов нет) — не реже раза в 5 с, как реестр подключения в
+     * режиме none, и в начале run() (план 2.0, 7.4 №6): иначе арендатор, вступивший после запуска, не участвовал бы.
+     */
+    private due;
     constructor(env: ProjectorEnv, name: string, def: ProjectorOptions);
     /**
      * Догнать журнал и следовать за ним до stop(); { once: true } — только догнать. Первый запуск (проекции