This is an automated email from the ASF dual-hosted git repository.
potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/main by this push:
new 2a98049ea22 Docs execution API version check via side effects in
AGENTS.md (#71484)
2a98049ea22 is described below
commit 2a98049ea2228d6470ae012dd14638fa5e54063e
Author: Jason(Zhe-You) Liu <[email protected]>
AuthorDate: Thu Aug 13 19:50:09 2026 +0800
Docs execution API version check via side effects in AGENTS.md (#71484)
---
airflow-core/src/airflow/api_fastapi/execution_api/AGENTS.md | 11 +++++++++++
1 file changed, 11 insertions(+)
diff --git a/airflow-core/src/airflow/api_fastapi/execution_api/AGENTS.md
b/airflow-core/src/airflow/api_fastapi/execution_api/AGENTS.md
index 4cacd2368ba..157fae64acc 100644
--- a/airflow-core/src/airflow/api_fastapi/execution_api/AGENTS.md
+++ b/airflow-core/src/airflow/api_fastapi/execution_api/AGENTS.md
@@ -32,6 +32,17 @@ uv run --active --group codegen --project
apache-airflow-task-sdk --directory ta
- Don't use keyword arguments with `endpoint()` — use positional:
`endpoint("/path", ["GET"])`.
- Don't add changes to already-released version files.
- Don't forget response converters for new fields in nested objects.
+- Don't branch business logic by comparing the negotiated API version to a
date/version string. For this case, subclass `VersionChangeWithSideEffects` for
the version change and check its `is_applied` flag instead:
+
+ ```python
+ class AddArgBindingsToTIRunContext(VersionChangeWithSideEffects): ...
+
+
+ def _client_supports_arg_bindings() -> bool:
+ return AddArgBindingsToTIRunContext.is_applied
+ ```
+
+ See [Cadwyn's
docs](https://docs.cadwyn.dev/concepts/version_changes/#version-changes-with-side-effects).
### Adding a New Feature End-to-End
