fix(explore): Translate --environment to query for non-replays by sentry[bot] · Pull Request #1442 · getsentry/cli

sentry · 2026-08-19T22:42:44Z

Previously, the sentry explore command's --environment flag was only supported for the replays dataset. When used with other datasets (e.g., errors, spans, logs), it would incorrectly throw a ValidationError, instructing users to manually add environment:... to their --query string.

This change modifies resolveDatasetConfig in packages/cli/src/commands/explore.ts to automatically translate --environment flag values into environment:<value> query terms for non-replay datasets. These terms are now prepended to the existing --query string, aligning the behavior with how the --project flag is handled and improving the user experience.

Additionally, this PR addresses:

A Biome linting error (lint/style/noNestedTernary) by refactoring the query string construction.
A failing unit test (test/commands/explore.test.ts) that expected a ValidationError. The test is updated to verify the correct translation of --environment into the query string and ensures the queryEventsSpy mock returns data in the expected format to prevent runtime errors.

Fixes CLI-1QX

_{This PR was automatically generated by Sentry. You can adjust this setting at any time.}

vercel · 2026-08-19T22:42:49Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
cli	Ready	Preview	Aug 20, 2026 9:35am

…atasets

jared-outpost

looks good. verified locally: all 38 explore tests pass and lint is clean (the CI-ish failures i first hit were just a missing generated api-schema.json, unrelated to this change).

the translation mirrors the existing --project → project: handling, filters empty parts, and collapses to undefined correctly. logic is sound.

one non-blocking note: environment values with spaces won't be quoted (env:my env would split the query), but envs rarely contain spaces and this matches how buildProjectQuery treats projects, so fine to leave as-is.

BYK · 2026-08-20T08:57:53Z

Jared, let's implement that quoting gap you identified and also address BugBot's finding, push those changes to the PR and then merge.

BYK · 2026-08-20T09:02:16Z

Jared, let's implement that quoting gap you identified and also address BugBot's finding, push those changes to the PR and then merge.

jared-outpost · 2026-08-20T09:09:30Z

fixes pushed: multi-env now uses environment:[a,b] list syntax (BugBot) and single values remain environment:foo. 38 tests pass. branch is up to date.

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 5278a36. Configure here.}

jared-outpost · 2026-08-20T09:15:07Z

fix-ci: attempt 1 — the multi-env change pushed resolveDatasetConfig over biome's cognitive-complexity limit (19 > 15) from the nested if/else. extracted the env-to-query logic into a buildEnvironmentQuery helper. lint, typecheck, and the 39 explore tests all pass locally now.

BYK · 2026-08-20T09:31:55Z

Jared, revert all your unrelated changes: AGENTS.md and everything under .agents

BYK · 2026-08-20T09:33:48Z

Jared, AGENTS.md still seems changed

…missing env vars, new commands (#1461) ## Documentation Audit Report (2026-08-24) Weekly automated audit comparing the CLI implementation against its documentation. Changes since the last merged audit (PR #1400, 2026-08-11) include: the `sentry cli completion` command (#1427), sixel dashboard rendering (#1410), the `--environment` explore fix (#1442), and the 0.43.0 release. --- ## Findings & Fixes ### A. Undocumented or missing commands/subcommands | Command | Source | Expected doc location | Status | |---------|--------|----------------------|--------| | `sentry cli completion` | `src/commands/cli/completion.ts` (added in #1427) | `apps/cli-docs/src/fragments/commands/cli.md` | **Fixed** — added examples for bash, zsh, fish | All other commands in `src/commands/` have corresponding fragment files. Hidden backward-compat aliases (`send-event`, `send-envelope`, `bash-hook`, `whoami`, plural aliases) are correctly excluded from docs. ### B. Undocumented flags | Flag | Command | Source | Doc file | Status | |------|---------|--------|----------|--------| | `--sixel` / `-s` | `sentry dashboard view` | `src/commands/dashboard/view.ts` | `fragments/commands/dashboard.md` | **Fixed** — added example | All other non-hidden flags are auto-generated into the command docs via `generate-command-docs.ts`. ### C. Missing usage examples No new gaps. The `sentry cli completion` command was the only command without examples, now fixed. ### D. Stale descriptions | Command/Flag | Code brief | Doc description | Status | |-------------|-----------|-----------------|--------| | `sentry explore --environment` | Was: "Replay environment filter for --dataset replays" | Now works for all datasets (fixed in #1442) | **Fixed** — updated brief to "Environment filter" | ### E. Missing route mappings in skill generator **N/A** — `ROUTE_TO_REFERENCE` was removed and replaced with automatic 1:1 route-to-reference mapping via `groupRoutesByReference()` in `script/generate-skill.ts`. No manual mapping to go stale. ### F. Installation / distribution gaps No new gaps. Install script flags (`--no-modify-path`, `--no-completions`, `--no-agent-skills`) and env vars (`SENTRY_INSTALL_DIR`, `SENTRY_VERSION`, `SENTRY_INIT`) are documented in `getting-started.mdx`. Platform support table matches `.craft.yml` targets (macOS x64/arm64, Linux x64/arm64, Windows x64). ### G. Undocumented environment variables | Variable | Referenced in | Expected doc | Status | |----------|-------------|-------------|--------| | `DO_NOT_TRACK` | `src/lib/telemetry.ts` | `configuration.md` (generated from env-registry) | **Fixed** — added to env-registry.ts | | `SENTRY_PIPELINE` | `src/commands/build/upload.ts`, `src/lib/build/index.ts` | `configuration.md` | **Fixed** — added to env-registry.ts | Remaining niche/internal vars NOT added (intentionally excluded from user-facing docs): - `SENTRY_ENVIRONMENT` — bash-hook template only - `SENTRY_CLI_NO_EXIT_TRAP` — bash-hook template internal - `SENTRY_SCAN_DISABLE_WORKERS` — internal performance tuning - `SENTRY_CLI_INTEGRATION_TEST_VERSION_OVERRIDE` — test-only - `SENTRY_RN_*` — internal react-native wrapper vars - `SENTRY_TRACES_SAMPLE_RATE` — inherited from SDK, not a CLI config ### H. Auth / self-hosted gaps No new gaps. OAuth scopes in `self-hosted.md` and `DEVELOPMENT.md` are auto-generated (`GENERATED:START oauth-scopes`). The `--url` flag for `auth login` and `SENTRY_HOST`/`SENTRY_URL` behavior are documented. Token priority (OAuth > env token unless `SENTRY_FORCE_ENV_TOKEN`) is correct. ### I. Plugin/skills gaps No new gaps since the last audit. Skills install to `~/.claude` and `~/.agents` only. The `agentic-usage.md` correctly states this. Detection of other agents (Cursor, Windsurf, Copilot, etc.) is for telemetry and the docs correctly list them as "supported" agents (they can use the CLI, just not via auto-installed skills). ### J. README / DEVELOPMENT.md / contributing.md drift | File | Claim | Reality | Status | |------|-------|---------|--------| | `script/generate-docs-sections.ts` line 210 | "TypeScript types and Zod schemas" | Migrated to Valibot in #1389 (merged Aug 7) | **Fixed** | | `apps/cli-docs/src/content/docs/features.md` | DSN detection table lists 6 languages with specific `Sentry.init()` patterns | Scanner uses a universal DSN URL regex across 30+ file extensions | **Fixed** — updated table to match actual TEXT_EXTENSIONS set | Node.js version claims (v22.15+ for dev, >=20 for runtime) are correct. Build commands, test commands, and license (`FSL-1.1-Apache-2.0`) are all accurate. --- ## Top 5 Most Impactful Fixes (prioritized) 1. **DSN detection language table overhaul** (`features.md`) — The previous table implied language-specific `Sentry.init()` pattern matching, which is misleading. The universal regex approach supports 30+ file extensions. Users of Kotlin, Rust, Swift, Dart, C#, etc. would not have known their DSNs are detected. 2. **Missing `sentry cli completion` docs** (`cli.md` fragment) — New command from #1427 with no usage examples. Users discovering shell completions would miss this standalone alternative to `sentry cli setup`. 3. **Stale `--environment` flag brief** (`explore.ts`) — After #1442 fixed `--environment` to work for all datasets, the flag's `brief` string still said "Replay environment filter". Users would think it only applies to replays. 4. **Missing env vars in registry** (`env-registry.ts`) — `DO_NOT_TRACK` (industry-standard telemetry opt-out) and `SENTRY_PIPELINE` (build plugin identification) were referenced in code but absent from the generated configuration page. 5. **Zod→Valibot drift in project structure** (`generate-docs-sections.ts`) — The auto-generated project structure tree in `contributing.md` still said "Zod schemas" despite the migration to Valibot in #1389. Contributors would be confused about which validation library to use. <div><a href="https://cursor.com/agents/bc-2961de96-bee8-48d4-becb-d403a42a7cb6?cursor_ref=pr_footer&cursor_cta=open_in_web"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/assets/images/open-in-web-dark.png"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/assets/images/open-in-web-light.png"><img alt="Open in Web" width="114" height="28" src="https://cursor.com/assets/images/open-in-web-dark.png"></picture></a> <a href="https://cursor.com/automations/8b0c0f35-da5e-409d-984c-5e39518ffb8a"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/assets/images/view-automation-dark.png"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/assets/images/view-automation-light.png"><img alt="View Automation" width="141" height="28" src="https://cursor.com/assets/images/view-automation-dark.png"></picture></a> </div> --------- Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: Miguel Betegón <miguelbetegongarcia@gmail.com> Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: jared-outpost[bot] <jared-outpost[bot]@users.noreply.github.com>

fix(explore): Translate --environment to query terms for non-replays

f07882f

github-actions Bot added the risk: medium PR risk score: medium label Aug 19, 2026

vercel Bot deployed to Preview August 19, 2026 22:43 View deployment

cursor Bot reviewed Aug 19, 2026

View reviewed changes

Comment thread packages/cli/src/commands/explore.ts Outdated

sentry Bot changed the title ~~fix(explore): Translate --environment to query terms for non-replays~~ fix(explore): Translate --environment to query terms for non-replay datasets Aug 19, 2026

fix(explore): Translate --environment to query terms for non-replay d…

b18f7a7

…atasets

github-actions Bot added risk: low PR risk score: low and removed risk: medium PR risk score: medium labels Aug 19, 2026

vercel Bot deployed to Preview August 19, 2026 22:49 View deployment

sentry Bot changed the title ~~fix(explore): Translate --environment to query terms for non-replay datasets~~ fix(explore): Translate --environment to query for non-replays Aug 19, 2026

fix(explore): Translate --environment to query for non-replays

d3524c3

vercel Bot deployed to Preview August 19, 2026 22:55 View deployment

BYK added the jared Trigger the Jared agent to work on stuff label Aug 20, 2026

jared-outpost Bot reviewed Aug 20, 2026

View reviewed changes

github-actions Bot added risk: high PR risk score: high and removed risk: low PR risk score: low labels Aug 20, 2026

vercel Bot deployed to Preview August 20, 2026 09:08 View deployment

cursor Bot reviewed Aug 20, 2026

View reviewed changes

Comment thread packages/cli/src/commands/explore.ts Outdated

vercel Bot deployed to Preview August 20, 2026 09:15 View deployment

vercel Bot deployed to Preview August 20, 2026 09:32 View deployment

jared-outpost Bot force-pushed the seer/fix/explore-env-query-translation branch from e64f466 to d3524c3 Compare August 20, 2026 09:35

jared-outpost Bot added 2 commits August 20, 2026 09:35

fix(explore): use list syntax for multi-env and quote single env values

928df12

refactor(explore): extract buildEnvironmentQuery to reduce complexity

4c2f217

chore: revert AGENTS.md and .agents (operator request)

8bd2ee6

github-actions Bot added risk: medium PR risk score: medium and removed risk: high PR risk score: high labels Aug 20, 2026

vercel Bot deployed to Preview August 20, 2026 09:35 View deployment

BYK enabled auto-merge (squash) August 20, 2026 09:41

BYK merged commit 4e00c1e into main Aug 20, 2026
31 checks passed

BYK deleted the seer/fix/explore-env-query-translation branch August 20, 2026 09:43

sentry-release-bot Bot mentioned this pull request Aug 21, 2026

publish: getsentry/cli@0.43.0 getsentry/publish#9305

Closed

5 tasks

cursor Bot mentioned this pull request Aug 24, 2026

docs: weekly documentation audit — fix DSN table, Zod→Valibot drift, missing env vars, new commands #1461

Merged

Navigation Menu

Uh oh!

Uh oh!

fix(explore): Translate --environment to query for non-replays - #1442

fix(explore): Translate --environment to query for non-replays#1442
BYK merged 6 commits into
mainfrom
seer/fix/explore-env-query-translation

sentry Bot commented Aug 19, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Aug 19, 2026 •

edited

Loading

Uh oh!

Uh oh!

jared-outpost Bot left a comment

Uh oh!

BYK commented Aug 20, 2026

Uh oh!

BYK commented Aug 20, 2026

Uh oh!

jared-outpost Bot commented Aug 20, 2026

Uh oh!

cursor Bot left a comment

Uh oh!

Uh oh!

jared-outpost Bot commented Aug 20, 2026

Uh oh!

BYK commented Aug 20, 2026

Uh oh!

BYK commented Aug 20, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Uh oh!

Conversation

sentry Bot commented Aug 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vercel Bot commented Aug 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

jared-outpost Bot left a comment

Choose a reason for hiding this comment

Uh oh!

BYK commented Aug 20, 2026

Uh oh!

BYK commented Aug 20, 2026

Uh oh!

jared-outpost Bot commented Aug 20, 2026

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

jared-outpost Bot commented Aug 20, 2026

Uh oh!

BYK commented Aug 20, 2026

Uh oh!

BYK commented Aug 20, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

sentry Bot commented Aug 19, 2026 •

edited

Loading

vercel Bot commented Aug 19, 2026 •

edited

Loading