From b506bbcedc30bc93b6067f3d012768c822d2ac66 Mon Sep 17 00:00:00 2001
From: pultormi <pultormi@amazon.com>
Date: Thu, 3 Sep 2026 11:31:44 -0700
Subject: [PATCH] Fix release & add readme for --v2

---
 .github/workflows/pypi-release.yaml |  5 +++--
 README.md                           | 24 ++++++++++++++++++++++++
 src/rpdk/core/__init__.py           |  2 +-
 3 files changed, 28 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/pypi-release.yaml b/.github/workflows/pypi-release.yaml
index 20b83e7c..171f32db 100644
--- a/.github/workflows/pypi-release.yaml
+++ b/.github/workflows/pypi-release.yaml
@@ -20,10 +20,11 @@ jobs:
         cache: 'pip'
     - name: Install dependencies
       run: |
-        pip install --upgrade wheel twine
+        pip install --upgrade pip
+        pip install --upgrade wheel twine build
     - name: Package project
       run: |
-        python setup.py sdist bdist_wheel
+        python -m build
     - name: Publish distribution 📦 to PyPI (If triggered from release)
       uses: pypa/gh-action-pypi-publish@release/v1
       with:
diff --git a/README.md b/README.md
index 849194cc..c2ce507a 100644
--- a/README.md
+++ b/README.md
@@ -96,6 +96,30 @@ Install PYJQ for Ubuntu system
 pip install pyjq
 ```
 
+#### Running contract tests with `--v2`
+
+`cfn test --v2` is an opt-in flag that runs the contract tests through the RQTS (CTv2) executor in a Docker container instead of the default pytest-based suite. Without `--v2`, the existing behavior is unchanged.
+
+```bash
+cfn test --v2
+cfn test --v2 --region us-west-2 --profile my-profile
+cfn test --v2 --typeconfig ./myResourceTypeConfig.json # type configuration is passed through to the executor
+cfn test --v2 --rqts-image my-registry/my-executor:my-tag # override the CLI-pinned executor image
+```
+
+The runner checks all of the following before starting the container, and reports every unmet requirement at once:
+
+* Docker is installed and the daemon is reachable.
+* The project is a **Java** resource type. Hook and module projects are not supported, and other language plugins do not produce an artifact the executor can load.
+* The project has been built, so that `<hyphenated-type-name>.zip` exists in the project root. Run `cfn generate` and your language plugin's build first.
+* AWS credentials and a region resolve and pass `sts:GetCallerIdentity`.
+
+Notes:
+
+* Scenario selection is owned by the executor image, so pytest-style arguments such as `-- -k contract_delete_update` are silently ignored on the `--v2` path. Test inputs are read from the ones packaged inside the artifact zip.
+* Executor output is written to `rqts-output/` in the project root, and per-scenario results are streamed to the console as the container runs.
+* The default image reference follows the `latest` tag on [ECR Public](https://gallery.ecr.aws/), matching what the cloud contract-test path runs. The CLI attempts a pull on each run and falls back to a locally cached image when the registry is unreachable.
+
 ### Command: validate
 
 To validate the schema, use the `validate` command.
diff --git a/src/rpdk/core/__init__.py b/src/rpdk/core/__init__.py
index 6aead28a..85d7a6cc 100644
--- a/src/rpdk/core/__init__.py
+++ b/src/rpdk/core/__init__.py
@@ -1,5 +1,5 @@
 import logging
 
-__version__ = "0.2.40"
+__version__ = "0.2.41"
 
 logging.getLogger(__name__).addHandler(logging.NullHandler())