Build Wanaku Semantic Router

This page describes how to build and package WSR from source, and how to apply the code formatting.

Build and package

Use Java 21 or later and Maven 3.9 or later.

The build gets the Wanaku Capabilities Java SDK release from Maven Central.

mvn -B -ntp clean verify

To build against an unreleased SDK, install the SDK into your local Maven repository first. Then set wanaku-capabilities-sdk.version in pom.xml to the SDK version that you installed.

The build creates target/wanaku-semantic-router-0.3.0-SNAPSHOT.jar and target/lib/. Keep the JAR and the library directory together. The JAR manifest contains the library paths. The tests use a local HTTP provider fixture. They do not need paid inference or backend services.

The runtime uses Camel 4.23.0 artifacts, which contain PR #27494. Republish catalogs using semantic.evaluation; old semantic.question YAML is incompatible. Migrate Barn preview clients to the new request and response contract before deployment. The Camel BOM manages all Camel dependency versions. Preserve the complete packaged distribution or container image digest to reproduce a deployment.

Format the code

The build applies the CIC Spotless rules during compilation. It uses Palantir Java Format and explicit imports. Use braces for control blocks. Apply formatting before you submit changes. Check committed formatting before you build a release.

mvn -B -ntp spotless:apply
mvn -B -ntp spotless:check

Next steps

• Test Wanaku Semantic Router: the test suites that need more than a Maven build.
• Run a route from local files: start the JAR that you built.