Дебаты Astra × Fable05-commits-pr-and-acceptance

5. Коммиты, PR и независимая приёмка

Подготовка изменения

До реализации создаётся контракт: цель, границы, намерение/решения, затронутые инварианты, критерии приёмки, совместимость, риск, проверки, rollout и восстановление. После исследования область может уточняться; существенное расширение возвращает задачу на оценку влияния и полномочий.

Автор работает в выделенной ветке/checkout. Перед коммитом он проверяет status/diff, явный список включаемых файлов, новые зависимости, миграции, обновления знаний и отсутствие случайных секретов/артефактов. Логические коммиты объясняют проблему и изменение поведения; один коммит на каждый механический шаг ранбука не обязателен.

Локальные hooks дают быстрый feedback. Обязательное условие приёмки дублируется в доверенном исполнении: часть hooks Git можно пропустить. Git hooks

Push и PR — самостоятельные внешние действия. Адаптер проверяет remote, ветку, target и права; сохраняет результат. При повторе используется уже созданный PR соответствующего запуска, а не публикуется дубликат.

Содержание PR

Пользовательское описание: проблема, итоговое поведение, важные ограничения, существенные риски, что проверено и что остаётся неизвестным. Техническое приложение: CHG, решения, кандидат, manifest контекста, версии ранбуков, список проверок и артефактов, порядок выпуска/восстановления.

Раздел «не проверено» содержит конкретную область, последствия и план. Его пустота не считается обещанием абсолютной полноты. Если проверка не применима, приводится основание. Если не запущена — это отдельный статус, а не отсутствие строки в отчёте.

Идентичность принимаемого кандидата

Создайте неизменяемый core:

repository identity
head SHA + target base SHA
merge strategy + candidate tree/commit
source/dependency/configuration/environment digests
test plan + test data + trusted runner configuration digests
acceptance contract version
trusted policy version + runbook versions

candidate_id = SHA256(canonical_json(core)). Канонизацию, типы и версии схемы определяет адаптер; самовольное изменение сериализации создаёт новую версию схемы. Evidence не входит в core и ссылается на candidate ID извне, поэтому нет циклического вычисления хеша. Grant проверяется как отдельное текущее условие действия и ссылается на свою версию и область.

Новый head, base или значимый вход создаёт нового кандидата. В первом варианте процесса обязательные проверки повторяются. Переиспользование результата допускается позже только по формальному правилу неизменности входов. Локальный успех на head не подтверждает автоматически merge result.

Для squash/rebase полученный commit может иметь другой SHA. Доверенный адаптер предпочитает идентифицировать содержимое через tree вместе с явно записанными head/base и стратегией. Если используется синтетический merge commit, адаптер сохраняет созданный объект для повторного использования: его метаданные могут менять SHA при одинаковом дереве. После squash/rebase доверенный merge-адаптер должен проверить соответствие дерева и необходимых родителей проверенному результату по выбранной стратегии. Это часть его контракта.

Версия применимой активной политики входит в core намеренно. Её смена консервативно создаёт нового кандидата и повтор обязательных проверок, даже если diff продукта тот же. Это принятая цена простого MVP. При разделении политики на области адаптер доказывает, какая версия применима к действию; автор PR не может объявить чужое изменение политики нерелевантным сам.

Что является доказательством

Минимальный EV содержит candidate ID, проверку и её версию, доверенного исполнителя, время, фактические входы, статус, число/набор выполненных тестов, выходные артефакты и их хеши. Обязательные поля зависят от вида проверки.

«Автор сообщил passed» не является EV. Доверенный сборщик получает сведения из CI/исполнителя, проверяет происхождение, полноту, привязку к кандидату и целостность артефактов. Крупные логи хранятся отдельно, но доступны для проверки в пределах принятой retention policy.

Хеш проверяет целостность, но не происхождение и не истинность отчёта. При экспорте сохраняется проверяемое основание доверия к producer: идентичность запуска/сервиса и аттестация по выбранному протоколу. Утраченные основания прошлой приёмки маркируются как недоступные; сама историческая запись о выполненной приёмке не переписывается.

Кандидат не коммитит собственный свежий статус verified: результат вычисляется по внешним свидетельствам. В Git остаются нормы, тесты, планы проверки и исторические ссылки. Подробности — в главе 2.

Независимая приёмка

Приёмочный исполнитель самостоятельно получает кандидат, контракт и действующие правила. Авторский отчёт используется как указатель, а не единственный источник фактов. Для снижения общего заблуждения проверяющий сначала ищет контрпримеры и пропущенные пути, затем сопоставляет своё заключение с авторским объяснением.

Независимость имеет несколько измерений: отдельные полномочия; защищённый источник политики; отдельный запуск проверок; самостоятельно собранный критический контекст; разные методы проверки. Другая модель полезна, но сама по себе не создаёт технической независимости.

Условие Результат приёмки
Обязательная проверка не исполнилась/набор пуст blocked, если доверенное правило не доказало неприменимость
Проверка прошла на другом кандидате blocked, причина stale_evidence; нужна актуальная проверка
Обнаружено нарушение бизнес-критерия вернуть на реализацию
Есть фактологический спор исследовательский ранбук
Нужен новый выбор поведения/риска подготовленный пакет решения человеку
Всё подтверждено, полномочие применимо разрешить следующее действие в пределах GRANT

Финальный gate и merge

Gate проверяет: кандидат текущий; обязательный набор реально выполнен; результаты и происхождение валидны; существенные критерии закрыты; нет блокирующих конфликтов; требуемые решения относятся к нужному пакету; полномочие сейчас действует; есть доказанный механизм привязки merge к проверенным head/base/result.

Только после этого отдельный исполнитель выполняет условный merge или добавляет кандидата в корректно настроенную очередь. Изменение веток между проверкой и действием должно привести к отказу/перепроверке, а не к незаметной подмене. Если платформа или права не обеспечивают такую гарантию, этот режим автоматического merge пока недоступен.

GitHub предоставляет required checks, правила approvals и merge queue, но общий зелёный индикатор недостаточен: допустимые для платформы skipped/neutral не доказывают исполнение вашей обязательной проверки. Проверяются также источник статуса и конфигурация защиты от обхода. GitHub protected branches

Для GitLab проверяются соответствующие настройки MR approvals и запреты самоодобрения с учётом фактической версии/плана. Название функции платформы не заменяет теста отрицательного сценария. GitLab approvals

Изменение самой приёмки

PR, меняющий workflow, grant, схему evidence, правила тестового отбора или инструкции с исполняемыми полномочиями, проходит по прежней доверенной политике. Новая политика не может разрешить собственное принятие. Защищённые пути и отдельные роли — часть реализации; CODEOWNERS без проверки фактических прав и обходов нельзя считать достаточной защитой.

Код кандидата не исполняется с merge/production credentials. Проверяются пустые/пропущенные тесты, подмена workflow и источник отчёта. Сам policy-adapter имеет отдельные тесты допуска/отказа и процедуру выпуска.

Merge, выпуск и эксплуатационная приёмка

Merge подтверждает готовность интеграции кода. Выпуск требует отдельной проверки артефакта сборки, конфигурации, схемы и rollout. Эксплуатационная приёмка проверяет сигналы после выпуска: критические сценарии, ошибки, latency, очередь, данные и внешние эффекты по принятому контракту.

Одно решение может заранее разрешить цепочку этих действий в заданном классе. Если появляются новые последствия, модель готовит новый выбор, не перекладывая механику выпуска на человека.

Для доказательств назначаются срок хранения по риску и сроку эксплуатации, экспорт/резервная копия важных manifest и проверка восстановления. Удалённый CI-артефакт не считается доступным доказательством. Если свежий gate требует такое evidence, его восстанавливают или проверяют заново.