# deep-research driver

Claude Code 의 deep-research 하네스를 **codex-cli / antigravity-cli** 로 이식한 외부 Python 드라이버.

## 전제
- `codex` 또는 `agy` CLI 설치 + 로그인(구독). 별도 검색 API 키 불필요 — 웹 조사는 각 CLI 네이티브 도구가 수행.

## 동작 방식 (중요)

이 드라이버는 codex/antigravity **안에서 도는 게 아니라 그 CLI 들을 워커로 호출**한다.
당신이 `deep-research` 를 실행하면 → 결정론 제어(dedup·득표 산식)는 이 Python 이 맡고
→ 각 단계의 LLM 작업은 `codex exec` / `agy -p` 를 subprocess 로 ~수십 회 호출해 처리한다.
(Claude Code 의 `/deep-research` 스킬처럼 챗 안에서 트리거하는 구조가 아님.)

## 설치 / 사용

```bash
# 1) 전역 명령으로 설치 (어느 디렉터리에서나 `deep-research`)
pipx install /home/donghyeon/dev/llm-wiki-private/scripts/deep-research
deep-research --backend codex "2026년 한국 전기차 보조금 정책 변화"
deep-research --backend antigravity "..." --json

# 2) pipx 없이: 프로젝트 venv 의 console-script 사용
cd scripts/deep-research && .venv/bin/pip install -e .
.venv/bin/deep-research --backend codex "..."

# 3) 모듈로 직접 실행 (설치 없이)
.venv/bin/python -m deep_research --backend codex "..."
```

## 구조
- `core.py` — 결정론 제어(dedup·예산·3-vote 정족수·랭킹). 원본 JS 와 1:1, 순수함수.
- `backends/` — 플랫폼 어댑터(codex/antigravity/mock).
- 충실도 기준 원본: `deep-research-wf_aecef33f-4cc.js` (spec 참조).

## 테스트

```bash
pip install -e ".[dev]" && pytest
```

MockBackend 로 네트워크 0 상태에서 6페이즈 + 퇴화 경로 3종 검증.