<!-- task=m-api-centered-proto-socket-rail/01_contracts_api_registry plan=1 tag=REVIEW_API -->
# PLAN-cloud-G07: Verification Evidence Recovery

## 이 파일을 읽는 구현 에이전트에게

이 후속 계획은 `plan_cloud_G07_0.log` / `code_review_cloud_G07_0.log`의 Required 이슈만 다룬다. 소스 정적 대조상 즉시 수정해야 할 코드 결함은 발견되지 않았고, 차단 지점은 필수 검증 출력 부재다.

## 배경

이전 구현은 API handler registry와 parser map 테스트를 보강했지만, 최종 검증으로 지정된 `go test ./services/api/...`와 `bin/contracts-check`의 실제 stdout/stderr를 리뷰 파일에 남기지 않았다. 현재 로컬 테스트 규칙은 local 실행을 금지하므로, 원격 검증 환경에서 실제 결과를 확보해야 한다.

## 사용자 리뷰 요청 흐름

원격 환경에서 명령이 없거나 SDK/tool/runtime이 없어 실행할 수 없으면, 추정하지 말고 `command -v <missing-tool>` 또는 실제 stderr를 포함해 `CODE_REVIEW-cloud-G07.md`의 사용자 리뷰 요청 섹션을 채운다. 테스트 실패가 코드 문제라면 사용자 리뷰로 넘기지 말고 필요한 최소 수정 후 재실행한다.

## 구현 체크리스트

### [REVIEW_API-1] 필수 원격 검증 출력 확보

문제:
필수 검증 명령의 실제 stdout/stderr가 없어 parser map과 API socket handler registry 변경의 최종 통과 여부를 판정할 수 없다.

해결 방법:
원격 검증 환경에서 아래 명령을 실행하고 실제 stdout/stderr를 `CODE_REVIEW-cloud-G07.md`에 기록한다. 명령이 통과하면 소스 변경 없이 검증 결과만 남긴다. 코드 또는 테스트 실패가 나오면 실패 원인을 좁게 수정하고 같은 명령을 재실행한다.

수정 파일 및 체크리스트:
- `agent-task/m-api-centered-proto-socket-rail/01_contracts_api_registry/CODE_REVIEW-cloud-G07.md`
- 필요 시 `services/api/internal/socket/**`
- 필요 시 `services/api/internal/contracts/**`
- [ ] `go test ./services/api/...`의 실제 stdout/stderr를 기록한다.
- [ ] `bin/contracts-check`의 실제 stdout/stderr를 기록한다.
- [ ] 실패가 코드 문제이면 최소 수정 후 재실행 결과를 기록한다.
- [ ] 환경/tool 부재이면 `command -v` 또는 실제 stderr를 사용자 리뷰 요청에 기록한다.
- [ ] 최종 단계로 `CODE_REVIEW-cloud-G07.md` 구현 체크리스트를 완료한다.

테스트 작성:
- 새 테스트 작성이 목적이 아니다. 기존 후속 검증 명령의 실제 실행 결과를 확보한다.
- 테스트 실패가 기존 테스트의 의미 부족 때문이면 원인과 수정 이유를 기록하고 좁게 보강한다.

중간 검증:
- 원격 검증 환경에서만 `go test ./services/api/...` 실행.
- 원격 검증 환경에서만 `bin/contracts-check` 실행.

## 수정 파일 요약

- 필수: `agent-task/m-api-centered-proto-socket-rail/01_contracts_api_registry/CODE_REVIEW-cloud-G07.md`
- 조건부: `services/api/internal/socket/**`, `services/api/internal/contracts/**`

## 최종 검증

- 원격 검증 환경에서만 `go test ./services/api/...`
- 원격 검증 환경에서만 `bin/contracts-check`

모든 검증/수정 완료 후 반드시 `CODE_REVIEW-cloud-G07.md`의 구현 에이전트 소유 섹션을 채운다.
