proto-socket/agent-roadmap/milestones/stability-baseline.md

안정화 기준선

목표

현재 사용 가능한 Dart, Go, Kotlin, Python, TypeScript 구현을 완성형 후보로 보고, 새 언어 확장이나 package 릴리즈보다 안정성 판단과 장기 유지 기준을 먼저 정리한다.

단계

안정화와 유지

상태

완료

범위

• 현재 5개 언어 구현이 프로토콜 0.1 계약을 안정적으로 유지하는지 확인한다.
• 전체 로컬 검증 매트릭스와 proto 동기화 검사를 안정성 판단의 기준으로 둔다.
• README, PROTOCOL, VERSIONING, PORTING_GUIDE의 설명이 현재 운영 방식과 맞는지 점검한다.
• Git 기반 사용을 현재 주 사용 방식으로 보고, package registry 릴리즈는 보류 상태로 유지한다.
• 새 언어 확장은 실제 수요가 생기기 전까지 보류 상태로 유지한다.

필수 기능

• 현재 지원 언어 범위와 비목표를 README 또는 로드맵에 명확히 정리한다.
• 전체 검증 매트릭스를 안정성 확인 기준으로 반복 실행하고 결과를 기록한다.
• PROTOCOL, VERSIONING, README, PORTING_GUIDE 간 설명 충돌이 없는지 점검한다.
• 프로토콜/API 변경 필요 후보를 검토하고, 없으면 현재 계약을 동결 후보로 기록한다.
• 유지보수 모드에서 허용할 작업 범위와 재개 조건을 문서화한다.

완료 기준

• 현재 5개 언어 구현을 당분간 완성형으로 유지할지 판단할 수 있는 근거가 정리되어 있다.
• 전체 검증 매트릭스와 proto 동기화 검사가 안정성 판단 기준으로 문서화되어 있다.
• 새 언어 확장, package 릴리즈, 프로토콜 변경을 언제 재개할지 기준이 명확하다.

범위 제외

• C# 또는 Swift 구현을 시작하지 않는다.
• Package registry 릴리즈 작업을 시작하지 않는다.
• 안정화 판단 없이 프로토콜이나 public API를 변경하지 않는다.
• 상위 ../oto 프로젝트의 CI/CD 실행기를 연결하지 않는다.

작업 컨텍스트

• 관련 경로: README.md, PROTOCOL.md, VERSIONING.md, PORTING_GUIDE.md, agent-roadmap/milestones/continuous-verification.md, agent-ops/skills/project/run-proto-socket-test-matrix/scripts/run_matrix.sh
• 선행 작업: 지속 검증
• 후속 작업: C# Unity/.NET 포트, Swift Apple 플랫폼 포트, 릴리즈 준비
• 검증 근거: 2026-06-18에 bash agent-ops/skills/project/run-proto-socket-test-matrix/scripts/run_matrix.sh --all 통과. Proto 동기화, Dart/Go/Kotlin/Python/TypeScript 동일 언어 테스트, 20개 일반 크로스 언어 방향, Dart.web WS/WSS 5개 방향이 모두 PASS.
• 안정성 근거: 2026-06-18 full stress 기준 same-language, cross-language, TypeScript gateway가 모두 PASS. timeout, nonce mismatch, response type mismatch, FIFO violation, pending leak가 모두 0이다.
• 성능 비교 해석: 2026-06-18 full performance regression 비교에는 baseline 대비 WARN row가 있으나, 이는 local host/runtime 상태와 짧은 request row의 측정 편차에 민감한 성능 참고 경고다. correctness/stability 위반이 아니므로 현재 완료 판단을 차단하지 않는다.
• 문서 정합성: 2026-05-22 기준 README, PROTOCOL, VERSIONING, PORTING_GUIDE의 protocol 0.1, 지원 언어, 새 언어 보류, package registry 보류, validation gate 설명이 충돌하지 않는다.
• 안정화 판단: 최신 전체 매트릭스 PASS, full 안정성 hard gate PASS, 문서 정합성 점검 기준으로 protocol 0.1 및 현재 5개 언어 구현을 완료 상태로 둔다. Coverage 완전성 평가는 라인 수치가 아니라 프로토콜 시나리오 coverage로 판단하며, Dart.web WSS는 테스트용 self-signed certificate SPKI Chrome wrapper를 통해 매트릭스에 포함한다. 다음 언어 확장 수요가 생기기 전까지 protocol/API 변경은 compatibility work로만 다룬다.