toki/nomadcode
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
nomadcode/agent-task/m-milestone-work-item-creation-sync/05+03,04_idempotency_retry/CODE_REVIEW-cloud-G07.md
toki f9c6be03ef feat: milestone work-item creation sync 관련 변경사항 커밋 
- projectsync: checkout, config 모듈 개선 및 테스트 추가
- workitempipeline: service 개선 및 테스트 추가
- http handlers 테스트 업데이트
- client: proto_socket_branch_event_service.dart 추가 및 테스트
- contracts notes 업데이트
- agent-task: milestone 하위 subtask PLAN/CODE_REVIEW 문서 추가
2026-06-13 16:45:10 +09:00

3.5 KiB
Raw Blame History

Code Review Reference - API

[IMPLEMENTING AGENT — READ FIRST] Filling in this file is the mandatory final step of implementation. Fill implementation-owned sections, run verification, keep active files in place, and report ready for review. Do not prompt the user directly during implementation.

개요

date=2026-06-13 task=m-milestone-work-item-creation-sync/05+03,04_idempotency_retry, plan=0, tag=API

Roadmap Targets

  • Milestone: agent-roadmap/phase/agent-ops-mcp-control-plane/milestones/milestone-work-item-creation-sync.md
  • Task ids:
    • cycle-idempotency: 같은 Plane 티켓 또는 같은 Milestone path 재처리 시 중복 생성 없이 남은 단계만 재시도한다.
  • Completion mode: check-on-pass

이 파일을 읽는 리뷰 에이전트에게

[REVIEW AGENT ONLY] 종결 절차는 코드리뷰 에이전트 전용이다.

구현 항목별 완료 여부

항목 완료 여부
[API-1] Identity Map Persistence [ ]
[API-2] Step Ledger [ ]
[API-3] Retry Decision Service [ ]

구현 체크리스트

  • Milestone path, provider, tenant, project, work item id, provider revision, roadmap revision을 저장하는 identity map migration/query/store를 추가한다.
  • provider work item 또는 Milestone path 재처리 시 existing identity를 찾고 중복 Milestone 생성/authoring을 막는다.
  • develop match, comment preserve, body/title update, Todo status move의 step ledger를 저장하고 성공한 step은 재시도하지 않는다.
  • actor guard와 revision mismatch가 silent overwrite 대신 conflict/retryable result를 반환하게 한다.
  • cd services/core && go test ./...와 git diff --check를 실행한다.
  • CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

코드리뷰 전용 체크리스트

  • 코드리뷰 결과에 PASS, WARN, FAIL 중 하나의 판정을 append한다.
  • active 파일을 .log로 아카이브하고 PASS이면 complete.log 작성 후 task directory를 archive로 이동한다.
  • PASS이고 task group이 m-<milestone-slug>이면 런타임 완료 이벤트 메타데이터를 보고한다.

계획 대비 변경 사항

구현 에이전트가 계획과 다르게 구현한 부분을 이유와 함께 기록한다.

주요 설계 결정

구현 에이전트가 주요 설계 결정 사항을 기록한다.

사용자 리뷰 요청

  • 상태: 없음
  • 사유 유형: 없음
  • 결정 필요: 없음
  • 차단 근거: 없음
  • 실행한 검증/명령: 없음
  • 자동 후속 불가 이유: 없음
  • 재개 조건: 없음

리뷰어를 위한 체크포인트

  • provider work item id와 Milestone path 양쪽 unique path가 중복 생성을 막는지 확인한다.
  • completed step이 재시도에서 다시 호출되지 않는지 확인한다.
  • actor guard가 NomadCode self mutation을 새 user trigger로 처리하지 않는지 확인한다.

검증 결과

API-1 중간 검증

$ cd services/core && go test ./internal/storage ./internal/db
(output)

API-3 중간 검증

$ cd services/core && go test ./internal/roadmapsync ./internal/storage
(output)

최종 검증

$ cd services/core && go test ./...
$ git diff --check
(output)