From 05d0de766c5133d1d43a32beff4351497e083ec5 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 6 Nov 2026 22:05:30 +0900 Subject: [PATCH 1/2] =?UTF-8?q?docs(review):=20r10=20=ED=99=95=EC=9D=B8=20?= =?UTF-8?q?=EB=A6=AC=EB=B7=B0=20round7=EC=9D=84=20=EC=98=81=EC=97=AD=20?= =?UTF-8?q?=EB=8B=A4=EC=84=AF=EC=9C=BC=EB=A1=9C=20=EA=B8=B0=EB=A1=9D?= =?UTF-8?q?=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: r10(6e992970)은 round6 결함 25건을 고친 커밋 하나로 +5,143줄이다. 확인 리뷰 상한(추가 1,500줄, docs/work/improve.md 4.4절)을 넘어, 수정이 새로 만든 결함을 영역마다 따로 봐야 했다. 방법: 영역 pathspec 다섯(01 core·inbound +1056, 02 멱등성 +407, 03 persistence +877, 04 build-logic 셸 판독 +659, 05 workflow 판독 +1288)으로 나눠 차례로 리뷰했다. build-logic은 한 묶음이 +1,916줄이라 둘로 갈랐다. 의심 결함은 desktop 임시 worktree의 탐침으로 확인했다. r9(45d2a478)에 같은 탐침을 돌려 회귀인지 가렸다. 버린 대안: 커밋 전체를 한 문서로 보는 것(상한 위반), 리뷰 기록 round6(+829줄)까지 읽는 것. 결과: Critical 0, Important 0, 회귀 1. 결함 5건 모두 Minor. RR7-01-01 설정에 중첩된 JAX-RS 자원·@ServerEndpoint를 놓침(회귀), RR7-01-02 메서드 참조 route 설정의 거짓 실패, RR7-03-01 ledger IT의 없는 예외 장치 안내, RR7-03-02 REINDEX SCHEMA|DATABASE CONCURRENTLY 설명 오류, RR7-05-01 경로 필터 workflow를 "매 변경"으로 셈. RR6 항목은 RR6-03-05만 부분이고 나머지는 닫혔다. 위험·한계: 라운드 끝 게이트와 실 Redis·실 PG 계약 lane은 다시 돌리지 않았다(17.2절 2c692554 결과가 마지막). leaf test 10개는 FROM-CACHE다. RR7-05-01은 경로 필터 정책을 소유자가 정해야 고칠 수 있다(18.3절). round6 Declined 30건이 처리 기록 없이 남아 멈춤 기준 2가 거짓이다. 검증: python3 scripts/check-review-index.py docs/reviews/2026-11-03-rereview rc=0(162건 모두 색인). check-work-docs.py --links(새 문서 6개) rc=0. desktop 탐침 4종 rc=0(~/t1-r10-review-logs/summary.txt), 탐침 코드는 공유 노트 rr7-probes/. architectureTest --rerun 229건, build-logic test --rerun 169건, persistence-jpa test 664건 실패 0. Refs: docs/reviews/2026-11-03-rereview/README.md 18절 --- docs/reviews/2026-11-03-rereview/README.md | 72 +++++++++ .../round7/01-core-inbound.md | 141 ++++++++++++++++++ .../round7/02-idempotency-outbound.md | 94 ++++++++++++ .../round7/03-persistence.md | 129 ++++++++++++++++ .../round7/04-build-logic-shell.md | 81 ++++++++++ .../round7/05-build-logic-workflow.md | 97 ++++++++++++ 6 files changed, 614 insertions(+) create mode 100644 docs/reviews/2026-11-03-rereview/round7/01-core-inbound.md create mode 100644 docs/reviews/2026-11-03-rereview/round7/02-idempotency-outbound.md create mode 100644 docs/reviews/2026-11-03-rereview/round7/03-persistence.md create mode 100644 docs/reviews/2026-11-03-rereview/round7/04-build-logic-shell.md create mode 100644 docs/reviews/2026-11-03-rereview/round7/05-build-logic-workflow.md diff --git a/docs/reviews/2026-11-03-rereview/README.md b/docs/reviews/2026-11-03-rereview/README.md index 84e7b67c..10a0cccf 100644 --- a/docs/reviews/2026-11-03-rereview/README.md +++ b/docs/reviews/2026-11-03-rereview/README.md @@ -403,3 +403,75 @@ Minor 중 RR5-01-01(`IDEMPOTENCY_RECOVERY_REQUIRED`의 클라이언트 안내가 - GREEN: 03 동시 인덱스 검사기(`ConcurrentIndexMigrationInspectorTest`)와 손 포맷(persistence-jpa `spotlessCheck`), 01 `architectureTest` 228·`spotbugsArchitectureTest`(A5 최종본), optional ledger `check`를 게이트 전에 따로 돌렸다(1분 50초, rc=0). - 게이트 안에서 확인한 보고서 항목: `:app-bootstrap:documentContractTest` 65, `verifyEnvKeys`, `verifyJpaApiSurface`, `redisContainerContractTest` 78, `jpaPlatformContractTest` 407, `jpaPlatformMigrationTest` 45, 새 lane `postgresqlConcurrentIndexMigrationIntegrationTest` 4(`integrationCheck`에서 실행), `postgresqlMigrationLockWaitIntegrationTest` 36, `postgresqlNotificationSchemaActivationIntegrationTest` 8, `postgresqlIdempotencyIntegrationTest` 10, `messagingInboxRedeliveryIntegrationTest` 3, app-bootstrap `integrationTest` 10(`PostgreSqlIdempotencyProviderIntegrationTest` 포함), sample `integrationTest` 63(`SampleIdempotencyReplayIntegrationTest`·`SampleMigrationStreamIsolationTest` 포함), ledger `integrationTest` 46. 모두 실패 0. in-memory fake 계약의 skip 19는 시간 케이스(설계). - 다시 돌리지 않은 것: 각 묶음이 로컬에서 이미 확인한 RED(01의 gRPC·STOMP·GraphQL·shared-contract·shared 규칙, 02 표, 03, 04). r10-03 보고서가 적은 `:adapter:outbound:persistence-jpa:documentContractTest`는 없는 태스크다(그 lane은 app-bootstrap에만 있다). + +## 18. r10 확인 리뷰 round7 (2026-11-06) + +`6e992970`(r10)만 봤다. 기준 커밋 `06f520e6`(브랜치 `refactor/maturity-review-2026-11` 위, 그 사이 커밋은 문서·성능 lane이라 리뷰한 +파일을 바꾸지 않았다). 리뷰어 1명이 영역을 차례로 봤다. 영역 문서는 `round7/01~05`다. + +커밋 하나가 +5,143줄이라 확인 리뷰 상한(추가 1,500줄, `docs/work/improve.md` 4.4절)을 넘는다. 영역 pathspec으로 나눴다. 정확한 +pathspec은 각 영역 문서 「범위」에 있다. + +| 영역 | 대상 | `git diff --shortstat` | +|---|---|---| +| [01 core·inbound](round7/01-core-inbound.md) | shared-contract, inbound web·GraphQL·gRPC·WebSocket, app-bootstrap(Flyway 규칙 제외), 매뉴얼 07, runbook | 33 파일, +1056 −137 | +| [02 멱등성·outbound](round7/02-idempotency-outbound.md) | application-core, cache-redis, redis-runtime, PG 멱등성 store, 매뉴얼 05 | 15 파일, +407 −458 | +| [03 persistence](round7/03-persistence.md) | persistence-jpa(멱등성·lockfile 제외), persistence-notification, inbound messaging, grpc ledger, sample, Flyway 규칙, `docs/jpa`·매뉴얼 04·study | 28 파일, +877 −113 | +| [04 build-logic 셸 판독](round7/04-build-logic-shell.md) | `ShellScript`, `StrictLaneStagesPlugin`, TestKit 테스트, build-logic `build.gradle`·README | 5 파일, +659 −100 | +| [05 build-logic workflow 판독](round7/05-build-logic-workflow.md) | `WorkflowGradleInvocations`와 그 테스트, `GradleCommandLineTest`, AGENTS.md·CLAUDE.md·`src/README.md` | 6 파일, +1288 −101 | +| 공통 문서(영역마다 자기 행을 읽음) | `docs/upgrade/`, `docs/testing/`, 2026-11-01 README | 3 파일, +25 −14 | +| 보지 않음 | 리뷰 기록 `round6/*`·이 README 17절(+829), lockfile 2줄 | — | + +### 18.1 결과 + +Critical 0, Important 0, 회귀 1(RR7-01-01). 결함 5건, 모두 Minor. 이번 수정이 만든 것 3건, 이전부터 있던 것을 이번 수정이 넓히거나 새로 +약속한 것 2건(섞임). + +| ID | 심각도 | 내용 | 이번 수정 / 이전부터 | 증거 | +|---|---|---|---|---| +| RR7-01-01 | Minor(회귀) | 설정에 중첩된 클래스를 요청 처리기 목록으로만 보아, 설정 안의 JAX-RS 자원·`@ServerEndpoint`가 `@SystemCaller`를 불러도 잡히지 않는다. r9는 잡았다 | 이번 수정 | E2 탐침, 두 커밋 | +| RR7-01-02 | Minor | 메서드 참조로 route만 등록한 설정도 사용자 전송이라, 같은 설정이 handler bean을 등록하면 거짓 실패. Javadoc·매뉴얼 07·B-16의 "요청 처리 코드를 다른 클래스에" 안내와 다르다 | 이번 수정 | E2 탐침 | +| RR7-03-01 | Minor | ledger 잠금 대기 IT가 "이 테스트에 예외로 적으라"고 안내하지만 예외를 적을 곳이 없다 | 이번 수정 | E1 | +| RR7-03-02 | Minor | "Flyway는 `REINDEX … CONCURRENTLY`를 트랜잭션 안에서 돌린다"는 설명이 `REINDEX SCHEMA|DATABASE CONCURRENTLY`에서 틀린다(Flyway가 트랜잭션 밖에서 적용) | 섞임 | E3 실 PostgreSQL | +| RR7-05-01 | Minor | 메시지·B-36은 "매 push·pull request·schedule에 도는 workflow"를 요구하지만 판독기는 `paths:` 필터 workflow도 센다 | 섞임(동작은 이전부터, 약속은 이번 수정) | E2 탐침 | + +r10이 고쳤다고 한 항목의 재확인(영역 문서 「항목 재확인」): + +- 닫힘: RR6-01-01~09, RR6-02-01~05, RR6-03-01~04, RR6-04-01~06. +- 부분: RR6-03-05(설명을 고치며 RR7-03-01·02가 생김). + +색인 보완: 이 README가 ID 대신 내용으로만 적은 지난 발견 둘을 이름으로 적는다(`docs/work/evidence.md` 7절). RR-05-10(06 영역 발견 5건의 +색인 누락)은 1절 정정과 6.1절이, RR-07-05(CSRF 제외 규칙의 이유)는 6절 r4-f 행의 "RR-06-05+07-05"가 다룬다. + +### 18.2 실행 (2026-11-06, desktop) + +임시 worktree `~/workspace/t1-r10-review`(`06f520e6`)와 `~/workspace/t1-r10-review-r9`(`45d2a478`, r9 비교용)에 탐침을 얹어 +`flock /tmp/claude-gates/heavy.lock` 아래에서 차례로 돌렸다. 로그 `~/t1-r10-review-logs/`(desktop, `summary.txt`). 탐침 코드와 결과는 공유 노트 +폴더 `rr7-probes/`에 있어 고칠 때 fixture로 옮겨 쓸 수 있다. 끝나고 두 worktree를 지웠다. + +| 명령 | 대상 | 결과 | 시간 | 직전 부하(1분) | +|---|---|---|---|---| +| `:app-bootstrap:architectureTest --tests …Rr7ProbeTest` | `06f520e6` | rc=0(탐침 P1·P2 위반 없음, P3 위반) | 21초 | 4.58 | +| 같은 명령 | `45d2a478` | rc=0(P1·P2 위반, P3 위반 없음) | 20초 | 4.89 | +| `-p build-logic test --tests …Rr7WorkflowProbeTest` | `06f520e6` | rc=0(경로 필터 workflow를 셈) | 2초 | 4.66 | +| `:adapter:outbound:persistence-jpa:rr7ReindexProbe`(임시 lane, 실 PostgreSQL) | `06f520e6` | rc=0(REINDEX 다섯 형태 중 SCHEMA·DATABASE만 적용) | 19초 | 4.28 | +| `:shared-contract:test :application-core:test :adapter:outbound:redis-runtime:test :adapter:outbound:cache-redis:test :adapter:outbound:persistence-jpa:test :adapter:outbound:persistence-notification:test :adapter:inbound:messaging:test :adapter:inbound:web:test :adapter:inbound:grpc:test :adapter:inbound:graphql:test :adapter:inbound:websocket:test :app-bootstrap:architectureTest --rerun --continue` | `06f520e6` + 탐침 | rc=0. 실행: persistence-jpa `test` 664건, `architectureTest` 229건(탐침 1건 포함), 실패 0. 나머지 10개 `test`는 FROM-CACHE(같은 입력의 이전 실행 결과) | 47초 | 4.46 | +| `-p build-logic test --rerun` | `06f520e6` + 탐침 | rc=0, 169건 실패 0 skip 0(탐침 1건 포함) | 40초 | 3.69 | + +다시 돌리지 않은 것: 라운드 끝 게이트(`ci`, `mainCheck`, `integrationCheck`, `-p optional-platforms …`, compose)와 실 Redis·실 PG 계약 +lane. 마지막 실행은 17.2절의 `2c692554`다(이 리뷰에는 E0). + +### 18.3 결정이 필요한 것 + +| 항목 | 선택지 | 권하는 안과 이유 | 정할 사람 | +|---|---|---|---| +| RR7-05-01 경로 필터 workflow를 단계 실행으로 셀지 | (a) `paths:`·`paths-ignore:` trigger만으로는 세지 않는다 (b) 세고, 메시지·B-36의 "매 변경" 약속을 고친다 | (a). 단계 검사는 "모든 변경이 이 lane을 지난다"를 보장하려는 것이고, 경로 필터는 그 보장을 깬다. 이 repo의 단계 명령은 필터 없는 workflow에 있어 판정이 바뀌지 않는다. round6 04가 "저장소 정책"으로 판단하지 않은 항목이라 정책으로 닫는다 | 소유자 | + +### 18.4 멈춤 기준 상태 (`docs/work/improve.md` 4.5절) + +1. 마지막 확인 리뷰 발견 0: **아님.** 5건(18.1절). +2. 열린 「Declined to judge」 0: **아님.** + - round6 01~04의 Declined 30건이 17절 처리 표·결정에 배정되거나 닫힌 기록이 없다(03의 중첩 블록 주석 1건은 r10이 고쳤다). 영역 문서에 위치가 있다. + - round7의 Declined 12건(01: 3, 02: 2, 03: 2, 04: 2, 05: 3)은 각 영역 문서에 있다. 판단이 필요한 것은 02의 "같은 owner token·다른 operation id의 넘겨받기"(업그레이드 안내에 없는 동작 변경)와 03의 "`new FluentConfiguration()` 경로"다. +3. 합친 트리의 라운드 끝 게이트: r10 트리 `2c692554`에서 통과(17.2절). 이 리뷰는 다시 돌리지 않았다. +4. README의 남은 항목 0: **아님.** 위 1·2와 18.3절 결정. diff --git a/docs/reviews/2026-11-03-rereview/round7/01-core-inbound.md b/docs/reviews/2026-11-03-rereview/round7/01-core-inbound.md new file mode 100644 index 00000000..0c140fc5 --- /dev/null +++ b/docs/reviews/2026-11-03-rereview/round7/01-core-inbound.md @@ -0,0 +1,141 @@ +# 01 core·inbound r10 확인 리뷰 (2026-11-06) + +> 대상: `6e992970`(r10)의 r10-01 묶음. RR6-01-01~09 수정: 설정 안 요청 처리 코드 판정, record·enum·예외 +> 상위 타입, gRPC 취소·raw status 로그, 네 전송의 `IllegalArgumentException` WARN 한 줄, shared-contract 패키지 규칙. +> 기준 커밋 `06f520e6`(이 영역의 코드는 `6e992970` 뒤로 바뀌지 않았다). + +## 범위 + +### pathspec + +``` +src/shared-contract src/adapter/inbound/graphql src/adapter/inbound/grpc src/adapter/inbound/web src/adapter/inbound/websocket +src/app-bootstrap ':!src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/JpaProductionArchitectureTest.java' +docs/manual/07-authorization.md docs/runbooks/idempotency-unavailable.md +``` + +`git diff --shortstat 6e992970^ 6e992970 -- `: 33개 파일, +1056 −137. 커밋 하나가 +5,143줄이라 +`docs/work/improve.md` 4.4절대로 영역 pathspec으로 나눴다(README 18절). `JpaProductionArchitectureTest`(Flyway 규칙)는 03, +`web/README.md`의 503 행은 02에서 함께 봤다. + +함께 읽은 주변 코드: `ApplicationBoundaryArchitectureTest`의 `ARE_USER_TRANSPORT_TYPES`(`:471-491`)와 `45d2a478`(r9)의 같은 판정식, +`GraphQlWireErrorMapper.sharedCodeOf`, `ServerFailureLog.of`, `GrpcExceptionHandlingInterceptor` 전체, shared-contract 패키지 디렉터리, +매뉴얼 07 「시스템이 부르는 쓰기」·「규칙이 못 보는 길」, round6 RR6-01-01·02의 고치는 법. + +### 수정 보고의 「새로 가정하는 것」 + +README 17절 처리 표에는 이 칸이 없고 묶음 보고는 repo에 남지 않았다. 커밋 본문 「위험·한계」와 17절 「결정」 칸에서 뽑았다. + +| 가정 | 확인 | +|---|---| +| 설정 안의 endpoint는 `ARE_REQUEST_HANDLER_TYPES` 목록 타입에 의존한다 | 거짓인 경우가 있다. 목록에 JAX-RS와 주석형 JSR-356 endpoint가 없다. 그런데 이 목록이 이제 설정에 **중첩된** 클래스에도 쓰인다(RR7-01-01) | +| 설정이 요청 처리기 타입에 의존하면 그 설정 안에 요청 처리 코드가 있다 | 거짓인 경우가 있다. 메서드 참조로 route만 등록한 설정도 의존한다(RR7-01-02) | +| 네 전송의 IAE는 carrier 검사 뒤에만 `refusedArgument`로 간다 | 참. web `GlobalExceptionHandler.java:93-97`, GraphQL `GraphQlWireErrorMapper.java:133-139`, gRPC `GrpcExceptionHandlingInterceptor.java:133-141`(carrier 분기 뒤 `status.getCause()`), STOMP `StompHandlerFailureLog.java:34-43` | + +### 불러온 스킬과 적용한 기준 + +| 스킬 | 기준 | 본 것 | +|---|---|---| +| `superpowers:requesting-code-review` | 주장(README 17절 r10-01)과 구현이 맞는가, 테스트가 이름대로를 보는가, 심각도 보정, Declined to judge, 읽기 전용. 하위 에이전트는 repo 설정이 막아 diff를 여러 번에 나눠 직접 봤다 | 항목마다 닫힘 여부, 새 fixture가 막으려는 모양 밖에서 무엇이 바뀌었나 | +| `docs/work/reference/review-criteria.md` 7절 | 규칙 테스트는 위반·허용 fixture를 둘 다 가지나, 변이·탐침으로 확인 | 새 판정식을 r9 판정식과 같은 fixture에 돌림 | +| `docs/work/reference/defect-patterns.md` A1·A10 | 갈라진 복사본(두 타입 목록), 글로만 있는 규칙 | `ARE_USER_TRANSPORT_TYPES`와 `ARE_REQUEST_HANDLER_TYPES`의 차이 | + +### 실행한 명령과 결과 + +desktop(`ssh desktop`) 임시 worktree 두 개(`~/workspace/t1-r10-review` = `06f520e6`, `~/workspace/t1-r10-review-r9` = `45d2a478`)에 +탐침을 얹고 `flock /tmp/claude-gates/heavy.lock` 아래에서 돌렸다. 로그 `~/t1-r10-review-logs/`(desktop), 탐침 코드와 결과는 공유 노트 폴더 +`rr7-probes/`. + +| # | 명령 | 결과 | 직전 부하(1분) | +|---|---|---|---| +| 1 | `./gradlew :app-bootstrap:architectureTest --tests dev.caskeleton.bootstrap.architecture.Rr7ProbeTest` (`06f520e6`) | rc=0, 21초. 결과는 아래 표 | 4.58 | +| 2 | 같은 명령 (`45d2a478`, 같은 탐침) | rc=0, 20초 | 4.89 | +| 3 | `./gradlew :shared-contract:test … :adapter:inbound:web:test :adapter:inbound:grpc:test :adapter:inbound:graphql:test :adapter:inbound:websocket:test :app-bootstrap:architectureTest --rerun --continue` (`06f520e6`, 탐침 포함 트리) | README 18.2절 | README 18.2절 | + +탐침 `Rr7ProbeTest`는 `USER_TRANSPORTS_DO_NOT_REACH_SYSTEM_CALLERS`를 다섯 모양에 돌려 위반 여부를 파일에 적는다. + +| 탐침 | 모양 | `06f520e6` | `45d2a478` | +|---|---|---|---| +| P1 | `@Configuration` 안의 중첩 JAX-RS 자원(`@Path`·`@POST`)이 `@SystemCaller`를 부름 | 위반 없음 | 위반(`NestedJaxRsConfiguration$RunNowResource`) | +| P1c | 같은 자원을 최상위 클래스로(대조군) | 위반 | 위반 | +| P2 | `@Configuration` 안의 중첩 `@ServerEndpoint`·`@OnMessage`가 `@SystemCaller`를 부름 | 위반 없음 | 위반(`…$RunNowEndpoint`) | +| P3 | 한 설정이 메서드 참조 route(`orders::list`, 처리 코드는 `OrderHandler`)와 `@SystemCaller` bean을 함께 등록 | 위반(`MethodRefRouteConfiguration`) | 위반 없음 | +| P3c | 같은 route만 있는 설정(대조군) | 위반 없음 | 위반 없음 | + +### 못 본 것 + +- 멱등성 저장소·계약 변경은 02, Flyway 규칙(`JpaProductionArchitectureTest`)은 03에서 봤다. +- 실제 JAX-RS·JSR-356 런타임 기동: 이 템플릿에는 그 런타임이 없다(app-bootstrap `testCompileOnly 'jakarta.ws.rs:jakarta.ws.rs-api'`만). 탐침은 규칙 판정만 본다. +- `ARE_REQUEST_HANDLER_TYPES`에 빠진 타입을 모두 찾지는 않았다. 목록 방식의 한계는 매뉴얼 07 「규칙이 못 보는 길」에 적혀 있다. 아래 RR7-01-01은 그중 **r9가 잡던 것을 r10이 놓치게 된** 모양만 적는다. + +## 항목 재확인 + +| ID | 판정 | 근거 | +|---|---|---| +| RR6-01-01 (설정 안 함수형 endpoint 회귀) | 닫힘 | 람다 route·data fetcher를 가진 설정을 다시 사용자 전송으로 센다(`ApplicationBoundaryArchitectureTest.java:534-581`). 위반 fixture `RunNowRouteConfigurationFixture`·`RunNowDataFetcherConfigurationFixture`와 테스트 `aConfigurationWhoseFunctionalRouteCallsASystemCallerIsCaught`·`…DataFetcher…`. 다만 고친 방법이 중첩 클래스 판정을 좁혀 새 구멍(RR7-01-01)과 새 거짓 실패(RR7-01-02)를 만들었다 | +| RR6-01-02 (익명 configurer 필드 거짓 양성) | 닫힘 | 허용 fixture `SystemCallerBesideFieldReadingWebMvcConfigurerFixture`, 테스트 `aWebMvcConfigurerNestedInAConfigurationMayReadTheConfigurationsField`. 이 수정의 부작용이 RR7-01-01이다 | +| RR6-01-03 (record·enum·예외 거짓 양성) | 닫힘 | `ApplicationBoundaryArchitectureTest.java:741-809`, fixture 3개와 테스트 3개(`Runnable` record는 여전히 잡힘) | +| RR6-01-04 (gRPC 취소 판정) | 닫힘 | `GrpcExceptionHandlingInterceptor.java`의 `delegate.isCancelled()` 분기(`:143`), 테스트 `aFailureOnACallTheClientCancelledIsNotLogged`·`aCancelledStatusTheServiceClosesALiveCallWithIsLoggedAsUnhandled` | +| RR6-01-05 (던진 raw status 설명 로그) | 닫힘 | `failureBehind`가 status 예외를 건너뛴다. 테스트 `aThrownRawStatusIsLoggedByItsCodeWithoutItsDescription`·`…WithACauseIsLoggedWithTheCauseAlone` | +| RR6-01-06 (STOMP IAE ERROR) | 닫힘 | `ServerFailureLog.refusedArgument`를 네 전송이 쓴다. 테스트 4개(web·GraphQL·gRPC·STOMP)와 `ServerFailureLogTest` | +| RR6-01-07 (runbook 문구, RR6-02-03과 같음) | 닫힘 | `docs/runbooks/idempotency-unavailable.md:22-25`·`:102-105` | +| RR6-01-08 (GraphQL 테스트가 carrier 대신 IAE) | 닫힘 | `aClientSideCarrierIsNotLogged`가 `IdempotencyInFlightException`을 넣는다 | +| RR6-01-09 (shared-contract 규칙이 아무것도 못 잡음) | 닫힘 | 대상 `dev.caskeleton.shared..`, 목록 12개가 `src/shared-contract/src/main/java/dev/caskeleton/shared/`의 디렉터리와 같다(ls). 다른 leaf에 `dev.caskeleton.shared` 패키지는 없다(grep). 위반·허용 fixture와 목록 대조 테스트 `SharedContractPackageRuleTest` | + +## 결함 + +### RR7-01-01 · Minor · 설정에 중첩된 클래스를 요청 처리기 목록으로만 보아, 설정 안의 JAX-RS 자원·`@ServerEndpoint`가 `@SystemCaller`를 불러도 잡히지 않는다 (회귀) + +- **위치**: + - 코드: `src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ApplicationBoundaryArchitectureTest.java:574-577`(중첩 클래스도 `ARE_REQUEST_HANDLER_TYPES`), `:498-548`(목록에 `jakarta.ws.rs..`, `jakarta.websocket.server..`·`jakarta.websocket.OnMessage` 없음), `:471-491`(`ARE_USER_TRANSPORT_TYPES`에는 `jakarta.ws.rs..`·`jakarta.websocket..` 있음). + - 문서: `docs/manual/07-authorization.md:104`(표시 검사는 JAX-RS를 사용자 전송 타입으로 센다), `:105` ②. +- **무엇이 틀렸나**: + - r9는 설정 클래스 자신만 판정에서 뺐다. 설정에 중첩된 다른 클래스는 `ARE_USER_TRANSPORT_TYPES`로 봤다(`45d2a478`의 같은 파일 `:516-522`). + - r10은 설정에 중첩된 클래스도 설정처럼 `ARE_REQUEST_HANDLER_TYPES`로만 본다(RR6-01-02 고치는 법을 따랐다). + - 두 목록은 다르다. 요청 처리기 목록에는 JAX-RS(`jakarta.ws.rs..`)와 주석형 JSR-356 endpoint(`@ServerEndpoint`, `@OnMessage`)가 없다. 사용자 전송 타입 목록에는 둘 다 있다. + - 그래서 설정에 중첩된 JAX-RS 자원이나 `@ServerEndpoint`는 r9에서는 잡혔고 r10에서는 잡히지 않는다. 탐침 P1·P2가 두 커밋에서 반대로 나왔다. 최상위 클래스로 두면 r10도 잡는다(P1c). + - 두 목록이 왜 다른지 적힌 곳이 없다. Javadoc(`:520-532`)은 요청 처리기 목록을 "controller, route, servlet, filter, interceptor, WebSocket handler, GraphQL, gRPC"로 적고 JAX-RS를 말하지 않는다. +- **발생 조건·영향**: + - 조건: 파생 서비스가 JAX-RS나 주석형 JSR-356 endpoint를 쓰고, 그 endpoint 클래스를 작업 bean을 등록하는 설정 안에 중첩해 둔다. 이 템플릿에는 두 런타임이 없어서 드물다. + - 영향: 인증만 된 사용자 요청이 권한 검사 없는 `@SystemInvoked` 쓰기를 부른다. 빌드는 신호를 내지 않는다. RR3-01-01·RR6-01-01과 같은 피해다. + - Minor로 둔 이유: 두 전송 모두 템플릿에 없는 런타임이고, 중첩 위치까지 겹쳐야 한다. 다만 이 커밋이 만든 회귀라 따로 센다. +- **테스트가 못 본 이유**: 새 fixture는 `HandlerFunction`(목록에 있음)을 중첩한 모양 하나뿐이다. r9가 잡던 중첩 모양 가운데 목록 밖 타입을 쓴 것은 없다. +- **고치는 법**: + - 권장: 설정 클래스 **자신**만 `ARE_REQUEST_HANDLER_TYPES`로 보고, 중첩 클래스는 r9처럼 `ARE_USER_TRANSPORT_TYPES`로 본다. 대신 RR6-01-02 모양(익명 `WebMvcConfigurer`가 바깥 필드를 읽음)은 "바깥 설정 인스턴스(`this$0`)로 가는 의존만 있는 경로"를 빼는 식으로 따로 허용한다. 그러면 두 목록의 차이가 중첩 클래스에 새지 않는다. + - 대안 1: `ARE_REQUEST_HANDLER_TYPES`에 `jakarta.ws.rs..`, `jakarta.websocket.server..`, `jakarta.websocket.OnMessage`·`OnOpen`을 더한다. 간단하지만 두 목록이 계속 갈라질 수 있어(A1), 두 목록의 차이를 단언하는 테스트를 같이 둬야 한다. + - 대안 2: 요청 처리기 목록을 `ARE_USER_TRANSPORT_TYPES`에서 "설정용 타입"(`WebMvcConfigurer`, `CorsRegistry`, `…config.annotation..`)을 뺀 것으로 정의해 목록을 하나로 만든다. + - RED 테스트 모양: 탐침 P1·P2를 위반 fixture로 옮긴다(`rr7-probes/…/probe/rr7/NestedJaxRsConfiguration.java`, `NestedServerEndpointConfiguration.java`). `06f520e6`에서 위반 0으로 실패해야 한다. +- **이번 수정 / 이전부터**: 이번 수정(회귀). +- **증거**: E2 — 명령 1·2(탐침 P1·P1c·P2를 두 커밋에서 실행). 코드 경로는 E1. + +### RR7-01-02 · Minor · 메서드 참조로 함수형 route만 등록한 설정도 사용자 전송으로 세어, 같은 설정이 handler bean을 등록하면 거짓 실패한다 — Javadoc·매뉴얼은 "요청 처리 코드가 있을 때만"이라고 적는다 + +- **위치**: + - 코드: `ApplicationBoundaryArchitectureTest.java:525-527`(Javadoc "A configuration names one only when request-handling code is in it"), `:574-579`(설정이 `RouterFunctions` 같은 목록 타입에 의존하기만 하면 전송). + - 문서: `docs/manual/07-authorization.md:105`("요청 처리 코드는 handler를 등록하는 설정과 다른 클래스에 둔다"), `docs/upgrade/2026-11-maturity-review.md` B-16("요청 처리 코드는 handler를 등록하는 설정과 다른 클래스에 둔다"). +- **무엇이 틀렸나**: + - 설정이 `RouterFunctions.route().GET("/orders", orders::list)`처럼 메서드 참조로 route를 등록하면, 요청 처리 코드는 `OrderHandler`에 있고 설정에는 없다. + - 그래도 설정은 `org.springframework.web.servlet.function..` 타입에 의존하므로 사용자 전송이 된다. 같은 설정이 `@SystemCaller` bean을 `new`로 만들면 위반이다(탐침 P3). route만 있는 설정은 통과한다(P3c). + - Javadoc은 "요청 처리 코드가 있을 때만" 설정이 요청 처리기 타입을 부른다고 적는다. 매뉴얼과 업그레이드 안내는 "요청 처리 코드를 다른 클래스에 두라"고만 한다. 그대로 따라 처리 코드를 `OrderHandler`로 옮겨도 빌드는 실패하고, 메시지는 요청이 지나가지 않는 경로를 말한다. +- **발생 조건·영향**: 함수형 endpoint를 쓰는 서비스가 한 기능의 설정에 route 등록과 예약 작업 bean을 함께 둔다. Spring 문서가 보여 주는 route 등록 모양 그대로다. 빌드가 실패하는 쪽(거짓 실패)이라 데이터·권한 피해는 없다. 고치는 사람은 안내와 다른 이유로 막힌다. +- **테스트가 못 본 이유**: 허용 fixture는 `WebMvcConfigurer`와 controller bean 두 모양뿐이다. route를 등록하지만 처리 코드는 없는 설정의 fixture가 없다. +- **고치는 법**: + - 권장: 문서를 동작에 맞춘다. 매뉴얼 07 ②·B-16·Javadoc에 "함수형 route·data fetcher·interceptor를 **등록하는** 설정은 처리 코드가 다른 클래스에 있어도 사용자 전송이다. route 등록은 handler bean을 만드는 설정과 다른 설정에 둔다"를 적는다. 탐침 P3을 "걸리는" fixture로 남긴다. + - 대안: 판정을 좁힌다. 설정이 요청 처리기 타입에 의존해도, 설정 자신의 메서드(람다 본문 포함)가 `@SystemCaller` 쪽으로 가는 호출을 갖지 않으면 빼는 식이다. 정확하지만 ArchUnit 규칙이 복잡해지고, `@Bean` 메서드가 작업을 `new`하는 호출과 람다 안 호출을 구별해야 한다. + - RED 테스트 모양: 권장안이면 문서 변경이라 RED가 없다. 대안이면 P3을 허용 fixture로 두고 `06f520e6`에서 위반 1로 실패하는 것을 본다. +- **이번 수정 / 이전부터**: 이번 수정(r9에서는 설정을 통째로 뺐으므로 P3이 통과했다). +- **증거**: E2 — 명령 1·2(탐침 P3·P3c). 문서 대조는 E1. + +## Declined to judge + +- `ARE_REQUEST_HANDLER_TYPES`에 빠진 다른 타입(예: 리액티브 `org.springframework.web.server.WebFilter`·`WebHandler`): 이 템플릿은 서블릿 스택이고 WebFlux가 classpath에 없다. 목록 방식의 한계로 매뉴얼 07 `:128-129`가 적는다. RR7-01-01은 r9가 잡던 모양만 다룬다. +- gRPC: 취소된 호출에서 carrier나 IAE로 끝나면 여전히 로그가 남는다. 문서(`src/adapter/inbound/grpc/README.md`)는 "인식 못 한 실패"에 대해서만 취소를 빼므로 어긋나지 않는다. +- gRPC: 서비스가 raw status를 다른 예외로 감싸 던지면(`new IllegalStateException("…", statusException)`) 원인 사슬의 status 설명이 스택에 남는다. RR6-01-05가 약속한 것은 "서비스가 끝낸 raw status"라 범위 밖으로 봤다. 입력값 유출 정책을 넓힐지는 결정할 일이다. +- round6 01의 「Declined to judge」 7건이 README 17절에서 배정·결정으로 닫히지 않았다(README 18절 「멈춤 기준 상태」). + +## 결론 + +Critical 0, Important 0, 회귀 1(RR7-01-01). 결함 2건, 모두 Minor, 모두 이번 수정이 만들었다. + +- RR6-01-01~09는 모두 닫혔다. 주장한 fixture·테스트가 있고 이름대로 본다. +- 새 결함 둘은 RR6-01-01·02를 고친 방법에서 나왔다. 하나는 r9가 잡던 중첩 endpoint를 놓치는 회귀, 하나는 안내대로 해도 실패하는 거짓 실패다. diff --git a/docs/reviews/2026-11-03-rereview/round7/02-idempotency-outbound.md b/docs/reviews/2026-11-03-rereview/round7/02-idempotency-outbound.md new file mode 100644 index 00000000..0f353c58 --- /dev/null +++ b/docs/reviews/2026-11-03-rereview/round7/02-idempotency-outbound.md @@ -0,0 +1,94 @@ +# 02 멱등성·outbound r10 확인 리뷰 (2026-11-06) + +> 대상: `6e992970`(r10)의 r10-02 묶음. RR6-02-01~05 수정: 같은 attempt의 재claim이 lease 지난 claim과 재시도 가능 실패를 +> 넘겨받음, 시작 확인을 그 시작을 적용한 핸들로만, command fake의 시계·key TTL, 503 뜻과 매뉴얼 05 문구. +> 기준 커밋 `06f520e6`(이 영역의 코드는 `6e992970` 뒤로 바뀌지 않았다). + +## 범위 + +### pathspec + +``` +src/application-core src/adapter/outbound/cache-redis src/adapter/outbound/redis-runtime +src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/idempotency +docs/manual/05-idempotency.md +``` + +`git diff --shortstat 6e992970^ 6e992970 -- `: 15개 파일, +407 −458. 함께 본 것: `src/adapter/inbound/web/README.md`의 503 행, +`docs/upgrade/2026-11-maturity-review.md` 「멱등성(같은 attempt의 재시도, r10)」 행, `src/adapter/outbound/persistence-jpa/README.md`의 +멱등성 문단, `docs/study/postgresql-jpa-walkthrough.ko.md` 1720줄 근처의 판정 순서표. + +함께 읽은 주변 코드: `IdempotencyExecutor`의 claim·시작·재조정 분기 전체(`:126-232`), Redis `CLAIM`·`TRANSITION` 프로그램 전체 +(`IdempotencyScripts.java`), `PostgreSqlIdempotencyStore.claim`·`markExecutionStarted`, `InMemoryIdempotencyStore` 전체, +`InMemorySemanticRedisCommands`의 CLAIM·TRANSITION·RENEW·INSPECT 사본, 샘플 `PublishPosterImageUseCase:106`(요청마다 새 attempt). + +### 수정 보고의 「새로 가정하는 것」 + +| 가정 | 확인 | +|---|---| +| 같은 attempt를 두 호출이 **동시에** 쓰지 않는다(호출자 계약) | 문서화는 됐다: `IdempotencyClaimAttempt` Javadoc, 매뉴얼 05 `:77-79`, application-core README. 템플릿의 HTTP 경로는 요청마다 새 attempt를 만든다(샘플 `PublishPosterImageUseCase.java:106`). 계약을 어기면 두 번째 호출은 `NOT_CLAIMED` → 500 `IDEMPOTENCY_RECOVERY_REQUIRED`를 받고 작업은 두 번 돌지 않는다(E1, 아래 시나리오 3) | +| 시작이 적용된 기록의 revision은 그 시작을 낸 핸들 revision + 1뿐이다 | 참. 넘겨받기는 늘 revision을 올리고(`CLAIM`의 `rev + 1`, PG `resetClaim`), 시작 전에 revision을 바꾸는 다른 전이가 없다. renew는 실행 중에만 된다 | +| 넘겨받기 판정을 같은 attempt 재생보다 먼저 해도 지문 불일치·완료 재생 판정은 그대로다 | 참. 세 저장소 모두 지문 → 완료 → 포기 → 넘겨받기 → 같은 attempt 순서다(Redis `CLAIM`, PG `PostgreSqlIdempotencyStore.java:117-171`, fake `InMemoryIdempotencyStore.java:52-86`) | + +### 불러온 스킬과 적용한 기준 + +| 스킬 | 기준 | 본 것 | +|---|---|---| +| `superpowers:requesting-code-review` | 주장과 구현, 테스트가 이름대로 보는가, 읽기 전용 | RR6-02-01~05 닫힘, 바뀐 판정 순서가 다른 경로에 미치는 영향 | +| `docs/work/reference/defect-patterns.md` A4·A5·A6 | 결과 불명을 확실함으로, 경쟁을 코드 순서로, 주장하는 것을 보지 않는 테스트 | 같은 attempt의 늦은 시작·재생 핸들 시작이 작업을 두 번 돌리는 길이 남았나, 계약 케이스가 그 길을 보나 | + +### 실행한 명령과 결과 + +| # | 명령 | 결과 | 직전 부하(1분) | +|---|---|---|---| +| 1 | `./gradlew … :application-core:test :adapter:outbound:redis-runtime:test :adapter:outbound:cache-redis:test :adapter:outbound:persistence-jpa:test … --continue` (`06f520e6`, desktop) | README 18.2절 | README 18.2절 | + +실 Redis·실 PostgreSQL 계약 lane(`redisContainerContractTest`, `jpaPlatformContractTest`의 멱등성 계약, `postgresqlIdempotencyIntegrationTest`)은 +다시 돌리지 않았다. 17.2절의 `2c692554` 실행이 마지막이다(E0). 이 영역에서 결함을 찾지 못해 실 vendor로 확인할 의심이 없었다. + +### 따라간 시나리오 (E1) + +1. **시작을 거절당한 attempt의 재시도**: claim(rev r) → lease 지남 → 시작 `LEASE_EXPIRED`(503) → 같은 attempt 재claim → 세 저장소 모두 + `TakenOverClaimed`(attempt 2, rev r+1) → 시작 → 실행. 계약 `anAttemptWhoseStartWasRefusedTakesItsClaimOverWhenItClaimsAgain`. +2. **멈췄던 첫 호출의 늦은 시작**: 위 1의 넘겨받기 뒤 첫 호출이 rev r 핸들로 시작 → Redis `TRANSITION`은 상태가 목표와 같아도 rev가 + r+1이 아니면(넘겨받은 쪽이 시작했으면 r+2) `ALREADY`를 주지 않고 rev 검사로 `NOT_OWNER`. PG는 기록된 시작 digest가 다른 핸들의 것이라 + `classifyStartMismatch` → `NOT_OWNER`. 계약 `aLateStartThroughTheHandleBeforeTheTakeoverIsRefusedAsAStaleOwner`. +3. **같은 attempt의 두 번째 호출이 실행 중에 옴**: 재claim은 `ReplayedAcquire`(현재 핸들) → 시작 → `NOT_CLAIMED` → executor `default` + → 500. 전에는 Redis가 `ALREADY`로 작업을 한 번 더 돌렸다. 계약 `theSameAttemptStartingAnExecutionItAlreadyStartedIsToldItIsNotClaimed`. +4. **시작 응답을 잃은 호출의 같은 호출 안 회복**: `INDETERMINATE` → `inspect` → `EXECUTING_SAME_OPERATION` → `runStarted`. 바뀐 `ALREADY` + 조건은 같은 핸들(rev r → 기록 r+1)이라 그대로 확인된다. + +## 못 본 것 + +- 실 Redis·실 PostgreSQL에서의 재실행(위 설명). +- 배포 중 섞인 버전(옛 인스턴스의 `TRANSITION`은 재생 핸들 시작에 `ALREADY`): round6 02의 Declined to judge에 이미 있다. README 17절에서 + 닫히지 않았다(README 18절). + +## 항목 재확인 + +| ID | 판정 | 근거 | +|---|---|---| +| RR6-02-01 (시작 거절 뒤 같은 attempt가 영원히 503) | 닫힘 | Redis `IdempotencyScripts.java` CLAIM의 넘겨받기 분기가 같은 owner 재생보다 앞, PG `PostgreSqlIdempotencyStore.java:141-160`, fake `InMemoryIdempotencyStore.java:71-84`, command fake 같은 순서. 계약 케이스 6개 추가(위 시나리오 1~3과 재시도 가능 실패·포기·지문) | +| RR6-02-02 (command fake 위 시간 케이스 skip) | 닫힘 | `RedisIdempotencyStoreContractTest`가 `elapse`를 `commands.advance`로 재정의, command fake의 hash TTL(`InMemorySemanticRedisCommands`의 `expireHashAfter`·`hash`). adapter 손 사본 20개 삭제는 "계약과 겹친 것"이라는 README 17절 설명을 따랐다(E0). 하나씩 계약 케이스와 대조하지는 않았다 | +| RR6-02-03 (runbook "message") | 닫힘 | 01의 RR6-01-07과 같은 문장. `docs/runbooks/idempotency-unavailable.md:22-25` | +| RR6-02-04 (503 뜻이 웹 매핑 표·인계 표에 없음) | 닫힘 | `src/adapter/inbound/web/README.md` 503 행, `docs/upgrade/2026-11-maturity-review.md` 프론트 인계 표 503 행 | +| RR6-02-05 (매뉴얼 05 첫 문장과 PG 항목 어긋남) | 닫힘 | `docs/manual/05-idempotency.md:57-61`이 저장소별로 나눠 적는다 | + +## 결함 + +없음. + +## Declined to judge + +- `InMemoryIdempotencyStore`는 시작 응답을 잃은 같은 핸들의 재시작(기록 rev r+1, 핸들 rev r)에 `NOT_OWNER`를 준다. 두 저장소는 + `ALREADY_STARTED_SAME_OPERATION`이다. fake는 응답 유실을 만들지 못하고 계약에 그 케이스가 없어 드러나지 않는다. 이 커밋 전부터이고, + fake와 저장소의 차이를 계약 밖에서 고칠지는 범위 밖이다. +- 같은 owner token에 다른 operation id로 온 claim이 재시도 가능 실패·lease 지난 claim을 만나면, 전에는 `OwnerOperationConflict`(500)였고 + 이제 넘겨받는다(넘겨받기가 같은 owner 판정보다 앞이 되어서). 아무것도 실행되지 않은 기록이라 안전하고, 계약에 이 경우 케이스가 없다. + 동작 변경으로 적어 둔다. 업그레이드 안내에는 없다. +- round6 02의 「Declined to judge」 6건이 README 17절에서 배정·결정으로 닫히지 않았다(README 18절 「멈춤 기준 상태」). + +## 결론 + +Critical 0, Important 0, 회귀 0. 결함 0건. RR6-02-01~05는 모두 닫혔다. 바뀐 판정 순서와 시작 확인 조건은 세 저장소·두 fake에서 +같고, 같은 attempt의 늦은 시작·재생 핸들 시작으로 작업이 두 번 도는 길은 남지 않았다(E1). 실 vendor 재실행은 하지 않았다. diff --git a/docs/reviews/2026-11-03-rereview/round7/03-persistence.md b/docs/reviews/2026-11-03-rereview/round7/03-persistence.md new file mode 100644 index 00000000..e41a5798 --- /dev/null +++ b/docs/reviews/2026-11-03-rereview/round7/03-persistence.md @@ -0,0 +1,129 @@ +# 03 persistence r10 확인 리뷰 (2026-11-06) + +> 대상: `6e992970`(r10)의 r10-03 묶음. RR6-03-01~05 수정: Flyway PostgreSQL 잠금을 세션 수준으로(module-defaults와 +> `FlywaySchemaPolicy.configure()`), 직접 `Flyway.configure()` 금지 규칙, 동시 인덱스 IT, 검사기의 `E'…'`·중첩 주석, +> Flyway 목록 고정 테스트, ledger Spotless, "Flyway는 늘 트랜잭션으로 감싼다" 설명 정정. +> 기준 커밋 `06f520e6`(이 영역의 코드는 `6e992970` 뒤로 바뀌지 않았다). + +## 범위 + +### pathspec + +``` +src/adapter/outbound/persistence-jpa ':!src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/idempotency' +':!src/adapter/outbound/persistence-jpa/gradle.lockfile' src/adapter/outbound/persistence-notification +src/adapter/inbound/messaging ':!src/adapter/inbound/messaging/gradle.lockfile' src/grpc src/sample-portfolio +src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/JpaProductionArchitectureTest.java +docs/jpa docs/manual/04-persistence.md docs/study +``` + +`git diff --shortstat 6e992970^ 6e992970 -- `: 28개 파일, +877 −113(lockfile 두 줄 제외). 함께 본 것: +`docs/upgrade/2026-11-maturity-review.md` 2절 15번과 「Flyway 잠금」 행. + +함께 읽은 주변 코드: 운영 코드에서 Flyway를 만드는 모든 곳(`grep org.flywaydb`의 main 6개 파일), `MigrationStartupRunner`, +`src/grpc/CLAUDE.md` 「Durable operation ledger adoption」(ledger는 서비스 Flyway에 위치를 더한다), Flyway 11.14.1 +`PostgreSQLAdvisoryLockTemplate`(`javap`), `LockWaitMigrationInspector` 전체, round6 03. + +### 수정 보고의 「새로 가정하는 것」 + +| 가정 | 확인 | +|---|---| +| Flyway가 잡은 연결은 실행 내내 그것의 것이다(Hikari 직접 연결) | 참. Spring Boot의 Flyway와 템플릿 스트림 모두 애플리케이션 `DataSource`(Hikari)를 받는다. Flyway는 한 연결로 잠그고 푼다. PgBouncer transaction 모드에서 깨진다는 한계는 `docs/jpa/migration-guide.md:27-31`에 적혔다 | +| 세션 잠금으로 바꿔도 잠금 대기 동작은 같다 | 참. Flyway 11.14.1은 두 방식 모두 `pg_try_advisory_[xact_]lock`을 `lockRetryCount`만큼 다시 시도한다(`PostgreSQLAdvisoryLockTemplate.lock`, `javap`). 무한 대기로 바뀌지 않는다 | +| 배포 마이그레이션 도구도 같은 값을 쓴다 | 이 repo 밖이라 확인할 수 없다. 업그레이드 안내 2절 15번과 가이드 `:24-25`가 시킨다 | +| 템플릿이 직접 만드는 Flyway는 모두 `FlywaySchemaPolicy.configure()`를 거친다 | 운영 코드는 참(멱등성·알림·sample 스트림, schema-per-tenant, inbox는 같은 값 사본). 규칙은 `Flyway.configure()`·`configure(ClassLoader)` 호출만 본다(아래 Declined) | + +### 불러온 스킬과 적용한 기준 + +| 스킬 | 기준 | 본 것 | +|---|---|---| +| `superpowers:requesting-code-review` | 주장과 구현, 문서가 동작과 맞는가 | RR6-03-01~05 닫힘, 새로 쓴 설명이 Flyway 실제 동작과 맞나 | +| `supabase-postgres-best-practices` 관점(잠금·마이그레이션) | 강한 잠금은 시간 제한, 동시 빌드는 트랜잭션 밖, 오래된 트랜잭션 확인 | 세션 잠금의 전제, CIC 대기 대상 | +| `docs/work/reference/defect-patterns.md` A2 | 문서와 코드 불일치 | 고친 설명 문장마다 Flyway 실제 동작과 대조 | + +### 실행한 명령과 결과 + +desktop 임시 worktree `~/workspace/t1-r10-review`(`06f520e6`), 공유 잠금 아래. 로그 `~/t1-r10-review-logs/`(desktop). + +| # | 명령 | 결과 | 직전 부하(1분) | +|---|---|---|---| +| 1 | `./gradlew :adapter:outbound:persistence-jpa:rr7ReindexProbe` — 탐침 `Rr7ReindexProbeIntegrationTest`를 임시 lane으로 등록(worktree의 `build.gradle`만 고침), 실 PostgreSQL(Testcontainers, `PostgreSqlReadinessSupport`) | rc=0, 19초. 결과는 아래 표 | 4.28 | +| 2 | `./gradlew … :adapter:outbound:persistence-jpa:test :adapter:outbound:persistence-notification:test :adapter:inbound:messaging:test … :app-bootstrap:architectureTest --rerun --continue` | rc=0. persistence-jpa `test` 664건 실패 0(실행, 임시 lane 때문에 캐시 아님), persistence-notification·messaging `test`는 FROM-CACHE, `architectureTest` 229건 실패 0(`--rerun`, 탐침 1건 포함) | 4.46 | +| 3 | `javap -c -p org.flywaydb.database.postgresql.PostgreSQLAdvisoryLockTemplate`(flyway-database-postgresql 11.14.1, 노트북 Gradle 캐시의 jar) | 세션 모드 `pg_try_advisory_lock` + `RetryStrategy` | — | + +탐침 1은 각 문장 하나만 든 `V1__reindex.sql`을 `.sql.conf` 없이 `FlywaySchemaPolicy.configure()`로 적용한다. Flyway가 트랜잭션 안에서 +돌리면 PostgreSQL이 `25001`로 거부하고, 트랜잭션 밖에서 돌리면 적용된다. + +| 문장 | 결과 | +|---|---| +| `REINDEX TABLE CONCURRENTLY probe` | 실패 `25001` (REINDEX CONCURRENTLY cannot run inside a transaction block) | +| `REINDEX INDEX CONCURRENTLY ix_probe_note` | 실패 `25001` | +| `REINDEX (CONCURRENTLY) TABLE probe` | 실패 `25001` | +| `REINDEX SCHEMA CONCURRENTLY public` | **적용됨**(Flyway가 트랜잭션 밖에서 돌림) | +| `REINDEX DATABASE CONCURRENTLY ` | **적용됨** | + +### 못 본 것 + +- `postgresqlConcurrentIndexMigrationIntegrationTest`·`postgresqlMigrationLockWaitIntegrationTest`·ledger `integrationTest`는 다시 돌리지 않았다. + 17.2절의 `2c692554` 실행이 마지막이다(E0). +- transaction 모드 PgBouncer 뒤의 실제 동작: 환경이 없다. 가이드의 설명은 Flyway 코드(한 연결로 잠그고 풂)와 맞는다(E1). + +## 항목 재확인 + +| ID | 판정 | 근거 | +|---|---|---| +| RR6-03-01 (CIC·REINDEX CONCURRENTLY가 Flyway 기본값에서 끝나지 않음) | 닫힘 | `persistence-jpa.yml:140-149`, `FlywaySchemaPolicy.java:115-127`, 스트림 5곳과 testkit `MigrationContractRunner`가 그것을 쓴다. inbox 사본은 `MessagingInboxSchemaStreamTest`가 값 대조. `JpaProductionArchitectureTest.everyProductionFlywayIsConfiguredThroughTheSchemaPolicy`. 실 PG IT 4건(17.2절, E0). 다만 고치며 쓴 설명 하나가 Flyway 동작과 다르다(RR7-03-02) | +| RR6-03-02 (`E'…\'…'` 문자열 판정) | 닫힘 | `LockWaitMigrationInspector.java`의 `opensEscapeString`·`endOfLiteral`, 테스트 `aLockAfterAnEscapeStringIsStillFound`(4 형태)·`aStatementFlywayRunsOutsideATransactionAfterAnEscapeStringIsNamed`. 중첩 주석(round6 Declined)도 `endOfBlockComment`로 함께 고쳤다 | +| RR6-03-03 (Flyway 목록에 문장이 더해지는 경우) | 닫힘 | `LockWaitMigrationInspectorTest.flywaysPostgreSqlParserStillHasTheStatementListTheInspectorCopied`가 `PostgreSQLParser`의 정적 패턴 전부를 고정한다(PR `ci`) | +| RR6-03-04 (ledger Spotless가 Sync 사본 검사) | 닫힘 | `src/grpc/grpc-operation-ledger-jpa/build.gradle:37-41` `targetExclude` | +| RR6-03-05 ("Flyway는 늘 트랜잭션으로 감싼다" 설명) | 부분 | 세 곳 모두 고쳤다(가이드 `:121-135`, 검사기 Javadoc, study 문서 `:1337-1367`). 새 문장이 "Flyway는 `REINDEX … CONCURRENTLY`를 트랜잭션 안에서 돌린다"로 넓게 적어 `SCHEMA`·`DATABASE` 형태에서 틀린다(RR7-03-02). ledger IT에 더한 안내는 없는 장치를 가리킨다(RR7-03-01) | + +## 결함 + +### RR7-03-01 · Minor · ledger 잠금 대기 IT가 동시 인덱스 파일을 "이 테스트에 예외로 적으라"고 안내하지만 예외를 적을 곳이 없다 + +- **위치**: + - 코드: `src/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerMigrationLockWaitIT.java:38-43`(Javadoc "Name such a file as an exception in this test"), `:98-104`(실패 메시지 "name it as an exception here"), `:69-72`(`migrationsAfterTheFirst()`는 V001 뒤 모든 파일, 거르는 목록 없음). +- **무엇이 틀렸나**: + - r10은 ledger 트리에 동시 인덱스 파일(트랜잭션 밖에서 도는 파일)이 생기면 이 IT가 `25001`로 실패할 때 안내를 붙였다(RR6-03-05). + - 안내는 "그 파일을 이 테스트에 예외로 적으라"다. 그러나 IT에는 예외 목록도, 파일을 거르는 장치도 없다. 매개변수는 트리의 V001 뒤 파일 전부다. +- **발생 조건·영향**: ledger에 `CREATE INDEX CONCURRENTLY` V004를 더하는 사람. IT가 실패하고, 메시지대로 하려면 테스트 구조를 새로 만들어야 한다. 무엇을 어떻게 빼야 하는지(빼도 되는 조건, 빼면 대신 무엇이 그 파일을 보나)는 안내에 없다. 거짓 실패 쪽이라 데이터 피해는 없다. +- **테스트가 못 본 이유**: ledger 트리에 지금 그런 파일이 없다. 안내는 오지 않을 실패에만 붙는다. +- **고치는 법**: + - 권장: IT에 "트랜잭션 밖에서 도는 파일" 목록(파일 이름과 이유)을 두고 `migrationsAfterTheFirst()`에서 뺀다. 그 목록의 파일은 `ConcurrentIndexMigrationInspector`의 두 검사(`.sql.conf`, 혼자인 문장)로 대신 본다. 메시지는 그 목록 이름을 가리킨다. + - 대안: 안내를 "이 IT는 그런 파일을 다룰 수 없다. 테스트에 거르는 장치를 더하는 변경이 필요하다"로 바꾼다. 장치를 만들지 않는 대신 기대를 바로잡는다. + - RED 테스트 모양: 임시 ledger 트리에 `V004__cic.sql`(+`.sql.conf`)을 두고 IT를 돌려 `25001` 실패를 본다. 권장안 뒤에는 목록에 이름을 넣으면 통과하고 inspector가 그 파일을 검사한다. +- **이번 수정 / 이전부터**: 이번 수정. +- **증거**: E1 — 코드 위치(grep으로 IT에 예외·제외 장치가 없음을 확인). 실행 탐침은 하지 않았다(ledger 트리를 바꿔야 해서 optional 빌드 integrationTest가 필요, 결함이 메시지의 사실 문제라 코드로 충분). + +### RR7-03-02 · Minor · "Flyway는 `REINDEX … CONCURRENTLY`를 트랜잭션 안에서 돌린다"고 적었지만 `REINDEX SCHEMA|DATABASE CONCURRENTLY`는 트랜잭션 밖에서 돌린다 + +- **위치**: + - 문서: `docs/jpa/migration-guide.md:122-125`("but not `REINDEX … CONCURRENTLY`, which it runs in the transaction for PostgreSQL to refuse"), `docs/study/postgresql-jpa-walkthrough.ko.md:1340-1342`("`REINDEX … CONCURRENTLY`는 모른다. 그 파일은 트랜잭션 안에서 돌고"). + - 코드: `src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/migration/ConcurrentIndexMigrationInspector.java:13-16`(Javadoc), `:54-57`(실패 메시지 "Flyway runs REINDEX ... CONCURRENTLY in one unless the migration says otherwise"). +- **무엇이 틀렸나**: + - Flyway 11의 트랜잭션 밖 목록에는 `^REINDEX( VERBOSE)? (SCHEMA|DATABASE|SYSTEM)`이 있다(`LockWaitMigrationInspectorTest.java:295`가 고정한 Flyway 패턴). 그래서 `REINDEX SCHEMA CONCURRENTLY`·`REINDEX DATABASE CONCURRENTLY`는 Flyway가 스스로 트랜잭션 밖에서 돌린다. + - 탐침 1: 그 두 문장은 `.sql.conf` 없이 적용됐다. `REINDEX TABLE|INDEX CONCURRENTLY`와 `REINDEX (CONCURRENTLY) TABLE`만 `25001`로 거부됐다. + - 문서·Javadoc·실패 메시지는 `REINDEX … CONCURRENTLY` 전체를 "Flyway가 모르는, 트랜잭션 안에서 도는" 문장으로 적는다. RR6-03-05가 고치려던 것과 같은 종류(Flyway가 언제 트랜잭션을 쓰는지에 대한 틀린 설명)다. 가이드의 "but not `REINDEX … CONCURRENTLY`"는 이전부터 있었고, r10이 "which it runs in the transaction"을 붙이고 같은 말을 검사기 Javadoc·메시지·study 문서로 넓혔다. +- **발생 조건·영향**: 행동 지시("동시 문장마다 `executeInTransaction=false`를 적는다")는 맞으므로 잘못된 배포로 이어지지 않는다. 틀린 것은 이유다. 검사기 메시지를 받은 사람이 `REINDEX SCHEMA CONCURRENTLY` 파일에서 "Flyway가 트랜잭션 안에서 돌린다"고 믿고 원인을 잘못 짚을 수 있다. `LockWaitMigrationInspector` Javadoc(`:150-151`, "`REINDEX TABLE CONCURRENTLY`는 목록에 없다")은 정확하다 — 같은 주제에 정확한 문장과 넓은 문장이 함께 있다. +- **테스트가 못 본 이유**: IT `flywayRunsReindexConcurrentlyInATransactionWherePostgresqlRefusesIt`는 `REINDEX TABLE CONCURRENTLY`만 본다. 문장은 문서·메시지라 대조하는 테스트가 없다. +- **고치는 법**: + - 권장: 네 곳을 "Flyway는 `REINDEX INDEX|TABLE … CONCURRENTLY`(괄호 옵션 형태 포함)를 트랜잭션 안에서 돌린다. `REINDEX SCHEMA|DATABASE|SYSTEM`은 `CONCURRENTLY`와 상관없이 트랜잭션 밖에서 돌린다"로 고친다. 행동 지시는 그대로 둔다. + - 대안: IT의 REINDEX 케이스를 탐침 1처럼 다섯 형태로 넓혀 Flyway 동작을 고정하고, 문서는 그 IT를 가리킨다. + - RED 테스트 모양: 대안을 쓰면 `REINDEX SCHEMA CONCURRENTLY public`이 "트랜잭션 안에서 거부된다"고 단언하는 케이스가 지금 실패한다(탐침 1 결과). +- **이번 수정 / 이전부터**: 섞임. 가이드의 "but not `REINDEX … CONCURRENTLY`"는 이전부터, "which it runs in the transaction"과 검사기 Javadoc·메시지·study 문서의 같은 문장은 이번 수정. +- **증거**: E3 — 명령 1(실 PostgreSQL, Flyway 11.14.1). 패턴은 E1. + +## Declined to judge + +- `JpaProductionArchitectureTest`의 Flyway 규칙은 `Flyway.configure()`·`Flyway.configure(ClassLoader)` 호출만 본다. `new FluentConfiguration()`·`new ClassicConfiguration()`으로 만든 Flyway는 지나간다. 문서(`persistence-jpa/CLAUDE.md:100-104`, 매뉴얼 04 `:122-124`)는 "`Flyway.configure()`를 부르면 실패한다"로 정확히 적는다. 생성자 경로를 막을지는 규칙 범위 결정이라 판단하지 않았다. +- 세션 잠금에서 연결이 끊기지 않은 채 unlock이 실패하면(Flyway가 "Unable to release PostgreSQL advisory lock"을 로그로만 남기는 경우) 잠금이 Hikari 풀의 연결에 남을 수 있다. Flyway 코드 경로로만 본 것이고 재현하지 않았다. 트랜잭션 잠금에는 없던 위험이다. 결정(Flyway 공식 옵션 채택)의 전제를 바꿀 만한 증거는 아니다. +- round6 03의 「Declined to judge」 10건 중 중첩 블록 주석은 r10이 고쳤고, 나머지 9건은 README 17절에서 배정·결정으로 닫히지 않았다(README 18절 「멈춤 기준 상태」). + +## 결론 + +Critical 0, Important 0, 회귀 0. 결함 2건, 모두 Minor. + +- 이번 수정: RR7-03-01(ledger IT의 없는 예외 장치 안내). +- 섞임: RR7-03-02(REINDEX 설명 — 이전부터 있던 넓은 문장을 이번 수정이 이유를 붙여 네 곳으로 넓힘). +- RR6-03-01~04는 닫혔고, RR6-03-05는 부분이다(위 두 결함). 세션 잠금 전제(한 연결, 재시도 대기)는 Flyway 코드와 맞는다. diff --git a/docs/reviews/2026-11-03-rereview/round7/04-build-logic-shell.md b/docs/reviews/2026-11-03-rereview/round7/04-build-logic-shell.md new file mode 100644 index 00000000..cf37c3c2 --- /dev/null +++ b/docs/reviews/2026-11-03-rereview/round7/04-build-logic-shell.md @@ -0,0 +1,81 @@ +# 04 build-logic 셸 판독 r10 확인 리뷰 (2026-11-06) + +> 대상: `6e992970`(r10)의 r10-04 묶음 중 셸 스크립트 판독(`ShellScript`)과 단계 검사 플러그인 쪽. RR6-04-03(조건부 `exit`·`exec`· +> `set -n`·`trap`), RR6-04-05(세지 않는 이유 셋과 실패 메시지). workflow 판독·Gradle 명령줄 쪽은 05다. +> 기준 커밋 `06f520e6`. 그 뒤 커밋 `e6b6e18e`가 같은 패키지의 `StrictTestLanePlugin`을 바꿨지만 이 pathspec의 파일은 바꾸지 않았다. + +## 범위 + +### pathspec + +``` +src/build-logic/src/main/java/dev/caskeleton/buildlogic/strictlane/ShellScript.java +src/build-logic/src/main/java/dev/caskeleton/buildlogic/strictlane/StrictLaneStagesPlugin.java +src/build-logic/src/test/java/dev/caskeleton/buildlogic/strictlane/StrictLaneStagesFunctionalTest.java +src/build-logic/build.gradle src/build-logic/README.md +``` + +`git diff --shortstat 6e992970^ 6e992970 -- `: 5개 파일, +659 −100. build-logic 묶음 전체는 +1,916줄이라 상한(1,500줄)을 넘어 +셸 판독(04)과 workflow 판독(05)으로 나눴다. 셸 모양의 테스트는 대부분 `WorkflowGradleInvocationsTest`에 있어(05 pathspec) 그 파일의 +셸 케이스도 함께 읽었다. + +함께 읽은 주변 코드: `ShellScript.java` 전체(1,659줄 중 `Evaluator`·`Parser`의 바뀐 곳과 그 호출자), `OPAQUE_COMMANDS`(`eval`·`source`·`.` +뒤의 디렉터리를 읽지 않음), round6 04의 RR6-04-03·05와 그 Declined. + +### 수정 보고의 「새로 가정하는 것」 + +| 가정 | 확인 | +|---|---| +| 스크립트가 0으로 끝날 수 있는 길은 `exit`·`exec`·`set -n`·`EXIT`/`ERR` trap과 그것을 부르는 함수다 | 남은 길(`eval "exit 0"`, `source`한 파일 안의 `exit`)은 `OPAQUE_COMMANDS`가 그 뒤 디렉터리를 "읽지 않음"으로 만들어 뒤 명령이 세어지지 않는다(거짓 실패 쪽). 거짓 통과로 새지 않는다(E1) | +| 리터럴이 아닌 `exit` 값은 0일 수 있다 | 판독기가 그렇게 본다(`exitsWithSuccess`). 거짓 실패 쪽 | +| 파이프 안·`( )`·`$( )` 안의 `exit`은 그 하위 셸만 끝낸다 | 참(bash에 `lastpipe`가 기본으로 꺼져 있음). 판독기는 그 경우를 건너뛴다(`walk`) | + +### 불러온 스킬과 적용한 기준 + +| 스킬 | 기준 | 본 것 | +|---|---|---| +| `superpowers:requesting-code-review` | 주장과 구현, 테스트가 이름대로 보는가 | RR6-04-03·05 닫힘 | +| `docs/work/reference/defect-patterns.md` A7 | 거짓 통과 게이트 | 새 분기마다 "세지 말아야 할 명령을 세는가"(거짓 통과)와 "셀 명령을 안 세는가"(설계상 허용된 거짓 실패)를 나눠 봄 | + +### 실행한 명령과 결과 + +| # | 명령 | 결과 | 직전 부하(1분) | +|---|---|---|---| +| 1 | `./gradlew -p build-logic test --rerun` (desktop `~/workspace/t1-r10-review`, `06f520e6` + 05의 탐침 1건) | rc=0, 40초, 169건 실패 0 skip 0 | 3.69 | + +### 따라간 모양 (E1) + +- 최상위 `exit 0` 뒤, `[ -z "$X" ] && exit 0` 뒤, `if …; then exit 0; fi` 뒤: 앞은 `terminated`, 뒤 둘은 `mayHaveEnded`로 뒤 명령을 세지 않는다. +- `./gradlew ci || exit`·`|| exit 1`: 인자 없는 `exit`은 실패 상태를 지키고, 그 명령은 "읽지 않음"(3번 이유)으로 남는다. +- `trap 'exit 0' EXIT`, `trap cleanup EXIT`(함수 안 인자 없는 `exit`), `trap 'exit' ERR`: 첫째와 셋째만 뒤 명령을 세지 않는다. EXIT trap의 인자 없는 `exit`은 상태를 지킨다는 판단은 bash 동작과 맞다. +- `exec > log 2>&1`(재지정만): 셸을 바꾸지 않으므로 끝내지 않는다고 본다. `exec ./gradlew ci`: 바꾼다. +- `set +o errexit`, `set -n`, `set -o noexec`, `set "$OPTS"`: 앞 둘은 읽고, 값이 펼쳐지는 `set`은 "알 수 없음"으로 errexit·noexec 둘 다 꺼졌을 수 있다고 본다. +- `echo | exit 0`: 파이프 안이라 하위 셸만 끝난다. 세는 데 영향 없음. +- 사용자 정의 `shell:` 템플릿(`bash {0}`처럼 `-e` 없는 것): `SHELLS` 표에 없는 이름이라 "읽지 않음"으로 남는다(05 `WorkflowGradleInvocations.java:155-159`, `:412-420`). + +## 못 본 것 + +- 실제 GitHub runner의 bash 동작: 실행할 수 없다. 판단은 bash 매뉴얼의 `exit`·`trap`·`set -e` 설명과 판독기 코드 대조다(E1). +- 이 repo의 실제 workflow 판정이 수정 전후 같다는 README 17절 주장("세는 명령 48개")은 다시 세지 않았다. 두 빌드의 `verifyStrictLaneStages --dry-run`은 17.2절 `2c692554`에서 통과했다(E0). + +## 항목 재확인 + +| ID | 판정 | 근거 | +|---|---|---| +| RR6-04-03 (맨 위 `exit`만 봄) | 닫힘 | `ShellScript.java`의 `effects`·`mayEnd`·`trap`·`endingIn`·`called`, 테스트(`WorkflowGradleInvocationsTest`의 조건부 `exit`·`exec`·`set -n`·함수 안 `exit`·EXIT/ERR trap 케이스) | +| RR6-04-05 (세지 않는 이유를 반대로 적음) | 닫힘 | 이유를 셋(실패를 막지 못함 / 돌지 않을 수 있음 / 판독기가 읽지 않음)으로 나눴다. `ShellScript` Javadoc `:25-56`, 각 이유 문구, `StrictLaneStagesPlugin.NOT_COUNTED`(`:61-75`), AGENTS.md·CLAUDE.md·`src/README.md`·`build-logic/README.md`·업그레이드 B-36이 같은 셋을 적는다. 단 `NOT_COUNTED`의 끝 문장은 05의 RR7-05-01 | + +## 결함 + +없음. + +## Declined to judge + +- 한 번 걸린 `trap 'exit 0' EXIT`를 `trap - EXIT`로 풀어도 판독기는 뒤 명령을 계속 세지 않는다. 거짓 실패 쪽이고 이 모양을 쓰는 workflow는 드물다. +- `kill $$`, `kill -TERM 0`처럼 셸을 신호로 끝내는 명령: 판독기가 보지 않는다. 신호로 끝난 단계는 실패로 끝나므로 거짓 통과가 아니다. +- round6 04의 「Declined to judge」 7건이 README 17절에서 배정·결정으로 닫히지 않았다(README 18절 「멈춤 기준 상태」). 그중 경로·브랜치 필터 항목은 05의 RR7-05-01과 겹친다. + +## 결론 + +Critical 0, Important 0, 회귀 0. 결함 0건. RR6-04-03·05는 닫혔다. 새 분기가 만드는 오판은 모두 "세지 않음"(거짓 실패) 쪽이고, 따라간 모양에서 +세지 말아야 할 명령을 세는 길은 찾지 못했다(E1). diff --git a/docs/reviews/2026-11-03-rereview/round7/05-build-logic-workflow.md b/docs/reviews/2026-11-03-rereview/round7/05-build-logic-workflow.md new file mode 100644 index 00000000..348ef811 --- /dev/null +++ b/docs/reviews/2026-11-03-rereview/round7/05-build-logic-workflow.md @@ -0,0 +1,97 @@ +# 05 build-logic workflow 판독 r10 확인 리뷰 (2026-11-06) + +> 대상: `6e992970`(r10)의 r10-04 묶음 중 workflow 판독(`WorkflowGradleInvocations`)과 Gradle 명령줄 쪽. RR6-04-01(작업 없이 끝나는 +> 옵션), RR6-04-02(옵션 표를 Gradle과 대조), RR6-04-04(Windows runner 기본 셸), RR6-04-06(요청형 trigger·`workflow_call`·`needs`). +> 셸 판독 쪽은 04다. 기준 커밋 `06f520e6`(이 pathspec의 파일은 `6e992970` 뒤로 바뀌지 않았다). + +## 범위 + +### pathspec + +``` +src/build-logic/src/main/java/dev/caskeleton/buildlogic/strictlane/WorkflowGradleInvocations.java +src/build-logic/src/test/java/dev/caskeleton/buildlogic/strictlane/WorkflowGradleInvocationsTest.java +src/build-logic/src/test/java/dev/caskeleton/buildlogic/strictlane/GradleCommandLineTest.java +AGENTS.md CLAUDE.md src/README.md +``` + +`git diff --shortstat 6e992970^ 6e992970 -- `: 6개 파일, +1288 −101. 함께 본 것: `docs/upgrade/2026-11-maturity-review.md` B-36, +`StrictLaneStagesPlugin.NOT_COUNTED`(04 pathspec), 이 repo의 `.github/workflows/*.yml` 15개의 trigger. + +### 수정 보고의 「새로 가정하는 것」 + +| 가정 | 확인 | +|---|---| +| change·release trigger(`push`, `pull_request`(+types), `pull_request_target`, `merge_group`, `schedule`, `release`)가 하나라도 있으면 그 workflow는 "매 변경에 돈다" | 거짓인 경우가 있다. `paths:` 필터가 붙은 trigger는 그 경로가 바뀔 때만 돈다. 그런데 실패 메시지·문서는 "매 push·pull request·schedule에 도는 workflow"에서 단계를 돌리라고 한다(RR7-05-01) | +| `workflow_call` workflow는 `uses: ./.github/workflows/`로 부르는 job을 통해서만 돈다 | 참. 다른 repo 표기(`owner/repo/.github/workflows/x.yml@ref`)로 같은 repo를 부르면 못 알아보지만 세지 않는 쪽(거짓 실패)이다 | +| 판독기의 Gradle 옵션 표는 실행 중인 Gradle의 `--help`와 같다 | 참. `GradleCommandLineTest`가 대조한다(이 실행에서 통과, 아래 명령 1) | + +### 불러온 스킬과 적용한 기준 + +| 스킬 | 기준 | 본 것 | +|---|---|---| +| `superpowers:requesting-code-review` | 주장과 구현, 문서·메시지가 동작과 같은가 | RR6-04-01·02·04·06 닫힘, 새 메시지가 시키는 것과 판독기가 세는 것 | +| `ci-cd-and-automation` | 게이트가 매 변경에 도는가 | trigger·필터·job 조건 | +| `docs/work/reference/defect-patterns.md` A2·A7 | 문서와 코드 불일치, 거짓 통과 게이트 | 판독기가 "돈다"고 보는 workflow의 범위 | + +### 실행한 명령과 결과 + +desktop 임시 worktree `~/workspace/t1-r10-review`(`06f520e6`), 공유 잠금 아래. 로그 `~/t1-r10-review-logs/`(desktop), 탐침 코드는 공유 노트 폴더 `rr7-probes/`. + +| # | 명령 | 결과 | 직전 부하(1분) | +|---|---|---|---| +| 1 | `./gradlew -p build-logic test --tests dev.caskeleton.buildlogic.strictlane.Rr7WorkflowProbeTest` | rc=0. 결과는 아래 | 4.66 | +| 2 | `./gradlew -p build-logic test --rerun` | rc=0, 40초, 169건 실패 0 skip 0(탐침 1건 포함) | 3.69 | + +탐침 `Rr7WorkflowProbeTest`는 `WorkflowGradleInvocations.read`에 두 workflow를 준다. + +| workflow | 읽은 결과 | +|---|---| +| `on: pull_request: paths: ["docs/**"]` + `push: branches: [main], paths: ["docs/**"]`, `run: ./gradlew ci` | `uncountedReason=null` — 실행으로 센다 | +| `on: workflow_dispatch`, 같은 step(대조군) | "its workflow starts only on workflow_dispatch … so it may not run" — 세지 않는다 | + +## 못 본 것 + +- 실제 GitHub의 trigger 해석(`paths` 필터, `types`, `needs`의 건너뜀): 실행할 수 없다. GitHub 문서 기준(E1). +- `--stop`·`--foreground`는 `GradleCommandLineTest`도 실행하지 않는다(데몬을 멈추거나 붙잡음). 표에 둔 근거는 Javadoc의 Gradle 소스 설명뿐이다(E0). + +## 항목 재확인 + +| ID | 판정 | 근거 | +|---|---|---| +| RR6-04-01 (작업 없이 끝나는 Gradle 옵션) | 닫힘 | `GRADLE_OPTIONS_THAT_RUN_NO_TASK`(`WorkflowGradleInvocations.java:134-143`), 묶음(`-qv`) 처리, 테스트 | +| RR6-04-02 (옵션 표를 지키는 테스트 없음) | 닫힘 | `GradleCommandLineTest`가 옵션 표 전체를 실행 중인 Gradle `--help`와 대조하고, 작업 없이 끝나는 옵션을 실제로 실행한다(`--stop`·`--foreground` 제외) | +| RR6-04-04 (Windows runner 기본 셸) | 닫힘 | `defaultShellReason`: `container:`가 있거나 `ubuntu-*`·`macos-*`·`linux`·`macos` 라벨일 때만 기본 셸을 bash로 읽는다. 식(`${{ matrix.os }}`)·Windows 라벨·라벨 없는 self-hosted는 세지 않는다 | +| RR6-04-06 (요청형 trigger·`workflow_call`·`needs`) | 닫힘 | `startReason`·`runsOnChanges`·`needsReason`, 테스트. 다만 고치며 쓴 메시지·문서가 새 약속을 했다(RR7-05-01) | + +## 결함 + +### RR7-05-01 · Minor · 실패 메시지와 문서는 "매 push·pull request·schedule에 도는 workflow"에서 단계를 돌리라고 하지만, 판독기는 `paths:` 필터로 일부 변경에만 도는 workflow도 센다 + +- **위치**: + - 코드: `src/build-logic/src/main/java/dev/caskeleton/buildlogic/strictlane/StrictLaneStagesPlugin.java:61-75`(`NOT_COUNTED` 끝: "in a step and job that run on every push, pull request or schedule"), `WorkflowGradleInvocations.java:44-55`(Javadoc "A workflow counts when one of its triggers is part of the change or release flow"), `:96-101`(`CHANGE_TRIGGERS`), `:620-627`(`runsOnChanges`는 trigger 이름과 `types`만 본다). + - 문서: `docs/upgrade/2026-11-maturity-review.md` B-36 할 일 칸("단계는 매 push·pull request·schedule에 도는 workflow와 job에서"). +- **무엇이 틀렸나**: + - r10은 "요청이 있어야 도는 workflow"를 세지 않게 하면서, 무엇이 "매 변경에 도는" workflow인지를 메시지와 문서에 처음 적었다: 매 push·pull request·schedule. + - 판독기는 trigger 이름과 `types`만 본다. `paths:`·`paths-ignore:` 필터는 읽지 않는다. + - 탐침: `pull_request`와 `push` 모두 `paths: ["docs/**"]`인 workflow의 `./gradlew ci`를 실행으로 센다. 이 workflow는 docs만 바뀐 변경에서만 돌고, 코드가 바뀐 PR에서는 돌지 않는다. + - 이 repo에도 `paths:` 필터가 있는 workflow가 7개 있다(`build-logic.yml`, `fileserver-pr.yml`, `link-check.yml`, `messaging-certification.yml`, `notification-platform.yml`, `object-storage-qualification.yml`, `redis-sdk-topology.yml`). 지금은 단계 명령을 거기서만 돌리지 않아 판정은 맞다. +- **발생 조건·영향**: 파생 서비스가 무거운 단계(`integrationCheck` 등)를 비용 때문에 `paths:` 필터 workflow로 옮긴다. 검사는 통과하고, 필터 밖 변경에서는 그 단계가 돌지 않는다. 메시지와 업그레이드 안내가 약속한 "매 변경"과 다르다. +- **테스트가 못 본 이유**: `WorkflowGradleInvocationsTest`의 trigger 케이스는 이벤트 이름·`types`·`workflow_call`·`needs`만 다룬다. 필터 케이스가 없다. +- **이번 수정 / 이전부터**: 섞임. 필터를 읽지 않는 동작은 이전부터다(round6 04 「Declined to judge」 첫 줄: "어떤 필터가 충분한지는 저장소 정책이라 판단하지 않았다"). "매 push·pull request·schedule"이라는 약속은 이번 수정이 메시지·문서에 썼다. +- **고치는 법** — 정책 선택이 먼저다(README 18절 「결정이 필요한 것」): + - 권장(a): `paths:`·`paths-ignore:`가 붙은 trigger는 "매 변경"이 아니므로 그 trigger만으로는 세지 않는다. 이유는 2번(돌지 않을 수 있음). `branches:` 필터는 기본 브랜치를 포함하면 센다. 이 repo의 단계 명령은 필터 없는 workflow에 있어 판정이 바뀌지 않는다. + - 대안(b): 동작은 두고 메시지·B-36을 "change trigger 중 하나로 시작하는 workflow(경로 필터는 보지 않는다)"로 고친다. 필터의 충분성은 저장소 책임으로 문서에 적는다. + - RED 테스트 모양: (a)면 탐침 workflow를 `WorkflowGradleInvocationsTest`에 넣고 `uncountedReason`이 null이 아님을 단언한다. `06f520e6`에서 실패한다(탐침 결과). +- **증거**: E2 — 명령 1(탐침). 이 repo workflow의 필터 목록은 E1(`grep -n "paths:" .github/workflows/*.yml`). + +## Declined to judge + +- `push: tags: ['v*']`만 있는 workflow(태그 push에만 돈다)도 change trigger로 센다. 릴리스 단계(`releaseCheck`)는 그런 workflow에서 도는 것이 맞아서 결함으로 보지 않았다. 다른 단계를 거기에만 두는 경우는 RR7-05-01과 같은 정책 질문이다. +- `runs-on`을 `group:` 매핑으로만 쓰고 `labels:`가 없는 job은 Windows일 수 있다고 보아 세지 않는다(거짓 실패 쪽, 메시지가 이유를 말함). +- 다른 repo 표기로 같은 repo의 재사용 workflow를 부르는 job: 위 「새로 가정하는 것」 둘째 줄. 거짓 실패 쪽. + +## 결론 + +Critical 0, Important 0, 회귀 0. 결함 1건(Minor, 섞임 — 동작은 이전부터, 약속은 이번 수정). RR6-04-01·02·04·06은 닫혔다. RR7-05-01은 +고치기 전에 소유자가 경로 필터 정책을 정해야 한다. From a9b6bcd52da0f9267d4708d9c408d6435a176a87 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 6 Nov 2026 22:31:07 +0900 Subject: [PATCH 2/2] =?UTF-8?q?docs(review):=20round7=EC=97=90=20=EB=8B=A4?= =?UTF-8?q?=EB=A5=B8=20=EB=A6=AC=EB=B7=B0=EC=9D=98=20=EB=B0=9C=EA=B2=AC?= =?UTF-8?q?=EA=B3=BC=20round6=20Declined=20=ED=8C=90=EC=A0=95=EC=9D=84=20?= =?UTF-8?q?=EB=8D=94=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 같은 커밋 6e992970을 따로 본 리뷰(claude/t1-baseline-7d623a 3add4917)가 이 리뷰에 없는 결함 셋을 찾았고 ID가 겹쳤다. 다른 세션이 코드 읽기로만 찾은 결함 후보(LockAcquisitionTimeoutException)가 남아 있었다. round6 「Declined to judge」 30건은 처리 기록이 없어 멈춤 기준 2가 거짓이었다. 방법: 넘겨받은 셋은 그쪽 근거를 읽고 이 리뷰의 기준 커밋 06f520e6에서 탐침을 다시 돌려 새 ID로 넣었다(RR7-01-03, RR7-03-03, RR7-03-04, 겹친 RR7-01-01은 합침, README 18.2절 대응표). 동시 인덱스 복구는 실패 이력 행 삭제를 더한 경우도 돌려 권하는 절차를 확인했다. 락 후보는 web· GraphQL 탐침으로 500 INTERNAL_ERROR를 확인해 RR7-01-04(Important)로 넣었다. round6 Declined 30건은 (a) 4 · (b) 24 · (c) 2로 판정해 (a)를 RR7-01-05·06, RR7-02-01, RR7-03-05로 올렸다. 소유자 결정 셋(RR7-05-01, RR7-03-03 복구, RR7-01-05 방향)을 18.4절 한 표로 모았다. 버린 대안: 다른 리뷰의 review.md를 그대로 합치기(같은 ID가 다른 결함을 가리킴). 결과: 결함 13건(Important 2, Minor 11, 회귀 1). 위험·한계: RR7-01-05·06, RR7-02-01, RR7-03-01·05는 코드 경로만(E1) 봤다. 라운드 끝 게이트는 다시 돌리지 않았다. round7 1차 Declined 12건은 아직 판정하지 않았다. (b) 2건은 t3·t5 브랜치가 병합돼야 닫힌다. 검증: check-review-index.py docs/reviews/2026-11-03-rereview rc=0(170건), check-work-docs.py --links(round7 6개 문서) rc=0. desktop 공유 잠금 아래 탐침 B1~B4(~/t1-r10-review-logs/summary.txt), 결과는 공유 노트 rr7-probes/results/pass2-06f520e6.txt. Refs: docs/reviews/2026-11-03-rereview/README.md 18절 --- docs/reviews/2026-11-03-rereview/README.md | 129 ++++++++++++++---- .../round7/01-core-inbound.md | 88 +++++++++++- .../round7/02-idempotency-outbound.md | 27 +++- .../round7/03-persistence.md | 71 +++++++++- .../round7/04-build-logic-shell.md | 2 +- .../round7/05-build-logic-workflow.md | 2 +- 6 files changed, 283 insertions(+), 36 deletions(-) diff --git a/docs/reviews/2026-11-03-rereview/README.md b/docs/reviews/2026-11-03-rereview/README.md index 10a0cccf..970ef6c0 100644 --- a/docs/reviews/2026-11-03-rereview/README.md +++ b/docs/reviews/2026-11-03-rereview/README.md @@ -412,6 +412,9 @@ Minor 중 RR5-01-01(`IDEMPOTENCY_RECOVERY_REQUIRED`의 클라이언트 안내가 커밋 하나가 +5,143줄이라 확인 리뷰 상한(추가 1,500줄, `docs/work/improve.md` 4.4절)을 넘는다. 영역 pathspec으로 나눴다. 정확한 pathspec은 각 영역 문서 「범위」에 있다. +같은 날 2차로 총괄이 세 가지를 더 맡겼다: 같은 커밋을 따로 본 리뷰의 발견 중 겹치지 않는 것(18.2절), 다른 세션이 코드 읽기로 찾은 결함 +후보 하나(RR7-01-04), round6 「Declined to judge」 30건 판정(18.5절). 2차 결함은 각 영역 문서의 「2차 추가 결함」 절에 있다. + | 영역 | 대상 | `git diff --shortstat` | |---|---|---| | [01 core·inbound](round7/01-core-inbound.md) | shared-contract, inbound web·GraphQL·gRPC·WebSocket, app-bootstrap(Flyway 규칙 제외), 매뉴얼 07, runbook | 33 파일, +1056 −137 | @@ -424,54 +427,126 @@ pathspec은 각 영역 문서 「범위」에 있다. ### 18.1 결과 -Critical 0, Important 0, 회귀 1(RR7-01-01). 결함 5건, 모두 Minor. 이번 수정이 만든 것 3건, 이전부터 있던 것을 이번 수정이 넓히거나 새로 -약속한 것 2건(섞임). +Critical 0, Important 2, Minor 11, 회귀 1. 결함 13건: 이번 수정이 만든 것 4건, 섞임 2건(이전부터 있던 것을 이번 수정이 넓히거나 새로 +약속함), 이전부터 7건. -| ID | 심각도 | 내용 | 이번 수정 / 이전부터 | 증거 | -|---|---|---|---|---| -| RR7-01-01 | Minor(회귀) | 설정에 중첩된 클래스를 요청 처리기 목록으로만 보아, 설정 안의 JAX-RS 자원·`@ServerEndpoint`가 `@SystemCaller`를 불러도 잡히지 않는다. r9는 잡았다 | 이번 수정 | E2 탐침, 두 커밋 | -| RR7-01-02 | Minor | 메서드 참조로 route만 등록한 설정도 사용자 전송이라, 같은 설정이 handler bean을 등록하면 거짓 실패. Javadoc·매뉴얼 07·B-16의 "요청 처리 코드를 다른 클래스에" 안내와 다르다 | 이번 수정 | E2 탐침 | -| RR7-03-01 | Minor | ledger 잠금 대기 IT가 "이 테스트에 예외로 적으라"고 안내하지만 예외를 적을 곳이 없다 | 이번 수정 | E1 | -| RR7-03-02 | Minor | "Flyway는 `REINDEX … CONCURRENTLY`를 트랜잭션 안에서 돌린다"는 설명이 `REINDEX SCHEMA|DATABASE CONCURRENTLY`에서 틀린다(Flyway가 트랜잭션 밖에서 적용) | 섞임 | E3 실 PostgreSQL | -| RR7-05-01 | Minor | 메시지·B-36은 "매 push·pull request·schedule에 도는 workflow"를 요구하지만 판독기는 `paths:` 필터 workflow도 센다 | 섞임(동작은 이전부터, 약속은 이번 수정) | E2 탐침 | +| ID | 심각도 | 내용 | 이번 수정 / 이전부터 | 출처 | 증거 | +|---|---|---|---|---|---| +| RR7-01-01 | Minor(회귀) | 설정에 중첩된 JAX-RS 자원·`@ServerEndpoint`가 `@SystemCaller`를 불러도 잡히지 않는다. r9는 잡았다 | 이번 수정 | 이 리뷰(다른 리뷰도 같은 결함) | E2 | +| RR7-01-02 | Minor | 메서드 참조로 route만 등록한 설정도 사용자 전송이라 handler bean과 같이 두면 거짓 실패. Javadoc·매뉴얼 07·B-16 안내와 다르다 | 이번 수정 | 이 리뷰 | E2 | +| RR7-01-03 | Minor | gRPC가 IAE를 원인으로 든 raw status를 던지면 `INTERNAL`·ERROR(메시지 첨부), `onError`로 넘기면 `BAD_PARAMETER`·WARN | 이전부터 | 다른 리뷰 | E2 | +| RR7-01-04 | Important | `LockAcquisitionTimeoutException`이 carrier가 아니고 처리기도 없어 409(재시도 가능) 대신 500 `INTERNAL_ERROR`(재시도 불가) | 이전부터 | 총괄 전달 후보 | E2 | +| RR7-01-05 | Minor | 감싼 carrier를 web·GraphQL·STOMP는 못 보고 gRPC만 찾아 응답 코드·로그가 전송마다 다르다 | 이전부터 | round6 01 Declined | E1 | +| RR7-01-06 | Minor | STOMP payload 변환·검증 실패를 ERROR와 예외 메시지(입력 조각)로 남긴다 | 이전부터 | round6 01 Declined | E1 | +| RR7-02-01 | Minor | httpclient `ClientRuntimeRegistry.close()`가 interrupt 상태면 drain 스레드 종료를 확인하지 않고 정상 반환 | 이전부터 | round6 02 Declined | E1 | +| RR7-03-01 | Minor | ledger 잠금 대기 IT가 "예외로 적으라"고 안내하지만 예외를 적을 곳이 없다 | 이번 수정 | 이 리뷰 | E1 | +| RR7-03-02 | Minor | "Flyway는 `REINDEX … CONCURRENTLY`를 트랜잭션 안에서 돌린다"가 `SCHEMA`·`DATABASE` 형태에서 틀린다 | 섞임 | 이 리뷰 | E3 | +| RR7-03-03 | Important | 실패한 동시 인덱스 복구를 "`DROP INDEX` 하나"로 안내하지만 `success=false` 이력 행이 다음 배포를 막고 runbook은 그 행 삭제를 금지 | 이전부터 | 다른 리뷰 | E3 | +| RR7-03-04 | Minor | "섞인 파일은 부분 적용되지 않는다"가 `.sql.conf`(`executeInTransaction=false`)를 붙이면 틀린다 | 이번 수정 | 다른 리뷰 | E3 | +| RR7-03-05 | Minor | 잠금 대기 검사기 Javadoc은 `VACUUM FULL`을 늘 거부한다지만 `executeInTransaction=true` 설정 파일에서는 통과 | 이전부터 | round6 03 Declined | E1 | +| RR7-05-01 | Minor | 메시지·B-36은 "매 push·PR·schedule"을 요구하지만 판독기는 `paths:` 필터 workflow도 센다 | 섞임 | 이 리뷰(round6 04 Declined와 같음) | E2 | r10이 고쳤다고 한 항목의 재확인(영역 문서 「항목 재확인」): - 닫힘: RR6-01-01~09, RR6-02-01~05, RR6-03-01~04, RR6-04-01~06. -- 부분: RR6-03-05(설명을 고치며 RR7-03-01·02가 생김). +- 부분: RR6-03-05(설명을 고치며 RR7-03-01·02·04가 생김). 색인 보완: 이 README가 ID 대신 내용으로만 적은 지난 발견 둘을 이름으로 적는다(`docs/work/evidence.md` 7절). RR-05-10(06 영역 발견 5건의 색인 누락)은 1절 정정과 6.1절이, RR-07-05(CSRF 제외 규칙의 이유)는 6절 r4-f 행의 "RR-06-05+07-05"가 다룬다. -### 18.2 실행 (2026-11-06, desktop) +### 18.2 출처 리뷰와 ID 대응 + +같은 커밋 `6e992970`을 다른 리뷰어가 따로 리뷰했다: 브랜치 `claude/t1-baseline-7d623a`, 커밋 `3add4917`, 파일 +`docs/reviews/2026-11-03-rereview/round7/review.md`(그 브랜치에만 있음), 매뉴얼 `docs/improvement/` 기준. 그 리뷰도 `RR7-NN-MM`을 썼고 번호가 +이 리뷰와 겹치지만 뜻이 다르다. 넘겨받은 발견은 그쪽 근거를 확인한 뒤 이 리뷰의 기준 커밋에서 탐침을 다시 돌렸다. + +| 다른 리뷰 ID | 이 리뷰 ID | 처리 | +|---|---|---| +| RR7-01-01 | RR7-01-01 | 같은 결함. 하나로 센다(01 문서 RR7-01-01에 한 줄) | +| RR7-01-02 | RR7-01-03 | 넘겨받음. 명령 B3으로 재현 | +| RR7-03-01 | RR7-03-04 | 넘겨받음. 명령 B4로 재현 | +| RR7-03-02(Important) | RR7-03-03(Important) | 넘겨받음. 명령 B4로 재현, 고치는 법의 SQL도 확인 | + +- 그 리뷰의 「Declined to judge」 중 경로 필터는 RR7-05-01, `new FluentConfiguration()` 경로·같은 owner token의 다른 operation id는 이 리뷰 + 1차 Declined(03·02 문서)와 같다. "설정이 `@CrossOrigin`·`RequestMethod`·`HttpServletRequest`를 쓰면 거짓 실패"는 RR7-01-02와 같은 모양이라 + 01 문서 RR7-01-02에 한 줄로 더했다. +- 두 리뷰 문서를 한 브랜치에 합치면 같은 ID가 다른 결함을 가리켜 색인 검사가 중복으로 보고한다. `round7/review.md`는 그대로 합치지 말고, + 출처 기록으로 그 브랜치에 두거나 위 표대로 번호를 바꿔 합친다. + +### 18.3 실행 (2026-11-06, desktop) 임시 worktree `~/workspace/t1-r10-review`(`06f520e6`)와 `~/workspace/t1-r10-review-r9`(`45d2a478`, r9 비교용)에 탐침을 얹어 `flock /tmp/claude-gates/heavy.lock` 아래에서 차례로 돌렸다. 로그 `~/t1-r10-review-logs/`(desktop, `summary.txt`). 탐침 코드와 결과는 공유 노트 -폴더 `rr7-probes/`에 있어 고칠 때 fixture로 옮겨 쓸 수 있다. 끝나고 두 worktree를 지웠다. +폴더 `rr7-probes/`(1차)·`rr7-probes/pass2/`(2차)에 있어 고칠 때 fixture로 옮겨 쓸 수 있다. 1차·2차 모두 끝나고 worktree를 지웠다. -| 명령 | 대상 | 결과 | 시간 | 직전 부하(1분) | -|---|---|---|---|---| -| `:app-bootstrap:architectureTest --tests …Rr7ProbeTest` | `06f520e6` | rc=0(탐침 P1·P2 위반 없음, P3 위반) | 21초 | 4.58 | -| 같은 명령 | `45d2a478` | rc=0(P1·P2 위반, P3 위반 없음) | 20초 | 4.89 | -| `-p build-logic test --tests …Rr7WorkflowProbeTest` | `06f520e6` | rc=0(경로 필터 workflow를 셈) | 2초 | 4.66 | -| `:adapter:outbound:persistence-jpa:rr7ReindexProbe`(임시 lane, 실 PostgreSQL) | `06f520e6` | rc=0(REINDEX 다섯 형태 중 SCHEMA·DATABASE만 적용) | 19초 | 4.28 | -| `:shared-contract:test :application-core:test :adapter:outbound:redis-runtime:test :adapter:outbound:cache-redis:test :adapter:outbound:persistence-jpa:test :adapter:outbound:persistence-notification:test :adapter:inbound:messaging:test :adapter:inbound:web:test :adapter:inbound:grpc:test :adapter:inbound:graphql:test :adapter:inbound:websocket:test :app-bootstrap:architectureTest --rerun --continue` | `06f520e6` + 탐침 | rc=0. 실행: persistence-jpa `test` 664건, `architectureTest` 229건(탐침 1건 포함), 실패 0. 나머지 10개 `test`는 FROM-CACHE(같은 입력의 이전 실행 결과) | 47초 | 4.46 | -| `-p build-logic test --rerun` | `06f520e6` + 탐침 | rc=0, 169건 실패 0 skip 0(탐침 1건 포함) | 40초 | 3.69 | +| # | 명령 | 대상 | 결과 | 시간 | 직전 부하(1분) | +|---|---|---|---|---|---| +| A1 | `:app-bootstrap:architectureTest --tests …Rr7ProbeTest` | `06f520e6` | rc=0(탐침 P1·P2 위반 없음, P3 위반) | 21초 | 4.58 | +| A2 | 같은 명령 | `45d2a478` | rc=0(P1·P2 위반, P3 위반 없음) | 20초 | 4.89 | +| A3 | `-p build-logic test --tests …Rr7WorkflowProbeTest` | `06f520e6` | rc=0(경로 필터 workflow를 셈) | 2초 | 4.66 | +| A4 | `:adapter:outbound:persistence-jpa:rr7ReindexProbe`(임시 lane, 실 PostgreSQL) | `06f520e6` | rc=0(REINDEX 다섯 형태 중 SCHEMA·DATABASE만 적용) | 19초 | 4.28 | +| A5 | `:shared-contract:test :application-core:test :adapter:outbound:redis-runtime:test :adapter:outbound:cache-redis:test :adapter:outbound:persistence-jpa:test :adapter:outbound:persistence-notification:test :adapter:inbound:messaging:test :adapter:inbound:web:test :adapter:inbound:grpc:test :adapter:inbound:graphql:test :adapter:inbound:websocket:test :app-bootstrap:architectureTest --rerun --continue` | `06f520e6` + 탐침 | rc=0. 실행: persistence-jpa `test` 664건, `architectureTest` 229건(탐침 1건 포함), 실패 0. 나머지 10개 `test`는 FROM-CACHE(같은 입력의 이전 실행 결과) | 47초 | 4.46 | +| A6 | `-p build-logic test --rerun` | `06f520e6` + 탐침 | rc=0, 169건 실패 0 skip 0(탐침 1건 포함) | 40초 | 3.69 | +| B1 | `:adapter:inbound:web:test --tests …Rr7LockTimeoutWebProbeTest` | `06f520e6` | rc=0(500 `INTERNAL_ERROR` `retryable=false`) | 9초 | 1.32 | +| B2 | `:adapter:inbound:graphql:test --tests …Rr7LockTimeoutGraphQlProbeTest` | `06f520e6` | rc=0(`INTERNAL_ERROR`) | 8초 | 1.73 | +| B3 | `:adapter:inbound:grpc:test --tests "…GrpcExceptionHandlingInterceptorTest.rr7probe*"` | `06f520e6` | rc=0(던짐 `INTERNAL`·ERROR+메시지, 넘김 `INVALID_ARGUMENT`·WARN) | 4초 | 2.01 | +| B4 | `:adapter:outbound:persistence-jpa:rr7CicProbe`(임시 lane, 실 PostgreSQL) | `06f520e6` | 첫 실행 rc=1(내 탐침 컴파일 오류), 고친 뒤 rc=0(섞임·복구 네 경우, 03 문서 표) | 3초 / 15초 | 2.01 / 2.66 | 다시 돌리지 않은 것: 라운드 끝 게이트(`ci`, `mainCheck`, `integrationCheck`, `-p optional-platforms …`, compose)와 실 Redis·실 PG 계약 lane. 마지막 실행은 17.2절의 `2c692554`다(이 리뷰에는 E0). -### 18.3 결정이 필요한 것 +### 18.4 결정이 필요한 것 | 항목 | 선택지 | 권하는 안과 이유 | 정할 사람 | |---|---|---|---| -| RR7-05-01 경로 필터 workflow를 단계 실행으로 셀지 | (a) `paths:`·`paths-ignore:` trigger만으로는 세지 않는다 (b) 세고, 메시지·B-36의 "매 변경" 약속을 고친다 | (a). 단계 검사는 "모든 변경이 이 lane을 지난다"를 보장하려는 것이고, 경로 필터는 그 보장을 깬다. 이 repo의 단계 명령은 필터 없는 workflow에 있어 판정이 바뀌지 않는다. round6 04가 "저장소 정책"으로 판단하지 않은 항목이라 정책으로 닫는다 | 소유자 | +| RR7-05-01(= round6 04 Declined ①) 경로 필터 workflow를 단계 실행으로 셀지 | (a) `paths:`·`paths-ignore:` trigger만으로는 세지 않는다 (b) 세고, 메시지·B-36의 "매 변경" 약속을 고친다 | (a). 단계 검사는 "모든 변경이 이 lane을 지난다"를 보장하려는 것이고 경로 필터는 그 보장을 깬다. 이 repo의 단계 명령은 필터 없는 workflow에 있어 판정이 바뀌지 않는다 | 소유자 | +| RR7-03-03 실패한 동시 인덱스 마이그레이션의 복구 절차 | (a) runbook에 "그 버전의 실패 이력 행만 지운다" 예외와 SQL(`DELETE FROM WHERE version = '' AND NOT success`)을 둔다 (b) 이 경우 `flyway repair`를 허용한다 (c) 동시 인덱스 마이그레이션을 금지하고 운영 절차로 돌린다 | (a). 실패 행은 적용되지 않은 버전의 기록이라 지워도 성공한 마이그레이션의 순서·checksum은 그대로다(명령 B4 넷째 경우로 재배포 성공 확인). (b)의 repair는 checksum·설명까지 다시 맞춰 가이드가 막으려는 불일치를 지운다. (c)는 r10이 이미 버린 대안이다(큰 테이블 인덱스 추가가 번거로워짐). "이력을 고치지 않는다" 정책의 예외라 소유자 확인이 필요하다 | 소유자 | +| RR7-01-05(= round6 01 Declined ①) 감싼 carrier를 전송이 어떻게 볼지 | (a) 네 전송 모두 원인 사슬의 첫 carrier를 본다 — web·GraphQL·STOMP에서 감싼 carrier의 응답이 500 → carrier 코드로 바뀐다 (b) 네 전송 모두 맨 위만 본다 — gRPC 응답이 carrier 코드 → `INTERNAL`로 바뀐다 (c) 차이를 두고 문서화한다 | (a). use case가 뜻한 코드로 답하고, persistence 실패의 SQL 원인이 어느 전송 로그에도 남지 않는다. gRPC가 이미 그렇게 해서 바뀌는 쪽이 셋이지만, 바뀌는 응답은 지금 500 `INTERNAL_ERROR`로 뭉개지는 경우뿐이다. 응답 코드가 바뀌는 수정이라 고치기 전에 확인받는다(`docs/work/improve.md` 7절) | 소유자 | -### 18.4 멈춤 기준 상태 (`docs/work/improve.md` 4.5절) +### 18.5 round6 「Declined to judge」 30건 판정 (2026-11-06) -1. 마지막 확인 리뷰 발견 0: **아님.** 5건(18.1절). +(a) 실제 결함 → round7 발견으로 넣음, (b) 결함 아님 → 닫음, (c) 소유자 결정 필요 → 18.4절. 번호는 round6 각 영역 문서 「Declined to judge」의 +순서다. 결과: (a) 4건(그중 1건은 RR7-01-01에 합침), (b) 24건, (c) 2건. + +| 영역 | # | 항목 | 판정 | 근거 | +|---|---|---|---|---| +| 01 | ① | 감싼 carrier를 전송마다 다르게 봄 | (c) → RR7-01-05 | 같은 규칙이 전송마다 갈라졌다(A1). 고치는 방향이 응답 코드를 바꿔 18.4절 | +| 01 | ② | dependency·5xx carrier를 원인 사슬째 남김 | (b) | 서버 실패를 원인과 함께 남기는 것이 정한 설계다(`ServerFailureLog.of`가 dependency·5xx carrier에 예외를 붙임). A8이 막는 것은 SQL 원인과 입력값이다. 자격 증명이 실리는 구체적 경로를 세우지 못했다 | +| 01 | ③ | GraphQL이 실패한 필드마다 한 줄 | (b) | 필드 단위 오류 설계의 결과다. 약속 위반이 없다 | +| 01 | ④ | 업그레이드 B-34가 템플릿 패키지 이름을 다시 나열 | (b) | 업그레이드 안내는 그 릴리스의 변경 기록이다. 정본은 `src/application-core/CLAUDE.md` 표이고 `TemplatePackageOwnershipDocumentTest`가 코드 사본과 대조한다 | +| 01 | ⑤ | STOMP 변환·검증 실패 ERROR | (a) → RR7-01-06 | 클라이언트 탓 실패를 ERROR와 입력 조각으로 남겨 A8을 어긴다 | +| 01 | ⑥ | RR6-01-01 고치는 법의 endpoint 목록 완전성 | (a) → RR7-01-01에 합침 | 목록이 사용자 전송 타입 목록보다 좁아 r9가 잡던 중첩 endpoint를 놓친다 | +| 01 | ⑦ | 규칙 탐침이 정적 `@ArchTest`만 돌림 | (b) | 방법 메모이고 결함 주장이 아니다. 메서드형 `@ArchTest`는 지금도 없다(architectureTest 전체 grep, `@ArchTest` 뒤 메서드 0) | +| 02 | ① | watchdog 스레드의 `inheritedAccessControlContext` | (b) | 템플릿은 실행 jar로 배포해 class loader가 하나다. 스레드는 마지막 예약 60초 뒤 끝난다. 공유 부모 loader 배포는 지원하는 형태가 아니다 | +| 02 | ② | `ClientRuntimeRegistry.close()`의 interrupt 처리 | (a) → RR7-02-01 | "돌아오면 스레드가 없다"는 Javadoc 약속이 interrupt 경로에서 확인 없이 깨진다(A14) | +| 02 | ③ | 배포 중 섞인 버전의 lease 지난 시작 | (b) | 배포 동안만이고 중복 실행이 없다(새 인스턴스는 옛 인스턴스가 시작한 기록을 넘겨받지 않는다) | +| 02 | ④ | `error-codes.yaml` `IDEMPOTENCY_UNAVAILABLE` `log_level` | (b) 다른 세션 처리 | `claude/t3-error-codes-loglevel-fcf427`에서 고침. 그 브랜치가 병합되면 닫힌다 | +| 02 | ⑤ | 시작 호출의 operation id가 claim과 다를 때 저장소 답이 다름 | (b) 다른 세션 처리 중 | `claude/t5-idempotency-operation-id-9bd973`에서 고치는 중. 병합 전까지 그 브랜치에서 열림 | +| 02 | ⑥ | in-memory fake가 lease를 모델링하지 않음 | (b) | RR-01-06 결정의 설계다(시간 케이스는 skip으로 보고). executor의 `LEASE_EXPIRED` → 503 매핑은 단위 테스트가 본다 | +| 03 | ① | 검사기의 10단어 셈이 Flyway와 다름 | (b) | 결과가 달라지는 입력이 없다(판정 단어가 첫 4개 키워드 안, 앞 괄호는 많아야 6단어) | +| 03 | ② | 중첩 블록 주석 | (b) r10이 고침 | `6e992970`: `LockWaitMigrationInspector.endOfBlockComment`, 테스트 `aStatementInsideANestedBlockCommentIsNotRead` | +| 03 | ③ | `executeInTransaction=true` + `SET LOCAL` + `VACUUM FULL` 통과 | (a) → RR7-03-05 | Javadoc의 "늘 거부"와 동작이 다르다(A2) | +| 03 | ④ | `REINDEX (CONCURRENTLY 'false')`를 동시로 판정 | (b) | 거부 쪽 오판이라 거짓 통과가 없고, 쓸 이유가 없는 입력이다 | +| 03 | ⑤ | `.sql.conf`의 placeholder·환경 변수에서 검사기 실패 | (b) | 거부 쪽이다. Flyway 치환 결과를 모른 채 통과시키지 않는 것이 맞는 방향이다 | +| 03 | ⑥ | Sync 사본과 IDE | (b) | 생성 소스의 일반 성질이다. IntelliJ 기본(Gradle 위임)에서는 Sync가 먼저 돈다 | +| 03 | ⑦ | persistence-jpa 디렉터리가 없는 파생 서비스 | (b) | 문서화된 capability 제거는 `runtimeOnly` 한 줄 제거이지 디렉터리 삭제가 아니다 | +| 03 | ⑧ | ledger V002 주석 "Flyway runs each migration in a transaction" | (b) | 적용된 마이그레이션은 고치지 않는다는 규칙이 정한다(`docs/work/reference/review-criteria.md` 9절, checksum). 틀린 설명은 r10이 가이드·검사기 Javadoc에서 바로잡았다 | +| 03 | ⑨ | `MessagingMigrationNamespaceTest` 정규식 | (b) | 소수 버전을 실패시키는 거부 쪽이라 조용히 빠지지 않는다 | +| 03 | ⑩ | `mixed=true`·전역 `executeInTransaction=false`를 쓰는 서비스 | (b) | 검사기 Javadoc과 가이드가 가정으로 적는다(약속 범위 밖으로 명시) | +| 04 | ① | 경로·브랜치 필터 trigger | (c) → RR7-05-01 | r10이 "매 변경"을 약속하며 정책 질문이 결함이 됐다. 18.4절 | +| 04 | ② | 설계상 거짓 실패 모양(`timeout ./gradlew`, `|| exit 1` 등) | (b) | README 16절 결정(거짓 실패 쪽을 받아들임) | +| 04 | ③ | `${{ }}` 값이 `--dry-run`·`|| true`로 펼쳐짐 | (b) | 실행 전 값을 알 수 없고, workflow 작성자가 자기 식으로 넣는 의도된 변경이다. 식 인자를 모두 세지 않으면 matrix 플래그마다 거짓 실패가 난다 | +| 04 | ④ | `CDPATH`·심볼릭 링크 | (b) | GitHub runner 기본 환경에 `CDPATH`가 없다 | +| 04 | ⑤ | composite action 안의 `run:` | (b) | 판독기가 읽지 않아 세지 않는 쪽(거짓 실패)이다 | +| 04 | ⑥ | httpclient 문서의 lane 이름·장애 주입 주기 | (b) 다른 커밋 처리 | `e6b6e18e`. 기준 커밋에서 `docs/httpclient/support-matrix.md:61`(`spring62ApiSurfaceScan`)·`:65`(main push, nightly)·`release-checklist.md:12`가 맞다 | +| 04 | ⑦ | 실제 GitHub runner·pwsh 동작 | (b) | 결함 주장이 아니라 실행 환경의 한계다. RR6-04-04는 코드·테스트로 닫혔다 | + +### 18.6 멈춤 기준 상태 (`docs/work/improve.md` 4.5절) + +1. 마지막 확인 리뷰 발견 0: **아님.** 13건(18.1절). 2. 열린 「Declined to judge」 0: **아님.** - - round6 01~04의 Declined 30건이 17절 처리 표·결정에 배정되거나 닫힌 기록이 없다(03의 중첩 블록 주석 1건은 r10이 고쳤다). 영역 문서에 위치가 있다. - - round7의 Declined 12건(01: 3, 02: 2, 03: 2, 04: 2, 05: 3)은 각 영역 문서에 있다. 판단이 필요한 것은 02의 "같은 owner token·다른 operation id의 넘겨받기"(업그레이드 안내에 없는 동작 변경)와 03의 "`new FluentConfiguration()` 경로"다. + - round6 30건은 모두 판정했다(18.5절). (b) 중 2건은 다른 브랜치(`claude/t3-error-codes-loglevel-fcf427`, `claude/t5-idempotency-operation-id-9bd973`)가 + 병합돼야 닫힌다. + - round7 1차 Declined 12건(01: 3, 02: 2, 03: 2, 04: 2, 05: 3)은 아직 판정하지 않았다. 각 영역 문서에 있다. 3. 합친 트리의 라운드 끝 게이트: r10 트리 `2c692554`에서 통과(17.2절). 이 리뷰는 다시 돌리지 않았다. -4. README의 남은 항목 0: **아님.** 위 1·2와 18.3절 결정. +4. README의 남은 항목 0: **아님.** 위 1·2와 18.4절 결정 3건. diff --git a/docs/reviews/2026-11-03-rereview/round7/01-core-inbound.md b/docs/reviews/2026-11-03-rereview/round7/01-core-inbound.md index 0c140fc5..4091701f 100644 --- a/docs/reviews/2026-11-03-rereview/round7/01-core-inbound.md +++ b/docs/reviews/2026-11-03-rereview/round7/01-core-inbound.md @@ -50,7 +50,7 @@ desktop(`ssh desktop`) 임시 worktree 두 개(`~/workspace/t1-r10-review` = `06 |---|---|---|---| | 1 | `./gradlew :app-bootstrap:architectureTest --tests dev.caskeleton.bootstrap.architecture.Rr7ProbeTest` (`06f520e6`) | rc=0, 21초. 결과는 아래 표 | 4.58 | | 2 | 같은 명령 (`45d2a478`, 같은 탐침) | rc=0, 20초 | 4.89 | -| 3 | `./gradlew :shared-contract:test … :adapter:inbound:web:test :adapter:inbound:grpc:test :adapter:inbound:graphql:test :adapter:inbound:websocket:test :app-bootstrap:architectureTest --rerun --continue` (`06f520e6`, 탐침 포함 트리) | README 18.2절 | README 18.2절 | +| 3 | `./gradlew :shared-contract:test … :adapter:inbound:web:test :adapter:inbound:grpc:test :adapter:inbound:graphql:test :adapter:inbound:websocket:test :app-bootstrap:architectureTest --rerun --continue` (`06f520e6`, 탐침 포함 트리) | README 18.3절 | README 18.3절 | 탐침 `Rr7ProbeTest`는 `USER_TRANSPORTS_DO_NOT_REACH_SYSTEM_CALLERS`를 다섯 모양에 돌려 위반 여부를 파일에 적는다. @@ -107,6 +107,7 @@ desktop(`ssh desktop`) 임시 worktree 두 개(`~/workspace/t1-r10-review` = `06 - RED 테스트 모양: 탐침 P1·P2를 위반 fixture로 옮긴다(`rr7-probes/…/probe/rr7/NestedJaxRsConfiguration.java`, `NestedServerEndpointConfiguration.java`). `06f520e6`에서 위반 0으로 실패해야 한다. - **이번 수정 / 이전부터**: 이번 수정(회귀). - **증거**: E2 — 명령 1·2(탐침 P1·P1c·P2를 두 커밋에서 실행). 코드 경로는 E1. +- **다른 리뷰와 합침**: 같은 커밋을 따로 본 리뷰(`claude/t1-baseline-7d623a` `3add4917`, `round7/review.md`의 RR7-01-01)가 같은 결함을 같은 모양(중첩 `@Path`·`@ServerEndpoint`, r9 위반 1건 → r10 0건)으로 찾았다. 그 리뷰는 WebFlux `WebFilter`·`WebHandler`도 같은 방식으로 빠진다고 적었다(E1). 결함 하나로 센다. ### RR7-01-02 · Minor · 메서드 참조로 함수형 route만 등록한 설정도 사용자 전송으로 세어, 같은 설정이 handler bean을 등록하면 거짓 실패한다 — Javadoc·매뉴얼은 "요청 처리 코드가 있을 때만"이라고 적는다 @@ -125,13 +126,14 @@ desktop(`ssh desktop`) 임시 worktree 두 개(`~/workspace/t1-r10-review` = `06 - RED 테스트 모양: 권장안이면 문서 변경이라 RED가 없다. 대안이면 P3을 허용 fixture로 두고 `06f520e6`에서 위반 1로 실패하는 것을 본다. - **이번 수정 / 이전부터**: 이번 수정(r9에서는 설정을 통째로 뺐으므로 P3이 통과했다). - **증거**: E2 — 명령 1·2(탐침 P3·P3c). 문서 대조는 E1. +- **같은 모양(2차)**: 다른 리뷰(`3add4917`)가 Declined로 적은 경우도 같은 원인이다. `ARE_REQUEST_HANDLER_TYPES`가 `org.springframework.web.bind.annotation..`·`jakarta.servlet.http..`를 패키지째 담아, `@CrossOrigin`·`RequestMethod`(CORS 설정에서 흔함)나 `HttpServletRequest`를 쓰는 설정이 handler bean을 함께 등록해도 거짓 실패한다(E1). 고칠 때 이 모양도 허용 fixture로 둔다. ## Declined to judge - `ARE_REQUEST_HANDLER_TYPES`에 빠진 다른 타입(예: 리액티브 `org.springframework.web.server.WebFilter`·`WebHandler`): 이 템플릿은 서블릿 스택이고 WebFlux가 classpath에 없다. 목록 방식의 한계로 매뉴얼 07 `:128-129`가 적는다. RR7-01-01은 r9가 잡던 모양만 다룬다. - gRPC: 취소된 호출에서 carrier나 IAE로 끝나면 여전히 로그가 남는다. 문서(`src/adapter/inbound/grpc/README.md`)는 "인식 못 한 실패"에 대해서만 취소를 빼므로 어긋나지 않는다. - gRPC: 서비스가 raw status를 다른 예외로 감싸 던지면(`new IllegalStateException("…", statusException)`) 원인 사슬의 status 설명이 스택에 남는다. RR6-01-05가 약속한 것은 "서비스가 끝낸 raw status"라 범위 밖으로 봤다. 입력값 유출 정책을 넓힐지는 결정할 일이다. -- round6 01의 「Declined to judge」 7건이 README 17절에서 배정·결정으로 닫히지 않았다(README 18절 「멈춤 기준 상태」). +- round6 01의 「Declined to judge」 7건은 2차에서 판정했다(README 18.5절). 그중 둘이 아래 RR7-01-05·06이 됐다. ## 결론 @@ -139,3 +141,85 @@ Critical 0, Important 0, 회귀 1(RR7-01-01). 결함 2건, 모두 Minor, 모두 - RR6-01-01~09는 모두 닫혔다. 주장한 fixture·테스트가 있고 이름대로 본다. - 새 결함 둘은 RR6-01-01·02를 고친 방법에서 나왔다. 하나는 r9가 잡던 중첩 endpoint를 놓치는 회귀, 하나는 안내대로 해도 실패하는 거짓 실패다. + +## 2차 추가 결함 (2026-11-06, 총괄 요청) + +총괄이 세 가지를 더 맡겼다. 같은 커밋을 따로 본 리뷰(`claude/t1-baseline-7d623a` `3add4917`)의 발견 중 이 리뷰와 겹치지 않는 것, 다른 세션이 +코드 읽기로만 찾은 결함 후보 하나, round6 01의 「Declined to judge」 판정. 넘겨받은 발견은 그쪽 근거를 읽은 뒤 이 리뷰의 기준 커밋 +`06f520e6`에서 탐침을 다시 돌려 확인했다. + +### 2차 실행 + +desktop 임시 worktree `~/workspace/t1-r10-review`(`06f520e6`, 다시 만들고 끝나고 지움), 공유 잠금 아래. 로그 `~/t1-r10-review-logs/`, +탐침 코드와 결과는 공유 노트 `rr7-probes/pass2/`·`rr7-probes/results/pass2-06f520e6.txt`. + +| # | 명령 | 결과 | 직전 부하(1분) | +|---|---|---|---| +| 4 | `./gradlew :adapter:inbound:web:test --tests …Rr7LockTimeoutWebProbeTest` | rc=0. `GlobalExceptionHandler.handleUnknown`이 `LockAcquisitionTimeoutException`에 500 `INTERNAL_ERROR` `retryable=false` | 1.32 | +| 5 | `./gradlew :adapter:inbound:graphql:test --tests …Rr7LockTimeoutGraphQlProbeTest` | rc=0. `GraphQlWireErrorMapper.masking()`이 같은 예외를 `INTERNAL_ERROR`·`INTERNAL`·`retryable=false`로 | 1.73 | +| 6 | `./gradlew :adapter:inbound:grpc:test --tests "…GrpcExceptionHandlingInterceptorTest.rr7probe*"` (다른 리뷰의 탐침을 결과를 파일로 쓰게 바꿔 기존 테스트 클래스에 끼움) | rc=0. 던짐: `INTERNAL`, ERROR 한 줄에 `IllegalArgumentException: unknown recipient alice@example.com` 첨부. 넘김: `INVALID_ARGUMENT`, WARN 한 줄(메시지 없음) | 2.01 | + +### RR7-01-03 · Minor · gRPC 서비스가 `IllegalArgumentException`을 원인으로 든 raw status를 던지면 `INTERNAL_ERROR`로 답하고 그 메시지를 ERROR로 남긴다 — 같은 status를 `onError`로 넘기면 `BAD_PARAMETER`·WARN이다 + +- **출처**: 다른 리뷰 `3add4917` `round7/review.md` RR7-01-02. 그쪽 근거(코드 경로·탐침)를 확인하고 명령 6으로 다시 재현했다. +- **위치**: + - 코드: `src/adapter/inbound/grpc/src/main/java/dev/caskeleton/adapter/inbound/grpc/GrpcExceptionHandlingInterceptor.java:137`(`status.getCause() instanceof IllegalArgumentException` — 던진 경우 원인 자리에는 status 예외가 있다), `:153`(`closeWithError`가 던진 예외 자체를 status의 원인으로 둔다), `:156-178`(`logUnrecognised`가 `failureBehind`로 status 예외를 벗겨 그 뒤의 IAE를 붙인다). + - 문서: `src/adapter/inbound/grpc/README.md:157-158`("`IllegalArgumentException`은 … WARN 한 줄 … 메시지 없음"), `:160`("raw status는 `onError`로 넘겼든 던졌든"), `src/shared-contract/README.md:94-98`("네 전송 모두 … 메시지는 … 남기지 않고 예외도 붙이지 않는다"). +- **무엇이 틀렸나**: + - `onError(Status.INVALID_ARGUMENT.withCause(iae).asRuntimeException())`는 `close(Status.fromThrowable(t))`가 되어 status의 원인이 IAE다. `BAD_PARAMETER`·WARN. + - 같은 예외를 던지면 원인 자리에 status 예외가 온다. `:137` 판정이 IAE를 보지 못해 `INTERNAL_ERROR`로 답한다. + - 이어서 r10의 `failureBehind`가 status 예외를 벗기고 IAE를 ERROR 줄에 붙인다. 입력값이 든 메시지가 로그에 남는다. +- **발생 조건·영향**: 입력 검증 실패를 `Status.INVALID_ARGUMENT.withCause(e).asRuntimeException()`로 던지는 서비스(grpc-java의 흔한 모양). 클라이언트는 재시도할 수 없는 `INTERNAL`을 받고, 서버 로그에 입력값이 ERROR와 스택으로 남는다. grpc 어댑터는 기본 조립에 없어 Minor. +- **테스트가 못 본 이유**: r10의 테스트는 원인이 `IllegalStateException`인 raw status와 원인 없는 raw status만 던진다. +- **고치는 법**: `close`에서 판정용 원인을 `failureBehind(status.getCause())`로 한 번 구해 carrier·IAE 판정과 로그에 같은 값을 쓴다. 대안: `closeWithError`가 던진 예외가 `StatusRuntimeException`·`StatusException`이면 그 status를 그대로 쓰고 원인은 status의 원인으로 둔다. RED: 명령 6의 탐침을 "던짐과 넘김의 status·로그 줄이 같다"는 단언으로 옮긴다. 지금 `INTERNAL ≠ INVALID_ARGUMENT`로 실패한다. +- **이번 수정 / 이전부터**: 이전부터. r9도 같은 답을 했다. r10이 RR6-01-05를 고치며 이 경로를 다시 썼는데 이 경우를 놓쳤다. +- **증거**: E2 — 명령 6. r9 동작은 다른 리뷰의 E1. + +### RR7-01-04 · Important · `LockAcquisitionTimeoutException`은 오류 코드를 운반하는 타입이 아니고 받는 처리기도 없어, 409 `LOCK_ACQUISITION_TIMEOUT`(재시도 가능) 대신 500 `INTERNAL_ERROR`(재시도 불가)로 답한다 + +- **출처**: 다른 세션이 코드 읽기로 찾은 후보(총괄 전달). 명령 4·5로 확인했다. +- **위치**: + - 코드: `src/application-core/src/main/java/dev/caskeleton/application/lock/LockAcquisitionTimeoutException.java:13`(`extends RuntimeException`만, `ApiErrorCarrier` 아님), `:6-11`(Javadoc "The web adapter maps it to 409"), `src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/error/GlobalExceptionHandler.java:195-202`(carrier가 아니면 `INTERNAL_ERROR`), GraphQL `GraphQlWireErrorMapper.java:199-206`(`sharedCodeOf`도 carrier만). + - 계약·문서: `docs/registries/error-codes.yaml:777-785`(409, `retryable: true`, `retry_after_seconds: 1`), `docs/runbooks/lock-acquisition-timeout.md:15`(증상 "HTTP 409 with `error.code=LOCK_ACQUISITION_TIMEOUT`"), `src/application-core/README.md:574-580`("web adapter 가 `errorCode()` + 고정 client-safe 메시지로 409 를 만든다"). + - 테스트: `src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/LockAcquisitionTimeoutClassificationContractTest.java:20-27`(Javadoc "D7 forbids collapsing a lock-acquisition timeout to a generic 500"), `:84-90`(예외의 `errorCode()`만 본다). +- **무엇이 틀렸나**: + - 예외는 `errorCode()` 메서드를 갖지만 `ApiErrorCarrier`를 구현하지 않는다. 전송들은 `ApiErrorCarrier`인지로만 코드를 읽는다. + - 이 예외를 받는 `@ExceptionHandler`도, GraphQL·gRPC 매핑도 없다(grep: main 코드에서 이 타입을 아는 곳은 던지는 persistence-jpa lock 둘과 지표 decorator뿐). + - 그래서 web은 500 `INTERNAL_ERROR` `retryable=false`(명령 4), GraphQL은 `INTERNAL_ERROR`(명령 5)로 답하고 "unhandled exception"으로 ERROR를 남긴다. gRPC도 carrier가 아니라 `INTERNAL`이다(E1). + - 레지스트리·runbook·Javadoc·README는 409 재시도 가능을 약속한다. 분류 계약 테스트는 "일반 500으로 뭉개지 않는다"(D7)를 이름에 걸지만 enum과 레지스트리 행만 본다. +- **발생 조건·영향**: + - 조건: 파생 서비스가 분산 lock capability(`DistributedLockPort.tryAcquire`)를 요청 처리 경로에서 쓰고 경합이 생긴다. 템플릿 자체의 운영 코드에는 호출자가 없다. + - 영향: 클라이언트는 재시도하면 될 경합을 재시도 불가 500으로 받는다. 운영자는 runbook대로 409를 찾지만 500 `INTERNAL_ERROR`와 "unhandled exception" ERROR만 보인다. 공개 계약(오류 코드 레지스트리)과 다른 응답이라 Important다. +- **테스트가 못 본 이유**: 분류 계약 테스트가 enum·레지스트리만 보고, 실제 전송 응답을 보는 테스트가 없다(A6 — 이름이 말한 성질을 단언하지 않음). +- **고치는 법**: + - 권장: `LockAcquisitionTimeoutException`이 `ApiErrorCarrier`를 구현한다(`errorCode()`의 반환 타입을 `ApiErrorCode`로). 그러면 네 전송이 따로 고치지 않아도 409·`Retry-After: 1`·4xx라 로그 없음으로 답한다. + - 대안: web에 전용 `@ExceptionHandler`를 둔다. web만 고쳐지고 GraphQL·gRPC는 그대로라 권하지 않는다. + - RED: 명령 4의 탐침을 `GlobalExceptionHandlerTest`에 "409·`LOCK_ACQUISITION_TIMEOUT`·`retryable=true`·`Retry-After`" 단언으로 옮긴다. 지금 500으로 실패한다. 분류 계약 테스트에 "예외가 `ApiErrorCarrier`다"를 더한다. +- **이번 수정 / 이전부터**: 이전부터(r10이 바꾼 파일이 아니다). +- **증거**: E2 — 명령 4·5. gRPC는 E1. + +### RR7-01-05 · Minor · 다른 예외에 감싼 carrier를 web·GraphQL·STOMP는 못 보고 gRPC만 원인 사슬에서 찾아, 같은 실패의 응답 코드와 로그가 전송마다 다르다 + +- **출처**: round6 01 「Declined to judge」 첫째 항목(README 18.5절 판정 (c)). 응답 코드가 바뀌는 수정이라 방향은 소유자 결정이다(README 18.4절). +- **위치**: web `GlobalExceptionHandler.java:195-198`(`ex instanceof ApiErrorCarrier`), GraphQL `GraphQlWireErrorMapper.java:200`, STOMP `StompHandlerFailureLog.java:34`, gRPC `GrpcExceptionHandlingInterceptor.java:180-192`(`carrierOf`가 원인 사슬을 따라감). 약속: `src/shared-contract/README.md` 「ServerFailureLog」("전송은 같은 줄을 쓴다", persistence 실패는 분류만). +- **무엇이 틀렸나**: 서비스가 `PersistenceFailureException`을 다른 예외로 감싸 던지면 web·GraphQL·STOMP는 500 `INTERNAL_ERROR`로 답하고 "unhandled"로 원인 사슬째(SQL 원인 포함) ERROR를 남긴다. gRPC는 감싼 carrier의 코드로 답하고 분류만 남긴다. 같은 규칙(실패 → 코드·로그)이 전송마다 다시 구현돼 갈라졌다(A1). web 쪽은 A8(SQL 원인을 로그에 싣지 않는다)도 어긴다. +- **발생 조건·영향**: use case나 adapter가 carrier를 감싸 던질 때. 템플릿 코드에는 그런 곳이 없다(round6 01 확인). 같은 실패에 클라이언트가 받는 코드가 전송마다 다르고, web 로그에 SQL 값·제약 이름이 남는다. +- **테스트가 못 본 이유**: 전송 테스트가 모두 맨 위 carrier만 넣는다. +- **고치는 법**: shared-contract에 "원인 사슬의 첫 carrier"를 찾는 함수 하나를 두고 네 전송이 쓴다(gRPC의 `carrierOf`를 옮김). 방향 선택지는 README 18.4절. RED: 네 전송 테스트에 감싼 `PersistenceFailureException`을 넣어 코드와 로그 줄이 같음을 단언한다. +- **이번 수정 / 이전부터**: 이전부터. +- **증거**: E1(네 전송의 판정 코드). 실행 탐침 없음 — 판정이 `instanceof` 한 줄이라 코드로 결정적이다. + +### RR7-01-06 · Minor · STOMP `@MessageMapping`의 payload 변환·검증 실패(`MessageConversionException`, `MethodArgumentNotValidException`)를 ERROR로, 예외 메시지(입력 조각)까지 남긴다 + +- **출처**: round6 01 「Declined to judge」 다섯째 항목(README 18.5절 판정 (a)). +- **위치**: `src/adapter/inbound/websocket/src/main/java/dev/caskeleton/adapter/inbound/websocket/stomp/StompHandlerFailureLog.java:32-45`(carrier·IAE가 아니면 `log.error("unhandled failure in a STOMP message handler", failure)`). 기준: `docs/work/reference/defect-patterns.md` A8("클라이언트 탓 실패(입력 오류)는 WARN 한 줄로 남기고 입력값을 싣지 않는다"). +- **무엇이 틀렸나**: payload를 읽지 못하거나 검증에 실패한 메시지는 클라이언트 탓 실패다. r10은 IAE만 WARN 한 줄로 바꿨고, 변환·검증 실패는 여전히 ERROR와 예외 전체로 남는다. Jackson 변환 실패 메시지는 받은 JSON 조각을 담는다. +- **발생 조건·영향**: 잘못된 JSON이나 검증에 걸리는 payload를 보내는 클라이언트마다 ERROR 한 줄과 스택이 남고, 입력 조각이 로그에 실린다. 경보가 ERROR에 걸리면 클라이언트 실수가 사고로 보인다. +- **테스트가 못 본 이유**: `StompHandlerFailureLogTest`에 변환·검증 실패 케이스가 없다. +- **고치는 법**: `MessageConversionException`·`MethodArgumentNotValidException`(Spring messaging)을 IAE와 같이 `BAD_PARAMETER`/`VALIDATION_FAILED`의 WARN 한 줄(타입만)로 남긴다. 프레임 응답은 그대로(보내지 않음). RED: 실제 `WebSocketAnnotationMethodMessageHandler`로 깨진 JSON payload를 보내 ERROR가 남는 것을 본다(round6 01 탐침 `Rr6StompProbeTest`의 모양). +- **이번 수정 / 이전부터**: 이전부터(r10이 같은 클래스에 IAE만 더함). +- **증거**: E1. 실행 탐침은 돌리지 않았다(Spring이 변환 실패를 `@MessageExceptionHandler`로 넘기는 경로는 round6 01이 같은 handler로 확인한 경로와 같다). + +### 2차 반영 뒤 결론 + +Critical 0, Important 1(RR7-01-04), 회귀 1(RR7-01-01). 결함 6건: 이번 수정 2(RR7-01-01·02), 이전부터 4(RR7-01-03~06). diff --git a/docs/reviews/2026-11-03-rereview/round7/02-idempotency-outbound.md b/docs/reviews/2026-11-03-rereview/round7/02-idempotency-outbound.md index 0f353c58..da77e813 100644 --- a/docs/reviews/2026-11-03-rereview/round7/02-idempotency-outbound.md +++ b/docs/reviews/2026-11-03-rereview/round7/02-idempotency-outbound.md @@ -41,7 +41,7 @@ docs/manual/05-idempotency.md | # | 명령 | 결과 | 직전 부하(1분) | |---|---|---|---| -| 1 | `./gradlew … :application-core:test :adapter:outbound:redis-runtime:test :adapter:outbound:cache-redis:test :adapter:outbound:persistence-jpa:test … --continue` (`06f520e6`, desktop) | README 18.2절 | README 18.2절 | +| 1 | `./gradlew … :application-core:test :adapter:outbound:redis-runtime:test :adapter:outbound:cache-redis:test :adapter:outbound:persistence-jpa:test … --continue` (`06f520e6`, desktop) | README 18.3절 | README 18.3절 | 실 Redis·실 PostgreSQL 계약 lane(`redisContainerContractTest`, `jpaPlatformContractTest`의 멱등성 계약, `postgresqlIdempotencyIntegrationTest`)은 다시 돌리지 않았다. 17.2절의 `2c692554` 실행이 마지막이다(E0). 이 영역에서 결함을 찾지 못해 실 vendor로 확인할 의심이 없었다. @@ -61,8 +61,8 @@ docs/manual/05-idempotency.md ## 못 본 것 - 실 Redis·실 PostgreSQL에서의 재실행(위 설명). -- 배포 중 섞인 버전(옛 인스턴스의 `TRANSITION`은 재생 핸들 시작에 `ALREADY`): round6 02의 Declined to judge에 이미 있다. README 17절에서 - 닫히지 않았다(README 18절). +- 배포 중 섞인 버전(옛 인스턴스의 `TRANSITION`은 재생 핸들 시작에 `ALREADY`): round6 02의 Declined to judge에 이미 있다. 2차에서 + 결함 아님으로 닫았다(README 18.5절). ## 항목 재확인 @@ -86,9 +86,28 @@ docs/manual/05-idempotency.md - 같은 owner token에 다른 operation id로 온 claim이 재시도 가능 실패·lease 지난 claim을 만나면, 전에는 `OwnerOperationConflict`(500)였고 이제 넘겨받는다(넘겨받기가 같은 owner 판정보다 앞이 되어서). 아무것도 실행되지 않은 기록이라 안전하고, 계약에 이 경우 케이스가 없다. 동작 변경으로 적어 둔다. 업그레이드 안내에는 없다. -- round6 02의 「Declined to judge」 6건이 README 17절에서 배정·결정으로 닫히지 않았다(README 18절 「멈춤 기준 상태」). +- round6 02의 「Declined to judge」 6건은 2차에서 판정했다(README 18.5절). 그중 하나가 아래 RR7-02-01이 됐다. ## 결론 Critical 0, Important 0, 회귀 0. 결함 0건. RR6-02-01~05는 모두 닫혔다. 바뀐 판정 순서와 시작 확인 조건은 세 저장소·두 fake에서 같고, 같은 attempt의 늦은 시작·재생 핸들 시작으로 작업이 두 번 도는 길은 남지 않았다(E1). 실 vendor 재실행은 하지 않았다. + +## 2차 추가 결함 (2026-11-06, 총괄 요청) + +round6 02의 「Declined to judge」를 판정하며(README 18.5절) 하나를 결함으로 올렸다. 다른 리뷰(`3add4917`)는 이 영역에서 새 결함을 적지 않았다. + +### RR7-02-01 · Minor · `ClientRuntimeRegistry.close()`는 닫는 스레드가 interrupt 상태면 drain 스레드가 끝났는지 보지 않고 정상으로 돌아온다 — "돌아오면 스레드가 남지 않는다"는 약속과 다르다 + +- **출처**: round6 02 「Declined to judge」 둘째 항목(README 18.5절 판정 (a)). +- **위치**: `src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/profile/ClientRuntimeRegistry.java:164-171`(Javadoc "Joining the thread is what makes 'no thread left' true when this returns"), `:181`·`:186`(`awaitTermination`·`join`은 interrupt 상태면 바로 `InterruptedException`), `:192-194`(잡아서 flag만 되살리고 반환), `:148-161`(`close()`는 그대로 정상 종료). +- **무엇이 틀렸나**: 16.1절 수정이 "close가 돌아오면 drain 스레드가 없다"를 join으로 보장했다. 그런데 닫는 스레드가 이미 interrupt 상태면 기다리는 첫 호출이 곧바로 예외를 내고, 그 catch는 flag를 되살린 뒤 아무 확인 없이 돌아온다. `close()`는 예외 없이 끝나지만 drain 스레드는 살아 있을 수 있다. 다른 실패 경로(`awaitTermination` 시간 초과, join 뒤 생존)는 `IllegalStateException`을 던지는데 interrupt 경로만 조용하다(A14). +- **발생 조건·영향**: interrupt된 스레드에서 registry를 닫는 경우(종료 훅을 interrupt로 끊는 런처, 테스트 프레임워크의 시간 제한 interrupt 뒤 정리). Spring 기본 종료 스레드는 보통 interrupt되지 않아 드물다. 그때 스레드가 남아도 호출자는 모른다. +- **테스트가 못 본 이유**: `ClientRuntimeRegistryTest`의 두 스레드 테스트가 interrupt되지 않은 스레드에서만 닫는다. +- **고치는 법**: interrupt를 받으면 남은 마감까지 interrupt를 무시하고 기다린 뒤(끝에 flag 복원) 스레드 생존을 확인하고, 살아 있으면 다른 경로처럼 `IllegalStateException`을 던진다. 대안: interrupt 경로에서도 바로 `IllegalStateException("interrupted before the drain thread exited")`를 던진다(더 단순하지만 정상 종료가 실패로 보일 수 있다). RED: 테스트 스레드에 `Thread.currentThread().interrupt()` 뒤 `close()`를 부르고, 돌아온 직후 drain 스레드가 살아 있으면 예외가 있었어야 함을 단언한다. +- **이번 수정 / 이전부터**: 이전부터(r9 16.1절 수정). r10이 바꾼 파일이 아니다. +- **증거**: E1(코드 경로). 실행 탐침은 돌리지 않았다 — interrupt 상태에서 `awaitTermination`이 바로 던지는 것은 `ThreadPoolExecutor` 계약이고, 그 뒤 경로는 catch 블록 하나라 코드로 결정적이다. + +### 2차 반영 뒤 결론 + +Critical 0, Important 0, 회귀 0. 결함 1건(RR7-02-01, Minor, 이전부터). 멱등성 쪽 r10 변경에서 찾은 새 결함은 여전히 0이다. diff --git a/docs/reviews/2026-11-03-rereview/round7/03-persistence.md b/docs/reviews/2026-11-03-rereview/round7/03-persistence.md index e41a5798..3ff9ae39 100644 --- a/docs/reviews/2026-11-03-rereview/round7/03-persistence.md +++ b/docs/reviews/2026-11-03-rereview/round7/03-persistence.md @@ -118,7 +118,7 @@ desktop 임시 worktree `~/workspace/t1-r10-review`(`06f520e6`), 공유 잠금 - `JpaProductionArchitectureTest`의 Flyway 규칙은 `Flyway.configure()`·`Flyway.configure(ClassLoader)` 호출만 본다. `new FluentConfiguration()`·`new ClassicConfiguration()`으로 만든 Flyway는 지나간다. 문서(`persistence-jpa/CLAUDE.md:100-104`, 매뉴얼 04 `:122-124`)는 "`Flyway.configure()`를 부르면 실패한다"로 정확히 적는다. 생성자 경로를 막을지는 규칙 범위 결정이라 판단하지 않았다. - 세션 잠금에서 연결이 끊기지 않은 채 unlock이 실패하면(Flyway가 "Unable to release PostgreSQL advisory lock"을 로그로만 남기는 경우) 잠금이 Hikari 풀의 연결에 남을 수 있다. Flyway 코드 경로로만 본 것이고 재현하지 않았다. 트랜잭션 잠금에는 없던 위험이다. 결정(Flyway 공식 옵션 채택)의 전제를 바꿀 만한 증거는 아니다. -- round6 03의 「Declined to judge」 10건 중 중첩 블록 주석은 r10이 고쳤고, 나머지 9건은 README 17절에서 배정·결정으로 닫히지 않았다(README 18절 「멈춤 기준 상태」). +- round6 03의 「Declined to judge」 10건은 2차에서 판정했다(README 18.5절). 그중 하나가 아래 RR7-03-05가 됐다. ## 결론 @@ -127,3 +127,72 @@ Critical 0, Important 0, 회귀 0. 결함 2건, 모두 Minor. - 이번 수정: RR7-03-01(ledger IT의 없는 예외 장치 안내). - 섞임: RR7-03-02(REINDEX 설명 — 이전부터 있던 넓은 문장을 이번 수정이 이유를 붙여 네 곳으로 넓힘). - RR6-03-01~04는 닫혔고, RR6-03-05는 부분이다(위 두 결함). 세션 잠금 전제(한 연결, 재시도 대기)는 Flyway 코드와 맞는다. + +## 2차 추가 결함 (2026-11-06, 총괄 요청) + +같은 커밋을 따로 본 리뷰(`claude/t1-baseline-7d623a` `3add4917`, `round7/review.md`)의 03 영역 발견 둘을 넘겨받았다. 그쪽의 RR7-03-01·02는 이 +리뷰의 RR7-03-01·02와 번호만 같고 다른 결함이라 새 번호를 붙였다(README 18.2절 대응표). 그쪽 탐침(공유 노트 `r7-probes/probe/pg/`)과 같은 +모양을 이 리뷰의 기준 커밋 `06f520e6`에서 다시 돌렸고, 고치는 법을 확인하려고 "실패 이력 행 삭제" 경우를 하나 더했다. round6 03의 +「Declined to judge」 판정에서 하나를 더 올렸다. + +### 2차 실행 + +desktop 임시 worktree `~/workspace/t1-r10-review`(`06f520e6`), 공유 잠금 아래. 탐침 `Rr7CicRecoveryProbeIntegrationTest`를 임시 lane +`rr7CicProbe`로 등록해 실 PostgreSQL(Testcontainers)에서 돌렸다. 모두 `FlywaySchemaPolicy.configure()`(세션 잠금)로 적용했다. 탐침 코드는 +공유 노트 `rr7-probes/pass2/`, 결과는 `rr7-probes/results/pass2-06f520e6.txt`. + +| # | 명령 | 결과 | 직전 부하(1분) | +|---|---|---|---| +| 4 | `./gradlew :adapter:outbound:persistence-jpa:rr7CicProbe` 첫 실행 | rc=1, 3초 — 내 탐침의 컴파일 오류(타입). 고쳐 다시 돌림 | 2.01 | +| 5 | 같은 명령 | rc=0, 15초. 아래 표 | 2.66 | + +V1은 `probe` 테이블, 일반 인덱스, `note`가 겹치는 행 하나(2001, `'note 1'`)를 만든다. + +| 경우 | V2 | 결과 | +|---|---|---| +| 섞임, `.sql.conf` 없음 | `INSERT (3001)` + `CREATE UNIQUE INDEX CONCURRENTLY` | Flyway가 실행 전에 거부("Detected both transactional and non-transactional statements"). 행 3001 없음, 이력 V1만 | +| 섞임, `executeInTransaction=false` | 같음 | `FlywayMigrateException`. **행 3001이 남음**(부분 적용), `ix_probe_note_u valid=false`, 이력 `2 success=false` | +| 복구: 가이드대로 | 유일 인덱스 하나 + `.sql.conf` → 실패 → 겹친 행 삭제, `DROP INDEX` → 재배포 | `FlywayValidateException: … Detected failed migration to version 2`. 이력 `2 success=false`가 그대로 | +| 복구: 실패 행도 삭제 | 위 + `DELETE FROM flyway_schema_history WHERE version = '2' AND NOT success` → 재배포 | 성공. `ix_probe_note_u valid=true`, 이력 `2 success=true` | + +### RR7-03-03 · Important · 실패한 동시 인덱스 마이그레이션의 복구를 "`DROP INDEX` 하나"라고 안내하지만, 남은 실패 이력이 다음 배포를 막고 runbook은 그 행을 지우는 것을 금지한다 + +- **출처**: 다른 리뷰 `3add4917` RR7-03-02. 그쪽 근거(가이드·runbook 문장, 탐침)를 확인하고 명령 5로 다시 재현했다. +- **위치**: + - 안내(같은 문장 세 벌): `docs/jpa/migration-guide.md:147-149`, `src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/migration/ConcurrentIndexMigrationInspector.java:18-19`·`:71-73`(`requireIsolatedStatement` Javadoc), `:92`(실패 메시지), `docs/study/postgresql-jpa-walkthrough.ko.md:1369-1371`. + - 막는 규칙: `docs/runbooks/migration-failed.md:42-66`(실패 분류에 이 경우가 없다), `:95`("delete or rewrite Flyway history to make validation green" 금지), `:107`(history repair 전 DB 소유자에게). +- **무엇이 틀렸나**: + - 트랜잭션 밖에서 돈 마이그레이션이 실패하면 Flyway는 이력에 `success=false` 행을 남긴다. + - 다음 배포의 validate는 그 행 때문에 실패한다. 무효 인덱스를 지우고 원인 데이터를 고쳐도 같다(명령 5 셋째 경우). + - 실패 행까지 지우면 재배포가 성공한다(넷째 경우). 그런데 문서 어디에도 그 단계가 없고, runbook은 이력 수정을 금지한다. +- **발생 조건·영향**: 가이드대로 쓴 동시 인덱스 마이그레이션이 실패한다(유일 인덱스의 중복 값, deadlock, `statement_timeout`, 운영자 취소). 운영자가 안내대로 `DROP INDEX` 뒤 다시 배포해도 기동이 또 멈추고, runbook에서 이 실패를 찾을 수 없다. r10 전에는 Flyway 기본 잠금 때문에 빌드가 실패까지 가지 못하고 멈췄다. r10이 빌드를 실제로 돌게 해 이 경로가 흔해졌다. 운영자에게 효과 없는 조치를 시키는 문서라 Important다. +- **테스트가 못 본 이유**: 동시 인덱스 IT는 성공하는 빌드와 상한에 걸려 취소되는 경우만 본다. 실패 뒤 재배포를 돌린 테스트가 없다. +- **고치는 법**: 정책 예외라 소유자 결정이 먼저다(README 18.4절). 권장안은 세 문장을 "무효 인덱스를 `DROP INDEX`하고, 그 버전의 실패 이력 행만 지운 뒤(`DELETE FROM WHERE version = '' AND NOT success`), 원인을 고쳐 다시 배포한다"로 고치고, runbook 「Classify the failure」에 이 경우와 SQL을, 「Do not」에 이 한 가지 예외를 적는 것이다. 성공한 행과 checksum은 건드리지 않는다. RED: 명령 5의 셋째 경우를 IT로 옮기고 문서 절차(넷째 경우)를 그대로 실행하게 한다. +- **이번 수정 / 이전부터**: 이전부터(가이드 문장은 `6d27356e`부터). r10이 바로 옆 문단을 고쳐 쓰고 빌드를 실제로 돌게 했다. +- **증거**: E3 — 명령 5(실 PostgreSQL, Flyway 11.14.1). 고치는 법의 SQL도 E3(넷째 경우). + +### RR7-03-04 · Minor · 학습 문서와 검사기 Javadoc이 "섞인 파일은 부분 적용되지 않는다"고 적지만, 가이드가 요구하는 `.sql.conf`를 붙이면 부분 적용된다 + +- **출처**: 다른 리뷰 `3add4917` RR7-03-01. 명령 5로 다시 재현했다. +- **위치**: `docs/study/postgresql-jpa-walkthrough.ko.md:1346-1348`(r10이 쓴 문장), `ConcurrentIndexMigrationInspector.java:16-19`(Javadoc: "Next to any other statement, one Flyway runs outside a transaction makes Flyway refuse the whole script before it runs any of it"). +- **무엇이 틀렸나**: Flyway의 `mixed=false` 거부는 `.sql.conf`가 트랜잭션 여부를 정하지 않은 파일에만 걸린다. 가이드·검사기 `validate`는 동시 인덱스 문장마다 `executeInTransaction=false`를 적으라고 한다. 그 설정이 붙은 섞인 파일은 Flyway가 문장마다 따로 커밋해 앞 문장이 남는다(명령 5 둘째 경우: 행 3001이 남고 무효 인덱스와 실패 이력이 생김). +- **발생 조건·영향**: 학습 문서를 믿고 `.sql.conf`를 붙인 채 다른 문장과 동시 인덱스를 섞는다. `requireIsolatedStatement`가 그 파일을 거부하지만 서비스가 마이그레이션 테스트를 둘 때만 돈다(가이드 `:146-147` "nothing checks it at startup"). 그 밖에서는 부분 적용과 실패 이력(RR7-03-03의 복구 문제)이 남는다. 문서 오류라 Minor. +- **테스트가 못 본 이유**: `.sql.conf`가 있는 섞인 파일을 Flyway로 끝까지 돌린 테스트가 없다. +- **고치는 법**: 두 곳을 "`.sql.conf` 없이 섞으면 Flyway가 실행 전에 거부한다. `executeInTransaction=false`를 붙이고 섞으면 문장마다 따로 커밋해 부분 적용된다. 그래서 동시 인덱스 문장은 혼자 둔다"로 고친다. 회귀 방지로 명령 5의 첫째·둘째 경우를 IT에 사실로 고정한다. +- **이번 수정 / 이전부터**: 이번 수정(RR6-03-05를 고치며 쓴 문장). +- **증거**: E3 — 명령 5. + +### RR7-03-05 · Minor · 잠금 대기 검사기 Javadoc은 `VACUUM FULL`을 늘 거부한다고 적지만, `.sql.conf`가 `executeInTransaction=true`를 정하면 `SET LOCAL` 뒤의 `VACUUM FULL`을 통과시킨다 + +- **출처**: round6 03 「Declined to judge」 셋째 항목(README 18.5절 판정 (a)). +- **위치**: `src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/migration/LockWaitMigrationInspector.java:62-64`(Javadoc: "A locking statement that cannot run in a transaction itself ({@code VACUUM FULL}, …) can never be bounded and is refused"), `:248-252`(설정이 `IN_A_TRANSACTION`이면 `SET LOCAL` 범위를 적용해 상한 있는 것으로 판정). +- **무엇이 틀렸나**: `.sql.conf`에 `executeInTransaction=true`를 쓰면 검사기는 그 파일을 트랜잭션 안이라 보고 `SET LOCAL` 뒤의 `VACUUM FULL`을 상한 있는 문장으로 통과시킨다. Javadoc의 "늘 거부"와 다르다. +- **발생 조건·영향**: 그 조합의 마이그레이션은 PostgreSQL이 배포 때 `25001`로 거부해 잠금 대기는 생기지 않는다. 검사기의 목적(상한 없는 잠금 대기를 막음)은 지켜지고, 검사기가 먼저 알려 주지 못할 뿐이다. 문서와 동작의 차이라 Minor. +- **테스트가 못 본 이유**: `LockWaitMigrationInspectorTest`에 `executeInTransaction=true` + `VACUUM FULL` 케이스가 없다. +- **고치는 법**: 권장: 트랜잭션 안에서 돌 수 없는 문장(`VACUUM`, 비동시 `REINDEX SCHEMA|DATABASE|SYSTEM` 등)이 `executeInTransaction=true` 파일에 있으면 검사기가 "PostgreSQL이 배포 때 거부한다"는 이유로 거부한다. 대안: Javadoc을 "설정이 트랜잭션을 정하지 않은 파일에서"로 좁힌다. RED: 그 조합 파일을 `unboundedLockingStatements(Path)`에 넣어 빈 결과가 나오는 것을 본다. +- **이번 수정 / 이전부터**: 이전부터. +- **증거**: E1(판정 코드). round6 03도 같은 판정을 코드 위치로 적었다(E0). 실행 탐침은 돌리지 않았다. + +### 2차 반영 뒤 결론 + +Critical 0, Important 1(RR7-03-03), 회귀 0. 결함 5건: 이번 수정 2(RR7-03-01·04), 섞임 1(RR7-03-02), 이전부터 2(RR7-03-03·05). diff --git a/docs/reviews/2026-11-03-rereview/round7/04-build-logic-shell.md b/docs/reviews/2026-11-03-rereview/round7/04-build-logic-shell.md index cf37c3c2..016437a6 100644 --- a/docs/reviews/2026-11-03-rereview/round7/04-build-logic-shell.md +++ b/docs/reviews/2026-11-03-rereview/round7/04-build-logic-shell.md @@ -73,7 +73,7 @@ src/build-logic/build.gradle src/build-logic/README.md - 한 번 걸린 `trap 'exit 0' EXIT`를 `trap - EXIT`로 풀어도 판독기는 뒤 명령을 계속 세지 않는다. 거짓 실패 쪽이고 이 모양을 쓰는 workflow는 드물다. - `kill $$`, `kill -TERM 0`처럼 셸을 신호로 끝내는 명령: 판독기가 보지 않는다. 신호로 끝난 단계는 실패로 끝나므로 거짓 통과가 아니다. -- round6 04의 「Declined to judge」 7건이 README 17절에서 배정·결정으로 닫히지 않았다(README 18절 「멈춤 기준 상태」). 그중 경로·브랜치 필터 항목은 05의 RR7-05-01과 겹친다. +- round6 04의 「Declined to judge」 7건은 2차에서 판정했다(README 18.5절). 그중 경로·브랜치 필터 항목은 05의 RR7-05-01로 합쳤다. ## 결론 diff --git a/docs/reviews/2026-11-03-rereview/round7/05-build-logic-workflow.md b/docs/reviews/2026-11-03-rereview/round7/05-build-logic-workflow.md index 348ef811..d5d954d3 100644 --- a/docs/reviews/2026-11-03-rereview/round7/05-build-logic-workflow.md +++ b/docs/reviews/2026-11-03-rereview/round7/05-build-logic-workflow.md @@ -79,7 +79,7 @@ desktop 임시 worktree `~/workspace/t1-r10-review`(`06f520e6`), 공유 잠금 - **발생 조건·영향**: 파생 서비스가 무거운 단계(`integrationCheck` 등)를 비용 때문에 `paths:` 필터 workflow로 옮긴다. 검사는 통과하고, 필터 밖 변경에서는 그 단계가 돌지 않는다. 메시지와 업그레이드 안내가 약속한 "매 변경"과 다르다. - **테스트가 못 본 이유**: `WorkflowGradleInvocationsTest`의 trigger 케이스는 이벤트 이름·`types`·`workflow_call`·`needs`만 다룬다. 필터 케이스가 없다. - **이번 수정 / 이전부터**: 섞임. 필터를 읽지 않는 동작은 이전부터다(round6 04 「Declined to judge」 첫 줄: "어떤 필터가 충분한지는 저장소 정책이라 판단하지 않았다"). "매 push·pull request·schedule"이라는 약속은 이번 수정이 메시지·문서에 썼다. -- **고치는 법** — 정책 선택이 먼저다(README 18절 「결정이 필요한 것」): +- **고치는 법** — 정책 선택이 먼저다(README 18.4절 「결정이 필요한 것」): - 권장(a): `paths:`·`paths-ignore:`가 붙은 trigger는 "매 변경"이 아니므로 그 trigger만으로는 세지 않는다. 이유는 2번(돌지 않을 수 있음). `branches:` 필터는 기본 브랜치를 포함하면 센다. 이 repo의 단계 명령은 필터 없는 workflow에 있어 판정이 바뀌지 않는다. - 대안(b): 동작은 두고 메시지·B-36을 "change trigger 중 하나로 시작하는 workflow(경로 필터는 보지 않는다)"로 고친다. 필터의 충분성은 저장소 책임으로 문서에 적는다. - RED 테스트 모양: (a)면 탐침 workflow를 `WorkflowGradleInvocationsTest`에 넣고 `uncountedReason`이 null이 아님을 단언한다. `06f520e6`에서 실패한다(탐침 결과).