# Локальный мастер заполнения

Один вход для обоих шаблонов договора и любых ИИ-агентов.
Мастер вызывает закреплённый `scripts/fill_contract.py`. Python 3 и подготовленная `.venv` остаются необходимы.
Он не редактирует XML Word. Он не устанавливает подлинность источников или личность пользователя.

## Подготовь среду и данные

1. Выполни проверенную загрузку и подготовку `.venv` по `guide/01-download.md`.
2. Получи выбор договора, оригиналы и значения по `guide/02-data.md`.
3. Сохрани рабочий JSON и карту `document → путь оригинала` отдельно от набора и публикуемых файлов сайта.
4. Формат заполненного ввода описан в `schemas/input.schema.json` (JSON Schema 2020-12).
   Пустые формы из `data/` предназначены для сбора данных. Они не проходят проверку заполненного ввода.
5. Цена — JSON-строка в рублях с точкой, например `"100.50"`. Месяцы и количество — положительные целые литералы JSON: `3`, а не `3.0`.
   Это дополнительное требование типов штатного заполнителя; [JSON Schema](https://json-schema.org/draft/2020-12/json-schema-validation#name-type) считает `3.0` целым значением.
   Пример формата не задаёт цену договора. Используй источник согласованной цены.
   Для «Корпорации» каждая строка имеет полный формат наименования по `README.md` и `months` от 3 до 12 включительно.
   Сокращённое название, отсутствие модуля и срок менее 3 или более 12 месяцев отклоняются. `changes` не отключает проверки.
6. Для каждого запуска выбери новую абсолютную приватную папку. Её родитель должен существовать.
   Не используй папку набора, `public/`, символическую ссылку или другое написание имени этих папок.
   Прежние результаты не перезаписываются.

Замени все обозначения в угловых скобках фактическими путями. Выполняй команды из проверенной папки набора.

## 1. Подготовь подтверждение

```text
.venv/bin/python -I scripts/wizard.py prepare "<рабочие данные.json>" --sources "<карта оригиналов.json>" --work-dir "<новая абсолютная приватная папка подготовки>"
```

Мастер проверяет формат полей, привязывает оригиналы, сбрасывает прежнее подтверждение и выполняет `--check`.
При ошибках формата возвращает список `errors` с путём поля, ожидаемым форматом и следующим действием.
Для наименования и границ срока вывод также содержит пояснение; для наименования — образцы.
Не преобразуй цену, не дополняй поля и не меняй оригинал ради успешной проверки.
Ошибки заполнителя находятся дословно в журнале соответствующего шага.

Успешный этап: `stage=await_user_reply`. Word ещё не создан.
Сохранены `bound.json`, `proposed-confirmation.txt` и отдельные журналы привязки и проверки.

Покажи пользователю весь `approval_text` одним сообщением.
Покажи все расчёты по этапу 3: количество × цена × месяцы, итог, без округления исходной цены.
Получив один фактический полный дословный ответ пользователя, сохрани его отдельно в приватный TXT UTF-8 без BOM.
Сохраняй текст самого сообщения. Не добавляй завершающий перевод строки или пробелы командой сохранения.
Не используй `echo` или heredoc, если они добавляют такой перевод строки. Проверь последние байты фактического файла.
Размер сравнивай с UTF-8 самого полученного сообщения, а не используй размер предложения как доказательство согласия.
Не создавай ответ сам. Не используй `proposed-confirmation.txt` как ответ пользователя.
Простого «да» недостаточно. Не склеивай несколько сообщений.
При недоступном полном показе и ответе остановись по `guide/03-approval.md`.
Ошибка `REPLY_FILE_FORMAT` означает отличие только в BOM или конечных пробельных символах.
Мастер ответ не меняет и не принимает. Сохрани исходный файл. Сверь его с самим сообщением пользователя.
Если лишние байты добавил редактор, сохрани то же реальное сообщение новым файлом без этих добавлений; новое согласие не требуется.
Если само сообщение отличается от полного блока, получи новое полное дословное подтверждение.

## 2. Создай и проверь Word

```text
.venv/bin/python -I scripts/wizard.py complete "<папка подготовки>/bound.json" --reply "<фактический полный ответ пользователя.txt>" --work-dir "<новая абсолютная приватная папка результата>"
```

Мастер заново сверяет оригиналы и данные. Он сравнивает отдельный ответ с текущим полным блоком.
Код подтверждения берётся из этого ответа, не из редактируемого JSON.
Установи происхождение ответа сам: программа не аутентифицирует человека и не распознаёт созданный агентом файл.
После потери истории с неизвестным происхождением ответа получи новое подтверждение по AGENTS.md.

При пустом `changes` мастер создаёт новый `Договор_черновик.docx` штатным заполнителем.
Затем он выполняет отдельный `--verify` и сохраняет `snapshot.json`.
Успешный этап: `stage=technical_checks_passed`.
`check` содержит фактический результат, stdout/stderr и код проверки артефактов, отпечаток Word и `saved_snapshot.sha256`.
Сохрани `check.saved_snapshot.sha256` отдельно от снимка через установленный доверенный канал.
Не вычисляй прежний якорь из проверяемого снимка.

При непустом `changes` этап — `text_changes_pending`.
Мастер сохраняет только `Базовый_черновик.docx`; правки текста ещё не внесены.
Внеси согласованные правки редактором в отдельную копию с видимыми отметками. Сохрани их перечень.
Не правь XML. Затем выполни отдельную проверку изменённой копии:

```text
.venv/bin/python -I scripts/wizard.py review "<папка результата>/approved.json" --reply "<тот же фактический ответ пользователя.txt>" --document "<отмеченная изменённая копия.docx>" --work-dir "<новая абсолютная приватная папка проверки>"
```

Для изменённого договора `review` выполняет `--artifacts` и сохраняет снимок.
`stage=artifacts_only` не означает проверку содержания или исполнения правок.
Для стандартного договора та же команда выполняет `--verify`.

## Заверши внешние проверки

На каждом техническом этапе остаются `status=draft` и `ready_for_delivery=false`.
`source_conditions_verified_by_script=false`: мастер не устанавливает, что все исходные условия учтены. Пройди `source_condition_coverage` по `guide/06-review.md`, включая условия вне схемы.
Полностью просмотри Word и нужный PDF, сверь нумерацию, вёрстку, источники, условия и правки независимо по `guide/06-review.md`.
Сохрани протокол отдельно от договора. Любая непроведённая проверка или неисправленное расхождение сохраняет статус «черновик».
При передаче изменённого договора сообщите нам о правках и отметках.

Для сверки сохранённого комплекта используй прежний доверенный внешний якорь:

```text
.venv/bin/python -I scripts/wizard.py compare "<папка результата>/approved.json" --snapshot "<прежний снимок.json>" --snapshot-sha256 "<прежний доверенный внешний SHA-256>" --work-dir "<новая абсолютная приватная папка сравнения>"
```

При перемещении Word добавь `--document "<фактический новый путь.docx>"`.
Для перенесённых оригиналов используй `--compare-sources` прямого заполнителя по `guide/07-delivery.md`.
Успешное сравнение не заменяет полный просмотр, независимую сверку или проверку происхождения якоря.
При совпадении: `stage=snapshot_compared`, `check.unchanged=true`, код 0.
При отличиях или недоступных файлах: `stage=snapshot_changes_detected`, `check.unchanged=false`, код 1.
Во второй ветке `ok=true` означает, что операция сравнения выполнена. Совпадения и готовности нет.
`report.json` сохраняется в обеих ветках вместе с полным `check`.
Прочитай `data_changes`, `data_file_changed`, `release_changed`, `document` и `sources`.
Сохрани прежнюю и текущую версии. Дальше выполни соответствующую ветку `guide/07-delivery.md`.
При изменении значений, источников или правок повтори привязку и полное подтверждение.
Простое повторение той же команды не устраняет различия.

## Прочитай журнал и возобнови работу

Каждая выполненная операция сохраняет отдельные `stdout.txt`, `stderr.txt`, `result.json`.
Верхний `report.json` записывается после выполненного этапа; для сравнения с отличиями он тоже сохраняется.
Отказы после создания папки сохраняются в `error.json`.
`existing_files` перечисляет файлы верхнего уровня рабочей папки с их SHA-256, без подпапок журналов и ссылок.
При отказе до создания папки вывод и фактический код сохрани отдельно в приватной папке; `work_directory=null`.
Для отказов самого мастера читай `error.json`; для отказов заполнителя также читай журнал указанной операции.
После `02-fill` и отказа `03-verify` Word остаётся в рабочей папке. Он не прошёл отдельную проверку и остаётся черновиком.
При отказе сохранения снимка проверь его фактическое наличие. Не объявляй файл отсутствующим без проверки файлов и журналов.
Не перезаписывай папку повторным запуском. Исправь причину по оригиналам и выбери новую папку.

Состояние и отчёт — указатели, а не доказательства согласия или готовности.
После потери контекста выполни процедуру AGENTS.md: заново установи доверенность выпуска, ответа пользователя и внешнего якоря.
Дальше используй фактические файлы и `next_step`. Не пропускай шаги по отметке старого отчёта.
Для английского краткого описания добавь `--language en`.
Если мастер недоступен, прямые команды этапов 2–7 остаются рабочим маршрутом.
