chore(main): release 1.21.0

[openfeaturebot]

🤖 I have created a release beep boop

1.21.0 (2026-06-22)

🐛 Bug Fixes

• collect and propagate per-provider errors in multi-provider strategies (#1901) (f938b26)
• deps: update dependency com.fasterxml.jackson:jackson-bom to v2.21.2 (#1907) (bb19ba9)
• deps: update dependency com.fasterxml.jackson:jackson-bom to v2.21.3 (#1935) (51754a5)
• deps: update dependency org.junit:junit-bom to v6.1.0 (#1941) (76b71c2)
• deps: update dependency org.projectlombok:lombok to v1.18.46 (#1932) (639ee61)
• deps: update dependency org.slf4j:slf4j-api to v2.0.18 (#1937) (ea41f90)
• deps: update jackson monorepo to v2.22.0 (#1946) (58091f3)
• Domain client event handlers no longer disappear (#1922) (5562cb9)
• keep distributionManagement in flattened pom (#1958) (08ce6d0)
• shutdown now clears hooks, evaluationContext and transactionContextPropagator as per spec 1.6.2 (#1936) (fb2181f)

✨ New Features

• support isolated API instances (#1928) (231464a)

🧹 Chore

• deps: update codecov/codecov-action action to v6 (#1913) (f2f14e3)
• deps: update codecov/codecov-action action to v6.0.1 (#1940) (fb84d68)
• deps: update codecov/codecov-action action to v6.0.2 (#1960) (039adc4)
• deps: update codecov/codecov-action action to v7 (#1961) (d779ae4)
• deps: update com.vmlens.version to v1.2.28 (#1923) (f2f7df7)
• deps: update dependency com.diffplug.spotless:spotless-maven-plugin to v3.5.1 (#1938) (6367b8a)
• deps: update dependency com.diffplug.spotless:spotless-maven-plugin to v3.6.0 (#1942) (cd29cd9)
• deps: update dependency com.diffplug.spotless:spotless-maven-plugin to v3.7.0 (#1967) (3a05490)
• deps: update dependency com.github.spotbugs:spotbugs to v4.10.1 (#1962) (9375570)
• deps: update dependency com.github.spotbugs:spotbugs to v4.10.2 (#1965) (50da905)
• deps: update dependency com.github.spotbugs:spotbugs-maven-plugin to v4.10.2.0 (#1966) (75391aa)
• deps: update dependency com.github.spotbugs:spotbugs-maven-plugin to v4.9.8.3 (#1915) (c476180)
• deps: update dependency com.github.spotbugs:spotbugs-maven-plugin to v4.9.8.4 (#1963) (864f9cf)
• deps: update dependency com.github.spotbugs:spotbugs-maven-plugin to v4.9.8.5 (#1964) (d8eb4fc)
• deps: update dependency com.google.guava:guava to v33.6.0-jre (#1927) (c69bb0e)
• deps: update dependency com.tngtech.archunit:archunit-junit5 to v1.4.2 (#1930) (b683371)
• deps: update dependency maven to v3.9.15 (#1929) (e300520)
• deps: update dependency maven to v3.9.16 (#1939) (b4b913c)
• deps: update dependency net.bytebuddy:byte-buddy to v1.18.10-jdk5 (#1949) (8bd83fc)
• deps: update dependency net.bytebuddy:byte-buddy to v1.18.8-jdk5 (#1917) (0c26c70)
• deps: update dependency net.bytebuddy:byte-buddy to v1.18.9-jdk5 (#1947) (78fb82d)
• deps: update dependency net.bytebuddy:byte-buddy-agent to v1.18.10-jdk5 (#1950) (484782b)
• deps: update dependency net.bytebuddy:byte-buddy-agent to v1.18.8-jdk5 (#1918) (04ca748)
• deps: update dependency net.bytebuddy:byte-buddy-agent to v1.18.9-jdk5 (#1948) (647bd1d)
• deps: update dependency org.apache.maven.plugins:maven-dependency-plugin to v3.11.0 (#1945) (9649ff3)
• deps: update dependency org.apache.maven.plugins:maven-failsafe-plugin to v3.5.6 (#1943) (d0278bb)
• deps: update dependency org.apache.maven.plugins:maven-surefire-plugin to v3.5.6 (#1944) (aa284ec)
• deps: update dependency org.codehaus.mojo:flatten-maven-plugin to v1.7.3 (#1957) (733af9e)
• deps: update dependency org.cyclonedx:cyclonedx-maven-plugin to v2.9.2 (#1976) (62fda56)
• deps: update github/codeql-action digest to 05b1a5d (#1906) (d2e15b4)
• deps: update github/codeql-action digest to 30c555a (#1904) (4638622)
• deps: update github/codeql-action digest to 34950e1 (#1921) (ea2d573)
• deps: update github/codeql-action digest to 3d564d9 (#1910) (88fb702)
• deps: update github/codeql-action digest to 57ec7e1 (#1920) (fcd0773)
• deps: update github/codeql-action digest to 72c0b0e (#1908) (39c9df3)
• deps: update github/codeql-action digest to a899987 (#1914) (eecb2d6)
• deps: update github/codeql-action digest to b623f5f (#1924) (d5f7a64)
• deps: update github/codeql-action digest to c618c9b (#1916) (36eb2e0)
• deps: update github/codeql-action digest to eedab83 (#1909) (050633c)
• deps: update github/codeql-action digest to f94817b (#1911) (e8a99d8)
• deps: update googleapis/release-please-action action to v5 (#1933) (72259d1)
• flatten pom, add licences to jar (#1951) (42418c1)

📚 Documentation

• fix inaccuracies in README code examples (#1931) (cc837b1)

🚀 Performance

• avoid ImmutableStructure allocation for empty ImmutableContext (#1972) (b54f6dc)
• avoid Optional.ofNullable wrapping on hook.before() return value (#1955) (b611d55)
• cache clientMetadata lambda to avoid per-call allocation (#1952) (85c0047)
• eliminate merge allocation in setHooks by accepting hook sources directly (#1956) (a5ba3c6)
• empty default for ProviderEvaluation (#1970) (7f92622)
• replace copy+reverse with index-based traversal in executeBefor… (#1954) (8fbf507)
• replace copy+reverse with index-based traversal in executeBeforeHooks (8fbf507)
• return Collections.emptyMap() from asUnmodifiableMap() when attributes is empty (#1974) (a8277d0)
• return ImmutableContext.EMPTY from NoOpTransactionContextPropag… (#1975) (78afa98)
• return ImmutableContext.EMPTY from NoOpTransactionContextPropagator (78afa98)
• return ImmutableContext.EMPTY when merging two empty contexts (#1973) (d492685)
• skip ImmutableMetadata allocation when builder has no entries (#1971) (e014572)
• skip iterating over empty list (#1969) (b21f4a8)
• skip unmodifiableMap wrapper when hookHints is empty (#1953) (b592514)

---

This PR was generated with Release Please. See documentation.

[gemini-code-assist]

Summary of Changes

Hello, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request introduces a new release, version 1.20.3, for the open-feature/java-sdk. It primarily involves updating the project's version across its configuration and documentation files, and includes a minor chore to update a GitHub CodeQL action dependency.

Highlights

• Release Version Bump: The project version has been incremented from 1.20.2 to 1.20.3 across various configuration and documentation files, including the pom.xml, README.md, and .release-please-manifest.json.
• Dependency Update: The github/codeql-action digest has been updated to 30c555a, as reflected in the CHANGELOG.md.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

This pull request updates the project version to 1.20.3 across various configuration and documentation files. The changes are primarily automated version bumps, reflecting a chore update related to github/codeql-action. The changes are straightforward and consistent across the files.

[gemini-code-assist]

The date 2026-03-19 appears to be a future date. Please ensure the changelog reflects the actual release date to maintain accuracy.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.21%. Comparing base (a8277d0) to head (db17b63).

Additional details and impacted files

@@             Coverage Diff              @@
##               main    #1905      +/-   ##
============================================
+ Coverage     92.23%   93.21%   +0.97%     
- Complexity      669      672       +3     
============================================
  Files            59       59              
  Lines          1635     1635              
  Branches        186      186              
============================================
+ Hits           1508     1524      +16     
+ Misses           80       66      -14     
+ Partials         47       45       -2     

Flag	Coverage Δ
unittests	93.21% <ø> (+0.97%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[coderabbitai]

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

• @coderabbitai resume to resume automatic reviews.
• @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

• ▶️ Resume reviews
• 🔍 Trigger review

📝 Walkthrough

Walkthrough

Version bumped from 1.20.2 to 1.21.0 across pom.xml, version.txt, .release-please-manifest.json, and README.md (badge, Maven, and Gradle snippets). A new [1.21.0] section is prepended to CHANGELOG.md covering bug fixes, new features, chores, documentation, and performance entries.

Changes

Release 1.21.0

Layer / File(s)	Summary
Version references updated in release files pom.xml, version.txt, .release-please-manifest.json, README.md	Version number updated from 1.20.2 to 1.21.0 in the Maven artifact, version identifier file, release manifest, and README badge and dependency examples.
Release notes and changelog entry CHANGELOG.md	New v1.21.0 section added with bug fixes (multi-provider error collection, event handler retention, POM flattening, context cleanup), new features (isolated API instances), chore entries (dependency and tooling updates), documentation fixes, and performance optimizations.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'chore(main): release 1.21.0' directly and clearly describes the main change—a version release from 1.20.2 to 1.21.0 across configuration and manifest files.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description check	✅ Passed	The description is related to the changeset - it documents the release version 1.21.0 with detailed changelog entries matching the version bumps and updates in the modified files.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Caution

Failed to replace (edit) comment. This is likely due to insufficient permissions or the comment being deleted.

Error details

{}

[toddbaert]

@coderabbitai full review this release PR. Sanity check all changes.

[coderabbitai]

Tip

For best results, initiate chat on the files or code changes.

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "=== PR `#1905` Details ==="
gh pr view 1905 --repo open-feature/java-sdk --json title,body,state,baseRefName,headRefName,mergedAt,author

echo ""
echo "=== PR Files Changed ==="
gh pr diff 1905 --repo open-feature/java-sdk --name-only

echo ""
echo "=== Full Diff ==="
gh pr diff 1905 --repo open-feature/java-sdk

Length of output: 35106

---

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "=== Merged PRs since last release (v1.20.2) ==="
# Find the last release tag date and list PRs merged since then
gh pr list --repo open-feature/java-sdk --state merged --limit 50 --json number,title,mergedAt,labels \
  --jq '.[] | select(.mergedAt > "2026-01-01") | {number: .number, title: .title, mergedAt: .mergedAt, labels: [.labels[].name]}'

Length of output: 7470

---

---

@toddbaert Here's the sanity check for this v1.21.0 release PR:

---

✅ Version Consistency

All 5 files are consistently updated from 1.20.2 → 1.21.0:

File	Change
.release-please-manifest.json	"1.20.2" → "1.21.0"
pom.xml	<version>1.20.2</version> → <version>1.21.0</version>
version.txt	1.20.2 → 1.21.0
README.md	Badge link, Maven coord, Gradle coord — all updated
CHANGELOG.md	New [1.21.0] section added at top

---

✅ README Coordinates

• Badge: links to https://github.com/open-feature/java-sdk/releases/tag/v1.21.0 ✅
• Maven: dev.openfeature:sdk:1.21.0 ✅
• Gradle: dev.openfeature:sdk:1.21.0 ✅

---

✅ CHANGELOG vs. Merged PRs

Cross-referenced all merged PRs since v1.20.2 (2026-03-19). All 50 retrievable PRs are accounted for in the CHANGELOG, including:

• Bug Fixes (#1901, #1907, #1922, #1935, #1936, #1937, #1941, #1946, #1958): correctly categorized
• New Features (#1928 – isolated API instances): correctly categorized
• Chore (27 deps/CI entries): all present
• Documentation (#1931 – README fixes): present
• Performance (11 entries): all present

The CHANGELOG comparison link (v1.20.2...v1.21.0) is correct.

---

⚠️ Minor: Duplicate Entries in Performance Section (cosmetic)

There are two duplicate entries — a known release-please artifact where both the PR merge commit and the raw commit SHA appear as separate entries:

1. replace copy+reverse with index-based traversal in executeBefor… (perf: replace copy+reverse with index-based traversal in executeBefor… #1954) and replace copy+reverse with index-based traversal in executeBeforeHooks (same commit 8fbf507)
2. return ImmutableContext.EMPTY from NoOpTransactionContextPropag… (perf: return ImmutableContext.EMPTY from NoOpTransactionContextPropag… #1975) and return ImmutableContext.EMPTY from NoOpTransactionContextPropagator (same commit 78afa98)

These are cosmetic and don't block the release, but if they bother you, the CHANGELOG can be manually edited before merging.

---

Summary

Everything looks correct and consistent. The release PR is safe to merge. 🚀

[openfeaturebot]

🤖 Created releases:

• v1.21.0

🌻

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud