fix(init): enrich 401 Unauthorized errors with actionable guidance

[betegon]

When sentry init runs without an org argument it calls listOrganizations() to show a picker. If the token is invalid or expired that call returns 401. Before this change users saw:

✗ Failed to list organizations: 401 Unauthorized
✗ Setup failed.

No hint about what to do. Compare that to 403, which already had enrich403Detail() pointing at the token settings page or suggesting re-auth. 401 was just falling through with the raw HTTP status.

After (env-var token):

✗ Could not list organizations (401 Unauthorized).
  Your SENTRY_AUTH_TOKEN token is invalid or has expired.
  Regenerate it at: https://sentry.io/settings/auth-tokens/
✗ Setup failed.

After (OAuth):

✗ Could not list organizations (401 Unauthorized).
  Not authenticated or your session has expired.
  Re-authenticate with: sentry auth login
✗ Setup failed.

What changed

• enrich401Detail() in infrastructure.ts — mirrors enrich403Detail(), applied in both throwApiError() and throwRawApiError()
• resolveOrgSlug() in preflight.ts — extended the existing 403 catch to also handle 401, returning { ok: false } so the error surfaces through ensureOrg with the full enriched message (same flow as 403, same Sentry culprit attribution)
• Fixed throwRawApiError's JSON-stringify fallback to exclude 401 alongside 403 — otherwise {"detail":null} responses would produce noisy prefixes in the enriched message
• Fixed a stale sentry login → sentry auth login in the empty-orgs fallback

Test plan

• Set SENTRY_AUTH_TOKEN to a garbage value, run sentry init with no org arg — should print the token hint + settings URL
• sentry auth logout, run sentry init with no org arg — should print the session-expired + re-auth hint
• bun test test/lib/api/infrastructure.test.ts — 17 tests pass

Ref: CLI-1SD

[github-actions]

PR Preview Action v1.8.1
🚀 View preview at https://cli.sentry.dev/_preview/pr-971/
Built to branch gh-pages at 2026-05-18 10:59 UTC. Preview will be ready when the GitHub Pages deployment is complete.

[github-actions]

Codecov Results 📊

✅ 6975 passed | Total: 6975 | Pass Rate: 100% | Execution Time: 0ms

📊 Comparison with Base Branch

Metric	Change
Total Tests	📈 +6
Passed Tests	📈 +6
Failed Tests	—
Skipped Tests	—

All tests are passing successfully.

✅ Patch coverage is 91.53%. Project has 14086 uncovered lines.
✅ Project coverage is 77.14%. Comparing base (base) to head (head).

Files with missing lines (3)

File	Patch %	Lines
src/lib/init/preflight.ts	87.50%	⚠️ 3 Missing
src/commands/issue/list.ts	0.00%	⚠️ 1 Missing
src/lib/api/infrastructure.ts	97.06%	⚠️ 1 Missing

Coverage diff

@@            Coverage Diff             @@
##          main       #PR       +/-##
==========================================
+ Coverage    77.10%    77.14%    +0.04%
==========================================
  Files          320       320         —
  Lines        61568     61609       +41
  Branches         0         0         —
==========================================
+ Hits         47465     47523       +58
- Misses       14103     14086       -17
- Partials         0         0         —

---

Generated by Codecov Action

[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 fe033af. Configure here.}