nomadcode/agent-ops/roadmap/milestones/plane-thin-e2e-loop.md

Plane Thin E2E Loop

목표

Plane issue를 core task의 외부 출처로 연결하고, task 실행 결과를 Plane comment/status로 되돌려보내는 최소 e2e cycle을 완성한다. Workflow Core의 retry, timeout, notification event 정책은 이 실제 loop가 관찰된 뒤 안정화한다.

단계

Plane Thin E2E

상태

진행 중

범위

• Plane issue 기반 작업 입력과 core task 생성 경로
• core task와 Plane issue의 외부 참조 연결
• task 완료와 실패 결과의 Plane comment/status 반영
• 최소 e2e 검증 절차와 운영 설정 문서화

필수 기능

• Plane issue를 core task로 연결하는 최소 입력 계약을 정한다.
  • task에 provider, external_id, external_url 등 외부 참조를 저장하는 방식을 정한다.
  • Plane issue title/description/comment 중 어떤 값을 task title/payload로 매핑할지 정한다.
• Plane adapter에서 issue comment와 status update 실제 호출을 구현한다.
  • PLANE_BASE_URL, PLANE_TOKEN 설정과 adapter client 동작을 README 또는 운영 문서와 맞춘다.
• task 완료/실패 시 Plane에 결과를 남기는 발행 지점을 workflow 또는 scheduler에 연결한다.
  • completed 결과는 Plane comment로 남긴다.
  • failed 결과는 Plane comment 또는 status로 관찰 가능하게 남긴다.
• Plane issue에서 core task 실행 결과가 Plane에 다시 남는 e2e 검증 시나리오를 정리한다.

완료 기준

• Plane issue 하나를 기준으로 core task를 만들고 enqueue할 수 있다.
• core task의 completed 결과가 Plane issue comment 또는 status에 반영된다.
• core task의 failed 결과가 Plane issue에서 관찰 가능하게 남는다.
• e2e loop 검증 명령이나 수동 절차가 문서에 남아 있다.
• Workflow Core에서 후속으로 정리할 retry, timeout, notification event TODO가 실제 loop 기준으로 드러난다.

범위 제외

• Plane 전체 양방향 동기화
• Plane webhook 기반 자동 수집의 완전한 운영화
• Mattermost 메시지 발송 구현
• Agent Integrator와 IOP의 추가 통합
• 복잡한 workflow DSL

작업 컨텍스트

• 관련 경로: services/core/internal/adapters/plane/, services/core/internal/workflow/, services/core/internal/scheduler/, services/core/internal/storage/
• 선행 작업: Server Skeleton
• 후속 작업: Workflow Core
• 확인 필요: Plane issue 상태 값과 comment API의 실제 계약은 구현 전에 확인이 필요하다.