docs(review): round7 수정을 합친 트리의 게이트와 멈춤 기준을 적는다
문제: 리뷰 README 18.6절은 합치기 전 사실(결함 13건, round7 1차 Declined
12건 미판정, 결정 3건 대기, r10 트리 게이트)에 머물러 있고, 수정 브랜치를
합친 트리를 어떻게 합쳤고 어떤 게이트로 확인했는지 적은 곳이 없다.
방법: 18.6절 네 칸을 2026-11-07 사실로 고친다. Declined는 round6 30건과
round7 1차 12건이 모두 판정돼 0이고, 게이트는 합친 트리에서 통과했다.
발견 15건은 고쳤지만 다음 확인 리뷰가 판정할 몫이라 "아님"으로 둔다.
README 남은 항목은 수정 세션이 범위 밖으로 적은 메모 넷을 그대로 옮긴다.
18.8절에 병합 순서, 충돌 세 곳과 처리, 게이트 표(PR 단계, 경로 필터
lane, main 단계, releaseCheck 둘), 못 돌린 것을 적는다. 버린 대안: 남은
메모를 결함으로 판정해 색인에 넣기 — 이 일은 합치고 검증만 하고, 판정은
확인 리뷰가 한다.
위험·한계: lychee·buf·trivy·GitHub dependency review는 돌리지 못했다
(18.8절에 이유와 대체). mainCheck 안 verifyFeatureScaffold의 중첩 빌드는
--no-build-cache를 넘겨받지 않아 FROM-CACHE 2줄이 남았다.
검증: desktop ~/integration-r8-logs/(pr-summary.txt, main-summary.txt)에서
48565718 대상 명령 46개 rc=0. 이 커밋 뒤 노트북에서
check-work-docs.py 전체·--history docs/manual·lychee 범위 --links(링크 520,
깨짐 0), check-review-index.py(172/172) rc=0, git diff --check 통과.
This commit is contained in:
@@ -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(이미지·서명 등, 태그 단계).
|
||||
|
||||
Reference in New Issue
Block a user