v1.15.0a1

Features

• Add ExecutionMode.WATCHER_KUBERNETES mode with test handling by @vricciardulli in #2529 and #2543
• Support dbt docs on Kubernetes via DbtDocsS3KubernetesOperator by @jx2lee in #2058
• Add use_tarball option to the upload_to_gcp_gs callback by @TTMichaelA in #2497
• Add AWS and Azure tarball upload options by @TTMichaelA in #2553
• Expose freshness_callback in ExecutionConfig.setup_operator_args for ExecutionMode.WATCHER by @pankajastro in #2586
• Allow templating dbt deps installation via ExecutionConfig by @pankajastro in #2728
• Add configurable seed rendering behavior by @pankajkoti in #2755
• Render ephemeral dbt models as EmptyOperator by default by @pankajkoti in #2759
• Support per-node callbacks via string import paths by @highlyavailable in #2781
• Map Snowflake query_tag from connection extras to dbt profile by @pankajastro in #2650
• Add Snowflake profile mapping for non-encrypted private key file by @pankajastro in #2660
• Export Clickhouse and encrypted Snowflake mappings from cosmos.profiles by @pankajastro in #2668
• Forward Snowflake insecure_mode from connection Extra into dbt profile by @toor11 in #2744
• Extend Snowflake profile mappings with authenticator, client_session_keep_alive, host, and port by @Aaditya-git in #2748
• Support extra__google_cloud_platform__project in GoogleCloudServiceAccountDictProfileMapping by @jroachgolf84 in #2626
• Enable the orjson parser for the whole project (experimental) by @corsettigyg in #2552
• Warn when users pass output-only template fields to local operators by @goingforstudying-ctrl in #2737

Enhancements

• Replace openlineage-airflow with apache-airflow-providers-openlineage by @tatiana in #2753
• Refactor handling of watcher producer-only dbt flags by @tatiana in #2717
• Disclose the --no-static-parser flag in ExecutionMode.LOCAL by @pankajkoti in #2714
• Refactor _default_freshness_callback to return a list of (id, state) tuples by @pankajastro in #2572
• Restore dynamically resolved user-provided node types by @jroachgolf84 in #2608
• Promote inline watcher status collections to named constants by @pankajastro in #2671
• Align WATCHER_KUBERNETES producer default task_id with PRODUCER_WATCHER_TASK_ID by @tatiana in #2794
• Centralize version-aware EmptyOperator imports in a compatibility module by @pankajkoti in #2758
• Move safe_copy out of cosmos.cache into cosmos.fs by @pankajkoti in #2715
• Refactor seed checksum hashing and caching helpers by @pankajkoti in #2784
• Avoid O(n^2) string accumulation in store_compiled_sql by @pankajastro in #2751
• Use GA versions for propagate_logs in provider_info by @pankajastro in #2712
• Use cosmos.log.get_logger consistently by @pankajastro in #2670
• Use lazy logging instead of f-strings in logger calls by @pankajastro in #2672 and #2680
• Ban eager module-level imports of optional providers via ruff by @tatiana in #2743
• Remove unused # type: ignore comments and re-enable warn_unused_ignores by @pankajastro in #2710 and #2763
• Drop the Python <3.9 fallback for functools.cache by @pankajastro in #2732
• Remove stale Airflow 2.3 comment on registry_conn_id default by @pankajastro in #2766
• Remove an outdated TODO on watcher terminal-status handling by @pankajastro in #2697
• Unify operator logging on self.log by @pankajastro in #2681
• Centralise resource_name extraction from dbt unique_id by @pankajkoti in #2687
• Tighten # type: ignore comments to specify error codes by @pankajastro in #2711

Bug Fixes

• Fix example_cosmos_sources to use a dbt project with sources by @jroachgolf84 in #2614
• Unify Postgres profiles.yml across dbt example projects by @yeoreums in #2501
• Pin dbt-core<2.0 in virtualenv example DAGs to avoid alpha pickup by @pankajastro in #2752

Docs

• Create a glossary stub by @lzdanski in #2461
• Improve the glossary: fix structure, add Cosmos-specific terms by @pankajastro in #2618
• Add a top-level FAQ page by @tatiana in #2635
• Align the FAQ page with the documentation style guide by @tatiana in #2667
• Update docs for DbtDocsS3KubernetesOperator by @jx2lee in #2575
• Add docs for ExecutionMode.WATCHER and the depends_on_past limitation by @tatiana in #2602
• Document watcher mode dbt 1.5+ requirement by @tatiana in #2700
• Improve clarity for watcher_dbt_execution_queue by @jroachgolf84 in #2705
• Document compiled_sql and freshness as output-only template fields by @00yhj22-debug in #2719
• Document seed rendering behavior by @pankajkoti in #2757
• Document tradeoffs of remote cache and disabling the dbt ls cache by @pankajkoti in #2722
• Document the LOCAL vs WATCHER benchmark on the Helm chart by @pankajkoti in #2688
• Enhance S3 dbt docs documentation by @jroachgolf84 in #2765
• Restore memory-optimised imports docs for Cosmos < 1.14.0 by @pankajkoti in #2604
• Update dbt and Airflow Spark URLs in profile mapping docstrings by @pankajastro in #2695
• Remove a duplicate node_conversion_by_task_group entry in render config docs by @pankajkoti in #2770
• Capitalize Docker as a product name in prose by @pankajkoti in #2623
• Normalize heading underlines across docs by @pankajkoti in #2641, #2655, #2656, and #2663
• Add language hints to docs code-block directives by @pankajastro in #2686
• Add the Cosmos 1.14.2 row to the watcher-retry behavior history by @tatiana in #2742

Others

• Reduce integration test CI time from ~30 min to ~16 min by @pankajkoti in #2562
• Speed up Airflow 3.1+ integration tests by caching InProcessExecutionAPI by @pankajkoti in #2547
• Carve dbt-loom tests into a dedicated CI job by @pankajastro in #2761
• Re-enable the cross-project dbt ls example DAG in the dbt-loom CI job by @pankajkoti in #2775
• Move test jobs that need no secrets to an unprivileged pull_request workflow by @pankajkoti in #2791
• Remove the Authorize gate from CI jobs that don't use secrets by @pankajkoti in #2567
• Avoid running tests when PRs from forks only change docs by @tatiana in #2583
• Forward extra args to the test-integration hatch script by @tatiana in #2682
• Add release-* branches for pull_request_target to run CI on release branches by @pankajkoti in #2603
• Pin pre-commit hooks and GitHub Actions to commit SHAs by @pankajkoti in #2610, #2611, #2612, and #2613
• Set persist-credentials: false for checkout in the actionlint workflow by @pankajkoti in #2793
• Stop the stale bot from auto-closing PRs by @pankajkoti in #2746
• Make local hatch run docs:build fail on Sphinx warnings by @pankajkoti in #2639
• Skip the watcher gateway test on Airflow 3.0 by @tatiana in #2607
• Add an example DAG for seed rendering behavior by @pankajkoti in #2756
• Add integration tests for ephemeral models rendered as empty operators by @pankajkoti in #2760
• Improve coverage for DbtRunAirflowAsyncBigqueryOperator by @pankajastro in #2733
• Add test coverage for DbtModel._extract_config branches by @pankajastro in #2779
• Extract project conventions into AGENTS.md; slim CLAUDE.md by @tatiana in #2703
• Document the AI agent attribution convention by @tatiana in #2718
• Teach AI agents to use pre-commit before committing and pushing by @tatiana in #2702
• Instruct Claude Code to read AGENTS.md for commands before running them by @pankajkoti in #2774
• Document docs build and serve commands, and the docs style guide, in CLAUDE.md by @pankajkoti in #2637 and #2665
• Bump black from 26.3.1 to 26.5.1 by @pankajkoti in #2727
• Bump codecov-action to v6.0.2 by @pankajkoti in #2786
• Dependency updates by @dependabot in #2541, #2555, #2571, #2578, #2579, #2582, #2588, #2589, #2609, #2621, #2627, #2651, #2674, #2707, #2721, #2724, #2725, #2730, #2745, #2783, #2789, and #2790

Milestone: Cosmos 1.15.0

v1.14.2

Behaviour Changes

These changes adjust observable behaviour of the ExecutionMode.WATCHER execution mode.
None of them break the public Cosmos API, but users relying on undocumented internals
(graph wiring assertions, XCom backup Variable names, retry-on-recovery semantics, or
retry log format) should review before upgrading.

• ExecutionMode.WATCHER + depends_on_past=True: when the producer task has
  depends_on_past=True (typically set via default_args), the producer-done gateway
  task inside DbtTaskGroup is now wired downstream of every consumer task, in addition
  to the producer. This is required so that wait_for_downstream gating behaves
  correctly across DAG runs and the task group acts as a single unit that must fully
  succeed before the next run starts. Users with depends_on_past=False (the default)
  see no topology change. See #2615.
• ExecutionMode.WATCHER downstream retry on upstream recovery: dbt models that were
  skipped after an upstream-failure event are now retried in the same DAG run when the
  upstream task succeeds on retry. Previously these models remained skipped for the run.
  See #2684.
• ExecutionMode.WATCHER consumer-retry log format: the consumer's fallback dbt
  invocation no longer inherits the producer's internal --log-format json flag, so
  retry task logs now default to dbt's normal text format. Users who relied on JSON output
  in retry logs can opt in via operator_args={"dbt_cmd_flags": ["--log-format", "json"]}.
  See #2713.
• ExecutionMode.WATCHER XCom-backup Variable key scheme: the per-model XCom backup
  Variable key now includes the full task-group path and sanitises disallowed characters
  (+ / :) from run_id. External monitoring or cleanup scripts that match the
  old key pattern will need updating. See #2629 and #2683.

Bug Fixes

• Sanitize disallowed characters from XCom backup variable key by @MichaelRBlack in #2629
• Prevent watcher producers from colliding on one XCom-backup key by @tatiana in #2683
• Retry watcher downstream models on upstream-failure recovery by @tatiana in #2684
• Fix ExecutionMode.WATCHER interaction with depends_on_past by @johnhoran in #2615
• Strip --log-format from producer flags on watcher consumer retry by @tatiana in #2713
• Fix duplicate deferrable kwarg in DbtRunAirflowAsyncBigqueryOperator by @pankajastro in #2616
• Fix dbt docs iframe src missing deployment path prefix by @pankajastro in #2640
• Defer TaskInstance import in cluster policy to fix Sentry init crash by @pankajastro in #2662
• Restore type hints broken by lazy imports in cosmos/__init__.py by @pankajastro in #2647
• Fix ExecutionMode.WATCHER non-dbt stdout being suppressed from logs by @pankajastro in #2654
• Fix test sensor retry behaviour in ExecutionMode.WATCHER by @pankajkoti in #2658
• Fix watcher fallback selector for versioned dbt models by @pankajkoti in #2659
• Break out of iframe from Airflow 2 dbt Docs 404 link by @pankajastro in #2685

Docs

• Document source freshness aware execution for ExecutionMode.WATCHER by @pankajastro in #2617
• Add reference docs for DbtRunLocalOperator, DbtTestLocalOperator, DbtSnapshotLocalOperator and DbtBuildLocalOperator by @pankajastro in #2643
• Add watcher retry behaviour history documentation by @tatiana in #2600
• Add Apache Airflow® trademark on first prominent mention by @pankajkoti in #2624
• Sentence-case section headings by @pankajkoti in #2630
• Use - for bullet points by @pankajkoti in #2631
• Drop decorative separator lines by @pankajkoti in #2632
• Normalize heading underlines in docs/guides/ and docs/index.rst by @pankajkoti in #2664
• Fix broken cross-directory doc links by @pankajastro in #2694
• Fix broken external links in hand-written docs by @pankajastro in #2696
• Document support for Airflow 3.2 in the compatibility policy by @pankajastro in #2652
• Refresh the dbt/Airflow conflicts table to match the compatibility policy by @pankajastro in #2653
• Document incremental model limitation for ExecutionMode.AIRFLOW_ASYNC by @pankajastro in #2642

Others

• Import ParamValidationError from airflow.sdk to silence deprecation warning by @pankajastro in #2645
• Import DAG from airflow.sdk to silence deprecation warning by @pankajastro in #2644
• Enforce docs style guide via pre-commit hook by @pankajkoti and @tatiana in #2633
• Add Airflow 3.2 to the test matrix in CLAUDE.md by @pankajastro in #2646
• Document the lazy-logging standard in CLAUDE.md by @pankajastro in #2679
• Extract watcher XCom-key helpers and inline single-use bindings by @pankajastro in #2673
• Remove leftover scripts/airflow3 directory by @pankajastro in #2661
• Fix altered_jaffle_shop seed-dep CTE references by @pankajastro in #2690
• Skip Airflow 3.0 integration test stuck on example_watcher_with_freshness by @pankajastro in #2692
• Fix typo "constrantis" → "constraints" in tests env comment by @pankajastro in #2669

v1.14.2a4

Pre-release alpha of Cosmos 1.14.2.

Refresh of a3 with eleven additional milestone PRs (nine from @pankajastro, two from @pankajkoti). All applied cleanly on top of the a3 cherry-picks. See the release PR for cherry-pick provenance and manual conflict resolution: #2708.

Bug Fixes

• Sanitize disallowed characters from XCom backup variable key by @MichaelRBlack in #2629
• Prevent watcher producers from colliding on one XCom-backup key by @tatiana in #2683
• Retry watcher downstream models on upstream-failure recovery by @tatiana in #2684
• Fix ExecutionMode.WATCHER interaction with depends_on_past by @johnhoran in #2615
• Fix duplicate deferrable kwarg in DbtRunAirflowAsyncBigqueryOperator by @pankajastro in #2616
• Fix dbt docs iframe src missing deployment path prefix by @pankajastro in #2640
• Defer TaskInstance import in cluster policy to fix Sentry init crash by @pankajastro in #2662
• Restore type hints broken by lazy imports in cosmos/__init__.py by @pankajastro in #2647
• Fix ExecutionMode.WATCHER non-dbt stdout being suppressed from logs by @pankajastro in #2654
• Fix test sensor retry behaviour in ExecutionMode.WATCHER by @pankajkoti in #2658
• Fix watcher fallback selector for versioned dbt models by @pankajkoti in #2659

Docs

• Document source freshness aware execution for ExecutionMode.WATCHER by @pankajastro in #2617
• Add reference docs for DbtRunLocalOperator, DbtTestLocalOperator, DbtSnapshotLocalOperator and DbtBuildLocalOperator by @pankajastro in #2643
• Add watcher retry behaviour history documentation by @tatiana in #2600
• Add Apache Airflow® trademark on first prominent mention by @pankajkoti in #2624
• Sentence-case section headings by @pankajkoti in #2630
• Use - for bullet points by @pankajkoti in #2631
• Drop decorative separator lines by @pankajkoti in #2632
• Normalize heading underlines in docs/guides/ and docs/index.rst by @pankajkoti in #2664
• Fix broken cross-directory doc links by @pankajastro in #2694
• Fix broken external links in hand-written docs by @pankajastro in #2696
• Document support for Airflow 3.2 in the compatibility policy by @pankajastro in #2652
• Refresh the dbt/Airflow conflicts table to match the compatibility policy by @pankajastro in #2653

Others

• Import ParamValidationError from airflow.sdk to silence deprecation warning by @pankajastro in #2645
• Import DAG from airflow.sdk to silence deprecation warning by @pankajastro in #2644
• Enforce docs style guide via pre-commit hook by @pankajkoti and @tatiana in #2633
• Add Airflow 3.2 to the test matrix in CLAUDE.md by @pankajastro in #2646
• Document the lazy-logging standard in CLAUDE.md by @pankajastro in #2679
• Extract watcher XCom-key helpers and inline single-use bindings by @pankajastro in #2673
• Remove leftover scripts/airflow3 directory by @pankajastro in #2661
• Fix altered_jaffle_shop seed-dep CTE references by @pankajastro in #2690
• Skip Airflow 3.0 integration test stuck on example_watcher_with_freshness by @pankajastro in #2692
• Fix typo "constrantis" → "constraints" in tests env comment by @pankajastro in #2669

Milestone: Cosmos 1.14.2

Full changelog: astronomer-cosmos-v1.14.2a3...astronomer-cosmos-v1.14.2a4

v1.14.2a3

Pre-release alpha of Cosmos 1.14.2.

First alpha cut from release-1.14 with the full milestone applied (previous alphas a1 / a2 were point fixes off feature branches). See the release PR for cherry-pick provenance and manual conflict resolution: #2708.

Bug Fixes

• Sanitize disallowed characters from XCom backup variable key by @MichaelRBlack in #2629
• Prevent watcher producers from colliding on one XCom-backup key by @tatiana in #2683
• Retry watcher downstream models on upstream-failure recovery by @tatiana in #2684
• Fix ExecutionMode.WATCHER interaction with depends_on_past by @johnhoran in #2615
• Fix duplicate deferrable kwarg in DbtRunAirflowAsyncBigqueryOperator by @pankajastro in #2616
• Fix dbt docs iframe src missing deployment path prefix by @pankajastro in #2640
• Defer TaskInstance import in cluster policy to fix Sentry init crash by @pankajastro in #2662
• Restore type hints broken by lazy imports in cosmos/__init__.py by @pankajastro in #2647
• Fix ExecutionMode.WATCHER non-dbt stdout being suppressed from logs by @pankajastro in #2654

Docs

• Document source freshness aware execution for ExecutionMode.WATCHER by @pankajastro in #2617
• Add reference docs for DbtRunLocalOperator, DbtTestLocalOperator, DbtSnapshotLocalOperator and DbtBuildLocalOperator by @pankajastro in #2643
• Add watcher retry behaviour history documentation by @tatiana in #2600
• Add Apache Airflow® trademark on first prominent mention by @pankajkoti in #2624
• Sentence-case section headings by @pankajkoti in #2630
• Use - for bullet points by @pankajkoti in #2631
• Drop decorative separator lines by @pankajkoti in #2632
• Normalize heading underlines in docs/guides/ and docs/index.rst by @pankajkoti in #2664
• Fix broken cross-directory doc links by @pankajastro in #2694
• Fix broken external links in hand-written docs by @pankajastro in #2696

Others

• Import ParamValidationError from airflow.sdk to silence deprecation warning by @pankajastro in #2645
• Import DAG from airflow.sdk to silence deprecation warning by @pankajastro in #2644
• Enforce docs style guide via pre-commit hook by @pankajkoti and @tatiana in #2633

Milestone: Cosmos 1.14.2

Full changelog: astronomer-cosmos-v1.14.1...astronomer-cosmos-v1.14.2a3

v1.14.2a2

Test: Forward non-dbt stdout to task log in WATCHER mode in #2654

v1.14.2a1

Test: Fix dbt docs iframe src missing deployment path prefix PR: #2640

v1.14.1

Bug Fixes

• Fix ExecutionMode.WATCHER producer retry behaviour by @tatiana in #2559
• Prevent watcher producer skip propagating to downstream tasks via gateway task by @johnhoran and @tatiana in #2597
• Keep watcher sensor polling when producer is still running by @pankajkoti in #2592
• Fix circular import error in Cosmos plugin discovery under Astro Runtime by @tatiana in #2538
• Fix CosmosRichLogger crash on None log message by @tatiana in #2540
• Enable inlets and outlets using dbt Fusion on Airflow 3 by @ichirotakami in #2561
• Fix incorrectly skipped source downstream tasks in ExecutionMode.WATCHER by @pankajastro in #2563
• Fix duplicate logs in dbt build when source freshness is enabled by @pankajastro in #2564
• Warn and normalize when source_rendering_behavior=None is passed by @pankajastro in #2570
• Gracefully handle Variable.set() failures on Astro Remote Execution by @hkc-8010 in #2573
• Skip malformed YAML selectors instead of failing entirely by @YourRoyalLinus in #2577

Docs

• Update watcher test behavior docs for Cosmos 1.14.0 by @tatiana in #2549
• Add redirect for moved partial-parsing docs page by @tatiana in #2550
• Document ExecutionMode.WATCHER and depends_on_past limitation by @tatiana in #2602
• Restore memory-optimised imports docs for Cosmos < 1.14.0 by @pankajkoti in #2604

Others

• Speed up Airflow 3.1+ integration tests by caching InProcessExecutionAPI by @pankajkoti in #2547
• Improve stability of cache hash unit tests by @tatiana in #2539
• Fix mypy 1.20.0 type check failures by @pankajkoti in #2546
• Fix CI failures caused by docs build memory exhaustion by @pankajkoti in #2580
• Fix dbt Fusion broken integration tests by @tatiana in #2581
• Fix flaky cosmos_manifest_selectors_example DAG in CI by @pankajkoti in #2593
• Reduce pre-commit autoupdate frequency PRs by @tatiana in #2544
• Bump reviewdog/action-actionlint from 1.71.0 to 1.72.0 by @dependabot in #2542
• Skip watcher gateway test on Airflow 3.0 by @tatiana in #2607

v1.14.1a4

Cut from release PR: #2601

v1.14.1a3

Cut from release PR: #2601

v1.14.1a2

• Fix watcher producer retries behaviour by @tatiana in #2559
  • Fixes ExecutionMode.WATCHER_KUBERNETES as well

#2559