opencode-context-tree 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # 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,

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.
 

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": {

package/dist/tui.js

@@ -19813,6 +19813,11 @@ import { insertNode as _$insertNode } from "@opentui/solid";
 import { insert as _$insert } from "@opentui/solid";
 import { setProp as _$setProp } from "@opentui/solid";
 import { createElement as _$createElement } from "@opentui/solid";
+
+// src/shared/version.ts
+var PLUGIN_VERSION = "0.2.1";
+
+// src/tui/route.tsx
 import { For, Show, createEffect, createMemo, createSignal as createSignal2, on, onCleanup } from "solid-js";
 
 // src/core/actions.ts
@@ -21078,7 +21083,7 @@ var EMPTY_TRANSCRIPT = {
   messages: []
 };
 var NO_BRANCHES = "No branches yet \xB7 b forks here into a real OpenCode session; nothing is copied or deleted.";
-var HELP = ["? help \xB7 ? or esc closes", "Move", "  \u2191\u2193 j k \xB7 J K by 20 \xB7 ctrl+d ctrl+u half page \xB7 gg top \xB7 G bottom \xB7 [ ] branch rows", "  h l \u2190 \u2192 fold/unfold a branch \xB7 Tab (or e) toggle \xB7 / live search \xB7 n N next/prev match", "Act", "  \u23CE go \u2014 a \u2387 header switches to it \xB7 a user turn forks & prefills it \xB7 a step forks after it", "  b branch \xB7 m merge \xB7 c crop mode (space mark \xB7 a auto \xB7 t result\u21C4turn \xB7 \u23CE apply \xB7 esc leave)", "  u undo (alias x) \xB7 L label \xB7 y copy \xB7 E export decisions", "Views", "  i inspector \xB7 1 2 3 lanes (duration/turns/calls) \xB7 0 off \xB7 s consumers \xB7 D decisions \xB7 f F filter", "Legend", "  \u25CF user \xB7 \u25CB assistant \xB7 \u2699 tool step \xB7 \u25C6 decision \xB7 \u2263 summary \xB7 \u2387 branch (a real OpenCode session)", "  \u2502 \u251C \u2570 draw the topology \xB7 \u25BE open \u25B8 folded \xB7 \u2190 here is the session you are in", "  dim rows are not sent to the model; \u2500\u2500 not in this branch's context \u2500\u2500 is where your path forked", "  right column is tokens; ~ estimated \xB7 \u26A0 \u226510k \xB7 \u2702 cropped \xB7 \u2717 tool error", "  \u2387 colours: open green \xB7 squashed blue \xB7 rejected/discarded red \xB7 abandoned grey"];
+var HELP = [`? help \xB7 ? or esc closes \xB7 opencode-context-tree ${PLUGIN_VERSION}`, "Move", "  \u2191\u2193 j k \xB7 J K by 20 \xB7 ctrl+d ctrl+u half page \xB7 gg top \xB7 G bottom \xB7 [ ] branch rows", "  h l \u2190 \u2192 fold/unfold a branch \xB7 Tab (or e) toggle \xB7 / live search \xB7 n N next/prev match", "Act", "  \u23CE go \u2014 a \u2387 header switches to it \xB7 a user turn forks & prefills it \xB7 a step forks after it", "  b branch \xB7 m merge \xB7 c crop mode (space mark \xB7 a auto \xB7 t result\u21C4turn \xB7 \u23CE apply \xB7 esc leave)", "  u undo (alias x) \xB7 L label \xB7 y copy \xB7 E export decisions", "Views", "  i inspector \xB7 1 2 3 lanes (duration/turns/calls) \xB7 0 off \xB7 s consumers \xB7 D decisions \xB7 f F filter", "Legend", "  \u25CF user \xB7 \u25CB assistant \xB7 \u2699 tool step \xB7 \u25C6 decision \xB7 \u2263 summary \xB7 \u2387 branch (a real OpenCode session)", "  \u2502 \u251C \u2570 draw the topology \xB7 \u25BE open \u25B8 folded \xB7 \u2190 here is the session you are in", "  dim rows are not sent to the model; \u2500\u2500 not in this branch's context \u2500\u2500 is where your path forked", "  right column is tokens; ~ estimated \xB7 \u26A0 \u226510k \xB7 \u2702 cropped \xB7 \u2717 tool error", "  \u2387 colours: open green \xB7 squashed blue \xB7 rejected/discarded red \xB7 abandoned grey", "  lanes: Input green you / grey context \xB7 Model purple answer / grey thinking \xB7 Tools orange call / red failed"];
 var FILTERS = [{
   title: "default",
   value: "default",
@@ -21469,13 +21474,23 @@ function TreeRoute(props) {
   const userTurns = () => (live()?.messages ?? []).filter((m) => m.role === "user").length;
   const laneWidth = () => Math.max(10, Math.min(width() - 46, 80));
   const strip = createMemo(() => buildEventStrip(live() ?? EMPTY_TRANSCRIPT, laneMode(), laneWidth()));
-  const cursorEvent = createMemo(() => {
+  const cursorEvents = createMemo(() => {
     const row = current();
+    const hit = new Set;
     if (!row || row.kind === "branch" || row.kind === "separator")
-      return -1;
+      return hit;
     const mid = currentMessageOf(row) ?? row.messageID;
     const pid = row.kind === "step" ? currentPartOf(row) ?? row.partID : undefined;
-    return stripIndexFor(strip(), mid, pid);
+    const own2 = stripIndexFor(strip(), mid, pid);
+    if (own2 >= 0)
+      hit.add(own2);
+    strip().events.forEach((e, i) => {
+      if (e.messageID !== mid)
+        return;
+      if (row.kind === "turn" ? e.lane === "input" : e.kind === "reasoning")
+        hit.add(i);
+    });
+    return hit;
   });
   const cellColor = (cell) => {
     if (cell.error)
@@ -21490,10 +21505,10 @@ function TreeRoute(props) {
     return e.kind === "reasoning" ? t.textMuted : t.accent;
   };
   const laneRuns = (lane) => {
-    const cur = cursorEvent();
+    const cur = cursorEvents();
     const runs = [];
     for (const cell of strip().lanes[lane]) {
-      const sel = cell !== null && cell.eventIndex === cur;
+      const sel = cell !== null && cur.has(cell.eventIndex);
       const color = cell === null ? t.textMuted : cellColor(cell);
       const fg = sel ? t.background : color;
       const bg = sel ? color : undefined;

package/docs/USAGE.md

@@ -39,6 +39,18 @@ unfold toggle go branch label filter_pick filter_prev search search_next search_
 crop crop_toggle_mode mark auto undo merge inspector consumers copy mode_duration mode_turns
 mode_calls lanes_off decisions export help`.
 
+## Upgrading
+
+OpenCode caches the version it installed and does not re-resolve `@latest` on restart. Pin the new
+release, which also rewrites both config entries:
+
+```sh
+opencode plugin opencode-context-tree@0.2.0 -g --force     # drop -g for the current project
+```
+
+or delete `~/.cache/opencode/packages/opencode-context-tree@latest` and restart. `?` in `/tree` and
+`/ctree status` print the running version.
+
 ## The loop
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-context-tree",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "private": false,
   "type": "module",
   "description": "Pi-style context tree for OpenCode: branch, merge (human-confirmed decision records), crop, undo, plus a DeepSeek-Harness-style trajectory view",

package/src/server/index.ts

@@ -16,6 +16,7 @@ import { CTREE_HELP, parseCtreeArgs } from "../core/ctree-args.js"
 import { autoMark, planResultCrop, resultCandidates, topCandidate, type CropRules, DEFAULT_RULES } from "../core/cropplan.js"
 import { planUndo } from "../core/undo.js"
 import { exportDecisions } from "../core/decision.js"
+import { PLUGIN_VERSION } from "../shared/version.js"
 import type { Transcript, TranscriptMessage } from "../core/transcript.js"
 import { parseForkTitle } from "../core/adopt.js"
 import { adoptNativeForks } from "../shared/adopt.js"
@@ -97,7 +98,7 @@ export const server: Plugin = async ({ worktree, client, directory }, options) =
         const cmd = parseCtreeArgs(input.arguments)
         switch (cmd.kind) {
           case "help":
-            return say(output, `${cmd.error ? `error: ${cmd.error}\n\n` : ""}${CTREE_HELP}`)
+            return say(output, `${cmd.error ? `error: ${cmd.error}\n\n` : ""}${CTREE_HELP}\n(opencode-context-tree ${PLUGIN_VERSION})`)
           case "status": {
             await adopt() // headless clients have no TUI half to do it for them
             const state = store.stateForSession(sessionID)
@@ -108,7 +109,7 @@ export const server: Plugin = async ({ worktree, client, directory }, options) =
             const branches = Object.values(state.sessions).filter((b) => b.parentSessionID === sessionID)
             // an adopted native fork carries no journal name: fall back to the session's own title
             const title = me && !me.name ? ((await client.session.get({ path: { id: sessionID }, query: { directory } }).catch(() => undefined))?.data as { title?: string } | undefined)?.title : undefined
-            return say(output, [`tree ${state.treeId}`, me ? `this session is ⎇ ${me.name ?? title ?? "branch"} (${me.status}) of ${me.parentSessionID}${me.note ? ` — ${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("\n"))
+            return say(output, [`opencode-context-tree ${PLUGIN_VERSION} · tree ${state.treeId}`, me ? `this session is ⎇ ${me.name ?? title ?? "branch"} (${me.status}) of ${me.parentSessionID}${me.note ? ` — ${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("\n"))
           }
           case "branch": {
             const tr = await transcriptOf(sessionID)

package/src/shared/version.ts

@@ -0,0 +1,3 @@
+/** Stamped by scripts/build.ts from package.json (the release tag); "dev" when run from source. */
+declare const __CTREE_VERSION__: string | undefined
+export const PLUGIN_VERSION: string = typeof __CTREE_VERSION__ === "string" ? __CTREE_VERSION__ : "dev"

package/src/tui/route.tsx

@@ -4,6 +4,7 @@
  * OpenCode data through the adapters, actions through ./actions.
  */
 import type { TuiPluginApi } from "@opencode-ai/plugin/tui"
+import { PLUGIN_VERSION } from "../shared/version.js"
 import { For, Show, createEffect, createMemo, createSignal, on, onCleanup } from "solid-js"
 import { planJump } from "../core/actions.js"
 import { foldJournal, type TreeState } from "../core/journal.js"
@@ -195,7 +196,7 @@ const NO_BRANCHES = "No branches yet · b forks here into a real OpenCode sessio
 /** The `?` pane: unindented lines are headings, indented ones body (see the render).
  *  It sits under the rows, so the tree stays on screen while you read it. */
 const HELP = [
-  "? help · ? or esc closes",
+  `? help · ? or esc closes · opencode-context-tree ${PLUGIN_VERSION}`,
   "Move",
   "  ↑↓ j k · J K by 20 · ctrl+d ctrl+u half page · gg top · G bottom · [ ] branch rows",
   "  h l ← → fold/unfold a branch · Tab (or e) toggle · / live search · n N next/prev match",
@@ -211,6 +212,7 @@ const HELP = [
   "  dim rows are not sent to the model; ── not in this branch's context ── is where your path forked",
   "  right column is tokens; ~ estimated · ⚠ ≥10k · ✂ cropped · ✗ tool error",
   "  ⎇ colours: open green · squashed blue · rejected/discarded red · abandoned grey",
+  "  lanes: Input green you / grey context · Model purple answer / grey thinking · Tools orange call / red failed",
 ]
 
 /** `f` opens this as a picker; `F` steps back through it (DESIGN.md §7.5). */
@@ -528,13 +530,22 @@ export function TreeRoute(props: TreeRouteProps) {
   // One pill per event on a shared time axis — categorical colour, nothing scaled by tokens.
   const laneWidth = () => Math.max(10, Math.min(width() - 46, 80))
   const strip = createMemo(() => buildEventStrip(live() ?? EMPTY_TRANSCRIPT, laneMode(), laneWidth()))
-  /** The strip event the cursor sits on; its cells draw inverted, so there is no cursor block. */
-  const cursorEvent = createMemo(() => {
+  /** The strip events the cursor sits on; their cells draw inverted, so there is no cursor block.
+   *  A step row also owns the thinking pills folded into it (the list shows them as `· Ns thought`),
+   *  otherwise the grey reasoning pills would never light up. */
+  const cursorEvents = createMemo<Set<number>>(() => {
     const row = current()
-    if (!row || row.kind === "branch" || row.kind === "separator") return -1
+    const hit = new Set<number>()
+    if (!row || row.kind === "branch" || row.kind === "separator") return hit
     const mid = currentMessageOf(row) ?? row.messageID
     const pid = row.kind === "step" ? (currentPartOf(row) ?? row.partID) : undefined
-    return stripIndexFor(strip(), mid, pid)
+    const own = stripIndexFor(strip(), mid, pid)
+    if (own >= 0) hit.add(own)
+    strip().events.forEach((e, i) => {
+      if (e.messageID !== mid) return
+      if (row.kind === "turn" ? e.lane === "input" : e.kind === "reasoning") hit.add(i)
+    })
+    return hit
   })
   const cellColor = (cell: StripCell): unknown => {
     if (cell.error) return t.error
@@ -546,10 +557,10 @@ export function TreeRoute(props: TreeRouteProps) {
   }
   /** Adjacent cells of the same colour collapse into one <text>, so a lane is a few nodes. */
   const laneRuns = (lane: "input" | "model" | "tools") => {
-    const cur = cursorEvent()
+    const cur = cursorEvents()
     const runs: { text: string; fg: unknown; bg: unknown }[] = []
     for (const cell of strip().lanes[lane]) {
-      const sel = cell !== null && cell.eventIndex === cur
+      const sel = cell !== null && cur.has(cell.eventIndex)
       const color = cell === null ? t.textMuted : cellColor(cell)
       const fg = sel ? t.background : color
       const bg = sel ? color : undefined