Publish models-router

CHANGELOG.md

@@ -17,6 +17,16 @@ All notable changes to models are documented here.
   separately at 1e-3: cosine is scale-invariant, so a runtime that skips L2
   normalization agrees with a normalized reference at exactly 1.0.
 
+## [0.3.2] - 2026-08-08
+
+### Added
+
+- `models-router` is now published. It was absent from the release allowlist, so
+  every version until now built it and shipped it nowhere: the pretrained task
+  classifier, the packaged index, `ModelRouter.discoverLocal()` and the catalog
+  discovery added in 0.3.1 were all unreachable from a dependency. The catalog
+  SPI itself was never affected, since it lives in the published `models-api`.
+
 ## [0.3.1] - 2026-08-08
 
 ### Added

README.md

@@ -139,16 +139,16 @@ directly:
 
 ```kotlin
 dependencies {
-    implementation("com.integrallis:models:0.3.1")
-    implementation("com.integrallis:backend-java:0.3.1") // or backend-native
+    implementation("com.integrallis:models:0.3.2")
+    implementation("com.integrallis:backend-java:0.3.2") // or backend-native
 }
 ```
 
 Use Apple's on-device system model on a supported Apple Silicon Mac:
 
 ```kotlin
 dependencies {
-    implementation("com.integrallis:backend-apple:0.3.1")
+    implementation("com.integrallis:backend-apple:0.3.2")
 }
 ```
 

RELEASING.md

@@ -7,8 +7,8 @@ the GitHub release.
 The publication allowlist contains `models-api`, `models-runtime`, `models`,
 `models-rag`, `models-semantic-order`, `backend-java`, `backend-native`,
 `backend-apple`, `models-langchain4j`, `models-spring-ai`,
-`models-spring-boot-starter`, and `models-embedding`. Benchmark applications,
-documentation tooling, and modules containing only package scaffolding are not
+`models-spring-boot-starter`, `models-embedding`, and `models-router`. Benchmark
+applications, documentation tooling, and modules containing only package scaffolding are not
 published.
 
 ## Cut a release

backend-native/src/main/rust/model-kernels/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "jmodels-kernels"
-version = "0.3.1"
+version = "0.3.2"
 edition = "2024"
 license = "Apache-2.0"
 publish = false

build.gradle.kts

@@ -56,7 +56,8 @@ val publishedModuleNames =
         "models-langchain4j",
         "models-spring-ai",
         "models-spring-boot-starter",
-        "models-embedding"
+        "models-embedding",
+        "models-router"
     )
 val publishedProjects = libraryProjects.filter { it.name in publishedModuleNames }
 val scaffoldProjects = libraryProjects.filterNot { it.name in publishedModuleNames }

docs/content/antora.yml

@@ -1,7 +1,7 @@
 name: models
 title: Models
 version: 'current'
-display_version: '0.3.1'
+display_version: '0.3.2'
 prerelease: false
 start_page: ROOT:index.adoc
 nav:
@@ -10,7 +10,7 @@ asciidoc:
   attributes:
     source-language: java
     source-highlighter: highlight.js
-    models-version: '0.3.1'
+    models-version: '0.3.2'
     modeljars-version: '0.1.2'
     vectors-version: '0.1.7'
     url-models-github: https://github.com/integrallis/models

docs/content/modules/ROOT/pages/index.adoc

@@ -118,6 +118,9 @@ image::models-0001.png[Models runtime architecture,align=center]
 
 |`models-embedding`
 |Optional Models-to-Vectors storage and semantic-cache bridge
+
+|`models-router`
+|Model selection across local and hosted models, with a pretrained task classifier
 |===
 
 Start with xref:using-models.adoc[Using Models], then select an exact

docs/landing/index.html

@@ -36,7 +36,7 @@
                 <a href="https://integrallis.com" class="brand-mark" aria-label="Integrallis"><img class="ilogo" src="assets/images/integrallis-logo.png" alt="Integrallis"></a>
                 <span class="sep">/</span>
                 <a href="#top" class="product">models</a>
-                <a href="https://github.com/integrallis/models/releases" class="version-pill" title="Release notes">v0.3.1</a>
+                <a href="https://github.com/integrallis/models/releases" class="version-pill" title="Release notes">v0.3.2</a>
             </div>
             <div class="nav-right">
                 <div class="nav-links">
@@ -182,7 +182,7 @@ <h2 class="section-title">Use Apple Intelligence from the JVM</h2>
                     </div>
                     <div class="apple-example reveal">
                         <div class="code-title">// Add the Apple backend</div>
-                        <pre><code>implementation("com.integrallis:backend-apple:0.3.1")</code></pre>
+                        <pre><code>implementation("com.integrallis:backend-apple:0.3.2")</code></pre>
                         <div class="code-title">// Check availability, then generate locally</div>
                         <pre><code class="language-java hljs" data-lang="java">try (var client = AppleFoundationModels.create()) {
     var status = client.availability();

docs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "models-docs",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "private": true,
   "description": "Documentation for Models",
   "dependencies": {

gradle.properties

@@ -1,2 +1,2 @@
-version = 0.3.1
+version = 0.3.2
 vectorsVersion = 0.1.7

models-backend-apple/README.md

@@ -5,7 +5,7 @@
 Java FFM bridge to Apple's on-device Foundation Models runtime.
 
 ```kotlin
-implementation("com.integrallis:backend-apple:0.3.1")
+implementation("com.integrallis:backend-apple:0.3.2")
 ```
 
 This module is intentionally separate from `backend-java`. The core

models-rag/README.md

@@ -8,7 +8,7 @@ generation, then enforces source attribution, abstention, and extractive fallbac
 on the generated answer.
 
 ```kotlin
-implementation("com.integrallis:models-rag:0.3.1")
+implementation("com.integrallis:models-rag:0.3.2")
 ```
 
 ```java

notebooks/.env.example

@@ -1,4 +1,4 @@
 MODELS_NOTEBOOK_MODE=source
-MODELS_VERSION=0.3.1
+MODELS_VERSION=0.3.2
 MODELS_NOTEBOOK_REPOSITORY=
 MODELS_NOTEBOOK_PREPARE=true

notebooks/README.md

@@ -27,7 +27,7 @@ Prepare either classpath without Docker:
 ./gradlew prepareNotebookClasspath -PnotebookMode=source
 ./gradlew prepareNotebookClasspath \
   -PnotebookMode=release \
-  -PnotebookVersion=0.3.1
+  -PnotebookVersion=0.3.2
 ```
 
 Test a staged release before it reaches Maven Central:
@@ -36,7 +36,7 @@ Test a staged release before it reaches Maven Central:
 ./gradlew verifyStagedPublications
 ./gradlew prepareNotebookClasspath \
   -PnotebookMode=release \
-  -PnotebookVersion=0.3.1 \
+  -PnotebookVersion=0.3.2 \
   -PnotebookRepository=build/staging-deploy
 ```
 
@@ -55,7 +55,7 @@ and does not read the host Docker credential store. To use published artifacts:
 
 ```bash
 MODELS_NOTEBOOK_MODE=release \
-MODELS_VERSION=0.3.1 \
+MODELS_VERSION=0.3.2 \
 ./docker-compose.sh up --build
 ```
 
@@ -75,7 +75,7 @@ Release mode executes the same notebooks from the selected artifacts:
 
 ```bash
 MODELS_NOTEBOOK_MODE=release \
-MODELS_VERSION=0.3.1 \
+MODELS_VERSION=0.3.2 \
 ./docker-compose.sh run --rm --no-deps jupyter \
   bash /home/jovyan/work/models/notebooks/scripts/test-notebooks.sh
 ```

notebooks/docker-compose.yml

@@ -12,7 +12,7 @@ services:
       - models-notebook-gradle-cache:/home/jovyan/.gradle
     environment:
       - MODELS_NOTEBOOK_MODE=${MODELS_NOTEBOOK_MODE:-source}
-      - MODELS_VERSION=${MODELS_VERSION:-0.3.1}
+      - MODELS_VERSION=${MODELS_VERSION:-0.3.2}
       - MODELS_NOTEBOOK_REPOSITORY=${MODELS_NOTEBOOK_REPOSITORY:-}
       - MODELS_NOTEBOOK_PREPARE=${MODELS_NOTEBOOK_PREPARE:-true}
       - JUPYTER_ENABLE_LAB=yes

notebooks/jupyter/prepare-classpath.sh

@@ -6,7 +6,7 @@ fi
 
 repository=/home/jovyan/work/models
 mode=${MODELS_NOTEBOOK_MODE:-source}
-version=${MODELS_VERSION:-0.3.1}
+version=${MODELS_VERSION:-0.3.2}
 repository_url=${MODELS_NOTEBOOK_REPOSITORY:-}
 
 case "$mode" in