Improve error messages for CLI flags, type generation, auth scopes, dev server tunnels, and compatibility flags by dario-piotrowicz · Pull Request #14241 · cloudflare/workers-sdk

dario-piotrowicz · 2026-06-09T20:17:56Z

Error messages across several areas now name the exact flags or values involved and suggest how to fix the problem:

demandOneOfOption (used by KV commands): messages now include -- prefixes and clear "Missing required option" / "Conflicting options" phrasing instead of the vague "Exactly one of the arguments ... is required".
wrangler types --include-env=false --include-runtime=false: the error now names both flags and explains what each does.
wrangler login --scopes: invalid scopes are individually identified instead of dumping the entire array.
wrangler dev --tunnel --remote: the error now explains why tunnels require local mode and suggests two concrete fixes.
Conflicting compatibility flags (nodejs_compat_populate_process_env / nodejs_compat_do_not_populate_process_env, global_navigator / no_global_navigator): errors now name the specific conflicting flags.

Tests
- Tests included/updated
- Automated tests not possible - manual testing has been completed as follows:
- Additional testing not necessary because:
Public documentation
- Cloudflare docs PR(s):
- Documentation not necessary because: improved error messages

A picture of a cute animal (not mandatory, but encouraged)

changeset-bot · 2026-06-09T20:18:03Z

🦋 Changeset detected

Latest commit: 1c3b0c5

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 4 packages

Name	Type
wrangler	Patch
@cloudflare/vite-plugin	Patch
@cloudflare/vitest-pool-workers	Patch
@cloudflare/wrangler-bundler	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

ask-bonk · 2026-06-09T20:18:42Z

UnknownError: ProviderInitError

github run

ask-bonk · 2026-06-09T20:18:45Z

@dario-piotrowicz Bonk workflow failed. Check the logs for details.

View workflow run · To retry, trigger Bonk again.

github-actions · 2026-06-09T20:18:57Z

✅ All changesets look good

pkg-pr-new · 2026-06-09T20:27:15Z

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@14241

@cloudflare/deploy-helpers

npm i https://pkg.pr.new/@cloudflare/deploy-helpers@14241

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@14241

miniflare

npm i https://pkg.pr.new/miniflare@14241

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@14241

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@14241

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@14241

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@14241

@cloudflare/workers-auth

npm i https://pkg.pr.new/@cloudflare/workers-auth@14241

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@14241

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@14241

wrangler

npm i https://pkg.pr.new/wrangler@14241

commit: 1c3b0c5

ask-bonk · 2026-06-09T21:32:15Z

The scope code is well-guarded (args.scopes truthy, length > 0, validation guarantees at least one invalid). The logic is sound.

Let me do a final scan: telemetry messages were preserved (good — AGENTS.md says they should be stable static labels, and they weren't changed even though wording changed). All static telemetry labels remain unchanged.

I've reviewed all 13 files. The changes are:

Pure error-message improvements with matching test snapshot updates
The demandOneOfOption refactor actually fixes a latent array-mutation bug (options.pop())
Telemetry labels correctly kept stable
Scope filtering logic is sound; the DefaultScopeKeys vs DefaultScopes divergence is theoretical only (setLoginScopeKeys never called in production)
Changeset present and correctly scoped to wrangler patch

No logic bugs, security issues, backward-compatibility violations, or incorrect API behavior. The only theoretical concern (scope set divergence) cannot occur in practice and would be a nitpick.

LGTM

github run

workers-devprod · 2026-06-09T21:33:53Z

Codeowners approval required for this PR:

@cloudflare/workers-kv
✅ @cloudflare/wrangler

Show detailed file reviewers

packages/wrangler/src/tests/kv/key.test.ts: [@cloudflare/workers-kv]
packages/wrangler/src/kv/index.ts: [@cloudflare/workers-kv]

…ev server tunnels, and compatibility flags

petebacondarwin

Codeowners Bypass

(KV is requested but this is a trivial change to error messages and not worth blocking on)

workers-devprod

Codeowners reviews satisfied

workers-devprod added this to workers-sdk Jun 9, 2026

github-project-automation Bot moved this to Untriaged in workers-sdk Jun 9, 2026

dario-piotrowicz marked this pull request as ready for review June 9, 2026 21:33

dario-piotrowicz requested a review from workers-devprod as a code owner June 9, 2026 21:33

workers-devprod requested review from a team and ascorbic and removed request for a team June 9, 2026 21:33

This comment was marked as resolved.

Sign in to view

Improve error messages for CLI flags, type generation, auth scopes, d…

3d8c389

…ev server tunnels, and compatibility flags

dario-piotrowicz force-pushed the dario/fix-miscellaneous-wrangler-errors branch from 3010fa8 to 3d8c389 Compare June 10, 2026 00:27

This comment was marked as resolved.

Sign in to view

petebacondarwin requested changes Jun 12, 2026

View reviewed changes

Comment thread packages/wrangler/src/core/helpers.ts Outdated

Comment thread packages/wrangler/src/core/helpers.ts Outdated

Comment thread packages/wrangler/src/kv/index.ts Outdated

Comment thread packages/wrangler/src/dev.ts

github-project-automation Bot moved this from Untriaged to In Review in workers-sdk Jun 12, 2026

dario-piotrowicz added 2 commits June 12, 2026 17:59

Use Intl.ListFormat

5b46237

pass command definition to demandOneOfOption

42db654

dario-piotrowicz requested a review from petebacondarwin June 12, 2026 17:55

This comment was marked as resolved.

Sign in to view

adapt error message for programmatic version

1c3b0c5

petebacondarwin removed the request for review from ascorbic June 12, 2026 21:11

petebacondarwin approved these changes Jun 12, 2026

View reviewed changes

workers-devprod approved these changes Jun 12, 2026

View reviewed changes

github-project-automation Bot moved this from In Review to Approved in workers-sdk Jun 12, 2026

dario-piotrowicz merged commit 8b2ce41 into main Jun 13, 2026
61 checks passed

dario-piotrowicz deleted the dario/fix-miscellaneous-wrangler-errors branch June 13, 2026 15:52

github-project-automation Bot moved this from Approved to Done in workers-sdk Jun 13, 2026

workers-devprod mentioned this pull request Jun 13, 2026

Version Packages #14274

Merged

Conversation

dario-piotrowicz commented Jun 9, 2026

Uh oh!

changeset-bot Bot commented Jun 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

ask-bonk Bot commented Jun 9, 2026

Uh oh!

ask-bonk Bot commented Jun 9, 2026

Uh oh!

github-actions Bot commented Jun 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pkg-pr-new Bot commented Jun 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ask-bonk Bot commented Jun 9, 2026

Uh oh!

workers-devprod commented Jun 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

This comment was marked as resolved.

Uh oh!

This comment was marked as resolved.

Uh oh!

This comment was marked as resolved.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment was marked as resolved.

Uh oh!

petebacondarwin left a comment

Choose a reason for hiding this comment

Uh oh!

workers-devprod left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

changeset-bot Bot commented Jun 9, 2026 •

edited

Loading

github-actions Bot commented Jun 9, 2026 •

edited

Loading

pkg-pr-new Bot commented Jun 9, 2026 •

edited

Loading

workers-devprod commented Jun 9, 2026 •

edited

Loading