.gitea/docker/Dockerfile.ci-cpp

@@ -10,6 +10,7 @@ RUN apt-get update -qq && \
     curl -fsSL https://deb.nodesource.com/setup_20.x | bash - && \
     apt-get install -y --no-install-recommends \
       nodejs \
+      doxygen \
       cmake \
       build-essential \
       git \

.gitea/workflows/cpp-tests.yml

@@ -63,7 +63,12 @@ jobs:
     runs-on: eulernest
     container:
       image: git.eulernest.eu/conformallab/ci-cpp:latest
-      options: "--memory=1400m --memory-swap=1400m"
+      # Memory bumped from 1400m → 1600m to avoid OOM during CGAL header
+      # compilation on ARM64 (CGAL + Eigen templates allocate ~700 MB per
+      # cc1plus instance; -j1 leaves a small margin).
+      # memory-swap == memory disables swap entirely so OOM fails fast
+      # rather than thrashing on the SD card.
+      options: "--memory=1600m --memory-swap=1600m"
 
     steps:
       - uses: actions/checkout@v4
@@ -72,7 +77,7 @@ jobs:
         run: cmake -S code -B build -DWITH_CGAL_TESTS=ON -DCMAKE_BUILD_TYPE=Release
 
       - name: Build CGAL-Tests
-        run: nice -n 19 cmake --build build --target conformallab_cgal_tests -j2
+        run: nice -n 19 cmake --build build --target conformallab_cgal_tests -j1
 
       - name: Run CGAL-Tests
         run: >

.gitea/workflows/doc-build.yaml

@@ -0,0 +1,50 @@
+name: API Docs
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Doc-build — informational only
+#
+# Generates Doxygen HTML from the public headers and uploads it as an
+# artifact for reviewer inspection.  Does NOT block merges:
+# `continue-on-error: true` ensures warnings or extraction issues never
+# fail the CI gate.  When Doxygen coverage is denser (Phase 8c), this job
+# can be promoted to a hard requirement and the artifact deployed to
+# Pages.
+# ─────────────────────────────────────────────────────────────────────────────
+jobs:
+  doc-build:
+    if: github.event_name == 'pull_request'
+    runs-on: eulernest
+    container:
+      image: git.eulernest.eu/conformallab/ci-cpp:latest
+    continue-on-error: true   # never block the merge
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Doxygen
+        run: apt-get update && apt-get install -y --no-install-recommends doxygen
+
+      - name: Generate API documentation
+        run: doxygen Doxyfile 2>&1 | tee doxygen.log
+
+      - name: Summarise warnings
+        if: always()
+        run: |
+          if [ -f doc/doxygen/doxygen-warnings.log ]; then
+            warn=$(wc -l < doc/doxygen/doxygen-warnings.log)
+            echo "DOC ▸ Doxygen warnings: $warn"
+            head -20 doc/doxygen/doxygen-warnings.log
+          fi
+
+      - name: Upload HTML as artifact
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: doxygen-html
+          path: doc/doxygen/html/
+          retention-days: 14