proto-socket/agent-ops/rules/project/domain/tools/rules.md
2026-04-12 17:30:20 +09:00

1.2 KiB

tools

목적 / 책임

Proto 생성·동기화 스크립트와 크로스 언어 테스트 인프라를 담당한다. 모든 언어 구현체가 공통으로 사용하는 빌드 도구를 관리한다.

포함 경로

  • tools/ — proto 생성/검증 스크립트
  • */crosstest/ — 각 언어의 크로스 언어 테스트 진입점

제외 경로

  • dart/lib/, go/*.go, kotlin/src/ — 각 언어 구현체 도메인

주요 구성 요소

  • tools/generate_proto.sh — 모든 언어용 proto 바인딩 생성
  • tools/check_proto_sync.sh — 언어 간 proto 스키마 동기화 검증

유지할 패턴

  • proto 변경 후 항상 generate → check_sync 순서로 실행
  • crosstest는 상대 서버가 먼저 시작된 상태에서 클라이언트 측 실행

다른 도메인과의 경계

  • protocol: 스크립트가 proto 파일을 읽지만, proto 파일 자체는 protocol 도메인
  • dart/go/kotlin: crosstest 코드는 각 언어 도메인 경로에 있지만 tools 도메인으로 분류

금지 사항

  • check_proto_sync.sh 실패를 무시하고 다음 단계로 진행하지 않는다
  • crosstest를 단일 언어 unit test로 대체하지 않는다