Release 1.12.0

[pankajkoti]

Breaking changes

• Introduced in the PR Refactor airflow/graph.py to simplify code-base #2080. The following functions are expected to be used internally only to Cosmos, so we hope these won't impact end-users, but we are documenting the changes just in case:
  • generate_task_or_group receives render_config instead of its individual configurations, such as test_behavior, source_rendering_behavior and enable_owner_inheritance
  • create_task_metadata receives render_config instead of its individual configurations, such as test_behavior, source_rendering_behavior and enable_owner_inheritance
  • create_task_metadata now expects the node_converters argument
• Drop Python 3.9 support by @pankajastro in Drop Python 3.9 support #2118
• Drop Airflow 2.4 support by @pankajastro in Drop Airflow 2.4 support #2161
• Drop Airflow 2.5 support by @pankajastro in Drop Airflow 2.5 support #2165

Features

• Support applying node_converter at a task level instead of task group level by @anyapriya in Support applying node_converter at a task level instead of task group level #1759
• Allow overriding DbtProducerWatcherOperator parameters via ExecutionConfig.setup_operator_args by @pankajastro in Add setup_operator_args in ExecutionConfig #2133
• Use deferrable sensors by default in ExecutionMode.WATCHER by @pankajastro in Add deferrable support for Watcher Sensor #2084
• Support real-time consumer updates when using ExecutionMode.WATCHER and InvocationMode.SUBPROCESS by @pankajastro in Support real-time consumer updates when using ExecutionMode.WATCHER and InvocationMode.SUBPROCESS #2152
• Update telemetry to v3 format with query parameters by @pankajkoti in Update telemetry to v3 format with query parameters #2192
• Add initial set of telemetry task listener metrics for Cosmos operators by @pankajkoti in Add telemetry task listener metrics for Cosmos operators #2195

Enhancements

• Unify Airflow version handling into constants.py by @tatiana in Unify airflow version handling into constants.py #2089
• Refactor airflow/graph.py to simplify the code base by @tatiana in Refactor airflow/graph.py to simplify code-base #2080
• Force watcher producer retries to zero by @pankajkoti in Force watcher producer retries to zero #2114
• Fail ExecutionMode.WATCHER consumer sensors immediately when the producer fails using Airflow context by @pankajkoti in Fail consumer sensors when producer task failure observed using Airflow context #2126
• ExecutonMode.WATCHER: fetch producer status asynchronously from the Airflow runtime so deferrable sensors fail immediately when the producer task fails by @pankajkoti in Watcher: fetch async producer status from Airflow runtime #2144
• Refactor ExecutionMode.WATCHER InvocationMode.SUBPROCESS log parser by @tatiana in Refactor Watcher InvocationMode.SUBPROCESS log parser #2183
• Replace map_index with is_mapped_task boolean in task telemetry metrics by @pankajkoti in Replace map_index with is_mapped_task boolean in task telemetry #2210
• Collect cosmos profile metrics in task telemetry metrics by @pankajastro in Collect cosmos profile metrics #2198
• Remove unnecessary information from telemetry by @tatiana in Remove unnecessary information from telemetry #2211

Bug fixes

• Clarify ExecutionMode.WATCHER deferrable failure messaging by @pankajkoti in Clarify watcher deferrable failure messaging #2124
• Remove empty test tasks when all tests are detached by @anyapriya in Removing empty test tasks when all tests are detached #2010
• Fix forwarding DbtProducerWatcherOperator dbt build flags by @michal-mrazek in Fix forwarding DbtProducerWatcherOperator dbt build flags #2127
• Add databricks oauth mock profile by @fjmacagno in Add databricks oauth mock profile #2164
• Register listeners in Airflow 3 plugin implementation by @pankajastro in Register the listener in Airflow 3 plugin impl #2187
• Fix resolution of packages-install-path when it uses env_var by @tatiana in Fix resolution of packages-install-path when it uses env_var #2194
• Fix template_fields in DbtConsumerWatcherSensor to include DbtRunLocalOperator template_fields`` by @tiovader and @emanuel-luis in Emit more metrics on task operators from Scarf telemetry task operator listener #2209
• Emit asset events in ExecutionMode.AIRFLOW_ASYNC mode by @pankajastro in Emit asset events in async execution mode #2184
• Remove dag_run_id from telemetry tests by @tatiana in Remove dag_run_id from telemetry tests #2213

Docs

• Document dataset-event limitation when using ExecutionMode.AIRFLOW_ASYNC by @varaprasadregani in docs: add limitation on dataset events missing in AIRFLOW_ASYNC mode #2143
• Expand ExecutionMode.KUBERNETES guidance by @tatiana in Improve docs on ExecutionMode.KUBERNETES #2139
• Add docs for deferrable DbtConsumerWatcherSensor by @pankajastro in Add docs for deferrable DbtConsumerWatcherSensor #2115
• Fix reStructuredText formatting by @dnskr in docs: Fix reStructuredText formatting #2132
• Add docs for setup_operator_args param by @pankajastro in Add docs for setup_operator_args param #2136
• Remove experimental flag for ExecutionMode.AIRFLOW_ASYNC by @pankajastro in Doc: Remove experimental for async execution mode #2153
• Clarify ExecutionMode.AIRFLOW_ASYNC dataset limits by @pankajkoti in Docs: clarify AIRFLOW_ASYNC dataset limits. #2167
• Update PRIVACY_NOTICE.rst by @tatiana in Update PRIVACY_NOTICE.rst #2212

Others

• Drop Python 3.9 support by @pankajastro in Drop Python 3.9 support #2118
• Drop Airflow 2.4 support by @pankajastro in Drop Airflow 2.4 support #2161
• Drop Airflow 2.5 support by @pankajastro in Drop Airflow 2.5 support #2165
• Improve example DAG jaffle_shop_kubernetes.py by @tatiana in Improve example DAG jaffle_shop_kubernetes.py #2140
• Enable tests for Python 3.13 by @pankajastro in Enable test for Python 3.13 #2154
• Add Python 3.12 to CI integration tests matrix by @pankajastro in Add Python 3.12 to CI integration test matrix #2168
• Retry flaky Telemetry success test to stabilise CI by @pankajkoti in Retry flaky telemetry success test #2138
• Drop unused producer state xcom handling in ExecutionMode.WATCHER by @pankajkoti in Watcher: drop unused producer state xcom #2145
• Remove unused Python3.9 uses from Github action CI by @pankajastro in Remove unused Python3.9 uses from Github action CI #2117
• Run pre-commit on ExecutionMode.WATCHER modules by @pankajkoti in Run pre-commit on watcher modules #2150
• Refactor: Use shared airflow version constant by @pankajkoti in Refactor: Use shared airflow version constant #2157
• Pin pydantic<2.0 for Airflow 2.6 compatibility by @pankajastro in Pin the pydantic<2.0 for Airflow 2.6 #2172
• Remove duplicate dbt-duckdb dependency by @pankajastro in Remove duplicate dbt-duckdb dependency #2170
• Add targeted type: ignore for untyped decorators to fix mypy errors by @pankajastro in Add targeted type: ignore for untyped decorators to fix mypy errors #2174
• Replace Legacy typing Aliases with Built-in Types for Python 3.10+ by @pankajastro in Replace Legacy typing Aliases with Built-in Types for Python 3.10+ #2175
• Refactor to reuse load_method_from_module from _utils/importer.py by @pankajastro in Refactor to reuse load_method_from_module from _utils/importer.py #2176
• Remove try except block for cache import and unused python_version variable by @pankajastro in Remove try except block for cache import and unuserd python_version #2186
• Unpin Airflow to satisfy GitHub Security tab requirements by @pankajastro in Unpin Airflow to satisfy GitHub Security tab requirements #2171
• Update Python version for pyupgrade in pre-commit config by @pankajastro in Update Python version for pyupgrade in pre-commit #2190
• Add cooldown config in dependabot config by @pankajastro in Add cooldown config in dependabot #2189
• Adjust pre-commit so Python 3.10 or higher can be used by @tatiana in Adjust pre-commit so Python 3.10 or higher can be used #2196
• Remove empty variables emission from telemetry metrics by @pankajkoti in Remove empty variables emission from telemetry metrics #2197
• Reformat documented comments for historical URL formats by @pankajkoti in Reformat documented comments for historical URL formats #2199
• Bump actions/checkout from 5.0.0 to 5.0.1 by @dependabot in Bump actions/checkout from 5.0.0 to 5.0.1 #2135
• Bump actions/checkout to 6.0.0 in GitHub workflows by @dependabot in Bump actions/checkout from 5.0.1 to 6.0.0 #2147
• Bump zizmorcore/zizmor-action from 0.2.0 to 0.3.0 by @dependabot in Bump zizmorcore/zizmor-action from 0.2.0 to 0.3.0 #2156
• Bump actions/checkout from 5.0.1 to 6.0.0 by @dependabot in Bump actions/checkout from 5.0.1 to 6.0.0 #2155
• Bump actions/checkout from 6.0.0 to 6.0.1 by @dependabot in Bump actions/checkout from 6.0.0 to 6.0.1 #2178
• Bump codecov/codecov-action from 5.5.1 to 5.5.2 by @dependabot in Bump codecov/codecov-action from 5.5.1 to 5.5.2 #2208
• pre-commit autoupdate by @pre-commit-ci[bot] in ⬆ [pre-commit.ci] pre-commit autoupdate #2134, ⬆ [pre-commit.ci] pre-commit autoupdate #2162, ⬆ [pre-commit.ci] pre-commit autoupdate #2173, ⬆ [pre-commit.ci] pre-commit autoupdate #2191, ⬆ [pre-commit.ci] pre-commit autoupdate #2202

closes: https://github.com/astronomer/oss-integrations-private/issues/275

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.85%. Comparing base (ea2cfea) to head (6487f85).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #2149   +/-   ##
=======================================
  Coverage   97.85%   97.85%           
=======================================
  Files          94       94           
  Lines        6058     6058           
=======================================
  Hits         5928     5928           
  Misses        130      130           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[netlify]

✅ Deploy Preview for sunny-pastelito-5ecb04 ready!

Name	Link
🔨 Latest commit	6487f85
🔍 Latest deploy log	https://app.netlify.com/projects/sunny-pastelito-5ecb04/deploys/693847deb050a00008abd7ec
😎 Deploy Preview	https://deploy-preview-2149--sunny-pastelito-5ecb04.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[netlify]

✅ Deploy Preview for astronomer-cosmos canceled.

Name	Link
🔨 Latest commit	ad54891
🔍 Latest deploy log	https://app.netlify.com/projects/astronomer-cosmos/deploys/694421f818491a00090df21d

[Copilot]

Pull request overview

This PR releases version 1.12.0 of Cosmos, updating the version number from the alpha pre-release (1.12.0a3) to the stable release and consolidating the changelog entries. The release includes breaking changes (dropping Python 3.9 and Airflow 2.4/2.5 support), new features for the ExecutionMode.WATCHER functionality, various enhancements, bug fixes, and documentation updates.

Key Changes:

• Version bump from 1.12.0a3 to 1.12.0 in the package metadata
• Comprehensive changelog consolidation with properly formatted entries across all categories
• Release date set to 2025-12-18

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
cosmos/init.py	Updates version string from pre-release to stable release version
CHANGELOG.rst	Consolidates and formats all changelog entries for the 1.12.0 release with proper categorization

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.