opencode-sesh 0.1.6 → 0.2.0

package/bin/sesh.sh

@@ -38,6 +38,18 @@ fi
 if [ "${1:-}" = --check ]; then
   "$SESH_JQ" -en '"2026-01-01T00:00:00Z" | fromdateiso8601 | type == "number"' >/dev/null || { echo 'jq capability check failed' >&2; exit 1; }
   command -v sqlite3 >/dev/null 2>&1 || command -v "$OPENCODE_BIN" >/dev/null 2>&1 || { echo 'neither sqlite3 nor opencode is available' >&2; exit 1; }
+  # The TUI panel is a copied file that opencode imports once at startup. Report
+  # when the installed copy has fallen behind this package so upgrades are not
+  # silently stale.
+  panel_bundled="$SCRIPT_DIR/../tui/sesh-panel.tsx"
+  panel_installed="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/plugins/sesh-panel.tsx"
+  if [ -f "$panel_installed" ] && [ -f "$panel_bundled" ]; then
+    if cmp -s "$panel_bundled" "$panel_installed"; then
+      echo 'sesh: sidebar panel is current'
+    else
+      echo 'sesh: sidebar panel is out of date; run `sesh install`, then fully quit and reopen opencode' >&2
+    fi
+  fi
   echo 'sesh: dependencies ready'
   exit 0
 fi
@@ -47,6 +59,7 @@ picker_limit=0
 picker_archived=0
 picker_print=0
 picker_fork=0
+picker_json=0
 picker_query=''
 while [ "$#" -gt 0 ]; do
   case "$1" in
@@ -55,12 +68,14 @@ while [ "$#" -gt 0 ]; do
     --archived) picker_archived=1 ;;
     --print) picker_print=1 ;;
     --fork) picker_fork=1 ;;
+    --json) picker_json=1 ;;
     --query) picker_query=${2:-}; shift ;;
     *) echo "unknown option: $1" >&2; exit 2 ;;
   esac
   shift
 done
 case "$picker_limit" in ''|*[!0-9]*) echo "--limit must be a non-negative integer" >&2; exit 2;; esac
+[ "$picker_json" = 0 ] || [ "$picker_print" = 1 ] || { echo '--json requires --print' >&2; exit 2; }
 
 shell_quote() {
   # Quotes fixed command arguments embedded in fzf's shell action strings.
@@ -94,6 +109,12 @@ trap cleanup EXIT
 trap 'exit 130' HUP INT TERM
 
 cache_cmd="$q_worker render --state-dir $q_state --query {q} --selected-id {6}"
+# fzf's --header is the only place a persistent scope/status line can live
+# without becoming a selectable row, so it is refreshed by transform-header on
+# start, on the 3s poll and after either action that can change it. Order
+# matters: a transform-* action placed AFTER reload/reload-sync in the chain
+# leaves the list empty, so the header is always transformed first.
+header_cmd="$q_list --header --state-dir $q_state"
 preview_cmd="if [ -f $q_state/help ]; then $q_shortcuts; else $q_preview $q_state {2}; fi"
 help_bind="?:transform:[ -z {q} ] && ( [ -f $q_state/help ] && rm -f $q_state/help && echo hide-preview || ( : > $q_state/help && echo show-preview+refresh-preview ) ) || echo 'put(?)'"
 toggle_cmd="$q_list --toggle-scope --state-dir $q_state >/dev/null"
@@ -101,16 +122,18 @@ delete_cmd="$q_delete $q_state {2}"
 
 query="$picker_query"
 while :; do
-selection=''
-set +e
-selection=$(FZF_DEFAULT_COMMAND='printf ""' FZF_DEFAULT_OPTS='' FZF_DEFAULT_OPTS_FILE='' "$SESH_FZF" --print-query --expect=ctrl-f --query="$query" --ansi --delimiter=$'\t' --with-nth=4 --track --id-nth=6 --disabled --layout=reverse --info=hidden --prompt='❯ ' \
-  --preview="$preview_cmd" --preview-window='right,50%,wrap,hidden' \
-  --bind='space:transform:[ -z {q} ] && echo toggle-preview || echo "put( )"' \
-  --bind="$help_bind" \
-  --bind="ctrl-x:execute($delete_cmd)+reload($cache_cmd)" \
-  --bind="ctrl-g:execute($toggle_cmd)+reload($cache_cmd)" \
-  --bind="change:reload:$cache_cmd" \
-  --bind="start,every(3):reload-sync:$cache_cmd")
+  header_line=$("$SCRIPT_DIR/sesh-list.sh" --header --state-dir "$state_dir" 2>/dev/null || true)
+  selection=''
+  set +e
+  selection=$(FZF_DEFAULT_COMMAND='printf ""' FZF_DEFAULT_OPTS='' FZF_DEFAULT_OPTS_FILE='' "$SESH_FZF" --print-query --expect=ctrl-f --query="$query" --ansi --delimiter=$'\t' --with-nth=4 --track --id-nth=6 --disabled --layout=reverse --info=hidden --prompt='❯ ' \
+    --preview="$preview_cmd" --preview-window='right,50%,wrap,hidden' \
+    --header-first --header="$header_line" \
+    --bind='space:transform:[ -z {q} ] && echo toggle-preview || echo "put( )"' \
+    --bind="$help_bind" \
+    --bind="ctrl-x:execute($delete_cmd)+transform-header($header_cmd)+reload($cache_cmd)" \
+    --bind="ctrl-g:execute($toggle_cmd)+transform-header($header_cmd)+reload($cache_cmd)" \
+    --bind="change:reload:$cache_cmd" \
+    --bind="start,every(3):transform-header($header_cmd)+reload-sync:$cache_cmd")
 status=$?
 set -e
 case "$status" in 0) ;; 1|130) exit 0;; *) echo "sesh: picker failed ($status)" >&2; exit "$status";; esac
@@ -120,13 +143,30 @@ selection=${selection#*$'\n'}
 key=${selection%%$'\n'*}
 selection=${selection#*$'\n'}
 session_id=$(printf '%s\n' "$selection" | cut -f2)
-[ -n "$session_id" ] || continue
+tracking_id=$(printf '%s\n' "$selection" | cut -f6)
+if [ -z "$session_id" ]; then
+  # Enter/Ctrl-F on a directory header or a notice row. Leave a one-shot
+  # message for the reopened picker so the keypress visibly did something,
+  # and keep the query so the user has not lost their place.
+  case "$tracking_id" in
+    hdr:*) printf '%s' 'That row is a directory header, not a session.' > "$state_dir/action-notice" ;;
+    notice:*) printf '%s' 'That row is a notice, not a session; pick a session row.' > "$state_dir/action-notice" ;;
+  esac
+  continue
+fi
 # Dispatch queues a new worker scan and waits for that exact serialized poll.
 # It cannot accept a previously fresh status while the worker owns its lock.
-poll_target=$("$SCRIPT_DIR/sesh-refresh-worker.sh" request --state-dir "$state_dir")
-if ! "$SCRIPT_DIR/sesh-refresh-worker.sh" wait --state-dir "$state_dir" --target "$poll_target" --timeout 12; then
-  echo 'Live state unavailable; retry selection after refresh' >&2
-  continue
+# A --print lookup reads the published snapshot, so it skips the wait entirely
+# and stays usable from scripts without paying a rescan.
+if [ "$picker_print" = 0 ]; then
+  printf 'sesh: refreshing session state…' >&2
+  poll_target=$("$SCRIPT_DIR/sesh-refresh-worker.sh" request --state-dir "$state_dir")
+  if ! "$SCRIPT_DIR/sesh-refresh-worker.sh" wait --state-dir "$state_dir" --target "$poll_target" --timeout 12; then
+    printf '\r\033[K' >&2
+    echo 'sesh: session state unavailable; selection cancelled, retry after refresh' >&2
+    continue
+  fi
+  printf '\r\033[K' >&2
 fi
 record=$("$SESH_JQ" -c --arg sid "$session_id" 'select(.sessionId==$sid)' "$state_dir/snapshot.jsonl")
 [ -n "$record" ] || continue
@@ -134,7 +174,10 @@ cwd=$(printf '%s' "$record" | "$SESH_JQ" -r '.cwd')
 fork=0
 if [ "$picker_fork" = 1 ] || [ "$key" = ctrl-f ]; then fork=1; fi
 if [ "$picker_print" = 1 ]; then
-  if [ "$fork" = 1 ]; then printf '%s\t%s\tfork\n' "$session_id" "$cwd"; else printf '%s\t%s\n' "$session_id" "$cwd"; fi
+  if [ "$picker_json" = 1 ]; then
+    "$SESH_JQ" -cn --arg sessionId "$session_id" --arg cwd "$cwd" --argjson fork "$fork" \
+      '{sessionId: $sessionId, cwd: $cwd, fork: ($fork == 1)}'
+  elif [ "$fork" = 1 ]; then printf '%s\t%s\tfork\n' "$session_id" "$cwd"; else printf '%s\t%s\n' "$session_id" "$cwd"; fi
   exit 0
 fi
 if [ ! -d "$cwd" ]; then

package/install.sh

@@ -19,6 +19,7 @@ BIN_DIR="${XDG_BIN_HOME:-$HOME/.local/bin}"
 INSTALL_TOOL=1
 INSTALL_TUI=1
 UNINSTALL=0
+SYNC_PANEL=0
 
 # Fallback plugin version for when the opencode CLI is unavailable; the
 # installer prefers the local opencode version so the panel matches its SDK.
@@ -43,6 +44,7 @@ Usage: bash install.sh [--bin-dir DIR] [--no-tool] [--no-tui] [--uninstall]
   --no-tool      Skip installing the sesh-list custom tool.
   --no-tui       Skip installing the in-TUI sessions panel plugin.
   --uninstall    Remove everything this script installed.
+  --sync-panel   Refresh an already-installed TUI panel only (used by postinstall).
   --help         Show this help.
 USAGE
 }
@@ -53,6 +55,7 @@ while [ "$#" -gt 0 ]; do
     --no-tool) INSTALL_TOOL=0; shift ;;
     --no-tui) INSTALL_TUI=0; shift ;;
     --uninstall) UNINSTALL=1; shift ;;
+    --sync-panel) SYNC_PANEL=1; shift ;;
     --help) usage; exit 0 ;;
     *) fail "unknown option: $1" ;;
   esac
@@ -110,62 +113,6 @@ launcher_is_ours() {
   [ -f "$target" ] && grep -qF 'Pick an opencode session' "$target" 2>/dev/null
 }
 
-if [ "$UNINSTALL" = 1 ]; then
-  if [ -L "$LAUNCHER" ]; then
-    if launcher_is_ours "$LAUNCHER"; then
-      rm -f "$LAUNCHER" && note "removed $LAUNCHER"
-    else
-      note "left $LAUNCHER untouched (not a sesh launcher: $(readlink "$LAUNCHER" 2>/dev/null))"
-    fi
-  fi
-  remove_if_marker "$COMMAND_DST" "rich interactive picker" && note "removed $COMMAND_DST"
-  remove_if_marker "$TOOL_DST" "list opencode sessions for the agent" && note "removed $TOOL_DST"
-  remove_if_marker "$PANEL_DST" "@jsxImportSource @opentui/solid" && note "removed $PANEL_DST"
-  remove_tui_entry && note "unregistered the panel from $TUI_JSON"
-  note "uninstalled (extraction cache and plugin dependencies left intact)"
-  exit 0
-fi
-
-for path in \
-  bin/sesh \
-  bin/sesh.sh \
-  bin/sesh-list.sh \
-  bin/sesh-preview.sh \
-  bin/sesh-delete.sh \
-  bin/sesh-refresh-worker.sh \
-  bin/sesh-shortcuts.sh \
-  opencode/tools/sesh-list.ts \
-  tui/sesh-panel.tsx \
-  themes/glow-dark-clean.json; do
-  [ -f "$SOURCE_DIR/$path" ] || fail "installer bundle is incomplete: missing $path."
-done
-
-for tool in bash jq fzf; do
-  command -v "$tool" >/dev/null 2>&1 || fail "required tool '$tool' is unavailable."
-done
-fzf_version=$(fzf --version 2>/dev/null || true)
-if [[ "$fzf_version" =~ ^([0-9]+)\.([0-9]+)(\.([0-9]+))? ]]; then
-  if [ "$((10#${BASH_REMATCH[1]}))" -eq 0 ] && [ "$((10#${BASH_REMATCH[2]}))" -lt 73 ]; then
-    fail "fzf >= 0.73.0 is required (found $fzf_version)."
-  fi
-else
-  fail "cannot parse fzf version from: $fzf_version."
-fi
-command -v sqlite3 >/dev/null 2>&1 || command -v opencode >/dev/null 2>&1 \
-  || fail "either sqlite3 or the opencode CLI is required."
-command -v opencode >/dev/null 2>&1 || note "opencode CLI not found: listing and previews work via sqlite3, but resume and delete need opencode."
-
-umask 077
-mkdir -p "$BIN_DIR"
-if [ -e "$LAUNCHER" ] && [ ! -L "$LAUNCHER" ]; then
-  fail "$LAUNCHER already exists and is not a symlink. Move it aside, then retry."
-fi
-if [ -L "$LAUNCHER" ] && ! launcher_is_ours "$LAUNCHER"; then
-  fail "$LAUNCHER is a symlink to $(readlink "$LAUNCHER" 2>/dev/null), which is not a sesh install. Move it aside, then retry."
-fi
-ln -sfn "$SOURCE_DIR/bin/sesh" "$LAUNCHER"
-note "linked $LAUNCHER -> $SOURCE_DIR/bin/sesh"
-
 install_file() {
   local src=$1 dst=$2
   mkdir -p "$(dirname "$dst")"
@@ -181,26 +128,20 @@ install_file() {
   note "installed $dst"
 }
 
-# Earlier versions shipped a markdown `/sesh` command that could only prompt the
-# agent; the TUI plugin now registers the slash itself. Drop the old file so the
-# two do not collide.
-remove_if_marker "$COMMAND_DST" "rich interactive picker" && note "removed obsolete markdown command $COMMAND_DST"
-[ "$INSTALL_TOOL" = 1 ] && install_file "$SOURCE_DIR/opencode/tools/sesh-list.ts" "$TOOL_DST"
-
-opencode_version=''
-if command -v opencode >/dev/null 2>&1; then
-  raw_version=$(opencode --version 2>/dev/null || true)
-  if [[ "$raw_version" =~ ([0-9]+\.[0-9]+\.[0-9]+) ]]; then opencode_version="${BASH_REMATCH[1]}"; fi
-fi
-plugin_version="${opencode_version:-$PLUGIN_VERSION_FALLBACK}"
-
-if [ "$INSTALL_TUI" = 1 ]; then
+install_tui_panel() {
   install_file "$SOURCE_DIR/tui/sesh-panel.tsx" "$PANEL_DST"
 
-  # opencode has no persistent-sidebar API: the panel is an xlarge modal
-  # dialog (see tui/sesh-panel.tsx). Register it idempotently and drop the
-  # previous filename if an older install left it behind.
-  tui_created=0
+  local opencode_version='' raw_version='' plugin_version=''
+  if command -v opencode >/dev/null 2>&1; then
+    raw_version=$(opencode --version 2>/dev/null || true)
+    if [[ "$raw_version" =~ ([0-9]+\.[0-9]+\.[0-9]+) ]]; then opencode_version="${BASH_REMATCH[1]}"; fi
+  fi
+  plugin_version="${opencode_version:-$PLUGIN_VERSION_FALLBACK}"
+
+  # opencode has no persistent-sidebar API: the panel is an xlarge modal dialog
+  # (see tui/sesh-panel.tsx). Register it idempotently and drop the previous
+  # filename if an older install left it behind.
+  local tui_created=0 tui_tmp=''
   if [ ! -f "$TUI_JSON" ]; then
     printf '{\n  "$schema": "https://opencode.ai/tui.json",\n  "plugin": []\n}\n' > "$TUI_JSON"
     tui_created=1
@@ -228,7 +169,7 @@ if [ "$INSTALL_TUI" = 1 ]; then
   # Local plugins resolve their imports from the config directory, and opencode
   # runs `bun install` there at startup. Keep the required packages declared
   # without clobbering versions the user already pinned.
-  pkg_created=0
+  local pkg_created=0 pkg_tmp=''
   if [ ! -f "$PACKAGE_JSON" ]; then
     printf '{\n  "dependencies": {}\n}\n' > "$PACKAGE_JSON"
     pkg_created=1
@@ -257,12 +198,104 @@ if [ "$INSTALL_TUI" = 1 ]; then
     rm -f "$pkg_tmp"
     note "warning: could not update $PACKAGE_JSON; the TUI panel may fail to load"
   fi
+}
+
+# opencode imports plugins once at startup and has no hot reload, so a running
+# instance keeps the old panel until it is fully quit (reloading a window reuses
+# the same process). Say so explicitly and name the processes still holding it.
+note_restart() {
+  note "restart opencode to load the updated panel: quit it completely"
+  note "  (all windows and background processes), then reopen."
+  if command -v pgrep >/dev/null 2>&1; then
+    local pids
+    pids=$(pgrep -x opencode 2>/dev/null | tr '\n' ' ' | sed 's/ $//' || true)
+    [ -n "$pids" ] && note "  still running: opencode PID(s) $pids"
+  fi
+  return 0
+}
+
+if [ "$UNINSTALL" = 1 ]; then
+  if [ -L "$LAUNCHER" ]; then
+    if launcher_is_ours "$LAUNCHER"; then
+      rm -f "$LAUNCHER" && note "removed $LAUNCHER"
+    else
+      note "left $LAUNCHER untouched (not a sesh launcher: $(readlink "$LAUNCHER" 2>/dev/null))"
+    fi
+  fi
+  remove_if_marker "$COMMAND_DST" "rich interactive picker" && note "removed $COMMAND_DST"
+  remove_if_marker "$TOOL_DST" "list opencode sessions for the agent" && note "removed $TOOL_DST"
+  remove_if_marker "$PANEL_DST" "@jsxImportSource @opentui/solid" && note "removed $PANEL_DST"
+  remove_tui_entry && note "unregistered the panel from $TUI_JSON"
+  note "uninstalled (extraction cache and plugin dependencies left intact)"
+  exit 0
+fi
+
+for path in \
+  bin/sesh \
+  bin/sesh.sh \
+  bin/sesh-list.sh \
+  bin/sesh-preview.sh \
+  bin/sesh-delete.sh \
+  bin/sesh-refresh-worker.sh \
+  bin/sesh-shortcuts.sh \
+  opencode/tools/sesh-list.ts \
+  tui/sesh-panel.tsx \
+  themes/glow-dark-clean.json; do
+  [ -f "$SOURCE_DIR/$path" ] || fail "installer bundle is incomplete: missing $path."
+done
+
+if [ "$SYNC_PANEL" = 1 ]; then
+  # Postinstall path: refresh a panel the user already opted into, without
+  # touching the launcher or requiring fzf/sqlite. No-op when the panel is
+  # absent, so `npm install` never adds a TUI panel on its own.
+  [ -f "$PANEL_DST" ] || { note "sesh sidebar panel is not installed; nothing to sync."; exit 0; }
+  umask 077
+  install_tui_panel
+  note_restart
+  exit 0
+fi
+
+for tool in bash jq fzf; do
+  command -v "$tool" >/dev/null 2>&1 || fail "required tool '$tool' is unavailable."
+done
+fzf_version=$(fzf --version 2>/dev/null || true)
+if [[ "$fzf_version" =~ ^([0-9]+)\.([0-9]+)(\.([0-9]+))? ]]; then
+  if [ "$((10#${BASH_REMATCH[1]}))" -eq 0 ] && [ "$((10#${BASH_REMATCH[2]}))" -lt 73 ]; then
+    fail "fzf >= 0.73.0 is required (found $fzf_version)."
+  fi
+else
+  fail "cannot parse fzf version from: $fzf_version."
+fi
+command -v sqlite3 >/dev/null 2>&1 || command -v opencode >/dev/null 2>&1 \
+  || fail "either sqlite3 or the opencode CLI is required."
+command -v opencode >/dev/null 2>&1 || note "opencode CLI not found: listing and previews work via sqlite3, but resume and delete need opencode."
+
+umask 077
+mkdir -p "$BIN_DIR"
+if [ -e "$LAUNCHER" ] && [ ! -L "$LAUNCHER" ]; then
+  fail "$LAUNCHER already exists and is not a symlink. Move it aside, then retry."
+fi
+if [ -L "$LAUNCHER" ] && ! launcher_is_ours "$LAUNCHER"; then
+  fail "$LAUNCHER is a symlink to $(readlink "$LAUNCHER" 2>/dev/null), which is not a sesh install. Move it aside, then retry."
+fi
+ln -sfn "$SOURCE_DIR/bin/sesh" "$LAUNCHER"
+note "linked $LAUNCHER -> $SOURCE_DIR/bin/sesh"
+
+# Earlier versions shipped a markdown `/sesh` command that could only prompt the
+# agent; the TUI plugin now registers the slash itself. Drop the old file so the
+# two do not collide.
+remove_if_marker "$COMMAND_DST" "rich interactive picker" && note "removed obsolete markdown command $COMMAND_DST"
+[ "$INSTALL_TOOL" = 1 ] && install_file "$SOURCE_DIR/opencode/tools/sesh-list.ts" "$TOOL_DST"
+
+if [ "$INSTALL_TUI" = 1 ]; then
+  install_tui_panel
 fi
 
 "$LAUNCHER" --check || fail "post-install check failed."
 note "done"
 note "  picker:  run 'sesh' in any terminal, or '/sesh' inside opencode"
-note "  sidebar: restart opencode to load the panel (ctrl+o opens the full picker)"
+note "  sidebar: ctrl+o opens the full picker"
+note_restart
 case ":$PATH:" in
   *":$BIN_DIR:"*) ;;
   *) note "  note: $BIN_DIR is not on PATH; add it to use the launcher anywhere." ;;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-sesh",
-  "version": "0.1.6",
+  "version": "0.2.0",
   "type": "module",
   "description": "Browse, search, preview and resume opencode sessions from the terminal and the TUI.",
   "license": "MIT",
@@ -36,16 +36,19 @@
   "publishConfig": {
     "access": "public"
   },
+  "packageManager": "bun@1.4.2",
   "engines": {
     "node": ">=20"
   },
   "scripts": {
     "prepare": "husky",
-    "test": "bash tests/sesh.sh",
+    "postinstall": "bash install.sh --sync-panel || true",
+    "test": "bash tests/sesh.sh && bash tests/changelog.sh",
+    "test:changelog": "bash tests/changelog.sh",
     "test:picker": "python3 tests/picker.py",
     "typecheck": "tsc -p tsconfig.json",
-    "lint:sh": "for script in bin/*.sh bin/sesh install.sh tests/*.sh; do bash -n \"$script\" || exit; done",
-    "prepublishOnly": "npm test && npm run typecheck"
+    "lint:sh": "for script in bin/*.sh bin/sesh install.sh tests/*.sh scripts/*.sh; do bash -n \"$script\" || exit; done",
+    "prepublishOnly": "bun run test && bun run typecheck"
   },
   "devDependencies": {
     "@commitlint/cli": "^21.2.2",