Skip to content

hermes-github-prs v0.3.0 — UI polish

Choose a tag to compare

@claudiumio claudiumio released this 21 Aug 05:04
· 58 commits to main since this release

hermes-github-prs v0.3.0

Special UI release. The pane now matches the density of GitHub's own PR page without leaving Hermes Desktop.

Polished list/detail hierarchy, timeline conversation, jump-to-latest, exact #N search. Still no backend — gh via shell.exec.

poster


Highlights

  • Filled PR / Issue headers — kicker (Pull request / Issue), grouped meta chips, title glued to #, radial pattern on --ui-editor-surface-background
  • Conversation rail — comments and commits share a gh-timeline; Quote is icon-only on hover/focus; inline threads keep file:line on a second line with a contained diff
  • Checks in the conversation — compact strip Blocked / Waiting / All passed via summarizeChecks (failures first, native StatusDot, collapsible). Dedicated Checks tab stays
  • Commits as <details> — lazy panel (full message, +/−, up to 20 files). SHA and external link do not toggle the row
  • Files unboxed — FileDiffBlock header is loose; border only on the diff body
  • Repo picker pill — 32px chip, owner avatar https://github.com/{owner}.png, owner / name
  • Jump to latest — floating control, Radix viewport only ([data-radix-scroll-area-viewport]); remeasures when headerQ.data mounts so a cached convQ cannot leave atBottom === true and hide the button
  • Exact #N filter — numericListQuery(); #42 matches PR 42, not 142; # 42 (space after hash) still parses
  • Theme inheritance — fields on --ui-editor-surface-background (matte/glass from Desktop); cards on --ui-bg-quaternary; container queries at <360 / <300 / <240

Technical notes

Hook order / TDZ (#20)

useEffect for atBottom used to sit below if (headerQ.isLoading) return. First paint without cache changed hook count (Rendered more hooks than during previous render). Effect now lives above every early return, with if (!el) return.

A later Codex note: if convQ resolved before headerQ, the effect ran during the loading return (no viewport) and never again ([convQ.data, page] unchanged). headerQ.data is now in the dependency list so measurement re-runs when the detail DOM mounts.

Viewport scroll (#20)

onScrollCapture previously used e.target, so nested overflow-x-auto (code blocks / tables) overwrote atBottom and hid Jump to latest. Handler now ignores anything that is not [data-radix-scroll-area-viewport].

Exact #N (#20)

matchesListQuery was substring. Query starting with # now compares item.number === n before any string match.

Layout (#19)

Pure helpers summarizeChecks / sortChecks. Large payloads still go through shBig (base64 chunks). SDK stubs (StatusDot, …). node --check + npm test 17/17.


Merged PRs in this release

  • #19 feat(ui): polished list/detail hierarchy and check/commit layouts
  • #20 fix(ui): address Codex/Pullfrog review — hook order, exact #N, viewport scroll

Install

hermes plugins install claudioorjunior/hermes-github-prs --enable

Requires Hermes Desktop + authenticated gh. Pane: titlebar GitHub → right workspace.


🇧🇷 Português (Brasil)

Release especial de UI. Headers preenchidos, trilho na conversation, checks compactos, commits em <details> lazy, diffs sem caixa, picker com avatar, jump-to-latest no viewport do Radix, busca #N exata, herança matte/glass.

Correções do #20: hook acima dos early-returns (crash de ordem), headerQ.data nas deps (remeasure no mount), filtro [data-radix-scroll-area-viewport], #42 ≠ #142.

PRs: #19, #20. MIT · @hermes/plugin-sdk · só gh.