opencode-context-tree 0.1.1 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # Changelog
 
+## 0.2.1 — 2026-09-03
+
+- Lanes: the cursor now highlights the thinking pills folded into the selected row (they never
+  lit up before); the `?` legend explains the lane colours (Input green you / grey context ·
+  Model purple answer / grey thinking · Tools orange call / red failed).
+- `?` help and `/ctree status` print the running plugin version.
+- Docs: how to upgrade (OpenCode pins the version it installed and does not re-check `@latest`;
+  pin a version with `opencode plugin opencode-context-tree@<version> -g --force`), and a note
+  that the trajectory panels are off by default (`1/2/3` show them, `i` the inspector).
+
+## 0.2.0 — 2026-09-03 — UI/UX pass from a four-lens review
+
+Findings from reviewers with lazygit/tig, k9s/btop, Helix/fzf and agent-tooling PM backgrounds,
+working from real screenshots.
+
+- Context bands are relative to the model window (<25 / 60 / 85 %), with a `▓▓░░░` bar; the
+  gauge, tree header and sidebar card show one identical string.
+- Thinking steps fold into their assistant row (`· 9.8s thought`) instead of being half the outline.
+- From inside a branch, trunk rows past the fork point are dimmed under a
+  `── not in this branch's context ──` separator: they are not sent to the model.
+- Decision records render as wrapped text (no raw `**`, no mid-word clipping).
+- Per-panel footer and scoped keys: `b`/`m`/`u` no longer fire from the help, decisions or
+  consumers panels.
+- `/` filters as you type with match highlighting, an honest zero-result state and a `4/17`
+  position; `n`/`N` step through matches.
+- Confirmations: Discard is gated and Esc cancels it; `⏎` names what it will do for the selected
+  row and confirms session switches; the merge picker names the trunk with turn and token counts.
+- Consumers show percent of the window, expand into their entries, and crop a tool result in
+  place; provider reasoning is labelled as not croppable.
+- Header dedupes the branch title and truncates to fit; crop marks survive mode changes and crop
+  mode is exclusive.
+- Keys aligned with vim: `u` undo (`x` kept), `s` consumers, `gg`/`G`, `ctrl+d`/`ctrl+u`,
+  `Tab` toggles a fold, `f` opens a filter picker (`F` reverses).
+- Lanes are an event strip like DeepSeek Harness's, not a bar chart: one pill per event on a
+  shared axis (Input / Model / Tools), a gap between neighbours, width by duration in Duration
+  mode, categorical colours, red for a failed tool call, the selected step inverted, an empty
+  lane says so, and nothing is scaled by tokens (the row column already has them).
+
 ## 0.1.1 — 2026-09-03
 
 - Install with OpenCode's own `opencode plugin opencode-context-tree [-g]`, which registers

package/README.md

@@ -26,7 +26,9 @@ opencode plugin opencode-context-tree        # for the current project only (.op
 ```
 
 Restart OpenCode. `/tree` (or `ctrl+q`) opens the tree; `/branch`, `/merge`, `/decisions` and the
-headless `/ctree` commands are available too.
+headless `/ctree` commands are available too. The trajectory panels are off by default so the
+first screen is the plain tree: inside `/tree` press `1`, `2` or `3` for the Input/Model/Tools
+timeline (`0` hides it) and `i` for the inspector.
 
 If you only see `/ctree` and no `/tree`, the TUI half is not registered: run the command above.
 To register by hand instead, the package name must be listed in **both** files:
@@ -38,6 +40,16 @@ To register by hand instead, the package name must be listed in **both** files:
 { "plugin": ["opencode-context-tree"] }
 ```
 
+**Upgrading.** OpenCode keeps the version it installed and does not re-check `@latest` on restart.
+To move to a new release, pin it (this also rewrites both config entries):
+
+```sh
+opencode plugin opencode-context-tree@0.2.0 -g --force     # or without -g for the project
+```
+
+or delete `~/.cache/opencode/packages/opencode-context-tree@latest` and restart. `?` in `/tree`
+and `/ctree status` show the version you are running.
+
 Options go in either file: `[["opencode-context-tree", { "storage": "global", "jumpSummary": "never" }]]`
 (see [docs/USAGE.md](docs/USAGE.md)). To hack on it from a checkout, see "Try it from source" below.
 
@@ -58,7 +70,7 @@ is one content-forward row and branches are drawn at their fork points:
 │ │ ● user: the bun test is flaky, find the race                                             ~0.4k
 │ │ ⚙ [bash $ bun test src/foo.test.ts] ⚠                                                     ~4.7k
 │ ◆ Decision: try-redis · Outcome: switched to a write-through cache…                         ~0.9k
-└ ⏎ go  b branch  m merge  c crop  i inspector  1·2·3 lanes  x undo  ? help  q back
+└ ⏎ go  b branch  m merge  c crop  u undo  s consumers  ? help  q back
 ```
 
 Every message and tool call is a row; the gutter draws each branch at the message it was forked
@@ -70,38 +82,35 @@ OpenCode's own `/fork` are adopted into the tree automatically.
 
 ## Screenshots
 
-Real OpenCode 1.18 TUI, gemma4 via ollama. `/tree` opens as a Pi-style outline of the whole
-session tree: one content-forward row per message and tool step (`● user:` / `○ assistant:` /
-`⚙ [bash $ …]`), branches drawn at their fork points with `│ ├ ╰` connectors and folded to their
-`⎇` header until you open them. Here a trunk about caching a `/users` endpoint has a squashed
-`try-redis` branch (its ◆ decision record is the leaf), a rejected `try-lru`, and two native
-`/fork` sessions:
+Real OpenCode 1.18 TUI, gemma4 via ollama. `/tree` is a Pi-style outline of the whole session
+tree: one row per message or tool step, thinking folded into its assistant row, branches drawn at
+their fork points and folded to their `⎇` header until opened, the context bar and band in the
+header, and a footer that says what `⏎` will do for the selected row:
 
 ![tree from the trunk](docs/screenshots/tree-trunk.png)
 
-The DeepSeek-Harness trajectory is one keystroke away, not gone: `i` opens the inspector and
-`1/2/3` bring in the Input/Model/Tools lanes:
+From inside a branch, `← here` marks your step and the trunk rows past the fork point are dimmed
+under `── not in this branch's context ──`: they are not sent to the model.
 
-![tree with the trajectory panels on](docs/screenshots/tree-trajectory.png)
+![tree from a branch](docs/screenshots/tree-from-a-branch.png)
 
-From inside a branch, `← here` marks your current step, that branch is expanded, and the rest of
-the tree stays visible and folded — you always see the whole tree:
+`/` filters as you type, highlights matches and counts rows; `n`/`N` step through them:
 
-![tree from a branch](docs/screenshots/tree-from-a-branch.png)
+![live search](docs/screenshots/search.png)
 
-`→` expands a branch inline (its turns continue the numbering from the fork point):
+The DeepSeek-Harness trajectory is one keystroke away: `1/2/3` bring in the event-strip lanes
+(one pill per event, width by duration, red for a failed tool call) and `i` the inspector:
 
-![a branch expanded inline](docs/screenshots/tree-expanded.png)
+![tree with the trajectory lanes on](docs/screenshots/tree-trajectory.png)
 
-`D` decisions · `u` what's filling the context · `?` help · `m` merge · the sidebar card:
+`s` shows what is filling the context, by share of the tree and of the model window, expandable
+into entries you can crop in place; `D` renders the decision records; `?` opens the help pane:
 
 | | |
 |---|---|
-| ![decisions](docs/screenshots/decisions.png) | ![consumers](docs/screenshots/consumers.png) |
+| ![consumers](docs/screenshots/consumers.png) | ![decisions](docs/screenshots/decisions.png) |
 | ![help](docs/screenshots/help.png) | ![merge picker](docs/screenshots/merge-picker.png) |
 
-![sidebar card](docs/screenshots/sidebar-card.png)
-
 ## Try it from source
 
 ```sh
@@ -110,11 +119,12 @@ bun install && bun run build
 # tui.json       →  "plugin": ["/abs/path/opencode-tree/dist/tui.js"]
 ```
 
-The footer inside `/tree` carries six keys — `⏎` go, `b` branch, `m` merge, `c` crop,
-`x` undo, `q` back — and `?` opens a help overlay with the rest: crop mode (`space` mark,
-double for protected, `a` auto, `t` result⇄turn, `⏎` apply), `i` inspector, `u` consumers,
-`D` decisions (`E` export), `L` label, `←→` fold/unfold, `[ ]` hop branches, `f` filter,
-`/` search, `g/G`, and how to read the screen.
+Keys inside `/tree` (vim-aligned): `j k` `ctrl+d ctrl+u` `gg G` move · `[ ]` hop between
+branches · `h l` `Tab` fold/unfold · `⏎` go (the footer says what it will do for the selected row)
+· `b` branch · `m` merge · `c` crop mode (`space` mark, `a` auto, `t` result⇄turn, `⏎` apply) ·
+`u` undo (`x` too) · `/` live search, `n N` next/prev · `f` filter picker · `i` inspector ·
+`1 2 3` lanes, `0` off · `s` what's filling the context · `D` decisions · `L` label · `y` copy ·
+`?` help · `q`.
 
 ## Commands
 

package/dist/server.js

@@ -19399,6 +19399,9 @@ ${records.map(one).join(`
 `;
 }
 
+// src/shared/version.ts
+var PLUGIN_VERSION = "0.2.1";
+
 // src/core/adopt.ts
 var FORK_TITLE = /^(.+) \(fork #(\d+)\)$/;
 function parseForkTitle(title) {
@@ -19590,7 +19593,8 @@ ${text}
           case "help":
             return say(output2, `${cmd.error ? `error: ${cmd.error}
 
-` : ""}${CTREE_HELP}`);
+` : ""}${CTREE_HELP}
+(opencode-context-tree ${PLUGIN_VERSION})`);
           case "status": {
             await adopt();
             const state = store.stateForSession(sessionID);
@@ -19603,7 +19607,7 @@ ${text}
             const title = me && !me.name ? (await client.session.get({ path: { id: sessionID }, query: { directory } }).catch(() => {
               return;
             }))?.data?.title : undefined;
-            return say(output2, [`tree ${state.treeId}`, me ? `this session is \u2387 ${me.name ?? title ?? "branch"} (${me.status}) of ${me.parentSessionID}${me.note ? ` \u2014 ${me.note}` : ""}` : "this session is the trunk", `${branches.length} branch(es) from here: ${branches.map((b) => `${b.name ?? b.sessionID} [${b.status}]`).join(", ") || "none"}`, `${crops.length} active crop(s), ~${hidden} tokens hidden`, `${Object.values(state.decisions).filter((d) => d.sessionID === sessionID && !d.hidden).length} decision record(s) here`].join(`
+            return say(output2, [`opencode-context-tree ${PLUGIN_VERSION} \xB7 tree ${state.treeId}`, me ? `this session is \u2387 ${me.name ?? title ?? "branch"} (${me.status}) of ${me.parentSessionID}${me.note ? ` \u2014 ${me.note}` : ""}` : "this session is the trunk", `${branches.length} branch(es) from here: ${branches.map((b) => `${b.name ?? b.sessionID} [${b.status}]`).join(", ") || "none"}`, `${crops.length} active crop(s), ~${hidden} tokens hidden`, `${Object.values(state.decisions).filter((d) => d.sessionID === sessionID && !d.hidden).length} decision record(s) here`].join(`
 `));
           }
           case "branch": {