# CodeGraph Phase 2 — AST 스크립트 dispatch.py 통합

## 배경
Agent 미팅(2026-04-16-codegraph-adoption.md) 합의 기반 Phase 2.
Phase 1 결과: 자체 AST 스크립트 승리 (precision 100%, code-review-graph 부적합).
AST 스크립트: `/home/jay/workspace/scripts/ast_dependency_map.py`

## 미팅 합의 Phase 2 범위

### 1. dispatch.py 통합 — affected_files 자동 제안
- dispatch.py에서 task 파일의 변경 대상 파일을 AST 스크립트에 전달
- AST 스크립트가 blast radius(영향받는 파일) 반환
- affected_files 필드에 자동 채우기 (팀장 확인 후 확정)
- `_parse_affected_files()` + `_check_affected_files_overlap()`과 연동

### 2. 테스트 핀포인트 실행 (미팅 합의: 카마소츠)
- blast radius에서 관련 test 파일 자동 추출
- 팀장 봇이 전체 pytest 대신 관련 테스트만 실행
- `pytest -k` 또는 `pytest path/to/test_*.py` 형태

### 3. Gemini 리뷰 컨텍스트 강화 (미팅 합의: 비너스)
- blast radius 정보를 PR description에 포함
- "이 함수는 N개 모듈에서 호출됨" 컨텍스트 → Gemini가 더 신중한 리뷰
- worktree_manager.py PR 생성 시 blast radius 요약 삽입

### 4. Codex G1 자동화 경로 (미팅 합의: 아틀라스)
- 변경 함수의 caller를 AST로 전부 조회
- 인터페이스 변경 여부 자동 감지 (파라미터/반환값 변경)
- codex_gate_check.py 입력에 caller 정보 추가

### 5. TS/React 지원 검증 (미팅 합의: 이쉬첼)
- 현재 AST 스크립트는 Python만 지원
- dashboard/components/*.js 파일에 대해 JS/TS 의존성 추적 가능 여부 평가
- 불가능하면 Python 코드베이스 전용으로 한정 (프론트는 기존 방식 유지)

### 6. 안전장치 (미팅 합의: 마아트/로키)
- 초기 6주 grep 병행 검증 (마아트)
- AST 결과와 grep 결과 비교 → false negative 모니터링
- 외부 도구 대신 자체 스크립트이므로 유지보수 우려 해소 (로키)

## 검증 시나리오 (이게 되면 성공)
1. dispatch 위임 시 affected_files가 자동으로 제안됨
2. blast radius 기반 관련 테스트만 실행 가능
3. PR description에 blast radius 요약 포함
4. codex_gate_check.py에 caller 정보 전달
5. Python 코드베이스에서 precision 90%+ 유지

## 주의사항
- dispatch.py 핵심 인프라 — 회귀 테스트 필수
- ast_dependency_map.py는 이미 존재, 수정/확장만
- 6주 grep 병행 검증 운영 규칙 포함