diff --git a/README.md b/README.md index 1f25f35a..ec6f5e75 100644 --- a/README.md +++ b/README.md @@ -144,7 +144,7 @@ To use the latest snapshot, add the repository and dependency to your `pom.xml`: net.ladenthin llama - 5.0.4-SNAPSHOT + 5.0.5-SNAPSHOT ``` @@ -719,7 +719,7 @@ forcing that floor on every core consumer. It ships and versions in lockstep wit net.ladenthin llama-langchain4j - 5.0.4-SNAPSHOT + 5.0.4 ``` diff --git a/docs/RELEASE.md b/docs/RELEASE.md index b8289acb..3eb5b4fe 100644 --- a/docs/RELEASE.md +++ b/docs/RELEASE.md @@ -1,37 +1,31 @@ # Release Process -This document is the maintainer-facing release procedure. End users should consult [CHANGELOG.md](../CHANGELOG.md). +The maintainer-facing release procedure is **centralized in the workspace repo**: +[`../workspace/workflows/release-process.md`](../workspace/workflows/release-process.md). -> Paste this prompt into a new Claude Code session, fill in the three placeholders, and send it to perform a release. +java-llama.cpp is a **Maven reactor**, so two repo-specific points extend the canonical procedure. +## Reactor version bump (all three poms) + +The root `pom.xml` is the parent (`net.ladenthin:llama-parent`); the `llama/` and +`llama-langchain4j/` modules inherit its version **but hardcode it in their ``** +(there is no `${revision}` single-sourcing). A version change — the release strip in Step 1 and the +post-release bump in Step 3 — must touch **all three poms in lockstep**, or the reactor build fails +with `Could not find artifact net.ladenthin:llama-parent:pom:{VERSION}`. Use: + +```bash +mvn -q versions:set -DnewVersion={VERSION} -DgenerateBackupPoms=false ``` -Release `{PROJECT}` to Maven Central. - -**Step 1 — Prepare the release (do immediately):** -1. Read the current version from `pom.xml` on `main` — it will be `{VERSION}-SNAPSHOT` -2. Strip `-SNAPSHOT` from `pom.xml` (→ `{VERSION}`) -3. In `README.md`, update **both**: - - The release dependency example to `{VERSION}` - - The snapshot dependency example to `{VERSION}-SNAPSHOT` (it should already match, but verify) -4. Commit both files directly to `main` (no pull request) - -**Step 2 — Wait for manual confirmation:** -I will create the `v{VERSION}` tag and GitHub release manually — wait for me to confirm -the release is published on Maven Central before proceeding. - -**Step 3 — Post-release snapshot bump (after my confirmation):** -Bump **both** files on `main`: -- `pom.xml` → `{NEXT_VERSION}-SNAPSHOT` -- `README.md` snapshot dependency example → `{NEXT_VERSION}-SNAPSHOT` - (the release dependency examples stay at the just-released `{VERSION}`) - -Commit both changes together directly to `main`. - -**Placeholders:** - -| Placeholder | Value | -|------------------|----------------------------------------------| -| `{PROJECT}` | *(project name)* | -| `{VERSION}` | *(release version, e.g. `1.3.0`)* | -| `{NEXT_VERSION}` | *(next snapshot base, e.g. `1.3.1`)* | -``` + +from the repo root — it updates the root `` plus both children's `` at +once. See the "Version bump" note in [CLAUDE.md](../CLAUDE.md) for the rationale. + +## Extra README dependency snippet + +Besides the root `README.md`, the `llama-langchain4j/README.md` `## Dependency` section carries a +**release** dependency snippet that must also be set to `{VERSION}` in Step 1 — it is not covered by +the root-README edits and drifts silently otherwise (the release examples stay at `{VERSION}` on the +Step 3 snapshot bump). + +One reactor `mvn -P release deploy` signs and publishes the parent pom, `llama`, and +`llama-langchain4j` together at the same version. diff --git a/llama-langchain4j/README.md b/llama-langchain4j/README.md index f4449369..6b672aa8 100644 --- a/llama-langchain4j/README.md +++ b/llama-langchain4j/README.md @@ -62,7 +62,7 @@ ScoringModel reranker = new JllamaScoringModel(rerankLlama); net.ladenthin llama-langchain4j - 5.0.4-SNAPSHOT + 5.0.4 ``` diff --git a/llama-langchain4j/pom.xml b/llama-langchain4j/pom.xml index 734ae30d..3e3d0e0c 100644 --- a/llama-langchain4j/pom.xml +++ b/llama-langchain4j/pom.xml @@ -12,7 +12,7 @@ SPDX-License-Identifier: MIT net.ladenthin llama-parent - 5.0.4 + 5.0.5-SNAPSHOT ../pom.xml diff --git a/llama/pom.xml b/llama/pom.xml index afa7be38..67e6e563 100644 --- a/llama/pom.xml +++ b/llama/pom.xml @@ -13,7 +13,7 @@ SPDX-License-Identifier: MIT net.ladenthin llama-parent - 5.0.4 + 5.0.5-SNAPSHOT ../pom.xml diff --git a/pom.xml b/pom.xml index 9a3d646c..1b4c6f45 100644 --- a/pom.xml +++ b/pom.xml @@ -19,7 +19,7 @@ SPDX-License-Identifier: MIT --> net.ladenthin llama-parent - 5.0.4 + 5.0.5-SNAPSHOT pom ${project.groupId}:${project.artifactId}