Release v4.8.1 (#3950)

Author: github-actions[bot]

cumulusci/__about__.py

@@ -1 +1 @@
-__version__ = "4.8.0"
+__version__ = "4.8.1"

docs/history.md

@@ -2,6 +2,20 @@
 
 <!-- latest-start -->
 
+## v4.8.1 (2026-01-30)
+
+<!-- Release notes generated using configuration in .github/release.yml at main -->
+
+## What's Changed
+
+### Changes
+
+-   @W-20921403: Smart Lookup Resolution for Mixed Salesforce IDs and Local References by [@aditya-balachander](https://github.com/aditya-balachander) in [#3946](https://github.com/SFDO-Tooling/CumulusCI/pull/3946)
+
+**Full Changelog**: https://github.com/SFDO-Tooling/CumulusCI/compare/v4.8.0...v4.8.1
+
+<!-- latest-stop -->
+
 ## v4.8.0 (2026-01-06)
 
 <!-- Release notes generated using configuration in .github/release.yml at main -->
@@ -14,8 +28,6 @@
 
 **Full Changelog**: https://github.com/SFDO-Tooling/CumulusCI/compare/v4.7.0...v4.8.0
 
-<!-- latest-stop -->
-
 ## v4.7.0 (2025-12-19)
 
 <!-- Release notes generated using configuration in .github/release.yml at main -->
@@ -1888,9 +1900,9 @@ Critical Changes:
         subfolders will see a change in resolution behavior. Previously,
         a dependency specified like this:
 
-                                          dependencies:
-                                              - github: https://github.com/SalesforceFoundation/NPSP
-                                                subfolder: unpackaged/config/trial
+                                            dependencies:
+                                                - github: https://github.com/SalesforceFoundation/NPSP
+                                                  subfolder: unpackaged/config/trial
 
         would always deploy from the latest commit on the default
         branch. Now, this dependency will be resolved to a GitHub commit
@@ -1901,12 +1913,12 @@ Critical Changes:
     -   The `project__dependencies` section in `cumulusci.yml` no longer
         supports nested dependencies specified like this:
 
-                                          dependencies:
-                                              - namespace: "test"
-                                                version: "1.0"
-                                                dependencies:
-                                                  - namespace: "parent"
-                                                    version: "2.2"
+                                            dependencies:
+                                                - namespace: "test"
+                                                  version: "1.0"
+                                                  dependencies:
+                                                    - namespace: "parent"
+                                                      version: "2.2"
 
         All dependencies should be listed in install order.
 
@@ -2075,12 +2087,12 @@ Critical changes:
     -   The `project__dependencies` section in `cumulusci.yml` will no
         longer support nested dependencies specified like this :
 
-                                          dependencies:
-                                            - namespace: "test"
-                                              version: "1.0"
-                                              dependencies:
-                                                - namespace: "parent"
-                                                  version: "2.2"
+                                            dependencies:
+                                              - namespace: "test"
+                                                version: "1.0"
+                                                dependencies:
+                                                  - namespace: "parent"
+                                                    version: "2.2"
 
     All dependencies should be listed in install order.
 
@@ -3687,33 +3699,33 @@ New features:
 
     : -
 
-                                          Added keywords for generating a collection of sObjects according to a template:
+                                            Added keywords for generating a collection of sObjects according to a template:
 
-                                          :   -   `Generate Test Data`
-                                              -   `Salesforce Collection Insert`
-                                              -   `Salesforce Collection Update`
+                                            :   -   `Generate Test Data`
+                                                -   `Salesforce Collection Insert`
+                                                -   `Salesforce Collection Update`
 
-                                      -
+                                        -
 
-                                          Changes to Page Objects:
+                                            Changes to Page Objects:
 
-                                          :   -   More than one page object can be loaded at once.
-                                                  Once loaded, the keywords of a page object remain
-                                                  visible in the suite. Robot will give priority to
-                                                  keywords in the reverse order in which they were
-                                                  imported.
-                                              -   There is a new keyword, `Log Current Page Object`,
-                                                  which can be useful to see information about the
-                                                  most recently loaded page object.
-                                              -   There is a new keyword, `Get Page Object`, which
-                                                  will return the robot library for a given page
-                                                  object. This can be used in other keywords to access
-                                                  keywords from another page object if necessary.
-                                              -   The `Go To Page` keyword will now automatically load
-                                                  the page object for the given page.
+                                            :   -   More than one page object can be loaded at once.
+                                                    Once loaded, the keywords of a page object remain
+                                                    visible in the suite. Robot will give priority to
+                                                    keywords in the reverse order in which they were
+                                                    imported.
+                                                -   There is a new keyword, `Log Current Page Object`,
+                                                    which can be useful to see information about the
+                                                    most recently loaded page object.
+                                                -   There is a new keyword, `Get Page Object`, which
+                                                    will return the robot library for a given page
+                                                    object. This can be used in other keywords to access
+                                                    keywords from another page object if necessary.
+                                                -   The `Go To Page` keyword will now automatically load
+                                                    the page object for the given page.
 
-                                      -   Added a basic debugger for Robot tests. It can be enabled
-                                          using the `-o debug True` option to the robot task.
+                                        -   Added a basic debugger for Robot tests. It can be enabled
+                                            using the `-o debug True` option to the robot task.
 
 -   Added support for deploying new metadata types
     `ProfilePasswordPolicy` and `ProfileSessionSetting`.
@@ -3788,8 +3800,8 @@ New features:
     permanently set this option, add this in
     `~/.cumulusci/cumulusci.yml`:
 
-                                      cli:
-                                          plain_output: True
+                                        cli:
+                                            plain_output: True
 
 -   Added additional info to the `cci version` command, including the
     Python version, an upgrade check, and a warning on Python 2.
@@ -5069,12 +5081,12 @@ Resolving a few issues from beta77:
     below. In flows that need to inject the actual namespace prefix,
     override the [unmanaged]{.title-ref} option .. :
 
-                                      custom_deploy_task:
-                                          class_path: cumulusci.tasks.salesforce.Deploy
-                                          options:
-                                              path: your/custom/metadata
-                                              namespace_inject: $project_config.project__package__namespace
-                                              unmanaged: False
+                                        custom_deploy_task:
+                                            class_path: cumulusci.tasks.salesforce.Deploy
+                                            options:
+                                                path: your/custom/metadata
+                                                namespace_inject: $project_config.project__package__namespace
+                                                unmanaged: False
 
 ### Enhancements
 
@@ -5789,13 +5801,13 @@ Resolving a few issues from beta77:
 -   **IMPORANT** This release changes the yaml structure for flows. The
     new structure now looks like this:
 
-                                      flows:
-                                          flow_name:
-                                              tasks:
-                                                  1:
-                                                      task: deploy
-                                                  2:
-                                                      task: run_tests
+                                        flows:
+                                            flow_name:
+                                                tasks:
+                                                    1:
+                                                        task: deploy
+                                                    2:
+                                                        task: run_tests
 
 -   See the new flow customization examples in the cookbook for examples
     of why this change was made and how to use it: