From a9b6bcd52da0f9267d4708d9c408d6435a176a87 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 6 Nov 2026 22:31:07 +0900 Subject: [PATCH] =?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`에서 실패한다(탐침 결과).