gito/agent-roadmap/phase/control-plane-foundation/PHASE.md
toki c9952509e9 feat(core): Forgejo 브랜치 이벤트 및 런타임 채널 인프라를 추가한다
- ControlPlane 라우터에 워커/에이전트 구독 채널을 추가한다
- ProtoSocket 기반 실시간 양방향 채널( dispatcher, envelope, server)을 구현한다
- Forgejo push 이벤트를 provider 어댑터로 처리하도록 연동한다
- PostgreSQL 스토리지 백엔드를 분리하여 postgres.go로 신설한다
- Git engine command에 diff/checkout/merge 연쇄 연산을 추가한다
- 런타임 모델에 agentSession, runtimeChannel 스키마를 추가한다
- 데이터베이스 마이그레이션에 agent_session, runtime_channel, lease 테이블을 추가한다
- agent-contract에 Forgejo branch events 계약 문서를 작성한다
- 로드맵 마일스톤과 아카이브 작업을 갱신한다
2026-06-13 19:16:03 +09:00

2.6 KiB

Phase: Control Plane Foundation

상태

[진행중]

목표

Gito의 초기 control plane을 build 가능한 modular monolith로 구성한다. platformless Git engine, repo/workspace/operation/event core model, Postgres 원장, proto-socket 우선 transport 경계를 정의하고 실제 구현 가능한 baseline으로 만든다.

Milestone 흐름

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

  • [검토중] Runtime Scaffold and Contract Baseline

    • 경로: agent-roadmap/phase/control-plane-foundation/milestones/runtime-scaffold-and-contract-baseline.md
    • 요약: Go command, Flutter control surface placeholder, contracts, agent-ops, README, architecture 문서를 실행 가능한 기준선으로 정리한다.
  • [진행중] Forgejo Branch Event MVP

    • 경로: agent-roadmap/phase/control-plane-foundation/milestones/forgejo-branch-event-mvp.md
    • 요약: Forgejo push webhook을 watched branch branch.updated event로 정규화하고 NomadCode가 proto-socket으로 받을 수 있는 MVP slice를 만든다.
  • [계획] Repo Registry and Workspace Lease

    • 경로: agent-roadmap/phase/control-plane-foundation/milestones/repo-registry-and-workspace-lease.md
    • 요약: 관리 대상 repo와 workspace slot/lease를 Postgres source of truth로 저장하고 안전하게 할당한다.
  • [계획] Platformless Git Operation Engine

    • 경로: agent-roadmap/phase/control-plane-foundation/milestones/platformless-git-operation-engine.md
    • 요약: clone, fetch, status, diff, commit, push, revision scan을 provider 없이 local bare repo 기반으로 검증한다.
  • [계획] Operation Event Outbox

    • 경로: agent-roadmap/phase/control-plane-foundation/milestones/operation-event-outbox.md
    • 요약: operation lifecycle, idempotency, audit event, outbox 발행을 PostgreSQL 기준으로 구성한다.

Phase 경계

  • 이 Phase는 Gito 자체 control plane과 platformless Git 기반만 다룬다.
  • IOP CLI 실행과 agent-shell streaming은 다음 Phase에서 다룬다.
  • PR/MR 같은 provider API는 provider integration Phase에서 다룬다.
  • Flutter 화면의 실제 UX 완성은 control surface Phase에서 다룬다.
  • Redis는 이 Phase의 source of truth가 아니며, 필요할 때 event fanout 가속 후보로만 남긴다.