fix(log): add ID column, --fields in human mode, and swapped-arg recovery

[BYK]

Summary

Fixes #858 — three improvements to sentry log commands:

• ID column in sentry log list: Adds a new ID column showing the first 8 characters of the log entry ID (sentry.item_id). Users can copy this prefix and use it with sentry log view, which resolves it via the existing hex-id-recovery fuzzy prefix matching system.
• --fields in human mode: When --fields email,user_id is passed, the requested fields are now sent to the ourlogs API as additional field parameters and rendered as extra columns in the human-mode table output. Works in both single-fetch and --follow modes. In trace mode, a warning is emitted since the trace-logs endpoint has a fixed field set.
• Swapped argument auto-recovery: sentry log view <hex-id> <org/project> now auto-detects the reversed argument order (exactly 2 args), swaps them, and emits a warning. Issue short IDs like CAM-82X are checked first so they still get the correct "Did you mean: sentry issue view" suggestion.

Issue #4 from the bug report (numeric extra={} fields returning null) is a backend/ingestion issue, not fixable in the CLI.

Changes

src/lib/formatters/log.ts

• Export LogLike type with sentry.item_id, id, and index signature for extra fields
• Add getLogId() helper with safe typeof guards (no as string casts)
• Add ID column to table headers and buildLogRowCells (4 cells: ID, Timestamp, Level, Message)
• Accept optional extraFields in buildLogRowCells, formatLogRow, createLogStreamingTable, formatLogsHeader, formatLogTable
• Extend hint rows with placeholder values for extra columns (StreamingTable width estimation)

src/lib/api/logs.ts

• Add extraFields?: string[] to ListLogsOptions
• Merge extra fields into the API field parameter with deduplication

src/commands/log/list.ts

• Import canonical LogLike from formatters and extend with timestamp_precise (no duplicate type)
• Thread flags.fields through to listLogs() as extraFields in both single-fetch and follow modes
• Wrap first follow-mode batch in LogListResult to carry extraFields context for the renderer
• Extract initFirstRender, isLogListResult, validateFollowFlags to reduce cognitive complexity
• Warn when --fields is used with trace mode

src/commands/log/view.ts

• Wire detectSwappedViewArgs for exactly 2-arg case to auto-correct reversed positional arguments
• Check looksLikeIssueShortId before swap detection to preserve issue-view suggestions

Tests

• Updated formatter tests for 4-column table layout
• Added tests for getLogId, buildLogRowCells with extra fields, extra columns in formatLogTable/formatLogsHeader
• Updated swapped-args test to verify auto-correction behavior

[github-actions]

PR Preview Action v1.8.1
🚀 View preview at https://cli.sentry.dev/_preview/pr-871/
Built to branch gh-pages at 2026-04-29 03:33 UTC. Preview will be ready when the GitHub Pages deployment is complete.

[github-actions]

Codecov Results 📊

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

📊 Comparison with Base Branch

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

All tests are passing successfully.

✅ Patch coverage is 80.68%. Project has 13026 uncovered lines.
❌ Project coverage is 76.02%. Comparing base (base) to head (head).

Files with missing lines (4)

File	Patch %	Lines
src/commands/log/list.ts	81.32%	⚠️ 17 Missing
src/commands/log/view.ts	61.11%	⚠️ 14 Missing
src/lib/api/logs.ts	44.44%	⚠️ 5 Missing
src/lib/formatters/log.ts	94.37%	⚠️ 4 Missing

Coverage diff

@@            Coverage Diff             @@
##          main       #PR       +/-##
==========================================
- Coverage    76.03%    76.02%    -0.01%
==========================================
  Files          294       294         —
  Lines        54164     54315      +151
  Branches         0         0         —
==========================================
+ Hits         41182     41289      +107
- Misses       12982     13026       +44
- 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 51ffec8. Configure here.}