🐛 BUG: Improve logging for how to resolve conflict in configuration files

[thomasgauvin]

Which Cloudflare product(s) does this pertain to?

Wrangler

What versions are you using?

4.6.0 [Wrangler]

What operating system and version are you using?

Mac Sonoma

Please provide a link to a minimal reproduction

No response

Describe the Bug

The error message for conflicting configurations does not provide any guidance on how to solve (errors should explain why they are occurring and give guidance on how to fix).

Please provide any relevant error logs

No response

[vahidshaik1901]

Opened #15534 for this.

The conflict is reported by findRedirectedWranglerConfig() in packages/workers-utils/src/config/config-helpers.ts. The user config and the .wrangler/deploy/config.json are each discovered by searching up the directory tree independently, so they can settle in different directories — but the message never said which location Wrangler actually wanted, or what to do about it.

The message now names the path the deploy configuration would have to sit at to be applied (the conflict check already computes it), suggests deleting it when it is left over from a previous build or running the command from the directory that owns the intended configuration, and links to the Generated Wrangler configuration docs.

Both existing inline snapshots in findWranglerConfig.test.ts are updated — they happen to cover both ways the paths diverge, deploy config deeper than the user config and shallower than it.