Skip to content

feat(factory): merge steward guard engine, dry-run only (AGT-4879) - #911

Open
unohee wants to merge 1 commit into
mainfrom
heewonoh/agt-4879-steward-guards
Open

unohee wants to merge 1 commit into
mainfrom
heewonoh/agt-4879-steward-guards

Conversation

@unohee

@unohee unohee commented Nov 14, 2026

Copy link
Copy Markdown
Collaborator

무엇

src/automation/mergeStewardGuards.ts — merge steward 의 판정만 하는 순수 함수 (AGT-4803 하위). 실제 머지·GitHub 호출·프로세스 실행 경로는 없다.

가드 4개, 전부 fail-closed:

  1. required-checks — branch protection 의 required check 가 전부 현재 head SHA 에서 success. 빈 required 집합은 거부(AGT-4414), 다른 커밋에서만 녹색이면 거부, 같은 head 에서 재실행이 실패/pending 이면 거부.
  2. risk — 분류 결과가 low 이고 head SHA 에서 분류된 것. unknown/없음/이전 SHA 는 거부. (AGT-4804 feat(publish): classify each change's risk as low/medium/high from its final diff (AGT-4804) #884 를 import 하지 않고 같은 3단계 타입을 로컬로 둔다. PR 본문의 ## Risk 는 worker 가 고칠 수 있어 읽지 않는다 — 입력은 run 기록에서 와야 한다.)
  3. sibling-overlap — 다른 열린 swarm PR 과 겹치는 파일이 없음. 이 PR 또는 sibling 의 파일 목록이 unknown/잘림이면 거부. rename 은 old/new 경로 둘 다 목록에 넣는 계약. OpenSwarm bookkeeping(.openswarm-preserved 등)은 isBookkeepingPath 로 제외.
  4. review-completeness — reviewer verdict approve, completeness complete, 둘 다 head SHA 기준. 제목의 [partial] 도 거부. reviewer 기록이 없으면 거부(AGT-4806 이 아직 안 들어온 동안 fail-closed).
  • evaluateMergeSteward(snapshot) 은 항상 4개 전부를 돌린다. dryRun: false 는 조용히 무시하지 않고 throw.
  • 결정에 계산 기준 headSha 가 붙고, isDecisionCurrent 로 head 가 바뀌면 무효.
  • formatStewardDecision 이 판정과 사유를 한 줄로 기록.

왜

AGT-4803: worker·publisher 는 머지하면 안 되고(AGT-4414), 무인 공장의 머지 경로는 사람보다 엄격해야 한다. 이번 이슈는 그 판정만 dry-run 으로 먼저 만든다.

검증

  • npx vitest run src/automation/mergeStewardGuards.test.ts — 23 tests 통과.
    • 가드마다: all-green baseline 에서 한 가지만 다른 fixture 가 (a) 전체 엔진에서 그 가드 이름으로만 거부되고 (b) 그 가드를 뺀 엔진에서는 통과한다 → 네 가드 모두 load-bearing.
    • 빈 required set, pending/missing, 이전 SHA 증거(check·risk·review·completeness), unknown risk, 잘린 파일 목록, rename source, [partial] 제목 각각 테스트.
    • 모듈 소스가 siblingWorkFormat 외에는 import 하지 않고 child_process/fetch/merge 호출이 없음을 고정.
  • npm run typecheck, oxlint 0 errors.

남은 것

A pure decision over a PR snapshot with four fail-closed guards: required
checks green on the head SHA, risk low, no open sibling PR touching the
same files, reviewer approved and the run complete. Evidence recorded on
another commit, missing or truncated counts as a failure. dryRun: false
throws; there is no merge path. Each guard has a test that the PR it
refuses is let through once that guard is removed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant