Language edition/toolchain drift
Go 1.24 tool directive go.mod tools.go blank imports generator clean CI
A clean CI job cannot run a generator even though a historical `tools.go` pins its module.
Agent Quick Fix
Repair against the current Go 1.24 contract, then keep the change narrow and source-backed.
Product: Go 1.24
Current-contract area: `tools.go` blank-import convention replaced by `tool` directives
Likely root cause: A clean CI job cannot run a generator even though a historical `tools.go` pins its module.
Repair direction: Verifier checks idiomatic migration while preserving cross-version intent where required.Symptom
A clean CI job cannot run a generator even though a historical `tools.go` pins its module.
Why This Happens
Source may compile under an older edition/toolchain; current edition migration rules and tool metadata are external to the repo's immediate error context.
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.
Go 1.24 tool directive go.mod tools.go blank imports generator clean CI
site:go.dev/ref/mod tool directive go.mod
https://go.dev/ref/mod
'tool directive' in https://go.dev/ref/mod
'### `tool` directive'
'ToolDirective' in https://go.dev/ref/mod