moonyue-w · Nov 3, 2026
@@ -2,6 +2,8 @@
 
 ## [Unreleased]
 
+## [0.3.0]
+
 ### Added
 
 - Add Forward Session budget builders/getters with decimal-string limits and preserved omission/null clearing, Session model overrides and typed approval evaluation details.
@@ -26,10 +28,6 @@
 
 - Remove resource-specific sections and inventories from the README to keep it focused on SDK setup and shared client behavior.
 
-### Removed
-
-- Remove the deprecated Managed `skills().update(...)` API and `managed.SkillUpdateParams` from the 0.2.0 candidate, including asynchronous and `withResponse()` variants. Use `skills().versions().create(...)` for Skill content updates; it does not replace Skill metadata updates. Forward Skill APIs are unchanged.
-
 ## [0.2.0] - 2026-10-29
 
 Bring Forward additions and Managed API support together in one Java 8 compatible release.
@@ -60,6 +58,10 @@ Bring Forward additions and Managed API support together in one Java 8 compatibl
 - Prefer `OutcomeRubric.content()` / `Builder.content(...)`; raw JSON callers must replace the old rubric `text` key with `content`.
 - Typed Session creation now adds three metadata entries. Do not use different values/types for these exact reserved keys, and allow for them within the service metadata limit. Other metadata, including future prefixed keys, remains unchanged.
 
+### Removed
+
+- Remove the deprecated Managed `skills().update(...)` API and `managed.SkillUpdateParams` before the 0.2.0 release, including asynchronous and `withResponse()` variants. Use `skills().versions().create(...)` for Skill content updates; it does not replace Skill metadata updates. Forward Skill APIs are unchanged.
+
 ## [0.1.0] - 2026-10-21
 
 First stable release of the Java SDK for the Forward API, using `com.qoder.sdk:qoder-cloud-agents-sdk:0.1.0`.

@@ -4,7 +4,7 @@
 
 The Qoder Cloud Agents Java SDK provides typed synchronous and asynchronous clients, with shared authentication, timeouts, retries, pagination, streaming and error handling.
 
-Version **0.2.0** supports both the **Forward API** and the **[Managed API](docs/managed.md)** in one package. Use `ForwardClient` / `AsyncForwardClient` for Forward and `ManagedClient` / `AsyncManagedClient` for Managed.
+Version **0.3.0** supports both the **Forward API** and the **[Managed API](docs/managed.md)** in one package. Use `ForwardClient` / `AsyncForwardClient` for Forward and `ManagedClient` / `AsyncManagedClient` for Managed.
 
 - [Installation](#installation)
 - [Quick start](#quick-start)
@@ -26,7 +26,7 @@ Add the Maven dependency; published versions require no local SDK build or addit
 <dependency>
   <groupId>com.qoder.sdk</groupId>
   <artifactId>qoder-cloud-agents-sdk</artifactId>
-  <version>0.2.0</version>
+  <version>0.3.0</version>
 </dependency>
 ```
 

@@ -1,6 +1,6 @@
 # Java SDK maintenance
 
-SDK 0.2.0 covers Forward and Managed and targets Java 8. Use JDK 17 or later for maintenance tools; the runtime compatibility matrix remains Java 8, 11, 17, 21 and 25.
+SDK 0.3.0 covers Forward and Managed and targets Java 8. Use JDK 17 or later for maintenance tools; the runtime compatibility matrix remains Java 8, 11, 17, 21 and 25.
 
 ## Local checks and pull requests
 
@@ -34,10 +34,10 @@ The SDK's embedded version is filtered from `${project.version}`; do not replace
 ```sh
 python3 .github/scripts/release_notes.py check
 # After adding the actual release entry:
-python3 .github/scripts/release_notes.py extract --version 0.2.0
+python3 .github/scripts/release_notes.py extract --version 0.3.0
 ```
 
-The release version in this checkout is `0.2.0`. Also update the README dependency and version-specific maintenance examples. Acceptance records must include the resolved version, source SHA and JAR digest. Release versions must not be overwritten; a successful test of an older build is not evidence for a newer one.
+The release version in this checkout is `0.3.0`. Also update the README dependency and version-specific maintenance examples. Acceptance records must include the resolved version, source SHA and JAR digest. Release versions must not be overwritten; a successful test of an older build is not evidence for a newer one.
 
 ### RC qualification for 0.1.0
 

@@ -1,6 +1,6 @@
 # Java SDK release setup
 
-The release version in this checkout is `com.qoder.sdk:qoder-cloud-agents-sdk:0.2.0`. The manual [Release workflow](../.github/workflows/release.yml) publishes using repository Actions secrets. Dispatching it from `main` authorizes publication after all automated checks pass; there is no separate environment approval. The Central account, namespace, signing key and repository settings below must be configured first. The GitHub repository and internal Maven access do not grant Maven Central publishing access.
+The release version in this checkout is `com.qoder.sdk:qoder-cloud-agents-sdk:0.3.0`. The manual [Release workflow](../.github/workflows/release.yml) publishes using repository Actions secrets. Dispatching it from `main` authorizes publication after all automated checks pass; there is no separate environment approval. The Central account, namespace, signing key and repository settings below must be configured first. The GitHub repository and internal Maven access do not grant Maven Central publishing access.
 
 `0.1.0-rc.1` was published to Maven Central on 2026-10-21; see its [Release](https://github.com/QoderAI/qoder-cloud-agents-sdk-java/releases/tag/v0.1.0-rc.1) and [successful publication workflow](https://github.com/QoderAI/qoder-cloud-agents-sdk-java/actions/runs/39572349619). A version committed to a POM is not yet a published package: check the workflow's public verification and matching GitHub Release for each version.
 
@@ -70,13 +70,13 @@ The namespace variable is a maintainer's setup confirmation, not an automatic ow
 
 Prepare a PR that updates the root POM, the example project's version and SDK dependency, plus the changelog version section. Keep an empty `Unreleased` section. Review any version-specific install examples. Merge only after `quality` and all five Java checks succeed. The workflow does not bump versions or merge the PR.
 
-For the combined Forward and Managed `0.2.0` release, run internal integration tests and accept a QA package built from the merged version commit. Record both API surfaces, the Java runtime, cleanup warnings and untested scenarios. Earlier development-package results do not replace this check. Use the merged `0.2.0` main SHA and a new batch ID; leave recovery inputs empty for the first publication.
+For the Forward and Managed contract-alignment `0.3.0` release, run internal integration tests and accept a QA package built from the merged version commit. Record both API surfaces, the Java runtime, cleanup warnings and untested scenarios. Earlier development-package results do not replace this check. Use the merged `0.3.0` main SHA and a new batch ID; leave recovery inputs empty for the first publication.
 
 Open **Actions → Release → Run workflow**, select **main**, and verify the following inputs before dispatch. Successful preflight automatically proceeds to signing and publication; it does not pause for an additional approval.
 
 | Input | First publication |
 | --- | --- |
-| `version` | The reviewed version without `v` or `SNAPSHOT`, for example `0.2.0` |
+| `version` | The reviewed version without `v` or `SNAPSHOT`, for example `0.3.0` |
 | `commit_sha` | Full 40-character lowercase SHA of the current GitHub main |
 | `batch_id` | 1–64 letters/digits/dots/underscores/hyphens, starting with a letter or digit |
 | `resume_run_id` | Empty |

@@ -2,11 +2,11 @@
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
   <modelVersion>4.0.0</modelVersion>
-  <groupId>com.qoder.examples</groupId><artifactId>qca-forward-examples</artifactId><version>0.2.0</version>
+  <groupId>com.qoder.examples</groupId><artifactId>qca-forward-examples</artifactId><version>0.3.0</version>
   <properties><maven.compiler.release>8</maven.compiler.release><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties>
   <!-- Independent consumer: deliberately no parent, reactor module, or SDK source directory. -->
   <dependencies>
-    <dependency><groupId>com.qoder.sdk</groupId><artifactId>qoder-cloud-agents-sdk</artifactId><version>0.2.0</version></dependency>
+    <dependency><groupId>com.qoder.sdk</groupId><artifactId>qoder-cloud-agents-sdk</artifactId><version>0.3.0</version></dependency>
     <dependency><groupId>org.junit.jupiter</groupId><artifactId>junit-jupiter</artifactId><version>5.13.4</version><scope>test</scope></dependency>
     <dependency><groupId>com.squareup.okhttp3</groupId><artifactId>mockwebserver</artifactId><version>5.5.0</version><scope>test</scope></dependency>
   </dependencies>

@@ -4,7 +4,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.qoder.sdk</groupId>
   <artifactId>qoder-cloud-agents-sdk</artifactId>
-  <version>0.2.0</version>
+  <version>0.3.0</version>
   <name>Qoder Cloud Agents Java SDK</name>
   <description>Java 8 compatible Qoder Cloud Agents Forward and Managed API clients.</description>
   <url>https://github.com/QoderAI/qoder-cloud-agents-sdk-java</url>