@narumitw/pi-btw 0.60.3 → 0.61.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -10,6 +10,7 @@ Only context you explicitly bring back is loaded into the main editor.
10
10
  - Starts a side thread immediately with `/btw <question>` or opens the manager with `/btw`.
11
11
  - Uses any persisted main-session branch as context without switching branches.
12
12
  - Supports scrollable answers, transcript search, a clickable jump-to-latest control, follow-up questions, queued steering, and in-memory resume.
13
+ - Offers fullscreen, side-thread-left, and side-thread-right workspaces with Pi's live main-thread view, click-to-focus input, and a draggable remembered divider.
13
14
  - Renders supported Mermaid fences as width-safe, themed Unicode diagrams without a browser or network request.
14
15
  - Keeps side questions and answers out of the main conversation by default.
15
16
  - Brings back the latest answer, a question suffix, an exact range, or the complete thread only when requested.
@@ -77,7 +78,9 @@ The normal location is `~/.pi/agent/pi-btw.json`.
77
78
  "model": "anthropic/claude-sonnet-4-5",
78
79
  "thinkingLevel": "low",
79
80
  "rememberThinkingLevelChanges": true,
80
- "fullscreenCopyOnSelect": true
81
+ "fullscreenCopyOnSelect": true,
82
+ "layout": "left-pane",
83
+ "sidePaneRatio": 0.5
81
84
  }
82
85
  ```
83
86
 
@@ -106,10 +109,23 @@ When **Same as main thread** is selected, shortcut changes stay local even when
106
109
  If a shortcut write fails, the local change remains active and pi-btw warns that it was not remembered.
107
110
  A failed Settings-screen save instead restores the previous displayed value.
108
111
 
109
- `fullscreenCopyOnSelect` controls only pi-btw's dedicated fullscreen view and defaults to `true` when omitted.
112
+ `fullscreenCopyOnSelect` controls only pi-btw's dedicated workspace and defaults to `true` when omitted.
110
113
  Turn **Copy selection automatically** off to retain highlighted selections and copy them with Pi's effective `app.message.copy` binding.
111
114
  Pi-btw does not inherit Pi core's setting of the same name because Pi's public extension API does not expose its effective value.
112
115
 
116
+ `layout` controls the dedicated workspace and defaults to `fullscreen` when omitted.
117
+ Accepted values are `fullscreen`, `left-pane`, and `right-pane`.
118
+ The pane names identify the side thread's position; the other pane reuses Pi's native main-thread rendering at pane width and stays current while BTW is open.
119
+ A single muted divider separates the panes; click either pane to move keyboard focus to it.
120
+ Drag the divider with the primary mouse button to resize both panes.
121
+ The side-thread share is limited to 20–80% and saved as `sidePaneRatio` when the button is released, independent of whether the side thread is on the left or right.
122
+ If the save fails, the workspace restores the last saved ratio and reports the error.
123
+ Pi's search and keyboard viewport controls apply to the active pane.
124
+ The mouse wheel scrolls the pane under the pointer without moving keyboard focus, and both panes continue redrawing while either pane is active.
125
+ If you selected context from the main-thread tree, the main pane still shows the active main thread while the side model receives the selected branch.
126
+ Pane layouts collapse to the side thread alone below 80 terminal columns and return keyboard focus to it.
127
+ Choose **Side-thread layout** in Settings; changes apply the next time a new or resumed BTW workspace opens.
128
+
113
129
  ### Keybindings
114
130
 
115
131
  Open `/btw` → **Settings**, select a shortcut row, then choose **Edit key combination…** or **Restore default**.
@@ -149,9 +165,9 @@ An explicitly unbound Pi thinking action stays unbound. Remove an override field
149
165
  ### Persistence
150
166
 
151
167
  Reading a missing settings file has no side effects.
152
- Pi-btw creates it only after a Settings change or a remembered shortcut change.
168
+ Pi-btw creates it only after a Settings change, a remembered shortcut change, or a divider drag.
153
169
  Within one Pi process, saves run in order and publish atomically through a same-directory temporary file and rename.
154
- Saves preserve `model` and unknown fields.
170
+ Saves preserve other recognized settings and unknown fields.
155
171
  Malformed or invalid files block saves and remain unchanged.
156
172
  Files must be valid UTF-8 and no larger than 64 KiB.
157
173
  Separate Pi processes and external editors are outside the in-process ordering boundary.
@@ -160,6 +176,7 @@ The file is read for every `/btw` invocation, so edits apply without `/reload`.
160
176
  ## 🚧 Limitations
161
177
 
162
178
  - `/btw` supports TUI mode only.
179
+ - Only the clicked pane receives keyboard input; hovering or scrolling over the other pane does not move focus.
163
180
  - Resume state is memory-only and lasts only for the current extension instance.
164
181
  - A side thread retains the latest 40,000 characters of main-conversation context and adds a truncation notice when earlier content is omitted.
165
182
  - Clipboard access depends on Pi's host helper, the operating system, and the terminal.