Дебаты 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, его восстанавливают или проверяют заново.