Commit Graph
306 Commits
Author SHA1 Message Date
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
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 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 123fc0bfae docs(ledger): Gradle 루트 재배치 작업의 착수 예측을 남긴다
pr / gradle (pull_request) Successful in 11m25s
pr / vulnerabilities (pull_request) Successful in 1m3s
pr / done (pull_request) Successful in 3s
2026-11-11 22:15:42 +09:00
DongHyeonka 6a792b8144 refactor(layout)!: 옮긴 경로를 부르는 곳을 모두 새 배치에 맞춘다
문제: 앞 커밋이 Gradle 루트를 저장소 루트로 옮기고 계층 폴더를 묶었다.
빌드 스크립트·build-logic·시험·workflow·스크립트·문서가 아직 옛 배치
(Gradle 루트 = src/)를 가정해 빌드가 되지 않는다.

고른 방법:
- Gradle 경로와 registry id는 그대로 둔다(:app-bootstrap, :application-core,
  :composition:*). registry의 source_path만 새 폴더를 가리킨다. 폴더에 맞춘
  이름(:domain:core, :application:core)은 프로젝트 이름 core가 둘이 되어
  boot jar의 BOOT-INF/lib와 기본 capability가 겹치고, 파생 서비스의 모든
  project(':…') 줄을 바꾸게 한다.
- registry는 gradle/modules.json, 시험 이미지 목록은
  gradle/container-images.properties: 버전 카탈로그 옆, 빌드가 고정하는 것.
  config/는 코드 검사 도구 설정만 둔다.
- build-logic: settings·architecture 플러그인의 저장소 루트를 Gradle 루트로
  (getParentFile 제거). config contract의 파일 트리는 src/만 훑는다(루트를
  훑으면 docs·.claude/worktrees까지 줍는다).
- 빌드 스크립트: rootProject.projectDir.parentFile → rootProject.projectDir,
  rootProject.file('../…') → rootProject.file('…'), 옛 src 기준 include에
  src/를 붙인다. notification API surface의 application-notification 소스
  루트를 새 폴더로(놓치면 272개 타입이 surface에서 말없이 빠진다).
- 시험: 옛 src 기준 모듈 목록과 ../ 개수를 고친다. 없는 폴더를 말없이
  건너뛰던 목록(MessagingAuthority, NotificationPayloadAtRest 등)을 새
  폴더로, FileserverDocumentationCoverageTest는 Gradle 경로 → 폴더를
  registry로 찾는다. Docker 계약은 WORKDIR /build, 새 jar 경로.
- Docker: 빌드 context를 저장소 루트로, .dockerignore는 허용 목록으로 다시
  써서 전에 context였던 것만 들어가게 한다. compose의 build.context는 .,
  env_file은 ./.env.
- workflow: working-directory: src 기본값과 그것을 되돌리던 줄을 지운다.
- scripts: verify.sh, ci/*, bootstrap-local, new-feature,
  verify-feature-scaffold, mongo 검증, hooks, check-repo-layout 허용 목록.
  check-docs의 경로 검사는 build-logic/·gradle/로 시작하는 경로도 본다.
- 문서: AGENTS.md 지도, README 구조 표, leaf AGENTS.md의 cd src, gates·
  operate·결정 색인, src/bootstrap/AGENTS.md를 조립 계층 family 규칙으로
  다시 쓴다. 기록 문서(docs/design·history·reviews, 지난 upgrade 안내,
  capability-status 제거 표)는 머리 블록만 고친다. 파생 서비스용 안내
  docs/upgrade/2026-11-relayout.md를 더한다.

위험: bootRun working dir가 저장소 루트가 되어 .env와 상대 경로 설정이
루트 기준이다. 루트 .env는 compose 보간에도 읽힌다(upgrade 안내 5절).
파생 서비스는 태그 pre-relayout-2026-11까지 받은 뒤 이 묶음을 받는다.

검증: desktop에서 캐시 없이 scripts/verify.sh docs·pr·main·release,
compose smoke 18 lane, 빠른 시작(scripts/verify.sh app). 결과는 PR 본문.
구조 리뷰(arch-reviewer) 지적 5건을 반영했다.

BREAKING CHANGE: Gradle은 저장소 루트에서 돈다(cd src 없음). registry는
gradle/modules.json, 이미지 빌드 context는 저장소 루트다. 옛 경로 → 새 경로
표는 docs/upgrade/2026-11-relayout.md.
Refs: design-docs repo-structure/01-backend-layout.md 6.1절 가-2·가-3
2026-11-11 22:15:42 +09:00
DongHyeonka 1388c06a9f refactor(layout)!: Gradle 루트와 계층 폴더를 옮긴다(옮기기만)
문제: Gradle 루트가 src/라서 빌드 도구(build-logic, gradle, config, 빌드
파일)가 계층 코드 폴더 옆에 섞여 있다. composition과 app-bootstrap은 같은
조립 계층인데 폴더가 따로이고, application 모듈 넷은 최상위에 흩어져 있다.
「Gradle은 src/에서 실행」이라는 예외 규칙이 모든 문서와 스크립트에 퍼졌다.

고른 방법: 저장소 루트를 Gradle 루트로 하고 src/에는 계층 코드만 둔다
(design-docs repo-structure/01-backend-layout.md 6.1절 가-2·가-3, 소유자
승인 2026-11-07). 이 커밋은 git mv만 한다. 이름 바꾸기 감지가 1541개
파일 모두를 R100으로 잡도록 내용을 바꾸지 않았다. 바뀐 곳은 둘뿐이다:
src/.gitignore의 줄을 루트 .gitignore로 옮겼다.

- 빌드 파일, gradle/, build-logic/ → 저장소 루트
- config/checkstyle·spotbugs → config/ (코드 검사 도구 설정만)
- registry config/architecture/modules.json → gradle/modules.json,
  시험 이미지 config/testing/container-images.properties
  → gradle/container-images.properties, registry 설명 → gradle/README.md
- Dockerfile, .dockerignore, .env*.example → 저장소 루트
- src/README.md(빌드·env 참조) → docs/build.md
- src/domain-core → src/domain/core,
  src/application-* → src/application/*,
  src/app-bootstrap → src/bootstrap/app,
  src/composition/* → src/bootstrap/*
- 기능 생성 템플릿 scripts/feature-scaffold/{templates,probes}/src/ 아래도
  같은 모양으로(domain/core, application/core, bootstrap/app)

위험: 이 커밋만으로는 빌드되지 않는다. 경로를 부르는 곳은 다음 커밋이
고친다. 두 커밋을 나눈 것은 파생 서비스가 merge할 때 이름 바꾸기와 내용
변경을 따로 보게 하려는 것이다.

검증: git diff --cached -M --name-status 에서 R100 1541개, 그 밖은
.gitignore 수정과 src/.gitignore 삭제뿐.

BREAKING CHANGE: 모든 빌드 파일과 계층 폴더의 경로가 바뀐다. 옛 경로 →
새 경로 표와 받는 순서는 docs/upgrade/2026-11-relayout.md에 있다.
Refs: design-docs repo-structure/01-backend-layout.md 6.1절
2026-11-11 21:04:21 +09:00
donghyeon.kang 66eaa98202 Merge pull request 'ci!: workflow를 pr·main·release 셋으로 접고 Gitea runner에서 돌린다' (#7) from claude/t2a-backend-ci-451e3b into main
main / main (push) Successful in 17m8s
main / configuration-cache (push) Successful in 2m3s
main / integration (push) Failing after 17m27s
main / build-logic (push) Successful in 1m24s
main / links (push) Failing after 6s
main / vulnerabilities (push) Successful in 43s
main / http3-experimental (push) Successful in 1m59s
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 / 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 / performance (push) Canceled after 0s
pre-relayout-2026-11
2026-11-11 11:25:17 +00:00
DongHyeonka 9c202b7b58 style(websocket): Nginx 하네스 주석을 100칸 안으로 줄인다
pr / gradle (pull_request) Successful in 12m41s
pr / vulnerabilities (pull_request) Successful in 44s
pr / done (pull_request) Successful in 2s
b0bca2a6이 단 주석 한 줄이 100칸을 넘어 spotlessJavaCheck가 PR #7의
pr.yml(run 61)을 막았다. 같은 뜻으로 줄을 다시 나눈다.

검증: desktop :adapter:inbound:websocket:spotlessJavaCheck와 check 통과.
2026-11-09 10:53:58 +09:00
DongHyeonka 78cbc865f3 docs(ledger): CI 재편 작업의 예측·실측과 하네스 회고 줄을 남긴다
pr / gradle (pull_request) Failing after 10m21s
pr / vulnerabilities (pull_request) Successful in 37s
pr / done (pull_request) Failing after 1s
t2a-backend-ci의 착수 예측(p30·p50·p80)과 실측(작업 중 132분, 호출 374,
출력 37.5만, 벽시계 849분)을 더한다. 하네스 회고(claude-harness
docs/retro/2026-11-08.md 7절)가 정한 retro 줄 셋(h3·x2·x3)을 ledger.py
append로 더한다. 이미 있던 줄은 고치지 않았다.
2026-11-09 06:56:44 +09:00
DongHyeonka 74b0599f12 fix(ci): Redis topology 스크립트가 데몬 호스트 주소를 바르게 읽는다
redis-topology.sh는 job 컨테이너의 기본 게이트웨이(=Docker 데몬 호스트)를
/proc/net/route에서 awk로 읽었다. awk는 "0x.." 문자열을 0으로 읽어 주소가
0.0.0.0이 됐고, 포워더가 자기 자신에게 이어 붙어 "Too many open files"로
main.yml 수동 실행(run 52)의 redis-topology 11행이 모두 실패했다.

python3로 little-endian 16진수를 바르게 바꾸고, 주소가 없거나 0.0.0.0이면
그 자리에서 실패한다.

검증: 노트북에서 같은 계산이 기본 게이트웨이를 낸다. runner 재실행은
다음 main.yml 수동 실행에서.
2026-11-09 06:56:38 +09:00
DongHyeonka b0bca2a62a fix(websocket): Nginx lane이 job 컨테이너 안의 앱에도 닿게 한다
websocketNginxTest의 Nginx 컨테이너는 host.docker.internal을
host-gateway(Docker 호스트)로 풀어 시험 JVM의 앱에 붙었다. desktop에서는
Docker 호스트가 곧 JVM의 호스트라 됐지만, Gitea runner처럼 job이 자기
컨테이너 안에서 돌면 앱은 거기 없다. release 수동 실행(run 51)의
websocket-stable-release-gate가 upgrade마다 DeploymentException으로
실패했다.

Testcontainers의 호스트 포트 노출(exposeHostPorts, withAccessToHost)로
host.testcontainers.internal을 이 JVM으로 잇는다. 두 환경에서 같은
이름이다. 버린 것: runner 설정을 host 네트워크로 바꾸기(platform-core 몫,
job 격리를 푼다).

위험: Testcontainers가 sshd 보조 컨테이너를 하나 더 띄운다(이미지는
Testcontainers가 고정한 것, container-images.properties 밖).

검증: desktop에서 :adapter:inbound:websocket:websocketNginxTest.
2026-11-08 23:52:07 +09:00
DongHyeonka d0c3f91a3b docs: 비전과 문제 정의의 빈 양식을 둔다
하네스 설계(design-docs harness/01-harness-design.md)는 검증 진입점
scripts/verify.sh와 비전 문서 docs/vision.md가 함께 생긴다고 했다.
verify.sh는 이 브랜치가 만들었는데 비전과 문제 정의 자리가 없었다.

claude-harness template/docs의 두 양식을 옮긴다. vision.md는 세 문장
자리만 두고 소유자가 쓴다(에이전트는 읽기만 한다). problem-statement.md는
고객의 말 그대로·지금 버티는 법·하지 않는 것·잴 수 있는 성공 기준 칸을
둔다. AGENTS.md 첫 문단과 docs/README.md 「폴더 밖 문서」가 두 파일을
가리킨다.

검증: python3 scripts/check-docs.py, check-work-docs.py 통과.
2026-11-08 22:32:16 +09:00
DongHyeonka 4d778c2293 Merge remote-tracking branch 'origin/main' into claude/t2a-backend-ci-451e3b
pr / gradle (pull_request) Successful in 12m38s
pr / vulnerabilities (pull_request) Successful in 36s
pr / done (pull_request) Successful in 0s
메시징 플랫폼 분리(PR #8)를 받는다. 충돌 둘: 옛 integration-main.yml은
이 브랜치가 지웠으므로 삭제를 둔다(메시징 측정 주석은 main.yml에 옮길
측정 수치가 없어 버린다). 업그레이드 안내는 메시징 절을 3.9(B-57~B-59)로
두고 CI 절을 3.10(B-60~B-66)으로 미룬다.
2026-11-08 22:20:58 +09:00
donghyeon.kang 1272a5e4d8 Merge pull request 'refactor(platforms)!: 메시징 플랫폼을 messaging-library 1.0.0으로 받고 지운다' (#8) from claude/x3-messaging-library-1aa3fa into main
build-logic / included-builds (push) Canceled after 0s
ci-quality-gates / quality-gates (push) Canceled after 0s
ci-quality-gates / release-gate (push) Canceled after 0s
dependency-vulnerability / dependency-review (push) Canceled after 0s
dependency-vulnerability / dependency-submission (push) Canceled after 0s
dependency-vulnerability / trivy-fs (push) Canceled after 0s
docs-check / docs (push) Canceled after 0s
integration-main / configuration-cache (push) Canceled after 0s
integration-main / integration-check (push) Canceled after 0s
integration-main / performance-check (push) Canceled after 0s
integration-main / httpclient-http3-experimental (push) Canceled after 0s
integration-main / compose-runtime-smoke (push) Canceled after 0s
integration-main / main-check (push) Canceled after 4s
link-check / lychee (push) Canceled after 3s
notification-platform / chaos (ambiguity, restart recovery, callback burst) (push) Canceled after 0s
notification-platform / contract (Java 21, no external provider) (push) Canceled after 4s
2026-11-08 13:19:45 +00:00
DongHyeonka a2dfefb6de docs(operate): 릴리스 secret 셋을 만드는 법을 적는다
release.yml이 태그에서 이미지를 올리고 서명하려면 repo secret
PACKAGE_TOKEN·COSIGN_PRIVATE_KEY·COSIGN_PASSWORD가 필요하다. 이름만
있고 만드는 법이 없어 소유자가 첫 릴리스 전에 찾아야 했다.

operate.md 4.3절에 각 값의 출처(개인 access token의 package 범위,
cosign generate-key-pair의 cosign.key와 비밀번호)와 공개 키를 어디에
주는지 적는다.

검증: python3 scripts/check-docs.py, check-work-docs.py 통과.
2026-11-08 21:59:19 +09:00
DongHyeonka 96836a64b6 docs(ledger): 메시징 라이브러리 분리 작업의 예측과 실측을 남긴다
build-logic / included-builds (pull_request) Failing after 7s
ci-quality-gates / quality-gates (pull_request) Failing after 3s
dependency-vulnerability / dependency-review (pull_request) Skipped
dependency-vulnerability / dependency-submission (pull_request) Skipped
dependency-vulnerability / trivy-fs (pull_request) Successful in 34s
docs-check / docs (pull_request) Successful in 9s
fileserver-pr / fileserver-unit-and-architecture (pull_request) Failing after 5s
fileserver-pr / fileserver-local-ext4-contract (pull_request) Failing after 4s
fileserver-pr / fileserver-http-contract (pull_request) Failing after 4s
fileserver-pr / fileserver-security-suite (pull_request) Failing after 3s
fileserver-pr / fileserver-bounded-memory (pull_request) Failing after 5s
link-check / lychee (pull_request) Failing after 6s
notification-platform / contract (Java 21, no external provider) (pull_request) Failing after 4s
notification-platform / chaos (ambiguity, restart recovery, callback burst) (pull_request) Skipped
object-storage-qualification / minio-managed-contract (pull_request) Failing after 3s
object-storage-qualification / minio-managed-fault (pull_request) Skipped
pr-adapters / changes (pull_request) Successful in 5s
pr-adapters / web-servlet-containers (pull_request) Skipped
pr-adapters / websocket-container-matrix (pull_request) Skipped
pr-adapters / websocket-nginx-contract (pull_request) Skipped
pr-adapters / httpclient-stable-contract (apache) (pull_request) Skipped
pr-adapters / httpclient-stable-contract (jdk) (pull_request) Skipped
pr-adapters / httpclient-security-and-compatibility (pull_request) Skipped
object-storage-qualification / aws-managed-common-subset (pull_request) Skipped
ci-quality-gates / release-gate (pull_request) Failing after 1s
pr-adapters / jpa-postgresql-contract (16) (pull_request) Failing after 5s
pr-adapters / jpa-postgresql-contract (18) (pull_request) Failing after 5s
pr-adapters / jpa-migration-smoke (pull_request) Failing after 5s
착수 때 공유 노트에 쓴 예측(p30·p50·p80)과 끝날 때 세션 기록에서
뽑은 실측(작업 중 110분, 호출 346, 출력 27.2만)을 한 줄씩 더한다.
모든 값이 p30 안이었고, 틀린 이유와 다음 예측에 더할 몫을 why에 적었다.
2026-11-08 21:56:59 +09:00
DongHyeonka d46bab9659 ci!: workflow를 pr·main·release 셋으로 접고 단계 job 모양만 검사한다
pr / gradle (pull_request) Successful in 16m42s
pr / vulnerabilities (pull_request) Successful in 37s
pr / done (pull_request) Canceled after 0s
workflow 15개(+ composite action, jq 설치 스크립트)가 모듈 모양으로
나뉘어 있었고, 그것을 읽는 판독기(ShellScript·WorkflowGradleInvocations·
TaskSelectors, 운영 3,283줄과 그 시험 1,814줄)가 리뷰 라운드마다 새 셸
모양으로 결함을 냈다. 그런데 Gitea에서는 Actions가 꺼져 있어 workflow는
한 번도 돌지 않았다(design-docs repo-structure/03-ci.md 2.1·3.4절).

소유자가 정한 B안(같은 문서 7절, 11절 ①~⑧)대로 바꾼다.

- .gitea/workflows/pr.yml: `gradle` job이 `./gradlew :prCheck`와
  `./gradlew :verifyStrictLaneStages --dry-run` 두 줄, `vulnerabilities`
  (trivy), 필수 검사 하나 `done`.
- main.yml: push마다 mainCheck·integrationCheck·build-logic 시험·
  configuration cache·lychee·trivy·http3(권고). nightly·수동 실행에서
  PostgreSQL major·HTTP transport·Redis topology 행렬, NFS, 알림 chaos,
  jpa-next, compose smoke, 마지막에 `needs`로 performanceCheck.
- release.yml: releaseCheck와 기존 release lane, 이미지를 이 Gitea
  레지스트리에 올리고 cosign 키 쌍으로 서명한다. 수동 실행은 push·서명
  앞까지 돈다. upload/download-artifact를 쓰지 않는다. JPA 승격은
  `needs: jpa-release-gate`가 대신한다.
- 새 집계 `prCheck` = ci + verifyDependencyLocks + compose 렌더링 +
  저장소 배치 + 문서 검사(Exec). workflow와 verify.sh가 같은 한 줄을 쓴다.
- verifyStrictLaneStages: 그래프 검사(모든 strict lane이 선언한 단계의
  계획에 있다)는 그대로 두고, workflow 쪽은 고정 문자열 형식 검사로
  바꾼다. 단계마다 workflow·이벤트·필터·job·옵션·조건을 build.gradle에
  선언하고, 그 job의 step이 `run: ./gradlew <단계> <옵션>`을 가지며 다른
  run도 셸 문법 없는 ./gradlew 한 줄이고, 선언 밖의 if:, 조건 없는
  needs:, continue-on-error·shell:·defaults:, 따옴표 키·flow 형식, 다른
  working-directory, 선언 밖의 이벤트 필터가 없는지 본다. PR 단계 job
  하나는 이 검사 자신을 돌려야 한다. 셸 해석 코드와 그 시험을 지운다
  (build-logic 운영 코드 −3,167줄, 시험 −2,231줄). 우회 입력 21가지를
  TestKit 시험으로 둔다.
- scripts/verify.sh <단계>: 사람·세션의 진입점. 무거운 단계는 지금 작업
  트리를 패치로 desktop에 보내 잠금 아래에서 돌린다(operate.md 4.1절의
  손 절차). scripts/ci/는 workflow가 부르는 trivy·Redis topology·포트
  포워더·configuration cache 스크립트다.
- workflow를 읽는 시험(DeveloperExperienceContractTest, JpaRelease
  RenderingTest, FileserverDocumentationCoverageTest)과 입력 선언을
  .gitea로 옮기고, keyless 서명 시험을 키 쌍 서명 시험으로 바꾼다.
- 문서: gates.md·operate.md·docs/ci-cd·AGENTS.md(검증 절)·build-logic
  AGENTS.md(셸 규칙 문단을 세 줄로)·leaf 문서의 workflow 참조,
  docs/upgrade B-57~B-61.

버린 것: workflow 하나에 if:로 단계를 나누기(파일만 보고 단계를 알 수
없다), 레지스트리에서 생성(같은 정보의 셋째 사본), 바뀐 모듈만 돌리기
(결정 30과 충돌). 판독기를 남기고 고치기는 6라운드 13건이 반증했다.

위험: PR이 어댑터 컨테이너 lane과 Redis standalone lane을 더는 막지
않는다(main·nightly에서 빨갛게 된다. 소유자 결정 ②). main push는 ci를
다시 돌리지 않는다. 성능 lane은 매 push가 아니라 nightly에서만 돈다.
`.github/workflows/messaging-certification.yml`은 메시징 분리 작업이
지우므로 남겼다(.gitea가 있으면 Gitea가 읽지 않는다). 서명·push는 secret이
없어 실제 태그로는 돌려 보지 않았다.

BREAKING CHANGE: workflow 파일 위치와 이름, strictLaneStages 문법,
릴리스 레지스트리·서명 방식이 바뀌었다. docs/upgrade/2026-11-maturity-
review.md B-57~B-61을 따른다.
2026-11-08 21:55:43 +09:00
DongHyeonka b9866407ca fix(notification): 알림 문서와 NOTIF-ADR을 test의 입력으로 선언한다
NotificationReleaseGateTest(알림 leaf의 `test`)는 docs/notification의
문서와 docs/adr의 NOTIF-ADR 넷이 있는지 본다. 그 파일들이 test 태스크의
입력이 아니어서, ADR을 옮기거나 지워도 Gradle이 태스크를 up-to-date나
캐시로 끝내고 시험이 다시 돌지 않았다. 지운 notification-platform.yml의
경로 필터가 docs/adr/로 옮긴 ADR을 못 보던 것과 같은 빈틈이다.

두 경로를 test의 입력으로 선언한다. 이 시험은 `ci` → `prCheck` 안에서
경로 필터 없이 매 PR 돈다(--dry-run 계획으로 확인).

검증: desktop PR 단계.
2026-11-08 21:55:43 +09:00
DongHyeonka 61b1d57515 fix(compose): dev overlay의 heap dump를 named volume에 둔다
dev lane overlay(src/app-bootstrap/compose-lanes/dev.yaml)가 heap dump
폴더를 bind mount `./tmp/heap-dumps`로 두었다. Docker가 그 폴더를 root
소유로 만들어, compose lane을 돌린 git worktree를 일반 사용자가 지우지
못했다(`git worktree remove`가 Permission denied). 그래서 operate.md
4.1절에 컨테이너로 폴더를 지우는 우회 문장이 있었다.

named volume `heap-dumps`로 바꾼다. dump는 컨테이너가 사라져도 남고,
`docker compose cp`로 꺼낸다. 우회 문장을 지운다.

버린 것: bind mount에 사용자 uid를 맞추기(이미지·환경마다 다르다).

검증: desktop PR 단계(`verifyComposeProfiles`가 렌더링된 모델의 mount
대상 중복을 본다)와 nightly compose smoke.
2026-11-08 21:55:43 +09:00
DongHyeonka 7dc5725fe7 docs!: 메시징 문서를 messaging-library로 보내고 관련 저장소 절을 채운다
앞 커밋이 메시징 플랫폼을 지웠지만 살아 있는 문서는 아직 src/platforms
경로와 docs/messaging/을 부른다. 기록 8개의 머리 블록 「현재 정본」도
지운 docs/messaging/support-matrix.md를 가리킨다.

- docs/messaging/(10개)을 지운다. 같은 이름의 파일이 이력째
  messaging-library에 있다. 이 repo에서 그 내용을 부르던 문서(manual 09,
  messaging-kafka README·AGENTS)는 그 repo 파일로 링크한다.
- 기록(설계서 3, 계획서 3, 납품 패키지 2): 본문은 두고 머리 블록만
  고쳤다. 플랫폼을 다룬 것은 「없음 — messaging-library로 옮겼다」, 앱
  쪽 발행·소비를 다룬 것은 docs/manual/09-outbox-events.md.
- docs/work/reference/related-repos.md: 관련 저장소 표(메시징 줄 채움),
  라이브러리를 고치는 법, 템플릿에서 버전 올리는 법, 같이 고칠 때
  composite build(Gradle 루트가 src/라 ../../messaging-library), registry
  라이브러리 칸. 설계 14절이 근거다.
- src/config/architecture/README.md: library_groups·allowed_libraries 설명.
- docs/upgrade/2026-11-maturity-review.md 3.9절: B-57(지운 것), B-58(받는
  법·패키지·auto-config 이름), B-59(registry 칸).
- 진입 문서와 지역 지침(AGENTS.md, README.md, delegate, decisions,
  review-criteria, defect-patterns, gates, capability-status, manual 07,
  build-logic·persistence-jpa·inbound messaging·shared-contract 지침,
  env-keys 주석)에서 「들여온 제품」·src/platforms 문장을 별도 repo
  라이브러리 문장으로 바꿨다.

위험: 다른 repo 파일을 가리키는 링크는 lychee가 외부 URL로 본다(공개
repo라 익명으로 읽힌다).

검증: python3 scripts/check-docs.py OK, check-work-docs.py OK(상대 링크
깨짐 0), check-repo-layout.py OK, python3 -m unittest discover -s
scripts/tests OK.

BREAKING CHANGE: docs/messaging/이 없어졌다. 메시징 문서는
messaging-library repo의 docs/messaging/에 있다.

Refs: design-docs repo-structure/05-library-repos.md 4.3·14절
2026-11-08 17:11:33 +09:00
DongHyeonka 5af9415587 refactor(platforms)!: 메시징 플랫폼을 messaging-library 1.0.0으로 받고 지운다
템플릿 안에 프로젝트 계층이 아닌 메시징 플랫폼(src/platforms/messaging,
19개 모듈)이 있다. 소유자 결정(2026-11-07)은 라이브러리를 별도 repo에서
관리하고 템플릿은 버전으로 받는 것이다. 라이브러리는 이력째
messaging-library로 옮겨 dev.cakit.messaging 1.0.0으로 Gitea Packages에
게시했다(태그 v1.0.0 = 8c6045e, release run 28).

- 받는 법: src/settings.gradle에 exclusiveContent 저장소(group dev.cakit와
  그 아래는 Gitea에서만, 나머지는 Maven Central에서만). 카탈로그
  messagingLibrary = "1.0.0"과 쓰는 모듈 여섯.
- 쓰는 leaf: adapter:outbound:messaging, adapter:outbound:messaging-kafka,
  adapter:inbound:messaging(admin exclude 좌표를 새 group으로), 시험만
  composition:outbox-relay와 app-bootstrap architectureTest. import와
  auto-configuration 이름 문자열 dev.caskeleton.messaging →
  dev.cakit.messaging, 시험 stand-in도 같은 FQCN으로.
- persistence-jpa migration 시험이 라이브러리 소스 폴더를 경로
  (../../../platforms/…)로 읽던 것을, 카탈로그 버전의 jar를 전용 구성
  messagingMigrations(non-transitive)로 받아 db/migration을 풀어 읽게
  했다. classpath에 올리면 그 leaf 시험의 Flyway가 메시징 migration까지
  볼 수 있어 버렸다.
- registry: 메시징 19행을 지우고 library_groups ["dev.cakit"]와 쓰는 세
  행의 allowed_libraries. 분리 전 프로젝트 edge 검사가 지키던 약속이
  앞 커밋의 라이브러리 edge 검사로 그대로 남는다.
- 계약 테스트: MessagingPublicSurfaceContractTest는 라이브러리로 옮겼고,
  MessagingAuthorityContractTest는 이 repo의 app.messaging 주인 하나만
  본다(라이브러리 쪽 하나는 그 repo가 본다).
- system caller 규칙(ApplicationBoundaryArchitectureTest)의 「프로젝트
  타입」에 dev.cakit.을 더했다. 메시지 handler가 구현하는 MessageHandler가
  라이브러리 타입이 되면서, 그대로 두면 manual 09의 handler가
  SYSTEM_CALLERS_HAVE_ONLY_PROJECT_SUPERTYPES에 걸리고 MessageHandler로
  주입받는 endpoint를 USER_TRANSPORTS_DO_NOT_REACH_SYSTEM_CALLERS가
  따라가지 못한다(구조 리뷰가 찾음).
- 순서 시험: 이름 정렬로도 라이브러리 root가 먼저 오게 되어 bridge 시험이
  afterName을 지키지 못했다. stand-in을 맨 뒤 순서로 두고, inbox 쪽
  beforeName을 지키는 시험을 더했다.
- 지움: src/platforms(와 빈 폴더), messaging-certification.yml, 카탈로그의
  avro·cloudevents·protobuf 4.33.2, SpotBugs 제외의 메시징 줄,
  check-repo-layout.py의 platforms. 편집 훅이 계층 leaf의 dev.cakit import를
  알린다.
- lockfile: 바뀐 줄은 dev.cakit.messaging 좌표 추가 45줄뿐이다(외부
  의존성 집합은 그대로, 설계 16절 H6).

버린 대안: 라이브러리 jar를 persistence-jpa testRuntimeOnly로 올려
classpath에서 읽기(위 이유). 템플릿에 docs/messaging 사본을 남기기
(라이브러리 문서와 갈라진다. 다음 커밋이 문서를 그 repo로 가리킨다).

위험: 캐시가 빈 빌드(새 기계, 이미지 builder)는 git.learn.hyeonworks.com에
닿아야 한다. 공개 owner라 토큰은 필요 없다(익명 200 확인). 이 커밋만으로는
살아 있는 문서가 지운 경로를 부른다(check-docs는 다음 커밋에서 통과).

검증: desktop에서 이 트리로 RED·GREEN(system caller 고정 시험 2건, 순서
시험 2건은 수정 전·제약 제거 시 실패, 수정 후 통과). 전체 게이트는
PR 본문.

BREAKING CHANGE: src/platforms/messaging과 project(':messaging:…') 경로가
없어졌다. dev.cakit.messaging:<모듈>:1.0.0 좌표로 받고 import를
dev.caskeleton.messaging → dev.cakit.messaging으로 바꾼다
(docs/upgrade/2026-11-maturity-review.md B-57~B-59).

Refs: design-docs repo-structure/05-library-repos.md 4·8·10·13절
2026-11-08 17:11:20 +09:00
DongHyeonka 77b81811c2 feat(build-logic): registry가 별도 repo 라이브러리 edge를 막게 한다
방향 검사(verifyModuleDependencyDirection)는 프로젝트 edge만 센다.
라이브러리가 별도 repo로 나가 외부 좌표가 되면, 지금 registry가
지키는 약속(메시징 bridge는 core-api만 본다, Kafka capability는
starter-kafka를 runtimeOnly로만 싣는다, 계층 leaf는 메시징을 모른다)을
아무것도 검사하지 않게 된다.

registry에 칸 둘을 더한다(설계 10.2절 T2, 소유자 승인 Q11).

- 맨 위 선택 칸 library_groups: 다스릴 Maven group 접두사.
- 행마다 선택 칸 allowed_libraries: group:artifact 목록. 꼴이 틀리거나,
  library_groups 밖 group이거나, 겹치면 registry를 읽을 때 거절한다.
  계층 leaf(domain-core, shared-contract, application-*) 행이 칸을
  채우면 registry 위반이다. purity 검사가 비프로젝트 선언을 막는 것과
  따로 registry 자체가 막는다.
- 방향 검사는 프로젝트 edge와 같은 방식으로 본다: 운영 선언
  (api·implementation·compileOnly·runtimeOnly)의 소유 group 좌표와,
  compileClasspath에서 보이는 소유 group 모듈(라이브러리 모듈이 api로
  내보낸 것 포함)이 모두 칸에 있어야 한다. --include-build로 끼운
  라이브러리 프로젝트는 프로젝트 edge가 아니라 그 좌표로 본다. 그래야
  같이 고치는 흐름(composite build)에서도 같은 판정이 나온다. 「자기
  빌드」는 ":"로 짐작하지 않고 해석 root의 build path로 읽는다(이 빌드가
  다른 빌드에 끼워 돌아도 검사가 꺼지지 않게).

버린 대안: app-bootstrap ArchUnit 패키지 규칙(T1). import만 보고
runtimeOnly로 싣는 starter를 못 본다. 「어떤 모듈을 싣는가」는 빌드
사실이라 빌드 검사가 맞다.

위험: 시험 구성(testImplementation 등)은 프로젝트 edge처럼 보지 않는다.
이 빌드 자체를 다른 빌드에 끼우는 경우는 시험이 없다.

검증: desktop ./gradlew -p build-logic test rc=0. 새 시험: ModuleRegistryTest
4, CleanArchitectureResolvedClasspathFunctionalTest 7. functional 시험은
구현 전 RED였다(runtimeOnly·compile-visible 두 건은 게이트가 통과해
버렸고, --include-build 건은 「forbidden project dependencies
[demo-included]」로 실패).

Refs: design-docs repo-structure/05-library-repos.md 10.2절
2026-11-08 17:10:50 +09:00
DongHyeonka de070e16a7 ci: 다른 단계가 이미 돌리는 workflow job을 지운다
workflow 15개 가운데 모듈 모양 파일들이 PR·main·nightly 단계가 이미
계획하는 Gradle 태스크를 한 번 더 돌린다(설계 design-docs
repo-structure/03-ci.md 3.1절 「중복」).

- fileserver-pr.yml 다섯 job: 모두 leaf `test`나 그 부분집합이다.
  `ci`가 매 PR 돌린다.
- fileserver-nightly.yml의 --rerun-tasks job 셋: 같은 `test`의
  부분집합이다. NFS job만 남긴다.
- jpa-nightly.yml의 failure·query plan·security·pool job: 모두
  integration()·performance() lane이라 :integrationCheck·
  :performanceCheck가 돈다. PostgreSQL major 행렬만 남긴다.
- notification-platform.yml의 pr job: `ci`와 :integrationCheck의
  태스크다. 경로 필터가 docs/adr/로 옮긴 알림 ADR을 보지 못했다.
  chaos job만 남긴다.
- object-storage-qualification.yml의 MinIO job 둘: integration lane이다.
  보호된 AWS job만 남긴다.
- link-check.yml: 문서 검사라 main 단계로(소유자 결정 2026-09-16).
  integration-main.yml의 links job으로 옮긴다.

fileserver 지원 매트릭스는 지운 job id 대신 그 증거를 실제로 만드는
테스트 클래스·모듈 test·남은 job을 적고, FileserverDocumentation
CoverageTest가 행마다 그 이름이 있는지 본다. job이 사라진 시험 문장
(PoolLaneClaimTest의 nightly job 검사, lychee 경로 필터 검사)은
지우거나 새 위치로 맞춘다.

위험: PR에서 경로로 켜지던 컨테이너 lane(notification의 실 PostgreSQL
두 lane, MinIO)은 이제 main push와 nightly에서만 돈다. 어댑터 컨테이너
lane을 main 단계로 옮긴 소유자 결정(2026-11-07 ②)과 같은 쪽이다.

검증: 기준 2959eff0의 desktop worktree에서 workflow의 Gradle 명령 50개를
--dry-run해 태스크 집합을 만들었다. 지운·옮긴 job 27개의 태스크는 모두
:ci·:mainCheck·:integrationCheck·:performanceCheck·:releaseCheck 계획
안에 있다(단계 집계 밖 0). 로그 desktop ~/t2a-backend-ci-logs/wave1-base/.
python3 scripts/check-docs.py, check-work-docs.py 통과.

Refs: design-docs repo-structure/03-ci.md 7.3절 Wave 1
2026-11-08 17:00:49 +09:00
donghyeon.kang 2959eff076 Merge pull request 'refactor(platforms)!: gRPC 플랫폼을 별도 repo grpc-library로 옮기고 지운다' (#6) from claude/x2-grpc-library-43dd09 into main 2026-11-08 06:54:14 +00:00
DongHyeonka a2dbf33b75 docs: grpc-library의 Maven group·패키지 이름을 dev.cakit.grpc로 맞춘다
grpc-library가 이름을 com.hyeonworks.grpc에서 dev.cakit.grpc로 바꾼다
(grpc-library PR #2, 소유자 2026-11-08: 개인 도메인 이름을 공용
라이브러리에 쓰지 않는다). 이 브랜치 문서는 옛 이름을 적고 있었다.

- README 재사용 체크리스트 6번: 라이브러리 패키지 dev.cakit.*은 바꾸지
  않는다. 2번이 바꾸는 dev.caskeleton과 겹치지 않게 정한 이름이라고 적었다
- related-repos.md(group 두 칸과 받는 법), capability-status, 업그레이드
  안내 B-55, 카탈로그 주석

남긴 것: Gitea 서버 주소, 기록(ADR-GRPC-002, 리뷰·history 본문)의 옛
proto 조직 이름 hyeonworks.

검증: check-docs.py OK, check-work-docs.py OK, --links broken 0.
2026-11-08 14:09:47 +09:00
DongHyeonka e1dd8e745f docs(ledger): gRPC 라이브러리 분리 작업의 예측과 실측을 남긴다
착수할 때(10:50) 공유 노트에 쓴 예측과 끝의 실측 두 줄이다. 모든 값이
p30 안이었고, 틀린 이유(desktop 대기를 작업 중 시간에 넣음)는 실측 줄
`why`에 적었다.
2026-11-08 14:02:09 +09:00
DongHyeonka 57988c2e48 fix(build-logic): registry 행의 build 칸을 거절하고 남은 두 빌드 문장을 고친다
구조 리뷰(arch-reviewer, 이 브랜치)가 찾은 권고 다섯을 고친다.

1. ModuleRegistry가 행의 `build` 칸을 아직 읽었다. 두 번째 빌드가 없어진
   뒤로 main이 아닌 값(오타 포함)을 적은 leaf는 settings가 include하지
   않고, 방향 검사도, 등록 안 된 build 스크립트 검사도 보지 않는데 ci는
   초록으로 남는다(08-05가 막으려던 모양). 칸이 있으면(빈 값 포함) read에서
   그 id와 'build'를 이름 대고 실패한다.
2. gates.md·defect-patterns.md의 「두 빌드의 verifyStrictLaneStages」.
3. shared-contract AGENTS.md의 「optional gRPC 빌드는 자기 사본을 둔다」를
   별도 repo 라이브러리로.
4. QualityConventionsPlugin 주석의 현재형 「optional-platforms 빌드가 같은
   제외 파일을 읽는다」를 이력으로.
5. StrictLaneStagesExtension 주석의 optional-build 경로에 그 빌드가 옮겨
   갔다는 말을 붙였다.

버린 대안: `build` 칸과 modulesForBuild를 통째로 지우기. settings 설치기와
ArchitecturePlugin의 시그니처까지 바뀌고, 막는 효과는 같다.

검증(desktop ~/x2-template-wt, --no-build-cache):
- RED: 새 시험 aBuildFieldIsRejected… 고치기 전 실패(9 tests, 1 failed)
- GREEN: ModuleRegistryTest 통과. 옛 blankBuildOwnershipIsRefused는 새
  문구로 바꿨다(빈 값도 같은 이유로 거절)
- -p build-logic check javadoc rc=0(172 tests), :ci :verifyDependencyLocks
  rc=0(7389 tests, 실패 0), verifyStrictLaneStages --dry-run, check-docs,
  check-work-docs(--links 포함), check-repo-layout 모두 rc=0
2026-11-08 13:49:48 +09:00
DongHyeonka 91804ec182 fix(docs): 옮긴 gRPC 기록은 템플릿에 남기고 머리 블록만 고친다
앞 커밋이 ADR-GRPC 7개와 gRPC 설계서를 살아 있는 문서와 함께 지웠다.
그러자 기록 docs/history/plans/2026-08-30-grpc-platform-implementation.md의
상대 링크가 깨졌다(desktop: check-work-docs --links broken 1, lychee
Error 1). 기록 본문은 고치지 않는다는 규칙이라 링크를 고칠 수 없다.
기록은 그때 템플릿 안 코드를 두고 한 결정·설계이므로 템플릿에도 남는
것이 맞다(설계 Q15 「리뷰 기록은 템플릿에 남김」과 같은 이유).

- ADR-GRPC 7개와 설계서를 22df3525에서 되살리고, 머리 블록 「현재 정본」을
  「없음 — grpc-library로 옮겼다」로 바꿨다. 사본은 grpc-library에도 있다.
- 업그레이드 안내 B-55의 지운 목록에서 그 기록들을 뺐다.
- persistence-jpa testkit 주석 둘을 Spotless 줄바꿈대로 다시 쌌다
  (desktop ci의 spotlessJavaCheck 실패).

검증(로컬, 문서만): check-docs.py rc=0, check-work-docs.py --links
broken 0. Gradle 게이트는 desktop에서 다시 돈다.
2026-11-08 13:05:03 +09:00
DongHyeonka 2921f596a5 feat(harness): 하네스 플러그인 harness@claude-harness를 켠다
공통 훅·스킬(되돌릴 수 없는 명령 차단 H12, 비밀 값 알림, 예측·실측
장부 기록, estimate·retro·techdebt)은 claude-harness repo의 플러그인이
준다. 이 repo는 그 플러그인을 켜지 않아 새 세션이 그것들을 받지 못했다.

.claude/settings.json에 extraKnownMarketplaces(claude-harness, git URL)와
enabledPlugins를 더했다. 기존 deny와 repo 훅은 그대로다. 사용자 전역에
같은 H12가 등록돼 있으면 플러그인 H12는 스스로 아무것도 하지 않는다
(소유자 기계가 그렇다). 비대화형(claude -p)은 플러그인을 자동 설치하지
않으므로 CLAUDE.md와 docs/upgrade/2026-11-harness.md 9번에 수동 설치 두
명령을 적었다.

위험: 이 세션은 ~/.claude를 바꾸지 않으므로 플러그인 설치 자체는 하지
않았다. 대화형 앱이 처음 열 때 설치를 묻는지는 확인하지 않았다(claude-
harness README도 같은 미확인).

검증: settings.json JSON 파싱, check-work-docs.py rc=0(CLAUDE.md 10/10줄).
2026-11-08 11:29:55 +09:00
DongHyeonka 5e204e6a43 refactor(platforms)!: gRPC 플랫폼을 별도 repo grpc-library로 옮기고 지운다
템플릿 repo 안에 프로젝트 계층이 아닌 라이브러리가 있었다. gRPC 플랫폼
(src/platforms/grpc, grpc-advanced)과 그것만을 위한 두 번째 Gradle 빌드
(src/platforms/optional-build)는 템플릿 어느 leaf도 쓰지 않는데,
registry 9행, workflow job 넷과 단계 하나, build-logic 플러그인 둘,
카탈로그·SpotBugs 항목, 문서 열두 개를 템플릿이 함께 지고 있었다.

소유자 결정(2026-11-07, design-docs repo-structure/README.md 3.5절,
05-library-repos.md Q1~Q17 승인)대로 라이브러리마다 별도 repo로 옮긴다.
gRPC는 템플릿 소비자가 없어 먼저 옮기고, 템플릿은 지우기만 한다(Q13).
코드와 이력은 grpc-library repo에 filter-repo로 옮겼다(옮긴 폴더의 트리
해시가 이 기준 커밋 22df3525와 같다).

지운 것:
- src/platforms/grpc, grpc-advanced, optional-build(343파일)
- registry의 "build": "optional-grpc" 9행
- ci-quality-gates.yml job optional-platforms·grpc-proto-buf와 그 needs,
  integration-main.yml optional 성능 단계와 job
  grpc-optional-platform-integration, release.yml job
  grpc-stable-release-gate와 이미지 job의 needs 한 줄
- build-logic ca.grpc-platform-module·ca.optional-architecture-registry,
  MainBuild(두 번째 빌드에서 주 빌드를 찾던 것)와 ArchitecturePlugin의
  optional 분기. 도구 설정·이미지 목록·registry는 Gradle 루트에서 찾는다
- 카탈로그 protobufPlugin·protobuf-java-grpc·protoc·plugin protobuf(Q14:
  채택 전이라 grpc-library 좌표도 넣지 않는다), SpotBugs 제외의 gRPC 줄
- 옮긴 문서: ADR-GRPC 7개, docs/compatibility/(폴더째), gRPC runbook 둘,
  gRPC 설계서. 리뷰·기록 본문은 고치지 않았다(Q15). 기록 하나의 머리
  블록 「현재 정본」만 새 자리를 말하게 했다
- DeveloperExperienceContractTest의 optional 빌드 lane 계약 시험,
  adopter API 표면 검사의 optional-build 제외 경로

남긴 것: adapter:inbound:grpc(io.grpc를 직접 쓰고 플랫폼을 쓰지 않는다),
src/platforms/messaging(다음 분리 작업), registry의 build 칸 지원
(ModuleRegistry, 일반 기능).

살아 있는 문서: README, docs 지도, capability-status, work/delegate·
gates·decisions(새 행 「라이브러리 repo」)·defect-patterns·
review-criteria(경계 밖 파일을 경로로 읽는 결합을 결함 후보로),
manual 04, jpa migration-guide, build-logic AGENTS·README, testkit 주석.
새 docs/work/reference/related-repos.md가 라이브러리 repo 목록과 같이
고치는 법을 둔다. 파생 서비스 안내는 docs/upgrade 3.8절 B-55·B-56.

위험: 파생 서비스가 이 경로를 고쳤으면 수정 대 삭제 충돌이 난다
(tech-log-backend는 플랫폼을 받은 적이 없다, 설계 12절). 분리 직전
커밋 태그 pre-library-split(설계 12.2절)은 이 브랜치 권한 밖이라 달지
않았다.

검증: desktop 게이트 결과는 PR 본문(ci, mainCheck 계열, releaseCheck,
compose smoke, 빠른 시작). 문서 검사 셋 rc=0.

BREAKING CHANGE: src/platforms/grpc*·optional-build, :grpc:*·:grpc-advanced:*
프로젝트, ca.grpc-platform-module, 카탈로그 protoc·protobuf-java-grpc·plugin
protobuf가 없다. 쓰던 서비스는 grpc-library 좌표 com.hyeonworks.grpc로
받는다(docs/upgrade/2026-11-maturity-review.md 3.8절).
Refs: design-docs repo-structure/05-library-repos.md 13.1절 1·2단계
2026-11-08 11:29:47 +09:00