From 8e13c669f49c8e10f36143d5e23e6e4afc5377fa Mon Sep 17 00:00:00 2001 From: Per Nyfelt Date: Tue, 17 Nov 2026 22:30:51 +0100 Subject: [PATCH 1/2] Set the approved Phase 8.4 release tuple versions The owner approved the audited tuple 2026-11-17 (recorded in req/phase8-4-release-checklist.md). Per the Phase 8.4 plan's WP3, the release versions ride a separate reviewed PR: the candidate tag anchors at this change's main merge SHA and the release runs from a clean detached checkout of that tag. - Set the nine module versions -- jinja 0.6.2, tokenizer 0.1.2, vision 0.1.2, native-macos-arm64 0.1.0, ffi 0.5.0, core 0.5.0, models 0.1.0, spring-ai 0.1.0 and langchain4j 0.1.0 -- exactly the tuple in tools/release-smoke/released-8.4.json. - Move the smoke consumer's CI defaults to the same versions, the documented same-PR rule: CI mode resolves the defaults unstripped, so the consumer and the publishing producers agree. - Finalize the changelogs: dated 0.6.2 and 0.1.2 sections for jinja and tokenizer (no functional changes; .module and dependency differences only), core 0.5.0 and models 0.1.0 roll their Unreleased entries, and the two development-cycle status notes are dropped. - The selftest e2e preflight case now forces its failure with a JMLX_JINJA_VERSION override: the 8.4 preflight reads the actual build.gradle files, so a release-ready tree passes version validation on its own and would run the case past the preflight. - Refresh the coordinate references in the adapter READMEs and the hf-reference README's local jar names. --- jmlx-core/CHANGELOG.md | 4 +--- jmlx-core/build.gradle | 2 +- jmlx-ffi/build.gradle | 2 +- jmlx-jinja/CHANGELOG.md | 8 +++++++- jmlx-jinja/build.gradle | 2 +- jmlx-langchain4j/README.md | 4 ++-- jmlx-langchain4j/build.gradle | 2 +- jmlx-models/CHANGELOG.md | 4 +--- jmlx-models/build.gradle | 2 +- jmlx-native-macos-arm64/build.gradle | 2 +- jmlx-spring-ai/README.md | 4 ++-- jmlx-spring-ai/build.gradle | 2 +- jmlx-tokenizer/CHANGELOG.md | 9 +++++++++ jmlx-tokenizer/build.gradle | 2 +- jmlx-vision/build.gradle | 2 +- req/phase8-4-release-checklist.md | 15 +++++++++------ tools/hf-reference/README.md | 2 +- tools/release-smoke/gradle.properties | 18 +++++++++--------- tools/release-smoke/selftest.sh | 13 ++++++++----- 19 files changed, 58 insertions(+), 41 deletions(-) diff --git a/jmlx-core/CHANGELOG.md b/jmlx-core/CHANGELOG.md index daed4def..adc28e57 100644 --- a/jmlx-core/CHANGELOG.md +++ b/jmlx-core/CHANGELOG.md @@ -1,11 +1,9 @@ # Changelog -## Unreleased +## [0.5.0] - 2026-11-17 - Add key-only bidirectional masks, explicit-scale bidirectional/cross attention, pre/post-norm encoder blocks and request-owned, non-appending `StaticKVCache`. - Add scale constructor overloads while retaining existing default scales. - Add `MLXMemory.clearCache()`, which releases the Metal allocator's pooled device buffers back to the OS without affecting live arrays (wraps `mlx_clear_cache`). - -Native pins, generated bindings and versions are unchanged. diff --git a/jmlx-core/build.gradle b/jmlx-core/build.gradle index 7764e237..65f14624 100644 --- a/jmlx-core/build.gradle +++ b/jmlx-core/build.gradle @@ -6,7 +6,7 @@ plugins { // Own explicit line, independent of the root's 0.5.0-SNAPSHOT default going forward -- see // req/plans/native-artifact-packaging-plan.md. Same number it already carries via that default. -version = '0.5.0-SNAPSHOT' +version = '0.5.0' java { withSourcesJar() diff --git a/jmlx-ffi/build.gradle b/jmlx-ffi/build.gradle index 888f2410..c1edf913 100644 --- a/jmlx-ffi/build.gradle +++ b/jmlx-ffi/build.gradle @@ -6,7 +6,7 @@ plugins { // Own explicit line, independent of the root's 0.5.0-SNAPSHOT default going forward -- see // req/plans/native-artifact-packaging-plan.md. Same number it already carries via that default. -version = '0.5.0-SNAPSHOT' +version = '0.5.0' java { withSourcesJar() diff --git a/jmlx-jinja/CHANGELOG.md b/jmlx-jinja/CHANGELOG.md index a976f342..db5e850c 100644 --- a/jmlx-jinja/CHANGELOG.md +++ b/jmlx-jinja/CHANGELOG.md @@ -5,7 +5,13 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). -## [Unreleased] +## [0.6.2] - 2026-11-17 + +### Changed + +- No functional changes to the published `0.6.1`: the JAR and POM are byte-identical to the + `0.6.1` coordinate on Central. The `.module` metadata is now generated by Gradle 9.9.0 + (was 9.7.0) under the Phase 8.4 combined release toolchain. ## [0.6.1] - 2026-11-05 diff --git a/jmlx-jinja/build.gradle b/jmlx-jinja/build.gradle index 8dfdda2e..e1fc1919 100644 --- a/jmlx-jinja/build.gradle +++ b/jmlx-jinja/build.gradle @@ -6,7 +6,7 @@ plugins { // jmlx-jinja is a dependency-free Java 21 library; keep that promise even though // the rest of jmlx currently targets Java 25. It is versioned independently of the // other jmlx modules because it was migrated from the standalone hfjinja project. -version = '0.6.2-SNAPSHOT' +version = '0.6.2' java { toolchain { diff --git a/jmlx-langchain4j/README.md b/jmlx-langchain4j/README.md index 4571cd5a..6d98a3a1 100644 --- a/jmlx-langchain4j/README.md +++ b/jmlx-langchain4j/README.md @@ -1,7 +1,7 @@ # jmlx LangChain4j adapter -Java 25, LangChain4j 1.23.0, macOS on Apple Silicon. Development coordinate: -se.alipsa:jmlx-langchain4j:0.1.0-SNAPSHOT. Publication is planned for Phase 8.4. +Java 25, LangChain4j 1.23.0, macOS on Apple Silicon. Coordinate: +se.alipsa:jmlx-langchain4j:0.1.0. Publication is planned for Phase 8.4. The native runtime jar remains an explicit runtime dependency. Configure a shared SchedulerInferenceClient as in the diff --git a/jmlx-langchain4j/build.gradle b/jmlx-langchain4j/build.gradle index 93bf1266..9b49bbe4 100644 --- a/jmlx-langchain4j/build.gradle +++ b/jmlx-langchain4j/build.gradle @@ -3,7 +3,7 @@ plugins { id 'maven-publish' } -version = '0.1.0-SNAPSHOT' +version = '0.1.0' java { withSourcesJar() diff --git a/jmlx-models/CHANGELOG.md b/jmlx-models/CHANGELOG.md index ce359267..88056707 100644 --- a/jmlx-models/CHANGELOG.md +++ b/jmlx-models/CHANGELOG.md @@ -1,6 +1,6 @@ # Changelog -## Unreleased +## [0.1.0] - 2026-11-17 - Add the Phase 7.3b WP8 Tier-A acceptance suites: `Qwen3VlGoldenTest` (full float32, strict `1e-4`) and `Qwen3VlDefaultPrecisionTest` (default TF32 bound `0.0025`) run the pinned tiny @@ -79,5 +79,3 @@ non-null embedding hook), greedy generation and the batch scheduler, in both TF32 precision modes. The recordings under `build/exact-bits` are PR evidence, never committed goldens and never part of `check`. - -Versions are unchanged; implementation does not publish artifacts. diff --git a/jmlx-models/build.gradle b/jmlx-models/build.gradle index 26e8fb57..628e2417 100644 --- a/jmlx-models/build.gradle +++ b/jmlx-models/build.gradle @@ -6,7 +6,7 @@ plugins { // Fresh line -- jmlx-models has never been published, same reasoning jmlx-tokenizer used for its // own first version. Independent of the root's 0.5.0-SNAPSHOT and of jmlx-core/jmlx-ffi's own // (older, phase 1-4) version line -- see req/plans/native-artifact-packaging-plan.md. -version = '0.1.0-SNAPSHOT' +version = '0.1.0' java { withSourcesJar() diff --git a/jmlx-native-macos-arm64/build.gradle b/jmlx-native-macos-arm64/build.gradle index 70df3f8b..5801187b 100644 --- a/jmlx-native-macos-arm64/build.gradle +++ b/jmlx-native-macos-arm64/build.gradle @@ -8,7 +8,7 @@ plugins { // mlx-c commit) travels inside the jar as native-pin.properties instead of in this version string, // so this module's own SemVer stays independent of mlx-c's own independent versioning (already a // distinct axis per AGENTS.md). -version = '0.1.0-SNAPSHOT' +version = '0.1.0' // This module has a small Java metadata API alongside its native payload. Native resources are added // directly to the main jar below, rather than registered as source-set resources, so normal source diff --git a/jmlx-spring-ai/README.md b/jmlx-spring-ai/README.md index d2053c5c..b26bdd49 100644 --- a/jmlx-spring-ai/README.md +++ b/jmlx-spring-ai/README.md @@ -1,7 +1,7 @@ # jmlx Spring AI adapter -Java 25, Spring AI 2.0.2, macOS on Apple Silicon. Development coordinate: -se.alipsa:jmlx-spring-ai:0.1.0-SNAPSHOT. Publication is planned for Phase 8.4. +Java 25, Spring AI 2.0.2, macOS on Apple Silicon. Coordinate: +se.alipsa:jmlx-spring-ai:0.1.0. Publication is planned for Phase 8.4. The native runtime jar remains an explicit runtime dependency. Create one scheduler and one shared client for the application: diff --git a/jmlx-spring-ai/build.gradle b/jmlx-spring-ai/build.gradle index 83499c25..b9391876 100644 --- a/jmlx-spring-ai/build.gradle +++ b/jmlx-spring-ai/build.gradle @@ -3,7 +3,7 @@ plugins { id 'maven-publish' } -version = '0.1.0-SNAPSHOT' +version = '0.1.0' java { withSourcesJar() diff --git a/jmlx-tokenizer/CHANGELOG.md b/jmlx-tokenizer/CHANGELOG.md index 89151ffa..5950b5c8 100644 --- a/jmlx-tokenizer/CHANGELOG.md +++ b/jmlx-tokenizer/CHANGELOG.md @@ -1,5 +1,14 @@ # Changelog +## [0.1.2] - 2026-11-17 + +### Changed + +- No functional changes to the published `0.1.1`: the JAR is byte-identical to the `0.1.1` + coordinate on Central. The POM and module metadata now depend on `se.alipsa:jmlx-jinja:0.6.2` + (was 0.6.1) and Jackson 3.3.0 (was 3.1.2), and the `.module` is generated by Gradle 9.9.0 + (was 9.7.0) under the Phase 8.4 combined release toolchain. + ## [0.1.1] - 2026-11-05 ### Fixed diff --git a/jmlx-tokenizer/build.gradle b/jmlx-tokenizer/build.gradle index ea2311e0..3ffbf3c8 100644 --- a/jmlx-tokenizer/build.gradle +++ b/jmlx-tokenizer/build.gradle @@ -6,7 +6,7 @@ plugins { // Its own version line, deliberately independent of the root's 0.5.0-SNAPSHOT: an // "independent release" that inherits the root version is not independent at all. The line // started at 0.1.0 in Phase 8.1. -version = '0.1.2-SNAPSHOT' +version = '0.1.2' // Pure Java with no native dependency, so it is not bound to the root's Java 25 toolchain // (which exists for jmlx-core/jmlx-ffi's Panama FFM). Targeting 21 matches jmlx-jinja and diff --git a/jmlx-vision/build.gradle b/jmlx-vision/build.gradle index 5ea50149..abbc6fe5 100644 --- a/jmlx-vision/build.gradle +++ b/jmlx-vision/build.gradle @@ -6,7 +6,7 @@ plugins { // Its own version line, deliberately independent of the root's 0.5.0-SNAPSHOT: jmlx-vision's // line started at 0.1.0 in Phase 8.1 -- same reasoning jmlx-tokenizer used for its own first // version. -version = '0.1.2-SNAPSHOT' +version = '0.1.2' // Pure Java with no native dependency, so it is not bound to the root's Java 25 toolchain (which // exists for jmlx-core/jmlx-ffi's Panama FFM). Targeting 21 matches jmlx-jinja and diff --git a/req/phase8-4-release-checklist.md b/req/phase8-4-release-checklist.md index bc8c825e..c145042b 100644 --- a/req/phase8-4-release-checklist.md +++ b/req/phase8-4-release-checklist.md @@ -11,20 +11,21 @@ Baseline: `9bc85042df50ed3f979cb8d3e7c8767917c71483` (published 8.1 recovery). Implementation starts from PR #94 merge `679d525b43d33eba552af3e6c4f46d80ee6ec673`. The [post-plugin artifact audit](phase8-4-pure-java-audit.md) at PR #97 merge `98190d44fd725b484e98e5e8b7b41efa925e0b23` supports the committed all-new manifest. -Tuple review and exact-candidate minimum-host verification remain open; repeat the audit at -the final candidate SHA. +The owner approved the audited tuple 2026-11-17; exact-candidate minimum-host verification +remains open, and the audit repeats at the final candidate SHA. | Module | Proposed decision | Evidence / remaining work | | --- | --- | --- | -| jinja | new 0.6.2 (pending tuple review) | All JARs and POM match Central; `.module` Gradle version differs 9.7.0 → 9.9.0 | +| jinja | new 0.6.2 | All JARs and POM match Central; `.module` Gradle version differs 9.7.0 → 9.9.0 | | tokenizer | new 0.1.2 | All JARs match; POM/module Jackson dependency differs 3.1.2 → 3.3.0, module Gradle version also differs | | vision | new 0.1.2 | All JARs match; POM/module Jackson dependency differs 3.1.2 → 3.3.0, module Gradle version also differs | -| native/ffi/core/models/adapters | first releases per manifest | All remain SNAPSHOT until reviewed candidate cut | +| native/ffi/core/models/adapters | first releases per manifest | Versions set by the version PR; candidate cut and verification remain | Any reuse-to-new change reopens tuple review. Module checks use checkout dependencies; mixed-source artifact smoke must establish the real published graph independently. -The proposed manifest now selects all nine new coordinates. This is not a final candidate cut: -module versions remain SNAPSHOT and tuple review is still required. +The manifest selects all nine new coordinates, and the version PR sets the module build files +and the smoke CI defaults to the approved tuple. This is not a final candidate cut: the +candidate tag, the signed bundle and the audit rerun at the final candidate SHA remain. The published Javadoc banner identifies only `Generated by javadoc (21)`; vendor, patch and build were not established from that banner. The retained 8.1 release report separately records BellSoft 21.0.12.1; the matching-toolchain audit reproduces every JAR exactly. The explicit @@ -59,6 +60,8 @@ BellSoft 21.0.12.1; the matching-toolchain audit reproduces every JAR exactly. T - [x] Revalidate pure-Java artifact reuse after the plugin pin bump and Jackson 3.3.0 update; [audit and artifact hashes](phase8-4-pure-java-audit.md) support all three new versions. - [ ] Approve the audited tuple after minimum-host readiness; repeat audit at final candidate SHA. + The owner approved the tuple 2026-11-17 and the version PR sets the module versions and + smoke CI defaults to it; the audit rerun at the final candidate SHA remains. - [ ] Freeze candidate tag/SHA, verify signed bundle, both consumer profiles and minimum host. - [ ] Review concrete verified-bundle receipt, then explicitly authorize Central publication. - [ ] Verify all nine exact Central coordinates and selected Java 21 subset on both platforms. diff --git a/tools/hf-reference/README.md b/tools/hf-reference/README.md index 29a73ddd..7008450c 100644 --- a/tools/hf-reference/README.md +++ b/tools/hf-reference/README.md @@ -160,7 +160,7 @@ tools/hf-reference/.venv/bin/python \ JMLX_LIBRARY_PATH=$PWD/native/install/lib \ JMLX_ROPE_REFERENCE=$PWD/build/qwen3vl-rope-reference.txt \ "$JDK25_HOME/bin/jshell" --execution local -s -J--enable-native-access=ALL-UNNAMED \ - --class-path jmlx-core/build/libs/jmlx-core-0.5.0-SNAPSHOT.jar:jmlx-ffi/build/libs/jmlx-ffi-0.5.0-SNAPSHOT.jar \ + --class-path jmlx-core/build/libs/jmlx-core-0.5.0.jar:jmlx-ffi/build/libs/jmlx-ffi-0.5.0.jar \ tools/hf-reference/qwen3vl_rope_interleaved_check.jsh ``` diff --git a/tools/release-smoke/gradle.properties b/tools/release-smoke/gradle.properties index 8009ee16..83a63b01 100644 --- a/tools/release-smoke/gradle.properties +++ b/tools/release-smoke/gradle.properties @@ -4,14 +4,14 @@ # CI reads these producer-aligned defaults. Release profiles read released-8.4.json; # historical `central --profile pure-java --release 8.1` reads released-8.1.properties. # A producer version change must update its CI default here in the same PR. -jmlxModelsVersion=0.1.0-SNAPSHOT -jmlxNativeVersion=0.1.0-SNAPSHOT -jmlxCoreVersion=0.5.0-SNAPSHOT -jmlxFfiVersion=0.5.0-SNAPSHOT -jmlxTokenizerVersion=0.1.2-SNAPSHOT -jmlxJinjaVersion=0.6.2-SNAPSHOT -jmlxVisionVersion=0.1.2-SNAPSHOT +jmlxModelsVersion=0.1.0 +jmlxNativeVersion=0.1.0 +jmlxCoreVersion=0.5.0 +jmlxFfiVersion=0.5.0 +jmlxTokenizerVersion=0.1.2 +jmlxJinjaVersion=0.6.2 +jmlxVisionVersion=0.1.2 org.gradle.warning.mode=summary -jmlxSpringAiVersion=0.1.0-SNAPSHOT -jmlxLangchain4jVersion=0.1.0-SNAPSHOT +jmlxSpringAiVersion=0.1.0 +jmlxLangchain4jVersion=0.1.0 diff --git a/tools/release-smoke/selftest.sh b/tools/release-smoke/selftest.sh index 54bf4255..2f4ea735 100755 --- a/tools/release-smoke/selftest.sh +++ b/tools/release-smoke/selftest.sh @@ -115,10 +115,12 @@ expect "all preflight rejects a missing adapter producer" 2 body \ # --- a failing preflight is side-effect-free: main runs the preflight immediately after argument # parsing, so a failing candidate run must exit 2 before the smoke repository or the consumer's # project state is touched. Runs the real run.sh, not the function: the property under test is -# main's ordering, not the function. stderr is captured and must carry the preflight's own -# message: other early paths (e.g. a missing wrapper distribution) also exit 2, so the status -# alone would pass a preflight that never ran. The state marker lives in this checkout's real -# consumer build directory (gitignored), created and removed by the test. --- +# main's ordering, not the function. The 8.4 preflight reads the actual build.gradle files, so +# a release-ready tree would pass version validation; the JMLX_JINJA_VERSION override is the +# deterministic failure independent of the tree's state. stderr is captured and must carry the +# preflight's own message: other early paths (e.g. a missing wrapper distribution) also exit 2, +# so the status alone would pass a preflight that never ran. The state marker lives in this +# checkout's real consumer build directory (gitignored), created and removed by the test. --- repo="$tmp/repo" state_marker="$here/build/e2e-preflight-state" mkdir -p "$repo" @@ -128,9 +130,10 @@ touch "$state_marker" err="$tmp/e2e.err" status=0 JMLX_SMOKE_REPO_DIR="$repo" JMLX_SMOKE_TUPLE_FILE="$tmp/absent.properties" JMLX_SMOKE_PRODUCER_VERSIONS="$producers_release" \ + JMLX_JINJA_VERSION=0.7.0 \ bash "$here/run.sh" candidate --profile pure-java >/dev/null 2>"$err" || status=$? if [ "$status" -eq 2 ] && [ -f "$repo/marker" ] && [ -f "$state_marker" ] \ - && grep -q "producer jmlx-jinja version .* != manifest" "$err"; then + && grep -q "JMLX_JINJA_VERSION must repeat manifest version" "$err"; then echo "ok: failing preflight exits 2 with its own message before touching the repository or consumer state" else echo "FAIL: preflight ran with side effects or the wrong exit (status $status; repo marker $([ -f "$repo/marker" ] && echo present || echo gone); state marker $([ -f "$state_marker" ] && echo present || echo gone); stderr: $(head -1 "$err"))" From 2dd12238b6462aa99cc7996c90bd28c9aed9f1af Mon Sep 17 00:00:00 2001 From: Per Nyfelt Date: Tue, 17 Nov 2026 23:04:03 +0100 Subject: [PATCH 2/2] Restore the canonical unstaged-native publish refusal The version change in this PR moves jmlx-native-macos-arm64 off -SNAPSHOT, which activates the release-version publish dependency on verifyNativeReleasePayload. On an unstaged checkout that Exec task now fails first (a python error, or a missing bootstrap script in a partial checkout) before the publish task's unconditional doFirst refusal runs, so the canonical message telling the human to run bootstrap-native.sh never prints. The release selftest's combined-staging fixture caught this in CI (run 44181118435). The payload check now skips via onlyIf while native/install/lib is unstaged, mirroring verifyPackagedNativeResources' existing lenient pattern: with no staged files there is no real payload to check, and the publish task's own hard, unconditional doFirst gate fires with the canonical message instead. Staging valid but the payload wrong still fails the release in the same task. --- jmlx-native-macos-arm64/build.gradle | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/jmlx-native-macos-arm64/build.gradle b/jmlx-native-macos-arm64/build.gradle index 5801187b..b00341c4 100644 --- a/jmlx-native-macos-arm64/build.gradle +++ b/jmlx-native-macos-arm64/build.gradle @@ -167,6 +167,13 @@ tasks.register('verifyNativeReleasePayload', Exec) { group = 'verification' description = 'Checks packaged dylib deployment targets, source paths, pins and license texts.' dependsOn tasks.named('jar'), tasks.named('sourcesJar'), tasks.named('javadocJar') + // Like verifyPackagedNativeResources: with native/install/lib unstaged there is no real + // payload to check, and this Exec task's own failure (a python error or a missing bootstrap + // script in a partial checkout) would otherwise preempt the publish task's unconditional + // doFirst refusal -- the canonical message that tells the human to run bootstrap-native.sh. + // Staging missing, the payload check is skipped and the publish refusal fires instead; + // staging present but the payload wrong, this task still fails the release. + onlyIf { hasValidatedStagedNativeFiles() } commandLine 'python3', rootProject.file('tools/release-all/release_inputs.py'), 'native', tasks.named('jar').get().archiveFile.get().asFile, '--documentation-jar', tasks.named('sourcesJar').get().archiveFile.get().asFile,