diff --git a/frontend/docs/archive/frontend-PROGRESS-S0-S4.md b/frontend/docs/archive/frontend-PROGRESS-S0-S4.md
new file mode 100644
index 00000000..ed674407
--- /dev/null
+++ b/frontend/docs/archive/frontend-PROGRESS-S0-S4.md
@@ -0,0 +1,1975 @@
+# Архив хроники зоны «Фронт» — записи сессий S0–S4 и приёмок до 15.08.2026
+
+> **⚠ АРХИВ (вынесено оркестратором №17 16.08, слово владельца: журналы забивали контекст сессиям).**
+> Все паки здесь ИСПОЛНЕНЫ и ПРИНЯТЫ (S2–S4 — D39.115/123/127/129/135). Живой журнал держит: текущее
+> состояние · решения владельца · запись приёмки S4 с фикс-листом ФС (вход S5) · пинги. Инструкции
+> отсюда не исполнять.
+
+### 14.08 — девятая фронт-сессия (S4): загрузка книги, запуск прогона, библиотека на масштабе, контракт 0.2.3
+
+Вход: промт `S4_SESSION_PROMPT.md` (семь задач). Дом прежний — мир моков по контракту; живого стенда
+платформы не поднимала (§10 промта — опция, не гейт), и это отдельной строкой в «чего НЕ сделала».
+
+#### 1. Контракт 0.2.3 — пять правок в зонной копии
+
+`info.version` 0.2.2 → **0.2.3**, `npm run contract` (spectral, порог warn) зелёный, типы
+перегенерены (`npm run contract:types`), тест дрейфа держит равенство спеки и `schema.ts`.
+
+| Правка | Что записано | Чем грунтовано |
+|---|---|---|
+| **PD-172** | у `createBook` — часть `file` идёт ПОСЛЕДНЕЙ, поле после файла = 400; причина одной строкой (платформа читает форму потоково и обязана увидеть языки до тела) | `platform/internal/httpapi/v0.go:311-378` — потоковый `MultipartReader`, ветка «языки пусты на приходе файла → 400» |
+| **PD-173** | новая схема `RejectReason` (`source_unreadable` · `not_configured` · `parser_unavailable`) и **необязательное** `Book.reject_reason` | `platform/internal/books/parse.go:51-66` — те же три имени + четвёртое `storage_unavailable`, которое на книге не хранится вовсе |
+| **PD-174** | названы классы, которые провод уже даёт: **404** на `POST /books` у инстанса без интейка, **503** у `resume` на деплое без маркер-команды/шаблона потолка | 404 — `v0.go:72-77` (маршрут не монтируется при `Intake == nil`); 503 — `reconcile.go:715-722` зовёт `s.runnable()`, а `v0.go:540-547` мапит его ошибки в 503 общей для старта и resume функцией `fail` |
+| **PD-180** | описание `createBook` честное: **201 несёт `parsing`**, `uploading` наблюдаем только параллельным чтением библиотеки; перечень отказов — 400 (>16 частей, поле >1 КиБ, поле после файла, нет файла), 404, 408, 413 (числа порогов в спеку не зашиты — они принадлежат деплою) | `books.go:110-180`: строка книги пишется ДО тела (оттого `uploading` виден вторым чтением), а ответ формируется после `StartParsing`, то есть уже в `parsing`; пороги — `v0.go:296-302`, 408 — `v0.go:410-417` |
+| **`BookIntake.title`** | необязательное поле: пусто/нет = «название даст разбор» (сегодня платформа берёт имя файла), заполнено = задано рукой и разбор не перепишет | `books.go:136` `titleFrom(in.Filename)`; ратификация — оркестратор 14.08 (исполнение замечания 12 S3.5) |
+
+**Расхождение с промтом, названное вслух (код первичен).** Промт описывает enum PD-173 как
+«словарь платформы из трёх значений». Проверка по коду: значений в словаре платформы **четыре**, а
+на книгу сегодня попадают **два**. `storage_unavailable` не хранится никогда (комментарий
+`parse.go:62-65`), `not_configured` в `books.reject_reason` не доходит тоже — `defer_` для него
+никогда не терминален (`parse.go:180-205`, `waitsForTheDeployment`), книга остаётся в `parsing` и
+ждёт человека. В спеку внесены все три имени промта: enum — это словарь ВЕРСИИ, клиент обязан
+терпеть незнакомое значение, а `not_configured` — состояние, которое платформа уже умеет назвать и
+которое станет терминальным ровно в тот день, когда владелец контракта решит, что упавшая на
+деплой книга должна умирать, а не ждать. Фраза для него написана, и это цена, которую я назвала:
+одна из трёх фраз сегодня недостижима на живой платформе.
+
+**`reject_reason` сделан необязательным, а не required+nullable, как `Run.paused_reason`.** Причина
+записана в самой спеке: причина отказа осмысленна ровно в одном состоянии из одиннадцати, а деплой
+старше этого минора не пришлёт её вовсе — значит «поля нет» и «поле `null`» означают ОДНО И ТО ЖЕ
+(«причина неизвестна») и рисуются одинаково. Это противоположность случая `sense` (0.2.2), где две
+формы несли РАЗНЫЕ факты; прецедент внутри той же спеки — `Usage.paused_reason`.
+
+#### 2. Загрузка книги (Ф-26, половина) — механизм и почему он такой
+
+- **XHR, а не `fetch`, и это не вкус.** Стандарт Fetch отдаёт прогресс ОТВЕТА и не имеет
+ эквивалента для тела запроса; единственный стандартный способ следить за отправкой — тело-поток
+ с `duplex: 'half'`, он только HTTP/2 и только Chromium, то есть на Firefox и Safari загрузка бы
+ просто не работала. `XMLHttpRequest.upload` — совместимый механизм, и он легален ровно в одном
+ месте: сетевой гейт ESLint пускает его только в `src/api/`. Шов не протёк: экран получает промис
+ и поток чисел (`src/api/upload.ts`).
+- **Порядок частей формы — правило провода**, а не привычка клиента: `title · source_lang ·
+ target_lang · genre · file`. Держится с двух сторон — тест сверяет ключи формы, которые ушли на
+ провод, а фикстура ОТКАЗЫВАЕТ форме, где файл не последний (та же проверка, что у платформы).
+- **Три состояния отправки**, и первое из них — измеренная неожиданность. В браузере мок-сеть это
+ service worker, а Chromium **не сообщает прогресс отправки для запроса, который отвечает
+ воркер**: проба напечатала `loadstart` с верным total (`0 / 300379`) и НИ ОДНОГО `progress`
+ после. Поэтому экран не рисует долю, которой нет: «Файл отправляется: 300 кБ» без процента.
+ Доля и вторая фаза («файл ушёл целиком, ждём ответа») живут для настоящей платформы и доказаны
+ тестом `src/api/upload.test.ts` — там мок перехватывает сам `XMLHttpRequest` и события шлёт.
+- **Подтверждение видимое** (§3.2): после 201 окно показывает карточку из полей КОНТРАКТА —
+ название, языки, знаки, состояние («разбор»), — и `chapter_count` в ней намеренно нет: до конца
+ разбора он ноль, и печатать его значило бы ответить на «сколько разделов» неправдой.
+- **Отказы — состояния формы, не алерты**: фраза берётся из `problem+json` платформы (контракт
+ кладёт слова на сервер), а СОВЕТ пишет клиент, потому что провод его не несёт и он разный:
+ «проверьте файл» ≠ «повторите позже» ≠ «этот сервис книги не принимает».
+
+#### 3. Запуск прогона (остаток строки 126)
+
+Форма читает `GET /books/{id}/run-options` при ОТКРЫТИИ (потолок принадлежит аккаунту и уезжает,
+пока книга стоит), шкала строится из `CeilingBounds` в ГЛАВАХ, предустановка — `default_chapters`
+платформы. Клиент не клампит второй раз. `max_chapters: 0` — не пустая шкала, а честное
+исчерпанное состояние. `409` на старте перечитывает bounds, и выбранное значение возвращается к
+новой предустановке ВО ВРЕМЯ РЕНДЕРА, а не размонтированием формы: размонтировав, я бы убрала с
+экрана ту самую фразу отказа, ради которой всё и затевалось. Галочка «остановиться на подписи
+банка» — параметр ЭТОГО запуска. ⚠ **По умолчанию ВЫКЛЮЧЕНА, и это решение про сегодня, а не про
+продукт** (нашло адверсариальное ревью): с включённой галочкой прогон доходит до `awaiting_bank` — и
+дальше в этой сборке идти НЕКУДА: экран подписи это S5, у чтения банка вообще нет канала (Ф-43), а
+`resume` отвечает 409, пока набор решений неполон. Предустановить её значило бы предустановить
+тупик. Сама галочка остаётся — выбор принадлежит человеку и этому прогону (владелец, 02.08), — а
+дефолт вернётся в тот день, когда S5 даст остановке куда идти.
+
+**`paused` прожит, и оповещение — НЕ тост.** Решение и аргумент: тост — временный носитель
+постоянного факта, он исчезает, а состояние остаётся; на десктопном однооконном экране статус-полоса
+и карточка книги видны всегда; §3.8 запрещает экрану выглядеть тревожным, а всплывающее окно — самая
+тревожная из форм. Поэтому остановка называется там, где стоит действие: фраза владельца в
+статус-полосе И выноской на карточке книги, и обе не исчезают. Кадр `EventCeiling` + `status:
+paused` в мире моков прожит целиком (сцена `intake`). `resume` как лекарство не предлагается нигде;
+путь вперёд — НОВЫЙ прогон со своим потолком, и он на карточке есть.
+
+#### 4. Библиотека на масштабе
+
+- **Группировка по сотням** (хвост Ф-12): дерево свыше 200 разделов складывается в группы по 100
+ («разделы 1–100»), 2284 раздела дают 23 строки. Аргумент — не кадр в секунду (плоское дерево
+ виртуализовано и стоит 31 строку в DOM), а полоса прокрутки: 59 618px хода и треть пикселя на
+ строку. Группа с выбранным разделом раскрывается сама (переход из палитры не должен терять
+ строку) и остаётся закрываемой рукой — раскрытие стало УПРАВЛЯЕМЫМ (`ui/Tree.tsx`).
+- **Выбор книги в дереве построен** (§2 промта зоны — «клик по книге открывает её состояние»). До
+ S4 карточка всегда показывала `books[0]`, и половина статусов была недостижима на экране в
+ принципе. Побочный эффект найден axe в первой же сцене: строка книги теперь БЫВАЕТ выбранной, и
+ правило `[data-selected] .badge`, снятое в S3.7 как мёртвое, ожило — бейдж на синем полотне давал
+ 3.52:1 при пороге 4.5, а тон-глиф книги 1.7:1 при пороге 3. Оба перекрашены, сторож контраста
+ выбранной строки теперь гоняется и на строке КНИГИ.
+- **Все одиннадцать `BookStatus` прожиты**: в дереве — словом (фикстура держит книгу каждого
+ состояния), на карточке — те три, у которых есть что сказать сверх слова (`uploading`, `parsing`,
+ `rejected` с причиной и советом, `paused` с фразой владельца); проверено сценой `context`.
+
+#### 5. Дыра, которую нашла постройка: конца интейка никто не объявляет
+
+Живой канал принадлежит ПРОГОНУ, а книга в `uploading`/`parsing` прогона не имеет — значит «разбор
+кончился» не приходит ничем. Без лечения книга висела бы в «разборе» до случайной
+инвалидации. Сделано: опрос ровно на время интейка (`intakePollMs = 3000`, останавливается вместе
+со статусом) плюс перечитывание ДЕРЕВА на выходе из интейка (`useIntakeEnd.ts`) — иначе список
+разделов, прочитанный когда разделов не было, так и оставался пустым (поймано сценой, не
+рассуждением). Это лечение, а не решение: правильным был бы кадр от контракта — **Ф-56**.
+
+⚠ Названная цена опроса на фикстуре: в мире `showcase` книга `bk_11` стоит в `uploading` вечно (она
+там ради того, чтобы состояние было видно на экране), поэтому библиотека на этом маршруте
+опрашивается каждые три секунды бесконечно. На живой платформе так не бывает — брошенную загрузку
+подметает свип через час (`books.UploadGrace`), — но фикстура этого не моделирует, и знать об этом
+надо тому, кто будет мерить на `/showcase` что-нибудь чувствительное к сети.
+
+#### 6. Диспозиции находок приёмки S3.7 — все девять несущих
+
+| № | Диспозиция |
+|---|---|
+| 1 (high) дубль подстановки строк | **починено.** `scripts/scenes.mjs` больше не держит своего филлера: `say()` зовёт тот же `src/i18n/fill.ts`, что и приложение (харнесс уже умеет грузить `.ts`). Семантика пропуска стала одна |
+| 2 отметка «перечитывание в пути» ставится без старта чтения | **починено, и дефект оказался хуже описанного.** Отметка снимается ровно тогда, когда кончается чтение, за которое она стоит (`resetQueries().finally`). Настоящая цена прежней версии: чтение, которое ПРОВАЛИЛОСЬ, оставляло запись пустой — и ключ замолкал до конца прогона. Тест `a key whose re-read failed is not silenced for the rest of the run` падает на до-фиксном коде |
+| 3 `onResync` не чистит `asked` | **починено:** отметки уходят вместе со снимками. Тест написан так, чтобы ловить дефект В ОКНЕ (чтение задержано на 120 мс, кадр приходит, пока перечитывание в полёте) — с быстрым моком он зеленел бы и на дефекте |
+| 4 клейм «resync не рвёт живой поток» | **клейм ОПРОВЕРГНУТ замером — S3.7 была неправа.** С задержанным ответом (120 мс) поток открывался ДВАЖДЫ: id прогона лежит внутри карточки книги, а reset её опустошает, и подписка снималась на время одного чтения. Починено удержанием id на время книги (`useRunStream`), тест инструментирован задержкой и падает на до-фиксном коде |
+| 5 сцена `hidden`: прекондиция не ассертится, сторож дифференциальный | **починено тремя проверками вместо одной:** прекондиция «банк ещё не пришёл» ассертится, «таблица вообще нарисована» (4 столбца, 608px) проверяется, «столбцы по содержимому, а не равными долями» — тоже; дифференциальное сравнение осталось четвёртым |
+| 6 дырка ESLint-гейта строк | **починено, и шире находки.** Гейт знает НОСИТЕЛИ: `??`, тернарник и шаблон — и в читаемом атрибуте, и как ребёнок элемента (`{'слово'}
` не ловился вовсе). Проверено живым нарушением на всех четырёх формах; живой экземпляр `Showcase.tsx` (`?? 'TextMachine'`) переехал в каталог. ⚠ Тем же ходом СУЖЕНО правило про `style` в объектном литерале — оно ловило `{ style: 'unit' }` у `Intl.NumberFormat`; сужение точечное (значение-строка React как стиль отвергает: «expects a mapping … not a string»), носители-объекты/переменные/шаблоны ловятся по-прежнему, проверено живым нарушением |
+| 7 perf-оседание может проходить вакуумно | **починено, и магические паузы убраны совсем:** раунд начинается от таблицы, которая УСТАКАНИЛАСЬ (`rowsSettled`), и число строк для сравнения меряется в этом же раунде — прежнее бралось до прокрутки, а виртуализатор держит в DOM разное число строк в разных местах списка |
+| 8 zoom-ассерт «в ряд» не запрещает стопку | **починено наполовину, и половина названа.** Сравнение стало СТРОГИМ (`left > предыдущего left`) — стопка теперь падает. Сильную форму («панель начинается там, где кончается предыдущая») гейтом не делаю: с 125% центр уже наезжает на правую панель — это Ф-54, вопрос плотности на владельце (В-7), и красный по построению гейт учит пропускать команду. Число печатается, как и печаталось |
+| 9 кадр `status` не перечитывает список глав | **починено:** кадр статуса перечитывает и список глав, и библиотеку. Второе — моя находка сверх списка: бейдж в дереве (главный носитель состояния) продолжал говорить «в очереди» под прогоном, который уже остановился; увидела на кадре потолочного стопа. Оба теста падают на до-фиксном коде |
+
+**Минорные** (из свода приёмки): свип языка не мёл `package.json` и безрасширенный
+`scripts/githooks/pre-commit` — **починено**, оба в списке, проверено живым нарушением (русский
+комментарий в хуке роняет тест) · гейт вызовов каталога держался на имени переменной `text` —
+**починено**, регексп ловит любой вызов вида `f('ключ', {…})`, а ложное срабатывание невозможно по
+построению (ключ не из каталога пропускается); проверено живым нарушением с переменной по имени
+`say` · шапка `ru.ts` ссылалась на несуществующий `src/i18n.test.ts` — **починено** · perf:
+удлинение запроса занижает мс/клавишу — **знаю, не трогала**: запрос берётся из фикстуры целым
+термином, и менять его длину сейчас значит менять величину, которую сравниваю с прошлым паком ·
+защёлка флага съёмки (окно 150 мс) — **не трогала без замера**, как и просил свод.
+
+#### 7. Гигиена доков и арбитраж двух чисел ЗАМЕРОМ
+
+- `FRONTEND_PLAN.md`: «платформа = ноль строк кода» → P5 принята (D39.130); таблица чтения больше
+ не подаёт строки 95/99/100/103 как «чего нет» и не шлёт в `API_CONTRACT_INPUT.md` как в живой
+ вход (он под баннером «исполнено») — вместо него контракт; ссылка на удалённый `src/api/types.ts`
+ заменена на то, где состояние книги живёт сегодня (`src/api/vocabulary.ts`, одна запись).
+- `STACK_DECISIONS.md`: тулчейн платформы **1.26.6** (сверено по `platform/Makefile:19`), состав
+ `npm run check` приведён к ШЕСТИ шагам по `package.json` — промт §7 называл семь, и первая
+ редакция моей правки повторила его число; посчитано командой, а не переписано.
+- `FRONTEND_SESSION_PROMPT.md:62`: «скелет P0 ждёт приёмки» → P5 принята и залендена.
+- `frontend/README.md`: зонная копия спеки больше не «черновик на ратификацию».
+- **Арбитраж (замер на дереве ДО пака).** Ключей каталога — `node -e "import('./src/i18n/ru.ts')…"`
+ → **157**: правы Ф-35 и живой `ru.ts`, «147» записи S3.7 неверно. Цена бандла — `npx vite build`
+ → главный чанк **724130 байт**: права ЗАПИСЬ S3.7 (+7999 от 716131), а «723102 (+6971)» строки
+ Ф-35 неверно. Живые носители (Ф-35, Ф-18) приведены к замеру; записи хроники не правлены — это
+ попутка, как и требует промт.
+
+#### 8. Заведённые строки и вопросы
+
+Ф-56 (нет кадра о конце интейка — вылечено опросом) · Ф-57 (какие пары языков продукт принимает —
+контракт не говорит, форма предлагает свой список) · Ф-58 (RTL не проверен, триггер наступил) ·
+Ф-59 (спойлер достаётся поиском по странице — ЗАМЕРЕНО) · Ф-60 (канвас-замер не знает `lang`) ·
+Ф-61 (платформа отвечает по-английски в русском интерфейсе — у контракта нет ни `Accept-Language`,
+ни машинного кода отказа) · **Ф-62** (переименовать книгу нечем: у книги на всей поверхности
+контракта нет ни одной записи — нашло ревью на обещании «поправить позже», обещание снято) ·
+**Ф-63** (рамка поля на модальной поверхности 1.20:1 при пороге 1.4.11 — тот же токен несёт рамки
+всей оболочки, поэтому перекраска это вид, а вид принимает владелец). Владельцу: **В-10** (спойлер —
+защита или вежливость) и **В-11** (фразы PD-173 на утверждение). Ф-52 закрыта замером и гейтом,
+Ф-42 закрыта решением по замеру, Ф-12 и Ф-26 — наполовину.
+
+#### 8а. Фразы PD-173 — отдельным списком на утверждение владельцем
+
+Промт (§2) просит вынести их отдельно. Написаны по РЕАЛЬНОМУ флоу отказов (прочитан
+`platform/internal/books/parse.go` read-only), в границах ПТ-33 — ни стадий, ни моделей, ни слова
+«парсер»/«манифест» — и без тревожного тона (§3.8). Разное следующее действие — разные фразы.
+
+| Машинная причина | Фраза | Совет (следующее действие) |
+|---|---|---|
+| `source_unreadable` | Файл не удалось разобрать на разделы | Проверьте файл — возможно, это не текст книги — и добавьте её заново. |
+| `not_configured` | Сервис пока не готов принять эту книгу | Файл здесь ни при чём: повторная загрузка поможет не раньше, чем мы это наладим. |
+| `parser_unavailable` | Не удалось обработать файл на нашей стороне | Файл здесь ни при чём: попробуйте добавить книгу позже. |
+| причина неизвестна (ветка неизвестного) | Книгу не удалось принять | Причина не названа. Попробуйте добавить книгу заново или позже. |
+
+Почему так: `source_unreadable` — движок прочитал файл и отказался (или не нашёл в нём ни одного
+раздела), исходник при этом УДАЛЯЕТСЯ и пере-разбора в контракте нет, поэтому единственное честное
+действие — добавить книгу заново. `parser_unavailable` — движок не удалось ЗАПУСТИТЬ, файл цел, но
+дотянуться до него нечем: повтор позже осмыслен. `not_configured` — деплою нечем разбирать книгу,
+и повтор сам по себе не поможет; ⚠ на сегодняшней платформе эта причина на отклонённую книгу не
+попадает вовсе (в записи выше), то есть фраза написана впрок. Ветка неизвестного не обвиняет ни
+файл, ни сервис — она не знает, кто виноват.
+
+#### 9. Адверсариальное ревью диффа (author≠reviewer) — механизмом
+
+Пять независимых линз по диффу (контракт · корректность клиента · продуктовые правила и доступность
+· гейты и тесты · фикстура и шов), на КАЖДУЮ находку — отдельный скептик с установкой ОПРОВЕРГАТЬ и
+требованием проверять исполнением, а не рассуждением. **44 находки, 49 агентов, 14 выжило.**
+Скептики гоняли vitest и рендерили компоненты сами — в отчётах ниже это видно по формулировкам
+«reproduced by rendering», и это ровно то, чего требует D39.129.
+
+⚠ **Честная оговорка о методе:** ревью шло по ЖИВОМУ дереву, пока я в нём работала, поэтому часть
+«опровергнутых» — это находки, верные в момент подачи и починенные мной до того, как до них дошёл
+скептик (порядок, счёт знаков, преждевременные тотали, 404 на старте, версия рукопожатия). В
+следующий раз ревью надо гонять по замороженному дереву, иначе «опровергнуто» смешивает два
+разных исхода. Ниже — по существу, а не по ярлыку воркфлоу.
+
+| Находка | Диспозиция |
+|---|---|
+| **Плейсхолдер названия обещает разбор, которого платформа не делает** (`parsedTitle` менял `_-` на пробелы, а `titleFrom` платформы срезает только расширение) | **принято, починено.** Скептик проверил ДВУМЯ прогонами — нашим `vitest` и `go test` платформы, где табличный случай прямо фиксирует, что дефис переживает `titleFrom`. Клиент теперь предсказывает ровно то, что делает сервер |
+| **Любой 409 на старте трактовался как «потолок уехал»** — платформа отвечает им ещё на четыре причины (прогон уже идёт, книга не готова, нет кредита) | **принято, починено:** совет стал причинно-нейтральным, а перечитываются ТЕПЕРЬ ОБА чтения — и шкала, и карточка книги (устаревшая карточка и была второй половиной дефекта). Воспроизведено скептиком рендером с реальным телом `problem+json` платформы |
+| **`useIntakeEnd` срабатывал на СМЕНУ книги** и выбрасывал список глав только что открытой | **принято, починено:** «переход» считается только внутри ОДНОЙ книги (в ref лежит пара «книга + состояние»). Воспроизведено рендером |
+| **`runOptionsQuery` наследовал общий `staleTime` 15 с** — переоткрытие формы в этом окне отдавало кэшированные bounds | **принято, починено:** `staleTime: 0`. Это ровно то, ради чего bounds — отдельный ресурс: максимум принадлежит АККАУНТУ и уезжает, пока книга стоит |
+| **Авто-раскрытие открывало ГРУППУ, но не саму книгу** — прыжок из палитры в свёрнутую книгу оставлял строку невидимой | **принято, починено:** книга открывается вместе с группой |
+| **`useRunStream` отдавал состояние связи ПРЕДЫДУЩЕЙ книги** на первый кадр после смены | **принято, починено:** при смене книги состояние сбрасывается в `connecting` |
+| **Строки групп кликались и не делали ничего** | **принято, починено:** клик по строке группы её сворачивает и разворачивает — то, что делает клик по папке в любом дереве |
+| **Шкала потолка объявляет голое число, подсказка не привязана** | **принято наполовину, замерено.** Подсказка привязана (`aria-describedby` теперь доезжает до инпута — проба в браузере до и после). Единицу в `aria-valuetext` подставить НЕЛЬЗЯ: библиотека составляет его сама из значения, переданный проп до инпута не доходит (замер). Цену назвала в коде: единицу несёт `SliderOutput`, а он живая область (`role="status"`) и читается на каждое изменение |
+| **Проверка «фраза платформы» в тесте 413 проходила при ОТСУТСТВИИ тела** (`undefined !== ''`) | **принято, починено:** проверяется непустая СТРОКА |
+| **Сцена `refusals` проверяла отсутствие фразы, недостижимой на этом пути** — не могла упасть | **принято, переписано:** теперь проверяется отсутствие СОБСТВЕННОЙ фразы клиента для этого класса (она достижима — ею клиент отвечает, когда тела нет), то есть проверка ловит подмену. ⚠ И тем же ходом нашлось второе: фраза фикстуры для 408 была ПОБУКВЕННО равна фразе клиента, из-за чего проверка была слепа — фикстура заговорила своими словами |
+| **Клавиатурная проверка Select утверждала то, что верно до нажатия клавиш** | **принято, починено:** сравнивается ИЗМЕНЕНИЕ значения |
+| **Список читаемых атрибутов гейта строк не знал `valueLabel`** — текстового пропа обоих новых примитивов | **принято, список расширен** (`valueLabel`, `aria-valuetext`) |
+| **`rowsSettled` мог принять промежуточное плато за устаканенную таблицу** | **принято:** нужны ТРИ одинаковых замера подряд, не два |
+| **Порог 3:1 сравнивался после округления** — 2.995 прошло бы как 3 | **принято** (формально опровергнуто «сегодня такого токена нет», но дыра реальна): сравнение идёт по замеренному числу |
+
+**Найдено ревью и починено ДО вердикта скептика** (то есть в «опровергнутых» по причине «уже не
+воспроизводится»): фикстура отдавала библиотеку от старых к новым, а платформа — от новых к старым
+(`order by added_at desc`), и только что загруженная книга уезжала вниз · `character_count` считался
+БАЙТАМИ, а платформа считает код-пойнты (`counter.Write` считает ведущие байты UTF-8) · книга без
+прогона получала ненулевые тотали юнитов, и карточка печатала «Разделов 0 · Блоков 12» · старт
+прогона отвечал 404 на четырёх из пяти запускаемых книг витрины (фикстура отдавала только заранее
+записанный прогон — теперь старт СОЗДАЁТ прогон, как на платформе) · счётчики глав не двигались в
+мире интейка, пока счётчик книги бежал к концу (теперь мир отдаёт кадр `chapter`, и чтение с ним
+согласовано) · рукопожатие фикстуры объявляло 0.2.2 после бампа спеки до 0.2.3 — **и это теперь
+заперто тестом**, потому что клиент сверяет только МАЖОР и молчал бы дальше · правило длины поля
+считало UTF-16-единицы вместо байтов · живые области для чтения с экрана, цель чекбокса 18px и его
+рамка 1.20:1 о модальную поверхность (последняя — Ф-63, потому что тот же токен несёт рамки всей
+оболочки) · обещание «название можно поправить позже» при отсутствии в контракте хоть одной записи
+о книге (Ф-62).
+
+**Опровергнуто и НЕ менялось** (примеры): «спека утверждает про `BookIntake.title` то, чего у
+платформы нет» — так и задумано, это ратифицированная правка, а платформа догоняет; «`not_configured`
+недостижим» — назван мной самой в записи и в спеке, значение словаря версии; «сужение правила
+`style` освобождает любую строку» — React строковый `style` отвергает, носители-объекты ловятся;
+«английские фразы платформы в русском интерфейсе» — контракт кладёт слово на сервер, а расхождение
+заведено строкой Ф-61, а не залатано вторым носителем на клиенте.
+
+#### 9а. Второй проход ревью — по осям, которых не было в первом (норма кода · вода · велосипеды · соответствие заданию · ошибки самого задания)
+
+Первый проход (§9) смотрел контракт, корректность клиента, продуктовые правила, гейты и фикстуру.
+Осей, которые владелец назвал прямо — «промышленные стандарты, без хаков и велосипедов, без воды в
+коде», — и оси «сделано ли ровно то, о чём просили, с поправкой на то, что промт писала нейросеть» —
+в нём НЕ БЫЛО. Второй проход закрывает эту дыру: пять линз (нормы §5.1 · вода · велосипеды ·
+соответствие заданию · верность самого задания), скептик на каждую находку, агентам ЗАПРЕЩЕНО писать
+в репозиторий (в первом проходе один агент оставил правку в моём файле — поймано снимком дерева;
+здесь снимок сверен после прогона: дерево тронуто только мной). **46 находок, 6 выжило.**
+
+| Находка | Диспозиция |
+|---|---|
+| **(ошибка ЗАДАНИЯ, high) «поле после файла = 400» — неправда.** Промт §2 (PD-172) и §2 (PD-180) так говорят, я перенесла это в спеку 0.2.3 и в фикстуру | **принято, исправлено во всех трёх местах.** По коду платформы (`httpapi/v0.go:352-361`) читатель ОСТАНАВЛИВАЕТСЯ на файле: часть после файла не читается вовсе — обязательная (языки) даёт 400 «как будто её не слали», необязательная (жанр) молча теряется, и загрузка проходит. Моя фикстура отказывала форме с хвостовым `genre` — то есть отказывала ЗАКОННОМУ запросу. Спека переписана точно, фикстура моделирует поток, добавлены два теста: обязательное поле за файлом = 400, необязательное = 201 без него |
+| **(ошибка ЗАДАНИЯ, low) §7 велит починить число, которое само неверно:** «`npm run check` — 4 шага против нынешних 7» | **принято.** Шагов **шесть** (посчитано `node -e` по `scripts.check`), и первая редакция моей правки повторила «семь» из промта — то есть я занесла свежую неправду в живой док. Исправлено в `STACK_DECISIONS.md` и в записи |
+| **(medium) Дерево узнавало строку-складку, РАЗБИРАЯ id** (`/:\d+$/`) | **принято, переписано.** Контракт: «идентификатор непрозрачен, клиент НЕ ДОЛЖЕН его разбирать», а движок уже строит ключи вида `<глава>:<срез>:<индекс>`, под этот шаблон подходящие. Теперь складка узнаётся по ПРИНАДЛЕЖНОСТИ к множеству, которое этот же файл и построил. ⚠ И первая редакция фикса была неверна — множеством стали ВСЕ дети книги, то есть на плоском дереве складкой оказалась каждая глава; поймала батарея сцен (`tabs`: двойной клик перестал закреплять вкладку), а не рассуждение |
+| **(medium) Ветка 409 не показана ни сценой, ни кадром, ни тестом** — при том что §11 требует показать каждую | **принято, построено.** Фикстура двигает потолок ОДИН раз, ровно как описывает контракт («холд по другой книге снижает остаток между чтением и вызовом»), поэтому первое нажатие «Перевести» получает 409 — единственный отказ, до которого доходит корректный клиент на корректной форме. Сцена `intake` теперь проверяет: фраза платформы на экране, наша не подставлена, шкала перечитана и стоит на новых bounds; второе нажатие запускает прогон |
+| **(medium) Правка `STACK_DECISIONS` повторила ошибочное число** | см. вторую строку — то же исправление |
+| **(low) Мёртвый элемент в списке авто-раскрытия** (`openBookId` дважды, второй под тернарником) | **принято, убрано** |
+
+**Найдено ревью и починено, хотя скептик снял** (не «опровергнуто по существу», а «уже не
+воспроизводится» либо «не этой сессии код», а дефект настоящий): выбор ТОГО ЖЕ файла второй раз не
+поднимал событие `change` — вход теперь очищается после чтения, иначе отказ оставался на экране под
+только что перевыбранным файлом · арифметика контраста в харнессе сцен округляла ДО сравнения, то
+есть имела ровно ту дыру, которую я закрыла в токен-гейте.
+
+**Опровергнуто по существу, и это тоже результат** (примеры с грунтом скептика): «AddBook 298 строк
+и шесть компонентов» — норма мягкая («~150», приёмка глазами), компонент один плюс три вида его же
+состояний и два чистых помощника, и файл в ряду зоны не выбивается · «состояние книги решается
+литералами в экране, контрольный вопрос провален» — ратифицированное чтение вопроса (компаньон
+контракта §«новое продуктовое состояние») требует ОДНОГО файла для карты «статус → вид», и он один,
+компилятор его и держит · «карта отказов написана трижды» — таблицы двух операций не пересекаются ни
+одной строкой и повторяют перечни ответов из спеки, слияние было бы контрактной ошибкой ·
+«файловый вход — велосипед, у библиотеки есть `FileTrigger`» — скрытый вход приехал из S3.7 и принят,
+а норма зоны запрещает импорт примитивов вне `src/ui/` · «сужение гейта `style` — подгонка» — обе
+формы регистра Ф-9 по-прежнему падают, порог не двигался, а сужение объявлено в зонном журнале,
+который и есть канал пингов фронта.
+
+⚠ **Флейк `perf`, названный числом.** В полной батарее сцена показала 63 мс/клавишу при пороге 60 и
+уронила команду; та же сцена в одиночку — 38 мс (34·36·38·38·51). Причина видна в `ps`: параллельные
+сессии зоны полигона и платформы держали `load average` около 8–13 (их питон и `go test`). Порог не
+трогала — S3.7 уже заменила шумный способ снятия величины на медиану пяти заходов, а двигать порог
+под чужую нагрузку было бы ровно той подгонкой, которую норма запрещает. На тихой машине (`load` 2.4)
+`npm run check:full` — **EXIT=0**, 335 тестов, 136 проверок, 11 сценариев, 8 маршрутов.
+
+#### 10. Чего я НЕ сделала
+
+- **Живого стенда платформы не поднимала** и smoke `POST /books` через dev-прокси не гоняла (§10 —
+ опция, не гейт). Значит всё, что сказано про поведение НАСТОЯЩЕЙ платформы, — из её кода и из
+ контракта, а не из прогона: сюда попадают определённая доля отправки, вторая фаза «файл ушёл» и
+ фразы `problem+json` (Ф-61).
+- **Отмена отправки на середине не проверена исполнением.** Тест покрывает только уже отменённый
+ сигнал: мок-сеть перехватывает запрос в тот же тик, и прервать его тиком позже она не даёт.
+ Сам путь — три строки (`signal → xhr.abort()`), но честнее назвать, чем зачесть.
+- **Добавление ГЛАВЫ (§3.10) не строила** — ручки в контракте нет, кнопка без действия запрещена
+ нормой зоны. Черновика правки спеки не писала: это не хвост загрузки, а отдельный сценарий, и
+ его форму (глава в существующую книгу? пере-разбор?) решать владельцу контракта.
+- **Референса `antigravity_add_folder.png` на диске нет** (папка под .gitignore, как было с
+ fleet_2.png): форму добавления книги я НЕ перерисовывала — достроила поля в раскладку S3.5.
+
+
+
+#### 11. Гейты на сдаче
+
+`npm run check` — зелёный, **335 тестов** (было 279). `npm run check:full` — EXIT=0: сборка, **8
+маршрутов** со снимком и axe (добавился `/intake`), **11 сценариев, 136 проверок** (добавились
+`intake` и `refusals`), ноль блокирующих нарушений axe и ноль узлов контраста на всех маршрутах и
+во всех сценах. Числа получены командами `npm run check`, `npm run check:full`, `npm run scenes`.
+
+Живым нарушением проверено (каждый гейт — своим): расширенный гейт строк роняет все четыре новые
+формы (`?? 'Слово'`, тернарник, шаблон, литерал ребёнком элемента) и по-прежнему ловит носители
+инлайн-стиля (объект, переменная) · сужение правила `style` не пропускает ничего, кроме строки ·
+свип языка ловит русский комментарий в безрасширенном `scripts/githooks/pre-commit` · гейт вызовов
+каталога ловит лишнюю переменную при вызове через переменную по имени `say` · порог контраста тонов
+краснеет на прежнем `--color-danger`. Тесты фиксов приёмки (кадр библиотеки, кадр списка глав,
+отметка после провалившегося чтения, отметки после ресинка, поток при медленном перечитывании)
+падают на до-фиксном коде — проверено откатом каждого фикса по очереди.
+
+### 10.08 — приёмка S3.7 оркестратором: ПРИНЯТО и залендено; арбитраж 8.1 — права сессия
+
+Гейты пере-прогнаны исполнением: `npm run check:full` EXIT=0 · vitest **279** · 9 сценариев
+(вывод сценариев теперь английский — свод дошёл и до инструментов) · сцена `hidden` зелёная.
+Ревью 11 агентами (6 линз + скептики, author≠reviewer): **12 находок подтверждено (1 high),
+0 опровергнуто, 16 минорных**; блокеров лендинга нет — носители ниже.
+
+**Арбитраж 8.1 — ПРАВА СЕССИЯ, HIGH приёмки S3.6 снята как ложноположительная.** Вердикт
+арбитражной линзы: в Chromium дефекта не существует — геометрический запрос (`read()`)
+внутри `content-visibility: hidden`-поддерева форсит расчёт раскладки, и замер таблицы в
+скрытой keep-alive вкладке даёт те же ширины, что у видимой (живой прогон сцены `hidden`
+при этой приёмке: `121·122·133·348` = эталону). Ошибка была МОЯ: верификатор S3.6 рассуждал
+от кода, не меряя браузером, и «CONFIRMED» надо было ставить как «PLAUSIBLE до живого
+прогона». Сессия поступила образцово: не поверила приёмке, замерила, сняла свой же
+уже написанный механизм и оставила сторож (Ф-53). Остатки сторожа честны и заведены ниже.
+
+**Поправки к записи S3.7 (сама запись не правлена):**
+
+- **Ложный клейм про `fill.ts` (high):** «заполнение вынесено в `src/i18n/fill.ts`, его
+ импортируют и приложение, и сцены» — сцены НЕ импортируют: `scenes.mjs` держит собственный
+ инлайн-филлер (`say()`, с ДРУГОЙ семантикой пропуска), и эта строка добавлена самой S3.7.
+ Дубль реален, диспозиция находки ревью в записи была ложной.
+- Цена бандла в записи (+7999 байт) противоречит числу в `BACKLOG.md`; ширины сцены `hidden`
+ в записи (`…·232`) устарели против дерева (`…·348` — сторож валиден, число дрейфнуло);
+ «106 из 119 = один свип» неточно (свип = 100 случаев); `BACKLOG.md` Ф-25 сохранил
+ отозванный самой записью клейм «вранья в комментариях не нашлось».
+
+**Находки приёмки — носитель: блок «находки приёмки S3.7» следующего фронт-промта (S4):**
+(1) отметка «перечитывание в пути» ставится без старта чтения и глушит следующие кадры ключа
+(`useRunStream.ts:146`); (2) `onResync` не чистит `asked` — отметки прежней эпохи съедают кадр
+в окне ресинка (`:42`); (3) клейм «resync не рвёт живой поток» принимать только по живому
+инструментированному прогону с задержкой ответа (статика `resetQueries` говорит обратное);
+(4) сцена `hidden`: прекондиция «ушли до прихода банка» не ассертится (гонка с синхронным
+моком) и сторож дифференциальный — симметричная регрессия замера пройдёт; (5) дырка
+ESLint-гейта: вычисленный литерал (`?? 'Word'`, тернарник) в читаемом атрибуте проходит —
+живой экземпляр `Showcase.tsx:134`; (6) perf-оседание может проходить вакуумно (заходы 2–5
+ждут 300мс против конвенции 700); (7) zoom-ассерт «в ряд» не запрещает стопку (сравнивает
+left с left, не с right); (8) кадр `status` не перечитывает список глав. Минорные — свод
+воркфлоу `wf_360f34ea-b32`.
+
+### 10.08 — восьмая фронт-сессия (S3.7): долги слоя данных, контракт 0.2.2, строки в каталог
+
+Вход: промт `S37_SESSION_PROMPT.md` (девять задач) плюс правило владельца, пришедшее по ходу пака:
+**в КОДЕ никакого русского** — комментарии, сообщения ошибок, логи, имена тестов, служебные строки
+сценариев по-английски; русский UI-текст живёт ТОЛЬКО в словаре.
+
+#### 1. Прогон по задачам
+
+| Задача | Что сделано | Тест / замер |
+|---|---|---|
+| **Ф-49** свежесть текста главы | кадр `chapter` инвалидирует юниты ИМЕННО своей главы, кадр `status` — юниты всей книги (границы стадий: пока `units_done` единый счётчик, кадра главы за волну может не быть ни одного) | `useRunStream.test.tsx`, 2 случая по счёту запросов к MSW; оба падают на до-фиксном коде |
+| **Ф-50** потерянный кадр | кадр, не нашедший снимка, зовёт `resetQueries` по своему ключу; ревизия многостраничного списка = МИНИМУМ из страниц | 2 теста, оба падают на до-фиксном коде. **Выбор reset вместо invalidate — замер, а не вкус:** `invalidateQueries` на запросе без данных ничего не делает (в исходнике библиотеки: перезапуск в полёте только при `state.data !== undefined`), то есть возвращает промис того самого устаревшего чтения |
+| **Ф-51** resync | `resetQueries` по скоупу КНИГИ (`bookScope`), отметка ревизии уходит вместе со снимком; чужие скоупы целы | 2 теста, оба падают на до-фиксном коде |
+| **Ф-47** `sense` обязателен | зонная копия `openapi.yaml` → **0.2.2**, правило пустой строки в описании, типы перегенерены, костыль `?? ''` снят | `npm run contract` зелёный; ⚠ костыль был в ОДНОМ месте, а не в трёх — счёт строки бэклога был завышен |
+| **Ф-40** общий модуль поля | `src/ui/Field.module.css` (`.input` + модификатор `.framed`), примитивы остались разными | `cssModules.test.ts` (пары по импортам, сироты) |
+| **Ф-25** язык кода | английские комментарии/тесты/сообщения во ВСЁМ дереве зоны, включая конфиги, `index.html` и python | гейт `src/i18n/catalogue.test.ts`, проверен живым нарушением |
+| **Ф-35** строки интерфейса | каталог `src/i18n/ru.ts` (**157 ключей**), механизм `@internationalized/string` 3.2.10, стор языка с персистом, локаль оттуда же берут `I18nProvider`, `Intl` и `` | гейт ESLint проверен живым нарушением на ДВУХ литералах — русском и английском; цена бандла 716131 → 724130 (+7999 байт, из них ~10 КБ — сам текст каталога, то есть библиотека не добавила ничего) |
+| **сторожа** зум и узкая панель | сцена `zoom` (125/150/200% = вьюпорты 1152/960/720 в CSS-пикселях): перелив окна, три панели стоят в ряд ВНУТРИ окна и по порядку, текст статус-полосы не обрезан, таблица банка нарисована и не за краем, axe на каждом шаге | `npm run scenes zoom` — **18 проверок**; сцена печатает и число, которое НЕ утверждает: обрезку центра (98px при 150%, 170px при 200%) — это Ф-54 |
+| **замер `measure.py`** | палитра S3.6 воспроизведена по `fleet_2.png` (`#181818` 63.97%, `#292929` 7.17%), кадр `/showcase` сведён с `fleet.png` при 1280×764 | числа и вердикты — `FRONTEND_PLAN.md` §5.7; окружение запинено (`scripts/requirements.txt`) |
+
+#### 2. Находки приёмки S3.6
+
+| № | Диспозиция |
+|---|---|
+| 8.1 (HIGH) | **НЕ ВОСПРОИЗВЕЛАСЬ.** Замер в браузере: таблица, смонтированная в скрытой keep-alive вкладке `/scale`, держит 116 ячеек и ширины `121·122·133·232` — те же, что у вкладки, с которой не уходили, и на до-фиксном коде тоже; `content-visibility: hidden` подтверждён на самой панели (`data-inert`, computed `hidden`). Причина: запрос геометрии внутри пропущенного поддерева заставляет браузер посчитать раскладку. Мой первый заход добавил под эту находку `IntersectionObserver` — **механизм снят**, чинить нечего. Сцена `hidden` (уход с вкладки ДО прихода банка и возврат) оставлена сторожем: путь реален и не был покрыт. Строка Ф-53 |
+| 8.2 контраст выбранной строки | починены пары на синем: счётчик замечаний → `--color-text` (7.27:1), значок и дорожка → `--color-text-secondary` (3.52:1), заполнение → `--color-text`. ⚠ Бейдж состояния книги в правило НЕ входит, и первая редакция этой строки врала: правило `[data-selected] .badge` было написано и снято — выбор в дереве контролируется активным документом, поэтому строка КНИГИ выбранной не бывает, и правило было мёртвым. Сторож в сцене `tabs` считает контраст ВНУТРИ страницы и падает на до-фиксном коде четырьмя парами (1.97 · 3.52 · 1.55 · 1.97). ⚠ Названо честно: пара «заполнение ↔ дорожка» даёт 2.07:1 — выше палитрой владельца не поднять, поэтому выбрана та пара, где обе половины читаются на самом фоне |
+| 8.3 сирота в «Замечаниях» | гард поднят в `open`/`pin` самого экрана (одно место вместо двух у зовущих), сирота помечается и когда раздел НАЗВАН, но отсутствует в списке |
+| 8.4 съёмка | (а) флаг не пишется, пока не полетел первый запрос, и защёлка ждёт 150 мс тишины — **замер показал дефект хуже описанного:** `/scale` снимался со строкой «загрузка разделов…», потому что между волнами чтений счётчик честно падает в ноль; (б) `shot.mjs` и `scenes.mjs` ждут доигрывания анимаций перед axe |
+| 8.5 минорные | все девять: кэш канвас-замера запоминает ширину только если шрифт реально доступен (`document.fonts.check`); пин вкладки — только левая кнопка и выделение ВНУТРИ этой главы; `termStatus` больше не носит нерендерящихся слов; три комментария токенов исправлены числами (3.58:1 · `--row-height-term`) и `--color-note` поднят до 3.07:1; `.paused` перестал быть no-op, `.offline` снят; **подпись disabled-кнопки** — противоречие «нетекстового» токена с WCAG разрешено в пользу WCAG, и оговорка написана рядом с самим токеном, а не рядом с кнопкой; сторож обрезки вкладок падает, если заголовок перестал быть `span`; PIL запинен |
+| 8.5 ре-рендер экрана | **замер до/после:** флаг съёмки переехал в лист (``), потому что `useIsFetching` перерисовывал ВЕСЬ экран на каждый старт и финиш запроса. Открытие 12 глав на `/scale`: p90 кадра 133 → 50‥67 мс, длинных кадров 16‥19 → 7‥13, длинных задач 22 (≈2080 мс) → 16 (≈1110 мс) |
+| 8.6 доки | `FRONTEND_PLAN.md` §5.6 поправлен (модель «вырез в хроме» описана как СНЯТАЯ, в коде пилюля), §4 — сценариев девять, команда замера через venv; `README.md` — карта сессий и раздел про язык кода; `BACKLOG.md` Ф-47 — счёт костылей исправлен |
+
+#### 3. Что нашла проверка исполнением, а не рассуждение
+
+- **Каталог печатал `показано {shown} из {total}` буквально.** `@internationalized/string` подставляет
+ переменные ТОЛЬКО в скомпилированные функции (прочитано в исходнике библиотеки), а плоскую строку
+ отдаёт как есть; ICU-компилятор — это отдельный шаг сборки, от которого стек отказался, когда
+ взвешивал lingui. Подстановка `{name}` теперь наша, четыре строки, и на неё стоит тест; поймал
+ дефект сценарий `bank`, юнит-батарея его не видела.
+- **Гейт строк сначала был написан по алфавиту** — и это было хуже, чем кажется: одно правило жило
+ в двух носителях (селектор ESLint и регексп теста), а перечень букв `ПТ|Ф|В|К|Д` был заплаткой под
+ конкретные строки бэклога. Переделано: ESLint ловит текст МЕСТОМ (буква в `JSXText` или в читаемом
+ атрибуте) — ловит и русский, и английский литерал, то есть строго сильнее; алфавит остался ровно
+ в одном месте и для ДРУГОГО правила («код зоны английский»), где комментарии иначе не проверить.
+- **`/scale` снимался недоделанным** (см. 8.4а) — нашлось при первой же проверке нового флага кадром.
+- **«Переезд строк, а не перевод» — доказано замером, а не обещанием.** Собрал все строки, которые
+ печатает экран (текст плюс `title`/`aria-label`/`placeholder`/`alt`), на шести маршрутах, из ДВУХ
+ сборок: этой и собранной из `git archive HEAD`. **986 строк, посимвольное совпадение.** Первый
+ заход замера показал расхождение и был неправ сам: он собирал текстовые УЗЛЫ, а переезд фразы
+ в каталог превращает три узла в один («переведено» · «0» · «из» · «1» → «переведено 0 из 1»);
+ сравнивать надо строки, как их читает глаз.
+
+#### 4. Как шла работа
+
+Свод языка и переезд строк — двенадцать параллельных агентов по непересекающимся файлам, каждый
+вернул свои ключи структурой, каталог собран одним местом. Их находки, которые я разобрал руками:
+JSDoc `look` у кнопки описывал три значения из четырёх (дописано), комментарий подвала панели
+ссылался на токен, который стоит не в этом правиле (переписан по коду), комментарий панели цитировал
+замер Fleet рядом с нашим изменившимся токеном (разведено явно).
+
+⚠ **Правка этой же записи по адверсариальному ревью.** Первая её редакция утверждала: «ни одного
+комментария, оказавшегося враньём против кода, свод не нашёл». Это неверно — я написал это по
+`notes` агентов, а по ДИФФУ таких мест минимум три, и все три поправлены молча: `ui/Tabs.tsx:44`
+(«один скролл-контейнер на вкладку» → панель `overflow: hidden`, скроллят списки внутри — переворот
+полярности), `showcase/Reader.module.css:12` (ссылка на `--space-4` при фактическом `--space-3`),
+`showcase/documents.ts:62`. Правильный вывод: свод их нашёл и исправил по коду, а мой отчёт этого
+не назвал — ровно тот класс, из-за которого приёмка требует сверять отчёт с диффом.
+
+#### 4а. Адверсариальное ревью диффа (author≠reviewer) — что оно поменяло
+
+Шесть линз плюс скептик на каждую находку с установкой ОПРОВЕРГАТЬ. Выжившее и его диспозиции:
+
+| Находка ревью | Диспозиция |
+|---|---|
+| **Ф-50 закрыт только для двух ключей:** кадры `note`/`bank`/`ceiling` остались на `invalidateQueries` и пропадали в том же окне | **принято, починено.** Все кадры идут через один `reread()`; тест на кадр `bank`+`ceiling` падает на до-фиксном коде |
+| **Перезапуск чтения на КАЖДЫЙ кадр**, пока запись пуста | **принято, замерено, починено.** Пачка из пяти кадров стоила ШЕСТЬ чтений; отметка «перечитывание уже в пути» держит их в двух. Тест на пачку |
+| **resync рвёт живой поток:** id прогона лежит ВНУТРИ карточки книги, а reset её опустошает | **не воспроизводится.** Замер: наблюдатель ни разу не рендерится с пустой карточкой (шесть рендеров, `status=success` во всех), `EventSource` открыт один раз и до, и после фикса. Гард, который я было написал, СНЯТ; тест-сторож («resync не перезапускает поток», проводка как на настоящем экране — id из запроса книги) оставлен |
+| **Тест подстановки — тавтология:** он заполнял места значениями, которые сам же из строки и вынул | **принято, переписано.** Теперь сверяются ВЫЗОВЫ: переменные, которые передаёт caller, против мест его строки, плюс обратное направление |
+| **Сторож языка не смотрит корневые файлы** (`index.html`, `vite.config.ts`, `tsconfig.json`) — как раз те, что сессия перевела руками | **принято, починено:** корни в списке по имени |
+| **ESLint-гейт знал семь атрибутов**, а `description`/`empty`/`hint`/`caption` наших примитивов — тоже текст на экране | **принято, список расширен** |
+| **`` не следует за выбором языка** — единственное, чего второй язык не мог бы поменять | **принято:** `Locale` ставит `lang` документа по выбранной локали |
+| **Сцена `zoom` зеленела бы на таблице, которая ничего не нарисовала** | **принято:** сначала проверяется, что столбцы есть |
+| **Отчёт врал в двух местах** (бейдж на выбранной строке; «ни одного вранья в комментариях») | **принято, обе строки поправлены выше** |
+| **Кадры `chapter` и `status` (то есть сам Ф-49) остались вне `reread`** — тот же пропадающий кадр на самом ходовом ключе | **принято, починено:** оба идут через `reread`; для книжного скоупа заведён `rereadAll`, который спрашивает КАЖДЫЙ ключ по отдельности — сброс по префиксу обнулил бы все открытые главы разом |
+| **Каталог и стор:** неизвестный сохранённый язык роняет первый рендер; `` заморожен; счётчик замечаний склоняется одной формой («1 замечаний»); потолок прогона — тоже | **принято, всё починено:** локаль неизвестного языка падает на язык по умолчанию, `lang` документа следует выбору, оба счётчика склоняются через `Intl.PluralRules` теми же формами, что уже носит банк |
+| **Второй экземпляр подстановки `{place}`** в харнессе сценариев | **принято:** заполнение вынесено в `src/i18n/fill.ts`, его импортируют и приложение, и сцены |
+| **Сцена `hidden` зеленела бы на самой регрессии**, которую сторожит | **принято, переписана:** сравнивает ШИРИНЫ таблицы, смонтированной в скрытой вкладке, с ширинами той же таблицы, с которой не уходили (121·122·133·232 против них же) |
+| **Сцена `zoom`: две проверки ни о чём** (панель шириной > 0; низ статус-полосы = низ окна) и она оставляла следующей сцене свою раскладку в localStorage | **принято:** проверки заменены на «три панели стоят в ряд внутри окна» и «текст статус-полосы не обрезан», хранилище восстанавливается. ⚠ И тем же ходом найден настоящий дефект — Ф-54 |
+| Мин-ревизия рвёт список и не оставляет следа | **отвечено, не менял:** дропнутый ответ не теряет строк — в кэше остаётся полный список с патчем кадра, а случай «список ПРИОБРЁЛ строки» контракт закрывает `resync_required` |
+| `api.test.ts` ослабил две проверки, сверяя фразу с константой мока | **отвечено, не менял:** проверка ловит ровно то, ради чего заведена — клиент передаёт фразу платформы нетронутой; прежняя форма вдобавок запирала СЛОВА фикстуры, то есть падала бы от правки фикстуры |
+
+#### 5. Красный гейт, который я НЕ подогнал
+
+Сцена `perf` на загруженной машине (в тот момент шло адверсариальное ревью двенадцатью агентами)
+показала отклик поля 63‥79 мс при пороге 60 и уронила `check:full`. Порог не трогал — вместо этого
+поставил A/B тем же зондом по двум сборкам подряд, чтобы нагрузка била в обе одинаково:
+
+| Сборка | Отклик на символ, пять прогонов |
+|---|---|
+| до этой сессии (`git archive HEAD`) | 44 · 47 · 50 · 54 · 59 и 42 · 43 · 44 · 46 · 48 |
+| эта сессия | 39 · 41 · 43 · 44 · 47 и 39 · 41 · 42 · 44 · 47 |
+
+То есть регрессии нет — сборка стала БЫСТРЕЕ, а красный был машиной: сам замер сцены чувствительнее
+к нагрузке, чем зонд. Красным он оставался и внутри `check:full` на тихой машине — просто потому,
+что к сцене `perf` команда уже минут пять гоняет сборку, семь маршрутов с axe и восемь сцен.
+
+Починен ИНСТРУМЕНТ, а не порог: сцена делает пять заходов и берёт МЕДИАНУ вместо одного захода,
+делённого на длину строки. Величина та же — миллисекунды на клавишу, — порог остался 60, и после
+правки та же сцена в том же `check:full` печатает **36 мс (из 30·35·36·37·48)**. Считаю это
+законной границей правила «гейты не подгонять под зелень»: подгонка — это когда двигают порог или
+выкидывают проверку; здесь заменён шумный способ снять величину, и заменён с числами на руках.
+
+#### 6. Гейты на сдаче
+
+`npm run check` — зелёный, **279 тестов** (было 160). Состав прироста назван честно: 106 из 119
+новых случаев — это ОДИН параметризованный свип языка по файлам зоны (по случаю на файл), остальные
+13 — тесты слоя данных, каталога и подстановки. `npm run check:full` — 7 маршрутов, **9 сценариев,
+88 проверок**, ноль блокирующих нарушений axe (включая три зум-шага), драг панели p90 17 мс.
+Оба гейта проверены живым нарушением: ESLint роняет и `title="Настройки"`, и `title="Settings"`
+(правило про МЕСТО, а не про алфавит); сторож языка ловит русский комментарий в `api/revision.ts`.
+
+### 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` у подсказки поля** | подсказка в форме добавления книги была голым `` | `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`. Ширины считались от «устоявшейся» ширины контейнера, но результат попадал в
+коллекцию через ``, а библиотека кэширует отрисованные колонки по объекту столбца
+(`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.
+
diff --git a/frontend/docs/frontend-PROGRESS.md b/frontend/docs/frontend-PROGRESS.md
index 45afe7f1..8463d508 100644
--- a/frontend/docs/frontend-PROGRESS.md
+++ b/frontend/docs/frontend-PROGRESS.md
@@ -430,1973 +430,7 @@ NDJSON — это шов ДВИЖОК↔ПЛАТФОРМА (D39.85), а фрон
**Поправки к записи S4 (чужой текст не редактирую):** «словарь платформы — четыре значения» → в коде ПЯТЬ (пропущен `schema_mismatch`) · «одна из трёх фраз сегодня недостижима» → недостижимы ВСЕ ТРИ: платформа `reject_reason` вообще не проецирует (`v0.go:497` «never projected») — доезжает только ветка неизвестного · §1/§2 записи несут снятое правило PD-172 «поле после файла = 400», которое сама же §9а опровергла (код и спека исправлены, текст записи — нет) · «136 проверок» = 134 (наивный греп ловил 2 строки vite) · «31 строка DOM / 59 618px» — замер S2 04.08, не этого пака · «46 находок → 6 выжило» = 5 различных (одна — дубль) · три поправки к записи S3.7 из заказа §6: разобрана только цена бандла; «дрейф ширин hidden» и «счёт 106 из 119» остались на записи оркестратора 14.08 (носитель там, дефекта сессии нет — фиксирую для полноты).
-### 14.08 — девятая фронт-сессия (S4): загрузка книги, запуск прогона, библиотека на масштабе, контракт 0.2.3
-
-Вход: промт `S4_SESSION_PROMPT.md` (семь задач). Дом прежний — мир моков по контракту; живого стенда
-платформы не поднимала (§10 промта — опция, не гейт), и это отдельной строкой в «чего НЕ сделала».
-
-#### 1. Контракт 0.2.3 — пять правок в зонной копии
-
-`info.version` 0.2.2 → **0.2.3**, `npm run contract` (spectral, порог warn) зелёный, типы
-перегенерены (`npm run contract:types`), тест дрейфа держит равенство спеки и `schema.ts`.
-
-| Правка | Что записано | Чем грунтовано |
-|---|---|---|
-| **PD-172** | у `createBook` — часть `file` идёт ПОСЛЕДНЕЙ, поле после файла = 400; причина одной строкой (платформа читает форму потоково и обязана увидеть языки до тела) | `platform/internal/httpapi/v0.go:311-378` — потоковый `MultipartReader`, ветка «языки пусты на приходе файла → 400» |
-| **PD-173** | новая схема `RejectReason` (`source_unreadable` · `not_configured` · `parser_unavailable`) и **необязательное** `Book.reject_reason` | `platform/internal/books/parse.go:51-66` — те же три имени + четвёртое `storage_unavailable`, которое на книге не хранится вовсе |
-| **PD-174** | названы классы, которые провод уже даёт: **404** на `POST /books` у инстанса без интейка, **503** у `resume` на деплое без маркер-команды/шаблона потолка | 404 — `v0.go:72-77` (маршрут не монтируется при `Intake == nil`); 503 — `reconcile.go:715-722` зовёт `s.runnable()`, а `v0.go:540-547` мапит его ошибки в 503 общей для старта и resume функцией `fail` |
-| **PD-180** | описание `createBook` честное: **201 несёт `parsing`**, `uploading` наблюдаем только параллельным чтением библиотеки; перечень отказов — 400 (>16 частей, поле >1 КиБ, поле после файла, нет файла), 404, 408, 413 (числа порогов в спеку не зашиты — они принадлежат деплою) | `books.go:110-180`: строка книги пишется ДО тела (оттого `uploading` виден вторым чтением), а ответ формируется после `StartParsing`, то есть уже в `parsing`; пороги — `v0.go:296-302`, 408 — `v0.go:410-417` |
-| **`BookIntake.title`** | необязательное поле: пусто/нет = «название даст разбор» (сегодня платформа берёт имя файла), заполнено = задано рукой и разбор не перепишет | `books.go:136` `titleFrom(in.Filename)`; ратификация — оркестратор 14.08 (исполнение замечания 12 S3.5) |
-
-**Расхождение с промтом, названное вслух (код первичен).** Промт описывает enum PD-173 как
-«словарь платформы из трёх значений». Проверка по коду: значений в словаре платформы **четыре**, а
-на книгу сегодня попадают **два**. `storage_unavailable` не хранится никогда (комментарий
-`parse.go:62-65`), `not_configured` в `books.reject_reason` не доходит тоже — `defer_` для него
-никогда не терминален (`parse.go:180-205`, `waitsForTheDeployment`), книга остаётся в `parsing` и
-ждёт человека. В спеку внесены все три имени промта: enum — это словарь ВЕРСИИ, клиент обязан
-терпеть незнакомое значение, а `not_configured` — состояние, которое платформа уже умеет назвать и
-которое станет терминальным ровно в тот день, когда владелец контракта решит, что упавшая на
-деплой книга должна умирать, а не ждать. Фраза для него написана, и это цена, которую я назвала:
-одна из трёх фраз сегодня недостижима на живой платформе.
-
-**`reject_reason` сделан необязательным, а не required+nullable, как `Run.paused_reason`.** Причина
-записана в самой спеке: причина отказа осмысленна ровно в одном состоянии из одиннадцати, а деплой
-старше этого минора не пришлёт её вовсе — значит «поля нет» и «поле `null`» означают ОДНО И ТО ЖЕ
-(«причина неизвестна») и рисуются одинаково. Это противоположность случая `sense` (0.2.2), где две
-формы несли РАЗНЫЕ факты; прецедент внутри той же спеки — `Usage.paused_reason`.
-
-#### 2. Загрузка книги (Ф-26, половина) — механизм и почему он такой
-
-- **XHR, а не `fetch`, и это не вкус.** Стандарт Fetch отдаёт прогресс ОТВЕТА и не имеет
- эквивалента для тела запроса; единственный стандартный способ следить за отправкой — тело-поток
- с `duplex: 'half'`, он только HTTP/2 и только Chromium, то есть на Firefox и Safari загрузка бы
- просто не работала. `XMLHttpRequest.upload` — совместимый механизм, и он легален ровно в одном
- месте: сетевой гейт ESLint пускает его только в `src/api/`. Шов не протёк: экран получает промис
- и поток чисел (`src/api/upload.ts`).
-- **Порядок частей формы — правило провода**, а не привычка клиента: `title · source_lang ·
- target_lang · genre · file`. Держится с двух сторон — тест сверяет ключи формы, которые ушли на
- провод, а фикстура ОТКАЗЫВАЕТ форме, где файл не последний (та же проверка, что у платформы).
-- **Три состояния отправки**, и первое из них — измеренная неожиданность. В браузере мок-сеть это
- service worker, а Chromium **не сообщает прогресс отправки для запроса, который отвечает
- воркер**: проба напечатала `loadstart` с верным total (`0 / 300379`) и НИ ОДНОГО `progress`
- после. Поэтому экран не рисует долю, которой нет: «Файл отправляется: 300 кБ» без процента.
- Доля и вторая фаза («файл ушёл целиком, ждём ответа») живут для настоящей платформы и доказаны
- тестом `src/api/upload.test.ts` — там мок перехватывает сам `XMLHttpRequest` и события шлёт.
-- **Подтверждение видимое** (§3.2): после 201 окно показывает карточку из полей КОНТРАКТА —
- название, языки, знаки, состояние («разбор»), — и `chapter_count` в ней намеренно нет: до конца
- разбора он ноль, и печатать его значило бы ответить на «сколько разделов» неправдой.
-- **Отказы — состояния формы, не алерты**: фраза берётся из `problem+json` платформы (контракт
- кладёт слова на сервер), а СОВЕТ пишет клиент, потому что провод его не несёт и он разный:
- «проверьте файл» ≠ «повторите позже» ≠ «этот сервис книги не принимает».
-
-#### 3. Запуск прогона (остаток строки 126)
-
-Форма читает `GET /books/{id}/run-options` при ОТКРЫТИИ (потолок принадлежит аккаунту и уезжает,
-пока книга стоит), шкала строится из `CeilingBounds` в ГЛАВАХ, предустановка — `default_chapters`
-платформы. Клиент не клампит второй раз. `max_chapters: 0` — не пустая шкала, а честное
-исчерпанное состояние. `409` на старте перечитывает bounds, и выбранное значение возвращается к
-новой предустановке ВО ВРЕМЯ РЕНДЕРА, а не размонтированием формы: размонтировав, я бы убрала с
-экрана ту самую фразу отказа, ради которой всё и затевалось. Галочка «остановиться на подписи
-банка» — параметр ЭТОГО запуска. ⚠ **По умолчанию ВЫКЛЮЧЕНА, и это решение про сегодня, а не про
-продукт** (нашло адверсариальное ревью): с включённой галочкой прогон доходит до `awaiting_bank` — и
-дальше в этой сборке идти НЕКУДА: экран подписи это S5, у чтения банка вообще нет канала (Ф-43), а
-`resume` отвечает 409, пока набор решений неполон. Предустановить её значило бы предустановить
-тупик. Сама галочка остаётся — выбор принадлежит человеку и этому прогону (владелец, 02.08), — а
-дефолт вернётся в тот день, когда S5 даст остановке куда идти.
-
-**`paused` прожит, и оповещение — НЕ тост.** Решение и аргумент: тост — временный носитель
-постоянного факта, он исчезает, а состояние остаётся; на десктопном однооконном экране статус-полоса
-и карточка книги видны всегда; §3.8 запрещает экрану выглядеть тревожным, а всплывающее окно — самая
-тревожная из форм. Поэтому остановка называется там, где стоит действие: фраза владельца в
-статус-полосе И выноской на карточке книги, и обе не исчезают. Кадр `EventCeiling` + `status:
-paused` в мире моков прожит целиком (сцена `intake`). `resume` как лекарство не предлагается нигде;
-путь вперёд — НОВЫЙ прогон со своим потолком, и он на карточке есть.
-
-#### 4. Библиотека на масштабе
-
-- **Группировка по сотням** (хвост Ф-12): дерево свыше 200 разделов складывается в группы по 100
- («разделы 1–100»), 2284 раздела дают 23 строки. Аргумент — не кадр в секунду (плоское дерево
- виртуализовано и стоит 31 строку в DOM), а полоса прокрутки: 59 618px хода и треть пикселя на
- строку. Группа с выбранным разделом раскрывается сама (переход из палитры не должен терять
- строку) и остаётся закрываемой рукой — раскрытие стало УПРАВЛЯЕМЫМ (`ui/Tree.tsx`).
-- **Выбор книги в дереве построен** (§2 промта зоны — «клик по книге открывает её состояние»). До
- S4 карточка всегда показывала `books[0]`, и половина статусов была недостижима на экране в
- принципе. Побочный эффект найден axe в первой же сцене: строка книги теперь БЫВАЕТ выбранной, и
- правило `[data-selected] .badge`, снятое в S3.7 как мёртвое, ожило — бейдж на синем полотне давал
- 3.52:1 при пороге 4.5, а тон-глиф книги 1.7:1 при пороге 3. Оба перекрашены, сторож контраста
- выбранной строки теперь гоняется и на строке КНИГИ.
-- **Все одиннадцать `BookStatus` прожиты**: в дереве — словом (фикстура держит книгу каждого
- состояния), на карточке — те три, у которых есть что сказать сверх слова (`uploading`, `parsing`,
- `rejected` с причиной и советом, `paused` с фразой владельца); проверено сценой `context`.
-
-#### 5. Дыра, которую нашла постройка: конца интейка никто не объявляет
-
-Живой канал принадлежит ПРОГОНУ, а книга в `uploading`/`parsing` прогона не имеет — значит «разбор
-кончился» не приходит ничем. Без лечения книга висела бы в «разборе» до случайной
-инвалидации. Сделано: опрос ровно на время интейка (`intakePollMs = 3000`, останавливается вместе
-со статусом) плюс перечитывание ДЕРЕВА на выходе из интейка (`useIntakeEnd.ts`) — иначе список
-разделов, прочитанный когда разделов не было, так и оставался пустым (поймано сценой, не
-рассуждением). Это лечение, а не решение: правильным был бы кадр от контракта — **Ф-56**.
-
-⚠ Названная цена опроса на фикстуре: в мире `showcase` книга `bk_11` стоит в `uploading` вечно (она
-там ради того, чтобы состояние было видно на экране), поэтому библиотека на этом маршруте
-опрашивается каждые три секунды бесконечно. На живой платформе так не бывает — брошенную загрузку
-подметает свип через час (`books.UploadGrace`), — но фикстура этого не моделирует, и знать об этом
-надо тому, кто будет мерить на `/showcase` что-нибудь чувствительное к сети.
-
-#### 6. Диспозиции находок приёмки S3.7 — все девять несущих
-
-| № | Диспозиция |
-|---|---|
-| 1 (high) дубль подстановки строк | **починено.** `scripts/scenes.mjs` больше не держит своего филлера: `say()` зовёт тот же `src/i18n/fill.ts`, что и приложение (харнесс уже умеет грузить `.ts`). Семантика пропуска стала одна |
-| 2 отметка «перечитывание в пути» ставится без старта чтения | **починено, и дефект оказался хуже описанного.** Отметка снимается ровно тогда, когда кончается чтение, за которое она стоит (`resetQueries().finally`). Настоящая цена прежней версии: чтение, которое ПРОВАЛИЛОСЬ, оставляло запись пустой — и ключ замолкал до конца прогона. Тест `a key whose re-read failed is not silenced for the rest of the run` падает на до-фиксном коде |
-| 3 `onResync` не чистит `asked` | **починено:** отметки уходят вместе со снимками. Тест написан так, чтобы ловить дефект В ОКНЕ (чтение задержано на 120 мс, кадр приходит, пока перечитывание в полёте) — с быстрым моком он зеленел бы и на дефекте |
-| 4 клейм «resync не рвёт живой поток» | **клейм ОПРОВЕРГНУТ замером — S3.7 была неправа.** С задержанным ответом (120 мс) поток открывался ДВАЖДЫ: id прогона лежит внутри карточки книги, а reset её опустошает, и подписка снималась на время одного чтения. Починено удержанием id на время книги (`useRunStream`), тест инструментирован задержкой и падает на до-фиксном коде |
-| 5 сцена `hidden`: прекондиция не ассертится, сторож дифференциальный | **починено тремя проверками вместо одной:** прекондиция «банк ещё не пришёл» ассертится, «таблица вообще нарисована» (4 столбца, 608px) проверяется, «столбцы по содержимому, а не равными долями» — тоже; дифференциальное сравнение осталось четвёртым |
-| 6 дырка ESLint-гейта строк | **починено, и шире находки.** Гейт знает НОСИТЕЛИ: `??`, тернарник и шаблон — и в читаемом атрибуте, и как ребёнок элемента (`{'слово'}
` не ловился вовсе). Проверено живым нарушением на всех четырёх формах; живой экземпляр `Showcase.tsx` (`?? 'TextMachine'`) переехал в каталог. ⚠ Тем же ходом СУЖЕНО правило про `style` в объектном литерале — оно ловило `{ style: 'unit' }` у `Intl.NumberFormat`; сужение точечное (значение-строка React как стиль отвергает: «expects a mapping … not a string»), носители-объекты/переменные/шаблоны ловятся по-прежнему, проверено живым нарушением |
-| 7 perf-оседание может проходить вакуумно | **починено, и магические паузы убраны совсем:** раунд начинается от таблицы, которая УСТАКАНИЛАСЬ (`rowsSettled`), и число строк для сравнения меряется в этом же раунде — прежнее бралось до прокрутки, а виртуализатор держит в DOM разное число строк в разных местах списка |
-| 8 zoom-ассерт «в ряд» не запрещает стопку | **починено наполовину, и половина названа.** Сравнение стало СТРОГИМ (`left > предыдущего left`) — стопка теперь падает. Сильную форму («панель начинается там, где кончается предыдущая») гейтом не делаю: с 125% центр уже наезжает на правую панель — это Ф-54, вопрос плотности на владельце (В-7), и красный по построению гейт учит пропускать команду. Число печатается, как и печаталось |
-| 9 кадр `status` не перечитывает список глав | **починено:** кадр статуса перечитывает и список глав, и библиотеку. Второе — моя находка сверх списка: бейдж в дереве (главный носитель состояния) продолжал говорить «в очереди» под прогоном, который уже остановился; увидела на кадре потолочного стопа. Оба теста падают на до-фиксном коде |
-
-**Минорные** (из свода приёмки): свип языка не мёл `package.json` и безрасширенный
-`scripts/githooks/pre-commit` — **починено**, оба в списке, проверено живым нарушением (русский
-комментарий в хуке роняет тест) · гейт вызовов каталога держался на имени переменной `text` —
-**починено**, регексп ловит любой вызов вида `f('ключ', {…})`, а ложное срабатывание невозможно по
-построению (ключ не из каталога пропускается); проверено живым нарушением с переменной по имени
-`say` · шапка `ru.ts` ссылалась на несуществующий `src/i18n.test.ts` — **починено** · perf:
-удлинение запроса занижает мс/клавишу — **знаю, не трогала**: запрос берётся из фикстуры целым
-термином, и менять его длину сейчас значит менять величину, которую сравниваю с прошлым паком ·
-защёлка флага съёмки (окно 150 мс) — **не трогала без замера**, как и просил свод.
-
-#### 7. Гигиена доков и арбитраж двух чисел ЗАМЕРОМ
-
-- `FRONTEND_PLAN.md`: «платформа = ноль строк кода» → P5 принята (D39.130); таблица чтения больше
- не подаёт строки 95/99/100/103 как «чего нет» и не шлёт в `API_CONTRACT_INPUT.md` как в живой
- вход (он под баннером «исполнено») — вместо него контракт; ссылка на удалённый `src/api/types.ts`
- заменена на то, где состояние книги живёт сегодня (`src/api/vocabulary.ts`, одна запись).
-- `STACK_DECISIONS.md`: тулчейн платформы **1.26.6** (сверено по `platform/Makefile:19`), состав
- `npm run check` приведён к ШЕСТИ шагам по `package.json` — промт §7 называл семь, и первая
- редакция моей правки повторила его число; посчитано командой, а не переписано.
-- `FRONTEND_SESSION_PROMPT.md:62`: «скелет P0 ждёт приёмки» → P5 принята и залендена.
-- `frontend/README.md`: зонная копия спеки больше не «черновик на ратификацию».
-- **Арбитраж (замер на дереве ДО пака).** Ключей каталога — `node -e "import('./src/i18n/ru.ts')…"`
- → **157**: правы Ф-35 и живой `ru.ts`, «147» записи S3.7 неверно. Цена бандла — `npx vite build`
- → главный чанк **724130 байт**: права ЗАПИСЬ S3.7 (+7999 от 716131), а «723102 (+6971)» строки
- Ф-35 неверно. Живые носители (Ф-35, Ф-18) приведены к замеру; записи хроники не правлены — это
- попутка, как и требует промт.
-
-#### 8. Заведённые строки и вопросы
-
-Ф-56 (нет кадра о конце интейка — вылечено опросом) · Ф-57 (какие пары языков продукт принимает —
-контракт не говорит, форма предлагает свой список) · Ф-58 (RTL не проверен, триггер наступил) ·
-Ф-59 (спойлер достаётся поиском по странице — ЗАМЕРЕНО) · Ф-60 (канвас-замер не знает `lang`) ·
-Ф-61 (платформа отвечает по-английски в русском интерфейсе — у контракта нет ни `Accept-Language`,
-ни машинного кода отказа) · **Ф-62** (переименовать книгу нечем: у книги на всей поверхности
-контракта нет ни одной записи — нашло ревью на обещании «поправить позже», обещание снято) ·
-**Ф-63** (рамка поля на модальной поверхности 1.20:1 при пороге 1.4.11 — тот же токен несёт рамки
-всей оболочки, поэтому перекраска это вид, а вид принимает владелец). Владельцу: **В-10** (спойлер —
-защита или вежливость) и **В-11** (фразы PD-173 на утверждение). Ф-52 закрыта замером и гейтом,
-Ф-42 закрыта решением по замеру, Ф-12 и Ф-26 — наполовину.
-
-#### 8а. Фразы PD-173 — отдельным списком на утверждение владельцем
-
-Промт (§2) просит вынести их отдельно. Написаны по РЕАЛЬНОМУ флоу отказов (прочитан
-`platform/internal/books/parse.go` read-only), в границах ПТ-33 — ни стадий, ни моделей, ни слова
-«парсер»/«манифест» — и без тревожного тона (§3.8). Разное следующее действие — разные фразы.
-
-| Машинная причина | Фраза | Совет (следующее действие) |
-|---|---|---|
-| `source_unreadable` | Файл не удалось разобрать на разделы | Проверьте файл — возможно, это не текст книги — и добавьте её заново. |
-| `not_configured` | Сервис пока не готов принять эту книгу | Файл здесь ни при чём: повторная загрузка поможет не раньше, чем мы это наладим. |
-| `parser_unavailable` | Не удалось обработать файл на нашей стороне | Файл здесь ни при чём: попробуйте добавить книгу позже. |
-| причина неизвестна (ветка неизвестного) | Книгу не удалось принять | Причина не названа. Попробуйте добавить книгу заново или позже. |
-
-Почему так: `source_unreadable` — движок прочитал файл и отказался (или не нашёл в нём ни одного
-раздела), исходник при этом УДАЛЯЕТСЯ и пере-разбора в контракте нет, поэтому единственное честное
-действие — добавить книгу заново. `parser_unavailable` — движок не удалось ЗАПУСТИТЬ, файл цел, но
-дотянуться до него нечем: повтор позже осмыслен. `not_configured` — деплою нечем разбирать книгу,
-и повтор сам по себе не поможет; ⚠ на сегодняшней платформе эта причина на отклонённую книгу не
-попадает вовсе (в записи выше), то есть фраза написана впрок. Ветка неизвестного не обвиняет ни
-файл, ни сервис — она не знает, кто виноват.
-
-#### 9. Адверсариальное ревью диффа (author≠reviewer) — механизмом
-
-Пять независимых линз по диффу (контракт · корректность клиента · продуктовые правила и доступность
-· гейты и тесты · фикстура и шов), на КАЖДУЮ находку — отдельный скептик с установкой ОПРОВЕРГАТЬ и
-требованием проверять исполнением, а не рассуждением. **44 находки, 49 агентов, 14 выжило.**
-Скептики гоняли vitest и рендерили компоненты сами — в отчётах ниже это видно по формулировкам
-«reproduced by rendering», и это ровно то, чего требует D39.129.
-
-⚠ **Честная оговорка о методе:** ревью шло по ЖИВОМУ дереву, пока я в нём работала, поэтому часть
-«опровергнутых» — это находки, верные в момент подачи и починенные мной до того, как до них дошёл
-скептик (порядок, счёт знаков, преждевременные тотали, 404 на старте, версия рукопожатия). В
-следующий раз ревью надо гонять по замороженному дереву, иначе «опровергнуто» смешивает два
-разных исхода. Ниже — по существу, а не по ярлыку воркфлоу.
-
-| Находка | Диспозиция |
-|---|---|
-| **Плейсхолдер названия обещает разбор, которого платформа не делает** (`parsedTitle` менял `_-` на пробелы, а `titleFrom` платформы срезает только расширение) | **принято, починено.** Скептик проверил ДВУМЯ прогонами — нашим `vitest` и `go test` платформы, где табличный случай прямо фиксирует, что дефис переживает `titleFrom`. Клиент теперь предсказывает ровно то, что делает сервер |
-| **Любой 409 на старте трактовался как «потолок уехал»** — платформа отвечает им ещё на четыре причины (прогон уже идёт, книга не готова, нет кредита) | **принято, починено:** совет стал причинно-нейтральным, а перечитываются ТЕПЕРЬ ОБА чтения — и шкала, и карточка книги (устаревшая карточка и была второй половиной дефекта). Воспроизведено скептиком рендером с реальным телом `problem+json` платформы |
-| **`useIntakeEnd` срабатывал на СМЕНУ книги** и выбрасывал список глав только что открытой | **принято, починено:** «переход» считается только внутри ОДНОЙ книги (в ref лежит пара «книга + состояние»). Воспроизведено рендером |
-| **`runOptionsQuery` наследовал общий `staleTime` 15 с** — переоткрытие формы в этом окне отдавало кэшированные bounds | **принято, починено:** `staleTime: 0`. Это ровно то, ради чего bounds — отдельный ресурс: максимум принадлежит АККАУНТУ и уезжает, пока книга стоит |
-| **Авто-раскрытие открывало ГРУППУ, но не саму книгу** — прыжок из палитры в свёрнутую книгу оставлял строку невидимой | **принято, починено:** книга открывается вместе с группой |
-| **`useRunStream` отдавал состояние связи ПРЕДЫДУЩЕЙ книги** на первый кадр после смены | **принято, починено:** при смене книги состояние сбрасывается в `connecting` |
-| **Строки групп кликались и не делали ничего** | **принято, починено:** клик по строке группы её сворачивает и разворачивает — то, что делает клик по папке в любом дереве |
-| **Шкала потолка объявляет голое число, подсказка не привязана** | **принято наполовину, замерено.** Подсказка привязана (`aria-describedby` теперь доезжает до инпута — проба в браузере до и после). Единицу в `aria-valuetext` подставить НЕЛЬЗЯ: библиотека составляет его сама из значения, переданный проп до инпута не доходит (замер). Цену назвала в коде: единицу несёт `SliderOutput`, а он живая область (`role="status"`) и читается на каждое изменение |
-| **Проверка «фраза платформы» в тесте 413 проходила при ОТСУТСТВИИ тела** (`undefined !== ''`) | **принято, починено:** проверяется непустая СТРОКА |
-| **Сцена `refusals` проверяла отсутствие фразы, недостижимой на этом пути** — не могла упасть | **принято, переписано:** теперь проверяется отсутствие СОБСТВЕННОЙ фразы клиента для этого класса (она достижима — ею клиент отвечает, когда тела нет), то есть проверка ловит подмену. ⚠ И тем же ходом нашлось второе: фраза фикстуры для 408 была ПОБУКВЕННО равна фразе клиента, из-за чего проверка была слепа — фикстура заговорила своими словами |
-| **Клавиатурная проверка Select утверждала то, что верно до нажатия клавиш** | **принято, починено:** сравнивается ИЗМЕНЕНИЕ значения |
-| **Список читаемых атрибутов гейта строк не знал `valueLabel`** — текстового пропа обоих новых примитивов | **принято, список расширен** (`valueLabel`, `aria-valuetext`) |
-| **`rowsSettled` мог принять промежуточное плато за устаканенную таблицу** | **принято:** нужны ТРИ одинаковых замера подряд, не два |
-| **Порог 3:1 сравнивался после округления** — 2.995 прошло бы как 3 | **принято** (формально опровергнуто «сегодня такого токена нет», но дыра реальна): сравнение идёт по замеренному числу |
-
-**Найдено ревью и починено ДО вердикта скептика** (то есть в «опровергнутых» по причине «уже не
-воспроизводится»): фикстура отдавала библиотеку от старых к новым, а платформа — от новых к старым
-(`order by added_at desc`), и только что загруженная книга уезжала вниз · `character_count` считался
-БАЙТАМИ, а платформа считает код-пойнты (`counter.Write` считает ведущие байты UTF-8) · книга без
-прогона получала ненулевые тотали юнитов, и карточка печатала «Разделов 0 · Блоков 12» · старт
-прогона отвечал 404 на четырёх из пяти запускаемых книг витрины (фикстура отдавала только заранее
-записанный прогон — теперь старт СОЗДАЁТ прогон, как на платформе) · счётчики глав не двигались в
-мире интейка, пока счётчик книги бежал к концу (теперь мир отдаёт кадр `chapter`, и чтение с ним
-согласовано) · рукопожатие фикстуры объявляло 0.2.2 после бампа спеки до 0.2.3 — **и это теперь
-заперто тестом**, потому что клиент сверяет только МАЖОР и молчал бы дальше · правило длины поля
-считало UTF-16-единицы вместо байтов · живые области для чтения с экрана, цель чекбокса 18px и его
-рамка 1.20:1 о модальную поверхность (последняя — Ф-63, потому что тот же токен несёт рамки всей
-оболочки) · обещание «название можно поправить позже» при отсутствии в контракте хоть одной записи
-о книге (Ф-62).
-
-**Опровергнуто и НЕ менялось** (примеры): «спека утверждает про `BookIntake.title` то, чего у
-платформы нет» — так и задумано, это ратифицированная правка, а платформа догоняет; «`not_configured`
-недостижим» — назван мной самой в записи и в спеке, значение словаря версии; «сужение правила
-`style` освобождает любую строку» — React строковый `style` отвергает, носители-объекты ловятся;
-«английские фразы платформы в русском интерфейсе» — контракт кладёт слово на сервер, а расхождение
-заведено строкой Ф-61, а не залатано вторым носителем на клиенте.
-
-#### 9а. Второй проход ревью — по осям, которых не было в первом (норма кода · вода · велосипеды · соответствие заданию · ошибки самого задания)
-
-Первый проход (§9) смотрел контракт, корректность клиента, продуктовые правила, гейты и фикстуру.
-Осей, которые владелец назвал прямо — «промышленные стандарты, без хаков и велосипедов, без воды в
-коде», — и оси «сделано ли ровно то, о чём просили, с поправкой на то, что промт писала нейросеть» —
-в нём НЕ БЫЛО. Второй проход закрывает эту дыру: пять линз (нормы §5.1 · вода · велосипеды ·
-соответствие заданию · верность самого задания), скептик на каждую находку, агентам ЗАПРЕЩЕНО писать
-в репозиторий (в первом проходе один агент оставил правку в моём файле — поймано снимком дерева;
-здесь снимок сверен после прогона: дерево тронуто только мной). **46 находок, 6 выжило.**
-
-| Находка | Диспозиция |
-|---|---|
-| **(ошибка ЗАДАНИЯ, high) «поле после файла = 400» — неправда.** Промт §2 (PD-172) и §2 (PD-180) так говорят, я перенесла это в спеку 0.2.3 и в фикстуру | **принято, исправлено во всех трёх местах.** По коду платформы (`httpapi/v0.go:352-361`) читатель ОСТАНАВЛИВАЕТСЯ на файле: часть после файла не читается вовсе — обязательная (языки) даёт 400 «как будто её не слали», необязательная (жанр) молча теряется, и загрузка проходит. Моя фикстура отказывала форме с хвостовым `genre` — то есть отказывала ЗАКОННОМУ запросу. Спека переписана точно, фикстура моделирует поток, добавлены два теста: обязательное поле за файлом = 400, необязательное = 201 без него |
-| **(ошибка ЗАДАНИЯ, low) §7 велит починить число, которое само неверно:** «`npm run check` — 4 шага против нынешних 7» | **принято.** Шагов **шесть** (посчитано `node -e` по `scripts.check`), и первая редакция моей правки повторила «семь» из промта — то есть я занесла свежую неправду в живой док. Исправлено в `STACK_DECISIONS.md` и в записи |
-| **(medium) Дерево узнавало строку-складку, РАЗБИРАЯ id** (`/:\d+$/`) | **принято, переписано.** Контракт: «идентификатор непрозрачен, клиент НЕ ДОЛЖЕН его разбирать», а движок уже строит ключи вида `<глава>:<срез>:<индекс>`, под этот шаблон подходящие. Теперь складка узнаётся по ПРИНАДЛЕЖНОСТИ к множеству, которое этот же файл и построил. ⚠ И первая редакция фикса была неверна — множеством стали ВСЕ дети книги, то есть на плоском дереве складкой оказалась каждая глава; поймала батарея сцен (`tabs`: двойной клик перестал закреплять вкладку), а не рассуждение |
-| **(medium) Ветка 409 не показана ни сценой, ни кадром, ни тестом** — при том что §11 требует показать каждую | **принято, построено.** Фикстура двигает потолок ОДИН раз, ровно как описывает контракт («холд по другой книге снижает остаток между чтением и вызовом»), поэтому первое нажатие «Перевести» получает 409 — единственный отказ, до которого доходит корректный клиент на корректной форме. Сцена `intake` теперь проверяет: фраза платформы на экране, наша не подставлена, шкала перечитана и стоит на новых bounds; второе нажатие запускает прогон |
-| **(medium) Правка `STACK_DECISIONS` повторила ошибочное число** | см. вторую строку — то же исправление |
-| **(low) Мёртвый элемент в списке авто-раскрытия** (`openBookId` дважды, второй под тернарником) | **принято, убрано** |
-
-**Найдено ревью и починено, хотя скептик снял** (не «опровергнуто по существу», а «уже не
-воспроизводится» либо «не этой сессии код», а дефект настоящий): выбор ТОГО ЖЕ файла второй раз не
-поднимал событие `change` — вход теперь очищается после чтения, иначе отказ оставался на экране под
-только что перевыбранным файлом · арифметика контраста в харнессе сцен округляла ДО сравнения, то
-есть имела ровно ту дыру, которую я закрыла в токен-гейте.
-
-**Опровергнуто по существу, и это тоже результат** (примеры с грунтом скептика): «AddBook 298 строк
-и шесть компонентов» — норма мягкая («~150», приёмка глазами), компонент один плюс три вида его же
-состояний и два чистых помощника, и файл в ряду зоны не выбивается · «состояние книги решается
-литералами в экране, контрольный вопрос провален» — ратифицированное чтение вопроса (компаньон
-контракта §«новое продуктовое состояние») требует ОДНОГО файла для карты «статус → вид», и он один,
-компилятор его и держит · «карта отказов написана трижды» — таблицы двух операций не пересекаются ни
-одной строкой и повторяют перечни ответов из спеки, слияние было бы контрактной ошибкой ·
-«файловый вход — велосипед, у библиотеки есть `FileTrigger`» — скрытый вход приехал из S3.7 и принят,
-а норма зоны запрещает импорт примитивов вне `src/ui/` · «сужение гейта `style` — подгонка» — обе
-формы регистра Ф-9 по-прежнему падают, порог не двигался, а сужение объявлено в зонном журнале,
-который и есть канал пингов фронта.
-
-⚠ **Флейк `perf`, названный числом.** В полной батарее сцена показала 63 мс/клавишу при пороге 60 и
-уронила команду; та же сцена в одиночку — 38 мс (34·36·38·38·51). Причина видна в `ps`: параллельные
-сессии зоны полигона и платформы держали `load average` около 8–13 (их питон и `go test`). Порог не
-трогала — S3.7 уже заменила шумный способ снятия величины на медиану пяти заходов, а двигать порог
-под чужую нагрузку было бы ровно той подгонкой, которую норма запрещает. На тихой машине (`load` 2.4)
-`npm run check:full` — **EXIT=0**, 335 тестов, 136 проверок, 11 сценариев, 8 маршрутов.
-
-#### 10. Чего я НЕ сделала
-
-- **Живого стенда платформы не поднимала** и smoke `POST /books` через dev-прокси не гоняла (§10 —
- опция, не гейт). Значит всё, что сказано про поведение НАСТОЯЩЕЙ платформы, — из её кода и из
- контракта, а не из прогона: сюда попадают определённая доля отправки, вторая фаза «файл ушёл» и
- фразы `problem+json` (Ф-61).
-- **Отмена отправки на середине не проверена исполнением.** Тест покрывает только уже отменённый
- сигнал: мок-сеть перехватывает запрос в тот же тик, и прервать его тиком позже она не даёт.
- Сам путь — три строки (`signal → xhr.abort()`), но честнее назвать, чем зачесть.
-- **Добавление ГЛАВЫ (§3.10) не строила** — ручки в контракте нет, кнопка без действия запрещена
- нормой зоны. Черновика правки спеки не писала: это не хвост загрузки, а отдельный сценарий, и
- его форму (глава в существующую книгу? пере-разбор?) решать владельцу контракта.
-- **Референса `antigravity_add_folder.png` на диске нет** (папка под .gitignore, как было с
- fleet_2.png): форму добавления книги я НЕ перерисовывала — достроила поля в раскладку S3.5.
-
-
-
-#### 11. Гейты на сдаче
-
-`npm run check` — зелёный, **335 тестов** (было 279). `npm run check:full` — EXIT=0: сборка, **8
-маршрутов** со снимком и axe (добавился `/intake`), **11 сценариев, 136 проверок** (добавились
-`intake` и `refusals`), ноль блокирующих нарушений axe и ноль узлов контраста на всех маршрутах и
-во всех сценах. Числа получены командами `npm run check`, `npm run check:full`, `npm run scenes`.
-
-Живым нарушением проверено (каждый гейт — своим): расширенный гейт строк роняет все четыре новые
-формы (`?? 'Слово'`, тернарник, шаблон, литерал ребёнком элемента) и по-прежнему ловит носители
-инлайн-стиля (объект, переменная) · сужение правила `style` не пропускает ничего, кроме строки ·
-свип языка ловит русский комментарий в безрасширенном `scripts/githooks/pre-commit` · гейт вызовов
-каталога ловит лишнюю переменную при вызове через переменную по имени `say` · порог контраста тонов
-краснеет на прежнем `--color-danger`. Тесты фиксов приёмки (кадр библиотеки, кадр списка глав,
-отметка после провалившегося чтения, отметки после ресинка, поток при медленном перечитывании)
-падают на до-фиксном коде — проверено откатом каждого фикса по очереди.
-
-### 10.08 — приёмка S3.7 оркестратором: ПРИНЯТО и залендено; арбитраж 8.1 — права сессия
-
-Гейты пере-прогнаны исполнением: `npm run check:full` EXIT=0 · vitest **279** · 9 сценариев
-(вывод сценариев теперь английский — свод дошёл и до инструментов) · сцена `hidden` зелёная.
-Ревью 11 агентами (6 линз + скептики, author≠reviewer): **12 находок подтверждено (1 high),
-0 опровергнуто, 16 минорных**; блокеров лендинга нет — носители ниже.
-
-**Арбитраж 8.1 — ПРАВА СЕССИЯ, HIGH приёмки S3.6 снята как ложноположительная.** Вердикт
-арбитражной линзы: в Chromium дефекта не существует — геометрический запрос (`read()`)
-внутри `content-visibility: hidden`-поддерева форсит расчёт раскладки, и замер таблицы в
-скрытой keep-alive вкладке даёт те же ширины, что у видимой (живой прогон сцены `hidden`
-при этой приёмке: `121·122·133·348` = эталону). Ошибка была МОЯ: верификатор S3.6 рассуждал
-от кода, не меряя браузером, и «CONFIRMED» надо было ставить как «PLAUSIBLE до живого
-прогона». Сессия поступила образцово: не поверила приёмке, замерила, сняла свой же
-уже написанный механизм и оставила сторож (Ф-53). Остатки сторожа честны и заведены ниже.
-
-**Поправки к записи S3.7 (сама запись не правлена):**
-
-- **Ложный клейм про `fill.ts` (high):** «заполнение вынесено в `src/i18n/fill.ts`, его
- импортируют и приложение, и сцены» — сцены НЕ импортируют: `scenes.mjs` держит собственный
- инлайн-филлер (`say()`, с ДРУГОЙ семантикой пропуска), и эта строка добавлена самой S3.7.
- Дубль реален, диспозиция находки ревью в записи была ложной.
-- Цена бандла в записи (+7999 байт) противоречит числу в `BACKLOG.md`; ширины сцены `hidden`
- в записи (`…·232`) устарели против дерева (`…·348` — сторож валиден, число дрейфнуло);
- «106 из 119 = один свип» неточно (свип = 100 случаев); `BACKLOG.md` Ф-25 сохранил
- отозванный самой записью клейм «вранья в комментариях не нашлось».
-
-**Находки приёмки — носитель: блок «находки приёмки S3.7» следующего фронт-промта (S4):**
-(1) отметка «перечитывание в пути» ставится без старта чтения и глушит следующие кадры ключа
-(`useRunStream.ts:146`); (2) `onResync` не чистит `asked` — отметки прежней эпохи съедают кадр
-в окне ресинка (`:42`); (3) клейм «resync не рвёт живой поток» принимать только по живому
-инструментированному прогону с задержкой ответа (статика `resetQueries` говорит обратное);
-(4) сцена `hidden`: прекондиция «ушли до прихода банка» не ассертится (гонка с синхронным
-моком) и сторож дифференциальный — симметричная регрессия замера пройдёт; (5) дырка
-ESLint-гейта: вычисленный литерал (`?? 'Word'`, тернарник) в читаемом атрибуте проходит —
-живой экземпляр `Showcase.tsx:134`; (6) perf-оседание может проходить вакуумно (заходы 2–5
-ждут 300мс против конвенции 700); (7) zoom-ассерт «в ряд» не запрещает стопку (сравнивает
-left с left, не с right); (8) кадр `status` не перечитывает список глав. Минорные — свод
-воркфлоу `wf_360f34ea-b32`.
-
-### 10.08 — восьмая фронт-сессия (S3.7): долги слоя данных, контракт 0.2.2, строки в каталог
-
-Вход: промт `S37_SESSION_PROMPT.md` (девять задач) плюс правило владельца, пришедшее по ходу пака:
-**в КОДЕ никакого русского** — комментарии, сообщения ошибок, логи, имена тестов, служебные строки
-сценариев по-английски; русский UI-текст живёт ТОЛЬКО в словаре.
-
-#### 1. Прогон по задачам
-
-| Задача | Что сделано | Тест / замер |
-|---|---|---|
-| **Ф-49** свежесть текста главы | кадр `chapter` инвалидирует юниты ИМЕННО своей главы, кадр `status` — юниты всей книги (границы стадий: пока `units_done` единый счётчик, кадра главы за волну может не быть ни одного) | `useRunStream.test.tsx`, 2 случая по счёту запросов к MSW; оба падают на до-фиксном коде |
-| **Ф-50** потерянный кадр | кадр, не нашедший снимка, зовёт `resetQueries` по своему ключу; ревизия многостраничного списка = МИНИМУМ из страниц | 2 теста, оба падают на до-фиксном коде. **Выбор reset вместо invalidate — замер, а не вкус:** `invalidateQueries` на запросе без данных ничего не делает (в исходнике библиотеки: перезапуск в полёте только при `state.data !== undefined`), то есть возвращает промис того самого устаревшего чтения |
-| **Ф-51** resync | `resetQueries` по скоупу КНИГИ (`bookScope`), отметка ревизии уходит вместе со снимком; чужие скоупы целы | 2 теста, оба падают на до-фиксном коде |
-| **Ф-47** `sense` обязателен | зонная копия `openapi.yaml` → **0.2.2**, правило пустой строки в описании, типы перегенерены, костыль `?? ''` снят | `npm run contract` зелёный; ⚠ костыль был в ОДНОМ месте, а не в трёх — счёт строки бэклога был завышен |
-| **Ф-40** общий модуль поля | `src/ui/Field.module.css` (`.input` + модификатор `.framed`), примитивы остались разными | `cssModules.test.ts` (пары по импортам, сироты) |
-| **Ф-25** язык кода | английские комментарии/тесты/сообщения во ВСЁМ дереве зоны, включая конфиги, `index.html` и python | гейт `src/i18n/catalogue.test.ts`, проверен живым нарушением |
-| **Ф-35** строки интерфейса | каталог `src/i18n/ru.ts` (**157 ключей**), механизм `@internationalized/string` 3.2.10, стор языка с персистом, локаль оттуда же берут `I18nProvider`, `Intl` и `` | гейт ESLint проверен живым нарушением на ДВУХ литералах — русском и английском; цена бандла 716131 → 724130 (+7999 байт, из них ~10 КБ — сам текст каталога, то есть библиотека не добавила ничего) |
-| **сторожа** зум и узкая панель | сцена `zoom` (125/150/200% = вьюпорты 1152/960/720 в CSS-пикселях): перелив окна, три панели стоят в ряд ВНУТРИ окна и по порядку, текст статус-полосы не обрезан, таблица банка нарисована и не за краем, axe на каждом шаге | `npm run scenes zoom` — **18 проверок**; сцена печатает и число, которое НЕ утверждает: обрезку центра (98px при 150%, 170px при 200%) — это Ф-54 |
-| **замер `measure.py`** | палитра S3.6 воспроизведена по `fleet_2.png` (`#181818` 63.97%, `#292929` 7.17%), кадр `/showcase` сведён с `fleet.png` при 1280×764 | числа и вердикты — `FRONTEND_PLAN.md` §5.7; окружение запинено (`scripts/requirements.txt`) |
-
-#### 2. Находки приёмки S3.6
-
-| № | Диспозиция |
-|---|---|
-| 8.1 (HIGH) | **НЕ ВОСПРОИЗВЕЛАСЬ.** Замер в браузере: таблица, смонтированная в скрытой keep-alive вкладке `/scale`, держит 116 ячеек и ширины `121·122·133·232` — те же, что у вкладки, с которой не уходили, и на до-фиксном коде тоже; `content-visibility: hidden` подтверждён на самой панели (`data-inert`, computed `hidden`). Причина: запрос геометрии внутри пропущенного поддерева заставляет браузер посчитать раскладку. Мой первый заход добавил под эту находку `IntersectionObserver` — **механизм снят**, чинить нечего. Сцена `hidden` (уход с вкладки ДО прихода банка и возврат) оставлена сторожем: путь реален и не был покрыт. Строка Ф-53 |
-| 8.2 контраст выбранной строки | починены пары на синем: счётчик замечаний → `--color-text` (7.27:1), значок и дорожка → `--color-text-secondary` (3.52:1), заполнение → `--color-text`. ⚠ Бейдж состояния книги в правило НЕ входит, и первая редакция этой строки врала: правило `[data-selected] .badge` было написано и снято — выбор в дереве контролируется активным документом, поэтому строка КНИГИ выбранной не бывает, и правило было мёртвым. Сторож в сцене `tabs` считает контраст ВНУТРИ страницы и падает на до-фиксном коде четырьмя парами (1.97 · 3.52 · 1.55 · 1.97). ⚠ Названо честно: пара «заполнение ↔ дорожка» даёт 2.07:1 — выше палитрой владельца не поднять, поэтому выбрана та пара, где обе половины читаются на самом фоне |
-| 8.3 сирота в «Замечаниях» | гард поднят в `open`/`pin` самого экрана (одно место вместо двух у зовущих), сирота помечается и когда раздел НАЗВАН, но отсутствует в списке |
-| 8.4 съёмка | (а) флаг не пишется, пока не полетел первый запрос, и защёлка ждёт 150 мс тишины — **замер показал дефект хуже описанного:** `/scale` снимался со строкой «загрузка разделов…», потому что между волнами чтений счётчик честно падает в ноль; (б) `shot.mjs` и `scenes.mjs` ждут доигрывания анимаций перед axe |
-| 8.5 минорные | все девять: кэш канвас-замера запоминает ширину только если шрифт реально доступен (`document.fonts.check`); пин вкладки — только левая кнопка и выделение ВНУТРИ этой главы; `termStatus` больше не носит нерендерящихся слов; три комментария токенов исправлены числами (3.58:1 · `--row-height-term`) и `--color-note` поднят до 3.07:1; `.paused` перестал быть no-op, `.offline` снят; **подпись disabled-кнопки** — противоречие «нетекстового» токена с WCAG разрешено в пользу WCAG, и оговорка написана рядом с самим токеном, а не рядом с кнопкой; сторож обрезки вкладок падает, если заголовок перестал быть `span`; PIL запинен |
-| 8.5 ре-рендер экрана | **замер до/после:** флаг съёмки переехал в лист (``), потому что `useIsFetching` перерисовывал ВЕСЬ экран на каждый старт и финиш запроса. Открытие 12 глав на `/scale`: p90 кадра 133 → 50‥67 мс, длинных кадров 16‥19 → 7‥13, длинных задач 22 (≈2080 мс) → 16 (≈1110 мс) |
-| 8.6 доки | `FRONTEND_PLAN.md` §5.6 поправлен (модель «вырез в хроме» описана как СНЯТАЯ, в коде пилюля), §4 — сценариев девять, команда замера через venv; `README.md` — карта сессий и раздел про язык кода; `BACKLOG.md` Ф-47 — счёт костылей исправлен |
-
-#### 3. Что нашла проверка исполнением, а не рассуждение
-
-- **Каталог печатал `показано {shown} из {total}` буквально.** `@internationalized/string` подставляет
- переменные ТОЛЬКО в скомпилированные функции (прочитано в исходнике библиотеки), а плоскую строку
- отдаёт как есть; ICU-компилятор — это отдельный шаг сборки, от которого стек отказался, когда
- взвешивал lingui. Подстановка `{name}` теперь наша, четыре строки, и на неё стоит тест; поймал
- дефект сценарий `bank`, юнит-батарея его не видела.
-- **Гейт строк сначала был написан по алфавиту** — и это было хуже, чем кажется: одно правило жило
- в двух носителях (селектор ESLint и регексп теста), а перечень букв `ПТ|Ф|В|К|Д` был заплаткой под
- конкретные строки бэклога. Переделано: ESLint ловит текст МЕСТОМ (буква в `JSXText` или в читаемом
- атрибуте) — ловит и русский, и английский литерал, то есть строго сильнее; алфавит остался ровно
- в одном месте и для ДРУГОГО правила («код зоны английский»), где комментарии иначе не проверить.
-- **`/scale` снимался недоделанным** (см. 8.4а) — нашлось при первой же проверке нового флага кадром.
-- **«Переезд строк, а не перевод» — доказано замером, а не обещанием.** Собрал все строки, которые
- печатает экран (текст плюс `title`/`aria-label`/`placeholder`/`alt`), на шести маршрутах, из ДВУХ
- сборок: этой и собранной из `git archive HEAD`. **986 строк, посимвольное совпадение.** Первый
- заход замера показал расхождение и был неправ сам: он собирал текстовые УЗЛЫ, а переезд фразы
- в каталог превращает три узла в один («переведено» · «0» · «из» · «1» → «переведено 0 из 1»);
- сравнивать надо строки, как их читает глаз.
-
-#### 4. Как шла работа
-
-Свод языка и переезд строк — двенадцать параллельных агентов по непересекающимся файлам, каждый
-вернул свои ключи структурой, каталог собран одним местом. Их находки, которые я разобрал руками:
-JSDoc `look` у кнопки описывал три значения из четырёх (дописано), комментарий подвала панели
-ссылался на токен, который стоит не в этом правиле (переписан по коду), комментарий панели цитировал
-замер Fleet рядом с нашим изменившимся токеном (разведено явно).
-
-⚠ **Правка этой же записи по адверсариальному ревью.** Первая её редакция утверждала: «ни одного
-комментария, оказавшегося враньём против кода, свод не нашёл». Это неверно — я написал это по
-`notes` агентов, а по ДИФФУ таких мест минимум три, и все три поправлены молча: `ui/Tabs.tsx:44`
-(«один скролл-контейнер на вкладку» → панель `overflow: hidden`, скроллят списки внутри — переворот
-полярности), `showcase/Reader.module.css:12` (ссылка на `--space-4` при фактическом `--space-3`),
-`showcase/documents.ts:62`. Правильный вывод: свод их нашёл и исправил по коду, а мой отчёт этого
-не назвал — ровно тот класс, из-за которого приёмка требует сверять отчёт с диффом.
-
-#### 4а. Адверсариальное ревью диффа (author≠reviewer) — что оно поменяло
-
-Шесть линз плюс скептик на каждую находку с установкой ОПРОВЕРГАТЬ. Выжившее и его диспозиции:
-
-| Находка ревью | Диспозиция |
-|---|---|
-| **Ф-50 закрыт только для двух ключей:** кадры `note`/`bank`/`ceiling` остались на `invalidateQueries` и пропадали в том же окне | **принято, починено.** Все кадры идут через один `reread()`; тест на кадр `bank`+`ceiling` падает на до-фиксном коде |
-| **Перезапуск чтения на КАЖДЫЙ кадр**, пока запись пуста | **принято, замерено, починено.** Пачка из пяти кадров стоила ШЕСТЬ чтений; отметка «перечитывание уже в пути» держит их в двух. Тест на пачку |
-| **resync рвёт живой поток:** id прогона лежит ВНУТРИ карточки книги, а reset её опустошает | **не воспроизводится.** Замер: наблюдатель ни разу не рендерится с пустой карточкой (шесть рендеров, `status=success` во всех), `EventSource` открыт один раз и до, и после фикса. Гард, который я было написал, СНЯТ; тест-сторож («resync не перезапускает поток», проводка как на настоящем экране — id из запроса книги) оставлен |
-| **Тест подстановки — тавтология:** он заполнял места значениями, которые сам же из строки и вынул | **принято, переписано.** Теперь сверяются ВЫЗОВЫ: переменные, которые передаёт caller, против мест его строки, плюс обратное направление |
-| **Сторож языка не смотрит корневые файлы** (`index.html`, `vite.config.ts`, `tsconfig.json`) — как раз те, что сессия перевела руками | **принято, починено:** корни в списке по имени |
-| **ESLint-гейт знал семь атрибутов**, а `description`/`empty`/`hint`/`caption` наших примитивов — тоже текст на экране | **принято, список расширен** |
-| **`` не следует за выбором языка** — единственное, чего второй язык не мог бы поменять | **принято:** `Locale` ставит `lang` документа по выбранной локали |
-| **Сцена `zoom` зеленела бы на таблице, которая ничего не нарисовала** | **принято:** сначала проверяется, что столбцы есть |
-| **Отчёт врал в двух местах** (бейдж на выбранной строке; «ни одного вранья в комментариях») | **принято, обе строки поправлены выше** |
-| **Кадры `chapter` и `status` (то есть сам Ф-49) остались вне `reread`** — тот же пропадающий кадр на самом ходовом ключе | **принято, починено:** оба идут через `reread`; для книжного скоупа заведён `rereadAll`, который спрашивает КАЖДЫЙ ключ по отдельности — сброс по префиксу обнулил бы все открытые главы разом |
-| **Каталог и стор:** неизвестный сохранённый язык роняет первый рендер; `` заморожен; счётчик замечаний склоняется одной формой («1 замечаний»); потолок прогона — тоже | **принято, всё починено:** локаль неизвестного языка падает на язык по умолчанию, `lang` документа следует выбору, оба счётчика склоняются через `Intl.PluralRules` теми же формами, что уже носит банк |
-| **Второй экземпляр подстановки `{place}`** в харнессе сценариев | **принято:** заполнение вынесено в `src/i18n/fill.ts`, его импортируют и приложение, и сцены |
-| **Сцена `hidden` зеленела бы на самой регрессии**, которую сторожит | **принято, переписана:** сравнивает ШИРИНЫ таблицы, смонтированной в скрытой вкладке, с ширинами той же таблицы, с которой не уходили (121·122·133·232 против них же) |
-| **Сцена `zoom`: две проверки ни о чём** (панель шириной > 0; низ статус-полосы = низ окна) и она оставляла следующей сцене свою раскладку в localStorage | **принято:** проверки заменены на «три панели стоят в ряд внутри окна» и «текст статус-полосы не обрезан», хранилище восстанавливается. ⚠ И тем же ходом найден настоящий дефект — Ф-54 |
-| Мин-ревизия рвёт список и не оставляет следа | **отвечено, не менял:** дропнутый ответ не теряет строк — в кэше остаётся полный список с патчем кадра, а случай «список ПРИОБРЁЛ строки» контракт закрывает `resync_required` |
-| `api.test.ts` ослабил две проверки, сверяя фразу с константой мока | **отвечено, не менял:** проверка ловит ровно то, ради чего заведена — клиент передаёт фразу платформы нетронутой; прежняя форма вдобавок запирала СЛОВА фикстуры, то есть падала бы от правки фикстуры |
-
-#### 5. Красный гейт, который я НЕ подогнал
-
-Сцена `perf` на загруженной машине (в тот момент шло адверсариальное ревью двенадцатью агентами)
-показала отклик поля 63‥79 мс при пороге 60 и уронила `check:full`. Порог не трогал — вместо этого
-поставил A/B тем же зондом по двум сборкам подряд, чтобы нагрузка била в обе одинаково:
-
-| Сборка | Отклик на символ, пять прогонов |
-|---|---|
-| до этой сессии (`git archive HEAD`) | 44 · 47 · 50 · 54 · 59 и 42 · 43 · 44 · 46 · 48 |
-| эта сессия | 39 · 41 · 43 · 44 · 47 и 39 · 41 · 42 · 44 · 47 |
-
-То есть регрессии нет — сборка стала БЫСТРЕЕ, а красный был машиной: сам замер сцены чувствительнее
-к нагрузке, чем зонд. Красным он оставался и внутри `check:full` на тихой машине — просто потому,
-что к сцене `perf` команда уже минут пять гоняет сборку, семь маршрутов с axe и восемь сцен.
-
-Починен ИНСТРУМЕНТ, а не порог: сцена делает пять заходов и берёт МЕДИАНУ вместо одного захода,
-делённого на длину строки. Величина та же — миллисекунды на клавишу, — порог остался 60, и после
-правки та же сцена в том же `check:full` печатает **36 мс (из 30·35·36·37·48)**. Считаю это
-законной границей правила «гейты не подгонять под зелень»: подгонка — это когда двигают порог или
-выкидывают проверку; здесь заменён шумный способ снять величину, и заменён с числами на руках.
-
-#### 6. Гейты на сдаче
-
-`npm run check` — зелёный, **279 тестов** (было 160). Состав прироста назван честно: 106 из 119
-новых случаев — это ОДИН параметризованный свип языка по файлам зоны (по случаю на файл), остальные
-13 — тесты слоя данных, каталога и подстановки. `npm run check:full` — 7 маршрутов, **9 сценариев,
-88 проверок**, ноль блокирующих нарушений axe (включая три зум-шага), драг панели p90 17 мс.
-Оба гейта проверены живым нарушением: ESLint роняет и `title="Настройки"`, и `title="Settings"`
-(правило про МЕСТО, а не про алфавит); сторож языка ловит русский комментарий в `api/revision.ts`.
-
-### 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` у подсказки поля** | подсказка в форме добавления книги была голым `` | `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`. Ширины считались от «устоявшейся» ширины контейнера, но результат попадал в
-коллекцию через ``, а библиотека кэширует отрисованные колонки по объекту столбца
-(`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.
+*(Записи сессий S0–S4 и их приёмок (02–14.08) — в [archive/frontend-PROGRESS-S0-S4.md](archive/frontend-PROGRESS-S0-S4.md); вынесено 16.08 по слову владельца. Запись приёмки S4 с фикс-листом ФС — ВЫШЕ, она живая.)*
## Пинг оркестратора №15 (09.08): контракт 0.2.1 — `503` на старте прогона; платформа-раннер заленден