Move Maven repositories to ./maven subdirectory

Introduce MAVEN_PROJECTS_DIR variable (default: maven) to support
Maven project checkouts in a subdirectory instead of the root.

Changes:
- common-functions.sh: Add MAVEN_PROJECTS_DIR, use ${root} prefix
  for all paths (projects, logs, develocity), add MAVEN_REPO_LOCAL_OPT
- repo-start, repo-checkout-specific-branches: cd into maven dir
- run-maven, run-jqa: Use MAVEN_REPO_LOCAL_OPT from common-functions
- CLAUDE.md: Document new directory structure and variables
- .gitignore: Simplify for new structure

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: ascheman

.gitignore

@@ -1,20 +1,8 @@
 .idea/
-# Maven directories
-core/
-doxia/
-misc/
-plexus/
-plugins/
-shared/
-sisu/
-site/
-sources/
-studies/
-svn/
+# Maven directories (new location via symlink)
+maven
 # Our stuff
-.repo/
 .envrc*
-.m2/repository/
 .sdkmanrc
 jqassistant/store*
 logs/*

CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-Maven Support & Care Tools - an automation toolkit for managing, building, and analyzing the Apache Maven multi-repository ecosystem. Uses the `repo` tool to manage 100+ Apache Maven repositories (manifest hosted at [maven-sources](https://github.com/apache/maven-sources)). Repositories are checked out directly into this directory with `.repo` at the root.
+Maven Support & Care Tools - an automation toolkit for managing, building, and analyzing the Apache Maven multi-repository ecosystem. Uses the `repo` tool to manage 100+ Apache Maven repositories (manifest hosted at [maven-sources](https://github.com/apache/maven-sources)). Repositories are checked out into the `./maven` directory (a symlink to external storage) with `.repo` at `maven/.repo`.
 
 ## Prerequisites
 
@@ -20,11 +20,11 @@ Maven Support & Care Tools - an automation toolkit for managing, building, and a
 # Initialize and sync repositories from maven-sources manifest
 ./bin/repo-start
 
-# Execute command across all repos
-repo forall -c "${PWD}/bin/gh-subscribe"
+# Execute command across all repos (from maven/ directory)
+cd maven && repo forall -c "${PWD}/../bin/gh-subscribe"
 
 # Execute on subset (by group)
-repo forall -r 'core' -c "${PWD}/bin/some-script"
+cd maven && repo forall -r 'core' -c "${PWD}/../bin/some-script"
 ```
 
 ### Building Projects
@@ -77,7 +77,8 @@ USE_DEVELOCITY=true ./bin/run-maven clean install
 
 | Variable | Description | Default |
 |----------|-------------|---------|
-| `PROJECTS` | Space-separated list of project paths | Contents of `.repo/project.list` |
+| `MAVEN_PROJECTS_DIR` | Directory containing Maven project checkouts | `maven` |
+| `PROJECTS` | Space-separated list of project paths | Contents of `${MAVEN_PROJECTS_DIR}/.repo/project.list` |
 | `USE_DEVELOCITY` | Enable Develocity build scans | `false` |
 | `FAIL_FAST` | Exit on first build failure | `false` |
 | `PREVIEW_LOGLINES` | Lines of log to show on failure | `0` |

bin/common-functions.sh

@@ -14,7 +14,8 @@
 # INPUT VARIABLES
 #   - dir: (Required, injected by caller) The directory path injected by the caller. This is used to determine the root directory.
 #   - ONLY_MAVEN: (Optional) If set to true (default), only Maven-based projects will be processed.
-#   - PROJECTS: (Optional) Space-separated list of projects to process, defaulting to the contents of `.repo/project.list`.
+#   - MAVEN_PROJECTS_DIR: (Optional) Directory containing Maven project checkouts, defaults to `maven`.
+#   - PROJECTS: (Optional) Space-separated list of projects to process, defaulting to the contents of `${MAVEN_PROJECTS_DIR}/.repo/project.list`.
 #   - PREVIEW_LOGLINES: (Optional) Number of log lines to preview in case of a build failure.
 #   - FAIL_FAST: (Optional) If set to true, the script will exit immediately upon a build failure.
 #
@@ -38,15 +39,22 @@
 #
 
 : "${ONLY_MAVEN:=true}"
+: "${MAVEN_PROJECTS_DIR:=maven}"
 : "${SETTINGS:=${PWD}/settings.xml}"
 
 # shellcheck disable=SC2034 disable=SC2154
-# root is used in other scripts, dir is injeted by the caller
+# root is used in other scripts, dir is injected by the caller
 root=$(readlink -f "${dir}/..")
-[[ -z "${PROJECTS:-}" ]] && PROJECTS="$(cat ${root}/.repo/project.list)"
+[[ -z "${PROJECTS:-}" ]] && PROJECTS="$(cat ${root}/${MAVEN_PROJECTS_DIR}/.repo/project.list)"
 noof_projects=$(echo "${PROJECTS}" | wc -w | sed -e 's/ //g')
 counter=0
 
+# Only set maven.repo.local if not already configured in MAVEN_OPTS
+MAVEN_REPO_LOCAL_OPT=""
+if [[ ! "${MAVEN_OPTS:-}" =~ maven.repo.local ]]; then
+  MAVEN_REPO_LOCAL_OPT="-Dmaven.repo.local=${root}/.m2/repository"
+fi
+
 exec_mvn() {
   project=$1
   shift
@@ -58,36 +66,39 @@ exec_mvn() {
   shift
   goals=${*}
 
-  if ! test -r "${project}/pom.xml" && eval "${ONLY_MAVEN}"; then
+  # Full path to project directory (under MAVEN_PROJECTS_DIR)
+  project_dir="${root}/${MAVEN_PROJECTS_DIR}/${project}"
+
+  if ! test -r "${project_dir}/pom.xml" && eval "${ONLY_MAVEN}"; then
     echo "${project} is not a Maven project (${counter}/${noof_projects})"
     return
   fi
 
-  test ! -d "${project}" && echo "${project} does not exist" >&2 && return
-  mkdir -p "logs/${project}"
+  test ! -d "${project_dir}" && echo "${project} does not exist" >&2 && return
+  mkdir -p "${root}/logs/${project}"
   ext=""
   case "${project}" in
   "core/maven")
     ext=" (no extension)"
     ;;
   *)
-    mkdir -p "${project}/.mvn"
-    ln -f develocity/*.xml "${project}/.mvn"
+    mkdir -p "${project_dir}/.mvn"
+    ln -f "${root}/develocity"/*.xml "${project_dir}/.mvn"
     ;;
   esac
 
   mvn="mvn"
   with="with"
-  if test -r "${project}/mvnw"; then
+  if test -r "${project_dir}/mvnw"; then
     mvn="./mvnw"
   else
     with="without"
   fi
-  logs="logs/${project}/${task}-$$-${counter}.log"
+  logs="${root}/logs/${project}/${task}-$$-${counter}.log"
   echo -n "${project} (${counter}/${noof_projects}), a Maven project ${with} wrapper, build (logs: '${logs}') "
   set +e
   (
-    cd "${project}"
+    cd "${project_dir}"
     # shellcheck disable=SC2086
     ${mvn} -B -s "${SETTINGS}" ${opts} ${goals} 2>&1
   ) > "${logs}"

bin/repo-checkout-specific-branches

@@ -3,6 +3,10 @@
 set -eu -o pipefail
 
 : "${BRANCH:=$(git branch --show-current)}"
+: "${MAVEN_PROJECTS_DIR:=maven}"
+
+# Change to maven projects directory
+cd "${MAVEN_PROJECTS_DIR}"
 
 # THIS IS REALLY A UGLY HACK - DO NOT USE IT IN PRODUCTION - ITS JUST A SHOWCASE
 declare -A branches

bin/repo-start

@@ -5,6 +5,10 @@ set -eu -o pipefail
 : "${GITHUB_ORGANIZATION:=unknown}"
 : "${WORKING_BRANCH:=master}"
 : "${BRANCH:=$(git branch --show-current)}"
+: "${MAVEN_PROJECTS_DIR:=maven}"
+
+# Change to maven projects directory
+cd "${MAVEN_PROJECTS_DIR}"
 
 # Use latest repo if available
 PATH=".repo/repo:${PATH}"

bin/run-jqa

@@ -116,7 +116,7 @@ jqa_common_opts() {
   local extension="${1:-}"
   echo "
     ${MVN_OPTS:-}
-    -Dmaven.repo.local=${root}/.m2/repository
+    ${MAVEN_REPO_LOCAL_OPT}
     -Djqassistant.maven.reuse-store=false
     -Djqassistant.store.uri=${store_uri}
     -Djqassistant.configuration.locations=${root}/.jqassistant${extension}.yml

bin/run-maven

@@ -39,7 +39,7 @@ fi
 dir=$(dirname "${0}")
 source "${dir}/common-functions.sh"
 
-opts="-Dmaven.repo.local=${root}/.m2/repository"
+opts="${MAVEN_REPO_LOCAL_OPT}"
 
 goals="${*}"