textmachine/frontend/docs/frontend-PROGRESS.md

Журнал зоны «Фронт»

Файл переименован 04.08 по слову владельца: был PROGRESS.md, стал frontend-PROGRESS.md. Причина — путаница с docs/PROGRESS.md оркестратора: два файла с одним именем в одном дереве, и ссылка «PROGRESS.md» без пути читалась по-разному в разных доках.

Оркестратору: прогресс фронта пишется СЮДА же, в этот файл, а не в docs/PROGRESS.md — так у зоны один журнал и конфликтов правок в общем файле не возникает (слово владельца 04.08).

Зонный журнал: сессии фронта пишут сюда сами и работают независимо (решение владельца 02.08). Хвосты — BACKLOG.md, план и замеры — FRONTEND_PLAN.md, ратифицированные пины — STACK_DECISIONS.md, контракт API — спека api-contract/openapi.yaml и спутник API_CONTRACT_DRAFT.md (API_CONTRACT_INPUT.md — исполненный вход, под ⚠-баннером). Сверху — текущее состояние, ниже — хроника по сессиям.

Текущее состояние

Запись оркестратора №15, 07.08. Абзацы ниже — состояние на 04.08, и первый из них с тех пор УСТАРЕЛ: «замок на входе закрыт, контракта API v0 нет» больше не так. Контракт ратифицирован D39.99, канон — docs/architecture/14-api-contract/ (спека + компаньон-README), зонная копия api-contract/openapi.yaml — байт-зеркало канона. Вторая сторона контракта, платформа, написана, принята и залендена (D39.109): вход через OIDC, сессии, кредитный леджер, админ-CLI. Строка 95 единого бэклога закрыта.

S3 ИСПОЛНЕН и ПРИНЯТ D39.115 (60595f6); промт отработан и заархивирован. Было в этой строке до 08.08: «запускается по слову владельца, промт готов» (S3_SESSION_PROMPT.md) и с 07.08 несёт три новых пункта списка правок спеки: А-нуль — шапка info спеки исправлена мной (три дня она называла себя нератифицированным черновиком S3 и ссылалась на несуществующий рядом компаньон; S3 остаётся бампнуть version) · В-трис — управляемый потолок прогона, решение владельца 07.08 (шкала в ИНТЕРФЕЙСЕ от минимума до доступного остатка, единица — ГЛАВЫ, не доллары, иначе это амендмент D39.84; максимум = баланс минус открытые холды ⚠ ФОРМУЛА ОШИБОЧНА, superseded D39.115 п.2(а): максимум = Balance КАК ЕСТЬ, холд уже дебет (вычитание дважды резало шкалу; испр. D39.125); носитель пересчёта «главы → деньги» — платформа, ручка объявляется правкой спеки) · В-кватер — фронт живёт на ТОМ ЖЕ origin, что платформа: CORS-слоя в ней нет вовсе, preflight OPTIONS с чужим Origin получает 401 от гарда сессии (замер на живом бинаре, PD-96 регистра платформы) ⇒ в деве ходить через прокси dev-сервера, кросс-origin не проектировать.

Мелочь зоны, которую стоит закрыть при следующем касании: API_CONTRACT_DRAFT.md — второй экземпляр компаньона; канон компаньона теперь docs/architecture/14-api-contract/README.md, поэтому зонному файлу нужен баннер-указатель, иначе это второй носитель одного состояния.

Запись оркестратора №15, 08.08 (после приёмки S3) — СЛОВО ВЛАДЕЛЬЦА О КАЧЕСТВЕ, гейт на S4. Владельцу НЕ нравится текущее качество фронта; названная претензия — «логика спама вкладками»: вкладки обязаны работать ровно как в VS Code — одиночный клик открывает PREVIEW-вкладку, следующий одиночный клик ЗАМЕЩАЕТ её содержимое (новая вкладка не плодится), пин вкладки — по двойному клику/взаимодействию с содержимым. Полный список претензий владелец сформулирует отдельным входом — этот абзац лишь первый пункт, НЕ весь список. Диспозиция оркестратора: S4 НЕ стартует до списка; когда список придёт — сначала «S3.5 фикс-пак оболочки» (вкладки по VS Code-модели + Ф-19 прокрутка + список владельца), затем S4 на починенной оболочке. Промт S3.5 выдаёт оркестратор по слову владельца.

Запись оркестратора №16, 09.08 — список владельца ПРИШЁЛ, промт S3.5 ВЫДАН. Абзац выше исполнен: полный список претензий (24 замечания, снятые владельцем с живого прогона витрины) получен 09.08 и завёрнут в промт S35_SESSION_PROMPT.md (эта папка): VS Code-модель вкладок + Ф-19 + все 24 номера блоками, приёмка кадрами ДО/ПОСЛЕ и playwright-сценариями, референс драг-ручки — vojo (src/app/components/page/Page.tsx:191-300, style.css.ts:11-70). Запуск сессии — по слову владельца; S4 остаётся гейчен до приёмки S3.5. Попутное: замечание (10) владельца независимо подтвердило Ф-21 — полоска замечания нечитаема без слова; само слово ступени — по-прежнему В-3 на владельце. Референс antigravity_add_folder.png докинут владельцем 09.08 (модал добавления книги, замечание (12)).

Запись фронт-сессии S3, 08.08. Абзац «S3 НЕ сделана: замок закрыт» ниже — состояние на 04.08, и он УСТАРЕЛ целиком: замок открыт, S3 сделана. Хроника — первым разделом ниже. Коротко: src/api/ асинхронен и разговаривает HTTP; MSW стоит СЕТЕВЫМ моком, поэтому приложение делает настоящий fetch и настоящий EventSource; фикстур шесть миров, по маршруту на каждый; живой прогресс идёт по SSE и двигает счётчик в браузере (замерено, не предположено); types.ts удалён, экраны живут на типах контракта; ветка неизвестного значения стоит на шве. Спека бампнута до 0.2.0 со всем списком правок промта — канон правит оркестратор по канон docs/architecture/14-api-contract/ (патч ПРИМЕНЁН и удалён, D39.115). Ф-15 и Ф-22 закрыты, заведены Ф-26..Ф-31. npm run check — 7 шагов, 108 тестов на 08.08 (число живёт в батарее, а не здесь: сверяется прогоном), зелёный; npm run shot — шесть маршрутов, гейт доступности зелёный на всех.

Запись фронт-сессии S3.5, 09.08. Фикс-пак оболочки по 24 замечаниям владельца ИСПОЛНЕН — прогон по всем номерам первым разделом хроники ниже. Коротко: вкладки живут по модели VS Code (предпросмотр/закрепление), Ф-19 закрыта keep-alive панелей, полоска ресайза больше не залипает (причина найдена в коде библиотеки), настройки и добавление книги открываются модальными окнами, лупа стала палитрой быстрого перехода, банк перепридуман со спойлерами по окну применимости, кнопка-заглушка «Подписать банк» снята в пользу честного состояния, палитра ушла в тёплый подтон (три варианта кадрами), причина «шакальных» иконок найдена в сетке набора и вылечена. Гейты зелёные, контраст axe — ноль узлов на всех семи маршрутах (Ф-11 закрыта замером). Адверсариальное ревью тремя линзами исполнено, находки и диспозиции — там же; две из них были моими дефектами по существу (правка полос увела ОТ референса; тронуто слово паузы, закреплённое за владельцем) и откачены. Ждут владельца: В-7 (масштаб интерфейса), В-8 (слово состояния в дереве), Ф-38 (защита вкладки «Замечания»), выбор палитры. Ждёт оркестратора: два черновика правки спеки — поля банка и BookIntake.title (в конце записи S3.5).

Запись фронт-сессии S3.6, 10.08. Второй круг замечаний владельца (10 пунктов, снятых с прогона после S3.5) отработан. Коротко: палитра переведена на НЕЙТРАЛЬНЫЙ ряд, снятый замером с fleet_2.png и antigravity_*.png (тёплый подтон S3.5 был моей отсебятиной ПРОТИВ этих же референсов); вкладки перестроены по замеру fleet_2 — полоса вкладок это ХРОМ, активная вкладка вырезана из него цветом полотна; найдена и починена причина обрезки коротких названий; ручка ресайза перенесена из vojo дословно, включая числа упоров; линия жёлоба читалки — в цвет оболочки, ширина набора отпущена по окну; банк памяти переделан в таблицу и открывается вкладкой в центре, спойлер снят с ПЕРЕВОДА и поставлен на описание; иконки книги и главы разведены и несут состояние цветом. Первым разделом записи — АУДИТ всех 24 буллетов S3.5 по коду (просьба владельца), с честными вердиктами второго круга. Ждут не меня: две дыры платформы/контракта под банк (ниже, «Жалобы») и подписной механизм S5.

Сессия S3.6 ЗАКРЫТА 10.08 (разделы 12–15 хроники). Дерево готово к лендингу, фронт не коммитит. Гейты: npm run check:full зелёный — 160 тестов, 7 маршрутов, 7 сценариев, ноль блокирующих нарушений axe, драг панели p90 17 мс. Новые строки бэклога Ф-49…Ф-51 (свежесть текста главы · потерянные кадры потока · resync сбрасывает один гард из двух) заведены по ресёрчу отдельным агентом и проверены по коду; два моих собственных предложения тот же ресёрч опроверг, и это записано в разделе 15 вместе с долгами сессии.

Четвёртый круг замечаний, 10.08 (раздел 12 хроники). Четыре бага владельца по таблице банка закрыты, и один из них был МОЙ механизм: заморозка ширин (useSettledWidth) оставляла таблицу сжатой после драга, а перезамер показал, что она ничего не покупала — драг держит p90 17 мс и без неё. Ширины отданы алгоритму библиотеки, содержимое меряется канвасом по всему банку и идёт ПОТОЛКОМ столбца. Спойлер описания переделан с фильтра на боксе на размытие глифов. Сверх списка владельца найдено шесть дефектов того же класса — в том числе замер по запасному шрифту (−4.7% ширины) и живой getComputedStyle, обнулявшийся за время загрузки шрифтов. Приёмка: 158 тестов, 7 сценариев, 4 новые проверки, каждая падает на откате своего фикса.

Запись оркестратора, 10.08 — ПРИЁМКА S3.6: принято и залендено (D39.127). Гейты пере-прогнаны исполнением, 12 находок ревью (1 high) и поправки к записи S3.6 — первой записью хроники ниже. Промт S3.7 выдан (S37_SESSION_PROMPT.md: Ф-49…Ф-51, Ф-47 ратифицирован, Ф-40, Ф-25, находки §8), запуск по слову владельца; S4 — после приёмки S3.7. Экспорт банка заведён строкой 169 единого бэклога (Ф-43).

• Пройдено: S0 (план), S1 (инструменты, скриншот-цикл, tokens.css, витрина), S2 (оболочка трёх панелей, слой src/ui/, масштаб списков, хвосты гейтов), S3 (слой данных: контракт 0.2.0, MSW, фикстуры всех состояний, живой поток, типы контракта), S3.5 (фикс-пак оболочки: 24 замечания владельца, сценарии интеракций, пере-замер полос), S3.6 (второй круг: палитра по замеру референсов, модель вкладок fleet_2, банк таблицей, ручка из vojo дословно).
• ⚠ АБЗАЦ НИЖЕ ИСТОРИЧЕСКИЙ (04.08), читать как хронику: замок с тех пор открыт (контракт ратифицирован D39.99), S3 исполнен и принят D39.115. Оставлен, потому что объясняет, ПОЧЕМУ S3 однажды остановилась, а не как диспозиция.
• S3 НЕ сделана: замок на входе закрыт, проверено исполнением 04.08. Контракта API v0 по-прежнему нет (docs/architecture/14-api-contract.md отсутствует; строка 95 единого бэклога — статус «дизайн-промт по слову владельца», то есть не исполнена). Вместо S3 сессия сделала то, что предписывает её же промт на этот случай: довела Ф-14 до артефакта API_CONTRACT_INPUT.md и остановилась. Кода не написано ни строки — это диспозиция, а не недоделка: моки, снятые не с того контракта, разойдутся с API, ровно ради чего строка 95 и заведена.
• Написан черновик контракта, принят в работу ревью оркестратора и ДОФИКШЕН (04.08). Форма сменена решением владельца: нормативная поверхность — OpenAPI 3.1 docs/api-contract/openapi.yaml, API_CONTRACT_DRAFT.md стал обязательным спутником (провенанс ✓/◆/○, обоснования, К-вопросы — то, чего YAML не выражает). Дом ратифицированной копии — docs/architecture/14-api-contract/, зона оркестратора; после ратификации типы генерятся из перенесённой копии — контракт первичен.
• Гейт контракта живой: npm run check стал шестишаговым (spectral на строгом пороге), openapi-typescript генерит src/api/schema.ts, тест дрифта не даёт спеке и типам разъехаться, ветка неизвестного значения стоит на шве (src/api/contract.ts), MSW отдаёт тело в форме контракта. Четыре формы нарушения проверены живьём (FRONTEND_PLAN.md §5.4.2).
• Ждёт оркестратора, четыре вещи: (1) ратифицировать спеку и перенести в docs/architecture/14-api-contract/, либо вернуть с правками; (2) три зависимости, которых фронт заводить не может — артефакт экспорта БАНКА (строки в едином бэклоге нет вовсе: 101 даёт таблицу подписи, не банк), механизм поднятия потолка (без него resume после стопа по потолку прогон не двигает) и правка устаревшего комментария провенанса store/migrate.go:193; (3) залендить дерево сессии; (4) вопросы владельцу — В-4, В-5 ниже и К-1..К-12 спутника, из них продуктовых пять, остальные — автору контракта и платформе.
• Ждёт владельца: контраст палитры (BACKLOG.md Ф-11) и два вопроса ниже — В-1 диск, В-2 копирайт.
• Ждёт движка: манифест глав и пофазный прогресс (единый бэклог, строки 99–100), к S5 — машиночитаемая таблица подписи банка (строка 101).
• npm run check зелёный (6 шагов, 80 тестов), npm run check:full зелёный, гейт доступности зелёный на обоих маршрутах. Гейтов стало больше: включён Ф-4 (отступы), закрыты Ф-9 и Ф-10, по ревью оркестратора 04.08 добавлены динамические импорты швов и языковая ветка в CSS.
• Карта канона для фронт-сессии — FRONTEND_PLAN.md §0.1, транспорт — §0.2. Заведены после того, как две ошибки S1 пришли из непрочитанного канона; читать до кода, не после.
• Передача следующей сессии написана — S3_SESSION_PROMPT.md (сессией S2 по просьбе владельца; ратифицирует оркестратор): вход в S3 под замком контракта API, который сессия проверяет сама, плюс фолбэк на Ф-14, если замок закрыт, и перечень ловушек, купленных S2.
• Гейты стоят и на коммите: pre-commit хук (02.08, вторая сессия) гоняет npm run check для коммитов с frontend-путями и блокирует смесь зон и файлы «никогда не коммитить»; ставится сам при npm install. Обход — только осознанный git commit --no-verify.

Решения владельца по продукту

Записываю здесь, потому что они меняют раскладку из §2 промта, а промт правит не фронт-сессия.

04.08 — где стоит «+» в рядах вкладок (закрывает половину Ф-7)

Вопрос был поставлен так: промт требует «+» вместе с действием, которое он запускает, а наборы вкладок у нас фиксированные (слева Книги · Поиск, справа О книге · Замечания · Банк) — пользователь их не расширяет, и fleet-овский смысл «+» («добавить инструмент») к ним не применим.

Владелец: «+» слева = «Добавить книгу». Отсюда:

Было	Стало	Почему
«+ Добавить книгу» строкой в дереве, «+» в рядах вкладок нет	«+» в ряду вкладок ЛЕВОЙ панели, строка из дерева убрана	одна вещь — одно место; в референсе «+» стоит ровно там
—	в центре и справа «+» нет	добавлять в фиксированный набор нечего, кнопка вышла бы декоративной

В S2 действие открывает вкладку-документ «Добавить книгу»; содержимое экрана (§3.1) делает S4.

04.08 — референсы вернулись на диск

frontend/references/*.png в .gitignore и в git никогда не заезжали, поэтому в третьей сессии их на диске не оказалось вовсе. Владелец положил файлы обратно. Следствие для будущих сессий: не считать наличие референсов данностью — если папки нет, это не «их отменили», а спросить.

02.08 — раскладка: банк памяти переезжает в правую панель

Владелец, глядя на витрину: «банк памяти перенёс бы в правую вкладку, чтоб можно было параллельно вертикально смотреть и оригинал, и главу, и банк памяти, а не горизонтально». Плюс три дефекта структуры в той же реплике: две кнопки настроек, банк продублирован (вкладка слева + отдельная карточка внизу), окно главы слишком мало.

Что из этого следует и сделано:

Было	Стало	Почему
Настройки в верхней полосе И внизу левой панели	только внизу левой панели	промт §3.12: настройки — отдельный раздел из низа левой панели, второй вход лишний
Банк во вкладке слева И карточкой в центре снизу	одна вкладка в правой панели	одна вещь — одно место; слева осталась только навигация
Центр разрезан на две карточки	одна панель во всю высоту	нижняя карточка была скопирована с терминала Fleet и не несла задачи
Кнопки сворачивания трёх панелей	двух	кнопка есть у той панели, которая существует

Вертикальный параллелизм — суть решения: рабочий цикл читателя это «читаю перевод → спотыкаюсь о термин → проверяю его в банке». Все три вещи обязаны быть видны одновременно, поэтому колонки: навигация · оригинал+перевод · справочное о читаемой главе. Правая панель становится панелью контекста, и её вкладки — О книге · Замечания · Банк.

Что при этом надо развести (иначе §3.5 ломается): у банка две разные работы. Справочная — «что это за термин», ей хватает 320px правой панели. Подписная — сотни терминов подряд, клавиатура важнее мыши, массовые действия — в 320px не помещается. Поэтому подписной экран открывается вкладкой в центре, как документ, а правая панель ведёт в него действием «Подписать банк». В витрине эта связка показана.

02.08 — данные: моки берут форму от движка

Владелец: «всё на диске лежит, и главы, и банки памяти». Разбор бэкенда подтвердил: моя первая фикстура выдумывала поля (kind: 'имя', state: 'подписан'), а промт прямо запрещает изобретать API. Формы переписаны по настоящим:

• банк — таблица glossary (backend/internal/store/migrate.go:176): src · dst · type · sense · status · source · since_ch/until_ch. Статусы подписи ровно три: auto|draft|approved, провенанс — seed|ruby|mined (⚠ испр. 04.08 по ревью оркестратора: здесь стояло seed|ruby|auto плюс mined по комментарию схемы; комментарий устарел, а литералы "auto" в коде пишут СТАТУС, не провенанс — membank/memseed.go:328). Типы — исправлено 04.08 по ревью оркестратора: сама колонка type в схеме свободный текст, и её комментарий перечень не закрывает («name|term|title|…»), поэтому истина — гейты в Go: классификатор знает четыре (terminology/classify.go:15), банкнота принимает их же плюс nickname (pipeline/banknote.go:74). Итого пять: name|place|title|term|nickname. org и fullname движок не знает вовсе — они приехали в тип фронта из этой самой строки;
• пары — ChunkExport из tmctl export --pairs (backend/internal/pipeline/export.go:25): chapter · chunk_idx · disposition · flag_reason · detail · final_text · source;
• причины замечаний — enum из backend/internal/pipeline/disposition.go:56-104.

Следствие для интерфейса, которое из этого выросло: движок говорит своим языком — sanitizer_stripped, «CJK leak in the ru output: 第一节». Промт §4.1 запрещает показывать это пользователю. Значит между движком и экраном обязан стоять слой перевода вердиктов в продуктовые понятия, и он заведён одной картой в данных: причина → человеческая фраза; поле detail не показывается никогда. Это же ПТ-33 реестра требований.

02.08 — шов данных заведён: моки выкидываются одной папкой

Владелец: «все моки рано или поздно придётся выкинуть; нужна минимальность моков, минимальная инвазивность в код и изолированность». На вопрос «соблюдаешь ли» честный ответ был «нет»: правило «данные только через src/api/» стояло в плане, а в коде компонент импортировал фикстуру напрямую — шва не было вовсе. Радиус поражения был мал (один экран), но образец для S2–S7 задавался неправильный.

Заведено: src/api/ — типы и функции, единственный вход; src/mock/ — фикстура, которую видит только api/. Правило теперь машинное, а не на совести ревьюера: no-restricted-imports на **/mock/** и запрет сетевых вызовов, с исключением для src/api/**.

Две поправки к этой записи, обе от ревью 02.08 (№3) — исходные формулировки были сильнее сделанного:

• «Доменных значений в разметке не осталось» — было неверно: в JSX оставались четыре литерала языка (lang="zh", lang="ru", подпись пары zh → ru), и тот же проход, который вынес числа в book.*, прошёл мимо них в той же строке. Починено: язык — код в данных, имя считается Intl.DisplayNames, lang берётся из книги; правило закрыто тестом (src/generality.test.ts), а не обещанием.
• «В день HTTP правится тело функций, экраны не трогаются» — переобещание. Верно только про день замены MSW настоящим сервером. Асинхронность приезжает раньше, на S3, вместе с MSW и TanStack Query — то есть ДО первого продуктового экрана (S4–S7), поэтому переписывать экраны и правда не придётся. Но четыре вызова витрины на S3 изменятся.

02.08 — что дал разбор канона: фронт мокает не тот контракт

docs/README.md прямо требует читать research/23 перед любым кодом стыка. Не читал, и это стоило двух вещей.

1. D39.85 (research/23 §0): фронт читает ТОЛЬКО read-модель платформы в Postgres, материализованную из NDJSON-потока событий; движок не опрашивается никогда, чтение живого SQLite движка — запрещённый анти-паттерн. Значит формы glossary/ChunkExport — словарь предметной области, но НЕ форма API. Типы фронта переписаны так, чтобы это было видно: src/api/types.ts объявлен рабочей гипотезой до появления контракта.
2. Единый бэклог, строка 95: «Контракт API v0 + продуктовый словарь статусов, ранняя вставка, зафиксировать артефактом ДО большого кода обеих сторон — фронт пишется на моках, без пришпиленного контракта моки и API разойдутся». Дом — docs/architecture/14-api-contract.md, файла нет. То есть фронт делает ровно то, ради предотвращения чего строка заведена. Для S2 (оболочка, src/ui/) это не помеха. Для S3 (слой данных) — вход, которого нет.

02.08 — инверсия смысла двух вердиктов (дефект, внесённый фронтом)

Продуктовые фразы к замечаниям были написаны по ИМЕНИ причины, а не по её доккомменту, и две из пяти получились наоборот:

• glossary_miss — «Термин не подписан в банке» ⟶ неверно. disposition.go:78-85: «an approved term's src fired in the chunk but no accepted dst form appears in the output — the model ignored the glossary». Термин подписан, его проигнорировал перевод. Фраза посылала человека подписывать уже подписанное — по банку, который в каноне центральная ценность.
• sanitizer_stripped — «Часть блока не переведена» ⟶ неверно. disposition.go:96-104: «the chunk is NOT lost — the cleaned text is committed as the export»; status.go:165-170: «the least alarming flag». Самый безобидный флаг из восьми подан как потеря текста.

Заодно вскрылось, что у движка есть ратифицированная лестница важности вердиктов (status.go:150-175, ранги 1..8), а интерфейс красил все замечания одинаково — то есть терял единственный сигнал приоритета. Введены две ступени: attention и glance.

Правило на будущее: фраза к вердикту пишется по доккомменту disposition.go, а не по имени причины, и рядом кладётся цитата. Соответствие целиком — в шапке src/mock/book.ts; его настоящий дом — контракт API (строка 95), не фронт.

02.08 — ревью №3 на полном каноне: что оно поменяло

Владелец разрешил читать весь корпус доков и потребовал прогнать ревью после чтения. Прочитано: CLAUDE.md · docs/README.md · CURRENT-STATE и единый бэклог · research/23 · product-requirements.md · карта D-лога. Ответ на вопрос владельца о способе связи: NDJSON — это шов ДВИЖОК↔ПЛАТФОРМА (D39.85), а фронту принадлежит JSON поверх HTTP плюс SSE от платформы (D39.84). Разведено в FRONTEND_PLAN.md §0.2, потому что путал их я сам.

Ревью: 5 линз × находки, на каждую независимый скептик с установкой опровергать. 15 находок → 12 проверено → 5 выжило, 7 опровергнуто. Хардблокеров нет; S2 не блокирован ничем.

Что	Диспозиция
Язык зашит в разметку (lang="zh"), а в типе — русское слово	починено: коды в данных + Intl.DisplayNames + тест-замок
Девять состояний нарисованы на ГЛАВАХ, хотя это состояния ПРОГОНА над книгой	починено: состояние → книга, у главы выполнение по юнитам; библиотека из нескольких книг
Прогресс — наивное «N из M глав», прямо запрещённое собственным планом	починено: две пары по юнитам, фикстура поставлена в середину черновой волны (наивный счётчик дал бы 0)
Сетевой гейт ловил только fetch — EventSource (ратифицированный транспорт) проходил молча	починено: восемь форм, все проверены живым нарушением
npm run shot зелен, когда экран не попал в список маршрутов скрипта	починено: тест сверяет routes.tsx и shot.mjs

Опровергнуто (и это ценнее половины находок): гипотеза «синхронный src/api/ — хардблокер, нужен свой хук уже сегодня». Два независимых скептика показали, что S2 данных не читает вовсе, а асинхронность приезжает на S3 вместе с MSW и TanStack Query — то есть самодельный хук был бы работой S3, которую S3 же и выбросит. Правку я не делал; переобещание в журнале поправил.

Что нашла не ревьюшница, а снимок: после переноса состояний на книгу три пары из девяти рисовались одинаково (готова ≡ не начата, перевод ≡ финал, ошибка ≡ не разобрана) — точка не различает девять значений. Метка стала словом; цвет остался вторым каналом и живёт на точке, а не на тексте (цвета замечания и отказа не проходят порог контраста для текста — проверено axe: было 5 узлов, стало 14, вернулось к 5).

Открытые вопросы к владельцу

#	Вопрос	Почему это его вопрос
В-1	Данные привязаны к одной машине. Вся фактура — прогоны, экспорты, банки — лежит в /home/ubuntu/books/gu-zhenren/ вне git; оба backend/example/sample-*.db пустые (только схема); пути стенда зашиты в тесты (miner_parity_test.go:33-35, labelharness_test.go:43) и в book.yaml абсолютными путями. Владелец сказал: «мне не нравится, что это живёт конкретно на моём диске». Лечение — платформа (platform/README.md:20-29: библиотека книг, хранение исходников и экспортов), но платформы ещё нет ни строки. Фронт от этого не зависит (работает на моках), но вопрос на движок/платформу, а не на фронт	скоуп-решение и порядок работ
В-3	Каким словом называть ступень замечания. Сейчас attention и glance различаются только цветом полоски: синяя и серая. Зрячему разница читается ещё и светлотой, скринридеру — никак. Лечение то же, что уже применено к состоянию прогона книги: слово рядом с цветом. Но словарь замечаний продуктовый (ПТ-33), а §3.8 требует, чтобы экран не выглядел тревожным, — «важно / неважно» и «ошибка / предупреждение» не годятся. Строка Ф-21	продуктовая формулировка, которую видит пользователь
В-6	Упёрся в свой потолок ≠ кончились деньги, а интерфейс их не различает. Владелец 07.08 дал человеку поставить перед стартом колпак в ГЛАВАХ; платформа берёт холд на его сумму. Но машинная причина паузы в контракте ровно одна — credit_exhausted, и она про кредит. Значит прогон, честно доехавший до выбранной человеком границы, и прогон, у которого кончился баланс, приходят на экран одной фразой «перевод остановлен: лимиты исчерпаны». Первому она врёт: лимит не исчерпан, человек сам так решил, и следующее действие у него другое — поднять колпак, а не пополнить счёт. Нужно ли второе значение и какая у него фраза — продуктовое. Заведено К-13, строка Ф-31	продуктовая формулировка, которую видит пользователь, и разное следующее действие
В-8	Какое слово о состоянии книги стоит в дереве. Замечание 23 потребовало бейджу ФИКС-место, и оно сделано; но две метки словаря в него не помещаются и усекаются с тултипом — «остановлена: лимиты» (19 знаков) и ветка неизвестного «неизвестное состояние» (21). Укоротить их сессия НЕ вправе: фраза паузы зарезервирована за владельцем (В-6), и первый заход S3.5 её укоротил и был откачен собственным ревью. Варианты: (а) оставить усечение с тултипом, (б) владелец даёт короткое слово для дерева, а полная фраза остаётся в статус-полосе, (в) расширить колонку бейджа за счёт названия книги	продуктовая формулировка, которую видит пользователь
В-7	Физический масштаб интерфейса на мониторе. Замечание 1 говорит «масштабы великоваты, особенно на 27″ 2K, на 24″ терпимее». Замер при вьюпорте референса расхождения с Fleet не нашёл (§5.5 плана): промежутки, ширины панелей, шаг строки и высота вкладки совпадают. Значит речь про физический размер на конкретном экране, а он зависит от масштабирования ОС, и «просто уменьшить токены» означало бы уехать от референса, который владелец принял. Правильное лекарство — ручка «плотность интерфейса» в настройках (3 ступени), но она требует перевода ВСЕХ размерных токенов в rem и пере-замера, то есть отдельного прохода (Ф-36). Вопрос: нужна ли ручка, и какой масштаб ОС стоит на 27″ 2K — по нему видно, во сколько раз расходится физика	продуктовое решение и цена отдельного пакета
В-2	Авторское право на текст фикстур. Витрина использует короткую выдержку из настоящего прогона (蛊真人). Правило проекта уже есть: eval/.gitignore:4 держит копирайтные тексты вне git. Сейчас взят объём под проверку плотности и не больше; нужно ли убрать совсем и заменить синтетикой — решать владельцу	юридика
В-4	Чем подписывать главу в дереве, если заголовок — ровно «Глава N». Титул движок рендерит детерминистически из шаблона пары (configs/langpacks/zh-ru/heading.txt: template Глава {n}), а подзаголовок остаётся телом текста и названием НЕ является. На 2284 разделах это дерево из 2284 одинаковых по форме строк. Оставить так, показывать номер иначе или просить у контракта что-то ещё — продуктовое решение. Артефакт §1.4 и К-3	продуктовая формулировка, которую видит пользователь
В-5	Показывать ли оценку времени до конца прогона. У движка поле есть (status.go eta_seconds, «secondary: mean fresh-call throughput × remaining»), запретом §4.8 оно не покрыто (это не деньги), но и не запрошено ни одним разделом промта. Решать ДО формы прогресса, иначе поле придётся вводить задним числом в уже нарисованную полосу. Артефакт К-6, резерв строки 54 единого бэклога	продуктовое: обещание срока пользователю

Хроника

10.08 — приёмка S3.6 оркестратором: ПРИНЯТО и залендено; поправки к записи S3.6

Гейты пере-прогнаны исполнением: npm run check:full EXIT=0, vitest 160, npm run shot ×3, сценарии зелёные. Один прогон shot напечатал «контраст: 4 узла» на /loading, два повторных — ноль: гонка axe с 220мс-анимацией карточки ожидания, уходит в S3.7 как стабилизация съёмки (контраст в shot.mjs — НЕ блокирующий гейт, «принято как есть», поэтому EXIT=0 нулей не доказывает). Ревью 12 агентами (6 линз + скептики, author≠reviewer): десять ключевых клеймов записи S3.6 подтверждены кодом; 12 находок подтверждено (1 high — замер ширин таблицы банка в скрытой keep-alive вкладке, src/ui/Table.tsx:232), 24 минорных — все переданы промтом S37_SESSION_PROMPT.md §8, здесь не дублируются.

Поправки к записи S3.6 ниже — сама запись не правлена (аннотация, не переписывание):

• §12, приёмочный буллет о сторожах спойлера, неверен обеими половинами: «спойлер проверяется по механизму (текст прозрачен и нарисован тенью), а не по слову filter» — финальный механизм это ровно filter: blur(3px) (src/showcase/Bank.module.css:80, text-shadow там же отвергнут), и сторожа сверяют именно blur (scripts/scenes.mjs:387,454). Сторожа валидны для настоящего механизма; ложна формулировка буллета — она описывает промежуточную редакцию.
• Число-дрейф разделов 7–14 против финального дерева: §8а — --panel-context-width в финале 620px, не 400px; §9а — механизма --table-min-width в дереве нет (минимум = полы столбцов --column-min); §7 — bankDocumentTitle спилен в §8а вместе с банком-документом; §14 — предзагрузка «на приходе фокуса» снята в §15, финал — только по нажатию кнопки.
• Грунты §3/§8б в движок съехали: правило «every proposed term is EITHER promoted OR declined» — backend/internal/pipeline/mining.go:81 (лог — :243), константа tm-bank-stop-v1 — mining.go:295.
• Разделы 12–15 стоят в обратном порядке после §11 — хронику S3.6 читать §12→§15 снизу вверх.
• Референса fleet_2.png на диске не было (references/ под .gitignore) — палитра и категория toned в tokens.test.ts ссылались на невоспроизводимый замер. Закрыто при приёмке: владелец докинул файл 10.08, пиксельная проба оркестратора (canvas, полный кадр 1280×801) подтверждает якоря — доминанта #181818 (656k px, полотно = базовый токен), #292929 второй по частоте (74k px, сурс панели), #184176 присутствует дословно (1.8k px, сурс выбранной строки); полный measure.py-свип — задача S3.7.

Носители хвостов S3.6: Ф-49…Ф-51 + находки приёмки → промт S3.7 (выдан, запуск по слову владельца; S4 — после его приёмки); Ф-43 → строка 169 единого бэклога (экспорт банка); Ф-47 РАТИФИЦИРОВАН (BankTerm.sense → required, пустая строка = «различителя нет»; исполняет S3.7 в зонной копии, канон — диффом при лендинге); черновик полей BankTerm (note/gender/contexts…) ждёт слова владельца по границе ПТ-33. Битая ссылка в застейдженном чужом docs/README.md (DOVODKA↔REDO) — передана полигонному лендингу, не трогал.

10.08 — седьмая фронт-сессия (S3.6): второй круг замечаний владельца

Вход: 10 замечаний владельца, снятых с прогона ПОСЛЕ S3.5, плюс два уточнения по ходу сессии (комментарии в коде — по-английски и без воды; блокеры платформы/бэкенда — жалобой, а пункт в бэклог). Ниже: аудит прошлого пака (просьба владельца №1), прогон по 10 номерам, жалобы, черновик правки спеки, самопроверка.

1. Аудит: 24 буллета S3.5 → что реально стоит в коде

Владелец: «ты ревьювил сам себя же по буллетам из изначального промта? буллет из промта → вот эти доработки в коде у нас есть». Сверено ПО КОДУ, не по отчёту. Столбец «вердикт второго круга» — что владелец сказал об этом же месте на новом прогоне.

№	Буллет S3.5	Что стоит в коде (file:line)	Вердикт второго круга
1	Масштабы великоваты, кадр 2560×1440	tokens.css шкала; предел меры набора --reader-width: 1040px	ОТКАЧЕНО: предел был моей добавкой сверх буллета, владелец назвал его «жёстко приклеен к центру» (нов. 6). Токен удалён
2	Спам вкладками → модель VS Code	showcase/documents.ts:23-40 (preview/pin), ui/Tabs.tsx:13 preview, Library.tsx:110 onActivate	принято, повторно не оспорено
3	Вид вкладок: мелкие, не отделимы	было: пилюля на панели, Tabs.module.css	ПЕРЕДЕЛАНО (нов. 4): модель fleet_2 — хром + вырез
4	Две кнопки поиска	showcase/Goto.tsx (палитра), одна лупа Showcase.tsx:126-132	принято
5	Выравнивание полос	Shell.module.css:12-17,111-118 --bar-inset, полосы прижаты к краям окна	принято
6	«О книге» — больше метаданных	showcase/About.tsx:11-34 (14 полей до границы контракта)	принято
7	Банк перепридумать	было: двухстрочный список в 320px, showcase/Bank.tsx	ПЕРЕДЕЛАНО (нов. 7): таблица в центре
8	Вкладка «Замечания» — обосновать или снять	showcase/Notes.tsx — пер-книжная сводка со ссылкой в раздел	защищено, повторно не оспорено; финальное слово владельца не сказано (Ф-38)
9	Оригинал/перевод разделить мягко	Reader.module.css:7-18 волосяная линия по жёлобу	ЦВЕТ СМЕНЁН (нов. 5): линия в цвет оболочки
10	Серо-синяя линия нечитаема	ui/Callout.tsx:24-33 значок в тон полоске, ховер подсвечивает пару	половина: связь есть, СТУПЕНЬ по-прежнему только цветом — слово продуктовое, В-3 на владельце
11	Настройки модальным окном	showcase/Settings.tsx, ui/Modal.tsx	принято
12	Добавление книги модалом	showcase/AddBook.tsx (два источника названия)	принято; поля title в контракте по-прежнему нет — правка предложена
13	= 7	—	см. 7
14	Слишком точная копия Fleet	было: тёплый подтон в tokens.css	ОТКАЧЕНО (нов. 2): подтон владельцу неприятен
15	Светлой темы и языка нет	каркас в Settings.tsx, строки Ф-34/Ф-35	диспозиция принята
16	Фон «серо-неприятный»	было: тёплый ряд	ПЕРЕДЕЛАНО (нов. 2, 9): нейтральный ряд по замеру референсов
17	«Шакальные» иконки	tokens/reset.css:72-76 полупиксельный сдвиг сетки	причина закрыта; но «дизайн иконок» — отдельное замечание (нов. 8), сделано
18	Залипание и форма ручки	Shell.module.css:64-109	ПЕРЕНЕСЕНО ДОСЛОВНО (нов. 3): числа и состояния из vojo
19	Шестерёнка в правый верх	Showcase.tsx:135-137	принято
20	«Подписать банк» непонятна	кнопка снята, состояние честное	дополнено (нов. 7): подписывается банк ЦЕЛИКОМ — правило названо в подвале таблицы
21	Статус на иконке книги	Library.tsx:124-128 data-tone на иконке	принято, усилено (нов. 8): четыре тона вместо двух
22	Где генерится заголовок главы	ответ оркестратора, сессии делать нечего	—
23	Наложение бейджа на название	Library.module.css:34-47 фикс-место + эллипсис	принято
24	Пометка черновика	showcase/Document.tsx:39-47	принято

Итог аудита честно: из 24 буллетов шесть владелец на втором круге вернул (1, 3/4, 7, 14/16, 18, 9) — не потому, что их не сделали, а потому что сделали НЕ ТАК. Два из шести — прямое следствие моей самодеятельности: предел ширины набора (1) и тёплый подтон (14/16) в буллетах не стояли, я их придумал; тёплый подтон при этом ПРОТИВОРЕЧИЛ референсам, которые владелец называет эталоном. Это ровно тот класс ошибки, что уже записан в памяти сессий: «оспаривать посылку, а не подменять её своей».

2. Прогон по десяти номерам второго круга

№	Замечание	Что сделано	Проверка
1	Аудит буллетов	таблица выше	—
2	Коричневый фон неприятен	нейтральный ряд #181818/#242424/#212121 + #090909 оболочки; тёплые тона удалены целиком	замер гистограмм референсов, .shots/showcase.png
3	Ручка не как в vojo	перенесены ЧИСЛА и состояния: покой 2×36 · ховер 0.25 · фокус акцентом 0.45 · драг 0.55 и 48px · упор min 3×28/0.85 · упор max 2×76/0.9, переходы 140ms	сценарий drag: проверяет и прозрачность, и высоту
4	Вкладки: вписать, баг обрезки	полоса вкладок = хром --color-chrome, активная вырезана цветом полотна (замер fleet_2: полоса 36‥66, активная залита #181818); баг найден — вкладки были flex-элементами и делили нехватку места ПРОПОРЦИОНАЛЬНО ширине, поэтому короткое название усекалось раньше длинного; теперь ряд прокручивается, а вкладка усекается только на своём пределе	сценарий tabs: «ни одна вкладка не усечена, не упёршись в предел»
5	Разделитель текста — чёрным	линия жёлоба перекрашена в --color-shell	Reader.module.css:7-18
6	Текст не по окну	--reader-width удалён вместе с центрированием: набор снова во всю ширину панели	кадр .shots/showcase.png
7	Банк — перепридумать	ниже отдельным разделом	сценарий bank, 12 проверок
8	Иконки книг и глав	книга — Book в тоне состояния (четыре тона), глава — FileText приглушённым; полоска выполнения главы синяя, на 100% зелёная	.shots/showcase.png, .shots/scale.png
9	Дизайн двуцветный	цвет введён там, где он ЗНАЧИТ: выбранная строка синяя (замер fleet_2 #184176), иконка книги в тоне состояния, точка состояния термина, полоска выполнения, акцент на открытом документе	axe: ноль узлов контраста на семи маршрутах
10	Скриншот fleet_2	принят в работу: с него сняты и палитра, и модель вкладок, и цвет выделения	FRONTEND_PLAN.md §5.6

3. Банк памяти (замечание 7) — что и почему

Владелец: «фронтовая сессия НЕ ПОНИМАЕТ чем мы заняты». Разбор пошёл в движок, а не в свою голову. Найдено:

• банк подписывается ЦЕЛИКОМ, а не построчно — стоп снимается, только когда решён КАЖДЫЙ предложенный термин, и тогда прогон идёт дальше (backend/internal/pipeline/mining.go:201; в контракте это POST /runs/{id}/resume, отвечающий 409 при неполном наборе решений, openapi.yaml:418). Правило названо словами в подвале таблицы;
• у стопа уже есть машинная таблица подписи tm-bank-stop-v1 — «что читает подписной экран» (mining.go:388, bankStopRowJSON mining.go:317-333): src · dst · origin · type · freq · spread · conventions · conf · invented · signals · contradicts · variants · evidence · contexts;
• описание термина у движка ЕСТЬ (владелец просил убедиться): seed.Term.Note и seed.Term.Gender/Aliases (backend/internal/seed/seed.go:63-80), плюс Evidence/Contexts кандидата майнера (miner/miner_emit.go:43-55). В контракт API это НЕ вынесено — у BankTerm есть только sense (openapi.yaml:983-1023). Поэтому спойлер поставлен на то описание, которое контракт отдаёт, — sense; полноценное описание/обоснование предложено правкой спеки (ниже) и заведено строкой бэклога.

⚠ Абзац переписан по итогам приёмки того же дня — первая редакция описывала экран, которого уже нет. Было: банк открывался вкладкой-документом в центре, а справочник оставался справа; владелец назвал это дублем и велел спилить. Стало (§8а и §9): банк живёт ТОЛЬКО в правой панели, таблицей, и она в приложении одна. Столбцы — Термин · Перевод · Тип · Смысл; «Действует» стало припиской к термину, «Состояние» снято совсем (§8б). Поиск идёт по термину и переводу, но НЕ по описанию: поле, по которому ищут, работает оракулом к тому, что закрыто спойлером (нашло адверсариальное ревью). Фильтр по типу — с счётчиками («имена — другая таблица, чем термины», слово владельца), состояние банка — в подвале.

Спойлер переставлен: закрыт СМЫСЛ (описание), перевод виден всегда. Прежнее поведение (блюр перевода) владелец назвал ошибкой, и он прав по существу: строку, у которой закрыт перевод, невозможно проверить — а таблица существует ровно ради проверки.

4. Жалобы: без чего эти экраны не заработают на живой платформе

Владелец 10.08 разрешил жаловаться прямо. Три вещи, и все три — не в зоне фронта:

1. У чтения GET /books/{id}/bank нет канала вообще. Банк живёт в приватном SQLite движка, читать его платформе запрещено (D39.85), а артефакта экспорта банка нет. Это записано в компаньоне контракта (14-api-contract/README.md §3: «строки нет — заводит оркестратор»), и строки в едином бэклоге я не нашёл до сих пор (docs/PROGRESS.md, номера 99–101 и 104 в живом файле отсутствуют). Пока её нет, вся витрина банка стоит на моке.
2. Поля, ради которых банк проверяют, движок производит, а контракт не несёт. См. §3: note, gender, aliases, variants, evidence, contexts, freq, confidence. Черновик правки — ниже. Без них таблица подписи на живых данных будет беднее, чем .bank-stop.json, который движок уже пишет на диск.
3. Подписной механизм (S5) упирается в то же. POST /bank/decisions и resume в контракте есть, но продавать их экраном, пока нет канала чтения, нельзя. Поэтому в S3.6 построен ВИД и честное состояние, а действие «подписать» не нарисовано вовсе — кнопка без действия запрещена нормой зоны.

5. Черновик правки спеки — «предложено», ратифицирует оркестратор

Повторяет черновик S3.5 и УСИЛЕН грунтом из движка (тогда грунт был косвенный). Предлагается добавить в BankTerm необязательные поля — проекцией машинной стоп-таблицы tm-bank-stop-v1:

Поле	Что это	Откуда движок берёт
note	описание/обоснование термина — то, что закрывается спойлером	seed.Term.Note (seed/seed.go:79)
gender	род: нужен постчеку склонения, а человеку — чтобы проверить строку	seed.Term.Gender (seed/seed.go:70)
aliases	прочие поверхности той же сущности	seed.Term.Aliases, miner.Term.Aliases
variants	что предлагали черновики, с числом голосов	BankStopVariant (mining.go:434-447)
evidence	улики паттернов, по которым термин выделен	miner.Term.Evidence (miner_emit.go:50)
contexts	KWIC исходника — главный материал проверки И главный спойлер	BankStopRow.Contexts (mining.go:407)
freq/spread/confidence	частота, разброс вариантов, уверенность роли	BankStopRow (mining.go:403-425)

⚠ Два предупреждения к правке, которые важнее самой правки: contexts — цитаты исходника из ЛЮБОГО места книги, то есть спойлер по построению: их отдача обязана быть ограничена окном прочитанного либо закрываться на клиенте. confidence, signals, variants раскрывают, что термин собирали НЕСКОЛЬКО источников — это граница ПТ-33 (интерфейс не раскрывает конвейер); отдавать их можно, но называть на экране без слов владельца нельзя. Поэтому в таблице их сегодня нет и без ратификации не появится.

6. Самопроверка исполнением

• npm run check — зелёный, 154 теста; npm run scenes — семь сценариев, 40 проверок (добавлен bank, усилен tabs проверкой обрезки, drag сверяет числа vojo, в двух сценариях теперь стоит прогон axe по ОТКРЫТОМУ состоянию); npm run shot — семь маршрутов, ноль узлов контраста у axe (палитра менялась целиком, поэтому Ф-11 пересчитана прогоном, а не рассуждением).
• Свои дефекты, пойманные ИСПОЛНЕНИЕМ по ходу: фильтр-группа банка ехала без имени (axe-риск) — добавлено aria-label; кнопка «Открыть таблицей» текстом ломала строку фильтра в 320px — стала иконкой; --panel-header-height и Context.module.css остались мёртвыми после правки вкладок — сняты (замок «токен без применения» сработал как задумано).

7. Адверсариальное ревью диффа (author≠reviewer) — находки и диспозиции

Находка	Диспозиция
Подсказка строки банка печатала то, что закрыто спойлером. Спойлер переехал на sense, а тултип строки (card()) по-прежнему собирал смысл: … — блюр закрывал глаз, тултип выдавал текстом	исправлено; закрыто проверкой в сценарии context («подсказка не выдаёт закрытое описание»)
Главное действие формы стало цветным вопреки собственному правилу. Button[look=primary] красился в --color-selected, а тот с S3.6 — синий цвет выбранной строки. Комментарий рядом при этом утверждал «ступенью поверхности, а не цветом»	исправлено: заведён --color-raised-strong, правило §4.2 держится
Счётчик в фишке фильтра — текст цветом --color-text-muted, то есть 3.9:1 при пороге WCAG 4.5 — ровно то, что Ф-11 запрещает для текста	исправлено (--color-text-secondary)
Новый экран не видел гейта доступности вообще. npm run shot проверяет МАРШРУТЫ, а таблица банка и модалы открываются кликом — axe до них не доходил	исправлено механизмом, а не глазами: в сценарии заведён audit(page), прогон axe теперь стоит на таблице банка и на модале настроек; обе — ноль нарушений, ноль узлов контраста
Счётчики фишек считались по всему банку, а не по найденному — при активном поиске фишка обещала строки, которых нет, и клик открывал пустую таблицу	исправлено: счёт по найденному
Пустая полоса вкладок на маршруте без книг читалась как сломанная шапка: хром есть, вкладок нет	исправлено: полоса без вкладок и без «+» прозрачна
Название банка жило двумя литералами (строка дерева и заголовок вкладки)	сведено в bankDocumentTitle
Комментарии врали после правок: Reader.tsx говорил «линия на скролл-контейнере» (она на содержимом с S3.5), Tabs.tsx — «вкладка документа синеватая, как файл во Fleet» (с S3.6 это акцент по кромке)	оба поправлены; правило прежнее — врущий комментарий хуже отсутствующего
Прокрутка ряда вкладок скрытой полосой. Ряд прокручивается, полоса скрыта (scrollbar-width: none) — мышью без клавиатуры до дальней вкладки добраться нечем, если бы не поведение Chromium: контейнер с ЕДИНСТВЕННЫМ горизонтальным переполнением крутится вертикальным колесом	принято как есть, поведение проверено в браузере кадра; если владелец увидит иначе — вернуть видимую полосу одной строкой
Ширина строки перевода на 2K. Мера набора отпущена по слову владельца (нов. 6), и на 2560×1440 строка идёт в ~120 знаков — типографски это много	не чиню молча: владелец прямо отверг ограничение шириной. Правильная ручка — плотность интерфейса (В-7/Ф-36), вопрос ему задан

8. Приёмка владельца в тот же день — три правки

(а) Дубль банка спилен. Первая редакция §3 открывала банк ещё и вкладкой-документом в центре, оставив в правой панели справочник. Владелец: «зачем продублировал, спилить, перенести таблицу вправо». Сделано: синтетический документ bank, строка в дереве и старый двухстрочный список удалены целиком; таблица переехала в правую панель и она в приложении одна (проверяется сценарием: [role="grid"] с этим именем ровно один). Правая панель стартует шире левой (--panel-context-width: 400px, предел растяжки поднят до 900) — в ней теперь таблица, а не список.

Узкая панель не давит столбцы, а роняет их: «Смысл» приходит с 340px ширины таблицы, «Тип» — с 520px; окно применимости стало припиской к термину («青茅 с 40-го»), потому что у 57 строк из 60 его нет вовсе и столбец стоял бы пустым. Порог пересекается только драгом панели.

(б) Столбец подписи термина убран. Вопрос владельца — «откуда ты взял, что каждый термин нужно подписывать? это следует из бэкенда?» — законный, и ответ честный: и да, и нет. В движке решение действительно ПОСТРОЧНОЕ: стоп снимается, лишь когда каждый предложенный термин promote либо decline (pipeline/mining.go:201), и контракт это несёт (BankDecision, TermStatus на строку). Но это МЕХАНИЗМ под стопом, а продуктовое действие одно — подпись всего банка. Показав построчное состояние колонкой, экран начал спорить с продуктом: ровно то, на что владелец указал ещё замечанием 20 первого круга («„подписано 10 из 60“ непонятно: что подписываем — банк или термины?»). Снято и это, и счётчики «подписано / ждут решения»; в подвале осталось «60 терминов» и, когда прогон реально стоит на подписи, состояние ВСЕГО банка — «банк ждёт подписи» (из статуса книги awaiting_bank, а не из суммы строк). Словарь termStatus на шве остаётся: он часть контракта и его сужения, просто не рисуется.

⚠ Один остаток называю прямо, решать не мне: в банке лежат и уже канонические термины (из сида), и свежепредложенные. Сегодня таблица их не различает — а подписывают, по сути, вторые. Если это окажется важно, различитель придётся вернуть, но уже НЕ как «состояние подписи строки».

(в) Перформанс замерен, а не предположен. Заведён сценарий perf (мир /scale, 1200 терминов):

Что мерилось	Число
кадр при прокрутке таблицы, медиана	17 мс (~59 к/с)
худший кадр за прогон	67 мс (одиночная заминка на первом кадре прокрутки)
строк в DOM из 1200	32 (417 узлов) — виртуализация жива
поиск: от ввода до перерисовки	137–199 мс

Пороги в сценарии грубые (медиана ≤ 34 мс, ≤ 80 строк в DOM, поиск ≤ 300 мс) — они ловят обвал, а не колебания. Задержка поиска — это пересборка коллекции библиотеки на 1200 строк; на глаз она на границе заметности, и если владелец её увидит, лечится дебаунсом ввода (строка бэклога не заводилась: сначала замер на настоящем банке).

Дефекты, пойманные исполнением в этой правке:

Находка	Диспозиция
Таблица падала при смене состава столбцов — «Cell count must match column count»: коллекция RAC не пересобирает строки, когда меняются СТОЛБЦЫ, а items те же	исправлено dependencies на TableHeader/TableBody/Row; ключ строкой, а не массивом (зависимости сравниваются по ссылке). Проверялось прогоном; попутно поймал себя на том, что первые две попытки «не помогли» из-за несобранного бандла — вывод в отчёт кладу после build, а не после правки файла
Скролл-контейнер читалки был недостижим с клавиатуры (scrollable-region-focusable) — текст раздела листался только мышью	исправлено (tabIndex). Нашёл новый гейт: axe по ОТКРЫТОМУ состоянию. Маршрутный гейт этого не видел, потому что на его кадре текст не переполнял панель — то есть дефект жил ровно там, куда старая проверка не смотрела
--radius-round осмиротел вместе с точками состояния	токен удалён (замок «объявлен, но не применён» сработал)

9. Второй заход приёмки — таблица, лаг и спойлер

Владелец посмотрел собранное и вернул четыре вещи. Все четыре — про то, что я смотрел на код, а не на экран целиком.

(а) «Лагает, пиздец» — и это правда. Мой собственный замер из §8 говорил «медиана 17 мс, всё хорошо». Медиана и была ложью: человек чувствует ДЛИННЫЕ кадры, а не середину распределения. Пере-замер по p90 и по числу кадров дольше 50 мс, отдельно на dev-сервере (то, что открывает владелец) и на сборке, при его вьюпорте 2560×1440:

Прогон	p90	худший	кадров > 50 мс
dev, ДО правок	133–200 мс	250–500 мс	5–9 из ~150
dev, после правок	33 мс	250–433 мс	4–5
сборка, после правок	17 мс	100 мс	4 из 129

Найдено две причины, обе мои:

1. Состав столбцов зависел от ширины. Коллекция react-aria пересобирается, когда меняется набор столбцов, — а я менял его прямо во время драга, на каждом пересечении порога: отсюда кадры по 300–500 мс. Адаптивность по ширине снята целиком; вместо неё у таблицы есть мера (--table-min-width), ниже которой она уезжает вбок, а не ужимается.
2. Строка поиска банка жила в состоянии ВСЕГО экрана. Каждая буква перерисовывала дерево на 2284 раздела, читалку и статус-полосу разом: замер — 150 мс на символ. Состояние переехало в сам банк; палитра перехода теперь не «пишет в строку поиска», а ПРОСИТ показать термин (requestedTerm). Отклик поля: 451 мс на три буквы → 43 мс на символ.

⚠ Честно про остаток: на dev-сервере 4–5 длинных кадров за драг остаются, и это НЕ банк — тот же драг с открытой вкладкой «О книге» и на пустой библиотеке даёт ту же картину (замер). Дальше это уже цена dev-режима React против сборки; на сборке p90 = 17 мс.

(б) Столбец «Тип» на вкладке одного типа. Владелец: «зачем мне при переключении на вкладку с именем отображать её тип». Столбец теперь стоит, только пока фильтр показывает ВСЕ типы; на любой вкладке одного типа он уходит, а его ширина достаётся переводу. Смена состава столбцов при этом происходит по КЛИКУ, а не по перетаскиванию, — то есть в момент, когда пересборка коллекции никого не бьёт по рукам.

(в) Спойлер был выборочным, а описание спойлерно ЦЕЛИКОМ. Прежняя логика закрывала строку, если термин вступает в силу позже читаемого раздела: закрытыми оказывались два описания из шестидесяти, а «спутница главного героя» — открытым. Владелец назвал это прямо: в этой колонке спойлеры ВЕЗДЕ. Теперь спойлер — свойство КОЛОНКИ: закрыто всё и по умолчанию, раскрывается наведением на саму ячейку. Позиция чтения из банка ушла совсем (и вместе с ней — плетение readingChapter через три компонента).

(г) Таблица должна читаться как таблица. Что сделано, по одному приёму на задачу: шапка прибита к верху и отделена линией; строки разделены волосяными линейками; между «Термином» и «Переводом» — та же тёмная прорезь, что делит оригинал и перевод в читалке (один приём на два экрана: слева язык книги, справа наш); исходная сторона набрана на пункт крупнее — иероглиф при равном кегле читается мельче кириллицы; у термина и перевода есть подсказка полным текстом, у описания её нет по построению; окно применимости стало припиской к термину и усекается первым. Плюс к этому: описание раскрывается и с КЛАВИАТУРЫ (по фокусу строки), иначе таблица читается только мышью; подвал при сужении говорит «показано N из M» — иначе на экране два разных числа (счётчик фишки «все» и размер банка) без объяснения, почему они разные. Плагин frontend-design при этом действительно был подключён и не сработал сам — его процесс (план → критика плана → сборка → критика кадром) я применил руками.

Гейты после захода — числа сняты прогоном на итоговом дереве: npm run check — 156 тестов; npm run scenes — семь сценариев, 52 проверки, из них замерных шесть; npm run shot — семь маршрутов, ноль нарушений axe и ноль узлов контраста.

10. Ревью двумя агентами (author≠reviewer) — что нашли и что с этим стало

По слову владельца пущены два независимых ревьюера на дифф: один по нормам фронта, второй адверсариальный. Оба поймали дефекты по существу, и оба — в том, что я правил ПРЯМО во время ревью. Это само по себе находка, и она их: семь перезаписей ревьюируемых файлов за полтора часа — не ревью-пригодное состояние, а два самых дорогих дефекта (1 и 6 ниже) въехали правками, сделанными ПОСЛЕ последнего прогона гейтов.

Находка	Что было	Диспозиция
Кэш коллекции замораживает замыкания render	dependencies покрывал только состав столбцов, а render берёт извне sourceLang и senseShown. Если банк ответил раньше книги, lang на исходной стороне не появился бы НИКОГДА: кандзи ушли бы в китайские начертания	исправлено: Table принимает dependencies от вызывающего, банк передаёт [sourceLang, senseShown]
Переключатель «показать смыслы» не работал	тот же кэш: состояние менялось, ячейки оставались закрытыми. Проп dependencies был заведён от ЭТОЙ болезни за три минуты до того, как я написал переключатель, им не воспользовавшись	исправлено вместе с находкой выше; закрыто проверкой сценария
Спойлер закрыт только глазам	блюр не существует для скринридера: описание зачитывалось вслух целиком	описание вынуто из дерева доступности (aria-hidden), пока не раскрыто; раскрывает переключатель — единственный способ, работающий и для мыши, и для клавиатуры, и для чтеца
Раскрытие по фокусу вскрывало спойлеры подряд	я добавил [data-focus-visible] .sense, и обход стрелками открывал по описанию на нажатие	снято; проверка сценария теперь утверждает ОБРАТНОЕ — обход строк не раскрывает
Поиск по описанию — оракул	matchesTerm искал по sense; палитра перехода находила термин по слову из ЗАКРЫТОГО описания и печатала его открытым текстом	поиск по описанию убран; палитра дополнительно называет окно применимости («с 300-го»), потому что контракт зовёт его границей спойлера
Палитра ломалась со второго открытия	перехват Escape не давал полю очиститься, следующая буква дописывалась к прошлому запросу; сценарий делал ровно эти шаги и был слеп	исправлено; проверка «открытая заново палитра начинает с чистой строки»
Просьба палитры тонула в фильтре типа	стоял фильтр «место», палитра вела к имени — и показывала пустоту. Тот же термин, попрошенный дважды, не срабатывал вовсе (равное значение — не изменение)	просьба сбрасывает фильтр типа и несёт номер; обе проверки в сценарии
Мёртвая проверка и красный гейт	senses.every((entry) => entry.filter !== 'none') на массиве СТРОК: undefined !== 'none' — всегда истина. Проверка прошла бы и со снятым блюром; tsc в этот момент был красным, а отчёт говорил «зелёный»	исправлено; вывод: числа в отчёт — только после прогона на замороженном дереве
Замер перформанса был монотонен «не в ту сторону»	ни одна проверка не утверждала, что действие произошло: залипшая прокрутка и застрявшая панель делали замер ЗЕЛЕНЕЕ	добавлены «таблица реально прокрутилась на N px» и «панель в ходе драга реально ездила на N px»
Пустое состояние приезжало строкой коллекции	renderEmptyState заворачивает заглушку в role="option"/строку таблицы: скринридер объявляет «Ничего не нашлось» выбираемым вариантом	пустое состояние рисуется ВМЕСТО коллекции
Спойлера на длинном хвосте не существовало	у всех 1200 терминов /scale было sense: '' — колонка пуста, механизм не проверялся ничем	фикстуре добавлены описания и окна применимости
aria-describedby у подсказки поля	подсказка в форме добавления книги была голым <p>	Text slot="description" — библиотека связывает сама
Enter в дереве без гарда шеврона	двойной клик шеврон исключал, Enter — нет	гард симметричен
Мелочи	matchesTerm приводил запрос внутри предиката (1200 раз на перерисовку) · windowOf считался дважды на строку · «1 терминов»	исправлено; склонение — через Intl.PluralRules

Не подтвердилось при проверке (записываю, чтобы не переискивали): пустой банк, отсутствующий sense, kind: null и незнакомое значение с провода обрабатываются корректно — сужение стоит на шве; виртуализация на 1200 строках жива; пагинация банка дочитывает курсор.

Отдельно про выравнивание (требование владельца этого же захода): проверено не на глаз, а замером положения ПЕРВОГО ГЛИФА в каждом блоке. Имена вкладок трёх панелей стоят на одной линии (22 / 350 / 926 при полях панелей 12 / 340 / 916); в правой панели поиск, фишки, шапка столбца, ячейка и подвал — все на 926. Двух расхождений не было видно глазами, но они были: строка дерева начиналась на 4px левее имени вкладки, текст читалки — на 2px правее. Оба поля приведены к полю вкладки.

11. Третий заход приёмки: таблица, которую можно смотреть вблизи

Владелец разобрал таблицу по пикселям. Все его претензии подтвердились замером DOM, и у всех оказалась ОДНА причина, которой я не знал, когда писал стили.

Устройство виртуализованной таблицы. Библиотека кладёт КАЖДУЮ ячейку в собственную абсолютно позиционированную полосу высотой в шаг строки, а role="row" остаётся контейнером НУЛЕВОЙ высоты (замер: полоса 32px, строка 1px, ячейка 18px). Я же красил строку и ячейку как обычные боксы. Отсюда разом:

Претензия владельца	Механика
«горизонтальные серые, вертикальные чёрные»	горизонталь рисовала строка, вертикаль — ячейка; разные элементы, разные токены
«чёрточки не доходят до конца, как отдельные элементы»	вертикаль шла по высоте ЯЧЕЙКИ (18px) внутри полосы 32px
«элементы прибиты под самый верх линий»	линия строки ложилась поверх ВЕРХНЕЙ кромки полосы, а текст не был центрирован в ней
«заголовки — не заголовки»	шапка отличалась от данных только тоном

Сделано: линии рисует ячейка, ячейка тянется на всю высоту полосы, наведение и выбор красят через потомка (.row[data-hovered] .cell) — у строки красить нечего, то есть подсветка строки до этого вообще не работала. Все линии — один токен. Шапка набрана капителью с разрядкой.

Обобщение, а не заплатка. Тот же дефект нашёлся замером в дереве книг и в списках: строка была 20px в полосе 26px, то есть тоже липла к верху и оставляла неокрашенную щель. Правка перенесена туда же.

Спойлер. Блюр применялся к боксу с overflow: hidden — обрезка резала размытие в прямоугольник с резкими краями. Теперь закрытое описание НЕ обрезается (обрезает ячейка), а многоточие включается только на раскрытом: размытие снова идёт по глифам.

Ширины столбцов и перформанс — связаны, и это выяснилось замером. Владелец: «драг банка влияет на рисовку перевода, а драг дерева — нет». Замер подтвердил и локализовал: правый разделитель p90 33 мс против 17 у левого. Причина не в читалке и не в скрытых вкладках (проверено по очереди): доли fr заставляют библиотеку пересчитывать ширины столбцов на КАЖДЫЙ кадр изменения ширины панели. A/B: fr — 33 мс, фиксированные px — 17 мс.

Решение без размена: ширины считает сам примитив (spread()), а ширину контейнера он берёт УСТОЯВШЕЙСЯ (useSettledWidth, 120 мс) — во время драга столбцы не пересчитываются вовсе, после отпускания встают по долям. Итог: оба разделителя p90 17 мс, столбцы по-прежнему текучие. Плюс contain: layout paint style на ячейках — браузерная половина той же экономии.

Перетаскивание границ столбцов (отраслевая норма — MUI X, AG Grid) было сделано и работало (сценарий тянул столбец 194→274px), но замер показал цену: p90 драга панели 33→83 мс, длинных кадров 7→44. Снято, строка Ф-48 с числами и условием возврата.

⚠ Отдельно про «стандартный ли подход»: дерево книг — Tree библиотеки на семантике treegrid плюс виртуализатор (ui/Tree.tsx), отступ уровня даёт сама библиотека через data-level, клавиатура — тоже её. Таблица — Table той же библиотеки с TableLayout. Ни то, ни другое не самописное; самописного в таблице ровно две вещи, и обе от замера: расчёт ширин долями и устоявшаяся ширина.

⚠ Раздел 11 частично СНЯТ разделом 12 (10.08). spread() и useSettledWidth удалены: владелец нашёл на них баг (панель, сжатая до упора и разжатая обратно, оставляла таблицу сжатой), а перезамер показал, что заморозка ширин ничего не покупала — драг держит p90 17 мс и без неё. Абзац про fr = 33 мс воспроизвести на текущем дереве не удалось; см. раздел 12.

15. Закрытие сессии S3.6: ресёрч, долги, чистка

Ресёрч отдельным агентом по четырём моим предложениям — два опровергнуты, и оба я проверил сам.

• «Клиент не идёт по next_cursor» — НЕВЕРНО, это была моя ошибка. Курсор обходится централизованно: src/api/client.ts → requestAll() с потолком в 50 страниц, и через него идут ВСЕ пять списковых чтений (queries.ts), а тест api/api.test.ts читает 2284 главы страницами по 500. Я утверждал обратное владельцу, не заглянув в единственный файл, где механизм и живёт. Урок ровно тот же, что и с блюром: сначала найти, ЧЕМ вещь делается, потом судить.
• «Suspense + переходы принципиально лучше» — НЕ КУПИТ заявленного. Открытие главы — это МОНТИРОВАНИЕ новой панели-вкладки, а переход React не показывает фолбэк лишь там, где содержимое уже раскрыто внутри той же границы. Новая граница даст то же мигание, только фолбэком. Плюс три жёстких препятствия: у useSuspenseQuery нет enabled (а он несёт смысл в шести местах), границ ошибок в проекте нет вовсе, и флаг готовности скриншот-цикла живёт ВНУТРИ Showcase — приостановка снимет кадр ожидания с маршрута /loading. Строку не завожу.
• «Предзагрузка соседей» — не надо: навигация по книге прыжковая (дерево, палитра, сводка замечаний), кнопок «следующая/предыдущая» нет вовсе, так что соседи по номеру — не то, что откроют следующим.
• «Свежесть текста по событию» — ПОДТВЕРЖДЕНО и заведено (Ф-49), с двумя поправками к моей формулировке: это не «устаревает на 15 секунд», а «не обновится вообще, пока не уведёшь фокус из окна»; и инвалидации на кадре chapter мало — нужна и на смене status.

Сверх списка агент нашёл три вещи, все проверены и заведены: Ф-50 (кадр, пришедший до появления чтения в кэше, теряется молча, а отметка ревизии уже сдвинута; плюс «рваный» многостраничный список под ревизией последней страницы) и Ф-51 (resync сбрасывает один гард из двух).

Свой дефект, внесённый в этой же сессии и снятый по его наводке: предзагрузка висела ещё и на onFocus строки дерева. Замерил: стрелки двигают ФОКУС, не трогая ни выбор, ни открытую вкладку — то есть каждое нажатие стрелки читало главу, которую никто не открывал. Ровно тот сценарий «2284 запроса», который я сам же отверг для наведения. Осталось только нажатие кнопки.

Чистка перед сдачей. Комментарии в своих файлах подрезаны (ui/Table.tsx 106 → 73 строк комментария при 391 → 358 строках всего; так же в Table.module.css, Bank.module.css, Tabs.module.css, scenes.mjs), улики остались здесь, а не в коде. Маркеров TODO/FIXME/ «временно» в зоне нет, мёртвых классов CSS-модулей нет, экспортов без импортёров нет, снимки и инструменты замера в .gitignore.

Долги сессии — что НЕ сделано и почему.

Долг	Почему не сделано
Ф-49 · Ф-50 · Ф-51 (свежесть текста, потерянные кадры, resync)	найдены в последний час; правки трогают слой данных, а не экран — делать их в конце длинной сессии без замера рискованнее, чем занести
Ф-48: база замера цены ресайза столбцов устарела (p90 33 → 17 мс)	возврат ресайза требует замера заново, а не ссылки на старое число
Спойлер достаётся поиском по странице и печатью в PDF	цена того, что текст остаётся текстом страницы; альтернатива — не держать его в документе, это продуктовое решение
Канвас не знает lang: при двух CJK-гарнитурах под одним слагом замер может разойтись с отрисовкой	на стенде одно лицо, расхождение 0px — проверять на машине с SC+JP
RTL: спаривание столбцов идёт по координате, порядок в DOM перевернётся	сегодня недостижимо (RTL-локаль не включается), проверить первым делом при появлении I18nProvider
Сцены гоняются на 1440×900 и в основном на /showcase	зум 125/150/200% и узкая панель замерены руками в этой сессии, но сторожа на них нет
Возврат вкладок к fleet.png сверен ГЛАЗОМ, а не measure.py	владелец просил «примерно как во fleet.png»; пиксельная сверка не делалась и здесь названа
Механизм stretch в ui/Table.tsx в приложении недостижим (у «Смысла» нет fit)	это защита примитива от пустоты справа, носителя и сторожа у неё нет — осознанно

Открыто на владельца: В-3 (слово ступени замечания), В-4 (подпись главы без заголовка), В-6 (фраза паузы), В-7 (масштаб интерфейса), В-8 (слово состояния в дереве), Ф-38 (защита вкладки «Замечания»). На оркестратора: два черновика правки спеки (поля BankTerm, BookIntake.title) и жалобы Ф-43…Ф-47 (канала под банк нет).

14. Мигание при открытии главы (замечание владельца 10.08)

«Вижу сначала мигание — квадрат с надписью, не успеваю прочитать, — затем глава. Похоже на гонку.» Квадрат — карточка Blank со словами «Раздел · Идёт загрузка»: клик открывает НОВУЮ вкладку, её запрос главы пуст, и Loaded честно рисует ожидание.

Замер до правки (покадрово, что нарисовано в центре): холодный кэш — карточка видна 130–230 мс; тёплый (та же глава второй раз) — карточки нет вовсе. То есть лечить надо ОЖИДАНИЕ, а не показ.

Сделано двумя ходами, оба — отраслевая практика, ни одного таймера в компоненте:

1. Чтение главы стартует по НАМЕРЕНИЮ, а не по клику. onPreload у дерева срабатывает на нажатии кнопки и на приходе фокуса (клавиатура), экран зовёт prefetchQuery. Рука держит кнопку 60–100 мс — этого хватает, чтобы клик пришёл на готовый ответ. Не на наведение: провести мышью по списку из 2284 разделов — это 2284 запроса, а нажатие бывает ровно одно на намерение. Повторную предзагрузку свежих данных слой запросов отбрасывает сам.
2. Карточка ожидания проявляется только через 220 мс — отложенной анимацией, а не таймером в состоянии: гоняться не с чем, а карточка, снятая до срока, попросту не была видна ни разу.

Проверено обратное — что я не спрятал настоящее состояние: на маршруте /loading карточки видны (opacity 1). Сторож в сцене tabs смотрит НЕПРОЗРАЧНОСТЬ, а не наличие в DOM, и падает, если снять оба механизма (проверено откатом).

13. Возврат вкладок и левой колонки к fleet.png (по слову владельца, 10.08)

Владелец: «вкладки, которые ты сделал, не понравились, вернём как было примерно во fleet.png, то же самое с левым столбцом дерева». В S3.6 я перестроил ряд вкладок по fleet_2: полоса — ХРОМ, активная вкладка вырезана из неё цветом полотна. Вернул модель fleet.png: полоса — само полотно панели без подложки, активная вкладка — скруглённая ПИЛЮЛЯ на нём, вкладка открытого документа синяя (--color-tab-active, замер #142f4c), «плюс» стоит сразу за вкладками, а не у дальнего края. Правило одно на все три панели (ui/Tabs.module.css), поэтому шапка «Книги» слева поехала вместе с документами и вкладками справки — этого владелец и просил.

⚠ Откатывал ВИД, не круг. В тех же файлах лежат починки этого пака, и они остались: ряд прокручивается вместо сжатия вкладок (иначе короткое название усекалось раньше длинного соседа — жалоба владельца), предел ширины вкладки, курсив у предпросмотра, keep-alive панелей через content-visibility (это половина экономии на драге), строка дерева во всю полосу виртуализатора. Из дерева ушла только надбавка отступа, которую я вводил ради совпадения с полем вкладки.

Токены: вернулись --panel-header-height (26px) и --color-tab-active, ушёл --tab-row-height — полосы больше нет. Комментарии у --color-panel и --color-chrome переписаны: они описывали снятую модель («активная вкладка, вырезанная из хрома») и стали бы враньём рядом с кодом.

12. Четвёртый заход: четыре бага владельца и цена собственной перестраховки

Владелец прислал четыре бага и потребовал луп-ревью в Playwright — «не останавливаешь правки, пока ревью не отпустит без блокеров». Ниже — что нашлось, включая то, чего в списке не было.

Баг 1: шапка просвечивает, строки едут сквозь заголовки. Причина того же класса, что в разделе 11: фон шапки стоял на группе role="rowgroup", а она НУЛЕВОЙ высоты — то есть не рисовал ничего. Библиотека при этом сама заворачивает шапку в свою sticky-коробку с правильной высотой и z-index, так что моё position: sticky было лишним. Фон переехал на ячейки заголовка, sticky снят как чужая работа. Токен --layer-sticky стал мёртвым и удалён.

Баг 2: панель, сжатая до упора и разжатая обратно, оставляла таблицу сжатой. Это был мой useSettledWidth. Ширины считались от «устоявшейся» ширины контейнера, но результат попадал в коллекцию через <Column width>, а библиотека кэширует отрисованные колонки по объекту столбца (useCachedChildren — WeakMap, сбрасывается только сменой dependencies). Столбцы не менялись, кэш не сбрасывался, новая ширина не доезжала. Владелец назвал это «перепеформил и сделал хаки вместо нормального решения» — так и было.

Снято целиком. Ширины теперь считает сама библиотека своим flexbox-алгоритмом (§9.7 CSS Flexbox, react-stately/.../TableUtils.mjs): столбец получает долю Nfr, пол и потолок. При смене ширины панели коллекция не пересобирается вовсе — раскладка пересчитывается нативно.

Цена перестраховки — замер, а не рассуждение. Раздел 11 объяснял заморозку числом «fr даёт p90 33 мс». На текущем дереве это НЕ воспроизводится: без заморозки p90 = 17 мс, длинных кадров 1 из 84. A/B по двум подозреваемым — блюр боксом и contain на ячейках — не сдвинул число ни на миллисекунду (17 мс во всех четырёх комбинациях). Честный вывод: чем бы ни были те 33 мс, заморозка их не лечила, а баг создала. Записано как урок: число, замеренное до серии правок, не оправдывает механизм после них — перезамерять на том дереве, которое сдаёшь.

Баг 4: текст не помещается в столбец. Столбцы делили место поровну, не зная, что в них лежит. Теперь примитив меряет содержимое: канвасом, шрифтом, снятым с живой ячейки, по ВСЕМУ банку (sample), а не по видимой выдаче — иначе столбцы прыгали бы под рукой печатающего.

⚠ Правильную модель нашёл с ТРЕТЬЕГО раза, и оба неверных варианта снял не я, а ревью. Ошибка обоих раз одного рода: проверял модель на той фикстуре, что под рукой, и объяснял себе остаток.

1. Замеренная ширина как ПОТОЛОК («текст поместится, когда есть место»). На дефолтной ширине панели «Монах Цветочного Вина» и «Весенне-осенняя цикада» продолжали усекаться: столбец перевода брал свою долю 172 вместо своего содержимого 181, а соседний столбец смыслов — закрытый спойлером! — держал те же 172. Потолок никогда не бывает полом, поэтому колонка с ограниченным аппетитом всегда проигрывает колонке без него. Я видел в замере «усечено 2 из 30» и объяснил себе как «прозе не хватает», не посмотрев, ЧТО именно усечено.
2. Замеренная ширина как ТОЧНАЯ. Текст стал помещаться, но статическая ширина в алгоритме библиотеки заморожена и не уступает вовсе. Замер ревьюера: один перевод длиннее ~28 знаков — и таблица шире панели, колонка смыслов уезжает за правый край без видимой полосы прокрутки; на зуме 150% то же самое, на 200% в DOM оставалось три столбца из четырёх. Ни одна фикстура в репозитории до порога не дотягивала, поэтому ни один прогон дефекта не видел.
3. Содержимое одновременно как потолок И как ВЕС (принято). Столбец получает ${fit}fr с maxWidth: fit: пока места хватает, потолок останавливает его ровно на содержимом, а остаток уходит прозе; когда места мало, столбцы уступают ПРОПОРЦИОНАЛЬНО тому, что в них лежит. Это то самое, что делает flex-basis в CSS, — библиотека его не поддерживает (базис всегда 0, режим только «расти»), и вес по содержимому даёт тот же эффект её же средствами.

Замер модели 3: на всех проверенных ширинах содержимое равно окну — 608/608, 520/520, 856/856, на зуме 1.25/1.5/2× тоже (449/449, 329/329), все четыре столбца на месте. Длинный перевод (37 знаков) больше ничего не выталкивает: 127/246/125/110 при окне 608. Усечение остаётся там, где ему и место: в прозе и, на самой узкой панели, в паре длинных переводов — с подсказками.

Баг 3: блюр выходил за текст и мылил фон — четыре круга на одном экране. Ошибка была в понимании МЕХАНИКИ, а не во вкусе, поэтому механика записана:

• text-shadow — СОБСТВЕННАЯ краска элемента, и его же overflow: hidden режет её вплотную к глифам: отсюда ровный вертикальный срез слева.
• filter: blur() применяется ПОСЛЕ сборки элемента, и обрезать его может только предок.
• Маска работает по КОРОБКЕ элемента, а размытие выходит за неё со всех четырёх сторон — всё вышедшее маска срезает по прямой.

Круг 1: заменил фильтр на text-shadow («фильтр мылит фон») — получил срез слева; фон при этом никогда и не мылился, у спана он прозрачный. Круг 2: добавил маску ради мягкого хвоста — она же и рисовала рамку, а на раскрытом тексте читалась как затемнение конца строки.

Третий круг — и вот тут я наконец ПОСМОТРЕЛ ЗАМЕРОМ, а не глазами по общему виду. Владелец снова вернул кадр: «всё ещё квадратные, выходящие за текст». Я снял профиль яркости поперёк размытой строки (скрин ×4 → канвас → максимум по столбцам и по строкам) и получил ответ, который опроверг мою же гипотезу: обрыва нет вообще. По вертикали яркость идёт гладко 24 → 64 → 24, единственный скачок в 14 единиц — это 1px линии-разделителя; по горизонтали максимальный перепад 2 единицы. Резать было нечему.

Прямоугольники делал РАДИУС. На кегле 13px размытие 5px слепляет слова в сплошные бруски с прямыми верхом и торцами — на увеличении ×4 это видно сразу, а на общем кадре я это трижды пропустил. На 3px форма слов сохраняется, и прочитать по-прежнему нельзя.

Принято: filter: blur(3px) и больше ничего. Обвязка, накопившаяся за три круга — маска, перенос полей с ячейки на текст, text-shadow, forced-color-adjust, — снята вся; перенос полей вдобавок не давал ничего (расстояние от глифов до обрезки в обоих случаях одинаковое, 8px). Осталось три правила: обычный текст с многоточием, размытие без обрезки, снятие размытия при раскрытии. Фильтр заодно держится в режиме высокой контрастности сам, без опт-аута (замерено).

Урок, и он дороже самой правки. Четыре круга по одному экрану ушли на то, что я правил ВИД, не разобравшись в МЕХАНИКЕ, а потом на каждом круге навешивал ещё один приём поверх предыдущего. Слова владельца: «не хакай решение, нужно чистое; оно у тебя уже было, потом ты всё сломал». Два правила себе: (1) у визуального дефекта сначала выясняется, каким свойством он производится, — и меряется, а не осматривается; (2) если правка добавляет ТРЕТИЙ приём к тем же двум строкам — это признак, что диагноз неверен, а не что нужен четвёртый.

Что нашёл сам, чего в списке владельца не было (он просил ловить классы, а не пункты):

Находка	Как нашлась
Ширина «Перевода» была на 1px меньше нужного, и Весенне-осенняя цикада получала многоточие при 412px пустоты рядом: замер не учитывал ЛИНИЮ столбца, а коробка считается по border-box	глазами на кадре, потом замером
Пустая выдача убирала таблицу целиком вместе с шапкой, а сообщение улетало в низ панели под подвал: пустой коллекции библиотека отводит всю высоту под собственную заглушку (замер: 702px пустоты)	обход состояний кадрами
Замер шёл по ЗАПАСНОМУ шрифту: канвас ничего не рисует, поэтому сабсет по unicode-range не грузится, а document.fonts.ready обещает только уже запрошенные лица. Кириллица мерилась на 4.7% шире (171.7 против 164.0)	адверсариальное ревью агентом + собственная проверка
getComputedStyle возвращает ЖИВОЙ объект: за время ожидания шрифтов строки успевали исчезнуть, и все столбцы мерились шрифтом канваса по умолчанию	замер после первой же правки — сломалось видимо
Библиотека кладёт под каждый столбец собственный пол в 75px, если пола не задать: столбец уже 75px (заголовок «ТИП» — 44) сидел бы в яме	ревью алгоритма библиотеки
Если бы измеренная ширина была у ВСЕХ столбцов, остаток не достался бы никому — таблица кончалась бы, не доходя до своего правого края (ровно та пустота справа, на которую жаловался владелец)	ревью алгоритма; закрыто структурно
Регрессия моего же спойлера: в режиме высокой контрастности он исчезал целиком. Система там снимает text-shadow и перекрывает color — все описания читались открытым текстом. Прежний фильтр бокса в forced-colors не снимался, то есть новый механизм отдал этих пользователей	адверсариальное ревью замером; проверено эмуляцией
Закрытое описание выделялось и копировалось: Ctrl+A отдавал все смыслы книги разом	то же ревью; закрыто user-select, поиск по странице остаётся открытым каналом — это записано, а не замолчано
Пол столбца брался от заголовка, но эффект замера не видел ПЕРЕИМЕНОВАНИЯ столбца: локализация заголовка при том же id оставила бы старый пол навсегда	ревью; ключ эффекта теперь несёт и имена
Нефинитная ширина (пустой computed style → NaN) уводила flex-цикл библиотеки в бесконечность: он замораживает элементы по ЗНАКУ отклонения, а у NaN знака нет	ревью; закрыто проверкой на конечность
Столбец термина мерился одной гарнитурой, а рисуется двумя плюс отступ: окно применимости («с 40-го») идёт вторым спаном на 12px с зазором 4px, которого в замере не было. Замер ревьюера: нужно 120, есть 119 — окно усекалось в каждой строке столбца, который по контракту «ровно своё содержимое», и дочитать его было нечем	ревью; теперь меряется и зазор (как пробел), у окна появилась подсказка
Переполнение таблицы САМОЗАПИРАЛОСЬ: за краем панели виртуализатор роняет столбцы из DOM, а замер требует их все — и ширины залипали на неверных, пока человек не прокрутит вбок. Снялось само вместе с переполнением	ревью; закрыто моделью 3
Приёмка не ловила переполнение вообще: проверка «сумма ширин равна ширине таблицы» зелёная и когда таблица уехала за край панели	ревью; добавлена отдельная проверка, падает на откате модели (замер: содержимое 559 при окне 520)
Возврат с фильтра одного типа на «все» дёргал столбцы. Измеренные ширины хранились ТОЛЬКО для видимых столбцов: пока фильтр прятал «Тип», его ширина выбрасывалась, и на возврате столбец на один кадр приходил обычной долей. Замер: Тип=146 Смысл=146 один кадр, затем 133/159 — сдвиг соседней колонки на 13px	владелец увидел глазами; замерен покадрово, ширины теперь ПОМНЯТСЯ, сторож в сцене падает на откате (2 раскладки за 90 кадров вместо 1)

Приёмка. npm run check:full зелёный: 160 тестов, 7 маршрутов, 7 сценариев, ноль блокирующих нарушений axe, драг панели p90 17 мс. Новых проверок в сценариях одиннадцать: шапка не просвечивает · столбцы занимают таблицу целиком (на своей ширине, у минимума панели и после возврата) · таблица не уезжает за край панели · столбцы по содержимому показывают его целиком · на пустой выдаче остаётся шапка и сообщение стоит под ней · спойлер держится в режиме высокой контрастности · выделение закрытого описания ничего не копирует · спойлер проверяется по механизму (текст прозрачен и нарисован тенью), а не по слову filter · подсказка сверяется с фактическим текстом описания, а не с литералом фикстуры.

Каждая ключевая проверка откатана и падает нужным текстом — этим они отличаются от украшения: усечено: Весенне-осенняя цикада · Монах Цветочного Вина при возврате потолка, содержимое 559, окно 520 при возврате точной ширины, раскладок за 90 кадров 2 при возврате замены ширин, обрезка true при возврате обрезки размытия. Прежняя формулировка («сумма ширин равна ширине таблицы») выполнялась арифметикой всегда, пока места хватает.

⚠ Две ловушки в самих проверках, обе из ревью:

• «что нарисовано сверху» флейкало: пока прокрутка идёт, виртуализатор снимает указатель со всего содержимого, и ответом становится сам грид. Ожидание транзиента — не ожидание успеха. Но и комментарий рядом врал: elementsFromPoint идёт по порядку наложения, а не по прозрачности, и дефект ловит только вторая половина проверки — плотность фона. Контрфакт замерен, комментарий исправлен: врущий комментарий тут санкционировал бы снос работающей половины.
• Проверка «подсказка не печатает описание» сравнивалась с литералом из фикстуры: сменись фикстура, и она молча стала бы пустой. Теперь сравнивается с фактическим текстом описания той же строки.

Известные ограничения, записаны честно: канвас не знает про lang, поэтому при двух CJK-лицах (SC и JP) под одним слагом замер может разойтись с отрисовкой — на этом стенде стоит одно лицо, расхождение 0px; RTL перевернёт порядок колонок в DOM, а спаривание идёт по координате — сегодня недостижимо (локаль RTL в приложении не включается), но при появлении I18nProvider проверить первым делом.

09.08 — шестая фронт-сессия (S3.5): фикс-пак оболочки по 24 замечаниям владельца

Промт S35_SESSION_PROMPT.md отработан. Ниже прогон по ВСЕМ 24 номерам владельца; молча пропущенных нет. Кадры — .shots/ (маршруты) и .shots/scenes/ (интеракции), они не коммитятся, поэтому в тексте называется, что на них видно, и чем это проверено.

Чем принято. npm run check зелёный (7 шагов, 144 теста). npm run shot — семь маршрутов, ноль узлов контраста у axe на всех семи (было 6 на маршрутах с данными и 3 на пустых) и ноль блокирующих нарушений. npm run scenes — пять сценариев интеракций, 19 проверок, все зелёные. Наложение 1280×764 на fleet.png и кадр 2560×1440 сняты и разобраны (FRONTEND_PLAN.md §5.5).

Что нашла собственная проверка исполнением, а не рассуждение (записано, потому что каждый из трёх — отдельный класс ошибки, и следующая сессия наступит на них снова):

1. Замыкание внутри строки коллекции застывает. Двойной клик по строке дерева не закреплял вкладку: обработчик, повешенный на TreeItem, живёт в КОЛЛЕКЦИИ библиотеки и пересобирается только при смене items, а items мемоизированы книгами и разделами — замыкание осталось с первого рендера. Лечение: обработчик на обёртке дерева, которая перерисовывается вместе с экраном; какая строка нужна, уже сказал выбор. Нашёл сценарий scenes tabs.
2. Ключ строки сводки замечаний схлопывал три замечания одного раздела в одно. У замечания в контракте нет собственного идентификатора, а ключом был chapter_id. Лечение — позиция в списке; проверка «в сводке ровно 4 строки» добавлена сценарием scenes context.
3. keep-alive оставляет соседние вкладки в DOM — и это меняет способ ПРОВЕРКИ. Глобальный локатор по роли находит скрытую строку соседней вкладки и ждёт её видимости до таймаута. Все сценарии теперь ищут внутри своей области; в scenes.mjs это записано комментарием, потому что грабли не разовые.

№	Замечание	Что сделано	Чем проверено
1	масштабы великоваты, особенно на 27″ 2K	Разделено замером на две разные вещи. При вьюпорте референса 1280×764 расхождения НЕТ: промежутки, ширины панелей 320·608·320, шаг строки 26 и высота пилюли вкладки 26 совпадают с Fleet — то есть «уменьшить всё» значило бы уехать ОТ референса. На кадре 2560×1440 нашлась настоящая беда другого рода: боковые панели держат ширину в пикселях, вся лишняя ширина доставалась центру, и строка перевода шла в ~150 знаков. Введён предел меры набора --reader-width: 1040px с центрированием блоков (~75 знаков в колонке). Физический размер на мониторе — вопрос масштабирования ОС, ручки «плотность интерфейса» у нас нет; цена ручки посчитана, строка Ф-36, вопрос владельцу В-7	scripts/measure.py, кадры 1280×764 и 2560×1440 ДО/ПОСЛЕ
2	спам вкладками	Модель VS Code целиком: одиночный клик — вкладка ПРЕДПРОСМОТРА, одна на панель, заголовок курсивом; следующий одиночный клик замещает её; закрепление — двойной клик по строке дерева, двойной клик по самой вкладке, Enter на выбранной строке либо содержательное взаимодействие с содержимым; закрытие как было. Модель вынесена в чистый модуль showcase/documents.ts и проверяется юнит-тестами, а не кадром. Что считаем содержательным взаимодействием: ВЫДЕЛЕНИЕ текста в паре. Правки у нас нет, а выделение — единственный акт, который читатель совершает намеренно и который означает «эта глава нужна дальше»; прокрутка намеренно не пинит	npm run scenes tabs (5 кликов → одна превью; двойной клик → пин; следующий клик → новая превью рядом) + documents.test.ts
3	вкладки мелкие, слиты с панелью	Причина найдена замером, а не на глаз: высота пилюли у нас и так 26 (как в референсе), а разошлись ПОЛЯ и ПРОМЕЖУТКИ — у Fleet поле вкладки 10 и промежуток ~5, у нас было 8 и 2. Введены --tab-inset: 10 и промежуток --space-3. Активная вкладка получила ступень заливки крупнее (--color-selected вместо --color-raised: разница с панелью была 4% светлоты) и полную яркость текста	наложение 1280×764, срезы через ряд вкладок
4	две кнопки поиска делают одно и то же	Роли разведены: лупа справа вверху — настоящая палитра быстрого перехода к разделу или термину (модальное окно, ввод + список, выбор раздела открывает превью-вкладку, выбор термина открывает банк с фильтром на этом термине). Вкладка-заглушка «Поиск» из левой панели СНЯТА: построить полнотекстовый поиск нечем — у контракта нет ни одной поисковой ручки. Строка Ф-33	npm run scenes overlays
5	выравнивание полос, «заметно по тексту снизу»	Пере-замер нашёл точную причину. У Fleet верхняя и статус-полоса прижаты к краям окна, а их содержимое центрируется в самой полосе: центр иконок y=17.75 при полосе 0‥36, центр текста статус-полосы y=749.75 при полосе 735.5‥764. У нас стояла разбивка «8 поля + 28 полосы», дававшая центры 22 и 745.5 — текст снизу висел на 4px выше и оставлял под собой пустую полосу. Токены стали 36 и 28, поле оболочки осталось только по бокам, поле текста полос — 12 (замер Fleet: 12.5 слева, 13.5 справа). Общая геометрия не изменилась: 36 + 836 + 28 = 900	замер вертикальных срезов обоих кадров, зум статус-полосы ДО/ПОСЛЕ при --dpr 1
6	«О книге» — метаданных больше, подходы охранять	Список расширен ровно до границы контракта: языки, жанр, состояние, переведено %, разделов, блоков, знаков, замечаний, добавлена, а при наличии прогона — начат, завершён, потолок прогона в разделах, остановка на подписи. Ни моделей, ни роутинга, ни стадий конвейера, ни денег: разрешающий список контракта их не отдаёт, и восстанавливать их по косвенным полям — то же самое, что показать	кадр /showcase, вкладка «О книге»
7 · 13	представление банка «совсем не годится»	Перепридумано. Строка стала двухстрочной карточкой: исходная сторона, различитель смысла, ТИП термина, перевод и СОСТОЯНИЕ подписи словами контракта (предложен · черновик · подписан); полная карточка с окном применимости — в подсказке строки. Тип показан потому, что контракт прямо говорит: name и place маршрутизируют термин в транслитерацию, значит строка без типа подписывается вслепую; строка без типа честно говорит «тип не определён» (требование контракта, а не наша выдумка). Спойлеры: термин, чьё окно начинается позже читаемого раздела, раскрывает то, до чего читатель не дошёл — перевод закрыт размытием и открывается наведением, вместо него стоит «с N-го». Чего в контракте НЕТ (род/пол, обоснование, варианты) — не заведено ни в фикстуру, ни в типы; правка спеки предложена черновиком ниже. Строка Ф-39	кадр /showcase, правая панель; спойлер виден на 青茅 (растение) и 不死凤凰
8	вкладка «Замечания» — лишняя	Защищена, но не тем, чем была. По пер-ГЛАВНОМУ списку владелец прав: он дублировал читалку. Вкладка переделана в пер-КНИЖНУЮ сводку — фраза замечания плюс раздел, строка открывает раздел вкладкой. Сценарий, который без неё не живёт: «пройтись по всем местам книги, требующим внимания», не открывая разделы по одному. Лишних запросов это не стоит: контракт отдаёт замечания пер-книжно и по-другому не умеет (Ф-32). Финальное слово владельцу, строка Ф-38	кадр /showcase, вкладка «Замечания»
9	оригинал и перевод разделены слабо	Приём РОВНО ОДИН: волосяная линия по жёлобу между колонками. Нарисована на скролл-контейнере, а не на каждом блоке — иначе она рвётся на промежутках между блоками и читается как таблица; суммарный отступ между текстами оставлен прежним, ширина колонок не поехала. Приглушение колонки оригинала не трогали — это хвост Ф-7 на S6	замер: линия стоит ровно на 720.0 CSS при центре содержимого 720
10	серо-синюю линию не удалось прочитать	Сделана СВЯЗЬ полоски со своей подписью: значок того же тона стоит у начала подписи, наведение на блок подсвечивает обе разом, подпись поднята с приглушённого тона до вторичного. Ступень по-прежнему различается только цветом, и этот остаток честно не закрыт: значок у обеих ступеней один, а СЛОВО ступени продуктовое и стоит на владельце (Ф-21, В-3) — выдумать его здесь значило бы сделать ровно то, что промт запрещает. То есть номер закрыт наполовину по решению, а не по недосмотру	кадр /showcase, две выноски в читалке
11 · 19	настройки: в правый верх и модальным окном	Шестерёнка — в правом верхнем углу, из низа левой панели вход убран (он там был единственным, теперь единственный здесь). Открывается модальным окном поверх оболочки. Внутри — честный каркас разделов: профиль и доступ · язык интерфейса · светлая тема · перевод по умолчанию · использование, у каждого одна строка о том, чего в нём пока нет. Переключателей, которые ничего не переключают, не нарисовано: это были бы кнопки без действия	npm run scenes overlays, кадр modal-settings.png
12	добавление книги — модальным окном	Сделано по antigravity_add_folder.png: выбор файла (настоящий, а не нарисованный — имя нужно живьём), поле названия и слоты будущих пер-книжных настроек. Два источника названия разведены и названы ДО нажатия: пустое поле — «название определит разбор файла», заполненное — «название задано вручную: разбор его не перепишет». Сам аплоад не строится (Ф-26) — это экран S4	npm run scenes overlays, кадр modal-add-book.png
14	слишком точная копия Fleet	Доводка, не редизайн: поверхности ушли в тёплый подтон той же светлоты, вкладка открытого документа уведена из синего Fleet в тон акценту — «открытый документ» и «фокус» теперь читаются одной системой, а не заимствованной парой. Чёрный фон между окнами не тронут (--color-shell тот же #090909), полоска ресайза его тоже не закрашивает	кадры четырёх палитр рядом
15	нет светлой темы и выбора языка	Цена посчитана честно, и дёшево не выходит ни то, ни другое — диспозиции в строках Ф-34 и Ф-35. Сделана та часть, что дешевле сегодня, чем завтра: локаль интерфейса сведена в ОДНО место (ui/Locale.tsx), прежде её порознь зашивали провайдер примитивов, имена языков, формат чисел и формат дат. Оба пункта названы в каркасе настроек честными строками	код + каркас настроек на кадре
16	фон главных окон серо-неприятный	Изучены рекомендации по тёмным фонам (не чистый нейтральный серый; слегка тонированные тёмные; текст не на максимуме контраста). Сняты кадрами ТРИ варианта — тёплый уголь, холодный графит, индиго. Выбран тёплый: он дальше всего от Fleet и подходит продукту, где основная работа — чтение. Холодный и индиго остаются альтернативами владельцу (пере-снимаются одной правкой tokens.css, значения в записи ниже). Контраст пересчитан: axe печатает НОЛЬ узлов на всех семи маршрутах	palette-compare (четыре кадра одним листом), прогон axe
17	иконки шакальные, текст рендерится странновато	Причина найдена, а не замазана. Она не в толщине, а в сетке: набор нарисован на сетке 24, рисуется размером 16, координата c уезжает в 2c/3, у геометрических форм (c кратно трём — рамка панели и её перегородка) центр штриха шириной 1px попадает ровно на ЦЕЛЫЙ пиксель и размазывается по двум половинкам. Проверены четыре варианта кадрами при --dpr 1: «штрих 2 при размере 16» и «размер 18, штрих 2» дают жирнее, но по-прежнему мыльно; полупиксельный сдвиг SVG даёт целые линии — взят он. Отдельно важное про инструмент: при дефолтных 2x этот дефект в кадр НЕ ПОПАДАЕТ вовсе, поэтому у npm run shot появился ключ --dpr. Текст статус-полосы: настоящий дефект был геометрическим (номер 5) плюс приглушённый тон; и то и другое исправлено. Цветная бахрома субпиксельного сглаживания остаётся — это норма платформы, расхождение уже принято в FRONTEND_PLAN.md §5.2 п.1	зумы 1x ДО/ПОСЛЕ: тогглы панелей, дерево, статус-полоса
18	фиолетовая полоска залипает; форма полоски	(а) Причина найдена в коде библиотеки, а не угадана: data-separator становится focus по обычному onFocus (dist/react-resizable-panels.js: z ? G = "focus"), а мышиный pointerdown фокус ОСТАВЛЯЕТ — наш стиль красил это состояние акцентом, и после отпускания драга полоска светилась. Лечится :focus-visible, который мышиный фокус не показывает; клавиатурная доступность при этом сохраняется. (б) Форма скопирована подходом с vojo: зона захвата — весь геп, индикатор — пилюля 2×36 по центру, в покое невидима, под курсором 0.35, в драге акцент и рост до 48, на упоре min сплющивается, на упоре max вытягивается. Чёрный геп не закрашивается ничем: разделитель прозрачен всегда	npm run scenes drag: в драге opacity 1 → после отпускания opacity 0, при этом библиотека ДЕРЖИТ data-separator="focus" — сценарий проверяет именно это
20	«подписать банк» и «подписано 10 из 60» непонятны	Кнопка снята: она вела во вкладку-заглушку, то есть была кнопкой без действия, а счётчик не отвечал ни на один вопрос человека. На её месте — честное состояние банка словами контракта, без выдуманных глаголов: «60 терминов · подписано 10 · ждут решения 50». Механизм подписи — S5	кадр /showcase, подвал правой панели
21	цветной статус книги — на иконке	Точка состояния переехала на угол иконки книги. Слово рядом осталось: цвет ДУБЛИРУЕТ его, а не заменяет — тексту цвета замечания и отказа не хватает контраста, точке порог для текста не предъявляется	кадр /showcase, левая панель
22	«где генерится оригинал названия главы?»	Вопрос владельца, ответ вписан оркестратором в промт; сессии тут делать нечего. Записано для полноты: сейчас метка приходит из фикстур мока, в бою — из ДАННЫХ книги (heading/number, К-3), а чем подписывать главу без заголовка — открытый В-4 на владельце (Ф-30)	—
23	системные надписи наезжают на название	Бейджу дано ФИКС-место шириной --badge-width, текст в нём выравнен вправо, название слева забирает всю свободную ширину и усекается первым — пересечься теперь нечем. Ширина взята по самой длинной метке словаря; заодно метка paused укорочена с «остановлена: лимиты» до «на паузе» — причина паузы и так печатается один раз, в статус-полосе, и дублировать её в самый длинный бейдж дерева незачем	кадр /showcase: «нужна подпись», «не разобрана», «на паузе» помещаются целиком
24	пометка черновика	Над текстом главы — мягкая строка со значком и тултипом: «черновой вариант, может быть перегенерирован», подробность в подсказке. Форма взята из данных контракта: пока прогон не довёл книгу до ready, и текст, и нарезка законно пересобираются. Неизвестное состояние тоже считается черновым (безопасная сторона), отсутствие книги пометки не даёт. Точнее было бы по ГЛАВЕ, но units_done контракта не разведён по фазам — строка Ф-37	кадр /showcase, шапка читалки

Что закрыто в бэклоге: Ф-19 (keep-alive панелей, сценарий scroll), Ф-11 (ноль узлов контраста замером). Заведено: Ф-33..Ф-39.

Адверсариальное ревью диффа (author≠reviewer, три независимые линзы — корректность, соответствие заданию, энтропия). Считаю нужным перечислить, потому что половина находок — мои дефекты, а не придирки, и часть из них ревью поймало ровно там, где мой отчёт заявлял «сделано».

Находка	Диспозиция
Замечание 5 стало ХУЖЕ, а записано как исправленное. --bar-inset: 12 клался внутрь оболочки, у которой своё поле 8 → текст полос уехал на 20 от края окна при цели 12.5 (было 14). То есть правка увела ОТ референса	Исправлено: поле оболочки перенесено на область панелей, полосы стали полнокровными. Замер после правки: наш текст x 12.5…1267.0, y 744.5…756.0 против 12.5…1266.5, 744.5…756.0 у Fleet — сходится по обеим осям. Промежутки панелей не сдвинулись
Тронуто слово, зарезервированное за владельцем. Метка paused укорочена с «остановлена: лимиты» до «на паузе» ради ширины бейджа, а промт прямо запрещает трогать фразу паузы (В-6)	Откачено. Слово возвращено, бейдж усекается с тултипом, а сам вопрос вынесен владельцу строкой В-8. Урок записан в код: ширина колонки — не основание менять продуктовое слово
Ключ строки палитры перехода собран из term.src — ровно тот приём, против которого в соседнем файле стоит пятистрочный комментарий; в фикстуре уже лежит контрпример (два «青茅»)	Исправлено: ключ — непрозрачный term.id. Заодно фильтр терминов стал ОДНИМ предикатом на банк и палитру (showcase/terms.ts): раньше палитра искала по склейке «src — dst» и находила то, чего банк, куда она ведёт, не показывает
Действие ведёт в свёрнутую панель. Выбор термина в палитре переключал вкладку правой панели, которая может быть свёрнута, — и не делал ничего видимого. expand из shell/layout.ts при этом остался без вызывающих	Исправлено: панель разворачивается вместе с действием
Спойлер банка блюрил ВЕСЬ банк у книги без нумерации (number = null → позиция чтения 0)	Исправлено: у книги без номеров берётся позиция в порядке чтения — она есть всегда
Выноска смещена на 2px относительно блока без замечания, поэтому её жёлоб уходил с волосяной линии читалки	Исправлено: прозрачная граница с обеих сторон, сетка общая
Ф-19 закрыта механизмом, но исходный кейс приёмки (дерево на /scale) остался непокрытым: после снятия вкладки «Поиск» дерево защищено не keep-alive, а тем, что рядом нет второй вкладки	Исправлено частично: keepAlive передан и левой панели, то есть механизм стоит и там; сценарий по-прежнему проверяет банк (1200 строк того же порядка), и это названо в Ф-19
Замечание 12 не имеет опоры в контракте: у BookIntake нет поля title, а разведение двух источников названия — центральное требование номера	Исправлено в бумаге: вторая правка спеки предложена черновиком выше. Дисциплина, применённая к банку, к модалу сначала применена не была — это мой пропуск, а не находка о контракте
Три токена мертвы (--color-current-line, --color-hint, --font-mono), и замок полноты их узаконивал	Исправлено: у теста токенов появилось обратное направление — «объявленный токен кем-то используется», с именным списком зарезервированных под Ф-20. Гейт проверен живым нарушением
Комментарии-простыни, местами по три копии одного рассказа (код + тест + план)	Сокращено: тела остались в FRONTEND_PLAN.md §5.5, в коде — по одной строке со ссылкой. Это постоянное замечание владельца, и оно справедливо
measure.py содержал мёртвую функцию и обёртку-пустышку; references/ не был ни в git, ни в .gitignore	Исправлено: мёртвый код снят, references/ внесён в зонный .gitignore (чужие скриншоты в репозиторий не едут, кладёт их владелец)
scenes не гонялся ничем	Исправлено: check:full = check + build + shot + scenes
Дублируются стили поля ввода (TextField и FilterField), Showcase.tsx за нормой 150 строк	Частично: из Showcase.tsx вынесены модель дефолтных вкладок и сигнал скриншот-цикла (230 строк — по-прежнему за нормой, экран режется на features/ при S4). Дубль CSS поля признан и оставлен: правка требует общего модуля стилей на два примитива, и делать её в фикс-паке оболочки — лишний риск. Строка Ф-40
Спойлер раскрывается только наведением (клавиатура и тач не раскроют); у спойлерной строки метка подписи замещается на «с N-го»	Принято как есть, названо: раскрытие кнопкой внутри строки списка — вложенный интерактив, его роняет гейт доступности (Ф-17). Полная карточка термина живёт в подсказке. Строка Ф-41
Двойной клик МИМО строки раздела закреплял чужую вкладку. Обработчик брал «текущий выбор», а строка книги и пустое место выбор не двигают — измерено прогоном: двойной клик по книге закреплял главу	Исправлено: строка берётся из САМОГО события, по data-key, который библиотека кладёт на строку. Покрыто сценарием
Ветка Enter была мёртвым кодом, а доккоммент обещал, что она работает. usePress библиотеки останавливает всплытие синтетического keydown, и обработчик на обёртке до него не доходил	Исправлено: перехват (onKeyDownCapture) — фаза перехвата идёт ДО обработчиков строки. Проверено прогоном: Enter по разделу закрепляет, по книге не трогает ничего
Проверка палитры в сценарии была самоподтверждающейся: на витрине одна вкладка предпросмотра открыта всегда, и «после выбора их ровно одна» прошло бы, даже если выбор не делает ничего	Исправлено: сценарий спрашивает ИМЯ открытой вкладки и имя найденной строки. Это ровно тот класс, ради которого мандат самопроверки и написан
Escape не закрывал палитру с первого нажатия: примитив поиска первым нажатием чистит свою строку и наружу событие не пускает	Исправлено перехватом; проверка добавлена в сценарий
Линия жёлоба читалки уезжала бы на классических полосах прокрутки Windows: фон стоял на скролл-контейнере, а он позиционируется по padding-box, куда входит полоса. На стенде полосы оверлейные, поэтому кадр этого показать не мог	Исправлено: линия переехала на СОДЕРЖИМОЕ. Отдельно ценно, что дефект нашёлся рассуждением о механизме там, где инструмент слеп
Сигнал скриншот-цикла стал считать ЛЮБОЙ запрос, включая фоновый рефетч по возврату фокуса и обновления от живого прогона, — кадр снимался бы в гонке с ними	Исправлено защёлкой «однажды сошёлся — больше не гаснет». Первая версия защёлки сработала слишком рано и объявила готовым маршрут, снятый ради ожидания, — поймал сам скриншот-цикл, защёлка теперь закрывается только после того, как что-то реально полетело
Палитра: при 50 совпавших разделах ни один термин до списка не доходил — обрезка резала общий список, а разделы стояли первыми	Исправлено: у разделов и терминов свои слоты; строка «показаны первые N» теперь показывается по факту обрезки, а не по совпадению длины
Строка замечания без раздела никуда не ведёт, но курсор обещал переход (раздел у замечания по контракту необязателен)	Исправлено: такой строке курсор возвращён в обычный
Шаг строки банка 46px против нарисованной коробки 40px: 6px между строками подсветка наведения не закрашивает	Принято: это шаг виртуализатора, а не высота коробки; комментарий токена исправлен, чтобы следующая сессия не искала эту высоту в CSS
Выбор термина в палитре ставит фильтр банка по исходной стороне, и различение двух легальных строк одного иероглифа на этом теряется	Принято, названо: фильтр — текстовый по построению; точное наведение на строку появится вместе с экраном подписи S5
keep-alive не ограничен: семь закреплённых вкладок — семь смонтированных читалок и семь запросов	Названо строкой Ф-42: на фикстурных главах цена нулевая, на настоящих — нет

Черновик правки спеки — ПРЕДЛОЖЕНО, не ратифицировано (замечания 7 и 13). Ратифицирует оркестратор; в зонную копию api-contract/openapi.yaml эта сессия НИЧЕГО не вносила, потому что правка спеки тянет за собой генерённые типы, а фикстура на выдуманной форме — известный класс ошибки (Ф-14). Владелец просит на термин больше, чем контракт отдаёт:

Предложено в BankTerm	Зачем	Откуда движок это возьмёт
gender (m/f/n/plural/null)	русский требует согласования: «Бай Нинбин сказал» ↔ «сказала». Сегодня род термина существует только в голове переводящей модели, и проверить его на подписи нечем	открытый вопрос к движку: в glossary такой колонки нет
rationale (строка, необязательная)	«почему предложен именно такой перевод» — то, ради чего подпись и существует; без обоснования человек подписывает вслепую	добытчик терминов знает контекст находки; вопрос, что из него легально показать (§4.1)
variants (массив строк, необязательный)	у термина бывает несколько кандидатов; сегодня приезжает один dst, и выбор человека сводится к «принять или переписать руками»	вопрос к автору контракта
—	спойлерная граница НЕ нужна отдельным полем	она уже есть: since_chapter/until_chapter — окно применимости, и S3.5 использует его именно как спойлерную границу

Вторая правка спеки, из замечания 12 (нашло адверсариальное ревью — та же дисциплина, что применена к банку, к модалу добавления сначала применена не была): у BookIntake четыре поля — file, source_lang, target_lang, genre, и title среди них НЕТ. Между тем центральное требование замечания 12 — «автор вводит название руками ЛИБО скипает, тогда название даёт авто-парсер, и эти два источника надо различать». Предложено: title (строка, необязательная) — пустое значение означает «взять из разбора файла». Различение источников на клиенте достаточно для формы, но не для экрана загрузки S4: без поля в спеке введённое руками название отправить некуда. Ратифицирует оркестратор.

Изменённые файлы. src/tokens/ (tokens.css, reset.css, measures.ts, tokens.test.ts) · src/shell/ (Shell.tsx, Shell.module.css) · src/ui/ (Tabs, Tree, List, Button, Callout, FilterField, Locale + новые Modal, TextField) · src/showcase/ (Showcase, Library, Context, Reader, format + новые About, Bank, Notes, Document, Settings, AddBook, Goto, documents, documents.test; удалён rooms.ts) · src/api/vocabulary.ts, src/api/index.ts · scripts/shot.mjs, новые scripts/scenes.mjs и scripts/measure.py · package.json · README.md, docs/FRONTEND_PLAN.md, docs/BACKLOG.md, этот файл.

Альтернативные палитры на случай, если тёплая не подойдёт (меняются одной правкой блока поверхностей tokens.css): холодный графит — панель #14181d, приподнятая #1f242b, выбранная #2b323b, текст #dde1e6/#8b939c/#6d747d, вкладка документа #16304e; индиго — панель #16171f, приподнятая #21222d, выбранная #2e2f3d, текст #e0e0e8/#8d8d9b/#71717f, вкладка документа #232455.

08.08 — пятая фронт-сессия (S3): слой данных построен, контракт правлен до 0.2.0

Замок открыт, и это проверено, а не принято на слово. Контракт лежит в docs/architecture/14-api-contract/ (спека + компаньон), вторая сторона — платформа — залендена. Первым шагом, как и велел промт, правки спеки; кодом занимался после.

Спека: 0.1.0-draft → 0.2.0

Внесён ВЕСЬ список промта; что именно и куда — построчно в канон docs/architecture/14-api-contract/ (патч ПРИМЕНЁН и удалён, D39.115), здесь только то, что стоит знать следующему.

Одно отступление от буквы промта, называю вслух. Пункт А-нуль говорил: «твоё там одно — бампнуть version». Но в шапке info стояла фраза «строка version всё ещё -draft — S3 бампнет её первым же действием», и после бампа она становилась ЛОЖНОЙ. Оставить в нормативном файле предложение, которое врёт про его собственное состояние, — это ровно тот дефект, из-за которого шапку и правили три дня назад. Заменил его на правду: копия сейчас намеренно ВПЕРЕДИ канона, и байт-равенство восстанавливается после пере-ратификации. Баннер «DRAFT … not a ratified contract» не возвращён.

Единственное место, где решение было за мной, — форма ручки границ потолка (В-трис). Взял отдельный ресурс GET /books/{bookId}/run-options, а не поле карточки книги. Довод не эстетический: максимум зависит от АККАУНТА (баланс минус открытые холды) и двигается, когда книга не меняется — холд под другую книгу опускает остаток. Карточка книги кэшируется и переиспользуется библиотекой, то есть назвала бы максимум, которого уже нет, ровно в тот момент, когда человек двигает ползунок. Три числа вместо двух: default_chapters отдаёт платформа, потому что выбор предустановленного значения — это продуктовая политика («потратить всё» ↔ «одна глава»), и клиент, выбравший его сам, принял бы это решение молча. max_chapters: 0 объявлен легальным ответом со смыслом «прогон начать нельзя вовсе». Обоснование целиком — в передаче §3.

Две ошибки входных данных, найденные исполнением, а не чтением. Первая: форма Usage в промте записана в синтаксисе OpenAPI 3.0 (nullable: true), в 3.1 он невалиден — выражено через oneOf с type: 'null', как и всё остальное в этой спеке. Вторая: в контракте не существует способа отличить достижение СОБСТВЕННОГО потолка прогона от исчерпания кредита — paused_reason имеет ровно одно значение, и оно про кредит. Механически они могут совпадать (холд берётся на сумму потолка), но это надо СКАЗАТЬ, а не вывести: у двух положений разная фраза. Заведён К-13, вопрос не решал сам.

Слой данных

• src/api/ разложен по обязанностям, а не по слоям ради слоёв: client.ts (HTTP, X-TM-Client, следование курсору до конца коллекции) · revision.ts (отбрасывание устаревшего чтения) · stream.ts (EventSource, рукопожатие, ре-синк) · vocabulary.ts (словари и их смыслы, включая ветку неизвестного) · contract.ts (суженные типы и нормализация) · queries.ts (по функции на операцию контракта). React в api/ не попал: слой запросов живёт на экране, как и требует план.
• MSW стоит СЕТЕВЫМ моком, а не подменённым модулем. Разница не стилистическая: приложение делает настоящий fetch и настоящий EventSource, поэтому ветки ожидания, ошибки и пустоты — это код, который побежит в бою, а не второй его экземпляр.
• Шесть миров фикстур, по маршруту на каждый: /showcase трудный случай · /scale длинный хвост · /empty · /loading · /error · /offline. Каждый снимается и прогоняется axe: ветка, которую нельзя открыть по прямой ссылке, не проверяется ничем.
• Ф-15 и Ф-22 закрыты. types.ts удалён, экраны живут на типах контракта.

Что измерено ДО того, как на нём что-то построили

• Сервис-воркер MSW перехватывает EventSource в живом Chromium и отдаёт потоковое тело кадр за кадром, lastEventId заполняется. Проверено зондом до первой строки слоя потока.
• В тестовом DOM EventSource нет вовсе — ни у happy-dom, ни глобального от Node. Отсюда развод: разбор кадра отдельно от транспорта, транспорт покрывает браузер, правила покрывает тест на подставном источнике.
• Живой поток действительно двигает интерфейс: на /showcase статус-полоса за 3.5 с прошла «переведено 3% · осталось 3 ч» → «4% · 1 ч». На /offline числа стоят, а полоса говорит «живой прогресс недоступен» — чтения при этом работают. Это замер в браузере, а не вывод из кода: скриншот снимается раньше первых кадров и такого доказательства не даёт.
• Виртуализация пережила смену слоя данных: на /scale 2284 главы прочитаны страницами по 500 и склеены до конца, в DOM держится 41 строка при scrollHeight 59 410.

Что нашёл сам скриншот-цикл — и почему это стоит того, чтобы смотреть

Три дефекта, и ни один не был бы найден чтением кода; каждый сначала увидели на кадре.

1. Выключенный запрос TanStack Query остаётся pending НАВСЕГДА. На /empty правая панель вечно показывала «Банк памяти · Идёт загрузка» — библиотека пуста, книги нет, запрос выключен, а экран обещал, что данные вот-вот приедут. Лечение — различать «ждём» и «выключено» (fetchStatus === 'idle') на шве отображения, одним местом.
2. Соседний класс того же дефекта: пока библиотека ещё летит, зависимые панели объявляли «Книга не выбрана» — тоже неправда, просто с другой стороны. Панель, чей запрос выключен ТОЛЬКО потому, что не приехала предпосылка, обязана говорить «жду».
3. Центр на /scale снимался в полёте: сигнал готовности считал только библиотеку и книгу, а юниты ещё летели, и в кадр попадала карточка «Идёт загрузка». Сигнал переопределён как «ни один запрос не в полёте» — именно «в полёте», а не «pending», иначе выключенный запрос держал бы флаг вечно.

networkidle в скриншот-цикле пришлось снять, и вернуть его нельзя. Живой прогон держит SSE-соединение открытым по построению — сеть не затихает никогда. Вместо него экран сам говорит, когда решил, что рисовать; у маршрута /loading финальная картинка это и есть ожидание, поэтому он снимается на loading и перечислен в PENDING_ROUTES.

Что поймал собственный тест на моём же коде

Тест потока, написанный после кода, уронил две вещи: кадр hello уезжал подписчику (рукопожатие — дело слоя потока, а не экрана), и кадры продолжали обрабатываться ПОСЛЕ отказа по мажорной версии и после отписки. Второе в живом EventSource замаскировано тем, что close() останавливает доставку, — то есть дефект был бы невидим до первого браузера, который доставит уже поставленный в очередь кадр. Обе правки в stream.ts.

Ревью исполнением (мандат)

Приложение поднято, шесть кадров сняты и просмотрены; npm run check зелёный на семи шагах, 107 тестов; npm run shot зелёный, гейт доступности зелёный на всех шести маршрутах. Семь форм нарушения гейтов проверены живьём с откатом копией файла, не git checkout (перечень — FRONTEND_PLAN.md §5.4.3): выброшенное значение словаря роняет tsc с именем пропавшего значения · спека без пере-генерации типов · разошедшийся мажор спеки и клиента · маршрут мимо shot.mjs · EventSource в экране · window.fetch в экране · импорт моков в экране, статический и динамический. EventSource внутри src/api/** проходит — и обязан.

Адверсариальное ревью диффа (author ≠ reviewer) — что оно поменяло

Пять независимых линз по диффу, на каждую находку — скептик с установкой ОПРОВЕРГНУТЬ (35 агентов). Из тридцати находок выжило четырнадцать; остальные опровергнуты чтением файлов, и это ровно та половина работы, ради которой ревью и делается.

Главную находку я не увидел сам, и она была настоящей. Ревизионный гейт никогда не сравнивал чтение с уже применённым КАДРОМ: кадры регистрировались под ключом stream:<книга>, чтения — под book:<книга>, chapters:<книга> и так далее. Пространства ключей не пересекались, то есть чтение сравнивалось только с более ранним ЧТЕНИЕМ — а гонка, ради которой гейт написан и которая описана в его же шапке, осталась открытой. Три скептика по очереди пытались это опровергнуть и не смогли; один воспроизвёл на моей же фикстуре. Сценарий: кадр progress двигает счётчик, рефетч по возврату фокуса приносит ответ, подготовленный ДО кадра, и полоса откатывается назад — ровно то, что спека в Revision объявляет MUST NOT.

Лечение — не заплата, а снятие лишней сущности. Я держал СВОЮ копию последнего чтения, чтобы было с чем сравнивать; копия протухала в момент, когда поток патчил кэш, и сравнение шло не с тем, что на экране. Теперь сравнение идёт с тем, что приложение действительно держит: кадр поднимает ревизию у записи кэша, которую патчит, а чтение отбрасывается на входе в кэш (freshest в queries.ts). Хранилище копий удалено целиком — вместе с ним ушла и вторая подтверждённая находка: карта росла на каждую прочитанную главу и не чистилась никогда.

Фикстура при этом моделировала сервер, которого контракт не допускает, и потому не могла этот дефект показать: чтения отвечали замороженной ревизией 1841, пока поток уводил её к 1859. Живая часть мира вынесена в mock/live.ts, поток и чтения двигают её вместе, а тест теперь прямо проверяет, что чтение не отвечает ревизией старше уже отправленного кадра.

Остальные подтверждённые находки, все проверены и починены:

Что	Почему это дефект
Loaded предпочитал ветку ошибки уже показанным данным	упавший ФОНОВЫЙ рефетч стирал отрисованную главу и терял место читателя; данные, которые уже есть, переживают неудачное обновление
При отказе библиотеки центр говорил «Библиотека пуста», а правая панель — «Книга не выбрана»	это видно на моём же кадре /error: экран называл отказ пустотой. Заведена третья ветка — «Библиотека недоступна»
Счётчик банка в подвале рисовал «подписано 0 из 0» поверх «Идёт загрузка»	экран противоречил сам себе на двух моих кадрах; счётчик появляется только когда банк ответил
eta_seconds: null давал висящее «осталось» без числа	null — легальное значение, которое я сам же и объявил в спеке; проверка ловила только undefined
problem.title уезжал на экран, а контракт ограничивал только detail	мой комментарий утверждал гарантию, которой в спеке не было. Спека теперь требует продуктового языка от ОБОИХ полей — их обоих читает пользователь
Мир /scale отдавал юниты чужой книги на любую главу	дерево говорило «1 из 2», читалка показывала четыре блока другой главы
Тест «ревизия скоупится по ресурсу» не мог упасть	обе фикстурные ревизии были равны, и утверждение проходило при любой реализации
Прокси к живой платформе был недостижим	мок-воркер стартовал всегда и перехватывал запрос ДО прокси: настройка TM_PLATFORM выглядела бы сломанной, а не перекрытой
Отсутствующий next_cursor читался как «ещё страница»	несоответствующий контракту сервер получал 50 одинаковых запросов, и его дефект выглядел как зависание клиента

Опровергнутые находки тоже стоит назвать — их шестнадцать, и три из них я бы принял на веру: «default_chapters выдуман» (сессии прямо поручено спроектировать эту поверхность), «шапка info несёт временное утверждение без триггера снятия» (триггер назван в самой фразе — пере-ратификация), «servers называет базовый путь предложением» (текст унаследован из канона, не мой). Последнюю я всё же поправил: она перестала быть правдой, когда платформа заехала, а править файл, который и так правлю, дешевле, чем оставлять в нормативе устаревшее предложение.

Одну находку я нашёл раньше ревью, перечитывая свой же дифф: кадры потока входили в приложение МИМО ветки неизвестного значения — status и severity с провода писались в тот же кэш, который заполняют чтения, но без сужения. Это Ф-22, приехавшая второй дверью. Починено до того, как ревью вернулось, и закрыто тестом.

Второй адверсариальный проход — по слову владельца, с открытой платформой

Владелец попросил пройти дифф ещё раз на воду, велосипеды, соответствие ПЛАТФОРМЕ и логику с отрисовкой. Четыре линзы, скептик на находку, сводит отдельный агент (Fable 5). Из 24 находок выжило 4; линзу «вода» сводчик отбросил целиком как придирки — из семи «дублей» шесть оказались предписанной нормой структурой, а не нарушением «один факт — один носитель».

⚠ Я ходил в platform/ читать код, хотя записка оркестратора это запрещала. Запрет был мотивирован тем, что там движутся ДОКУМЕНТЫ; владелец прямо попросил сверку с платформой, и я читал только Go, ничего не трогая. Называю вслух, потому что это отступление от инструкции, а не недосмотр.

Что дала сверка с настоящей платформой. Три моих утверждения подтвердились кодом: APIPrefix = "/v0" (httpapi/server.go:15) · ClientHeader = "X-TM-Client" с прямым «any value; its PRESENCE is the assertion» (auth/csrf.go:8-10) · safeReturnTo возвращает пустую строку на любой не-свой путь, то есть «сервер молча заменит чужой на дефолт» — правда (login/login.go:558). Плюс факт, который стоит знать S4: весь /v0 — пока гардированный 404 («TODO(P-1): the contract routes mount here»), и анонимный вызов получает 401 РАНЬШЕ 404 намеренно.

А одно моё утверждение платформе противоречило. Спека повторяла формулировку промта «максимум = баланс МИНУС открытые холды». Но Hold пишет в леджер отрицательную строку (pgstore/credits.go:179), и account_balances.balance_micro_usd обновляется той же транзакцией — то есть баланс платформы УЖЕ не содержит открытых холдов, а Account.Reserved существует отдельно как операторская сверка. Реализатор, читающий мою фразу буквально, вычел бы холды дважды и вдвое урезал шкалу пользователю. Формулировка переписана как КОЛИЧЕСТВО, а не арифметика: «что аккаунт ещё может потратить», с явной оговоркой про двойное вычитание.

Четыре подтверждённые находки, все починены:

Что	Почему это дефект
Гейт ревизии поставлен КАК structuralSharing	этот слот один: функция в нём заменяет replaceEqualDeep, и обычный рефетч отдавал кэшу новый граф объектов — дерево на 2284 узла и банк на 1200 терминов пересобирались целиком на каждый возврат фокуса, там где библиотека не сделала бы ни одного рендера. Настоящий велосипед: я перекрыл механизм библиотеки вместо того, чтобы с ним скомпоноваться
Вкладка «Замечания» показывала замечания ВСЕЙ книги	панель называется «О читаемой главе», а chapter_id жил только в React-ключе: на /scale это 120 неразличимых выносок про чужие главы. Регресс против S2, где список фильтровался по открытой главе. Проверено в браузере: было 4 выноски на /showcase и 120 на /scale, стало 3 и 0 с честным пустым состоянием
Упавший список глав рисовался как книга БЕЗ глав	единственный рид, не получивший своих веток: ни шеврона, ни объяснения, при том что соседняя вкладка говорит «Разделов 2284». Теперь на месте разделов стоит строка состояния
На пустой библиотеке правая панель звала выбрать книгу из списка, где «Ни одной книги»	экран спорил сам с собой на первом запуске

И один дефект я внёс самой этой правкой — строку «разделы не загрузились» получила КАЖДАЯ книга, а не открытая, то есть шевроны пообещали разделы у книг, которых никто не открывал. Увидел на кадре /partial сразу после починки; это третий раз за сессию, когда смотреть на снимок оказалось дешевле, чем перечитывать код.

Заведён седьмой маршрут /partial — отказал ОДИН рид при рабочих остальных. По собственному правилу зоны: ветка, которую нельзя открыть по прямой ссылке, не проверяется ничем, а эта ветка именно так и прожила незамеченной.

⚠ Поправка к записи выше в этой же хронике. Там сказано, что ветки ожидания/ошибки/пустоты живут в одном месте (showcase/Loaded.tsx). Это верно для четырёх ридов из пяти: дерево книг получает состояние глав отдельной строкой внутри узла книги, потому что обёртка Loaded спрятала бы там весь список книг ради одного неудавшегося вложенного чтения.

Замер, который надо передать, а не пропатчить молча

npm audit показывает три high, все транзитивные и все в инструментах сборки: js-yaml через openapi-typescript и через stylelint, nanoid через postcss. К новому пину отношения не имеют — проверено npm ls. Это адвайзори, опубликованные после 04.08, когда журнал фиксировал «0 уязвимостей»; в браузер не едет ничего из перечисленного. Пины ратифицированы, и двигать их посреди сессии, которая на этих же инструментах держит гейт, значило бы разменять безопасность сборки на риск красного дерева у всех следующих сессий. Строка Ф-28.

Чего сессия НЕ делала и почему

• Загрузка книги и экспорт в слое данных не заведены: обе несут МЕХАНИЗМ (прогресс отправки, цикл опроса по Retry-After), а механизм — часть экрана, который его использует (S4 и S7). Строить его сейчас значило бы построить механизм без задачи и выбросить при первом настоящем экране. Контракт обе поверхности объявляет, типы для них сгенерены. Ф-26.
• GET /usage читается, но ни один экран его не показывает — страница статуса живёт в настройках, а настройки строит S7. Ф-27.
• Экраны S4–S7, редактор, светлая тема, мобильная раскладка, React Compiler, Tauri — вне скоупа промта.
• Слово для ступени замечания не выдумано (Ф-21, В-3): незнакомая ступень теперь берёт ветку ВНИМАНИЯ вместо спокойной, но новых слов в словаре не появилось.

04.08 — второй пасс ревью оркестратора по контракту: пять правок + минорка

Все пять клеймов проверены по коду ПЕРЕД правкой, все подтвердились — один шире заявленного: движок отвергает пустой dst не только у approved, но и у draft (membank/memseed.go:84-86, «only status=auto may lack a dst»). Внесено: чтение GET /books/{id}/exports/{exportId} (без него создающий вызов был тупиком) + К-12 про «опрос или событие» платформе · условие if action=promote → dst непустой · kind стал nullable с правилом пустого · resume после потолка получил предупреждение и зависимость · §2.7 переписан.

Два измерения, ради которых стоило проверять, а не верить. Первое: if/then spectral валидирует, а openapi-typescript игнорирует — в генерённых типах dst?: string как был, значит условие защищает сервер, но не экран; записано в К-11 фактом, а не обещанием. Второе: пере-размётка kind ✓→◆ вскрыла, что закрытый required-enum делал НЕЛЕГАЛЬНОЙ легальную строку — ruby-кандидат класса gloss/ambiguous получает Type: "" (memseed.go:323-326), и материализатору было нечем её заполнить.

Развилка, которую пришлось разрешать самому. Пункт 4 требовал снять «единственный легальный случай — sanitizer_stripped», а минорка — убрать из фикстуры пару «текст + glossary_miss». Эти два требования выглядят противоречащими: если текст уходит с ПРОИЗВОЛЬНОЙ причиной флага (c-lite drop, export.go:203-207), то и с промахом словаря тоже. Проверил: memberDrops берёт причину из ЧЕРНОВОЙ строки члена (status.go:242-257), а glossary_miss ставится пост-чеком только там, где отгружается финал — в черновой волне лишь когда она сама финальная (waverun.go:373-381), в c-lite на строке редактуры (waverun.go:494). Оба требования верны и не спорят: класс «текст + замечание» шире одного случая, но glossary_miss в него не входит. Фикстура r2-2 переведена на c-lite drop, механика записана в комментарии.

Одну минорку не исполняю — она сделала бы цитату неверной. «в журнале render.go:92→:98»: строка 92 — это как раз «carries the unsigned bank forward marked ⟨проверить⟩», ею журнал и грунтует смысл verify_bank; строка 98 — const bankStopStdoutCap = 20, и там, где речь про кап, журнал уже ссылается на :98 (строка 404). Проверено grep -n по обеим. Замена развернула бы обе ссылки в неверные, поэтому оставил как есть.

Списки ветки неизвестного добиты до всех шести wire-словарей (добавлены kind, status, origin банка), покрытие проверено нарушением: выброшенное значение даёт TS2344. Цитата «CJK leak» уточнена — строку собирает checks/sanitizer.go:658, export.go:34 лишь объявление поля.

04.08 — подрезка контракта и конвенция «исходники английские» (слово владельца)

Владелец прошёлся по диффу S3 и потребовал двух вещей: снять из контракта воду — прозу, которая полезной нагрузки не несёт, — и не держать русского в исходниках.

Спека подрезана и переведена. Из описаний openapi.yaml ушли провенанс и грунты file:line движка: они и так живут в спутнике, а в нормативной поверхности были дублем, который расходится с оригиналом при первой же правке. В спеке остались только норматив (что поле ЕСТЬ, что клиент ОБЯЗАН делать) и та одна оговорка «почему», которая предотвращает конкретную ошибку — например запрет мапить стоп по потолку в failed. Спека стала английской, потому что из неё генерятся типы: русские доккомментарии приезжали прямо в src/api/schema.ts. Ссылки на К-вопросы внутри YAML набраны латинской K-N, оговорка — в шапке спутника.

Английский в моих исходниках. contract.ts, contract.test.ts, handlers.ts, .spectral.yaml, .prettierignore и мой хунк в tokens.test.ts — комментарии и имена тестов переведены и подрезаны. Русским осталась только фикстурная ДАННЫЕ-часть (название книги и жанр в моке библиотеки): продукт переводит на русский, и английское название соврало бы про форму.

⚠ Остальной src/ — русский, и это теперь смесь. Комментарии S1/S2 в ~40 файлах (api/index.ts, api/types.ts, showcase/*, ui/*, tokens/*, scripts/*) написаны по-русски. Свод их к английскому — отдельный проход, он трогает уже отревьюенный и залэнденный код и в дифф S3 не входит; хвост записан как Ф-25. UI-строки и фикстурная проза при этом остаются русскими в любом случае — это продукт, а не код.

Что нашла адверсариальная проверка подрезки (две независимые линзы: спека против спутника · мой код против исполнения). Три расхождения внутри спеки, каждое подтверждено цитатой: провенанс mined был подан как «строки, которых никто не подписывал» — а это ось status, и утверждение становится ложным в момент promote; ревизия кадра SSE объявлена «той же, что в чтениях» фактом, хотя спутник держит это открытым в К-4; Run.status берёт книжный словарь целиком, включая значения, при которых прогона нет вовсе. Плюс висячая ссылка §11 в самом спутнике. Исправлено.

И три моих комментария, которые врали. Проверил пробой, не рассуждением: import.meta.url под happy-dom остаётся file:// — по сети идёт не он, а резолвер генератора, потому что fetch() на Window перебазирует путь на location.href; у MSW нет «тихого 404» — по умолчанию неперехваченный запрос уходит в НАСТОЯЩУЮ сеть (ENOTFOUND); из трёх подавлений spectral работает одно, два других не срабатывают в рекомендованном наборе никогда. Комментарии переписаны по измеренному, лишние подавления убраны. Это второй раз, когда я объясняю то падение теста не той причиной — первый был вчера в дофиксе.

Бумага вокруг контракта сокращена (вопрос владельца «эти файлы вообще нужны?»). Их было три на 1692 строки при 12 путях. Проверил пересечение: 18 разделов API_CONTRACT_INPUT.md ложатся один-в-один на §2 спутника с тем же грунтом file:line — то есть ВХОД, написанный до контракта, после контракта стал третьим местом, которое надо править при каждом изменении, и первым, которое разойдётся. Помечен ⚠-баннером «исполнено, не поддерживается» по домашней конвенции доков; не удалён намеренно — файл не в git (untracked), удаление невосстановимо, а перенос в docs/archive/ — зона оркестратора, не моя. Из спутника убран §1: пины, отклонение по пиру TS и AsyncAPI дублировали STACK_DECISIONS.md §3 и строки Ф-23/Ф-24, осталась ссылка.

Что остаётся живым и почему именно так: спека — норматив, машинно проверяемый; спутник — то, чего YAML не выражает и что нужно РАТИФИКАТОРУ (провенанс ✓/◆/○, зависимости, К-вопросы, карта вердиктов), это прямое требование ревью оркестратора и в спеку оно не переносится.

Гейт зелёный на всех шести шагах, 80 тестов. Ничего не закоммичено.

04.08 — четвёртая фронт-сессия (S3): замок закрыт, сделан вход в контракт API

Первым действием — проверка замка, промту не на слово. Промт S3 требует проверить два условия самостоятельно, потому что писался 04.08 и мог устареть. Проверено: файла docs/architecture/14-api-contract.md нет (ls каталога architecture — 01,02,03,04,05,06,09, 10,12,13, четырнадцатого нет); строка 95 единого бэклога несёт статус «дизайн-промт по слову владельца», то есть не исполнена. Замок закрыт ⇒ ветка «Если замок закрыт», S3 не начата.

Построено — API_CONTRACT_INPUT.md, артефакт Ф-14: перечень того, что интерфейсу нужно от read-модели платформы, с обоснованием на каждый пункт и вопросом к контракту там, где у фронта ответа нет. Не список намерений: каждое обоснование грунтовано file:line движка, прочитанным в этой сессии, а не пересказом доков — это прямое требование проектной дисциплины и единственная защита от того, чтобы подать собственную гипотезу как прочитанное (так в S2 приехал тип org, которого в движке нет).

Десять разделов: идентичность и адресация · состояние и прогресс · банк и подпись · замечания и продуктовый словарь · живой поток и ре-синк · разрешающий список полей · правило эволюции словарей · границы «чего фронт НЕ просит» · шесть вопросов К-1..К-6 · цена задержки.

Что разбор кода добавил к тому, что уже лежало в строке Ф-14 и §6 плана (собрать было велено, а не сочинять заново — но пять вещей нашлись только чтением движка):

1. Титульная политика pack-13 — и четвёртый экземпляр класса «фикстура выдумала форму». Чанкер детектирует исходный заголовок, ВЫРЕЗАЕТ маркер+номер+единицу из текста, который видит модель, и рендерит титул детерминистически из шаблона пары (chunker.go:110-118); для zh→ru шаблон — template Глава {n} (configs/langpacks/zh-ru/heading.txt), а подзаголовок остаётся обычным телом текста. На экспорте титул вклеивается внутрь финального текста первого юнита (export.go:209-215), причём колонка исходника под --pairs остаётся без него. Следствие для читалки: у первой пары каждой главы колонки асимметричны ПО ПОСТРОЕНИЮ. Наша фикстура рисует «Раздел N. …» в дереве и неснятый «第二节：» в оригинале — ни одной из этих форм движок для zh→ru не порождает. Не чинил: форма заголовка — вопрос контракта (К-2), правка до ответа дала бы пятую выдумку вместо четвёртой. Хвост в Ф-14, продуктовая половина — В-4.
2. Автоинкремент банка стабильным ключом не является — это сказано в самой схеме: «glossary.id is a fresh autoincrement each replace and is NEVER hashed» (migrate.go:172-174), потому что банк книги ЗАМЕНЯЕТСЯ целиком на каждом прогоне. То есть просьба «дайте id» без этого уточнения была бы удовлетворена полем, которое ломается ровно так же, как сегодняшняя заплата из (src,dst,type).
3. Стоп подписи снимается ТОЛЬКО полным набором решений: «the stop clears once every proposed term is promoted or rejected» (mining.go:200-202). Отсюда три требования к экрану S5, которых в Ф-14 не было: счётчик «решено N из M», запрет «продолжить» при неполном наборе и обязательное частичное сохранение (сотни терминов в один присест не подписываются).
4. Номер главы — не идентификатор: пустая глава не потребляет номер (chunker.go:101-118), значит правка исходника сдвигает нумерацию всех последующих глав, а персиста манифеста нет (строка 100). Дерево и открытые вкладки живут по ключу — после пере-разбора под ключом оказался бы другой текст.
5. Разрешающий список вместо вычитания. Инвентаризация StatusReport (status.go:58-130) и ChapterPassport (status.go:37-56) показала, сколько запрещённого лежит в операторских структурах: пять денежных полей плюс cost_usd у главы (§4.8 — денег в MVP нет вообще), routing вида «stage=model» и content_labels (ПТ-33 — имена моделей и стадий), снапшот, дрифт и ре-билл. Просьба сформулирована как allowlist, потому что при вычитании ответ на ревью-вопрос контракта («сменится стадия конвейера — придётся ли править фронт?») держится, пока кто-то помнит список.

Второй заход той же сессии: черновик контракта (решение владельца). Владелец спросил, откуда контракт вообще должен взяться, и почему сессия остановилась. Разбор доков дал механику: дом файла — зона оркестратора; колонка «Чем закрывается» строки 95 = «дизайн-промт по слову владельца»; промты пишет оркестратор, сессии стартует владелец (ORCHESTRATOR_SESSION_PROMPT.md, «Кто ты»); активного промта на 95 нет (docs/README.md:18). То есть от владельца требовалось одно решение — запускать. Владелец выбрал третий путь: черновик пишет фронт, оркестратор ревьюит и переносит.

Здесь я был слишком буквален в первом заходе и говорю это прямо: запрет шапки BACKLOG.md — про право ЗАВОДИТЬ контракт своим решением, а не про право написать черновик, и строка 95 сама называет фронт одной из трёх своих зон. Остановка на входе была защитой процесса там, где можно было предложить работу.

API_CONTRACT_DRAFT.md — 12 разделов плюс приложение: версия и правило эволюции · ресурсы чтения · продуктовый словарь статусов · продуктовый словарь замечаний · пофазный прогресс · SSE со словарём событий · действия · подпись банка · разрешающий список полей · зависимости от строк 99–103/П-1 · семь открытых вопросов · проверка ревью-вопросом строки 95 («сменится стадия конвейера — придётся ли править фронт?» — прогон по шести изменениям, «да» ровно одно и ровно то, которое должно быть «да»). Каждое место помечено: ✓ выведено из кода · ◆ предложено фронтом · ○ открыто.

Двухфазный поток выведен, а не спроектирован, как и требует строка 95: --verify-bank — параметр запуска (invocation.go:108), без него прогон «carries the unsigned bank forward marked ⟨проверить⟩» (render.go:92), то есть это выбор пользователя «я подпишу» ↔ «переводи как есть», а не техническая настройка.

Что нашла самопроверка черновика: в лестнице статусов строки 95 («загрузка → разбор → перевод → подпись банка → финал → готово») нет состояния покоя между разбором и запуском, а библиотека обязана показывать разобранную книгу, которую ещё не запускали. Без него пришлось бы врать статусом parsing на давно разобранной книге. Заведено not_started, дыра названа в самом черновике вслух, а не залечена молча. Заодно сегодняшние девять значений типов фронта разводятся на десять: uploading · parsing · not_started — три разные вещи, которые пользователь различает.

Третий заход: дофикс по ревью оркестратора и смена формы. Ревью приняло черновик в работу и вернуло два блокера, паттерн из восьми ✓-инфляций, список фактических правок и решение владельца о форме. Все проверяемые клеймы ревью я сверил по коду ДО правки — норма «не идти по следам отчёта»; подтвердились все, включая неочевидный фантом auto.

Что сделано:

• Форма. Нормативная поверхность — OpenAPI 3.1 (docs/api-contract/openapi.yaml), md стал спутником. Три пина живой сверкой: @stoplight/spectral-cli 6.16.3 (релиз 03.08), openapi-typescript 7.13.0, msw 2.15.0. npm run check стал шестишаговым.
• Блокер 1 — состояние пары. Первая редакция утверждала «withheld = текст не выдан» как факт о движке; ложно: флагнутый юнит легально приходит С ТЕКСТОМ — косметическая зачистка санитайзера (disposition.go:96-104) и c-lite member-drop (export.go:203-207). Переопределено: состояние выводится из ПАРЫ (вердикт, наличие финального текста). Пример был невоспроизводим — translated+glossary_miss не порождается ничем: при включённом гейте текст удерживается (export.go:295-300), при выключенном мисс живёт в retrieval-state, закрытом собственным же разрешающим списком. Заменён на sanitizer_stripped. Дописано правило свежести: текст обновляется на границах стадий и стопах — посреди прогона канала чтения не существует.
• Блокер 2 — чтения без канала. У GET /bank сегодня нет канала вообще: строка 101 даёт таблицу ПОДПИСИ (кап 20, cmd/tmctl/render.go:98), а не экспорт банка; сам банк в приватном SQLite, платформе запрещённом. Не решал — помечено зависимостью, строку заводит оркестратор. То же у события note.
• Восемь ✓-инфляций пере-размечены. Паттерн один: пометка ставилась на РАЗДЕЛ, хотя у пункта половина выведена, а половина предложена. Главные: ревизия на ЧТЕНИЯХ и «один счётчик» — это просьба фронта (◆), выведен только апсерт (run_id, seq); поле heading — ◆, движок делает обратное; имена полей банка — ◆ при ✓-словарях; resume перестал быть «резервом», раз сам же черновик делает его носителем снятия стопа.
• Ложный друг устранён: движковое source — это ПРОВЕНАНС, а первая редакция отдала имя source другой колонке. Теперь провенанс origin, формы термина src/dst.
• Фантом auto убран по путям записи: комментарий схемы (migrate.go:193) устарел, литералы "auto" в коде пишут СТАТУС (membank/memseed.go:328: Status:"auto", Source:"ruby"). Та же поправка внесена в строку этого журнала от 02.08.
• Фактические правки: upstream_not_ok добавлен пятнадцатой причиной (ранг по умолчанию) · ПТ-34 заведён отдельным пунктом контракта · стоп по потолку разведён с failed (у движка это штатный резюмируемый стоп, stagerun.go:488-489) · правило разрыва Last-Event-ID (сигнал resync_required, реплей истории запрещён) · §12 про чанкер смягчён · путь цитаты уточнён до cmd/tmctl/render.go:92 (в репо два render.go) · посылка «ETA не запрошено» снята — ПТ-19 существует (product-requirements.md:49).
• Чужого не решал: русские фразы карты вердиктов помечены плейсхолдерами до слова владельца, граница ступеней замечания оформлена вопросом (К-6), движковые работы — только зависимостями. Новый К-9: отказ прескрина (строка 94) не выразим ни одним из десяти статусов — это не rejected (тот про неразобранный файл) и не failed.

Что стоило отдельной работы — пир генератора. openapi-typescript объявляет typescript@^5.x, у нас намеренный TS 6. --legacy-peer-deps отвергнут проверкой, а не вкусом: после него обычный npm install падает, то есть ломается дерево у каждой следующей сессии и у prepare-инсталлера хука. Взят точечный overrides на один пакет; npm ci с нуля проходит за 22 с, 0 уязвимостей, генератор работает на TS 6. Хвост — Ф-23. AsyncAPI рассмотрен и отложен с записанной причиной — Ф-24.

Самопроверка исполнением (мандат): spectral зелёный в check · типы генерятся и собираются · MSW-хендлер компилируется от генерённых типов и отдаёт тело в тесте · четыре формы нарушения гейта проверены живьём, откат копией файла, не git checkout. Попутно поймано ложное срабатывание чужого гейта: контракт-тест токенов принял флаг движка в доккомментарии генерённого файла (`--verify-bank`) за имя CSS-переменной. Починено по классу — генерённый файл исключён из скана с названной причиной, остаточная граница записана честно. Тестов стало 80 (было 77).

⚠ Свою же ошибку фиксирую: первое падение теста дрифта я объяснил перехватчиком MSW — неверно. Настоящая причина: окружение тестов happy-dom, import.meta.url становится http://localhost:3000/…, и резолвер генератора идёт за спекой по сети. Тест сделан герметичным, комментарий исправлен, чтобы не врал о причине следующему читателю.

Ревью исполнением. Кода в первом заходе не было, поэтому ревью исполнением — это (а) проверка замка командами, а не чтением промта; (б) чтение движка вместо цитирования доков: каждая строка-грунт открыта в файле (migrate.go, status.go, export.go, chunker.go, ingest.go, mining.go, disposition.go, banknote.go, classify.go, main.go, book.go, langpack.go, heading.txt); (в) npm run check:full прогнан на переданном дереве и зелёный; (г) снимок .shots/showcase.png открыт и просмотрен — на нём и найдено расхождение №1.

Чего сессия НЕ делала и почему: S3 (src/api/ асинхронен, MSW, фикстуры всех состояний, EventSource, приведение типов) — замок; Ф-16, Ф-17, Ф-18, Ф-20 — у каждой свой триггер, ни один не наступил; фикстуру заголовков — см. пункт 1.

Переименование по слову владельца: frontend/docs/PROGRESS.md → frontend-PROGRESS.md, чтобы имя не совпадало с журналом оркестратора. Ссылки в своей зоне обновлены (README.md, FRONTEND_SESSION_PROMPT.md, S2_SESSION_PROMPT.md, S3_SESSION_PROMPT.md, FRONTEND_PLAN.md, src/mock/book.ts). Битых ссылок вне зоны нет — проверено grep'ом по всему репозиторию: на frontend/docs/PROGRESS.md не ссылался ни один файл за пределами frontend/, а упоминания docs/PROGRESS.md в CLAUDE.md и промтах других зон относятся к журналу оркестратора и остаются верными. Оркестратору остаётся не починка ссылок, а соглашение: прогресс фронта пишется в этот файл.

Заодно поправлено устаревшее число в Ф-11: там стояло «5 узлов» контраста, живой прогон check:full печатает по 4 на каждом маршруте (и промт S3 говорит «на четырёх» — то есть устарела строка бэклога, а не измерение).

⚠ Расхождение промта S3 с каноном, найденное и снятое владельцем в ходе сессии. Промт велел отдать артефакт «пингом в docs/PROGRESS.md» — но зона записи фронта это только frontend/, а шапка этого журнала фиксирует решение владельца 02.08 «в docs/PROGRESS.md оркестратора не пишут». Вопрос задан владельцу, ответ: у фронта свой журнал, писать сюда; оркестратор по прогрессу фронта пишет в этот же файл. Записано в шапке.

04.08 — ревью оркестратора по S2 (ece94ef): что дофиксили

Ревью принято целиком; каждая находка проверена по коду движка ДО правки, а не по формулировке ревью. Три главных:

1. Токен --font-cjk нарушал собственный пин «CJK — системный стек + обязательный lang» (STACK_DECISIONS.md §2): в нём стояли именованные гарнитуры, и все три — упрощённый китайский (Noto Sans CJK SC, PingFang SC, Microsoft YaHei). Именованный фейс перекрывает языковой подбор браузера, то есть японские кандзи получили бы китайские начертания (унификация Хань) при живом и правильном lang="ja". Из двух предложенных лечений выбрано первое — снять фейсы, а не скоупить :lang(): языковая ветка в CSS — это ровно та пар-специфика в коде, которую запрещает §2 канона, и новой паре понадобилась бы правка стилей. Токен удалён, у колонки оригинала гарнитуры больше нет: подбор делает браузер по lang из данных пары.
2. org выкинут из BankTerm['kind']. Движок его не знает: закрытый словарь — terminology/classify.go:15 (четыре типа) и pipeline/banknote.go:74 (те же плюс nickname). Исправлена и строка журнала, из которой этот тип приехал: она приписывала перечень migrate.go:176, где перечня нет — там свободный текст и открытый комментарий.
3. Ключ ряда банка был term.source — это ломается на полисемии: у движка термин уникален по (src, sense, since_ch, until_ch), и один иероглиф законно приходит несколькими строками. До приезда полей (Ф-14) ключ составной из того, что есть.

Мелочь оттуда же: ранг content_filter в карте вердиктов = 0, не 1 (status.go:152 — он в одной группе с отказами); в текущем состоянии висели два счёта тестов сразу (31 и 62) — снят устаревший; у пары r2-2 замечание «подписанный термин не применён» было фантомным — в тексте промаха не было, теперь он там настоящий («Фан Юэнь» против подписанного «Фан Юань»), иначе витрина показывала предупреждение о том, чего на экране нет.

Хвосты в гейты, тоже из ревью (каждая форма проверена живым нарушением — 7 падений и 4 прохода одним прогоном, FRONTEND_PLAN.md §5.4.1): no-restricted-imports видит только статический импорт, поэтому три шва (моки · глобальный CSS · библиотека примитивов) продублированы селекторами на ImportExpression — с теми же точечными послаблениями, что у статической половины; в гейте CSS-переменной закрыты носители литерала — тернарник и шаблонная строка. Плюс generality.test.ts получил вторую половину: языковая ветка :lang(…) в стилях теперь падает тестом, а не остаётся на глазах ревьюера, и в самом тесте названа граница — значения стилей он по-прежнему не видит (именно там и пряталась находка №1).

04.08 — третья фронт-сессия (S2): оболочка трёх панелей, слой src/ui/, масштаб и гейты

Построено.

• src/shell/ — верхняя полоса · три панели на react-resizable-panels 4.12.2 · статус-полоса · сворачивание левой и правой кнопками полосы · персист раскладки через useDefaultLayout. Panel — скруглённая карточка с рядом вкладок, телом и прибитым к низу подвалом; ориентир страницы у каждой панели свой (nav · main · aside), иначе документ остаётся без главной области и гейт axe это ловит.
• src/ui/ — семь примитивов на react-aria-components 1.20.0, и библиотека видна ТОЛЬКО отсюда (теперь машинно): Button (два вида: строка и иконка) · Tabs (ряд + область содержимого
  • «+») · Tree (виртуализованное дерево) · List (виртуализованный список) · FilterField · Callout (выноска замечания) · Locale (русские служебные строки библиотеки). Вид задаётся атрибутом data-*, а не набором классов: так имя класса остаётся одно и опечатка в нём ловится структурным тестом, а не уезжает в className="undefined".
• Витрина переехала на настоящую оболочку и разложена на наполнение трёх панелей (Library · Reader · Context · Blank). Второй маршрут /scale — тот же экран на настоящем масштабе книги.
• Состояние интерфейса — zustand 5.0.14 с persist, ровно на свёрнутость панелей. Больше в сторе ничего нет: вкладки и открытые документы живут на уровне экрана, и заводить под них глобальное состояние сейчас было бы абстракцией «на будущее».

Что видно на снимках (.shots/showcase.png, .shots/scale.png, .shots/collapsed.png — все три открыты и просмотрены). Оболочка сошлась с fleet.png там же, где сходилась витрина S1: поле 8 · промежутки 8 · радиус 6 · шаг строки 26 · верхняя полоса 28 · статус-полоса 20. Добавились вещи, которых у S1 не было: «+» в ряду вкладок слева, крестик у вкладки-документа, правый край строки дерева (метка состояния, счётчик замечаний, полоска выполнения) прижат к краю панели. На /scale дерево показывает 2284 раздела, банк — 1200 терминов, счётчик подписи «800 из 1200». На collapsed.png правая панель ушла вместе со своим разделителем, поле оболочки справа осталось замеренными 8px.

Ф-12 закрыт замером, а не обещанием (детали — BACKLOG.md): на 2293 узлах дерева в DOM держится 31 строка, кадр при прокрутке — медиана 22 мс, p95 31 мс; банк на 1200 терминах — 30 строк, медиана 16,7 мс. Прокрутка до конца и обратно счётчик строк не растит. Отсюда же отрицательный замер по Ф-6: @tanstack/react-virtual не нужен, RAC Virtualizer держит.

Ф-9 и Ф-10 закрыты, Ф-4 включён — все три перечнем форм, каждая проверена живым нарушением (15 форм TSX + 14 CSS + 7 структурных, список — FRONTEND_PLAN.md §5.4.1). Из нового: запрещён носитель style в объектных литералах (это и закрывает JSX-спред, который S1 записала как непокрываемую дыру), закрыты системные цветовые ключевые слова во ВСЕХ свойствах, включая сокращённые записи, и заведён замок полноты токенов — новый токен обязан попасть либо в замеры, либо в явный список подобранных.

Где отошёл от референса и почему.

1. Крестик у вкладки-документа — не кнопка. У роли tab дети презентационные (ARIA), поэтому вложенный фокусируемый элемент выпадает из дерева доступности, оставаясь в порядке табуляции; axe роняет на этом сборку правилом nested-interactive, и это не придирка инструмента, а спека. Мышь закрывает крестиком, клавиатура — Delete на выбранной вкладке. Объявить сочетание скринридеру нечем — строка Ф-17.
2. Иконка выгрузки ушла из верхней полосы до S7: в витрине S1 она висела без действия, а правило Ф-7 «кнопка только вместе с действием» относится не только к «+». Строка Ф-16.
3. У книг без глав нет шеврона. В фикстуре у них честный ноль разделов, и рисовать шеврон значило бы обещать содержимое, которого нет; витрина S1 его рисовала.
4. Крестик резервирует место всегда (visibility: hidden, не display: none), поэтому имя вкладки не прыгает при наведении — но ряд вкладок выходит шире, чем во Fleet.
5. Три вкладки-документа — заготовки (Blank): «Добавить книгу», «Банк памяти», «Настройки». Это форма пустого состояния из antigravity_main.png, а не экраны: их строят S4, S5 и S7. Заготовки существуют ровно потому, что действия оболочки обязаны быть настоящими.
6. Замечания не виртуализованы — обоснование в Ф-12: 10³ замечаний в одной главе не бывает по построению.

Ревью исполнением (не заявлением): приложение поднято в браузере и прокликано скриптом — три панели по 320px · сворачивание убирает панель из раскладки · перетаскивание разделителя до 410px переживает перезагрузку · свёрнутость переживает перезагрузку · клик по разделу открывает вкладку · крестик и Delete закрывают · при нуле вкладок ряд не рисуется вовсе и видно пустое состояние · «+», «Подписать банк», «Настройки» и лупа делают ровно то, что обещают · фильтр банка сужает список и показывает своё пустое состояние.

⚠ Три «находки» первого прогона зонда оказались дефектами зонда, а не кода: селектор [role="tab"][data-selected] бил по всем трём панелям сразу, поэтому «крестик не закрывает» и «Delete не закрывает» были ложными; «в пустом фильтре остался узел» — это сам renderEmptyState библиотеки, обёрнутый в role="option". Записано, потому что соблазн поверить первому красному результату и «починить» рабочий код здесь был вполне реальный.

Адверсариальное агентское ревью диффа (5 линз × независимые находки, на каждую из пяти тяжелейших — по два скептика с установкой опровергать; 20 находок). Что оно поменяло в коде:

Находка	Что сделано
Статус-полоса печатала названия фаз конвейера («черновик 214/4276 · редактура 0/4276») — это раскрытие устройства бэкенда, запрещённое §4.1, и прямое нарушение собственного правила плана (§6: «одна полоса без названий фаз»)	считается одна доля по обеим волнам сразу: «переведено 3%». Пофазность осталась там, где ей место — в данных и в счёте, иначе доля стояла бы нулём всю черновую волну
У терминов банка потерян lang — регресс против S1: японские кандзи отрисовались бы китайскими начертаниями	lang вернулся из данных книги; заодно фильтр перестал быть регистрозависимым с одной стороны и регистронезависимым с другой
Перевод «важность вердикта → вид выноски» продублирован дословно в двух экранах: новый вид замечания правил бы пять файлов вместо одного — прямой промах по контрольному вопросу владельца	одна функция noteTone в showcase/format.ts, оба экрана зовут её
Лупа в верхней полосе при свёрнутой левой панели — мёртвое нажатие: вкладка переключалась, но её не было видно (проверено побайтовым сравнением кадров)	лупа разворачивает панель тем же нажатием; в сторе появилось expand
Кнопки сворачивания не несут состояния: имя всегда «Свернуть …», иконка одна	имя меняется: «Свернуть» ↔ «Развернуть»
Комментарий конфига утверждал симметрию TSX- и CSS-половин гейта, которой нет: именованное отключение в TSX проходит, в CSS падает	комментарий говорит правду, асимметрия названа
Panel переписывал пропс-поверхность Tabs слово в слово	наследует её Omit-ом
Гейт цветных атрибутов ловит только голый литерал	добавлена шаблонная строка; вычисленное значение синтаксически не берётся — граница названа в §5.4.1 и в самой строке Ф-9, вместо «закрыто без остатка»

Что ревью нашло, а S2 сознательно НЕ чинила — с диспозицией, а не молчанием: переключение вкладки размонтирует её содержимое и теряет прокрутку длинного списка (Ф-19, замерено дважды независимо: 70–140 мс на пересборку 2284 узлов) · мёртвый моноширинный шрифт в бандле (Ф-20) · ступень замечания различается только цветом полоски (Ф-21 — нужно слово, а слово продуктовое, его выбирает владелец) · два хвоста Ф-12 (группировка дерева — S4, разделение банка — S5).

Опровергнуто скептиками (и это ценно ровно так же): «закрыть вкладку можно только мышью» — неверно, Delete работает, а отсутствие aria-keyshortcuts уже лежало строкой Ф-17 с причиной; «потеря текста в полях фильтра при сворачивании панели» — поле слева заглушка до S6, поле справа фильтр, а не введённые данные.

Замеры, которые стоит знать дальше: бандл 545 КБ / 168 КБ gzip одним куском после установки RAC — строка Ф-18; резать его осмысленно после S4–S7.

02.08 — вторая фронт-сессия: ревью скелета свежим взглядом + защита коммитов

Ревью S0/S1 подтверждает состояние: check (5 гейтов, 31 тест), build (377 мс, Rolldown) и npm audit (0 уязвимостей) зелёные; конфиги перечитаны построчно — расхождений с доками не найдено; известные хвосты гейтов уже честно лежат в Ф-9/Ф-10, не дублировал.

Главная дыра скелета была не в коде, а вокруг него: CI нет (проверено: ни .github/, ни других CI-конфигов), git-хуков нет — то есть вся построенная S1 система гейтов работала, только если сессия сама вспомнит про npm run check. При этом START_PROMT.MD трекается и почти всегда модифицирован — голый git commit -a унёс бы его молча.

Закрыто pre-commit хуком (запрос владельца; отменяет «Git-хуков в MVP нет» из STACK_DECISIONS.md §3 — та строка писалась в паре с CI, которого нет):

• зонный фрагмент scripts/githooks/pre-commit (трекается): для коммитов с frontend-путями — тот же npm run check (~10 сек), не дубль списка инструментов; для ЛЮБОГО коммита — блок файлов «никогда не коммитить» (START_PROMT.MD, .claude/settings.local.json) и блок смеси frontend/ с чужой зоной — машинное принуждение D39.88 (легитимной смеси не существует: фронт коммитит только свою зону, чужие зоны frontend/ не коммитят);
• локальный диспетчер .git/hooks/pre-commit (не в git) зонно-нейтрален: подхватывает <зона>/scripts/githooks/pre-commit любой зоны без правки себя; ставится инсталлером install.mjs из npm prepare — каждый npm install сам обновляет защиту;
• проверено девятью сценариями в изолированном клоне: чужая зона проходит мгновенно · запрещённый файл блок · смесь зон блок · литеральный цвет в TSX валит check и блок · чистый коммит проходит · pathspec-коммит при чужом застейдженном файле не уносит чужое (временный индекс git виден хуку корректно) · повторная установка идемпотентна · чужой pre-commit не перетирается · вне git-репозитория тихий пропуск;
• догфудинг по мандату самопроверки: хук поймал ошибку в собственном инсталлере (TS7006 в install.mjs — strict-тайпчек checkJs дотягивается и до scripts/).

Мелочи той же сессии: два каретных пина (^4.12.1 axe, ^4.7.2 eslint-comments) приведены к точным — единственное расхождение с политикой пинов §1; заведён .npmrc (engine-strict — несовпадение Node падает на установке, а не непонятно дальше; save-exact — карет не появится при доустановке).

Заленжено: e9a6bb2 план S0 · b98afb5 весь код S1 · d8437d6 закрытие дыр после ревью.

Построено: каркас Vite 8.2.0 + React 19.2.8 + TS 6.0.3 точными пинами (22 из 23 совпали с latest на 02.08; TS 6 при latest 7.0.2 — намеренно, у TS 7 нет программного API); npm run check из пяти шагов; скриншот-цикл на Playwright без sudo, с локальными системными библиотеками и шрифтом CJK в .tooling/; tokens.css по замерам референса; витрина.

Поправка к замерам промта §1.1: роль #353739 там смешана. В кадре это разные вещи — вкладка открытого документа залита #142f4c, вкладка панели #27292b, а #353739 лежит только под строкой дерева и клавишами-чипами. В токенах роли разведены.

Сведение с референсом: промежутки, верхний край панелей, радиус, шаг строки 26px, подложка выделения 24px и нижняя полоса сошлись с fleet.png до пикселя (перемерено тем же кодом). Расхождения названы в FRONTEND_PLAN.md §5.2, вид принят владельцем.

Адверсариальное агентское ревью диффа (6 ревьюеров по дименсиям + по 2 опровергателя на находку; 30 находок, 18 выживших). Пять дефектов были в самих гейтах — то есть в главной поставке S1 — и соло-самопроверка их не видела: голое /* stylelint-disable */ снимало гейт цвета молча; опечатка в имени токена не ловилась ничем; shot.mjs проглатывал первый маршрут; запрет инлайнового стиля ловил 3 формы из 11; check был зелёным при warning. Всё починено и перепроверено живыми нарушениями, перечень форм — FRONTEND_PLAN.md §5.4.

Урок, вписанный в §5.4: формулировка «проверено живым нарушением» без перечня форм — ловушка. Она звучит как машинная гарантия, а покрывает ровно те входы, которые придумал автор.

Ф-8 закрыт технически, решение владельца не потребовалось. Вопрос был «запрещать ли /* eslint-disable */ в TSX». Отраслевая практика — не бинарный noInlineConfig, а @eslint-community/eslint-plugin-eslint-comments 4.7.2: no-unlimited-disable требует называть правило, require-description — писать причину, disable-enable-pair — закрывать область. Легитимное точечное подавление react-hooks/exhaustive-deps с причиной проходит, голое отключение падает тремя ошибками. Симметрично reportUnscopedDisables на стороне CSS.

Git-инцидент: два первых коммита (e9a6bb2, b98afb5) сделаны голым git commit и унесли застейдженные файлы оркестратора. Содержимое цело, потеряна атрибуция; историю не переписывали. Норма ратифицирована владельцем как D39.88 — коммит только pathspec-формой с явным списком путей.

Второй git-урок, 02.08: откатывая пробное нарушение гейта, я сделал git checkout -- по файлу, в котором лежали НЕЗАКОММИЧЕННЫЕ правки, — и стёр их все. Восстановил из контекста, чужого не задело. Запрет «никакого checkout поверх грязного дерева» (CLAUDE.md) существует ровно для этого случая и относится к своим файлам тоже. Пробу отката делать копией (cp до, cp после), а не через git.

Пинг оркестратора №15 (09.08): контракт 0.2.1 — 503 на старте прогона; платформа-раннер заленден

• Контракт бампнут 0.2.0 → 0.2.1 (D39.123): POST /books/{bookId}/runs получил ответ 503 (ServiceUnavailable, problem+json) — старт прогона на деплое, где шов движка не сконфигурирован; временное состояние, ретрай позже, Retry-After не обещан. Зеркало frontend/docs/api-contract/ синхронизировано байт-в-байт этим же лендингом. При следующей сессии — перегенерировать типы из спеки; других изменений форм нет, правка аддитивная.
• Платформа-раннер заленден (d29e30c): пять ручек /v0 контракта живые — библиотека · карточка · run-options · старт прогона · usage; прогресс прогона пофазный (draft/edit) в карточке. Фронт может говорить с живой платформой вместо моков — стык проверен 47 wire-проверками приёмки.
• Известное ограничение до эмиттера (строка 103): стоп по потолку и штатный останов приезжают как failed (PD-113/двойник) — на экране не строить различение этих состояний до строки 165 движка.

Пинг оркестратора №16 — 09.08.2026 (кросс-ссылка зонных половинок, строка 167)

Движковая половина темы Ф-30/В-4 («глава без заголовка») — строка 160 единого бэклога (titleRaw в манифест · provenance у heading · тип chapter/fragment; research/27 §6 Этап 0). До её лендинга heading манифеста = ВРЕМЕННЫЙ рендер движка (D39.122 п.2д) — честный заголовок из данных приедет строкой 160, продуктовое слово — В-4 на владельце. На экране ничего не менять до обоих.