@ucsandman/legcli 0.9.0 → 0.10.0

package/src/board/history.js

@@ -0,0 +1,377 @@
+// History cell: every conversation on this machine, Leg's own and the ones
+// Claude Code, Codex, Grok, Antigravity and Copilot keep in their own stores.
+// Data: /api/history (a page at a time) and /api/history/<id> (one
+// conversation's last messages, read only when a row is opened), plus
+// /api/worktrees. Nothing here is pushed over SSE: the live terminals lane
+// stays the only live region; this cell is a count that opens, like finished
+// terminals and what landed (DESIGN.md rule 3).
+//
+// `el`, `api`, `getToken`, `ago` and `whenAgo` are copied from sessions.js,
+// which cannot export from its IIFE. The time grammar is sessions.js's: a
+// change to ago() there is a change here in the same commit.
+(function () {
+  'use strict'
+  const PAGE = 50
+  const IDS = ['claude', 'codex', 'agy', 'grok', 'copilot']
+
+  function getToken() { return localStorage.getItem('legToken') || localStorage.getItem('batonToken') || '' }
+  async function api(path, opts = {}) {
+    const headers = { 'Content-Type': 'application/json' }
+    const token = getToken()
+    if (token) headers.Authorization = `Bearer ${token}`
+    const r = await fetch(path, { method: opts.method || 'GET', headers, body: opts.body ? JSON.stringify(opts.body) : undefined })
+    const data = await r.json().catch(() => ({}))
+    if (!r.ok) throw new Error(data.error || `${r.status} ${r.statusText}`)
+    return data
+  }
+  function el(tag, attrs, children) {
+    const n = document.createElement(tag)
+    for (const [k, v] of Object.entries(attrs || {})) { if (v === null || v === undefined) continue; if (k === 'class') n.className = v; else n.setAttribute(k, v) }
+    for (const c of children || []) { if (c === null || c === undefined) continue; n.appendChild(typeof c === 'string' ? document.createTextNode(c) : c) }
+    return n
+  }
+  function ago(ms) {
+    const s = Math.max(0, Math.floor(ms / 1000))
+    if (s < 60) return `${s}s`
+    const m = Math.floor(s / 60)
+    if (m < 60) return `${m}m`
+    const h = Math.floor(m / 60)
+    if (h < 48) return `${h}h${m % 60 ? ` ${m % 60}m` : ''}`
+    const d = Math.floor(h / 24)
+    return `${d}d${h % 24 ? ` ${h % 24}h` : ''}`
+  }
+  function whenAgo(ts) {
+    const t = Date.parse(ts)
+    return Number.isFinite(t) ? `${ago(Date.now() - t)} ago` : ''
+  }
+  function sysMessage(text, tone) { const fn = window.legMessage || window.batonMessage; if (typeof fn === 'function') fn(text, tone) }
+
+  function fallbackCopy(text) {
+    const ta = document.createElement('textarea')
+    ta.value = text
+    ta.style.position = 'fixed'
+    ta.style.opacity = '0'
+    document.body.appendChild(ta)
+    ta.select()
+    let ok = false
+    try { ok = document.execCommand('copy') } catch { ok = false }
+    document.body.removeChild(ta)
+    return ok
+  }
+
+  function takeFocus(box) {
+    const node = document.activeElement
+    if (!box || !node || !box.contains(node)) return null
+    const key = typeof node.getAttribute === 'function' ? node.getAttribute('data-focus-key') : null
+    if (!key) return null
+    const at = { key }
+    if (typeof node.selectionStart === 'number') { at.start = node.selectionStart; at.end = node.selectionEnd }
+    return at
+  }
+
+  function putFocus(box, at) {
+    if (!box || !at) return
+    const key = at.key.replace(/\\/g, '\\\\').replace(/"/g, '\\"')
+    let target = null
+    try { target = box.querySelector(`[data-focus-key="${key}"]`) } catch { return }
+    if (target && target.disabled) target = target.parentElement?.querySelector('[data-focus-key]:not([disabled])') || null
+    if (!target) return
+    target.focus({ preventScroll: true })
+    if (typeof at.start === 'number' && typeof target.setSelectionRange === 'function') {
+      try { target.setSelectionRange(at.start, at.end) } catch {}
+    }
+  }
+
+  function takeScroll(box) {
+    const at = new Map()
+    if (!box) return at
+    for (const node of box.querySelectorAll('[data-scroll-key]')) if (node.scrollTop) at.set(node.getAttribute('data-scroll-key'), node.scrollTop)
+    return at
+  }
+
+  function putScroll(box, at) {
+    if (!box || !at || !at.size) return
+    for (const node of box.querySelectorAll('[data-scroll-key]')) {
+      const was = at.get(node.getAttribute('data-scroll-key'))
+      if (was) node.scrollTop = was
+    }
+  }
+
+  const state = {
+    open: false, loaded: false, loading: false, error: '', guest: false,
+    total: 0, counts: {}, records: [], offset: 0, providers: [], refreshedAt: null,
+    filters: { provider: '', search: '', repo: '', managed: false },
+    detailId: null, detail: null, detailError: '',
+    worktrees: null, worktreesError: '',
+  }
+  let searchTimer = null
+  let loadSeq = 0 // a slower, older request never overwrites a newer filter's answer
+
+  function query({ more = false } = {}) {
+    const f = state.filters
+    const q = new URLSearchParams()
+    q.set('limit', String(PAGE))
+    if (more && state.records.length) {
+      const last = state.records[state.records.length - 1]
+      q.set('before', last.id)
+    } else {
+      q.set('offset', '0')
+    }
+    if (f.provider) q.set('provider', f.provider)
+    if (f.search) q.set('search', f.search)
+    if (f.repo) q.set('repo', f.repo)
+    if (f.managed) q.set('managed', '1')
+    return `/api/history?${q}`
+  }
+
+  async function load({ more = false } = {}) {
+    if (state.loading && more) return
+    state.loading = true
+    state.error = ''
+    const seq = ++loadSeq
+    try {
+      const r = await api(query({ more }))
+      if (seq !== loadSeq) return
+      // a page fetched after new conversations arrived can overlap the last one
+      const seen = new Set(more ? state.records.map((x) => x.id) : [])
+      state.records = more ? [...state.records, ...r.records.filter((x) => !seen.has(x.id))] : r.records
+      state.total = r.total
+      state.counts = r.counts || {}
+      state.providers = r.providers || []
+      state.refreshedAt = r.refreshed_at
+      state.loaded = true
+      if (r.refresh_error) state.error = `the index did not refresh: ${r.refresh_error}`
+    } catch (err) {
+      if (seq !== loadSeq) return
+      // a guest never gets this cell: the whole group is the owner's
+      if (/belongs to the owner/.test(err.message)) state.guest = true
+      state.error = err.message
+    }
+    state.loading = false
+    render()
+  }
+
+  async function loadWorktrees() {
+    try { state.worktrees = await api('/api/worktrees?dirty=0'); state.worktreesError = '' } catch (err) { state.worktreesError = err.message }
+    render()
+  }
+
+  async function openDetail(id) {
+    if (state.detailId === id) { state.detailId = null; state.detail = null; render(); return }
+    state.detailId = id
+    state.detail = null
+    state.detailError = ''
+    render()
+    try {
+      const d = await api(`/api/history/${encodeURIComponent(id)}?messages=8`)
+      if (state.detailId !== id) return
+      state.detail = d
+    } catch (err) { if (state.detailId === id) state.detailError = err.message }
+    render()
+    document.querySelector(`[data-focus-key="history-close:${CSS.escape(id)}"]`)?.focus({ preventScroll: true })
+  }
+
+  function copy(text, what) {
+    const done = () => sysMessage(`${what} copied`, 'ok')
+    const fail = () => {
+      if (fallbackCopy(text)) done()
+      else sysMessage(`could not copy the ${what}`, 'danger')
+    }
+    if (navigator.clipboard && navigator.clipboard.writeText) navigator.clipboard.writeText(text).then(done, fail)
+    else fail()
+  }
+
+  const short = (r) => `${r.provider}:${String(r.native_id || r.leg_session_id || '').slice(0, 8)}`
+  const agentChip = (name) => el('span', { class: `chip${IDS.includes(name) ? ` chip-id-${name}` : ''}` }, [name])
+
+  function row(r) {
+    const where = `${r.repo_name || r.cwd || 'no folder'}${r.branch ? ` on ${r.branch}` : ''}${r.worktree ? ' (worktree)' : ''}`
+    const open = state.detailId === r.id
+    const title = el('button', { type: 'button', class: 'history-title', 'aria-expanded': open ? 'true' : 'false', 'data-focus-key': `history:${r.id}` }, [r.title || `(untitled, ${short(r)})`])
+    title.addEventListener('click', () => openDetail(r.id))
+    return el('div', { class: 'history-row', 'data-history-id': r.id }, [
+      el('div', {}, [
+        title,
+        el('div', { class: 'history-register' }, [
+          agentChip(r.provider),
+          r.managed ? el('span', { class: 'chip' }, [r.live ? 'leg, live' : 'leg']) : el('span', { class: 'chip is-stale' }, [r.live ? 'external, live' : 'external']),
+          el('span', {}, [where]),
+          r.turns ? el('span', {}, [`${r.turns} prompt${r.turns === 1 ? '' : 's'}`]) : null,
+          el('span', { class: 'mono' }, [short(r)]),
+        ]),
+      ]),
+      el('span', { class: 'history-when' }, [whenAgo(r.updated_at || r.started_at)]),
+    ])
+  }
+
+  function messageRow(m, key) {
+    const isUser = m.role === 'user'
+    return el('div', { class: `turn drawer-msg ${isUser ? 'is-human' : 'is-agent'}` }, [
+      el('div', { class: 'drawer-msg-head' }, [
+        el('span', { class: `turn-role drawer-msg-role ${isUser ? '' : 'chip-state-ok'}` }, [isUser ? 'human' : 'agent']),
+        m.ts ? el('span', { class: 'turn-when drawer-msg-when' }, [whenAgo(m.ts)]) : null,
+      ]),
+      el('p', { 'data-scroll-key': `history-msg:${key}` }, [m.text]),
+    ])
+  }
+
+  function detail(r) {
+    const d = state.detail
+    const box = el('div', { class: 'history-detail', role: 'region', 'aria-label': `Conversation ${short(r)}` })
+    const close = el('button', { type: 'button', class: 'btn btn-secondary btn-sm', 'data-focus-key': `history-close:${r.id}` }, ['Close'])
+    close.addEventListener('click', () => openDetail(r.id))
+    box.appendChild(el('div', { class: 'detail-heading' }, [el('span', {}, [r.title || 'Untitled conversation']), close]))
+    if (state.detailError) { box.appendChild(el('p', { class: 'history-empty' }, [`could not read it: ${state.detailError}`])); return box }
+    if (!d) { box.appendChild(el('p', { class: 'history-empty' }, ['reading the conversation'])); return box }
+    const kv = el('div', { class: 'kv' })
+    const pair = (k, v) => { if (v === null || v === undefined || v === '') return; kv.appendChild(el('span', { class: 'kv-key' }, [k])); kv.appendChild(el('span', { class: 'kv-val' }, [typeof v === 'string' ? v : String(v)])) }
+    pair('agent', `${d.provider}${d.account && d.account !== 'default' ? ` (${d.account})` : ''}`)
+    pair('started by', d.managed ? `Leg, session ${d.leg_session_id} (${d.leg_status})` : 'the agent itself, outside Leg')
+    pair('folder', `${d.cwd || 'unknown'}${d.cwd_exists === false ? ' (gone)' : ''}`)
+    pair('repository', d.repo ? `${d.repo}${d.branch ? ` on ${d.branch}` : ''}` : null)
+    pair('worktree', d.worktree ? d.worktree.path : null)
+    pair('started', d.started_at ? `${new Date(d.started_at).toLocaleString()} (${whenAgo(d.started_at)})` : null)
+    pair('last activity', d.updated_at ? `${new Date(d.updated_at).toLocaleString()} (${whenAgo(d.updated_at)})` : null)
+    pair('prompts', d.turns)
+    pair('transcript', d.transcript === 'supported' ? d.transcript_path : `${d.transcript_path || 'kept by the agent'} (Leg cannot read this agent's transcript)`)
+    pair('id', d.id)
+    box.appendChild(kv)
+    const cmd = el('div', { class: 'history-command' })
+    if (d.resume && d.resume.supported) {
+      const text = `leg history continue ${d.id}`
+      const b = el('button', { type: 'button', class: 'btn btn-secondary btn-sm' }, ['Copy the continue command'])
+      b.addEventListener('click', () => copy(text, 'command'))
+      cmd.append(el('span', {}, ['Continue it in a terminal:']), el('code', { class: 'mono' }, [text]), b)
+    } else cmd.appendChild(el('span', { class: 'history-empty' }, [`Cannot continue it: ${d.resume ? d.resume.reason : 'unknown'}`]))
+    if (d.cwd) { const b = el('button', { type: 'button', class: 'btn btn-secondary btn-sm' }, ['Copy folder path']); b.addEventListener('click', () => copy(d.cwd, 'path')); cmd.appendChild(b) }
+    box.appendChild(cmd)
+    if (d.messages === null) box.appendChild(el('p', { class: 'history-empty' }, ['Leg has no reader for this agent\'s transcript; the agent itself can show it.']))
+    else if (!d.messages.length) box.appendChild(el('p', { class: 'history-empty' }, ['No messages could be read from the transcript.']))
+    else {
+      box.appendChild(el('p', { class: 'cap-line' }, [`the last ${d.messages.length} message${d.messages.length === 1 ? '' : 's'}, newest first`]))
+      const msgs = [...d.messages].reverse()
+      msgs.forEach((m, i) => box.appendChild(messageRow(m, `${r.id}:${i}`)))
+    }
+    return box
+  }
+
+  function worktreeRow(w) {
+    const owner = w.owner.kind === 'checkout' ? 'the checkout itself' : w.owner.kind === 'session' ? `Leg session ${w.owner.id}${w.owner.live ? ', live' : ''}` : w.owner.kind === 'card' ? `Leg card ${w.owner.id}` : 'not Leg\'s'
+    const flags = []
+    if (!w.exists) flags.push(el('span', { class: 'chip chip-state-warn' }, ['missing']))
+    if (w.orphaned) flags.push(el('span', { class: 'chip chip-state-warn' }, ['orphaned']))
+    if (w.stale) flags.push(el('span', { class: 'chip is-stale' }, ['stale']))
+    if (w.dirty !== null && w.dirty !== undefined) flags.push(el('span', { class: `chip ${w.dirty ? 'chip-state-warn' : 'chip-state-ok'}` }, [w.dirty ? `${w.dirty} uncommitted` : 'clean']))
+    return el('div', { class: 'history-row' }, [
+      el('div', {}, [
+        el('div', { class: 'mono' }, [w.path]),
+        el('div', { class: 'history-register' }, [
+          el('span', {}, [`${w.repo_name || 'repo'}${w.branch ? ` on ${w.branch}` : ' (detached)'}`]),
+          el('span', {}, [owner]),
+          el('span', {}, [`${w.conversations.count} conversation${w.conversations.count === 1 ? '' : 's'}`]),
+          ...flags,
+        ]),
+      ]),
+      el('span', { class: 'history-when' }, [w.last_activity_at ? whenAgo(w.last_activity_at) : '']),
+    ])
+  }
+
+  function render() {
+    const head = document.getElementById('history-head')
+    const region = document.querySelector('.region-history')
+    const meta = document.querySelector('.region-history .region-meta')
+    const slot = document.getElementById('history-actions')
+    const panel = document.getElementById('history-drawer')
+    const list = document.getElementById('history-list')
+    const listMeta = document.getElementById('history-list-meta')
+    const more = document.getElementById('history-more')
+    if (!head || !meta || !slot || !panel || !list || !listMeta || !more) return
+    const focusAt = takeFocus(panel) || takeFocus(region)
+    const scrollAt = takeScroll(panel)
+    slot.textContent = ''
+    if (state.guest) { head.textContent = 'Conversations'; meta.textContent = 'The owner of this machine sees them.'; panel.hidden = true; return }
+    if (!state.loaded) {
+      head.textContent = state.error ? 'Conversations unavailable' : 'Reading conversations'
+      meta.textContent = state.error || 'Looking through the agents\' own stores.'
+      panel.hidden = true
+      return
+    }
+    const filtered = state.filters.provider || state.filters.search || state.filters.repo || state.filters.managed
+    const all = Object.values(state.counts).reduce((a, b) => a + b, 0)
+    const byAgent = Object.entries(state.counts).sort((a, b) => b[1] - a[1]).map(([p, n]) => `${n} ${p}`).join(', ')
+    head.textContent = all ? `${all} conversation${all === 1 ? '' : 's'}` : 'No conversations found'
+    meta.textContent = all
+      ? `${byAgent}${filtered ? `; ${state.total} match the filters` : ''}${state.refreshedAt ? `; looked ${whenAgo(state.refreshedAt)}` : ''}`
+      : 'Leg looks in the Claude Code, Codex, Grok, Antigravity and Copilot homes on this machine, and its own sessions.'
+    const btn = el('button', { type: 'button', class: 'btn btn-secondary', 'aria-expanded': state.open ? 'true' : 'false', 'aria-controls': 'history-drawer', 'data-focus-key': 'history-toggle' },
+      [state.open ? 'Hide conversations' : (all ? `Browse ${all}` : 'Browse')])
+    btn.addEventListener('click', () => { state.open = !state.open; if (state.open && state.worktrees === null) loadWorktrees(); render() })
+    slot.appendChild(btn)
+    panel.hidden = !state.open
+    if (!state.open) {
+      putFocus(region, focusAt)
+      return
+    }
+    const headline = document.getElementById('history-drawer-head')
+    if (headline) headline.textContent = filtered ? `${state.total} of ${all} conversations` : `${all} conversation${all === 1 ? '' : 's'}`
+    // filters: the select is filled once from the providers the server names
+    const sel = document.getElementById('history-provider')
+    if (sel && sel.options.length <= 1 && state.providers.length) for (const p of state.providers) sel.appendChild(el('option', { value: p.name }, [p.label]))
+    listMeta.textContent = state.error ? state.error : (state.loading ? 'reading' : `${state.records.length} of ${state.total} shown, newest first`)
+    list.textContent = ''
+    if (!state.records.length && !state.loading) list.appendChild(el('p', { class: 'history-empty' }, [filtered ? 'Nothing matches these filters.' : 'No conversation has been found on this machine yet.']))
+    for (const r of state.records) {
+      list.appendChild(row(r))
+      if (state.detailId === r.id) list.appendChild(detail(r))
+    }
+    more.textContent = ''
+    if (state.records.length < state.total) {
+      const b = el('button', { type: 'button', class: 'btn btn-secondary', 'data-focus-key': 'history-more' }, [`Show ${Math.min(PAGE, state.total - state.records.length)} more`])
+      b.addEventListener('click', () => load({ more: true }))
+      more.appendChild(b)
+    }
+    // checkouts
+    const wtMeta = document.getElementById('worktrees-meta')
+    const wtList = document.getElementById('worktrees-list')
+    if (wtMeta && wtList) {
+      wtList.textContent = ''
+      if (state.worktreesError) wtMeta.textContent = `could not list them: ${state.worktreesError}`
+      else if (!state.worktrees) wtMeta.textContent = 'listing the checkouts'
+      else {
+        const w = state.worktrees.worktrees
+        const missing = w.filter((x) => !x.exists).length
+        const orphaned = w.filter((x) => x.orphaned).length
+        wtMeta.textContent = w.length ? `${w.length} checkout${w.length === 1 ? '' : 's'} across ${state.worktrees.repos} repositor${state.worktrees.repos === 1 ? 'y' : 'ies'}${missing ? `, ${missing} missing` : ''}${orphaned ? `, ${orphaned} orphaned` : ''}. Read only: Remove on a terminal or a card is what removes one.` : 'No repository is known yet.'
+        for (const x of w) wtList.appendChild(worktreeRow(x))
+      }
+    }
+    putScroll(panel, scrollAt)
+    putFocus(panel, focusAt) || putFocus(region, focusAt)
+  }
+
+  function wireFilters() {
+    const sel = document.getElementById('history-provider')
+    const search = document.getElementById('history-search')
+    const repo = document.getElementById('history-repo')
+    const only = document.getElementById('history-only')
+    const form = document.getElementById('history-filters')
+    if (form) form.addEventListener('submit', (e) => { e.preventDefault(); load() })
+    if (sel) sel.addEventListener('change', () => { state.filters.provider = sel.value; load() })
+    if (only) only.addEventListener('change', () => { state.filters.managed = only.checked; load() })
+    const debounce = (input, key) => input && input.addEventListener('input', () => {
+      state.filters[key] = input.value.trim()
+      clearTimeout(searchTimer)
+      searchTimer = setTimeout(() => load(), 300)
+    })
+    debounce(search, 'search')
+    debounce(repo, 'repo')
+  }
+
+  document.addEventListener('DOMContentLoaded', () => {
+    wireFilters()
+    render()
+    load()
+    // the count stays honest without pushing anything over the live stream
+    setInterval(() => { if (!document.hidden && !state.open) load() }, 60000)
+  })
+})()

package/src/board/index.html

@@ -75,6 +75,15 @@
       <div class="ledger-actions" id="trunk-actions"></div>
     </div>
 
+    <!-- Every conversation on this machine, Leg's own and the ones the agents
+         keep in their own stores. A count that opens, like the other three:
+         history.js fills it from /api/history, only once the reader asks. -->
+    <div class="ledger-cell region-history">
+      <h3 id="history-head">Reading conversations</h3>
+      <p class="region-meta"></p>
+      <div class="ledger-actions" id="history-actions"></div>
+    </div>
+
     <div class="ledger-cell" id="board">
       <h3 id="cards-head">No background tasks</h3>
       <p class="region-meta"></p>
@@ -97,6 +106,29 @@
     <div class="trunk-list" id="trunk"></div>
   </div>
 
+  <div class="drawer" id="history-drawer" hidden>
+    <h3 class="drawer-head" id="history-drawer-head">Conversations</h3>
+    <!-- discovered conversations are read from the agents' own stores and
+         never moved; a row opens its last messages in place, and the only
+         way to continue one is a command in a terminal, shown on the row -->
+    <form class="history-filters" id="history-filters">
+      <label for="history-provider">Agent</label>
+      <select id="history-provider"><option value="">every agent</option></select>
+      <label for="history-search">Search</label>
+      <input type="text" id="history-search" autocomplete="off" spellcheck="false" placeholder="title, repo, branch or id">
+      <label for="history-repo">Repository</label>
+      <input type="text" id="history-repo" autocomplete="off" spellcheck="false" placeholder="name or path">
+      <label for="history-only"><input type="checkbox" id="history-only"> only conversations Leg started</label>
+    </form>
+    <p class="region-meta" id="history-list-meta" role="status" aria-atomic="true"></p>
+    <div class="history-list" id="history-list"></div>
+    <div class="ledger-actions" id="history-more"></div>
+    <p class="drawer-note">Read only: each agent keeps its own history where it always was. Leg lists it, opens it, and never moves or changes it. Sessions Leg started itself are marked <span class="chip">leg</span>; the rest are <span class="chip is-stale">external</span>.</p>
+    <h3 class="drawer-head" id="worktrees-head">Checkouts</h3>
+    <p class="region-meta" id="worktrees-meta" role="status" aria-atomic="true"></p>
+    <div class="history-list" id="worktrees-list"></div>
+  </div>
+
   <div class="drawer" id="cards-drawer" hidden>
     <h3 class="drawer-head">Background tasks</h3>
     <div class="card-list" id="columns"></div>
@@ -247,5 +279,6 @@
 
 <script src="board.js" defer></script>
 <script src="sessions.js" defer></script>
+<script src="history.js" defer></script>
 </body>
 </html>

package/src/board/sessions.js

@@ -836,8 +836,14 @@
     ]))
 
     if (pendingConfirm && pendingConfirm.id === s.session_id) {
+      // Snapshot it: confirmRow clears pendingConfirm before it calls back, so
+      // a callback that read the variable instead of this value dereferenced
+      // null and threw on the way to act(). That was every Yes on this page —
+      // Remove, Remove record, End and Land all did nothing, with the
+      // TypeError going only to the console.
+      const pending = pendingConfirm
       term.appendChild(row)
-      term.appendChild(confirmRow(pendingConfirm.question, pendingConfirm.verb, (btn) => act(s.session_id, pendingConfirm.action, btn)))
+      term.appendChild(confirmRow(pending.question, pending.verb, (btn) => act(s.session_id, pending.action, btn)))
       return term
     }
     const actions = el('div', { class: 'term-actions' })
@@ -1563,7 +1569,13 @@
     }
     renderAccounts(v.accounts || [])
     renderDefaultOrder(v)
-    renderSessions(v)
+    // A rebuild replaces every button in the grid. A confirm row is a question
+    // the reader is answering right now, and a push landing between their
+    // mousedown and their mouseup dropped the click: the browser fires `click`
+    // only when both landed on the same element, so Remove did nothing however
+    // often it was pressed. The rows hold still until the question is answered
+    // — `view` is already current, and answering it re-renders from that.
+    if (!pendingConfirm) renderSessions(v)
     renderTrunk(v)
     // the panel behind the expansion just changed: status, turns and what is
     // next live in the session view, so redraw the region from it
@@ -1574,9 +1586,11 @@
     try { render(await api('/api/sessions')) } catch (err) { sysMessage(err.message, 'danger') }
   }
 
-  window.addEventListener('leg:sessions', (e) => render(e.detail));
-  window.addEventListener('leg:sessions', (e) => render(e.detail));
-  window.addEventListener('baton:sessions', (e) => render(e.detail)); // legacy alias
+  // Exactly one listener. board.js publishes `leg:sessions` and the legacy
+  // `baton:sessions` alias for every push; this file had been registered on
+  // `leg:sessions` twice and on the alias once, so one push rebuilt the entire
+  // terminals grid three times over.
+  window.addEventListener('leg:sessions', (e) => render(e.detail))
   document.addEventListener('keydown', (e) => {
     if (e.key !== 'Escape') return
     if (pendingConfirm) { pendingConfirm = null; if (view) renderSessions(view); return }
@@ -1589,6 +1603,6 @@
     setInterval(tickElapsed, 1000)
     // the timed re-sort exists to move the needs-you partition, which can wait a
     // few seconds: it stands down mid-selection rather than clearing the drag
-    setInterval(() => { if (view && !selectionInsideGrid()) renderSessions(view) }, 15000)
+    setInterval(() => { if (view && !pendingConfirm && !selectionInsideGrid()) renderSessions(view) }, 15000)
   })
 })()

package/src/history/cli.mjs

@@ -0,0 +1,159 @@
+// `leg history <verb>` and `leg worktrees` — the human surface of discovery.
+// Every verb prints for a person by default and JSON with --json; every one
+// of them is read-only except `continue`, which starts a normal `leg <agent>`
+// session on a conversation the agent's own store holds. Exit codes follow
+// the rest of the CLI: 0 fine, 1 internal error, 2 usage, 3 not found / not
+// possible, 4 license required.
+import { resolve } from 'node:path'
+import { listHistory, findRecord, recordDetail, refreshIndex, resumeSpec, providerSupport, HistoryInputError, PROVIDER_NAMES, DEFAULT_LIMIT } from './index.mjs'
+import { listWorktrees } from './worktrees.mjs'
+import { ago } from '../resume.mjs'
+import { attach } from '../attach.mjs'
+import { entitlement, allows, describe as describeLicense } from '../license.mjs'
+
+export const HELP = `leg history: every coding-agent conversation on this machine, Leg's own and the ones it only found
+  [ls] [--provider claude,codex,grok,agy,copilot] [--repo <path|name>] [--search <text>] [--limit n] [--offset n] [--all] [--json]
+       [--managed | --external] [--live] [--subagents] [--refresh]
+                                  newest first; the index refreshes itself when it is older than a minute
+  show <id> [--messages n] [--json]  one conversation: where it ran, its last messages, whether Leg can continue it
+  continue <id> [agent args...]   start leg <agent> on that conversation, in its own folder, supervised like any other
+  refresh [--full] [--json]       re-stat every store now; --full drops the index and re-reads everything
+  providers [--json]              what Leg can do for each agent: list, read the transcript, continue
+An id is <provider>:<native id>; a unique prefix of the native id (4+ characters) is enough.
+Nothing in an agent's own store is moved or changed; Leg writes only ${'$LEG_HOME'}/history/index.json.`
+
+export const WORKTREES_HELP = `leg worktrees [--repo <path>] [--no-dirty] [--json]
+  every checkout git lists for the repositories Leg knows, Leg's own worktrees and the ones
+  discovered conversations were working in; read only (leg card rm / the board's Remove still own removal)`
+
+// a Leg-only row's id is the session id whole: cut, it would not round-trip
+const short = (id) => { const [p, n] = String(id).split(':', 2); if (p === 'leg') return String(id); return n ? `${p}:${n.slice(0, 8)}` : String(id).slice(0, 24) }
+const when = (iso) => (iso ? ago(Date.now() - Date.parse(iso)) : '-')
+const flag = (args, k) => args[k] === true || (typeof args[k] === 'string' && args[k] !== 'false')
+
+export function fmtRow(r) {
+  const who = r.managed ? (r.live ? 'leg live' : 'leg') : (r.live ? 'external live' : 'external')
+  const where = `${r.repo_name ?? r.cwd ?? '-'}${r.branch ? '@' + r.branch : ''}${r.worktree ? ' (worktree)' : ''}`
+  return `${short(r.id).padEnd(16)}  ${r.provider.padEnd(6)}  ${who.padEnd(13)}  ${where.slice(0, 40).padEnd(40)}  ${when(r.updated_at).padEnd(20)}  ${String(r.title ?? '').slice(0, 60)}`
+}
+
+function printDetail(out, d, { requested = 8 } = {}) {
+  out(`${d.id}  ${d.provider}${d.account !== 'default' ? '/' + d.account : ''}  ${d.managed ? `Leg session ${d.leg_session_id} (${d.leg_status})` : 'discovered, not started by Leg'}${d.live ? '  LIVE' : ''}`)
+  out(`  title:      ${d.title ?? '-'}`)
+  out(`  folder:     ${d.cwd ?? '-'}${d.cwd_exists === false ? '  (gone)' : ''}`)
+  out(`  repo:       ${d.repo ?? '-'}${d.branch ? `  branch ${d.branch}` : ''}`)
+  if (d.worktree) out(`  worktree:   ${d.worktree.path}`)
+  out(`  started:    ${d.started_at ?? '-'}`)
+  out(`  updated:    ${d.updated_at ?? '-'}  (${when(d.updated_at)})`)
+  out(`  turns:      ${d.turns ?? 'unknown'}`)
+  out(`  transcript: ${d.transcript_path ?? '-'}${d.transcript === 'unsupported' ? '  (Leg cannot read this provider\'s transcript)' : ''}`)
+  out(`  continue:   ${d.resume.supported ? `leg history continue ${d.id}` : `not possible: ${d.resume.reason}`}`)
+  if (d.messages === null) out('  messages:   not readable for this provider')
+  else if (requested === 0) out('  messages:   not asked for (--messages 0)')
+  else if (!d.messages.length) out('  messages:   none readable')
+  else {
+    out('  messages:')
+    for (const m of d.messages) out(`    [${m.role === 'user' ? 'human' : 'agent'}${m.ts ? ' ' + String(m.ts).slice(0, 16).replace('T', ' ') : ''}] ${m.text.replace(/\s+/g, ' ').slice(0, 300)}`)
+  }
+}
+
+export async function historyCommand(cmd, args, { out, die, raw = [] }) {
+  const json = flag(args, 'json')
+  if (cmd === 'help' || cmd === '--help' || cmd === '-h' || flag(args, 'help') || flag(args, 'h')) { out(HELP); return 0 }
+  if (!cmd || cmd === 'ls') {
+    if (args.limit !== undefined) {
+      const n = Number(args.limit)
+      if (!Number.isInteger(n) || n < 1) return die(2, '--limit must be a positive integer (--all lists everything)')
+    }
+    if (args.offset !== undefined) {
+      const n = Number(args.offset)
+      if (!Number.isInteger(n) || n < 0) return die(2, '--offset must be a non-negative integer')
+    }
+    if (args.provider && String(args.provider).split(',').some((p) => !PROVIDER_NAMES.includes(p.trim()))) return die(2, `unknown provider in "${args.provider}" (${PROVIDER_NAMES.join('|')})`)
+    let r
+    try {
+      r = listHistory({
+        provider: args.provider ?? null, repo: args.repo ? (/[\\/]/.test(args.repo) ? resolve(String(args.repo)) : args.repo) : null, search: args.search ?? null,
+        limit: flag(args, 'all') ? 0 : (args.limit ? parseInt(args.limit, 10) : DEFAULT_LIMIT), offset: args.offset ? parseInt(args.offset, 10) : 0,
+        includeSubagents: flag(args, 'subagents'), refresh: flag(args, 'refresh') ? true : null,
+        managed: flag(args, 'managed') ? true : flag(args, 'external') ? false : null, live: flag(args, 'live') ? true : null,
+      })
+    } catch (err) { return die(1, `history: ${err.message}`) }
+    if (json) { out(JSON.stringify(r, null, 2)); return 0 }
+    // a failed refresh is said whatever the last index still lists
+    if (r.refresh_error) out(`refresh error: ${r.refresh_error} (showing the last index${r.refreshed_at ? ', from ' + when(r.refreshed_at) : ''})`)
+    if (!r.total) {
+      out('no conversations found.')
+      out('Leg looks in the Claude Code, Codex, Grok, Antigravity and Copilot homes on this machine, plus its own sessions. leg history providers lists them.')
+      return 0
+    }
+    for (const x of r.records) out(fmtRow(x))
+    if (r.total > r.records.length) out(`… ${r.total - r.records.length} more (--limit n, or --all)`)
+    return 0
+  }
+  if (cmd === 'refresh') {
+    const t = Date.now()
+    let r
+    try { r = refreshIndex({ force: flag(args, 'full') }) } catch (err) { return die(1, `history refresh: ${err.message}`) }
+    if (json) { out(JSON.stringify({ ms: Date.now() - t, refreshed_at: r.index.refreshed_at, stats: r.stats }, null, 2)); return 0 }
+    for (const s of r.stats) out(`${s.provider.padEnd(6)} ${s.account === 'default' ? '' : s.account.padEnd(10)} ${s.missing ? 'no store here' : s.error ? `ERROR ${s.error}` : `${s.records} conversation${s.records === 1 ? '' : 's'} (${s.scanned} scanned, ${s.parsed} read)`}  ${s.root}`)
+    out(`refreshed in ${Date.now() - t} ms`)
+    return r.stats.some((s) => s.error) ? 1 : 0
+  }
+  if (cmd === 'providers') {
+    const p = providerSupport()
+    if (json) { out(JSON.stringify(p, null, 2)); return 0 }
+    out('provider  list  transcript   continue     live marker')
+    for (const x of p) out(`${x.name.padEnd(9)} yes   ${x.transcript.padEnd(12)} ${x.resume.padEnd(12)} ${x.live === 'marker' ? 'yes' : 'no'}`)
+    return 0
+  }
+  if (cmd === 'show' || cmd === 'continue') {
+    const id = args._[0]
+    if (!id) return die(2, `usage: leg history ${cmd} <id>`)
+    let rec
+    try { rec = findRecord(id) } catch (err) { if (err instanceof HistoryInputError) return die(2, err.message); throw err }
+    if (!rec) return die(3, `no conversation matches "${id}" (leg history ls)`)
+    if (cmd === 'show') {
+      if (args.messages !== undefined) {
+        const n = Number(args.messages)
+        if (!Number.isInteger(n) || n < 0) return die(2, '--messages must be a non-negative integer')
+      }
+      const requested = args.messages !== undefined ? parseInt(args.messages, 10) : 8
+      const d = recordDetail(rec, { messages: requested })
+      if (json) { out(JSON.stringify(d, null, 2)); return 0 }
+      printDetail(out, d, { requested })
+      return 0
+    }
+    const spec = resumeSpec(rec)
+    if (!spec.supported) return die(3, `cannot continue ${rec.id}: ${spec.reason}`)
+    const ent = entitlement()
+    if (!allows(ent, 'run')) {
+      out(describeLicense(ent))
+      return 4
+    }
+    out(`continuing ${rec.id} with leg ${spec.agent} in ${spec.cwd}`)
+    // everything after the id is the agent's (and Leg's own --no-worktree,
+    // --no-auto-approve, which attach() strips as it does for leg <agent>)
+    const at = raw.indexOf(id)
+    const extra = at === -1 ? [] : raw.slice(at + 1)
+    return attach(spec.agent, [...spec.args, ...extra], { open: (process.env.LEG_NO_OPEN || process.env.BATON_NO_OPEN) !== '1', cwd: spec.cwd, continued: { id: rec.id, provider: rec.provider, native_id: rec.native_id, transcript_path: rec.transcript_path, title: rec.title } })
+  }
+  return die(2, `unknown history command "${cmd}" (ls|show|continue|refresh|providers)`)
+}
+
+export function fmtWorktree(w) {
+  const owner = w.owner.kind === 'checkout' ? 'checkout' : w.owner.kind === 'session' ? `session ${w.owner.id}${w.owner.live ? ' (live)' : ''}` : w.owner.kind === 'card' ? `card ${w.owner.id}` : 'external'
+  const flags = [!w.exists ? 'MISSING' : null, w.orphaned ? 'orphaned' : null, w.stale ? 'stale' : null, w.dirty === null ? null : w.dirty ? `${w.dirty} dirty` : 'clean'].filter(Boolean).join(', ')
+  return `${(w.repo_name ?? '-').padEnd(18)}  ${(w.branch ?? '(detached)').slice(0, 32).padEnd(32)}  ${owner.padEnd(36)}  ${String(w.conversations.count).padStart(3)} conv  ${flags.padEnd(22)}  ${w.path}`
+}
+
+export function worktreesCommand(cmd, args, { out, die }) {
+  if (cmd === 'help' || cmd === '--help' || cmd === '-h' || flag(args, 'help') || flag(args, 'h')) { out(WORKTREES_HELP); return 0 }
+  if (cmd && cmd !== 'ls') return die(2, `unknown worktrees command "${cmd}" (ls)`)
+  const r = listWorktrees({ dirty: !flag(args, 'no-dirty'), repo: args.repo ? resolve(String(args.repo)) : null })
+  if (flag(args, 'json')) { out(JSON.stringify(r, null, 2)); return 0 }
+  if (!r.worktrees.length) { out('no worktrees: Leg knows no repository yet (a session, a card or a discovered conversation names one).'); return 0 }
+  for (const w of r.worktrees) out(fmtWorktree(w))
+  out(`${r.worktrees.length} checkout${r.worktrees.length === 1 ? '' : 's'} across ${r.repos} repositor${r.repos === 1 ? 'y' : 'ies'}; dirty checked on ${r.dirty_checked}. Read only: leg card rm / leg sessions rm / the board's Remove own removal.`)
+  return 0
+}