Ubisam-MobileGit/handoff/2026-09-28_unit-tests-redesign.md

작업: 리디자인 신규 로직 단위 테스트 작성

목표

• 리디자인(TASK-050~054)으로 새로 생긴 순수 로직과 API 클래스에 JUnit4 단위 테스트를 작성하고, 기존 테스트 중 동작 변경으로 깨진 것을 고친다.

배경

• 작업 위치: D:\Android\UBGitea\.claude\worktrees\awesome-pascal-3f2ada (git 워크트리). 이 폴더 안에서만 작업한다. D:\Android\UBGitea 본 폴더는 건드리지 않는다.
• Android 앱(Kotlin, Jetpack Compose). 테스트는 app/src/test/java/com/ubisam/ubgitea/ 아래 JVM 단위 테스트(JUnit4, kotlinx-coroutines-test runTest).
• Gradle 실행 전 반드시: export JAVA_HOME="/d/AndroidStudio/jbr" (Git Bash 기준).
• 테스트 실행 예: ./gradlew testDebugUnitTest --tests "com.ubisam.ubgitea.feature.home.*" --console=plain -q
• 다른 작업자가 같은 폴더에서 화면 파일 4개를 동시에 고치고 있다(아래 "건드리지 말 것"). 컴파일 오류가 그 파일들에서 나면 내 잘못이 아니다. 2분 기다렸다가 다시 실행한다.

결정사항 (변경 금지)

• 메인 소스(app/src/main/)의 동작은 바꾸지 않는다. 테스트가 실패하면 먼저 테스트가 틀렸는지 본다. 메인 코드의 버그라고 판단되면 고치지 말고 보고서에 적는다.
• 테스트 스타일은 기존 파일을 따른다. 참고: app/src/test/java/com/ubisam/ubgitea/data/notifications/GiteaNotificationsApiTest.kt (API 테스트, 파일 안에 private QueueTransport fake 포함), app/src/test/java/com/ubisam/ubgitea/feature/codebrowser/content/SyntaxHighlighterTest.kt.
• 새 의존성 추가 금지. Robolectric, Compose UI 테스트 금지. Composable 함수는 테스트하지 않는다.
• 테스트 이름은 기존처럼 백틱 문장형 또는 camelCase 중 그 파일이 쓰는 방식을 따른다.

수정/생성할 파일

• app/src/test/java/com/ubisam/ubgitea/feature/codebrowser/content/SyntaxHighlighterTest.kt : 수정 (깨진 기대값)
• app/src/test/java/com/ubisam/ubgitea/feature/codebrowser/content/SymbolOutlineTest.kt : 신규
• app/src/test/java/com/ubisam/ubgitea/feature/codebrowser/content/CodeSearchTest.kt : 신규
• app/src/test/java/com/ubisam/ubgitea/feature/home/HomeSummariesTest.kt : 신규
• app/src/test/java/com/ubisam/ubgitea/feature/home/HomeViewModelTest.kt : 신규
• app/src/test/java/com/ubisam/ubgitea/feature/work/WorkViewModelTest.kt : 신규
• app/src/test/java/com/ubisam/ubgitea/data/activity/GiteaActivityApiTest.kt : 신규
• app/src/test/java/com/ubisam/ubgitea/data/workitems/GiteaWorkSearchApiTest.kt : 신규
• app/src/test/java/com/ubisam/ubgitea/domain/history/UnifiedDiffParserTest.kt : 수정 (parseFileEntries 테스트 추가)
• app/src/test/java/com/ubisam/ubgitea/feature/history/FileDiffChangesTest.kt : 신규
• app/src/test/java/com/ubisam/ubgitea/ui/RelativeTimeTest.kt : 신규
• app/src/test/java/com/ubisam/ubgitea/ui/navigation/ 아래 기존 Route 테스트 : 수정 및 추가
• 그 밖에 전체 테스트 실행에서 깨지는 기존 테스트 : 수정

구체 작업

먼저 ./gradlew compileDebugUnitTestKotlin testDebugUnitTest --console=plain -q 를 돌려 현재 깨진 테스트 목록을 확인한다.

1. SyntaxHighlighterTest 수정

   • 대상 코드: app/src/main/java/com/ubisam/ubgitea/feature/codebrowser/content/SyntaxHighlighter.kt 의 tokenizeLines, identifierRole, TokenRole.
   • 바뀐 동작: C#, C++, Java, Kotlin, JavaScript 에서 키워드가 아닌 식별자도 토큰이 된다. 뒤에 ( 가 오면 METHOD (앞 단어가 new 면 TYPE), 대문자로 시작하고 소문자를 포함하면 TYPE (단 . 뒤에 오면 제외), _t 로 끝나면 TYPE, m_ 또는 _ 로 시작하면 색 없음. if/else/return/throw/for/while... 는 CONTROL_KEYWORD. using/import/package/namespace 만 있는 줄의 식별자는 색 없음.
   • 기존 기대값을 위 규칙에 맞게 고치고, 위 규칙 각각에 대한 테스트를 추가한다 (C# 과 C++ 예시 위주).

2. SymbolOutlineTest — 대상: .../content/SymbolOutline.kt 의 extractSymbols, enclosingSymbols, findSymbolNamed, supportsOutline.

   • C# (Allman 중괄호): namespace, class, 필드 3개, 메서드 2개가 있는 파일에서 이름, label(예: NextDelay(int)), kind, depth, line, endLine 확인.
   • C++ 헤더: namespace a::b {, class Foo {, 생성자 선언, 메서드 선언(; 로 끝남), 멤버 변수, public: / private: 라벨이 심볼이 아닌지.
   • C++ 소스: Ret Foo::Bar(int x) const { 형태의 정의에서 name 이 Bar, 생성자 초기화 리스트(: m_x(x) {})가 심볼로 잡히지 않는지, 함수 본문 안의 호출문이 심볼로 잡히지 않는지.
   • 전방 선언 class Foo; 는 목록에 없음.
   • 주석과 문자열 안의 {, } 와 선언처럼 보이는 텍스트가 무시되는지 (여러 줄 /* */ 포함).
   • 매개변수가 여러 줄에 걸치면 label 이 Name(…).
   • Kotlin: class, fun, 식 본문 함수(fun a() = 1) 뒤의 선언도 잡히는지.
   • 지원하지 않는 언어(SyntaxLanguage.PYTHON)는 빈 목록, supportsOutline false.
   • enclosingSymbols: 메서드 본문 중간 줄에서 namespace → class → method 순서로 반환, 필드는 제외.

3. CodeSearchTest — 대상: .../content/CodeSearch.kt 의 findMatches, firstMatchFrom, parseLineNumber, counterpartOf, cppRoleOf.

   • 대소문자 무시, 한 줄에 여러 번, 겹치지 않게 전진, 빈 검색어는 결과 없음.
   • firstMatchFrom: 해당 줄 이후 첫 결과, 없으면 0.
   • parseLineNumber: 범위 밖, 0, 음수, 공백, :12 형태.
   • counterpartOf: 같은 폴더 같은 이름의 .h↔.cpp, 확장자 우선순위(cpp 가 cc 보다 먼저), 다른 폴더의 같은 이름은 제외, C++ 이 아니면 null, 자기 자신은 제외. RepositoryPath.of("src/a/Foo.h") 로 만든다.

4. HomeSummariesTest — 대상: .../feature/home/HomeSummaries.kt 의 activeRepositoriesOf, todayCountsOf (internal). ZoneId.of("Asia/Seoul") 고정.

   • 최신 활동순 정렬, limit, 7일 범위 밖 활동은 막대에 안 들어감, dailyCounts 크기 7 이고 마지막 칸이 오늘, latestRefName 은 ref 가 있는 활동 중 최신.
   • todayCountsOf: PUSH 와 ISSUE_OPENED 만 세고, 어제 것은 제외. 자정 경계(서울 기준)를 확인.

5. GiteaActivityApiTest — 대상: app/src/main/java/com/ubisam/ubgitea/data/activity/GiteaActivityApi.kt.

   • push: op_type":"commit_repo", content 가 {"Commits":[{"Sha1":"abcdef1234","Message":"첫 줄\n둘째 줄"}],"Len":3} 인 JSON 문자열. commits[0].shortId 가 7자, message 는 첫 줄만, commitCount 3, refName 에서 refs/heads/ 제거.
   • 이슈/PR: content":"42|제목" → subjectNumber 42, subjectText "제목". | 가 없으면 number null.
   • content 가 깨진 JSON 이어도 예외 없이 빈 commits.
   • star_repo, watch_repo, mirror_sync_push 는 결과에서 빠짐. 모르는 op_type 은 ActivityKind.OTHER.
   • 페이지 50개 요청에 50개를 받았지만 그중 일부가 star 라서 걸러져도 nextPage 는 2 (받은 개수 기준).
   • created 가 2026-09-28T10:00:00+09:00 (오프셋 형식) 과 ...Z 둘 다 파싱.
   • date 인자가 있으면 쿼리에 date=2026-09-28, 없으면 없음. URL 경로가 /api/v1/users/{login}/activities/feeds, /api/v1/orgs/{org}/activities/feeds.
   • body 가 null 이면 빈 목록. 401 → ApiFailure.AuthenticationExpired, 토큰 공백 → AuthenticationExpired.
   • 응답 JSON 필드: id, op_type, act_user{login,full_name}, repo{name,owner{login}}, ref_name, content, created.

6. GiteaWorkSearchApiTest — 대상: .../data/workitems/GiteaWorkSearchApi.kt.

   • WorkScope 별 쿼리 파라미터: REVIEW_REQUESTED→review_requested=true, ASSIGNED_TO_ME→assigned=true, CREATED_BY_ME→created=true, EVERYONE→셋 다 없음.
   • WorkTypeFilter: ISSUES→type=issues, PULL_REQUESTS→type=pulls, ALL→type 없음. state=open|closed. owner 있으면 포함.
   • 응답 매핑: repository{name, owner} 에서 owner 는 문자열. pull_request 객체가 있으면 isPullRequest, pull_request.merged true 면 isMerged.
   • X-Total-Count 헤더 → Page.totalCount. count() 는 limit=1 로 요청하고 헤더 값을 반환, 헤더 없으면 null.
   • state 가 open/closed 가 아니면 ApiFailure.InvalidResponse.

7. HomeViewModelTest / WorkViewModelTest — 대상: .../feature/home/HomeViewModel.kt, .../feature/work/WorkViewModel.kt. 기존 ViewModel 테스트(app/src/test/java/com/ubisam/ubgitea/feature/notifications/ 등)의 디스패처 설정 방식(Dispatchers.setMain)을 그대로 따른다. Repository 는 테스트 파일 안의 fake 로 만든다.

   • Home: 로드 성공 시 Content, 피드 실패 시 Error 타입 매핑, 조직 목록 실패는 무시되고 Content, 요약 숫자 하나가 실패해도 나머지는 채워짐, selectFilter 가 visibleTimeline 을 거름, loadMore 가 id 중복 없이 뒤에 붙임, open() 을 두 번 불러도 한 번만 로드, close() 후 Idle.
   • Work: open() 은 Idle 일 때만 로드, selectScope/State/Type 은 1페이지부터 다시 로드, 결과 없으면 Empty, 페이지 이동, 오류 매핑.

8. UnifiedDiffParserTest 추가 / FileDiffChangesTest

   • UnifiedDiffParser.parseFileEntries: hunk 마다 맨 앞에 헤더 행(isHunkHeader, hunkLabel 은 두 번째 @@ 뒤 텍스트, 없으면 빈 문자열), @@ -10,3 +12,4 @@ 이면 왼쪽 번호 10부터 오른쪽 12부터, 추가만 있는 행은 leftNumber null.
   • changeStartsOf (.../feature/history/FileDiffScreen.kt, internal): 연속된 변경 묶음의 첫 인덱스만 반환.

9. RelativeTimeTest — 대상: app/src/main/java/com/ubisam/ubgitea/ui/DateTimeFormatting.kt 의 relativeTimeOf. zone 을 Asia/Seoul 로 넘긴다.

   • 1분 미만 JustNow, 59분 Minutes(59), 같은 날 3시간 전 Hours(3), 자정을 넘긴 2시간 전은 Yesterday, 3일 전 Days(3), 7일 이상은 OnDate("yyyy-MM-dd").

10. Route 테스트 — 대상: app/src/main/java/com/ubisam/ubgitea/ui/navigation/RouteStackSaver.kt 의 RouteEncoding.

    • Route.Home, Route.Work 왕복, Route.WorkItems(owner, name, number=42, isPullRequest=true/false) 왕복, number 가 숫자가 아니거나 0 이하면 decodeOrNull null, 빈 스택 복원 기본값이 Route.Home.

11. 마지막에 전체 실행: ./gradlew compileDebugUnitTestKotlin testDebugUnitTest --console=plain -q. 실패 0 이 될 때까지 테스트를 고친다.

건드리지 말 것

• app/src/main/ 아래 모든 파일 (읽기만).
• 특히 다른 작업자가 수정 중인 파일: feature/repositories/RepositoryListScreen.kt, feature/notifications/NotificationsScreen.kt, feature/workitems/WorkItemsScreen.kt, feature/settings/SettingsScreen.kt, res/values/strings_*.xml.
• git commit, push, stash 금지.

완료 기준

• ./gradlew testDebugUnitTest 실패 0.
• 위 1~10 항목마다 테스트가 존재.

보고 형식

• 추가/수정한 테스트 파일 목록과 테스트 개수
• 전체 테스트 실행 결과 (총 개수, 실패 수)
• 메인 코드의 버그로 의심되는 것 (파일, 함수, 재현 입력, 기대와 실제)

막히면

• 추측해서 진행하지 말고 멈춘 뒤, 무엇이 불명확한지 보고할 것