reflet-sdk 0.7.2 → 0.7.4

package/CHANGELOG.md

@@ -5,6 +5,35 @@ All notable changes to `reflet-sdk` will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.7.4] - 2026-10-15
+
+### Changed
+
+- Devtools: one panel button replaces the separate Board and Notes buttons. It reopens the panel on the tab you used last, even after a reload, and shows how many notes aren't on the board yet. The microphone opens Sessions directly. The bar steps aside while the panel is open, and the panel opens wider (480 px).
+- Devtools: the panel's tabs carry icons, in the order Board, Notes, Sessions, Code. Your Reflet account (avatar, name, organization) sits in the panel's footer, with Connect and Disconnect; the Board tab no longer has a connection bar, and Sessions no longer says "Recording as…".
+- Devtools: secondary choices are menus, not a second row of tabs: This page / Whole board on the Board, On screen / Details on a session's intentions. Every menu and surface follows one radius scale.
+- Devtools: opening a session replaces the tabs with a back button to Sessions; the brief adds one more level back to the session. The links back inside the content, except "All evidence" from one screenshot, are gone. Moving between levels puts keyboard focus on the new view's heading, or on the view itself while it loads, and the session keeps its tab and On screen / Details choice when you come back from the brief.
+- Sessions: on first use, "What a session records" shows above Start session instead of below it. Deleting an intention or a screenshot now says exactly which saved briefs go with it.
+- Devtools: when connecting isn't possible, the panel says what it needs: a public key and a local address (localhost, *.localhost or *.test), or REFLET_SECRET_KEY. Error messages point to the panel's footer instead of the old Board tab.
+- Sessions: "Hand off N confirmed" is now "Prepare brief". Nothing is shared until you copy the brief or download its `.zip`; "Copied or exported briefs can't be recalled" is gone. Earlier briefs list the intention they carried, when, and whether you copied or downloaded them. Dates read "Today, 14:02", "Yesterday, 14:02" or "12 Oct, 14:02".
+- Notes: "Send to board" is now "Add to board". The empty Notes tab has a Pick an element button.
+
+### Added
+
+- Sessions: add an intention to the board from its card, or every confirmed intention not on the board yet from the review's footer. Intentions on the board show "On the board".
+- Devtools: the account footer shows your Reflet avatar. Requires the matching Reflet backend; older backends show initials.
+
+### Removed
+
+- Devtools: the pick button in the panel header (the bar and the Notes tab have it), and the press-shrink on rows and cards.
+
+## [0.7.3] - 2026-10-14
+
+### Added
+
+- Sessions: the Intentions tab opens On screen. Each intention is pinned on the screenshot of the moment it's about: a frame around the element, a line, a number, and a short label the AI writes (at most 6 words, in your language), with Confirm and Dismiss right on the label. A choice already made stays focusable but inactive, like on the cards; Undo in the notice reverts it. Click the label to open the full intention under Details. Intentions with no screenshot are listed below with the same buttons. Your own wording replaces the AI label: once you, an accepted change or a removed contribution rewrites the need, the label shows the need itself. Requires the matching Reflet backend.
+- Sessions: the frame goes around the element you talk about, not the one under your pointer. Each screenshot now records the names and positions of the buttons, links, headings and images it shows (masked elements and anything in or around typed text left out, at most 80), and the AI picks among them. When nothing matches, or for sessions analyzed before, the label sits on the screenshot without a frame. Removing a screenshot or correcting a passage's context moves the pin at once. The session disclosure lists this.
+
 ## [0.7.2] - 2026-10-13
 
 ### Fixed

package/README.md

@@ -180,13 +180,16 @@ canvas content may come out blank.
 #### Devtools for your team (development only)
 
 In `NODE_ENV=development`, `RefletFeedback` also mounts a small devtools bar
-above its launcher; drag it by its grip anywhere, double-click the grip to put
-it back. Its panel opens full height: drag its header to move it (double-click
-to dock it back), drag its inner edge, bottom edge or corner to resize it
-(double-click a handle to reset). Position and size are remembered and refit
-whenever the window changes size. Production builds drop it at bundle time —
-the devtools chunk is never shipped to your users. Pass `devtools={false}` to
-turn it off.
+above its launcher: **Pick**, **Sessions** (the microphone) and the panel
+button, which reopens the panel on the tab you used last. Drag the bar by its
+grip anywhere, double-click the grip to put it back. While the panel is open
+the bar steps aside. The panel opens full height: drag its header to move it
+(double-click to dock it back), drag its inner edge, bottom edge or corner to
+resize it (double-click a handle to reset). Position and size are remembered
+and refit whenever the window changes size. Your Reflet account and
+organization sit in the panel's footer, with Connect and Disconnect. Production
+builds drop it at bundle time — the devtools chunk is never shipped to your
+users. Pass `devtools={false}` to turn it off.
 
 - **Pick** — click an element to write a note on it. The note card has a
   "View code" button, and Shift+click (or Shift+Enter) skips the note and opens
@@ -204,24 +207,27 @@ turn it off.
   to retry.
 - **Copy as prompt** — every note, with its source location, component stack,
   selector and markup, as one Markdown prompt for a coding agent.
-- **Send to board** — notes become internal feedback: members see them with an
+- **Add to board** — notes become internal feedback: members see them with an
   "Internal" badge, the public board never does, and an admin can make one
   public from the dashboard.
-- **Board** — the board's feedback for the current route, or the whole board,
-  with "Show on page", the reporter's source location, and a code search for
-  the element's text.
+- **Board** — the board's feedback for the current route, or the whole board
+  (the view menu next to the count), with "Show on page", the reporter's
+  source location, and a code search for the element's text.
 - **Sessions** — talk through the app while you use it: Reflet records your
   voice, what you point at and mark, and a screenshot at the start, at each
   mark and on each page change. Finish, and Reflet transcribes the session and
-  proposes the changes you asked for. Keep, edit or dismiss each proposal, then
-  hand the kept ones off as a brief to copy into a coding agent or export as a
-  `.zip` with its screenshots. Sessions are recorded under your own name, so
-  they need Connect rather than `REFLET_SECRET_KEY`.
+  proposes the intentions behind what you said. Confirm, edit or dismiss each
+  one. Like notes, confirmed intentions have two ways out: **Prepare brief**
+  builds a brief you copy into a coding agent or download as a `.zip` with its
+  screenshots (nothing is shared until you copy or download it), and **Add to
+  board** turns them into internal feedback, one by one or all at once.
+  Sessions are recorded under your own name, so they need Connect rather than
+  `REFLET_SECRET_KEY`.
 
 Code view and the board go through one dev-only route that reads files from
 your repository and holds the board credential server-side.
 
-To reach the board, click **Connect to Reflet** in the Board tab: sign in on
+To reach the board, click **Connect to Reflet** in the panel's footer: sign in on
 reflet.app, approve the organization that owns the widget's key, and the dev
 server keeps a revocable token in `~/.reflet/devtools/`,
 outside the repository. That token acts as you, only reaches the devtools