프로젝트 소개

Web UI Quality (WUQ)는 AI 지원 웹 변경 사항을 위한 검증 레이어의 오픈 소스 프리뷰입니다. 이 도구의 목적은 AI가 생성한 웹 변경 사항을 완료 처리하기 전에 사람이 다음 사항들을 확인할 수 있도록 돕는 것입니다: AI가 변경하도록 허용된 범위, 실제로 변경된 내용, 검증된 사항, 그리고 여전히 알 수 없는 사항입니다. 작동 방식 이 도구는 범위(Scope), 변경(Change), 증거(Evidence), 검증(Verify)이라는 네 가지 질문을 분리하여 관리합니다. 범위는 고려 대상이 되는 프로젝트와 파일을 다루며, 변경은 Host가 실제로 적용한 내용을 다룹니다. 증거는 실행된 테스트, 도구, 브라우저 및 전후 기록을 다루고, 검증은 해당 증거가 요청된 주장에 충분한지를 다룹니다. 소스 변경이 필요한 수정 사항은 VERIFIED로 보고되기 전에 해당 Host의 쓰기 영수증과 현재 검증 증거를 반드시 수신해야 합니다. 프로젝트 측은 의존성을 자동으로 설치하거나, 소스를 업로드하거나, 커밋, 푸시, 배포를 수행하지 않으며, 모델의 제안을 쓰기 권한으로 변환하지 않는다고 명시하고 있습니다. 설치 및 명령어 현재 프리뷰 버전은 PyPI나 npm에 게시되지 않았으므로 소스 체크아웃을 통해 설치해야 합니다. 저장소를 클론하고 pip install -e .를 실행한 후 web-ui-quality doctor를 호출합니다. 안정적인 진입점으로는 --help, run, doctor 및 auth 하위 명령어를 포함한 web-ui-quality가 있습니다. run 명령어는 로컬 웹 프로젝트 경로와 자연어로 설명된 작업을 입력받습니다. README의 예시에서는 로그인 로직 변경은 금지하면서 결제 페이지의 모바일 레이아웃을 확인하도록 요청합니다. 요청된 수정 주장이 검증되지 않았을 때 실패해야 하는 통합 환경을 위해 --ci --require VERIFIED 옵션을 사용할 수 있으며, 이는 Host 승인, 범위 확인, 브라우저 요구 사항 또는 프로젝트 도구 증거를 우회하지 않습니다. 독립적인 공개 체크는 체크아웃 상태에서 python -B run_tests.py로 실행됩니다. 데모 픽스처 저장소에는 경계가 지정된 컴포넌트 수정을 위한 소규모 공개 픽스처인 examples/scope-drift-demo/가 포함되어 있습니다. 요청에서는 하나의 컴포넌트 파일을 지정하지만, 동반 파일은 의도적으로 해당 범위 밖에 둡니다. 일반적인 소스 전용 체크아웃에서 명령어는 실제 이전 상태를 기록하고, 신뢰할 수 있는 Host가 변경 사항을 적용하고 필요한 증거를 반환할 때까지 대기합니다. 만약 Host가 승인된 범위를 벗어나 동반 파일을 수정하면, project-drift 게이트가 결과가 VERIFIED가 되는 것을 방지합니다. README는 이를 모델의 정확도나 프로덕션 동작에 대한 주장이 아닌 경계 시연으로 설명합니다. 상태 및 명시적 제한 사항 현재 공개 릴리스는 Apache-2.0 라이선스의 v4.3.0-oss-preview.1로 식별됩니다. 과거의 v4.3.0 릴리스는 기록 보존용으로 유지된 별도의 MIT 라이선스 소스 스냅샷으로 설명됩니다. 상태 표에 따르면 공개 소스 및 엔지니어링 체크는 PASS, 현재 프리뷰의 라이선스는 Apache-2.0, PyPI/npm은 게시되지 않음, 실제 Host 자격 검증은 NOT_MEASURED, 외부 블라인드 홀드아웃은 NOT_MEASURED, 상용 GA 자격 검증은 NOT_ELIGIBLE로 표시되어 있습니다. 이 프리뷰는 Codex, Claude 또는 기타 Host에 대한 실제 정확도, 실제 사용자 혜택, 프로덕션 호환성, 보편적 접근성, 원격 증명 또는 토큰 절약을 주장하지 않으며, 브라우저나 Host 증거가 누락된 경우 검증되지 않은 상태로 남습니다. 저장소 레이아웃 및 라이선스 경계 런타임과 CLI는 runtime/python/web_ui_quality/ 아래에 있으며, Codex 스킬 지침을 위한 skills/, 공개 JSON 스키마를 위한 schemas/, 로컬 픽스처 및 자격 검증 입력을 위한 examples/, 그리고 깨끗한 체크아웃 상태에서 실행하도록 설계된 테스트를 위한 tests/public/가 있습니다. 게시 경계 문서에는 PUBLICATION.md, DEPENDENCY_LICENSE_REVIEW.md 및 FINAL_PUBLIC_SOURCE_MANIFEST.json이 포함됩니다. 비공개 복구 기록, 채팅 기록, 브라우저 저장소, evolution/, 외부 워크트리, 상용 템플릿 및 상용 데모 자료는 이 공개 코어에서 제외됩니다. 보안 보고서는 공개 이슈가 아닌 GitHub 보안 권고 또는 프로젝트 연락처 주소를 통해 요청되며, 라이선스 경계는 LICENSE, NOTICE.md 및 THIRD_PARTY_NOTICES.md에 설명되어 있습니다.