#!/usr/bin/env bash # 검증 진입점. 사람·세션·문서가 같은 명령을 쓰고, 단계 이름은 workflow(.gitea/workflows)와 같다. # # scripts/verify.sh <단계> [대상] [--on here|<호스트>] [--log <이름>] [--no-cache] # # 단계 무엇 workflow # docs 문서·지침 검사와 스크립트 시험(Gradle 없음) pr.yml의 prCheck 안 # leaf <경로> registry gradle_path 하나의 check (작업 중) # pr :prCheck, :verifyStrictLaneStages --dry-run pr.yml `gradle` # main :mainCheck, :integrationCheck, build-logic 시험, 설정 캐시 main.yml(push) # nightly compose smoke 전부, :performanceCheck(마지막) main.yml(nightly) # release :releaseCheck(이 커밋을 provenance로) release.yml `release` # app 앱을 띄워 health와 기본 endpoint를 직접 본다 (없음) # round pr → main → nightly → release, 첫 실패에서 멈춘다 라운드 끝 묶음 # docs 밖의 단계는 Gradle·Docker를 쓴다. 이 repo에서는 desktop에서만 돈다(docs/work/operate.md 4.1절). # trivy·lychee·nightly 행렬(Redis topology, PostgreSQL major, NFS)은 도구를 내려받거나 runner 환경이 필요해 # workflow에서만 돈다. # # --on <호스트>: 지금 작업 트리(커밋 안 된 변경 포함)를 패치로 그 호스트에 옮긴다. 기준 커밋에서 새 worktree를 # 만들어 패치를 적용하고, 트리 해시가 여기와 같은지 본 뒤 잠금 아래에서 같은 단계를 돌리고 worktree를 지운다. # push하지 않는다. 기준 커밋은 원격 checkout이 fetch로 받을 수 있어야 한다(기본: origin/main과 갈라진 곳). # docs 밖의 단계는 기본이 desktop이다. desktop에서 직접 돌릴 때는 --on here. # --no-cache: Gradle 명령마다 --no-build-cache를 붙인다(증거로 쓸 실행, docs/work/reference/gates.md 3절). # 환경 변수: VERIFY_HOST(무거운 단계의 --on 기본값, 없으면 desktop), VERIFY_REMOTE_REPO(원격 checkout, 기본 # ~/workspace/), VERIFY_BASE_REF(기본 origin/main), VERIFY_LOCK(기본 /tmp/claude-gates/heavy.lock), # VERIFY_SSH(기본 ssh). # 종료 코드: 단계의 종료 코드. 2 = 사용법, 4 = 원격 준비 실패. set -euo pipefail ROOT=$(git rev-parse --show-toplevel) cd "$ROOT" 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_FLAGS=(--console=plain --no-daemon) export GRADLE_OPTS="${GRADLE_OPTS:+$GRADLE_OPTS }-Dorg.gradle.daemon=false" LOCK=${VERIFY_LOCK:-/tmp/claude-gates/heavy.lock} usage() { awk 'NR > 1 && /^#/ { sub(/^# ?/, ""); print; next } NR > 1 { exit }' "$ROOT/scripts/verify.sh" >&2 exit 2 } gradle() { (cd src && ./gradlew "$@" "${GRADLE_FLAGS[@]}"); } # ---------------------------------------------------------------- 단계 본문 run_docs() { python3 scripts/check-work-docs.py python3 scripts/check-docs.py python3 -m unittest discover -s scripts/tests python3 scripts/check-repo-layout.py } # 대상은 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; } import json, sys paths = {m["gradle_path"] for m in json.load(open("src/config/architecture/modules.json"))["modules"]} sys.exit(0 if sys.argv[1] in paths else 1) PY gradle "$path:check" } run_pr() { gradle :prCheck gradle :verifyStrictLaneStages --dry-run } run_main() { gradle :mainCheck --continue gradle :integrationCheck --continue gradle -p build-logic test bash scripts/ci/verify-configuration-cache.sh } # performanceCheck는 마지막이다: 상한은 다른 빌드가 돌지 않는 머신에서만 뜻이 있다. run_nightly() { bash scripts/run-compose-runtime-smoke.sh --matrix src/app-bootstrap/compose-lanes/compose-profile-contracts.json gradle :performanceCheck --continue } # CI는 GITHUB_SHA로 커밋을 받는다. 여기서는 HEAD를 준다(--on 원격 실행에서는 패치를 얹은 기준 커밋). run_release() { GIT_SHA=${GIT_SHA:-$(git rev-parse HEAD)} gradle :releaseCheck; } run_app() { bash scripts/bootstrap-local.sh; } # 함수를 && 목록 안에서 부르면 그 안의 set -e가 꺼진다. 그래서 차례로 부른다. run_round() { run_pr run_main run_nightly run_release } # ---------------------------------------------------------------- 실행 위치 run_here() { local stage=$1 shift case "$stage" in docs) run_docs ;; leaf | pr | main | nightly | release | app | round) # 같은 머신의 다른 세션·프론트 repo와 무거운 실행이 겹치지 않게 공유 잠금 아래에서 돈다. if [ -z "${VERIFY_LOCKED:-}" ] && [ -d "$(dirname "$LOCK")" ]; then export VERIFY_LOCKED=1 exec flock "$LOCK" "$ROOT/scripts/verify.sh" "$stage" "$@" --on here "${NO_CACHE[@]}" fi "run_$stage" "$@" ;; *) usage ;; esac } run_remote() { local stage=$1 target=$2 host=$3 log=$4 ssh=${VERIFY_SSH:-ssh} local name base tree tmp_index patch id remote_repo name=$(basename "$(dirname "$(git rev-parse --path-format=absolute --git-common-dir)")") remote_repo=${VERIFY_REMOTE_REPO:-"~/workspace/$name"} base=$(git merge-base HEAD "${VERIFY_BASE_REF:-origin/main}") tmp_index=$(mktemp) patch=$(mktemp) TMP_FILES+=("$tmp_index" "$patch") cp "$(git rev-parse --git-path index)" "$tmp_index" GIT_INDEX_FILE=$tmp_index git add -A tree=$(GIT_INDEX_FILE=$tmp_index git write-tree) git diff --binary "$base" "$tree" > "$patch" id="verify-$(date +%s)-$$" echo "verify: $host에서 '$stage $target' (기준 ${base:0:12}, 트리 ${tree:0:12}, 로그 ~/$log-logs/$stage.log)" >&2 $ssh "$host" "cat > /tmp/$id.patch" < "$patch" # compose lane이 만든 root 소유 파일이 있어도 지울 수 있게 정리는 worktree remove --force 하나로 한다. $ssh "$host" bash -s <&2; exit 4; fi mkdir -p "\$(dirname $LOCK)" ~/$log-logs echo "verify: \$(uptime)" >&2 VERIFY_LOCKED=1 flock $LOCK ./scripts/verify.sh $stage $target --on here ${NO_CACHE[*]} 2>&1 | tee ~/$log-logs/$stage.log rc=\${PIPESTATUS[0]} # 새 worktree라 여기 있는 JUnit XML은 모두 이번 실행의 것이다. worktree를 지우기 전에 센다. find . -path '*/build/test-results/*' -name 'TEST-*.xml' -print0 | xargs -0 -r cat \\ | grep -o ']*' \\ | awk '{ for (i = 1; i <= NF; i++) if (split(\$i, kv, "=") == 2) { gsub(/"/, "", kv[2]); n[kv[1]] += kv[2] } } END { printf "verify: 테스트 tests=%d failures=%d errors=%d skipped=%d\\n", n["tests"], n["failures"], n["errors"], n["skipped"] }' \\ | tee -a ~/$log-logs/$stage.log echo "verify: rc=\$rc" | tee -a ~/$log-logs/$stage.log exit \$rc EOF } main() { local stage=${1:-} target="" on="" log="" NO_CACHE=() [ -n "$stage" ] || usage shift if [ "$stage" = leaf ] && [ $# -gt 0 ] && [ "${1#--}" = "$1" ]; then target=$1 shift fi while [ $# -gt 0 ]; do case "$1" in --on) on=${2:?--on 뒤에 호스트}; shift 2 ;; --log) log=${2:?--log 뒤에 이름}; shift 2 ;; --no-cache) NO_CACHE=(--no-cache); GRADLE_FLAGS+=(--no-build-cache); shift ;; *) usage ;; esac done if [ -z "$on" ]; then if [ "$stage" = docs ]; then on=here; else on=${VERIFY_HOST:-desktop}; fi fi if [ "$on" = here ]; then run_here "$stage" ${target:+"$target"} else log=${log:-$(git branch --show-current | tr '/' '-')} run_remote "$stage" "$target" "$on" "${log:-detached}" fi } main "$@"