pi-chassis 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to pi-chassis (published under an earlier name up to 0.3.0)
 
 ## [Unreleased]
 
+## [0.8.0] - 2026-10-30
+
+### Changed
+
+- Allows pi 1.3 and 1.4: the peer dependency range is now `>=1.2.0 <1.5.0`. Checked on pi 1.2.0 and 1.4.0; pi 1.3 was not tested. `docs/internals.md` now lists every unofficial pi hook chassis uses.
+- Versioning: a release now declares a range of supported pi versions instead of one pi minor. Adding a pi minor is a minor release, dropping one is a breaking change, and CI tests the lowest and highest supported versions (README, Versioning).
+
+## [0.7.1] - 2026-10-23
+
+### Changed
+
+- README: the install commands no longer pin a version or a tag, and the advice to pin is gone.
+
 ## [0.7.0] - 2026-10-23
 
 ### Changed
@@ -107,5 +120,7 @@ First public release.
 - Plain and Nerd Font icon sets (`/chassis icons`).
 - Sanitizing of untrusted text (file contents, tool output, git and forge output, session names, widget text) before it reaches the terminal.
 
-[Unreleased]: https://github.com/one24-ai/pi-chassis/compare/v0.7.0...HEAD
+[Unreleased]: https://github.com/one24-ai/pi-chassis/compare/v0.8.0...HEAD
+[0.8.0]: https://github.com/one24-ai/pi-chassis/compare/v0.7.1...v0.8.0
+[0.7.1]: https://github.com/one24-ai/pi-chassis/compare/v0.7.0...v0.7.1
 [0.7.0]: https://github.com/one24-ai/pi-chassis/releases/tag/v0.7.0

package/README.md

@@ -7,12 +7,12 @@ Requires pi 1.2 and Node.js 22.19 or later.
 ## Install
 
 ```bash
-pi install npm:pi-chassis@0.4.0                        # from npm, pinned
-pi install git:github.com/one24-ai/pi-chassis@v0.4.0   # from git, pinned to a tag
-pi install /path/to/pi-chassis                         # a local checkout
+pi install npm:pi-chassis                        # from npm, the latest release
+pi install git:github.com/one24-ai/pi-chassis   # from git, the main branch
+pi install /path/to/pi-chassis                  # a local checkout
 ```
 
-Pin a version: pi keeps a pinned npm version or git tag until you change it, so an update never arrives by surprise. See the [changelog](CHANGELOG.md) before moving to a new one.
+`pi update` moves to the latest release; the [changelog](CHANGELOG.md) says what changed.
 
 pi-chassis replaces pi's header, footer and editor, so it does not combine with another package that replaces any of them (pi-open-tui is one): keep only one such package in `packages`.
 
@@ -45,7 +45,7 @@ pi-chassis follows [Semantic Versioning](https://semver.org). The public API is:
 - the slash commands, their arguments and the `ctrl+x` and `ctrl+p` keys,
 - the settings it stores in `~/.pi/agent/chassis.json`.
 
-A change that breaks one of those is a major version, a new feature is a minor version, and a fix is a patch. Before 1.0.0, a breaking change bumps the minor version instead (0.1 to 0.2). Each release supports one pi minor version, declared in `peerDependencies`; supporting a new pi minor is a minor release of pi-chassis. Every change is listed in [CHANGELOG.md](CHANGELOG.md); how a release is cut is in [RELEASING.md](RELEASING.md).
+A change that breaks one of those is a major version, a new feature is a minor version, and a fix is a patch. Before 1.0.0, a breaking change bumps the minor version instead (0.1 to 0.2). Each release declares the pi versions it supports in `peerDependencies`. Adding a pi minor version is a minor release; dropping one is a breaking change. CI tests the lowest and highest supported pi versions. Every change is listed in [CHANGELOG.md](CHANGELOG.md); how a release is cut is in [RELEASING.md](RELEASING.md).
 
 ## Credits
 

package/dist/chassis/layout.d.ts

@@ -4,7 +4,7 @@
  * Fullscreen mode: pi renders one layout root (a VStack of transcript + input dock). We wrap it in
  * an HStack with the sidebar as a fixed-width right column, which is what OpenCode looks like.
  * There is no extension API for this: it relies on the TUI's `layoutRoot` field and
- * `setLayoutRoot()` (pi-tui ViewportTUI), verified on pi 1.1.0. If either is missing, or pi
+ * `setLayoutRoot()` (pi-tui ViewportTUI), verified on pi 1.4.0. If either is missing, or pi
  * swaps the root back (renderer switch), the guard widget re-wraps it or we fall back.
  *
  * Regular mode has no layout root, so the sidebar is a toggleable overlay instead.

package/dist/chassis/layout.js

@@ -4,7 +4,7 @@
  * Fullscreen mode: pi renders one layout root (a VStack of transcript + input dock). We wrap it in
  * an HStack with the sidebar as a fixed-width right column, which is what OpenCode looks like.
  * There is no extension API for this: it relies on the TUI's `layoutRoot` field and
- * `setLayoutRoot()` (pi-tui ViewportTUI), verified on pi 1.1.0. If either is missing, or pi
+ * `setLayoutRoot()` (pi-tui ViewportTUI), verified on pi 1.4.0. If either is missing, or pi
  * swaps the root back (renderer switch), the guard widget re-wraps it or we fall back.
  *
  * Regular mode has no layout root, so the sidebar is a toggleable overlay instead.

package/dist/chassis/messages.d.ts

@@ -1,6 +1,6 @@
 /**
  * OpenCode-style transcript styling. pi has no renderer hooks for these, so two prototype patches
- * (pi and extensions share one module instance; verified on pi 1.1.0), both undone on uninstall:
+ * (pi and extensions share one module instance; verified on pi 1.4.0), both undone on uninstall:
  *
  * 1. User messages (UserMessageComponent.render): a ┃ bar in the agent colour, then the message
  *    on the panel background with 1 row of padding above and below and 2 columns on the left,

package/dist/chassis/messages.js

@@ -1,6 +1,6 @@
 /**
  * OpenCode-style transcript styling. pi has no renderer hooks for these, so two prototype patches
- * (pi and extensions share one module instance; verified on pi 1.1.0), both undone on uninstall:
+ * (pi and extensions share one module instance; verified on pi 1.4.0), both undone on uninstall:
  *
  * 1. User messages (UserMessageComponent.render): a ┃ bar in the agent colour, then the message
  *    on the panel background with 1 row of padding above and below and 2 columns on the left,

package/docs/internals.md

@@ -2,12 +2,20 @@
 
 pi has no extension API for a side panel. In fullscreen mode (`"tuiMode": "fullscreen"`), pi renders one layout root, a vertical stack of transcript plus input. pi-chassis wraps that root in a horizontal stack with the sidebar as a fixed 48-column right column, using pi-tui's `setLayoutRoot()`.
 
-This was last checked on pi 1.2.0. A pi update could change these internals. If that happens, or in regular mode, the sidebar falls back to a pop-up overlay (`ctrl+x b`), and everything else keeps working.
+This was last checked on pi 1.4.0. A pi update could change these internals. If that happens, or in regular mode, the sidebar falls back to a pop-up overlay (`ctrl+x b`), and everything else keeps working.
 
 Below 116 columns the split sidebar hides itself. Context, cost and provider usage, status widgets and other extensions' statuses (MCP, LSP, ...) live in the sidebar; whenever it is hidden they show in the footer instead.
 
-Other unsupported hooks, all checked on pi 1.2.0:
+The split relies on `tui.layoutRoot`, `tui.setLayoutRoot()`, the entries of pi-tui's `HStack` and `VStack` (`basis`, `grow`, `shrink`, `minSize`, `visible`) and the `Symbol.for("@earendil-works/pi-tui/layout-node")` method.
+
+Other unsupported hooks, checked on pi 1.4.0 (seen running unless noted):
 
 - Prompt bars: patches `UserMessageComponent.prototype.render`. The original is restored on `/chassis off` and on shutdown.
-- Tool rows: a renderer resolver (`pi.registerToolRenderer`) draws the built-in tools' calls; pi's own tool definitions, settings and active tool set are not touched.
-- Thinking peek: finds the latest assistant message component in the TUI tree.
+- Tool rows: a renderer resolver (`pi.registerToolRenderer`) draws the built-in tools' calls; pi's own tool definitions, settings and active tool set are not touched. Rows from other extensions are compacted by patching `ToolExecutionComponent.prototype.render` (reads `expanded`, `isPartial`, `result`, `contentBox`, `imageComponents`, `toolDefinition`, and the row above's `lastMessage` and `isStreaming`). The compact path for tools without their own shell was read in pi's source, not seen running.
+- Finished thinking: patches `AssistantMessageComponent.prototype.render` to drop the hidden-thinking label from settled messages (reads `contentContainer`, `lastMessage`, `isStreaming`, `hideThinkingBlock`, `thinkingVisibilityOverrides`).
+- Extension notices: patches `CustomMessageComponent.prototype.render` (reads `message.customType`). Read in pi's source, not seen running.
+- Thinking peek: finds the latest assistant message component in the TUI tree and calls `setHiddenThinkingLabel`.
+- Leader keys that map to slash commands call the editor's `onSubmit`, which pi copies onto chassis's editor (seen with `ctrl+x s`; `ctrl+x r` not run).
+- The prompt reads the editor's `renderedVisibleLineCount`, and the chat container is found by matching component class names (`UserMessageComponent`, `AssistantMessageComponent`, `ToolExecutionComponent`) in the TUI tree.
+
+Several of these read members that are private or protected in pi's types (`Stack.entries`, `ScrollView.child`, `MouseRegion.child`) or match class names, so the type check does not catch a change: re-check them by running pi after each pi update.

package/extensions/chassis/layout.ts

@@ -4,7 +4,7 @@
  * Fullscreen mode: pi renders one layout root (a VStack of transcript + input dock). We wrap it in
  * an HStack with the sidebar as a fixed-width right column, which is what OpenCode looks like.
  * There is no extension API for this: it relies on the TUI's `layoutRoot` field and
- * `setLayoutRoot()` (pi-tui ViewportTUI), verified on pi 1.1.0. If either is missing, or pi
+ * `setLayoutRoot()` (pi-tui ViewportTUI), verified on pi 1.4.0. If either is missing, or pi
  * swaps the root back (renderer switch), the guard widget re-wraps it or we fall back.
  *
  * Regular mode has no layout root, so the sidebar is a toggleable overlay instead.

package/extensions/chassis/messages.ts

@@ -1,6 +1,6 @@
 /**
  * OpenCode-style transcript styling. pi has no renderer hooks for these, so two prototype patches
- * (pi and extensions share one module instance; verified on pi 1.1.0), both undone on uninstall:
+ * (pi and extensions share one module instance; verified on pi 1.4.0), both undone on uninstall:
  *
  * 1. User messages (UserMessageComponent.render): a ┃ bar in the agent colour, then the message
  *    on the panel background with 1 row of padding above and below and 2 columns on the left,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-chassis",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "A workbench for pi: an interface, git workflows and a widget platform for everyday engineering. Sidebar and home screen, Build/Plan modes, ctrl+x leader keys and a ctrl+p palette, a git diff view, git commands that draft commit messages and pull requests, and a widget and brand API for other packages.",
   "type": "module",
   "license": "MIT",
@@ -83,8 +83,8 @@
     "release": "node scripts/release.mjs"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": ">=1.2.0 <1.3.0",
-    "@earendil-works/pi-tui": ">=1.2.0 <1.3.0"
+    "@earendil-works/pi-coding-agent": ">=1.2.0 <1.5.0",
+    "@earendil-works/pi-tui": ">=1.2.0 <1.5.0"
   },
   "devDependencies": {
     "@types/node": "24.10.1",