Resolve libmeos for the BerlinMOD runners through the repo lib via LD_LIBRARY_PATH

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,14 @@
+<!--
+👀 Reviewers: this project's tier ranking, dependency chains and the
+standards checklist live in:
+  doc/contributing/reviewer-guide.md
+PR authors: update that file in the same commit as any PR queue change.
+-->
+
+## Summary
+
+<!-- What this PR does, in 1–3 bullets. Focus on the "why". -->
+
+## Test plan
+
+<!-- - [ ] Bullet checklist of TODOs for verifying this PR -->

.github/workflows/maven.yml

@@ -0,0 +1,115 @@
+name: Maven CI
+
+on:
+  push:
+    branches: ["main", "feat/**", "fix/**"]
+    paths-ignore:
+      - "**/*.md"
+      - "doc/**"
+  pull_request:
+    branches: ["main", "feat/**", "fix/**"]
+    paths-ignore:
+      - "**/*.md"
+      - "doc/**"
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Build and test (Java 21 / Spark 3.5)
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Java 21
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: "21"
+          cache: maven
+
+      - name: Install libmeos runtime dependencies
+        run: |
+          sudo apt-get update -qq
+          # proj-data + libh3-1 are required by the th3index libmeos.so:
+          # libmeos NEEDs libh3.so.1, and geodetic transforms need PROJ data.
+          sudo apt-get install -y libjson-c5 libgeos-c1t64 libproj25 proj-data libgsl27 libh3-1
+
+      - name: Set up libmeos.so and LD_LIBRARY_PATH
+        run: |
+          mkdir -p /tmp/libmeos
+          cp "$GITHUB_WORKSPACE/lib/libmeos.so" /tmp/libmeos/libmeos.so
+          echo "LD_LIBRARY_PATH=/tmp/libmeos" >> "$GITHUB_ENV"
+
+      - name: Provide the MEOS spatial_ref_sys table
+        run: |
+          # libmeos resolves SRID metadata (geodetic recognition for
+          # tgeogpoint, transforms) from its built-in default path
+          # /usr/local/share/spatial_ref_sys.csv. The vendored .so ships
+          # without that data file, so geography input fails with
+          # MEOS_ERR_INVALID_ARG. Fetch the canonical table to the default
+          # path, as a runtime data dependency rather than a vendored blob.
+          sudo mkdir -p /usr/local/share
+          sudo curl -fsSL \
+            https://raw.githubusercontent.com/MobilityDB/MobilityDB/master/meos/src/geo/spatial_ref_sys.csv \
+            -o /usr/local/share/spatial_ref_sys.csv
+          test -s /usr/local/share/spatial_ref_sys.csv
+
+      - name: Install JMEOS 1.4 to local Maven repository
+        run: |
+          mvn install:install-file \
+            -Dfile=libs/JMEOS-1.4.jar \
+            -DgroupId=org.jmeos \
+            -DartifactId=jmeos \
+            -Dversion=1.4 \
+            -Dpackaging=jar \
+            -q
+
+      - name: License header check
+        run: bash tools/scripts/check_license.sh
+
+      - name: Compile
+        run: mvn -B compile
+
+      - name: Verify optional-family flags exclude their packages
+        run: |
+          mvn -B clean compile -DCBUFFER=OFF -DNPOINT=OFF -DPOSE=OFF -DRGEO=OFF -DH3=OFF
+          for f in cbuffer npoint pose rgeo h3; do
+            if [ -d "target/classes/org/mobilitydb/spark/$f" ]; then
+              echo "ERROR: $f package compiled despite -D${f^^}=OFF"; exit 1
+            fi
+          done
+          mvn -B clean compile
+
+      - name: Unit tests
+        run: mvn -B test
+
+      - name: Portable bare-name parity gate (RFC #920 — 29/29, 0 unbacked)
+        run: python3 scripts/portable_parity.py --mspark .
+
+      - name: Native crash diagnostics
+        if: failure()
+        run: |
+          echo "===== JVM fatal error logs ====="
+          find . -name 'hs_err_pid*.log' -print -exec cat {} \; 2>/dev/null || true
+          echo "===== surefire dump streams ====="
+          for f in $(find . -path '*/surefire-reports/*' \( -name '*.dump' -o -name '*.dumpstream' -o -name '*-jvmRun*.dump' \) 2>/dev/null); do
+            echo "----- $f -----"; cat "$f" 2>/dev/null || true
+          done
+          echo "===== surefire reports + test stdout ====="
+          for f in $(find target/surefire-reports -name '*.txt' 2>/dev/null); do
+            echo "----- $f -----"; cat "$f" 2>/dev/null || true
+          done
+
+      - name: Package (fat jar)
+        run: mvn -B package -DskipTests
+
+      - name: Upload fat jar
+        uses: actions/upload-artifact@v4
+        with:
+          name: mobilityspark-spark.jar
+          path: target/*-spark.jar

.gitignore

@@ -3,14 +3,24 @@
 .project
 .settings/
 
-# Intellij
+# IntelliJ IDEA
 .idea/
 *.iml
 *.iws
+*.ipr
 
-# Mac
+# macOS
 .DS_Store
+**/.DS_Store
 
 # Maven
 log/
 target/
+
+# Large BerlinMOD benchmark data (generated locally — too large for GitHub)
+berlinmod/data/trips.csv
+dependency-reduced-pom.xml
+hs_err_pid*.log
+
+# Isolated per-worktree Maven repo (build-local, never shipped)
+.m2-uni/

.m2-acc/aopalliance/aopalliance/1.0/_remote.repositories

@@ -0,0 +1,3 @@
+#NOTE: This is a Maven Resolver internal implementation file, its format can be changed without prior notice.
+#Fri May 29 12:58:16 CEST 2026
+aopalliance-1.0.pom>central=

.m2-acc/aopalliance/aopalliance/1.0/aopalliance-1.0.pom

@@ -0,0 +1,15 @@
+<project>
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>aopalliance</groupId>
+  <artifactId>aopalliance</artifactId>
+  <name>AOP alliance</name>
+  <version>1.0</version>
+  <description>AOP Alliance</description>
+  <url>http://aopalliance.sourceforge.net</url> 
+
+  <licenses>
+    <license>
+      <name>Public Domain</name>
+    </license>
+  </licenses>
+</project>

.m2-acc/aopalliance/aopalliance/1.0/aopalliance-1.0.pom.sha1

@@ -0,0 +1 @@
+5128a2b0efbba460a1178d07773618e0986ea152  aopalliance-1.0.pom

.m2-acc/classworlds/classworlds/1.1-alpha-2/_remote.repositories

@@ -0,0 +1,4 @@
+#NOTE: This is a Maven Resolver internal implementation file, its format can be changed without prior notice.
+#Fri May 29 12:56:21 CEST 2026
+classworlds-1.1-alpha-2.jar>central=
+classworlds-1.1-alpha-2.pom>central=

.m2-acc/classworlds/classworlds/1.1-alpha-2/classworlds-1.1-alpha-2.jar.sha1

@@ -0,0 +1 @@
+05adf2e681c57d7f48038b602f3ca2254ee82d47

.m2-acc/classworlds/classworlds/1.1-alpha-2/classworlds-1.1-alpha-2.pom

@@ -0,0 +1,95 @@
+<project>
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>classworlds</groupId>
+  <artifactId>classworlds</artifactId>
+  <name>classworlds</name>
+  <version>1.1-alpha-2</version>
+  <description></description>
+  <url>http://classworlds.codehaus.org/</url>
+  <ciManagement>
+    <notifiers>
+      <notifier>
+        <address>classworlds-scm@lists.codehaus.org</address>
+      </notifier>
+    </notifiers>
+  </ciManagement>
+  <inceptionYear>2002</inceptionYear>
+  <mailingLists>
+    <mailingList>
+      <name>classworlds users</name>
+      <subscribe>http://lists.codehaus.org/mailman/listinfo/classworlds-user</subscribe>
+      <unsubscribe>http://lists.codehaus.org/mailman/listinfo/classworlds-user</unsubscribe>
+      <archive>http://lists.codehaus.org/pipermail/classworlds-user/</archive>
+    </mailingList>
+    <mailingList>
+      <name>classworlds developers</name>
+      <subscribe>http://lists.codehaus.org/mailman/listinfo/classworlds-dev</subscribe>
+      <unsubscribe>http://lists.codehaus.org/mailman/listinfo/classworlds-dev</unsubscribe>
+      <archive>http://lists.codehaus.org/pipermail/classworlds-dev/</archive>
+    </mailingList>
+    <mailingList>
+      <name>classworlds commit messages</name>
+      <subscribe>http://lists.codehaus.org/mailman/listinfo/classworlds-scm</subscribe>
+      <unsubscribe>http://lists.codehaus.org/mailman/listinfo/classworlds-scm</unsubscribe>
+      <archive>http://lists.codehaus.org/pipermail/classworlds-scm/</archive>
+    </mailingList>
+  </mailingLists>
+  <developers>
+    <developer>
+      <id>bob</id>
+      <name>bob mcwhirter</name>
+      <email>bob@werken.com</email>
+      <organization>The Werken Company</organization>
+      <roles>
+        <role>Founder</role>
+      </roles>
+    </developer>
+    <developer>
+      <id>jvanzyl</id>
+      <name>Jason van Zyl</name>
+      <email>jason@zenplex.com</email>
+      <organization>Zenplex</organization>
+      <roles>
+        <role>Developer</role>
+      </roles>
+    </developer>
+    <developer>
+      <id>bwalding</id>
+      <name>Ben Walding</name>
+      <email>ben@walding.com</email>
+      <organization>Walding Consulting Services</organization>
+      <roles>
+        <role>Developer</role>
+      </roles>
+    </developer>
+  </developers>
+  <scm>
+    <connection>scm:cvs:pserver:anonymous@cvs.codehaus.org:/scm/cvspublic/:classworlds</connection>
+    <url>http://cvs.classworlds.codehaus.org/</url>
+  </scm>
+  <organization>
+    <name>The Codehaus</name>
+    <url>http://codehaus.org/</url>
+  </organization>
+  <build>
+    <sourceDirectory>src/java/main</sourceDirectory>
+    <testSourceDirectory>src/java/test</testSourceDirectory>
+    <plugins>
+      <plugin>
+        <artifactId>maven-surefire-plugin</artifactId>
+        <configuration>
+          <includes>
+            <include>**/*Test.java</include>
+          </includes>
+        </configuration>
+      </plugin>
+    </plugins>
+  </build>
+  <distributionManagement>
+    <site>
+      <id>default</id>
+      <name>Default Site</name>
+      <url>scp://classworlds.codehaus.org//www/classworlds.codehaus.org</url>
+    </site>
+  </distributionManagement>
+</project>

.m2-acc/classworlds/classworlds/1.1-alpha-2/classworlds-1.1-alpha-2.pom.sha1

@@ -0,0 +1 @@
+8c8ad6a96a8c1168f8b12ec8a227b8261b160b26  /home/projects/maven/repository-staging/to-ibiblio/maven2/classworlds/classworlds/1.1-alpha-2/classworlds-1.1-alpha-2.pom

.m2-acc/classworlds/classworlds/1.1/_remote.repositories

@@ -0,0 +1,4 @@
+#NOTE: This is a Maven Resolver internal implementation file, its format can be changed without prior notice.
+#Fri May 29 12:57:03 CEST 2026
+classworlds-1.1.jar>central=
+classworlds-1.1.pom>central=

.m2-acc/classworlds/classworlds/1.1/classworlds-1.1.jar.sha1

@@ -0,0 +1 @@
+60c708f55deeb7c5dfce8a7886ef09cbc1388eca

.m2-acc/classworlds/classworlds/1.1/classworlds-1.1.pom

@@ -0,0 +1,98 @@
+<project>
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>classworlds</groupId>
+  <artifactId>classworlds</artifactId>
+  <name>classworlds</name>
+  <version>1.1</version>
+  <description></description>
+  <url>http://classworlds.codehaus.org/</url>
+  <ciManagement>
+    <notifiers>
+      <notifier>
+        <configuration>
+          <address>classworlds-scm@lists.codehaus.org</address>
+        </configuration>
+      </notifier>
+    </notifiers>
+  </ciManagement>
+  <inceptionYear>2002</inceptionYear>
+  <mailingLists>
+    <mailingList>
+      <name>classworlds users</name>
+      <subscribe>http://lists.codehaus.org/mailman/listinfo/classworlds-user</subscribe>
+      <unsubscribe>http://lists.codehaus.org/mailman/listinfo/classworlds-user</unsubscribe>
+      <archive>http://lists.codehaus.org/pipermail/classworlds-user/</archive>
+    </mailingList>
+    <mailingList>
+      <name>classworlds developers</name>
+      <subscribe>http://lists.codehaus.org/mailman/listinfo/classworlds-dev</subscribe>
+      <unsubscribe>http://lists.codehaus.org/mailman/listinfo/classworlds-dev</unsubscribe>
+      <archive>http://lists.codehaus.org/pipermail/classworlds-dev/</archive>
+    </mailingList>
+    <mailingList>
+      <name>classworlds commit messages</name>
+      <subscribe>http://lists.codehaus.org/mailman/listinfo/classworlds-scm</subscribe>
+      <unsubscribe>http://lists.codehaus.org/mailman/listinfo/classworlds-scm</unsubscribe>
+      <archive>http://lists.codehaus.org/pipermail/classworlds-scm/</archive>
+    </mailingList>
+  </mailingLists>
+  <developers>
+    <developer>
+      <id>bob</id>
+      <name>bob mcwhirter</name>
+      <email>bob@werken.com</email>
+      <organization>The Werken Company</organization>
+      <roles>
+        <role>Founder</role>
+      </roles>
+    </developer>
+    <developer>
+      <id>jvanzyl</id>
+      <name>Jason van Zyl</name>
+      <email>jason@zenplex.com</email>
+      <organization>Zenplex</organization>
+      <roles>
+        <role>Developer</role>
+      </roles>
+    </developer>
+    <developer>
+      <id>bwalding</id>
+      <name>Ben Walding</name>
+      <email>ben@walding.com</email>
+      <organization>Walding Consulting Services</organization>
+      <roles>
+        <role>Developer</role>
+      </roles>
+    </developer>
+  </developers>
+  <scm>
+    <connection>scm:cvs:pserver:anonymous@cvs.classworlds.codehaus.org:/home/projects/classworlds/scm/:classworlds</connection>
+    <developerConnection>scm:cvs:ext:brett@cvs.classworlds.codehaus.org:/home/projects/classworlds/scm/:classworlds</developerConnection>
+    <url>http://cvs.classworlds.codehaus.org/</url>
+  </scm>
+  <organization>
+    <name>The Codehaus</name>
+    <url>http://codehaus.org/</url>
+  </organization>
+  <build>
+    <sourceDirectory>src/java/main</sourceDirectory>
+    <testSourceDirectory>src/java/test</testSourceDirectory>
+    <plugins>
+      <plugin>
+        <artifactId>surefire</artifactId>
+        <configuration>
+          <includes>
+            <include>**/*Test.java</include>
+          </includes>
+        </configuration>
+      </plugin>
+    </plugins>
+  </build>
+  <distributionManagement>
+    <site>
+      <id>default</id>
+      <name>Default Site</name>
+      <url>scp://classworlds.codehaus.org//www/classworlds.codehaus.org</url>
+    </site>
+  </distributionManagement>
+</project>

.m2-acc/classworlds/classworlds/1.1/classworlds-1.1.pom.sha1

@@ -0,0 +1 @@
+4703c4199028094698c222c17afea6dcd9f04999