Commit Graph
333 Commits
Author SHA1 Message Date
DongHyeonka caa71d3228 docs(work): operate.md를 줄 상한 안으로 되돌린다
main(a7e38c10)에 들어온 요청률 제한 한 줄로 docs/work/operate.md가
151줄이 됐다. check-work-docs.py의 상한은 150줄이라
scripts/verify.sh docs가 main에서 실패한다. 같은 줄 끝의
「(W4 BE-OBS-A)」는 새 세션이 따라갈 수 없는 작업 이력 ID다.

같은 절에서 템플릿 전용 게이트 문서를 가리키는 줄과 파생 서비스 쪽
병합·게이트는 그 repo의 일이라는 줄을 한 항목으로 합쳤다. 둘 다
「파생 서비스의 게이트는 누구 몫인가」를 말한다. 요청률 제한 줄은
내용을 그대로 두고 이력 ID만 뺐다.

검증: scripts/verify.sh docs(노트북) rc=0, operate.md 150/150.
2026-11-12 21:08:17 +09:00
DongHyeonka 0d0cb12fe0 merge: main(a7e38c10, 관리 포트·admin 입력 검증 보안 수정)을 받는다 2026-11-12 21:06:06 +09:00
donghyeon.kang a7e38c1049 Merge pull request 'fix(security): W4 red team 백엔드 발견(관리포트 노출·admin @Valid)을 고친다' (#12) from claude/redteam-be-fixes-main into main
main / main (push) Successful in 25m40s
main / configuration-cache (push) Successful in 1m49s
main / build-logic (push) Successful in 1m9s
main / links (push) Successful in 15s
main / vulnerabilities (push) Successful in 1m12s
main / http3-experimental (push) Successful in 36s
main / jpa-postgresql (16) (push) Skipped
main / jpa-postgresql (17) (push) Skipped
main / jpa-postgresql (18) (push) Skipped
main / httpclient-transport (apache) (push) Skipped
main / httpclient-transport (jdk) (push) Skipped
main / redis-topology (7.2, cluster) (push) Skipped
main / redis-topology (7.2, sentinel) (push) Skipped
main / redis-topology (7.2, standalone) (push) Skipped
main / redis-topology (7.4, cluster) (push) Skipped
main / redis-topology (7.4, sentinel) (push) Skipped
main / redis-topology (7.4, standalone) (push) Skipped
main / redis-topology (7.4, tls) (push) Skipped
main / redis-topology (8.2, cluster) (push) Skipped
main / redis-topology (8.2, sentinel) (push) Skipped
main / redis-topology (8.2, standalone) (push) Skipped
main / redis-topology (8.2, tls) (push) Skipped
main / fileserver-nfs-ambiguity (push) Skipped
main / notification-chaos (push) Skipped
main / done (push) Skipped
main / performance (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
2026-11-12 10:51:34 +00:00
DongHyeonka 6c69384c76 test(persistence-jpa): platform 계약 시험이 PostgreSQL 서버를 JVM에서 나눠 쓴다
pr / done (pull_request) Canceled after 0s
문제: `JpaPlatformContractSupport`의 Javadoc은 「서버를 JVM에서 공유한다」고
하지만, `start`는 부를 때마다 컨테이너를 새로 띄웠다. 클래스 42개가 저마다 띄워
desktop main 단계에서 platform 계약 lane이 컨테이너 75개(기동 181초), migration
lane이 36개(71초)를 썼다. 이 lane들은 build의 실서버 슬롯 하나 위에서 돌기 때문에,
이 기동 시간이 main job 시간에 그대로 더해졌다. release gate 셋과 nightly
행렬 셋에서도 같은 lane이 major마다 돈다.

고친 방법: Stable major마다 서버 하나를 JVM에서 처음 쓸 때 띄우고, JVM이 끝날 때
멈춘다(shutdown hook, reaper에 기대지 않는다). support마다 그 서버에 database를
하나 만들고(`create database contract_<n>`), close에서 pool을 다 닫은 뒤
지운다(`drop database ... with (force)`). 표·스키마·Flyway 이력은 database에
있어 클래스끼리 섞이지 않는다. 서버 전체에 걸리는 role은 섞이므로 Javadoc에
적었다. role을 만드는 계약은 `PostgreSqlSecurityContractTest` 하나이고, lane마다
JVM이 따로라 이름이 겹치지 않는다.

시험: 소유권 시험에 둘을 더한다. 두 번째 support가 같은 서버, 다른 database를
받는지, close가 database를 지우는지 본다. 공유를 되돌리면 앞의 것이, drop을
빼면 뒤의 것이 실패한다. close 시험의 이름은 「database를 지우기 전에 pool을
닫는다」로 고친다.

버린 대안: 컨테이너 tmpfs·fsync 끄기로 기동만 빠르게. 재시작·장애 복구 계약의
조건이 바뀐다. Testcontainers reuse: CI에서 일부러 끈 설정이다.

위험·한계: 한 클래스가 서버 설정(`ALTER SYSTEM`)을 바꾸면 같은 lane의 다음
클래스가 본다. 지금 그런 계약은 없다(검색으로 확인).
2026-11-12 19:43:33 +09:00
DongHyeonka 738fe7004e docs(ledger): CI 건강·성능 첫 라운드 실측을 고치고 둘째 라운드 예측을 남긴다
pr / done (pull_request) Canceled after 0s
첫 라운드 actual 정정 줄은 PR #13 병합 직전에 적었지만, 커밋하면 초록 run이
새 head로 밀려서 공유 노트에 두었던 것이다(작업 중 555분, 결과 partial).
둘째 라운드 예측은 p50 240분이고 근거는 줄의 basis 칸에 있다.
2026-11-12 19:38:04 +09:00
DongHyeonka c89f3e8887 ci(main): main job 줄에서 integrationCheck를 앞에 둔다
문제: main job은 `./gradlew :mainCheck :integrationCheck --continue` 한 번이다.
integration lane은 build 전체에서 실서버 슬롯 하나를 나눠 쓴다
(ExclusiveRealServerLaneService, maxParallelUsages 1). desktop 측정에서
이 lane들은 시작 약 10분 동안 슬롯을 거의 쓰지 못했다. main 단계 분석이 CPU를
다 쓰는 동안 lane의 컴파일이 뒤로 밀렸기 때문이다. 그 뒤 19분은 lane이 한 번에
하나씩, 한가한 기계에서 돌았다. runner run 132에서도 jpa 계약 lane이 1,134초에야
시작했다.

고른 방법: 줄을 `./gradlew :integrationCheck :mainCheck --continue`로 바꾼다.
Gradle은 준비된 일을 요청한 태스크 순서대로 시작하므로, integration lane의
컴파일이 먼저 돌고 슬롯이 첫 분부터 찬다. 같은 단계, 같은 태스크 집합이다.
build.gradle 단계 선언의 `line`, main.yml, scripts/verify.sh, gates.md,
build-logic/AGENTS.md의 예시 줄을 함께 바꾼다.

측정(desktop, e7be517e, --no-build-cache, 같은 init script):
- 순서 바꾸기 전 1,760초(aeb60339, 거의 같은 트리), 바꾼 뒤 1,484초(−16%), rc=0, 실패 0
- jpa 계약 lane 시작 777초 → 329초. 슬롯이 60초부터 끝까지 찬다.

버린 대안: 슬롯을 둘로 늘리기. 시간에 민감한 web·WebSocket lane이 함께 돌 때
실패해서 하나로 둔 것이다(2026-11-01 리뷰). lane을 두 Gradle 실행으로 나누기:
컴파일을 두 번 한다.

위험·한계: lane이 main 단계 분석과 같은 시간에 돌아 CPU를 나눠 쓴다. 지금도 앞
10분에는 전송 qualification lane이 그렇게 돌았다. desktop 한 번은 실패 0이고,
runner 결과는 PR 본문에 적는다. 이제 main job 시간은 슬롯 lane 시간의 합이
정한다(가장 큰 것은 PostgreSQL 컨테이너 기동, 후속).
2026-11-12 19:37:46 +09:00
DongHyeonka 1fabd04df5 ci(main): HTTP transport 두 행을 job 하나의 step으로 돈다
문제: nightly의 httpclient-transport는 transport마다 job 하나였다. 행마다 1분이
안 되고, 그 대부분이 job 시작이다(run 100: apache 0.8분, jdk 0.9분).

고른 방법: job 하나에 transport마다 step 하나를 둔다. 줄은 지금과 같다
(`-Phttpclient.contract.transports=<transport>`). `if: always()`라서 앞
transport가 실패해도 뒤가 돌고, 실패한 step 이름이 transport를 말한다.
속성 값이 다르므로 두 번째 실행도 lane을 다시 돈다.

버린 대안: 그대로 두기. 매일 job 시작 한 번을 더 치른다.

검증: YAML을 읽어 step 넷(checkout, setup, apache, jdk)을 확인했다.
2026-11-12 18:59:20 +09:00
DongHyeonka ba3c964a92 ci(main): Redis 구성 lane 11행을 job 하나의 step으로 돈다
문제: nightly의 redis-topology가 행렬 job 11개였다. 행마다 job을 새로 시작해
컨테이너·checkout·JDK·Gradle 시작과 구성을 다시 치렀다. 수동 실행 run 100에서
이 11개가 runner 135분 가운데 26분이었고, 그중 약 3분의 1이 시작 비용이었다.

고른 방법: job 하나에 행마다 step 하나를 둔다. 각 step은 지금과 같은
`bash scripts/ci/redis-topology.sh <topology> <version>` 한 줄이다.
- `if: always()`로 한 행이 실패해도 나머지가 돈다. job이 빨갛게 되고, 실패한
  step 이름이 행을 말한다.
- 스크립트가 끝날 때 자기 topology를 내리므로 행끼리 서버를 나누지 않는다.
- 같은 job 안에서 Gradle daemon과 구성 결과를 다시 쓴다.
- timeout은 행 11개를 합친 시간에 맞춰 90분으로 둔다.

문서: 행렬이라고 적던 곳(gates.md, template-vs-consumer.md, redis-sdk compose
README, 스크립트 머리 주석)을 step으로 고친다.

버린 대안: 버전마다 job 하나(3개). 시작 비용을 셋 더 치른다. 한 step에서
셸 반복문으로 돌기: 어느 행이 실패했는지 로그를 뒤져야 하고, 단계 job 규칙과
같은 이유로 셸 문법을 늘리지 않는다.

위험·한계: UI에서 행마다 따로 보이던 초록·빨강이 step 단위가 된다. job 하나가
시간 제한에 걸리면 남은 행이 함께 멈춘다.

검증: YAML을 읽어 step 13개(checkout, setup, 행 11)를 확인했다. runner nightly
측정은 PR 본문에 적는다.
2026-11-12 18:57:05 +09:00
DongHyeonka afbfb1cc73 ci: Trivy 데이터베이스를 runner 캐시에서 복원한다
문제: scripts/ci/trivy-scan.sh가 job마다 취약점 DB(133 MB, 약 30초)를
내려받는다. release 이미지 job은 Java 색인(952 MB, 약 2분)도 받는다. run 125의
이미지 job 7.0분 가운데 약 2.8분이 이 두 내려받기였다.

고른 방법: 새 composite action `.gitea/actions/trivy-db-cache`가 Trivy 기본
캐시 디렉터리(~/.cache/trivy)의 db와 java-db를 actions/cache로 복원한다.
pr.yml `done`, main.yml `vulnerabilities`, release.yml 이미지 job의 scan 앞에
둔다. Java 색인은 이미지 job만 받는다(`java-db: "true"`).
- Trivy는 DB 자체의 metadata로 최신인지 판단하고, 아니면 새로 받는다. 복원은
  시간을 줄일 뿐이고 아는 권고 목록을 바꾸지 않는다.
- 항목은 덮어쓰지 않으므로 key에 기간을 넣는다. 취약점 DB는 하루, Java 색인은
  Trivy가 스스로 3일마다 갱신하므로 3일 단위다. 952 MB가 매일 캐시에 쌓이지 않는다.
- 저장은 main ref만 한다. JDK·Gradle 캐시와 같은 규칙이다. 브랜치가 main이 쓸
  DB를 정하지 못한다.

버린 대안: `--skip-db-update`로 캐시만 쓰기. DB가 오래될 수 있어 게이트가 약해진다.
key 하나 고정. 첫 사본이 영원히 남는다.

위험·한계: Java 색인 항목이 runner 캐시(5 GB 상한)의 약 1 GB를 쓴다. 효과는
main이 한 번 저장한 뒤부터 보인다.

검증: 네 YAML을 읽었다. runner 측정은 PR 본문에 적는다.
2026-11-12 18:56:52 +09:00
donghyeon-ka f4e9253eee Merge origin/main (e7be517e, #13 NegotiatedProtocol flake 고침 등) into PR #12 브랜치
pr / done (pull_request) Successful in 12m51s
2026-11-12 18:44:55 +09:00
donghyeon.kang e7be517e06 Merge pull request 'ci: 백엔드 CI를 runner에서 초록으로 만들고 job 준비 비용을 줄인다' (#13) from claude/w2-be-ci-perf-e89fe7 into main
main / main (push) Successful in 35m56s
main / build-logic (push) Successful in 1m17s
main / configuration-cache (push) Successful in 2m3s
main / links (push) Successful in 18s
main / vulnerabilities (push) Successful in 57s
main / http3-experimental (push) Successful in 1m34s
main / jpa-postgresql (16) (push) Skipped
main / jpa-postgresql (17) (push) Skipped
main / jpa-postgresql (18) (push) Skipped
main / httpclient-transport (apache) (push) Skipped
main / httpclient-transport (jdk) (push) Skipped
main / redis-topology (7.2, cluster) (push) Skipped
main / redis-topology (7.2, sentinel) (push) Skipped
main / redis-topology (7.4, cluster) (push) Skipped
main / redis-topology (7.4, tls) (push) Skipped
main / redis-topology (8.2, standalone) (push) Skipped
main / compose-smoke (push) Skipped
main / redis-topology (7.2, standalone) (push) Skipped
main / redis-topology (7.4, sentinel) (push) Skipped
main / redis-topology (7.4, standalone) (push) Skipped
main / redis-topology (8.2, cluster) (push) Skipped
main / redis-topology (8.2, sentinel) (push) Skipped
main / redis-topology (8.2, tls) (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
2026-11-12 09:43:41 +00:00
donghyeon-ka a9aa86e5e4 Merge origin/main (27a18b4f, #14 전문가 스킬·docs·scripts/tests) into PR #12 브랜치
pr / done (pull_request) Canceled after 0s
pr / gradle (pull_request) Failing after 9m18s
pr / vulnerabilities (pull_request) Successful in 1m3s
2026-11-12 15:02:09 +09:00
DongHyeonka 7db40c9b7a merge: main(27a18b4f, W3 전문가 스킬 병합)을 받는다
pr / done (pull_request) Successful in 12m1s
2026-11-12 15:01:50 +09:00
donghyeon.kang 27a18b4f0c Merge pull request 'feat(claude): 분야 전문가를 지식 스킬 열 개와 렌즈 리뷰어로 두고 협업 명단을 붙인다' (#14) from donghyeon.kang/w3-experts-be into main
main / integration (push) Failing after 17m4s
main / build-logic (push) Successful in 1m15s
main / configuration-cache (push) Successful in 1m29s
main / links (push) Failing after 6s
main / vulnerabilities (push) Successful in 48s
main / jpa-postgresql (18) (push) Skipped
main / httpclient-transport (apache) (push) Skipped
main / redis-topology (7.2, sentinel) (push) Skipped
main / redis-topology (7.4, cluster) (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 / http3-experimental (push) Successful in 55s
main / jpa-postgresql (16) (push) Skipped
main / jpa-postgresql (17) (push) Skipped
main / httpclient-transport (jdk) (push) Skipped
main / redis-topology (7.2, cluster) (push) Skipped
main / redis-topology (7.2, standalone) (push) Skipped
main / redis-topology (7.4, standalone) (push) Skipped
main / redis-topology (7.4, tls) (push) Skipped
main / redis-topology (7.4, sentinel) (push) Skipped
main / redis-topology (8.2, cluster) (push) Skipped
main / object-storage-aws (push) Skipped
main / compose-smoke (push) Skipped
main / redis-topology (8.2, sentinel) (push) Skipped
main / main (push) Successful in 3m49s
main / redis-topology (8.2, standalone) (push) Skipped
main / redis-topology (8.2, tls) (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 / performance (push) Canceled after 0s
2026-11-12 06:00:51 +00:00
DongHyeonka d17f8bcf7a merge: main(841a176f, t2b 재배치 병합)을 받는다
pr / done (pull_request) Canceled after 0s
2026-11-12 11:44:05 +09:00
DongHyeonka 3e06a8097d ci(main): 같은 트리거·브랜치의 새 run이 이전 run을 취소한다
문제: runner 한 대를 모든 repo가 같이 쓴다. main.yml은 cancel-in-progress가
false라서, 새 push가 와도 이전 push run이 끝까지 돌아 runner를 잡는다.

고른 방법: group을 트리거와 ref로 나누고(main-<event>-<ref>) cancel-in-progress를
켠다. push는 같은 브랜치의 이전 push run을, nightly는 이전 nightly를, 수동 실행은
같은 브랜치의 이전 수동 실행을 대기 중이든 실행 중이든 취소한다. 새 run이 이전
run이 볼 것을 다 본다.

Gitea 1.27의 규칙(release/v1.27 models/actions/run.go
CancelPreviousJobsByRunConcurrency): 새 run이 생기면 같은 group의 대기·Blocked
job은 언제나 취소하고, cancel-in-progress가 true일 때만 실행 중인 job도 취소한다.
이 저장소 기록이 그대로다. run 79와 93의 Blocked performance job은 다음 run이
생긴 그 초에 취소됐고, PR run 97의 실행 중 job은 새 head가 들어오고 11초 뒤 runner
로그에 "Job cancelled"를 남기고 멈췄다.

pr.yml은 이미 PR마다 group 하나다(pull_request run의 ref가
refs/pull/<번호>/head). 그 사실을 주석으로만 남긴다.

버린 대안: group을 브랜치 하나로 두기(main-<ref>). push가 돌고 있는 nightly를
취소한다. nightly에는 push run에 없는 job이 있다. pr.yml group 문자열을
github.event.pull_request.number로 바꾸기: 지금 대기 중인 run(124, PR 12·14의
107·115)이 다른 group에 남아 다음 push에 취소되지 않는다.

위험·한계: main에 연달아 병합하면 앞 병합만의 main 단계 결과는 남지 않는다.
뒤 run이 둘을 함께 본다. release.yml은 그대로 취소하지 않는다.

검증: 세 workflow를 YAML로 읽어 concurrency 값을 확인했다. 실제 취소 증거는 이
PR 본문에 run 번호로 적는다.
2026-11-12 11:44:05 +09:00
DongHyeonka 9682c52c65 build(release): 이미지를 만들 때 OS 보안 업데이트를 받는다
pr / done (pull_request) Canceled after 0s
문제: noble로 올린 release 수동 실행(run 101)의 이미지 검사가 HIGH 2건으로
실패한다. apt와 libapt-pkg6.0t64의 CVE-2026-109518이고, 고친 버전
2.8.4ubuntu0.1이 이미 나왔다. 가장 새로운 eclipse-temurin:21-jre-noble
digest(2026-10-29)에는 아직 들어오지 않았다. 정책은 고칠 수 있는
High/Critical을 실패로 둔다(2026-11-11 소유자 결정).

고른 방법: 실행 단계에서 `apt-get update && apt-get upgrade`로 이미 나온 보안
수정을 받고 패키지 목록을 지운다. desktop에서 같은 digest에 그대로 해 보니
apt가 2.8.4ubuntu0.1이 되었다. 정책 문서에 같은 내용을 적는다.

버린 대안: 예외로 두기. 정책은 아직 고친 버전이 없는 것만 예외로 둔다.
기본 이미지가 따라올 때까지 기다리기. 그동안 release가 막힌다.

위험·한계: 같은 커밋이라도 빌드한 날에 따라 OS 패키지 버전이 달라질 수 있다.
digest 고정은 시작점만 고정한다. SBOM이 그 빌드의 실제 버전을 남긴다.

검증: desktop 이미지 빌드, runner release 수동 실행(이 PR 본문에 적는다).
2026-11-12 10:59:43 +09:00
DongHyeonka 335fc9679d docs(ledger): CI 건강·성능 작업의 예측과 실측을 남긴다
pr / done (pull_request) Canceled after 0s
예측은 2026-11-11 착수 때(p50 144분), 실측은 작업 중 417분·호출 464.
p80을 넘은 이유와 결과(partial)는 줄의 why 칸에 있다.
2026-11-12 08:34:10 +09:00
DongHyeonka 083c6910fa fix(compose): smoke lane이 기반 서비스를 먼저 띄우고 앱을 띄운다
pr / done (pull_request) Canceled after 0s
문제: compose smoke는 lane의 오래 도는 서비스를 `up --wait` 한 번에 함께 띄운다.
앱과 Kafka가 동시에 뜨면 앱의 producer가 아직 연결을 받지 않는 broker에 붙어
재시도 WARN을 남기고, 「기동 로그가 조용하다」 검사가 실패한다. main 수동 run 59
(2026-11-11)의 local-messaging lane이 이것으로 실패했다. 같은 lane이 바로 앞
run과 desktop에서는 통과했다(시간 경쟁).

고른 방법: smoke 스크립트가 app이 아닌 서비스를 먼저 `up --wait`로 healthy까지
띄우고, 그다음 app까지 `up --wait`한다. 모든 lane이 app을 가진다. 개발용
compose.yaml은 바꾸지 않는다.

버린 대안: compose.yaml의 app에 kafka `depends_on`(service_healthy)을 거는 것.
app은 profile이 다른 여러 lane과 개발 환경이 함께 쓰고, 꺼진 profile의 서비스를
기다리게 되면 그 구성이 시작하지 못한다(`required: false`는 Compose 2.20부터).

위험·한계: lane마다 기반 서비스가 healthy가 될 때까지 기다리는 만큼 lane이 조금
길어진다. 그전에도 `up --wait`가 그만큼 기다렸으므로 차이는 작다.

검증: desktop에서 local-messaging lane, runner nightly 수동 실행(이 PR 본문에 적는다).
2026-11-12 07:53:10 +09:00
donghyeon-ka 6b1b246ee2 test(registry): 스키마 위반을 PR 레인에서 막고 누락 필드를 또렷이 알린다
pr / done (pull_request) Canceled after 0s
pr / gradle (pull_request) Successful in 11m1s
pr / vulnerabilities (pull_request) Successful in 1m8s
ContractRegistrySchemaGovernanceTest(모든 레지스트리 행에 legal
compatibility_impact + non-blank required_test 강제)는 @Tag(document-contract)
라 main 스테이지에서만 돈다. PR 레인은 repository-contract이고 그 입력에
docs/**가 빠져 있어, 잘못된 env-keys가 prCheck를 통과하고 병합 뒤 mainCheck
에서야 깨졌다(BE-CONFIG-001이 그렇게 새어 나갔다). 또 필드가 아예 빠지면
Set.of(...).contains(null)이 NPE를 던져 어느 행이 문제인지 알 수 없었다.

- RegistrySchemaPullRequestGateTest(@Tag repository-contract): 같은
  RegistryGovernanceCatalog.validate를 PR 레인에서 돌려 위반이 병합 전에
  막히게 한다.
- app build.gradle repositoryContractInputs에 docs/registries/**를 더해
  레지스트리가 바뀌면 PR 레인이 재실행된다.
- RegistryGovernanceCatalog: compatibility_impact가 null이면 "... must be one
  of [...], but was null"로 또렷이 실패한다(NPE 대신). 누락-필드 음성 사례를
  ContractRegistrySchemaGovernanceTest에 더했다.
- ManagementActuatorSecurityContractTest javadoc에
  actuator-contract:management-address-loopback 항목을 더해 열거를 맞춘다.

버린 대안: required_test가 실제 시험을 가리키는지 범용 강제는 안 넣었다 —
env-keys의 distinct required_test 193개 중 테스트 소스에 literal로 있는 건
7개뿐이라(나머지는 문서적 식별자), 범용 강제는 기존 186행을 깨뜨린다.

위험·한계: PR 레인이 docs/registries 변경에도 재실행된다(의도).

검증(desktop, 고친 env-keys): spotlessCheck·verifyEnvKeys·build-logic test·
documentContractTest·repositoryContractTest(새 게이트)·
ManagementActuatorSecurityContractTest·web-fileserver·web-advanced 모두 rc=0.
RED 재현: 고치기 전 새 게이트가 "env-keys.yaml row MANAGEMENT_SERVER_PORT
compatibility_impact must be one of [...], but was null"로 실패.
2026-11-12 07:19:00 +09:00
donghyeon-ka 156046e274 fix(registry): 관리 포트 항목의 계약 두 줄을 되돌리고 주소 항목에 제 시험을 준다
env-keys.yaml에서 MANAGEMENT_SERVER_ADDRESS를 MANAGEMENT_SERVER_PORT 항목
중간에 끼워 넣어, PORT의 compatibility_impact와 required_test
(actuator-contract:management-port-separated) 두 줄이 ADDRESS로 넘어갔다.
PORT는 두 칸을 잃어 스키마상 불완전해졌고, ADDRESS의 required_test는 제
시험이 아니라 포트 분리 시험을 가리켰다.

PORT에 두 줄을 되돌리고, ADDRESS의 required_test를
actuator-contract:management-address-loopback로 바꾼다. 이 id는
ManagementActuatorSecurityContractTest의 loopback 기본값 시험 마커로 이미
존재한다(실제 시험을 가리킨다). validation: host_or_ip_address는 env-keys의
자유 서술 규약에 맞는 신규 서술자다(닫힌 집합 강제 없음).

위험·한계: 데이터 수정만. 동작 변화 없음.

검증(desktop): :app-bootstrap:verifyEnvKeys rc=0,
documentContractTest(ContractRegistrySchemaGovernanceTest) rc=0.
2026-11-12 07:19:00 +09:00
DongHyeonka ea52d9d900 Merge remote-tracking branch 'origin/main' into claude/w3-experts-be
pr / gradle (pull_request) Successful in 11m1s
pr / vulnerabilities (pull_request) Successful in 1m10s
pr / done (pull_request) Successful in 0s
2026-11-12 04:36:53 +09:00
DongHyeonka 5feb5a1bc0 fix(claude): 분야 파일을 고치기 전에 be 스킬을 부르도록 규칙에 파일과 스킬 짝을 적는다
문제: 실제 세션 평가(구현 과제 3번)에서 `be-persistence`는 세 번 모두 스킬 목록에
떴지만 부른 세션은 한 번뿐이었다. 나머지 둘은 관련 문서를 직접 읽고 스킬을 건너뛰었다.
규칙은 "어느 스킬인지는 experts.md 3절 표"라고만 해서 한 번 더 읽어야 짝을 알았다.

고른 방법: 규칙에 고칠 것 → 스킬 짝을 한 줄로 적고, 처음 Edit·Write하기 전에 Skill
도구로 부르며 문서를 읽었어도 부른다고 적었다. 버린 대안: 모듈마다 leaf AGENTS.md에
한 줄 더하기(파일 수십 개, 배치 검사와 겹침), 강조어(MUST 등, 과다 호출을 부른다).

위험: 규칙이 붙는 세션마다 약 300토큰이 는다. 여러 분야를 부르면 호출이 는다.

검증: python3 -m unittest discover -s scripts/tests 154건 통과, scripts/verify.sh docs rc=0.
2026-11-12 04:36:10 +09:00
donghyeon-ka 0adb826f0f chore(format): spotless 포맷을 바뀐 자바 파일에 적용한다
pr / gradle (pull_request) Successful in 11m38s
pr / vulnerabilities (pull_request) Successful in 54s
pr / done (pull_request) Canceled after 0s
PR #12의 액추에이터·fileserver·web-advanced 수정 커밋이 긴 주석과
assertion 메시지에 포맷 드리프트를 남겨, runner pr / gradle의
:app-bootstrap:spotlessJavaCheck가 깨졌다. 모듈 시험만 돌리고 포맷
게이트(spotlessCheck)를 건너뛴 탓이다.

./gradlew spotlessApply로 바뀐 3개 파일만 재포맷했다. 이미 push된
커밋이라 force push 금지 → squash 대신 새 커밋으로 올린다.

위험·한계: 포맷만 바뀐다(긴 줄의 줄바꿈). 동작·의미 변화 없음.

검증: spotlessCheck rc=0. 바뀐 3개 모듈 시험 재실행 —
ManagementActuatorSecurityContractTest·FileserverAdminControllerRequestBodyValidationTest·WebCodecMapperTest
BUILD SUCCESSFUL (1m8s).
2026-11-12 02:36:37 +09:00
DongHyeonka aeb6033990 fix(ci): 라이선스 판정을 배포하는 의존성에 두고 빌드한 뒤에 돈다
pr / done (pull_request) Successful in 13m37s
문제: PR 단계를 job 하나로 접자 Trivy filesystem 검사가 Gradle 빌드 뒤에 돌게
됐고, 처음으로 lockfile의 라이선스를 읽었다(run 95). Trivy는 같은 기계의 Gradle
캐시에서만 lockfile의 라이선스를 읽는데, 예전의 따로 된 검사 job에는 캐시가 없어
「High/Critical 라이선스는 막는다」는 검사가 라이선스를 한 번도 본 적이 없었다.
보이게 되자 lockfile마다 SpotBugs·Checkstyle(LGPL), Error Prone dataflow(GPL+CPE),
Jakarta API(EPL/GPL 이중), org.reflections(WTFPL, Trivy 분류 forbidden) 등이 걸렸다.
대부분 배포하지 않는 빌드 도구·시험 구성이다. 한편 릴리스 이미지 검사는 jar의
라이선스를 읽지 못한다(run 62의 Licenses 칸이 모든 jar에서 비어 있다). 그래서 앞
커밋의 「앱 의존성 금지 라이선스는 이미지에서 막는다」도 빈 검사였다.

고른 방법(2026-11-11 소유자 결정 「배포하는 의존성의 금지 라이선스만 실패」):
- filesystem 검사가 `src/bootstrap/app/gradle.lockfile`의 runtimeClasspath 항목
  (기본 조립 jar에 실리는 것)만 골라 forbidden(CRITICAL)이면 실패한다.
- Gradle 캐시가 없으면 건너뛴다고 적는다. 캐시가 있는데 라이선스를 하나도 읽지
  못하면 빈 검사이므로 실패한다.
- 나머지 라이선스 결과(OS, 도구, 시험, restricted)는 보고만 한다. 이미지 검사의
  빈 라이선스 gate는 지우고 보고만 남긴다. 정책 문서를 실제 동작에 맞춘다.

버린 대안: lockfile 전체에 High/Critical을 그대로 막고 예외를 다는 것. Trivy의
라이선스 예외는 라이선스 이름 단위라 도구용 LGPL을 빼면 배포 의존성의 LGPL도 빠진다.

위험·한계: main.yml의 vulnerabilities job은 빌드하지 않아 라이선스 판정을 건너뛴다.
판정은 병합을 막는 PR 단계에 있다. runtimeClasspath 밖에서 jar에 실리는 것(다른
조립)이 생기면 grep 조건을 넓혀야 한다.

검증: runner PR `pr / done`(이 PR 본문에 적는다).
2026-11-12 02:26:58 +09:00
DongHyeonka 24dde5867d docs(capability): 컨테이너 lane을 돌리는 job 이름을 지금 workflow에 맞춘다
capability-status의 네 행이 2026-11-08에 지운 integration-main.yml의
integration-check job을 가리켰다. 지금은 main.yml의 main job이
:integrationCheck를 돈다.
2026-11-12 01:37:54 +09:00
DongHyeonka 2c180b9059 ci(main): main과 integration 단계를 job 하나, Gradle 실행 한 번으로 돈다
문제: main push는 `main`(17.1분)과 `integration`(17.4분) 두 job을 차례로 돈다
(run 79, runner capacity 1). 두 job이 같은 모듈을 각자 설정·컴파일하고,
integration의 컨테이너 lane은 실서버 슬롯(ExclusiveRealServerLaneService)
하나를 차례로 쓰는 동안 나머지 worker가 놀고, main의 분석(testQualityCheck,
생성 명령 왕복의 안쪽 빌드)은 다른 job이라 그 시간에 겹치지 못한다.

고른 방법: `./gradlew :mainCheck :integrationCheck --continue` 한 줄을 `main` job이
돈다. strict lane 단계 선언에 `line`을 더해, 같은 job을 쓰는 단계가 선언한 한
줄을 나눠 쓸 수 있게 한다. 「단계마다 정해진 한 줄」 규칙은 그대로다: 두 단계
모두 그 정확한 줄을 요구하고, line에는 태스크 경로만 쓸 수 있고 자기 단계를
빼면 설정 단계에서 거절한다(TestKit 시험 셋). scripts/verify.sh의 main 단계도
같은 줄을 쓴다.

버린 대안: 한 job에 두 줄을 차례로 두기. mainCheck가 실패하면 integration이
돌지 않는다. 실서버 슬롯을 둘로 늘리기. 시간에 민감한 lane이 서로 겹쳐 불안정해진다
(그 서비스가 생긴 이유).

위험·한계: 컨테이너 lane이 main 단계의 CPU 작업과 겹친다. 시간에 민감한 system
lane은 지금도 main 단계 안에서 같은 겹침을 견디고, integration lane은 대부분
컨테이너 계약이다. 한 job이 길어져(예상 22~25분) timeout을 240분으로 둔다.

검증: build-logic 시험(desktop), verifyStrictLaneStages --dry-run, runner main 수동
실행의 main job 시간(이 PR 본문에 적는다).
2026-11-12 01:37:37 +09:00
DongHyeonka 7dbf11caf5 ci(release): web·WebSocket·HTTP client release lane을 job 하나로 합친다
문제: release 수동 실행(run 62)은 gate job 12개를 하나씩 돈다(runner capacity 1).
web·websocket·httpclient 세 gate는 각각 2.4~3.2분인데 그중 약 2분이 checkout,
JDK, Gradle 시작, 세 lane이 함께 쓰는 모듈의 컴파일이다.

고른 방법: `stable-release-gates` job 하나가 세 job의 태스크를 Gradle 한 번에
`--continue`로 돈다. 한 lane이 실패해도 나머지 lane의 결과가 나온다.
app-image-release의 needs와 capability-status 문서의 job 이름을 맞춘다.

버린 대안: JPA·fileserver job까지 합치기. JpaReleaseRenderingTest가 PostgreSQL
major마다 job 하나인 행렬을, FileserverDocumentationCoverageTest와 지원 문서가
fileserver job 이름을 근거로 읽는다. `--tests` 필터를 쓰는 jpa-registry-and-docs는
같은 Gradle 실행에 넣으면 필터가 다른 시험 태스크에도 걸린다.

위험·한계: 세 영역의 로그가 한 job에 섞인다. 실패한 lane 이름은 Gradle이 끝에
모아 적는다.

검증: runner release 수동 실행(이 PR 본문에 적는다).
2026-11-12 01:34:40 +09:00
DongHyeonka 1405306070 fix(httpclient): HTTP/2 협상 시험이 공용 프로필의 짧은 연결 제한에 걸리지 않는다
문제: NegotiatedProtocolContractTest의 JDK transport 시험 둘은 공용 시험 프로필
(연결 500ms, TLS 핸드셰이크 1s)을 그대로 쓴다. 부하가 높을 때 TLS 핸드셰이크와
ALPN이 그 안에 끝나지 않아 HttpConnectTimeoutException으로 실패한다.
main push run 93(2026-11-11, spring70CompatibilityTest lane)과 desktop(부하
18~24, 2026-11-08)에서 봤다. 이 시험이 보는 것은 협상된 프로토콜이지 시간
예산이 아니다.

고른 방법: 두 시험만 넉넉한 TimeoutSettings(연결·핸드셰이크·헤더·유휴 10s,
전체 30s)를 쓴다. DNS 값은 플랫폼이 받는 유일한 값인 기본값으로 둔다. 시간
제한을 보는 다른 시험은 공용 프로필 그대로다.

위험·한계: 공용 프로필을 쓰는 다른 실서버 시험도 같은 부하에서 걸릴 수 있다.
관측된 것은 이 시험뿐이라 이것만 고쳤다.

검증: desktop mainCheck, runner main 수동 실행.
2026-11-12 01:32:11 +09:00
DongHyeonka 7284b581c1 ci(main): nightly가 main에서 PR 단계를 돌려 PR이 쓸 빌드 캐시를 채운다
문제: PR 단계는 한 줄만 바꾼 PR도 526개 태스크를 모두 처음부터 돈다(run 64·85,
FROM-CACHE 0). PR은 캐시를 읽기만 하는데, main push는 PR 단계 태스크
(spotbugsMain, test, checkstyle 등)를 돌리지 않아 읽을 항목이 없다. desktop PR
단계 태스크 시간 1,919초 가운데 컴파일 30%, SpotBugs 26%, 시험 35%다.

고른 방법: main.yml에 nightly·수동 전용 job `done`을 둔다. `:prCheck`를 main에서
한 번 더 돌리고, setup-gradle이 job 끝에 그 결과를 캐시에 저장한다. setup-gradle은
캐시 키에 job 이름을 넣고 같은 이름의 항목부터 찾으므로, pr.yml의 job과 같은
이름이어야 PR이 이 항목을 복원한다. 게이트가 아니라 문서(gates.md)에 그렇게 적는다.

버린 대안: main push마다 돌리기. 모든 push가 약 8분 늦어진다. PR이 캐시를 쓰게
하기. 검토 전 코드가 main이 복원할 캐시를 바꿀 수 있다.

위험·한계: 효과는 이 job이 main에서 한 번 돈 뒤부터다(브랜치 수동 실행은 캐시를
저장하지 않는다). 그날 병합으로 바뀐 모듈은 다음 nightly까지 PR에서 다시 돈다.
enhanced 캐시 제공자의 키 규칙은 공개되지 않아, 같은 이름으로 복원되는지는 첫
nightly 뒤 PR 로그의 FROM-CACHE 수로 확인한다. nightly에 약 8분이 더해진다.

검증: 병합 뒤 첫 nightly와 그 뒤 PR의 setup-gradle 복원 줄·FROM-CACHE 수(이 PR
본문에 적는다). desktop에서 캐시가 찬 PR 단계 시간(pr-bc2)으로 효과의 상한을 잰다.
2026-11-12 01:30:20 +09:00
DongHyeonka d237bacc14 ci: JDK 캐시는 main에서만 저장한다
앞 커밋은 pull request만 읽기 전용으로 두고 push·schedule·수동 실행은 어느
브랜치에서든 저장하게 했다. 키가 Temurin 빌드 하나로 고정이고 처음 저장한
항목이 계속 쓰이므로, 쓰기 권한자가 브랜치에서 수동 실행으로 먼저 저장하면
그 뒤 모든 main 실행이 리뷰 없이 그 JDK를 복원한다. setup-gradle과 같은
규칙(main ref만 저장)으로 맞춘다.

위험·한계: 브랜치의 수동 실행에서는 main이 저장하기 전까지 캐시가 비어 있어
효과를 볼 수 없다. 효과는 병합 뒤 첫 main push에서 확인한다.
2026-11-12 01:28:35 +09:00
DongHyeonka 5a95db4523 ci(main): NFS job의 compose 경로를 재배치에 맞추고 호스트 nfsd 모듈을 먼저 본다
문제: 두 가지다.
- 재배치(PR #10)로 workflow의 기본 작업 폴더 `src`가 없어졌는데
  fileserver-nfs-ambiguity의 두 compose 줄이 `adapter/outbound/...`로 남았다.
  지금 main에서는 파일을 찾지 못해 실패한다.
- 그 전에도 이 job은 run 52·63에서 NFS 서버 컨테이너가 바로 끝나
  「dependency failed to start」로만 실패했다. 서버는 호스트 커널의 nfsd를 쓰고,
  desktop 호스트에는 그 모듈이 올라가 있지 않다(`lsmod`에 없음, 모듈 파일은
  있음). runner 안쪽 daemon에는 /lib/modules가 없어 컨테이너가 올릴 수 없다.

고른 방법: 경로에 `src/`를 붙인다. 첫 step이 /proc/filesystems에서 nfsd를
확인하고, 없으면 호스트에서 한 번 돌릴 명령을 출력하고 실패한다. 원인을
로그에서 바로 읽을 수 있다.

버린 대안: job이 privileged 컨테이너로 호스트에 모듈을 올리게 하기. CI가
runner 호스트의 커널 상태를 바꾸게 된다.

위험·한계: 호스트에 모듈을 올리기 전까지 이 job은 빨갛다. 올리는 것은
runner 호스트 관리자(소유자)의 일이다.

검증: 경로는 workflow의 run 줄 경로를 모두 대조하는 스크립트로 확인했다
(빠진 경로는 이 두 줄뿐). runner nightly 수동 실행.
2026-11-12 01:27:06 +09:00
DongHyeonka 000a59ed5f fix(redis): Redis 8 구성 lane이 search 모듈을 싣고 admin이 FT.INFO를 받는다
문제: nightly의 redis-topology 8.2 standalone·sentinel·cluster가 run 63에서
RedisTopologyContractTest 「admin 계정이 ADMIN_ONLY 진단을 모두 쓸 수 있다」로
실패한다. 7.2·7.4는 통과한다. 원인은 둘이다.
- 명령 정책 catalog는 search 모듈의 FT.INFO를 8.0부터 ADMIN_ONLY로 둔다.
  fixture ACL의 admin 줄에는 그 권한이 없다(standalone: 거부).
- sentinel·cluster lane은 entrypoint를 덮어써 `redis-server`를 바로 실행한다.
  Redis 8 이미지의 docker-entrypoint.sh가 모듈을 싣는데 그것을 건너뛰어
  FT.INFO 자체가 없다(「있어야 할 서버에 없다」).
desktop에서 확인: Redis 7.2·7.4는 ACL 규칙 `+ft.info`가 있으면 시작을 거부하고,
8.2는 모듈을 실었을 때만 받는다. cluster 모드에서도 search 모듈은 실리고
FT.INFO가 생긴다.

고른 방법:
- sentinel·cluster 데이터 노드가 `exec docker-entrypoint.sh redis-server`로
  standalone처럼 이미지 entrypoint를 거친다. 서버도 root가 아니라 이미지의
  redis 사용자로 돈다.
- 네 구성의 ACL 마운트 원본을 `REDIS_ACL_DIR`로 바꿀 수 있게 한다(기본값은
  지금 폴더). redis-topology.sh가 8 이상에서만 커밋한 ACL 파일에서 admin 줄
  끝에 `+ft.info`를 더한 사본을 build/ 아래 만들어 쓴다. 실행마다 원본에서
  만들어 어긋날 수 없다. ACL README에 이 예외를 적는다.

버린 대안: 버전별 ACL 파일을 하나 더 커밋하기. README가 금하는 두 번째
사본이다. catalog에서 FT.INFO를 빼기. SDK가 문서로 지원한다고 한 진단이다.

위험·한계: entrypoint를 거치며 7.x에서도 서버 사용자가 redis로 바뀐다.
/tmp의 nodes.conf와 읽기 전용 ACL 마운트는 그 사용자도 읽고 쓸 수 있다.

검증: runner redis-topology 11칸(nightly 수동 실행, 이 PR 본문에 적는다).
2026-11-12 01:25:53 +09:00
DongHyeonka cfc80ae8d4 build(release): 기본 이미지를 noble로 올리고 이미지 검사를 취약점과 라이선스로 나눈다
pr / done (pull_request) Failing after 12m44s
문제: release 수동 실행(run 62)의 app-image-release가 Trivy에서 실패한다. 기본
이미지 eclipse-temurin:21-jre-jammy(ubuntu 22.04)에 고친 버전이 있는 OS 취약점
HIGH 7건(apt, libssl3/openssl, libbrotli1 등)과 OS 패키지 라이선스 HIGH 370건이
걸렸다. 앱 jar는 0건이다.

고른 방법(2026-11-11 소유자 결정 「권하는 안」):
- builder·runtime을 eclipse-temurin:21-{jdk,jre}-noble(ubuntu 24.04.5)의
  2026-10-29 digest로 올린다. noble 이미지에는 uid·gid 1000인 `ubuntu` 계정이
  있어, 앱 계정(uid 1000)을 만들기 전에 지운다. wget(healthcheck)과 C.UTF-8은
  noble에도 있다(desktop에서 확인).
- 취약점: OS·앱 모두 High/Critical이면 실패를 유지한다. 고친 버전이 있으면
  새 digest로 고치고, 아직 없는 것만 .trivyignore.yaml에 만료일 예외로 둔다.
- 라이선스: 앱 의존성(`--pkg-types library`)의 금지 라이선스(Trivy CRITICAL)만
  실패. OS 패키지 것을 포함한 나머지는 보고만 한다.
- 정책 문서(.github/dependency-vulnerability-policy.md)에 같은 내용을 적는다.

위험·한계: noble로 바꾸며 아직 고친 버전이 없는 High가 새로 보일 수 있다.
그때는 이유와 만료일을 달아 예외로 둔다. PR의 filesystem 검사는 그대로라
앱 의존성의 restricted(HIGH) 라이선스는 PR에서 여전히 막힌다.

검증: runner release 수동 실행의 app-image-release(이 PR 본문에 적는다),
desktop compose smoke(같은 Dockerfile로 qualification 이미지를 만든다).
2026-11-12 01:18:24 +09:00
DongHyeonka 96caf997f8 ci: Gradle job마다 JDK를 내려받지 않고 runner 캐시에서 복원한다
문제: job 컨테이너가 매번 새것이라 setup-java가 빈 tool cache를 보고 Temurin
21.0.11(약 190MB)을 job마다 GitHub에서 받는다. job 하나에 21~23초, nightly
한 번(Gradle job 28개)에 약 9.5분, release 수동 한 번에 약 4분이다. 11-09에는
같은 GitHub 내려받기가 504로 실패한 job도 있었다.

고른 방법: setup-java 앞에서 actions/cache v4.3.0(node20, 커밋 SHA 고정)으로
setup-java가 설치하는 tool cache 폴더를 복원한다. setup-java는 tool cache를
먼저 보므로 복원되면 내려받지 않는다. 키는 Temurin 빌드 하나를 가리키므로
어느 브랜치에서 저장해도 내용이 같다. pull request는 읽기만 한다(검토 중인
코드가 JDK를 바꿔 넣지 못하게). push·schedule·수동 실행은 쓰기 권한자만
시작할 수 있어 저장을 허용한다.

버린 대안: JDK가 든 runner 이미지 쓰기. runner 설정은 다른 저장소(platform-core)다.

위험·한계: runner 캐시 상한은 5GB다. 이 항목은 압축 후 약 150~200MB다.

검증: runner 수동 실행 두 번째 Gradle job부터 「Trying to download」가 없는지,
setup 시간(이 PR 본문에 적는다).
2026-11-12 01:18:24 +09:00
DongHyeonka deeb1126b5 ci(pr): PR 단계를 job 하나로 접는다
문제: pr.yml은 gradle·vulnerabilities·done 세 job이고 필수 검사는 `done`이다.
`done`은 앞 두 job이 끝나야 runner 대기열에 들어가는데, Gitea는 대기열에
들어온 순서로 job을 집는다. 그래서 그사이에 줄 선 다른 run의 job이 먼저
돈다. 2026-11-08 PR #7의 run 61은 gradle이 22:55에 끝났는데 `done`은 release
수동 실행(13 job)과 main 수동 실행(30 job)이 다 끝난 01:47에야 돌았다.
job마다 checkout과 준비도 다시 한다.

고른 방법: `done` job 하나가 `./gradlew :prCheck`, `verifyStrictLaneStages
--dry-run`, Trivy 검사를 차례로 돈다. 필수 검사 이름 `pr / done
(pull_request)`은 그대로라 저장소 보호 규칙은 바꾸지 않는다. strict lane
단계 선언의 PR job을 `done`으로 바꾼다. 단계 job의 step은 `./gradlew` 한
줄만 허용했는데, 저장소 스크립트 한 줄(`bash scripts/<이름>.sh <단어>...`)도
허용한다. 자기 step이라 종료 코드가 job을 실패시키고 단계 줄의 결과를 가릴
수 없다. 셸 문법을 붙인 스크립트와 저장소 밖 명령은 여전히 막는다(TestKit
시험 셋을 더했다).

버린 대안: trivy를 Gradle Exec 태스크로 감싸 `./gradlew` 줄로 만들기. desktop
verify가 도구를 내려받아 설치하게 된다(docs/work/operate.md 4.1절이 막는다).

위험·한계: Trivy가 마지막 step이라 Gradle이 실패하면 그 PR의 취약점 결과는
Gradle을 고친 뒤에 보인다. main push와 nightly가 같은 트리를 다시 검사한다.

검증: build-logic 시험(desktop), runner에서 이 PR의 `pr / done`.
2026-11-12 01:18:07 +09:00
DongHyeonka 575aa1f766 ci: needs와 if를 함께 쓰는 job을 없애 Blocked에 멈추지 않게 한다
문제: main.yml의 `performance`는 한 번도 돌지 않았다. 수동 실행(run 63)에서는
2.5일 동안, main push(run 79)에서는 지금까지 Blocked다. Gitea API의 job
상태 `waiting`은 runner를 기다리는 것(`queued`)이 아니라 서버의 Blocked다.
Gitea 1.27은 앞 job이 끝나면 `needs`가 있는 job의 `if`를 서버에서 계산하고,
계산이 실패하면 Blocked로 둔다. 일회용 workflow 세 가지(입력 있음·없음,
concurrency 있음·없음)를 수동 실행해 보니, `needs`와 `if`를 함께 가진 job
여섯 개가 `if` 내용(`!cancelled()`, `always()`, 이벤트 이름만)과 앞 job 결과에
상관없이 모두 Blocked였다. `if`가 없는 `needs` job과 `needs`가 없는 `if` job은
제대로 풀렸다. release.yml의 `app-image-signing`도 같은 모양이라 수동 실행이
끝나지 않는다.

고른 방법:
- performance: `needs`를 지우고 파일 맨 끝에 둔다. `needs` 없는 job은 run이
  시작할 때 대기열에 들어가고, capacity 1인 runner 하나는 run의 job을 만든
  순서(파일 순서)대로 돈다. 조건은 `github.event_name != 'push'` 하나다.
  build.gradle의 strict lane 단계 선언도 같은 조건으로 바꾼다.
- app-image-signing: job 조건을 두 step의 조건으로 옮긴다. 수동 실행에서는
  job이 뜨고 step이 모두 건너뛴다. 키를 가진 job이 하나뿐이라는 시험은
  그대로 두고, 조건을 보는 단언만 step으로 옮긴다.

버린 대안: performance를 별도 workflow로 빼기. workflow는 셋(pr·main·release)만
둔다는 규칙(docs/work/reference/gates.md)을 바꾸게 된다.

위험·한계: runner가 둘이 되거나 capacity가 1보다 커지면 performance가 다른
job과 겹칠 수 있다. 그래도 돌기는 한다. 원인이 Gitea 서버 쪽이라 Gitea를
올리면 다시 확인할 일이다. 수동 실행으로만 재현했고 push 실행의 원인은
같은 증상으로 판단했다.

검증: verifyStrictLaneStages --dry-run(desktop·runner PR), runner main 수동
실행에서 performance가 마지막에 도는지(이 PR 본문에 적는다).
2026-11-12 01:17:52 +09:00
DongHyeonka 7054d179bd ci(main): notification-chaos가 네 suite를 한 번에 돌리고 결과를 확인한다
문제: notification-chaos는 같은 `:adapter:outbound:notification:test`를 필터를
바꿔 `--rerun`으로 두 번 돌린 뒤 「이름 붙인 suite가 정말 돌았나」를 본다.
두 번째 실행이 첫 실행의 결과 XML을 지워서 ChaosSecurity 결과가 없다고
매번 실패한다(run 52·63). 시험 자체는 두 번 다 통과했다.

고른 방법: 네 필터를 한 번의 실행에 넣고, 확인 step을 PostgreSQL 재실행
step보다 앞에 둔다. Gradle 시작과 시험 JVM 기동도 한 번 준다.

버린 대안: 실행마다 결과 폴더를 옮겨 두기. step이 셸 스크립트가 되고, 같은
태스크를 두 번 돌릴 이유가 없다.

위험·한계: 두 묶음이 같은 JVM에서 돈다. 묶음끼리 상태를 나누면 드러날 수
있는데, 그것은 이 job이 찾으려는 종류의 결함이다.

검증: runner main 수동 실행의 notification-chaos(이 PR 본문에 적는다).
2026-11-12 01:17:35 +09:00
DongHyeonka c7aff0f4f0 ci(links): lychee-action을 v2.9.0으로 올려 --root-dir을 읽게 한다
문제: main의 links job이 run 52·63·79 모두 `lychee: unexpected argument
'--root-dir'`로 실패한다. 고정한 lychee-action v2.0.2는 lychee v0.16.1을
받는데, 그 버전에는 --root-dir이 없다. 상대 경로 --root-dir은 lychee
v0.22.0부터 읽는다.

고른 방법: action을 v2.9.0(lychee v0.24.2, 2026-07-09)의 커밋 SHA로 올린다.
Gitea의 job token은 lychee가 보낼 GitHub 쪽에서 의미가 없어 token을 비우고,
Gitea에 없는 job summary를 끈다. DeveloperExperienceContractTest가 고정한
SHA를 함께 바꾼다.

버린 대안: v2.0.2에 lycheeVersion만 새로 주기. v2.0.2의 내려받기 경로는
lychee 0.16 이전의 자산 이름을 쓴다.

위험·한계: 새 lychee가 전보다 많은 외부 링크를 깨졌다고 볼 수 있다. 그러면
링크를 고치거나 .lycheeignore에 이유와 함께 넣는다.

검증: runner main 수동 실행의 links job(이 PR 본문에 적는다).
2026-11-12 01:17:11 +09:00
DongHyeonka 8648825676 fix(web): 응답 유실 시험의 준비 요청이 장애용 짧은 읽기 제한을 쓰지 않는다
문제: HttpResponseLossFixture.reset()은 시나리오 전에 부수 효과 카운터를
지우는 DELETE다. 이 요청이 응답을 일부러 버리는 호출용 읽기 제한(750ms)을
그대로 썼다. 부하가 높은 runner에서 평범한 reset 응답이 그보다 늦어
JettyCommitThenConnectionResetIT가 시나리오를 시작하기도 전에
SocketTimeoutException으로 실패했다(main run 24, 2026-11-08, 세 번 중 한 번).

고른 방법: 재시도와 부수 효과 조회처럼 넉넉한 HttpFixtureTimeouts.READ_MILLIS를
쓴다. 짧은 제한은 장애를 건 호출에만 남는다.

위험·한계: 시험이 보는 동작은 바뀌지 않는다. 준비 단계가 기다릴 수 있는
시간만 늘었다.

검증: desktop mainCheck(webJettyCompatTest 포함), runner main 수동 실행.
2026-11-12 01:16:57 +09:00
DongHyeonka 6325b5183f fix(compose): root로 도는 CI에서도 Keycloak이 smoke lane secret을 읽는다
문제: compose smoke는 실행마다 Keycloak client secret을 0600 파일로 만든다.
Compose는 파일을 소유자·권한 그대로 붙이고 Keycloak은 이미지 사용자 uid
1000으로 읽는다. runner job은 root라 파일이 root 소유가 되고, Keycloak
entrypoint가 읽지 못해 exit 78로 끝난다. auth profile을 쓰는 8 lane이
run 52·63에서 모두 이것으로 실패했다. desktop은 만든 사람이 uid 1000이라
통과했다.

고른 방법: root면 파일을 uid 1000에게 넘기고 0600을 지킨다. uid 1000도
root도 아니면 같은 스크립트의 Mailpit 키처럼 0644로 둔다(값은 실행마다
새로 만들고, Git이 무시하는 폴더에 있고, 끝나면 지운다).

위험·한계: Keycloak 이미지의 사용자가 1000이 아니게 바뀌면 상수를 고쳐야
한다. 이미지 태그(26.0)를 올릴 때 확인할 것으로 주석에 적었다.

검증: runner main 수동 실행의 compose-smoke(이 PR 본문에 적는다).
2026-11-12 01:16:57 +09:00
DongHyeonka ecc1400486 fix(objectstorage): Minio TLS 시험이 CI job 안에서도 컨테이너에 닿는다
문제: MinioS3ManagedObjectProviderContractTest는 endpoint를
`https://localhost:<포트>`로 고정했다. Gitea runner의 job 컨테이너 안에서
localhost는 job 컨테이너 자신이고, Testcontainers가 띄운 MinIO는 dind
daemon 쪽에 있다. 그래서 main의 integration job이 run 52·63·79 세 번 모두
이 시험의 연결 거부로 빨갛다. desktop에서는 둘이 같아 통과한다. 시험
인증서도 localhost와 127.0.0.1만 이름으로 가졌다.

고른 방법: 같은 lane의 평문 시험(MinioManagedObjectContractTest)처럼
Testcontainers가 알려 주는 Docker 호스트 주소로 붙고, 그 주소를 인증서
SAN에 더한다(IP면 ip:, 이름이면 dns:). 인증서는 컨테이너보다 먼저
만들어야 하므로 주소는 DockerClientFactory에서 받는다.

버린 대안: 인증서 검증을 끄는 것. 이 시험은 운영 클라이언트 그대로
HTTPS로 붙는 것이 목적이라 검증을 끄면 시험이 다른 경로를 본다.

위험·한계: IPv6 호스트는 URI에 대괄호를 씌우는 것만 넣었고 그 환경에서
돌려 보지 않았다.

검증: desktop integrationCheck, runner main 수동 실행(이 PR 본문에 적는다).
2026-11-12 01:16:56 +09:00
DongHyeonka 1444d1e0df docs(security): 요청률 제한은 기본 off·ingress 책임임을 명시한다
pr / vulnerabilities (pull_request) Successful in 1m1s
pr / gradle (pull_request) Failing after 7m18s
pr / done (pull_request) Canceled after 0s
W4 red team BE-OBS-A 소유자 결정(2026-11-12): 요청 빈도 제한은 앱 기본 off로 두고
ingress/gateway 책임으로 명시한다. 앱은 크기/양 bound는 이미 강제하고, 빠진 축은
요청 빈도 하나이며 그것은 앞단이 서비스 전체 기준으로 보는 게 맞다.

docs/security/rate-limiting.md에 자세(기본 off·ingress 책임)와 앞단에서 안 거는
배포를 위한 앱 내 redis limiter 켜는 법(모듈·env·client-ip 주의)을 적는다. 운영
매뉴얼(docs/work/operate.md 파생 서비스 절)과 PR 체크리스트(docs/manual/
11-checklist.md inbound)에서 가리켜, 파생 서비스가 릴리스 전에 "요청률을 어디서
거는가"를 정하게 한다.

동작/코드 변경 없음(문서만).
2026-11-12 01:15:07 +09:00
DongHyeonka f15cfc4ad6 docs(reviews): W4 red team 보안 리뷰와 발견 처리를 남긴다
공격 표면 목록·ASVS L2/API Top 10 행렬·정적/수동/동적 결과와 발견 3건
(BE-CONFIG-001 고침·BE-INPUT-002 고침·BE-INPUT-001 by-design 재분류)을
기록한다. 소유자 결정 칸에 BE-OBS-A(요청률 제한 기본 off)를 올린다.
2026-11-12 01:15:07 +09:00
DongHyeonka a1e2cd4988 docs(web-advanced): XML 매퍼가 CBOR의 coercion 잠금을 안 쓰는 이유를 적는다
red team 리뷰가 WebXmlMapperFactory를 WebCborMapperFactory의 scalar-coercion
잠금(withCoercionConfig String->Fail, Textual Integer->Fail)을 빠뜨린 것으로 보고
표현별 엄격성 불일치를 의심했다. 실제로는 by-design이다: XML은 textual 포맷이라
숫자·불리언 DTO 필드도 전부 String 토큰(<count>5</count>)으로 들어온다. 거기서
String 입력을 막으면 모든 숫자/불리언 바인딩이 깨지고, WebCodecMapperTest의
xmlRoundTripPreservesWireTypes(int count를 바인딩)가 바로 그걸 고정한다. CBOR과의
엄격성 차이는 검증 우회가 아니다 — FAIL_ON_UNKNOWN_PROPERTIES와 SecureXmlInputFactory
하드닝은 여기에도 적용되고, @Valid 제약은 바인딩 뒤 모든 표현에 돈다.

순진한 "parity fix"가 멀쩡한 XML 바인딩을 깨뜨리지 않도록, 왜 CoercionConfig를
두지 않는지 주석으로 못 박는다(동작 변경 없음).

검증: :adapter:inbound:web-advanced:test --tests '*WebCodecMapperTest*' rc=0(무회귀).
2026-11-12 01:15:07 +09:00
DongHyeonka bb8bb31b9c fix(fileserver): admin reconcile의 @RequestBody에 @Valid를 더한다
web-fileserver admin 평면에서 orphans:reconcile만 @RequestBody에 @Valid가 없었다.
다른 다섯 핸들러(relocate·force-delete·submit-notification 등)는 모두 @Valid다.
지금은 OrphanReconcileHttpRequest에 Bean Validation 제약이 없어 드러나지 않지만,
나중에 limit에 @Min, reason에 @NotBlank를 더하면 @Valid가 없어 조용히 무시된다 —
이 템플릿이 평소 막는 검증 우회 부류다.

reconcileOrphans 파라미터에 @Valid를 더하고, 이 컨트롤러의 모든 @RequestBody가
@Valid를 갖는지 반사로 확인하는 막는 시험을 더해 admin 평면 전체에 규약을 고정한다.

검증: RED→GREEN — @Valid를 빼면 FileserverAdminControllerRequestBodyValidationTest
가 실패(rc=1, 그 파일 41행 AssertionError: offenders 비지 않음), 넣으면
:adapter:inbound:web-fileserver:test rc=0.
2026-11-12 01:15:07 +09:00
DongHyeonka 9fb5a61fc7 fix(actuator): 관리 포트를 loopback에 고정해 무인증 노출을 막는다
`management.server.address`가 비어 있어 Spring이 관리 커넥터를 모든 인터페이스
(0.0.0.0)에 바인딩했다. 별도 포트는 별도 네트워크가 아니다. 그 포트의
health·prometheus·info는 permitAll이고 actuator 체인에 인증 메커니즘이 없어,
파드/호스트 네트워크의 누구에게나 무인증으로 응답한다.

동적으로 확인했다(bootRunH2): `ss`가 `*:9001`, `curl :9001/actuator/health·info·
prometheus`=200. info는 build group/artifact/version·capabilities를, prometheus는
disk 경로·free/total·JVM·timing을 유출한다(API 표면·인프라 토폴로지). compose의
`127.0.0.1:9001` publish는 Docker 호스트만 막고 같은 compose 네트워크의 형제
컨테이너나 NetworkPolicy 없는 k8s/bare 배포는 막지 못한다. 선행 리뷰(07-13)는
compose publish만 확인했고 앱의 bind 주소는 보지 않았다.

observability.yml에 `management.server.address: ${MANAGEMENT_SERVER_ADDRESS:
127.0.0.1}`를 둬서 posture가 compose·NetworkPolicy에 의존하지 않고 앱 자체에서
loopback으로 닫히게 한다. 원격 스크레이프 배포는 그 env를 명시하거나 loopback
사이드카로 긁는다. 노출 allowlist는 그대로다.

버린 대안:
- 하드코딩 `127.0.0.1` → operator override 불가, env-driven 관례 위반.
- compose/NetworkPolicy에만 의존 → 앱 밖 설정에 보안 posture를 맡김(이 발견의 원인).

검증: 막는 계약 시험 `actuator-contract:management-address-loopback`를 더했다.
desktop에서 RED→GREEN 확인 — address 줄을 빼면 그 시험이 실패(rc=1,
ManagementActuatorSecurityContractTest.java:239 AssertionError), 넣으면
`:app-bootstrap:test` rc=0. build-logic `EnvContractVerifierTest` rc=0(env-keys와
설정 정합).
2026-11-12 01:15:07 +09:00
donghyeon.kang 841a176fc9 Merge pull request 'refactor(layout)!: Gradle 루트를 저장소 루트로 옮기고 src/에는 계층 코드만 둔다' (#10) from claude/t2b-relayout-e435ee into main
main / main (push) Failing after 16m36s
main / integration (push) Failing after 22m20s
main / build-logic (push) Successful in 2m8s
main / configuration-cache (push) Successful in 2m58s
main / links (push) Failing after 8s
main / vulnerabilities (push) Successful in 1m9s
main / http3-experimental (push) Successful in 2m22s
main / jpa-postgresql (16) (push) Skipped
main / jpa-postgresql (17) (push) Skipped
main / jpa-postgresql (18) (push) Skipped
main / httpclient-transport (apache) (push) Skipped
main / httpclient-transport (jdk) (push) Skipped
main / redis-topology (7.2, sentinel) (push) Skipped
main / redis-topology (7.2, standalone) (push) Skipped
main / redis-topology (7.4, sentinel) (push) Skipped
main / redis-topology (7.4, tls) (push) Skipped
main / redis-topology (8.2, sentinel) (push) Skipped
main / redis-topology (8.2, standalone) (push) Skipped
main / fileserver-nfs-ambiguity (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 / compose-smoke (push) Skipped
main / redis-topology (7.2, cluster) (push) Skipped
main / redis-topology (7.4, cluster) (push) Skipped
main / redis-topology (7.4, standalone) (push) Skipped
main / redis-topology (8.2, cluster) (push) Skipped
main / redis-topology (8.2, tls) (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 / performance (push) Canceled after 0s
2026-11-11 16:13:47 +00:00
DongHyeonka 97798b5a35 docs(ledger): Gradle 루트 재배치 작업의 실측을 남긴다
pr / gradle (pull_request) Successful in 11m45s
pr / vulnerabilities (pull_request) Successful in 1m1s
pr / done (pull_request) Successful in 4s
2026-11-12 00:39:58 +09:00
DongHyeonka c611b06f03 feat(claude): 분야 전문가를 지식 스킬 열 개와 렌즈 리뷰어로 두고 협업 명단을 붙인다
pr / vulnerabilities (pull_request) Canceled after 0s
pr / done (pull_request) Canceled after 0s
pr / gradle (pull_request) Canceled after 8m18s
문제: 하네스에 분야 지식이 없다. 영속성·메시징·보안·관측·성능·API 계약·
빌드·시험·문서·도메인의 이 repo 규칙(적용된 마이그레이션 금지, 잠금 상한,
동시 인덱스 빌드, env 키 레지스트리 등)은 문서에 흩어져 있어, 세션이 그
문서를 찾아 읽어야만 지킨다. 여러 분야에 걸친 일을 누가 보고 어떻게
합치는지도 정한 곳이 없다.

고른 방법(소유자 결정 2026-11-11 「W3 설계대로」):
- 지식 스킬 be-* 10개(.claude/skills/). 각자 paths를 걸어 그 분야 파일을
  만질 때만 목록에 뜬다. 본문은 언제 쓰나 → 함정 → 실패는 이렇게 보인다 →
  검증 → 이 repo에서 정한 것 순서이고, 정본 문서를 가리킨다. 초안은 이
  repo 문서만 본 서브에이전트가 썼고, 경로는 relayout 배치에 맞췄다.
- 서브에이전트 reviewer(렌즈 = brief의 스킬 경로). arch-reviewer는
  be-domain을 미리 싣고 lead 공통 양식으로 돌려준다.
- .claude/rules/expert-skills.md: 분야 파일을 고치기 전에 그 스킬의
  「함정」·「검증」을 보게 하는 두 줄(평가에서 스킬 호출이 5번 중 2번이었다).
- docs/work/experts.md: 명단·경로 → 렌즈·넘김 지도·충돌·비용. 루트
  AGENTS.md 한 줄, CLAUDE.md 두 줄 고침(10줄 상한 유지), README 3절 4단계와
  delegate.md 4.3절에 가리키는 말.
- 시험: 에이전트 넷, Agent 도구 금지, 설명 합 1,200자, 지식 스킬의 paths·
  설명 300자·금지어·절 순서·150줄, 모든 paths glob이 추적 파일에 걸림,
  명단이 모든 전문가를 담음.
버린 대안: 분야마다 서브에이전트. Anthropic 2026-10-22·2026-01-23·2026-04-07
글이 반대하고, 설명이 모든 세션에 든다.

위험: 플러그인 lead·new-expert·harness-eval은 claude-harness PR #3(0.3.0)이
병합돼야 받는다. 그전에는 lead를 가리키는 문장이 설명만 남는다.

검증: python3 -m unittest discover -s scripts/tests → 154건 통과. 새 시험 6개는
조건을 깰 때마다 실패했다. scripts/verify.sh docs → rc=0.
2026-11-11 23:19:44 +09:00