toki/proto-socket
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
proto-socket/agent-task/m-inbound-queue-ordering/07_python_gateway/CODE_REVIEW-cloud-G08.md
toki bdcebdeb56 feat: dart inbound gateway implementation and inbound queue ordering milestone progress 
- Add inbound_gateway.dart, inbound_gateway_io.dart, inbound_gateway_web.dart
- Update communicator.dart and proto_socket.dart for inbound queue support
- Update browser_ws_import_compile.dart and communicator_test.dart
- Archive Dart gateway task (04_dart_gateway)
- Create plan and code review docs for go/kotlin/python/typescript gateways
- Update roadmap files (ROADMAP.md, current.md, inbound-queue-ordering.md)
2026-06-02 10:45:33 +09:00

2.5 KiB
Raw Blame History

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