prreviewbuddy 0.63.0 → 0.69.1

package/CHANGELOG.md

@@ -1,5 +1,157 @@
 # Changelog
 
+## 0.69.1
+
+**Escape leaves the Buddy AI field.** With your cursor in the Buddy AI question box, Escape moves
+focus out of it and keeps what you typed, so J, K and the other single keys work on the page again.
+An open menu or dialog still takes Escape first. A second Escape leaves Prepare feedback or focus
+mode, as before.
+
+## 0.69.0
+
+**Back to the review's overview from the keyboard.** ⌘K S R (Ctrl+K S R off a Mac) goes where the
+Review item at the top of the sidebar goes: the review's Overview, or its progress while it is
+still running. It is first under Sections in the palette. If a section is expanded, the Overview
+opens expanded too, as the other sections do. It is listed in Keyboard shortcuts (⌘K ?).
+
+## 0.68.0
+
+**Prepare and copy feedback from the keyboard.** While you prepare feedback with at least one card
+chosen, ⌘Enter (Ctrl+Enter off a Mac) opens the draft, as the Prepare feedback button does. Enter
+still ticks the ringed card. In the draft, ⌘C copies the whole Markdown, as Copy Markdown does, and
+Escape closes it. If you have selected some of the draft's text, ⌘C copies just that, as it always
+has.
+
+Both buttons now show their key: Prepare feedback ⌘Enter, Copy Markdown ⌘C. Both are listed in
+Keyboard shortcuts (⌘K ?) under Issues and Questions.
+
+## 0.67.0
+
+**Prepare feedback from the keyboard.** ⌘K A P (Ctrl+K A P off a Mac) starts Prepare feedback on
+Issues or Questions, and the same keys leave it from anywhere in the review. The palette names the
+way it will go: Start Prepare feedback, or Exit Prepare feedback.
+
+**Escape leaves Prepare feedback.** Escape now closes the innermost thing first. An open menu, popover
+or dialog closes; with none open, Escape leaves Prepare feedback, just as Done does; and only then
+does it leave an expanded section. It also works straight after ticking a box with the mouse.
+
+**Escape from a card's Ask Buddy menu goes back to the card.** After Space opens the menu and Escape
+closes it, the ring and focus are back on the card, so ⌘C, Space, Enter and J carry on from it
+without moving away and back. A menu opened by clicking its button still returns to the button.
+
+## 0.66.0
+
+**Move through Issues and Questions from the keyboard.** On a review's Issues or Questions, J and K
+move a ring from card to card, the same ring the Reviews list uses, and bring each card on screen.
+Cards folded away under Resolved or Answered are passed over until you open them, and while Buddy
+AI is expanded over the review the keys are left alone. Click a card,
+anywhere on it, and J and K go on from that card.
+
+On the ringed card, Space opens its Ask Buddy menu, ready for the arrow keys, Enter and Escape.
+⌘C (Ctrl+C off a Mac) copies the card, exactly as its Copy button does. If you have selected some
+text, or you are typing in a field, ⌘C copies that instead, as it always has. While you prepare
+feedback, Enter ticks or unticks the ringed card, and J and K move on without changing what you
+have chosen.
+
+**Tick a whole card while preparing feedback.** A click anywhere on a card now ticks it, not only
+on its box. Clicks on the card's own controls (Copy, Ask Buddy, Dismiss, a file location) still do
+what they did, and selecting text on a card does not tick it.
+
+**Menus near the bottom stay on screen.** An Ask Buddy menu opened low in the window now opens
+upwards when it fits there and not below. When it fits neither way, for example with many saved
+prompts in a short window, it opens on the side with more room and scrolls inside, and the arrow
+keys keep the item you are on in view, so every choice stays within reach. The review page's other
+menus, and Ask Buddy in the browser extension, follow the same rule.
+
+All five keys are listed in Keyboard shortcuts (⌘K ?) under Issues and Questions.
+
+## 0.65.0
+
+**Start a review from the workspace with ⌘P.** You no longer need a terminal to start one. Press
+⌘P (Ctrl+P off a Mac) anywhere in the workspace and choose what to review: P for pull requests, B
+for a branch. ⌘P P and ⌘P B go straight there, and both are listed in Keyboard shortcuts and in the
+⌘K palette under Add review.
+
+Pull requests: paste one or more github.com links, in whatever text they came in, and press Enter.
+Links to `/files` or a comment are read as the pull request they belong to, and the same pull
+request pasted twice is reviewed once. Each link gets a row saying what will happen: `Ready`,
+`Already reviewed`, `Local repository not found`, or `GitLab isn't supported yet`. One link that
+cannot be reviewed does not stop the others. A review runs in a local clone of its repository,
+found among the folders you have reviewed in before and their other worktrees, including ones an
+agent made. When more than one folder holds the repository, the row shows which one it will use,
+and you can pick another. The workspace runs two reviews at a time, across everything you start
+from it, and the rest wait their turn. Up to 20 pull requests can go in one paste; past that the
+panel says how many to remove rather than leaving some out. You can close the panel straight away:
+the reviews carry on and appear in your list as they start.
+
+Branch: choose a working folder, from Recent, by typing its path, or with Browse… on a Mac, and
+press Enter. It reviews the branch checked out in that folder, exactly as running `prreviewbuddy`
+there would, and the review is filed under that folder: a worktree stays that worktree, never its
+main clone. The panel shows the repository, branch and base it found, says if that branch already
+has a review, and explains a folder it cannot review, such as one on a detached HEAD.
+
+Review options, folded away, let you change the agent and model for this review, and the base for a
+branch. The agent is the one you configured, as on the command line. When several are installed
+and none is chosen, the options open and ask you to pick one. A review that stopped before it
+finished picks up where it left off with the agent and model it started with, as from the command
+line, and its row says which.
+
+## 0.64.2
+
+**Review state says whether you have reviewed a change, in those words.** On the Reviews page the
+filter reads `Review state: All / Queue / Not reviewed / Reviewed`, and a card you have opened but
+not marked says `Not reviewed` where it said `In progress`. The menus and the bulk bar say
+`Mark not reviewed` for the way back. This is a separate question from where a review sits in
+Active, Waiting and Done, so `Not reviewed` and `Done` together is a card you have put away
+without marking it reviewed, not a contradiction.
+
+`New` still marks a review you have never opened. The `Not reviewed` filter includes those as well,
+because a review nobody has opened has not been reviewed either. Mark not reviewed from a review's
+own page now always lands on `Not reviewed`, never back on `New`, as it already did from the list.
+Links to the old filter keep working.
+
+## 0.64.1
+
+**The author filter names people.** On the Reviews page it reads `Author: Everyone`, like Status
+and PR beside it, and lists each person by their GitHub name with their login beside it:
+`Amy Li · @amy`. Someone with no public name on GitHub is listed by login alone. The list is in
+alphabetical order of what you read, and if someone changes their name on GitHub the filter shows
+the name from their newest review. Author and PR both carry the GitHub mark, because both are
+answered from GitHub. Status is yours, so it has none.
+
+## 0.64.0
+
+**Choose the findings you want to raise, and copy them as one message.** Issues and Questions each
+have a Prepare feedback button now. Press it and every card gets a checkbox; tick the ones you want
+to take to the author. Your choices stay as you move between Issues and Questions, and a bar at the
+foot of the review keeps count: `5 chosen · 2 issues · 3 questions`. Each count takes you back to
+its list. The rail shows `2 chosen` under each. Clear empties your choice, and Done leaves it
+altogether.
+
+Prepare feedback in that bar opens your choices, large enough to read, issues first, then
+questions, each in the order the review lists them. Preview shows the message as the author will
+read it; Markdown shows the text behind it, to edit. They are one draft: an edit is in the preview
+as soon as you switch back, and Copy Markdown copies what you edited. Each item starts as exactly
+what that card's own Copy gives you: the finding, why it matters, and where it points. Severity and
+status are left out, because they are how PR Review Buddy sorts findings for you, not part of what
+you tell the author. Dismissing or answering a finding you chose leaves your draft exactly as you
+left it. Change what you chose, even to take a tick back, and the draft is made again from the new
+choice. Nothing is rewritten by AI.
+
+A choice belongs to the review you made it on. Another review starts with none, and reloading the
+page starts over. Dismiss and Mark answered work as before, while choosing or not.
+
+Lists are drawn as GitHub draws them, in the feedback preview and in Buddy AI's answers. A list
+with blank lines between its items is one list, numbered on from its first number. A paragraph
+indented under an item stays in that item, and a list indented under an item is drawn inside it,
+one level deep, with its own paragraphs. What counts is how far a line is indented under its item,
+so a list indented the same throughout is still one list. Before, each item after a blank line was
+numbered 1, and a nested list was drawn as more items of the outer one, so a finding with numbered
+steps of its own previewed them as further findings.
+
+KISS's Copy draft comment and Copy recommendations now say Copied in their own words after a
+click, and then go back to their names. Before, the first click left them as a bare icon.
+
 ## 0.63.0
 
 **Telemetry now records first use.** With telemetry on, PR Review Buddy sends one more event,