From d1f3e06b26e8aa373ba342d278eb65e5aca0700a Mon Sep 17 00:00:00 2001
From: Dan Davison <dan.davison@temporal.io>
Date: Sat, 14 Mar 2026 21:07:09 -0400
Subject: [PATCH 1/7] Add temporal sample init manifests for CLI scaffolding

---
 .../samples/bookingsaga/temporal-sample.yaml  |  2 ++
 .../temporal/samples/dsl/temporal-sample.yaml |  2 ++
 .../encryptedpayloads/temporal-sample.yaml    |  2 ++
 .../fileprocessing/temporal-sample.yaml       |  2 ++
 .../samples/hello/temporal-sample.yaml        |  2 ++
 .../moneytransfer/temporal-sample.yaml        |  2 ++
 .../samples/nexus/temporal-sample.yaml        |  2 ++
 .../nexuscancellation/temporal-sample.yaml    |  2 ++
 .../temporal-sample.yaml                      |  2 ++
 .../nexusmultipleargs/temporal-sample.yaml    |  2 ++
 temporal-samples.yaml                         | 23 +++++++++++++++++++
 11 files changed, 43 insertions(+)
 create mode 100644 core/src/main/java/io/temporal/samples/bookingsaga/temporal-sample.yaml
 create mode 100644 core/src/main/java/io/temporal/samples/dsl/temporal-sample.yaml
 create mode 100644 core/src/main/java/io/temporal/samples/encryptedpayloads/temporal-sample.yaml
 create mode 100644 core/src/main/java/io/temporal/samples/fileprocessing/temporal-sample.yaml
 create mode 100644 core/src/main/java/io/temporal/samples/hello/temporal-sample.yaml
 create mode 100644 core/src/main/java/io/temporal/samples/moneytransfer/temporal-sample.yaml
 create mode 100644 core/src/main/java/io/temporal/samples/nexus/temporal-sample.yaml
 create mode 100644 core/src/main/java/io/temporal/samples/nexuscancellation/temporal-sample.yaml
 create mode 100644 core/src/main/java/io/temporal/samples/nexuscontextpropagation/temporal-sample.yaml
 create mode 100644 core/src/main/java/io/temporal/samples/nexusmultipleargs/temporal-sample.yaml
 create mode 100644 temporal-samples.yaml

diff --git a/core/src/main/java/io/temporal/samples/bookingsaga/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/bookingsaga/temporal-sample.yaml
new file mode 100644
index 000000000..42c0fdd5f
--- /dev/null
+++ b/core/src/main/java/io/temporal/samples/bookingsaga/temporal-sample.yaml
@@ -0,0 +1,2 @@
+description: Trip booking Saga pattern with compensation
+sdk_version: "1.32.1"
diff --git a/core/src/main/java/io/temporal/samples/dsl/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/dsl/temporal-sample.yaml
new file mode 100644
index 000000000..9b26e5c34
--- /dev/null
+++ b/core/src/main/java/io/temporal/samples/dsl/temporal-sample.yaml
@@ -0,0 +1,2 @@
+description: DSL-driven workflow steps defined in JSON
+sdk_version: "1.32.1"
diff --git a/core/src/main/java/io/temporal/samples/encryptedpayloads/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/encryptedpayloads/temporal-sample.yaml
new file mode 100644
index 000000000..4baa00042
--- /dev/null
+++ b/core/src/main/java/io/temporal/samples/encryptedpayloads/temporal-sample.yaml
@@ -0,0 +1,2 @@
+description: End-to-end payload encryption
+sdk_version: "1.32.1"
diff --git a/core/src/main/java/io/temporal/samples/fileprocessing/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/fileprocessing/temporal-sample.yaml
new file mode 100644
index 000000000..2fe01fff7
--- /dev/null
+++ b/core/src/main/java/io/temporal/samples/fileprocessing/temporal-sample.yaml
@@ -0,0 +1,2 @@
+description: Route tasks to specific Workers for host-local download/process/upload
+sdk_version: "1.32.1"
diff --git a/core/src/main/java/io/temporal/samples/hello/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/hello/temporal-sample.yaml
new file mode 100644
index 000000000..fb9345f60
--- /dev/null
+++ b/core/src/main/java/io/temporal/samples/hello/temporal-sample.yaml
@@ -0,0 +1,2 @@
+description: Single-file hello world samples demonstrating core SDK features
+sdk_version: "1.32.1"
diff --git a/core/src/main/java/io/temporal/samples/moneytransfer/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/moneytransfer/temporal-sample.yaml
new file mode 100644
index 000000000..27021659b
--- /dev/null
+++ b/core/src/main/java/io/temporal/samples/moneytransfer/temporal-sample.yaml
@@ -0,0 +1,2 @@
+description: Separate processes for workflows, activities, and transfer requests
+sdk_version: "1.32.1"
diff --git a/core/src/main/java/io/temporal/samples/nexus/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/nexus/temporal-sample.yaml
new file mode 100644
index 000000000..07d98eeff
--- /dev/null
+++ b/core/src/main/java/io/temporal/samples/nexus/temporal-sample.yaml
@@ -0,0 +1,2 @@
+description: Nexus service definition and operation handlers
+sdk_version: "1.32.1"
diff --git a/core/src/main/java/io/temporal/samples/nexuscancellation/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/nexuscancellation/temporal-sample.yaml
new file mode 100644
index 000000000..bed931803
--- /dev/null
+++ b/core/src/main/java/io/temporal/samples/nexuscancellation/temporal-sample.yaml
@@ -0,0 +1,2 @@
+description: Cancel a Nexus operation using WaitRequested cancellation
+sdk_version: "1.32.1"
diff --git a/core/src/main/java/io/temporal/samples/nexuscontextpropagation/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/nexuscontextpropagation/temporal-sample.yaml
new file mode 100644
index 000000000..ec671f38e
--- /dev/null
+++ b/core/src/main/java/io/temporal/samples/nexuscontextpropagation/temporal-sample.yaml
@@ -0,0 +1,2 @@
+description: Propagate MDC context from Workflows to Nexus operations
+sdk_version: "1.32.1"
diff --git a/core/src/main/java/io/temporal/samples/nexusmultipleargs/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/nexusmultipleargs/temporal-sample.yaml
new file mode 100644
index 000000000..e0eafd626
--- /dev/null
+++ b/core/src/main/java/io/temporal/samples/nexusmultipleargs/temporal-sample.yaml
@@ -0,0 +1,2 @@
+description: Map a Nexus operation to a workflow with multiple input arguments
+sdk_version: "1.32.1"
diff --git a/temporal-samples.yaml b/temporal-samples.yaml
new file mode 100644
index 000000000..b43907bad
--- /dev/null
+++ b/temporal-samples.yaml
@@ -0,0 +1,23 @@
+version: 1
+language: java
+repo: temporalio/samples-java
+scaffold:
+  build.gradle: |
+    plugins { id 'java' }
+    repositories { mavenCentral() }
+    java { sourceCompatibility = JavaVersion.VERSION_11 }
+    dependencies {
+        implementation "io.temporal:temporal-sdk:{{sdk_version}}"
+        implementation "io.temporal:temporal-envconfig:{{sdk_version}}"
+        implementation "ch.qos.logback:logback-classic:1.5.6"
+        implementation "commons-lang:commons-lang:2.6"
+    }
+    task execute(type: JavaExec) {
+        mainClass = findProperty("mainClass") ?: ""
+        classpath = sourceSets.main.runtimeClasspath
+    }
+sample_path: core/src/main/java/io/temporal/samples
+root_files:
+  - gradlew
+  - gradlew.bat
+  - gradle/

From 74082c451f082a2aea95bef78cc016237f5a25de Mon Sep 17 00:00:00 2001
From: Dan Davison <dan.davison@temporal.io>
Date: Sun, 15 Mar 2026 19:48:48 -0400
Subject: [PATCH 2/7] refactor: unify manifests into single
 temporal-sample.yaml

---
 .../samples/bookingsaga/temporal-sample.yaml  |  2 -
 .../temporal/samples/dsl/temporal-sample.yaml |  2 -
 .../encryptedpayloads/temporal-sample.yaml    |  2 -
 .../fileprocessing/temporal-sample.yaml       |  2 -
 .../samples/hello/temporal-sample.yaml        |  2 -
 .../moneytransfer/temporal-sample.yaml        |  2 -
 .../samples/nexus/temporal-sample.yaml        |  2 -
 .../nexuscancellation/temporal-sample.yaml    |  2 -
 .../temporal-sample.yaml                      |  2 -
 .../nexusmultipleargs/temporal-sample.yaml    |  2 -
 temporal-sample.yaml                          | 62 +++++++++++++++++++
 temporal-samples.yaml                         | 23 -------
 12 files changed, 62 insertions(+), 43 deletions(-)
 delete mode 100644 core/src/main/java/io/temporal/samples/bookingsaga/temporal-sample.yaml
 delete mode 100644 core/src/main/java/io/temporal/samples/dsl/temporal-sample.yaml
 delete mode 100644 core/src/main/java/io/temporal/samples/encryptedpayloads/temporal-sample.yaml
 delete mode 100644 core/src/main/java/io/temporal/samples/fileprocessing/temporal-sample.yaml
 delete mode 100644 core/src/main/java/io/temporal/samples/hello/temporal-sample.yaml
 delete mode 100644 core/src/main/java/io/temporal/samples/moneytransfer/temporal-sample.yaml
 delete mode 100644 core/src/main/java/io/temporal/samples/nexus/temporal-sample.yaml
 delete mode 100644 core/src/main/java/io/temporal/samples/nexuscancellation/temporal-sample.yaml
 delete mode 100644 core/src/main/java/io/temporal/samples/nexuscontextpropagation/temporal-sample.yaml
 delete mode 100644 core/src/main/java/io/temporal/samples/nexusmultipleargs/temporal-sample.yaml
 create mode 100644 temporal-sample.yaml
 delete mode 100644 temporal-samples.yaml

diff --git a/core/src/main/java/io/temporal/samples/bookingsaga/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/bookingsaga/temporal-sample.yaml
deleted file mode 100644
index 42c0fdd5f..000000000
--- a/core/src/main/java/io/temporal/samples/bookingsaga/temporal-sample.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-description: Trip booking Saga pattern with compensation
-sdk_version: "1.32.1"
diff --git a/core/src/main/java/io/temporal/samples/dsl/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/dsl/temporal-sample.yaml
deleted file mode 100644
index 9b26e5c34..000000000
--- a/core/src/main/java/io/temporal/samples/dsl/temporal-sample.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-description: DSL-driven workflow steps defined in JSON
-sdk_version: "1.32.1"
diff --git a/core/src/main/java/io/temporal/samples/encryptedpayloads/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/encryptedpayloads/temporal-sample.yaml
deleted file mode 100644
index 4baa00042..000000000
--- a/core/src/main/java/io/temporal/samples/encryptedpayloads/temporal-sample.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-description: End-to-end payload encryption
-sdk_version: "1.32.1"
diff --git a/core/src/main/java/io/temporal/samples/fileprocessing/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/fileprocessing/temporal-sample.yaml
deleted file mode 100644
index 2fe01fff7..000000000
--- a/core/src/main/java/io/temporal/samples/fileprocessing/temporal-sample.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-description: Route tasks to specific Workers for host-local download/process/upload
-sdk_version: "1.32.1"
diff --git a/core/src/main/java/io/temporal/samples/hello/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/hello/temporal-sample.yaml
deleted file mode 100644
index fb9345f60..000000000
--- a/core/src/main/java/io/temporal/samples/hello/temporal-sample.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-description: Single-file hello world samples demonstrating core SDK features
-sdk_version: "1.32.1"
diff --git a/core/src/main/java/io/temporal/samples/moneytransfer/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/moneytransfer/temporal-sample.yaml
deleted file mode 100644
index 27021659b..000000000
--- a/core/src/main/java/io/temporal/samples/moneytransfer/temporal-sample.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-description: Separate processes for workflows, activities, and transfer requests
-sdk_version: "1.32.1"
diff --git a/core/src/main/java/io/temporal/samples/nexus/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/nexus/temporal-sample.yaml
deleted file mode 100644
index 07d98eeff..000000000
--- a/core/src/main/java/io/temporal/samples/nexus/temporal-sample.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-description: Nexus service definition and operation handlers
-sdk_version: "1.32.1"
diff --git a/core/src/main/java/io/temporal/samples/nexuscancellation/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/nexuscancellation/temporal-sample.yaml
deleted file mode 100644
index bed931803..000000000
--- a/core/src/main/java/io/temporal/samples/nexuscancellation/temporal-sample.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-description: Cancel a Nexus operation using WaitRequested cancellation
-sdk_version: "1.32.1"
diff --git a/core/src/main/java/io/temporal/samples/nexuscontextpropagation/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/nexuscontextpropagation/temporal-sample.yaml
deleted file mode 100644
index ec671f38e..000000000
--- a/core/src/main/java/io/temporal/samples/nexuscontextpropagation/temporal-sample.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-description: Propagate MDC context from Workflows to Nexus operations
-sdk_version: "1.32.1"
diff --git a/core/src/main/java/io/temporal/samples/nexusmultipleargs/temporal-sample.yaml b/core/src/main/java/io/temporal/samples/nexusmultipleargs/temporal-sample.yaml
deleted file mode 100644
index e0eafd626..000000000
--- a/core/src/main/java/io/temporal/samples/nexusmultipleargs/temporal-sample.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-description: Map a Nexus operation to a workflow with multiple input arguments
-sdk_version: "1.32.1"
diff --git a/temporal-sample.yaml b/temporal-sample.yaml
new file mode 100644
index 000000000..bab998c72
--- /dev/null
+++ b/temporal-sample.yaml
@@ -0,0 +1,62 @@
+version: 1
+language: java
+scaffold:
+  build.gradle: |
+    plugins { id 'java' }
+    repositories { mavenCentral() }
+    java { sourceCompatibility = JavaVersion.VERSION_11 }
+    dependencies {
+        implementation "io.temporal:temporal-sdk:{{sdk_version}}"
+        implementation "io.temporal:temporal-envconfig:{{sdk_version}}"
+        implementation "ch.qos.logback:logback-classic:1.5.6"
+        implementation "commons-lang:commons-lang:2.6"
+    }
+    task execute(type: JavaExec) {
+        mainClass = findProperty("mainClass") ?: ""
+        classpath = sourceSets.main.runtimeClasspath
+    }
+root_files:
+  - gradlew
+  - gradlew.bat
+  - gradle/
+samples:
+  - path: core/src/main/java/io/temporal/samples/hello
+    dest: src/main/java/io/temporal/samples/hello
+    description: Single-file hello world samples demonstrating core SDK features
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/nexus
+    dest: src/main/java/io/temporal/samples/nexus
+    description: Nexus service definition and operation handlers
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/nexuscancellation
+    dest: src/main/java/io/temporal/samples/nexuscancellation
+    description: Cancel a Nexus operation using WaitRequested cancellation
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/nexuscontextpropagation
+    dest: src/main/java/io/temporal/samples/nexuscontextpropagation
+    description: Propagate MDC context from Workflows to Nexus operations
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/nexusmultipleargs
+    dest: src/main/java/io/temporal/samples/nexusmultipleargs
+    description: Map a Nexus operation to a workflow with multiple input arguments
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/bookingsaga
+    dest: src/main/java/io/temporal/samples/bookingsaga
+    description: Trip booking Saga pattern with compensation
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/moneytransfer
+    dest: src/main/java/io/temporal/samples/moneytransfer
+    description: Separate processes for workflows, activities, and transfer requests
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/dsl
+    dest: src/main/java/io/temporal/samples/dsl
+    description: DSL-driven workflow steps defined in JSON
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/fileprocessing
+    dest: src/main/java/io/temporal/samples/fileprocessing
+    description: Route tasks to specific Workers for host-local download/process/upload
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/encryptedpayloads
+    dest: src/main/java/io/temporal/samples/encryptedpayloads
+    description: End-to-end payload encryption
+    sdk_version: "1.32.1"
diff --git a/temporal-samples.yaml b/temporal-samples.yaml
deleted file mode 100644
index b43907bad..000000000
--- a/temporal-samples.yaml
+++ /dev/null
@@ -1,23 +0,0 @@
-version: 1
-language: java
-repo: temporalio/samples-java
-scaffold:
-  build.gradle: |
-    plugins { id 'java' }
-    repositories { mavenCentral() }
-    java { sourceCompatibility = JavaVersion.VERSION_11 }
-    dependencies {
-        implementation "io.temporal:temporal-sdk:{{sdk_version}}"
-        implementation "io.temporal:temporal-envconfig:{{sdk_version}}"
-        implementation "ch.qos.logback:logback-classic:1.5.6"
-        implementation "commons-lang:commons-lang:2.6"
-    }
-    task execute(type: JavaExec) {
-        mainClass = findProperty("mainClass") ?: ""
-        classpath = sourceSets.main.runtimeClasspath
-    }
-sample_path: core/src/main/java/io/temporal/samples
-root_files:
-  - gradlew
-  - gradlew.bat
-  - gradle/

From f2f2aa2671a980fae286a7b34f6d75222727e362 Mon Sep 17 00:00:00 2001
From: Dan Davison <dan.davison@temporal.io>
Date: Sun, 15 Mar 2026 22:21:42 -0400
Subject: [PATCH 3/7] feat: complete temporal-sample.yaml with all samples

---
 temporal-sample.yaml | 120 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 120 insertions(+)

diff --git a/temporal-sample.yaml b/temporal-sample.yaml
index bab998c72..2f13b2df0 100644
--- a/temporal-sample.yaml
+++ b/temporal-sample.yaml
@@ -60,3 +60,123 @@ samples:
     dest: src/main/java/io/temporal/samples/encryptedpayloads
     description: End-to-end payload encryption
     sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/apikey
+    dest: src/main/java/io/temporal/samples/apikey
+    description: Connect to Temporal using API key authentication
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/asyncchild
+    dest: src/main/java/io/temporal/samples/asyncchild
+    description: Invoke a Child Workflow asynchronously outliving the parent
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/asyncuntypedchild
+    dest: src/main/java/io/temporal/samples/asyncuntypedchild
+    description: Invoke an untyped Child Workflow asynchronously outliving the parent
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/autoheartbeat
+    dest: src/main/java/io/temporal/samples/autoheartbeat
+    description: Auto-heartbeating interceptor for long-running activities
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/batch
+    dest: src/main/java/io/temporal/samples/batch
+    description: Batch processing patterns using sliding window, iterator, and heartbeating
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/bookingsyncsaga
+    dest: src/main/java/io/temporal/samples/bookingsyncsaga
+    description: Synchronous trip booking Saga with early client unblock via update
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/countinterceptor
+    dest: src/main/java/io/temporal/samples/countinterceptor
+    description: Worker and client interceptors that count executions, signals, and queries
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/customannotation
+    dest: src/main/java/io/temporal/samples/customannotation
+    description: Custom annotation via interceptor to mark exceptions as benign
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/customchangeversion
+    dest: src/main/java/io/temporal/samples/customchangeversion
+    description: Upsert a custom search attribute when adding workflow version changes
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/earlyreturn
+    dest: src/main/java/io/temporal/samples/earlyreturn
+    description: Early return from a workflow using Update-with-Start
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/encodefailures
+    dest: src/main/java/io/temporal/samples/encodefailures
+    description: Encode and decode failure messages using a payload codec
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/envconfig
+    dest: src/main/java/io/temporal/samples/envconfig
+    description: Configure the Temporal client from TOML configuration files
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/excludefrominterceptor
+    dest: src/main/java/io/temporal/samples/excludefrominterceptor
+    description: Exclude specific workflow and activity types from interceptors
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/getresultsasync
+    dest: src/main/java/io/temporal/samples/getresultsasync
+    description: Get workflow results asynchronously using getResultAsync
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/keymanagementencryption
+    dest: src/main/java/io/temporal/samples/keymanagementencryption
+    description: Payload encryption using the AWS Encryption SDK with KMS keyrings
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/listworkflows
+    dest: src/main/java/io/temporal/samples/listworkflows
+    description: List workflow executions using custom search attributes
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/metrics
+    dest: src/main/java/io/temporal/samples/metrics
+    description: Set up SDK metrics with a Prometheus scrape endpoint
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/moneybatch
+    dest: src/main/java/io/temporal/samples/moneybatch
+    description: Batch multiple withdrawals into a single deposit using signal-with-start
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/packetdelivery
+    dest: src/main/java/io/temporal/samples/packetdelivery
+    description: Parallel async packet deliveries with per-item cancellation support
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/payloadconverter
+    dest: src/main/java/io/temporal/samples/payloadconverter
+    description: Custom payload converters for crypto and CloudEvents serialization
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/peractivityoptions
+    dest: src/main/java/io/temporal/samples/peractivityoptions
+    description: Set per-activity-type options via WorkflowImplementationOptions
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/polling
+    dest: src/main/java/io/temporal/samples/polling
+    description: Polling patterns for frequent, infrequent, and periodic activity execution
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/retryonsignalinterceptor
+    dest: src/main/java/io/temporal/samples/retryonsignalinterceptor
+    description: Interceptor that waits for a signal to retry or fail an activity
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/safemessagepassing
+    dest: src/main/java/io/temporal/samples/safemessagepassing
+    description: Safe signal and update handling with locking and continue-as-new
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/sleepfordays
+    dest: src/main/java/io/temporal/samples/sleepfordays
+    description: Workflow that periodically sleeps for days between actions
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/ssl
+    dest: src/main/java/io/temporal/samples/ssl
+    description: Connect to Temporal using mTLS authentication
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/terminateworkflow
+    dest: src/main/java/io/temporal/samples/terminateworkflow
+    description: Terminate a workflow execution using the client API
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/tracing
+    dest: src/main/java/io/temporal/samples/tracing
+    description: Distributed tracing with OpenTracing and OpenTelemetry via Jaeger
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/updatabletimer
+    dest: src/main/java/io/temporal/samples/updatabletimer
+    description: Blocking sleep that can be updated via signal at any time
+    sdk_version: "1.32.1"
+  - path: core/src/main/java/io/temporal/samples/workerversioning
+    dest: src/main/java/io/temporal/samples/workerversioning
+    description: Worker Versioning with auto-upgrading and pinned workflow deployments
+    sdk_version: "1.32.1"

From 726debd93d7724a73eda1114200d355432263713 Mon Sep 17 00:00:00 2001
From: Dan Davison <dan.davison@temporal.io>
Date: Sun, 15 Mar 2026 22:52:54 -0400
Subject: [PATCH 4/7] feat: add run commands to sample manifest

---
 temporal-sample.yaml | 146 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 146 insertions(+)

diff --git a/temporal-sample.yaml b/temporal-sample.yaml
index 2f13b2df0..63f1527a1 100644
--- a/temporal-sample.yaml
+++ b/temporal-sample.yaml
@@ -24,159 +24,305 @@ samples:
     dest: src/main/java/io/temporal/samples/hello
     description: Single-file hello world samples demonstrating core SDK features
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.hello.HelloActivity"
   - path: core/src/main/java/io/temporal/samples/nexus
     dest: src/main/java/io/temporal/samples/nexus
     description: Nexus service definition and operation handlers
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "temporal operator namespace create --namespace my-target-namespace"
+      - cmd: "temporal operator namespace create --namespace my-caller-namespace"
+      - cmd: "temporal operator nexus endpoint create --name my-nexus-endpoint-name --target-namespace my-target-namespace --target-task-queue my-handler-task-queue --description-file ./src/main/java/io/temporal/samples/nexus/service/description.md"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.nexus.handler.HandlerWorker --args=\"-target-host localhost:7233 -namespace my-target-namespace\""
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.nexus.caller.CallerWorker --args=\"-target-host localhost:7233 -namespace my-caller-namespace\""
+        new_terminal: true
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.nexus.caller.CallerStarter --args=\"-target-host localhost:7233 -namespace my-caller-namespace\""
+        new_terminal: true
   - path: core/src/main/java/io/temporal/samples/nexuscancellation
     dest: src/main/java/io/temporal/samples/nexuscancellation
     description: Cancel a Nexus operation using WaitRequested cancellation
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "temporal operator namespace create --namespace my-target-namespace"
+      - cmd: "temporal operator namespace create --namespace my-caller-namespace"
+      - cmd: "temporal operator nexus endpoint create --name my-nexus-endpoint-name --target-namespace my-target-namespace --target-task-queue my-handler-task-queue --description-file ./src/main/java/io/temporal/samples/nexus/service/description.md"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.nexuscancellation.handler.HandlerWorker --args=\"-target-host localhost:7233 -namespace my-target-namespace\""
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.nexuscancellation.caller.CallerWorker --args=\"-target-host localhost:7233 -namespace my-caller-namespace\""
+        new_terminal: true
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.nexuscancellation.caller.CallerStarter --args=\"-target-host localhost:7233 -namespace my-caller-namespace\""
+        new_terminal: true
   - path: core/src/main/java/io/temporal/samples/nexuscontextpropagation
     dest: src/main/java/io/temporal/samples/nexuscontextpropagation
     description: Propagate MDC context from Workflows to Nexus operations
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "temporal operator namespace create --namespace my-target-namespace"
+      - cmd: "temporal operator namespace create --namespace my-caller-namespace"
+      - cmd: "temporal operator nexus endpoint create --name my-nexus-endpoint-name --target-namespace my-target-namespace --target-task-queue my-handler-task-queue --description-file ./src/main/java/io/temporal/samples/nexus/service/description.md"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.nexuscontextpropagation.handler.HandlerWorker --args=\"-target-host localhost:7233 -namespace my-target-namespace\""
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.nexuscontextpropagation.caller.CallerWorker --args=\"-target-host localhost:7233 -namespace my-caller-namespace\""
+        new_terminal: true
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.nexuscontextpropagation.caller.CallerStarter --args=\"-target-host localhost:7233 -namespace my-caller-namespace\""
+        new_terminal: true
   - path: core/src/main/java/io/temporal/samples/nexusmultipleargs
     dest: src/main/java/io/temporal/samples/nexusmultipleargs
     description: Map a Nexus operation to a workflow with multiple input arguments
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "temporal operator namespace create --namespace my-target-namespace"
+      - cmd: "temporal operator namespace create --namespace my-caller-namespace"
+      - cmd: "temporal operator nexus endpoint create --name my-nexus-endpoint-name --target-namespace my-target-namespace --target-task-queue my-handler-task-queue --description-file ./src/main/java/io/temporal/samples/nexus/service/description.md"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.nexusmultipleargs.handler.HandlerWorker --args=\"-target-host localhost:7233 -namespace my-target-namespace\""
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.nexusmultipleargs.caller.CallerWorker --args=\"-target-host localhost:7233 -namespace my-caller-namespace\""
+        new_terminal: true
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.nexusmultipleargs.caller.CallerStarter --args=\"-target-host localhost:7233 -namespace my-caller-namespace\""
+        new_terminal: true
   - path: core/src/main/java/io/temporal/samples/bookingsaga
     dest: src/main/java/io/temporal/samples/bookingsaga
     description: Trip booking Saga pattern with compensation
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.bookingsaga.TripBookingSaga"
   - path: core/src/main/java/io/temporal/samples/moneytransfer
     dest: src/main/java/io/temporal/samples/moneytransfer
     description: Separate processes for workflows, activities, and transfer requests
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.moneytransfer.AccountTransferWorker"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.moneytransfer.AccountActivityWorker"
+        new_terminal: true
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.moneytransfer.TransferRequester"
+        new_terminal: true
   - path: core/src/main/java/io/temporal/samples/dsl
     dest: src/main/java/io/temporal/samples/dsl
     description: DSL-driven workflow steps defined in JSON
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.dsl.Starter"
   - path: core/src/main/java/io/temporal/samples/fileprocessing
     dest: src/main/java/io/temporal/samples/fileprocessing
     description: Route tasks to specific Workers for host-local download/process/upload
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.fileprocessing.FileProcessingWorker"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.fileprocessing.FileProcessingStarter"
+        new_terminal: true
   - path: core/src/main/java/io/temporal/samples/encryptedpayloads
     dest: src/main/java/io/temporal/samples/encryptedpayloads
     description: End-to-end payload encryption
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.encryptedpayloads.EncryptedPayloadsActivity"
   - path: core/src/main/java/io/temporal/samples/apikey
     dest: src/main/java/io/temporal/samples/apikey
     description: Connect to Temporal using API key authentication
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.apikey.ApiKeyWorker"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.apikey.Starter"
+        new_terminal: true
   - path: core/src/main/java/io/temporal/samples/asyncchild
     dest: src/main/java/io/temporal/samples/asyncchild
     description: Invoke a Child Workflow asynchronously outliving the parent
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.asyncchild.Starter"
   - path: core/src/main/java/io/temporal/samples/asyncuntypedchild
     dest: src/main/java/io/temporal/samples/asyncuntypedchild
     description: Invoke an untyped Child Workflow asynchronously outliving the parent
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.asyncuntypedchild.Starter"
   - path: core/src/main/java/io/temporal/samples/autoheartbeat
     dest: src/main/java/io/temporal/samples/autoheartbeat
     description: Auto-heartbeating interceptor for long-running activities
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.autoheartbeat.Starter"
   - path: core/src/main/java/io/temporal/samples/batch
     dest: src/main/java/io/temporal/samples/batch
     description: Batch processing patterns using sliding window, iterator, and heartbeating
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.batch.slidingwindow.SlidingWindowBatchWorker"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.batch.slidingwindow.SlidingWindowBatchStarter"
+        new_terminal: true
   - path: core/src/main/java/io/temporal/samples/bookingsyncsaga
     dest: src/main/java/io/temporal/samples/bookingsyncsaga
     description: Synchronous trip booking Saga with early client unblock via update
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.bookingsyncsaga.TripBookingWorker"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.bookingsyncsaga.TripBookingClient"
+        new_terminal: true
   - path: core/src/main/java/io/temporal/samples/countinterceptor
     dest: src/main/java/io/temporal/samples/countinterceptor
     description: Worker and client interceptors that count executions, signals, and queries
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.countinterceptor.InterceptorStarter"
   - path: core/src/main/java/io/temporal/samples/customannotation
     dest: src/main/java/io/temporal/samples/customannotation
     description: Custom annotation via interceptor to mark exceptions as benign
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.customannotation.CustomAnnotation"
   - path: core/src/main/java/io/temporal/samples/customchangeversion
     dest: src/main/java/io/temporal/samples/customchangeversion
     description: Upsert a custom search attribute when adding workflow version changes
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.customchangeversion.CustomChangeVersionStarter"
   - path: core/src/main/java/io/temporal/samples/earlyreturn
     dest: src/main/java/io/temporal/samples/earlyreturn
     description: Early return from a workflow using Update-with-Start
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.earlyreturn.EarlyReturnWorker"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.earlyreturn.EarlyReturnClient"
+        new_terminal: true
   - path: core/src/main/java/io/temporal/samples/encodefailures
     dest: src/main/java/io/temporal/samples/encodefailures
     description: Encode and decode failure messages using a payload codec
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.encodefailures.Starter"
   - path: core/src/main/java/io/temporal/samples/envconfig
     dest: src/main/java/io/temporal/samples/envconfig
     description: Configure the Temporal client from TOML configuration files
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.envconfig.LoadFromFile"
   - path: core/src/main/java/io/temporal/samples/excludefrominterceptor
     dest: src/main/java/io/temporal/samples/excludefrominterceptor
     description: Exclude specific workflow and activity types from interceptors
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.excludefrominterceptor.RunMyWorkflows"
   - path: core/src/main/java/io/temporal/samples/getresultsasync
     dest: src/main/java/io/temporal/samples/getresultsasync
     description: Get workflow results asynchronously using getResultAsync
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.getresultsasync.Worker"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.getresultsasync.Starter"
+        new_terminal: true
   - path: core/src/main/java/io/temporal/samples/keymanagementencryption
     dest: src/main/java/io/temporal/samples/keymanagementencryption
     description: Payload encryption using the AWS Encryption SDK with KMS keyrings
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.keymanagementencryption.awsencryptionsdk.EncryptedPayloads"
   - path: core/src/main/java/io/temporal/samples/listworkflows
     dest: src/main/java/io/temporal/samples/listworkflows
     description: List workflow executions using custom search attributes
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.listworkflows.Starter"
   - path: core/src/main/java/io/temporal/samples/metrics
     dest: src/main/java/io/temporal/samples/metrics
     description: Set up SDK metrics with a Prometheus scrape endpoint
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.metrics.MetricsWorker"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.metrics.MetricsStarter"
+        new_terminal: true
   - path: core/src/main/java/io/temporal/samples/moneybatch
     dest: src/main/java/io/temporal/samples/moneybatch
     description: Batch multiple withdrawals into a single deposit using signal-with-start
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.moneybatch.AccountTransferWorker"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.moneybatch.AccountActivityWorker"
+        new_terminal: true
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.moneybatch.TransferRequester"
+        new_terminal: true
   - path: core/src/main/java/io/temporal/samples/packetdelivery
     dest: src/main/java/io/temporal/samples/packetdelivery
     description: Parallel async packet deliveries with per-item cancellation support
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.packetdelivery.Starter"
   - path: core/src/main/java/io/temporal/samples/payloadconverter
     dest: src/main/java/io/temporal/samples/payloadconverter
     description: Custom payload converters for crypto and CloudEvents serialization
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.payloadconverter.crypto.Starter"
   - path: core/src/main/java/io/temporal/samples/peractivityoptions
     dest: src/main/java/io/temporal/samples/peractivityoptions
     description: Set per-activity-type options via WorkflowImplementationOptions
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.peractivityoptions.Starter"
   - path: core/src/main/java/io/temporal/samples/polling
     dest: src/main/java/io/temporal/samples/polling
     description: Polling patterns for frequent, infrequent, and periodic activity execution
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.polling.frequent.FrequentPollingStarter"
   - path: core/src/main/java/io/temporal/samples/retryonsignalinterceptor
     dest: src/main/java/io/temporal/samples/retryonsignalinterceptor
     description: Interceptor that waits for a signal to retry or fail an activity
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.retryonsignalinterceptor.MyWorkflowWorker"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.retryonsignalinterceptor.RetryRequester"
+        new_terminal: true
   - path: core/src/main/java/io/temporal/samples/safemessagepassing
     dest: src/main/java/io/temporal/samples/safemessagepassing
     description: Safe signal and update handling with locking and continue-as-new
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.safemessagepassing.ClusterManagerWorkflowWorker"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.safemessagepassing.ClusterManagerWorkflowStarter"
+        new_terminal: true
   - path: core/src/main/java/io/temporal/samples/sleepfordays
     dest: src/main/java/io/temporal/samples/sleepfordays
     description: Workflow that periodically sleeps for days between actions
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.sleepfordays.Worker"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.sleepfordays.Starter"
+        new_terminal: true
   - path: core/src/main/java/io/temporal/samples/ssl
     dest: src/main/java/io/temporal/samples/ssl
     description: Connect to Temporal using mTLS authentication
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.ssl.Starter"
   - path: core/src/main/java/io/temporal/samples/terminateworkflow
     dest: src/main/java/io/temporal/samples/terminateworkflow
     description: Terminate a workflow execution using the client API
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.terminateworkflow.Starter"
   - path: core/src/main/java/io/temporal/samples/tracing
     dest: src/main/java/io/temporal/samples/tracing
     description: Distributed tracing with OpenTracing and OpenTelemetry via Jaeger
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.tracing.TracingWorker"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.tracing.Starter"
+        new_terminal: true
   - path: core/src/main/java/io/temporal/samples/updatabletimer
     dest: src/main/java/io/temporal/samples/updatabletimer
     description: Blocking sleep that can be updated via signal at any time
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.updatabletimer.DynamicSleepWorkflowWorker"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.updatabletimer.DynamicSleepWorkflowStarter"
+        new_terminal: true
   - path: core/src/main/java/io/temporal/samples/workerversioning
     dest: src/main/java/io/temporal/samples/workerversioning
     description: Worker Versioning with auto-upgrading and pinned workflow deployments
     sdk_version: "1.32.1"
+    commands:
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.workerversioning.Starter"
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.workerversioning.WorkerV1"
+        new_terminal: true
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.workerversioning.WorkerV1_1"
+        new_terminal: true
+      - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.workerversioning.WorkerV2"
+        new_terminal: true

From e523c22610dc0698d77738b89eecb8d32643fbbd Mon Sep 17 00:00:00 2001
From: Dan Davison <dan.davison@temporal.io>
Date: Sun, 15 Mar 2026 23:02:17 -0400
Subject: [PATCH 5/7] fix: remove description-file refs from nexus samples that
 lack the file

nexuscancellation, nexuscontextpropagation, and nexusmultipleargs were
referencing ./src/main/java/io/temporal/samples/nexus/service/description.md
which only exists in the nexus sample directory.
---
 temporal-sample.yaml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/temporal-sample.yaml b/temporal-sample.yaml
index 63f1527a1..20732e5d3 100644
--- a/temporal-sample.yaml
+++ b/temporal-sample.yaml
@@ -46,7 +46,7 @@ samples:
     commands:
       - cmd: "temporal operator namespace create --namespace my-target-namespace"
       - cmd: "temporal operator namespace create --namespace my-caller-namespace"
-      - cmd: "temporal operator nexus endpoint create --name my-nexus-endpoint-name --target-namespace my-target-namespace --target-task-queue my-handler-task-queue --description-file ./src/main/java/io/temporal/samples/nexus/service/description.md"
+      - cmd: "temporal operator nexus endpoint create --name my-nexus-endpoint-name --target-namespace my-target-namespace --target-task-queue my-handler-task-queue"
       - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.nexuscancellation.handler.HandlerWorker --args=\"-target-host localhost:7233 -namespace my-target-namespace\""
       - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.nexuscancellation.caller.CallerWorker --args=\"-target-host localhost:7233 -namespace my-caller-namespace\""
         new_terminal: true
@@ -59,7 +59,7 @@ samples:
     commands:
       - cmd: "temporal operator namespace create --namespace my-target-namespace"
       - cmd: "temporal operator namespace create --namespace my-caller-namespace"
-      - cmd: "temporal operator nexus endpoint create --name my-nexus-endpoint-name --target-namespace my-target-namespace --target-task-queue my-handler-task-queue --description-file ./src/main/java/io/temporal/samples/nexus/service/description.md"
+      - cmd: "temporal operator nexus endpoint create --name my-nexus-endpoint-name --target-namespace my-target-namespace --target-task-queue my-handler-task-queue"
       - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.nexuscontextpropagation.handler.HandlerWorker --args=\"-target-host localhost:7233 -namespace my-target-namespace\""
       - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.nexuscontextpropagation.caller.CallerWorker --args=\"-target-host localhost:7233 -namespace my-caller-namespace\""
         new_terminal: true
@@ -72,7 +72,7 @@ samples:
     commands:
       - cmd: "temporal operator namespace create --namespace my-target-namespace"
       - cmd: "temporal operator namespace create --namespace my-caller-namespace"
-      - cmd: "temporal operator nexus endpoint create --name my-nexus-endpoint-name --target-namespace my-target-namespace --target-task-queue my-handler-task-queue --description-file ./src/main/java/io/temporal/samples/nexus/service/description.md"
+      - cmd: "temporal operator nexus endpoint create --name my-nexus-endpoint-name --target-namespace my-target-namespace --target-task-queue my-handler-task-queue"
       - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.nexusmultipleargs.handler.HandlerWorker --args=\"-target-host localhost:7233 -namespace my-target-namespace\""
       - cmd: "./gradlew -q execute -PmainClass=io.temporal.samples.nexusmultipleargs.caller.CallerWorker --args=\"-target-host localhost:7233 -namespace my-caller-namespace\""
         new_terminal: true

From 3aa4ab7d9dc94aae1a5dd9138b19fa94a6f7edc1 Mon Sep 17 00:00:00 2001
From: Dan Davison <dan.davison@temporal.io>
Date: Sun, 15 Mar 2026 23:21:37 -0400
Subject: [PATCH 6/7] feat: add include for nexus base package in nexus variant
 samples

nexuscancellation, nexuscontextpropagation, and nexusmultipleargs
import classes from the base nexus package. The include field tells
the CLI to extract the nexus package alongside the variant.
---
 temporal-sample.yaml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/temporal-sample.yaml b/temporal-sample.yaml
index 20732e5d3..10f50e9b9 100644
--- a/temporal-sample.yaml
+++ b/temporal-sample.yaml
@@ -43,6 +43,9 @@ samples:
     dest: src/main/java/io/temporal/samples/nexuscancellation
     description: Cancel a Nexus operation using WaitRequested cancellation
     sdk_version: "1.32.1"
+    include:
+      - path: core/src/main/java/io/temporal/samples/nexus
+        dest: src/main/java/io/temporal/samples/nexus
     commands:
       - cmd: "temporal operator namespace create --namespace my-target-namespace"
       - cmd: "temporal operator namespace create --namespace my-caller-namespace"
@@ -56,6 +59,9 @@ samples:
     dest: src/main/java/io/temporal/samples/nexuscontextpropagation
     description: Propagate MDC context from Workflows to Nexus operations
     sdk_version: "1.32.1"
+    include:
+      - path: core/src/main/java/io/temporal/samples/nexus
+        dest: src/main/java/io/temporal/samples/nexus
     commands:
       - cmd: "temporal operator namespace create --namespace my-target-namespace"
       - cmd: "temporal operator namespace create --namespace my-caller-namespace"
@@ -69,6 +75,9 @@ samples:
     dest: src/main/java/io/temporal/samples/nexusmultipleargs
     description: Map a Nexus operation to a workflow with multiple input arguments
     sdk_version: "1.32.1"
+    include:
+      - path: core/src/main/java/io/temporal/samples/nexus
+        dest: src/main/java/io/temporal/samples/nexus
     commands:
       - cmd: "temporal operator namespace create --namespace my-target-namespace"
       - cmd: "temporal operator namespace create --namespace my-caller-namespace"

From 022bcec4a414aae77042d5160289022643a5237e Mon Sep 17 00:00:00 2001
From: Dan Davison <dan.davison@temporal.io>
Date: Sun, 15 Mar 2026 23:28:14 -0400
Subject: [PATCH 7/7] fix: add commons-cli to scaffold build.gradle

Required by the nexus ClientOptions class which is included as a
dependency of the nexus variant samples.
---
 temporal-sample.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/temporal-sample.yaml b/temporal-sample.yaml
index 10f50e9b9..7161547e2 100644
--- a/temporal-sample.yaml
+++ b/temporal-sample.yaml
@@ -10,6 +10,7 @@ scaffold:
         implementation "io.temporal:temporal-envconfig:{{sdk_version}}"
         implementation "ch.qos.logback:logback-classic:1.5.6"
         implementation "commons-lang:commons-lang:2.6"
+        implementation "commons-cli:commons-cli:1.9.0"
     }
     task execute(type: JavaExec) {
         mainClass = findProperty("mainClass") ?: ""