# ПАК «ФОРМАТЫ И ЧЕСТНЫЙ СЛОВАРЬ» — движковая сессия

> **ВЫДАН 05.09 сессии `textmachine-main-fe`.** Три круга совместного ревью (оркестратор + Fable 5);
> состав пака и словарь — итог восьми кругов сходимости, тела разборов в `D39.202`/`D39.207`.

**Зона записи:** `backend/`. **Коммитит оркестратор** (`textmachine-main-27`), ты готовишь дерево и
передаёшь. **Отчёт:** секция «Бэкенд» в `docs/PROGRESS.md`. **Денег:** $0, ни одного платного вызова.

---

## 0. КАРТА ЧТЕНИЯ — ПЯТЬ ПОЗИЦИЙ, ОНА ЗАКОН

Дальше — только по её ссылкам. Голову журнала решений целиком НЕ читать (канон это запрещает).

1. **`backend/internal/chunk/ingest.go`** целиком — предмет пака живёт здесь.
2. **`docs/research/27-chapter-detection.md`** — через его ревью-шапку. Дизайн НЕ ратифицирован;
   это материал, а не заказ.
3. **`## D39.205`** (пропущенный кусок — критическая поломка) и в `## D39.202` — **только п.3-бис**
   (гейт умирает вытеснением) **и п.9** (чего не сторожит ничто). Тело ноты целиком не нужно.
   ⚠ **ПОДНОМЕР своего тела не имеет** — `D2.3` живёт пунктом внутри `^## D2`.
4. Строки бэклога **297** (словарь провенанса) и **299** (имя, не разрешающееся ни во что) в
   `docs/PROGRESS.md`.
5. **`docs/architecture/12-go-style-notes.md`** — норматив стиля, только больные места.

**Код читаешь по мере правки. Несущие файлы, которые ты ТОЧНО будешь править:**
`chunk/ingest.go` · `pipeline/manifest.go` (ключ, тег, `title_raw`) · `chunk/chunker.go`
(`stripHeading`, `matchHeaderLine`) · `lang/langpack.go` (⚠ `parseHeading` СЕГОДНЯ ТРЕБУЕТ `marker`,
`:677-679` — после «только `template`» он упадёт, это заказанная правка) · `lang/embedded.go`.

---

## 1. ЧТО УЖЕ ПОСТРОЕНО — НЕ ЗАКАЗЫВАТЬ ЗАНОВО

Самый дорогой раздел: половина ошибок прошлых паков — постройка второго носителя.

- **Провенанс разреза уже есть** — поле `Document.Structure`, и оно **спроектировано верно**:
  отвечает на «КАКОЙ ПУТЬ провёл границы» (`ingest.go:94-95`). ⛔ Неверна его первая строка (`:70`),
  рекламирующая «how much the chapter cut can be trusted», — и именно её списала платформа.
  **Поле не переделывать; чинить словарь и формулировку.**
- ⛔ **Валидатор V2-7 «формат провёл ВСЕ границы» (`ingest.go:170-176`) — ЗАМЕЩАЕТСЯ конкуренцией
  (§2.4), а не сохраняется рядом с ней.** После конкуренции его предикат
  (`len(parts)>1 && len(chapters)==len(parts)`, `:177`) становится мёртвым кодом. Не пытайся
  сохранить обе логики — это прямо противоречащие друг другу правила.
- **Доминирующий юнит с полом ≥2** для CJK уже есть (`detectChapterUnit`, `ingest.go:249-263`) —
  это мини-индуктор, а не список паттернов. **Пол ≥2 — единственный валидатор, живущий в паке 1.**
- **Читательские слова цели** уже разведены и грузятся СВОИМ загрузчиком по ЯЗЫКУ, вне пар-пака
  (`lang.LoadReaderWords`, `reader.go:87`) — **прецедент, по образцу которого делается структура
  источника.**
- **Скрипт языка** уже выводится (`lang.LangScripts`, `script.go:67`), CJK-дефолт живёт данными.

---

## 2. ЧТО ЗАКАЗАНО

### 2.1 Шаг 0 — ПРИБОР ДО ПРАВОК. Поведение не меняется, $0

Без него пак не имеет права ложиться: под ним подписанный банк владельца (окна в ординалах глав)
и боевая книга.

1. ⛔ **Пин — ПОЛНЫЙ МАНИФЕСТ до правок**, а не хеш: id глав + номера (лучше весь JSON). Из хеша
   не построить карту сдвигов §2.5, а она заказана. Хеш — производное, снимай и его.
   ⛔ **НО: под `books/` не запускай НИЧЕГО.** `tmctl manifest` пишет сайдкар рядом с проектной базой
   книги (`manifestPath()` = `ProjectDB + ".manifest.json"`, `pipeline/manifest.go:189`), то есть
   ПИШЕТ в каталог книги — а запись там запрещена (§7). **Форма: копируешь исходник и `book.yaml`
   в собственный каталог сессии** (не `/tmp` — см. §4, не `books/`) **и все замеры и пины делаешь
   на копии.**
   ⛔ **В копии обязательно перенаправь `project_db` и `source_file`.** `project_db` — ЯВНОЕ поле
   yaml (`config/book.go:86`), и «рядом с yaml» подставляется, только если оно ПУСТО (`:199-201`);
   у стендовых книг там абсолютные пути. Скопируешь как есть — сайдкар уедет обратно под `books/`
   (запись, которая запрещена) или по мёртвому пути.
   ⚠ **А `langpack_root` / `langpack_extend` НЕ трогай** — они только читаются, и подмена дала бы
   другой `Pack.Version()`, то есть другой `cutTag`: пин снялся бы с другого разреза, и сравнивать
   было бы нечего.
2. **Синтетические фикстуры по стандартам:** EPUB 3 с `nav`, EPUB 2 с NCX. Сегодня тестовый билдер
   пишет только `container→OPF→spine→xhtml` и **nav/NCX не пишет вовсе** (`chunktest/epub.go:42-82`).
3. **Оракул — КОД, не замер:** EPUB с `nav` разворачивается в txt, путь разреза обязан восстановить
   nav-границы. Ground truth **без ручной разметки и без единого вызова модели**. ⚠ Сам ЗАМЕР — пак 2.
4. **Замеры ДО правок, каждый числом в отчёт:** есть ли `\f` в стенд-книгах · есть ли главы-огрызки
   от print-TOC · сбрасывается ли нумерация по томам.

**Файлы стенда — поимённо** (см. §7 о доступе): 蛊真人 (GB18030 txt, ~2283 «第N节») · EPUB владельца
Кристофф/en · EPUB владельца isekai/ja. ⚠ Платная книга платформы `bk_SS5VES2JELESJSTR` живёт в
workdir платформы, **гейту §3 не видна и в него не входит**; её заметки теряются по слову оркестратора.

### 2.2 Данные структуры — ПО ИСТОЧНИКУ, вне пар-пака

Ревью-вопрос проекта: «заработает ли пара, которой в репо НЕТ, без правки Go?»

- `marker`/`units`/выбор читателя номеров/грамматика шаблона → **файл структуры ИСТОЧНИКА**, свой
  загрузчик по `Book.SourceLang`, **по образцу `reader.txt`**.
- ⛔ **В пар-пак класть НЕЛЬЗЯ:** книга без каталога пары идёт с nil-паком (`runner.go:397-407`).
- ⛔ **ОДИН ИСТОЧНИК НА ФАКТ.** Ингест И `stripHeading` чанкера читают **тот же самый файл**.
  Сегодня чанкер берёт `HeadingRule` пары; после разведения `heading.txt` оставляет ТОЛЬКО
  `template`. Оставить marker в обоих местах = вернуть дрейф ingest↔chunker, который pair-14 закрыл
  («ONE source, no ingest↔chunker byte-drift», `ingest.go:181-186`).
- **Лестница при отсутствии данных:** язык → скрипт → embedded-дефолт ПО СКРИПТУ → честное `none`.
  ⛔ **Дефолт НЕЛЬЗЯ класть под `internal/lang/data/`**, хотя прецедент `cjk-section.txt` туда и манит:
  `EmbeddedVersion()` хеширует **весь каталог** (`embedded.go:44-56`, `ReadDir("data")`; «a byte edit
  of ANY embedded file is a loud --resnapshot»). Положишь туда — нарушишь «не в снапшот» МЕХАНИЗМОМ,
  тест §4 п.3 покраснеет, и самый соблазнительный «фикс» будет хаком (руками исключить файл из
  обхода). Клади в ОТДЕЛЬНЫЙ embed-каталог со своей версией (`internal/lang/structure/` или как
  назовёшь).
- **Объём читателей номеров в паке 1 — РОВНО СУЩЕСТВУЮЩИЙ** (арабские + CJK). Схема данных пишется
  под общий случай, но **римские/словесные читатели НЕ строятся** — их заказывает пак 2, если замер
  покажет нужду.

⛔ **ВЕРСИОНИРОВАНИЕ — ТОЧНО, иначе воспроизводится F1 MAJOR (D39.122).** Данные структуры решают
ГРАНИЦЫ ⇒ обязаны войти в **`cutInputs`** (`manifest.go:240-255`) ⇒ двигают **`cutTag`** ⇒ двигают
**unit-id**. `manifestKey` фолдит компоненты ПОРОЗНЬ (`manifest.go:336-354`), и одного его
НЕДОСТАТОЧНО: правка данных перережет книгу, а id юнитов переживут — ровно тот дефект, ради которого
тег и заведён. **В снапшот волн — НЕ класть.** Тест `TestEveryCutInputMovesTheTag`
(`cuttag_test.go:26`) получает новый компонент.

**ФОРМА компонента — не на твоё усмотрение, она уже задана прецедентом:**
`Structure: <версия парсера> + sha256(байты структурных данных, РЕАЛЬНО загруженных для этой книги —
`<source>/structure.txt` либо дефолт по скрипту)`. **Никогда `omitempty`** — дефолт есть всегда.
Считается ОДИНАКОВО на пишущем и читающем пути (`runner.go:384-386`: «loaded on BOTH the write path
and the read-only path so status/export/report reproduce the identical snapshot»). Это ровно форма
`Langpack: r.packVersion()`.

⛔ **ЧТО НЕ ПЕРЕЕЗЖАЕТ, и это тихая ловушка:** **числительные** (`Zero`/`Digit`/`Unit`/`Magnitude`)
**остаются в `data/cjk-section.txt`**. Их читает не только ингест — на них стоят ДЕНЕЖНЫЕ $0-гейты
величины чисел (`checks/cheapgates.go:601, 636, 649, 666` — `lang.DefaultCJKSection()`), а это
ВЕРДИКТНЫЕ данные, и им место в снапшоте. Уносишь числительные — **молча меняются вердикты гейтов**.
Переезжают ТОЛЬКО `marker` / `units` / грамматика шаблона.

### 2.3 EPUB по стандарту

- Читать **`nav` (EPUB 3) и NCX (EPUB 2)**; spine — порядок ЧТЕНИЯ, а не оглавление.
- Учитывать `linear` и `properties` — сегодня `opfPackage` их не разбирает (`ingest.go:500-509`).

**Нормализация nav — правилами, а не на усмотрение** (research/27 — материал, не заказ):
цели сортируются **по позиции в spine** · цели вне spine или неразрешимые — игнор со счётом ·
вложенные `ol` **сплющиваются** (каждая цель — граница; иерархия томов — §5) · дубли целей
схлопываются · приоритет **nav → NCX → spine** · nav с нулём разрешимых целей = отсутствует.

⛔ **ТЕКСТ КНИГИ НЕ ТЕРЯЕТСЯ НИКОГДА** (`D39.205`: пропущенный кусок — критическая поломка):
- **служебные документы — НЕ текст книги и исключаются со счётом**, и список ТОЧНЫЙ, потому что
  наивная форма не сработает: исключаются (1) документ с `properties="nav"`; (2) документы, чья роль — `toc`
  или `cover` — объявлена **в landmarks (EPUB 3) ЛИБО в OPF `<guide>` через `<reference type=…>`
  (EPUB 2)**. ⛔ Обе формы обязательны: landmarks — конструкция EPUB 3, **у EPUB 2 nav-документа нет
  вовсе**, и сессия, проверившая только landmarks, приклеит `toc.xhtml` к главе 1 ровно на том
  «массовом EPUB 2», которым это правило себя и мотивирует. ⚠ `properties="cover-image"` стоит на ИЗОБРАЖЕНИИ, а не на
  документе, и среди документов spine не исключит ничего; landmarks — это `<nav epub:type="landmarks">`
  ВНУТРИ nav-документа, в `properties` их нет. Грепнуть один `properties` и на этом успокоиться —
  значит приклеить к главе 1 текстовую страницу оглавления (`toc.xhtml` в spine — массовый EPUB 2)
  и титул. Больше НИЧЕГО не исключается;
- ⛔ **`linear="no"` НИКОГДА не начинает главу**, даже если nav на него указывает (сноски,
  приложения) — прикрепляется к предыдущему по spine;
- **непокрытые контент-документы ДО первой цели nav** (титул, обложка-страница) прикрепляются к
  **ПЕРВОЙ** главе — зеркало правила преамбулы txt;
- **остальные непокрытые** — к **предыдущей** главе;
- каждое прикрепление считается; число в WARN и в отчёт.

⚠ **Вырожденный nav — ОЖИДАЕМЫЙ исход пака 1, а не твой баг.** Скрейп с тремя целями на триста
документов даст три главы-кита с ярлыком `declared` и огромным счётом прикреплений. Словарь честен,
разрез — нет; лечение (валидаторы `runt`/`whale`, кросс-аудит) — пак 2 (§5). **Тревога здесь — СЧЁТ**,
и это всё, что от пака 1 требуется. Не лезь чинить кита.

### 2.4 Словарь: четвёртое значение и КОНКУРЕНЦИЯ свидетелей

**Словарь: `declared` · `delimited` · `detected` · `none`.**

- `declared` — формат утверждает СТРУКТУРУ ГЛАВ (nav/NCX).
- **`delimited` (новое)** — в файле был РАЗДЕЛИТЕЛЬ, но «это глава» — допущение движка. Сюда уходят
  **и EPUB-spine, и `\f` в txt**: spine объявляет порядок чтения, form feed — разрыв СТРАНИЦЫ.
  ⚠ Реальный источник `\f` — не человек, а извлечение из PDF (`pdftotext` ставит его на каждом
  разрыве страницы по умолчанию).
- `detected` — движок вывел границу из СОДЕРЖИМОГО.
- `none` — свидетеля нет (и при <2 главах — уже так).

⛔ **КОНКУРЕНЦИЯ вместо сложения — заказанная СМЕНА ПОВЕДЕНИЯ.** Сегодня txt режется по `\f`, а
ПОТОМ каждая часть — по шапкам (`ingest.go:159-167`), пути СКЛАДЫВАЮТСЯ. Заказано: **есть шапки →
режем по шапкам, книга `detected`; шапок нет → режем по `\f`, книга `delimited`.** Смешанного случая
не остаётся **по построению**, агрегировать нечего, `structureOf` сводится к «`none` при <2 главах,
иначе свидетель победившего пути».

⛔ **И ГЛАВНОЕ — ЧТО С БАЙТАМИ ПРОИГНОРИРОВАННОГО `\f`.** `text.NormalizeSource` form feed **не
трогает** (`ingest.go:44-46`). Сегодня он до провода не доходит, потому что он и есть символ разреза;
после конкуренции проигнорированный `\f` **останется в тексте главы** и уедет модели, в контент-хеш
и в чекеры. ⇒ **игнорируемый `\f` заменяется на разрыв абзаца (`\n\n`) в ингесте, до нормализации**,
и считается.

**Слабость выражается СЧЁТОМ, не классом:** `form feeds ignored: N`, `documents attached: M` — в WARN
и в отчёт, **НЕ в манифест**: потребителя на проводе у счёта сегодня нет, а поле без потребителя —
механизм ради галочки.

⚠ **Провенанс — свойство ГРАНИЦЫ.** Глав N, границ N−1; у первой главы открывающей границы нет.
⚠ **ПРАВИЛО ПРЕАМБУЛЫ ЗАМОРОЖЕНО:** текст до первой шапки сливается в главу 1, и код объясняет
зачем — «dense numbering aligns with the section numbers», «第一节» обязано быть главой 1
(`splitTextChapters`, `ingest.go:265-270`). Не трогать: правка сдвинет нумерацию ВСЕЙ стенд-книги.
⚠ Следствие, которое надо знать, а не чинить: у главы 1 шапка стоит НЕ в её начале, значит
`title_raw` главы 1 берётся из проглоченной шапки.

### 2.5 `title_raw` и карта сдвигов

- **`title_raw`** едет по проводу **аддитивно**. Определение: **строка шапки как в источнике** (txt)
  / **`navLabel` дословно** (EPUB). ⛔ Обоснование — собственное: заголовок, не едущий по проводу,
  невозможно отрендерить. **НЕ ссылаться на «шесть заголовков из семнадцати»: у числа нет носителя**
  (эррата 05.09-е).
- ⛔ **ПОНИЖЕНИЕ подзаголовка в прозу (`chunker.go:155-177`) НЕ ТРОГАТЬ.** Снимешь — изменятся чанки
  и модель перестанет переводить подзаголовок. `title_raw` добавляется РЯДОМ, не вместо.
- ⚠ В EPUB-экспорт и в `nav` `title_raw` в этом паке НЕ входит — он на языке источника.
- ⛔ **БАМП `chunkerVersion` — ОДИН РАЗ, И ЭТО ЗАКАЗАНО ЯВНО.** Пак меняет РАЗРЕЗ (EPUB spine→nav,
  конкуренция `\f`), а правило ингеста по конвенции покрывается `chunkerVersion` (`text/source.go`:
  «covered by chunkerVersion (a deliberate re-translation, not a silent one)»). Забыть бамп —
  оставить протухший манифест выглядящим текущим.
  ⇒ `chunker_version` уезжает в снапшот, и **голден краснеет: `testdata/golden/capture.golden`
  несёт ЧЕТЫРЕ строки `chunker_version`** (проверено `grep -c`).
  **Голден пере-захватывается ОДИН раз, в самом конце, и ТОЛЬКО после того, как ты предъявишь пин:
  разрез самого голдена не изменился** (его фикстура — ja-txt с `第一章`, форм-фидов ноль).
  Объявление по D39.183 обязательно.
  ⚠ Без этого абзаца ты упёрся бы в красный голден и по §7 обязан был бы остановиться и пинговать —
  поэтому он здесь: правка ЗАКАЗАНА.
- **Карта сдвигов — МАШИННАЯ (JSON), set-diff по id и номеру: `same/moved/gone/new`.** Прозой нельзя:
  на прозе не построить мигратор потом. Мигратор в пак НЕ входит — **пак производит УЛИКУ, а не
  ремонт**, и это сказано вслух.

---

## 3. ГЕЙТ ЛЕНДИНГА

**Зелено, если выполнено ОДНО из двух:**

- **(а)** разрез стенд-книги воспроизводится **байт-в-байт** против пина §2.1, ЛИБО
- **(б)** расхождение **перечислено**, приложена **машинная карта сдвигов**, в отчёте **ЯВНО названа
  цена: что именно теряется и у кого**, и это **подписано владельцем**.

⛔ **Почему не только (а).** Чистое «байт-в-байт» защищало бы ОШИБКИ нынешнего разреза: правильный
детектор чинит главы-огрызки, а гейт бы его за это не пустил. Это **девятая форма ложной зелени —
гейт, ЗАЩИЩАЮЩИЙ дефект** (`D39.202`). ⚠ Такого детектора **в паке 1 нет** (он в §5, пак 2) — довод
объясняет ФОРМУ гейта на будущее, а не заказывает тебе детектор.

⚠ **Ветка (б) честна ровно наполовину, и это записано сознательно:** мигратора окон банка нет, и пак
его не строит. Сдвиг окна = новый `TermID` = каскад на решения владельца в платформе. Поэтому (б)
обязывает НАЗВАТЬ потерю, а не починить.

⚠ **Поток подписи — не твой.** Ты сдаёшь карту и названную цену в отчёте; **оркестратор несёт
владельцу; лендинг — после его слова.** Не жди сам и не «подписывай» сам.

⚠ **ГЕЙТ ПРИМЕНЯЕТСЯ ТОЛЬКО К 蛊真人** — под ней подписанный банк владельца (окна в ординалах глав). **EPUB владельца
под гейт НЕ попадают: их разрез ОБЯЗАН измениться (spine → nav), это и есть заказ пака.** Для них
ветка (а) провалена по построению, и требовать под них подпись владельца бессмысленно. Они — прибор
§2.1 п.3: их новый разрез **ИЗМЕРЯЕТСЯ и идёт в отчёт числом**, а не гейтится.

⚠ **Ожидаемый исход для 蛊真人 — ветка (а).** В паке 1 её разрез может сдвинуть только
`\f`-конкуренция. Ветка (б) существует на случай, если `\f` там окажется.

---

## 4. САМОПРОВЕРКА — ИСПОЛНЕНИЕМ, И ВЕЕР НАПРАВЛЕН

Самоотчёт «проверено» без исполнения регулярно оказывается ложным. После кода — **адверсариальный
проход по СВОЕЙ готовой работе**. Глубину и веер выбираешь ты; направление — вот что уязвимо здесь:

1. ⛔ **Резка xhtml по якорям `nav`** (несколько глав в одном файле) — самое уязвимое место пака.
   У `extractXHTML` **не меньше четырёх пинов байт-паритета** (`ingest_test.go:323, 359, 423, 467`:
   void-теги, несбалансированный ruby, raw-text-элементы, голый амперсанд). Ошибка здесь ТИХАЯ,
   и ломает она именно их.
2. **Загрузчик структуры обязан достигать книги БЕЗ пар-пака** — тест на книгу без `langpack_root`.
3. **Данные структуры реально двигают `cutTag`** (и через него unit-id) **и в payload `manifestKey` (`manifest.go:336-354`), и НЕ
   двигают снапшот волн** — тест на каждое из трёх.
4. **Байты игнорируемого `\f`** — тест, что в тексте главы его не остаётся.
5. **Выравнивание `title_raw` с ПЛОТНОЙ нумерацией** — тест с ПУСТОЙ главой между двумя непустыми:
   пустая глава номер не потребляет, а `title_raw` поедет параллельным срезом, и промах на одну
   позицию даст заголовок главы N на главе N+1 **молча**. Тот же класс уже чинили для ruby
   (`ingest.go:568-605`, `denseNo`).
6. **Именованный артефакт:** посади дефект в разбор `nav` так, чтобы одна глава потерялась молча,
   и предъяви **имя покрасневшего теста**. Не краснеет ничто — это находка, а не повод двигаться.

⚠ **Каталог мутаций** (`backend/cmd/tmmutate`): `-root` обязан быть КОПИЕЙ; копия вне git ⇒
`GOFLAGS=-buildvcs=false`. **Не работай под `/tmp`:** посторонний `/tmp/.git` ломает `go build`
всему, что там собирается, и уже дал этой смене ложную зелень.

---

## 5. ГРАНИЦЫ — ЧЕГО В ЭТОМ ПАКЕ НЕТ

Названо, чтобы не открылось по ходу и не было сделано «по здравому смыслу»:

- **Лексиконы не-CJK, корпус, ЗАМЕР оракулом, сбор файлов, сеть** — пак 2. Пак 1 ничего не собирает.
- ⛔ **Структурные валидаторы (монотонность номеров, коридор hits/объём, headSpread, runt/whale) —
  ПАК 2.** В паке 1 живёт только уже построенный пол ≥2. **Причина не стилистическая:** у стенд-книги
  нумерация СБРАСЫВАЕТСЯ по томам (`eval/dovodka/narezka.py:18`), и валидатор монотонности отверг бы
  или перекроил её шапки — то есть уронил бы гейт §3 на верной книге.
- **Индуктор скелетов строк** — пак 2, и только если замер покажет нужду.
- **Мигратор** окон банка, `chunk_status`, `unit_resolutions` — не здесь (строка 298, D15.2).
- **Идентичность по ИСХОДУ** (`cutTag` как дайджест нарезки) — свой пак. Здесь только сравнение
  манифестов до/после в приборе шага 0.
- **Публикация провенанса по главе, `kind`, вердикт качества, иерархия томов, print-TOC-линковка,
  `split/merged` в карте** — не строить. Потребителя нет, фронт заморожен.
- **FB2** — только если владелец скажет, что у беты есть FB2-источники.
- **Платформенное:** предикат «двух свидетелей» и `structure_version` · снятие временного правила
  по `declared` (строка 297) · глагол «перечитать журнал» — **всё это НЕ твоя зона.** Не добавляй
  полей «для платформы».
- ⛔ **Рендер при сбросе нумерации по томам — ВОПРОС ВЛАДЕЛЬЦА, не чинить.** Ты УВИДИШЬ в `nav`
  платного EPUB несколько глав с одним номером. Это выбор рендера (номер книги против плотного
  ординала), он вне пака. Увидел — запиши числом в отчёт и иди дальше.
- **`narezka.py` полигона** (второй приватный zh-детектор) — пинг полигону от оркестратора, не твоё.
- ⛔ **Сквозного прогона не-CJK НЕ БУДЕТ и не заказывается:** промтов пары для en/ja не существует
  (`backend/prompts/` — только `zh-ru`). Не-CJK путь проверяется **только на уровне ingest/manifest,
  $0**. Не пытайся «доказать бету» — не сможешь, и это не твой дефект.

---

## 6. ОБЯЗАТЕЛЬСТВО, КОТОРОЕ ПАК ДАЁТ ПЛАТФОРМЕ

**Пак НЕ бампает `manifestVersion`.** Значения и поля аддитивны; платформа игнорирует неизвестные
поля и деградирует на неизвестных значениях. Бамп понадобился бы, только если читатель прочтёт
документ **как текущий и НЕВЕРНО**: единица без плотного номера или с дубликатом · тотал, не равный
списку · пустой id · смена ФОРМЫ id.

⇒ **Граница обязательства: каждая единица манифеста нумерована ПЛОТНО и 1-based.** «Фрагмент» —
атрибут нумерованной единицы, а не отсутствие номера.
⚠ Контракт при этом обещает `number: null` как законный — и **шов его отвергает**; противоречие
записано эрратой 05.09 в `openapi.yaml`. Снимать его — не в этом паке.

⚠ **Стыковка с платформой — предусловие ЛЕНДИНГА и забота ОРКЕСТРАТОРА, не твоя** (`platform/` —
чужая зона). От тебя нужно одно: **сдать в отчёте манифест-фикстуру со значением `delimited`**,
чтобы платформенный тест мог на ней проверить деградацию в «знаки».

---

## 7. ДИСЦИПЛИНА

- **Доступ к книгам.** `books/` — симлинк в соседнее дерево. **ЧИТАТЬ файлы под `books/` РАЗРЕШЕНО
  и необходимо** (§2.1 без этого неисполним). ⛔ **ЗАПРЕЩЕНО:** любая запись под `books/`, любые
  git-операции там, и что-либо ещё в `/home/ubuntu/projects/textmachine` вне `books/`.
- **Тесты и гейты не подгонять под зелень.** ⚠ Правка, вызванная **заказанной** сменой поведения, —
  обслуживание. **Заказанные здесь правки тестов, поимённо:**
  · `priceprojection_test.go:144` — кейс «a form feed is the format speaking» ждёт
    `StructureDeclared`; **станет `delimited`**;
  · тест V2-7 «формат провёл ВСЕ границы» — меняются ДВА кейса, не один: «один случайный `\f`
    среди шапок» (шапки побеждают, книга `detected`) **и ПЕРВЫЙ кейс `ingest_test.go:68`
    «the format drew every boundary» (`ГЛАВА A\fГЛАВА B` → `StructureDeclared`), который становится
    `delimited`**. ⛔ И **само имя** `TestTXTStructureIsDeclaredOnlyWhenTheFormatDrewEVERYBoundary`
    после конкуренции ни во что не разрешается — **переименовать тем же актом** (класс строки 299,
    который этот же промт требует ниже для комментариев);
  · `ingest_encoding_test.go:218-227` (GB18030, `第一章…\f第二章…`) — **счёт глав сохранит** (две
    шапки побеждают), но его **комментарий про разрез по `\f` станет ложью** — поправить текст
    комментария, это класс строки 299;
  · ⚠ `TestIngestTXTFormFeedChapters` (`ingest_test.go:34-46`) проверяет разрез `A\fB\fC`, где шапок
    нет — **при конкуренции НЕ меняется**, меняется только ярлык на `delimited`. Не «чини» его.
  **Каждая такая правка ОБЪЯВЛЯЕТСЯ в отчёте:** что изменилось в поведении, какой тест это описывал,
  куда уехала гарантия. Не заказано и не ратифицировано — **пинг, не правка**.
- **Комментарии, описывающие сменённое поведение, — тоже носители.** Правь их вместе с кодом; в
  частности протухает `bookfile/epub.go:15-19` («ридер делает главу из КАЖДОГО документа spine»).
  Это класс строки 299 — имя или утверждение, которое больше ни во что не разрешается.
- **Не хакать вокруг ошибки.** Нашёл дефект в чужой зоне — опиши, не чини.
- **Никогда не читать `.env`.** PUML не рендерить. **Не коммитить.** Не двигать HEAD. Не трогать
  чужое незакоммиченное. ⚠ Якорный линт доков (`docs/scripts/counts.py --lint`) — гейт ОРКЕСТРАТОРА;
  доки с якорями ты не пишешь, но знай, что он есть, и не строй второй такой.
- **Утверждение о замере — с КОМАНДОЙ** (`D39.207` п.5): пишешь «проверено» или «не проверено,
  потому что X» — рядом стоит команда, которой это показано.
- ⛔ **Идентификатор, не виденный ЦЕЛИКОМ в выводе команды, не воспроизводить по памяти** — ни хеш,
  ни номер строки. Обрезающий `cut`/`head` молча превращает улику в догадку (`research/29` §5.6:
  так был сфабрикован sha256, совпавший на 52 знака из 64).

---

## 8. ЧТО ПРИСЛАТЬ И В КАКОМ ПОРЯДКЕ

1. **Эхо старта:** своими словами — что понял предметом и что считаешь границей. До кода.
2. **Записка-план** в отчёт: что делаешь, в каком порядке, и **чем сдача осмысленна, если тебя
   оборвут на середине**. До кода.
3. **Замеры шага 0 — числами**, до правок.
4. Код.
5. **Отчёт:** батарея (команда, скипы числом, EXIT) · каталог · посадка именованного артефакта
   (`file:line` · что подменено · **какое ИМЯ теста покраснело**) · объявления по D39.183 · счета
   `form feeds ignored` / `documents attached` · манифест-фикстура с `delimited` · что НЕ проверено
   и почему.

⚠ **Споткнулся о невыполнимое, о противоречие в самом задании или о нехватку доступа — пиши сразу,
не обходи молча.** Обход тихо становится нормой, и следующая смена наследует его как факт.