# task-1941: codex_gate_check.py — Codex CC 플러그인 연동으로 전환

## 배경
codex_gate_check.py가 Codex CC 플러그인(codex-companion.mjs)을 무시하고 raw `codex exec` 직접 호출 중.
플러그인이 설치되어 있으나(v1.0.3) 연동이 안 되어 거의 항상 마아트 폴백으로 빠짐.
시스템3문서(context-notes.md)에 "codex-plugin-cc = CLIRunner subprocess, MCP 통합 미구현"으로 명시된 상태.

## 현재 구현 (문제)
```python
# scripts/codex_gate_check.py 236행
result = subprocess.run(
    ["codex", "exec", prompt],  # ← raw CLI 호출, 플러그인 무시
    capture_output=True, text=True, timeout=120,
)
```

## 수정 방향

### 1. codex-companion.mjs 호출로 전환
- 플러그인 경로: `/home/jay/.claude/plugins/cache/openai-codex/codex/1.0.3/scripts/codex-companion.mjs`
- 호출 방식: `node codex-companion.mjs task "<프롬프트>"`
- 환경변수: `CLAUDE_PLUGIN_ROOT` 설정 필요 여부 확인

### 2. 또는 Codex CLI 올바른 호출 방식 확인
- `codex exec` 대신 `codex` CLI의 올바른 비대화형 모드 확인
- `codex --help` 출력 확인 후 적합한 옵션 사용
- `--quiet`, `--json`, `--model` 등 옵션 확인

### 3. 마아트 폴백 강화
- Codex 실패 시 폴백이 "파일 존재 확인"만 하는 건 너무 약함
- 폴백에 실질적 검증 추가: AST 의존성 분석 결과 활용, 변경 범위 크기 경고 등

### 4. 시스템3문서 업데이트
- `memory/plans/cross-verification-workflow/context-notes.md`에서 Codex 관련 "미구현" → "구현 완료"로 업데이트
- 또는 현실적 한계를 반영한 상태로 수정

## 사전 확인 (작업 시작 전 필수)
```bash
# Codex CLI 사용 가능 옵션 확인
codex --help
# codex-companion.mjs 직접 테스트
node /home/jay/.claude/plugins/cache/openai-codex/codex/1.0.3/scripts/codex-companion.mjs --help
# 현재 codex exec가 실패하는 정확한 에러 확인  
codex exec "hello" 2>&1
```

## 검증 시나리오
1. codex_gate_check.py 실행 → Codex가 실제 응답 반환 (마아트 폴백 아님)
2. Codex 장애 시 → 마아트 폴백으로 정상 전환
3. `python3 -m pytest tests/ -q` → 0 failed

## 레벨
- critical