<!-- task=m-inbound-queue-ordering/07_python_gateway plan=0 tag=API -->

# Code Review Reference - API

> **[IMPLEMENTING AGENT — READ FIRST]** 구현 후 이 파일을 채우고 active 파일을 그대로 둔 채 리뷰를 요청한다. 최종화는 code-review 전용이다.

## 개요

date=2026-06-02
task=m-inbound-queue-ordering/07_python_gateway, plan=0, tag=API

## Roadmap Targets

- Milestone: `agent-roadmap/milestones/inbound-queue-ordering.md`
- Task ids:
  - `python-gateway`: Python process/asyncio worker gateway 후보를 적용한다.
- Completion mode: check-on-pass

## 구현 항목별 완료 여부

| 항목 | 완료 여부 |
|------|---------|
| [API-1] Python gateway worker candidate | [ ] |

## 구현 체크리스트

- [ ] Python gateway input/output에 내부 `seq`를 포함하고 asyncio worker 또는 process worker 후보를 추가한다.
- [ ] gateway는 decode/전처리만 수행하고 pending/listener/request/write queue 상태를 소유하지 않는다.
- [ ] 작은 packet에서는 gateway off fallback이 기존 receive coordinator path를 사용하도록 한다.
- [ ] Python tests에 out-of-order worker completion, fallback, close/cancel 순서 검증을 추가한다.
- [ ] 중간 검증으로 `cd python && python3 -m pytest -q test/test_communicator.py`를 실행한다.
- [ ] 최종 검증으로 `bash agent-ops/skills/project/run-proto-socket-test-matrix/scripts/run_matrix.sh --all`을 실행한다.
- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

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

- [ ] verdict append, log archive, PASS complete.log/archive move를 수행한다.

## 계획 대비 변경 사항

_구현 에이전트가 기록한다._

## 주요 설계 결정

_구현 에이전트가 기록한다._

## 사용자 리뷰 요청

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

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

- process/async worker가 stateful dispatch를 소유하지 않는지 확인한다.
- fallback path가 기존 coordinator path인지 확인한다.

## 검증 결과

### API-1 중간 검증
```
$ cd python && python3 -m pytest -q test/test_communicator.py
```

### 최종 검증
```
$ bash agent-ops/skills/project/run-proto-socket-test-matrix/scripts/run_matrix.sh --all
```