textmachine/platform/docs/PLATFORM_RUNNER_SESSION_PROMPT.md

Промт платформа-сессии: РАННЕР — транзиентные юниты · реконсилятор · очередь · первые ручки /v0

Выдан 08.08.2026, оркестратор №15, по слову владельца 08.08 (D39.119; санкция направления — D39.107 п.3(3)). Ты — платформа-сессия. Зона записи: platform/ + зонный журнал platform/docs/platform-PROGRESS.md (итоги/пинги ТОЛЬКО туда, в docs/PROGRESS.md не пишешь — D39.100). НЕ коммитишь — дерево готовишь, лендит оркестратор; своё в git-индексе не держи (стейдж = риск чужого коммита). Деньги: $0 — LLM-вызовов нет; PostgreSQL стенда — рецепт без root в platform/docs/STACK_DECISIONS.md. ⚠ Живые соседи по дереву: полигон эксп-22 (eval/, docs/experiments/22-*) и, возможно, бэкенд-пак «блокеры контракта» (см. §Координация) — чужого не трогать и не «прибирать» (инцидент D39.113: откачено семь файлов, шесть потеряны). Пространства имён: «строка N» = ЕДИНЫЙ БЭКЛОГ docs/PROGRESS.md (таблица «Бэклог») · «PD-N» = platform/docs/DEFECT_REGISTER.md · «П-N» = platform/BACKLOG.md.

Первый деливерабл — эхо-блок ≤10 строк ПЕРВЫМ СООБЩЕНИЕМ сессии (скоуп · инварианты · не-делать; подтверждения не жди — работай дальше). ⚠ Все file:line/якоря промта — ОТПРАВНЫЕ ТОЧКИ, код первичен: протухший якорь — сверка, не блокер.

Онбординг: какую проблему решаем и что решит твой результат

Платформа — SaaS control plane над движком перевода: пользователи/кредиты/HTTP уже стоят (P0–P3 приняты, D39.107/109/114), но ПРОГОН движка платформа пока умеет запускать только дев-пайпом (internal/ingest/supervisor.go — явный DEV MODE). Ратифицированная форма шва — D39.106: движок = транзиентный systemd-юнит на прогон (платформа НЕ родитель), события — events.jsonl каталога книги (эмиттер движка ещё НЕ построен — строка 103, промт будет отдельно), платформа ТЕЙЛИТ с курсором, а ремонт-канал — tmctl status --json (уже существует и читается твоим resync.go). Твой пак строит ПРОДОВУЮ половину раннера и первые контрактные ручки — после него фронт сможет говорить с живой платформой, а не моками, не дожидаясь эмиттера.

Карта чтения (≤5): platform/README.md + зонный журнал (шапка; там же — отчёты P0–P3, вкл. замер PD-91) → docs/research/25-*.md (§Форма · §Обязательные механизмы, включая абзац «Опс:» внутри неё — читать ПЕРЕД любым кодом стыка) → D-лог грепом: D39.106 · D39.110 · D39.115 п.4 (форма run-options/CeilingBounds) → контракт docs/architecture/14-api-contract/ (openapi 0.2.0 + компаньон 2.14–2.16) → реестр platform/docs/DEFECT_REGISTER.md (открытые PD-строки твоих поверхностей; счёт — python3 docs/scripts/counts.py).

Работы

1. Транзиентный systemd-юнит на прогон: Restart=no, SIGTERM (D39.106 §2); щедрый TimeoutStopSec (research/25 §Форма); cgroup-лимиты прогона — ответ PD-13 живёт здесь (D39.106 §3). Privilege-модель реши ДО постройки — research/25 называет два варианта: linger-пользователь либо узкое polkit-правило; зафиксируй выбор в STACK_DECISIONS. Свойства юнита меряй исполнением на стенде без root — метод замера systemd-run --user уже отработан на PD-91 (P3, зонный журнал). Пиннинг прогона к версионированному пути бинаря движка + резюм другой версией только явным флагом (строка 139).
2. Очередь River + воркер (П-3/П-7): пин подтверждён — добавь в go.mod; гард «один живой прогон на книгу» (runs_one_live_per_book) — исполнением; холд ДО спавна на сумму потолка (PD-79 закрыт в P3 — путь открыт), интеграция с юнитом п.1.
3. Реконсилятор (строка 138): на КАЖДЫЙ выход юнита (ExecStopPost-маркер/D-Bus — реши сам) и на БУТЕ — перезапуск прерванных прогонов; источник истины на буте = каталоги книг + Postgres, НЕ состояние systemd (research/25). До появления эмиттера live-статус добирается периодическим status --json-резюнком (твой resync.go) — честно, с меткой давности.
4. Тейлер events.jsonl — строится против словаря platform/internal/ingest/events.go (словарь = ПРЕДЛОЖЕНИЕ платформы движку; сам ТРАНСПОРТ ратифицирован D39.106) и лежит наготове: курсор (engine_run_id, seq) коммитится в ОДНОЙ транзакции с эффектом (контракт Sink + run_attempts.last_seq уже это предвосхищают); файла пока нет — тейлер обязан спокойно ждать его появления. Ратификация PD-105 (этим промтом, D39.119): доставка at-least-once, ДУБЛЬ seq = НОРМА повторного чтения — декодер принимает его идемпотентно, БЕЗ фатала; тот же seq с ДРУГИМ payload = карантин прогона (research/25). Реестр предписывал ратифицировать это «вместе с промтом эмиттера» — девиация осознанная (тейлер-сторона строится сейчас); строку PD-105 реестра обнови этим паком. Дев-пайп platform/internal/ingest/supervisor.go не удаляется — остаётся дев-режимом; resync.go — твой резюнк-канал.
5. Первые ручки /v0 по контракту 0.2.0 (П-1/П-5; гейт «ждёт ратификации» снят D39.115): библиотека/карточка книги · GET /books/{id}/run-options → CeilingBounds (максимум = Balance КАК ЕСТЬ — ⚠ НЕ «минус Reserved», это вычитание дважды, D39.115 п.2а; max_chapters отдаётся УЖЕ подрезанным, клиенту подрезать второй раз запрещено) · старт прогона с обязательным ceiling_chapters (потолок в USD передаётся движку аргументом прогона — см. §Координация) · GET /usage · статус/прогресс прогона из read-model. Формы ответов — СТРОГО спека; расхождение спеки с твоим кодом = вопрос оркестратору, не правка спеки. Две границы, размеченные явно: (а) интейк книг — библиотека обязана читать книги, заведённые ЛЮБЫМ путём (дев-скрипт/руками в каталоге + строка read-model; заведи такой скрипт как дев-инструмент); сам POST /books (multipart-загрузка) бери ТОЛЬКО если ложится чисто, иначе — явная строка зонного бэклога с обоснованием, ручки сдаются без него; (б) пересчёт «главы→доллары»: движковой поверхности оценки $/глава НЕ СУЩЕСТВУЕТ — на бету источник = конфиг-константа платформы (правит оператор; дефолт возьми из cost-model docs/experiments/08-cost-model-v2.md, поделив на главы, с комментом-провенансом), НЕ выдумывай движковую поверхность и НЕ ходи в SQLite движка; потребность в честной движковой оценке — строкой зонного бэклога, оркестратор заведёт её движку.
6. Реестр PD: возьми строки, чья латентность снимается ЭТИМ паком (PD-99 — argv с деньгами/book-id на INFO при появлении воркера — обязательно; остальные сверь сам по реестру и возьми/оставь с обоснованием). Строки эмиттер-стороны (PD-60/61) НЕ трогать — они задание движку.

Вне скоупа: эмиттер (движок, строка 103) · uncertain-эскроу/ночная сверка (строки 136/137 — следующий денежный промт) · SSE на фронт · SPA-отдача. Инварианты: движок дёргается ТОЛЬКО процессами (никаких импортов backend) · живой SQLite движка не читать (D39.85) · book.yaml платформа НЕ правит (D39.110).

§Координация с бэкенд-паком (живой шов)

Параллельно (возможно) идёт бэкенд-пак «блокеры контракта» (промт docs/BACKEND_CONTRACT_BLOCKERS_SESSION_PROMPT.md): он строит потолок-аргумент прогона (строка 145), пофазный прогресс в status --json (99), манифест глав (100) и экспорт банка (125). Правило до его лендинга: свою логику доводи ДО шва целиком, сам шов — за узким интерфейсом с дев-стабом и пометкой TODO(145)/TODO(99)… (стаб = заглушка твоего интерфейса, НЕ имитация wire-формы движка — форму молча не выдумывай). Ручка старта прогона сдаётся полной, передача потолка движку — через такой интерфейс. Форму ПРИНИМАТЬ только из HEAD (залендённого); чужое незакоммиченное дерево backend/ читать для сверки МОЖНО (норма D39.115 п.3), но копировать его форму нельзя — расхождение твоего стаба с их черновиком = вопрос, не молчаливая подгонка. Писать в backend/ нельзя.

Самопроверка и СТОП

Мандат 12.07: ревью ИСПОЛНЕНИЕМ (код + живые пробы на собранном бинаре + systemd-run-замеры). Дифф ^func Test до/после — исполнением, не памятью; батарея make check зелёная целиком с живым PG (скипов ноль — рецепт в STACK_DECISIONS); make vuln чист. По правилу зоны: закрытая PD-строка = запиненное свойство (тест поимённо). Канал вопросов: непонятно / конфликт промта с кодом-доками-спекой / privilege-модель упирается в стенд → СТОП по ЭТОМУ пункту (остальные продолжай), вопрос — строкой в зонный журнал плюс устно владельцу (он релеит оркестратору); НЕ тихая интерпретация. Отчёт в зонный журнал: по работам с file:line · девиации · открытые PD-строки после пака (счёт скриптом) · каждое ЧИСЛО отчёта — с командой, которой получено (приёмка пере-ранит). СТОП — приёмка оркестратора (адверсариальная, со своими посадками).