pr / done (pull_request) Successful in 3m28s
문제: :app-bootstrap:publicPathSnapshotTest(루트 verifyPublicPathSnapshot)는
빌드에 approvePublicPathChange가 있으면 publicpath.snapshot.write=true를
시험에 주었고, 시험은 기준선을 먼저 쓴 뒤 그 파일과 비교해 늘 통과했다.
project.hasProperty는 -P뿐 아니라 gradle.properties(저장소·GRADLE_USER_HOME),
ORG_GRADLE_PROJECT_ 환경 변수, GRADLE_OPTS의 -Dorg.gradle.project.에서도
참이라, 한 줄로 보안 기준선 게이트가 말없이 꺼졌다.
고른 방법: API surface 태스크와 같은 모양으로 나눈다. 비교 lane은 쓰기
스위치를 false로 고정하고, 실행 전(doFirst)에 셋 중 하나면 「read-only」로
실패한다. (1) 빌드에 승인 속성이 있다. (2) 시험 JVM이 받을
publicpath.snapshot.write가 false가 아니다. (3) 상속한 JAVA_TOOL_OPTIONS·
JDK_JAVA_OPTIONS·_JAVA_OPTIONS에 그 스위치가 있다. 고정값은 앞의 두
변수를 이긴다(JVM이 Gradle의 -D보다 먼저 읽는다). _JAVA_OPTIONS는 뒤에
읽혀 고정값을 이기므로(기준 main에서도 같은 빈틈) (3)이 막는다. main
단계 lane이라 up-to-date·캐시가 없어 mainCheck·releaseCheck마다 검사가
돈다. 쓰기는 새 Test 태스크 :app-bootstrap:publicPathSnapshotUpdate(루트
별칭 updatePublicPathSnapshot)가 같은 tag 시험을 쓰기 스위치를 켜고
돌린다. 승인 속성이 없으면 쓰기 전에 실패하고, 어떤 단계에도 들지
않으며, 매번 다시 돈다.
버린 대안: 쓴 뒤 「기준선을 다시 썼다, 커밋하라」로 실패시키기 — 한 lane
안에서 통과·실패의 뜻이 갈려 lane 결과 판정과 섞인다. update를
explicitOnly strict lane으로 두기 — TEST lane은 캐시되어 쓰기를 건너뛸 수
있고 집계 태스크마다 안내가 찍힌다.
위험·한계: 승인 명령이 verifyPublicPathSnapshot -P…에서
updatePublicPathSnapshot -P…로 바뀐다. 승인 속성을 상시로 둔 파생 서비스는
mainCheck·releaseCheck가 실패한다(docs/upgrade/2026-11-round9-public-surface.md
5행). 기준선 머리 주석의 명령 한 줄만 바뀌고 경로 내용은 그대로다.
갱신 명령을 적은 곳(docs/build.md, be-security 스킬, 제거 표
docs/capability-status.md·build-logic/README.md)도 함께 고친다.
검증: desktop 공유 잠금 아래 detached worktree, --no-build-cache.
변이 = gradle.properties의 approvePublicPathChange=true + SecurityConfig의
requestMatchers("/v1/admin/**").permitAll() 한 줄.
- RED(기준 96c0b4c7): 변이에서 verifyPublicPathSnapshot rc=0, 기준선에
permitAll 줄이 덧붙었다. permitAll + _JAVA_OPTIONS로 쓰기 스위치를 준
것도 rc=0(JAVA_TOOL_OPTIONS·JDK_JAVA_OPTIONS는 rc=1).
- GREEN(이 커밋 트리 3958ac3e):
- 변이 없음 verifyPublicPathSnapshot rc=0.
- 변이, -P, ORG_GRADLE_PROJECT_ 각각 rc=1 「is read-only」.
- permitAll + 세 JVM 옵션 변수 각각 rc=1 「is read-only」.
- 빌드 스크립트가 쓰기 스위치를 true로 덮으면 rc=1 「is read-only」.
- permitAll만 rc=1 「surface changed」.
- 승인 없는 updatePublicPathSnapshot rc=1, 기준선 그대로.
- updatePublicPathSnapshot -PapprovePublicPathChange rc=0, 새 줄이
들어가고 이어서 verifyPublicPathSnapshot rc=0.
- scripts/ci/verify-configuration-cache.sh rc=0.
- scripts/verify.sh(트리 3958ac3e, 「HEAD 트리와 같음」): desktop leaf
:app-bootstrap --no-cache rc=0(tests=330 failures=0), desktop pr
--no-cache rc=0(tests=7329 failures=0), 노트북 docs rc=0.
BREAKING CHANGE: 공개 경로 스냅숏 갱신은 ./gradlew updatePublicPathSnapshot
-PapprovePublicPathChange다. verifyPublicPathSnapshot·mainCheck·releaseCheck는
approvePublicPathChange가 어디서든 켜져 있으면 실패한다.
Refs: REV-BE-0011