가이드

완료된 답변에 필요한 source coverage가 없으면 fail closed합니다.

Source audit는 provider answer text의 inline source coverage를 점검하고, 감독 workflow가 citation을 요구할 때 결과를 막을 수 있습니다.

소스 감사를 포함한 쿼리

agbrowse web-ai query \
  --vendor chatgpt \
  --inline-only \
  --require-source-audit \
  --source-audit-ratio 1 \
  --prompt "Find the latest official installation docs and cite them."

범위 지정 감사

유효한 소스와 시점을 좁힐 수 있습니다. "공식 응답이 없었다" 같은 부재 주장에는 --source-audit-scope와 --source-audit-date를 사용합니다.

agbrowse web-ai query \
  --vendor grok \
  --model expert \
  --inline-only \
  --require-source-audit \
  --source-audit-scope "official product docs and release notes" \
  --source-audit-date "2026-05-05" \
  --prompt "Summarize the latest official product changes with sources."

--source-audit-ratio <0..1>은 부분 sourcing이 의도적일 때만 사용합니다. 기본값은 감지된 모든 claim에 inline source를 요구합니다.

Claim audit

agbrowse web-ai claim-audit는 repository docs에서 금지된 hosted/cloud/stealth claim을 검사합니다. release gate gate:no-cloud-claims와 동일한 claim-audit 모듈을 사용하여, 공개 문서가 코드베이스에서 뒷받침할 수 없는 주장을 하지 않도록 보장합니다.

agbrowse web-ai claim-audit --json

릴리즈 게이트 연동

gate:no-cloud-claims 릴리즈 게이트는 npm run gate:all 실행 시 claim-audit를 자동으로 수행합니다. README, docs, structure 파일에서 금지된 claim이 발견되면 게이트가 실패하여 릴리즈를 차단합니다. 이를 통해 공개 텍스트가 structure/CAPABILITY_TRUTH_TABLE.md의 capability truth table과 일관성을 유지합니다.

npm run gate:no-cloud-claims   # claim gate 단독 실행
npm run gate:all               # claim audit 포함 전체 게이트 실행

라이브 상태 보고

web-ai 서브시스템은 장시간 실행 작업 중 typed standalone live-status report struct를 방출합니다. 이 구조화된 보고서는 provider 상태, 진행 signal, 타이밍 데이터를 담고 있어 하류 도구가 CLI 출력을 스크래핑하지 않고 파싱할 수 있습니다.

릴리즈 게이트 Web-AI 가이드