feat(release): add --from to scope set-commits to a local range

[betegon]

Summary

Adds a --from <ref> flag to sentry release set-commits so monorepo users can associate only the commits that changed a given subtree since the last release — the use case raised in the last comment of #1156:

sentry release set-commits 1.0.0 --from v0.9.0 --path apps/mobile,apps/shared

This reads the local v0.9.0..HEAD range, keeps only commits touching those paths, and sends them.

Why a new flag instead of --commit PREV..SHA --path ...

Path filtering can only happen client-side. --commit/--auto send a ref range that Sentry expands server-side, and the API has no concept of paths (confirmed in set_refs/set_commits on the backend) — so a path filter there would be silently ignored. That's why --path already implies local git, and why the range it needs must also be local. --from reuses the existing getCommitLog(from, paths) path (git log <ref>..HEAD -- <paths>).

What changed

• --from <ref> (implies --local): reads <ref>..HEAD from local git. Combines with --path. Cannot be combined with --auto/--commit (same rule as --path), and rejects an empty ref.
• Depth handling: a from..HEAD range is self-bounding, so --initial-depth is dropped when --from is set. getCommitLog now only adds --max-count for a positive depth (omitting it reads the whole range).
• Extracted parseCommitRefs and parseLocalScope helpers to keep func under the cognitive-complexity limit.
• Requires a full (non-shallow) checkout spanning the range — already surfaced via the existing shallow-clone warning.

Test plan

• pnpm vitest run test/commands/release/set-commits.test.ts test/lib/git-commit-log.test.ts — 28 pass (new: --from implies local, combines with --path, rejects empty/--auto/--commit; getCommitLog omits --max-count for a range and applies it for a positive depth).
• pnpm tsc --noEmit, biome, and pnpm run check:fragments all clean.

Follow-up to #1156 (the --clear fix landed in #1196).

Made with Cursor

[github-actions]

PR Preview Action v1.8.1
🚀 View preview at https://cli.sentry.dev/_preview/pr-1197/
Built to branch gh-pages at 2026-07-06 09:14 UTC. Preview will be ready when the GitHub Pages deployment is complete.

[github-actions]

Codecov Results 📊

✅ Patch coverage is 83.33%. Project has 5333 uncovered lines.
✅ Project coverage is 81.8%. Comparing base (base) to head (head).

Files with missing lines (1)

File	Patch %	Lines
src/commands/release/set-commits.ts	80.00%	⚠️ 8 Missing and 1 partials

Coverage diff

@@            Coverage Diff             @@
##          main       #PR       +/-##
==========================================
+ Coverage    81.80%    81.80%        —%
==========================================
  Files          423       423         —
  Lines        29282     29308       +26
  Branches     19051     19082       +31
==========================================
+ Hits         23953     23975       +22
- Misses        5329      5333        +4
- Partials      1983      1982        -1

---

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 306f19b. Configure here.}