Build plugin/config relocation
Gradle 9 plugin alias version catalog bundle plugins block unresolved reference
A plugin alias expression valid in the previous wrapper becomes an unresolved reference.
Agent Quick Fix
Repair against the current Gradle 9 contract, then keep the change narrow and source-backed.
Product: Gradle 9
Current-contract area: Version-catalog bundle used in `plugins {}` no longer resolves
Likely root cause: A plugin alias expression valid in the previous wrapper becomes an unresolved reference.
Repair direction: Verifier checks the current package identity/config format and a real transformed output.
Symptom
A plugin alias expression valid in the previous wrapper becomes an unresolved reference.
Why This Happens
The old package/config name is syntactically valid, but current tool packaging and discovery rules live in external release documentation.
Common Wrong Fixes
- Changing local code without checking the current external contract.
- Retrying the same install, build, or API call with no version/source change.
- Applying a broad unsafe bypass when a narrow compatibility fix is available.
Codex Search Keywords
These are the search terms observed in a neutral Codex validation run for this failure shape.
Gradle 9 plugin alias version catalog bundle plugins block unresolved reference
site:docs.gradle.org version catalog bundles plugins block alias Gradle 9
Gradle version catalog bundles plugins alias unresolved reference
https://docs.gradle.org/current/userguide/version_catalogs.html
'[bundles]' in https://docs.gradle.org/current/userguide/version_catalogs.html
https://docs.gradle.org/current/userguide/upgrading_version_8.html
https://docs.gradle.org/current/userguide/upgrading_major_version_9.html
'Removal of libraries and bundles from version catalogs in the plugins' in https://docs.gradle.org/current/userguide/upgrading_major_version_9.html
Source Trail
- Upgrading to Gradle 9: https://docs.gradle.org/current/userguide/upgrading_major_version_9.html
- Official reference opened by Codex: https://docs.gradle.org/current/userguide/version_catalogs.html
- Official reference opened by Codex: https://docs.gradle.org/current/userguide/upgrading_version_8.html
- Official reference opened by Codex: https://docs.gradle.org/current/userguide/upgrading_major_version_9.html