Cotor logoCotor
docs/PROJECT_ANALYSIS.md

Cotor Project Analysis

open_in_new원문

Cotor Project Analysis

이 문서는 heodongun/cotor 코드베이스를 기준으로 구성 요소와 런타임 흐름을 빠르게 파악하기 위한 분석 요약입니다.

1. 기술 스택

  • Language: Kotlin 2.1.0
  • Runtime: JVM (JDK 17+ 권장)
  • Build: Gradle (build.gradle.kts)
  • CLI: Clikt 기반 명령 체계
  • DI: Koin

2. 소스 구조 개요

src/main/kotlin/com/cotor 주요 패키지:

  • presentation/cli: cotor CLI 명령 진입 및 서브커맨드
  • domain/orchestrator: 파이프라인 실행 오케스트레이션
  • domain/executor: 에이전트 실행 단위 처리
  • validation: 파이프라인/출력/템플릿 정적 검증
  • checkpoint, recovery: 체크포인트 저장 및 재개
  • stats, analysis, monitoring: 실행 통계/분석/모니터링
  • data/plugin, data/registry: 플러그인/에이전트 레지스트리
  • presentation/web, presentation/timeline: 웹 UI 및 타임라인 출력
  • security: 실행 화이트리스트 및 보안 검증

3. CLI 명령 구현 위치

대표 명령 클래스:

  • presentation/cli/Commands.kt
    • CotorCli, InitCommand, RunCommand, StatusCommand, ListCommand, VersionCommand
  • presentation/cli/EnhancedCommands.kt
    • ValidateCommand, TestCommand
  • presentation/cli/DoctorCommand.kt
  • presentation/cli/StatsCommand.kt
  • presentation/cli/TemplateCommand.kt
  • presentation/cli/PluginCommand.kt
  • presentation/cli/AgentCommand.kt
  • presentation/cli/ResumeCommand.kt
  • presentation/cli/WebCommand.kt

4. 실행 플로우

일반적인 실행 경로:

  1. CLI 입력 파싱 (presentation/cli)
  2. 설정 로드 및 병합 (data/config)
  3. 파이프라인/스테이지 검증 (validation)
  4. 오케스트레이터 실행 (domain/orchestrator)
  5. 에이전트별 플러그인 호출 (data/plugin, domain/executor)
  6. 결과 집계/분석 (domain/aggregator, analysis)
  7. 통계/체크포인트 기록 (stats, checkpoint)

5. 운영 관점 체크포인트

  • 실행 전: validate + --dry-run
  • 실행 중: status, run --watch, dash
  • 실행 후: stats, analysis, 결과 포맷(json/csv/text)
  • 장애 복구: resume, checkpoint gc
  • 환경 점검: doctor

6. 문서화 범위

이 docs 사이트에는 다음이 포함됩니다.

  • cotor/docs 하위의 모든 .md/.txt
  • 루트 README.md, README.ko.md
  • 본 분석 문서(PROJECT_ANALYSIS.md)