Repository navigation
Releases
v0.53.0 — 한국어 절차 검색과 세션 인계 실험
v0.53.0 — 한국어 절차 검색과 세션 인계 실험
기본 결과 변경
한국어로 두 작업의 순서를 명시한 질의에서 어휘 점수가 같은 후보의 순위가 달라질 수 있다. 예를 들어 ‘검수 다음 출고’는 ‘검수 후 출고’를, ‘출고 다음 검수’는 그 반대를 우선한다. 지원하는 표현·적용 채널과 한계는 검색 예제에 있다. 이 변경은 일반 한국어 의미 이해를 제공하지 않는다. 권한, 읽기 범위, 기본 검색 모드, 네트워크 정책은 바뀌지 않는다.
처음 써 보기
첫 인계 따라 하기는 소스 체크아웃에서 임시 예제 볼트로 시작한다. 결정·다음 행동·근거 줄을 다른 프로세스에서 찾아본다. 테스트가 안내서에서 명령을 읽어 그대로 실행한다. 10분은 학습 목표이고 신규 사용자 실측 시간이 아니다.
인계 재개 비교는 같은 작업을 이어 한 경우와 다른 업무를 거쳐 재개한 경우의 최종 파일을 같은 기준으로 채점한다. 올바른 인계·잘못된 업무·오래된 입력을 구별한다. 기본 실험은 별도 Python 프로세스를 사용하는 고정 시나리오다. 실제 참여자의 결과를 채점하는 방법도 제공하며 기본 실행이 사람이나 모델의 성능을 뜻하지 않는다.
참고한 연구와 오픈소스
- PAWS-X 논문 및 저자 자료: 단어가 겹치지만 의미가 다른 대조쌍 설계에서 착안했다. 한국어 검색 사례는 새로 작성했으며 원 데이터셋의 점수를 재현한 것이 아니다.
- Switch-SWE 논문 및 저자 구현: 업무 전환 유무를 같은 결과 기준으로 비교하는 방법을 차용했다. 원 벤치마크를 실행한 것이 아니다.
- Sybil: 게시된 Markdown 예제를 시험 입력으로 쓰는 방식을 참조했다. Sybil 설치는 필요하지 않다.
하위호환·검증
소스 태그는 v0.53.0이다. 새 런타임 의존성이나 볼트 데이터 변환은 없다. healthcheck 버전 스탬프가 바뀌며 기존 설치와 볼트를 게시 과정에서 자동 변경하지 않는다. 기존 스탬프 사본 갱신은 설치 호스트에서 별도로 진행한다. 검증 범위와 GitHub Release의 verification.json에서 소스 및 실행 기록을 확인할 수 있다.
선택형 Windows 시험
임시 폴더 경로가 150자이고 Hypothesis를 설치한 경우, 기존 상태 검사 도우미가 긴 영수증 파일 경로를 여는 과정에서 오류가 재현됩니다. v0.52.1과 이번 버전에서 같은 오류를 확인했습니다. 짧은 임시 경로에서는 해당 상태 검사 11개가 모두 통과했습니다. 자세한 실행 조건은 첨부된 verification.json에 있습니다.
v0.52.1 — 같은 번호 보고, 가짜 머리글 줄 무력화, 판단 올리기 원답 보존
v0.52.1 — 같은 번호 보고, 가짜 머리글 줄 무력화, 판단 올리기 원답 보존
개선 조사가 먼저 볼 항목으로 고른 세 가지를 구현하고 저장소 설정 둘을 켠다. healthcheck는 한 노트에서 같은 번호를 단 결정·실수 제목을 보고만 하고, SessionStart는 훅 자신의 섹션 머리글처럼 시작하는 노트 줄을 무력화하며, jev_ask.py --escalate-bizrouter는 BizRouter 답 옆에 원래 Jev 답을 남기고 두 답이 다르면 검토를 요구한다. BizRouter 경로의 모델은 google/gemini-decision-1 하나로 줄인다. 저장소에는 v* 태그 규칙 집합(ruleset)과 비공개 취약점 제보를 켰다. 이 변경은 공개하지 않은 v0.52.0 후보에 처음 들어갔으며(저장소 설정 둘도 그때인 2026-11-16에 켰다), v0.52.1은 그 변경을 모두 담아 처음 공개하고 후보의 긴 Windows TEMP 경로 시험을 고친다. 기준은 공개 v0.51.0 커밋 22168b7ddd10796e8ad0a894fe2c79a704bd7da2다.
v0.52.0 후보에서 고친 긴 TEMP 경로 시험
v0.52.0 후보의 독립 릴리스 검토는 검증 계약 1번 관문이 요구한 긴 Windows TEMP 경로 실행이 실제로는 기본 TEMP에서 돌았음을 찾아냈다. 그 실행은 TEMP·TMP를 Windows의 일반 경로 한계(260자)보다 긴 폴더로 잡았다. LongPathsEnabled가 0이면 Python tempfile은 그런 폴더에 파일을 만들지 못하고, 쓸 수 없는 TEMP 폴더를 오류 없이 건너뛰어 기본 임시 폴더를 쓴다. 그래서 그 실행은 보통의 기본 TEMP 실행과 같았다.
tempfile이 실제로 쓰는 150자 TEMP 폴더에서 전체 시험을 돌리자 v0.51.0과 v0.52.0에서 같은 131개 항목이 실패했다(시험 130개와, 시험 20개를 가진 시험 클래스 하나의 준비 단계. 26개 모듈, 두 판의 실패 목록이 같다). 기본 TEMP에서는 v0.52.0의 시험 4,518개가 실패 없이 끝난다(건너뜀 57개). 그러니 v0.52.0에서 생긴 회귀가 아니라 v0.51.0에도 있던 문제다. 131개 가운데 3개는 TEMP와 무관했다(아래 어댑터 시험 항목).
v0.52.1은 실패가 난 자리를 고친다.
- 저장소 도구 셋(
scripts/verify_codex_plugin.py·scripts/verify_antigravity_plugin.py·scripts/build_antigravity_package.py)은 임시 작업 폴더가 그 아래에 만들 경로까지 더해 240자 기준에 닿을 때만 그 폴더를 Windows 확장 길이 형식(\\?\)으로 쓰고 같은 형식으로 지운다(패키지 생성기는 저장소·출력·비교할 패키지 폴더와 원본 폴더 밖의 링크 대상에도, Antigravity 검증기는 복사할 패키지 폴더에도 같은 기준을 쓴다). 240자는 일반 경로 한계(260자) 아래에 여유를 둔 기준으로,vault_evidence.fs_path와 같다. 메시지와 보고서에는 일반 형식의 경로를 쓰고(codex의 명령 줄이나 오류 출력을 그대로 옮긴 부분은 빼고), git에는 늘 일반 형식의 폴더를 넘긴다. 세 도구는 같은 도우미 블록의 사본을 하나씩 갖고,tests/test_long_path_helper_copies.py가 사본이 바이트 단위로 같은지 확인한다. - 런타임 모듈
vault_lesson_metrics.py는 관찰 기록 저장소의 파일 접근(상태 확인·목록·폴더 생성·잠금·임시 파일·링크·정리)을vault_evidence.fs_path로 한다. 이 모듈은 v0.51.0이 긴 경로 도우미로 옮긴 모듈에 들어 있지 않았다. 관찰 기록은 볼트 루트에서 102자 아래에 놓이므로, 루트가 158자 이상이면 관찰 기록(record)이invalid_or_unavailable_input으로 실패했다. 경로 검사도 맞췄다. 인증서가 묶는resolve_note_path는 경로의 각 구성 요소를 일반 형식의lstat으로 보아 링크와 재분석 지점(정션 포함)을 거부하는데, 일반 경로 한계를 넘는 구성 요소는 그렇게 볼 수 없어 없는 것으로 지나간다. 그래서 이 저장소는 240자 기준에 닿는 경로를 볼트의 확장 길이 형식에서 시작해 검사하고, 그보다 짧은 경로는 전처럼 검사한다.tests/test_windows_long_paths.py의LessonMetricsLongPathTests는 어떤 TEMP에서도 172자 이상의 볼트를 만들어 기록과 요약을 확인하고, 확장 길이 형식으로 적은 볼트에서도 기록이 남김없이 끝나는지와, 일반 경로 한계를 넘는 기록 폴더에 놓인 정션을 짧은 경로에서처럼unsafe_path로 거부하는지(Windows)를 확인한다. 오류 코드는 바꾸지 않았다. - 평가 스크립트 넷(
scripts/evaluate_task_workflows.py·scripts/evaluate_improvement_experiments.py·scripts/evaluate_improvement_accounting.py·scripts/evaluate_memory_reliability.py)은 임시 폴더에 그 아래를 위해 잡아 둔 영수증 경로의 길이를 더한 값이 240자 기준에 닿으면 임시 볼트를 확장 길이 형식의 폴더에 만들어 같은 형식으로 지운다. 런타임 모듈에는 볼트를 일반 형식으로 넘긴다. 전에는evaluate_task_workflows.py와evaluate_memory_reliability.py가 모든 확인이 통과한 뒤 임시 폴더를 지우지 못해 종료 코드 1로 끝났고, 두 개선 예제는 저장한 기록을 일반 경로로 확인하다 "native completion must be persisted"로 먼저 실패했다.evaluate_memory_reliability.py는 앞뒤 비교에서 한계를 넘는 기록 둘을 조용히 빠뜨리던 것도fs_path로 읽고,evaluate_improvement_experiments.py는 저장한 기록의 확인 둘을fs_path로 한다. - 시험 fixture는
tests/_winfs.py의extended·plain·deep_path로 한계를 넘는 경로를 만들고 읽고 지운다. 같은 파일의make_junction은 링크 경로가 240자 기준에 닿으면 확장 길이 형식으로 링크를 만든다. 전에는 긴 TEMP에서 정션을 만들지 못해 그것이 필요한 시험이 건너뛰어졌다(150자 측정에서 1개). 교훈 단서 훅의 프로세스 시험은 훅이 세션 표지를 둘 수 있는지 훅 자신의 함수로 물어, 둘 수 있으면 guard 왕복을, 없으면 문서에 적은 hint 전달을 확인한다.SessionStart의 긴 출처 이름 사례는 Windows에서 이름 길이를 폴더가 남기는 여유에 맞춘다(보통의 TEMP에서는 그대로 95자). - 시험 패키지(
tests/__init__.py)에는 한계를 넘는 항목이 있어도tempfile.TemporaryDirectory가 임시 폴더를 지우게 하는 정리 보강이 있다. 전체 실행(python -m unittest discover -s tests)은 시험 모듈을 최상위 모듈로 읽어 이 패키지를 불러오지 않으므로, 지금까지 이 보강은 앞선 모듈이 패키지를 불러온 경우에만 켜졌다. 이제 이름순으로 맨 먼저 도는tests/test_000_environment.py가 패키지를 불러와 전체 실행에서 늘 켜지고, 확장 길이 형식으로 다시 지울 때도tempfile의 원래 정리 함수를 써서 읽기 전용 항목 처리를 유지한다. 모듈 하나만 discover 형식(-p "test_x.py")으로 돌리면, 그 모듈이tests패키지를 불러오지 않는 한 지금도 켜지지 않는다(정리 보강은 Windows에서만 쓴다). tests/test_vault_adapters.py의 실행 경로 시험 3개는 데스크톱 브라우저가 떠 있는지를 모듈을 읽을 때가 아니라 시험을 시작할 때 본다. 전체 실행은 첫 시험보다 훨씬 앞서 모든 모듈을 읽으므로, 그 사이에 브라우저가 켜지면 건너뛰어야 할 시험이 실패했다. 위 131개 가운데 3개가 이 경우였다.- 저장소 도구 셋·평가 스크립트 넷·
vault_lesson_metrics.py는 일반 형식으로 적은 경로를, 그 경로에 그 아래를 위해 잡아 둔 길이를 더한 값이 240자 기준에 닿을 때만(Windows) 확장 길이 형식으로 다룬다. 잡아 둔 길이는 실제로 만들거나 읽는 가장 깊은 경로보다 길 수 있다. 개선 회계 예제는 개선 실험 예제만 쓰는 영수증의 길이를 잡고, 패키지 생성기는 열지 않는 파일까지 포함해 원본 폴더 아래의 가장 긴 경로를 센다. 그보다 짧은 경로에서도 달라진 점이 있다. 짧은 경로를 처음부터 확장 길이 형식으로 적으면 일반 형식으로 다루는 곳이 있다. 패키지 생성기는 그런 인자를 일반 형식으로 보여 주고 비교하며(v0.52.0은 적은 그대로 보여 주고 그런 경로의 git 모드 비교를 건너뛰었다), Antigravity 검증기는 그런--package·--agy인자를 오류 메시지에 일반 형식으로 적는다. TEMP를 그 형식으로 적으면 두 검증기는codex·agy에 넘기려고 만드는 경로와 그 폴더를 가리키는 메시지를, 평가 스크립트 넷은 런타임 모듈에 넘기는 볼트를 일반 형식으로 쓴다(v0.52.0은 적힌 형식 그대로 썼다). 또 Antigravity 검증기의 실패 문구는agy오류 출력이 작업 폴더를 확장 길이 형식으로 적은 자리도<temp>로 바꾼다(작업 폴더가 일반 형식일 때 v0.52.0은\\?\<temp>로 남겼다).
같은 실행을 다시 할 수 있게 scripts/long_temp_suite.py를 더했다.
python -B scripts/long_temp_suite.py [--length N] [--parent DIR] [--keep] [--summary OUT] [-- ARG ...]
이 도구는 경로 길이가 정확히 N자(기본 150)인 폴더를 --parent(기본은 현재 tempfile.gettempdir()) 아래에 만들어 TEMP·TMP·TMPDIR로 잡고, AGENTIC_VAULT_REQUIRE_LONG_TEMP=N을 준 채 저장소 루트에서 python -m unittest를 실행한다(-- 뒤 인자가 없으면 discover -s tests). 시험을 시작하기 전에 자식 프로세스에서 tempfile.gettempdir()이 그 폴더인지 확인하고, 아니면 아무것도 실행하지 않고 종료 코드 3으로 끝난다. 그 밖에는 시험 실행의 종료 코드로 끝난다. Windows 상태 코드(예: Ctrl+C 뒤의 0xC000013A)도 그대로 넘긴다. 사용법 오류(예: 상위 폴더에서 만들 수 없는 길이)는 2이고, 시험이 통과한 뒤 --summary 파일을 쓸 수 없을 때도 2다(시험이 실패했으면 시험의 종료 코드). 폴더를 만든 실행은 끝난 뒤 폴더를 지우고(--keep이면 남긴다), 시험이 Ctrl+C로 멈춘 경우까지 표준 오류의 마지막 줄에 temp_length·tempfile_uses_temp·long_paths_enabled·returncode·python·platform 키를 담은 한 줄 JSON 요약을 쓴다(--summary OUT이면 파일에도 쓴다). tempfile 확인이나 폴더를 지우는 중에 Ctrl+C를 누르면 요약 없이 끝난다. 사용법 오류에서는 요약을 쓰지 않고, 이미 있던 --summary 파일은 그대로 둔다(없던 파일은 빈 파일로 생길 수 있다).
전체 시험 안에서는 tests/test_000_environment.py의 DeclaredLongTempTests.test_tempfile_uses_the_declared_long_temp가 같은 조건을 지킨다. AGENTIC_VAULT_REQUIRE_LONG_TEMP가 있으면 tempfile.gettempdir()이 TMPDIR·TEMP·TMP 가운데 처음 설정된 변수(tempfile이 읽는 순서)가 가리키는 폴더이고 그 길이가 선언한 값 이상이어야 통과하며, 없으면 임시 폴더를 쓸 수 있는지만 확인한다. 이 시험은 건너뛰지 않는다. tests/test_long_temp_suite.py는 scripts/long_temp_suite.py의 시험이다.
v0.52.0 태그는 다시 쓰지 않았고 그 태그에는 GitHub 릴리스가 없다.
변경
- 같은 번호의 결정·실수 항목 보고(healthcheck 섹션 14d, 관리성, 보고 전용,
vault_healthcheck.py).
전체 검사는 다른 노트 섹션과 같은 노트 범위(금지 구역·제외 경로 적용)에서 2단계 제목(##다음에 공백이나 탭) 가운데 글이ADR-<숫자>나M-<숫자>로 시작하는 것을 찾는다. 프런트매터·펜스 코드 블록·HTML 주석 안의 줄은 세지 않는다. 번호는 숫자가 아닌 첫 글자에서 끝나고 앞의 0은 번호에 넣지 않으므로ADR-12와ADR-120은 다른 번호이고,ADR-007과ADR-7a는ADR-7과 같은 번호다. 한 노트에서 같은 종류·같은 번호의 제목이 둘 이상이면 발견 한 건이며, 발견이 있을 때만 섹션 14c 자리 뒤·섹션 15 앞에## 14d. 같은 번호의 결정·실수 항목 — 관리성 (N)을 쓴다. 줄마다 노트의 볼트 기준 POSIX 경로, 번호와 개수, 행 번호(편집기처럼 LF 줄 바꿈으로 센다)를 적는다. 볼트가 git 저장소이고 노트가 추적되면HEAD의 노트를 같은 규칙으로 읽어 그 번호의 2단계 제목 수와 제목 줄을 본다.HEAD에도 있는 제목 줄이 노트에 더 많으면 어느 줄이 커밋된 것인지 가를 수 없다. 그렇지 않고 노트에 그 번호의 제목이HEAD보다 많지 않으면 새 항목은 없으므로, 제목 줄이 모두HEAD에 있으면 둘 다(셋 이상이면 모두) 두고 참조에 제목을 함께 적으라고 안내하고(제목을 바꾸면 앵커가 깨진다),HEAD와 다른 줄이 있으면 커밋된 항목의 제목을 고친 것이므로— HEAD와 제목이 다른 줄(<행 번호>행)은 커밋된 항목을 고친 것이다. 번호를 바꾸지 않는다.를 쓴다. 노트의 제목이 k개 더 많고HEAD에 없는 줄이 정확히 k개이면 그 행만 커밋 안 된 제목으로 적고 그쪽 번호를 바꾸라고 안내하며,HEAD에 그 번호의 제목이 하나도 없으면— 모두 커밋 안 됐다(<행 번호>행). 하나만 두고 나머지 번호를 바꾼다.를 쓴다. 가를 수 없는 경우와 그 밖의 경우, git이 없거나 실패하거나 노트가 추적되지 않을 때는— 커밋 여부를 확인하지 못했다. 번호를 바꾸기 전에 참조를 확인한다.를 쓰며 예외를 내지 않는다. 제목을 자동으로 고치거나 번호를 다시 매기지 않는다./vault-lint명령 안내(commands/vault-lint.md)에는 14d가 나오면 번호와 제목을 자동으로 바꾸지 말고 줄 끝 안내대로 제안하라는 줄을 더했다. N은 관리성 합계에 더해지고, N이 1 이상일 때만--json-summary에"duplicate_entry_ids": N이 생긴다. 종료 코드·--staged·경고 정책·인증서는 바뀌지 않으며 이 섹션은 경고 정책으로 승격할 수 없다. 여러 세션이 함께 쓰는 볼트에서 같은 결정 번호를 단 항목 둘이 모두 커밋된 일이 계기다. SessionStart의 가짜 머리글 줄 무력화(hooks/session_start.py).
노트 줄이 앞의 공백 문자(str.isspace()가 참인 유니코드 공백: 공백·탭·줄 바꿈 없는 공백·전각 공백 등)와 폭 없는 문자(U+200B~U+200D·U+2060·U+FEFF)를 건너뛴 뒤 훅 자신의 섹션 머리글(=== SESSION HANDOFF,=== HOT CONTEXT,=== FIXED CONSTRAINTS, 훅의 머리글 상수에서 만든다)로 시작하면 그 줄 앞에NEUTRALIZED_PREFIX인[note line, not a hook header]를 붙이고 줄 끝은 그대로 둔다. 그런 줄이 없는 글은 그대로 돌려주며, 두 번 적용해도 결과가 같다. 비밀 마스킹 바로 뒤(_neutralize_header_lines(_redact_sensitive_lines(text)))에서 두 호출 지점(compact의 추가 노트와 주요 노트 섹션)에 모두 적용하므로 compact 고정 제약 발췌도 무력화한 글에서 만든다. 대화형 이벤트(startup·resume·clear·compact)와--host antigravity주입이 같은 처리를 받고,vault_doctor의 주입 추정도 같은 무력화를 적용한다. 그 줄이 훅의 섹션 머리글로 읽히지 않게 하는 위생 처리이며 프롬프트 주입 방어가 아니다(보안 정책). 전각 문자나 다른 철자로 쓴 머리글처럼 머리글을 닮기만 한 다른 줄은 그대로 지나간다.- 판단 올리기의 Jev 원답 보존과 BizRouter 모델 축소(
jev_ask.py,bizrouter_client.py).
jev_ask.py run --escalate-bizrouter가 저확신 문항을 BizRoutergoogle/gemini-decision-1로 다시 물어 적용하면(escalation.status: "applied"), 그 문항의 결과는 지금처럼 BizRouter 답과"escalated_from"(Jev 모델)을 담고, 새로"primary"(올리기가 없었으면 나왔을 검증된 Jev 답,id를 뺀 같은 키와 값)와"agreement"(참·거짓)를 더한다. 일치는 Choice는 같은 선택지, Noul은 두 확률이 0.5의 같은 쪽(어느 한쪽이라도 정확히 0.5이면 불일치), Score는 같은 단계 척도에서 두score값의 차가 1 이하일 때다. 검토 사유는 지금처럼 올린 답으로_review_reasons를 다시 계산한 뒤, 일치하지 않는 문항마다 질문 순서대로{"id": <id>, "reason": "provider_disagreement"}를 덧붙인다. 일치해도 사유를 지우지 않는다.escalation객체에는"disagreed_ids"(올린 순서, 비어 있을 수 있다)가 생긴다.bizrouter_client.MODELS는google/gemini-decision-1하나만 남기고(model_limits도 그 모델만 안다), 모듈 설명에 TypeSafe Jev 모델은 이 클라이언트로 부를 수 없다고 적는다. 그래서jev_ask.py·vault_judge.py에서--provider bizrouter와--model typesafe/jev-1.13.0(또는typesafe/jev-latest)를 함께 주면 기존 모델 검사가 지금과 같은 오류 코드invalid_arguments와 종료 코드 2로 거부한다. TypeSafe Jev는 직접 TypeSafe API(https://api.typesafe.ai/v1/systemone,TYPESAFE_API_KEY)로만,google/gemini-decision-1은 BizRouter(BIZROUTER_API_KEY)로만 부르며, 어느 경로도typesafe/jev-*모델 이름을 BizRouter로 보내지 않는다. 일치는 정보이지 통과가 아니다(Jev 판단 안내). - 저장소 설정(유지관리자가 적용, 코드 변경 없음).
태그 규칙 집합을refs/tags/v*에 걸어 갱신과 삭제를 막았다. 생성은 막지 않고 우회 주체(bypass actor)는 없다. 비공개 취약점 제보도 켰다. 둘 ...
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대화 세션을 감싸 실행하지는 않는다.
v0.50.0 — 낡은 PR CI 실행 취소와 연결 작업 트리 HEAD 확인
v0.50.0 — 낡은 PR CI 실행 취소와 연결 작업 트리 HEAD 확인
저장소 CI가 같은 풀 리퀘스트의 이전 실행만 취소하도록 하고, healthcheck에 어느 분기·태그에도 담기지 않은
HEAD를 가진 연결 작업 트리를 알리는 선택형 확인과 그 작업을 master에 반영하는 안내를 더한다.
기준은 공개 v0.49.0 커밋 1fc8269039c06ecadb2852e2addbadfb0a40e15b다.
변경
- 낡은 풀 리퀘스트 CI 실행 취소(저장소 CI).
.github/workflows/tests.yml의permissions:와jobs:사이에
워크플로 수준concurrency블록을 둔다. 묶음 이름은pull_request사건이면tests-pr-뒤에 풀 리퀘스트 번호,
그 밖의 사건이면tests-run-뒤에 실행 번호(run_id)를 붙인 것이고,cancel-in-progress는pull_request사건에서만 참이다. 같은 풀
리퀘스트에 새 커밋이 오면 그 풀 리퀘스트의 이전 실행만 취소된다. master·태그·후보 분기 push와 수동
실행(workflow_dispatch)은 실행마다 묶음이 따로라 취소되거나 다른 실행 뒤에 줄 서지 않는다. 릴리스 관문으로
쓰는 실행이 이 push 실행들이다.on:의 사건(push·pull_request·workflow_dispatch)과 작업 정의는 그대로이고,
경로 거름·분기 거름·작업 수준concurrency는 넣지 않는다. 시험(tests/test_supply_chain.py)이 블록이 정확히
한 번 있고 두 줄이 위와 같은지, 작업 수준concurrency가 없는지,on:에paths·paths-ignore·branches·tags
거름이 없는지 고정한다. 결정과 근거가 된 중복 실행 측정은 릴리스 무결성의
2026-11-15 항목에 적었다. - 연결 작업 트리 HEAD 확인(선택형, 읽기 전용).
vault_healthcheck.py --worktree-heads는 전체 검사에서만 동작한다.
볼트 저장소에서git worktree list --porcelain으로 등록된 작업 트리를 읽고, bare 항목과 분기에 걸린 작업 트리는
건너뛴다. 분기에 걸리지 않은(detached) HEAD마다 그 커밋을--contains로 넘긴
git for-each-ref --count=1 ... refs/heads refs/tags로 그 커밋을 담은 분기·태그가 있는지 보고, 없으면 새 섹션
## 14c. 분기·태그 밖 HEAD를 가진 연결 작업 트리 — 관리성 (N)(섹션 14b 바로 뒤)에 한 줄씩 적는다. 줄에는 경로(볼트
안이면 볼트 기준 POSIX 상대 경로, 밖이면 슬래시로 쓴 절대 경로, 볼트 자신의 작업 트리는.. 볼트가 저장소
루트이면 본 작업 트리가.이고, 볼트 밖에 있는 본 작업 트리는 절대 경로로 쓴다)와 HEAD 앞 12자를 쓰고, 작업
트리를 지우기 전에git branch로 그 커밋에 분기 이름을 붙여 고정하라고 안내한다. prunable 표시가 붙은 항목도 알린다. git이
실패하면(저장소 없음·명령 오류·시간 초과)- (확인 실패)로 시작하는 짧은 이유 한 줄을 쓰고 N에 세지 않으며 예외를 내지
않는다. 플래그를 주면 N이 관리성 합계에 더해지고--json-summary에"unreachable_worktree_heads": N이 생긴다.
종료 코드는 바뀌지 않는다.--staged와 함께 주면 인자 오류(종료 코드 2)다. 새 코드는vault_healthcheck.py의
# --- BEGIN SHARED WORKTREE RULE블록 밖에 있고, 그 블록과 사본, 금지 구역 가드는 바뀌지 않는다.
시험은 새 모듈tests/test_healthcheck_worktree_heads.py다. - 연결 작업 트리 작업 반영 안내. 동시 커밋 안내에
Landing work from a linked worktree
절을 더한다. 작업 트리 작업은 detached HEAD가 아니라 자기 분기에 커밋한다. master 반영은 공유 본 작업 트리에서
vault_commit.py로 한다. 바뀐 노트는 본 트리로 복사해--path와 그 sha256으로 커밋하고, 공유 노트의 줄은
--own-lines로 반영하되 패치 파일은 본 트리나 임시 폴더에 둔다. 볼트 폴더 안에 있는 연결 작업 트리(예:
.claude/worktrees/<이름>) 안의 경로는 패치 파일까지 거부되지만, 다른 곳에 있는 연결 작업 트리는 감지되지 않는다.
공유 본 트리에서는git merge·git cherry-pick을 쓰지 않는다. 둘 다 공유 인덱스에 쓰고, 다른 세션이 스테이징한
변경이 있으면git merge가 중단되며,vault_commit.py는 병합이 진행 중이면 거부한다. 작업 트리를 지우기 전에
vault_healthcheck.py --worktree-heads로, 또는 그 커밋을git branch --contains에 주어 확인한다. 어느 분기·태그에도 없는
detached 커밋은 작업 트리를 지운 뒤 git이 정리하면 사라진다. 백업 스냅숏은 등록된 작업 트리 사본을 건너뛰므로
(안전 보강 안내) 거기서 커밋하지 않은 작업도 스냅숏에 없다. - 판 표면. 세 매니페스트와 생성
antigravity/plugin.json, healthcheck 스탬프와ENGINE_VERSION, README·
docs/codex.md·docs/README.md·docs/release-integrity.md·SECURITY.md의 현재 판 줄과 Codex 설명을 0.50.0으로
옮긴다. Antigravity CLI 생성 패키지는 원본에서 다시 만들고 사본 일치를 검사한다.
기본 결과 변경
- 판 메타데이터: 매니페스트 버전·설치 태그·healthcheck 식별이 0.50.0으로 이동한다. healthcheck의 엔진 스탬프(2행,
vault_doctor.py --plugin-scope가 읽는다)와--help가 바뀐다.--help에서는 argparse가 사용법 블록에
[--worktree-heads]를 붙여 기본 폭에서 사용법이 한 줄 늘고,--worktree-heads줄이 옵션 목록에 하나 생기며,
기존 옵션 줄 여섯 개는 설명 열이 한 칸 밀려 다시 정렬된다. - 저장소 CI: 같은 풀 리퀘스트에 새 커밋이 오면 그 풀 리퀘스트의 이전 실행이 취소된다. 이 저장소 자체의 CI에 관한
변경이며 설치한 플러그인의 동작이 아니다. push 실행과 수동 실행은 취소되지 않는다. - 그 밖에는 새 플래그 없이 바뀌는 결과가 없다. 플래그 없는 healthcheck 기본 보고서·
--staged·--json-summary는
판 표면 말고는 v0.49.0과 같다. 규칙·어댑터·권한 템플릿·git 훅·기본 훅 정의·기본 네트워크/모델 호출 설정은
바꾸지 않는다.
하위호환·업그레이드
현재 설치 ref는 v0.50.0이다. 기존 설정 키는 추가하거나 마이그레이션하지 않는다. 활성 설치와 회사 볼트는 이
릴리스로 갱신하지 않는다. 볼트에 복사된 healthcheck는 /vault-upgrade(Codex는 upgrade)를 실행한 뒤에
--worktree-heads를 갖는다.
인증서가 묶는 일곱 파일은 v0.49.0과 같아 v0.46.0 이후 인증서는 실제 바이트가 같은 경우 계속 유효하다.
v0.45.1 이하와 오갈 때는 v0.46.0 업그레이드 안내를 따른다.
healthcheck만 engine=0.50.0으로 이동하며 기존 규칙·어댑터 스탬프는 유지한다.
checker_sha256는 09642e7aa77d0b812f5afa646b491fe2d79d44104e399bea4a3001a6f2f1279d 그대로다.
검증
검증 계약에 요구 관문을 적었다. 실제 최종 소스의 시험 수·종료 코드·건너뜀·CI·
독립 검토·ZIP 재빌드·설치 자원 바이트·인증서 결과는 릴리스의 verification.json에 기록한다.
게시 후 새 다운로드와 릴리스 증명 확인은 별도 기록으로 남긴다. 계약 문서 자체는 통과 결과가 아니다.
새 시험은 워크플로 파일의 concurrency 블록·사건·거름을 고정하는 tests/test_supply_chain.py의 시험, 임시 볼트
저장소에서 연결 작업 트리를 만들어 섹션 14c·분기 고정 뒤 0건·분기에 걸린 작업 트리 제외·플래그 없는 두 실행의
바이트 일치·--staged와의 인자 오류·--json-summary 키를 확인하는 tests/test_healthcheck_worktree_heads.py,
그리고 판 표면을 고정하는 tests/test_release_metadata.py의 v0.50.0 시험이다. 시험은 워크플로 파일의 내용만
확인한다. GitHub가 실제로 이전 풀 리퀘스트 실행을 취소하는지는 시험으로 확인하지 않았다.
연구 출처와 기존 기능의 차이
| 출처 | 준 것 | 이번 적용 |
|---|---|---|
| 개발동생 영상(2026-11-14) | Anthropic·OpenAI·GitHub의 Git 규모 대응 소개와, 발표자가 작은 팀에 권한 조언 셋(에이전트마다 작업 폴더를 따로 주는 git worktree, 같은 풀 리퀘스트에 새 커밋이 오면 돌던 시험 취소, 줄 단위 대신 의도 중심 리뷰) |
1번 항목은 둘째 조언을 이 저장소 CI에 옮긴 것이다. 첫째 조언(세션마다 작업 트리)은 이미 동시 커밋 안내가 권하고 있어, 2·3번 항목은 그 방식을 안전하게 쓰도록 이번에 더한 확인과 반영 안내다(발표자의 제안이 아니다). 셋째 조언은 기존 작업 명세(task contracts)로 다루며 바꾸지 않았다 |
| Anthropic, Redesigning source control | 클라이언트가 항상 온라인이라는 전제에서 서버가 커밋과 계산을 맡는 자체 소스 관리(Scion). 저자들은 "Scion is by no means a suitable replacement for git for general use."라고 적었다 | 채택하지 않았다. 로컬 git·훅·미러를 유지하는 근거로 읽었다. 가장 가까운 기존 기능은 vault_commit.py --own-lines(공유 인덱스 없이 HEAD 위에 자기 변경만 얹어 커밋을 만들고, HEAD가 그사이 바뀌지 않았을 때만 분기를 옮긴다)다 |
| OpenAI, Scaling Git at OpenAI | Git 사용 방식은 바꾸지 않고 저장소 뒤쪽 서버를 새로 만든 사례(Pando) | 맥락으로만 읽었고 채택하지 않았다 |
| GitHub, Inside GitHub's new Git storage architecture | 참조마다 순서를 매겨 다른 분기의 push끼리는 기다리지 않게 한 저장 계층("When two pushes do update the same reference, only one will append to the log.") | 맥락으로만 읽었고 채택하지 않았다 |
두 항목은 출처들이 소개한 서버 쪽 설계(Scion·Pando)가 아니라 발표자가 작은 팀에 권한 조언에서 나왔다. 서버 쪽
설계는 한 컴퓨터에서 여러 세션이 함께 쓰는 볼트라는 이 플러그인의 규모에 맞지 않아 채택하지 않았다. 기존의 해시를 선언한
경로 커밋·자기 줄 커밋(vault_commit.py), 연결 작업 트리 사본의 금지 구역 처리, 백업의 작업 트리 사본 제외를 새
기능처럼 다시 넣지 않았다. 이전 저장소 문서는 이 네 출처를 인용하지 않았다(git grep으로 네 주소를 찾아 v0.49.0
트리에 일치가 없음을 확인했다). 출처들이 보고한 효과 수치는 이 저장소의 효과로 주장하지 않는다.
알려진 경계
- CI 변경은 이 저장소의 워크플로에만 해당한다. 취소된 풀 리퀘스트 실행은 릴리스 관문이 아니며, 후보 분기·태그·
master push 실행은 취소되지 않는다. GitHub의 실제 취소 동작은 공개 뒤 풀 리퀘스트에서 관찰해야 한다. --worktree-heads는 git에 등록된 작업 트리만 읽는다. 작업 트리 삭제나git worktree prune을 막지 않고, 분기를
만들지 않으며, 커밋하지 않은 변경과 등록되지 않은 사본은 보지 않는다.--worktree-heads는 로컬 분기(refs/heads/*)와 태그(refs/tags/*)만 본다. 원격 추적 참조(refs/remotes/*)는
보지 않으므로 그것만 담은 커밋도 목록에 오른다.- 안내 절은 순서를 설명할 뿐 일반
git merge·git cherry-pick·git commit을 막지 않는다. - 실제 업무 볼트나 실제 풀 리퀘스트로 효과를 측정하지 않았다.
- 생성 Antigravity CLI 패키지의 사본 일치는 검사하지만 실제 agy 대화 세션은 실행하지 않는다.
v0.49.0 — 요구 출처·단계별 검증·개선 반복 관찰
v0.49.0 — 요구 출처·단계별 검증·개선 반복 관찰
사용자 요청·확인 답변·저장소 사실·호스트 기본값을 분리하는 작업 명세, 기존 실행 근거에 연결한
단계별 검토, 고정 명세의 개선 반복 관찰을 선택형 표준 라이브러리 도구로 추가한다.
기준은 공개 v0.48.0 커밋 8c4b176c9f594ad5c47ea9c12fd561d0432e822f다.
변경
- 작업 명세:
vault_task_contracts.py의 capture / inspect / revise.
각 항목의 정확한 원문 출처와 선언된 origin/status, 미확정 질문, 수락된 완료 조건을 기록한다.
저장소 사실과 호스트 가정은 확인된 사용자 요구로 자동 승격하지 않는다. 명세 개정은 새 불변
영수증으로 남고 이전 버전을 사용하는 검토는 현재 결과로 재사용하지 못한다. - 단계별 검증:
vault_staged_evaluation.py evaluate.
기존vault_evidence·vault_coverage를 재사용하며 계약의 완료 조건과 기계 검사·의미 검토·독립 검토를 연결한다.
실패·미실행·건너뜀·근거 없음을 구분하고 모델의 찬성만으로 검사 실패나 근거 누락을 통과로 바꾸지 않는다. - 개선 반복 관찰:
vault_improvement_cycles.py audit.
명시된 순서의 보고서를 다시 계산하고 같은 명세·완료 조건의 결과를 비교한다. 성공·회귀·반복 실패·진동·
세대 한도·관측 비용 한도 소진을 구분한다. 첫 관측이나 마지막 허용 관측에서도 성공할 수 있다. - 공용 스킬·Codex 연결 문서·문서 색인·배포 자원 확인 목록에 새 도구를 연결한다.
Antigravity CLI 생성 패키지는 원본에서 다시 만들고 사본 일치를 검사한다.
기본 결과 변경
- 기존 엔진 명령과 설정 스키마의 판정 경로는 바꾸지 않는다. 새 capture/revise 쓰기와 읽기 전용
inspect/evaluate/audit는 사용자가 해당 명령을 명시적으로 선택할 때만 수행한다. - 공용 스킬과 Codex 참고 문서에 새 도구 설명이 들어가므로 호스트가 읽는 안내 문구는 갱신된다.
단순하거나 이미 확정된 작업에 새 인터뷰나 대기 단계를 강제하지 않는다. - 현재 버전·설치 태그·healthcheck 식별은 0.49.0으로 이동한다. healthcheck의 버전 안내 출력은 바뀐다.
- 새 엔진 도우미와 문서가 패키지/설치 확인 목록에 추가된다. 기존 볼트의 엔진 사본은 upgrade 전까지 그대로다.
- 규칙·어댑터·권한 템플릿·기본 훅 정의·기본 네트워크/모델 호출 설정은 바꾸지 않는다.
하위호환·업그레이드
현재 설치 ref는 v0.49.0이다. 기존 설정 키는 추가하거나 마이그레이션하지 않는다.
새 작업 명세와 단계별 보고서의 스키마는 명시적 입력에만 적용한다. 활성 설치와 회사 볼트는 이 릴리스로 갱신하지 않는다.
인증서가 묶는 일곱 파일은 v0.48.0과 같아 v0.46.0 이후 인증서는 실제 바이트가 같은 경우 계속 유효하다.
v0.45.1 이하와 오갈 때는 v0.46.0 업그레이드 안내를 따른다.
healthcheck만 engine=0.49.0으로 이동하며 기존 규칙·어댑터 스탬프는 유지한다.
검증
검증 계약에 요구 관문을 적었다. 실제 최종 소스의 시험 수·종료 코드·건너뜀·CI·
독립 검토·ZIP 재빌드·설치 자원 바이트·인증서 결과는 릴리스의 verification.json에 기록한다.
게시 후 새 다운로드와 릴리스 증명 확인은 별도 기록으로 남긴다. 계약 문서 자체는 통과 결과가 아니다.
체크아웃에서 python scripts/evaluate_task_workflows.py로 일곱 합성 통제를 재생한다. 이는 외부 벤치마크가 아니다.
새 합성 시험은 확인되지 않은 가정의 수락, 미해결 질문, 개정된 명세의 이전 검토 재사용,
실패/미실행을 모델 찬성으로 통과시키는 경우, 필수 완료 조건 누락, 정체·회귀·소진을 성공으로
오인하는 경우, 낡거나 위험한 출처·경로·입력 한도를 다룬다. 실제 모델이나 회사 자료로 성능을 측정하지 않았다.
연구 출처와 기존 기능의 차이
Q00/ouroboros v0.60.0의 고정 소스
54dad8e1dd93aee31858bde72493cd7a0f938739를 검토했다.
| 참고 메커니즘 | 공개 근거 | 이번 적용 |
|---|---|---|
| 요구와 추측을 구분한 범위 | ledger, 실행 명세 | 항목별 출처·선언 상태·질문·불변 개정 이력 |
| 실행 근거와 모델 평가의 권한 분리 | 판정 | 기존 evidence/coverage 위의 단계별 보고서 |
| 성공과 중단의 구분 | 종료 조건 | 실행하지 않는 제한된 반복 관찰기 |
기존 요구사항-완료조건-검사 연결, 실행 비교, 네 조건 개선 실험, 비용 기록을 새 기능처럼 재도입하지 않았다.
이번 구현은 자체 표준 라이브러리 코드이며 Ouroboros 패키지를 의존성으로 설치하거나 코드를 복사하지 않는다.
상류는 MIT다.
모호성 수치 0.2와 온톨로지 유사도 0.95를 정확도 보증이나 이 플러그인의 기본 문턱으로 가져오지 않는다.
알려진 경계
- origin·confirmed·검사 실행 표시는 호출자의 선언이다. 정확한 원문과 해시는 바이트 연결/현재성을 확인하며
사용자 신원·실제 승인·내용의 진실·독립 실행을 인증하지 않는다. ready_for_execution_review는 실행이나 배포의 허가가 아니다. 모델 검토는 의미상 이견/보류의 자료이며
단독으로 실행 근거를 만들 수 없다. 기존 evidence에서 말하는 current 역시 의미상 정답을 뜻하지 않는다.- 반복 관찰기는 자동 실행·명령 실행·모델 호출·외부 지출 상한 강제·자동 승격·게시를 하지 않는다.
보고하지 않은 비용/관측은 발견하지 못하며 미확인 비용을 0으로 취급하지 않는다. - 실제 업무 오류율·비용 절감·자동 자기 개선 성능을 측정하지 않았다. 원문 명세와 검사가 충분한지에 대한
판단은 호출자와 검토자의 책임이며, 합성 기능 시험은 실업무 효과의 증명이 아니다. - 생성 Antigravity CLI 패키지의 사본 일치는 검사하지만 실제 agy 대화 세션은 실행하지 않는다.
v0.48.0 — Antigravity CLI 겸용 패키지
v0.48.0 — Antigravity CLI 겸용 패키지
Google Antigravity CLI(agy)에서도 같은 볼트를 쓰도록, 저장소의 명령·스킬·훅·엔진 스크립트로 만든
Antigravity 전용 플러그인 패키지를 antigravity/ 폴더에 더한다. 이 플러그인을 Antigravity CLI와 함께 쓰려면
무엇을 고쳐야 하는지 살핀 검토(agy 1.5.7 실측과 공식 문서 대조)의 변경 목록에서 여섯 항목을 다룬다. 세션 시작
훅의 Antigravity 모드, Stop 사건의 체크포인트, 패키지 생성기와 생성 패키지, 격리 설치 확인 도구, 호스트 중립
공용 문구, 문서와 판 표면이다. 저장소 루트는 지금처럼 Claude Code·Codex 플러그인이며 그 훅 정의와 매니페스트
구성은 바뀌지 않는다. 실제 agy 대화 세션은 실행하지 않았다(아래 알려진 경계). 새 옵션 없이도 결과가 바뀌는
곳이 있으므로 아래 기본 결과 변경을 먼저 본다.
변경
- 세션 시작 훅에
--host antigravity모드를 더한다(공용 도우미는
hooks/antigravity_hook.py). 생성 패키지의hooks.json만 이 플래그를 쓰며,
표준 입력의 모양으로 모드를 짐작하지 않는다. 이 모드는 표준 입력의 JSON을 16 MiB까지 읽고, 입력의cwd와
workspacePaths항목 가운데00-meta/vault-config.json이 일반 파일로 있는 절대 경로가 정확히 하나일 때 그
볼트를 쓴다.CLAUDE_PROJECT_DIR와 훅 프로세스의 현재 폴더는 쓰지 않는다. 볼트가 없거나 둘 이상이면{}를
내고, 둘 이상일 때는 경로 없는 한 줄을 표준 오류에 남긴다. 같은 사건의 처리기 셋 가운데 하나만 동작하도록
시스템 임시 폴더에 대화 ID로 정한 표지 파일을 만들며, 표지는 120초 동안만 유효하다. 주입할 글은 기본 경로가 새
세션(startup)에 쓰는 것과 같은 설정 검증·예산·9,500자 상한으로 만들어injectSteps의 시스템 메시지
하나(metadata의source는agentic-vault)로 낸다. 오류가 나면 고정 코드 한 줄과{}를 내며 종료 코드는
언제나 0이다. 도움말과 줄임 옵션--h(아래기본 결과 변경5번)를 빼면 플래그 없는 기본 경로(--host claude)의
출력과 표준 입력 처리는 v0.47.0과 같다. - 체크포인트 훅의
--host antigravity모드는 Antigravity의Stop사건에서
fullyIdle이 참이고 대화 ID(conversationId, 128자 이하)가 있을 때만, 같은 방식으로 찾은 볼트에 사건 이름
Stop의 체크포인트를 남긴다. 같은 대화 ID와 실행 번호(executionNum)의 Stop이 120초 안에 다시 오면 쓰지
않는다. 훅 입력의lastUserInput·transcriptPath·작업 공간 경로는 저장하지 않고(노트의 볼트 기준 상대
경로·크기·해시는 Claude Code 체크포인트처럼 남는다), 대화 ID는 해시로만 남기며, 언제나{}를 내고 0으로
끝난다.vault_state.py와 healthcheck가Stop사건을PreCompact·SessionEnd와 함께 받는다. - 패키지 생성기(
build·check)가 저장소에서 Antigravity CLI 패키지
antigravity/를 만들고, 만든 폴더를 커밋한다.plugin.json, Antigravity 형식의hooks.json(SessionStart와
Stop마다sh래퍼·py -3·python처리기 셋), 스킬 17개(공용 스킬 둘과 명령 15개를 같은 이름으로 바꾼 스킬),
엔진 스크립트·훅 파일 넷·assets/의 바이트 사본, 스킬이 가리키는docs/문서가 들어간다. 명령 스킬은
${CLAUDE_PLUGIN_ROOT}·$ARGUMENTS대신<PLUGIN_ROOT>·<ARGUMENTS>자리표시자와 그 뜻을 적은 머리말을 쓰고
disable-model-invocation: true를 단다. agy 검사기는 24,000바이트를 넘는 스킬 본문에 경고하므로
agentic-vault·vault-init·vault-upgrade스킬의 일부 절을 패키지 안의references/파일로 옮기고, 본문이
23,500바이트를 넘으면 생성이 실패한다. 저장소의 원본은 나누지 않는다. 패키지 안에 없는 대상으로 가는 링크는 같은
태그의 GitHub 주소로 바꾼다. 생성은 결정적이며(정렬한 순회, LF, 시각 없음)check는 다시 만든 결과와 커밋한
폴더의 차이를 하나씩 보이고 차이가 있으면 종료 코드 1로 끝난다..gitattributes는antigravity/**를 LF로
고정한다. - 격리 설치 확인 도구는 패키지를 임시 폴더에 복사하고 가짜 홈
폴더(USERPROFILE·HOME·APPDATA·LOCALAPPDATA·TMP·TEMP)에서agy --version,
agy plugin validate --strict --json(오류·경고 0),agy plugin install,agy plugin list --json(판,source가
antigravity, 활성, 스킬 이름, 훅 묶음)을 실행한 뒤 설치본을 바이트로 대조하고 실제~/.gemini/config가
그대로인지 확인한다. 대화,-p실행, 로그인은 하지 않는다. - 공용 문구: 공용 스킬의 설명과 본문,
/vault-session-start,/vault-lint,
볼트 AGENTS.md 스텁이 Antigravity CLI를 함께 적는다. 수동 세션
시작 경로와/vault-lint는 볼트 루트를--vault로 넘긴다. 스킬에
Antigravity CLI 참고 문서(설치, 스킬 이름, 자리표시자,
도구 대응, 훅, 하지 않는 것, 데이터, 확인하지 않은 것)를 더한다. - 문서: 새 Antigravity CLI 안내(설치·갱신·직접 해 보는 확인·권한·데이터·약관 메모·한계),
README, SECURITY.md, 문서 색인, hardening.md의
체크포인트 사건, codex.md, release-integrity.md, 저장소 AGENTS.md(매니페스트 넷과 생성 폴더
규칙)와 판 표면을 고친다.
기본 결과 변경
플러그인을 갱신하면 명령·스킬·훅 코드는 바로 바뀐다. 볼트에 설치된 사본(규칙·healthcheck·생성 AGENTS.md)은
/vault-upgrade(Codex는 upgrade)를 실행하기 전까지 예전대로다.
- 공용 스킬
agentic-vault의 설명(호스트가 스킬을 고를 때 읽는 문구)에서with Claude Code or Codex,가
with Claude Code, Codex or Antigravity CLI,로 바뀐다. 본문에는 Antigravity CLI 갈래 줄, 상시 규칙 괄호의
Codex·Antigravity CLI의 AGENTS.md, 명령 표기 문단 끝의 스킬 이름 안내, 훅 출력 상한 괄호의injectSteps
문장, 참고 목록의references/antigravity.md줄이 더해진다. 대상: Claude Code와 Codex의 모든 사용자. - 볼트 AGENTS.md 스텁의 첫 줄 재생성 안내가 Codex와 Antigravity CLI의 재생성 방법을 함께 적고, "Codex는
CLAUDE.md를"은 "Codex와 Antigravity CLI는 CLAUDE.md를"로, "Codex 표시 상한에 따른 생략"은 "호스트 표시 상한에
따른 생략"으로 바뀌며, Codex 줄 뒤에 Antigravity CLI 줄이 더해진다. 새 볼트의 AGENTS.md와,
/vault-upgrade(Codexupgrade)가agentic-vault:generated표지가 있는 AGENTS.md를 다시 만들 때 반영된다.
표지가 없는 AGENTS.md는 바뀌지 않는다./vault-recall은 AGENTS.md도 읽으므로 그런 볼트에서는 결과의
diagnostics.bytes_read가 달라진 바이트 수만큼 바뀐다. 대상: 새 볼트, 생성 AGENTS.md가 있는 볼트를 업그레이드하는 사용자. /vault-session-start는 주입이 없을 때session_start.py에 볼트 루트를--vault로 넘겨 실행하라고 하고,
CLAUDE_PROJECT_DIR을 현재 볼트 루트로 보라는 괄호를 뺀다. 대상: 세션 시작 주입이 없던 세션의 모든 사용자./vault-lint(Codexlint)는 건강 검사기에 볼트 루트를--vault로 넘기고, 생략하면 스크립트가
CLAUDE_PROJECT_DIR(Claude Code), 없으면 현재 폴더를 쓴다고 적는다. 넘긴 경로가 없거나 폴더가 아니면 검사기는
종료 코드 2로 끝난다(v0.46.0부터의 동작). 대상:/vault-lint를 쓰는 모든 사용자.- 두 훅의
--help(usage 줄과 옵션 목록)에--host {claude,antigravity}가 보인다.--help를--h로 줄여
쓰면 이제--help·--host둘에 맞아 인자 오류(종료 코드 2)로 끝난다(v0.47.0은 도움말을 냈다). 줄임 옵션
--h를 빼면,--host를 주지 않은 실행에서 바뀌는 것은 도움말과 아래 6번의Stop뿐이고 그 밖의 출력과
표준 입력 처리는 그대로다. 대상: 훅을 직접 실행하거나 도움말을 읽는 사람. session_checkpoint.py의--event가Stop도 받는다(도움말의--event선택지와 설명 문장에도Stop이
보인다). v0.47.0은--event Stop을 인자 오류(종료 코드 2)로 거부했다.--event없이 표준 입력으로 온Stop은
v0.47.0처럼 거부하고 기록하지 않는다.vault_state.py가Stop사건의 체크포인트를 쓰고 읽으며, healthcheck의
선택형checkpoint_drift_check는 마지막 사건이Stop인 체크포인트도 비교 대상으로 삼고 그 경고의details에
사건 이름Stop이 나올 수 있다. v0.47.0은 그런 기록을 형식이 맞지 않는 것으로 보고 건너뛰었다. Stop
체크포인트는--host antigravity(Antigravity 패키지의 훅)나--event Stop을 준 실행에서만 생기므로, 그런
기록이 없는 볼트의 healthcheck 결과는 그대로다. 보강 helper bundle을 설치한 git 볼트에서는
/vault-upgrade(Codexupgrade)가00-meta/scripts/의vault_state.py·vault_healthcheck.py를 플러그인
원본과 다르다(differs)고 보고하고 교체를 제안한다. 대상: 훅을 직접 실행하는 사람,checkpoint_drift_check를
켜고 Antigravity CLI로도 쓰는 볼트, helper bundle을 설치한 git 볼트.- 새 파일
hooks/antigravity_hook.py,scripts/build_antigravity_package.py,
scripts/verify_antigravity_plugin.py,skills/agentic-vault/references/antigravity.md,docs/antigravity.md와
생성 폴더antigravity/가 저장소와 Claude Code·Codex 설치본의 플러그인 폴더에 생긴다. Claude Code와 Codex가
읽는 매니페스트와 훅 정의는 바뀌지 않는다. 대상: 모든 사용자(설치 폴더의 파일 목록과 크기). - 릴리스 ZIP(태그의
git archive)에 생성 패키지antigravity/가 들어가 파일 수와 크기가 늘어난다. 대상: ZIP을
내려받거나 재빌드로 대조하는 사람. - healthcheck 스탬프와
ENGINE_VERSION이0.48.0이 된다./vault-upgrade가00-meta/scripts/vault_healthcheck.py
교체를 제안하고, doctor--plugin-scope는 v0.47.0 사본을 더 오래된 것으로 보고한다. 대상: healthcheck 사본이
있는 git 볼트. .gitattributes가antigravity/**를 LF로 고정하므로core.autocrlf=true인 Windows checkout에서도 그 폴더의
파일은 LF로 받는다. 대상: 저장소를 clone하거나 checkout하는 사람.
하위호환·업그레이드
일곱 bound 파일은 v0.46.0·v0.47.0과 같으므로 checker_sha256는 09642e7aa77d0b812f5afa646b491fe2d79d44104e399bea4a3001a6f2f1279d 그대로다. v0.46.0이나 v0.47.0에서 만든 인증서는 실제 설치 바이트가 같으면 그대로 맞는다. v0.45.1 이하에서 올 때는 v0.46.0의 순서를 따른다.
healthcheck 스탬프와 ENGINE_VERSION은 engine=0.48.0이다. 규칙 6종, Aside 조항 시작 마커와 /aside-repl 명령
원본(engine=0.47.0), deny zone 가드와 PowerShell 구문 분석기(engine=0.46.0), Aside 도우미
aside-up.ps1(engine=0.17.0), 교훈 단서 훅, git 훅은 기존 스탬프를 유지한다. 볼트에 설치된 healthcheck 사본은
/vault-upgrade(Codex upgrade)로 갱신하기 전까지 옛 동작이며, 스탬프가 올라갔으므로 /vault-upgrade가 그
사본의 교체를 제안한다.
Claude Code·Codex 설치는 그대로다. 저장소 루트의 hooks/hooks.json, .claude-plugin/, .codex-plugin/의 구성은
바뀌지 않고 판 번호와 Codex 긴 설명만 바뀐다. 줄임 옵션 --h를 빼면 두 훅의 기본 경로(--host 없음)는 v0.47.0과
같은 출력을 낸다(도움말과 --event Stop은 위 기본 결과 변경 5·6번).
Antigravity CLI에는 이번 판부터 antigravity/ 폴더를 태그를 고정한 주소나 로컬 폴더로 설치한다
(Antigravity CLI 안내). 이전에 저장소 루트를 agy로 설치했다면(Claude 플러그인 구조의
자동 변환 설치) 그 설치를 지우고 이 판의 패키지를 설치한다.
v0.47.0 이하의 healthcheck는 Stop 사건이 든 체크포인트를 형식이 맞지 않는 기록으로 보고 건너뛰므로, 되돌린 뒤에는
다른 체크포인트와 비교한다. 생성 AGENTS.md는 /vault-upgrade가 다시 만들 때 새 문구를 받고, 이전 판으로 되돌린 뒤
upgrade를 실행하면 그 판의 문구로 다시 만들어진다.
참고와 기존 활용의 차이
| 자료 | 고정 근거와 이번 활용 | 기존 활용과의 관계 |
|---|---|---|
Build plugins·Hooks·Customization discovery·Plugins·Rules·Permissions·/permissions 명령·Settings·CLI reference·Skills·FAQ (Google Antigravity 공식 문서, 2026-11-13에 읽음) |
플러그인 매니페스트의 위치와 허용 키, 플러그인 루트의 구성 요소(skills/·hooks.json, commands/ 없음)와 설치 위치, 훅 사건 여섯 가지(압축·세션 종료 사건 없음), 플러그인 훅이 플러그인 폴더에서 실행되고 작업 공간을 표준 입력의 workspacePaths로 받는다는 것, 표준 출력 JSON과 injectSteps, 0이 아닌 종료 코드를 기록하고 무시하는 동작, 스킬 프런트매터, 규칙 파일 탐색(AGENTS.md를 읽고 CLAUDE.md는 적재 위치에 없다)과 @ 포함을 펼친 뒤 24,000바이트를 넘는 규칙 파일을 자르는 것(Rules), /permissions의 Global·Shared·Project 범위와 read_file deny가 같은 경로의 write_file도 막는다는 것, Windows 경로를 드라이브 문자 없이 /로 맞추는 것(Permissions·/permissions 명령), 데이터 수집 설정이 계정에 저장되고 비즈니스 계정에서는 늘 꺼져 있다는 것(Settings), 작업 공간 신뢰 목록과 CLI 로그 파일 경로를 바꾸는 --log-file(CLI reference), 스킬마다 /<스킬 이름> 슬래시 명령이 생긴다는 것(Skills)과 플러그인 스킬도 /<스킬 이름>으로 부른다는 것(Plugins·Build plugins), 플러그인 스킬의 이름이 플러그인 이름으로 시작한다는 것(Customization discovery), 소비자 요금제에서 agy를 제3자 에이전트로 감싸는 것에 관한 FAQ. 생성 패키지의 형식과 훅 입출력, 안내서의 권한·데이터·직접 해 보는 확인, 알려진 경계의 근거로 쓴다 |
이 저장소의 이전 문서는 이 자료를 인용하지 않았다. |
| [google-antigravity/antigravity-cli](https://github.com/google... |
v0.47.0 — 안내서 대조 검토 반영과 aside-repl 절차 명령
v0.47.0 — 안내서 대조 검토 반영과 aside-repl 절차 명령
이 플러그인의 명령·규칙·브리지·어댑터를 공급사의 프롬프트 작성 안내서(아래 참고와 기존 활용의 차이)와
견준 대조 검토가 고칠 곳을 찾았다. 이번 릴리스는 열한 항목을 다룬다.
저장소 기여자 안내, Telegram 브리지의 선택형 모델·노력 수준과 계속 실패하는 정기 브리핑의 시도 상한,
교훈 은퇴 사유, 인박스 처리의 완료 조건, 종료 기록을 읽는 사람, 문구 정리, Aside의 /aside-repl 절차
명령, 시험 fixture의 경합, v0.46.0 문서 정정이다. 이 가운데 /aside-repl 절차 명령은 같은 검토에서
함께 다룬 요청이고, 시험 fixture의 경합과 v0.46.0 문서 정정은 v0.46.0 릴리스에서 넘어온 것이며,
나머지 여덟(넣지 않은 계약 한 줄 포함)은 그 검토가 찾은 것이다. 엔진 사본 소유를 밝히는 계약 한 줄은
계획해 시험했으나 통과하지 못해 넣지 않았다. 그 밖에 이전 릴리스 문서에 불안정한 시험으로 적혀 있던
시험 하나가 이번 릴리스 게이트에서 다시 떨어져 그 시간 의존 결함을 고쳤다(런타임 코드는 그대로다). 새
옵션 없이도 결과가 바뀌는 곳이 있으므로 아래 기본 결과 변경을 먼저 본다.
변경
- 저장소 루트에 기여자·에이전트 안내 AGENTS.md를 두고, Claude Code가 이를 불러오도록 .claude/CLAUDE.md(한 줄: @../AGENTS.md)를 둔다. 유지관리자가 설계와 릴리스를 정하고, 기여자와 에이전트는 요청받은 범위만 작게 고친다는 것, import 없이 같은 규칙을 지녀야 하는 파일(볼트에서 혼자 실행되는 healthcheck·deny zone 가드, vault_paths.py를 불러오면 안 되는 vault_lint_extensions.py, import 순환을 피하는 vault_state.py) 때문에 일부러 둔 다섯 규칙의 사본(일곱 곳)과 그것을 지키는 시험, 엔진 파일과 볼트 자료의 구분, 릴리스 규칙과 시험 실행법을 적는다. 볼트에는 설치하지 않는다.
- Telegram 브리지 설정: 선택 키
jarvis.model·jarvis.effort를 더한다.
두 키의 기본값은 빈 문자열이고, 비어 있으면 브리지는--model·--effort를 넘기지 않아 claude CLI 인자
배열이 v0.46.0과 같다. 값이 있으면--settings다음,--append-system-prompt앞에--model과 그 값,
--effort와 그 값을 이 순서로 더한다.effort는low·medium·high·xhigh·max중 하나이고,
model은 ASCII 영문자·숫자로 시작해 영문자·숫자와. _ : @ / + [ ] -만 쓴 256자 이하의 이름이다. 다른
값은 설정 오류로 브리지를 시작하지 않고, doctor는 값을 적지 않은 채jarvis_configuration_invalid를
보고한다. 브리지는 모델 이름이 CLI에서 쓸 수 있는지는 검사하지 않는다. - 정기 브리핑: 같은 회차가 8번 연속 실패하면(응답 생성 실패, 생성 중
예외, Telegram 전송 실패) 그 회차를pending에서 빼고 그날은 다시 시도하지 않으며, 소유자에게 날짜·시각·회차
이름과 시도 횟수를 적고 원인은 짐작하지 않는 안내를 한 번 보낸다. 시도 사이의 간격은 기존 재시도
간격(60초에서 시작해 실패마다 두 배, 최대 1시간)을 따른다. 이 간격은 회차마다 따로 두지 않고pending이 빌
때만 60초로 돌아가므로, 두 회차 이상이 함께pending에 있으면 뒤 회차는 앞 회차의 실패로 늘어난 간격에서
이어 시도하고 건너뛰기 안내도 그만큼 늦게 온다. 날이 바뀔 때 전날의pending회차는 한 번만 더 시도하고,
실패하면 같은 방식으로 건너뛴 뒤 그날 회차를 같은 처리에서 이어 간다. 상태 파일last_brief의 형식은
그대로다. - 교훈 은퇴 사유:
vault_lesson_delta.py의 RETIRE가 선택형reason과
date를 받아 대장 줄의 상태 칸을상태: retired(사유, YYYY-MM-DD)로 쓴다. 대장 줄의 표지 키는 그대로다.
제목형 기록에는 사유를 받지 않고(retire_reason_unsupported), 이미 적힌 사유는 바꾸지 않는다
(retire_reason_exists). 새 볼트의 교훈 대장 템플릿은 형식 줄에 두
은퇴 형태를 적고 은퇴 항목을 둔다. 실수 노트 템플릿은 "교훈은 만료되지
않는다" 대신, 이유가 사라진 항목을 사용자 확인 뒤 은퇴시키는 방법을 적는다./vault-session-end는 은퇴를
그 근거를 이번 세션에서 확인했을 때만 제안하고 승인 뒤 적용하며, 승격 초안에 적용 범위·이유·출처를 담고
사용자 확인만 필요한 행동은 "X 전에 확인받는다"로 쓴다.constraints_note안내는
항목마다 적용 범위와 이유를 적고 이유가 사라진 항목을 지우라고 권한다. /vault-process-inbox에 완료 조건(## 3-1.)을 둔다. 1에서 찾은
파일이 모두 처리를 마치거나 사유와 함께 보류돼야 끝난다. 내용 없는 자리표시 파일(.gitkeep등)은 대기열
파일로 세지 않는다. 보류 사유는 판독 불가, 이동 뒤 이름 충돌, 보완하고 다시 검사해도check_compile이
통과하지 않음, 진단하고 다시 시도해도 풀리지 않은 장애의 넷이다. 권한 거부·훅의 차단·deny zone은 우회하지
않는다. 보고 직전에 인박스를 다시 나열해 남은 파일(실행 중에 들어온 파일 포함)을 2단계부터 처리한다./vault-session-end첫머리에**읽는 사람:**문단을 둔다.
handoff·hot·log와 종료 보고는 이 세션에 없던 사람이 읽으므로 지어낸 약어는 풀어 쓰고, 명령이 요구하는
식별자와 기계 값은 그대로 적되 처음 나올 때 뜻을 붙인다.- 문구 정리: 새 볼트의 hot·handoff 템플릿 제목은 "500단어 이내" 대신 "500단어 권고"라고 하고, hot 템플릿
본문은 세션 주입 예산(hot_max_tokens) 안에 들도록 압축하라고 한다. SKILL.md는 hot을 "500단어 스냅숏" 대신
"짧은 현재 상태 스냅숏"으로 부르고, 종료 때 "500단어 이내로 재작성" 대신 핵심 결정·다음 행동을 앞에 두라고
한다. 상시 로드 규칙vault-architecture.md의 문구는 바꾸지 않았다. 설정 템플릿의gates.note_move설명은
처리한 인박스 원본의 격리 이동과/vault-lint관리성 이슈의 아카이브 이동을 나눠 적는다. /vault-session-end의 원격 push 줄을 예외가 드러나게 고쳤다. 동작은 같다.- 선택형 Aside 어댑터에 엔진 소유 절차 명령
/aside-repl을
더한다./vault-init과/vault-upgrade(Codexinit·upgrade)가 따로 묻고, 승인할 때만 볼트의
.claude/commands/aside-repl.md로 복사한다. 스크립트를 파일로 써서 bash 셸이 있으면
aside repl "$(cat 파일.js)"꼴로, 없으면 Python에서 셸을 거치지 않고 넘기며, 요청 글은 셸 명령줄에 넣지
않는다. 본문에 주입 셸 명령과allowed-tools가 없으므로aside호출은 모두 에이전트 자신의 도구 호출로 권한
확인과 훅을 거친다. 다만 Python 경로의 호출은python으로 시작하므로,aside로 시작하는 Bash·PowerShell
명령에만 건 Aside 자동 기동 훅은 동작하지 않는다. 그래서 절차는 그 경로에서 훅이 있어도 기동 도우미를 직접
실행하게 한다(훅의 조건은 설정 파일을 읽어 확인했고 훅을 켠 채 실행해 보지는 않았다).vault_adapters.py의
새--offer-aside-command와adapters.aside_command항목이 사본의 상태를 보고하고, 새로 넣는 Aside 조항에는
**repl 스크립트 전달:**줄이 붙으며, 새로 만드는 운영 가이드 노트에는 2026-11-12~13의 repl 호출 실측 표가
들어간다. 명령·스킬 본문이 주입하는 셸 명령이 PreToolUse 훅을 거치지 않은 관찰은
SECURITY.md와 deny zone 가드 안내에 적었고,
이 플러그인의 명령·스킬에 주입 셸 명령이 없음을 시험이 지킨다. Codex 설치 확인이 바이트로 대조하는 리소스는
129개에서 130개가 된다. - 시험 fixture: tests/test_vault_commit.py가 모든 시험에서 복사하는 시드 Git 저장소에 maintenance.auto=false와 gc.auto=0을 둔다. v0.46.0 master CI의 macOS 작업 하나가 이 저장소를 복사하는 동안 .git/objects/maintenance.lock이 사라져 오류를 냈다. 자동 유지보수가 커밋 뒤 배경에서 그 파일을 만들고 지운 것으로 보이며, 원인 프로세스를 직접 관측하지는 않았다. 런타임 코드는 바뀌지 않는다.
- 시험: tests/test_vault_retrieval.py의
test_later_source_verification_cannot_leave_earlier_source_stale은 같은 크기로 다시 쓴 출처를 마지막 재확인이 알아채는지 보는데, 두 번의 쓰기가 같은 파일 시각 눈금에 들어가면 떨어졌다. 이 시험은 v0.23.0의 검증 문서와 v0.25.0·v0.26.0 릴리스 노트에 불안정한 시험으로 적혀 있었고, v0.26.0에서는 다루지 않은 채 남았다. 이 릴리스의 첫 후보 커밋에서 전체 로컬 시험을 두 번 돌린 가운데 한 번 떨어졌고, 그 시험만 한 프로세스에서 300번 반복하면 그 커밋에서 97번, v0.46.0에서 86번 떨어졌다(Windows 11, Python 3.12). 시험이 다시 쓴 파일의 수정 시각을 명시적으로 뒤로 옮기게 고쳤다. 런타임 코드는 바뀌지 않는다.
기본 결과 변경
플러그인을 갱신하면 명령·스킬·브리지 코드는 바로 바뀐다. 볼트에 설치된 사본(규칙·healthcheck·어댑터)은 /vault-upgrade(Codex는 upgrade)를 실행하기 전까지 예전대로 동작하고, 이전 플러그인 폴더에서 시작한 Telegram 브리지는 다시 시작하기 전까지 예전대로 동작한다.
/vault-process-inbox는 보고 직전에 1단계와 같은 범위로 인박스를 다시 나열하고, 처리하지도 보류하지도 않은
파일(실행 중에 들어온 파일 포함)을 2단계부터 처리한다. 보류 사유는 정확히 넷이다. 권한 거부, 훅의 차단, deny
zone은 우회하지 않고(문서에 적힌mv -n경로만 쓴다) 무엇이 막았는지를 적어 풀리지 않은 장애로 보류한다.
보고 표에는 보류한 파일마다 사유와 필요한 사용자 결정이 붙는다. 내용 없는 자리표시 파일(.gitkeep등)은
대기열 파일로 세지 않는다. 대상: 플러그인을 갱신한 모든 사용자(Claude Code와 Codex)./vault-session-end는 handoff·hot·log와 종료 보고를 이 세션에 없던 사람이 읽는다는 기준으로 쓴다.
지어낸 약어는 풀어 쓰고, 명령이 요구하는 ID·해시·상태 값은 그대로 적되 처음 나올 때 뜻을 붙인다. 구조,
예산, log 형식은 그대로다. 대상: 모든 사용자./vault-session-end의 승격 초안은 조항 안에 적용 범위·이유·출처를 적고, 사용자 확인만 필요한 행동은 "X 전에
확인받는다"로 쓴다. 이미 승격된 조항은 바뀌지 않는다. 은퇴는 그 교훈이 기대던 원인이 사라졌다는 근거를 이번
세션에서 확인했을 때만 제안한다. 대상: 모든 사용자의 새 승격과 은퇴 제안.- 새 볼트의 실수 노트 템플릿은 "교훈은 만료되지 않는다" 대신, 이유가 사라진 항목을 사용자 확인 뒤 제목
아래상태: retired(사유, YYYY-MM-DD)줄로 은퇴시킨다고 적는다(교훈 표지가 있으면 그 다음 줄에 달고, 사유
없는 RETIRE로 표지 상태도retired로 맞춘다). 본문은 남는다. 기존 실수 노트는 바뀌지 않는다. 대상: 새
볼트(/vault-init, Codexinit). vault_lesson_delta.py: 상태 칸이 이미상태: retired(…, YYYY-MM-DD)인 줄에 사유 없는 RETIRE를 하면 그
칸을상태: retired로 다시 쓰지 않고 그대로 둔다. 그 밖의 RETIRE 결과는 바이트 단위로 같다. 대상: 사유를
손으로 적은 칸에 RETIRE를 실행하는 사용자.- 새 교훈 대장은 새 형식 줄(두
retired형태)과 은퇴 항목을 받는다./vault-upgrade가 맞추는 v0.8.2 이하의
대장도 새 형식 줄을 받는다. 다른 기존 대장은 바뀌지 않는다. 대상: 새 볼트, v0.8.2 이하의 대장. - 새 볼트의 hot·handoff 템플릿 제목은 "500단어 이내" 대신 "500단어 권고"라고 하고, hot 템플릿 본문은 세션
주입 예산(hot_max_tokens) 안에 들도록 압축하라고 한다. SKILL.md는 hot을 "짧은 현재 상태 스냅숏"으로
부르고, 종료 때hot_note를 핵심 결정·다음 행동이 앞에 오게 다시 쓰라고 한다. 상시 로드 규칙
vault-architecture.md는 그대로다("500단어 핫 컨텍스트", 스탬프engine=0.6.0). 기존 노트는 바뀌지
않는다. 대상: 새 볼트(템플릿), 모든 사용자(SKILL.md). - 새 볼트의 설정 템플릿에서
gates.note_move설명이 인박스 원본의 격리 이동(확인 없음)과 관리성 아카이브
이동(승인 뒤)을 나눠 적는다. 값은 그대로이고 게이트는 집행되지 않으며 기존 설정은 바뀌지 않는다. 대상: 새
볼트. /vault-upgrade는 기존jarvis블록에 빈model·effort키를 더하고, 새 볼트도 두 키를 받는다. 키가
비어 있는 동안 브리지의 claude 인자 배열은 v0.46.0과 같다. 대상:jarvis블록이 있는 볼트, 새 볼트.- v0.46.0까지 무시되던
model이나effort키가 이미jarvis블록에 있으면 이제 검증한다. 올바른 값은
--model·--effort를 더하고, 올바르지 않은 값(문자열이 아닌 값 포함)은 브리지를 시작할 때 멈추게 하며
(종료 코드 2) doctor는jarvis_configuration_invalid를 보고한다. CLI가 받지 않는 모델 이름은 모든 질문과
브리핑을 실패하게 한다(--bare없이 이름 하나로 확인했다). 대상: 그런 키가 있는 브리지 사용자. - 같은 정기 브리핑 회차가 8번 연속 실패하면(생성 실패, 생성 중 예외, 전송 실패)
pending에서 빠지고 그날은
다시 시도하지 않으며, 소유자는 날짜·시각·회차 이름과 시도 횟수가 든 안내를 한 번 받는다. v0.46.0은 끝없이
다시 시도했고 소유자에게 알리지 않았다. 그 회차는fired로 기록하지 않고, 전달되지 않은 안내는 로그에만
남는다. 대상: 브리지 사용자. - 날이 바뀔 때 전날의
pending회차는 한 번 더 시도하고 실패하면 안내와 함께 건너뛰며, 그 뒤 같은 처리에서
그날 회차를 진행한다. v0.46.0은 전날 회차가 성공할 때까지 그날 회차를 처리하지 않았다. 대상: 브리지 사용자. - 생성 중 예외(설정 오류 제외)도 실패한 시도로 센다. 로그 줄이
스케줄 브리핑 생성 실패(HH:MM) — 시도 k/8,
스케줄 브리핑 생성 오류(HH:MM, …) — 시도 k/8(괄호 안에 시각과 오류의 유형·위치),
스케줄 브리핑 전송 실패(HH:MM) — 시도 k/8로 바뀌고스케줄 브리핑 생성 실패 — pending 유지는 없어진다.
상태 파일 쓰기 오류의 처리는 그대로다. 대상: 브리지 사용자, 로그를 읽는 사람. vault_adapters.py에 새 옵션--offer-aside-command와 항목adapters.aside_command가 생긴다. 이 항목은
그 옵션을 주거나.claude/commands/aside-repl.md가 있을 때만 나온다. 같은 이름의 명령을 직접 만든 볼트는
이 항목을unstamped·review_command로 보고,vault_adapters.py의 텍스트 출력(기본--format text)에
두 줄이 더 붙으며/vault-doctor가 읽는 JSON에는adapters.aside_command가 더해진다. 다른 항목은
그대로다. 대상:.claude/commands/aside-repl.md가 있는 볼트./vault-upgrade는 늘--offer-aside-command를 주므로 어댑터 JSON에aside_command가 생긴다(설치된 것이
없으면missing, Aside 조항이 없으면 아무것도 말하거나 묻지 않는다). Aside 조항이 있는 볼트에서는
/aside-repl설치를 묻고(답이 없으면 설치하지 않는다), 명령이 설치됐는데 조항에**repl 스크립트 전달:**
줄이 없으면 그 줄을 넣을지 따로 묻는다. 고치지 않은 구버전 명령은 diff를 보여 준 뒤 교체한다. 대상:
/vault-upgrade나 Codexupgrade를 실행하는 모든 볼트(JSON 항목), Aside 조항이 있는 볼트(질문)./vault-init은 Aside 어댑터가 승인되면/aside-repl설치를 따로 묻는다.frontmatter_roots가 없고
frontmatter_exempt_paths(없으면fm_exempt_zones)가.claude를 덮지 않으면 먼저.claude를 더할지
묻고, 거부하면 설치하지 않는다. 대상: 새 볼트(Claude Code와 Codex).- 새로 넣는 Aside 조항의 시작 마커는
engine=0.47.0이고**repl 스크립트 전달:**줄(bash 경로와 셸 없는
Python 경로)이 붙으며,**기동(Windows):**줄은 Python 경로로aside repl을 부를 때 자동 기동 훅이 있어도
기동 도우미를 먼저 실행하게 한다. 기존 조항은 바뀌지 않는다. 대상: 새로 Aside를 들이는 볼트. - 새로 만드는 Aside 운영 가이드 노트에 2026-11-12~1...
v0.46.0 — 금지 구역 정규화와 검사 빈틈 보강
v0.46.0 — 금지 구역 정규화와 검사 빈틈 보강
v0.45.1에 대한 외부 검토가 찾은 결함 일곱 가지를 고친다. 금지 구역(deny zone)이
같은 폴더 이름의 다른 유니코드 정규화 표기를 놓치던 문제, 프런트매터의 따옴표 없는
위키링크 검사가 놓치거나 잘못 보고하던 꼴, 설정 키·노트 경로·--vault 경로의 오류를
조용히 넘기던 곳, 템플릿으로 만든 볼트에 나던 거짓 경고, 검사를 다 하지 못했는데도
통과로 보이던 집사 보고다. 새 옵션 없이도 결과가 바뀌는 곳이 있으므로 아래
기본 결과 변경을 먼저 보고, 경고를 fatal로 올린 볼트는 갱신 전에
하위호환·업그레이드의 순서를 따른다.
변경
- 금지 구역 비교와 deny zone 가드:
금지 구역과exclude_dirs를 견주는 판정이 경로 단계마다 같은 접기 함수fold_path_part를
쓴다. 두 이름은 유니코드 정준 대소문자 무시 비교(canonical caseless matching: NFD, casefold,
NFD)로 같을 때 같은 이름이고, 비교용 결과는 NFC로 낸다. ASCII 이름은 예전처럼 casefold만
한다. healthcheck,vault_paths로 경로를 푸는 도구(recall·세션 시작·doctor·Telegram 브리지 등),
lint 경고 확장, 선택형 deny zone 가드(Bash·PowerShell 명령과 와일드카드 경로에서 구역 이름을
찾는 단계 포함)가 모두 이 비교를 쓴다. 설정 파일의 문자열은 고쳐 쓰지 않는다. - 프런트매터의 따옴표 없는 위키링크: 줄 단위 정규식 대신
작은 반복형 스캐너가 YAML이 중첩 목록으로 읽는 꼴을 찾는다. 커밋 게이트(--staged)와 full
검사가 같은 스캐너를 쓰며, 메시지·개수 방식·종료 코드는 그대로다. 표준 라이브러리만 쓰고
입력 길이에 선형이며 재귀하지 않는다. - 알 수 없는 최상위 설정 키:
deny_zone같은 오타는 적용되지 않는데도
조용히 넘어갔다. 이제 health 리포트 §0과 doctorconfig_warnings가 키 이름과 가장 가까운
알려진 키를 알리고, healthcheck 콘솔 줄은 그 건수를 알린다. 값은 보이지 않고, 키 이름의 제어·줄
바꿈·방향 제어 문자는 escape해 적는다. 경고일 뿐 종료 코드는 그대로다. hot_note·handoff_note의.md요건: 두 키가.env같은
임의 파일을 가리키면 SessionStart가 그 내용을 주입할 수 있었다. 이제 비어 있거나 확장자가
.md(대소문자 무관)인 노트만 받고, 다른 값은 설정 오류로 막는다. 메시지는 키 이름만 적는다.--vault경로 오류와--require-vault: 명령줄에서 준--vault경로가
없거나 파일이면 healthcheck와 doctor가 종료 코드 0으로 끝날 수 있었다(아래 9번). 이제 종료
코드 2로 끝난다.
새--require-vault는 healthcheck full 모드와 doctor에서 설정이 없는 폴더도 2로 끝낸다.- 템플릿의 기준 커밋 자리표시자: 템플릿 그대로의 handoff
기준 커밋(없음)이 "session-end 계약 위반"으로 보고됐다. 이제 자리표시자를 받아들이고,
git 볼트에서 볼트 폴더를 바꾼 커밋이anchor_drift_threshold개 이상 쌓였을 때만 알린다. - 집사 보고와 healthcheck 요약: Telegram 집사는 종료
코드만 보고치명 없음 ✅를 보냈다. healthcheck에 선택형--json-summary(한 줄 JSON, 개수만
담고 경로·노트 이름·값은 담지 않는다)를 더했고, 브리지는 이 요약을 읽어 완전하고 깨끗한 검사에만
✅를 붙인다. - Codex 설치 확인(
scripts/verify_codex_plugin.py)이vault_paths.py·vault_healthcheck.py·
jarvis_bridge.py도 설치본과 바이트로 대조한다. 대조하는 리소스는 126개에서 129개가 된다.
기본 결과 변경
다음 결함 수정은 새 옵션 없이 결과를 바꾼다. 볼트에 설치된 healthcheck와 deny zone 가드
사본은 /vault-upgrade(Codex upgrade)로 갱신하기 전까지 옛 동작이며, 그 사이에는 커밋
게이트와 세션 시작 검사의 판정이 다를 수 있다.
- 금지 구역은 이제 대소문자뿐 아니라 유니코드 정규화 형식도 무시하고 맞춘다(유니코드
정준 대소문자 무시 비교). healthcheck full 모드, recall, 세션 시작, doctor, Telegram 브리지,
lint 경고 확장, deny zone 가드(Bash·PowerShell 명령과 와일드카드 경로에서 찾는 구역 이름
포함), 그리고vault_paths로 노트 경로를 푸는 모든 도구(jarvis_bridge,vault_commit,
vault_connectors,vault_context_guard,vault_doctor,vault_egress,vault_evidence,
vault_instruction_budget,vault_lesson_metrics,vault_links,vault_memory,
vault_plugin_scope,vault_proposals,vault_provenance,vault_query_expansion,
vault_recall,vault_retrieval,vault_revocation,vault_runs,vault_ssot,
vault_state,vault_worktrees,session_start)에 적용된다. 예를 들어 커밋 도우미는 그런
경로를denied_path로 거부하고, SSOT 도우미는 그런 노트를 더 이상 읽지 않는다. macOS 볼륨과
거기서 복사한 자료처럼 분해형(NFD)으로 저장된 폴더 이름은 이제 조합형(NFC)으로 적은 구역
안에 들고, 반대도 그렇다. 기본 구역 다섯 개를 포함해 ASCII 이름의 구역은 예전과 같다. 다만
;나`가 든 구역은 그 글자와 정준 동치인 U+037E(그리스 물음표)·U+1FEF(그리스 바리아)로
적은 폴더 이름도 이제 덮는다. 그런 폴더의 노트는 healthcheck 대상, recall 결과, 세션 문맥에서
빠진다. 반대로 예전의 casefold 비교로는 같던 이름이 달라지는 드문 경우가 있다. 아래 이오타
(U+0345.ᾪ처럼 합쳐 쓴 글자에 든 것도, 다른 글자 뒤에 따로 붙인 것도 해당한다) 뒤에 결합
부호가 이어지고 정규화가 그 부호를 아래 이오타 앞으로 옮기는 이름은(결합 등급이 0이 아닌 부호가
대개 그렇다), 대문자 변환이나 casefold가 아래 이오타를 글자 이오타(ι·Ι)로 바꾸어 그 부호가
이오타 뒤에 남은 표기와 더 이상 같은 이름이 아니다. 이 차이는 아래 이오타가 든 이름에서만 생긴다.
macOS의 deny zone 가드는 경로를 분해형으로 푼 뒤 대소문자를 접어 견주도록 바뀌어,
볼트 폴더 이름을 다른 정규화 형식으로 적은 경로도 같은 볼트로 본다. exclude_dirs항목도 공유 비교기가 견주는 곳(recall, 브리지의 노트 경로,vault_paths를
쓰는 도구)에서는 같은 방식으로 접힌다. healthcheck 자체의 폴더 순회와 백업은 지금의 정확
일치를 유지한다.- 이름이 정규화 형식만 다른 두 형제 폴더는 이제 한쪽을 적은 구역에 둘 다 든다.
- 그런 폴더 안을 가리키는 설정 노트(
hot_note,handoff_note,index_note,log_note,
ssot_note,health_report,rules_dir)는 이제 설정 오류다. healthcheck 종료 코드 1, 세션
주입 없음, doctorinvalid_config(종료 코드 2), recallinvalid_config이다. 설정을 검증하는
다른 도구(커밋 도우미, evidence, memory, proposals, revocation과 그 밖의validate_config
호출자, 설정 바인딩을 거치는 브리지의 Q&A·브리핑)도 멈추고, 볼트의 검사기 사본을 갱신하면
커밋 게이트가 커밋을 거부한다. - 프런트매터 검사는 이제 흐름 목록 안의 따옴표 없는 위키링크(
related: ["[[A]]", [[B]]],
related: [ [[B]] ]), 흐름 매핑 안의 값(meta: {a: "[[A]]", b: [[B]]}), 영문자·숫자·_밖의
글자가 든 키 뒤(see-also: [[B]], 따옴표로 감싼 키), 목록 항목 안의 키 뒤(- key: [[B]]), 키
다음 줄, 중첩 목록 항목, 앵커·태그 뒤, 흐름 키로 쓴 링크, 값 맨 앞의 Obsidian 임베드
(cover: ![[img.png]]), 주석으로 끝난 평문 값 아래에 들여 쓴 줄의 링크(title: a # 메모다음
줄의[[B]]), 값 안에 다시:가 나온 뒤의 링크(title: a: [[b]])도 보고한다. 그런 노트가 있으면
full 검사가 종료 코드 1로 끝나고(SessionStart 백그라운드 검사도 그렇다. 그래서
--session-evidence는observed_error를 보고한다), 제안(proposals)은 거부되며, 볼트의 검사기
사본을 갱신하면 그 노트를 스테이징한 커밋도 거부된다. YAML이 읽지 못하는 깨진 프런트매터에서도
스캐너가 읽은 문맥에 따라 새로 보고되는 줄이 있다. 예를 들어title: "제목처럼 닫는 따옴표가
빠진 줄 아래에related: ["[[A]]"]가 있으면, 열린 따옴표가 그 줄의 첫 따옴표에서 닫힌 것으로
읽혀 뒤의 링크가 따옴표 밖에 놓이므로 그 줄을 보고한다. 보고는related:줄을 가리키지만
원인은 위쪽의 닫히지 않은 따옴표다. - YAML 자체가 블록 스칼라(
|,>)의 내용, 따옴표 문자열(여러 줄 포함), 평문 값의 이어지는
줄로 두는 줄은 더 이상 보고하지 않는다. v0.45.1은 그 줄들을 한 줄씩 따로 읽었다. 프런트매터
전체가 키 없이 스칼라 하나인 경우만 예외로, 그 안의 줄은 예전 규칙으로 계속 검사한다. 올바른
YAML에서는 그 밖에 v0.45.1이 보고한 줄을 계속 보고한다. 프런트매터가 올바른 YAML이 아닐 때에도
프런트매터 끝이나...줄까지 닫히지 않은 따옴표 뒤,...줄 뒤, 블록 스칼라 내용보다 덜 들여
쓴 줄, 평문 값을 시작할 수 없는 글자로 시작한 값 뒤의 줄은 계속 보고한다. 다만 YAML이 읽지
못하는 프런트매터는 어디까지가
따옴표나 블록 스칼라인지가 정해져 있지 않으므로, 스캐너가 그런 구간 안으로 읽은 줄은 v0.45.1과
달리 보고되지 않을 수 있다(아래알려진 경계). 00-meta/vault-config.json의 알 수 없는 최상위 키는 이제 health 리포트 §0에 한 줄씩(가장
가까운 알려진 키가 있으면 함께), healthcheck 콘솔 줄에 알림으로(SessionStart 백그라운드 검사
줄도 마찬가지), doctor에config_warnings필드로 나온다. 종료 코드, 커밋 게이트, SessionStart
주입(session_start.py)과 recall은 그대로다.deny_zone을deny_zones로 고칠 때는
deny_zones가 기본 구역 다섯 개를 대체한다는 점을 기억하고 그 다섯 개도 함께 적는다.hot_note·handoff_note는 비어 있거나 확장자가.md(대소문자 무관)인 노트를 가리켜야 한다.
다른 값은 이제 설정 오류다. healthcheck 종료 코드 1, 두 노트 모두 주입 없음, doctor
invalid_config(종료 코드 2), recallinvalid_config이고, 설정을 검증하는 다른 도구도 4번처럼
멈추며, 볼트의 검사기 사본을 갱신하면 커밋 게이트가 커밋을 거부한다.- 명령줄에서 준
--vault경로가 없거나 파일이면 healthcheck는 이제 종료 코드 2로 끝난다(전에는
full 모드에서 없는 경로는 종료 코드 0과볼트 아님, 파일은 Windows에서 0과볼트 아님,
POSIX에서 1이었고,--staged에서는 1이었다). doctor는 종료 코드 2와invalid_vault
(vault_path_not_found)를 낸다(전에는 종료 코드 0과not_vault).00-meta/vault-config.json
없이 존재하는 폴더와--vault없는 실행(SessionStart 훅 등)은 full 모드에서 여전히 0으로
끝나며, 새--require-vault를 주면 그 경우도 2로 끝난다.--staged에서는 이 옵션이 결과를
바꾸지 않는다(설정 파일을 읽지 못하는 폴더는 두 버전 모두 1로 끝난다). - 기준 커밋(anchor) 줄이 아직 템플릿 값
(없음)인 handoff는 더 이상 "handoff에 기준
커밋(anchor) 줄이 없음 — session-end 계약 위반"을 받지 않는다. git이 없으면 §12가 검사를
건너뛰었다고 적고, git 볼트에서는 아직 session-end 기록이 없다고 적으며, 볼트 폴더를 바꾼
커밋이anchor_drift_threshold개에 이르러야 콘솔 경고("session-end 기록 없음")를 낸다.
기준 커밋 줄 자체가 없는 handoff는 예전처럼 보고하고, 자리표시자 줄과 함께 16진수 기준 커밋
줄도 있는 handoff는 예전처럼 그 16진수 줄로 계산한다. - 명령줄: healthcheck의
--help와 usage 줄에--require-vault·--json-summary가, doctor의
것에--require-vault가 나온다. 사용 오류였던 새 옵션의 접두어(--r,--re,--j등)는
이제 그 옵션을 고른다. 전에 통하던 약어는 모두 뜻이 그대로다. - Telegram 집사는 완전하고 깨끗한 검사에만
치명 없음 ✅를 보인다. 치명 건수를 밝히고, 읽지
못한 노트가 있거나 링크·정션을 건너뛰었으면 그 수와 함께일부 미검사라고 적는다(연결 작업
트리 사본과 근거 바이트 예산으로 빠진 노트는 세지 않는다). 근거 바이트 예산 때문에 경고 확장
분석이 일부 생략됐으면 그 사실과 건수를 덧붙이고, 경고를fatal로 올린 볼트에서는 그때 ✅
대신⚠️ 를 쓴다. 설정·경로 오류는 치명 발견이 아니라 오류로 보고하고, 검사기가 요약을 내지
않으면 결과를 확인할 수 없다고 적는다. 볼트 폴더가 사라졌으면 예전처럼실행 실패다. 이전
플러그인 폴더에서 시작한 브리지는 새 폴더에서 다시 시작할 때까지 옛 문구를 쓴다. checker_sha256가 바뀌므로, 경고를fatal로 올린 볼트는 v0.45.1 이하에서 만든 인증서로는
새 엔진에서 멈춘다(아래하위호환·업그레이드).- 참고:
scripts/evaluate_retrieval_backends.py가 싣는vault_paths.py·vault_healthcheck.py의
code_sha256값이 바뀐다. - 참고:
scripts/evaluate_verifier_fidelity.py의frontmatter_destruction행에서 제안 관문이
막는 수가 66건 중 42건에서 48건으로 는다(5번의 닫히지 않은 따옴표 꼴 6건).
측정 문서의 표와 그 표를 고정한 시험도 새 수치다.
바뀌지 않는 것도 적어 둔다. --json-summary를 주지 않으면 healthcheck의 콘솔 줄과 리포트
§14는 근거 바이트 예산 때문에 건너뛴 파일을 여전히 읽기 실패로 적고 이슈 합계에 센다. 이번
릴리스는 기본 출력을 일부러 바이트 단위로 유지한다. 커밋 게이트(--staged)는 구역의 다른 표기로
스테이징한 노트를 대소문자 변형과 마찬가지로 계속 검사한다(아래 알려진 경계).
하위호환·업그레이드
금지 구역 비교를 바꾸면서 경고 승격 인증서의 checker_sha256는 v0.34.0부터 v0.45.1까지의
be02b141ffed91cbe34f8cb2317a790c60075740bfe5d8dc435ef202f113174f에서 09642e7aa77d0b812f5afa646b491fe2d79d44104e399bea4a3001a6f2f1279d로 바뀐다. 일곱 bound 파일 가운데 바뀐 것은 vault_paths.py와 vault_lint_extensions.py이고 harmless corpus는 같다. 인증서는 버전 이름이 아니라 실제 바이트를 묶는다.
Claude Code와 Codex의 플러그인 설치본, 그리고 git 볼트에서 pre-commit 훅이 실행하는 볼트 안 엔진 사본(00-meta/scripts/)이 그 대상이다. 그래서 경고를 fatal로 올린 볼트는 갱신 전에 다음 순서를 따른다. 이전 버전으로 되돌릴 때도 같은 순서다.
- 볼트 설정
warning_policy.levels에서fatal로 올린 단계를warning으로 되돌린다. - 볼트를 읽는 엔진을 모두 같은 버전(되돌릴 때는 이전 버전)으로 바꾼다. Claude Code와 Codex 설치본을 함께 바꾸고, git 볼트의 엔진 사본은 갱신할 때
/vault-upgrade(Codexupgrade)로 바꾼다./vault-upgrade는 사본을 이전 버전으로 내리지 않으므로, 되돌릴 때는 그 사본도 이전 버전의 파일로 직접 되돌린다. - 바꾼 설치본에서
vault_warning_policy.py --certificate로 인증서를 다시 만들어 볼트 설정의warning_policy.certificate에 넣는다. - 단계를 다시
fatal로 올린다.
3단계의 명령은 harmless replay를 실행하므로 실행 결과와 설치 바이트를 확인한다. 버전이 섞인
동안에는 한 인증서가 모든 사본에 맞지 않으므로 승격을 끈 채로 둔다. 맞지 않는 인증서를 유지하면
healthcheck는 종료 코드 1로 멈추고 SessionStart는 주입하지 않으며 --staged는 커밋을 막는다.
doctor·recall은 invalid_config, check-support를 포함한 SSOT 명령(vault_ssot.py)은
ssot_operation_unavailable로 멈춘다. 경고를 승격하지 않은 볼트는 이 순서가 필요 없다.
healthcheck 스탬프와 ENGINE_VERSION, deny zone 가드(deny-guard.py)와 PowerShell 구문
분석기(ps-parse.ps1)의 스탬프는 engine=0.46.0이다. 규칙 6종, Aside 도우미, 교훈 단서 훅,
git 훅은 내용이 같아 기존 스탬프를 유지한다. 볼트에 설치된 he...
v0.45.1 — 검색 근거 관찰과 교훈 평가
v0.45.1 — 검색 근거 관찰과 교훈 효과 평가
검색에 일치하는 기록이 있어도 질문에 필요한 조건이 실제 문맥에 모두 들어 있다는
뜻은 아니다. 이번 버전은 실제 recall 출력에서 작성자가 선언한 근거의 노출을 관찰하고,
검색 범위·출력 누락·상충 근거를 나누어 평가하는 선택형 도구를 추가한다.
v0.45.0 후보에서 수정한 시험 경로
macOS 임시 폴더의 /var 경로는 /private/var로 연결될 수 있다. 두 정상 입력 시험이
이를 반영하지 않아 엄격한 연결 경로 거부에 걸렸다. 시험이 소유한 임시 루트에
Path.resolve()를 적용했고, 연결 부모는 거부하며 실제 경로는 읽는 회귀 시험을 추가했다.
별칭 임시 폴더 환경에서 해당 두 시험을 하위 프로세스로 다시 실행하는 회귀도 포함한다.
런타임 읽기 정책을 느슨하게 하지 않았다. 이전 후보 태그를 다시 쓰지 않는다.
변경
- 검색 근거 관찰:
assess_support(recalled, contract)는
실제로 출력된 출처와 줄의 정확한 문구를 선언한 필수 항목·상충 항목과 비교한다.
문서 제목 일치나 결과 목록에만 있고 출력에서 빠진 근거를 충족으로 세지 않는다.
여러 필수 항목은 모두 필요하고 항목 안 대안은 하나만 관찰돼도 된다. - 실제 검색 평가: 새 합성 볼트에서 실제 recall을
실행한다. 어휘 혼동, 여러 기록에 흩어진 조건, 누락·상충, 줄 선택과 출력 예산,
512KiB 전후 UTF-8 파일을 측정한다. 잘못된 any-match 대조군과 구별한다. - 교훈 관찰 비교: 명시적으로 입력한 교훈 없음·힌트·가드
관찰 기록에서 비교 조건과 짝·근거·시점·누락을 검사한다. 첫 시도·재시도·최종 작업
결과·불필요한 중단·측정된 사용량을 분리한다. 기본 예시는 scripted 데모다. - Claude/Codex 설치의 필수 리소스 바이트 확인과 CI에 새 도구를 연결한다.
유지되는 동작과 경계
기본 recall 반환값·정렬·훅·설정 템플릿은 바꾸지 않는다. 단일 파일 512KiB 상한과
불완전 검색 표시는 유지된다. 구간 읽기, 새 검색 알고리즘, 벡터 DB, 모델 판정 게이트는
추가하지 않는다. 기존 구조화 기억의 조건·시간·권한과 온톨로지 검사는 그대로다.
관찰은 호스트가 선언한 literal quotation의 출력 여부다. 의미적 충분성, 원문의 현재성,
진실, 행동 권한을 인증하지 않는다. 부정 근거의 부재는 부정 명제의 근거가 아니다.
교훈 기록의 해시와 caller-reported 실제 호스트 표지는 실행의 진위를 인증하지 않는다.
시뮬레이션과 실제 호스트 관찰을 합쳐 효과를 주장하지 않으며 인과적 효과를 증명하지 않는다.
도구가 모델·명령·호스트를 자동 실행하지 않고, 사용자 볼트를 평가 대상으로 자동 읽지 않는다.
참고와 기존 활용의 차이
| 자료 | 고정 근거와 이번 활용 | 기존 활용과의 관계 |
|---|---|---|
| RULER, COLM 2024 · NVIDIA/RULER | Apache-2.0 코드가 공개된 합성 길이·복수 값·변수 연결 평가. 이 버전은 원본 합성 기록과 실제 recall 경로로 응용하며 코드·외부 데이터는 복사하지 않음 | 공개 대장과 조사한 기존 기록에서 미발견. hsiehjackson/RULER는 이전 주소, 규칙 배포 도구 intellectronica/ruler와 다름 |
| NoLiMa, ICML 2025 · 라이선스 | 질문·근거의 낮은 어휘 중복과 literal distractor 설계만 참고 | 비상업 학술 연구·교육용 제한. 코드·needle·haystack·결과를 복사하지 않음 |
| Sufficient Context, ICLR 2025 · 공개 설명 | 관련 기록 존재와 질문 지원의 구분을 실제 recall 문맥의 명시적 필수 근거 관찰에 연결 | 과거 충분성 판정 검토의 후속 활용. 공개 저장소는 README와 이미지이며 실행 가능한 autorater·명시적 라이선스가 없음. 판정자 프롬프트·코드 복사나 모델 정확도 이전 없음 |
| lessons-learned | MIT. 비교 팔과 행동·최종 결과를 구별하는 평가 설계 참고 | v0.43.0의 hint/guard·예산·인용문 처리 참고를 재사용. 이번에는 관찰 기록의 비교 조건과 정직한 점수 집계로 확장하며 코드/시나리오 복사 없음 |
논문 성능은 당시 논문의 모델·자료에서 얻은 결과이며 플러그인 성능이 아니다.
RULER의 현행 main은 예전 실행 파이프라인에 deprecated를 표시한다. 2024 논문의
방법을 최신 브랜치의 성능이나 현재 모델의 능력으로 해석하지 않는다.
실행과 설치
python scripts/evaluate_recall_support.py
python scripts/evaluate_lesson_cue_effects.py
세부 입력과 결과 해석은 각 안내를 따른다. 새 도구와 API는 명시적으로 선택한다.
Python 3.10+ 표준 라이브러리를 유지하고 운영 의존성을 추가하지 않는다.
현재 설치 ref는 v0.45.1이다. 공개는 활성 설치 캐시 갱신이나 회사 볼트 upgrade가 아니다.
검증
검증 계약에 따라 최종 소스의 로컬 시험·독립 검토·CI·
실제 격리 설치 바이트·인증서·재빌드·자산을 별도로 확인한다. 실제 결과는 공개
verification.json에 기록하고 게시 후 확인은 별도 기록으로 보관한다. 과거 릴리스의
성공 수치를 이번 버전의 결과로 옮기지 않는다. 실제 호스트 교훈 효과는 아직 미측정이다.
v0.44.0 — 기록 보존·철회 문맥 전달
선택한 원문 기록의 보존 검사와 철회 자료의 외부 전달 차단을 보강했습니다.
- 문장 안의 관계 보존: 지정한 줄·문단 전체를 비교해 수량 바꿔치기, 부정 표현 추가, 예외 삭제를 검토 대상으로 표시합니다. 새 옵션을 생략하면 기존 결과를 유지합니다.
- 철회 자료의 재전달 방지: 설정된 철회 정책을 Jev·Jarvis의 실제 문맥 준비에 적용하고, 전달 직전과 응답 후 원본·정책·설정 변경을 재확인합니다. 이미 전송된 정보의 회수 기능은 아닙니다.
- 검증 보강: 기존 Hypothesis를 재사용해 순서가 달라지는 작업을 시험합니다. 모든 생성 시험은 실제 소비 경로를 관찰하며, 문맥을 읽지 못한 상태는 안전한 성공으로 계산하지 않습니다. 별도의 합성 16쌍에서 기록 검사와 기존 문자 검사를 같은 입력으로 비교합니다.
일반적인 의미 이해나 실제 모델의 오염 방어 성능을 보장하지 않습니다. 원문을 바꿔 표현한 경우 검토가 필요할 수 있으며, 지정하지 않은 기록과 미등록 사본은 검사 범위 밖입니다. Python 표준 라이브러리 기반 실행 환경을 유지합니다.
설계에 참고한 논문·기존 오픈소스 활용 차이와 한계는 릴리스 상세에 정리했습니다. 정확한 소스의 시험·CI·설치·재현 빌드 결과는 첨부 verification.json을, 배포본 체크섬은 SHA256SUMS를 확인하세요.
설치·회사 볼트 이관은 이번 공개와 별개입니다.