appsok/agent-roadmap/phase/usable-mvp/milestones/logcat-console.md

Milestone: ADB 콘솔과 logcat

위치

• Roadmap: agent-roadmap/ROADMAP.md
• Phase: agent-roadmap/phase/usable-mvp/PHASE.md

목표

설치 직후 앱 동작을 확인할 수 있도록 logcat stream을 앱 안에서 보여준다. MVP에서는 완전한 interactive shell보다 logcat viewer, 필터, pause/clear, 저장 후보를 우선한다.

상태

[계획]

승격 조건

• 없음

구현 잠금

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

범위

• 선택 device 기준 adb logcat stream
• package/tag/level 필터 UI
• pause, clear, auto-scroll 제어
• 로그 저장 또는 복사 후보

기능

Epic: [logcat] logcat viewer

설치 후 바로 디버깅할 수 있는 기본 로그 화면을 제공한다.

• [stream] 선택 device의 adb logcat stream을 시작하고 화면에 append한다.
• [lifecycle] 화면 이탈 또는 device 변경 시 logcat process를 정리한다. 검증: stream subscription/process cleanup unit 또는 integration test 후보를 마련한다.
• [level-color] info/debug/warn/error를 구분해 읽기 쉽게 표시한다.
• [auto-scroll] 새 로그가 들어올 때 자동 스크롤하되 pause 상태에서는 사용자의 위치를 유지한다.

Epic: [filter] 필터와 작업 도구

반복 디버깅 중 필요한 로그만 빠르게 볼 수 있게 한다.

• [query-filter] package/tag/text query 필터를 제공한다.
• [level-filter] ALL/DEBUG/ERROR 같은 level filter를 제공한다.
• [clear-pause] clear와 pause/resume 버튼을 제공한다.
• [export] 현재 로그를 파일 저장 또는 clipboard 복사할 수 있는 방향을 정리한다.

완료 리뷰

• 상태: 없음
• 요청일: 없음
• 완료 근거: 모든 기능 Task와 Task 안에 명시된 검증 충족 후 기록한다.
• 리뷰 필요:
  • 사용자가 완료 결과를 확인했다
  • archive 이동을 승인했다
• 리뷰 코멘트: 없음

범위 제외

• 완전한 interactive adb shell terminal
• logcat 중앙 업로드
• crash 분석 자동화

작업 컨텍스트

• 관련 경로: lib/src/features/console/, lib/src/services/adb_service.dart
• 표준선(선택): MVP에서는 logcat viewer를 우선하고 interactive shell은 후속 후보로 둔다.
• 선행 작업: USB 설치와 device 선택
• 후속 작업: 설치 세션 이력과 오류 리포트
• 확인 필요: 없음