build(conference-scheduling): lint OpenAPI spec with vacuum in CI

Moves the vacuum lint out of the maven build into a dedicated GitHub
workflow, following vacuum's documented CI/CD setup. The workflow lints
the committed spec of every model shipping a .vacuum-ruleset.yaml, so
future converted models are covered automatically. The generated
src/build/openapi.json is now committed (force-added past the root
.gitignore's "build" pattern) to keep the lint standalone and make spec
drift visible in diffs.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Qae2bExuXdkKjDJjFXynGi

Author: larsbeck

.github/workflows/lint_openapi.yml

@@ -0,0 +1,49 @@
+name: OpenAPI Lint
+
+on:
+  push:
+    branches: [stable, development, '*.x']
+    paths:
+      - 'use-cases/**'
+      - '.github/workflows/lint_openapi.yml'
+  pull_request:
+    branches: [stable, development, '*.x']
+    paths:
+      - 'use-cases/**'
+      - '.github/workflows/lint_openapi.yml'
+
+jobs:
+  vacuum:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout timefold-quickstarts
+        uses: actions/checkout@v7
+
+      # The GitHub token prevents intermittent installation failures caused by
+      # API rate limiting. It only accesses public repository information.
+      - name: Install vacuum
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: curl -fsSL https://quobix.com/scripts/install_vacuum.sh | sh
+
+      # Lints the committed OpenAPI spec of every model that ships a vacuum ruleset.
+      - name: Lint OpenAPI specs
+        run: |
+          found=0
+          for ruleset in use-cases/*/.vacuum-ruleset.yaml; do
+            model_dir="$(dirname "$ruleset")"
+            spec="$model_dir/src/build/openapi.json"
+            if [ ! -f "$spec" ]; then
+              echo "::error::$model_dir has a vacuum ruleset but no committed spec at $spec"
+              exit 1
+            fi
+            found=1
+            echo "::group::vacuum lint $spec"
+            vacuum lint --ruleset "$ruleset" --details --fail-severity error "$spec"
+            echo "::endgroup::"
+          done
+          if [ "$found" -eq 0 ]; then
+            echo "::error::no .vacuum-ruleset.yaml found under use-cases/"
+            exit 1
+          fi

use-cases/conference-scheduling/pom.xml

@@ -17,8 +17,6 @@
     <revision>1.0.0-SNAPSHOT</revision>
     <error-prone.version>2.50.0</error-prone.version>
     <jacoco.version>0.8.15</jacoco.version>
-    <vacuum.version>0.29.9</vacuum.version>
-    <vacuum.binary.extension></vacuum.binary.extension>
     <maven.compiler.release>21</maven.compiler.release>
   </properties>
 
@@ -244,56 +242,8 @@
         </configuration>
       </plugin>
 
-      <!-- Vacuum is a native Go binary; the npm package is just one of its distribution channels.
-           Downloading the platform binary directly keeps node/npm out of the maven build. -->
-      <plugin>
-        <groupId>io.github.download-maven-plugin</groupId>
-        <artifactId>download-maven-plugin</artifactId>
-        <version>2.0.0</version>
-        <executions>
-          <execution>
-            <id>download-vacuum</id>
-            <phase>generate-resources</phase>
-            <goals>
-              <goal>wget</goal>
-            </goals>
-            <configuration>
-              <url>
-                https://github.com/daveshanley/vacuum/releases/download/v${vacuum.version}/vacuum_${vacuum.version}_${vacuum.os}_${vacuum.arch}.tar.gz</url>
-              <unpack>true</unpack>
-              <outputDirectory>${project.build.directory}/vacuum</outputDirectory>
-            </configuration>
-          </execution>
-        </executions>
-      </plugin>
-
-      <plugin>
-        <groupId>org.codehaus.mojo</groupId>
-        <artifactId>exec-maven-plugin</artifactId>
-        <version>3.6.3</version>
-        <executions>
-          <execution>
-            <id>lint-openapi-descriptions</id>
-            <phase>verify</phase>
-            <goals>
-              <goal>exec</goal>
-            </goals>
-            <configuration>
-              <executable>${project.build.directory}/vacuum/vacuum${vacuum.binary.extension}</executable>
-              <arguments>
-                <argument>lint</argument>
-                <argument>--ruleset</argument>
-                <argument>${project.basedir}/.vacuum-ruleset.yaml</argument>
-                <argument>--details</argument>
-                <argument>--fail-severity</argument>
-                <argument>error</argument>
-                <argument>${project.basedir}/src/build/openapi.json</argument>
-              </arguments>
-            </configuration>
-          </execution>
-        </executions>
-      </plugin>
-
+      <!-- Persists the generated OpenAPI spec so CI (see .github/workflows/lint_openapi.yml)
+           can lint it with vacuum without building the project. -->
       <plugin>
         <artifactId>maven-resources-plugin</artifactId>
         <version>3.5.0</version>
@@ -361,88 +311,5 @@
     </plugins>
   </build>
 
-  <!-- Selects the matching vacuum release binary (vacuum_<version>_<os>_<arch>.tar.gz). -->
-  <profiles>
-    <profile>
-      <id>vacuum-macos-aarch64</id>
-      <activation>
-        <os>
-          <family>mac</family>
-          <arch>aarch64</arch>
-        </os>
-      </activation>
-      <properties>
-        <vacuum.os>darwin</vacuum.os>
-        <vacuum.arch>arm64</vacuum.arch>
-      </properties>
-    </profile>
-    <profile>
-      <id>vacuum-macos-x86_64</id>
-      <activation>
-        <os>
-          <family>mac</family>
-          <arch>x86_64</arch>
-        </os>
-      </activation>
-      <properties>
-        <vacuum.os>darwin</vacuum.os>
-        <vacuum.arch>x86_64</vacuum.arch>
-      </properties>
-    </profile>
-    <profile>
-      <id>vacuum-linux-amd64</id>
-      <activation>
-        <os>
-          <name>Linux</name>
-          <arch>amd64</arch>
-        </os>
-      </activation>
-      <properties>
-        <vacuum.os>linux</vacuum.os>
-        <vacuum.arch>x86_64</vacuum.arch>
-      </properties>
-    </profile>
-    <profile>
-      <id>vacuum-linux-aarch64</id>
-      <activation>
-        <os>
-          <name>Linux</name>
-          <arch>aarch64</arch>
-        </os>
-      </activation>
-      <properties>
-        <vacuum.os>linux</vacuum.os>
-        <vacuum.arch>arm64</vacuum.arch>
-      </properties>
-    </profile>
-    <profile>
-      <id>vacuum-windows-amd64</id>
-      <activation>
-        <os>
-          <family>windows</family>
-          <arch>amd64</arch>
-        </os>
-      </activation>
-      <properties>
-        <vacuum.os>windows</vacuum.os>
-        <vacuum.arch>x86_64</vacuum.arch>
-        <vacuum.binary.extension>.exe</vacuum.binary.extension>
-      </properties>
-    </profile>
-    <profile>
-      <id>vacuum-windows-aarch64</id>
-      <activation>
-        <os>
-          <family>windows</family>
-          <arch>aarch64</arch>
-        </os>
-      </activation>
-      <properties>
-        <vacuum.os>windows</vacuum.os>
-        <vacuum.arch>arm64</vacuum.arch>
-        <vacuum.binary.extension>.exe</vacuum.binary.extension>
-      </properties>
-    </profile>
-  </profiles>
 
 </project>