fix(stream-json): AGY headless 권한 오류와 빈 응답 전파

[kunkunGames]

목표

AGY headless 실행에서 도구 권한 거부가 SUCCESS와 빈 응답으로 위장되지 않도록 명시적 오류로 전달하고, 공용 stream-json runner에서 종료 상태와 stderr 존재 여부를 관측 가능하게 한다.

쉬운 설명

Gemini/Antigravity 에이전트가 명령 권한을 받지 못하면 지금까지는 성공한 것처럼 보이는 빈 응답으로 끝났다. 이제 사용자는 실제 권한 거부 원인과 설정 방향을 확인할 수 있다. 보안상 모든 권한을 자동 승인하는 우회 플래그는 추가하지 않았다.

개선되는 것

Fix 1

AGY codec이 result.status=SUCCESS이더라도 응답 텍스트가 없으면 Done을 만들지 않고, 프로세스 stderr 수집 후 명시적 Error를 생성한다.

Fix 2

step_update의 ERROR/FAILED/DENIED 상태와 오류 상세를 보존한다. stderr가 없는 경우에도 마지막 도구 실패를 사용자에게 전달한다.

Fix 3

공용 runner가 종료 코드, stdout 라인 수, stderr 길이·존재 여부를 안전한 메타데이터로 기록한다. stderr 본문이나 프롬프트는 로그에 남기지 않는다.

Before → After

시나리오	Before	After
headless 명령 권한 거부	SUCCESS + 빈 Done → generic empty response	권한 거부 안내가 포함된 Error + provider stderr
stdout step만 ERROR	오류 상세가 유실됨	마지막 step 오류를 보존해 Error로 전달
정상 텍스트 응답	delta/aggregate 처리 유지	기존 동작 유지

사이드 이펙트 시뮬레이션

시나리오	동작	결론
정상 AGY 응답	non-empty text가 있을 때만 Done	정상 경로 유지
provider가 stderr를 출력하며 exit 0	stderr는 사용자 오류 상세로 전달하고 길이만 로그 메타데이터화	진단성 향상, 비밀값 로그 방지
권한 우회가 필요한 작업	--dangerously-skip-permissions는 계속 차단	좁은 permissions.allow 설정을 운영자가 선택

해결한 내용

• src/services/stream_json_cli/codec.rs: AGY terminal state를 보류해 stderr 및 마지막 step 오류를 결합하고 빈 성공 응답을 명시적 오류로 변환했다.
• src/services/stream_json_cli/runner.rs: child exit/stderr 메타데이터를 기록해 성공 종료와 stderr 동시 발생을 관측 가능하게 했다.
• docs/design/stream-json-cli-family-spec.md: non-empty 응답 없는 성공 terminal event의 오류 계약을 명문화했다.

검증

• cargo fmt --all --check
• git diff --check
• cargo test --lib stream_json_cli (16 passed)
• cargo check --all-targets (passed; 기존 unused/dead-code 경고만 존재)

[chatgpt-codex-connector]

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Credits must be used to enable repository wide code reviews.