gito/agent-roadmap/phase/provider-change-request-integration/PHASE.md

Phase: Provider Change Request Integration

상태

[계획]

목표

GitHub PR, GitLab MR, Gitea PR 같은 provider 기능을 provider-neutral ChangeRequest 인터페이스로 묶는다. Webhook은 빠른 wakeup signal로 사용하되, 최종 상태 판정은 Git revision/diff와 provider read API로 재검증한다.

Milestone 흐름

완료된 Milestone은 archive 경로를 가리키고, 검토중, 진행중, 계획, 스케치 또는 보류 Milestone은 이 Phase 하위 milestones/ 경로를 가리킨다. 완료, 검토중, 진행중, 계획, 스케치 순서로 두어 아래로 갈수록 미래 작업에 가까워지게 정렬한다. 스케치 Milestone은 아직 구현 가능한 계획이 아니므로 계획 Milestone보다 아래에 둔다.

• [계획] Provider Adapter Foundation

  • 경로: agent-roadmap/phase/provider-change-request-integration/milestones/provider-adapter-foundation.md
  • 요약: provider registry, credential ref, webhook intake, provider capability boundary를 만든다.

• [계획] Change Request Abstraction

  • 경로: agent-roadmap/phase/provider-change-request-integration/milestones/change-request-abstraction.md
  • 요약: GitHub PR, GitLab MR, Gitea PR을 공통 ChangeRequest action과 event로 표현한다.

• [계획] Webhook Revision Reconcile

  • 경로: agent-roadmap/phase/provider-change-request-integration/milestones/webhook-revision-reconcile.md
  • 요약: provider webhook, polling, Git revision scan을 같은 변경 event로 정규화하고 재검증한다.

Phase 경계

• Git 자체 조작은 provider adapter가 아니라 platformless Git engine이 맡는다.
• provider adapter는 PR/MR/review/checks/comment/webhook 같은 플랫폼 API만 맡는다.
• provider별 credential 원문은 tracked 파일에 저장하지 않고 credential ref로만 연결한다.
• provider webhook만으로 상태를 확정하지 않고 Git revision 또는 provider read API로 확인한다.