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
This commit is contained in:
DongHyeonka
2026-11-11 22:15:42 +09:00
parent 1388c06a9f
commit 6a792b8144
263 changed files with 1057 additions and 907 deletions
+1 -1
View File
@@ -30,7 +30,7 @@ fi
compose=(docker compose -f "${repository_dir}/compose.yaml")
echo "bootstrap 1/4: compiling the default application composition"
(cd "${repository_dir}/src" && ./gradlew :app-bootstrap:compileTestJava --console=plain)
(cd "${repository_dir}" && ./gradlew :app-bootstrap:compileTestJava --console=plain)
if ! docker info >/dev/null 2>&1; then
echo "bootstrap: Docker가 필요합니다. Docker Desktop/daemon을 시작한 뒤 \`docker info\`가 성공하는지 확인하세요." >&2
+1 -1
View File
@@ -10,4 +10,4 @@
# 참조: 지금 트리·registry에 없는 경로. 고치거나 「> 이력」 인용 블록으로 옮기면 지운다.
# 숫자: 정본(src/gradle/libs.versions.toml, registry)이 정하는 값을 복사한 곳. 정본을 가리키게 고치면 지운다.
# 숫자: 정본(gradle/libs.versions.toml, registry)이 정하는 값을 복사한 곳. 정본을 가리키게 고치면 지운다.
+5 -5
View File
@@ -18,7 +18,7 @@
링크는 lychee와 check-work-docs.py --links가 본다.
number 살아 있는 문서가 정본이 정하는 숫자를 복사하지 않는다: Spring Boot 버전, leaf 개수.
Spring Boot 버전은 이름 바로 뒤(「Spring Boot」·「Boot」 뒤의 세 자리 버전)만이 아니라 `Spring Boot`
칸이 있는 표 행의 세 자리 버전과, 정본(src/gradle/libs.versions.toml의 springBoot)과 같은
칸이 있는 표 행의 세 자리 버전과, 정본(gradle/libs.versions.toml의 springBoot)과 같은
버전 문자열(굵은 글씨·표 칸·코드 안 포함)도 잡는다.
map docs/README.md의 문서 지도가 지금 있는 문서 폴더를 모두 덮는다. 지도는 표의 첫 칸에 적은
`폴더/`다. docs/ 바로 아래 폴더가 대상이고, 파일 없이 폴더만 가진 묶음 폴더(history/)는
@@ -43,7 +43,7 @@
python3 scripts/check-docs.py --only head # 하나만 (language, head, reference, number, map, readme)
python3 -m unittest discover -s scripts/tests # 이 검사의 시험
Gradle 밖에 둔다. 빌드는 문서를 파싱하지 않는다(src/build-logic/AGENTS.md 「저장소 파일을 읽는 테스트」).
Gradle 밖에 둔다. 빌드는 문서를 파싱하지 않는다(build-logic/AGENTS.md 「저장소 파일을 읽는 테스트」).
"""
from __future__ import annotations
@@ -60,7 +60,7 @@ from pathlib import Path
REPO_ROOT = Path(__file__).resolve().parent.parent
EXCEPTIONS_FILE = "scripts/check-docs-exceptions.txt"
REGISTRY_FILE = "src/config/architecture/modules.json"
REGISTRY_FILE = "gradle/modules.json"
CHECKS = ("language", "head", "reference", "number", "map", "readme", "link", "style")
# 기록: 본문은 쓴 때의 원문이다. 머리 블록만 고친다. 종류는 폴더가 정한다.
@@ -125,7 +125,7 @@ TOKEN = re.compile(r"[^\s가-힣]+")
WORD = re.compile(r"^[(\[\"'“‘*_]*[A-Za-z][a-z]*(?:['’][a-z]+)?(?:-[a-z]+)*[)\]\"'”’*_.,;:!?…]*$")
# --- 참조
PATH_ROOTS = ("src/", "docs/", "scripts/", "compose/", "infra/", ".github/", ".gitea/")
PATH_ROOTS = ("src/", "docs/", "scripts/", "compose/", "infra/", ".github/", ".gitea/", "build-logic/", "gradle/")
PLACEHOLDER = re.compile(r"[*?<>{}\[\]$…]|\.\.\.|YYYY|NNN|[가-힣]")
LINE_SUFFIX = re.compile(r"(?::\d+(?:[-,]\d+)*)+$")
# 모든 leaf에 있는 소스 세트 이름(src/test, src/main/java)은 어느 leaf의 것인지 문장이 정한다.
@@ -141,7 +141,7 @@ COPIED_NUMBERS = [
re.I)),
]
# 이름 옆이 아닌 Spring Boot 버전: 「기준은 **4.0.8**」, 「| Spring Boot | 4.0.0 |」.
CATALOG_FILE = "src/gradle/libs.versions.toml"
CATALOG_FILE = "gradle/libs.versions.toml"
CATALOG_SPRING_BOOT = re.compile(r'^springBoot\s*=\s*"([^"]+)"', re.M)
# 세 자리 버전. 앞이 낱말·점·§이면 다른 수의 일부다(1.2.3.4, RFC 절 번호 §6.5.2).
VERSION = re.compile(r"(?<![\w.§])v?\d+\.\d+\.\d+(?:[.-][A-Za-z][A-Za-z0-9]*)*(?![\w]|\.\d)")
+27 -34
View File
@@ -9,8 +9,8 @@
무엇을 보나:
1. 저장소 루트의 추적 파일·폴더가 ROOT_ALLOWED 안에 있는가.
2. src/ 바로 아래의 추적 파일·폴더가 SRC_ALLOWED 안에 있는가.
3. registry(src/config/architecture/modules.json)의 모든 source_path가 허용된 src/ 폴더 아래에 있는가.
2. src/ 바로 아래의 추적 파일·폴더가 SRC_ALLOWED 안에 있는가. src/에는 계층 폴더만 있다(파일 없음).
3. registry(gradle/modules.json)의 모든 source_path가 허용된 src/ 폴더 아래에 있는가.
4. (경고만) 개발 환경·테스트 fixture 파일(compose 파일, 셸 스크립트, compose/ 아래 보조 파일)을 다른
추적 파일이 하나도 가리키지 않으면 이름을 출력한다. 아무도 읽지 않는 파일이 소리 없이 남는 것이
infra/ 12개가 쌓인 방식이다. 경로를 변수로 조립하는 workflow는 이 검사가 따라가지 못하므로 경고로만 둔다.
@@ -33,19 +33,26 @@ import sys
from pathlib import Path, PurePosixPath
REPO_ROOT = Path(__file__).resolve().parent.parent
REGISTRY = "src/config/architecture/modules.json"
REGISTRY = "gradle/modules.json"
# 저장소 루트: 문서·스크립트·CI·개발 환경과 Gradle 루트(src)뿐이다.
# 저장소 루트 = Gradle 루트: 빌드 도구와 빌드 파일, 문서·스크립트·CI·개발 환경, 그리고 코드(src)다.
# 2026-11-11에 Gradle 루트를 src/에서 여기로 옮겼다(design-docs repo-structure/01-backend-layout.md 6.1절 가-3).
ROOT_ALLOWED = {
# 폴더
".claude": "Claude Code 세션 설정(추적: settings.json의 권한·훅, rules·skills·agents)",
".gitea": "Gitea Actions workflow(pr·main·release)와 공용 action",
".github": "CODEOWNERS, PR 템플릿, 의존성 취약점 정책",
"build-logic": "빌드 규칙(included build)",
"compose": "compose.yaml이 마운트하는 보조 파일",
"config": "코드 검사 도구 설정(checkstyle, spotbugs)",
"docs": "문서",
"gradle": "wrapper, 버전 카탈로그, 모듈 registry, 시험 컨테이너 이미지 목록",
"scripts": "Gradle 밖 검사·실행 스크립트",
"src": "Gradle 루트",
"src": "계층별 앱 코드",
# 파일
".dockerignore": "이미지 빌드 context(저장소 루트)에서 뺄 것",
".env.example": "env 계약",
".env.local.example": "로컬 env 예",
".gitattributes": "Git 설정",
".gitignore": "Git 설정",
".lycheeignore": "링크 검사(lychee)가 건너뛸 URL. lychee는 저장소 루트의 이 이름만 읽는다",
@@ -54,46 +61,32 @@ ROOT_ALLOWED = {
"AGENTS.md": "규칙 정본이자 작업 지도",
"CLAUDE.md": "Claude Code 진입점(AGENTS.md를 가져온다)",
"README.md": "저장소 소개",
"compose.yaml": "개발 환경(하나뿐)",
"renovate.json": "의존성 갱신 봇 설정",
"testcontainers.properties.example": "Testcontainers 로컬 설정 예",
}
# src/ 바로 아래: 계층·조립 leaf, Gradle 루트 표준 폴더와 빌드 파일. 계층이 아닌 라이브러리(메시징·gRPC)는
# 2026-11-08에 별도 repo로 나갔다(docs/work/reference/related-repos.md). 그 자리(platforms)는 다시 두지 않는다.
SRC_ALLOWED = {
# 계층과 조립
"domain-core": "계층",
"shared-contract": "계층",
"application-core": "계층",
"application-fileserver": "계층(capability)",
"application-notification": "계층(capability)",
"application-objectstorage": "계층(capability)",
"adapter": "계층(adapter leaf 묶음)",
"composition": "조립(Clean Architecture의 Main)",
"app-bootstrap": "조립 루트",
# Gradle 루트 표준
"build-logic": "빌드 규칙(included build)",
"config": "빌드 전체 도구 설정(registry, checkstyle, spotbugs, 테스트 이미지)",
"gradle": "wrapper와 버전 카탈로그",
# 파일
".dockerignore": "이미지 빌드 context",
".env.example": "env 계약",
".env.local.example": "로컬 env 예",
".gitignore": "Git 설정",
"Dockerfile": "릴리스 이미지",
"README.md": "빌드·env 안내",
"build.gradle": "루트 빌드",
"compose.yaml": "개발 환경(하나뿐)",
"gradle.properties": "Gradle 설정",
"gradlew": "wrapper",
"gradlew.bat": "wrapper",
"renovate.json": "의존성 갱신 봇 설정",
"settings-gradle.lockfile": "settings 잠금",
"settings.gradle": "settings",
"testcontainers.properties.example": "Testcontainers 로컬 설정 예",
}
# src/ 바로 아래: 계층 폴더만. 같은 계층의 leaf는 그 계층 폴더 아래에 둔다(application/core, bootstrap/app).
# 빌드 도구와 빌드 파일은 저장소 루트에 있다. 계층이 아닌 라이브러리(메시징·gRPC)는 2026-11-08에 별도 repo로
# 나갔다(docs/work/reference/related-repos.md). 그 자리(platforms)는 다시 두지 않는다.
SRC_ALLOWED = {
"domain": "계층(domain/core)",
"shared-contract": "계층",
"application": "계층(application/core와 capability application leaf)",
"adapter": "계층(adapter leaf 묶음: inbound, outbound)",
"bootstrap": "조립 계층(Clean Architecture의 Main): 조립 루트 app과 조립 leaf",
}
# 아무도 가리키지 않으면 경고할 파일: 개발 환경과 테스트 fixture.
FIXTURE_SUFFIXES = (".sh", ".acl", ".json", ".yaml", ".yml")
FIXTURE_PREFIXES = ("compose/", "scripts/", "src/app-bootstrap/compose-lanes/")
FIXTURE_PREFIXES = ("compose/", "scripts/", "src/bootstrap/app/compose-lanes/")
HISTORY_PREFIXES = (
"docs/reviews/",
"docs/superpowers/",
+2 -2
View File
@@ -66,9 +66,9 @@ if [ "${topology}" = tls ]; then
extra=(-Predis.topology.trust-material="${trust}")
fi
(cd src && ./gradlew "${tasks[@]}" --continue \
./gradlew "${tasks[@]}" --continue \
-Predis.topology.host=localhost -Predis.topology.port="${port}" -Predis.topology.mode="${topology}" \
"${extra[@]}")
"${extra[@]}"
printf 'evidence: commit=%s run=%s topology=%s redis_version=%s image_digest=%s\n' \
"$(git rev-parse HEAD)" "${GITHUB_RUN_ID:-local}" "${topology}" "${version}" "${digest}"
+1 -1
View File
@@ -8,7 +8,7 @@
# prCheck and verifyStrictLaneStages are not in the list: the strict-lane check reads the task graph
# itself and is declared incompatible, and prCheck is ci plus scripts.
set -euo pipefail
cd "$(dirname "${BASH_SOURCE[0]}")/../../src"
cd "$(dirname "${BASH_SOURCE[0]}")/../.."
reused() { # gradle arguments...; fails unless the second identical run reuses the stored entry
./gradlew "$@" --configuration-cache --configuration-cache-problems=fail
+1 -1
View File
@@ -22,7 +22,7 @@ Bash 직후 ──> post-bash ──> desktop에서 Gradle을 돌렸으면
| ID | 때 | 하는 일 | 결과 |
| --- | --- | --- | --- |
| H13 | PreToolUse `Edit\|Write\|MultiEdit` | `src/**/src/main/resources/db/migration/<키>`의 `<키>`가 `src/adapter/outbound/persistence-jpa/src/test/resources/db/applied-migrations.sha256`에 있으면 막는다 | 종료 코드 2와 「새 버전 파일을 더한다」 안내 |
| 포맷 | PostToolUse `Edit\|Write\|MultiEdit` | `src/**/*.java`(build-logic과 `build/` 제외)를 google-java-format으로 맞춘다. 버전은 카탈로그 `googleJavaFormat`, jar는 Gradle 캐시, 옵션은 Spotless 단계와 같게 `--skip-reflowing-long-strings --replace` | 파일이 바뀌면 「다시 읽는다」 한 줄. 문법 오류면 첫 줄들 |
| 포맷 | PostToolUse `Edit\|Write\|MultiEdit` | `src/**/*.java`(`build/` 제외. `build-logic/`은 `src/` 밖이라 대상이 아니다)를 google-java-format으로 맞춘다. 버전은 카탈로그 `googleJavaFormat`, jar는 Gradle 캐시, 옵션은 Spotless 단계와 같게 `--skip-reflowing-long-strings --replace` | 파일이 바뀌면 「다시 읽는다」 한 줄. 문법 오류면 첫 줄들 |
| N1 | 같은 때, `src/**/src/main/java/**/*.java` | registry로 그 파일의 leaf를 찾고 import를 본다: 순수성 목록(`DomainPurityArchitectureTest`, `verifyApplicationCoreDependencyPurity`와 같은 패키지), inbound의 persistence 접근, `dev.caskeleton.*`의 주인 leaf가 registry `allowed_dependencies`(전이 포함)에 있는지 | 「HARD-STOP N 의심」 줄 |
| N2 | 같은 때, `*.md` | `scripts/check-work-docs.py`와 `scripts/check-docs.py`를 돌린다 | 실패 줄. 고친 문서를 가리키는 줄이 있으면 그것만 |
| N5 | Stop | 이 세션에서 Java를 고친 뒤 `ssh <desktop 호스트> … gradlew …` 실행이 없으면 턴을 한 번 막고 이유를 준다 | `decision: block`, 다음 Java 편집 전까지 한 번 |
+3 -3
View File
@@ -26,8 +26,8 @@ import subprocess
import sys
from pathlib import Path
REGISTRY = "src/config/architecture/modules.json"
CATALOG = "src/gradle/libs.versions.toml"
REGISTRY = "gradle/modules.json"
CATALOG = "gradle/libs.versions.toml"
MIGRATION_MANIFEST = "src/adapter/outbound/persistence-jpa/src/test/resources/db/applied-migrations.sha256"
STATE_DIR = ".claude/hook-state"
EDIT_TOOLS = ("Edit", "Write", "MultiEdit")
@@ -41,7 +41,7 @@ GJF_EXPORTS = tuple(f"--add-exports=jdk.compiler/com.sun.tools.javac.{part}=ALL-
for part in ("api", "code", "file", "parser", "tree", "util"))
GJF_TIMEOUT = 25
# Spotless is not applied to build-logic (it is its own build), so the hook leaves it alone too.
FORMAT_EXCLUDED = ("src/build-logic/",)
FORMAT_EXCLUDED = ("build-logic/",)
SKIPPED = "포맷을 건너뛰었다"
# --- N1: the layer rules the gates hold, checked on the imports of one edited main source --------------
+5 -5
View File
@@ -83,7 +83,7 @@ fi
# 기능 패키지는 다섯 루트 바로 아래에 생긴다. 어느 leaf에든 그 이름의 패키지가 이미 있으면 거절한다.
# 템플릿 패키지(operation, lock, cache, secret, notification…)는 모두 여기 걸린다. 이름 목록을 따로
# 두지 않는 이유: 목록은 템플릿이 패키지를 더하거나 옮길 때 갈라진다(예전 목록에는 사라진
# `outbound`가 남고 새 `secret`이 없었다). 템플릿 소유 목록의 정본은 src/application-core/CLAUDE.md
# `outbound`가 남고 새 `secret`이 없었다). 템플릿 소유 목록의 정본은 src/application/core/CLAUDE.md
# 「Package ownership」이고, 생성 뒤에는 NamingConventionTest.FEATURE_PACKAGES_DO_NOT_REUSE_TEMPLATE_PACKAGE_NAMES가
# 같은 규칙을 다시 건다.
feature_roots=(domain application adapter/inbound/web adapter/outbound/identifier bootstrap/autoconfigure)
@@ -100,7 +100,7 @@ done
if [ -n "$existing" ]; then
echo "'$package_name' 패키지가 이미 있다: $existing" >&2
echo "템플릿 패키지와 같은 이름의 업무 기능은 upstream 템플릿을 받을 때 같은 패키지 트리에 섞인다." >&2
echo "다른 이름을 고른다(템플릿 패키지 목록: src/application-core/CLAUDE.md 「Package ownership」)." >&2
echo "다른 이름을 고른다(템플릿 패키지 목록: src/application/core/CLAUDE.md 「Package ownership」)." >&2
exit 2
fi
@@ -128,7 +128,7 @@ for source in "${sources[@]}"; do
targets+=("$target")
done
imports="$repo_root/src/app-bootstrap/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports"
imports="$repo_root/src/bootstrap/app/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports"
config_class="dev.caskeleton.bootstrap.autoconfigure.$package_name.${name}Config"
[ -f "$imports" ] || { echo "없다: $imports" >&2; exit 1; }
@@ -150,7 +150,7 @@ leaves=(:domain-core :application-core :adapter:outbound:identifier :adapter:inb
if [ "$format" -eq 1 ]; then
spotless=()
for leaf in "${leaves[@]}"; do spotless+=("$leaf:spotlessApply"); done
(cd "$repo_root/src" && ./gradlew -q --console=plain "${spotless[@]}")
(cd "$repo_root" && ./gradlew -q --console=plain "${spotless[@]}")
echo "포맷 spotlessApply (${leaves[*]})"
fi
@@ -160,7 +160,7 @@ cat <<EOF
$name 뼈대를 만들었다. 다음 순서로 진행한다(docs/manual/02-new-feature.md).
1. 검사: cd src && ./gradlew ${checks[*]} architectureCheck --console=plain
1. 검사: ./gradlew ${checks[*]} architectureCheck --console=plain
2. 권한: app.authz.role-permissions에 역할 -> $kebab:create 를 준다(07-authorization.md).
주기 전까지 POST /$path_segment 는 모두 403이다.
3. 저장 adapter: ${name}Repository를 구현하고 ${name}RepositoryContract를 실제 저장소로 상속한다
+10 -10
View File
@@ -24,15 +24,15 @@
set -euo pipefail
REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
CONTRACTS="${REPO_ROOT}/src/app-bootstrap/compose-lanes/compose-profile-contracts.json"
EVIDENCE_ROOT="${REPO_ROOT}/src/app-bootstrap/build/evidence/runtime-smoke"
CONTRACTS="${REPO_ROOT}/src/bootstrap/app/compose-lanes/compose-profile-contracts.json"
EVIDENCE_ROOT="${REPO_ROOT}/src/bootstrap/app/build/evidence/runtime-smoke"
RUN_ID="$(date -u +%Y%m%dT%H%M%SZ)-$$"
# Compose project names accept lowercase alphanumerics, hyphens and underscores only, so the run id
# is lowercased for the project while the evidence directory keeps the readable timestamp.
PROJECT_RUN_ID="$(tr '[:upper:]' '[:lower:]' <<<"${RUN_ID}")"
# The lanes boot the qualification image: the application with every capability module on the
# classpath (src/Dockerfile COMPOSITION, app-bootstrap qualificationBootJar). The default image is
# classpath (Dockerfile COMPOSITION, app-bootstrap qualificationBootJar). The default image is
# the composition a service ships and carries none of them, so a lane that switches JPA or Kafka on
# would have nothing to switch. compose.yaml passes this to the build and puts it in the tag.
export COMPOSITION=qualification
@@ -81,8 +81,8 @@ for tool in jq docker; do
done
[[ -r "${CONTRACTS}" ]] || { echo "missing ${CONTRACTS}" >&2; exit 78; }
# The lane-only TLS overlay's keypair directory (src/app-bootstrap/compose-lanes/tls.yaml).
LANE_POSTGRES_TLS="${REPO_ROOT}/src/app-bootstrap/compose-lanes/postgres/tls"
# The lane-only TLS overlay's keypair directory (src/bootstrap/app/compose-lanes/tls.yaml).
LANE_POSTGRES_TLS="${REPO_ROOT}/src/bootstrap/app/compose-lanes/postgres/tls"
# ---- per-lane state, cleaned up by the trap ---------------------------------
PROJECT=""
@@ -115,7 +115,7 @@ cleanup_lane() {
[[ -n "${LANE_TMP}" && -d "${LANE_TMP}" ]] && rm -rf "${LANE_TMP}"
# .env.lane is gone — the lane's values live in the generated overlay now — but a file left by an
# older revision of this script would still be read by an env_file list of an older stack.
rm -f "${REPO_ROOT}/src/.env.lane" "${REPO_ROOT}/compose/keycloak/secrets/graphql-smoke-client-secret"
rm -f "${REPO_ROOT}/.env.lane" "${REPO_ROOT}/compose/keycloak/secrets/graphql-smoke-client-secret"
# The lane keypair, including the CA's private half. A certificate that outlives the run it was
# made for is a credential nobody is tracking.
rm -f "${LANE_POSTGRES_TLS}"/ca.key "${LANE_POSTGRES_TLS}"/ca.crt \
@@ -231,7 +231,7 @@ run_lane() {
# The values a deployment must supply: the seven with no inline default, and the secrets the prod
# env validator requires to be non-blank. A lane supplies them explicitly rather than inheriting a
# developer's src/.env, which is the difference between a lane that reproduces anywhere and one
# developer's .env, which is the difference between a lane that reproduces anywhere and one
# that reproduces on the machine it was written on. All generated per run and removed on teardown.
#
# The database credentials are additionally *exported*, because two different mechanisms have to
@@ -297,8 +297,8 @@ run_lane() {
# Every deployment-supplied value the lane owns, collected here and written into the generated
# overlay's `environment:` block below rather than into an env file.
#
# These lived in src/.env.lane, and an env file cannot win. env_file lists merge across overlays
# and the later one takes precedence, so the developer's optional src/.env — declared by the local
# These lived in .env.lane, and an env file cannot win. env_file lists merge across overlays
# and the later one takes precedence, so the developer's optional .env — declared by the local
# overlay, after the base — silently replaced them. That is not hypothetical: it pinned the JWT
# issuer to http://localhost:8081, which inside the app container is the application itself, so the
# application fetched JWKS from its own port and answered AUTH_JWKS_UNAVAILABLE to every
@@ -331,7 +331,7 @@ run_lane() {
# The lane's own settings go into a generated overlay rather than into that file.
#
# env_file lists merge across overlays and the later file wins, so the developer's optional
# src/.env — declared by the local overlay (now compose.yaml) — silently overrode the lane's values.
# .env — declared by the local overlay (now compose.yaml) — silently overrode the lane's values.
# local-messaging started Kafka, set APP_MESSAGING_BROKER=kafka, and was refused by the dependency
# validator for a broker it had supplied, because an empty value from a file nobody mentioned won
# the merge. An `environment:` block beats every env_file regardless of order, so the lane's
+11 -11
View File
@@ -27,10 +27,10 @@ sys.modules["hooks"] = hooks
_spec.loader.exec_module(hooks)
REGISTRY = {"modules": [
{"id": "domain-core", "gradle_path": ":domain-core", "source_path": "src/domain-core", "allowed_dependencies": []},
{"id": "domain-core", "gradle_path": ":domain-core", "source_path": "src/domain/core", "allowed_dependencies": []},
{"id": "shared-contract", "gradle_path": ":shared-contract", "source_path": "src/shared-contract",
"allowed_dependencies": []},
{"id": "application-core", "gradle_path": ":application-core", "source_path": "src/application-core",
{"id": "application-core", "gradle_path": ":application-core", "source_path": "src/application/core",
"allowed_dependencies": ["domain-core", "shared-contract"]},
{"id": "adapter-inbound-web", "gradle_path": ":adapter:inbound:web", "source_path": "src/adapter/inbound/web",
"allowed_dependencies": ["application-core"]},
@@ -38,9 +38,9 @@ REGISTRY = {"modules": [
"source_path": "src/adapter/outbound/persistence-jpa", "allowed_dependencies": ["application-core"]},
]}
PACKAGES = {
"src/domain-core": "dev/caskeleton/domain/order/Order.java",
"src/domain/core": "dev/caskeleton/domain/order/Order.java",
"src/shared-contract": "dev/caskeleton/shared/error/ApiErrorCode.java",
"src/application-core": "dev/caskeleton/application/order/PlaceOrderUseCase.java",
"src/application/core": "dev/caskeleton/application/order/PlaceOrderUseCase.java",
"src/adapter/inbound/web": "dev/caskeleton/adapter/inbound/web/order/OrderRequest.java",
"src/adapter/outbound/persistence-jpa": "dev/caskeleton/adapter/outbound/persistence/order/OrderEntity.java",
}
@@ -157,7 +157,7 @@ class MigrationGuardTest(RepositoryTestCase):
class FormatterTest(RepositoryTestCase):
"""The formatter runs one JVM on one file with the jar Gradle cached; it never downloads one."""
SOURCE = "src/domain-core/src/main/java/dev/caskeleton/domain/order/Order.java"
SOURCE = "src/domain/core/src/main/java/dev/caskeleton/domain/order/Order.java"
def fake_cache(self, version: str = "1.35.0") -> Path:
return fake_cache(Path(tempfile.mkdtemp(dir=self.cache.name)), version)
@@ -210,7 +210,7 @@ class FormatterTest(RepositoryTestCase):
self.assertEqual(second, "")
def test_build_logic_and_non_java_files_are_not_formatted(self) -> None:
self.assertFalse(hooks.wants_format("src/build-logic/src/main/java/A.java"))
self.assertFalse(hooks.wants_format("build-logic/src/main/java/A.java"))
self.assertFalse(hooks.wants_format("src/app/build/generated/A.java"))
self.assertFalse(hooks.wants_format("docs/a.md"))
self.assertTrue(hooks.wants_format(self.SOURCE))
@@ -247,18 +247,18 @@ class BoundaryNudgeTest(RepositoryTestCase):
return added_context(out)
def test_spring_in_the_domain_is_hard_stop_1(self) -> None:
text = self.nudge("src/domain-core", "dev/caskeleton/domain/order/Line.java",
text = self.nudge("src/domain/core", "dev/caskeleton/domain/order/Line.java",
"import org.springframework.stereotype.Component;")
self.assertIn("HARD-STOP 1 의심: `domain-core`가 `org.springframework.stereotype.Component`", text)
self.assertIn("architectureCheck", text)
def test_an_owned_library_in_the_application_is_flagged(self) -> None:
text = self.nudge("src/application-core", "dev/caskeleton/application/order/Notify.java",
text = self.nudge("src/application/core", "dev/caskeleton/application/order/Notify.java",
"import dev.cakit.messaging.api.MessageEnvelope;")
self.assertIn("`application-core`가 `dev.cakit.messaging.api.MessageEnvelope`", text)
def test_an_inbound_dto_in_the_application_is_hard_stop_3(self) -> None:
text = self.nudge("src/application-core", "dev/caskeleton/application/order/Place.java",
text = self.nudge("src/application/core", "dev/caskeleton/application/order/Place.java",
"import dev.caskeleton.adapter.inbound.web.order.OrderRequest;")
self.assertIn("HARD-STOP 3 의심: `dev.caskeleton.adapter.inbound.web.order.OrderRequest`는 leaf "
"`adapter-inbound-web`의 것인데 `application-core`", text)
@@ -280,7 +280,7 @@ class BoundaryNudgeTest(RepositoryTestCase):
self.assertEqual(text, "")
def test_test_sources_and_files_outside_any_leaf_are_not_checked(self) -> None:
path = "src/domain-core/src/test/java/dev/caskeleton/domain/order/OrderTest.java"
path = "src/domain/core/src/test/java/dev/caskeleton/domain/order/OrderTest.java"
self.repo.write(path, "package dev.caskeleton.domain.order;\nimport org.springframework.util.Assert;\nclass OrderTest {}\n")
self.assertEqual(hooks.boundary_findings(self.repo.root, path, (self.repo.root / path).read_text()), [])
self.assertEqual(hooks.boundary_findings(self.repo.root, "src/other/src/main/java/A.java", "import org.springframework.X;"), [])
@@ -323,7 +323,7 @@ class DocumentNudgeTest(RepositoryTestCase):
class TurnEndNudgeTest(RepositoryTestCase):
"""N5 — Java edited and no desktop Gradle run since: the turn end says so once."""
SOURCE = "src/domain-core/src/main/java/dev/caskeleton/domain/order/Order.java"
SOURCE = "src/domain/core/src/main/java/dev/caskeleton/domain/order/Order.java"
def edit_java(self) -> None:
run_event("post-edit", self.repo.payload(self.SOURCE), self.environment)
+2 -2
View File
@@ -30,7 +30,7 @@
set -euo pipefail
REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
CONTRACTS="${REPO_ROOT}/src/app-bootstrap/compose-lanes/compose-profile-contracts.json"
CONTRACTS="${REPO_ROOT}/src/bootstrap/app/compose-lanes/compose-profile-contracts.json"
FAILURES=0
fail() { echo " FAIL: $*" >&2; FAILURES=$((FAILURES + 1)); }
@@ -259,4 +259,4 @@ if [[ ${FAILURES} -gt 0 ]]; then
echo "verify-compose-profile-contracts: ${FAILURES} lane(s) do not match the contract" >&2
exit 1
fi
echo "verify-compose-profile-contracts: all ${lane_count} lanes match src/app-bootstrap/compose-lanes/compose-profile-contracts.json"
echo "verify-compose-profile-contracts: all ${lane_count} lanes match src/bootstrap/app/compose-lanes/compose-profile-contracts.json"
+6 -6
View File
@@ -78,15 +78,15 @@ done
for name in "${names[@]}"; do
package_name="$(printf '%s' "$name" | tr '[:upper:]' '[:lower:]')"
for required in \
"src/domain-core/src/main/java/dev/caskeleton/domain/$package_name/${name}.java" \
"src/application-core/src/main/java/dev/caskeleton/application/$package_name/Create${name}UseCase.java" \
"src/domain/core/src/main/java/dev/caskeleton/domain/$package_name/${name}.java" \
"src/application/core/src/main/java/dev/caskeleton/application/$package_name/Create${name}UseCase.java" \
"src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/$package_name/${name}Controller.java" \
"src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/$package_name/${name}Config.java"; do
"src/bootstrap/app/src/main/java/dev/caskeleton/bootstrap/autoconfigure/$package_name/${name}Config.java"; do
[ -f "$copy/$required" ] || { echo "생성되지 않았다: $required" >&2; exit 1; }
done
done
cd "$copy/src"
cd "$copy"
./gradlew --console=plain --continue \
:domain-core:check \
:application-core:check \
@@ -116,7 +116,7 @@ require_test_result() {
fi
}
# 템플릿 경로(<leaf>/src/test/java/<패키지 경로>/<클래스>.java.tmpl)를 그 leaf의 결과 XML 경로로.
# 템플릿 경로(<leaf>/src/test/java/<패키지 경로>/<클래스>.java.tmpl, src/ 기준)를 그 leaf의 결과 XML 경로(저장소 루트 기준)로.
result_of() {
local template="${1#./}" name="$2" package_name="$3"
local leaf="${template%%/src/test/java/*}"
@@ -124,7 +124,7 @@ result_of() {
class_path="${class_path%.java.tmpl}"
local fqcn
fqcn="$(printf '%s' "$class_path" | sed -e "s/__Feature__/$name/g" -e "s/__feature__/$package_name/g" | tr '/' '.')"
printf '%s/build/test-results/test/TEST-%s.xml' "$leaf" "$fqcn"
printf 'src/%s/build/test-results/test/TEST-%s.xml' "$leaf" "$fqcn"
}
for name in "${names[@]}"; do
+1 -1
View File
@@ -22,7 +22,7 @@
set -euo pipefail
REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
GRADLE_DIR="${REPO_ROOT}/src"
GRADLE_DIR="${REPO_ROOT}"
MODULE=':adapter:outbound:persistence-mongo'
GRADLE=(./gradlew --console=plain)
+2 -2
View File
@@ -23,11 +23,11 @@
set -euo pipefail
REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
GRADLE_DIR="${REPO_ROOT}/src"
GRADLE_DIR="${REPO_ROOT}"
MODULE=':adapter:outbound:persistence-mongo'
GRADLE=(./gradlew --console=plain)
RESULTS_DIR="${GRADLE_DIR}/adapter/outbound/persistence-mongo/build/test-results"
RESULTS_DIR="${GRADLE_DIR}/src/adapter/outbound/persistence-mongo/build/test-results"
RAN=()
SKIPPED=()
+5 -5
View File
@@ -33,7 +33,7 @@ TMP_FILES=()
trap '[ ${#TMP_FILES[@]} -eq 0 ] || rm -f "${TMP_FILES[@]}"' EXIT # 빈 배열 + set -u는 옛 bash에서 오류다
# 빌드마다 쓰고 버리는 daemon. 여러 worktree의 빌드를 한 오래 사는 daemon이 받으면 서로 호환되지 않는 compiler
# worker가 쌓여 desktop 메모리를 채운다(2026-11-08 측정: worker 41개, 14.2GB). GRADLE_OPTS는 단계 안에서 다시 부르는
# Gradle(생성 명령 왕복, 설정 캐시·Redis 스크립트)에도 같은 규칙을 준다. repo 기본값(src/gradle.properties)은 그대로다.
# Gradle(생성 명령 왕복, 설정 캐시·Redis 스크립트)에도 같은 규칙을 준다. repo 기본값(gradle.properties)은 그대로다.
GRADLE_FLAGS=(--console=plain --no-daemon)
export GRADLE_OPTS="${GRADLE_OPTS:+$GRADLE_OPTS }-Dorg.gradle.daemon=false"
LOCK=${VERIFY_LOCK:-/tmp/claude-gates/heavy.lock}
@@ -43,7 +43,7 @@ usage() {
exit 2
}
gradle() { (cd src && ./gradlew "$@" "${GRADLE_FLAGS[@]}"); }
gradle() { ./gradlew "$@" "${GRADLE_FLAGS[@]}"; }
# ---------------------------------------------------------------- 단계 본문
@@ -57,9 +57,9 @@ run_docs() {
# 대상은 registry의 gradle_path여야 한다. 폴더 이름이나 기억으로 짐작한 경로는 여기서 거절한다.
run_leaf() {
local path=${1:?leaf 뒤에 registry gradle_path(예: :adapter:outbound:persistence-jpa)}
python3 - "$path" <<'PY' || { echo "verify: $path는 registry(src/config/architecture/modules.json)의 gradle_path가 아니다" >&2; exit 2; }
python3 - "$path" <<'PY' || { echo "verify: $path는 registry(gradle/modules.json)의 gradle_path가 아니다" >&2; exit 2; }
import json, sys
paths = {m["gradle_path"] for m in json.load(open("src/config/architecture/modules.json"))["modules"]}
paths = {m["gradle_path"] for m in json.load(open("gradle/modules.json"))["modules"]}
sys.exit(0 if sys.argv[1] in paths else 1)
PY
gradle "$path:check"
@@ -79,7 +79,7 @@ run_main() {
# performanceCheck는 마지막이다: 상한은 다른 빌드가 돌지 않는 머신에서만 뜻이 있다.
run_nightly() {
bash scripts/run-compose-runtime-smoke.sh --matrix src/app-bootstrap/compose-lanes/compose-profile-contracts.json
bash scripts/run-compose-runtime-smoke.sh --matrix src/bootstrap/app/compose-lanes/compose-profile-contracts.json
gradle :performanceCheck --continue
}