Repository navigation
v0.51.0 — 독립 평가 결함 수정과 선택형 BizRouter Decisions 어댑터
v0.51.0 — 독립 평가 결함 수정과 선택형 BizRouter Decisions 어댑터
사전 맥락 없는 독립 평가(v0.50.0 기준)가 확인한 Windows MAX_PATH 초과 시 오류·오분류, SessionStart 비밀 마스킹 공백, Antigravity Stop 훅 중복·누락, 신규 /vault-init 관리성 이슈 13건, 시험 격리 결함 4종, README.md 영문 개요 절단·구버전 표기 잔류를 바로잡고, google/gemini-decision-1을 지원하는 선택형 BizRouter Decisions 어댑터와 저확신 에스컬레이션을 더한다. 기준은 공개 v0.50.0 커밋 39e5177de416dd056fad99f77c074415c42f6f89다.
변경
- 선택형 BizRouter Decisions 어댑터와 저확신 에스컬레이션(
bizrouter_client.py,jev_ask.py,vault_judge.py).
기본 공급자(TypeSafe Jevhttps://api.typesafe.ai/v1/systemone,TYPESAFE_API_KEY,jev-1.13.0)는 그대로 유지한다. 명시적으로--provider bizrouter를 주면 고정 주소https://api.bizrouter.ai/v1/decisions(BIZROUTER_API_KEY)로 요청하며 기본 모델은google/gemini-decision-1(typesafe/jev-1.13.0도 선택 가능)이다.google/gemini-decision-1에서는 요청당 최대 1,000개 질문과 2~255개 Choice/Score 단계(요청 상한 256 KiB·응답 상한 512 KiB, 텍스트·JSON 전용)를 지원한다.jev_ask.py run --escalate-bizrouter는 기본 Jev 배치 응답 중 보류(abstained)가 아닌low_confidence·low_decisiveness문항만 추려google/gemini-decision-1로 1회 재평가하며,BIZROUTER_API_KEY가 없거나 추가 호출이 실패해도 Jev 원응답을 보존하고escalation.status: "unavailable"만 남긴다. 비밀 필터(jev_client.SENSITIVE)와vault_judge.py의O_NOFOLLOW·금지 구역·TOCTOU 재확인은 두 공급자에 똑같이 적용된다(Jev 판단 안내). - Windows
MAX_PATH(260자) 초과 경로 지원과path_too_long오류 분리(vault_evidence.py,vault_state.py,vault_runs.py,vault_task_contracts.py,vault_improvements.py,vault_run_costs.py,vault_operations.py,vault_bundle.py,vault_handoff_fold.py,backup_vault.py).
WindowsLongPathsEnabled=0환경에서도 깊은 런타임 락·계약·영수증·백업 스테이징 경로가 동작하도록 시스템 호출 경계에서 확장 경로 접두어(\\?\) 헬퍼(fs_path)를 적용하고, OS 경로 길이 초과 예외(ENAMETOOLONG·WinError 206등)를unsafe_lock이나unsafe_or_invalid_input같은 보안·무결성 위반 코드와 분리해path_too_long으로 보고한다. 작업 트리 경로 판정(vault_worktrees.py)과 인증서가 묶는vault_paths.py는 바꾸지 않는다. SessionStart비밀 마스킹과 AntigravityStop훅 중복·누락 보완(hooks/session_start.py,hooks/antigravity_hook.py,hooks/session_checkpoint.py).
대화형SessionStart(startup·resume·clear·compact)와--host antigravity(injectSteps[].systemMessage)가 읽는 상태 노트 본문에서jev_client._matches_sensitive에 걸리는 자격 증명 줄과 다중 줄 PEM 개인키 블록을 마스킹한다(비밀 패턴이 없는 일반 노트는 기존과 바이트 단위 동일). AntigravityStop훅은 양의 정수executionNum에서 기존 120초 잠금 키를 유지하고,executionNum == 0이면 턴 필드 요약을 잠금 키에 보태 120초 안의 후속 턴 체크포인트가 누락되지 않게 하며,executionNum이 생략되거나 정수가 아니면 원시 이벤트 SHA-256으로 잠금을 걸어 3중 처리기(sh·py -3·python) 중 하나만 기록하게 한다.- 초기
/vault-init청결성, 시험 격리, 엔진 폴더 정리, 볼트 사본 방어, 줄바꿈 통일.
vault_healthcheck.py가 이미 섹션 10(scan_rules_integrity)에서 검사하는rules_dir행동 계약 파일을 고아·인덱스 미등록 집계에서 제외하고assets/templates/index.md에[[lessons]]를 기본 등록해, 정석/vault-init직후(미니볼트 포함·미포함 모두) 첫vault_healthcheck.py실행이issues: 0, critical: 0이 되게 한다. 또한 비볼트(not_vault)·경로 부재(vault_not_found) 조기 종료 시--worktree-heads --json-summary가 검사하지 않은"unreachable_worktree_heads": 0을 내보내지 않게 고친다. 라이브claudeCLI를 호출하는 수동 프로브skills/agentic-vault/scripts/test_rules_inheritance.py는scripts/manual_rules_inheritance_probe.py로 옮겨 엔진·antigravity/패키지에서 제외하고, 볼트00-meta/scripts/로 복사된vault_doctor.py·vault_adapters.py가 플러그인 트리 밖에서 임포트 시 죽지 않도록CLAUDE_PLUGIN_ROOT폴백과 안전 종료 진단(session_hook_not_bundled)을 더한다. 비-TTYstdin파이프 행(test_memory_recovery.py,test_vault_doctor.py), 단독 모듈 임포트(test_run_evaluator_binding.py), 줄바꿈 고정(test_vault_healthcheck.py), 병렬 부하 타임아웃 여유(test_codex_verification.py)를 고치고.gitattributes최상단에* text=auto eol=lf를 두어 Windows 기본 체크아웃에서도 루트와 생성antigravity/텍스트 줄바꿈을 일치시킨다. - 문서·판 표면 복구와 생성 패키지 갱신.
README.md첫 화면에 30초 개요·영문 개요·현재 판 요약을 배치하고 이전 판 이력을 접힘 블록으로 내렸으며, 영문Core commands문단 한복판에 끼어들었던 구버전 이력 194줄을 복구하고 현행 안내문의0.48.0잔류 표기(README.md,docs/antigravity.md:23)를 모두0.51.0으로 바로잡았다..codex-plugin/plugin.jsonlongDescription앞머리에 제품 소개를 보강하고 Antigravity CLI 생성 패키지(antigravity/)를 다시 생성해 일치를 확인했다.
기본 결과 변경
- 판 메타데이터: 매니페스트 버전·설치 태그·healthcheck 스탬프(
engine=0.51.0)와ENGINE_VERSION이0.51.0으로 이동한다. SessionStart주입: 비밀 패턴이 없는 일반 노트의 출력은 바이트 단위로 같으며,jev_client._matches_sensitive또는 PEM 개인키 블록을 포함한 줄만 마스킹 문구로 치환된다.vault_healthcheck.py:rules_dir(기본.claude/rules) 아래 행동 계약 파일이 섹션 6(고아/준고아)·섹션 6c(인덱스 미등록)에서 제외되고(섹션 10 검사는 그대로 유지),not_vault·vault_not_found조기 종료의--worktree-heads --json-summary에서"unreachable_worktree_heads": 0이 빠진다.- Antigravity
Stop체크포인트:executionNum이 생략되거나0으로 유지되는 호스트 이벤트에서도 단일 턴 1회 기록으로 수렴한다. - Windows 긴 경로 오류 코드:
MAX_PATH초과 OS 오류 시unsafe_lock·unsafe_or_invalid_input대신path_too_long을 반환한다. - Jev 판단 도구(
jev_ask.py,vault_judge.py): 새 플래그(--provider bizrouter,--model,--escalate-bizrouter)를 주지 않으면 기본 TypeSafe Jev 동작·출력은 v0.50.0과 같다(--help에 새 옵션이 표시된다).
하위호환·업그레이드
현재 설치 ref는 v0.51.0이다. 기존 볼트 설정 키는 추가하거나 마이그레이션하지 않는다. 공개 준비 자체가 활성 설치나 운영 볼트를 자동으로 갱신하지 않는다. git 무결성 게이트가 있는 볼트에서 helper bundle을 갱신할 때는 bizrouter_client.py를 함께 둔다(bizrouter_client는 지연 임포트되므로 기존 Jev 전용 사본도 깨지지 않는다).
인증서가 묶는 일곱 파일(vault_lint_extensions.py·vault_warning_policy.py·vault_provenance.py·vault_egress.py·vault_ssot.py·jev_client.py·vault_paths.py)은 v0.46.0부터 v0.51.0까지 바이트 단위로 같아, 실제 설치 바이트가 같은 경우 기존 경고 승격 인증서가 그대로 유효하다. v0.45.1 이하와 오갈 때는 v0.46.0 업그레이드 안내를 따른다. healthcheck만 engine=0.51.0으로 이동하며 기존 규칙·어댑터 스탬프는 유지한다. checker_sha256는 09642e7aa77d0b812f5afa646b491fe2d79d44104e399bea4a3001a6f2f1279d 그대로다.
검증
검증 계약에 요구 관문을 적었다. 최종 소스의 시험 수·종료 코드·건너뜀·CI·독립 검토·ZIP 재빌드·설치 자원 바이트·인증서 결과는 릴리스의 verification.json에 기록한다.
새 회귀 시험 모듈은 BizRouter Decisions 어댑터·스케일·저확신 에스컬레이션을 검증하는 tests/test_bizrouter_decisions.py, Windows 285자 이상 깊은 볼트 경로에서 상태·계약·실행·개선·백업을 검증하는 tests/test_windows_long_paths.py, SessionStart 비밀·PEM 마스킹과 Antigravity Stop 중복·누락 방지를 검증하는 tests/test_session_security_and_stop_dedup.py, 정석 /vault-init 직후 issues == 0·조기 종료 요약·엔진 폴더 청결성·볼트 사본 doctor/adapters 안전 동작을 검증하는 tests/test_vault_init_cleanliness.py, 그리고 현행 문서의 구버전 표기 부재와 영문 개요 무결성을 고정하는 tests/test_release_metadata.py의 V0510ReleaseMetadataTests다.
연구 출처와 기존 기능의 차이
| 출처 | 준 것 | 이번 적용 |
|---|---|---|
| BizRouter Decisions API 문서 | POST https://api.bizrouter.ai/v1/decisions에서 noul·choice·score 세 유형으로 google/gemini-decision-1·typesafe/jev-1.13.0을 호출하는 정형 판단 계약 |
기존 TypeSafe Jev(jev_client.py)를 대체하지 않고 bizrouter_client.py 선택형 어댑터(--provider bizrouter) 및 저확신 문항 재평가(--escalate-bizrouter)로 추가했다. 동일 비밀 필터(jev_client.SENSITIVE)와 파일 근거 바인딩(vault_judge.py)을 그대로 재사용한다 |
| Google Gemini Decision 1 공개 벤치마크 색인 | 정형 판단 지수(Decision Index v2.1)와 모델별 보정·불변성 특성 공개 지표 | 참고 맥락으로만 확인했으며 외부 벤치마크 수치를 이 플러그인의 자체 성능으로 주장하지 않는다 |
알려진 경계
- BizRouter Decisions(
https://api.bizrouter.ai/v1/decisions)는 텍스트·JSON 입력만 지원하며 이미지·첨부 파일 입력은 거부한다(HTTP 400). 기본 공급자는 계속 TypeSafe Jev이며, 두 공급자 모두 명시적--allow-network와 환경변수 키(TYPESAFE_API_KEY또는BIZROUTER_API_KEY) 없이는 네트워크를 호출하지 않는다. SessionStart비밀 마스킹은jev_client._matches_sensitive패턴과 PEM 개인키 블록 기반이므로 알려지지 않은 임의 형식·인코딩된 비밀까지 모두 찾아내지는 못한다(보안 정책).- Windows 긴 경로 헬퍼(
fs_path)는 Python 표준 라이브러리 파일 입출력 경계를 처리하며, 외부 셸 도구·서드파티 프로그램 자체의MAX_PATH한계까지 바꾸지는 않는다. - 생성 Antigravity CLI 패키지의 사본 일치와
agy plugin validate --strict는 검사하지만 소비자 계정 약관 경계에 따라 에이전트가 실제agy대화 세션을 감싸 실행하지는 않는다.