Commit Graph
473 Commits
Author SHA1 Message Date
donghyeon.kang fda918fc25 Merge branch 'main' into docs/improve-review-budget
pr / done (pull_request) Waiting to run
2026-11-18 14:09:56 +00:00
donghyeon.kang cd52397027 Merge pull request 'docs(ledger): 흔들린 시험을 장부에 남기고 시간·순서 단언 규칙을 리뷰 기준에 건다' (#40) from claude/w2-be-flaky-ledger into main
main / build-logic (push) Waiting to run
main / configuration-cache (push) Waiting to run
main / links (push) Waiting to run
main / vulnerabilities (push) Waiting to run
main / http3-experimental (push) Waiting to run
main / jpa-postgresql (16) (push) Waiting to run
main / jpa-postgresql (17) (push) Waiting to run
main / jpa-postgresql (18) (push) Waiting to run
main / httpclient-transport (push) Waiting to run
main / redis-topology (push) Waiting to run
main / fileserver-nfs-ambiguity (push) Waiting to run
main / notification-chaos (push) Waiting to run
main / jpa-next (hibernate-8, Hibernate 8 is not resolvable from this build, so nothing has been compiled or run against it, Hibernate 8, *Hibernate8CompatibilityTest) (push) Waiting to run
main / jpa-next (jakarta-persistence-4, the JPA 4 API is not on any configuration this build resolves, so nothing has been compiled against it, Jakarta Persistence 4, *Jpa4CompatibilityTest) (push) Waiting to run
main / jpa-next (postgresql-19, no PostgreSQL 19 image is published yet, so no container of that major has ever been started by this lane, PostgreSQL 19, *PostgreSql19CompatibilityTest) (push) Waiting to run
main / object-storage-aws (push) Waiting to run
main / compose-smoke (push) Waiting to run
main / done (push) Waiting to run
main / performance (push) Waiting to run
main / main (push) In progress
2026-11-18 14:09:47 +00:00
donghyeon.kang 76436f8b21 Merge branch 'main' into claude/w2-be-flaky-ledger
pr / done (pull_request) Successful in 2m20s
2026-11-18 13:13:53 +00:00
donghyeon.kang 99ca4975cc Merge pull request 'docs(reviews): round9 기록에 B20·B22 발견과 #28 병합을 적는다' (#36) from claude/r9-review-record-2 into main
main / links (push) Successful in 8s
main / main (push) Failing after 15m58s
main / build-logic (push) Successful in 57s
main / configuration-cache (push) Successful in 1m2s
main / vulnerabilities (push) Successful in 16s
main / http3-experimental (push) Successful in 21s
main / jpa-postgresql (16) (push) Skipped
main / jpa-postgresql (17) (push) Skipped
main / jpa-postgresql (18) (push) Skipped
main / httpclient-transport (push) Skipped
main / redis-topology (push) Skipped
main / fileserver-nfs-ambiguity (push) Skipped
main / notification-chaos (push) Skipped
main / jpa-next (hibernate-8, Hibernate 8 is not resolvable from this build, so nothing has been compiled or run against it, Hibernate 8, *Hibernate8CompatibilityTest) (push) Skipped
main / jpa-next (jakarta-persistence-4, the JPA 4 API is not on any configuration this build resolves, so nothing has been compiled against it, Jakarta Persistence 4, *Jpa4CompatibilityTest) (push) Skipped
main / jpa-next (postgresql-19, no PostgreSQL 19 image is published yet, so no container of that major has ever been started by this lane, PostgreSQL 19, *PostgreSql19CompatibilityTest) (push) Skipped
main / object-storage-aws (push) Skipped
main / compose-smoke (push) Skipped
main / done (push) Skipped
main / performance (push) Skipped
2026-11-18 13:13:52 +00:00
donghyeon.kang fd5a285c84 Merge branch 'main' into claude/r9-review-record-2
pr / done (pull_request) Successful in 2m17s
2026-11-18 12:44:07 +00:00
donghyeon.kang a8c6720ad4 Merge pull request 'fix(registries)!: 옮긴 worker 파일을 가리키게 하고 문서 검사가 registry 경로를 본다' (#46) from claude/be-main-red2-metrics into main
main / main (push) Successful in 16m30s
main / build-logic (push) Successful in 56s
main / configuration-cache (push) Successful in 1m5s
main / links (push) Successful in 8s
main / vulnerabilities (push) Successful in 35s
main / http3-experimental (push) Successful in 23s
main / jpa-postgresql (16) (push) Skipped
main / jpa-postgresql (17) (push) Skipped
main / jpa-postgresql (18) (push) Skipped
main / httpclient-transport (push) Skipped
main / redis-topology (push) Skipped
main / fileserver-nfs-ambiguity (push) Skipped
main / notification-chaos (push) Skipped
main / jpa-next (hibernate-8, Hibernate 8 is not resolvable from this build, so nothing has been compiled or run against it, Hibernate 8, *Hibernate8CompatibilityTest) (push) Skipped
main / jpa-next (jakarta-persistence-4, the JPA 4 API is not on any configuration this build resolves, so nothing has been compiled against it, Jakarta Persistence 4, *Jpa4CompatibilityTest) (push) Skipped
main / jpa-next (postgresql-19, no PostgreSQL 19 image is published yet, so no container of that major has ever been started by this lane, PostgreSQL 19, *PostgreSql19CompatibilityTest) (push) Skipped
main / object-storage-aws (push) Skipped
main / compose-smoke (push) Skipped
main / done (push) Skipped
main / performance (push) Skipped
2026-11-18 12:44:06 +00:00
DongHyeonka a00d559c84 ci(docs)!: 문서 검사가 registry YAML이 가리키는 경로도 본다
pr / done (pull_request) Successful in 2m29s
문제: 코드 파일을 옮기는 PR은 docs/registries/*.yaml 행의 source·
registered_by가 옛 경로로 남아도 초록이다. scripts/check-docs.py의 reference
검사는 마크다운만 읽고, 행과 코드를 대조하는 MetricsRegistryCodeAlignmentTest·
HeaderRegistryRuntimeAlignmentTest는 main 단계에서만 돈다. #38이 이렇게
병합돼 main이 빨강이 됐고, main이 빨강인 동안 다른 PR 병합이 모두 멈췄다.

방법: reference 검사가 docs/registries/*.yaml의 줄에서 repo 경로 모양의 낱말
(PATH_ROOTS로 시작, 공백·따옴표·한글에서 끊는다)을 찾아 git이 아는 파일인지
본다. headers.yaml의 "service: src/..." 같은 접두어 붙은 값과 주석의 경로도
같은 규칙으로 잡는다. gates.md 2절에 「지표·헤더를 등록하는 코드를 옮기거나
바꿈 → :app-bootstrap:documentContractTest」 행을 따로 두고, 「지우거나 옮김」
행에 registry YAML을 적는다. docs/README.md 「문서 검사」 표와 관측 업그레이드
안내(14번 행)를 고친다.
버린 대안: (1) 대조 시험을 PR 단계로 옮기기 — 문서 대조는 main 단계라는
결정(2026-09-16)을 바꾸고 Gradle lane 하나를 PR에 더한다. (2) gates.md에
사람이 돌릴 lane만 적기 — #38도 그 표를 따랐어야 했지만 기계가 막지 않으면
다시 샌다.

PR 단계에 두는 이유(gates.md 7절 5번): 이미 PR에서 도는 check-docs.py의
기존 검사가 볼 파일만 넓힌다. 새 태스크·job이 없고 Gradle 없이 1초 안에
끝난다. 옮기는 PR에서 잡지 못하면 main이 빨강이 되어 모든 병합이 멈춘다.

위험·한계: 경로가 있는지만 본다. 파일은 남고 등록 줄만 다른 파일로 옮긴
경우는 여전히 main 단계 document-contract lane이 잡는다(gates.md 새 행).
파생 서비스는 registry 주석에 적은 경로가 없으면 PR에서 새로 실패한다. 주석은
지금까지 어떤 검사도 보지 않았다. source·registered_by는 main 단계 대조
시험에서 이미 실패하던 경로다.

검증: 노트북 `bash scripts/verify.sh docs` rc=0(스크립트 시험 170개 통과).
옛 metrics.yaml에서 `check-docs.py --only reference`가 rc=1로
metrics.yaml:878을 가리킨다. 새 시험 셋은 옛 check-docs.py에서 실패하고, 정규식
변이 셋(따옴표 안 값만 보기, 한글에서 안 끊기, 주석 건너뛰기)이 각각 시험
하나 이상을 실패시킨다.

BREAKING CHANGE: docs/registries/*.yaml의 값과 주석에 적은 repo 경로가 지금
트리에 없으면 PR 단계 documentCheck가 실패한다. 파생 서비스는
`python3 scripts/check-docs.py --only reference`로 자기 행·주석을 확인한다
(docs/upgrade/2026-11-round9-observability.md 14번).
2026-11-18 21:17:34 +09:00
DongHyeonka b43fd78c23 fix(registries): notification.queue.depth 행이 옮긴 worker 파일을 가리킨다
문제: main 99cc4f59(#38 병합) push run의 :app-bootstrap:documentContractTest가
MetricsRegistryCodeAlignmentTest.everyRowNamesTheMainFileThatRegistersIt에서
실패한다. #38의 2d274a684가 NotificationSchedulerWorker를
adapter:outbound:notification(platform/dispatch)에서
composition:notification-platform(composition/notification)으로 옮겼는데,
metrics.yaml의 notification.queue.depth 행 registered_by는 옛 경로를
가리킨다. 이 대조 시험은 main 단계(mainCheck)에서만 돌아 #38의 PR run은
초록이었다. #37은 이 파일을 건드리지 않았다.

방법: 코드가 맞다. 옮긴 것은 #38의 의도한 구조 변경이고 gauge는 새 파일
96줄에서 NotificationMetricName.QUEUE_DEPTH로 등록된다. 그래서 registry의
registered_by만 새 경로로 바꾼다.

같은 모양: #37·#38이 지우거나 옮긴 파일 27개의 옛 경로와 클래스 이름을
살아 있는 문서·registry에서 찾았다. 남은 것은 이 행 하나다.

검증: desktop, 트리 fcc67388, `./gradlew :app-bootstrap:documentContractTest
--rerun --no-build-cache` rc=0, 79개 통과(실패 0). 로그
~/be-main-red2-logs/c-doccontract.log. 수정 전 실패는 main run의 같은 태스크
(79개 중 1개 실패).

Fixes: 2d274a684e3a ("refactor(application)!: 시스템 쓰기와 운영자 연산을 유스케이스 계약 안으로 옮긴다")
2026-11-18 21:03:54 +09:00
donghyeon.kang 48fe719471 Merge branch 'main' into claude/r9-review-record-2
pr / done (pull_request) Successful in 12m28s
2026-11-13 20:15:07 +00:00
donghyeon.kang 99cc4f59ae Merge pull request 'refactor(application)!: 시스템 쓰기와 운영자 연산을 유스케이스 계약 안으로 옮긴다' (#38) from claude/r9-b-application into main
main / main (push) Failing after 24m34s
main / build-logic (push) Successful in 56s
main / configuration-cache (push) Successful in 1m24s
main / links (push) Successful in 9s
main / vulnerabilities (push) Successful in 1m38s
main / http3-experimental (push) Successful in 1m27s
main / jpa-postgresql (16) (push) Skipped
main / jpa-postgresql (17) (push) Skipped
main / jpa-postgresql (18) (push) Skipped
main / httpclient-transport (push) Skipped
main / redis-topology (push) Skipped
main / fileserver-nfs-ambiguity (push) Skipped
main / notification-chaos (push) Skipped
main / jpa-next (hibernate-8, Hibernate 8 is not resolvable from this build, so nothing has been compiled or run against it, Hibernate 8, *Hibernate8CompatibilityTest) (push) Skipped
main / jpa-next (jakarta-persistence-4, the JPA 4 API is not on any configuration this build resolves, so nothing has been compiled against it, Jakarta Persistence 4, *Jpa4CompatibilityTest) (push) Skipped
main / jpa-next (postgresql-19, no PostgreSQL 19 image is published yet, so no container of that major has ever been started by this lane, PostgreSQL 19, *PostgreSql19CompatibilityTest) (push) Skipped
main / object-storage-aws (push) Skipped
main / done (push) Skipped
main / performance (push) Skipped
main / compose-smoke (push) Skipped
2026-11-13 20:15:06 +00:00
donghyeon.kang a9ac254373 Merge branch 'main' into claude/r9-b-application
pr / done (pull_request) Successful in 14m31s
2026-11-13 18:43:52 +00:00
donghyeon.kang 6aac48a3aa Merge pull request 'fix(outbound)!: 발행·SMTP 발송·캐시 시간 상한과 S3·Mongo·HTTP 압축을 맞춘다' (#37) from claude/r9-b-outbound into main
main / main (push) Failing after 25m31s
main / build-logic (push) Successful in 53s
main / configuration-cache (push) Successful in 1m29s
main / jpa-next (hibernate-8, Hibernate 8 is not resolvable from this build, so nothing has been compiled or run against it, Hibernate 8, *Hibernate8CompatibilityTest) (push) Skipped
main / jpa-next (postgresql-19, no PostgreSQL 19 image is published yet, so no container of that major has ever been started by this lane, PostgreSQL 19, *PostgreSql19CompatibilityTest) (push) Skipped
main / object-storage-aws (push) Skipped
main / done (push) Skipped
main / links (push) Successful in 13s
main / vulnerabilities (push) Successful in 1m37s
main / http3-experimental (push) Successful in 1m28s
main / jpa-postgresql (16) (push) Skipped
main / jpa-postgresql (17) (push) Skipped
main / jpa-postgresql (18) (push) Skipped
main / httpclient-transport (push) Skipped
main / redis-topology (push) Skipped
main / fileserver-nfs-ambiguity (push) Skipped
main / notification-chaos (push) Skipped
main / jpa-next (jakarta-persistence-4, the JPA 4 API is not on any configuration this build resolves, so nothing has been compiled against it, Jakarta Persistence 4, *Jpa4CompatibilityTest) (push) Skipped
main / compose-smoke (push) Skipped
main / performance (push) Skipped
2026-11-13 18:43:50 +00:00
donghyeon.kang bb4b1777e0 Merge branch 'main' into claude/r9-b-outbound
pr / done (pull_request) Successful in 13m14s
2026-11-13 17:13:54 +00:00
donghyeon.kang a1391853ac Merge pull request 'test: #34가 남긴 SpotBugs 지적과 벽시계 상한 셋을 고친다' (#43) from claude/r9-main-red-fix into main
main / main (push) Successful in 17m44s
main / build-logic (push) Successful in 1m29s
main / configuration-cache (push) Successful in 1m20s
main / links (push) Successful in 13s
main / vulnerabilities (push) Successful in 1m58s
main / http3-experimental (push) Successful in 1m55s
main / jpa-postgresql (16) (push) Skipped
main / jpa-postgresql (17) (push) Skipped
main / jpa-postgresql (18) (push) Skipped
main / httpclient-transport (push) Skipped
main / notification-chaos (push) Skipped
main / jpa-next (hibernate-8, Hibernate 8 is not resolvable from this build, so nothing has been compiled or run against it, Hibernate 8, *Hibernate8CompatibilityTest) (push) Skipped
main / jpa-next (postgresql-19, no PostgreSQL 19 image is published yet, so no container of that major has ever been started by this lane, PostgreSQL 19, *PostgreSql19CompatibilityTest) (push) Skipped
main / redis-topology (push) Skipped
main / fileserver-nfs-ambiguity (push) Skipped
main / jpa-next (jakarta-persistence-4, the JPA 4 API is not on any configuration this build resolves, so nothing has been compiled against it, Jakarta Persistence 4, *Jpa4CompatibilityTest) (push) Skipped
main / object-storage-aws (push) Skipped
main / compose-smoke (push) Skipped
main / done (push) Skipped
main / performance (push) Skipped
2026-11-13 17:13:53 +00:00
DongHyeonka e2cd451fb5 docs(work): 확인 리뷰에 예산 확인 지점과 실패한 단계 검증을 더한다
pr / done (pull_request) Successful in 13m51s
개선 playbook에는 확인 리뷰를 몇 번까지 돌리는지, 한 번에 얼마나 쓰는지
정한 곳이 없다. 멈춤 기준(4.5절)은 발견 0 하나라 brief가 예산 없이
"발견 0까지"를 시키면 소유자가 멈출 때까지 사용량을 쓴다. 2026-11
전체 리뷰와 수정이 주간 사용량의 절반(50%)을 썼고, 전 범위 첫 파동이
리뷰어 비용의 80%, 이후 파동이 2%였다. 또 main 단계 실패의 고침을
PR 단계 검증(verify.sh pr)만 보고 닫아 main 전용 SpotBugs가 새로
빨개졌다.

위임 루프 운영 12절(design-docs 사용량 회고 PR)을 이 playbook에 맞춘다.
- 2절: 열린 끝 일은 brief의 예산·멈출 기준을 받는다. 없으면 묻는다.
- 4.1: 전 범위 리뷰는 라운드마다 한 번, 그 뒤는 직전 수정 diff만.
  새 눈 리뷰는 PR당 한 번 + 고친 뒤 확인 한 번.
- 4.2 9단계와 9절: main·nightly 실패는 그 단계의 태스크를 돌려 rc를
  본다. PR 단계 검증으로 닫지 않는다.
- 4.5: 예산은 멈춤 기준이 아니라 확인 지점이다. 닿았는데 넷이 아직
  아니면 멈추고 남은 발견·쓴 양을 보고해 계속할지 묻는다.

고른 방법: 소유자가 거둔 "새 Important 0이면 멈춤" 같은 다른 멈춤
기준을 되살리지 않았다. 예산은 기준을 낮추지 않고 계속할지 묻는
지점만 더한다. 라운드 상한을 멈춤 기준으로 두는 안은 버렸다.

위험·한계: 4.5절의 "발견 0" 기준 자체는 그대로다. 예산에 닿으면 사람
결정이 한 번 더 들어간다. 위임 루프 운영 12절은 cold-read 시험 전이라
이 줄도 시험 전이다.

검증: scripts/verify.sh docs rc=0(improve.md 148/150, 진입 경로 한도 안,
이력 ID 0, 상대 링크 168개). 노트북 laptop-gate로 돌렸다.

Refs: design-docs delegation-loop/retro/2026-11-13-usage-waste.md
2026-11-13 22:38:04 +09:00
DongHyeonka a03cca738d test: #34가 남긴 SpotBugs 지적과 벽시계 상한 셋을 고친다
pr / done (pull_request) Successful in 12m33s
main 단계의 :adapter:inbound:graphql:spotbugsSystemTest가 #34의
`var unused = release.await(...)`를 DLS_DEAD_LOCAL_STORE로 잡아 main이
빨갛다. 이 태스크는 main 단계에만 있어 PR run에서 보이지 않았다.
latch의 반환값을 쓰고, 풀려나지 않고 시한까지 간 호출 수를 센다.

#34가 벽시계 시험을 고칠 때 httpclient 셋이 빠졌다. 셋 다 시한에 0.5초
여유를 둔 상한이라 부하 아래에서 원인과 상관없이 실패한다(Jetty 시험이
부하 11~15에서 1.68초 > 1.5초). #34와 같은 방식으로 고친다.
- 재는 구간을 호출 하나로 좁힌다(준비 시간을 뺀다).
- 상한은 시한 + 3초이고, 그 상한이 서버의 흘림·지연보다 작다는 것을
  함께 단언한다(작지 않으면 상한이 아무것도 증명하지 못한다).
- 늦은 헤더의 지연은 mock 서버의 종료 대기(5초)보다 짧게 둔다.

Refs: RR9-03-36
2026-11-13 21:13:57 +09:00
donghyeon.kang c1338beaa8 Merge pull request 'test(persistence-jpa): 동시 writer 시험이 replay 순서를 받은 위치 순서로 본다' (#39) from claude/r9-live-event-order into main
main / main (push) Failing after 23m6s
main / build-logic (push) Successful in 1m43s
main / links (push) Successful in 10s
main / vulnerabilities (push) Successful in 2m11s
main / http3-experimental (push) Successful in 44s
main / jpa-postgresql (16) (push) Skipped
main / redis-topology (push) Skipped
main / fileserver-nfs-ambiguity (push) Skipped
main / notification-chaos (push) Skipped
main / configuration-cache (push) Successful in 1m32s
main / jpa-postgresql (17) (push) Skipped
main / jpa-postgresql (18) (push) Skipped
main / httpclient-transport (push) Skipped
main / jpa-next (hibernate-8, Hibernate 8 is not resolvable from this build, so nothing has been compiled or run against it, Hibernate 8, *Hibernate8CompatibilityTest) (push) Skipped
main / jpa-next (jakarta-persistence-4, the JPA 4 API is not on any configuration this build resolves, so nothing has been compiled against it, Jakarta Persistence 4, *Jpa4CompatibilityTest) (push) Skipped
main / jpa-next (postgresql-19, no PostgreSQL 19 image is published yet, so no container of that major has ever been started by this lane, PostgreSQL 19, *PostgreSql19CompatibilityTest) (push) Skipped
main / object-storage-aws (push) Skipped
main / compose-smoke (push) Skipped
main / done (push) Skipped
main / performance (push) Skipped
2026-11-13 11:43:52 +00:00
DongHyeonka 5f0bf17bd2 docs(ledger): PR 단계 Jetty attempt deadline 시험의 흔들림을 더한다
pr / done (pull_request) Successful in 13m24s
desktop에서 main c7a18ec7의 prCheck를 돌렸을 때(시작 부하 11~15)
JettyAttemptDeadlineTest#aSlowDripExchangeIsAbortedAtTheAttemptDeadline이
1.68초로, 상한 1.5초를 넘어 실패했다. #34가 고친 벽시계 시험 범위 밖에 남은
것이다. 고치는 일은 벽시계 시험을 맡은 쪽에 넘겼다.

검증: python3 -m unittest scripts/tests/test_ledger.py 통과.
2026-11-13 20:42:21 +09:00
DongHyeonka 88d35f7936 docs(ledger): 흔들린 시험을 장부에 남기고 시간·순서 단언 규칙을 리뷰 기준에 건다
pr / done (pull_request) Canceled after 0s
2026-11-12~13 백엔드 runner에서 흔들린 시험은 넷이다. 그런데 기록이 공유
노트와 세션 메시지에 흩어져 있다. 같은 모양(벽시계 상한, 스레드 시작
순서)이 다시 들어와도 리뷰 기준에는 「스레드 없음」 단언만 적혀 있어서
막을 근거가 없다.

- `docs/ledger/flaky-tests.jsonl`: 흔들림 하나가 한 줄이다. 칸과 범주의
  정본은 design-docs `ci/manual.md` 8.5절이다. 첫 네 줄:
  - compose 기동 경쟁(run 100, #13으로 고침)
  - gRPC 서버 deadline(run 221, #34)
  - HTTP client slow drip JDK(run 228, #34)
  - JPA 동시 writer replay 순서(run 260, #39 열림)
  `.gitattributes`에 `merge=union`을 준다. `scripts/tests/test_ledger.py`가
  칸·범주·날짜 형식을 본다.
- review-criteria.md 「타이밍에 기대지 않나」: 벽시계 상한 단언과 스레드
  시작 순서 단언을 더하고, 매뉴얼 8.4절을 가리킨다.
- gates.md 「원래 있던 실패 가리기」: 반복마다 시작 부하를 적게 한다.
  runner 실패면 그 시각에 잠금 아래 돈 desktop 실행도 적는다(runner는
  잠금 밖이다). 흔들림이면 장부에 한 줄을 더하고, 상한을 늘리거나 재시도를
  붙이지 않고 8.4절대로 고친다.

PR #12가 실패했다는 HTTP/2 흔들림은 넣지 않았다. 그 PR의 runner run은
모두 cancelled라 어느 시험인지 특정할 수 없다.

검증: scripts/verify.sh docs(노트북) rc=0. test_ledger의 새 시험이 잘못된
범주를 잡는지 한 줄을 바꿔 실패를 확인하고 되돌렸다.

Refs: design-docs ci/03-time-reduction-plan.md FLAKY-1
2026-11-13 19:46:21 +09:00
donghyeon.kang 0519eb5c83 Merge branch 'main' into claude/r9-review-record-2
pr / done (pull_request) Successful in 12m16s
2026-11-13 10:13:48 +00:00
donghyeon.kang 46e6a7eff5 Merge branch 'main' into claude/r9-b-application
pr / done (pull_request) Successful in 11m55s
2026-11-13 09:42:58 +00:00
donghyeon.kang bf5a517ff2 Merge branch 'main' into claude/r9-b-outbound
pr / done (pull_request) Successful in 13m20s
2026-11-13 09:42:56 +00:00
donghyeon.kang aaa85c2a3b Merge branch 'main' into claude/r9-live-event-order
pr / done (pull_request) Successful in 14m1s
2026-11-13 09:42:54 +00:00
donghyeon.kang c7a18ec7fa Merge pull request 'fix(objectstorage): 포트 계약 시험을 두고 그 시험이 찾은 결함을 고친다' (#35) from claude/r9-objstore-contract into main
main / vulnerabilities (push) Successful in 1m10s
main / http3-experimental (push) Successful in 2m38s
main / jpa-postgresql (16) (push) Skipped
main / jpa-postgresql (17) (push) Skipped
main / jpa-next (hibernate-8, Hibernate 8 is not resolvable from this build, so nothing has been compiled or run against it, Hibernate 8, *Hibernate8CompatibilityTest) (push) Skipped
main / jpa-next (jakarta-persistence-4, the JPA 4 API is not on any configuration this build resolves, so nothing has been compiled against it, Jakarta Persistence 4, *Jpa4CompatibilityTest) (push) Skipped
main / jpa-postgresql (18) (push) Skipped
main / httpclient-transport (push) Skipped
main / redis-topology (push) Skipped
main / fileserver-nfs-ambiguity (push) Skipped
main / notification-chaos (push) Skipped
main / jpa-next (postgresql-19, no PostgreSQL 19 image is published yet, so no container of that major has ever been started by this lane, PostgreSQL 19, *PostgreSql19CompatibilityTest) (push) Skipped
main / object-storage-aws (push) Skipped
main / compose-smoke (push) Skipped
main / done (push) Skipped
main / performance (push) Skipped
main / main (push) Failing after 30m35s
main / build-logic (push) Successful in 1m21s
main / configuration-cache (push) Successful in 2m21s
main / links (push) Successful in 16s
2026-11-13 09:42:52 +00:00
DongHyeonka 9fc881be27 test(persistence-jpa): 동시 writer 시험이 replay 순서를 받은 위치 순서로 본다
pr / done (pull_request) Canceled after 0s
문제: LiveEventLogContractTest의 「두 writer 동시 쓰기」 시험은 두 writer를
latch 하나로 동시에 푼다. 위치는 순서 없이 1·2인지 보면서, replay는
from-first, from-second 순서로 단언한다. 「먼저 제출한 writer가 1번을
받는다」고 가정하는 셈이다. 어느 writer가 allocator에 먼저 닿는지는
스케줄러가 정한다. 그래서 부하 아래에서는 second가 1번을 받고 시험이
실패한다(main 검사 run 260, d32b4b53, 434건 중 1건). 2026-09-29부터 있던
흔들림이다.

고른 방법: 각 Future가 돌려준 위치를 키로 값을 TreeMap에 모은다. 키가
정확히 1·2인지 보고, replay 순서가 위치 순서로 정렬한 값과 같은지 본다.
이 시험이 지키는 성질은 「위치가 겹치지 않고 replay가 위치 순서를 따른다」
이다. 스레드 시작 순서는 지키는 성질이 아니다. 고친 메서드의 영어
@DisplayName은 테스트 작성 규칙대로 한국어로 바꿨다.

버린 대안:
- latch를 둘로 나눠 writer 순서를 강제한다. 동시에 쓰는 경우를 더는 보지
  않게 되어 이 시험의 목적이 사라진다.
- replay를 순서 없이(containsExactlyInAnyOrder) 본다. replay가 위치 순서를
  따르는지를 놓친다.

같은 모양 찾기: 백엔드 시험 source set 전체에서 동시에 일을 푸는 파일
(CountDownLatch·CyclicBarrier·Phaser·Executors·invokeAll·supplyAsync·
runAsync)과 순서 단언(containsExactly·get(0)·getFirst)이 함께 있는 파일을
grep으로 골라 읽었다. 이 시험을 빼면 27개다. 모두 앞 단계를 latch로
기다려 순서를 강제하거나, 개수·집합으로 보거나, 한 스레드가 정한 순서를
본다. 스레드 시작 순서를 결과 순서로 단언하는 곳은 이 시험 하나였다.

위험·한계: 시험 코드만 바뀐다. production 동작은 그대로다. 찾기는 위
이름 목록에 기댄다. 다른 방식으로 스레드를 만드는 시험은 보지 않았다.

검증(desktop, --no-build-cache):
- RED 탐침(main + second가 먼저 위치를 잡게 강제): jpaPlatformContractTest
  --tests '*LiveEventLogContractTest' rc=1. 실패는 replay 단언 하나이고
  실제 값은 [from-second, from-first]다. main 검사 run 260과 같은 실패다.
- 고친 시험 + 같은 강제 순서: rc=0(11건 실패 0).
- 고친 시험 클래스 --rerun 5회: 모두 rc=0.
- :adapter:outbound:persistence-jpa:jpaPlatformContractTest 필터 없이:
  rc=0(434건 실패 0).
- scripts/verify.sh pr --no-cache: rc=0(트리 461ffa24, 6905건 실패 0,
  skip 35, FROM-CACHE 0).

Refs: main 검사 #148(run 260, d32b4b53)
2026-11-13 18:41:55 +09:00
donghyeon.kang f9d0cf351b Merge branch 'main' into claude/r9-b-application
pr / done (pull_request) Canceled after 0s
2026-11-13 07:58:25 +00:00
donghyeon.kang 6c4dfe6188 Merge branch 'main' into claude/r9-b-outbound
pr / done (pull_request) Canceled after 0s
2026-11-13 07:58:23 +00:00
donghyeon.kang 69e2dd8edf Merge branch 'main' into claude/r9-review-record-2
pr / done (pull_request) Successful in 13m0s
2026-11-13 07:58:22 +00:00
donghyeon.kang 228f20391a Merge branch 'main' into claude/r9-objstore-contract
pr / done (pull_request) Successful in 12m57s
2026-11-13 07:58:21 +00:00
donghyeon.kang d32b4b53de Merge pull request 'test: 부하 아래에서 흔들리던 벽시계 시험을 원인 단언과 gate로 고친다' (#34) from claude/r9-wallclock-tests into main
main / main (push) Failing after 24m51s
main / build-logic (push) Successful in 2m6s
main / links (push) Successful in 11s
main / configuration-cache (push) Successful in 1m42s
main / vulnerabilities (push) Successful in 1m6s
main / http3-experimental (push) Successful in 1m21s
main / jpa-postgresql (16) (push) Skipped
main / jpa-postgresql (17) (push) Skipped
main / jpa-postgresql (18) (push) Skipped
main / httpclient-transport (push) Skipped
main / redis-topology (push) Skipped
main / fileserver-nfs-ambiguity (push) Skipped
main / notification-chaos (push) Skipped
main / jpa-next (hibernate-8, Hibernate 8 is not resolvable from this build, so nothing has been compiled or run against it, Hibernate 8, *Hibernate8CompatibilityTest) (push) Skipped
main / jpa-next (jakarta-persistence-4, the JPA 4 API is not on any configuration this build resolves, so nothing has been compiled against it, Jakarta Persistence 4, *Jpa4CompatibilityTest) (push) Skipped
main / jpa-next (postgresql-19, no PostgreSQL 19 image is published yet, so no container of that major has ever been started by this lane, PostgreSQL 19, *PostgreSql19CompatibilityTest) (push) Skipped
main / object-storage-aws (push) Skipped
main / compose-smoke (push) Skipped
main / done (push) Skipped
main / performance (push) Skipped
2026-11-13 07:58:19 +00:00
donghyeon.kang dedafd5de1 Merge branch 'main' into claude/r9-b-application
pr / done (pull_request) Canceled after 0s
2026-11-13 07:37:44 +00:00
DongHyeonka 2d274a6842 refactor(application)!: 시스템 쓰기와 운영자 연산을 유스케이스 계약 안으로 옮긴다
pr / done (pull_request) Canceled after 0s
시스템이 부르는 쓰기가 유스케이스 계약 밖에 있다. fileserver 정리·맞추기,
알림 claim·발송·lease 회복·맞추기·provider event replay는 capability도
트랜잭션 선언도 없는 서비스를 worker가 바로 부르고, 그 worker와 조립은
outbound adapter 안에 있다. 알림 운영자 연산 넷은 permission 없이 서비스
하나에 모여 있고 재시도 시각은 상수다. web stream bridge는 outbound가
구현한 replay 포트를 바로 읽는다. fileserver 관리 HTTP 기본값은
controller가 정한다.

고른 방법: 시스템 쓰기는 @SystemInvoked 유스케이스로 나누고 composition
worker 설정이 new로 만든다(bean 아님). 알림 worker와 fileserver 정리 조립은
composition으로 옮기고, 맞추기의 재시도·포기 시점은 유스케이스가 정한다.
운영자 연산은 platform.admin의 유스케이스 클래스 넷과 notification-admin:*
permission이다(port.in 인터페이스는 port.in과 admin의 cycle을 만들어 두지
않는다). replay 읽기는 조회 유스케이스 둘을 거치고 포트는
LiveEventReplayQueryPort로 이름을 바꾼다. 아키텍처 규칙 둘: 사용자 전송은
저장·id 포트를 쥐지 못하고, inbound는 application 서비스·coordinator를
interface로도 쥐지 못한다. 재시도 시각은 설정, 관리 기본값은 command
팩터리다. 재시도 시각의 규칙은 policy의 값 RetryTiming 하나가 갖고 설정은
그 값을 만든다. retry·routing 값들은 서버가 만드는 값이라 잘못된 값을
IllegalStateException으로 거절한다(manual 06). 모듈 기본값이 role notification-admin에 운영자 permission
넷을 준다(fileserver의 ROLE_FILE_ADMIN과 같다). 버린 대안: 서비스에
@UseCaseCapability만 달기(사용자와 시스템이 같은 진입점을 나눠 써서 권한
규칙이 막지 못한다), 운영자 서비스 삭제, 설정에서 policy를 만들어 버리며
검증하기(규칙이 바뀐 policy bean과 상관없이 남는다).

위험·한계: 공개 타입·생성자·bean 이름·아키텍처 규칙이 바뀐다. 파생
서비스가 할 일은 docs/upgrade/2026-11-round9-application.md 1~3·5·6행이다.
claim·fence 커밋 위에 쌓았다.

검증: PR 본문의 desktop 결과.

Refs: RR9-05-06, RR9-05-07, RR9-05-08, RR9-05-10, RR9-05-19
BREAKING CHANGE: NotificationAdminService·NotificationAdminApplicationService가 없어지고 운영자 연산은 platform.admin의 RedriveDeliveryUseCase 등이다(permission notification-admin:*). 알림 worker가 composition:notification-platform으로 옮기고 ReconciliationJobWorker·ProviderEventReplayWorker는 유스케이스가 됐다. MessagingReplayBridge 생성자가 조회 유스케이스를 받고 LiveEventReplayPort는 LiveEventReplayQueryPort다. 사용자 전송이 저장·id 포트나 application 서비스 interface를 쥐면 architectureTest가 실패한다. 운영자 요청 record 이름이 *Request로 바뀌고 DefaultNotificationRetryPolicy 생성자가 RetryTiming을 받는다. RetryBackoff·RetryBudget·RetryContext·RetryDecision.RetryAfter·RouteCandidate·RoutingContext·RoutingDecision·EligibilityResult가 잘못된 값에 IllegalStateException을 던진다.
2026-11-13 16:37:03 +09:00
DongHyeonka e60408e931 refactor(application)!: durable operation 타입을 맞추고 안 쓰는 타입을 지운다
durable operation은 core 공통 타입을 따르지 않는다. tenant·principal이
문자열이고 operation id는 controller가 만들며, UUIDv7 파생은 유스케이스가
한다. operation id 문법이 셋인데 이유가 없고, 멱등 판정 셋 중 둘이
executor를 쓰지 않는 이유도 없다. 쓰는 곳 없는 공개 타입이 일곱이고,
final 유스케이스가 둘이며, 포트 둘은 실패 결과를 적지 않았고, 소스
문자열에 NUL 바이트가 있다.

고른 방법: OperationCommand·query·command가 Optional<TenantId>를 받고
SubmitDurableOperationUseCase가 DurableOperationIdFactory로 id를 만든다.
UUIDv7 파생은 IntegrationIdentity로 옮긴다. id 문법 셋은 다니는 곳(URL
경로, header·Redis key, 비교만)이 달라 합치지 않고 OperationId Javadoc에
비교를 적는다. executor를 쓰지 않는 중복 판정 둘은 manual 05에 결정으로
적는다. 안 쓰는 타입은 지우고, final을 떼고, 실패 결과 Javadoc을 쓰고,
NUL은 \u0000으로 쓴다. final을 뗀 유스케이스는 SpotBugs
CT_CONSTRUCTOR_THROW에 걸려, config/spotbugs/exclude.xml의 CGLIB 그룹을
@UseCaseCapability가 붙은 *UseCase class까지 넓힌다(유스케이스 계약이 final을
금한다). 버린 대안: operation id 값 타입 하나로 통일(path
segment가 '/'를 실을 수 있게 되거나 지금 유효한 caller id를 거절한다).

위험·한계: 공개 생성자와 타입이 바뀐다. 파생 서비스가 할 일은
docs/upgrade/2026-11-round9-application.md 1·2행이다(최종 안내에서는 4·7행).

검증: PR 본문의 desktop 결과.

Refs: RR9-05-11, RR9-05-12, RR9-05-13, RR9-05-14, RR9-05-15, RR9-05-16, RR9-05-17, RR9-05-18
BREAKING CHANGE: OperationCommand·GetDurableOperationQuery·CancelDurableOperationCommand의 tenant가 Optional<TenantId>이고 OperationCommand에 operation id 인자가 없다. SubmitDurableOperationUseCase 생성자가 DurableOperationIdFactory를 받는다. ReadConsistency, FileserverSpans, ProviderEventId, NotificationExpiredException, BatchNotificationProviderAdapter, CollapseCapability, ProviderCollapseMapping을 지웠다.
2026-11-13 16:37:03 +09:00
donghyeon.kang 85340dd994 Merge branch 'main' into claude/r9-b-outbound
pr / done (pull_request) Canceled after 0s
2026-11-13 07:22:04 +00:00
DongHyeonka 931178760a fix(outbound)!: S3 조건부 쓰기·MongoDB 예산과 lease·HTTP 압축을 맞춘다
pr / done (pull_request) Canceled after 0s
S3 control 저장소는 SDK가 응답을 잃고 다시 보낸 조건부 PUT의 412를
충돌로 본다. MongoDB 집계는 결과 바이트 예산을 보지 않고 전부 메모리에
올린다. tenant client registry는 쓰는 중인 client를 내보내고, 내보내다
닫기에 실패하면 다른 tenant의 acquire가 실패한다. migration lease를 잃은
runner가 그 뒤에도 checkpoint를 쓴다. HTTP client는 SOCKS proxy를 HTTP로
붙이고, 압축을 켜면 Apache는 스스로 풀어 max-wire-bytes가 푼 크기를
세며, JDK transport는 그 설정을 읽지 않는다.

고른 방법: S3는 412에서 다시 읽어 이 호출이 쓴 record 그대로면 성공으로
본다. 집계는 $limit(maxResults + 1)과 maxResultBytes를 집행한다. registry
acquire는 Lease를 돌려주고 쓰는 중에는 내보내지 않으며 idle은 마지막
close부터 잰다. 상한·lease 수·내보내기는 registry 밖에서 잡을 수 없는 전용
lock 하나로 묶는다. 닫기 실패는 evictionCloseFailures가 센다. migration
ledger는 lock 문서의 현재 fence로 쓴다. ProxyType은 HTTP만 남긴다.
압축은 RestClient 기본 헤더로 보내고 ContentDecoding이 버퍼·스트리밍
본문을 모두 푼다(겹친 coding과 그 밖의 coding은 거부, 빈 본문은 빈
본문). Jetty HTTP/3는 기동 뒤 decoder를 비운다. 버린 대안: SOCKS 지원
(transport 셋 중 하나만 된다), transport마다 자동 풀기(크기 상한이
transport마다 달라진다), 집계를 RawBsonDocument로 재기(converter를 거치지
않으면 반환 타입 mapping이 갈라진다).

위험·한계: MongoTenantClientRegistry.acquire 반환형과 ProxyType이 바뀐다.
S3에서 두 writer가 같은 버전에서 같은 record를 쓰면 둘 다 성공으로 본다
(Javadoc과 안내 3절). 집계 결과는 converter로만 바뀌어 entity callback이
돌지 않는다. evictionCloseFailures 지표는 지표 묶음에 넘긴다.

검증: desktop RED(pr2-red2). GREEN은 PR 본문의 verify.sh pr 결과.

Refs: RR9-01-08, RR9-01-11, RR9-01-19, RR9-01-20, RR9-01-27, RR9-01-28, RR9-01-30, RR9-01-31
BREAKING CHANGE: MongoTenantClientRegistry.acquire가 Lease를 돌려주고, migration lease를 잃은 refresh가 MongoOperationRejectedException을 던진다. HTTP client ProxyType.SOCKS가 없어져 그 설정은 바인딩이 실패한다. request.compression이 모든 transport에서 같은 coding만 받는다. docs/upgrade/2026-11-round9-outbound.md
2026-11-13 16:21:16 +09:00
DongHyeonka 154cb4b795 fix(outbound)!: 발행 대기·SMTP 발송·캐시 시간 상한을 지킨다
outbox 발행 대기가 publish()가 돌아온 뒤부터 재서, 호출을 붙잡은
publisher는 longestAttempt를 넘겨도 relay를 묶는다. SMTP 발송 pool은
대기열이 찰 때까지 thread 하나로 돌고, profile들의 max-concurrency가 pool이
담는 수를 넘어도 기동한다. 넘친 발송은 결과 불명으로 남는다. SMTP
profile timeout은 명령 하나만 묶어, 느린 relay에서 발송이 lease를 넘으면
lease 복구가 아직 도는 발송을 운영자 확인으로 넘긴다. Redis 캐시
command-timeout에 lane 대기 2초가 더해지고, 값 크기 상한은 설정할 길이
없다.

고른 방법: 발행 대기 마감은 publish() 전에 잡고 남은 시간만 기다린다.
기다리는 중 interrupt는 결과 불명, 이미 interrupt된 thread와 0 이하
longestAttempt는 보내지 않고 REJECTED_RETRYABLE로 돌려준다. SMTP pool은
dispatch-concurrency개 thread와 그 네 배 대기열로 고정한다. 한 family의
켜진 profile 전체를 보는 ProviderRuntimeAssembler.requireTogether를 두고,
SMTP는 max-concurrency 합이 pool보다 크거나 lease가 timeout 두 배 이하면
조립을 실패시킨다. profile timeout은 발송 한 번을 두 번 묶는다:
pool 대기가 넘으면 보내지 않고 재시도, 발송이 넘으면 PROVIDER_RESPONSE_LOST
로 남겨 다시 보내지 않는다. 두 시한은 completeOnTimeout이라 취소된다.
기본 timeout은 10초에서 30초로, socket timeout 합보다 길어야 한다.
Redis 연산 전체를 command-timeout 하나로 묶고
app.capabilities.cache.maximum-value-bytes를 다시 묶는다(1..16 MiB).
버린 대안: 발송 timeout에 재시도(같은 메일을 두 번 보낼 수 있다), 캐시
상한을 상수로 두기(큰 값을 쓰는 서비스가 바꿀 길이 없다), assembler가
assemble마다 합을 누적하기(조립 순서에 상태가 남는다).

위험·한계: 기동 조건이 늘었다(SMTP max-concurrency 합, lease와 SMTP
timeout, 캐시 값 상한 범위). 대기 시한이 돌려주는 stage는 일부러 버린다
(Error Prone 규칙대로 `unused`에 받고, SpotBugs DLS는 config/spotbugs/
exclude.xml에 그 메서드만 제외한다. Jetty abortAtDeadline 선례). send pool을 바꿔 끼운 배포는 부른 thread에서
돌리지 않는 executor여야 한다. outbox 새 거절 코드의 runbook 줄은 runbook
묶음에 넘긴다. claim·fence 커밋 위에 쌓았다.

검증: desktop RED(고치기 전 트리 + 새 시험, pr2-red2) 새 시험 실패.
GREEN은 PR 본문의 verify.sh pr 결과.

Refs: RR9-01-05, RR9-01-15, RR9-01-16, RR9-01-17, RR9-01-18
BREAKING CHANGE: SMTP profile들의 max-concurrency 합이 send pool(thread와 대기열)을 넘거나 dispatch.lease-duration이 SMTP timeout의 두 배 이하면 기동이 실패한다. SMTP 기본 timeout이 30초이고, 넘은 발송은 결과 불명이 된다. SmtpNotificationProviderAdapter 생성자가 timeout을 받는다. Redis 캐시 값이 maximum-value-bytes(기본 1 MiB)를 넘으면 기록하지 않는다. docs/upgrade/2026-11-round9-outbound.md
2026-11-13 16:21:16 +09:00
donghyeon.kang b81c1ffca0 Merge branch 'main' into claude/r9-review-record-2
pr / done (pull_request) Canceled after 0s
2026-11-13 06:29:01 +00:00
donghyeon.kang e742e47921 Merge branch 'main' into claude/r9-objstore-contract
pr / done (pull_request) Canceled after 4m7s
2026-11-13 06:28:59 +00:00
donghyeon.kang b183a4f48e Merge branch 'main' into claude/r9-wallclock-tests
pr / done (pull_request) Successful in 12m59s
2026-11-13 06:28:57 +00:00
donghyeon.kang 5f8fc814bb Merge pull request 'fix(observability)!: 관측 registry를 코드와 맞추고 로그 내용·로컬 비밀 기본값을 고친다' (#32) from claude/r9-a-obs-logs into main
main / main (push) Successful in 30m5s
main / build-logic (push) Successful in 1m45s
main / configuration-cache (push) Successful in 1m42s
main / links (push) Successful in 24s
main / vulnerabilities (push) Successful in 1m24s
main / http3-experimental (push) Successful in 1m45s
main / jpa-postgresql (16) (push) Skipped
main / jpa-postgresql (17) (push) Skipped
main / jpa-postgresql (18) (push) Skipped
main / httpclient-transport (push) Skipped
main / redis-topology (push) Skipped
main / fileserver-nfs-ambiguity (push) Skipped
main / notification-chaos (push) Skipped
main / jpa-next (hibernate-8, Hibernate 8 is not resolvable from this build, so nothing has been compiled or run against it, Hibernate 8, *Hibernate8CompatibilityTest) (push) Skipped
main / jpa-next (jakarta-persistence-4, the JPA 4 API is not on any configuration this build resolves, so nothing has been compiled against it, Jakarta Persistence 4, *Jpa4CompatibilityTest) (push) Skipped
main / jpa-next (postgresql-19, no PostgreSQL 19 image is published yet, so no container of that major has ever been started by this lane, PostgreSQL 19, *PostgreSql19CompatibilityTest) (push) Skipped
main / object-storage-aws (push) Skipped
main / compose-smoke (push) Skipped
main / done (push) Skipped
main / performance (push) Skipped
2026-11-13 06:28:56 +00:00
DongHyeonka d95e8dc0f9 docs(upgrade): objectstorage 포트 계약이 바꾼 결과를 파생 서비스에 알린다
pr / done (pull_request) Canceled after 0s
실패한 managed 게시를 다시 하면 APPLIED가 되고, 중단한 stage의 재검증은
IllegalStateException이 되며, 불변 Set capability가 동작한다. 이 셋과
testFixtures의 fake·계약을 쓰는 법을 업그레이드 안내에 적는다.

Refs: RR9-03-31, RR9-03-33, RR9-03-35
2026-11-13 15:09:33 +09:00
DongHyeonka 207d688cbe docs(reviews): round9 기록에 B20·B22 발견과 #28 병합을 적는다
pr / done (pull_request) Canceled after 0s
B20(objectstorage 포트 계약)을 고치며 찾은 다섯 건(RR9-03-33~35,
RR9-04-46·47)과 main 단계 실패를 따라가 찾은 벽시계 시험 한 건
(RR9-03-36)을 색인과 영역 문서에 더한다. #17·#19~#27이 #28로 함께
병합된 사실, 그룹 A·B와 B20·B22의 PR 번호, 소유자가 뒤집을 수 있는
결정 ⑧·⑨를 적는다.

Refs: RR9-03-31, RR9-03-33, RR9-03-34, RR9-03-35, RR9-03-36, RR9-04-46, RR9-04-47
2026-11-13 15:04:39 +09:00
DongHyeonka 3e1c629d1f docs(rules): 공유 계약 테스트는 포트가 선언한 것만 단언한다
pr / done (pull_request) Canceled after 0s
시험 규칙 5는 예외 메시지까지 단언하라고 했다. fake와 adapter가 함께
상속하는 계약에서는 메시지가 구현마다 달라 그 규칙을 따를 수 없다.
TESTING_STRATEGY 9.4가 이미 그렇게 정했는데 규칙 문서가 가리키지 않아,
다음 작성자가 메시지 단언을 다시 넣을 수 있었다.

Refs: RR9-03-31
2026-11-13 15:02:10 +09:00
donghyeon.kang 62b4379fbf Merge branch 'main' into claude/r9-wallclock-tests
pr / done (pull_request) Canceled after 0s
2026-11-13 05:57:43 +00:00
DongHyeonka fdf775f636 test: 부하 아래에서 흔들리던 벽시계 시험을 원인 단언과 gate로 고친다
pr / done (pull_request) Canceled after 0s
문제: main 단계 CI는 desktop heavy lock 밖에서 부하 14~25 아래 돈다. main push run
221은 gRPC GrpcP1BoundaryWireTest 서버 기본 deadline 시험이 다른 status를, run 228은
httpclient FailureInjectionContractTest slow drip이 1.92s(상한 1.5s)를 내 빨갰다.
main 단계 lane을 전수로 보니 같은 부류가 더 있었다. 상한이 설정 예산에 바짝
붙었거나(예산+0.5s), 잰 구간에 준비 작업(컨테이너 기동, Flyway 준비, 첫 연결)이
들어가거나, 「아직 도는 동안」을 짧은 sleep·점유 시간으로 만든 시험들이다.

고친 것(시험만):
- httpclient slow drip: 상한 예산+4s(drip 전체 12.8s의 절반 아래임을 함께 단언),
  잰 구간에서 harness 닫기를 뺐다. AttemptDeadlineTest 둘은 deadline을 초 단위로.
- gRPC: 서버·client deadline 시험과 포화(SERVER_BUSY) 시험이 시험이 여는 gate로
  handler를 붙잡는다(취소되면 응답하지 않음). 서버 deadline 시험은 걸린 시간이 10s
  기본값보다 확실히 짧음(5s 아래)을 함께 단언해 설정한 150ms가 걸렸음을 본다.
  waitForReady, 대기 상한 30s. drain 시험은 연결을 먼저 맺고 drain·폴링 창 6s·4s.
- graphql deadline: sleep resolver를 gate로(상한 30s), 예산 2s, 응답 상한 예산+6s(기본
  예산 10s보다 짧다).
- persistence-jpa: lifecycle의 @Timeout이 컨테이너 기동을 덮던 것을 2분으로, 준비
  연결은 재시도해 받고 풀 고갈 상한 5s. migration 둘은 원인을 SQLState 55P03
  (lock_timeout)으로 단언하고 시간 상한 30s. NOWAIT는 contender의 lock_timeout이 0임을
  먼저 단언하고 상한 10s.
- cache-redis: live lease TTL 2s(밀려난 holder 케이스 넷이 1.5 TTL씩 잔다), fixed
  window 1시간.

버린 대안: 가짜 시계(deadline의 주인이 JDK HttpClient·Hikari·PostgreSQL·gRPC라 시험이
시계를 못 바꾼다), 상한 일률 배수(증명할 것과 가르지 못하는 값이 된다).

검증: desktop, CPU 부하(yes 24개, 12코어) 아래 바뀐 lane 전부 1084건, 리뷰 수정 뒤
다시 676건 실패 0. httpclient·gRPC lane 3회 반복 통과. verify.sh pr --no-cache 6805건
실패 0. RED: gRPC는 main·#25 이전·부하 유무 24회, httpclient는 main 부하 아래 4회 모두
통과해 desktop에서 재현되지 않았다. 고침은 CI 실패 둘과 코드 분석에 근거한다.
2026-11-13 14:56:38 +09:00
DongHyeonka 141c2a4f6d merge: main(3e908c02, round9 #29~#31)을 받는다 2026-11-13 13:58:10 +09:00
DongHyeonka 1ab96de01d test(objectstorage): 포트 계약을 포트 소유 leaf에 두고 fake와 adapter가 함께 통과하게 한다
문제: capability 기준 5(docs/manual/10-capabilities.md)는 포트를 가진 모듈의
testFixtures에 포트 계약을 두고 fake와 실제 adapter가 모두 통과하게 한다.
application-objectstorage에는 testFixtures도 fake도 없었다. 포트 수준 동작은 adapter
안의 local-dev 시험으로만 봤고, 포트 인터페이스는 결과와 예외를 적지 않았다.
capability-status는 app-bootstrap 통합 시험이 MinIO로 조립한다고 적었지만 실제로는
local-dev다.

고친 것:
- 포트 여덟의 Javadoc에 결과(APPLIED·REPLAYED·REJECTED 등)와 예외 타입을 적었다.
  IllegalArgumentException은 요청 그대로를, IllegalStateException은 지금 상태에서의
  거절이다. 유스케이스가 감싸 기능 오류로 바꾸고, 설정이 틀린 destination은 조립
  오류(500)로 바꾼다(AGENTS 규칙). 예외 메시지는 구현의 것이라 계약이 단언하지 않는다.
- testFixtures testkit: 계약 셋(ManagedObjectStoragePortContract 관리 게시·조회·
  전송·복구 조회·회수, StagedObjectPublicationPortContract 단계 게시·handoff·중단,
  ObjectScanMaintenancePortContract scan gate), in-memory fake InMemoryObjectStorage,
  destination 설명 ObjectStorageDestinationPolicy.
- fake(이 leaf test)와 adapter routing 구현(local-dev, adapter test contract/LocalDev*)이
  같은 계약을 상속한다. adapter 쪽 destination 설명은 조립된 policySnapshot에서 읽는다.
- adapter에서 계약이 드러낸 것 둘:
  - 실패한 managed 게시를 다시 하면 이번 호출이 게시했는데도 REPLAYED였다(stage 재시도는
    APPLIED). 이제 PUBLISHED로 바꾼 호출 하나만 APPLIED다. 같은 key로 겹친 호출은
    REPLAYED다(ManagedPublicationOutcomeTest가 겹침을 결정적으로 재현한다).
  - 검증한 뒤 중단한 stage를 다시 검증하면 REPLAYED였다. 중단된 operation의 검증을
    거절한다.
- 문서: application-objectstorage AGENTS·README, adapter README 「포트 계약」,
  TESTING_STRATEGY 9.4, capability-status Object storage 증거 칸.

버린 대안: MinIO에서 포트 계약 돌리기. S3 provider는 readiness registry에서 아직 배포
대상이 아니다(docs/registries/object-storage-readiness.yaml). 포트 경로를 MinIO로 묶는
일은 S3를 배포 대상으로 올리는 일과 같이 간다. MinIO에서는 provider 계약이 돈다.
남은 것: adapter 전용 ObjectStorageProviderException이 포트 밖으로 나가 바이트
불일치·consumer 실패는 계약이 unchecked 예외까지만 단언한다(RR9-03-34, 따로 고친다).

검증: desktop, :application-objectstorage:check :adapter:outbound:objectstorage:check
:app-bootstrap:architectureTest architectureCheck -p build-logic test 726건 실패 0.
RED: main에 ManagedPublicationOutcomeTest만 → 실패. 돌연변이: adapter의 회수 재시도를
REPLAYED→APPLIED로 바꾸면 계약 1건이 실패한다.

Refs: RR9-03-31, RR9-03-35, RR9-04-46
2026-11-13 13:49:40 +09:00
DongHyeonka b44aa49e7a fix(build-logic): 순수 모듈 testFixtures classpath도 순수성 검사에 넣는다
문제: verifyModuleDependencyPurity는 순수 모듈(application-*, domain-core,
shared-contract)의 compile·runtime·test classpath만 풀어 봤다. test classpath는
testFixturesImplementation을 거쳐 보지만 testFixturesCompileOnly는 보지 않는다. 그래서
공유 fixtures에 Spring을 compileOnly로 두면 순수성 검사를 통과했다. testFixtures를 쓰는
순수 leaf 다섯 곳에 같은 구멍이 있었다.

고친 것: java-test-fixtures를 쓴 순수 모듈은 testFixturesCompileClasspath·
testFixturesRuntimeClasspath도 같은 금지 group으로 본다. 지금 다섯 leaf의 fixtures에는
금지 group이 없어 기존 빌드는 그대로 통과한다(lockfile 대조).

검증: desktop, 기준 4ca61cd9 + 새 functional 시험만 → testFixturesCompileOnly Spring
케이스가 빌드 통과로 실패(RED). 고친 뒤 -p build-logic test 통과(다음 커밋의 GREEN
실행에 포함).

Refs: RR9-04-47
2026-11-13 13:49:40 +09:00
DongHyeonka 42d84d505e fix(objectstorage): 불변 Set으로 만든 요청에서 NPE를 내지 않는다
문제: ObjectRequestSupport.immutableCapabilities가 null 원소를 거르려고
capabilities.contains(null)을 불렀다. JDK의 불변 Set(Set.of, Set.copyOf)은
contains(null)에서 false 대신 NullPointerException을 던진다. 그래서 게시·stage 요청을
Set.of(...) capability로 만들면 생성자가 NPE로 실패했다. 지금 호출자가 모두 EnumSet을
넘겨 드러나지 않았고, 포트 계약 시험(다음 커밋)이 처음 잡았다.

고친 것: 원소를 하나씩 보고 null이면 지금처럼 IllegalArgumentException을 던진다.

검증: desktop, 기준 4ca61cd9에 새 시험만 → 「불변 Set으로 만든 요청」이 NPE로 실패.
고친 뒤 :application-objectstorage:check 통과(다음 커밋의 GREEN 실행에 포함).

Refs: RR9-03-33
2026-11-13 13:49:40 +09:00
donghyeon.kang 4f73e62e23 Merge branch 'main' into claude/r9-a-obs-logs
pr / done (pull_request) Successful in 13m43s
2026-11-13 04:44:09 +00:00