diff --git a/docs/reviews/2026-11-03-rereview/README.md b/docs/reviews/2026-11-03-rereview/README.md index 970ef6c0..52693f60 100644 --- a/docs/reviews/2026-11-03-rereview/README.md +++ b/docs/reviews/2026-11-03-rereview/README.md @@ -502,6 +502,7 @@ lane. 마지막 실행은 17.2절의 `2c692554`다(이 리뷰에는 E0). | 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절) | 소유자 | +| round7 05 Declined ①: 태그·릴리스 trigger만 있는 workflow를 단계 실행으로 셀지 | (a) `push`에 `tags:`만 있거나(`branches`·`paths` 없이) `release` trigger만 있는 workflow는 `releaseCheck` 단계에만 센다 (b) 지금처럼 모든 단계에 센다(릴리스 흐름도 변경 흐름의 일부)고 메시지·B-36에 적는다 | (a). 결정 「경로 필터 workflow와 단계 검사」와 같은 원칙이다 — 태그 push는 매 변경에 돌지 않는다. `releaseCheck`는 정의가 "tag 전용 검사"(`src/README.md`)라 예외로 둔다. 이 repo는 `release.yml`(`push: tags: [v*]`)이 `:releaseCheck`·`-p optional-platforms releaseCheck` 말고도 `-p optional-platforms integrationCheck`를 돌리지만, 같은 단계를 `integration-main.yml`(main push·nightly)도 돌려 판정이 바뀌지 않는다 | 소유자 | ### 18.5 round6 「Declined to judge」 30건 판정 (2026-11-06) @@ -520,8 +521,8 @@ lane. 마지막 실행은 17.2절의 `2c692554`다(이 리뷰에는 E0). | 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 | ④ | `error-codes.yaml` `IDEMPOTENCY_UNAVAILABLE` `log_level` | (b) 다른 세션 처리, 닫힘 | `claude/t3-error-codes-loglevel-fcf427`에서 고쳤고 리뷰 브랜치에 합쳐졌다(`ddf174cd`). 합친 트리 `2c8a359d`에서 행에 `log_level`이 없고, 두면 `OperationalErrorRegistryContractTest`가 실패한다(`docs/registries/error-codes.yaml` 머리 주석) | +| 02 | ⑤ | 시작 호출의 operation id가 claim과 다를 때 저장소 답이 다름 | (b) 다른 세션 처리, 닫힘 | `claude/t5-idempotency-operation-id-9bd973`(`200019aa`)이 고쳤고 리뷰 브랜치에 합쳐졌다(`0fa01019`). 합친 트리 `2c8a359d`에서 PostgreSQL 시작도 `namesAnotherOperation` → `OPERATION_CONFLICT`로 Redis와 같다 | | 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` | @@ -541,6 +542,34 @@ lane. 마지막 실행은 17.2절의 `2c692554`다(이 리뷰에는 E0). | 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는 코드·테스트로 닫혔다 | +#### round7 1차 「Declined to judge」 12건 판정 (2026-11-07) + +총괄 요청으로 이 리뷰 1차 문서의 「Declined to judge」를 같은 방식으로 판정했다. 기준은 리뷰 브랜치를 fast-forward한 `2c8a359d`다(t3·t5 수정과 결정 +색인의 2026-11-06 결정 포함). 번호는 각 영역 문서 「Declined to judge」의 순서다(각 영역의 마지막 줄 "round6 …의 Declined"는 위 표가 다뤄 세지 +않는다). 결과: (a) 3건(그중 1건은 RR7-01-01에 합침), (b) 8건, (c) 1건. + +(a)로 새로 올린 발견 둘은 이 표에만 적었다. 총괄 지시가 18절 판정 표와 18.4절만 고치라고 해서 18.1절 색인 표에는 넣지 않았다. + +| 발견 | 심각도 | 한 줄 내용 | 이번 수정 / 이전부터 | 증거 | +|---|---|---|---|---| +| RR7-02-02 | Minor | in-memory fake가 시작을 적용한 같은 핸들의 재시작(응답 유실)에 `NOT_OWNER` — 두 저장소·포트 Javadoc은 `ALREADY_STARTED_SAME_OPERATION` | 이전부터 | E1 | +| RR7-03-06 | Minor | "코드로 만드는 Flyway는 모두 `FlywaySchemaPolicy.configure()`에서" 규칙을 ArchUnit이 `Flyway.configure()` 호출로만 지켜 `new FluentConfiguration()`·`new ClassicConfiguration()`이 빠진다 | 이번 수정 | E1 | + +| 영역 | # | 항목 | 판정 | 근거 | +|---|---|---|---|---| +| 01 | ① | `ARE_REQUEST_HANDLER_TYPES`에 WebFlux `WebFilter`·`WebHandler` 등이 없음 | (a) → RR7-01-01에 합침 | r9는 설정에 중첩된 클래스를 `org.springframework.web..` 전체로 봤다. 목록이 좁아진 같은 원인이고 다른 리뷰도 RR7-01-01에 함께 적었다 | +| 01 | ② | gRPC: 취소된 호출이 carrier·IAE로 끝나면 로그가 남음 | (b) | 문서는 "인식 못 한 실패"에서만 취소를 뺀다(`src/adapter/inbound/grpc/README.md`). 약속 위반이 없다 | +| 01 | ③ | gRPC: raw status를 다른 예외로 감싸 던지면 원인 사슬의 status 설명이 스택에 남음 | (b) | 인식 못 한 실패를 원인 사슬째 남기는 것은 네 전송 공통 설계다(web `GlobalExceptionHandler.handleUnknown`도 같다). RR6-01-05가 약속한 것은 서비스가 끝낸 raw status 자체의 설명이고 그것은 지켜진다 | +| 02 | ① | in-memory fake가 같은 핸들의 재시작에 `NOT_OWNER` | (a) → RR7-02-02 | 포트 Javadoc과 두 저장소, 결정 「넘겨받기 전 핸들의 재전송」(2026-11-06, 전이를 적용한 핸들에게는 "이미 처리됨")과 다르다. fake가 계약 밖으로 갈라졌다(A6) | +| 02 | ② | 같은 owner token·다른 operation id의 claim이 넘겨받을 수 있는 기록에서 `OwnerOperationConflict` 대신 넘겨받음 | (b) | 아무것도 실행되지 않은 기록이라 넘겨받아도 안전하다. `OwnerOperationConflict`에는 Javadoc 약속이 없고, t5가 더한 계약 케이스 `aClaimWithTheOwnerTokenUnderAnotherOperationIsAnOwnerOperationConflict`(살아 있는 claim)는 세 저장소가 같게 답한다. 결정 「같은 token·다른 operation의 claim·inspect」(2026-11-06, `docs/work/reference/decisions.md` 2.4)가 claim의 `OwnerOperationConflict`를 진행 중인 기록으로 한정했다. 넘겨받을 수 있는 기록은 넘겨받기를 먼저 보는 RR6-02-01 순서를 따른다 | +| 03 | ① | `new FluentConfiguration()`·`new ClassicConfiguration()` 경로 | (a) → RR7-03-06 | 규칙 문장(`persistence-jpa/CLAUDE.md`, `FlywaySchemaPolicy` Javadoc)이 모든 생성을 말하는데 장치는 한 길만 막는다(A10) | +| 03 | ② | 세션 잠금: 연결이 살아 있는 채 unlock이 실패하면 잠금이 풀의 연결에 남을 수 있음 | (b) | 결정 「Flyway PostgreSQL 잠금」(세션 수준, `docs/work/reference/decisions.md` 2.5)의 범위 안의 성질이다. 남은 잠금은 다음 배포가 `lockRetryCount` 뒤 오류로 멈추는 닫힌 실패이고, 풀이 그 연결을 닫으면 풀린다. 재현하지 않았고 결정의 전제를 바꿀 증거가 아니다 | +| 04 | ① | `trap 'exit 0' EXIT` 뒤 `trap - EXIT`로 풀어도 계속 세지 않음 | (b) | 거짓 실패 쪽이다(README 16절 결정) | +| 04 | ② | `kill $$` 등 신호로 셸을 끝내는 명령을 모델링하지 않음 | (b) | 신호로 끝난 단계는 실패로 끝나 거짓 통과가 없다 | +| 05 | ① | `push: tags:`만 있거나 `release` trigger만 있는 workflow도 단계 실행으로 셈 | (c) → 18.4절 | 결정 「경로 필터 workflow와 단계 검사」(2026-11-06)는 `paths:`만 정했다. 태그·릴리스 trigger는 같은 원칙(매 변경에 도는가)의 다른 모양이지만 `releaseCheck`는 정의상 태그 전용이라 새 결정이 필요하다 | +| 05 | ② | `runs-on`을 `labels:` 없는 `group:` 매핑으로만 쓰면 세지 않음 | (b) | 거짓 실패 쪽이고 실패 메시지가 이유("may be a Windows runner")를 말한다 | +| 05 | ③ | 같은 repo의 재사용 workflow를 `owner/repo/.github/workflows/x.yml@ref`로 부르면 호출자로 못 알아봄 | (b) | 거짓 실패 쪽이다. 메시지가 "no workflow in this directory calls it"을 말한다 | + ### 18.6 멈춤 기준 상태 (`docs/work/improve.md` 4.5절) 1. 마지막 확인 리뷰 발견 0: **아님.** 13건(18.1절). 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 4091701f..82e4f842 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 @@ -108,6 +108,7 @@ desktop(`ssh desktop`) 임시 worktree 두 개(`~/workspace/t1-r10-review` = `06 - **이번 수정 / 이전부터**: 이번 수정(회귀). - **증거**: 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). 결함 하나로 센다. +- **3차 합침(2026-11-07)**: 1차 「Declined to judge」 첫째 항목(WebFlux `WebFilter`·`WebHandler`가 요청 처리기 목록에 없음)도 같은 원인이다. r9는 설정에 중첩된 클래스를 `org.springframework.web..` 전체로 봤다. README 18.5절에서 (a)로 판정해 이 결함에 합쳤다. ### RR7-01-02 · Minor · 메서드 참조로 함수형 route만 등록한 설정도 사용자 전송으로 세어, 같은 설정이 handler bean을 등록하면 거짓 실패한다 — Javadoc·매뉴얼은 "요청 처리 코드가 있을 때만"이라고 적는다 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 da77e813..9112b1c8 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 @@ -111,3 +111,26 @@ round6 02의 「Declined to judge」를 판정하며(README 18.5절) 하나를 ### 2차 반영 뒤 결론 Critical 0, Important 0, 회귀 0. 결함 1건(RR7-02-01, Minor, 이전부터). 멱등성 쪽 r10 변경에서 찾은 새 결함은 여전히 0이다. + +## 3차 추가 결함 (2026-11-07, 총괄 요청) + +이 문서 1차 「Declined to judge」 둘을 판정했다(README 18.5절). 첫째를 결함으로 올리고, 둘째는 닫았다. 기준은 리뷰 브랜치를 fast-forward한 +`2c8a359d`다(t5 멱등 수정 `200019aa` 포함). + +### RR7-02-02 · Minor · in-memory fake는 시작을 적용한 그 핸들이 시작을 다시 보내면(응답 유실) `NOT_OWNER`로 답한다 — 두 저장소와 포트 Javadoc은 `ALREADY_STARTED_SAME_OPERATION`이다 + +- **출처**: 이 문서 1차 「Declined to judge」 첫째 항목(README 18.5절 판정 (a)). +- **위치**: + - fake: `src/application-core/src/testFixtures/java/dev/caskeleton/application/idempotency/testkit/InMemoryIdempotencyStore.java`의 `markExecutionStarted` — 시작하면 `row.advance(EXECUTING)`가 기록의 핸들(revision)을 바꾸고, 다시 온 같은 핸들은 `!row.owner.equals(owner)`로 `NOT_OWNER`가 된다. + - 약속: `IdempotencyStartOutcome.ALREADY_STARTED_SAME_OPERATION` Javadoc("This exact start — from the handle presented — was already applied (a lost reply)"). 저장소: Redis `TRANSITION`은 기록 revision이 핸들 + 1이면 `ALREADY`, PostgreSQL은 기록된 시작 digest가 같으면(`replayVerdict` `SAME_ARGUMENTS`) `ALREADY_STARTED_SAME_OPERATION`. + - 결정: 「넘겨받기 전 핸들의 재전송」(2026-11-06, `docs/work/reference/decisions.md` 2.4) — 이미 일어난 전이를 다시 보내면 그 전이를 실제로 적용한 핸들에게만 "이미 처리됨"으로 확인한다. fake는 그 핸들에게도 거절한다. +- **무엇이 틀렸나**: 포트 계약은 "시작 응답을 잃은 호출자가 같은 핸들로 다시 시작하면 이미 시작됐다고 확인한다"이다. 두 저장소는 그렇게 답하고 fake는 `NOT_OWNER`로 답한다. 공유 계약(`IdempotencyStoreContract`)에 그 케이스가 없어 fake가 계약 밖으로 갈라진 채 통과한다(A6). +- **발생 조건·영향**: fake 위에서 executor나 use case를 시험하는 테스트가 같은 핸들로 시작을 두 번 보내면, 운영 저장소에서는 계속 실행될 흐름이 fake에서는 "회복 필요"(500)로 끝난다. 테스트가 운영과 다른 답을 근거로 통과하거나 실패한다. +- **테스트가 못 본 이유**: 계약에 "같은 핸들로 시작 두 번" 케이스가 없다. fake는 응답 유실을 만들 수 없어도 같은 호출을 두 번 하는 것은 할 수 있다. +- **고치는 법**: 계약에 케이스를 더한다 — claim → 시작 → 같은 핸들로 다시 시작 → `ALREADY_STARTED_SAME_OPERATION`과 현재 핸들. fake는 시작을 적용한 핸들(revision)을 기억해 그 핸들이면 `ALREADY_STARTED_SAME_OPERATION`으로 답한다(complete의 `completedBy`와 같은 방식). RED: 그 계약 케이스가 fake 계약 테스트에서 `NOT_OWNER`로 실패한다. 두 저장소 계약 테스트는 통과해야 한다. +- **이번 수정 / 이전부터**: 이전부터. +- **증거**: E1(fake·두 저장소의 판정 코드). 실행 탐침은 돌리지 않았다 — fake 판정은 `equals` 한 줄이라 코드로 결정적이다. + +### 3차 반영 뒤 결론 + +Critical 0, Important 0, 회귀 0. 결함 2건(RR7-02-01·02, 모두 Minor, 이전부터). 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 3ff9ae39..f425b1ff 100644 --- a/docs/reviews/2026-11-03-rereview/round7/03-persistence.md +++ b/docs/reviews/2026-11-03-rereview/round7/03-persistence.md @@ -196,3 +196,24 @@ V1은 `probe` 테이블, 일반 인덱스, `note`가 겹치는 행 하나(2001, ### 2차 반영 뒤 결론 Critical 0, Important 1(RR7-03-03), 회귀 0. 결함 5건: 이번 수정 2(RR7-03-01·04), 섞임 1(RR7-03-02), 이전부터 2(RR7-03-03·05). + +## 3차 추가 결함 (2026-11-07, 총괄 요청) + +이 문서 1차 「Declined to judge」 둘을 판정했다(README 18.5절). 첫째를 결함으로 올리고, 둘째는 결정 「Flyway PostgreSQL 잠금」으로 닫았다. + +### RR7-03-06 · Minor · "코드로 만드는 Flyway는 모두 `FlywaySchemaPolicy.configure()`에서 시작한다"는 규칙을 ArchUnit은 `Flyway.configure()` 호출로만 지킨다 — `new FluentConfiguration()`·`new ClassicConfiguration()`은 Flyway 기본(트랜잭션) 잠금으로 돌아간다 + +- **출처**: 이 문서 1차 「Declined to judge」 첫째 항목(README 18.5절 판정 (a)). 다른 리뷰(`3add4917`)도 같은 항목을 Declined로 적었다. +- **위치**: + - 규칙: `src/adapter/outbound/persistence-jpa/CLAUDE.md:100-104`("every Flyway built in code starts from `FlywaySchemaPolicy.configure()`"), `FlywaySchemaPolicy.java` Javadoc("Every Flyway the template builds itself starts from {@link #configure()}"). + - 지키는 장치: `src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/JpaProductionArchitectureTest.java:167-190`(`callMethod(Flyway, "configure")`·`configure(ClassLoader)`만 거부). +- **무엇이 틀렸나**: Flyway 설정을 만드는 공개 길은 셋이다: `Flyway.configure()`, `new FluentConfiguration()`(+`.load()`), `new ClassicConfiguration()` + `new Flyway(configuration)`. 규칙 문장은 셋 모두를 말하고, ArchUnit은 첫째만 막는다(A10 — 둘째·셋째는 글로만 있음). +- **발생 조건·영향**: 파생 서비스가 자기 스트림을 `new FluentConfiguration()`으로 만든다. 빌드는 통과하고, 그 스트림의 `CREATE INDEX CONCURRENTLY` 마이그레이션은 RR6-03-01처럼 Flyway 자신의 열린 트랜잭션을 기다려 끝나지 않는다. 이 repo 코드에는 그런 생성이 없다(grep). +- **테스트가 못 본 이유**: 규칙에 둘째·셋째 길의 위반 fixture가 없다. +- **고치는 법**: 같은 규칙에 `callConstructor(FluentConfiguration.class, …)`(인자 없는 것과 `ClassLoader` 하나)와 `callConstructor(ClassicConfiguration.class, …)`를 `FlywaySchemaPolicy` 밖에서 거부하는 조건을 더한다. 대안: 문서를 "`Flyway.configure()`를 부르지 않는다"로 좁힌다(지키는 범위에 말을 맞춤, 권하지 않음 — 막으려는 피해가 그대로 남는다). RED: 둘째·셋째 길로 Flyway를 만드는 위반 fixture가 지금 규칙을 통과한다. +- **이번 수정 / 이전부터**: 이번 수정(규칙과 문장 모두 r10이 만들었다). +- **증거**: E1(규칙 코드와 Flyway 11.14.1의 공개 생성자). + +### 3차 반영 뒤 결론 + +Critical 0, Important 1(RR7-03-03), 회귀 0. 결함 6건: 이번 수정 3(RR7-03-01·04·06), 섞임 1(RR7-03-02), 이전부터 2(RR7-03-03·05).