From 66a7190a838feee7f9b854f3030171e144de273b Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 13 Nov 2026 05:05:46 +0900 Subject: [PATCH 1/5] =?UTF-8?q?docs(build):=20mainCheck=C2=B7bootstrap=20?= =?UTF-8?q?=EC=84=A4=EB=AA=85=EC=9D=84=20=EC=A7=80=EA=B8=88=20=ED=83=9C?= =?UTF-8?q?=EC=8A=A4=ED=81=AC=EC=99=80=20=EA=B8=B0=EB=B3=B8=20=EC=A1=B0?= =?UTF-8?q?=EB=A6=BD=EC=97=90=20=EB=A7=9E=EC=B6=98=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `mainCheck`는 `:adapter:inbound:graphql:graphqlStableTest`에 기댄다 (build.gradle `mainCheck` 태스크). 그런데 루트 build.gradle Lifecycle 주석과 gates.md 1절 `mainCheck` 행에는 이 lane이 없다. docs/build.md 표는 gates.md 1절을 정본으로 가리키므로 정본이 빠진 셈이다. build.gradle의 bootstrap 주석은 단계를 「migrate-and-start」로 적는다. 기본 조립은 web뿐이고 persistence-jpa 줄이 꺼져 있어 startup Flyway가 돌지 않는다. 「start」로 고치고, Flyway는 persistence-jpa 줄을 켰을 때만 돈다고 적는다. 동작 변경 없음: build.gradle은 주석만 바꿨다. 검증: scripts/verify.sh docs(노트북) rc=0. Refs: round9 확인 리뷰(r9-be 그룹 C가 넘긴 Low 둘) --- build.gradle | 8 +++++--- docs/work/reference/gates.md | 2 +- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/build.gradle b/build.gradle index e892f1de..c9cfd47e 100644 --- a/build.gradle +++ b/build.gradle @@ -57,7 +57,8 @@ tasks.register('verifyDependencyLocks') { } // feature-developer-experience-contract D3 — the ordered local bootstrap lifecycle is -// scripts/bootstrap-local.sh (compile, Docker preflight, dependency wait, migrate-and-start, smoke). +// scripts/bootstrap-local.sh (compile, Docker preflight, dependency wait, start, smoke). Startup +// Flyway runs only when the persistence-jpa runtimeOnly line is on; the default composition is web. // --------------------------------------------------------------------------------------------- // Lifecycle. @@ -70,8 +71,9 @@ tasks.register('verifyDependencyLocks') { // prCheck the pull-request stage: ci + dependency locks + the Compose render, the // repository layout and the document checks (scripts outside Gradle) // mainCheck the main-branch stage: environment contract, full-boot qualification, -// public-path baseline, transport and messaging qualification lanes, each -// leaf's document-contract lanes, and the feature generator round trip +// public-path baseline, transport and messaging qualification lanes, the +// GraphQL transport-boundary lane (graphqlStableTest), each leaf's +// document-contract lanes, and the feature generator round trip // (verifyFeatureScaffold) // integrationCheck the declared strict integration lanes (several need a container runtime) // performanceCheck the declared strict performance lanes (load, shutdown, pool and resource diff --git a/docs/work/reference/gates.md b/docs/work/reference/gates.md index 8bc7c673..2c0b5809 100644 --- a/docs/work/reference/gates.md +++ b/docs/work/reference/gates.md @@ -40,7 +40,7 @@ workflow에만 있는 job: `pr.yml` `done`의 마지막 step과 `main.yml`의 `v | `python3 scripts/check-repo-layout.py` | 저장소 루트와 `src/` 최상위에 허용 목록 밖의 항목이 없는가, registry 경로가 허용 폴더 안인가. 아무도 가리키지 않는 compose·스크립트 파일은 경고 | PR(`prCheck` 안) | `verifyRepositoryLayout` | | `python3 scripts/check-work-docs.py` | 작업 지침(루트 `AGENTS.md`·`CLAUDE.md`, `docs/work/`, `src/**/AGENTS.md`, `.claude/`)의 분량 상한, 본문 이력 ID 0, playbook 뼈대, 상대 링크 | PR(`prCheck` 안) | `verifyWorkDocs` | | `python3 scripts/check-docs.py` | 살아 있는 문서의 언어, 기록·ADR 머리 블록, 문서의 인라인 코드 경로·Gradle 경로가 지금 있는가, 복사한 숫자, 상대 링크(`docs/README.md` 「문서 검사」) | PR(`prCheck` 안) | `documentCheck` | -| `mainCheck` | `configContractCheck` + `qualificationCheck`(`testQualityCheck` 포함) + 공개 경로 스냅숏 + 전송·메시징 qualification lane + 생성 명령 왕복(`verifyFeatureScaffold`) + 모든 leaf의 `mainCheck`(document-contract lane 등) | main | `main.yml` `main`: `./gradlew :integrationCheck :mainCheck --continue` | +| `mainCheck` | `configContractCheck` + `qualificationCheck`(`testQualityCheck` 포함) + 공개 경로 스냅숏 + 전송·메시징 qualification lane + GraphQL 전송 경계 lane(`graphqlStableTest`) + 생성 명령 왕복(`verifyFeatureScaffold`) + 모든 leaf의 `mainCheck`(document-contract lane 등) | main | `main.yml` `main`: `./gradlew :integrationCheck :mainCheck --continue` | | `integrationCheck` | 선언된 strict integration lane 전체(실 컨테이너). 입력이 없는 lane은 빼고 이름을 댄다 | main·nightly | `main.yml` `main`: `./gradlew :integrationCheck :mainCheck --continue`(두 단계를 Gradle 한 번에. 한 번 컴파일하고, 직렬 lane이 도는 동안 나머지가 겹친다. integration이 앞이라 lane이 첫 몇 분부터 슬롯을 쓴다) | | `performanceCheck` | 선언된 performance lane 전체(부하·종료·풀·자원 한계, 실 서버와 컨테이너). 상한을 매번 단언한다. 손으로 돌리든 workflow든 같은 상한이다 | nightly(다른 무거운 job 뒤: 파일 맨 끝 job이고 runner 하나가 job을 만든 순서대로 돈다. `needs`는 쓰지 않는다 — Gitea 1.27이 `needs`와 `if`를 함께 가진 job을 Blocked에 둔다) | `main.yml` `performance`. 5절 | | `releaseCheck` | 릴리스 provenance + 공개 경로 스냅숏. 커밋을 `GITHUB_SHA`·`GIT_SHA`·`-PgitRevision=`로 받고, 없으면 설계대로 실패한다 | 태그 | `release.yml` `release` | From d30843407f2f2b30a01fa998f83f2e739c0754ce Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 13 Nov 2026 06:37:43 +0900 Subject: [PATCH 2/5] =?UTF-8?q?docs(build-logic):=20=EC=A0=80=EC=9E=A5?= =?UTF-8?q?=EC=86=8C=20=EB=A3=A8=ED=8A=B8=EB=A5=BC=20=EB=88=84=EA=B0=80=20?= =?UTF-8?q?=EC=96=B4=EB=8A=90=20=EB=A0=88=EC=9D=B8=EC=97=90=20=EC=A3=BC?= =?UTF-8?q?=EB=8A=94=EC=A7=80=20=EB=B0=94=EB=A1=9C=20=EC=A0=81=EB=8A=94?= =?UTF-8?q?=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit build-logic/AGENTS.md는 「저장소 루트(`ca.repository.root`)는 이 두 레인에만 준다」고 적는다. 실제로 루트를 주는 것은 build-logic convention이 아니라 leaf `build.gradle`의 레인 선언(`systemProperty`)이다. 지금은 app-bootstrap의 `documentContractTest`·`repositoryContractTest` 둘이지만, 다른 leaf의 document-contract 레인도 같은 방식으로 받을 수 있다. 그러면 「두 레인」은 틀린 말이 된다. 태그 두 개로 범위를 적고, 주는 쪽이 그 leaf의 `build.gradle`이라고 적는다. 검증: scripts/verify.sh docs(노트북) rc=0. 이 문장을 읽는 시험은 없다 (git grep 'build-logic/AGENTS.md' -- '*.java': 0건). Refs: round9 리뷰 기록 5절 10번(r9-be 그룹 C) --- build-logic/AGENTS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/build-logic/AGENTS.md b/build-logic/AGENTS.md index 22483be7..3600cfc1 100644 --- a/build-logic/AGENTS.md +++ b/build-logic/AGENTS.md @@ -14,7 +14,7 @@ registry, settings, build-logic, 루트 라이프사이클이 정하는 것을 - 테스트가 저장소 파일을 읽으면 그 파일을 그 leaf의 test task `inputs`로 선언한다. - 저장소 문서와 대조하는 테스트는 `mainStage()` 레인(`document-contract` 태그)으로 leaf `mainCheck`에서 돈다. - 문서가 아닌 저장소 파일(빌드 스크립트, workflow, Compose, 다른 leaf 소스)을 읽어야 merge 전에 막을 수 있는 계약은 그 파일만 입력으로 둔 별도 레인(app-bootstrap `repository-contract`)에 둔다. -- 저장소 루트(`ca.repository.root`)는 이 두 레인에만 준다. 그래서 태그 없이 저장소를 읽는 테스트는 `test`에서 실패한다. +- 저장소 루트(`ca.repository.root`)는 `document-contract`·`repository-contract` 태그 레인에만, 그 leaf의 `build.gradle`이 레인 선언의 `systemProperty`로 준다. convention은 주지 않는다. 그래서 태그 없이 저장소를 읽는 테스트는 `test`에서 실패한다. - 문서를 파싱해 대조하는 Gradle 검사는 두지 않는다. 문서 검사는 Gradle 밖 `scripts/check-docs.py`·`scripts/check-work-docs.py`다. ## lane 캐시와 성능 lane From 3b71a3ca32e558ddad3c0a0081ee66b05c37ed54 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 13 Nov 2026 08:32:49 +0900 Subject: [PATCH 3/5] =?UTF-8?q?docs(security):=20=EA=B3=B5=EA=B0=9C=20?= =?UTF-8?q?=EA=B2=BD=EB=A1=9C=20=EC=8A=A4=EB=83=85=EC=88=8F=20=EA=B2=80?= =?UTF-8?q?=EC=82=AC=EC=9D=98=20=EC=84=A4=EB=AA=85=EC=9D=84=20=EB=84=93?= =?UTF-8?q?=EC=96=B4=EC=A7=84=20=EB=B2=94=EC=9C=84=EC=97=90=20=EB=A7=9E?= =?UTF-8?q?=EC=B6=98=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 공개 경로 스냅숏은 이제 기본 공개 경로만이 아니라 profile 덮어쓰기와 운영 코드 filter chain의 `permitAll`·`securityMatcher` 문장까지 고정한다 (`docs/security/public-paths-snapshot.txt`). 그런데 그 검사를 설명하는 세 곳은 아직 「기본 공개 경로」만 본다고 적는다. - gates.md 2절 `verifyPublicPathSnapshot` 행 - 루트 build.gradle `verifyPublicPathSnapshot` 태스크 description - app-bootstrap build.gradle `publicPathSnapshotTest` 레인 description 세 곳 모두 지금 범위(기본값, profile 덮어쓰기, filter chain 문장)로 고친다. 동작 변경 없음. 검증: scripts/verify.sh docs(노트북) rc=0. 이 문구를 고정하는 시험은 없다 (git grep 'shipped public path default' -- '*.java': 0건). Refs: round9 확인 리뷰(r9-be가 넘긴 Low, 공개 경로 범위 확장 뒤) --- build.gradle | 2 +- docs/work/reference/gates.md | 2 +- src/bootstrap/app/build.gradle | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/build.gradle b/build.gradle index c9cfd47e..4c5ba61a 100644 --- a/build.gradle +++ b/build.gradle @@ -275,7 +275,7 @@ strictLaneStages { // `-PapprovePublicPathChange` rewrites the baseline after review. tasks.register('verifyPublicPathSnapshot') { group = 'verification' - description = 'Fails when the shipped public path default drifts from docs/security/public-paths-snapshot.txt.' + description = 'Fails when the public path surface (default, profile overrides, filter-chain permitAll and securityMatcher statements) drifts from docs/security/public-paths-snapshot.txt.' dependsOn ':app-bootstrap:publicPathSnapshotTest' } diff --git a/docs/work/reference/gates.md b/docs/work/reference/gates.md index 2c0b5809..f6757859 100644 --- a/docs/work/reference/gates.md +++ b/docs/work/reference/gates.md @@ -45,7 +45,7 @@ workflow에만 있는 job: `pr.yml` `done`의 마지막 step과 `main.yml`의 `v | `performanceCheck` | 선언된 performance lane 전체(부하·종료·풀·자원 한계, 실 서버와 컨테이너). 상한을 매번 단언한다. 손으로 돌리든 workflow든 같은 상한이다 | nightly(다른 무거운 job 뒤: 파일 맨 끝 job이고 runner 하나가 job을 만든 순서대로 돈다. `needs`는 쓰지 않는다 — Gitea 1.27이 `needs`와 `if`를 함께 가진 job을 Blocked에 둔다) | `main.yml` `performance`. 5절 | | `releaseCheck` | 릴리스 provenance + 공개 경로 스냅숏. 커밋을 `GITHUB_SHA`·`GIT_SHA`·`-PgitRevision=`로 받고, 없으면 설계대로 실패한다 | 태그 | `release.yml` `release` | | `:app-bootstrap:verifyEnvKeys` | env 키 레지스트리와 profile YAML·`.env.example` | `mainCheck` 안(`configContractCheck`) | build-logic `ca.config-contract` | -| `verifyPublicPathSnapshot` | 기본 공개 경로가 `docs/security/public-paths-snapshot.txt`와 같은가 | `mainCheck`·`releaseCheck` 안 | `build.gradle` | +| `verifyPublicPathSnapshot` | 공개 경로 표면(기본값, profile 덮어쓰기, 운영 코드 filter chain의 `permitAll`·`securityMatcher` 문장)이 `docs/security/public-paths-snapshot.txt`와 같은가 | `mainCheck`·`releaseCheck` 안 | `build.gradle` | | `verifyDependencyLocks` | lockfile | PR(`prCheck` 안) | `build.gradle` | | `:app-bootstrap:documentContractTest` | 문서와 코드를 대조하는 lane(태그 `document-contract`) | main(`mainCheck` 안) | `src/bootstrap/app/build.gradle` | | `:app-bootstrap:repositoryContractTest` | 빌드 스크립트·workflow·compose를 읽는 계약(태그 `repository-contract`) | PR | `src/bootstrap/app/build.gradle` | diff --git a/src/bootstrap/app/build.gradle b/src/bootstrap/app/build.gradle index 4dd98ec8..3a451cea 100644 --- a/src/bootstrap/app/build.gradle +++ b/src/bootstrap/app/build.gradle @@ -452,7 +452,7 @@ springBoot { strictTestLanes { lane('publicPathSnapshotTest') { tag = 'public-path-snapshot' - description = 'Compares the shipped public path default with the reviewed baseline.' + description = 'Compares the public path surface (default, profile overrides, filter-chain permit statements) with the reviewed baseline.' rejectSkipped = true mainStage() systemProperty 'publicpath.snapshot.write', project.hasProperty('approvePublicPathChange') ? 'true' : 'false' From 5feb06982d5e52b0d75842d766a1a33d335b2c83 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 13 Nov 2026 08:32:49 +0900 Subject: [PATCH 4/5] =?UTF-8?q?ci(release):=20needs=EA=B0=80=20=EC=9E=88?= =?UTF-8?q?=EB=8A=94=20job=EC=9D=B4=20runner=20=EB=8C=80=EA=B8=B0=EC=97=B4?= =?UTF-8?q?=20=EB=92=A4=EB=A1=9C=20=EA=B0=80=EB=8A=94=20=EB=B9=84=EC=9A=A9?= =?UTF-8?q?=EC=9D=84=20=EC=A0=81=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 수동 release run 157에서 `app-image-release`는 gate가 끝나고 3시간 뒤에, `app-image-signing`은 이미지 job이 끝나고 2시간 뒤에 시작했다. runner label(`ubuntu-latest`)은 다른 job과 같고 environment도 없다. 원인은 `needs`다. Gitea는 runner에 실행할 수 있게 된 지 가장 오래된 job을 준다. 그 runner가 받는 모든 repo가 대상이다. `needs`가 없는 job은 run을 만들 때부터 실행할 수 있다. `needs`가 있는 job은 앞 job이 끝나야 실행할 수 있다. 그래서 그 시각 전에 만들어진 모든 job 뒤에 선다. 같은 시간대 두 repo의 job 시각이 이 순서와 맞는다. - 이미지 job(17:50 실행 가능): 17:47에 만들어진 프론트 run까지 먼저 돌았다. 17:51에 만들어진 run보다는 앞이었다. - 서명 job(21:01 실행 가능): 19:28에 만들어진 run까지 먼저 돌았다. 22:30에 만들어진 run보다는 앞이었다. release.yml에 그 비용과 측정값을 적고, 태그는 대기 중인 run이 없을 때 자르라고 적는다. main.yml `performance` 주석의 「만든 순서」도 「실행할 수 있게 된 순서」로 고친다. `needs`가 없는 job에서는 둘이 같다. 고르지 않은 안: - `needs`를 빼고 파일 순서에 맡긴다. gate가 실패해도 이미지가 publish될 수 있다. - 서명을 이미지 job에 합친다. 서명 키가 빌드하는 job에 들어간다. - runner를 늘린다. 이번 프로그램의 범위 밖이다. 대기는 runner가 바쁠 때만 생기고, release 비용(job 시간 합)에는 들어가지 않는다. 동작 변경 없음: 주석만 바꿨다. 검증: scripts/verify.sh docs(노트북) rc=0. release.yml을 읽는 시험 (DeveloperExperienceContractTest, JpaReleaseRenderingTest)은 주석 문구를 보지 않고, 넣은 주석에는 JPA gate 태스크 이름이 없다. --- .gitea/workflows/main.yml | 7 ++++--- .gitea/workflows/release.yml | 10 ++++++++++ 2 files changed, 14 insertions(+), 3 deletions(-) diff --git a/.gitea/workflows/main.yml b/.gitea/workflows/main.yml index a878e56a..457d83cf 100644 --- a/.gitea/workflows/main.yml +++ b/.gitea/workflows/main.yml @@ -344,9 +344,10 @@ jobs: # run (63), and on every push, where the nightly jobs it waited for are skipped (79). A throwaway # workflow started by hand reproduced it with nothing else in it (2026-11-11, three variants): # every job with both `needs` and `if` stayed Blocked, whatever the `if` said and whether or not - # the jobs it needed had passed. A job without `needs` is queued when the run starts, and the one - # runner (capacity 1) takes a run's jobs in the order they were created, which is their order in - # this file. A second runner would let this job overlap the others; it would still run. + # the jobs it needed had passed. A job without `needs` is runnable when the run starts, and the one + # runner (capacity 1) takes the job that became runnable first, so a run's jobs go in the order they + # were created, which is their order in this file. A second runner would let this job overlap the + # others; it would still run. performance: if: ${{ github.event_name != 'push' }} runs-on: ubuntu-latest diff --git a/.gitea/workflows/release.yml b/.gitea/workflows/release.yml index 8022ae99..05ace22e 100644 --- a/.gitea/workflows/release.yml +++ b/.gitea/workflows/release.yml @@ -142,6 +142,16 @@ jobs: # Build, inventory and scan the image; on a tag also push it. It waits on every evidence job: # `needs` does not reach across workflows, so a gate in another file could still be running. + # + # What `needs` costs on this runner. Gitea gives the runner the job that became runnable first, + # across every repository the runner serves. A job without `needs` is runnable when its run is + # created; this one only when the last gate finishes, so it waits behind every job created before + # that moment, other repositories' jobs included. Manual run 157 (2026-11-12): the gates finished at + # 17:50 UTC and this job started at 20:52, after four frontend pull-request runs created between + # 17:03 and 17:47; app-image-signing waited two hours more the same way. Their job time is what a + # release costs; the wait is the queue's. On an idle runner the wait is zero, so cut a release tag + # when no other run is queued. Kept as it is: without `needs` an image could be published before a + # gate failed, and folding the signing into this job would put the key in a job that builds. app-image-release: needs: - release From 46c9ab81f5cb8359a8c91c043c39d0611163c8c6 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 13 Nov 2026 10:31:18 +0900 Subject: [PATCH 5/5] =?UTF-8?q?build(test):=20=EC=8B=A4=ED=8C=A8=ED=95=9C?= =?UTF-8?q?=20=EC=8B=9C=ED=97=98=EC=9D=B4=20job=20=EB=A1=9C=EA=B7=B8?= =?UTF-8?q?=EC=97=90=20=EB=A9=94=EC=8B=9C=EC=A7=80=EC=99=80=20=EC=9B=90?= =?UTF-8?q?=EC=9D=B8=EC=9D=84=20=EB=82=A8=EA=B8=B4=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit main push run 221(3d31896a)의 main job이 gRPC 시험 하나로 빨갛다. `GrpcP1BoundaryWireTest`의 「deadline 없이 부른 느린 호출은 서버 기본 deadline에서 DEADLINE_EXCEEDED로 끝난다」다. job 로그에는 「AssertionFailedError at GrpcP1BoundaryWireTest.java:276」 한 줄뿐이라 어떤 status가 왔는지 알 수 없다. - Gradle 기본 exceptionFormat(SHORT)은 예외 타입과 줄만 찍는다. - Gitea runner는 job이 끝나면 시험 보고서를 남기지 않는다. - desktop에서 같은 lane을 1코어에 고정해 15번 돌렸지만 모두 통과했다. 그래서 원인을 가릴 증거가 없다. 고친 것: - java 규약(`ca.java-library`가 적용하는 JavaConventionsPlugin)의 모든 Test 태스크가 실패를 FULL 형식으로 찍는다. 메시지와 원인 사슬이 job 로그에 남는다. strict lane도 Test 태스크라 같이 적용된다. - 그 시험의 status 단언에 받은 예외를 설명으로 붙인다(`as("status of %s")`). 다음에 실패하면 어느 경로였는지 바로 보인다. 다른 status가 왔는지, 5초 대기가 끝났는지(UNKNOWN), 다른 예외였는지다. 원인을 고친 커밋이 아니다. 재시도로 덮지 않았고, 시간 상한도 바꾸지 않았다. 코드로 확인한 범위는 이렇다. 응답이 성공으로 왔다면 단언 전에 `Status.fromThrowable(null)`이 NPE를 냈어야 한다. 그러니 실패는 DEADLINE_EXCEEDED가 아닌 status이거나 5초 대기 초과다. 위험: 실패가 많은 실행에서는 로그가 길어진다. 기본 stack trace 필터 (TRUNCATE)가 시험 진입점 아래를 자른다. 검증: desktop `./gradlew -p build-logic test`(새 시험 everyTestTaskLogsAFailureWithItsMessageAndCauses 포함)와 grpc lane, `verify.sh pr` (PR 본문에 적는다). --- .../java/JavaConventionsPlugin.java | 7 +++++++ .../PlatformModuleConventionTest.java | 21 +++++++++++++++++++ .../inbound/grpc/GrpcP1BoundaryWireTest.java | 1 + 3 files changed, 29 insertions(+) diff --git a/build-logic/src/main/java/dev/caskeleton/buildlogic/java/JavaConventionsPlugin.java b/build-logic/src/main/java/dev/caskeleton/buildlogic/java/JavaConventionsPlugin.java index 7b75200e..bf404d4c 100644 --- a/build-logic/src/main/java/dev/caskeleton/buildlogic/java/JavaConventionsPlugin.java +++ b/build-logic/src/main/java/dev/caskeleton/buildlogic/java/JavaConventionsPlugin.java @@ -25,6 +25,7 @@ import org.gradle.api.tasks.bundling.AbstractArchiveTask; import org.gradle.api.tasks.bundling.Jar; import org.gradle.api.tasks.compile.JavaCompile; import org.gradle.api.tasks.testing.Test; +import org.gradle.api.tasks.testing.logging.TestExceptionFormat; import org.gradle.jvm.toolchain.JavaLanguageVersion; import org.gradle.testing.base.TestingExtension; @@ -270,6 +271,11 @@ public final class JavaConventionsPlugin implements Plugin { // // The container images the lanes start come from gradle/container-images.properties, // each as `ca.test.image.`, with the file as an input (review 2026-11-01 08-04). + // + // A failing test prints its message and cause chain, not only the exception type and line + // (Gradle's default). The Gitea runner keeps no test report, so the job log is all there is: + // main push run 221 (2026-11-13) failed a gRPC deadline test with only + // "AssertionFailedError at GrpcP1BoundaryWireTest.java:276" to show for it. File images = containerImageCatalog(project); Map containerImages = containerImages(images); project.getExtensions().getExtraProperties().set("testContainerImages", containerImages); @@ -279,6 +285,7 @@ public final class JavaConventionsPlugin implements Plugin { .configureEach( test -> { test.systemProperty("user.timezone", "UTC"); + test.getTestLogging().setExceptionFormat(TestExceptionFormat.FULL); containerImages.forEach( (key, image) -> test.systemProperty(CONTAINER_IMAGE_PROPERTY_PREFIX + key, image)); test.getInputs() diff --git a/build-logic/src/test/java/dev/caskeleton/buildlogic/convention/PlatformModuleConventionTest.java b/build-logic/src/test/java/dev/caskeleton/buildlogic/convention/PlatformModuleConventionTest.java index c712ce19..6911d241 100644 --- a/build-logic/src/test/java/dev/caskeleton/buildlogic/convention/PlatformModuleConventionTest.java +++ b/build-logic/src/test/java/dev/caskeleton/buildlogic/convention/PlatformModuleConventionTest.java @@ -42,6 +42,27 @@ class PlatformModuleConventionTest { assertTrue(result.getOutput().contains("api-configuration-present=true"), result.getOutput()); } + @Test + void everyTestTaskLogsAFailureWithItsMessageAndCauses() throws Exception { + // given: `laneFixture` stands for a strict lane, a Test task registered after the convention. + buildFile( + """ + plugins { id 'ca.platform-module' } + tasks.register('laneFixture', Test) + tasks.register('reportTestLogging') { + List formats = tasks.withType(Test).collect { it.name + '=' + it.testLogging.exceptionFormat }.sort() + doLast { logger.lifecycle('formats=' + formats) } + } + """); + + // when + BuildResult result = runner("reportTestLogging").build(); + + // then + assertTrue( + result.getOutput().contains("formats=[laneFixture=FULL, test=FULL]"), result.getOutput()); + } + @Test void aLeafCarriesTheReleaseVersionAndNamesTheRevisionSeparately() throws Exception { // given diff --git a/src/adapter/inbound/grpc/src/test/java/dev/caskeleton/adapter/inbound/grpc/GrpcP1BoundaryWireTest.java b/src/adapter/inbound/grpc/src/test/java/dev/caskeleton/adapter/inbound/grpc/GrpcP1BoundaryWireTest.java index cbd20d75..fedee48b 100644 --- a/src/adapter/inbound/grpc/src/test/java/dev/caskeleton/adapter/inbound/grpc/GrpcP1BoundaryWireTest.java +++ b/src/adapter/inbound/grpc/src/test/java/dev/caskeleton/adapter/inbound/grpc/GrpcP1BoundaryWireTest.java @@ -273,6 +273,7 @@ class GrpcP1BoundaryWireTest { // then assertThat(Status.fromThrowable(failure).getCode()) + .as("status of %s", failure) .isEqualTo(Status.Code.DEADLINE_EXCEEDED); }); }