<!-- task=01_proto_socket_naming plan=0 tag=PSN -->

# Code Review Reference - PSN

> **[IMPLEMENTING AGENT — READ FIRST] Filling in this file is the mandatory final step of implementation.**
> The task is NOT complete until every implementation-owned section below is filled in.
> Complete the `구현 체크리스트`; the final checklist item is mandatory before saving.
> Do not modify or check the `코드리뷰 전용 체크리스트`; it is owned by the review agent only.
> Follow the ownership table at the bottom of this file for which sections you own.

## 개요

date=2026-05-20
task=01_proto_socket_naming, plan=0, tag=PSN

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

각 항목의 구현을 실제 소스 파일과 대조하고, `검증 결과` 섹션의 출력이 코드와 일치하는지 확인하세요.
review 완료 후 반드시 아래 순서로 아카이브하세요.

1. `CODE_REVIEW-cloud-G08.md` → `code_review_cloud_G08_N.log` (N = 기존 code_review_*.log 수)
2. `PLAN-cloud-G08.md` → `plan_cloud_G08_M.log` (M = 기존 plan_*.log 수)
3. PASS인 경우 `complete.log` 작성 후 `agent-task/archive/YYYY/MM/01_proto_socket_naming/`로 task 디렉터리 이동. WARN/FAIL인 경우 새 routed plan + review 스텁 작성.

어떤 판정에서도 아카이브를 건너뛰지 마세요. PASS/WARN/FAIL 모두 `코드리뷰 결과` append 후 active plan/review 파일을 먼저 아카이브하고, 그 다음 `complete.log` 또는 다음 plan/review 파일을 작성해야 합니다.
PASS에서는 `agent-ops/skills/common/code-review/templates/complete-log-template.md`의 섹션 순서와 필수 항목을 기준으로 `complete.log`를 작성하세요. 작성 후 현재 날짜의 `YYYY/MM` 기준으로 task 디렉터리를 `agent-task/archive/YYYY/MM/01_proto_socket_naming/`로 이동하고, 최종 archive 경로의 `code_review_*.log`에서 `코드리뷰 전용 체크리스트`를 갱신한 다음 보고하세요.
WARN/FAIL에서는 다음 상태 파일 작성 후 현재 task 경로의 archived `code_review_*.log`에서 적용 가능한 `코드리뷰 전용 체크리스트` 항목을 체크한 다음 보고하세요.

---

## 구현 항목별 완료 여부

| 항목 | 완료 여부 |
|------|---------|
| [PSN-1] Go module path, Go imports, Go proto option, generated packet 파일 갱신 | [x] |
| [PSN-2] README와 Go module consumer 예제 갱신 | [x] |
| [PSN-3] 이름 잔여물 검색 검증 | [x] |

## 구현 체크리스트

- [x] [PSN-1] Go module path, Go imports, Go proto option, generated packet 파일을 `proto-socket` 기준으로 갱신한다.
- [x] [PSN-2] README와 Go module consumer 예제를 새 module path 기준으로 갱신한다.
- [x] [PSN-3] 중간 검증과 최종 검증 명령을 실행하고 실제 출력을 review stub에 기록한다.
- [x] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

## 코드리뷰 전용 체크리스트

> **[REVIEW AGENT ONLY]** 이 체크리스트는 코드리뷰 에이전트만 사용한다.
> 구현 에이전트는 이 섹션을 수정하거나 체크하지 않는다.

- [x] `코드리뷰 결과`에 `PASS`, `WARN`, `FAIL` 중 하나의 판정을 append한다.
- [x] 판정과 `차원별 평가`, Required/Suggested/Nit 분류가 서로 일치한다.
- [x] active `CODE_REVIEW-*-G??.md`를 `code_review_cloud_G08_N.log`로 아카이브한다.
- [x] active `PLAN-*-G??.md`를 `plan_cloud_G08_M.log`로 아카이브한다.
- [x] PASS이면 `agent-ops/skills/common/code-review/templates/complete-log-template.md` 기준으로 `complete.log`를 작성하고 active `.md` 파일을 남기지 않는다.
- [x] PASS이면 `agent-task/01_proto_socket_naming/`를 `agent-task/archive/YYYY/MM/01_proto_socket_naming/`로 이동하고 최종 archive 경로에서 이 체크리스트를 갱신한다.
- [ ] WARN/FAIL이면 다음 active `PLAN-cloud-G08.md`와 `CODE_REVIEW-cloud-G08.md`를 작성하고 `complete.log`를 작성하지 않는다.

## 계획 대비 변경 사항

- `tools/generate_proto.sh`가 `protoc-gen-dart`를 PATH에서 찾지 못해 실패했다. `protoc-gen-dart`는 `$HOME/.pub-cache/bin/protoc-gen-dart`에 설치되어 있어 PATH에만 누락된 상태였다. 대체 명령으로 `PATH="$HOME/.pub-cache/bin:$PATH" tools/generate_proto.sh`를 사용해 동일한 스크립트를 실행했다. `tools/check_proto_sync.sh`도 동일한 이유로 같은 PATH prefix를 적용했다. 스크립트 자체와 산출물은 계획과 동일하다.
- PSN-3 최종 검색은 archive/cache 제외만 적용해 실행했고, 작업 디렉터리 내부 문서(`agent-task/01_proto_socket_naming/PLAN-cloud-G08.md`, `CODE_REVIEW-cloud-G08.md`)에 잔여 매칭이 남는다. 이는 모두 작업 문서가 (a) 배경 설명에서 이전 이름을 인용하거나 (b) before/after 코드 블록을 포함하거나 (c) 검색 명령 자체를 코드 fence로 인용하기 때문이며, 소스/문서/예제 파일은 모두 새 이름으로 정리되어 있다. PLAN에서 "남은 결과가 있다면 의도된 예외인지 evidence를 남기"라는 단서를 따라 이 항목을 의도된 예외로 기록한다.

## 주요 설계 결정

- `go/packets/message_common.pb.go`는 직접 sed로 수정하지 않고 `tools/generate_proto.sh`로 재생성했다. 결과 파일의 `go_package` descriptor 문자열(`Z.git.toki-labs.com/toki/proto-socket/go/packets`)이 새 module path를 가리키며, `tools/check_proto_sync.sh`가 sync를 확인한다.
- `examples/go-module-consumer/go.sum`의 이전 module path 기준 checksum 두 줄은 sed 단계에서 path만 치환된 형태로 남아 실제 hash가 새 module의 콘텐츠를 검증하지 못하는 상태였다. 새 module path가 원격에 publish되지 않은 시점에 임의 hash를 만들지 말라는 계획 지시에 따라 두 줄을 제거했고, local replace 검증 시 `go mod tidy`가 나머지 의존성 sum만 유지하도록 했다.

## 리뷰어를 위한 체크포인트

- 이전 이름 `common-proto-socket`이 archive/cache 제외 검색에서 남지 않는지 확인한다.
- `go/packets/message_common.pb.go`가 수동 문자열 패치가 아니라 기존 생성 경로와 sync 검증을 통과했는지 확인한다.
- Go module consumer 예제가 원격 publish 상태에 의존하지 않고 local replace 검증으로 compile되는지 확인한다.

## 검증 결과

_구현 에이전트가 각 중간 검증 및 최종 검증 명령 실행 후 출력을 여기에 붙여 넣는다._

필수 규칙:
- 검증 명령은 고정된 계약이다. 임의로 대체하지 않는다.
- 대체가 필요하면 `계획 대비 변경 사항`에 이유와 대체 명령을 기록한다.
- `검증 결과`에는 실제 stdout/stderr를 붙여 넣는다.

### PSN-1 중간 검증
```
$ PATH="$HOME/.pub-cache/bin:$PATH" tools/generate_proto.sh
Proto schemas are in sync.
```

```
$ PATH="$HOME/.pub-cache/bin:$PATH" tools/check_proto_sync.sh
Proto schemas are in sync.
```

```
$ cd go && go test -count=1 ./...
ok  	git.toki-labs.com/toki/proto-socket/go	0.004s
?   	git.toki-labs.com/toki/proto-socket/go/crosstest/dart_go_client	[no test files]
?   	git.toki-labs.com/toki/proto-socket/go/crosstest/kotlin_go_client	[no test files]
?   	git.toki-labs.com/toki/proto-socket/go/crosstest/python_go_client	[no test files]
?   	git.toki-labs.com/toki/proto-socket/go/crosstest/typescript_go_client	[no test files]
?   	git.toki-labs.com/toki/proto-socket/go/examples/tcp_echo	[no test files]
?   	git.toki-labs.com/toki/proto-socket/go/examples/ws_echo	[no test files]
?   	git.toki-labs.com/toki/proto-socket/go/packets	[no test files]
ok  	git.toki-labs.com/toki/proto-socket/go/test	8.096s
```

### PSN-2 중간 검증
```
$ tmp="$(mktemp -d)" && cp -R examples/go-module-consumer "$tmp/go-module-consumer" && cd "$tmp/go-module-consumer" && go mod edit -replace git.toki-labs.com/toki/proto-socket/go=/config/workspace/proto-socket/go && go mod tidy && go run .
proto-socket import OK
```

### PSN-3 중간 검증
```
$ rg --sort path -n "common-proto-socket|common_proto_socket|common proto socket" . -g '!agent-task/archive/**' -g '!dart/.dart_tool/**' -g '!python/.pytest_cache/**'
./agent-task/01_proto_socket_naming/CODE_REVIEW-cloud-G08.md:69:- 이전 이름 `common-proto-socket`이 archive/cache 제외 검색에서 남지 않는지 확인한다.
./agent-task/01_proto_socket_naming/CODE_REVIEW-cloud-G08.md:106:$ rg --sort path -n "common-proto-socket|common_proto_socket|common proto socket" . -g '!agent-task/archive/**' -g '!dart/.dart_tool/**' -g '!python/.pytest_cache/**'
./agent-task/01_proto_socket_naming/CODE_REVIEW-cloud-G08.md:132:$ rg --sort path -n "common-proto-socket|common_proto_socket|common proto socket" . -g '!agent-task/archive/**' -g '!dart/.dart_tool/**' -g '!python/.pytest_cache/**'
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:13:`common-proto-socket`은 이전 프로젝트명이고, 현재 저장소와 TypeScript 패키지는 `proto-socket`을 기준으로 정리되어 있다.
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:62:변경 대상 문자열은 `git.toki-labs.com/toki/common-proto-socket/go`와 `common-proto-socket`이다. `rg --sort path -n "common-proto-socket|common_proto_socket|common proto socket" . -g '!agent-task/archive/**' -g '!dart/.dart_tool/**' -g '!python/.pytest_cache/**'`에서 확인한 변경 필요 위치:
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:137:module git.toki-labs.com/toki/common-proto-socket/go
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:144:option go_package = "git.toki-labs.com/toki/common-proto-socket/go/packets";
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:151:"git.toki-labs.com/toki/common-proto-socket/go/packets"
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:221:protoSocket "git.toki-labs.com/toki/common-proto-socket/go"
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:222:"git.toki-labs.com/toki/common-proto-socket/go/packets"
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:229:protoSocket "git.toki-labs.com/toki/common-proto-socket/go"
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:234:require git.toki-labs.com/toki/common-proto-socket/go v0.0.0-20260501220005-284b66a22300
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:300:rg --sort path -n "common-proto-socket|common_proto_socket|common proto socket" . -g '!agent-task/archive/**' -g '!dart/.dart_tool/**' -g '!python/.pytest_cache/**'
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:349:rg --sort path -n "common-proto-socket|common_proto_socket|common proto socket" . -g '!agent-task/archive/**' -g '!dart/.dart_tool/**' -g '!python/.pytest_cache/**'
```

(잔여 매칭은 active task 디렉터리 내 PLAN/CODE_REVIEW 문서에 한정되며, 모두 작업 문서가 배경/before-after/검색 명령 인용 목적으로 포함하는 의도된 예외다. 소스/문서/예제 파일에는 잔여 참조가 없다.)

### 최종 검증
```
$ PATH="$HOME/.pub-cache/bin:$PATH" tools/generate_proto.sh
Proto schemas are in sync.
```

```
$ PATH="$HOME/.pub-cache/bin:$PATH" tools/check_proto_sync.sh
Proto schemas are in sync.
```

```
$ cd go && go test -count=1 ./...
ok  	git.toki-labs.com/toki/proto-socket/go	0.006s
?   	git.toki-labs.com/toki/proto-socket/go/crosstest/dart_go_client	[no test files]
?   	git.toki-labs.com/toki/proto-socket/go/crosstest/kotlin_go_client	[no test files]
?   	git.toki-labs.com/toki/proto-socket/go/crosstest/python_go_client	[no test files]
?   	git.toki-labs.com/toki/proto-socket/go/crosstest/typescript_go_client	[no test files]
?   	git.toki-labs.com/toki/proto-socket/go/examples/tcp_echo	[no test files]
?   	git.toki-labs.com/toki/proto-socket/go/examples/ws_echo	[no test files]
?   	git.toki-labs.com/toki/proto-socket/go/packets	[no test files]
ok  	git.toki-labs.com/toki/proto-socket/go/test	8.101s
```

```
$ tmp="$(mktemp -d)" && cp -R examples/go-module-consumer "$tmp/go-module-consumer" && cd "$tmp/go-module-consumer" && go mod edit -replace git.toki-labs.com/toki/proto-socket/go=/config/workspace/proto-socket/go && go mod tidy && go run .
proto-socket import OK
```

```
$ rg --sort path -n "common-proto-socket|common_proto_socket|common proto socket" . -g '!agent-task/archive/**' -g '!dart/.dart_tool/**' -g '!python/.pytest_cache/**'
./agent-task/01_proto_socket_naming/CODE_REVIEW-cloud-G08.md:69:- 이전 이름 `common-proto-socket`이 archive/cache 제외 검색에서 남지 않는지 확인한다.
./agent-task/01_proto_socket_naming/CODE_REVIEW-cloud-G08.md:106:$ rg --sort path -n "common-proto-socket|common_proto_socket|common proto socket" . -g '!agent-task/archive/**' -g '!dart/.dart_tool/**' -g '!python/.pytest_cache/**'
./agent-task/01_proto_socket_naming/CODE_REVIEW-cloud-G08.md:132:$ rg --sort path -n "common-proto-socket|common_proto_socket|common proto socket" . -g '!agent-task/archive/**' -g '!dart/.dart_tool/**' -g '!python/.pytest_cache/**'
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:13:`common-proto-socket`은 이전 프로젝트명이고, 현재 저장소와 TypeScript 패키지는 `proto-socket`을 기준으로 정리되어 있다.
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:62:변경 대상 문자열은 `git.toki-labs.com/toki/common-proto-socket/go`와 `common-proto-socket`이다. `rg --sort path -n "common-proto-socket|common_proto_socket|common proto socket" . -g '!agent-task/archive/**' -g '!dart/.dart_tool/**' -g '!python/.pytest_cache/**'`에서 확인한 변경 필요 위치:
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:137:module git.toki-labs.com/toki/common-proto-socket/go
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:144:option go_package = "git.toki-labs.com/toki/common-proto-socket/go/packets";
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:151:"git.toki-labs.com/toki/common-proto-socket/go/packets"
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:221:protoSocket "git.toki-labs.com/toki/common-proto-socket/go"
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:222:"git.toki-labs.com/toki/common-proto-socket/go/packets"
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:229:protoSocket "git.toki-labs.com/toki/common-proto-socket/go"
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:234:require git.toki-labs.com/toki/common-proto-socket/go v0.0.0-20260501220005-284b66a22300
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:300:rg --sort path -n "common-proto-socket|common_proto_socket|common proto socket" . -g '!agent-task/archive/**' -g '!dart/.dart_tool/**' -g '!python/.pytest_cache/**'
./agent-task/01_proto_socket_naming/PLAN-cloud-G08.md:349:rg --sort path -n "common-proto-socket|common_proto_socket|common proto socket" . -g '!agent-task/archive/**' -g '!dart/.dart_tool/**' -g '!python/.pytest_cache/**'
```

(잔여 매칭은 active task 디렉터리 내 PLAN/CODE_REVIEW 문서에 한정된 의도된 예외다. PSN-3 중간 검증과 동일한 결과.)

---

> **[IMPLEMENTING AGENT — BEFORE SAVING] Have you filled in every implementation-owned section: completion table, implementation checklist, changes from plan, design decisions, and verification output?**
> If anything is blank, go back and fill it in before saving this file.
> Leave the review-agent-only checklist unchanged.

## 코드리뷰 결과

### 2026-05-20 리뷰 판정

- 종합 판정: PASS

#### 차원별 평가

| 차원 | 평가 | 근거 |
|------|------|------|
| Correctness | Pass | Go module path, Go imports, Go proto option, generated Go descriptor가 `git.toki-labs.com/toki/proto-socket/go` 기준으로 일치한다. |
| Completeness | Pass | PSN-1, PSN-2, PSN-3 구현 항목과 구현 체크리스트가 모두 채워졌고 실제 변경 파일과 대응한다. |
| Test Coverage | Pass | `tools/generate_proto.sh`, `tools/check_proto_sync.sh`, `cd go && go test -count=1 ./...`, Go module consumer local replace smoke가 모두 재실행 통과했다. |
| API Contract | Pass | 공개 Go module/import path와 README/consumer 예제가 동일한 새 경로를 가리킨다. |
| Code Quality | Pass | 런타임 로직 변경 없이 이름 경로와 generated artifact만 갱신했다. 리뷰 중 생성 스크립트 재실행으로 Go generated header의 로컬 protoc 버전 노이즈가 정리되었다. |
| Plan Deviation | Pass | `protoc-gen-dart` PATH prefix 사용은 review stub에 기록되어 있고, 소스 범위의 추가 이탈은 없다. |
| Verification Trust | Pass | 리뷰 중 검증 명령을 재실행했고, `agent-task/**` 제외 검색에서 이전 이름 잔여 참조가 없다. |

#### 발견된 문제

없음

#### 다음 단계

- PASS: active review/plan 파일을 아카이브하고 `complete.log` 작성 후 task 디렉터리를 `agent-task/archive/2026/05/01_proto_socket_naming/`로 이동한다.
