GitDocs
Build-system major drift

Go 1.24 GOCACHEPROG JSON protocol remote cache helper changed

Builds fail only when the remote cache helper is enabled; disabling cache hides the issue.

Go 1.24GoBuild-system major driftgo124

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: Custom `GOCACHEPROG` speaks a stale JSON protocol
Likely root cause: Builds fail only when the remote cache helper is enabled; disabling cache hides the issue.
Repair direction: Verifier checks explicit modern configuration and supported daemon/toolchain separation.

Symptom

Builds fail only when the remote cache helper is enabled; disabling cache hides the issue.

Why This Happens

Build scripts can be syntactically plausible while the current build-system major removes implicit artifacts/APIs or raises its daemon runtime floor.

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 GOCACHEPROG JSON protocol remote cache helper changed
GOCACHEPROG protocol JSON Go 1.24
"GOCACHEPROG" "KnownCommands"
https://go.dev/src/cmd/go/internal/cache/prog.go
https://go.dev/src/cmd/go/internal/cacheprog/cacheprog.go
go.dev src cmd go internal cacheprog cacheprog.go
https://go.dev/src/cmd/go/internal/
https://go.dev/src/cmd/go/internal/cacheprog/
"ProgRequest" "BodySize" GOCACHEPROG
https://raw.githubusercontent.com/golang/go/go1.23.0/src/cmd/go/internal/cache/prog.go

Source Trail

GitHub source file/reference: