Cumulusci

Critical Changes

- We now support all package installation options for the `update_dependencies` and `install_managed` tasks, including `activate_remote_site_settings`, `security_type`, `name_conflict_resolution`, and `password` (password not available for `update_dependencies`). (\2811)

We also fixed a minor inconsistency in defaulting the `activate_remote_site_settings` (or formerly `activateRSS`) option. Projects that define custom tasks based on the `InstallPackageVersion` class should ensure they explicitly set the `activate_remote_site_settings` option, or accept the new default of True.

MetaDeploy install plans now *do not* freeze defaulted package install options. If your install plans are dependent on specific install options, we recommend explicitly specifying them. Install plans without explicit options will use the defaults at the time of execution.

Changes

- The `sources` feature, which allows CumulusCI projects to consume automation from other projects, now supports specifying a `resolution_strategy`, just like dependencies. Sources can now resolve to the same GitHub refs as corresponding dependencies, including branch matching. The default behavior is to use the `production` resolution strategy. (\2807)
- Added several new tasks for configuring Marketing Cloud: `marketing_cloud_create_subscriber_attribute`, `marketing_cloud_create_user`, and `marketing_cloud_update_user_role`. (\2838)
- In the mapping file for the `load_dataset` task, the `batch_size` can now be specified for Bulk API steps in addition to REST API steps. (\2813)
- The `snowfakery` task now supports the `ignore_row_errors` option to continue loading even if there are row errors. (\2819)
- We made significant updates to the [documentation for Robot Framework](https://cumulusci.readthedocs.io/en/stable/robot.html). (\#2834, \2847)
- We improved option validation for the `add_page_layout_fields` task. (\2828)

Issues Fixed

- Fixed handling of timezones when the `start_time` option is specified for the push tasks. (\2814)
- Fixed the `deploy_marketing_cloud_package` task to handle changes to the Marketing Cloud API. (\2816)
- Fixed an issue where MetaDeploy install steps that used 04t package version Ids, including 2GP installations, were frozen with incorrect titles. (\2817)
- Fixed an issue causing 2GP commit-status builds to fail when the local Git repository has a detached HEAD (\2818)
- Fixed a bug in the `dry_run` option for the `metadeploy_publish` task where explicitly setting the option to `False` did not disable the dry run. (\2836)
- Improved the error message shown by the `load_dataset` task if a table is missing from the dataset. (\2813)
- Improved the warning message shown when CumulusCI can't encrypt org and service config files. (\2839)

Internal Changes

- CumulusCI has improved infrastructure for its own integration tests. (\2783)
- Filing a CumulusCI issue on GitHub now presents a form to enter details. (\2829)
- Added a linter to ensure consistent formatting of YAML files within the CumulusCI codebase. (\2844)

Critical Changes

- The `github_release` task now requires the `tag_prefix` option to be passed. (2792)
- The `github_copy_subtree` task now requires a `tag_name` option to be passed. (2792)
- The `github_copy_subtree` task option `version` has been deprecated (use the `tag_name` option instead). (2792)

Changes

- `uninstall_packaged_incremental` now defaults to ignoring non-deletable `CustomObjectTranslation` metadata. If your project customizes the `ignore_types` option on `uninstall_packaged_incremental`, we recommend you add `CustomObjectTranslation` to this option. (2790)

Issues Fixed

- Fixed an issue where bulk job results were being miscounted. (Thanks sfdcale!) (2789)
- Fixed an issue where GitHub tags for 2GP package would always include the "release" prefix (even for Beta packages). (2792)

Changes

- We added a new Metadata ETL task, <span class="title-ref">add\_page\_layout\_fields</span>, that allows adding fields to existing layouts. (\2766)
- We added a task to enable an Einstein prediction: <span class="title-ref">enable\_einstein\_prediction</span> (thanks, erikperkins\!) (\2778)
- We added standard flows for releasing unlocked packages: <span class="title-ref">release\_unlocked\_beta</span> and <span class="title-ref">release\_unlocked\_production</span> (\2768)
- We added [documentation](https://cumulusci.readthedocs.io/en/stable/packaging.html) for using CumulusCI to build managed 2GP packages, unlocked packages, and extending NPSP and EDA with 2GP packages. (\#2768)
- Contributions to CCI now require verification by isort, which ensures consistency in the order that imports are used. (\2770)
- CumulusCI now supports deploying unmanaged dependencies in SFDX source format. (\2735)
- The <span class="title-ref">create\_package\_version</span> task now handles dependencies that use a <span class="title-ref">zip\_url</span>. (\2735)
- Updates to Github Actions configuration documentation. Thanks Julian88Tex (\2773)
- CumulusCI now automatically recognizes services and orgs configured via environment variables. See the [docs](https://github.com/SFDO-Tooling/CumulusCI/blob/481ab27446edbfdb038ea62834a6f276dc53bf3d/docs/headless.rst#L9) for more details. (\2676 and \2776)
- We've updated the Push Upgrade tasks (<span class="title-ref">push\_list</span>, <span class="title-ref">push\_sandbox</span>, etc) task option <span class="title-ref">start\_time</span> to accept ISO-8601 formatted datetimes. (\2769)
- You can now specify "sandbox": true on a CUMULUSCI\_ORG\_ variable in headless environments to indicate that the org you want to connect to is a sandbox. when connecting sandbox orgs in a headless environment. (\2753)

Issues Closed

- Fixed an issue where scratch orgs failed to be deleted in CI environments. (\2676)
- Fixed an issue where deleting an org failed to mark the org as deleted on CumulusCI's keychain. (\2676)
- Fixed an issue where CumulusCI would fail on Linux distributions that were incompatible with the <span class="title-ref">keyring</span> package. (\2676)
- We fixed an issue causing the <span class="title-ref">release\_2gp\_production</span> flow to fail with a dependency parsing error. (\2767)
- Fixed a couple issues with connecting CumulusCI to sandboxes using enhanced domains. (\2753 and \2765)
- Fixed a bug where the github_release task was not marking the "This is a pre-release" checkbox for beta releases. (2788)

Issues Closed

* Fixed an issue where a missing dependency was causing the homebrew installer formula to break.

Critical Changes

- The `create_package_version` task no longer creates Unlocked Packages from the `unpackaged/pre` and `unpackaged/post` directories of dependencies, or local `unpackaged/pre` directories by default. This behavior is now opt-in via the `create_unlocked_dependency_packages` option, which defaults to False. Projects using the old default behavior must explicitly set this option. We believe the new behavior is a more sane default for most 2GP projects. (2741)

Changes

- The `add_standard_value_set_entries` task now supports value sets for `LeadStatus`. (2695, with thanks to naicigam)
- We updated the default API version to 52.0. (2740)

Issues Closed

- Fixed an issue where the the built-in connected app was not accessible when running CumulusCI in a headless environment. (2737)
- The `create_package_version` task now supports `objectSettings` in the org definition file. (2741)
- We fixed issues in working with files containing Unicode characters on some Windows systems when using source-tracking commands. (2739)
- Fixed a bug where the `anon_apex` task had option text that was missing spaces. (2736)

Changes:

- Fix a bug with the integration of CumulusCI and the new SOQLQuery
Feature