From 04396b90f136536636ffc5b7489b039697552890 Mon Sep 17 00:00:00 2001 From: heaven Date: Fri, 14 Aug 2026 03:45:36 +0300 Subject: [PATCH] Remove worked-off S3, S3.5 and S3.7 prompt copies from the frontend zone, archived in docs/archive/prompts with outcome banners --- frontend/docs/S35_SESSION_PROMPT.md | 241 -------------------- frontend/docs/S37_SESSION_PROMPT.md | 235 ------------------- frontend/docs/S3_SESSION_PROMPT.md | 336 ---------------------------- 3 files changed, 812 deletions(-) delete mode 100644 frontend/docs/S35_SESSION_PROMPT.md delete mode 100644 frontend/docs/S37_SESSION_PROMPT.md delete mode 100644 frontend/docs/S3_SESSION_PROMPT.md diff --git a/frontend/docs/S35_SESSION_PROMPT.md b/frontend/docs/S35_SESSION_PROMPT.md deleted file mode 100644 index c2cec96f..00000000 --- a/frontend/docs/S35_SESSION_PROMPT.md +++ /dev/null @@ -1,241 +0,0 @@ -# Промт: фронт-сессия S3.5 — фикс-пак оболочки (гейт S4) - -Ты — фронтенд-сессия TextMachine, шестая по счёту. Зона записи — **только `frontend/`**; сессия -НЕ коммитит — дерево готовит и передаёт на лендинг оркестратору. Протокол зоны — стоящий промт -`FRONTEND_SESSION_PROMPT.md` §«Зона и git», он в силе целиком; итоги, пинги и вопросы владельцу — -ТОЛЬКО зонный журнал `frontend-PROGRESS.md` (в `docs/PROGRESS.md` фронт не пишет). В дереве живут -незакоммиченные файлы ДРУГИХ зон (полигон: `eval/*`, `docs/experiments/22*|23*`) — не трогать -и не «прибирать». - -> Промт написан оркестратором №16 (09.08.2026) из **24 замечаний владельца**, снятых с живого -> прогона витрины. Замечания пронумерованы номерами владельца — **(1)…(24)**, номера локальны -> этому промту (как Q-номера паков). В отчёте пройтись по ВСЕМ 24: сделано (кадр ДО/ПОСЛЕ) / -> диспозиция с обоснованием / вопрос В-строкой. Молча пропустить номер нельзя. - -## Зачем эта сессия (рамка) - -Владельцу НЕ нравится текущее качество оболочки, и **S4 гейчен до её починки** (D39.119 п.4). -Скоуп S3.5 зафиксирован там же: **вкладки по VS Code-модели + Ф-19 + полный список владельца** — -список ниже и есть. Это фикс-пак ОБОЛОЧКИ И ВИТРИНЫ: настоящие экраны S4–S7 (загрузка книги, -механизм подписи банка, содержимое настроек, экспорт) НЕ строить. Общее замечание владельца, -рамка всего пака: модель до сих пор «не понимает связанность между элементами, их визуальную -ценность и не видит картину целиком» — каждый пункт чинить не изолированной заплаткой, -а глядя на весь экран. - -## Обязательное чтение до кода (порядок) - -1. `FRONTEND_SESSION_PROMPT.md` — стоящий промт: сценарий, жёсткие ограничения, зона и git. -2. Шапка `frontend-PROGRESS.md` + `BACKLOG.md` — пак прямо касается Ф-7, Ф-11, Ф-19, Ф-20, Ф-21, - Ф-30, Ф-32; их диспозиции не переизобретать. -3. `FRONTEND_PLAN.md` §5 — гейты, замеры, скриншот-цикл (что уже стоит и как расширять). -4. Референсы `frontend/references/`: **fleet.png — главный** (пропорции, зазоры, верхняя полоса, - статус-полоса) · **antigravity_add_folder.png** — модал добавления (свежий, докинут владельцем - 09.08) · antigravity_chat.png · antigravity_main.png. -5. `docs/product-requirements.md` — продуктовые требования (из реестра, не из памяти). -6. Контракт: зонная копия `frontend/docs/api-contract/openapi.yaml` — формы данных берутся оттуда. - -## Инструментальная рамка (обязательна) - -- **Скриншот-цикл стоит и остаётся законом:** `npm run shot`, «смотреть на снимок — обязательная - часть цикла» (`scripts/shot.mjs` шапка). Для этого пака статики МАЛО: половина замечаний — про - ИНТЕРАКЦИЮ (клики по вкладкам, драг ручки, модалы, ховеры). Playwright уже в зависимостях - (`playwright` 1.62.1) — писать сценарии интеракций (клик → кадр → проверка состояния) и гонять - их частью самопроверки; долгоживущие — в `scripts/`, replayable, не в /tmp. Вердикт «сделано» - без кадра ДО/ПОСЛЕ не принимается. -- **Сверка с референсом:** `npm run shot --size 1280x764` — вьюпорт fleet.png для прямого - наложения. Замечание (1) дополнительно требует кадра **2560×1440** — владелец смотрит - на 27" 2K, и дефолтные масштабы не понравились именно там. -- Если в окружении установлен плагин **frontend-design** (официальный Anthropic) — он активируется - на фронт-задачах сам; его гайды по типографике/палитре применять, но пины `STACK_DECISIONS.md` - и токен-гейты (одно место для цвета и размера) первичны. -- **Мандат самопроверки:** ревью ИСПОЛНЕНИЕМ своего кода и своих кадров + адверсариальное ревью - диффа (author≠reviewer) в конце — как в S2/S3. `npm run check` и `npm run check:full` зелёные - на сдаче; гейт доступности axe зелёный (⚠ при смене фонов пересчитывать контраст — Ф-11 уже - на пороге WCAG). - -## Замечания владельца - -### Вкладки — модель VS Code (2, 3; сюда же Ф-19) - -**(2) Спам вкладками.** Любой клик по главе плодит вкладку по центру. Сделать ровно модель -VS Code для текстовых файлов: -- одиночный клик по главе → **preview-вкладка** (одна на панель, заголовок курсивом); -- одиночный клик по другой главе **замещает содержимое** preview-вкладки — новая не создаётся; -- **пин** (превращение в постоянную): двойной клик по главе, двойной клик по самой вкладке, - либо содержательное взаимодействие с открытым содержимым (в VS Code — правка; что считать - содержательным у нас — реши и запиши в отчёт; простая прокрутка пинить не должна); -- закрытие — как сейчас (крестик/Delete, Ф-17 в силе). - -**Ф-19 чинится здесь же:** переключение вкладки размонтирует панель и теряет прокрутку -(`react-aria-components` не рендерит невыбранную TabPanel), пересборка 2284 узлов стоит -70–140 мс. Строка откладывала лекарство «до решения об устройстве оболочки» — это решение -принимается СЕЙЧАС, под задачу: keep-alive панелей или запоминание офсета на вкладку — выбрать -по замеру и записать почему. - -Приёмка playwright-сценарием: пять одиночных кликов по разным главам → в ряду ровно ОДНА -preview-вкладка; двойной клик → пин, следующий одиночный клик открывает НОВУЮ preview рядом; -на `/scale` прокрутка дерева до 9000 → уход на другую вкладку → возврат → офсет жив. - -**(3) Вид вкладок.** Слишком мелкие, «не отделимы для глаза», слиты с панелью. Вписать вкладки -в панель аккуратнее: активная читается мгновенно (фон/подчёрк/контраст), высота и отступы — -по референсу, а не меньше. Это не «скопировать Fleet ещё точнее», а передать аккуратнее — см. (14). - -### Геометрия, масштабы, зазоры (1, 5) - -**(1) Дефолтные масштабы великоваты**, особенно на 27" 2K (на 24" терпимее). Ориентир — пропорции -fleet.png ОТНОСИТЕЛЬНО кадра: доли панелей, высоты строк дерева/списков, плотность элементов -внутри панелей («элементы как будто не тот масштаб имеют»). Работать ЗАМЕРОМ — наложение кадра -1280×764 на референс, измеренные доли/пиксели в `FRONTEND_PLAN.md` §5, — не на глаз. Все размеры -через `tokens.css` (токен-гейт Ф-4 стоит и обязателен). - -**(5) Выравнивание панелей, зазоров и статус-полосы.** «Особенно заметно по тексту снизу» — -нижняя статус-полоса: базовые линии, вертикальные центры, отступы от краёв — сверить с Fleet -попиксельно; у них аккуратнее. - -### Кнопки, иконки, настройки (4, 17, 19, 11) - -**(4) Две кнопки поиска, делают одно и то же, лупа в непонятном месте.** У Fleet роли РАЗНЫЕ: -вкладка «Search» в левой панели — полнотекстовый поиск по проекту; лупа в правом верхнем углу — -глобальная палитра «Goto / Search everywhere». Развести роли осмысленно для читалки (поиск по -книге ≠ быстрый переход к главе/термину) либо оставить одну кнопку; кнопка без действия -запрещена (норма Ф-7/Ф-16). - -**(17) Иконки «шакальные»** — особенно тогглы левой/правой панели. Разобраться с причиной, -а не перерисовать вслепую: размер сетки иконки vs размер отрисовки, выравнивание на пиксельную -сетку, толщина штриха на тёмном фоне, `shape-rendering`. Туда же — «текст рендерится странновато, -особенно внизу»: проверить сглаживание, вес и размер шрифта статус-полосы (дробные px после -масштабирования дают мыло). Показать кадрами ДО/ПОСЛЕ с зумом. - -**(19)+(11) Настройки.** Шестерёнку — в правый верхний угол (как у Fleet), из нижней части -убрать. Открываются НЕ вкладкой — **модальным окном поверх оболочки** (по примеру Claude Code / -ChatGPT). Внутри — честный каркас разделов без содержимого (содержимое — S7), включая два -будущих пункта из (15): светлая тема, язык интерфейса. - -### Драг панелей (18; сюда же половина 14) - -**(18а) Баг:** фиолетовая полоска ресайза ЗАЛИПАЕТ после отпускания драга. **(18б) Форма:** -полоску сделать тонкой и вписанной ВНУТРИ гепа между окнами — она не должна перекрывать чёрный -геп (владелец: «чёрный фон между окнами не трогать, он идеален» — (14)). - -Референс-реализация по слову владельца — проект vojo, скопировать ПОДХОД оттуда: -- `/home/ubuntu/projects/vojo/src/app/components/page/style.css.ts:11-70` — ручка: невидимая - зона захвата 7px поверх зазора; индикатор — пилюля 2×36px по центру, `opacity: 0` в покое, - ховер 0.25, драг — подсветка акцентом и рост до 48px; на упоре min сплющивается, на упоре - max вытягивается («лимит чувствуется тактильно»); переходы 140ms. -- `/home/ubuntu/projects/vojo/src/app/components/page/Page.tsx:191-300` — механика: pointer - capture на ручке; живая ширина в состоянии компонента, персист одним махом на pointerup - (не на каждый move); cleanup-эффект снимает `cursor`/`user-select` с body при unmount - посреди драга — ЭТО и есть лекарство от залипания (Alt-Tab, смена маршрута, pointerup мимо). -- Правый край — та же схема в `ThreadDrawer.tsx:209-241`. - -Копируется подход, не файл: у vojo vanilla-extract и folds, у нас токены и CSS-модули. - -### Читалка (9, 10, 24) - -**(9) Оригинал/перевод разделить мягко визуально.** Сейчас колонки различимы слабо. Очень -деликатно: фон на полтона, тонкий разделитель, отступ — один приём, не три сразу. (Приглушение -колонки оригинала — отдельный хвост Ф-7 на S6, здесь не решать, но не противоречить.) - -**(10) Серо-синяя линия вдоль текста** — владелец не смог её прочитать. Это полоска ЗАМЕЧАНИЯ -(`src/ui/Callout.tsx:13`, `Callout.module.css`: синяя `attention` / серая `glance` — выноска -по образцу antigravity_chat). Непрочитываемость подтверждает Ф-21 живым владельцем: смысл -различается только цветом. Переделать так, чтобы значение читалось без объяснения — связью -с замечанием (иконка/счётчик у блока, ховер подсвечивает пару «полоска ↔ текст замечания»), -НО продуктовое слово ступени не выдумывать — словарь на владельце (В-3/Ф-21). - -**(24) Пометка черновика.** Пока глава переводится/черновая — мягкая пометка (иконка/ворнинг -с тултипом): «черновой вариант, может быть перегенерирован» — чтобы человек не пугался смены -названий и числа глав (research/27: пере-нарезка легальна). Форму брать из данных контракта -(статусы главы/прогона по спеке); поля не выдумывать — класс ошибки «фикстура выдумала форму» -уже ловился четырежды (Ф-14). - -### Вкладка «Замечания» (8) - -Владелец: непонятно зачем — всё рисуется в тексте, статусы есть в дереве; «лишнее. Если хочешь -защитить этот дизайн — обоснуй». Два легальных исхода: (а) снять вкладку; (б) защитить — -обоснованием И кадром сценария, который без неё не живёт (кандидат: сводный список по книге, -Ф-32 — пер-книжное чтение замечаний уже есть в памяти клиента). Решение — диспозицией в отчёте, -финальное слово — владельцу. - -### Банк памяти (7, 13, 20) - -**(7)+(13) Представление банка перепридумать.** Текущее «прям совсем не годится: не -репрезентативно, непонятно, нечитаемо». Больше информации на термин и читаемо для верификации: -оригинал · перевод · тип · род/пол · описание/обоснование · варианты · статус решения · откуда -термин (глава появления); сведения, раскрывающие БУДУЩИЕ события книги, — под спойлер. Поля -брать из контракта (`BankEntry`: `type`/`sense`/`since_ch`/`source`, трёхзначный статус); чего -в контракте нет (пол/род? варианты? спойлер-граница?) — не выдумывать в фикстуре молча, -а ПРЕДЛОЖИТЬ черновиком правки спеки с пометкой «предложено» (право и обязанность зоны — -D39.99 п.4; ратифицирует оркестратор). - -**(20) «Подписать банк» и «подписано 10 из 60» непонятны:** что подписываем — банк или термины? -зачем счётчик? кнопка открывает вкладку-заглушку. Механизм подписи = S5, здесь НЕ строить. -В S3.5 — честная витрина: непонятные кнопки-заглушки снять (кнопка без действия запрещена) -либо заменить читаемым состоянием («ждут решения: 50»), формулировки — по словарю подписи -контракта (auto/draft/approved), без выдуманных глаголов. - -### Библиотека и метаданные (6, 12, 21, 22, 23) - -**(6) «О книге» — метаданных больше, но подходы охранять.** Вытащить больше информации о книге, -при этом НИЧЕГО, что раскрывает принципы/логику работы бэкенда: деньги на экран не выносим -(§4.8 стоящего промта), модели/routing/внутренности пайплайна закрыты разрешающим списком -контракта — это осознанная защита подходов, не пробел. Легально из контракта: язык пары, объём, -главы/юниты, прогресс пофазно, статус, даты, замечания счётчиком. - -**(12) Добавление книги — модальным окном**, по antigravity_add_folder.png (сейчас зачем-то -открывается новая вкладка): модал «добавить книгу» → выбор файла/папки → **поле названия: -автор вводит руками ЛИБО скипает — тогда название даёт авто-парсер** (различать эти два -источника) → слоты будущих пер-книжных настроек (каркасом). Сам аплоад (`POST /books`, -multipart, прогресс) строит S4 — здесь модал, его форма и мок-поведение. - -**(21) Цветной статус книги — на ИКОНКЕ книги**, не точкой рядом с надписью. - -**(23) Наложение системных надписей на название книги/главы** («готово», «нужна подпись» -перекрывают текст) — «исполнение кривое и некрасивое», сама идея бейджа не отвергнута. -Переделать: бейдж/иконка НЕ поверх названия (справа в ряд, отдельным слоем с гарантией -непересечения — эллипсис названию, фикс-место бейджу). - -**(22) — вопрос владельца, ответ вписан оркестратором, сессии тут делать нечего:** «где -генерится оригинал названия главы?» Сейчас — фикстуры мока (`src/mock/book.ts:87-131`, -`src/mock/scale.ts:49-51`). В реальном пайплайне заголовок ПЕРЕВОДА движок рендерит -детерминистически из шаблона пары (`configs/langpacks/zh-ru/heading.txt`: «Глава {n}») и вклеивает -в финальный текст первого юнита, а исходный маркер остаётся телом оригинала; метка в дереве -по контракту — из ДАННЫХ (`heading`/`number`, К-3); чем подписывать главу без заголовка — -открытый В-4 на владельце (Ф-30). - -### Цвет и тема (14, 15, 16) - -**(14) «Слишком точная копия Fleet».** Подразбить цветовую схему чуть оригинальнее — акценты, -выделения, второстепенные поверхности; **чёрный фон между окнами НЕ трогать** («он идеален»). -Это доводка индивидуальности, не редизайн. - -**(16) Фон главных окон «серо-неприятный».** Изучить (websearch) рекомендации по тёмным фонам, -приятным глазу: не чистый нейтральный серый — слегка тонированные тёмные (тёплый или холодный -подтон), не абсолютно чёрное полотно под текстом, контраст текста не на максимум. Предложить -2–3 варианта КАДРАМИ, выбрать лучший, показать владельцу оставшиеся как альтернативы. Токены — -в `tokens.css`; контраст пересчитать (Ф-11 у порога; axe-гейт остаётся зелёным). - -**(15) Светлой темы нет, выбора языка интерфейса нет.** Оба живут в настройках (каркас — п. (11)). -Строить в S3.5 только если дёшево поверх токенов (палитра уже одно место — оценить честно); -иначе — ЧЕСТНАЯ диспозиция: цена, план, строки Ф-N в `BACKLOG.md`. Молчание нелегально. - -## Что НЕ делать - -- Не строить экраны S4–S7: загрузка книги, механизм подписи банка, содержимое настроек, экспорт. -- Не править канон контракта; правки спеки — черновиком «предложено», ратифицирует оркестратор. -- Не трогать чужие зоны и чужие незакоммиченные файлы (полигон жив). -- Продуктовые слова не выдумывать: ступень замечания (В-3), фраза паузы (В-6), подпись главы - без заголовка (В-4) — на владельце. -- Тесты и гейты не подгонять под зелень (D39.121): красный гейт — вопрос оркестратору - через журнал, не правка гейта. -- Никакого `git add -A`/`git commit` — дерево передаётся на лендинг как есть. - -## Отчёт и приёмка - -- Таблица по всем 24 номерам: номер → что сделано → кадр/замер (ДО/ПОСЛЕ) → либо диспозиция / - В-строка. Прогон по номерам — в зонный журнал `frontend-PROGRESS.md`, хвосты — `BACKLOG.md` - строками Ф-N, вопросы владельцу — В-строками. -- `npm run check` и `npm run check:full` зелёные; кадры в `.shots/`; наложение 1280×764 - на fleet.png и кадр 2560×1440 — приложены. -- Адверсариальное ревью диффа (author≠reviewer) исполнено, находки с диспозициями — в отчёт. -- Промт S4 не писать — его выдаёт оркестратор после приёмки этого пака. diff --git a/frontend/docs/S37_SESSION_PROMPT.md b/frontend/docs/S37_SESSION_PROMPT.md deleted file mode 100644 index 12a22b69..00000000 --- a/frontend/docs/S37_SESSION_PROMPT.md +++ /dev/null @@ -1,235 +0,0 @@ -# Промт: фронт-сессия S3.7 — долги слоя данных и мелкие хвосты (до S4) - -Ты — фронтенд-сессия TextMachine, восьмая по счёту. Зона записи — **только `frontend/`**; сессия -НЕ коммитит — дерево готовит и передаёт на лендинг оркестратору. Протокол зоны — стоящий промт -`FRONTEND_SESSION_PROMPT.md` §«Зона и git», он в силе целиком; итоги, пинги и вопросы владельцу — -ТОЛЬКО зонный журнал `frontend-PROGRESS.md` (в `docs/PROGRESS.md` фронт не пишет). В дереве живут -незакоммиченные файлы ДРУГИХ зон (полигон: `eval/*`, `docs/*`) — не трогать и не «прибирать»; -у полигона прямо сейчас идёт ЖИВОЙ платный прогон — ничего в `eval/` и `~/books/` не запускать, -не читать замки, не убивать процессы. - -> Промт написан оркестратором (10.08.2026) по приёмке S3.6. Контекст холодному исполнителю: -> оболочка и витрина построены сессиями S0–S3.6 и приняты владельцем (три круга замечаний); -> слой данных стоит с S3 — `src/api/` разговаривает настоящим HTTP через MSW-мок сети, -> живой поток идёт по SSE (`src/showcase/useRunStream.ts`), чтения — TanStack Query -> (`src/api/queries.ts`), контракт — зонная копия `frontend/docs/api-contract/openapi.yaml` -> (0.2.1), типы генерятся из неё. Эта сессия НЕ строит новых экранов: она закрывает названный -> техдолг слоя данных (Ф-49…Ф-51), одну ратифицированную правку контракта (Ф-47), -> интернационализацию строк интерфейса (Ф-35: словарь + гейт, без хардкода русского) -> и мелкие хвосты. S4 стартует после неё отдельным промтом. -> По всем задачам — прогон в отчёте; -> **молча пропустить задачу нельзя**: сделано / диспозиция с обоснованием / вопрос В-строкой. - -## Обязательное чтение до кода (порядок) - -1. `FRONTEND_SESSION_PROMPT.md` — стоящий промт: зона, git, жёсткие ограничения. -2. `frontend-PROGRESS.md`: шапка «Текущее состояние», затем **приёмочная запись оркестратора - 10.08 (первая в хронике)** — в записи S3.6 есть число-дрейф против финального дерева, - и поправки перечислены именно там; затем сама запись S3.6 (⚠ её разделы 12–15 стоят - в ОБРАТНОМ порядке после §11). `BACKLOG.md` строки Ф-40, Ф-47, Ф-49, Ф-50, Ф-51 — - формулировки не переизобретать, но и не принимать на веру: КАЖДУЮ проверить по коду - до правки. -3. Контракт: зонная копия `frontend/docs/api-contract/openapi.yaml` — §`Unit`, - `EventEnvelope`, `Revision`, `resync_required`, `BankTerm`; поведение ревизий и правило - `>= R` — норматив. -4. `FRONTEND_PLAN.md` §5 — гейты и замеры: что уже стоит и как расширять. - -## Задачи - -### 1. Ф-49 — текст открытой главы не подписан ни на один сигнал изменения - -`keys.units` не инвалидируется нигде: `useRunStream.ts` по кадрам инвалидирует notes/bank/book, -кадр `chapter` патчит лишь СПИСОК глав, а открытые главы живут на keep-alive вкладках и не размонтируются — -читатель, не уводивший фокус из окна, нового текста не увидит вообще. Контракт прямо предписывает -обратное (`openapi.yaml`, `Unit`: «the live "something changed" signal arrives as an event; the -text arrives with a read after the boundary»). - -Сделать: инвалидация чтений юнитов открытой главы на кадре `chapter` этой главы И на смене -`status` книги (границы стадий — за всю черновую волну кадр `chapter` может не прийти ни разу, -пока К-10 открыт). Безопасная сторона: лишняя инвалидация дешевле невидимого текста, но -НЕ инвалидировать все главы на каждый кадр — скоуп по ключу главы из кадра. - -### 2. Ф-50 — кадр потока, пришедший до появления чтения в кэше, теряется молча - -`useRunStream.ts`: обработчики делают `list === undefined ? list : {...}` — в пустой кэш кадр -не пишется, а `acceptFrame` уже сдвинул отметку ревизии; `freshest(undefined, next)` затем -принимает снимок, сделанный ДО кадра. Окно — старт экрана и resync. Рядом второе того же класса: -многостраничное чтение штампует «рваный» список ревизией ПОСЛЕДНЕЙ страницы (`queries.ts`), -хотя контракт предупреждает, что ревизия движется во время пагинации. - -Сделать: кадр, не нашедший кэша, обязан оставить след — либо инвалидация ключа, либо отметка -ревизии не сдвигается до успешной записи; для пагинации — ревизия списка не выше МИНИМАЛЬНОЙ -из страниц либо перечитывание при сдвиге ревизии между страницами. Выбор решения обосновать -в журнале ЗАМЕРОМ/тестом, не рассуждением. - -### 3. Ф-51 — `resync` сбрасывает один гард из двух - -На `resync_required` зовётся `invalidateQueries()` без ключа: данные сохраняются, гард -`dropStaleReads` продолжает сравнивать новый снапшот со СТАРОЙ отметкой — а по контракту resync -выдаётся именно после полной замены, где монотонность ревизии не обещана. Вторым слоем: вызов -без ключа бьёт по чужим скоупам (библиотека, usage, run-options, другие книги). - -Сделать: `resetQueries`/`removeQueries` по скоупу КНИГИ + сброс отметок ревизий этой книги -(стриминговая сторона уже сбрасывает — довести симметрию до кэша). Чужие скоупы не трогать. - -### 4. Ф-47 — правка контракта: `sense` становится обязательным (РАТИФИЦИРОВАНО) - -Решение оркестратора (автор контракта), исполняется этой сессией в зонной копии: -`BankTerm.sense` — в `required`; пустая строка = «различителя нет». Дифф в канон -`docs/architecture/14-api-contract/` переносит оркестратор при лендинге — канон сам не трогать. - -Сделать: правка `frontend/docs/api-contract/openapi.yaml` (в `required` + описание правила пустого), -бамп `info.version` 0.2.1 → 0.2.2, `npm run contract` зелёный, `npm run contract:types` — -перегенерить `src/api/schema.ts`, убрать костыли `?? ''` по `sense` (проверить грепом ВСЕ места, -не по счёту из строки бэклога — он там завышен), фикстуры мока привести (каждый терм несёт -`sense`, хотя бы пустой строкой). - -### 5. Ф-40 — общий модуль стилей поля ввода - -`src/ui/TextField.module.css` и `src/ui/FilterField.module.css` держат байт-одинаковые `.input`, -`::placeholder`, `:focus`; отличие — цвет границы в покое. Роли примитивов разные, сливать -примитивы нельзя — общий CSS-модуль поля на оба, отличия остаются у ролей. - -### 6. Ф-25 — свод языка комментариев (конвенция владельца 04.08) - -Комментарии S1/S2 в ~40 файлах (`api/index.ts`, `showcase/*`, `ui/*`, `tokens/*`, `scripts/*`) -остались русскими; приёмка нашла русские комментарии и в **~14 НОВЫХ файлах S3.6** (например, -`src/showcase/About.tsx`) — вопреки конвенции и уточнению владельца по ходу самой S3.6. -Перевести на английский ОДНИМ механическим проходом, покрыв ОБА множества. Граница жёсткая: -переводятся комментарии, имена тестов и служебные строки; **UI-текст и фикстурная проза остаются -русскими — это продукт, а не код.** Смыслы не менять; комментарий, который при переводе оказался -враньём против кода, — чинить по коду и назвать в журнале. - -### 7. Сторожа на то, что мерилось руками - -Из таблицы долгов S3.6: зум 125/150/200% и узкая панель замерены руками, сторожа нет. Дёшево -и без новых механизмов: в существующие сценарии добавить прогон одной-двух ключевых проверок -на втором вьюпорте/зуме (выбор — по замеру, что реально ловит регресс раскладки). Если дёшево -не выходит — честная диспозиция в журнале, не молчание. - -Отдельно: референс fleet_2.png, на котором стоит палитра S3.6 и категория `toned` в -`src/tokens/tokens.test.ts`, докинут владельцем в `frontend/references/` при приёмке 10.08 -(быструю пиксельную пробу якорей оркестратор сделал — совпало; запись в журнале). Прогнать -полный `measure.py` по палитре и вкладкам, записать числа в `FRONTEND_PLAN.md` §5 — замер -становится воспроизводимым; ⚠ PIL для `measure.py` не запинен (см. 8.5) — решается тем же -пунктом. - -### 8. Находки приёмки S3.6 (закрыть здесь же) - -Приёмочное ревью оркестратора (12 агентов: шесть линз + скептики-верификаторы, author≠reviewer) -подтвердило 12 находок. Ниже те, что закрывает эта сессия; каждая грунтована `file:line` — -проверяй по коду, не по списку (строки могли съехать). - -**8.1 (HIGH) Замер ширин таблицы банка молча проваливается в скрытой keep-alive вкладке -и не повторяется при показе.** `src/ui/Table.tsx:232` — зависимости эффекта замера -`[frame, named, sample, marks, hasRows]` не знают о видимости вкладки; под -`content-visibility: hidden` (`src/ui/Tabs.module.css`) геометрия нулевая, `read()` не набирает столбцов, -10 кадров ретрая и молчаливый `return`. Сценарий: открыть книгу, уйти с вкладки «Банк» ДО прихода -`/bank`, вернуться — столбцы падают в `1fr` без потолков (ровно «баг 4» владельца, объявленный -починенным). Лечение выбрать по замеру (триггер на возврат видимости: -`contentvisibilityautostatechange` / ResizeObserver / зависимость от выбранной вкладки); -приёмка — playwright-сценарий, воспроизводящий уход-возврат, и падающий на до-фиксном коде тест. - -**8.2 Вторичный текст и индикаторы теряют контраст на новом синем `--color-selected`.** -Выбранная строка дерева — ПОСТОЯННОЕ состояние (открытый раздел всегда выбран), а содержимое -не перекрашивается: на #1c4478 лежат текст 12px #9b9b9b (3.52:1 при пороге 4.5), иконка #707070 -(1.98:1), дорожка прогресса #262626 (1.55:1) — `src/ui/Tree.module.css:46` красит только фон, -`src/showcase/Library.module.css` содержимое не трогает. Починить пары на selected-фоне, не уезжая от -референса; axe этого НЕ ловит (non-text не проверяет, выбранную строку со счётчиком не видел) — -добавить сторож в сцену. - -**8.3 Путь из «Замечаний» не загарден: `open` по id, отсутствующему в `chapters`.** -`src/showcase/Showcase.tsx:186` + `src/showcase/Notes.tsx:53-54` — строка сводки с определённым, но отсутствующим id -рисуется кликабельной; `Tabs` контролируемый (авто-фолбэка react-stately на первую вкладку НЕТ), -итог — пустой центр без empty-состояния. Гардить как Library-путь (`positionOf`), сироту -помечать и в строке сводки (сейчас `data-orphan` только при `chapter_id === undefined`). - -**8.4 Съёмка нестабильна — два источника гонки, лечить оба.** -(а) `src/showcase/useScreenshotFlag.ts:22` — на первом рендере `useIsFetching() === 0` и экран -объявляется `ready` ДО старта первого запроса (нотификация батчится в отдельную задачу); гейт -`scripts/shot.mjs` ждёт ровно `dataset.screen`. (б) Поймано исполнением на приёмке: axe стартует во время 220мс-анимации -карточки ожидания — один прогон `npm run shot` напечатал «контраст: 4 узла» на `/loading`, -два повторных — ноль. Стабилизировать цикл: убрать транзиент `ready`, дожидаться устаканивания -анимаций до прогона axe. - -**8.5 Минорные — одним проходом** (правки на строки, не механизмы): -- `src/ui/Table.tsx:257` — кэш канвас-замера не инвалидируется, если шрифт так и не загрузился - (отравление ширинами fallback); -- `src/showcase/Document.tsx:33` — пин вкладки срабатывает на ЛЮБОЙ `mouseup` при непустом - глобальном выделении (правый клик, выделение в соседней панели); -- `src/showcase/Showcase.tsx:59` — `awaiting()` на tracked-результатах + `useIsFetching` даёт - полный ре-рендер экрана на каждом префетче; чинить ТОЛЬКО с замером до/после, иначе не трогать; -- `src/api/vocabulary.ts:112` — `termStatus.label` («предложен»/«черновик»/«подписан») не - рендерится ни одним экраном: снять либо применить; продуктовые слова не выдумывать; -- `src/tokens/tokens.css:27` — в комментарии `--color-text-muted` число 3.9:1, фактически 3.58:1; - `tokens.css:33` — `--color-note` 2.98:1 на панели при пороге 3:1 для non-text (добрать); - `tokens.css:68` — комментарий `--row-height-term` ссылается на удалённый двухстрочный список; -- `src/showcase/Status.module.css:8` — `.paused`/`.offline` стали no-op (цвет совпал с базой): - вернуть отличие либо снять классы; -- `src/ui/Button.module.css:36` — подпись disabled-кнопки ТЕКСТОМ `--color-text-muted` против - контракта токена «non-text only» (WCAG disabled освобождает — противоречие контракту токена, - привести одно к другому); -- `scripts/scenes.mjs:170` — сторож обрезки вкладок молча зеленеет, если заголовок вкладки - перестанет быть `span`; -- `scripts/measure.py:13` — PIL нигде не запинен: манифест окружения для `scripts/` либо честная - шапка «чем ставить». - -**8.6 Доки зоны — привести к коду** (правится СВОЁ; записи журнала S3.6 не переписывать — -поправки к ним уже аннотированы приёмочной записью оркестратора в журнале): -- `FRONTEND_PLAN.md` §5.6 описывает СНЯТУЮ модель вкладок (вырез в хроме) как текущую — в коде - пилюля по fleet.png (возврат разделом 13 записи S3.6); §4 говорит «сценариев пять» — их семь; -- `frontend/README.md` — вписать S3.6 (и эту сессию) в карту сессий; -- `BACKLOG.md` Ф-47 — «`?? ''` в трёх местах» завышено: вхождение одно - (`src/showcase/Bank.tsx:166`); поправить при закрытии строки. - -### 9. Ф-35 — строки интерфейса без хардкода: словарь + гейт - -Сегодня ~90 русских литералов живут прямо в разметке (Ф-35); локаль примитивов уже сведена -в одно место (`src/ui/Locale.tsx`, `interfaceLocale`). Сделать интерфейс переводимым -МЕХАНИЗМОМ, не переводом: - -- все строки интерфейса уезжают в КАТАЛОГ сообщений, механизм — ОТРАСЛЕВОЙ i18n-инструмент, - не самописная поделка: компонент берёт строку по ключу, локаль = данные, новый язык - добавляется файлом перевода без захода в компоненты. Кандидатов сравнить и выбор обосновать - в журнале (у react-aria уже есть свой слой `@internationalized/string`; react-intl / lingui — - альтернативы); новая зависимость — с точным пином и записью в `STACK_DECISIONS.md` §3, - как того требует политика пинов; цену бандла замерить; -- **гейт против нового хардкода:** кириллический литерал в JSX/разметке = ошибка линта - (исключения — модуль словаря и фикстуры); гейт проверить ЖИВЫМ нарушением, как Ф-4/Ф-9; -- хранилище выбора языка подключить к словарю; каркасный пункт настроек «язык интерфейса» - уже есть — честное состояние «сейчас интерфейс только русский» остаётся, пока локаль - содержимого одна (ru); -- границы прежние: фикстурная проза (тексты мок-книг, названия глав, термины банка) — ДАННЫЕ, - не интерфейс, в словарь не уезжает; продуктовый список языков — решение владельца (если - нужен ответ сейчас — В-строкой); переводы строк на другие языки НЕ выдумывать. - -Приёмка: гейт ловит подсунутый литерал (показать нарушением); кадры семи маршрутов -не изменились — это переезд строк, не перевод. - -## Что НЕ делать - -- Не строить экраны S4–S7 (загрузка книги, механизм подписи, содержимое настроек, экспорт). -- Не трогать канон контракта `docs/architecture/14-api-contract/` — только зонную копию (задача 4). -- Поля банка из черновика S3.5/S3.6 (`note`, `gender`, `contexts`…) НЕ заводить ни в спеку, - ни в фикстуры — черновик ждёт ратификации (граница ПТ-33 — на владельце). -- Продуктовые слова не выдумывать: В-3 (ступень замечания), В-4 (глава без заголовка), - В-6 (фраза паузы), В-8 (слово состояния в дереве) — на владельце. -- Тесты и гейты не подгонять под зелень (D39.121): красный гейт — вопрос оркестратору - через журнал, не правка гейта. -- Никакого `git add`/`git commit` — дерево передаётся на лендинг как есть. -- Ф-48: если по ходу покажется, что пора вернуть ресайз столбцов — НЕ возвращать; строка - требует свежего замера от новой базы, это не задача пака. - -## Отчёт и приёмка - -- Каждая задача 1–3: ТЕСТ, падающий на до-фиксном коде (vitest поверх MSW; поток мокается - событиями), и зелёный после; в журнал — что именно ловит тест и как воспроизводился дефект. -- `npm run check` и `npm run check:full` зелёные на сдаче; счётчик тестов вырос, ни одна - существующая проверка не ослаблена. -- **Мандат самопроверки:** ревью ИСПОЛНЕНИЕМ своего кода, своих кадров и своих сценариев + - адверсариальное ревью диффа (author≠reviewer) в конце; находки с диспозициями — в журнал. -- Прогон по всем задачам таблицей в `frontend-PROGRESS.md`: задача → что сделано → тест/замер → - либо диспозиция. Хвосты — строками Ф-N в `BACKLOG.md` (Ф-49/50/51/40/47 закрыть или - переформулировать честно; Ф-35 и Ф-25 закрываются в своей код-половине, продуктовая половина - Ф-35 «какие языки» остаётся на владельце), вопросы владельцу — В-строками. -- Промт S4 не писать — его выдаёт оркестратор после приёмки этого пака. diff --git a/frontend/docs/S3_SESSION_PROMPT.md b/frontend/docs/S3_SESSION_PROMPT.md deleted file mode 100644 index 4b9069c9..00000000 --- a/frontend/docs/S3_SESSION_PROMPT.md +++ /dev/null @@ -1,336 +0,0 @@ -> ⚠⚠ **ПРОМТ ОТРАБОТАН — исторический, НЕ задание.** Исполнен двумя фронт-сессиями (04.08 и 08.08), -> **ПРИНЯТ и заленден D39.115** (`60595f6`): контракт **0.2.0** в каноне, канон и зонная копия -> байт-равны, блоки компаньона 2.14–2.16 внесены, слой данных построен. **Список «Правки спеки» -> ниже ИСПОЛНЕН целиком — не исполнять заново: спека уже 0.2.0, и повторная правка откатит -> ратифицированный контракт.** Живое состояние зоны — `frontend-PROGRESS.md`; хвосты — `BACKLOG.md` -> (Ф-29 · Ф-30 · Ф-31/К-13 · Ф-32); следующий промт зоны (S4) выдаёт оркестратор по слову владельца. -> Архивная копия — `docs/archive/prompts/FRONTEND_S3_SESSION_PROMPT_2026-08-04.md`. - -# Промт: фронт-сессия S3 — слой данных - -Ты — фронтенд-сессия TextMachine, четвёртая по счёту. Зона записи — **только `frontend/`**; -сессия не коммитит — лендит оркестратор (протокол — стоящий промт `FRONTEND_SESSION_PROMPT.md` -§«Зона и git», он в силе целиком). Пре-коммит хук стоит и самоустанавливается при `npm install`. - -> Промт написан сессией S2 по просьбе владельца — как передача с той точки, где S2 встала. -> Ратифицирует и правит его оркестратор; при расхождении с его хендофф-промтом побеждает тот. - -## Входное состояние (04.08, проверено исполнением, а не заявлено) - -- **Пройдено S0–S2:** план · инструменты и скриншот-цикл · `tokens.css` по замерам референса · - оболочка трёх панелей (`src/shell/`) · примитивы `src/ui/` на `react-aria-components` · - витрина `/showcase` и нагрузочный `/scale` (2284 раздела, 1200 терминов). -- `npm run check` — 5 гейтов (prettier · eslint тип-осведомлённый · stylelint · tsc · vitest, - **77 тестов**), `npm run check:full` — + сборка + три скриншота с гейтом доступности axe. - Всё зелёное на 04.08. -- **Данные всё ещё синхронная фикстура:** `src/api/` отдаёт объекты из `src/mock/` напрямую. - Это диспозиция Ф-15, а не недосмотр: асинхронность приезжает вместе с MSW, то есть в S3. -- **Гейты, которые ты застаёшь:** одно место для цвета и размера (TSX-половина в - `eslint.config.js`, CSS-половина в `stylelint.config.js`) · три шва — фикстуры видит только - `src/api/`, глобальный CSS только `src/main.tsx`, `react-aria-components` только `src/ui/` — - закрытые и для статического, и для динамического импорта · сеть запрещена вне `src/api/` - во всех транспортах (`fetch`/`EventSource`/`WebSocket`/`XMLHttpRequest`, включая - `window.*`) · тест общности: код языка не зашивается в разметку, стили не ветвятся по - `:lang(…)` · контракт-тест токенов и структурные тесты CSS-модулей. -- Правки S2 и дофикс по ревью ЗАЛЕНДЕНЫ (`02872b6`) — восстанавливать нечего, дерево фронта чистое. - ⚠ В дереве могут лежать незакоммиченные файлы ДРУГИХ зон (параллельные сессии — норма): не трогать - и не «прибирать». - -## Замок снят (оркестратор №14, 05.08) - -Контракт существует и ратифицирован (`docs/architecture/14-api-contract/`, D39.99), строка 95 -закрыта, вторая сторона контракта — платформа — уже написана и принята: её скелет живёт в -`platform/` и ратифицированные ответы платформы вошли в список правок спеки ниже. Раздел «Если -замок закрыт» оставлен как исторический — исполнять его НЕ надо. Один сохраняющийся запрет: -не начинать «пока на своих типах, потом поправим» — моки, снятые не с того контракта, разойдутся -с API, ровно ради чего строка 95 и заводилась. - -## Обязательное чтение до кода (порядок) - -1. `frontend/docs/FRONTEND_SESSION_PROMPT.md` — стоящий промт: сценарий §3, жёсткие ограничения - §4, «как работать» §7. **Его не редактировать.** ⚠ Раскладка §2 частично устарела — её - перевешивают решения владельца из журнала зоны. -2. `frontend/docs/frontend-PROGRESS.md` целиком: «Текущее состояние» · «Решения владельца по продукту» · - «Открытые вопросы» · хронику 04.08 (в ней — что S2 построила, где отошла от референса и что - поправило ревью оркестратора). -3. `frontend/docs/FRONTEND_PLAN.md` — §0.1 (карта канона: что читать перед чем), **§0.2 - (транспорт: с движком фронт не разговаривает никогда — это ратифицированный анти-паттерн, - D39.81/D39.85)**, §5.4 и §5.4.1 (формы обхода гейтов и названные границы), **§6 (что уже - известно про движок и как это меняет форму данных — читать до первой строки типов)**. -4. `frontend/docs/STACK_DECISIONS.md` — §2 пины (там уже названы `@tanstack/react-query` и `msw`), - §5 транспорт и правила стрима, §7 риск ре-ингеста. Библиотеки сам не выбирай и версии - по памяти не «обновляй»: твои знания об экосистеме устарели, сверка — live по npm. -5. `docs/research/23-engine-platform-seam.md` — `docs/README.md` требует читать его **перед любым - кодом стыка**; форма событий и правило ре-синка оттуда. -6. `frontend/docs/BACKLOG.md` — строки **Ф-14** (вход фронта в контракт), **Ф-15** (закрывается - этой сессией), Ф-19, Ф-21. -7. `references/*.png` и `.shots/*.png` — открой и посмотри до первой правки. - -## Правки спеки — ПЕРВЫЙ шаг S3 (список актуализирован оркестратором №15, 07.08: добавлены В-трис и В-кватер) - -Контракт ратифицирован. Спеку правишь ты: минорный бамп версии, регенерация типов, батарея, -компаньон-К-таблица получает статусы. **Ниже — ПОЛНЫЙ список; он вырос с 04.08**, потому что -платформа ответила на свои К-вопросы и владелец сменил модель лимитов. Порядок правок твой, -но ни одна не «на потом»: спека — нормативная поверхность, и на ней уже стоит код платформы. - -**А-нуль. Шапка `info` спеки уже исправлена оркестратором №15 (07.08) — НЕ возвращай её обратно.** -Три дня после ратификации файл называл себя «DRAFT of frontend session S3 — not a ratified -contract» и ссылался на компаньон по пути, которого рядом с каноном нет. Сейчас там сказана -правда: ратифицирован D39.99, канон в `docs/architecture/14-api-contract/`, зонная копия — -байт-зеркало, компаньон = `README.md` рядом с каноном. **Твоё в этом пункте одно:** строка -`version` всё ещё `0.1.0-draft` — бампни её первым же действием (минорный бамп, как и сказано -ниже), и байт-сверку копий из пункта Д делай уже с этой шапкой. - -**А. Решения владельца 04.08 (D39.100).** -1. **К-1:** десять статусов приняты — статусов больше не трогать. -2. **К-8:** `BookStatus` получает 11-е значение **`paused`** (резюмируемый стоп; в `failed` не - мапить — спека это уже запрещает). Оповещение «перевод остановлен: лимиты исчерпаны». -3. **К-5:** `eta_seconds` в прогресс-модель (движок отдаёт, `status.go:112`; поле опциональное). -4. **К-3:** метка главы — ИЗ ДАННЫХ книги; зашитых форм «Глава N» не существует, легальна книга - без номеров и глав вовсе. Проверь спеку И фикстуры на зашитую форму. - -**Б. Ратифицированные ответы платформы. Это уже НЕ вопросы — это форма, которую спека обязана -выразить.** - -> ⚠ Ссылки на `platform/docs/*` ниже и в разделе Г — **происхождение, а не задание.** Всё, что тебе -> нужно, приведено в этом промте целиком. В зону платформы ходить НЕ надо: там прямо сейчас живая -> сессия, её документы движутся, и промт, который зависит от чужого живого файла, ломается ровно в -> тот момент, когда сосед его правит. Если всё же полезешь — только читать, и знай, что читаешь -> черновик. -5. **К-4 (ревизия):** счётчик пер-КНИЖНЫЙ, одно и то же число несут все книго-скоупные чтения и - `id` кадра потока. Прозой в спеку: ревизия монотонна В ПРЕДЕЛАХ скоупа и между скоупами не - сравнивается · отбрасывание устаревшего чтения — обязанность клиента · докачка по - `Last-Event-ID` читает **`revision >= R`**, не `>` (одна транзакция = одна ревизия, но - НЕСКОЛЬКО кадров; строгое «больше» теряет кадры-братья) · после транзакции ПОЛНОЙ ЗАМЕНЫ - (банк пересобирается целиком, пере-чанковка заменяет главы) сервер обязан выдать - `resync_required`: дельта-чтение удаления выразить не может. -6. **К-7 (пагинация):** keyset-курсор на КАЖДОМ списочном ответе, `?limit=&cursor=`, - `next_cursor: string|null` присутствует ВСЕГДА (добавить позже — значит молча отрезать хвост - у клиента, который поля не читает). Дефолты: главы 5000 · банк 1000 · замечания 500. - ⚠ Курсор привязан к СТРУКТУРНОЙ эпохе (поколение манифеста / `chunker_version`), **НЕ к - ревизии книги**: ревизия бампается на каждой материализации, и привязка к ней даёт вечный - рестарт пагинации во время прогона на книге в 5000 глав. Отклонение протухшего курсора — - обязанность СЕРВЕРА (MUST), клиент её исполнить не может: курсор непрозрачен. -7. **К-12 (экспорт):** опрос, а не пуш. `202` + `Location`; статус-чтение отдаёт `ready:false` - с заголовком **`Retry-After`**, объявленным ЯВНО как заголовок этого 200-ответа (RFC 9110 - определяет его для 503 и 3xx — на 200 общая семантика не действует, поэтому объявляем сами). -8. **CSRF:** браузерный клиент обязан слать заголовок **`X-TM-Client`** на небезопасных запросах - cookie-пути. Место — описание `sessionCookie`. Несущим является ПРИСУТСТВИЕ заголовка, - значение любое: не выдумывай токенную семантику. -9. **`Run.paused_reason`** — машинная причина паузы либо `null`; фразу рисует клиент, API несёт - состояние. **Значение ровно одно и оно уже занято платформой: `credit_exhausted`.** (В редакции - этого промта от 05.08 стояло `limits_exhausted` — ошибка оркестратора, значение должно совпадать - с тем, что пишет платформа, иначе клиент не опознает причину.) - -**В. Решение владельца 05.08 — модель лимитов СМЕНИЛАСЬ.** Не подписка с окнами, а **БАЛАНС -кредитов** («покупка токенов как у OpenRouter»). Следствия для спеки: -10. Окон и `resets_at` НЕТ. Экран показывает ОСТАТОК, а не «сбросится через». Денежные СУММЫ - по-прежнему на провод не идут (D39.84) — процент остатка, не доллары. -11. Прежняя инструкция этого промта «API лимитов проектирует платформа, в спеку не выдумывать» - ОТМЕНЕНА: форма ответила (`GET /v0/usage`), и её надо выразить — но БЕЗ полей окон. Форма - приведена ЗДЕСЬ целиком, ходить за ней в чужую зону не нужно и не надо (промт, зависящий от - живого документа соседней зоны, ломается ровно тогда, когда сосед его правит): - - ```yaml - Usage: - required: [state, remaining_percent] - properties: - state: { enum: [ok, low, exhausted] } # low — порог показа предупреждения - remaining_percent: { type: integer, minimum: 0, maximum: 100 } - paused_reason: { enum: [credit_exhausted], nullable: true } - ``` - - Процент считается от суммы грантов аккаунта, не от «лимита периода»: периодов больше нет. - `Run.paused_reason` несёт то же значение на прогоне. Сумм нет ни в каком виде (D39.84). - (В редакции 05.08 этот пункт слал за схемой в `PLATFORM_DIRECTION.md` §2 — там её нет, там - денежная модель; ошибка оркестратора.) - -**В-бис. Поверхность входа — появилась в P1, в спеке её нет** (добавлено оркестратором 05.08 после -приёмки платформы P1; в редакции этого промта от 05.08 утра этого пункта не было, потому что кода -входа ещё не существовало). - -Платформа построила OIDC-вход. Четыре ручки живут ВНЕ версионного префикса, как `/healthz`, потому -что это механика сессии, а не контрактная поверхность: - -| Ручка | Метод | Что делает | -|---|---|---| -| `/auth/login` | GET | начинает вход, редиректит к провайдеру; принимает `?return_to=<путь на этом сайте>` | -| `/auth/callback` | GET | завершает вход, ставит сессионную куку, редиректит на `return_to` либо на дефолт | -| `/auth/logout` | POST | завершает ЭТУ сессию | -| `/auth/logout-all` | POST | завершает ВСЕ сессии пользователя («выйти везде») | - -15-бис. **Описать их в КОМПАНЬОНЕ, в `openapi.yaml` не тащить** — решение оркестратора как -владельца контракта. Клиенту нужно знать три вещи: куда вести на вход, что `return_to` принимает -только путь этого сайта (сервер молча заменит чужой на дефолт — открытый редирект закрыт), и что -обе `POST`-ручки лежат на cookie-пути, то есть требуют `X-TM-Client` из пункта 8. -Отказ входа — `problem+json`, как везде; различать причины отказа клиент не может и не должен. - -**Г. Ограничения скорости, которые спека обязана удержать** (замер и разбор — -`platform/docs/PLATFORM_DIRECTION.md` §4; для тебя это правила, а не предложения): -12. **Юниты читаются только пер-главно.** Пер-книжной ручки юнитов не заводить никогда — - на этом стоит вся память клиента (рабочий набор 27 КБ против ~62 МБ). -13. **Экспорт — артефакт по ссылке;** сборка текста книги на клиенте запрещена явно. -14. **Сервер ВПРАВЕ склеивать события прогресса**, клиент обязан терпеть скачки счётчиков — - записать в описания событий (иначе прогон на 9500 юнитов = неограниченный источник рендера). -15. **Заголовок главы ограничен по длине на сервере** — единственная неограниченная строка в - списке из 5000 строк. - -**В-трис. Управляемый потолок прогона — РЕШЕНИЕ ВЛАДЕЛЬЦА 07.08, поверхности в спеке нет** -(добавлено оркестратором №15 по приёмке платформы P2, D39.109/D39.110; в редакции 05.08 этого -пункта не было — решения не существовало). - -Проблема, которую это решает: перевод книги стоит денег, и человек должен уметь сказать «не -больше вот столько» ДО старта, а не узнавать пост-фактум. Сегодня потолок живёт только в конфиге -книги на стороне движка, и управлять им нельзя вообще. - -Форма, ратифицированная владельцем: **шкала в интерфейсе от минимума до максимума**, ноль выбрать -НЕЛЬЗЯ (подсвечивается серым — прогон с нулевым потолком не начнётся), виджет выбираешь сам -(ползунок — предложение владельца, не мандат). Три вещи в этой форме — «делай РОВНО так», потому -что каждая куплена проверкой: - -16. **Единица шкалы — ГЛАВЫ, а не доллары.** Не «поставить $3», а «перевести до N глав». Причина - жёсткая: D39.84 запрещает денежные суммы на пользовательском проводе и экране, и П-5 показывает - процент ровно поэтому. Доллары на этой шкале = амендмент D39.84, а он не выдан. Побочная - выгода: минимум шкалы объясняет себя сам — одна глава. -17. **Максимум шкалы = ДОСТУПНЫЙ остаток.** ⚠ **Первая редакция этого пункта говорила «баланс МИНУС открытые холды» — ошибка оркестратора, вычитание дважды; исправлено 08.08 по находке самой S3 (D39.115).** Холд — дебет в момент взятия, поэтому баланс уже без него. - Платформа берёт холд на сумму потолка ДО спавна прогона, поэтому шкала, упёртая в полный - баланс, запирает всё на одну книгу и вторую начать нельзя. Два числа платформа уже различает. -18. **Это потолок ПРОГОНА, не книги.** Он едет со стартом прогона и не является свойством книги; - в спеке ему место рядом с созданием прогона, а не в модели книги. - -⚠ Чего в спеке НЕ выражать: пересчёт «глав → деньги». Он живёт на платформе (по оценке движка) и -наружу не выходит ни в каком виде. Поверхность отдаёт границы шкалы и выбранное значение в главах. - -**В-кватер. ФРОНТ ЖИВЁТ НА ТОМ ЖЕ ORIGIN, что платформа — сегодня это не выбор, а факт** -(замер приёмки №15 на живом бинаре, строка PD-96 регистра платформы). - -CORS-слоя в платформе нет вовсе: preflight `OPTIONS` с чужим `Origin` получает 401 от гарда -сессии, заголовков `Access-Control-*` нет ни на одном ответе. Значит браузерный клиент с другого -origin неработоспособен как класс, а не «требует настройки». Для тебя два следствия: в деве ходи -через прокси dev-сервера на тот же origin (не напрямую на порт платформы), и **не проектируй ничего -вокруг кросс-origin запросов** — если продукт когда-нибудь потребует отдельный домен фронта, это -отдельная работа платформы, и она не сделана. Заголовок `X-TM-Client` (пункт 8) при этом обязателен -и на same-origin: он не про CORS. - -**Д. После правок:** байт-сверка зонной спеки с ратифицированной копией -(`docs/architecture/14-api-contract/openapi.yaml`); расхождение отдай оркестратору на -пере-ратификацию диффом — сам канон не правь. - -## Скоуп S3 — слой данных, и ни шагом дальше - -1. **`src/api/` становится асинхронным**: MSW как сетевой мок + серверное состояние на пинах - из STACK_DECISIONS §2 (версии сверить live на дату сессии; `.npmrc` держит `save-exact`). - Каждый новый пин — строкой в таблицу `FRONTEND_PLAN.md` с датой релиза и «зачем нам». -2. **Фикстуры всех состояний, а не одного счастливого:** ожидание · ошибка · пусто · - частично · длинный хвост · потеря соединения на стриме. Правило S1/S2, которое здесь - действует сильнее всего: **фикстура по умолчанию — трудный случай.** Наивный счётчик глав - должен на ней давать ноль (идёт черновая волна), иначе скриншот-цикл смотрит на удобное. -3. **Живой прогресс — `EventSource` за швом `src/api/`** (STACK_DECISIONS §5; гейт сети уже - запрещает его где-либо ещё). Докачка по `Last-Event-ID`/ревизии — часть контракта, не выдумка. -4. **Ф-15 закрывается здесь:** ветки ожидания/ошибки/пустоты появляются вместе с MSW, а не - после первого продуктового экрана. -5. **Типы `src/api/types.ts` приводятся к контракту.** Что в них сегодня заведомо временное: - булев `signed` вместо трёхзначного `auto|draft|approved` · ключ строки банка, собранный - из (`src`, `dst`, `type`), — у движка термин уникален по (`src`, `sense`, `since_ch`, - `until_ch`) · отсутствие ревизии для докачки. Всё это перечислено строкой Ф-14. - **Закрытые юнионы получают явную ветку неизвестного значения** (строка Ф-22) — сегодня её нет - ни у одного, и строгость тайпчека здесь НЕ страхует: `runStates[book.state]` - (`showcase/Library.tsx:103`) — обращение к `Record` по КОНЕЧНОМУ юниону, а - `noUncheckedIndexedAccess` добавляет `undefined` только индексным сигнатурам (проверено `tsc` - на пробе: обращение по юниону компилируется молча, ругается только `Record`). - Значит состояние прогона из будущего контракта даёт `undefined.tone` — падение дерева - библиотеки, а не пустую метку; `noteTone` тем же классом тихо уводит незнакомую ступень - замечания в СПОКОЙНУЮ ветку. **Место ветки — шов `src/api/`, где значение входит**, а не - каждый компонент: перевод «вердикт → вид» уже расползался по экранам, и контрольный вопрос - владельца требует, чтобы новое значение правило один файл. -6. **Поля не выдумывать.** Нет в контракте — это вопрос владельцу/оркестратору в - «Открытые вопросы» журнала зоны, а не догадка в типе. Дефект «фикстура выдумала поле» - в этой зоне случался дважды и оба раза стоил экрана. - -**Не в скоупе:** экраны S4–S7 · редактор текста · светлая тема · мобильная раскладка · -React Compiler (Ф-2) · Tauri (Ф-5). - -## Если замок закрыт - -Контингенция на случай, если проверка замка даст «закрыт» (на вечер 04.08 замок ОТКРЫТ); тогда правильный ход — не ждать молча и не строить экраны -на синхронных моках (порядок этапов Ф-1 стоит именно на слое данных). - -- **Доведи Ф-14 до артефакта, который можно отдать автору контракта:** не список намерений, - а перечень с обоснованием на каждый пункт — язык кодами · состояние прогона отдельно от - выполнения главы · прогресс пофазно по ЮНИТАМ · ревизия/`Last-Event-ID` · трёхзначный статус - подписи · поля банка (`type`/`sense`/`since_ch`) и ключ строки · продуктовый словарь вердиктов - (ПТ-33; §4.1 запрещает протечку внутренностей конвейера на экран). Половина уже написана - в строке Ф-14 и в §6 плана — собери, а не сочиняй заново. -- Отдай его оркестратору пингом в `frontend/docs/frontend-PROGRESS.md` и **остановись**: - заводить контракт своим решением фронт не может (шапка `BACKLOG.md`). - ⚠ **Испр. сессией S3 04.08 по слову владельца:** здесь стояло «пингом в `docs/PROGRESS.md`» — - это чужая зона, и шапка журнала фронта фиксирует решение владельца 02.08 «в `docs/PROGRESS.md` - оркестратора не пишут». Канал передачи — журнал своей зоны; оркестратор пишет туда же. -- Ф-16, Ф-17, Ф-18, Ф-20 — **не трогать**: у каждой в бэклоге стоит свой триггер, и ни один - из них не наступил. - -## Ловушки, купленные S2 — не переоткрывать - -- **`react-aria-components`:** `Tab` не принимает клавиатурных обработчиков (обработчик живёт - на ряду вкладок) · у роли `tab` дети презентационные, поэтому крестик закрытия — не кнопка - (axe роняет `nested-interactive`), закрытие с клавиатуры — `Delete`, объявить его нечем (Ф-17) · - **невыбранная `TabPanel` не рендерится вовсе** (`dist/private/Tabs.mjs:276`), отсюда потеря - прокрутки при переключении вкладки (Ф-19, замерено дважды) · `Tree` — это `treegrid`/`row`, - а не `treeitem`; раскрытие — `