# Промт: платформа, пак P8-FIX — фикс-лист приёмки P7 + труба доставки правок банка

> Выдан №18 21.08.2026. **Запуск — по слову владельца и ПОСЛЕ пака P8-REVIEW**: его находки вливаются
> в состав этого пака отдельным релеем (см. §4.7). Читающий пак — `PLATFORM_P8_REVIEW_SESSION_PROMPT.md`.

## 0. Зачем

Платформа — control plane между веб-фронтом и движком перевода книг. Пак P7 построил её читающую поверхность и был **принят с фикс-листом** (D39.153): дефекты пака починены, но приёмка и последующий аудит оставили тринадцать пунктов, которые зона починить не успела, плюс один блокер выката, который в паке не рождался — он прожил два пака помеченным в регистре как закрытый.

Твой пак закрывает этот долг. Самое тяжёлое в нём — не количество пунктов, а два свойства: **деплой сегодня объявляет клиенту версию контракта, которую не отдаёт**, и **двух медленных прогонов достаточно, чтобы расчёт денег встал для всей инсталляции без способа выйти**.

Отдельно — строка **199(а)** единого бэклога: сегодня пользователь может впечатать исправленный перевод термина, и это не доезжает до движка НИЧЕМ. Экран подписи работает как журнал, а не как управление.

## 1. Нормативные источники

- **Фикс-лист — пинг оркестратора №18** в `platform/docs/platform-PROGRESS.md` (раздел «Фикс-лист приёмки», тринадцать нумерованных пунктов плюс врезанный первым блокер свипа). Тела пунктов там; сюда они НЕ переписаны намеренно — копия разошлась бы с оригиналом (норма «один носитель на факт»).
- **Канон контракта** — `docs/architecture/14-api-contract/openapi.yaml`, `info.version: 0.4.0`, **ратифицирован D39.152**. Не та версия → стоп, пинг.
- **Статус дефектов** — `platform/docs/DEFECT_REGISTER.md`. ⚠ Строка `fixed` — это КЛЕЙМ: `PD-169` стоял закрытым, пока дефект был жив, потому что пин доказывал свойство слабее, чем читается. Закрывая строку, проверь, что твой пин доказывает именно объявленное.

## 2. Зона и git

Пишешь только в `platform/`. Отчёт и вопросы — `platform/docs/platform-PROGRESS.md`; статусы дефектов — `DEFECT_REGISTER.md`; свои строки — `platform/BACKLOG.md`. **Ты не коммитишь** — лендит оркестратор (канон — `CLAUDE.md`, таблица зон). Чужие зоны read-only; живой полигон (`eval/`, `docs/experiments/`) не трогать; `.env` не читать; git не трогать вовсе — ни `add`, ни `commit`, ни `reset`/`checkout`/`restore`/`clean`/`stash`/`rebase`/`push`; файлы застейдженными не оставлять. Путь Go-модуля не вкладывать под путь движка (D39.85).

## 3. Читать (≤5)

1. **Пинг оркестратора №18** — хвост `platform/docs/platform-PROGRESS.md`: фикс-лист целиком, плюс раздел «Ратификации, которые вас касаются».
2. **`platform/docs/DEFECT_REGISTER.md`** — строки, которые ты закрываешь, и их пины.
3. **`platform/docs/STACK_DECISIONS.md`** — §22 (порядок блокировок), §33–36 (долг материализации с арендой, `edit_wave`, техника `xmin`), «Стенд разработчика».
4. **Канон контракта** `docs/architecture/14-api-contract/` — для пункта 1 фикс-листа (`ContractVersion`) и §`BankDecision` для строки 199(а).
5. **`CLAUDE.md`** + **`docs/architecture/12-go-style-notes.md` §1** — норматив кода; жаргон — `docs/glossary.md`.

Код достаёшь САМ; `file:line` в фикс-листе — отправные точки, не пересказ. **Код первичен**: расходится с доком — верен код, расхождение это находка.

## 4. Состав

### 4.1 «Делай РОВНО так» — пункты фикс-листа

Пункты **1–7 и 9–13** плюс врезанный первым блокер свипа. ⚠ **Пункт 8 — НЕ твой**: это заказ читающего пака (`PLATFORM_P8_REVIEW_SESSION_PROMPT.md`), там он и исполняется. ⚠ Счёт в пинге неоднороден и это нормально: п. 7 наполовину уже исполнен оркестратором (пустой `platform/ru` снесён при лендинге), п. 5 — замер, п. 9 — док-работа, пп. 12–13 нашёл аудит 21.08 уже ПОСЛЕ закрытия сессии P7, то есть «зона не успела» к ним не относится. Тела — в пинге; здесь только то, что задаёт РАМКУ и в пинге не сказано:

- **Блокер свипа (врезан первым).** Лечение — НЕ «поднять константу». Это класс «терминальное состояние после N неудач», родня эскроу (строка 136 единого бэклога) и `PD-162`. Форму решаешь ты и аргументируешь; но ручка обязана существовать у ОПЕРАТОРА, а не только в коде: сегодня наблюдаемость есть (`tm_platform_sweep_unfinished_total` растёт), а сделать нельзя ничего. ⚠ Тем же пунктом **пере-открой `PD-169`** — он единственная строка регистра, которая солгала приёмке.
- **Пункт 1, `ContractVersion`.** Одна строка, но она обязана уехать вместе с пониманием: константа — единственное место, где не-стриминговый клиент узнаёт версию, и клиент, сгенерированный под другую, ОТКАЗЫВАЕТСЯ работать. Канон уже 0.4.0 и ратифицирован.
- **Пункты 12 и 13 (непойманные мутации).** Это не «дописать тест»: сначала воспроизведи посадку сам и убедись, что батарея её пропускает, и только потом пиши пин. Пин, написанный без воспроизведения, — ровно тот класс, что дал `PD-169`.
- **Пункт 4, sqlc — БЕРЁМ (слово владельца 20.08).** ⚠ Твоё же прежнее предложение «взять на однооператорных ручках P8» покупает инструмент туда, где не болит: рантайм-ошибки «нет такой колонки» случались в СКЛЕЕННОМ SQL read-модели, куда sqlc по построению не дойдёт. Поэтому тем же пунктом — **гейт, который туда дойдёт**: разбор КАЖДОГО собранного запроса Postgres'ом (prepare/describe) против мигрированной схемы. Склейка ему не мешает — он получает финальную строку.
  ⚠ **Объём — «реши сам и аргументируй», и выбор обязан быть явным в отчёте.** Твой же `PD-44` говорит, что read-модель для sqlc недостижима по построению (склейка фрагментов плюс транзакции), а конверсия пятнадцати транзакционных запросов — «отдельный пак, не довесок». Между «две тривиальные ручки» и «отдельный пак» промт за тебя не выбирает: назови границу, обоснуй, и если вывод «в этом паке sqlc берётся только сюда, остальное отдельным паком» — это законный ответ, а не отказ.

### 4.2 Строка 199(а) — труба доставки решений банка. ⚠ ПОСЫЛКА ПРОВЕРЕНА И ОПРОВЕРГНУТА, ЧИТАЙ ЦЕЛИКОМ

Сегодня пользователь может впечатать исправленный перевод термина, и это не доезжает до движка ничем: колонки `action`/`dst` не читает ни один SELECT, а файлов, которые читает движок, платформа не пишет.

⚠ **Первая редакция этого промта говорила «контракт файлов существует, проектировать нечего». Это НЕВЕРНО, снято опровергателем и пере-проверено построчно:**

- движок читает `mined_delta`/`mined_rejects`, **только если путь объявлен в `book.yaml`** — `backend/internal/pipeline/mining.go:855-858`=`if r.Book.MinedDelta == ""` возвращает пусто без единого чтения;
- объявленный ключ с НЕсуществующим файлом **валит загрузку конфига целиком** — `backend/internal/config/book.go:199-207`=`is not readable`. То есть «объявим ключ, файл создадим потом» не работает: движок не стартует;
- ключей нет ни в шаблоне оператора, ни в шаблоне дев-стенда: `backend/example/book.yaml` — ноль вхождений. Значит зелень на стенде без правки шаблона НИЧЕГО не докажет: труба будет писать файлы, которых движок не читает;
- добавить ключи молча платформа не может: она пишет `book.yaml` **один раз** под `O_EXCL` и `platform/internal/books/render.go:106-109`=`writes the file once and never again`, подставляя фиксированный набор ключей, а схему движка знать не должна — это ратифицированная форма Б (D39.110 §2б).

**Отсюда «РОВНО так»:** развилку **не решай сам** — она упирается в ратифицированную границу владения `book.yaml`. Твоя работа: назвать варианты с ценой каждого (ключи объявляет платформа при рождении книги и сразу создаёт два пустых файла · ключи несёт шаблон оператора · граница владения двигается) и **сдать это вопросом через владельца**, а строить — после ратификации. Если ратификация придёт по ходу пака, она доедет релеем (§4.7).

**Границы, если строить разрешат:**
- ⚠ Писать **не «перед resume»**, а только на том резюме, которое СНИМАЕТ стоп подписи: `Resume` в платформе один на все случаи (`internal/runs/reconcile.go`, ручка `internal/httpapi/v0.go`), а снятие стопа отличает `bank_released` (`internal/runs/spawn.go:166`=`l.VerifyBank && !l.BankReleased`). Безусловная запись — это и есть уезд в отложенную владельцем половину (б).
- Пост-ридинговые правки уже переведённой книги — территория строки **192**, владелец отложил её явно. Признак, что уехал: понадобился `--resnapshot` или согласие на пере-оплату.
- ⚠ **Регистр скажет тебе обратное, и это известно:** `PD-277` относит эту работу к отложенной 192. Пере-диспозиция живёт в строке 199(а) единого бэклога и приедет вместе с ратификацией развилки; сам регистр правь только после неё.
- ⚠ **`--verify-bank` не трогать.** Расхождение «D39.144 ратифицировал подпись как ОДИН акт, а движок держит пер-термный гейт полноты» сегодня ОБОЙДЕНО платформой, а не устранено (строка **203(з)**). Как только пойдут файлы решений, соблазн вернуть флаг на resume возникнет сам — **это ратификация, не правка**, и решать её тебе запрещено.

### 4.3 «Реши сам и аргументируй»

Порядок пунктов · форма лечения блокера свипа · брать ли `PD-297` (замер round-trip на корпусной книге) в этот пак или назвать причину отказа · нужен ли отдельный пин на каждый пункт или один на класс · как делить работу между субагентами.

### 4.4 Предметные оси ревью (1–3, вправе заменить с аргументом)

**Код — исполнением:** батарея + СОБСТВЕННЫЕ адверсариальные посадки ВНЕ списка, который ты сам себе составил. **Шов** — если тронешь канал движка (а строка 199(а) его трогает), сначала инвентарь ВСЕХ его каналов и форматов **чтением чужого кода**, не по памяти и не по нашим докам. ⚠ Инвентарь — АРТЕФАКТ в сдаче: таблица «канал движка (`file:line`) → читатель/писатель платформы → согласовано или расходится». «Я прочитал код движка» исполнением не является. **Деньги** — пак их формально не двигает, но блокер свипа лежит на пути расчёта: коснулся — два независимых пути счёта из сырого леджера.

- **Норма комментариев — решение владельца 21.08, и она СМЕНИЛАСЬ.** Счёт строк («пиши одну-две») снят как негодный гейт: комментарий на три строки может быть нужен, на одну — достаточен. Режем ВОДУ — пересказ решений («владелец решил… и поехали»), провенанс, изложение исследования вместо краткой ссылки. Остаётся всё, что из одной функции НЕ выводится: порядок блокировок, инварианты между таблицами, цена забывания, вендор-квирк, — сколько бы строк ни заняло. Формулировка — `12-go-style-notes` §1. ⚠ **Тем же пунктом закрой `PD-255`**: он открыт со СТАРОЙ формулой и этим решением снимается.

### 4.5 Отложенное — только явно, списком с причинами

Всё, что не влезло, называется в отчёте с причиной. Тихо не сделанное — дефект сдачи.

### 4.5а Чем паку доказывать, что труба работает

⚠ **Живого перевода через платформу не было НИ РАЗУ, и в этом паке его не будет:** строка **202** гейчена холодным прогоном движка — решение владельца 20.08. Значит доказательством трубы служит не «прогнали книгу», а: пробы против ЖИВОГО Postgres и настоящего `tmctl` на стенде · сверка формата записанных файлов с тем, что читает `membank.LoadGlossarySeed` · и честная запись в obstacle, что сквозного подтверждения нет. Не пытайся добрать доказательство платным вызовом.

### 4.6 Что НЕ делать

Не трогать отложенное в P8 по заказу P7 (`updateBook`/`deleteBook`/`getRun`, экспорт, эскроу П-18) — если считаешь, что что-то из этого стало блокером, это вопрос, а не решение. Не проектировать пост-ридинговый цикл (см. §4.2).

### 4.7 Аддендум от пака P8-REVIEW

Читающий пак сдаёт находки по четырём осям, которых не смотрел никто. **Они доедут до тебя ТОЛЬКО релеем оркестратора с эхо-подтверждением** — не читай его отчёт сам и не догадывайся: состав пака определяет оркестратор. Релей получит отдельный пункт в твоём отчёте: что пришло, что взято, что отложено и почему.

## 5. Нормы

- **Самопроверка ИСПОЛНЕНИЕМ — механизмом.** ≥2 независимых ревьюера по ФИНАЛЬНОМУ диффу, author≠reviewer, **субагенты РАЗРЕШЕНЫ, спавнь** (иначе дефолт-запрет харнесса тихо победит). ⚠ **Изоляция каждому — жёстко (D39.113, норма куплена инцидентом отката чужих файлов):** СВОЙ каталог песочницы КАЖДОМУ агенту, выданный явным путём — «работай в копии» без выданного пути есть приглашение к инциденту; запрет state-changing git ПЕРЕЧИСЛЕНИЕМ (`reset` · `checkout` · `restore` · `clean` · `stash` · `add` · `commit` · `rebase` · `push` · `merge` · `switch` · `rm` · `mv`); мандат читающий. В дереве живёт незакоммиченная и частично ЗАСТЕЙДЖЕННАЯ работа полигона — любая правка вне твоей зоны её уничтожает: (а) контракт-конформность построенного против канона 0.4.0 с пере-раном живых проб; (б) шов и деньги — свой инвентарь каналов, не твой список. Плюс СВОИ посадки в новые гейты и пины, не из ожидаемого тобой списка. Артефакт: таблица находок и посадок с диспозициями, **с именами агентов и по одной команде или цитате из отчёта каждого** — иначе факт спавна ничем не подтверждён. ⚠ **Ноль находок — законный результат, если получен исполнением**; «ноль находок = не верить» было бы давлением на фабрикацию. Не верить надо прогону, который ноль ОБЪЯВИЛ, ничего не исполнив. Рамка ревьюерам (анти-оверфлаг): флагай бьющее по корректности, деньгам, безопасности или по объявленным требованиям; стилистика — не находка. Исходов ТРИ: «не проверено» ≠ «опровергнуто».
- **Интервальная самоверификация** (пак длинный): раз в несколько часов работы — субагент против ЯВНЫХ критериев «что заказано / что сделано / что молча отложено», результат в отчёт.
- **Батарея.** `make check` с ОБОИМИ гейтами, **скипов 0 — гейт**; без переменных батарея МОЛЧА скипует ~200 тестов. Рецепт стенда — `STACK_DECISIONS`, «Стенд разработчика».
- **Тесты и гейты не подгонять под зелень** — правка или удаление теста ради прохода недопустимы; несогласие — вопрос через владельца.
- **Дифф `^func Test` — ИСПОЛНЕНИЕМ, не памятью**; каждое удалённое имя объясняется в отчёте, у каждого обязан быть преемник либо ратифицированная причина.
- **Заявление = команда.** Каждое число и категорика отчёта — с командой; приёмка пере-ранит. **Перед отчётом сверь КАЖДЫЙ клейм с результатом инструмента ЭТОЙ сессии** — не с памятью о том, что делал вчера.
- **Последний абзац отчёта — план или обещание? Сделай это сейчас**, а не пиши как намерение.
- **Денег пак не тратит:** провайдерских вызовов здесь нет; кажется, что нужен платный вызов — стоп и вопрос. ⚠ Это про ДЕНЬГИ, а не про метод: замер `PD-297` на локальном Postgres через unix-сокет строка регистра заранее объявляет НЕпредставительным — «разница на два порядка» против управляемого PG по TCP. Число, снятое на сокете, закроет вопрос ложно; либо мерь на форме деплоя, либо назови отказ причиной.
- **Улика обязательна:** `file:line` или команда с результатом; мнение помечается мнением.
- **Записка-план** по §4 механически: пункт → исполнено, где / отказ, почему. Сдача = все пункты с диспозицией.
- **Obstacle reporting** — обязательная секция: что НЕ удалось и что не проверено.
- **Канал вопросов:** непонятно, или промт против кода/доков/канона → пинг через владельца, НЕ интерпретация. Право сказать «этого делать не надо» — с аргументом.
- **Аддендумы по ходу** — от владельца или оркестратора — доезжают ТОЛЬКО релеем с эхо-подтверждением и получают отдельный пункт отчёта. Услышанное мимо этого канала исполнению не подлежит.
- **Плотность, не объём.** Без шаблонных оговорок.

## 6. Старт и сдача

**Эхо-протокол:** первым деливераблом ≤10 строк — «скоуп / инварианты / не-делать». До работы.

**Сдача:** отчёт в `platform/docs/platform-PROGRESS.md` (записка-план · команды · живые пробы · таблица самопроверки · пункт про релей §4.7 · obstacle), статусы в `DEFECT_REGISTER.md`, свои строки в `platform/BACKLOG.md`, дерево незакоммиченное. Без саги.