diff --git a/docs/BACKEND_SILENT_HARM_SESSION_PROMPT.md b/docs/BACKEND_SILENT_HARM_SESSION_PROMPT.md new file mode 100644 index 00000000..5a2d0ee1 --- /dev/null +++ b/docs/BACKEND_SILENT_HARM_SESSION_PROMPT.md @@ -0,0 +1,204 @@ +# Промт: бэкенд, пак «тихая порча» — книга уезжает неправильной, а тот, кто её читает, признака не видит + +> **Выдан оркестратором №19, 27.08.2026.** Пак идёт ПАРАЛЛЕЛЬНО платформенному P9 (зоны не +> пересекаются). Оба его пункта гейчены одним событием — **первым платным прогоном книги**, — и это +> событие следующее в очереди проекта. Пока они открыты, платить за прогон значит платить за брак, +> который увидят не все и не сразу. + +## §0. Какая проблема и что решит твой результат + +Продукт обещает две вещи: **консистентные термины на всю книгу** и **честный текст на выходе**. +Сегодня оба обещания могут быть нарушены так, что **человек, получивший результат, ничего не заметит**. + +**1. Эскалация теряет банк памяти.** Конвейер собирает ДВА системных сообщения — базовый промпт и +инъекцию банка (`internal/pipeline/render.go:256` и `:258`). OpenAI-совместимый слой Gemini принимает +РОВНО ОДНО и лишние выбрасывает молча. Gemini стоит третьим хопом дефолтной цепочки боевого конфига +(`configs/pipeline-c1.yaml:129`). Итог: глава, доехавшая до этого хопа, переводится **без канона +имён** — то есть ровно без того, ради чего банк памяти существует. Носитель — строка **208**. + +⚠ **Точность, без которой ты будешь чинить не то (нашла контрактная сессия).** Дефект НЕ невидим +целиком: пост-чек глоссария **работает ВСЕГДА** (`config/pipeline.go:445-452` — «ALWAYS runs… +converting silent glossary drift into a loud, visible signal») и меряет финал против того, что движок +СОБРАЛ (`waverun.go:429` и `:542`, `Postcheck(memSel.Injected, …)`). Инъекцию выбросил сервер, а не +движок, — значит промахи **конфирмятся и пишутся в retrieval-state**. Дефект **виден оператору +телеметрией и НЕвиден на проводе** (`postcheck_misses` не в аллоулисте; гейт `postcheck_gate` в боевом +`c1` отсутствует ⇒ дефолт false, ни флага, ни замечания). **Пост-чек — НЕ лечение**, он свидетель. + +⚠ **У дефекта ДВА пострадавших канала, а не один.** Тем же вызовом собираются предложения терминов +для банкноты (`waverun.go:363`, `sr.BankProposals` — «the WHAT channel»). Хоп без канона генерит +предложения без контекста банка, они едут в карту подписи, и **владелец подписывает из отравленного +списка**. Цена дефекта удваивается. ⚠ И третье: `:542` — это волна РЕДАКТОРА, то есть тот же хоп +молча съел бы **правки владельца**, доставленные вчерашней дверью (D39.161 обещает `depth: refinement` +— «правка доезжает до следующего прогона»). + +**2. Дыры выдачи молчат в САМОМ ТЕКСТЕ — и только в нём.** Выпавший член юнита исчезает из +отгруженного текста без маркера: читатель получает склейку и признака в тексте не видит. +⚠ **Формулировку сузила контрактная сессия, и сужение существенно: ПРОВОД признак несёт.** Компаньон +контракта обещает различение дословно — «флаг+текст → `translated` с замечанием; флаг+пусто → +`withheld`», — то есть платформа и экран о замечании узнают. Слепа именно ВЫГРУЗКА: человек, который +получил файл с переводом, замечания не видит. Носитель — строка **193**. + +**Что решит результат:** после пака брак либо не возникает, либо ВИДЕН — и первый платный прогон +можно покупать, не гадая, что он вернёт. + +## §1. Зона записи и git + +**Твоя зона — `backend/`.** Итоги и находки — своя секция журнала `docs/PROGRESS.md` («Бэкенд»). + +- **Ты НЕ коммитишь.** Лендит оркестратор после адверсариальной приёмки. Канон — `CLAUDE.md`. +- ⚠ **`platform/` НЕ ТРОГАТЬ ВООБЩЕ: там прямо сейчас работает пак P9.** Нужна правка на той стороне — + это пинг, а не правка. +- `docs/` (кроме своей секции журнала), `frontend/`, `eval/` — не трогать. В дереве незакоммиченная + работа полигона (20 позиций) — не касаться. + +## §2. Карта чтения — ≤5 позиций, ЗАКОН + +1. **`docs/experiments/00-provider-quirks.md`** — ⚠ **читать ПЕРВЫМ и ОБЯЗАТЕЛЬНО: это норма + `CLAUDE.md`** («провайдерские ловушки — читать ПЕРЕД правкой адаптеров и вызовов»). Твой пункт 1 — + ровно правка адаптерного пути. +2. **Сборка сообщений и провайдеры:** `internal/pipeline/render.go:250-260` (два системных) · + `internal/llm/httpllm.go:513` (`toOpenAIMessages`) · `internal/llm/provider_anthropic.go:145,163` + (у Anthropic системные — отдельные блоки с `cache_control`) · `internal/llm/capability.go` + (per-провайдерные квирки живут ЗДЕСЬ). +3. **Конфиги:** `configs/models.yaml:110` (gemini через OpenAI-совместимый слой) · + `configs/pipeline-c1.yaml:118-133` (цепочка эскалации; ⚠ раннер исполняет SINGLE-HOP, и при + `budget_usd=0` эскалация не исполняется вовсе — достижимость зависит от конфига, см. §3.1). +4. **Экспорт:** `internal/pipeline/export.go` — вокруг `:211-230` (c-lite: юнит флагается, когда член + выпал) и `:315-330` (диспозиции и `final_hash`). +5. **`docs/architecture/12-go-style-notes.md`** — норматив зоны, только больные места. + +## §3. Состав пака + +### §3.1. Инъекция банка не должна теряться — ЗАКАЗ; форма лечения СВОБОДНА + +**Заказано:** после пака инъекция банка доезжает до модели на КАЖДОМ провайдере цепочки, либо вызов +падает громко. Молчаливая потеря недопустима. + +**Свободен и обязан обосновать — ГДЕ лечить.** Два очевидных места, оба со своей ценой: +- **свернуть системные сообщения в одно прямо в `toOpenAIMessages`** — просто, но меняет провод ВСЕМ + OpenAI-совместимым провайдерам, а не только тому, кто этого требует; +- **завести квирк в `capability.go`** («принимает одно системное») и сворачивать только тем, у кого он + стоит — точнее, но это новая ось в реестре возможностей. + +**Что знать, прежде чем выбирать** (проверено мной, но пере-проверь): +- `toOpenAIMessages` кладёт сообщения ОДИН-В-ОДИН, сворачивания нет; её собственный комментарий + говорит, что `CacheBoundary` на этом пути **бессмысленна** (кеш префиксный и автоматический), и + важен только ПОРЯДОК стабильного префикса — значит сворачивание кеш не портит; +- у **Anthropic** путь другой: системные становятся отдельными блоками, а `CacheBoundary` — реальным + `cache_control`. **Сворачивать там нельзя**, и правка не должна его задеть; +- **достижимость сегодня ограничена:** раннер исполняет SINGLE-HOP, при `budget_usd=0` эскалация не + идёт. Дефект от этого не перестаёт быть дефектом — он ждёт первого конфига с бюджетом. + +⚠ **Второй вред, и он денежный.** В день, когда включат `postcheck_gate` (задумано после E1), +потерянная инъекция превратит купленный эскалационный хоп — **самый дорогой, апекс цепочки** — в +`flagged → withheld`: заплатили за текст и выбросили его гейтом. + +⚠ **Норма проекта, исполнить буквально:** поведение провайдера берётся из **официальной документации +вендора**, а не из рассуждения. Клейм «принимает ровно одно системное сообщение» — **пере-проверь по +вендор-доке** и приложи ссылку. Не подтвердилось — это находка, и пак меняется. + +### §3.2. Дыры выдачи обязаны быть ВИДНЫ — ЗАКАЗ; форма маркера СВОБОДНА + +**Заказано:** отгруженный ТЕКСТ не может молча недосчитаться куска. Либо кусок на месте, либо его +отсутствие видно ТОМУ, КТО ЧИТАЕТ ФАЙЛ. **Форма свободна ровно в этих границах: маркер в тексте ЛИБО +аннекс в самом отгружаемом файле.** ⚠ Код выхода и сводка «где-то в отчёте» заказ НЕ закрывают — +читателю файла они не видны никогда; прежняя редакция промта их предлагала, и это было противоречием +собственному критерию (нашла контрактная сессия). + +⛔ **Жёсткое ограничение: маркер — ПРОЕКЦИЯ экспорта, а НЕ мутация финального текста в сторе.** Две +причины, обе проверены: (а) вклеив маркер в текст юнита, ты превратишь `флаг+пусто` в `флаг+текст`, и +провод перечитает `withheld` как `translated` — сломается ровно обещание компаньона §2.7; (б) +сдвинется `final_hash` (`stagerun.go:236`) — то есть чекпойнты и перекупка волн. **Безопасное место — +рендер выгрузки**, и прецедент рядом: `ApplyHeading` (`export.go:236`) вклеивает титул именно там. + +⚠ **Классов дыр ТРИ, а строка 193 якорит один. Реши по каждому и обоснуй:** (а) c-lite member-drop — +юнит теряет часть текста; (б) юнит целиком `withheld` — экспортится `""`, кусок отсутствует молча; +(в) gate-override `glossary_miss` — `DispOK` с подтверждённым промахом экспортится `""` +(`export.go:320-323`). +⛔ **АНТИ-скоуп:** юнит, у которого санитайзер снял разметку, текст НЕ потерял — маркер на нём +**дезинформирует** читателя. Не помечать. + +⚠ **Язык маркера — это ДАННЫЕ пары, а не строка в Go.** Словесный маркер едет на языке ЦЕЛИ, значит +его место в langpack (прецедент — `heading.txt`), либо маркер языконейтральный. Захардкоженная строка +одного языка формально «не ветвится по паре» и всё равно нарушает мандат общности `CLAUDE.md`. +⚠ **Проверь прежде, чем строить: что из этого уже есть.** Провод различение несёт (§0 п.2), и, может +статься, экспорт тоже несёт что-то, чего строка 193 не знает, — тогда пак сужается, и это находка. + +⛔ **Новых причин флага НЕ заводить.** c-lite уже несёт причину первого выпавшего члена +(`export.go:225-230`); незнакомая причина по построению падает в `unspecified` на проводе — это +ратифицировано. Карта причин живёт в `platform/internal/ingest/notes.go`, а **платформа заперта паком +P9**, и положить туда новую причину НЕКУДА. Причины переиспользуй; если новая неизбежна — прими +`unspecified` и пингани. **Мост между exit-контрактом и `Note.code` НЕ строить.** + +⚠ **Якоря строки 193 подсохли — не верь им, грунтуй сам.** Строка называет `export.go:211-223` и +`:324-329`; я сверил — механизм c-lite действительно рядом (`:227` и `:320` ставят `DispFlagged`), но +второй якорь показывает ветку `DispOK` с громким отказом на пустой `final_hash`, а не то, что строка +обещает. **Установи текущую правду сам** — код первичен, строка бэклога вторична. + +### §3.3. Чего в паке НЕТ — пропуски подписаны + +- **Читающая сторона банка** (строки **221**/**224**/**226**) — форма разобрана консилиумом 27.08, но + её потребитель (экран подписи) ЗАМОРОЖЕН, и строить проекцию без живого потребителя значило бы + завести ровно тот класс дефекта, который назван в `18-bank-ontology.md`. Ждёт заказа экрана. +- **Деньги банковых ролей** (**194**, **197**) — другая тема, гейчена следующим касанием денежного + пути. Не бери попутно. +- **Строка 198** (апгрейд стирает замечания) — нужна платформенная половина, а платформа занята P9. + +## §4. Самопроверка ИСПОЛНЕНИЕМ — «перечитал сам» её не удовлетворяет + +1. **Батарея зоны** под `-race`, линтер 0 issues; числа — с командами. +2. **Пункт 1 — тест обязан утверждать ПОСТ-ФИКСНЫЙ инвариант, а не наличие сообщений.** + ⛔ Прежняя редакция («покажи, что инъекция в запросе есть») была ВЫРОЖДЕННОЙ: `toOpenAIMessages` + кладёт сообщения один-в-один, оба системных в запросе есть и СЕГОДНЯ — теряет их сервер. Такой + тест зелен на непочиненном коде. Утверждать надо: **у провайдера с квирком системное сообщение + РОВНО ОДНО и инъекция внутри него; у Anthropic — два блока и живой `cache_control`.** + ⚠ И гонять ОБА пути — черновой (`waverun.go:429`) и РЕДАКТОРСКИЙ (`:542`): вчерашняя дверь правок + доставляет владельческие правки именно вторым. Фейковый провайдер и харнесс $0 в репо есть, + платных вызовов пак НЕ требует. + ⚠ Дешёвый второй замер после фикса: кривая пост-чек-промахов на эскалационном хопе обязана упасть. +3. **Пункт 2 доказывается ТЕКСТОМ:** на ОДНОМ и том же состоянии с выпавшим членом покажи отгруженный + текст **до правки и после правки** (не «до и после выпадения» — это другое). Разница и есть + деливерабл. +4. **Свои посадки мутаций:** минимум по одной на пункт; вердикт — по ДЕЛЬТЕ против чистой базовой + линии и по ТОПИЧНОСТИ упавшего теста, не по цвету батареи. + +**Субагенты РАЗРЕШЕНЫ явно** (иначе дефолт-запрет харнесса тихо побеждает). **Опровергатель на выбор +места лечения в §3.1 — ЗАКАЗ, не право:** он получает оба варианта и мандат «покажи, где предложенное +ломает Anthropic-путь или кеш». Находки в отчёт, включая отвергнутые с причиной. +⚠ **Веер: 2–4 агента, не больше.** + +## §5. Оси ревью — 1–3, вправе заменить с аргументом + +1. **Ось «что увидит читатель книги»** — не оператор и не тест: человек, купивший перевод. +2. **Ось «пара, которой в репо нет»** — правка не должна ветвиться по паре или книге (мандат + общности `CLAUDE.md`); ревью-вопрос: «заработает ли на паре, которой ещё нет, без правки Go». +3. **Ось «детерминизм»** — трогаешь сборку запроса: не сдвинулись ли снапшоты, версии и хеши так, + что прогон перекупается. + +## §6. Записка-план, комплектность, «заявление = команда» + +**До правок** — записка-план в своей секции журнала. **В конце** — таблица комплектности против §3: +пункт → что сделано → каким ИСПОЛНЕНИЕМ подтверждено. Слово вместо команды = пункт НЕ сделан. + +## §7. Эхо-протокол старта — и проверка канала + +ДО работы — ≤10 строк: **скоуп · инварианты · не-делать**. **Первое действие — вписать свой блок в файл канала (§10), сразу второе — послать мне эхо** по +адресу оттуда: я увижу понимание скоупа до работы, ты убедишься, что канал жив. + +## §8. Obstacle — обязательная секция + +**«Что НЕ удалось и что НЕ проверено»** отдельной секцией, не россыпью. + +## §9. Канал вопросов и твоё право отказаться + +Конфликт промта с кодом или доками — **пинг, не интерпретация в свою пользу**. +⚠ **У тебя есть право сказать «этого делать не надо» — с аргументом.** Промт писал не тот, кто живёт +в этом коде; сегодня ошибки находили в КАЖДОМ моём промте, в одном девять. Отказ с разбором дороже +послушного исполнения плохого пункта. Аддендумы доезжают ТОЛЬКО релеем через владельца. +⚠ **Тесты и гейты не подгонять под зелень.** + +## §10. Как со мной связаться + +**Адрес — в файле `/tmp/textmachine-channel`** (механизм — `CLAUDE.md`, «Связь между сессиями»). +**Впиши туда свой блок первым делом**, чужие не трогай. ⚠ **Канала нет ⇒ НЕ искать:** вопрос секцией +в отчёт, работа продолжается, владелец пере-передаст.