feat(pull-requests): show label descriptions on hover

[RakshithBhat03]

Pull request labels in the Summary tab show their name and color, but leave the label's GitHub description inaccessible.

Labels with a non-empty description now use the shared hover-and-focus Tooltip primitive, including the standard tooltip surface and accessibility wiring. Labels whose description is missing, null, or blank remain ordinary non-interactive chips, and long unbroken descriptions wrap inside the panel.

Descriptions are optional in the shared contract so older clients and providers that do not supply them continue to work. GitHub descriptions are retained only for pull request detail responses; list and cross-repository search payloads stay unchanged.

Verification

• vp test run packages/contracts/src/pullRequest.test.ts apps/server/src/pullRequest/gitHubPullRequestJson.test.ts — 86 tests passed.
• vp run --filter @t3tools/contracts --filter t3 --filter @t3tools/web typecheck — passed. Existing Effect suggestions remain in unchanged server files.
• vp fmt --check packages/contracts/src/pullRequest.ts packages/contracts/src/pullRequest.test.ts apps/server/src/pullRequest/gitHubPullRequestJson.ts apps/server/src/pullRequest/gitHubPullRequestJson.test.ts apps/web/src/components/pullRequest/PullRequestSummaryTab.tsx — passed.
• vp lint --report-unused-disable-directives packages/contracts/src/pullRequest.ts packages/contracts/src/pullRequest.test.ts apps/server/src/pullRequest/gitHubPullRequestJson.ts apps/server/src/pullRequest/gitHubPullRequestJson.test.ts apps/web/src/components/pullRequest/PullRequestSummaryTab.tsx — passed with a pre-existing react(no-array-index-key) warning in PullRequestSummaryTab.tsx.
• vp run --filter @t3tools/web build — production web build passed.
• Manually verified the label description interaction in an isolated seeded web environment.

Screenshots

---

Built by GPT-5.6 in T3 Code through the Codex harness.

---

Note

Low Risk
Backward-compatible optional field, UI-only tooltip behavior, and scoped decoder changes with no auth or data-mutation paths.

Overview
Pull request label descriptions are now surfaced in the Summary tab when GitHub provides them.

The shared PullRequestLabel type gains an optional description (omitted when the host does not send it, null when empty). The GitHub JSON decoder normalizes and trims descriptions for detail responses only; list and search rows still expose name and color without description metadata.

On the web, label chips in PullRequestSummaryTab are rendered via PullRequestLabelChip: labels with a non-empty description become focusable chips with a tooltip; others stay plain chips. Contract and server tests lock in backward compatibility and the list-vs-detail split.

^{Reviewed by Cursor Bugbot for commit 1e9ff44. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

[!NOTE]

Show label descriptions on hover in pull request summary tab

• Adds an optional description field to the PullRequestLabel schema in pullRequest.ts, which is absent when the host does not report it and null when no description exists.
• Extends the GitHub label decoder in gitHubPullRequestJson.ts to parse and normalize descriptions; detail views include descriptions, list views omit them.
• Introduces a PullRequestLabelChip component in PullRequestSummaryTab.tsx that wraps labels with a tooltip showing the description when one is present.

^{Macroscope summarized 1e9ff44.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 83d8b264-e8ae-4292-b88b-51958967c57b

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[macroscopeapp]

Approvability

Verdict: Approved 5b2dcbc

Minor UI enhancement that adds tooltip descriptions to pull request labels on hover. The changes are additive, backward compatible, follow existing tooltip patterns in the codebase, and include comprehensive tests.

^{You can customize Macroscope's approvability policy. Learn more.}

[macroscopeapp]

One consistency finding on the new label chip: the hover description is built from Popover rather than the shared Tooltip primitive this file already uses for its other hover-only text. Details inline.

^{Posted via Macroscope — UI Consistency}

Dismissing prior approval to re-evaluate 5b2dcbc