From c80fafd0b5d1d2eea941b6616a803a3cda653e43 Mon Sep 17 00:00:00 2001
From: peverwhee <courtneyp@ucar.edu>
Date: Mon, 1 Dec 2025 10:29:56 -0700
Subject: [PATCH 1/3] add --fresh argument to cmake command examples

---
 test/README.md                        | 4 ++--
 test/advection_test/README.md         | 2 +-
 test/capgen_test/README.md            | 2 +-
 test/ddthost_test/README.md           | 2 +-
 test/var_compatibility_test/README.md | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/test/README.md b/test/README.md
index 9b8d808c..ba5978aa 100644
--- a/test/README.md
+++ b/test/README.md
@@ -14,7 +14,7 @@ $ pytest -v <root_project_source_directory>/scripts/ --doctest-modules
 The run the regression tests with mock host models, build the main project with your test option:
 
 ```bash
-$ cmake -S<root_project_source_directory> -B<build_directory> <options>...
+$ cmake --fresh -S<root_project_source_directory> -B<build_directory> <options>...
 $ cd <build_directory>
 $ make
 $ ctest
@@ -22,7 +22,7 @@ $ ctest
 
 For example, to run all of the regression tests from the root of the project, you can use:
 ```bash
-cmake -B./build -S./ -DCCPP_FRAMEWORK_ENABLE_TESTS=ON
+cmake --fresh -B./build -S./ -DCCPP_FRAMEWORK_ENABLE_TESTS=ON
 ```
 
 Currently (as of July 2025), if everything works as expected, you should see something like:
diff --git a/test/advection_test/README.md b/test/advection_test/README.md
index ce3e285d..6dd53e9f 100644
--- a/test/advection_test/README.md
+++ b/test/advection_test/README.md
@@ -14,7 +14,7 @@ Contains tests to exercise the capabilities of the constituents object, includin
 To explicitly build/run the advection test host, run:
 
 ```bash
-$ cmake -S<path_to_project_root> -B<path_to_build> -DCCPP_RUN_ADVECTION_TEST=ON
+$ cmake --fresh -S<path_to_project_root> -B<path_to_build> -DCCPP_RUN_ADVECTION_TEST=ON
 $ cd <path_to_build>
 $ make
 $ ctest
diff --git a/test/capgen_test/README.md b/test/capgen_test/README.md
index 9a320332..bcc0e628 100644
--- a/test/capgen_test/README.md
+++ b/test/capgen_test/README.md
@@ -16,7 +16,7 @@ Contains tests for overall capgen capabilities such as:
 To explicitly build/run the capgen test host, run:
 
 ```bash
-$ cmake -S<path_to_project_root> -B<path_to_build> -DCCPP_RUN_CAPGEN_TEST=ON
+$ cmake --fresh -S<path_to_project_root> -B<path_to_build> -DCCPP_RUN_CAPGEN_TEST=ON
 $ cd <path_to_build>
 $ make
 $ ctest
diff --git a/test/ddthost_test/README.md b/test/ddthost_test/README.md
index 292722dc..9c90d754 100644
--- a/test/ddthost_test/README.md
+++ b/test/ddthost_test/README.md
@@ -9,7 +9,7 @@ Contains tests to exercise more DDT functionality:
 To explicitly build/run the ddt test host, run:
 
 ```bash
-$ cmake -S<path_to_project_root> -B<path_to_build> -DCCPP_RUN_DDT_HOST_TEST=ON
+$ cmake --fresh -S<path_to_project_root> -B<path_to_build> -DCCPP_RUN_DDT_HOST_TEST=ON
 $ cd <path_to_build>
 $ make
 $ ctest
diff --git a/test/var_compatibility_test/README.md b/test/var_compatibility_test/README.md
index a8beecf2..d5573f3a 100644
--- a/test/var_compatibility_test/README.md
+++ b/test/var_compatibility_test/README.md
@@ -16,7 +16,7 @@ Tests the variable compatibility object (`VarCompatObj`):
 To explicitly build/run the variable compatibility test host, run:
 
 ```bash
-$ cmake -S<path_to_project_root> -B<path_to_build> -DCCPP_RUN_VAR_COMPATIBILITY_TEST=ON
+$ cmake --fresh -S<path_to_project_root> -B<path_to_build> -DCCPP_RUN_VAR_COMPATIBILITY_TEST=ON
 $ cd <path_to_build>
 $ make
 $ ctest

From 0b281197895883105b4000ee2e0e32ea5dc1e584 Mon Sep 17 00:00:00 2001
From: peverwhee <courtneyp@ucar.edu>
Date: Mon, 1 Dec 2025 11:00:23 -0700
Subject: [PATCH 2/3] add fresh flag to workflow

---
 .github/workflows/capgen_unit_tests.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/capgen_unit_tests.yaml b/.github/workflows/capgen_unit_tests.yaml
index 7247100f..461a8809 100644
--- a/.github/workflows/capgen_unit_tests.yaml
+++ b/.github/workflows/capgen_unit_tests.yaml
@@ -29,7 +29,7 @@ jobs:
 
     - name: Build the framework
       run: |
-        cmake -S. -B./build -DOPENMP=ON -DCCPP_FRAMEWORK_ENABLE_TESTS=ON
+        cmake --fresh -S. -B./build -DOPENMP=ON -DCCPP_FRAMEWORK_ENABLE_TESTS=ON
         cd build
         make
 

From cdb180a171fefd403262b0b0c3045a03d39620a0 Mon Sep 17 00:00:00 2001
From: Dom Heinzeller <dom.heinzeller@icloud.com>
Date: Thu, 4 Dec 2025 12:02:43 -0700
Subject: [PATCH 3/3] Update README.md

Add --fresh for cmake call in nested suite README
---
 test/nested_suite_test/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/test/nested_suite_test/README.md b/test/nested_suite_test/README.md
index 0c2033db..d3c3182f 100644
--- a/test/nested_suite_test/README.md
+++ b/test/nested_suite_test/README.md
@@ -11,7 +11,7 @@ Tests the capability to process nested suites:
 To explicitly build/run the nested suite test host, run:
 
 ```bash
-$ cmake -S<path_to_project_root> -B<path_to_build> -DCCPP_RUN_NESTED_SUITE_TEST=ON
+$ cmake --fresh -S<path_to_project_root> -B<path_to_build> -DCCPP_RUN_NESTED_SUITE_TEST=ON
 $ cd <path_to_build>
 $ make
 $ ctest