@bojackduy/opencode-telescope 0.1.19 → 0.1.21

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@bojackduy/opencode-telescope",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "description": "Fuzzy search across all OpenCode conversations — grep session and chat history, find code snippets, and jump to any chat instantly",
   "type": "module",
   "license": "MIT",

package/search.ts

@@ -631,12 +631,31 @@ function indexedTextRows(db: Database, dbPath: string, limit: number, query: str
 
 function indexedRecentRows(db: Database, dbPath: string, limit: number, directory?: string, offset?: number, role?: SearchRole) {
   try {
-    const index = ensureSearchIndex(db, dbPath, { rebuild: false })
+    const index = ensureSearchIndex(db, dbPath, { rebuild: false, useStale: true })
     if (!index) {
-      scheduleBackgroundIndexRebuild(dbPath)
+      debug.log("query:recent:index:missing", { dbPath })
       return
     }
 
+    const rowCount = index.query<{ count: number }, []>("SELECT COUNT(*) as count FROM document_index").get()?.count ?? 0
+    if (rowCount === 0) {
+      debug.log("query:recent:index:empty", { dbPath })
+      return
+    }
+
+    const state = sourceState(db, dbPath)
+    const currentDataVersion = getMeta(index, "source_data_version")
+    const currentMtimeMs = getMeta(index, "source_mtime_ms")
+    const currentPath = getMeta(index, "source_path")
+    const currentIndexVersion = getMeta(index, "index_version")
+    if (currentPath !== dbPath || currentDataVersion !== String(state.dataVersion) || currentMtimeMs !== String(state.mtimeMs) || currentIndexVersion !== SEARCH_INDEX_VERSION) {
+      debug.log("query:recent:index:stale", {
+        dbPath,
+        expectedDataVersion: state.dataVersion,
+        actualDataVersion: currentDataVersion,
+      })
+    }
+
     const conditions: string[] = ["part_type = 'text'"]
     const params: (string | number)[] = []
     if (role) {
@@ -711,7 +730,7 @@ function visibleTextRows(db: Database, limit: number, query?: string, directory?
   return rows
 }
 
-function ensureSearchIndex(source: Database, sourcePath: string, options?: { rebuild?: boolean }) {
+function ensureSearchIndex(source: Database, sourcePath: string, options?: { rebuild?: boolean; useStale?: boolean }) {
   const indexPath = searchIndexPath(sourcePath)
   if (!_indexDb || _indexDbPath !== indexPath) {
     _indexDb?.close()
@@ -726,7 +745,10 @@ function ensureSearchIndex(source: Database, sourcePath: string, options?: { reb
   const currentPath = getMeta(_indexDb, "source_path")
   const currentIndexVersion = getMeta(_indexDb, "index_version")
   if (currentPath !== sourcePath || currentDataVersion !== String(state.dataVersion) || currentMtimeMs !== String(state.mtimeMs) || currentIndexVersion !== SEARCH_INDEX_VERSION) {
-    if (options?.rebuild === false) return
+    if (options?.rebuild === false) {
+      if (options?.useStale) return _indexDb
+      return
+    }
     rebuildSearchIndex(source, _indexDb, sourcePath, state)
   }
   return _indexDb

package/telescope.tsx

@@ -23,6 +23,7 @@ import { inputSafeKeys, keyListLabel, matchesKey, prevent } from "./ui/keyboard.
 import { findRenderableByID, jumpToRenderedTarget, messageTargetID, previewScrollAmount, scrollPreviewToTarget } from "./ui/render-target.ts"
 
 export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; onClose: () => void }) => {
+  debug.log("component:render:start")
   type OwnerFilter = "all" | SearchRole
   const dimensions = useTerminalDimensions()
   const [query, setQuery] = createSignal("")
@@ -52,7 +53,7 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
   const MIN_RECENT_BATCH_SIZE = 15
   const RESULT_OVERSCAN_MULTIPLIER = 2
   const RESULT_BATCH_VIEWPORTS = 4
-  const RESULT_PREFETCH_VIEWPORTS = 3
+  const RESULT_PREFETCH_VIEWPORTS = 5
   const RESULT_CACHE_BEHIND_VIEWPORTS = 6
   const INITIAL_PREVIEW_BEFORE = 20
   const INITIAL_PREVIEW_AFTER = 30
@@ -92,10 +93,23 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
   let resultNavigationStarted = false
   let resultPrefetchTimer: ReturnType<typeof setTimeout> | undefined
   let resultPreviousTimer: ReturnType<typeof setTimeout> | undefined
+  type PreviewBeforeIntent = "passive-prefetch" | "explicit-scroll"
+  type PendingPreviewBefore = {
+    id: number
+    previousContentHeight: number
+    previousScrollTop: number
+    requestedAmount: number
+    intent: PreviewBeforeIntent
+    visibleLoad: boolean
+  }
+  let previewBeforeLoadID = 0
   let previewBeforeTimer: ReturnType<typeof setTimeout> | undefined
   let previewAfterTimer: ReturnType<typeof setTimeout> | undefined
-  let pendingPreviewBefore: { previousContentHeight: number; preserveScroll: boolean; visibleLoad: boolean } | undefined
+  let pendingPreviewBefore: PendingPreviewBefore | undefined
   let pendingPreviewAfterVisible = false
+  let previewBeforeAdjusting = false
+  let pendingCoalescedExplicit: { requestedAmount: number } | undefined
+  let pendingPreviewAnchorCorrection: { anchorPartID: string; visualOffset: number; createdAt: number; expiresAt: number } | undefined
   const previewMeasuredHeights = new Map<string, number>()
   const cancelPreviewPrefetch = () => {
     if (previewBeforeTimer) clearTimeout(previewBeforeTimer)
@@ -104,6 +118,9 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
     previewAfterTimer = undefined
     pendingPreviewBefore = undefined
     pendingPreviewAfterVisible = false
+    previewBeforeAdjusting = false
+    pendingCoalescedExplicit = undefined
+    pendingPreviewAnchorCorrection = undefined
     setPrefetchingPreviewBefore(false)
     setPrefetchingPreviewAfter(false)
     setLoadingPreviewMore(false)
@@ -150,6 +167,12 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
     return { start: base + cachedStart, end: base + cachedEnd, items: cached.slice(cachedStart, cachedEnd) }
   })
 
+  const resultTopSpacerHeight = () =>
+    Math.max(0, resultRenderWindow().start - resultBaseOffset()) * resultRowHeight()
+
+  const resultBottomSpacerHeight = () =>
+    Math.max(0, resultBaseOffset() + results().length - resultRenderWindow().end) * resultRowHeight()
+
   let lastResultRenderWindow = ""
   createEffect(() => {
     const window = resultRenderWindow()
@@ -217,6 +240,7 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
         }
         debug.timeEnd("query:recent")
         setLoading(false)
+        debug.log("component:interactive")
       }, 1)
       onCleanup(() => clearTimeout(timer))
       return
@@ -444,6 +468,31 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
     onCleanup(() => clearTimeout(timer))
   })
 
+  createEffect(() => {
+    if (!resultNavigationStarted || !hasMore()) return
+    const interval = setInterval(() => {
+      if (!hasMore() || loadingMore() || loadingPreviousResults() || prefetchingResults() || busy() || loading()) return
+      const scroll = resultScroll
+      if (!scroll) return
+      const children = scroll.getChildren()
+      if (!children || children.length === 0) return
+      const lastChild = children[children.length - 1] as { y: number; height: number }
+      const contentHeight = lastChild.y + lastChild.height
+      const scrollThreshold = Math.max(2, Math.floor(scroll.height * RESULT_PREFETCH_VIEWPORTS))
+      if (scroll.scrollTop + scroll.height >= contentHeight - scrollThreshold) {
+        debug.log("results:scroll-prefetch", {
+          scrollTop: scroll.scrollTop,
+          height: scroll.height,
+          contentHeight,
+          scrollThreshold,
+          rowsAhead: resultPrefetchState().rowsAhead,
+        })
+        scheduleResultPrefetch(false)
+      }
+    }, 200)
+    onCleanup(() => clearInterval(interval))
+  })
+
   const estimatePreviewPartHeight = (part: ConversationPreviewPart) => {
     if (part.type === "tool") {
       if (!part.target) return 2
@@ -457,15 +506,31 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
 
   const previewPartHeight = (part: ConversationPreviewPart) => previewMeasuredHeights.get(part.id) ?? estimatePreviewPartHeight(part)
 
-  const previewVirtualLayout = createMemo(() => {
-    previewHeightVersion()
+  const buildPreviewLayout = (parts: ConversationPreviewPart[]) => {
     let offset = 0
-    return previewParts().map((part) => {
+    return parts.map((part) => {
       const height = previewPartHeight(part)
       const row = { part, top: offset, bottom: offset + height, height }
       offset += height
       return row
     })
+  }
+
+  const previewWindowForLayout = (layout: ReturnType<typeof buildPreviewLayout>, scrollTop: number, viewportHeight: number) => {
+    if (layout.length === 0) return { start: 0, end: 0 }
+    const overscan = Math.max(viewportHeight * 2, 40)
+    const from = Math.max(0, scrollTop - overscan)
+    const to = scrollTop + viewportHeight + overscan
+    const foundStart = layout.findIndex((row) => row.bottom >= from)
+    const start = foundStart === -1 ? Math.max(0, layout.length - 1) : Math.max(0, foundStart)
+    const foundEnd = layout.findIndex((row) => row.top > to)
+    const end = foundEnd === -1 ? layout.length : foundEnd
+    return { start, end: Math.min(layout.length, Math.max(start + 1, end)) }
+  }
+
+  const previewVirtualLayout = createMemo(() => {
+    previewHeightVersion()
+    return buildPreviewLayout(previewParts())
   })
 
   const previewContentHeight = () => previewVirtualLayout().at(-1)?.bottom ?? 0
@@ -484,14 +549,7 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
       return
     }
 
-    const overscan = Math.max(scroll.height * 2, 40)
-    const from = Math.max(0, scroll.scrollTop - overscan)
-    const to = scroll.scrollTop + scroll.height + overscan
-    const foundStart = layout.findIndex((row) => row.bottom >= from)
-    const start = foundStart === -1 ? Math.max(0, layout.length - 1) : Math.max(0, foundStart)
-    const foundEnd = layout.findIndex((row) => row.top > to)
-    const end = foundEnd === -1 ? layout.length : foundEnd
-    const next = { start, end: Math.min(layout.length, Math.max(start + 1, end)) }
+    const next = previewWindowForLayout(layout, scroll.scrollTop, scroll.height)
     const current = previewWindow()
     if (current.start !== next.start || current.end !== next.end) setPreviewWindow(next)
   }
@@ -556,6 +614,29 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
         totalMeasured: previewMeasuredHeights.size,
         window: previewWindow(),
       })
+      const anchorCorrection = pendingPreviewAnchorCorrection
+      if (anchorCorrection && scroll) {
+        const now = Date.now()
+        const shouldCorrect = now <= anchorCorrection.expiresAt && lastPreviewScrollKeyMs <= anchorCorrection.createdAt
+        if (shouldCorrect) {
+          const nextLayout = buildPreviewLayout(previewParts())
+          const anchor = nextLayout.find((row) => row.part.id === anchorCorrection.anchorPartID)
+          if (anchor) {
+            const correctedScrollTop = Math.max(0, anchor.top + anchorCorrection.visualOffset)
+            const correctedWindow = previewWindowForLayout(nextLayout, correctedScrollTop, scroll.height)
+            setPreviewWindow(correctedWindow)
+            scroll.scrollTo(correctedScrollTop)
+            debug.log("preview:measure:anchor-correct", {
+              anchorPartID: anchorCorrection.anchorPartID,
+              visualOffset: anchorCorrection.visualOffset,
+              correctedScrollTop,
+              window: correctedWindow,
+            })
+          }
+        } else {
+          pendingPreviewAnchorCorrection = undefined
+        }
+      }
       setPreviewHeightVersion((value) => value + 1)
       setTimeout(updatePreviewWindow, 1)
     }
@@ -574,75 +655,139 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
     onCleanup(() => clearTimeout(timer))
   })
 
-  const loadPreviewBefore = (previousContentHeight = previewContentHeight(), preserveScroll = true, visibleLoad = false) => {
+  const loadPreviewBefore = (pending: PendingPreviewBefore) => {
     const item = selectedResult()
     const first = previewParts()[0]
     if (!item || !first || loadingPreviewMore() || prefetchingPreviewBefore()) {
       debug.log("preview:load-before:skip", {
+        loadID: pending.id,
         reason: !item ? "no-item" : !first ? "no-first-part" : loadingPreviewMore() ? "loading-preview-more" : "prefetching-before",
-        previousContentHeight,
-        preserveScroll,
-        visibleLoad,
+        pending,
         state: previewScrollState(),
       })
       return
     }
     const beforeState = previewScrollState()
-    visibleLoad ? setLoadingPreviewMore(true) : setPrefetchingPreviewBefore(true)
+    const beforeLayout = previewVirtualLayout()
+    const scrollTop = previewScroll?.scrollTop ?? pending.previousScrollTop
+    const anchor = beforeLayout.find((row) => row.bottom >= scrollTop) ?? beforeLayout[0]
+    const anchorPartID = anchor?.part.id ?? first.id
+    const offsetInAnchor = anchor ? scrollTop - anchor.top : 0
+    pending.visibleLoad ? setLoadingPreviewMore(true) : setPrefetchingPreviewBefore(true)
     debug.time("preview:load-before")
     try {
       debug.log("preview:load-before:start", {
-        item: item.id,
+        loadID: pending.id,
+        intent: pending.intent,
         cursor: { id: first.id, timeCreated: first.timeCreated },
-        previousContentHeight,
-        preserveScroll,
-        visibleLoad,
+        previousContentHeight: pending.previousContentHeight,
+        previousScrollTop: pending.previousScrollTop,
+        anchorPartID,
+        offsetInAnchor,
+        requestedAmount: pending.requestedAmount,
+        visibleLoad: pending.visibleLoad,
         state: beforeState,
       })
       const page = loadConversationBefore(item, { id: first.id, timeCreated: first.timeCreated }, { limit: PREVIEW_PAGE_SIZE, dbPath: dbPath() })
-      debug.log("preview:load-before", {
-        item: item.id,
+      debug.log("preview:load-before:query-done", {
+        loadID: pending.id,
         added: page.parts.length,
         hasMoreBefore: page.hasMoreBefore,
-        preserveScroll,
-        visibleLoad,
         first: page.parts[0]?.id,
         last: page.parts.at(-1)?.id,
       })
       if (page.parts.length > 0) {
-        setPreviewParts((prev) => [...page.parts, ...prev])
-        if (preserveScroll) {
-          setTimeout(() => {
-            const beforeAdjust = previewScrollState()
-            const delta = previewContentHeight() - previousContentHeight
-            if (delta > 0) previewScroll?.scrollBy(delta)
-            updatePreviewWindow()
-            debug.log("preview:load-before:adjust", {
-              delta,
-              previousContentHeight,
-              newContentHeight: previewContentHeight(),
-              scrolled: delta > 0,
-              beforeAdjust,
-              afterAdjust: previewScrollState(),
+        const currentParts = previewParts()
+        const nextParts = [...page.parts, ...currentParts]
+        const nextLayout = buildPreviewLayout(nextParts)
+        const anchorPredicted = nextLayout.find((row) => row.part.id === anchorPartID)
+        const anchorPredictedTop = anchorPredicted?.top ?? 0
+        const visualOffset = offsetInAnchor - (pending.intent === "explicit-scroll" ? pending.requestedAmount : 0)
+        const targetScrollTop = pending.intent === "explicit-scroll"
+          ? Math.max(0, anchorPredictedTop + offsetInAnchor - pending.requestedAmount)
+          : anchorPredictedTop + offsetInAnchor
+        const nextWindow = previewWindowForLayout(nextLayout, targetScrollTop, previewScroll?.height ?? Math.max(8, height() - 7))
+
+        solidBatch(() => {
+          setPreviewParts(nextParts)
+          setPreviewWindow(nextWindow)
+        })
+
+        previewScroll?.scrollTo(targetScrollTop)
+        const anchorCorrectionCreatedAt = Date.now()
+        pendingPreviewAnchorCorrection = {
+          anchorPartID,
+          visualOffset,
+          createdAt: anchorCorrectionCreatedAt,
+          expiresAt: anchorCorrectionCreatedAt + 300,
+        }
+
+        debug.log("preview:load-before:commit", {
+          loadID: pending.id,
+          anchorPartID,
+          anchorPredictedTop,
+          offsetInAnchor,
+          visualOffset,
+          targetScrollTop,
+          window: nextWindow,
+          intent: pending.intent,
+          newParts: page.parts.length,
+          totalParts: nextParts.length,
+        })
+
+        previewBeforeAdjusting = true
+        setTimeout(() => {
+          const newLayout = previewVirtualLayout()
+          const anchorNew = newLayout.find(e => e.part.id === anchorPartID)
+          const actualAnchorTop = anchorNew?.top ?? anchorPredictedTop
+          const drift = actualAnchorTop - anchorPredictedTop
+
+          if (Math.abs(drift) >= 1 && previewScroll) {
+            const correctedScrollTop = targetScrollTop + drift
+            const correctedWindow = previewWindowForLayout(newLayout, correctedScrollTop, previewScroll.height)
+            setPreviewWindow(correctedWindow)
+            previewScroll.scrollTo(correctedScrollTop)
+            debug.log("preview:load-before:drift-correct", {
+              loadID: pending.id,
+              drift,
+              anchorPredictedTop,
+              actualAnchorTop,
+              correctedScrollTop,
+              window: correctedWindow,
             })
-          }, 1)
-        } else {
-          setTimeout(() => {
+          } else {
             updatePreviewWindow()
-            debug.log("preview:load-before:no-adjust", {
-              previousContentHeight,
-              newContentHeight: previewContentHeight(),
-              state: previewScrollState(),
-            })
-          }, 1)
-        }
+          }
+
+          previewBeforeAdjusting = false
+
+          const coalesced = pendingCoalescedExplicit
+          if (coalesced) {
+            pendingCoalescedExplicit = undefined
+            const scroll = previewScroll
+            if (scroll) {
+              debug.log("preview:before:coalesce-replay", {
+                requestedAmount: coalesced.requestedAmount,
+                state: previewScrollState(),
+              })
+              schedulePreviewBefore({
+                intent: "explicit-scroll",
+                visibleLoad: true,
+                requestedAmount: coalesced.requestedAmount,
+                previousScrollTop: scroll.scrollTop,
+              })
+            }
+          }
+        }, 1)
       }
       setHasMorePreviewBefore(page.hasMoreBefore)
     } catch (err) {
       debug.log("preview:load-before:error", err instanceof Error ? err.message : String(err))
+      previewBeforeAdjusting = false
     } finally {
       debug.timeEnd("preview:load-before")
-      visibleLoad ? setLoadingPreviewMore(false) : setPrefetchingPreviewBefore(false)
+      lastBeforeLoadMs = Date.now()
+      pending.visibleLoad ? setLoadingPreviewMore(false) : setPrefetchingPreviewBefore(false)
     }
   }
 
@@ -688,46 +833,104 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
     }
   }
 
-  const schedulePreviewBefore = (previousContentHeight = previewContentHeight(), preserveScroll = true, visibleLoad = false) => {
+  const schedulePreviewBefore = (opts: {
+    intent: PreviewBeforeIntent
+    visibleLoad?: boolean
+    previousContentHeight?: number
+    requestedAmount?: number
+    previousScrollTop?: number
+  }) => {
+    const id = ++previewBeforeLoadID
+    const previousContentHeight = opts.previousContentHeight ?? previewContentHeight()
+    const previousScrollTop = opts.previousScrollTop ?? previewScroll?.scrollTop ?? 0
+    const requestedAmount = opts.requestedAmount ?? 0
+    const visibleLoad = opts.visibleLoad ?? false
+    const source = opts.intent === "explicit-scroll" ? "key" : "edge"
     if (!hasMorePreviewBefore() || loadingPreviewMore() || prefetchingPreviewBefore()) {
-      debug.log("preview:prefetch-before:skip", {
-        reason: !hasMorePreviewBefore() ? "no-more-before" : loadingPreviewMore() ? "loading-preview-more" : "prefetching-before",
+      debug.log("preview:before:schedule-skip", {
+        loadID: id,
+        reason: !hasMorePreviewBefore() ? "no-more-before" : loadingPreviewMore() ? "loading" : "prefetching",
+        source,
+        intent: opts.intent,
         previousContentHeight,
-        preserveScroll,
+        previousScrollTop,
+        requestedAmount,
         visibleLoad,
         state: previewScrollState(),
       })
       return
     }
+    if (previewBeforeAdjusting) {
+      if (opts.intent === "explicit-scroll") {
+        pendingCoalescedExplicit = { requestedAmount }
+        debug.log("preview:before:coalesce-explicit", {
+          loadID: id,
+          requestedAmount,
+          state: previewScrollState(),
+        })
+      } else {
+        debug.log("preview:before:schedule-skip", {
+          loadID: id,
+          reason: "adjusting",
+          source,
+          intent: opts.intent,
+          previousContentHeight,
+          previousScrollTop,
+          requestedAmount,
+          visibleLoad,
+          state: previewScrollState(),
+        })
+      }
+      return
+    }
     if (previewBeforeTimer) {
       if (pendingPreviewBefore) {
         const previousPending = { ...pendingPreviewBefore }
-        pendingPreviewBefore.preserveScroll = pendingPreviewBefore.preserveScroll && preserveScroll
         pendingPreviewBefore.visibleLoad = pendingPreviewBefore.visibleLoad || visibleLoad
-        debug.log("preview:prefetch-before:merge", {
+        if (opts.intent === "explicit-scroll" && pendingPreviewBefore.intent === "passive-prefetch") {
+          pendingPreviewBefore.intent = "explicit-scroll"
+          pendingPreviewBefore.requestedAmount = requestedAmount
+          pendingPreviewBefore.previousScrollTop = previousScrollTop
+        }
+        debug.log("preview:before:schedule-merge", {
+          loadID: id,
           previousPending,
           nextPending: pendingPreviewBefore,
-          requested: { previousContentHeight, preserveScroll, visibleLoad },
-          state: previewScrollState(),
+          requested: { source, intent: opts.intent, previousContentHeight, previousScrollTop, requestedAmount, visibleLoad },
         })
       } else {
-        debug.log("preview:prefetch-before:skip", {
+        debug.log("preview:before:schedule-skip", {
+          loadID: id,
           reason: "timer-already-set",
+          source,
+          intent: opts.intent,
           previousContentHeight,
-          preserveScroll,
+          previousScrollTop,
+          requestedAmount,
           visibleLoad,
           state: previewScrollState(),
         })
       }
       return
     }
-    pendingPreviewBefore = { previousContentHeight, preserveScroll, visibleLoad }
-    debug.log("preview:prefetch-before-scheduled", { previousContentHeight, preserveScroll, visibleLoad, state: previewScrollState() })
+    pendingPreviewBefore = { id, previousContentHeight, previousScrollTop, requestedAmount, intent: opts.intent, visibleLoad }
+    debug.log("preview:before:schedule", {
+      loadID: id,
+      source,
+      intent: opts.intent,
+      previousContentHeight,
+      previousScrollTop,
+      requestedAmount,
+      visibleLoad,
+      firstPart: previewParts()[0]?.id,
+      partCount: previewParts().length,
+      state: previewScrollState(),
+    })
     previewBeforeTimer = setTimeout(() => {
       const pending = pendingPreviewBefore
       previewBeforeTimer = undefined
       pendingPreviewBefore = undefined
-      if (pending) loadPreviewBefore(pending.previousContentHeight, pending.preserveScroll, pending.visibleLoad)
+      if (pending) loadPreviewBefore(pending)
     }, 1)
   }
 
@@ -813,11 +1016,14 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
     debug.timeEnd("preview:load")
   })
 
+  let lastBeforeLoadMs = 0
+  let lastPreviewScrollKeyMs = 0
   createEffect(() => {
     const item = selectedResult()
     if (!item) return
     const interval = setInterval(() => {
       if (loadingPreviewMore() || prefetchingPreviewBefore() || prefetchingPreviewAfter()) return
+      if (previewBeforeAdjusting) return
       const scroll = previewScroll
       const children = scroll?.getChildren()
       if (!scroll || !children || children.length === 0) return
@@ -827,26 +1033,28 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
       const nearTop = scroll.scrollTop <= prefetchDistance
       const atBottom = scroll.scrollTop + scroll.height >= totalContentHeight - 1
       const nearBottom = scroll.scrollTop + scroll.height >= totalContentHeight - prefetchDistance
-      if (nearTop || nearBottom) {
-        debug.log("preview:scroll-edge", {
-          y: scroll.y,
-          scrollTop: scroll.scrollTop,
-          height: scroll.height,
-          contentHeight: totalContentHeight,
-          childContentHeight: previewScrollState().childContentHeight,
-          prefetchDistance,
-          atTop,
-          nearTop,
-          atBottom,
-          nearBottom,
-          hasMoreBefore: hasMorePreviewBefore(),
-          hasMoreAfter: hasMorePreviewAfter(),
-          prefetchingBefore: prefetchingPreviewBefore(),
-          prefetchingAfter: prefetchingPreviewAfter(),
-          children: children.length,
-        })
+      const msSinceManualScroll = Date.now() - lastPreviewScrollKeyMs
+      const willLoadBefore = atTop && hasMorePreviewBefore() && (Date.now() - lastBeforeLoadMs) > 100 && msSinceManualScroll > 700
+      debug.log("preview:edge:decision", {
+        scrollTop: scroll.scrollTop,
+        height: scroll.height,
+        contentHeight: totalContentHeight,
+        prefetchDistance,
+        atTop,
+        nearTop,
+        atBottom,
+        nearBottom,
+        hasMoreBefore: hasMorePreviewBefore(),
+        hasMoreAfter: hasMorePreviewAfter(),
+        loadingBefore: loadingPreviewMore(),
+        pendingBefore: Boolean(previewBeforeTimer),
+        willLoadBefore,
+        msSinceLastLoad: Date.now() - lastBeforeLoadMs,
+        msSinceManualScroll,
+      })
+      if (willLoadBefore) {
+        schedulePreviewBefore({ intent: "passive-prefetch", previousContentHeight: totalContentHeight, previousScrollTop: scroll.scrollTop })
       }
-      if (atTop && hasMorePreviewBefore()) schedulePreviewBefore(totalContentHeight, true, false)
       if (nearBottom && hasMorePreviewAfter()) schedulePreviewAfter(atBottom)
     }, 400)
     onCleanup(() => clearInterval(interval))
@@ -881,11 +1089,14 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
     }
 
     const beforeState = previewScrollState()
+    lastPreviewScrollKeyMs = Date.now()
     debug.log("preview:scroll-key", { direction, state: beforeState })
 
+    const requestedAmount = previewScrollAmount(scroll)
+
     if (direction < 0 && scroll.scrollTop <= 0 && hasMorePreviewBefore()) {
-      debug.log("preview:scroll-key:load-before", { direction, state: beforeState })
-      schedulePreviewBefore(previewContentHeight(), true, true)
+      debug.log("preview:scroll-key:load-before", { direction, requestedAmount, state: beforeState })
+      schedulePreviewBefore({ intent: "explicit-scroll", visibleLoad: true, requestedAmount, previousScrollTop: scroll.scrollTop })
       return
     }
 
@@ -896,7 +1107,7 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
       return
     }
 
-    const amount = direction * previewScrollAmount(scroll)
+    const amount = direction * requestedAmount
     scroll.scrollBy(amount)
     updatePreviewWindow()
     debug.log("preview:scroll-key:scroll", { direction, amount, before: beforeState, after: previewScrollState() })
@@ -1025,6 +1236,7 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
                   >
                     <Show when={!loading()}>
                       <Show when={results().length > 0} fallback={<EmptyState query={query()} owner={ownerLabel()} theme={theme()} />}>
+                        <box height={resultTopSpacerHeight()} flexShrink={0} />
                         <For each={resultRenderWindow().items}>
                           {(item, index) => {
                             const absoluteIndex = () => resultRenderWindow().start + index()
@@ -1041,6 +1253,7 @@ export const Telescope = (props: { api: TuiPluginApi; config: TelescopeConfig; o
                             )
                           }}
                         </For>
+                        <box height={resultBottomSpacerHeight()} flexShrink={0} />
                         <Show when={loadingMore()}>
                           <SkeletonRow theme={theme()} />
                         </Show>

package/tui.tsx

@@ -1,6 +1,7 @@
 /** @jsxImportSource @opentui/solid */
 import type { TuiPlugin, TuiPluginApi, TuiPluginModule } from "@opencode-ai/plugin/tui"
 import { Telescope } from "./telescope.tsx"
+import { debug } from "./ui/debug.ts"
 import { loadTelescopeConfig } from "./ui/config.ts"
 
 const id = "opencode-telescope"
@@ -12,15 +13,19 @@ const enabled = (options: unknown) => {
 }
 
 const tui: TuiPlugin = async (api: TuiPluginApi, options: unknown) => {
+  debug.log("plugin:setup:start")
   if (!enabled(options)) return
 
   const config = loadTelescopeConfig()
   const command = "opencode.telescope.sessions"
   const open = () => {
+    debug.log("plugin:dialog:open:start")
     api.ui.dialog.replace(() => <Telescope api={api} config={config} onClose={() => api.ui.dialog.clear()} />)
     api.ui.dialog.setSize("xlarge")
+    debug.log("plugin:dialog:open:done")
   }
 
+  debug.log("plugin:setup:register-keymap")
   const unregisterKeymap = api.keymap.registerLayer({
     commands: [
       {
@@ -38,6 +43,7 @@ const tui: TuiPlugin = async (api: TuiPluginApi, options: unknown) => {
   api.lifecycle.onDispose(() => {
     unregisterKeymap()
   })
+  debug.log("plugin:setup:done")
 }
 
 const plugin: TuiPluginModule & { id: string } = {