Skip to content

fix(completions): populate project cache from listProjects#517

Merged
betegon merged 1 commit intomainfrom
fix/project-completion-cache
Mar 20, 2026
Merged

fix(completions): populate project cache from listProjects#517
betegon merged 1 commit intomainfrom
fix/project-completion-cache

Conversation

@betegon
Copy link
Member

@betegon betegon commented Mar 20, 2026

Summary

Shell completions showed org slugs but not projects after the slash. The completion PR (#465) described "lazy project cache population" but only DSN resolution actually wrote to the project_cache table. Commands like project list, issue list, etc. fetched projects but never cached them for completions.

Adds cacheProjectsForOrg() at the API layer (in listProjects()), mirroring how listOrganizations() calls setOrgRegions(). Every command that lists projects now automatically seeds the completion cache.

Changes

  • src/lib/db/project-cache.ts — Add cacheProjectsForOrg() batch function using transactional upsert (same pattern as setOrgRegions())
  • src/lib/api/projects.ts — Call cache after listProjects() returns (best-effort, wrapped in try/catch)
  • test/lib/db/project-cache.test.ts — 4 new tests: batch insert, idempotency, empty no-op, no conflict with DSN cache keys

Test Plan

  • bun test test/lib/db/project-cache.test.ts — 26 tests pass (4 new)
  • bun test test/lib/complete.test.ts — 20 tests pass
  • bun run typecheck — clean
  • bun run lint — clean
  • Manual: run sentry project list myorg/, then sentry issue list myorg/<TAB> — projects now complete

@github-actions
Copy link
Contributor

github-actions bot commented Mar 20, 2026

Semver Impact of This PR

🟢 Patch (bug fixes)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).


New Features ✨

Telemetry

  • Include user email in Sentry telemetry context by BYK in #513
  • Track TTY vs non-TTY invocations via metric by betegon in #482

Other

  • (help) Fuzzy "Did you mean?" suggestions for command typos by BYK in #516
  • (upgrade) Add progress spinners for version check and download phases by BYK in #515
  • Dynamic cache-backed shell completions with fuzzy matching by BYK in #465

Bug Fixes 🐛

  • (completions) Populate project cache from listProjects by betegon in #517
  • (help) Hide ASCII banner when stdout is not a TTY by betegon in #501
  • (json) Flatten view command JSON output for --fields filtering by BYK in #495
  • (polling) Throw TimeoutError instead of bare Error on timeout by BYK in #503
  • (project) Fallback to org listing when bare slug matches an organization by betegon in #475
  • (setup) Auto-configure zsh fpath for shell completions by betegon in #509
  • Isolate multiregion 403 tests from env-var auth tokens by BYK in #514
  • Only mention token scopes in 403 errors for env-var tokens by BYK in #512
  • Suggest similar projects on project-search miss (CLI-A4) by BYK in #511
  • Preserve ApiError type in Seer handler + suggest trial start command (CLI-N, CLI-1D/BW/98) by BYK in #510
  • Add 403 scope guidance to issue list error handling (CLI-97) by BYK in #508
  • Propagate 403 from multi-region fan-out instead of returning empty list (CLI-89) by BYK in #507
  • Lowercase project slug in URL-parsed issue short IDs (CLI-C8 follow-up) by BYK in #506
  • Handle EIO stream errors gracefully in bin.ts by BYK in #505
  • Use fuzzyMatch for similar project suggestions and add tests (CLI-C0) by BYK in #504
  • Use resolved org in numeric issue ID 404 hint (CLI-BT) by BYK in #502
  • Include API endpoint in error messages for better diagnostics (CLI-BS) by BYK in #500
  • Enrich 403 on org listing with token scope guidance (CLI-89) by BYK in #498
  • Add 400 suggestions to org-all issue list path (CLI-BY) by BYK in #497
  • Lowercase project slug in issue arg parsing (CLI-C8) by BYK in #496
  • Enrich short ID 404 with org context and suggestions (CLI-A1) by BYK in #494
  • Suggest similar projects when project not found in org (CLI-C0) by BYK in #493
  • Event 404 hint should suggest different project, not repeat failing command by BYK in #492
  • Enrich event 404 errors with retention and format suggestions (CLI-6F) by BYK in #491
  • Add actionable suggestions for 400 Bad Request on issue list (CLI-BM, CLI-7B) by BYK in #489
  • Detect issue short IDs passed to issue list (CLI-C3) by BYK in #488
  • Add Glob.match() polyfill + improve auto-detect diagnostics (CLI-7T) by BYK in #487
  • Add org-slug pre-check to dispatchOrgScopedList (CLI-9A) by BYK in #485

Internal Changes 🔧

  • (issue) Skip getProject round-trip in project-search resolution by betegon in #473
  • (resolve) Carry project data through resolution to eliminate redundant getProject calls by BYK in #486
  • (telemetry) Convert is_tty metric to span tag by betegon in #499
  • HTTP latency optimizations — diagnostics, cache warming, concurrency limits by BYK in #490
  • Switch from @sentry/bun to @sentry/node-core/light (~170ms startup savings) by BYK in #474
  • Regenerate skill files by github-actions[bot] in b7b240ec

🤖 This preview updates automatically when you update the PR.

@github-actions
Copy link
Contributor

github-actions bot commented Mar 20, 2026

Codecov Results 📊

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

📊 Comparison with Base Branch

Metric Change
Total Tests
Passed Tests
Failed Tests
Skipped Tests

✨ No test changes detected

All tests are passing successfully.

✅ Patch coverage is 100.00%. Project has 1047 uncovered lines.
✅ Project coverage is 95.79%. Comparing base (base) to head (head).

Files with missing lines (1)
File Patch % Lines
projects.ts 92.82% ⚠️ 15 Missing
Coverage diff
@@            Coverage Diff             @@
##          main       #PR       +/-##
==========================================
+ Coverage    95.79%    95.79%        —%
==========================================
  Files          180       180         —
  Lines        24860     24897       +37
  Branches         0         0         —
==========================================
+ Hits         23813     23850       +37
- Misses        1047      1047         —
- Partials         0         0         —

Generated by Codecov Action

…completions

Shell completions showed org slugs but not projects because only DSN
resolution populated the project_cache table. Commands like `project list`
fetched projects from the API but never cached them.

Add `cacheProjectsForOrg()` batch function (following the `setOrgRegions()`
pattern) and call it from `listProjects()` at the API layer. This means
every command that lists projects (project list, findProjectsByPattern,
findSimilarProjects, etc.) now automatically seeds the completion cache.

After running `sentry project list myorg/`, tab completion for
`sentry issue list myorg/<TAB>` now suggests projects.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@betegon betegon force-pushed the fix/project-completion-cache branch from 229ed8d to 187ea25 Compare March 20, 2026 13:42
@betegon betegon marked this pull request as ready for review March 20, 2026 13:47
@betegon betegon merged commit b600314 into main Mar 20, 2026
22 checks passed
@betegon betegon deleted the fix/project-completion-cache branch March 20, 2026 13:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant