chore: version bump Taskgraph 16.0.0

CHANGELOG.md

@@ -1,5 +1,31 @@
 # Change Log
 
+## [16.0.0] - 2025-09-26
+
+### Changed
+
+- BREAKING CHANGE: Must use `-i/--interactive` to pause task execution in `load-task`
+- Upgraded docker-image tasks to use image_builder v6.0.0
+- Functions in `util/taskcluster.py` now use the official Taskcluster Python client
+
+### Added
+
+- Ability to run any task with a docker-worker payload to `taskgraph load-task`
+- Ability to pipe a task definition into `taskgraph load-task`
+- Ability to specify a custom image to `taskgraph load-task`, including building them locally
+- `load_tasks_for_kind` utility function can now generate any graph stage
+
+### Fixed
+
+- `load_tasks_for_kind` utility function now forwards kwargs to `TaskGraphGenerator`
+- `taskgraph build-image` now supports images using `$DOCKER_IMAGE_PARENT`
+- `taskgraph build-image` now obtains necessary context automatically
+
+### Removed
+
+- BREAKING CHANGE: `taskgraph build-image` no longer accepts a `--tag` flag
+- BREAKING CHANGE: Functions in `util/taskcluster.py` no longer accept the `use_proxy` argument
+
 ## [15.4.0] - 2025-09-22
 
 ### Added

docs/reference/migrations.rst

@@ -3,20 +3,35 @@ Migration Guide
 
 This page can help when migrating Taskgraph across major versions.
 
+15.x -> 16.x
+------------
+
+* Stop using the ``--tag`` flag with ``taskgraph build-image``. Images must now
+  be tagged manually via Docker post build.
+* Running ``taskgraph load-task`` will no longer pause task execution and
+  instead immediately execute the task's command after loading. Now you must
+  use the ``-i/--interactive`` flag to pause execution.
+* Utility functions in ``taskgraph.util.taskcluster`` no longer accept the
+  ``use_proxy`` argument. Instead the presence of ``TASKCLUSTER_PROXY_URL`` in
+  the environment will be used to determine whether or not to use the
+  Taskcluster proxy. Remove ``use_proxy`` from all function calls, and then
+  either set ``TASKCLUSTER_PROXY_URL`` or unset it depending on whether using
+  the proxy is desired or not.
+
 14.x -> 15.x
 ------------
 
-* `get_primary_dependency` now requires a `primary-dependency-label` to be set
-  on the task it is passed instead of `primary-kind-dependency`. Update any tasks
+* ``get_primary_dependency`` now requires a ``primary-dependency-label`` to be set
+  on the task it is passed instead of ``primary-kind-dependency``. Update any tasks
   you were calling this for to set this attribute. (If your only usage of this
-  is indirectly through `from_deps`, no change is needed: `from-deps` generated
-  tasks will set this for you.)
+  is indirectly through ``from_deps``, no change is needed: ``from-deps`` generated
+  tasks will set this for you).
 
 13.x -> 14.x
 ------------
 
-* The `{task_workdir}` string in environment variables no longer gets
-  interpolated by `run-task`. This is backing out a feature introduced in
+* The ``{task_workdir}`` string in environment variables no longer gets
+  interpolated by ``run-task``. This is backing out a feature introduced in
   version 13.x, so this release introduces no new backwards incompatibilities
   with version 12.x or earlier.
 

pyproject.toml

@@ -1,7 +1,7 @@
 ### Project
 [project]
 name = "taskcluster-taskgraph"
-version = "15.4.0"
+version = "16.0.0"
 description = "Build taskcluster taskgraphs"
 readme = "README.rst"
 authors = [