proto-socket/agent-roadmap/milestones/workspace-port-env-standardization.md
toki 83a8b2250e perf(dart): WS burst 수신 회귀를 해소한다
작은 WS frame을 isolate 왕복 없이 처리해 full 성능 검증에서 확인된 Dart WS burst hard-gate 회귀를 닫는다.

성능 검증 루프의 task archive와 로드맵 완료 근거도 함께 보존한다.
2026-06-07 20:42:33 +09:00

2.8 KiB

워크스페이스 포트/환경 표준화

목표

Proto Socket은 runtime service port를 소유하지 않는 라이브러리지만, cross-language/cross-runtime test runner에서 고정 local port 대역을 사용한다. 이 Milestone은 proto-socket의 fixed test port 대역을 workspace 포트 표준의 예외로 명확히 기록하고, remote Dart web/Chrome fallback 환경도 raw secret 없이 재현 가능한 기준으로 정리한다.

단계

안정화와 유지

상태

[진행중]

구현 잠금

  • 상태: 해제
  • 결정 필요: 없음

범위

  • runtime service/frontend/backend 포트 없음 상태를 명시
  • cross-language/cross-runtime test runner의 fixed local port 대역을 workspace 표준 예외로 문서화
  • remote Dart web/Chrome fallback runner와 WSS/SPKI wrapper 환경을 테스트 runner 예외로 정리
  • 일반 예시 포트와 test matrix reserved 대역이 다른 프로젝트 host publish 포트와 충돌하지 않도록 기준 정리
  • private SSH host, credential, token 값은 tracked 문서에 쓰지 않고 runner 책임 경계만 기록

기능

Epic: [exception] Proto-socket port exception

Proto Socket의 테스트용 포트 사용을 제품 runtime 포트와 구분한다.

  • [no-runtime-port] proto-socket은 frontend/backend runtime service port를 소유하지 않는다는 기준을 README/test 문서에서 확인 가능하게 정리한다.
  • [test-port-range] cross-language fixed local port 대역 29090-29899를 workspace 표준 예외로 문서화하고 충돌 방지 기준을 남긴다.
  • [example-ports] 예제/문서의 9090류 포트가 test matrix reserved 대역과 제품 host publish 대역을 오해하게 만들지 않는지 점검한다.
  • [remote-web-runner] Dart web/Chrome remote fallback, WSS/SPKI wrapper, SSH runner 경계는 raw secret 없이 테스트 환경 예외로 정리한다.

완료 리뷰

  • 상태: 없음
  • 요청일: 없음
  • 완료 근거: 없음
  • 리뷰 필요:
    • 사용자가 완료 결과를 확인했다
    • archive 이동을 승인했다
  • 리뷰 코멘트: 없음

범위 제외

  • wire format, proto schema, nonce 의미 변경
  • performance hotspot 개선 작업
  • package registry release 작업
  • C# 또는 Swift 포팅
  • private SSH credential, host token, certificate secret 기록

작업 컨텍스트

  • 관련 경로: agent-test/local/, agent-ops/skills/project/run-proto-socket-test-matrix/, dart/, go/, kotlin/, python/, typescript/, examples/
  • 표준선(선택): 29090-29899는 workspace frontend/backend/backend-artifact 대역이 아니라 proto-socket test runner 전용 reserved range다.
  • 선행 작업: workspace 공통 포트 inventory 정리
  • 후속 작업: test docs와 runner script의 port drift 방지
  • 확인 필요: 없음