Cumulusci

Critical Changes

- CumulusCI will be dropping support for Python 3.6 and 3.7 within the next few releases. Please ensure you're running Python 3.8 or above.

Changes

- We added a new command, ``cci plan info``. Similar to ``cci task info``, this command displays detailed information about a MetaDeploy ``plan``, and includes a ``--messages`` option to display user-facing text. (2946)
- Improved logging to show reduced timestamps, and provide some syntax highlighting of output. (2941)
- [Snowfakery 2.2](https://github.com/SFDO-Tooling/Snowfakery/releases/tag/v2.2>) is now included with CumulusCI. New features include unique IDs and Numeric Counters. (#2962)

Issues Closed

- We added an improved error message when ``metadeploy_publish`` is passed a lightweight tag. (2955)
- Adjusted a check for .lightning. domains in the ``cci org connect`` command. (2970)
- We fixed an issue where stacktraces for some Apex test failures were truncated. (2961)

Changes

- Added a <span class="title-ref">cci plan list</span> command for displaying a list of metadeploy plans (2940)
- Task options can now be marked as "sensitive". These task options that will be obfuscated when displayed at the beginning of each task in a flow. (2939)
- Improved error message when <span class="title-ref">uninstall_packaged_incremental</span> is run in an sfdx-format project without converting to Metadata API format first (2929)
- Improved error messaging for multiple scenarios where tasks are improperly configured in cumulusci.yml. (2923)
- We added a new task <span class="title-ref">create_blank_profile</span> that can be used to create a new profile from scratch without any permissions enabled. (This new task requires a Winter 22 Org or API 53.0) (2908)
- We've added a user friendly error message when installing a package using security_type "PUSH" with a 04t Package Version ID. (2935)

Critical Changes

- Backwards incompatibility: the robot task option debug has been renamed to robot_debug. (2909)


Changes

- CumulusCI now has a schema published [here](https://github.com/SFDO-Tooling/CumulusCI/tree/main/cumulusci/schema/cumulusci.jsonschema.json). This is primarily intended to be use for enabling linting in VS Code, but could be used for any schema-aware editor or any validation purpose. (#2902)
- We added a new task create_blank_profile that can be used to create a new profile from scratch without any permissions enabled. (2908)
- Manually creating a Personal Access Token and pasting it into the CLI is no longer required to connect a GitHub service. Instead, CumulusCI now supports GitHub's device authentication flow, allowing you to authenticate via browser using a temporary device code. (2911)
- cci service info for a github service now displays expiration dates for GitHub personal access tokens, if set. (2912)
- Improved error messaging for multiple scenarios where tasks are improperly configured in cumulusci.yml. (2923)


Issues Fixed

- Fixed a bug where connecting a GitHub service with cci service connect was failing silently. (2888)
- Fixed an issue where MetaDeploy steps using the old filename_token and namespace_token options could not be used. (2914)

Changes

- We changed how the output from some commands and tasks are displayed in the CLI. (2887)
- Updated the `deploy_marketing_cloud_package` task for compatibility with the October 2021 release of Marketing Cloud. (2899)
- The `--max-lines` option on the `cci error info` command has been removed. (2895)

Issues fixed

- Removed the unused `--skip` option for the `cci flow run` command. (2884)
- Flow descriptions no longer generate a warning. (2885)
- Fixed a bug in freezing the `load_dataset` task options for MetaDeploy. (2900)
- The marketing cloud `deploy` task now properly exits when a result status of `FATAL_ERROR` is returned. (2897)
- We fixed a regression in the `push_list` task that affected 2GP push upgrades (2898)

Issues Fixed

- We fixed a regression that resulted in upload failures for 2GP packages that extend 1GP packages (closes 2880).

Changes

- CumulusCI uses package version Ids from 1GP releases wherever available, reducing the need to install 1GP packages in an org to build 2GP dependencies. (2832)
- We added `metadata_package_id` and `version_id` options to allow passing `MetadataPackage` (prefix 033) and `MetadataPackageVersion` (prefix 04t) IDs to the push upgrade tasks. (2837)
- `cci flow info` will now output all flow options defined. (2845)
- We improved error messages for incorrect data mapping files (2831).
- The `snowfakery` task supports specifying the `loading_rules` option (2861)
- The `snowfakery` task supports recipe options being supplied to recipes using the `recipe_options` option (2861).

Issues Fixed

- We fixed some errors in the documentation (2854)
- We fixed an issue causing CumulusCI to fail to install releases that contain an Unlocked Package without a namespace. (2851)
- We added handling for issues that occur when running the `generate_dataset_mapping` task for very large orgs (2860).
- We fixed a regression in using cross-project sources in MetaDeploy installers (2875).