gitai로 에이전트 여럿이 main에 동시에 반영해도 거절되지 않게 하는 법

gitai는 동시 반영을 둘 다 받는다

에이전트 alpha와 beta가 같은 main에서 파일 하나씩을 고쳐 같은 순간 반영했습니다. 일반 git에서는 한쪽 push가 거절됐고, gitai에서는 둘 다 들어갔습니다.

git pushgitai land

graft log의 rewritten은 서버가 beta의 커밋을 alpha 커밋 뒤로 옮겨 다시 만들었다는 표시입니다.

gitai는 GitLab의 Git 서버 Gitaly를 고쳐 만든 MIT 라이선스 서버이고, 에이전트는 graft 명령으로 서버에 반영을 맡깁니다.

github.com↗

GitHub - feder-cr/git-ai: Git designed for AI agents.

Git designed for AI agents. Contribute to feder-cr/git-ai development by creating an account on GitHub.

1git clone https://github.com/feder-cr/git-ai.git
2cd git-ai
3make build                    # Go 1.26·C 컴파일러·Meson·Ninja 필요
4examples/graft/quickstart.sh  # 임시 폴더에 서버와 에이전트 둘을 띄워 반영까지

서버가 뜨면 에이전트마다 작업 폴더에서 graft commit -m으로 커밋을 만들고, 반영을 같은 순간 겁니다.

1export GRAFT_ADDRESS=unix:/srv/graft/run/gitaly.sock GRAFT_STORAGE=default
2for a in alpha beta; do
3  (cd $a && GRAFT_TOKEN=$(cat /srv/graft/tokens/$a) GRAFT_USER=$a \
4    GRAFT_AUTHOR="$a <$a@example.com>" graft land main) &
5done
6wait

1[graft]
2standalone = true
3
4[graft.land.batch]
5window = "500ms"   # 기본 10ms

거절은 브랜치 갱신 방식에서 생긴다

git은 브랜치를 compare-and-swap으로 바꿔서, 먼저 온 쪽이 main을 바꾸면 뒤쪽 push는 거절됩니다. compare-and-swap은 지금 값이 내가 읽은 값과 같을 때만 새 값으로 바꾸는 연산입니다. push도 "main이 A일 때만 C로 바꿔 달라"는 요청입니다.

git은 거절된 쪽에 받아 와서 다시 올리라고 돌려보냅니다. gitai는 브랜치마다 서버 메모리에 대기열을 두고, 진 요청을 새 tip 위로 옮겨 바로 다시 시도합니다. 창 안에 함께 들어온 요청은 차례로 얹은 뒤 갱신 한 번으로 반영합니다.

Anthropic은 하루 병합이 3만 건으로 늘자 git을 떠나 Scion으로 옮겼습니다. gitai는 그 공개 설계를 따라 만든 서버이고, Anthropic과는 관계가 없습니다.

gitai 제작자가 에이전트 50대로 250건을 반영했을 때, 에이전트가 각자 재시도하는 쪽은 반영 한 건마다 스물여섯 번 넘게 시도했습니다.

gitai가 반영하지 않은 50건은 일부러 넣은 충돌이라 에이전트에게 돌아갔고, 충돌 해결 규칙을 켜면 250건이 모두 들어갑니다.

에이전트마다 반영할 브랜치를 정할 수 있다

gitai는 에이전트마다 토큰을 따로 두고, 정책으로 누가 어느 브랜치를 바꿀지 정합니다. 규칙은 위에서부터 차례로 보고, 처음 맞는 규칙을 따릅니다. 아래는 alpha만 main을 바꾸고 나머지 에이전트는 다른 브랜치에만 반영하게 한 설정입니다.

1[[graft.policy]]
2actor = "alpha"
3refs = ["refs/heads/main"]
4allow = true
5
6[[graft.policy]]
7refs = ["refs/heads/main"]
8allow = false
9
10[[graft.policy]]
11refs = ["refs/heads/**"]
12allow = true

beta가 main으로 반영하면 두 번째 규칙에 걸려 거절되고, 커밋은 임시 브랜치에 남습니다. 거절된 반영은 graft log에 남지 않습니다. 같은 커밋을 graft land agent/beta로 보내면 반영됩니다.