@narumitw/pi-btw 0.61.2 → 0.63.0

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,12 +10,14 @@ 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
+ - Uses Pi's message components, a native-style working editor border, and a compact footer below the editor.
14
+ - Offers fullscreen, side-thread-left, and side-thread-right workspaces with Pi's live main-thread view, mouse or keyboard pane focus, and a draggable remembered divider.
14
15
  - Renders supported Mermaid fences as width-safe, themed Unicode diagrams without a browser or network request.
16
+ - Manually previews and imports new main-thread context without stopping main work or rewriting earlier side exchanges.
15
17
  - Keeps side questions and answers out of the main conversation by default.
16
18
  - Brings back the latest answer, a question suffix, an exact range, or the complete thread only when requested.
17
19
  - Uses Pi's current model and thinking level or saved pi-btw choices.
18
- - Offers BTW-only exit, thinking-cycle, and bring-to-main keybindings.
20
+ - Offers BTW-only exit, thinking-cycle, bring-to-main, and pane-switch keybindings.
19
21
 
20
22
  ## 📦 Install
21
23
 
@@ -55,7 +57,9 @@ Both routes require TUI mode and a model with usable credentials; see [Settings]
55
57
  Side questions and selected conversation context are sent to that model's provider.
56
58
  Bringing context back fills the main editor without submitting; replacing an existing draft requires confirmation.
57
59
  Ctrl+C cancels the response and discards the current draft and queued questions, but completed exchanges remain resumable in memory.
58
- Read the [workflow guide](./docs/workflows.md) for context selection, copying, search, steering, and draft recovery; `/new`, `/resume`, `/reload`, and restart discard retained threads.
60
+ While composing, use **Import main updates** (`F9` by default) to preview and confirm new main context; no content is imported automatically.
61
+ Imports can increase context size and provider cost; see [import scope and branch limits](./docs/workflows.md#import-main-updates).
62
+ Read the [workflow guide](./docs/workflows.md) for context selection, importing, copying, search, steering, and draft recovery; `/new`, `/resume`, `/fork`, `/reload`, and restart discard retained threads.
59
63
 
60
64
  ## ⚙️ Settings
61
65
 
@@ -116,7 +120,9 @@ Pi-btw does not inherit Pi core's setting of the same name because Pi's public e
116
120
  `layout` controls the dedicated workspace and defaults to `fullscreen` when omitted.
117
121
  Accepted values are `fullscreen`, `left-pane`, and `right-pane`.
118
122
  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.
123
+ A single muted divider separates the panes; click either pane or use the pane-switch shortcut to move keyboard focus.
124
+ The footer below the editor shows **BTW focus** or **Main focus** and the available switch key.
125
+ It also shows the selected side model and thinking level when space permits; narrow or short views omit optional fields and hints before the active input row.
120
126
  Drag the divider with the primary mouse button to resize both panes.
121
127
  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
128
  If the save fails, the workspace restores the last saved ratio and reports the error.
@@ -138,6 +144,8 @@ The literal `/btw settings` remains a side question, not a settings subcommand.
138
144
  | `exit` | `ctrl+c` | Cancel and leave the dedicated side-thread workspace, including its nested dialogs. |
139
145
  | `cycleThinkingLevel` | Inherit Pi's `app.thinking.cycle` | Cycle supported levels while composing or generating. |
140
146
  | `bringToMain` | `ctrl+r` | Open the bring-to-main chooser after a completed answer. |
147
+ | `switchPane` | First available `f6`, `f7`, or `f8` | Switch keyboard focus between panes in a split workspace. |
148
+ | `importMainUpdates` | First available `f9`, `f10`, or `f11` | Preview and confirm main updates while the side composer is idle. |
141
149
 
142
150
  For example, merge these overrides into `pi-btw.json`:
143
151
 
@@ -159,6 +167,8 @@ Actual availability depends on the terminal; `super` and some modified combinati
159
167
  New overrides cannot take ordinary typing keys or conflict with BTW actions, Pi editing, selection, search, scrolling, or enabled manual-copy bindings.
160
168
  Pi's explicitly configured printable thinking shortcuts remain inherited for compatibility.
161
169
  If a saved override becomes conflicting, BTW warns and uses an available default; if none is usable, that shortcut is unavailable and its activation hint is omitted.
170
+ The pane-switch action uses only the first available fallback and does not displace an existing BTW override or inherited Pi thinking shortcut.
171
+ It has no effect in fullscreen-only or collapsed layouts, and background pane switching is blocked while an overlay owns focus.
162
172
  An explicitly unbound Pi thinking action stays unbound. Remove an override field to restore its default; neither saving nor resetting modifies Pi's global keybindings.
163
173
  **Ctrl+C always remains available as hard cancel**, even after configuring another exit key. Shortcut handling does not interpret bracketed-paste payloads as commands.
164
174
 
@@ -176,10 +186,14 @@ The file is read for every `/btw` invocation, so edits apply without `/reload`.
176
186
  ## 🚧 Limitations
177
187
 
178
188
  - `/btw` supports TUI mode only.
179
- - Only the clicked pane receives keyboard input; hovering or scrolling over the other pane does not move focus.
189
+ - The side model does not execute tools. Answers appear only after the response completes, not token by token.
190
+ - Only the active pane receives keyboard input; hovering or scrolling over the other pane does not move focus.
180
191
  - Resume state is memory-only and lasts only for the current extension instance.
181
- - A side thread retains the latest 40,000 characters of main-conversation context and adds a truncation notice when earlier content is omitted.
192
+ - Main-conversation context is a limited text snapshot, not the complete session; see [context scope](./docs/workflows.md#choose-context-and-resume-threads).
182
193
  - Clipboard access depends on Pi's host helper, the operating system, and the terminal.
194
+ - The live workspace still uses a BTW-owned terminal handoff and private host-layout access because Pi has no public workspace-composition API; see the [core-alignment handoff](./docs/core-alignment.md) for tested safeguards, exact limits, and proposed APIs.
195
+ - Pi does not expose all effective renderer options or a public clipboard-read callback. BTW uses native automatic wheel behavior but does not inherit private host wheel overrides or right-click clipboard paste.
196
+ - Conversation appearance follows native defaults, not custom host editor/footer extensions or private padding settings. BTW uses one-cell message padding and zero-cell editor padding; see the [appearance reference and before/after frames](./docs/native-appearance.md).
183
197
  - Malformed, unsupported, or oversized Mermaid diagrams remain readable as fenced source; partial parses also show a warning.
184
198
  - Pi versions before 0.85 omit the clickable jump-to-latest control.
185
199
 
@@ -191,7 +205,7 @@ packages/pi-btw/
191
205
  │ ├── index.ts # Thin Pi entrypoint
192
206
  │ └── btw.ts # Side-thread lifecycle and command
193
207
  ├── dist/ # Generated Jiti runtime
194
- ├── docs/ # Side-thread workflows and controls
208
+ ├── docs/ # Workflows, appearance evidence, and core-alignment handoff
195
209
  ├── scripts/build-runtime.mjs # Runtime builder
196
210
  └── test/ # Behavior and lifecycle coverage
197
211
  ```