babysit

О babysit

Следит за запросом на слияние (pull request) или циклом рецензирования до тех пор, пока он не станет действительно готовым к слиянию, продолжая проверять статус, а не останавливаясь после одного прохода, пока остаются необработанные комментарии или ветки рецензирования. Рабочий процесс определяет номер PR, исходную ветку (branch) и базовую ветку (base branch), подтверждает, что PR не является черновым, и проверяет возможность слияния, результаты проверок (checks), решение рецензента, комментарии и ветки рецензирования. Ожидающие проверки отслеживаются до их завершения с интервалом опроса примерно от 30 до 60 секунд, если пользователь не запросил другой интервал. Считываются новые комментарии и необработанные ветки рецензирования, при этом сводки ботов рассматриваются как полезные, но требующие проверки на соответствие коду выводы.

Реальные проблемы исправляются в сфокусированных коммитах, запускаются соответствующие тесты или сборки, изменения отправляются, и цикл возвращается к повторной проверке статуса. Устаревшие ветки рецензирования разрешаются только после подтверждения того, что код или сгенерированный артефакт теперь учитывают комментарий. Процесс останавливается только тогда, когда проверки проходят или намеренно пропускаются, решение рецензента приемлемо, не осталось действий по комментариям и не осталось необработанных веток рецензирования.

Навык предоставляет конкретные рецепты для GitHub CLI и GraphQL. Команда gh pr view со списком полей JSON дает грубый статус, включая состояние (state), статус черновика (draft status), возможность слияния (mergeability), статус возможности слияния (mergeStateStatus), решение рецензента (reviewDecision), OID верхней ссылки (headRefOid) и сводку проверок статуса (statusCheckRollup). Владелец и имя репозитория определяются с помощью gh repo view и jq перед выполнением запросов GraphQL. Необработанные ветки рецензирования извлекаются с помощью запроса GraphQL reviewThreads, который включает pageInfo для пагинации, с документированным циклом, который перебирает результаты, используя endCursor, пока hasNextPage истинно, и фильтрует необработанные ветки с помощью jq. Мутация resolveReviewThread разрешает ветку только при подтверждении исправления. Правила работы включают поддержание работы наблюдателя во время длительных проверок, подтверждение того, что проблемы, сообщенные ботом, относятся к устаревшему или текущему коду, проверку того, что исходный код и сгенерированные артефакты совпадают перед разрешением, выполнение свежей финальной проверки и отчет о конкретных доказательствах, таких как последний SHA коммита, результаты проверок, количество необработанных веток, запущенные тесты и любые измененные локальные файлы.

Часто задаваемые вопросы (FAQ)

Когда навык перестает следить за PR?

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

Как часто он опрашивает статус?

С практическим интервалом, обычно от 30 до 60 секунд, если пользователь не запросил другой интервал. Наблюдатель продолжает работать, пока все еще ожидаются длительные проверки.

Как находятся необработанные ветки рецензирования?

С помощью запроса GraphQL reviewThreads, который включает pageInfo, перебирая результаты с использованием предыдущего endCursor, пока hasNextPage истинно, затем фильтруя ветки, где isResolved ложно, с помощью jq.

Когда безопасно разрешать устаревшую ветку рецензирования?

Только после подтверждения того, что код или сгенерированный артефакт теперь учитывают комментарий, с использованием мутации resolveReviewThread. Для распределенных сгенерированных файлов необходимо сначала подтвердить, что исходный код и сгенерированный артефакт совпадают.

Что следует сообщать в конце?

Конкретные доказательства: последний SHA коммита, имена и результаты проверок, количество необработанных веток, запущенные тесты и любые измененные локальные файлы, оставленные без изменений, после выполнения одной свежей проверки статуса PR, веток, недавних комментариев и статуса git.