@dzhechkov/harness-core 0.8.11 → 0.8.21

package/dist/backlog-public.js

@@ -0,0 +1,415 @@
+/**
+ * Публичный снимок бэклога: порождение, а не фильтрация.
+ *
+ * ЗАЧЕМ. Владелец хочет страницу «как строится харнесс в режиме реального времени». Наружу уходит
+ * производное от приватного стора, где каждая из 675 записей несёт полный текст задачи. Тексты не
+ * должны покидать машину никогда.
+ *
+ * ГЛАВНОЕ РЕШЕНИЕ (ADR-001), и оно объясняет форму всего файла: публичный объект НЕ ПРОВЕРЯЕТСЯ
+ * после сборки — он СОБИРАЕТСЯ здесь, перечислением разрешённых агрегатов, и приватное поле просто
+ * ни разу не читается на пути к выходу. Разница практическая: проверяющий поверх готового файла
+ * ловит то, о чём мы подумали, и пропускает поле, которое добавят завтра. Порождение не пропускает
+ * ничего, потому что не знает о существовании остального.
+ *
+ * ФУНКЦИЯ ЧИСТАЯ: два входа — записи и дата, — ни файловой системы, ни часов. Отсюда три свойства
+ * сразу: проверяется без файловой системы; одинаковый вход даёт байт-идентичный выход; и её нельзя
+ * сузить вызовом, потому что сужать нечем (INV-4).
+ *
+ * ИНВАРИАНТ, А НЕ ПЕРЕЧЕНЬ: наружу не уходит величина, ПРИВЯЗАННАЯ К ОДНОЙ ЗАПИСИ.
+ *
+ * Прежняя редакция перечисляла запрещённое — максимум, минимум, процентили — и была неполна:
+ * медиана при НЕЧЁТНОМ числе записей тоже есть значение ровно одной записи, а перечисление её не
+ * называло. Правило, сформулированное перечислением, всегда неполно, и неполнота читается как
+ * разрешение. Переформулировано 2026-09-03 решением владельца, пока в публичном ряду была ОДНА
+ * точка: после второй смена формулировки развела бы историю надвое.
+ *
+ * ЧЕСТНАЯ ГРАНИЦА: правило ОПИСЫВАЕТ, а не запрещает. Медиана при нечётном числе записей остаётся
+ * значением одной записи, и инвариант это честно покрывает — но не предотвращает. Исполнение
+ * машиной (отказ, если центральное значение разделяют менее MIN_GROUP записей) — отдельная работа,
+ * запись бэклога a72bb268.
+ *
+ * Максимум по определению есть значение РОВНО ОДНОЙ записи, то есть та же группа размера один,
+ * ради запрета которой написано правило малых групп. Состязательный рой нашёл это до реализации: 31,33 дня —
+ * тяжёлый выброс на фоне медианы в 2 дня, он переиздавался бы неизменным месяцами и стал бы
+ * устойчивым отпечатком одной идеи в каждом снимке. Вместо них — медиана и гистограмма по корзинам,
+ * и порог применяется к каждой корзине.
+ */
+/** Версия схемы. Живёт В КАЖДОЙ точке ряда, а не только в корне: точка годичной давности должна
+ * читаться новым кодом без потерь (AM-6). */
+export const PUBLIC_SCHEMA = 'backlog-public/1';
+/** Порог малой группы. Два — минимум, при котором счётчик перестаёт быть указателем на одну запись. */
+export const MIN_GROUP = 2;
+/** Корзины времени до терминального состояния, в днях. Границы измерены, а не выбраны: на 288
+ * терминальных записях наполнение 120 · 62 · 84 · 3 · 19, корзин меньше порога ноль. */
+export const TTT_BUCKETS = [
+    ['<1', 0, 1], ['1-3', 1, 3], ['3-7', 3, 7], ['7-14', 7, 14], ['14+', 14, Infinity],
+];
+/** Терминальность — ЯВНЫЙ предикат, а не «есть отметка времени».
+ *
+ * До 2026-09-03 «есть statusTs» было тождественно «запись терминальна» — 288 из 288. Починка
+ * отметки времени в тот день эту тождественность разрушила: `roulette --commit` и `enrich` теперь
+ * тоже её ставят. Неявный фильтр по наличию отметки МОЛЧА включил бы записи в работе и испортил
+ * метрику в день собственного исправления. */
+const TERMINAL = new Set(['shipped', 'dropped']);
+const isTerminal = (r) => TERMINAL.has(r.status);
+const KNOWN_STATUS = new Set(['new', 'enriched', 'in-progress', 'shipped', 'dropped']);
+function daysBetween(a, b) {
+    const t0 = Date.parse(a), t1 = Date.parse(b);
+    if (!Number.isFinite(t0) || !Number.isFinite(t1))
+        return null;
+    const d = (t1 - t0) / 86_400_000;
+    return d >= 0 ? d : null;
+}
+/** Слить группы ниже порога в `other`; вернуть `null`, если и корзина оказалась мала. */
+function collapseSmall(counts) {
+    const small = Object.entries(counts).filter(([, n]) => n < MIN_GROUP);
+    if (small.length === 0)
+        return { counts, skip: null };
+    const otherSum = small.reduce((s, [, n]) => s + n, 0);
+    if (otherSum < MIN_GROUP) {
+        return {
+            counts,
+            skip: `разрез пропущен: ${small.length} групп(ы) ниже порога ${MIN_GROUP}, их сумма ${otherSum} тоже ниже порога`,
+        };
+    }
+    const kept = {};
+    for (const [k, n] of Object.entries(counts))
+        if (n >= MIN_GROUP)
+            kept[k] = n;
+    kept.other = otherSum;
+    return { counts: kept, skip: null };
+}
+/**
+ * Построить публичный снимок.
+ *
+ * @param records разобранные приватные записи — читаются ТОЛЬКО поля `PrivateRecord`
+ * @param snapshotDate дата снимка, `YYYY-MM-DD`; ВХОД, а не обращение к часам (ADR-003)
+ */
+export function buildPublicSnapshot(records, snapshotDate) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(snapshotDate)) {
+        return { ok: false, code: 'SCHEMA_DRIFT', reason: `дата снимка обязана быть YYYY-MM-DD, получено «${snapshotDate}»` };
+    }
+    const statusCounts = {};
+    const effortCounts = {};
+    const goalCounts = {};
+    const tttDays = [];
+    for (const r of records) {
+        if (!KNOWN_STATUS.has(r.status)) {
+            // Неизвестный статус — отказ, а не тихий пропуск: молчание превратило бы новое состояние
+            // в невидимое, и счётчики перестали бы сходиться с итогом без единого сообщения.
+            return { ok: false, code: 'SCHEMA_DRIFT', reason: `неизвестный статус «${r.status}» — схема разошлась с данными` };
+        }
+        statusCounts[r.status] = (statusCounts[r.status] ?? 0) + 1;
+        const e = String(r.effort ?? 'нет');
+        effortCounts[e] = (effortCounts[e] ?? 0) + 1;
+        const g = r.goalId ?? 'нет';
+        goalCounts[g] = (goalCounts[g] ?? 0) + 1;
+        // ЯВНЫЙ фильтр терминальности — см. комментарий к isTerminal.
+        if (isTerminal(r) && r.createdTs && r.statusTs) {
+            const d = daysBetween(r.createdTs, r.statusTs);
+            if (d !== null)
+                tttDays.push(d);
+        }
+    }
+    const effort = collapseSmall(effortCounts);
+    if (effort.skip !== null) {
+        return { ok: false, code: 'SMALL_GROUP', reason: `разрез по усилию: ${effort.skip}` };
+    }
+    const goals = collapseSmall(goalCounts);
+    // Гистограмма: порог применяется к КАЖДОЙ корзине, потому что корзина — такая же группа.
+    const buckets = {};
+    for (const [name, lo, hi] of TTT_BUCKETS)
+        buckets[name] = tttDays.filter((d) => d >= lo && d < hi).length;
+    const smallBucket = Object.entries(buckets).find(([, n]) => n > 0 && n < MIN_GROUP);
+    if (smallBucket) {
+        return {
+            ok: false, code: 'SMALL_GROUP',
+            reason: `корзина «${smallBucket[0]}» содержит ${smallBucket[1]} запись(и) — ниже порога ${MIN_GROUP}`,
+        };
+    }
+    const sorted = [...tttDays].sort((a, b) => a - b);
+    // Медиана по определению, а не «средний по счёту элемент». При ЧЁТНОМ числе значений средних
+    // два, и медиана — их полусумма; `sorted[floor(n/2)]` брал верхний из них.
+    //
+    // Это не педантизм, у ошибки была цена в приватности. Верхний центральный элемент — значение
+    // РОВНО ОДНОЙ записи, то есть та же группа размера один, ради запрета которой написано правило
+    // малых групп (см. шапку). Полусумма двух РАЗНЫХ центральных значений значением ни одной записи
+    // не является — и это единственная форма, в которой правка что-то даёт приватности. Оговорка
+    // несущая: когда два центральных значения СОВПАДАЮТ, полусумма равна им же, и медиана снова есть
+    // значение записей (тест A3 показывает ровно это). Найдено кросс-семейным ревью 2026-09-03:
+    // прежняя редакция комментария обещала больше, чем делает код.
+    // ИЗМЕРЕНО 2026-09-03 на живом сторе: n = 304, центральные 1,9879 и 2,0147, публиковалось 2,01
+    // (значение одной записи), истинная медиана — 2,00.
+    //
+    // ЧЕСТНАЯ ГРАНИЦА, чтобы её не пришлось искать заново: при НЕЧЁТНОМ n медиана по-прежнему есть
+    // значение одной записи — это свойство самого определения, а не дефект.
+    //
+    // СТРОКА КВИТАНЦИИ ЭТО ТЕПЕРЬ ПОКРЫВАЕТ: 2026-09-03 она переформулирована инвариантом «наружу не
+    // уходит величина, привязанная к одной записи» вместо прежнего перечисления. Правка сделана в тот
+    // же день сознательно — в публичном ряду была ОДНА точка, и после второй смена формулировки
+    // развела бы историю надвое.
+    //
+    // НО ПОКРЫВАЕТ — НЕ ЗНАЧИТ ЗАПРЕЩАЕТ. Правило описывает, машина его не исполняет: медиана при
+    // нечётном n уходит наружу как была. Заслон малой группы на саму медиану — запись a72bb268.
+    const median = sorted.length === 0
+        ? null
+        : Number(((sorted.length % 2 === 1
+            ? sorted[(sorted.length - 1) / 2]
+            : (sorted[sorted.length / 2 - 1] + sorted[sorted.length / 2]) / 2)).toFixed(2));
+    const snapshot = {
+        schema: PUBLIC_SCHEMA,
+        snapshotDate,
+        totals: { records: records.length, terminal: records.filter(isTerminal).length },
+        statusCounts,
+        effortCounts: effort.counts,
+        categoryCounts: goals.skip === null ? goals.counts : null,
+        categorySkipReason: goals.skip,
+        ttt: { medianDays: median, buckets },
+        receipt: {
+            checkedFields: Object.keys(statusCounts).length + Object.keys(effort.counts).length
+                + (goals.skip === null ? Object.keys(goals.counts).length : 0) + Object.keys(buckets).length,
+            checkedGroups: Object.keys(effort.counts).length + Object.keys(goals.counts).length + Object.keys(buckets).length,
+            appliedRules: [
+                `MIN_GROUP=${MIN_GROUP}`,
+                'терминальность по статусу, не по наличию отметки',
+                'наружу не уходит величина, привязанная к одной записи',
+                ...(goals.skip !== null ? ['разрез по целям пропущен'] : []),
+            ],
+        },
+    };
+    return { ok: true, snapshot };
+}
+/* ================================================================== */
+/*  ЗАСТАВА НА ВЫХОДЕ (ADR-004) — независимая проверка финальных байтов */
+/* ================================================================== */
+/**
+ * Разобрать то, что СЕЙЧАС уйдёт наружу, и отказать, если что-то не так.
+ *
+ * ЗАЧЕМ ОТДЕЛЬНАЯ ФУНКЦИЯ, если выше уже есть порождение. Порождение защищает СВОЙ выход. Как
+ * только появится второй путь наружу — а он появляется всегда, — эта гарантия его не покроет.
+ * Прецедент сработал 2026-08-30: сессионный хук засеял приватный ключ в каталог сборки за секунды
+ * до пуша, и починкой стала проверка ПО СОДЕРЖИМОМУ выходного дерева, а не доверие сборщику.
+ *
+ * ПОЧЕМУ СВОЙ ПЕРЕЧЕНЬ, А НЕ ИМПОРТ СХЕМЫ. Если бы застава брала перечень у генератора, одна
+ * ошибка проходила бы обе проверки сразу. Копия — сознательное дублирование; их расхождение
+ * ловится тестом и потому становится громким, а не тихим.
+ *
+ * ПЕРЕСЕЧЬ ЕЁ НЕЛЬЗЯ: один аргумент, никаких флагов. Проверка, которую вызывающий может ослабить,
+ * проверкой не является.
+ */
+/** Собственная копия перечня. НЕ импортируется из схемы выше — см. комментарий. */
+const EGRESS_ALLOWED_KEYS = [
+    'schema', 'snapshotDate', 'totals', 'statusCounts', 'effortCounts',
+    'categoryCounts', 'categorySkipReason', 'ttt', 'receipt',
+];
+export function assertPublicSafe(bytes) {
+    let parsed;
+    try {
+        parsed = JSON.parse(bytes);
+    }
+    catch {
+        return { ok: false, code: 'SCHEMA_DRIFT', reason: 'финальные байты не разбираются как JSON' };
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return { ok: false, code: 'SCHEMA_DRIFT', reason: 'публичный снимок обязан быть объектом' };
+    }
+    const obj = parsed;
+    // ОБЯЗАТЕЛЬНЫЕ ПОЛЯ: пустой объект — НЕ чистый снимок.
+    //
+    // Найдено кросс-семейным ревью (Codex gpt-5.6-sol, вердикт F, 2026-09-03): первая редакция
+    // возвращала `{ok:true, checkedKeys:0}` на `'{}'`. Это ровно та форма, против которой написан
+    // весь модуль: проверка выводила «чисто» из ОТСУТСТВИЯ данных, а не из их проверки.
+    for (const required of EGRESS_ALLOWED_KEYS) {
+        if (!(required in obj)) {
+            return { ok: false, code: 'SCHEMA_DRIFT', reason: `обязательное поле «${required}» отсутствует — неполный снимок не считается чистым` };
+        }
+    }
+    // РЕКУРСИВНЫЙ обход, а не только верхний уровень.
+    //
+    // Та же проверка (вердикт F) воспроизвела утечку: `{"receipt":{"text":"ПРИВАТНЫЙ ТЕКСТ"}}`
+    // проходила, потому что застава смотрела ТОЛЬКО верхние ключи, а `receipt` в перечне разрешён.
+    // Дыра существовала в каждом разрешённом поле — ttt, totals, любом. Белый список верхнего уровня
+    // не является белым списком: он проверяет имена дверей, не заглядывая в комнаты.
+    // Перечень покрывает ВСЁ ДЕРЕВО, а не только корень. Первая починка проверяла лишь ФОРМУ
+    // вложенного имени («похоже на техническое») — и короткий приватный текст под именем `text`
+    // проезжал: имя техничное, строка короче порога. Форма имени ничего не гарантирует; гарантирует
+    // только перечень. Ключи-ДАННЫЕ (имена статусов, целей, корзин) перечислить нельзя — они
+    // приходят из данных, — поэтому для них поле объявлено словарём, и проверяется ЗНАЧЕНИЕ: число.
+    const NESTED = {
+        totals: ['records', 'terminal'],
+        ttt: ['medianDays', 'buckets'],
+        'ttt.buckets': TTT_BUCKETS.map(([n]) => n),
+        receipt: ['checkedFields', 'checkedGroups', 'appliedRules'],
+        statusCounts: ['new', 'enriched', 'in-progress', 'shipped', 'dropped'],
+        effortCounts: ['1', '2', '3', '4', '5', 'нет', 'other'],
+        // ЕДИНСТВЕННЫЙ словарь с неперечислимыми ключами: имена целей приходят из данных владельца и
+        // заранее неизвестны. Третий проход ревью показал, почему это опасно: ИМЯ КЛЮЧА само есть
+        // канал — `{"statusCounts":{"PRIVATE_TASK_TEXT":2}}` проходил, потому что проверялись только
+        // форма имени и тип значения. Статусы, усилия и корзины перечислимы, и теперь перечислены.
+        // Для целей форма имени — единственная защита, и она названа слабой прямо здесь.
+        categoryCounts: 'dictionary-of-numbers',
+    };
+    const DICT_KEY_RE = /^[A-Za-z0-9_<>+.-]{1,60}$/;
+    // СВОБОДНАЯ СТРОКА — ЭТО КАНАЛ, даже короткая и даже в разрешённом поле.
+    //
+    // Второй канал, названный тем же ревью: `receipt.appliedRules` — массив строк, и порог длины в
+    // 200 символов пропускал приватный текст, если он короче. Порог ловит ПРОЗУ, но не ловит
+    // короткое сообщение, а утечке достаточно короткого. Поэтому строковые значения проверяются не
+    // длиной, а ПРИНАДЛЕЖНОСТЬЮ: каждое из них либо перечислено, либо имеет машинную форму.
+    const ALLOWED_RULE = /^(MIN_GROUP=\d+|терминальность по статусу, не по наличию отметки|наружу не уходит величина, привязанная к одной записи|разрез по целям пропущен)$/;
+    const ALLOWED_STRING_AT = {
+        schema: /^backlog-public\/1$/,
+        snapshotDate: /^\d{4}-\d{2}-\d{2}$/,
+        categorySkipReason: /^разрез пропущен: \d+ групп\(ы\) ниже порога \d+, их сумма \d+ тоже ниже порога$/,
+        'receipt.appliedRules': ALLOWED_RULE,
+    };
+    const walk = (node, at, depth) => {
+        if (depth > 6)
+            return { ok: false, code: 'SCHEMA_DRIFT', reason: `слишком глубокая вложенность в ${at}` };
+        if (node === null || typeof node === 'number' || typeof node === 'boolean')
+            return null;
+        if (typeof node === 'string') {
+            // Место строки определяет, что ей разрешено. Строка там, где строк не ждут, — отказ; строка
+            // не той формы там, где ждут, — тоже отказ. Длина остаётся вторым рубежом.
+            const base = at.replace(/\[\d+\]$/, '');
+            const pattern = ALLOWED_STRING_AT[base];
+            if (pattern === undefined) {
+                return { ok: false, code: 'FORBIDDEN_FIELD', reason: `строка в ${at} — это поле не объявлено строковым, значит не публикуется` };
+            }
+            if (!pattern.test(node)) {
+                return { ok: false, code: 'FORBIDDEN_FIELD', reason: `строка в ${at} не соответствует объявленной форме: «${node.slice(0, 60)}»` };
+            }
+            if (node.length > 200) {
+                return { ok: false, code: 'FORBIDDEN_FIELD', reason: `строка в ${at} длиной ${node.length} — публичный снимок не носит прозу` };
+            }
+            return null;
+        }
+        if (Array.isArray(node)) {
+            for (let i = 0; i < node.length; i += 1) {
+                const bad = walk(node[i], `${at}[${i}]`, depth + 1);
+                if (bad)
+                    return bad;
+            }
+            return null;
+        }
+        if (typeof node === 'object') {
+            for (const [k, v] of Object.entries(node)) {
+                if (at === '' && !EGRESS_ALLOWED_KEYS.includes(k)) {
+                    return { ok: false, code: 'FORBIDDEN_FIELD', reason: `ключ «${k}» отсутствует в перечне разрешённых` };
+                }
+                if (at !== '') {
+                    const rule = NESTED[at];
+                    if (rule === undefined) {
+                        return { ok: false, code: 'FORBIDDEN_FIELD', reason: `поле ${at} не объявлено в перечне вложенных — его содержимое не проверяется, значит не публикуется` };
+                    }
+                    if (rule === 'dictionary-of-numbers') {
+                        if (!DICT_KEY_RE.test(k)) {
+                            return { ok: false, code: 'FORBIDDEN_FIELD', reason: `ключ словаря «${k}» в ${at} не похож на имя группы` };
+                        }
+                        if (typeof v !== 'number' || !Number.isFinite(v)) {
+                            return { ok: false, code: 'FORBIDDEN_FIELD', reason: `${at}.${k} — словарь счётчиков не носит ничего, кроме чисел` };
+                        }
+                    }
+                    else if (!rule.includes(k)) {
+                        return { ok: false, code: 'FORBIDDEN_FIELD', reason: `вложенный ключ «${k}» в ${at} отсутствует в перечне разрешённых` };
+                    }
+                }
+                const bad = walk(v, at === '' ? k : `${at}.${k}`, depth + 1);
+                if (bad)
+                    return bad;
+            }
+            return null;
+        }
+        return { ok: false, code: 'SCHEMA_DRIFT', reason: `неожиданный тип в ${at}` };
+    };
+    const deep = walk(obj, '', 0);
+    if (deep)
+        return deep;
+    // ПРОВЕРЯТЬ НАДО БАЙТЫ, А НЕ РАЗОБРАННЫЙ ОБЪЕКТ — и это второй урок того же ревью.
+    //
+    // Найдено кросс-семейным ревью (вердикт F, второй проход): вход с ДУБЛИРУЮЩИМ ключом
+    // `{"receipt":{"text":"ПРИВАТНЫЙ ТЕКСТ"},"receipt":{...}}` проходил. JSON.parse оставляет
+    // ПОСЛЕДНИЙ `receipt`, обход видит чистый объект и говорит «чисто» — а наружу уезжают ОБА,
+    // потому что наружу уезжает строка, а не объект.
+    //
+    // Общая форма ошибки: проверяющий смотрел не на тот объект. Наружу уходят БАЙТЫ, значит
+    // проверять надо байты. Способ: сериализовать разобранное обратно и сверить с исходным — всё,
+    // что разбор проглотил (дубликаты ключей, лишние пробелы, комментарии), даст расхождение.
+    const canonical = JSON.stringify(obj);
+    if (canonical !== bytes.trim()) {
+        return {
+            ok: false,
+            code: 'SCHEMA_DRIFT',
+            reason: 'байты не совпадают с их же разбором — в них есть то, чего разбор не видит '
+                + `(дубликат ключа, лишнее форматирование): ${bytes.trim().length} байт против ${canonical.length}`,
+        };
+    }
+    // Каждая опубликованная группа не ниже порога. Проверяется ПО СОДЕРЖИМОМУ, а не по вере в то,
+    // что генератор уже посчитал.
+    let groups = 0;
+    for (const field of ['statusCounts', 'effortCounts', 'categoryCounts']) {
+        const v = obj[field];
+        if (v === null || v === undefined)
+            continue;
+        if (typeof v !== 'object') {
+            return { ok: false, code: 'SCHEMA_DRIFT', reason: `поле ${field} обязано быть объектом счётчиков` };
+        }
+        for (const [k, n] of Object.entries(v)) {
+            if (typeof n !== 'number' || !Number.isFinite(n)) {
+                return { ok: false, code: 'SCHEMA_DRIFT', reason: `счётчик ${field}.${k} не число` };
+            }
+            if (n > 0 && n < MIN_GROUP) {
+                return { ok: false, code: 'SMALL_GROUP', reason: `${field}.${k} = ${n} — ниже порога ${MIN_GROUP}` };
+            }
+            groups += 1;
+        }
+    }
+    // Производная малая группа: если итог минус сумма опубликованных даёт остаток ниже порога, то
+    // этот остаток восстанавливается ВЫЧИТАНИЕМ, и публиковать его нельзя даже неявно.
+    const totals = obj.totals;
+    const total = typeof totals?.records === 'number' ? totals.records : null;
+    if (total !== null) {
+        for (const field of ['statusCounts', 'effortCounts']) {
+            const v = obj[field];
+            if (!v)
+                continue;
+            const sum = Object.values(v).reduce((s, n) => s + n, 0);
+            const remainder = total - sum;
+            if (remainder > 0 && remainder < MIN_GROUP) {
+                return {
+                    ok: false, code: 'DERIVABLE_SMALL_GROUP',
+                    reason: `${field}: итог ${total} минус сумма ${sum} даёт ${remainder} — группа восстанавливается вычитанием`,
+                };
+            }
+        }
+    }
+    return { ok: true, checkedKeys: Object.keys(obj).length, checkedGroups: groups };
+}
+/**
+ * Потолок отсрочки в днях. Три — минимум, при котором ОКНО становится четырёхдневным и движение
+ * перестаёт указывать на один день. НЕ «минимум, при котором разность больше единицы»: так было
+ * написано до 2026-09-03 и это опровергнуто измерением (6 из 6 агрегатов несли разность ровно 1).
+ */
+export const HOLD_CAP_DAYS = 3;
+/**
+ * @param previous значение столбца в ПОСЛЕДНЕМ опубликованном снимке
+ * @param current значение сейчас
+ * @param heldDays сколько дней этот столбец уже отложен
+ */
+export function applyDeltaRule(previous, current, heldDays) {
+    if (previous === null)
+        return { action: 'publish', value: current };
+    const delta = Math.abs(current - previous);
+    if (delta !== 1)
+        return { action: 'publish', value: current };
+    if (heldDays >= HOLD_CAP_DAYS) {
+        return {
+            action: 'publish-aggregated', value: current, overPeriodDays: heldDays + 1,
+        };
+    }
+    return {
+        action: 'hold', heldDays: heldDays + 1,
+        reason: `разность ровно 1 — столбец отложен, чтобы движение не указывало на одну запись (отсрочка ${heldDays + 1} из ${HOLD_CAP_DAYS})`,
+    };
+}
+//# sourceMappingURL=backlog-public.js.map

package/dist/backlog-public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlog-public.js","sourceRoot":"","sources":["../src/backlog-public.ts"],"names":[],"mappings":"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"}

package/dist/backlog-transitions.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Журнал переходов статуса — append-only, по строке на переход.
+ *
+ * ЗАЧЕМ. Запись бэклога хранит РОВНО ОДИН переход: поле `statusTs` перезаписывается на каждом
+ * следующем. Промежуточные переходы, повторные открытия и время, проведённое в каждом статусе,
+ * стираются по построению. Измерено 2026-09-02: из 663 записей отметку несут 288, и все 288 —
+ * терминальные; «сколько идея пробыла в работе» невычислимо ни для одной.
+ *
+ * ПОЧЕМУ ЭТО СРОЧНО, а не «когда дойдут руки». Прошлое невосстановимо: каждый день без журнала
+ * навсегда вычитается из будущей аналитики. Панель можно построить когда угодно — данные для неё
+ * набираются только с того дня, когда начали писать.
+ *
+ * ЧЕГО ЭТОТ ФАЙЛ НЕ ДЕЛАЕТ. Он не восстанавливает историю задним числом и не пытается: 12 случайных
+ * снимков дают 99 переходов, но снимки нерегулярны и делались при СЛИЯНИИ, то есть в моменты,
+ * коррелирующие с активностью. Восстановленное из них — отдельный слой с собственной пометкой, а
+ * не строки этого журнала.
+ *
+ * ФОРМАТ. JSONL: одна строка — один переход, дозапись без чтения всего файла. Порча одной строки
+ * не делает нечитаемым остальное — ровно поэтому не JSON-массив.
+ */
+/** Одна строка журнала: кто, откуда, куда, когда и по какой причине. */
+export interface TransitionRow {
+    /** Идентификатор записи бэклога. */
+    readonly id: string;
+    /** Статус ДО перехода. `null` — запись только что создана. */
+    readonly from: string | null;
+    readonly to: string;
+    /** ISO-время. Передаётся ВЫЗЫВАЮЩИМ, а не берётся из часов: иначе функция нечистая и невоспроизводима. */
+    readonly ts: string;
+    /** Причина, если её назвали. Свободный текст: здесь он уместен, это летопись, а не гейт. */
+    readonly reason?: string | undefined;
+    /** Чем вызван переход: имя команды. Отвечает на вопрос «кто это сделал». */
+    readonly by?: string | undefined;
+}
+/** Путь журнала. Рядом с самим бэклогом, чтобы переезд стора не разлучил их. */
+export declare function transitionLogPath(projectRoot: string): string;
+/**
+ * Дозаписать переход. НИКОГДА не бросает: журнал — наблюдение, а не гейт, и его поломка не должна
+ * ронять команду, которая меняла статус. Возвращает признак успеха, чтобы вызывающий мог сказать
+ * вслух, если запись не легла — молчаливая потеря наблюдения хуже громкой.
+ */
+export declare function appendTransition(projectRoot: string, row: TransitionRow): boolean;
+/**
+ * Прочитать журнал. Битая строка ПРОПУСКАЕТСЯ, а не роняет чтение: файл дозаписывается конкурентно,
+ * и оборванная последняя строка — нормальное состояние, а не повод потерять всю летопись.
+ */
+export declare function readTransitions(projectRoot: string): readonly TransitionRow[];
+//# sourceMappingURL=backlog-transitions.d.ts.map

package/dist/backlog-transitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlog-transitions.d.ts","sourceRoot":"","sources":["../src/backlog-transitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CASjF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CAY7E"}

package/dist/backlog-transitions.js

@@ -0,0 +1,64 @@
+/**
+ * Журнал переходов статуса — append-only, по строке на переход.
+ *
+ * ЗАЧЕМ. Запись бэклога хранит РОВНО ОДИН переход: поле `statusTs` перезаписывается на каждом
+ * следующем. Промежуточные переходы, повторные открытия и время, проведённое в каждом статусе,
+ * стираются по построению. Измерено 2026-09-02: из 663 записей отметку несут 288, и все 288 —
+ * терминальные; «сколько идея пробыла в работе» невычислимо ни для одной.
+ *
+ * ПОЧЕМУ ЭТО СРОЧНО, а не «когда дойдут руки». Прошлое невосстановимо: каждый день без журнала
+ * навсегда вычитается из будущей аналитики. Панель можно построить когда угодно — данные для неё
+ * набираются только с того дня, когда начали писать.
+ *
+ * ЧЕГО ЭТОТ ФАЙЛ НЕ ДЕЛАЕТ. Он не восстанавливает историю задним числом и не пытается: 12 случайных
+ * снимков дают 99 переходов, но снимки нерегулярны и делались при СЛИЯНИИ, то есть в моменты,
+ * коррелирующие с активностью. Восстановленное из них — отдельный слой с собственной пометкой, а
+ * не строки этого журнала.
+ *
+ * ФОРМАТ. JSONL: одна строка — один переход, дозапись без чтения всего файла. Порча одной строки
+ * не делает нечитаемым остальное — ровно поэтому не JSON-массив.
+ */
+import { appendFileSync, mkdirSync, readFileSync, existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+/** Путь журнала. Рядом с самим бэклогом, чтобы переезд стора не разлучил их. */
+export function transitionLogPath(projectRoot) {
+    return join(projectRoot, '.dz', 'backlog', 'status-log.jsonl');
+}
+/**
+ * Дозаписать переход. НИКОГДА не бросает: журнал — наблюдение, а не гейт, и его поломка не должна
+ * ронять команду, которая меняла статус. Возвращает признак успеха, чтобы вызывающий мог сказать
+ * вслух, если запись не легла — молчаливая потеря наблюдения хуже громкой.
+ */
+export function appendTransition(projectRoot, row) {
+    try {
+        const p = transitionLogPath(projectRoot);
+        mkdirSync(dirname(p), { recursive: true });
+        appendFileSync(p, `${JSON.stringify(row)}\n`, 'utf8');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Прочитать журнал. Битая строка ПРОПУСКАЕТСЯ, а не роняет чтение: файл дозаписывается конкурентно,
+ * и оборванная последняя строка — нормальное состояние, а не повод потерять всю летопись.
+ */
+export function readTransitions(projectRoot) {
+    const p = transitionLogPath(projectRoot);
+    if (!existsSync(p))
+        return [];
+    const out = [];
+    for (const line of readFileSync(p, 'utf8').split('\n')) {
+        if (!line.trim())
+            continue;
+        try {
+            const r = JSON.parse(line);
+            if (typeof r?.id === 'string' && typeof r?.to === 'string' && typeof r?.ts === 'string')
+                out.push(r);
+        }
+        catch { /* битая строка пропускается */ }
+    }
+    return out;
+}
+//# sourceMappingURL=backlog-transitions.js.map

package/dist/backlog-transitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlog-transitions.js","sourceRoot":"","sources":["../src/backlog-transitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAiB1C,gFAAgF;AAChF,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,OAAO,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC;AACjE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,GAAkB;IACtE,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;QACzC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,cAAc,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,MAAM,CAAC,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,SAAS;QAC3B,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC;YAC5C,IAAI,OAAO,CAAC,EAAE,EAAE,KAAK,QAAQ,IAAI,OAAO,CAAC,EAAE,EAAE,KAAK,QAAQ,IAAI,OAAO,CAAC,EAAE,EAAE,KAAK,QAAQ;gBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvG,CAAC;QAAC,MAAM,CAAC,CAAC,+BAA+B,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}