docs(review): r10 확인 리뷰 round7을 영역 다섯으로 기록한다
문제: 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절
This commit is contained in:
@@ -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절 결정.
|
||||
|
||||
@@ -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 -- <pathspec>`: 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를 놓치는 회귀, 하나는 안내대로 해도 실패하는 거짓 실패다.
|
||||
@@ -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 -- <pathspec>`: 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 재실행은 하지 않았다.
|
||||
@@ -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 -- <pathspec>`: 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 <db>` | **적용됨** |
|
||||
|
||||
### 못 본 것
|
||||
|
||||
- `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 코드와 맞는다.
|
||||
@@ -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 -- <pathspec>`: 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).
|
||||
@@ -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 -- <pathspec>`: 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/<file>`로 부르는 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은
|
||||
고치기 전에 소유자가 경로 필터 정책을 정해야 한다.
|
||||
Reference in New Issue
Block a user