AI 분석과 승인 기반 수정

읽기 전용 분석

1. 실패 Run을 열고 Analyze Failure를 선택합니다.
2. 전송 대상 Provider와 선택 Context를 확인합니다.
3. 필요한 Source snippet·실패 로그·Run metadata·Evidence만 포함합니다.
4. 마스킹 이후 전송 범위를 명시적으로 승인합니다.
5. Root Cause Candidates와 근거·실제 파일·라인을 검토합니다.

Source Search·File Read·Run/Log/Evidence 읽기는 분석용입니다. 모델이 주장한 원인은 실제 증거와 비교하세요. 부족한 근거에서는 후보 원인으로 해석합니다.

Core는 Codex 기반 ChatGPT 계정 연결과 별도 OpenAI API Provider 경로를 구분합니다. API Provider는 API 계정의 이용 조건을 따르며 구독 로그인과 같은 인증 경로가 아닙니다. 개발 소스에서 계정 연결은 pnpm ai:login을 사용하고 공식 로그인 페이지에서 완료합니다. 실제 사용 가능한 모델·계정 상태는 연결 화면에서 확인하세요.

수정안 적용

1. Fix Proposal의 affected file·변경 이유·suggested tests와 Proposed Diff를 확인합니다.
2. Dirty Editor를 먼저 저장하거나 취소합니다. 현재 사용자 변경을 덮어쓰지 마세요.
3. 정확한 Proposal·파일·변경 범위를 승인하고 Apply를 수행합니다.
4. Changed Files와 Actual Disk/Git Diff를 다시 검토합니다.
5. 승인된 Protocol Task/Test로 Validate 또는 Retest를 실행합니다.
6. 실제 Agent Test 결과를 보고 성공·실패를 판단합니다.

현재 GUI는 선택한 Proposal 파일 중심으로 적용합니다. 서비스의 multi-file 지원을 임의 전체 프로젝트 수정 권한으로 해석하지 마세요. 새 Proposal은 새 승인 대상입니다. 기본 최대3 attempts이며 서비스 경계의 설정 범위가 적용됩니다.

되돌리기와 충돌

Revert AI Changes는 AI 적용 전 baseline으로 복원합니다. 이후 사용자 수정이 있으면 PATCH_CONFLICT로 보호합니다. 강제 overwrite나 Git 전체 reset으로 우회하지 마세요. validation/retest 실패가 사용자 기존 Source를 버리는 이유는 아닙니다.

Snapshot Retest 제한

커밋하지 않은 AI 변경은 Workspace Snapshot으로 Agent에 전달할 수 있습니다. 현재 작은 텍스트 Snapshot은 최대100 파일·24KiB Source content이며 전체 RPC 제한도 있습니다. Secret 파일·dependency·build/cache·binary는 제외합니다. 필요한 변경 파일이 제외되거나 크기를 넘으면 실패하며 자동으로 축약해 전달하지 않습니다. 큰 프로젝트 전체 복사나 Secret injection 기능으로 광고하지 않습니다.

AI에는 unrestricted shell·자동 commit/push·무승인 write 권한이 없습니다. 최종 성공은 실제 Test PASS로 확인합니다. 현재 Attempt/분석 이력은 세션 수명에 묶일 수 있으므로 중요한 결과는 별도로 보관하세요.