proto-socket/agent-ops/rules/project/domain/kotlin/rules.md

kotlin

목적 / 책임

Toki Socket의 Kotlin/Android 구현체를 담당한다. Android 및 JVM 환경을 대상으로 하며, 현재 구현 진행 중이다.

포함 경로

• kotlin/src/ — 구현 소스
• kotlin/crosstest/ — 크로스 언어 테스트 (Dart, Go와 연동). 오케스트레이터 또는 클라이언트 헬퍼
• kotlin/build.gradle.kts, kotlin/settings.gradle.kts — Gradle 빌드 설정

제외 경로

• kotlin/src/**/packets/ — protocol 도메인

주요 구성 요소

• (구현 진행 중 — Dart/Go 구조 참고)

유지할 패턴

• ./gradlew test로 테스트 실행
• ./gradlew run -PmainClass=...으로 crosstest 실행
• Available 표시 조건: 동일 언어 테스트 + 크로스 언어 테스트 통과

다른 도메인과의 경계

• protocol: proto 타입을 사용하지만, 스키마 정의는 protocol 도메인
• dart/go: crosstest에서 상호 연동

금지 사항

• Kotlin proto 복사본에서 메시지 스키마를 변경하지 않는다
• 아직 Available이 아니므로 README의 구현 상태를 임의로 변경하지 않는다