diff --git a/docs/reviews/2026-11-03-rereview/README.md b/docs/reviews/2026-11-03-rereview/README.md index 31d33206..daa932f1 100644 --- a/docs/reviews/2026-11-03-rereview/README.md +++ b/docs/reviews/2026-11-03-rereview/README.md @@ -574,15 +574,28 @@ lane. 마지막 실행은 17.2절의 `2c692554`다(이 리뷰에는 E0). | 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절) +### 18.6 멈춤 기준 상태 (`docs/work/improve.md` 4.5절, 2026-11-07) -1. 마지막 확인 리뷰 발견 0: **아님.** 13건(18.1절). -2. 열린 「Declined to judge」 0: **아님.** - - 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.4절 결정 3건. +1. 마지막 확인 리뷰 발견 0: **아님.** round7 15건(18.1절). 15건 모두 고쳤다(18.7절). 고친 커밋을 보는 다음 확인 리뷰가 판정한다. +2. 열린 「Declined to judge」 0: **참.** + - round6 30건은 모두 판정했다(18.5절). (b) 중 다른 브랜치가 닫는 2건은 그 브랜치가 리뷰 브랜치에 합쳐져(`ddf174cd`, `0fa01019`) + 합친 트리 `2c8a359d`에서 확인해 닫았다. + - round7 1차 12건(01: 3, 02: 2, 03: 2, 04: 2, 05: 3)도 모두 판정했다(18.5절 「round7 1차」 표, `cb340001`): (a) 3건, (b) 8건, + (c) 1건. (c)는 18.4절 넷째 결정이 됐다. +3. 합친 트리의 라운드 끝 게이트: **참.** `claude/integration-r8-a4196a`(`48565718`)에서 PR 단계·main 단계·바뀐 영역 lane 전부 rc=0(18.8절). +4. README의 남은 항목 0: **아님.** 18.4절 결정 4건은 모두 답을 받았고 결정 색인에 위치를 적었다. 남은 것은 수정 세션이 「범위 밖」으로 + 적고 고치지 않은 아래 넷이다. 결함인지 판정하지 않았다. 다음 확인 리뷰가 판정한다. 수정마다 새로 기대는 것은 각 커밋 본문 「위험·한계」에 있다. + - 멱등(r8-f4): 적용한 핸들이 markFailed를 다른 retention으로 다시 보내면 Redis·fake는 `ALREADY_MARKED_SAME_OPERATION`, PostgreSQL은 + `OPERATION_CONFLICT`다. `IdempotencyFailOutcome.OPERATION_CONFLICT` Javadoc은 둘 다 `OPERATION_CONFLICT`라고 적는다. 또 Redis TRANSITION의 + start `ALREADY`는 전이 종류를 보지 않아, EXECUTING 핸들로 renew한 뒤 그 핸들로 start하면 Redis만 `ALREADY_STARTED_SAME_OPERATION`이다 + (executor는 renew를 부르지 않아 손으로 만든 호출로만 닿음). + - 아키텍처 규칙(r8-f2): STOMP channel interceptor 타입(`org.springframework.messaging.support.ChannelInterceptor`·`Message`·`MessageChannel`)이 + 사용자 전송 타입 목록에 없다. 설정 클래스 자신에 직접 쓴 WebFlux `WebFilter`·`WebHandler`는 요청 처리기 목록 밖이다(WebFlux는 classpath에 없음). + 둘 다 이전부터다. + - 전송 오류(r8-f1): web 필터가 던진 carrier는 `EnvelopeErrorController`가 status만 봐 500 `INTERNAL_ERROR`가 된다. 템플릿에 carrier를 던지는 + 필터는 없다(grep). + - 이력 ID(t4-2): `docs/manual`·`docs/work` 밖 문서(`AGENTS.md`, `docs/httpclient/*.md`, `src/adapter/inbound/web/README.md` 등)에 본문 이력 ID가 + 남아 있다. 이력 0 규칙을 그 문서까지 넓힐지는 소유자 결정이다. ### 18.7 round7 처리 (2026-11-07) @@ -605,3 +618,91 @@ round7 결함 15건과 고치다 같이 고친 것을 수정 브랜치 다섯 | 태그·릴리스 trigger 판정(18.4절 넷째) | 고침(18.4절 (a)) | `a490c20f` | RED: `ac3c6a81` + 테스트만으로 68건 중 2건 실패(`WorkflowGradleInvocationsTest`, `StrictLaneStagesFunctionalTest` UnexpectedBuildSuccess). GREEN: 두 클래스 46·22건 실패 0, `-p build-logic check javadoc`(173건), 두 빌드 단계 검사, `check-work-docs.py`·상대 링크 검사 rc=0 | | 깨진 상대 링크 3개(`src/README.md`, fileserver·objectstorage README, 기준 커밋부터) | 고침 | `eab82df1` | `check-work-docs.py --links`를 src·docs·`README.md`·.github에 돌려 깨진 링크 0. lychee는 돌리지 못함 | | `AGENTS.md` 커밋 예외 문장(매뉴얼 수정 세션이 범위 밖에서 봄) | 고침 | `ac3c6a81` | 본문을 읽는 테스트가 없다(git grep) | + +### 18.8 합친 트리와 게이트 (2026-11-07, desktop) + +`2c8a359d`에서 딴 `claude/integration-r8-a4196a`에 아래 순서로 `git merge --no-ff`를 했다: `447a77a3`(매뉴얼 수정), `ef8ef170`(r8-f1), +`a8166598`(r8-f2), `6764246a`(r8-f3), `14435106`(r8-f4), `a490c20f`(r8-f5), `81ef58ab`(매뉴얼 이력 ID), `cb340001`(1차 Declined 판정). + +합칠 때 생긴 충돌과 처리: + +| 병합 | 파일 | 충돌 | 처리 | +|---|---|---|---| +| r8-f5 | `docs/upgrade/2026-11-maturity-review.md` 머리 「커밋」 줄 | r8-f1이 「r8-f1 전송 오류 처리(B-45~B-48)」, r8-f5가 「`paths` 필터 trigger(B-36)」·「태그 push·`release`(B-36)」를 같은 줄 끝에 더함 | 셋 다 남기고 날짜 순(11-06 `paths` → 11-07 r8-f1 → 11-07 태그)으로 이었다 | +| 매뉴얼 이력 ID | `scripts/check-work-docs.py` `HISTORY_PATTERNS` | 매뉴얼 수정이 회차 패턴 위에 주석 한 줄을 더하고 그 패턴을 고침, 이력 ID 브랜치가 같은 자리에 패턴 셋을 더함 | 패턴 셋을 두고, 주석은 그 주석이 설명하는 회차 패턴 바로 위에 뒀다. 회차 패턴은 매뉴얼 수정 판(자동 병합) | +| 매뉴얼 이력 ID | `docs/work/evidence.md` 8·9절 경계 | 이력 ID 브랜치가 8절 끝에 문단·표를 더함, 매뉴얼 수정이 9절 제목 날짜를 「2026-11-06~07」로 고침 | 8절 추가분을 두고 9절 제목은 매뉴얼 수정 판 | + +- 자동 병합: `docs/work/reference/decisions.md`(r8-f1·f4·f5·매뉴얼 수정이 서로 다른 행), `docs/manual/07-authorization.md`(r8-f2 문단과 이력 ID + 걷어내기가 다른 문단), `docs/manual/04-persistence.md`, `docs/upgrade/2026-11-maturity-review.md` 본문. 합친 결과를 읽어 두 브랜치의 문장이 모두 + 남은 것과 업그레이드 안내 B 행 번호가 겹치지 않는 것을 봤다. +- 합친 뒤 노트북 검사: `check-work-docs.py`(전체·`--history docs/manual`·lychee 범위 `--links`), `check-review-index.py` 모두 rc=0. + +게이트: 대상 `48565718`(18.7절까지 적은 커밋). desktop 새 detached worktree에서 공유 잠금 아래 차례로 돌렸다. 모든 Gradle 명령에 +`--no-build-cache`를 붙였다. 로그 desktop `~/integration-r8-logs/`(`pr-summary.txt`·`main-summary.txt`, 명령마다 `<단계>-<이름>.log`, 실행 +스크립트 `gates.sh`). 바뀐 영역 lane은 `git diff --name-only 2c8a359d 48565718`(120파일)을 `on.pull_request.paths`가 있는 workflow와 +`pr-adapters.yml` `changes` job의 정규식에 맞춰 골랐다. 첫 실행에서 모두 통과해 다시 돌린 것은 없다. + +| 단계 | 명령 | rc | 시간 | 직전 부하 | 실제 실행 | 테스트(실패·skip) | +|---|---|---|---|---|---|---| +| PR | `tasks --group verification` | 0 | 5초 | 0.39 | 5 executed | — | +| PR | `:ci :verifyDependencyLocks --warning-mode=fail --continue` | 0 | 6분 29초 | 0.76 | 752 executed, 4 up-to-date, FROM-CACHE 0 | 7373 (0·28) | +| PR | `:verifyStrictLaneStages --dry-run` | 0 | 11초 | 11.83 | 4 up-to-date | — | +| PR | `bash scripts/verify-compose-profile-contracts.sh` | 0 | 3초 | 10.62 | — | — | +| PR | `:sample-portfolio:check :sample-portfolio:qualityCheck` | 0 | 31초 | 10.62 | 14 executed, 42 up-to-date | 340 (0·0) | +| PR | `-p optional-platforms ci` | 0 | 1분 10초 | 8.78 | 113 executed, 4 up-to-date | 593 (0·0) | +| PR | `-p optional-platforms :verifyStrictLaneStages --dry-run` | 0 | 2초 | 14.87 | 4 up-to-date | — | +| PR(web) | `:adapter:inbound:web:systemTest :adapter:inbound:web:webJettyCompatTest` | 0 | 26초 | 14.08 | 4 executed | 34 (0·0) | +| PR(websocket) | `:adapter:inbound:websocket:websocketJettyTest` | 0 | 4초 | 9.56 | 2 executed | 8 (0·0) | +| PR(websocket) | `:adapter:inbound:websocket:websocketNginxTest` | 0 | 6초 | 9.12 | 3 executed | 4 (0·0) | +| PR(httpclient) | `httpClientStableContractTest -Phttpclient.contract.transports=apache` | 0 | 6초 | 8.71 | 1 executed | 17 (0·0) | +| PR(httpclient) | 같은 것 `=jdk` | 0 | 5초 | 8.25 | 1 executed | 17 (0·0) | +| PR(httpclient) | `spring70CompatibilityTest` | 0 | 5초 | 7.91 | 1 executed | 23 (0·0) | +| PR(jpa) | `jpaPlatformContractTest -Pjpa.matrix.versions=16` | 0 | 3분 36초 | 7.68 | 3 executed | 429 (0·0) | +| PR(jpa) | 같은 것 `=18` | 0 | 3분 36초 | 2.58 | 1 executed | 429 (0·0) | +| PR(jpa) | `jpaPlatformMigrationTest` | 0 | 1분 20초 | 1.82 | 1 executed | 45 (0·0) | +| PR(redis-sdk-topology) | standalone 7.4 compose + `redisTopologyTest` ×3(redis-runtime·redis-sdk·cache-redis) | 0 | 1분 26초 | 2.57 | 3 executed | 119 (0·0) | +| PR(build-logic) | `-p build-logic test` | 0 | 40초 | 1.25 | 3 executed, 3 up-to-date | 173 (0·0) | +| PR(fileserver-pr) 1/5 | `:application-fileserver:test :composition:fileserver-platform:test` | 0 | 2초 | 2.39 | 42 up-to-date — 같은 worktree `:ci`가 실행(361건·37건) | — | +| PR(fileserver-pr) 2/5 | `:adapter:outbound:fileserver:test` | 0 | 1초 | 2.27 | 26 up-to-date — `:ci`가 실행 | — | +| PR(fileserver-pr) 3/5 | `:adapter:inbound:web-fileserver:test` | 0 | 2초 | 2.27 | 29 up-to-date — `:ci`가 실행 | — | +| PR(fileserver-pr) 4/5 | `…web-fileserver:test --tests '*FileserverHardeningContractTest' …fileserver:test --tests '*PhysicalPathResolverTest'` | 0 | 4초 | 2.27 | 2 executed | 30 (0·0) | +| PR(fileserver-pr) 5/5 | `:adapter:outbound:fileserver:test --tests '*LargeFileBoundedMemoryTest'` | 0 | 3초 | 2.73 | 1 executed | 2 (0·0) | +| PR(object-storage) | `:adapter:outbound:objectstorage:objectStorageMinioContractTest` | 0 | 8초 | 2.67 | 2 executed | 19 (0·0) | +| PR(문서) | `check-work-docs.py`, `--history docs/manual`, lychee 범위 `--links`(`gates.md` 2절), `check-review-index.py` | 0 | 0초 | 2.62 | — | 이력 ID 0줄(13파일), 링크 520개 깨짐 0(572파일), 색인 172/172 | +| main | `:mainCheck --continue --warning-mode=fail` | 0 | 8분 16초 | 2.62 | 241 executed, 255 up-to-date, FROM-CACHE 0 (아래 주 1) | 440 (0·0) | +| main | configuration-cache 1/3: `ci`·`mainCheck`·`integrationCheck`·`releaseCheck` `--dry-run` 두 번씩 | 0 | 34초 | 8.43 | 재사용 4/4 | — | +| main | configuration-cache 2/3: `:domain-core:check :application-core:check --configuration-cache` | 0 | 4초 | 5.74 | 4 executed, 25 up-to-date | — | +| main | configuration-cache 3/3: 같은 것 다시 | 0 | 1초 미만 | 5.74 | 25 up-to-date, 재사용 1/1 | — | +| main | `:integrationCheck --continue` | 0 | 16분 55초 | 5.74 | 101 executed, 173 up-to-date | 1021 (0·0) | +| main | `:performanceCheck --continue` | 0 | 23초 | 0.73 | 60 executed | 26 (0·0) | +| main | `-p optional-platforms performanceCheck --continue` | 0 | 4초 | 1.78 | 10 executed | 1 (0·0) | +| main | `-p optional-platforms integrationCheck` | 0 | 20초 | 2.04 | 10 executed | 47 (0·0) | +| main | `:adapter:outbound:httpclient:test -Phttp3.tests.enabled=true`(실험 job) | 0 | 40초 | 2.18 | 1 executed | 360 (0·0) | +| main | notification-platform `pr` 1~4/7(compile, application-core·notification·persistence-jpa 등 test) | 0 | 각 1~2초 | 1.44~1.48 | 모두 up-to-date — 같은 worktree `:ci`가 실행 | — | +| main | notification-platform `pr` 5/7 `jpaPlatformContractTest` | 0 | 3분 32초 | 1.44 | 1 executed | 429 (0·0) | +| main | notification-platform `pr` 6/7 `jpaPlatformMigrationTest` | 0 | 1분 20초 | 1.75 | 1 executed | 45 (0·0) | +| main | notification-platform `pr` 7/7 `:adapter:outbound:notification:check -x test` | 0 | 2초 | 1.26 | 1 executed, 28 up-to-date | — | +| main | `bash scripts/run-compose-runtime-smoke.sh --matrix src/config/runtime/compose-profile-contracts.json` | 0 | 12분 6초 | 1.51 | — | 18 lane 모두 통과 | +| 태그 | `:releaseCheck -PgitRevision=48565718…` | 0 | 4초 | 1.26 | 20 executed | 1 (0·0) | +| 태그 | `-p optional-platforms releaseCheck -PgitRevision=48565718…` | 0 | 8초 | 1.24 | 16 executed | 27 (0·0) | + +1. `:mainCheck` 로그의 FROM-CACHE 2줄(`:domain-core:checkstyleMain`·`checkstyleTest`)은 `verifyFeatureScaffold`가 띄우는 중첩 Gradle 빌드(생성 + 명령 왕복용 임시 복사본) 안의 것이다. `--no-build-cache`가 중첩 빌드로 넘어가지 않는다. 바깥 빌드 집계는 FROM-CACHE 0이다. +2. `:ci`의 skip 28은 기준 `2c8a359d`의 통합 게이트(2026-11-07)와 같은 수다. in-memory fake 계약의 시간 케이스 19, app-bootstrap 조건부 adapter + 계약, notification provider sandbox 등 이전부터 있던 것이다. +3. 바뀐 영역 lane이 실제로 돈 것(로그 `> Task` 줄): `postgresqlIdempotencyIntegrationTest`, `postgresqlConcurrentIndexMigrationIntegrationTest`, + `postgresqlMigrationLockWaitIntegrationTest`, `redisContainerContractTest`, `httpClientFailureInjectionTest`, `app-bootstrap:integrationTest` + (`integrationCheck` 안), `:app-bootstrap:documentContractTest`·`verifyEnvKeys`·`verifyPublicPathSnapshot`·`verifyFeatureScaffold`(`mainCheck` 안). +4. `integrationCheck`가 뺀 lane: `redisTopologyTest` ×3(입력 필요 — PR 단계에서 standalone으로 따로 돌림), `objectStorageAwsQualificationTest` + (보호된 AWS sandbox 입력 필요, 못 돌림). +5. `--warning-mode=fail`로 돌린 `:ci`·`:mainCheck` 로그에 Deprecated 경고가 없다(`grep -i deprecat`는 `verifyEnvKeys` 통과 줄 하나만 걸림). + +못 돌린 것과 해당 없는 것: + +- lychee(`link-check.yml`): desktop·노트북에 없다. 같은 범위 상대 링크 검사로 대신했다. 외부 URL은 보지 못했다. +- `ci-quality-gates.yml` `grpc-proto-buf`: buf가 없다. 해당 없음 — diff에 `.proto`·`buf*.yaml`이 없다. +- `dependency-vulnerability.yml` `dependency-review`·`dependency-submission`: GitHub에서만 돈다. 해당 없음 — lockfile·`libs.versions.toml` 변경이 없다. + `trivy-fs`: trivy가 없어 못 돌렸다. +- 경로가 안 걸린 PR workflow: `messaging-certification.yml`, `notification-platform.yml`의 pull request trigger(main push의 `pr` job은 위에서 돌림). +- PR·main 단계가 아닌 것: nightly·수동 전용(`fileserver-nightly`, `jpa-nightly`, `jpa-next`, redis 전체 matrix, MinIO fault, AWS), `release.yml`의 + `releaseCheck` 두 명령 밖 job(이미지·서명 등, 태그 단계).