feat!: bump to v4.0.0 (#108)

* feat!: bump to v4.0.0 — remove totalSteps from CreateWorkflowRequest

* fix: update install docs to reference v4.0.0

Maven and Gradle snippets in README still showed 3.2.0.

* chore: complete v4.0.0 changelog with all changes since v3.8.0

Add MCP operation default context, README install version updates,
CI and infrastructure changes. Set release date to 2026-03-09.

Author: saurabhjain1592

CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to the AxonFlow Java SDK will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.0.0] - 2026-03-09
+
+### Breaking Changes
+
+- **Removed `totalSteps` from `CreateWorkflowRequest`**. Requires Platform v4.5.0+ (recommended v5.0.0+).
+  Total steps are auto-computed when the workflow reaches a terminal state.
+- **`mcpCheckInput()` default `operation` changed from `"query"` to `"execute"`** (#104). Callers relying on
+  the implicit `"query"` default must now pass `operation("query")` explicitly. The check-input endpoint is
+  used by external orchestrators managing their own MCP execution, so `"execute"` (conservative) is the
+  correct default over `"query"` (read-only).
+
+### Changed
+
+- README install snippets updated from `3.2.0` to `4.0.0` for Maven and Gradle
+- Removed Scarf tracking pixel from README (#107)
+- SDK telemetry suppressed in CI workflows via `DO_NOT_TRACK=1` (#105)
+- Maven dependency caching enabled in CI and release workflows (#106)
+
+### Note
+
+`MediaAnalysisResult.getExtractedText()` was replaced by `hasExtractedText()` + `getExtractedTextLength()`
+in v3.5.0. This major version formally acknowledges that breaking change.
+
+---
+
 ## [3.8.0] - 2026-03-03
 
 ### Added

README.md

@@ -45,14 +45,14 @@ If you're new to AxonFlow, this short video shows how the control plane and SDKs
 <dependency>
     <groupId>com.getaxonflow</groupId>
     <artifactId>axonflow-sdk</artifactId>
-    <version>3.2.0</version>
+    <version>4.0.0</version>
 </dependency>
 ```
 
 ### Gradle
 
 ```groovy
-implementation 'com.getaxonflow:axonflow-sdk:3.2.0'
+implementation 'com.getaxonflow:axonflow-sdk:4.0.0'
 ```
 
 ## Evaluation Tier (Free License)

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>com.getaxonflow</groupId>
     <artifactId>axonflow-sdk</artifactId>
-    <version>3.6.0</version>
+    <version>4.0.0</version>
     <packaging>jar</packaging>
 
     <name>AxonFlow Java SDK</name>

src/main/java/com/getaxonflow/sdk/AxonFlow.java

@@ -4076,7 +4076,6 @@ public CompletableFuture<UsageSummary> getUsageSummaryAsync(String period) {
      *     CreateWorkflowRequest.builder()
      *         .workflowName("code-review-pipeline")
      *         .source(WorkflowSource.LANGGRAPH)
-     *         .totalSteps(5)
      *         .build()
      * );
      * System.out.println("Workflow created: " + workflow.getWorkflowId());

src/main/java/com/getaxonflow/sdk/types/workflow/WorkflowTypes.java

@@ -225,9 +225,6 @@ public static final class CreateWorkflowRequest {
         @JsonProperty("source")
         private final WorkflowSource source;
 
-        @JsonProperty("total_steps")
-        private final Integer totalSteps;
-
         @JsonProperty("metadata")
         private final Map<String, Object> metadata;
 
@@ -238,20 +235,18 @@ public static final class CreateWorkflowRequest {
          * Backward-compatible constructor without traceId.
          */
         public CreateWorkflowRequest(String workflowName, WorkflowSource source,
-                                     Integer totalSteps, Map<String, Object> metadata) {
-            this(workflowName, source, totalSteps, metadata, null);
+                                     Map<String, Object> metadata) {
+            this(workflowName, source, metadata, null);
         }
 
         @JsonCreator
         public CreateWorkflowRequest(
                 @JsonProperty("workflow_name") String workflowName,
                 @JsonProperty("source") WorkflowSource source,
-                @JsonProperty("total_steps") Integer totalSteps,
                 @JsonProperty("metadata") Map<String, Object> metadata,
                 @JsonProperty("trace_id") String traceId) {
             this.workflowName = Objects.requireNonNull(workflowName, "workflowName is required");
             this.source = source != null ? source : WorkflowSource.EXTERNAL;
-            this.totalSteps = totalSteps;
             this.metadata = metadata != null ? Collections.unmodifiableMap(metadata) : Collections.emptyMap();
             this.traceId = traceId;
         }
@@ -264,10 +259,6 @@ public WorkflowSource getSource() {
             return source;
         }
 
-        public Integer getTotalSteps() {
-            return totalSteps;
-        }
-
         public Map<String, Object> getMetadata() {
             return metadata;
         }
@@ -283,7 +274,6 @@ public static Builder builder() {
         public static final class Builder {
             private String workflowName;
             private WorkflowSource source = WorkflowSource.EXTERNAL;
-            private Integer totalSteps;
             private Map<String, Object> metadata;
             private String traceId;
 
@@ -297,11 +287,6 @@ public Builder source(WorkflowSource source) {
                 return this;
             }
 
-            public Builder totalSteps(Integer totalSteps) {
-                this.totalSteps = totalSteps;
-                return this;
-            }
-
             public Builder metadata(Map<String, Object> metadata) {
                 this.metadata = metadata;
                 return this;
@@ -313,7 +298,7 @@ public Builder traceId(String traceId) {
             }
 
             public CreateWorkflowRequest build() {
-                return new CreateWorkflowRequest(workflowName, source, totalSteps, metadata, traceId);
+                return new CreateWorkflowRequest(workflowName, source, metadata, traceId);
             }
         }
     }

src/main/java/com/getaxonflow/sdk/types/workflow/package-info.java

@@ -38,7 +38,6 @@
  *     CreateWorkflowRequest.builder()
  *         .workflowName("code-review-pipeline")
  *         .source(WorkflowSource.LANGGRAPH)
- *         .totalSteps(5)
  *         .build()
  * );
  *