pi-bro 0.22.2 → 0.23.1

package/CHANGELOG.md

@@ -2,6 +2,45 @@
 
 All notable changes to pi-bro are documented here.
 
+## [0.23.1] - 2026-10-15
+
+### Highlights
+
+- Scroll Bro's explain, show, help and btw windows with the mouse wheel again on Pi 1.2.
+- See the save messages and key hints in `/bro preferences`, `/bro advisor-steer` and `/bro config` on normal-size terminals; they were cut off at the bottom.
+- btw keeps your place: it follows the newest answer while you are at the bottom and no longer jumps back to the top after each reply.
+
+### Fixed
+
+- Mouse-wheel scrolling in the explain/show/doctor/help and btw windows on Pi 1.2 fullscreen. Pi 1.2 stopped passing raw wheel input to windows without a mouse handler; both windows now handle Pi's mouse events and keep the raw path for Pi 0.84 and regular mode.
+- The wheel over the preferences, advisor-steer, config and Guided Review loading windows no longer scrolls the chat behind them on Pi 1.2.
+- `/bro preferences`, `/bro advisor-steer` and `/bro config` fit their windows: no blank padding rows, a shorter editor hint line, the editors' height limit raised from 60% to 78% like the other Bro windows, and the config list sized to the terminal. At 24 rows the preferences editor now draws 18 rows instead of 27. Very short terminals (under about 22 rows) can still clip the editors, because Pi's editor has a minimum height.
+- `/bro config` shows one key-hint line instead of two that disagreed, and its model picker shows its own hints.
+- btw's hint while a reply runs now says Esc closes the panel and stops the reply, which is what it does.
+- Guided Review saves once when you close it instead of twice; teardown without closing it (for example switching sessions) still saves.
+
+### Changed
+
+- Internal: `src/bro.ts` is split into feature and modal modules (#133). No behaviour change.
+
+## [0.23.0] - 2026-10-13
+
+### Highlights
+
+- `/bro show` can draw a real sequence diagram when a conversation traces messages among three or more parts of a system. Press **O** to see it rendered in your browser.
+- Bro is now tested on Pi 1.2 as well as Pi 0.84.2, and the README says so.
+- pi-bro has a preview card in the pi.dev package gallery.
+
+### Added
+
+- `/bro show` can end a reply with one Mermaid `sequenceDiagram` for interactions among three or more participants (#108). The modal keeps the diagram's source readable and **O** opens a rendered version. Bro builds that page itself: it inlines a vendored Mermaid 12.1.0, allows only its own two scripts by hash, runs Mermaid with `securityLevel: "strict"` and no HTML labels, and inserts the model's text as escaped source. Any other Mermaid stays in the modal as plain text. If the diagram file cannot be written, the reply is kept and a warning is shown.
+
+### Changed
+
+- Tested on Pi 1.2.0 (development pin) with a CI job that keeps Pi 0.84.2 covered; the README's Pi range now reads `>=0.84.2` (#130).
+- The package now bundles Mermaid 12.1.0 for sequence diagrams, so it grows from about 0.5 MB to 6 MB unpacked (#108).
+- Runtime source moved into `src/`; the extension entry is now `src/bro.ts`. Installs are unaffected. The package also sets a pi.dev gallery preview image (#116).
+
 ## [0.22.2] - 2026-10-13
 
 ### Highlights

package/README.md

@@ -16,9 +16,7 @@ main agent's conversation stays clean. Before you install, see
 [what leaves your machine](#what-leaves-your-machine).
 
 <p align="center">
-  <a href="https://raw.githubusercontent.com/tranhoangnguyen03/pi-bro/main/docs/images/bro-response-after.png">
-    <img alt="A dense agent reply explained in plain language in the Bro window" src="https://raw.githubusercontent.com/tranhoangnguyen03/pi-bro/main/docs/images/bro-response-after.png" width="820">
-  </a>
+  <img alt="Bro explains a dense agent reply in plain language, then answers a side question" src="https://raw.githubusercontent.com/tranhoangnguyen03/pi-bro/main/docs/images/bro-demo.gif" width="820">
 </p>
 
 ## Install
@@ -51,7 +49,7 @@ GitHub, use `pi install git:github.com/tranhoangnguyen03/pi-bro`.
 | Command | What you get |
 | --- | --- |
 | `/bro`, `/bro text`, `/bro file`, `/bro url` | **[Explain](docs/user-guide.md#what-bro-can-explain).** A plain-language version of the agent's last reply, pasted text, a PDF/DOCX/Markdown file, or a public webpage. Three modes: `brief`, `balanced`, `faithful`. |
-| `/bro show` | **[Show](docs/user-guide.md#bro-show).** The last few turns drawn as a shape (call tree, file tree, diff, pseudocode, or an HTML diagram) instead of prose. |
+| `/bro show` | **[Show](docs/user-guide.md#bro-show).** The last few turns drawn as a shape (call tree, file tree, diff, pseudocode, a sequence diagram, or an HTML layout) instead of prose. |
 | `/bro btw` | **[Side questions](docs/user-guide.md#bro-btw-side-conversation).** A separate conversation seeded with recent context, so you can ask without interrupting the agent. ⚠️ [Full-permission mode](#what-leaves-your-machine) can edit files. |
 | `/bro guided-review <PR>` | **[Guided Review](docs/guided-review.md).** An explanation and quality assessment of a GitHub PR, with ranked findings, source evidence and private questions. Needs the Claude or Muse backend. |
 | `bro_advisor` tool | **[Second opinion](docs/user-guide.md#bro-advisor).** A tool your agent can call mid-task; a fresh backend process investigates and returns advice to the agent. ⚠️ [Runs with permissions bypassed](#what-leaves-your-machine). |
@@ -62,7 +60,7 @@ Guided Review has its own [guide](docs/guided-review.md).
 
 ## Requirements
 
-- Pi `>=0.84.2 <1` and Node.js `>=22.19.0`.
+- Pi `>=0.84.2` (tested on 0.84.2 and 1.2) and Node.js `>=22.19.0`.
 - macOS or Linux. Windows is untested; there, cancelling stops only the
   backend's direct process, not anything it started.
 - At least one backend CLI on your `PATH`, signed in once from your terminal.
@@ -89,7 +87,7 @@ which may keep it under their own policies. Paths below are under
 | Feature | What is sent | What Bro keeps on disk |
 | --- | --- | --- |
 | Explain | The agent's last reply, your pasted text, or text extracted from your file or webpage, plus your preferences | Nothing; the last result stays in memory |
-| Show | User and assistant text from recent turns (no tool calls, tool results, reasoning or images), plus your preferences | HTML diagrams in `pi-bro-<uid>/` in your system temp folder |
+| Show | User and assistant text from recent turns (no tool calls, tool results, reasoning or images), plus your preferences | Diagram pages in `pi-bro-<uid>/` in your system temp folder |
 | Side questions | Your questions and up to the last 8 turns of conversation text, plus your preferences | Nothing; the thread stays in memory |
 | Guided Review | The PR description and diff, the files the backend reads, your questions, plus your preferences | Reviews and captured source in `bro-reviews/`, with no automatic cleanup |
 | Advisor | The agent's system instructions, tool list and whole conversation, including tool calls and results (reasoning and images omitted), plus your steering | Steering in `bro-advisor.md` and the session file |
@@ -142,7 +140,7 @@ release is published to npm from CI with
 ```sh
 npm ci
 npm test        # offline: uses fake backend CLIs, never calls a model
-pi --tui-mode fullscreen -e ./bro.ts
+pi --tui-mode fullscreen -e ./src/bro.ts
 ```
 
 See [CONTRIBUTING.md](CONTRIBUTING.md), the [code map](docs/DEVELOPMENT.md)

package/THIRD_PARTY_NOTICES.md

@@ -67,6 +67,35 @@ HTML parsing uses [LinkeDOM](https://github.com/WebReflection/linkedom),
 copyright (c) 2021 Andrea Giammarchi (@WebReflection), licensed under the ISC
 License. Its complete license is distributed with the LinkeDOM npm package.
 
+## Mermaid
+
+`vendor/mermaid.min.js` is the unmodified `dist/mermaid.min.js` from the
+[mermaid](https://github.com/mermaid-js/mermaid) npm package, version 12.1.0
+(sha256 `6484afc32872a3aa16cac9a76ba1816a1ed4cc870a6593cc2e17757750f518b2`).
+`/bro show` inlines it into the diagram page it writes. Licensed under the MIT License:
+
+The MIT License (MIT)
+
+Copyright (c) 2014 - 2022 Knut Sveidqvist
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
 ## show-me
 
 The experimental show prompt's form menu, diff grammar, and example
@@ -96,3 +125,31 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
+
+## Mermaid
+
+`src/vendor/mermaid.min.js` is the unmodified browser build of
+[Mermaid](https://github.com/mermaid-js/mermaid) 12.1.0, licensed under the MIT
+License:
+
+The MIT License (MIT)
+
+Copyright (c) 2014 - 2022 Knut Sveidqvist
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/docs/pig-compatibility.md

@@ -12,7 +12,7 @@ Install the PiG binary from https://github.com/MichaelKinsy/PiG/releases/tag/v0.
 pig install npm:pi-bro
 ```
 
-That command installs the published Bro version; these compatibility changes take effect only after a Bro release containing them. To test this checkout now, install dependencies and use `pig -e ./bro.ts`.
+That command installs the published Bro version; these compatibility changes take effect only after a Bro release containing them. To test this checkout now, install dependencies and use `pig -e ./src/bro.ts`.
 
 At initial verification, `@pi-in-go/pig@0.3.0` was not available from npm. CI therefore downloads the pinned GitHub binary and verifies its published SHA-256 checksum.
 

package/docs/user-guide.md

@@ -95,7 +95,7 @@ next mode without saving it:
   faithful → brief). It applies to this explanation only and does not change
   the mode saved by `/bro mode`; pressing it again while Bro is working skips
   ahead
-- **O**: Open the HTML diagram when a show reply contains one
+- **O**: Open the diagram (an HTML layout or a rendered sequence diagram) when a show reply contains one
 - **Esc**: Close the modal, or cancel while Bro is working
 
 The modal header shows the model and reasoning effort the explanation or
@@ -179,8 +179,9 @@ asked in.
 
   `/insert` and `/insert-all` never replace an existing main-editor draft:
   edit or clear it first. Any other text, including other slash-prefixed input
-  such as `/send`, is sent as a question. Esc closes the modal (or cancels a
-  running turn). The header shows the model and reasoning effort the latest
+  such as `/send`, is sent as a question. Esc closes the modal and stops a
+  running turn; the thread is kept. The view follows the newest text while you
+  are at the bottom; scroll up to read earlier turns. The header shows the model and reasoning effort the latest
   turn used (`default` when the model's own effort applies) and the current
   mode.
 - A turn is capped at 2 minutes in conversation-only mode and 10 minutes in
@@ -281,6 +282,12 @@ reply that ends in one self-contained HTML block — layout, a state comparison,
 anything where position itself carries meaning — is written to a file and
 opened with **O**.
 
+When the turns describe messages passing among three or more participants in
+a set order (for example browser → API → database), a reply can instead end in
+one Mermaid `sequenceDiagram`. The modal keeps its source visible with
+`[Diagram saved — press O to render]`; **O** opens a page that draws it with
+the Mermaid copy bundled in Bro. Any other Mermaid stays plain text.
+
 Pressing **R** redraws the same captured turns; running `/bro show` again
 captures the latest turns afresh. `/bro show <n-turns>` overrides the default turn
 count for a single run.
@@ -945,10 +952,14 @@ read. Move what you want to keep into `/bro preferences`, and choose
   scripts or loading page subresources. It sends the extracted readable text,
   including links preserved in that text, to the selected backend; it does not
   separately send the requested URL or raw page HTML.
-- **Show diagrams**: When a show reply ends in one self-contained HTML block,
-  Bro writes it to `pi-bro-<uid>/bro-show-<hash>.html` in your system temp folder with a restrictive
-  Content-Security-Policy, and opens it in your browser only when you press
-  **O**. **C** copies the full reply, including the HTML.
+- **Show diagrams**: When a show reply ends in one self-contained HTML block
+  or one Mermaid sequence diagram, Bro writes a page to
+  `pi-bro-<uid>/bro-show-<hash>.html` in your system temp folder with a
+  restrictive Content-Security-Policy, and opens it in your browser only when
+  you press **O**. HTML pages run no scripts. Sequence-diagram pages run only
+  Bro's bundled Mermaid and its fixed setup script; the model's diagram text is
+  inserted as escaped text and nothing is loaded from the network. **C**
+  copies the full reply, including the diagram source.
 - **Clipboard**: **C**, `/copy`, `/copy-all`, and Guided Review's Copy finding copy text to your system
   clipboard, where your operating system or clipboard manager may retain it.
 
@@ -974,7 +985,7 @@ tool before giving it to Bro.
   current session — the last few turns' user and assistant messages, with
   tool calls, tool results, reasoning, and images always omitted; its shapes
   reflect what was reported in the conversation, not independent verification.
-- HTML diagrams open in your default browser; pressing **O** on a remote or
+- Diagrams open in your default browser; pressing **O** on a remote or
   headless session with no display reports the failure instead of opening
   anything.
 - Explain keeps only the latest result in memory and does not export directly to files. Guided Review separately persists review records and captured source.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-bro",
-  "version": "0.22.2",
+  "version": "0.23.1",
   "description": "A sidekick for you and your Pi agent: plain-language explanations, side questions, diagrams, PR review and second opinions, without cluttering the agent's context.",
   "type": "module",
   "license": "MIT",
@@ -41,18 +41,24 @@
     "code-review"
   ],
   "files": [
-    "bro.ts",
-    "review.ts",
-    "review-source.ts",
-    "review-ui.ts",
-    "review-modal.ts",
-    "util.ts",
-    "settings.ts",
-    "sources.ts",
-    "config-ui.ts",
-    "ui-capabilities.ts",
-    "backend.ts",
-    "prompt.ts",
+    "src/bro.ts",
+    "src/doctor.ts",
+    "src/show.ts",
+    "src/advisor.ts",
+    "src/btw.ts",
+    "src/explain-modal.ts",
+    "src/review.ts",
+    "src/review-source.ts",
+    "src/review-ui.ts",
+    "src/review-modal.ts",
+    "src/util.ts",
+    "src/settings.ts",
+    "src/sources.ts",
+    "src/config-ui.ts",
+    "src/ui-capabilities.ts",
+    "src/backend.ts",
+    "src/prompt.ts",
+    "src/vendor/mermaid.min.js",
     "README.md",
     "CHANGELOG.md",
     "LICENSE",
@@ -77,8 +83,9 @@
   },
   "pi": {
     "extensions": [
-      "./bro.ts"
-    ]
+      "./src/bro.ts"
+    ],
+    "image": "https://raw.githubusercontent.com/tranhoangnguyen03/pi-bro/main/docs/images/social-preview.png"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "*",
@@ -86,10 +93,10 @@
     "typebox": "*"
   },
   "devDependencies": {
-    "@earendil-works/pi-coding-agent": "0.84.2",
-    "@earendil-works/pi-tui": "0.84.2",
+    "@earendil-works/pi-coding-agent": "1.2.0",
+    "@earendil-works/pi-tui": "1.2.0",
     "@types/node": "^24.0.0",
-    "typebox": "1.3.7",
+    "typebox": "1.3.27",
     "typescript": "6.0.3"
   },
   "dependencies": {