@leftoff/cli 0.9.18-beta.1 → 0.9.18-beta.10

package/ui/prs.js

@@ -182,8 +182,11 @@ function sessionLinks(r, opts) {
 
 // One PR row on the PRs tab. 0.8.5: tap the row to expand it in place
 // (`open`, with `detail` as /v1/prs/detail answered: { loading } | { ok, detail } | { ok: false, code }).
-export function prRowHtml(r, { team = false, now = Date.now(), mayEdit = true, sessionAction = null, showMachine = false, open = false, detail = null, me = null } = {}) {
+export function prRowHtml(r, { team = false, now = Date.now(), mayEdit = true, sessionAction = null, showMachine = false, open = false, detail = null, me = null, picks = null } = {}) {
   const p = r.pr || {}
+  // testplan Part 3: a merged PR can be picked for a test plan (a box plus the word, the state in aria-pressed)
+  const picked = !!(picks && picks.has(p.url))
+  const pick = picks && p.state === 'merged' ? '<button type="button" class="pr-pick" data-action="prs-pick" data-url="' + esc(p.url) + '" aria-pressed="' + picked + '" data-tip="' + (picked ? 'Picked for a test plan' : 'Pick for a test plan') + '"><span aria-hidden="true">' + (picked ? '☑' : '☐') + '</span><span class="pr-pick-w">' + (picked ? 'Picked' : 'Pick') + '</span></button>' : ''
   const url = safeUrl(p.url)
   // 0.8.9: what the checks and review chips don't already say (a conflict, your review)
   const bwhy = r.bucketWhy !== undefined ? r.bucketWhy : prBucket(p, me).why
@@ -195,7 +198,7 @@ export function prRowHtml(r, { team = false, now = Date.now(), mayEdit = true, s
     : [p.repo, p.branch, when].filter(Boolean)
   const why = whyText(r)
   const unlinkTo = !team && mayEdit && (r.sessions || []).length === 1 ? r.sessions[0] : null
-  return '<article class="prrow' + (open ? ' open' : '') + '" data-pr="' + esc(p.url) + '"><div class="pr-main">' +
+  return '<article class="prrow' + (open ? ' open' : '') + (pick ? ' pickable' : '') + (picked ? ' picked' : '') + '" data-pr="' + esc(p.url) + '">' + pick + '<div class="pr-main">' +
     '<div class="pr-line1">' + line1 + '</div>' +
     '<div class="pr-title">' + (url ? '<a href="' + esc(url) + '" target="_blank" rel="noopener noreferrer">' + esc(p.title || '') + '</a>' : esc(p.title || '')) + '</div>' +
     '<div class="pr-meta">' + meta.map(esc).join(' · ') + (why ? ' · <span class="pr-why">' + esc(why) + '</span>' : '') + prMoreHtml(p, open) + '</div>' +
@@ -411,12 +414,19 @@ export const isOpenPr = (r) => !['merged', 'closed'].includes(String((r && r.pr
 function doneGroupHtml(g, { open, rowOpts }) {
   return '<details class="prgroup done b-' + g.key + '" data-group="' + g.key + '"' + (open ? ' open' : '') + '><summary><h2>' + esc(g.label) + ' <span class="count">' + g.rows.length + '</span><span class="chev" aria-hidden="true">›</span></h2></summary>' + g.rows.map((r) => prRowHtml(r, rowOpts(r))).join('') + '</details>'
 }
-export function prsBodyHtml(d, { view = 'mine', now = Date.now(), mayEdit = true, sessionAction = null, filter = {}, open = null, details = null, quietOpen = false, doneOpen = null, projects = [] } = {}) {
+// testplan Part 3: what's picked, and the way to a test plan of exactly those
+export function prPicksBarHtml(picks) {
+  const n = picks ? picks.size : 0
+  if (!n) return ''
+  const href = '#/testplan/new?prs=' + [...picks].map(encodeURIComponent).join(',')
+  return '<div class="prs-picks" role="status"><span><span aria-hidden="true">☑</span> ' + n + ' merged PR' + (n === 1 ? '' : 's') + ' picked</span><a class="btn primary" href="' + esc(href) + '">Test plan for these</a><button type="button" class="linkish" data-action="prs-pick-clear">Clear</button></div>'
+}
+export function prsBodyHtml(d, { view = 'mine', now = Date.now(), mayEdit = true, sessionAction = null, filter = {}, open = null, details = null, quietOpen = false, doneOpen = null, projects = [], picks = null } = {}) {
   const f = { repos: [], state: null, q: '', project: null, ...filter }
   if (f.project && !(projects || []).some((p) => p.id === f.project)) f.project = null
   const all = prRows(d)
   const me = d.me || null
-  let h = prsCutHtml(d) // 0.9.12: first, so a phone sees it
+  let h = prsCutHtml(d) + prPicksBarHtml(picks) // 0.9.12: first, so a phone sees it
   if (all.length) {
     // 0.9.0: projects first (when you have any), then the repos in the picked one
     if ((projects || []).length) {
@@ -449,7 +459,7 @@ export function prsBodyHtml(d, { view = 'mine', now = Date.now(), mayEdit = true
   const rows = filterPrRows(all, f, { me, projects })
   const { groups, quiet } = groupPrRows(rows, { now, me })
   const showMachine = !!d.multiMachine
-  const rowOpts = (r) => ({ team: view === 'team', now, mayEdit, sessionAction, showMachine, me, open: !!(open && open.has(r.pr.url)), detail: details ? details[r.pr.url] : null })
+  const rowOpts = (r) => ({ team: view === 'team', now, mayEdit, sessionAction, showMachine, me, open: !!(open && open.has(r.pr.url)), detail: details ? details[r.pr.url] : null, picks: view === 'mine' ? picks : null })
   if (!all.length && d.tooBig) {
     h += '<div class="empty">Too many PRs to load at once. <button type="button" class="linkish" data-action="prs-refresh">Try again</button></div>'
   } else if (!all.length) {

package/ui/semdiff.js

@@ -83,8 +83,11 @@ export function readingOrder(steps, data) {
   return (steps || []).slice().sort((a, b) => ri(a) - ri(b) || tagRank(a) - tagRank(b) || (a.n || 0) - (b.n || 0))
 }
 // A repo the session changed that couldn't be read here: one quiet line each, never dropped silently
+// 2026-11-03 and what it left out because it was already changed before the session (baseNotes)
 export function unreadableLines(data) {
-  return data && Array.isArray(data.unreadable) ? data.unreadable.map((u) => (u && (u.line || (u.repo ? u.repo + ': not readable from here' + (u.why ? ' (' + u.why + ')' : '') : ''))) || '').filter(Boolean) : []
+  const un = data && Array.isArray(data.unreadable) ? data.unreadable.map((u) => (u && (u.line || (u.repo ? u.repo + ': not readable from here' + (u.why ? ' (' + u.why + ')' : '') : ''))) || '').filter(Boolean) : []
+  const bn = data && Array.isArray(data.baseNotes) ? data.baseNotes.map((n) => (n && typeof n.line === 'string' ? n.line : '')).filter(Boolean) : []
+  return un.concat(bn)
 }
 function unreadableHtml(data, { esc, icon }) {
   const ls = unreadableLines(data)
@@ -139,9 +142,11 @@ export function snipsByFile(st) {
   return out
 }
 // the files of a walkthrough that start folded: generated or lockfiles, and anything in Safe to skip
+// (2026-11-03 not "Tests updated to match": a test a step names, like the one that pins the bug,
+// is part of that step's story even when the rest of its lines landed in that group)
 export function skipFiles(data) {
   const out = new Set()
-  for (const g of (data && data.groups) || []) for (const f of g.files || []) out.add(f.path)
+  for (const g of (data && data.groups) || []) if (g.kind !== 'tests') for (const f of g.files || []) out.add(f.path)
   for (const f of (data && data.files) || []) if (f.generated) out.add(f.path)
   return out
 }
@@ -160,10 +165,78 @@ export function sfSet(fp, keys, open) {
     if (all.length > 30) for (const k of all.filter((x) => x !== SF_KEY + fp).slice(0, all.length - 30)) localStorage.removeItem(k)
   } catch {}
 }
-export function sfOpen(state, step, file, skip) { const k = step + '|' + file; return k in (state || {}) ? !!state[k] : fileFoldsDefault(file, skip) }
+// def: the default when nothing was chosen (null: by the file's kind)
+export function sfOpen(state, step, file, skip, def = null) { const k = step + '|' + file; return k in (state || {}) ? !!state[k] : def != null ? !!def : fileFoldsDefault(file, skip) }
+// 2026-11-03 ("Where's my diff?": steps 1 and 2 both named one new test file; step 1's row came up
+// empty and its diff showed in step 2 only). Two steps naming exactly the same lines had one id,
+// so the one drawn diff moved to the later step. Walkthroughs kept before the fix still carry the
+// shared id: the later ones get their count appended, as src/semdiff.js uniqueStepIds does. In place.
+export function uniqueStepIds(steps) {
+  const seen = new Set()
+  for (const st of steps || []) {
+    if (!st || typeof st.id !== 'string' || !st.id) continue
+    if (!seen.has(st.id)) { seen.add(st.id); continue }
+    let k = 2
+    while (seen.has(st.id + k.toString(16))) k++
+    st.id = st.id + k.toString(16)
+    seen.add(st.id)
+  }
+  return steps
+}
+// The same lines shown again by a later step: "<step id>:<snippet i>" -> { id, n } of the first
+// step (in reading order) that shows them. That first step shows them open; a later one folds
+// that file with "Also in step N", which goes there.
+export function sharedSnips(data) {
+  const first = new Map(), out = new Map()
+  for (const st of readingOrder((data && data.steps) || [], data)) {
+    ;(st.snippets || []).forEach((sn, i) => {
+      const k = sn.hunk + '\0' + sn.patch + '\0' + JSON.stringify(sn.focus || null)
+      const f = first.get(k)
+      if (!f) first.set(k, { id: st.id, n: st.n })
+      else if (f.id !== st.id) out.set(st.id + ':' + i, f)
+    })
+  }
+  return out
+}
+// "Lines 12–30", "Lines 3–5, 9" (old side: "Old lines …"), or '' with no focus
+export function focusWords(focus) {
+  if (!Array.isArray(focus) || !focus.length) return ''
+  const r = (f) => (f.from === f.to ? String(f.from) : f.from + '–' + f.to)
+  const nw = focus.filter((f) => f.side !== 'old'), od = focus.filter((f) => f.side === 'old')
+  const parts = []
+  if (nw.length) parts.push((nw.length === 1 && nw[0].from === nw[0].to ? 'Line ' : 'Lines ') + nw.map(r).join(', '))
+  if (od.length) parts.push((parts.length ? 'old ' : 'Old ') + (od.length === 1 && od[0].from === od[0].to ? 'line ' : 'lines ') + od.map(r).join(', '))
+  return parts.join(', ')
+}
+// a file of a step whose every snippet an earlier step shows: that step, else null
+export function alsoIn(st, g, shared) {
+  if (!shared || !shared.size || !g.snips.length) return null
+  const fs = g.snips.map(([, i]) => shared.get(st.id + ':' + i))
+  return fs.every((f) => f && f.id === fs[0].id) ? fs[0] : null
+}
 export const CHANGED_TIP = 'Its files changed since this walkthrough was written'
 
-function stepHtml(st, { esc, icon, done, cur, open, sid, sf = {}, skip = null, stat = null }) {
+// 2026-11-03 decision memory: the accepted decisions a step cites, as small chips that open the decision with its chain
+export function decisionsOf(data) { return new Map(((data && data.decisions) || []).map((d) => [d.id, d])) }
+export function stepDecisionsHtml(st, data, { esc }) {
+  const ids = Array.isArray(st.decisions) ? st.decisions : []
+  if (!ids.length) return ''
+  const by = decisionsOf(data)
+  const gone = new Set((data && data.stale && data.stale.decisions) || [])
+  const departs = new Set(Array.isArray(st.departs) ? st.departs : [])
+  return '<div class="wt-decs" role="group" aria-label="Decisions behind this step">' + ids.map((id) => {
+    const d = by.get(id)
+    const dep = departs.has(id), prop = !!(d && d.status === 'proposed')
+    // 1g/1f: shape plus word, never color alone: ≠ Departs, ◌ Proposed
+    const marks = (dep ? '<span class="wt-dec-rel wt-dec-dep"><span aria-hidden="true">≠</span> Departs</span>' : '') + (prop ? '<span class="wt-dec-rel wt-dec-prop"><span aria-hidden="true">◌</span> Proposed</span>' : '')
+    const tip = (gone.has(id) ? 'Changed since this walkthrough · ' : '') + (dep ? 'This step departs from it · ' : '') + (prop ? 'Proposed by this session, not accepted yet · ' : '') + (d ? d.text : 'Decision ' + id)
+    return '<button type="button" class="dec-chip wt-dec' + (gone.has(id) ? ' wt-dec-gone' : '') + (dep ? ' wt-dec-departs' : '') + (prop ? ' wt-dec-proposed' : '') + '" data-action="wt-dec" data-id="' + esc(id) + '"' + (dep ? ' data-departs="1"' : '') + (data && data.decisionRepo ? ' data-repo="' + esc(data.decisionRepo) + '"' : '') +
+      ' data-tip="' + esc(tip) + '"><span class="wt-dec-id">' + esc(id) + '</span>' + marks + (d ? '<span class="wt-dec-t">' + esc(d.text) + '</span>' : '') + (gone.has(id) ? '<span class="wt-dec-w"> · changed since</span>' : '') + '</button>'
+  }).join('') + '</div>'
+}
+// how the export names a cited decision: "departs from" / "(proposed)"
+function decWord(st, id, d) { return (Array.isArray(st.departs) && st.departs.includes(id) ? 'departs from ' : '') + (d && d.status === 'proposed' ? '(proposed) ' : '') }
+function stepHtml(st, { esc, icon, done, cur, open, sid, sf = {}, skip = null, stat = null, shared = null, foldShared = true, data = null }) {
   const core = st.tag === 'Core'
   // 2026-10-29 several repos: the step's repo leads ("cube_cloud · src/x.ts"); one repo: the file names
   const rp = st.repo ? [st.repo] : []
@@ -175,15 +248,17 @@ function stepHtml(st, { esc, icon, done, cur, open, sid, sf = {}, skip = null, s
     '<button type="button" class="wt-rev' + (done ? ' on' : '') + '" data-action="wt-reviewed" data-id="' + esc(sid) + '" data-step="' + esc(st.id) + '" aria-pressed="' + (done ? 'true' : 'false') + '" data-tip="' + (done ? 'Reviewed · tap to undo' : 'Mark reviewed') + '">' + icon('check') + '<span>' + (done ? 'Reviewed' : 'Mark reviewed') + '</span></button></header>'
   const why = st.why ? '<div class="wt-why wt-md">' + walkBlock(st.why) + '</div>' : ''
   const byFile = snipsByFile(st)
-  const fileHead = (g, isOpen) => '<summary class="wt-sf-h" aria-label="' + esc((st.repo ? repoSplit(g.file, rp).filter(Boolean).join(' · ') : g.file) + ', ' + g.add + ' added, ' + g.del + ' removed') + '">' + icon('chevron-right', 'ic wt-g-chev') +
+  const fileHead = (g, isOpen, also) => '<summary class="wt-sf-h" aria-label="' + esc((st.repo ? repoSplit(g.file, rp).filter(Boolean).join(' · ') : g.file) + ', ' + g.add + ' added, ' + g.del + ' removed' + (also ? ', also in step ' + also.n : '')) + '">' + icon('chevron-right', 'ic wt-g-chev') +
     (stat && stat.get(g.file) ? statusHtml(stat.get(g.file), { esc, icon }) : '') +
     '<span class="mono wt-sf-p">' + esc(st.repo ? repoSplit(g.file, rp).filter(Boolean).join(' · ') : g.file) + '</span>' +
+    (also ? '<a class="wt-also" href="#wt-' + esc(also.id) + '" data-action="wt-go" data-step="' + esc(also.id) + '" data-file="' + esc(g.file) + '" data-tip="The same lines, open in step ' + also.n + '">' + icon('arrow-up') + 'Also in step ' + also.n + '</a>' : '') +
     '<span class="wt-file-n"><span class="wt-add">+' + n0(g.add) + '</span> <span class="wt-del">−' + n0(g.del) + '</span></span></summary>'
   const snips = (byFile.length > 1 ? '<div class="wt-sfa" role="group" aria-label="Files in this step"><button type="button" class="linkish wt-sfa-b" data-action="wt-sf-all" data-step="' + esc(st.id) + '" data-open="0">' + icon('chevrons-down-up') + 'Collapse all</button><button type="button" class="linkish wt-sfa-b" data-action="wt-sf-all" data-step="' + esc(st.id) + '" data-open="1">' + icon('chevrons-up-down') + 'Expand all</button></div>' : '') +
     byFile.map((g) => {
-      const isOpen = sfOpen(sf, st.id, g.file, skip)
-      return '<details class="wt-sf" data-sfk="' + esc(st.id + '|' + g.file) + '" data-step="' + esc(st.id) + '"' + (isOpen ? ' open' : '') + '>' + fileHead(g, isOpen) +
-        g.snips.map(([sn, i]) => '<div class="wt-snip">' + (sn.partial ? '<div class="wt-snip-h"><span class="faint">Part of the change</span></div>' : '') + '<div class="wt-snip-d" data-snip="' + esc(st.id) + ':' + i + '"></div></div>').join('') + '</details>'
+      const also = alsoIn(st, g, shared)
+      const isOpen = sfOpen(sf, st.id, g.file, skip, also && foldShared ? false : null)
+      return '<details class="wt-sf' + (also ? ' wt-sf-also' : '') + '" data-sfk="' + esc(st.id + '|' + g.file) + '" data-step="' + esc(st.id) + '"' + (isOpen ? ' open' : '') + '>' + fileHead(g, isOpen, also) +
+        g.snips.map(([sn, i]) => '<div class="wt-snip">' + (sn.partial ? '<div class="wt-snip-h"><span class="faint">Part of the change</span></div>' : focusWords(sn.focus) ? '<div class="wt-snip-h"><span class="faint wt-focus-w"><i class="wt-focus-g" aria-hidden="true"></i>' + esc(focusWords(sn.focus)) + ' for this step</span></div>' : '') + '<div class="wt-snip-d" data-snip="' + esc(st.id) + ':' + i + '"></div></div>').join('') + '</details>'
     }).join('')
   const show = core || open
   const lines = st.snippets.reduce((a, s) => a + s.changed, 0)
@@ -191,7 +266,7 @@ function stepHtml(st, { esc, icon, done, cur, open, sid, sf = {}, skip = null, s
     : '<button type="button" class="wt-showc" data-action="wt-code" data-step="' + esc(st.id) + '" aria-expanded="false">' + icon('chevron-right') + 'Show code <span class="faint">· ' + plural(lines, 'line') + '</span></button>'
   // callouts whose line isn't in a drawn snippet (folded code) still read here
   const loose = !show && st.callouts.length ? '<div class="wt-cos">' + st.callouts.map((c) => calloutHtml(c, { esc, icon })).join('') + '</div>' : ''
-  return '<article class="wt-st ' + (core ? 'wt-core' : 'wt-sup') + (done ? ' done' : '') + (cur ? ' cur' : '') + '" id="wt-' + esc(st.id) + '" data-step="' + esc(st.id) + '" tabindex="-1" aria-label="' + esc('Step ' + st.n + ': ' + mdPlain(st.title)) + '">' + head + why + loose + code + '</article>'
+  return '<article class="wt-st ' + (core ? 'wt-core' : 'wt-sup') + (done ? ' done' : '') + (cur ? ' cur' : '') + '" id="wt-' + esc(st.id) + '" data-step="' + esc(st.id) + '" tabindex="-1" aria-label="' + esc('Step ' + st.n + ': ' + mdPlain(st.title)) + '">' + head + why + stepDecisionsHtml(st, data, { esc }) + loose + code + '</article>'
 }
 
 function groupHtml(g, { esc, icon, open, data = null }) {
@@ -334,6 +409,8 @@ function modeSegHtml(show, split) {
 // "3 files changed since this walkthrough · Update"
 export function staleWords(st) {
   if (!st) return ''
+  // 2026-11-03 a decision it cites has changed (superseded, rejected or edited) since it was written
+  if (Array.isArray(st.decisions) && st.decisions.length && !st.count) return (st.decisions.length === 1 ? 'Decision ' + st.decisions[0] + ' has' : 'Decisions ' + st.decisions.join(', ') + ' have') + ' changed since this walkthrough'
   if (st.count == null) return 'The change has moved on since this walkthrough'
   if (!st.count) return 'The change has moved on since this walkthrough'
   return st.count + (st.count === 1 ? ' file changed' : ' files changed') + ' since this walkthrough'
@@ -371,9 +448,10 @@ export function walkthroughHtml({ s, data, ui, reviewed = new Set(), esc, icon,
     exportsHtml(ok, ui, { icon }) + '</div>' +
     '<button type="button" class="wt-x" data-action="wt-close" data-id="' + esc(sid) + '" aria-label="Close the walkthrough">' + icon('x') + '</button></div>'
   // 2026-10-30 the reading tools, a slim second row of the toolbar (the first stays one row): Next spot, Unified / Split
-  const tools = spotBtnHtml(ok && view === 'story' ? spotsFor(data, readingOrder(data.steps, data)).length : 0, ui.spot, { icon }) +
+  // 2026-11-03 This session · Whole folder, at the top of the story and the Files list alike
+  const tools = fileScopeSegHtml(data && data.fileScope, { esc, icon, action: 'wt-files', busy: !!ui.loading }) + spotBtnHtml(ok && view === 'story' ? spotsFor(data, readingOrder(data.steps, data)).length : 0, ui.spot, { icon }) +
     modeSegHtml(ok || (data && Array.isArray(data.files) && data.files.length), ui.split)
-  if (tools) h += '<div class="wt-r2" role="toolbar" aria-label="Reading tools">' + tools + '</div>'
+  if (tools) h += '<div class="wt-r2" role="toolbar" aria-label="Which changes and reading tools">' + tools + '</div>'
   // which model wrote it (Settings → Models → Walk me through it picks it)
   // the session's own agent couldn't (a Codex session, no transcript here, it didn't answer): said quietly, the reason in the tip
   if (ok) h += '<p class="faint wt-by">Written by ' + (data.modelLabel ? esc(data.modelLabel) : 'your summarizer') + (data.unavailable ? ' (Claude unavailable: ' + esc(data.unavailable) + ')' : '') + (when ? ' · ' + esc(when) : '') +
@@ -394,6 +472,8 @@ export function walkthroughHtml({ s, data, ui, reviewed = new Set(), esc, icon,
     // a small local model (under 7B) is the likely reason: one quiet line pointing at a better one
     if (data.status === 'fallback' && data.small) h += '<p class="faint wt-small">' + icon('info') + '<span>Small local models struggle here. Try Claude or qwen2.5-coder 7B in <a href="#/settings/models">Settings</a>.</span></p>'
   }
+  // 2026-11-03 switched to the other scope with nothing written for it: never a model run on its own; Write it is one tap
+  if (data && !ui.loading && data.status === 'none' && view === 'story') h += '<p class="wt-stale" role="status"><i class="wt-chg-g" aria-hidden="true"></i><span>' + (data.fileScope && data.fileScope.key === 'folder' ? 'No walkthrough of the whole folder yet.' : 'No walkthrough of this session’s changes yet.') + ' The files are under Files.</span><button type="button" class="linkish wt-upd" data-action="wt-update" data-id="' + esc(sid) + '">' + icon('refresh-cw') + 'Write it</button></p>'
   const deck = ok && view === 'story' && ui.deck !== false && (data.steps || []).length > 0 // 0.9.18 the slideshow
   if (ok && view === 'story' && !deck) {
     const steps = data.steps || []
@@ -418,7 +498,8 @@ export function walkthroughHtml({ s, data, ui, reviewed = new Set(), esc, icon,
     const vis = new Set(visibleSteps(steps, ui.filter).map((x) => x.id))
     const core = steps.filter((x) => x.tag === 'Core' && vis.has(x.id)), sup = steps.filter((x) => x.tag !== 'Core' && vis.has(x.id))
     const bd = data.stats.breakdown || {}
-    const one = (st) => stepHtml(st, { esc, icon, done: reviewed.has(st.id), cur: ui.cur === st.id, open: ui.open && ui.open.has(st.id), sid, sf: ui.sf || {}, skip: skipFiles(data), stat: statusMap(data) })
+    const shared = sharedSnips(data), skip = skipFiles(data), stat = statusMap(data)
+    const one = (st) => stepHtml(st, { esc, icon, done: reviewed.has(st.id), cur: ui.cur === st.id, open: ui.open && ui.open.has(st.id), sid, sf: ui.sf || {}, skip, stat, shared, data })
     const repos = walkRepos(data)
     // 2026-10-29 several repos: one section per repo (its header with counts), its steps in reading order
     if (repos.length) {
@@ -444,6 +525,7 @@ export function walkthroughHtml({ s, data, ui, reviewed = new Set(), esc, icon,
   }
   let fl = ''
   if (!(ok && view === 'story') && data && Array.isArray(data.files) && data.files.length && !ui.loading) {
+    if (ok || !data.message) body += unreadableHtml(data, { esc, icon }) // 2026-11-03 what the scope left out, or the no-snapshot note
     if (data.files.length > 1) { fl = filesListHtml(data, { esc, icon }); body += filesListHtml(data, { esc, icon, mobile: true }) }
     body += filesHtml(data.files, { esc, icon })
   }
@@ -474,6 +556,7 @@ export function deckSlides(data, ui = {}) {
 function deckHtml(data, ui, { esc, icon, reviewed, sid }) {
   const { slides, cur } = deckSlides(data, ui)
   const steps = data.steps || []
+  const shared = sharedSnips(data)
   const total = slides.length
   const sec = (i, inner, label, extra = '') => '<section class="wt-slide' + (i === cur ? ' on' : '') + '" data-slide="' + i + '"' + extra + ' role="group" aria-roledescription="slide" aria-label="' + esc(label) + '"' + (i === cur ? '' : ' hidden') + '>' + inner + '</section>'
   let h = '<div class="wt-deck" id="wtDeck" data-cur="' + cur + '" data-n="' + total + '" tabindex="-1" aria-roledescription="slideshow" aria-label="Walkthrough slides">'
@@ -504,7 +587,7 @@ function deckHtml(data, ui, { esc, icon, reviewed, sid }) {
   slides.forEach((s, i) => {
     if (s.kind === 'step') {
       const x = s.step
-      h += sec(i, stepHtml(x, { esc, icon, done: reviewed.has(x.id), cur: false, open: true, sid, sf: ui.sf || {}, skip: skipFiles(data), stat: statusMap(data) }), 'Step ' + x.n + ' of ' + steps.length + ': ' + mdPlain(x.title), ' data-step="' + esc(x.id) + '"')
+      h += sec(i, stepHtml(x, { esc, icon, done: reviewed.has(x.id), cur: false, open: true, sid, sf: ui.sf || {}, skip: skipFiles(data), stat: statusMap(data), shared, foldShared: false /* a slide shows one step: the earlier one isn't on screen */, data }), 'Step ' + x.n + ' of ' + steps.length + ': ' + mdPlain(x.title), ' data-step="' + esc(x.id) + '"')
     } else if (s.kind === 'skip') {
       const groups = data.groups || []
       const n = groups.reduce((a, g) => a + g.files.length + (g.kind === 'repeated' ? 1 : 0), 0), l = groups.reduce((a, g) => a + g.lines, 0)
@@ -557,18 +640,63 @@ export function filesHtml(files, { esc, icon }) {
   const open = files.length <= 10
   return '<div class="wt-files-v">' + files.map((f, i) => {
     const what = f.hidden ? 'not shown (keys and env files never are)' : f.binary ? 'binary file' : f.generated ? 'generated or lockfile · ' + plural(f.add + f.del, 'line') : !f.lines ? (f.status === 'renamed' ? 'renamed, nothing changed inside' : 'no lines changed') : ''
-    return '<details class="wt-file" id="wt-f-' + i + '" data-file-i="' + i + '"' + (open && !what ? ' open' : '') + '><summary>' + icon('chevron-right', 'ic wt-g-chev') + statusHtml(f, { esc, icon }) + '<span class="mono wt-file-p">' + esc(f.repo && String(f.path).startsWith(f.repo + '/') ? f.repo + ' · ' + f.path.slice(f.repo.length + 1) : f.path) + '</span>' + (f.oldPath ? '<span class="faint wt-file-o">from ' + esc(f.oldPath) + '</span>' : '') +
+    return '<details class="wt-file' + (f.notSession ? ' nots' : '') + '" id="wt-f-' + i + '" data-file-i="' + i + '"' + (open && !what ? ' open' : '') + '><summary>' + icon('chevron-right', 'ic wt-g-chev') + statusHtml(f, { esc, icon }) + '<span class="mono wt-file-p">' + esc(f.repo && String(f.path).startsWith(f.repo + '/') ? f.repo + ' · ' + f.path.slice(f.repo.length + 1) : f.path) + '</span>' + (f.oldPath ? '<span class="faint wt-file-o">from ' + esc(f.oldPath) + '</span>' : '') + scopeTagHtml(f, { esc }) +
       '<span class="wt-file-n"><span class="wt-add">+' + n0(f.add) + '</span> <span class="wt-del">−' + n0(f.del) + '</span></span></summary>' +
       (what ? '<p class="faint wt-g-p">' + esc(what) + '</p>' : '<div class="wt-snip-d" data-file="' + i + '"></div>' + (f.clipped ? '<p class="faint wt-g-p">… too big to show all of it here</p>' : '')) + '</details>'
   }).join('') + '</div>'
 }
+// 2026-11-03 (asked: "should Files/Ask be scoped too? Or should it be a toggle?") Which files the
+// walkthrough, its Files view, What it did and Ask cover: This session (the default, only what the
+// session changed) or Whole folder (everything uncommitted, the rest marked "not from this
+// session"). The daemon cuts both the same way (Engine#scopeDiff); the choice is kept on this device.
+export const FILE_SCOPE_KEY = 'lo-file-scope'
+export function fileScopeStore(storage) {
+  return {
+    get() { try { return storage && storage.getItem(FILE_SCOPE_KEY) === 'folder' ? 'folder' : 'session' } catch { return 'session' } },
+    set(v) { try { if (!storage) return; if (v === 'folder') storage.setItem(FILE_SCOPE_KEY, 'folder'); else storage.removeItem(FILE_SCOPE_KEY) } catch {} },
+  }
+}
+// "This session 4 · Whole folder 24": a segmented toggle with each side's count. fs: the daemon's
+// { key, session, folder } (none from an older Mac, or with the snapshot rule off: no toggle).
+export function fileScopeSegHtml(fs, { esc, icon, action = 'wt-files', busy = false } = {}) {
+  if (!fs || typeof fs !== 'object' || fs.session == null || fs.folder == null) return ''
+  const key = fs.key === 'folder' ? 'folder' : 'session'
+  const n = (v) => '<span class="fsc-n" aria-hidden="true">' + esc(Number(v) || 0) + '</span>'
+  const one = (k, label, cnt, tip) => '<button type="button" data-action="' + esc(action) + '" data-files="' + k + '" aria-pressed="' + (key === k) + '" aria-label="' + esc(label + ', ' + (Number(cnt) || 0) + ' file' + (Number(cnt) === 1 ? '' : 's')) + '" data-tip="' + esc(tip) + '"' + (busy ? ' disabled' : '') + '>' + label + ' ' + n(cnt) + '</button>'
+  return '<div class="wt-seg wt-seg-sm fsc-seg" role="group" aria-label="Which changes">' +
+    one('session', 'This session', fs.session, 'Only what this session changed') +
+    one('folder', 'Whole folder', fs.folder, 'Everything uncommitted in the folder, other sessions’ changes too') + '</div>'
+}
+// The context line Ask puts above a question: "This session’s changes (4 files)" / "Whole folder (24 files)"
+export function scopeAskLine(data) {
+  const fs = data && data.fileScope
+  if (!fs || fs.session == null || fs.folder == null) return ''
+  const folder = fs.key === 'folder'
+  const k = Number(folder ? fs.folder : fs.session) || 0
+  const files = k + ' file' + (k === 1 ? '' : 's')
+  return folder ? 'Whole folder (' + files + ')' : 'This session’s changes (' + files + ')'
+}
+// the quiet per-file words: not from this session (Whole folder), or changed before it too
+export function scopeTagWords(f) {
+  if (!f) return ''
+  if (f.notSession) return 'not from this session'
+  if (f.preDirty === 'start') return 'only this session’s change'
+  if (f.preDirty === 'whole') return 'changed before this session too'
+  if (f.preDirty === 'before') return 'has changes from before this session'
+  return ''
+}
+export function scopeTagHtml(f, { esc }) {
+  const w = scopeTagWords(f)
+  if (!w) return ''
+  return f.notSession ? '<span class="wt-nots" data-tip="Changed in this folder, but not by this session"><i class="nots-g" aria-hidden="true"></i>not from this session</span>' : '<span class="wt-pre faint">' + esc(w) + '</span>'
+}
 // 0.9.18 (Joel): the Files view's list of files, beside the diff on a wide screen (each
 // scrolls on its own) and folded above it on a phone. Folders like the file map;
 // each file with its status by shape and its +/− count; a click opens that file's diff.
 function flFileHtml(it, { esc, icon, depth }) {
   const f = it.f
-  return '<a class="wt-fm-i wt-fl-i" href="#" data-action="wt-file" data-i="' + it.i + '"' + (depth ? ' data-d="' + Math.min(depth, 6) + '"' : '') + ' aria-label="' + esc(f.path + ', ' + statusWord(f).toLowerCase() + ', ' + f.add + ' added, ' + f.del + ' removed') + '">' +
-    statusHtml(f, { esc, icon }) + '<span class="wt-fm-f">' + esc(it.base) + '</span><span class="wt-fl-n" aria-hidden="true"><span class="wt-add">+' + n0(f.add) + '</span><span class="wt-del">−' + n0(f.del) + '</span></span></a>'
+  return '<a class="wt-fm-i wt-fl-i' + (f.notSession ? ' nots' : '') + '" href="#" data-action="wt-file" data-i="' + it.i + '"' + (depth ? ' data-d="' + Math.min(depth, 6) + '"' : '') + ' aria-label="' + esc(f.path + ', ' + statusWord(f).toLowerCase() + ', ' + f.add + ' added, ' + f.del + ' removed' + (scopeTagWords(f) ? ', ' + scopeTagWords(f) : '')) + '"' + (f.notSession ? ' data-tip="Not from this session"' : '') + '>' +
+    statusHtml(f, { esc, icon }) + '<span class="wt-fm-f">' + esc(it.base) + '</span>' + (f.notSession ? '<i class="nots-g" aria-hidden="true"></i>' : '') + '<span class="wt-fl-n" aria-hidden="true"><span class="wt-add">+' + n0(f.add) + '</span><span class="wt-del">−' + n0(f.del) + '</span></span></a>'
 }
 export function filesListHtml(data, { esc, icon, mobile = false }) {
   const files = (data && data.files) || []
@@ -597,7 +725,7 @@ export function hydrateWalkthrough(root, data, { renderDiff, renderSplit = null,
   if (!cache) { cache = new Map(); drawnFor.set(data, cache) }
   const doc = root.ownerDocument
   const sp = !!(split && renderSplit)
-  const draw = (key, patch, label, callouts) => {
+  const draw = (key, patch, label, callouts, focus = null) => {
     const ck = (sp ? 'S|' : 'U|') + key
     let node = cache.get(ck)
     if (!node) {
@@ -609,6 +737,15 @@ export function hydrateWalkthrough(root, data, { renderDiff, renderSplit = null,
       node.classList.add('wt-gd')
       node.dataset.wtk = key
       for (const g of node.querySelectorAll('.gd-gap')) g.remove()
+      // 2026-11-03 the lines this step's refs name, when it shows a hunk whole (a new file two steps share)
+      for (const f of Array.isArray(focus) ? focus : []) {
+        const sel = f.side === 'old' ? '.gd-o' : '.gd-n'
+        for (const el of node.querySelectorAll(sp ? '.gd-half' : '.gd-row')) {
+          const x = el.querySelector(sel), v = x && x.textContent !== '' ? Number(x.textContent) : NaN
+          if (v >= f.from && v <= f.to) el.classList.add('wt-focus')
+        }
+      }
+      if (Array.isArray(focus) && focus.length) node.classList.add('wt-gd-focus')
       for (const c of callouts || []) {
         const sel = c.side === 'old' ? '.gd-o' : '.gd-n'
         let row = null
@@ -640,8 +777,10 @@ export function hydrateWalkthrough(root, data, { renderDiff, renderSplit = null,
     const [sid, i] = slot.getAttribute('data-snip').split(':')
     const st = (data.steps || []).find((x) => x.id === sid)
     const sn = st && st.snippets[+i]
-    if (!sn) continue
-    slot.appendChild(draw('s:' + sid + ':' + i, sn.patch, 'Changes in ' + sn.file, st.callouts.filter((c) => c.hunk === sn.hunk))); k++
+    if (!sn) { slot.innerHTML = '<p class="faint wt-snip-none">No lines to show here.</p>'; continue } // never an empty row
+    const node = draw('s:' + sid + ':' + i, sn.patch, 'Changes in ' + sn.file, st.callouts.filter((c) => c.hunk === sn.hunk), sn.focus)
+    if (node.isConnected && root.contains(node) && !slot.contains(node)) { slot.appendChild(node.cloneNode(true)); k++; continue } // shown in another slot on this page: a copy, never moved out of it
+    slot.appendChild(node); k++
   }
   for (const slot of root.querySelectorAll('[data-group-ex]')) {
     if (slot.firstChild) continue
@@ -691,6 +830,7 @@ export function toMarkdown(data, { title = '' } = {}) {
     if (repos.length && st.repo && st.repo !== lastRepo) { lastRepo = st.repo; const r = repos.find((x) => x.label === st.repo); L.push(''); L.push('### ' + st.repo + (r ? ' (' + repoHeadWords(r, data.steps || []) + ')' : '')) }
     L.push(''); L.push((repos.length ? '#### ' : '### ') + st.n + '. ' + st.title + ' (' + st.tag + ')'); L.push('')
     if (st.why) L.push(st.why)
+    if (Array.isArray(st.decisions) && st.decisions.length) { const by = decisionsOf(data); L.push(''); L.push('Decisions: ' + st.decisions.map((id) => decWord(st, id, by.get(id)) + '`' + id + '`' + (by.get(id) ? ' ' + by.get(id).text : '')).join('; ')) } // 2026-11-03
     for (const c of st.callouts || []) { L.push(''); L.push('> **' + (CALLOUT[c.kind] || CALLOUT.look).word + '** (`' + pathLabel(c.file, data) + ':' + c.line + '`): ' + c.text) }
     for (const sn of st.snippets || []) {
       const fence = /```/.test(sn.patch) ? '~~~~' : '```'
@@ -703,6 +843,7 @@ export function toMarkdown(data, { title = '' } = {}) {
     for (const g of groups) L.push('- ' + g.title + (g.note ? ' (' + g.note + ')' : '') + ': ' + plural(g.files.length + (g.kind === 'repeated' ? 1 : 0), 'file') + ', ' + plural(g.lines, 'line'))
   }
   if (data.coverage) { L.push(''); L.push('_Every changed line is in a step or a group: ' + n0(data.coverage.covered) + ' of ' + n0(data.coverage.total) + '._') }
+  if (Array.isArray(data.decisions) && data.decisions.length) { L.push(''); L.push('### Decisions cited'); L.push(''); for (const d of data.decisions) L.push('- `' + d.id + '` ' + d.text + (d.why ? ' (' + d.why + ')' : '')) }
   return L.join('\n') + '\n'
 }
 
@@ -721,7 +862,7 @@ export function staticDiffHtml(patch, callouts = []) {
   }
   return h + '</div>'
 }
-const EXPORT_CSS = 'body{margin:0;background:#fff;color:#1f2328;font:15px/1.5 -apple-system,BlinkMacSystemFont,"Segoe UI",system-ui,sans-serif}main{max-width:900px;margin:0 auto;padding:32px 20px 64px}h1{font-size:22px;margin:0 0 4px}h2{font-size:17px;margin:32px 0 6px}.f{color:#59636e;font-size:13px}.sum{font-size:15px}.tag{display:inline-flex;align-items:center;height:20px;padding:0 8px;border:1px solid #d1d9e0;border-radius:999px;font-size:12px;line-height:1;margin-left:8px;vertical-align:2px}.tag.core{font-weight:700;border-width:2px}.fl{font:12px ui-monospace,SFMono-Regular,Menlo,monospace;color:#59636e;margin:10px 0 4px}.d{border:1px solid #d1d9e0;border-radius:6px;overflow:hidden;font:12px/1.5 ui-monospace,SFMono-Regular,Menlo,monospace}.r{display:grid;grid-template-columns:44px 44px 18px 1fr}.g{color:#59636e;text-align:right;padding:0 6px;user-select:none}.m{text-align:center}.c{white-space:pre-wrap;word-break:break-word;padding-right:8px}.r.h{background:#ddf4ff;color:#59636e}.r.add{background:#e6ffec}.r.add .g{background:#ccffd8}.r.del{background:#ffebe9}.r.del .g{background:#ffd7d5}.r.mark .g:first-child{box-shadow:inset 3px 0 0 #1f2328}.co{margin:4px 8px 6px 106px;padding:6px 10px;border:1px solid #1f2328;border-radius:6px;font:13px/1.45 -apple-system,system-ui,sans-serif;white-space:normal}.co.assumption{border-style:dotted}.co.untested{border-style:dashed}.co b{margin-right:6px}.loose .co{margin-left:0}details{margin:8px 0}summary{cursor:pointer}ul{padding-left:20px}code{font:.86em ui-monospace,SFMono-Regular,Menlo,monospace;background:#f6f8fa;border:1px solid #d1d9e0;border-radius:5px;padding:0 4px;overflow-wrap:break-word;word-break:normal;-webkit-box-decoration-break:clone;box-decoration-break:clone}h2 code{font-size:.84em}.why{margin:8px 0 12px;overflow-wrap:break-word}.why p{margin:0 0 8px}.why :is(ul,ol){margin:0 0 8px;padding-left:20px}.why li{margin:2px 0}.why h2,.why h3,.why h4,.why h5,.why h6{font-size:1em;margin:10px 0 4px}.why blockquote{margin:0 0 8px;padding-left:10px;border-left:3px solid #d1d9e0}.why pre{margin:0 0 8px;overflow-x:auto;background:#f6f8fa;border:1px solid #d1d9e0;border-radius:6px;padding:8px 10px;font:12px/1.45 ui-monospace,SFMono-Regular,Menlo,monospace}.why pre code{background:none;border:0;padding:0;font-size:inherit;overflow-wrap:normal;word-break:normal}.co code{font-size:.84em}a{color:#0969da;overflow-wrap:anywhere}.u{overflow-wrap:anywhere}.tk-c{color:#59636e}.tk-s{color:#0a3069}.tk-k{color:#cf222e}.tk-n{color:#0550ae}.tk-add{color:#116329}.tk-del{color:#82071e}@media print{.why pre{white-space:pre-wrap}code{background:none}}@media (prefers-color-scheme:dark){body{background:#0d1117;color:#e6edf3}code,.why pre{background:#161b22;border-color:#3d444d}.why blockquote{border-color:#3d444d}a{color:#4493f8}.tk-c{color:#9198a1}.tk-s{color:#a5d6ff}.tk-k{color:#ff7b72}.tk-n{color:#79c0ff}.tk-add{color:#7ee787}.tk-del{color:#ffa198}.f,.g,.fl{color:#9198a1}.d,.tag{border-color:#3d444d}.r.h{background:#121d2f}.r.add{background:#12261e}.r.add .g{background:#1b4721}.r.del{background:#25171c}.r.del .g{background:#542426}.co,.r.mark .g:first-child{border-color:#e6edf3;box-shadow:inset 3px 0 0 #e6edf3}}'
+export const EXPORT_CSS = 'body{margin:0;background:#fff;color:#1f2328;font:15px/1.5 -apple-system,BlinkMacSystemFont,"Segoe UI",system-ui,sans-serif}main{max-width:900px;margin:0 auto;padding:32px 20px 64px}h1{font-size:22px;margin:0 0 4px}h2{font-size:17px;margin:32px 0 6px}.f{color:#59636e;font-size:13px}.sum{font-size:15px}.tag{display:inline-flex;align-items:center;height:20px;padding:0 8px;border:1px solid #d1d9e0;border-radius:999px;font-size:12px;line-height:1;margin-left:8px;vertical-align:2px}.tag.core{font-weight:700;border-width:2px}.fl{font:12px ui-monospace,SFMono-Regular,Menlo,monospace;color:#59636e;margin:10px 0 4px}.d{border:1px solid #d1d9e0;border-radius:6px;overflow:hidden;font:12px/1.5 ui-monospace,SFMono-Regular,Menlo,monospace}.r{display:grid;grid-template-columns:44px 44px 18px 1fr}.g{color:#59636e;text-align:right;padding:0 6px;user-select:none}.m{text-align:center}.c{white-space:pre-wrap;word-break:break-word;padding-right:8px}.r.h{background:#ddf4ff;color:#59636e}.r.add{background:#e6ffec}.r.add .g{background:#ccffd8}.r.del{background:#ffebe9}.r.del .g{background:#ffd7d5}.r.mark .g:first-child{box-shadow:inset 3px 0 0 #1f2328}.co{margin:4px 8px 6px 106px;padding:6px 10px;border:1px solid #1f2328;border-radius:6px;font:13px/1.45 -apple-system,system-ui,sans-serif;white-space:normal}.co.assumption{border-style:dotted}.co.untested{border-style:dashed}.co b{margin-right:6px}.loose .co{margin-left:0}details{margin:8px 0}summary{cursor:pointer}ul{padding-left:20px}code{font:.86em ui-monospace,SFMono-Regular,Menlo,monospace;background:#f6f8fa;border:1px solid #d1d9e0;border-radius:5px;padding:0 4px;overflow-wrap:break-word;word-break:normal;-webkit-box-decoration-break:clone;box-decoration-break:clone}h2 code{font-size:.84em}.why{margin:8px 0 12px;overflow-wrap:break-word}.why p{margin:0 0 8px}.why :is(ul,ol){margin:0 0 8px;padding-left:20px}.why li{margin:2px 0}.why h2,.why h3,.why h4,.why h5,.why h6{font-size:1em;margin:10px 0 4px}.why blockquote{margin:0 0 8px;padding-left:10px;border-left:3px solid #d1d9e0}.why pre{margin:0 0 8px;overflow-x:auto;background:#f6f8fa;border:1px solid #d1d9e0;border-radius:6px;padding:8px 10px;font:12px/1.45 ui-monospace,SFMono-Regular,Menlo,monospace}.why pre code{background:none;border:0;padding:0;font-size:inherit;overflow-wrap:normal;word-break:normal}.co code{font-size:.84em}a{color:#0969da;overflow-wrap:anywhere}.u{overflow-wrap:anywhere}.tk-c{color:#59636e}.tk-s{color:#0a3069}.tk-k{color:#cf222e}.tk-n{color:#0550ae}.tk-add{color:#116329}.tk-del{color:#82071e}@media print{.why pre{white-space:pre-wrap}code{background:none}}@media (prefers-color-scheme:dark){body{background:#0d1117;color:#e6edf3}code,.why pre{background:#161b22;border-color:#3d444d}.why blockquote{border-color:#3d444d}a{color:#4493f8}.tk-c{color:#9198a1}.tk-s{color:#a5d6ff}.tk-k{color:#ff7b72}.tk-n{color:#79c0ff}.tk-add{color:#7ee787}.tk-del{color:#ffa198}.f,.g,.fl{color:#9198a1}.d,.tag{border-color:#3d444d}.r.h{background:#121d2f}.r.add{background:#12261e}.r.add .g{background:#1b4721}.r.del{background:#25171c}.r.del .g{background:#542426}.co,.r.mark .g:first-child{border-color:#e6edf3;box-shadow:inset 3px 0 0 #e6edf3}}'
 // ONE self-contained file: inline CSS, the snippets baked in, no scripts, no links out.
 // 0.9.18 a deck, like the board's: an overview, then one slide per step, then Safe to
 // skip. Without a script: one radio per slide (hidden, still focusable, so ← / → move
@@ -748,6 +889,7 @@ export function toHtmlDoc(data, { title = '', repo = '', when = '' } = {}) {
   const agHead = (s) => { if (!repos.length || !s.st || !s.st.repo || s.st.repo === agRepo) return ''; agRepo = s.st.repo; const r = repos.find((x) => x.label === s.st.repo); return '<li class="rh"><h3>' + escH(s.st.repo) + (r ? ' <span class="f">· ' + repoHeadWords(r, steps) + '</span>' : '') + '</h3></li>' }
   o += '<h2>Reading order</h2><ol class="ag">' + slides.map((s, i) => i === 0 ? '' : agHead(s) + '<li><label for="s' + i + '">' + (s.st ? s.st.n + '. ' : '') + walkInline(s.t) + (s.st ? ' <span class="tag ' + (s.st.tag === 'Core' ? 'core' : '') + '">' + escH(s.st.tag) + '</span>' : '') + '</label></li>').join('') + '</ol>'
   if (data.coverage) o += '<p class="f">Every changed line is in a step or a group: ' + n0(data.coverage.covered) + ' of ' + n0(data.coverage.total) + '.</p>'
+  if (Array.isArray(data.decisions) && data.decisions.length) o += '<h2>Decisions cited</h2><ul>' + data.decisions.map((d) => '<li><code>' + escH(d.id) + '</code> ' + escH(d.text) + (d.why ? ' <span class="f">(' + escH(d.why) + ')</span>' : '') + '</li>').join('') + '</ul>' // 2026-11-03
   b += '<section class="sl" data-i="0">' + o + nav(0) + '</section>'
   slides.forEach((s, i) => {
     if (!i) return
@@ -756,6 +898,7 @@ export function toHtmlDoc(data, { title = '', repo = '', when = '' } = {}) {
       const st = s.st
       if (repos.length && st.repo) { const r = repos.find((y) => y.label === st.repo); x += '<h3 class="rp">' + escH(st.repo) + (r ? ' <span class="f">· ' + repoHeadWords(r, steps) + '</span>' : '') + '</h3>' } // 2026-10-29 the step's repo
       x += '<h2>' + st.n + '. ' + walkInline(st.title) + '<span class="tag ' + (st.tag === 'Core' ? 'core' : '') + '">' + escH(st.tag) + '</span></h2>' + (st.why ? '<div class="why">' + walkBlock(st.why, { exported: true }) + '</div>' : '')
+      if (Array.isArray(st.decisions) && st.decisions.length) { const by = decisionsOf(data); x += '<p class="f decs">Decisions: ' + st.decisions.map((id) => escH(decWord(st, id, by.get(id))) + '<code>' + escH(id) + '</code>' + (by.get(id) ? ' ' + escH(by.get(id).text) : '')).join('; ') + '</p>' } // 2026-11-03
       const drawn = new Set()
       for (const sn of st.snippets || []) {
         const cs = (st.callouts || []).filter((c) => c.hunk === sn.hunk)

package/ui/session-catchup.js

@@ -29,17 +29,33 @@ export function sessionCatchupHtml(ui, { esc, icon = () => '', sid = '' } = {})
     : '<ul class="scu-body scu-list">' + body.map((_, i) => '<li data-scu="b-' + i + '"></li>').join('') + '</ul>'
   return '<div class="scu" role="region" aria-label="Catch me up">' + head('<span class="scu-when" data-scu="when"></span>') +
     (goal ? '<p class="scu-goal" data-scu="goal"></p>' : '') +
-    text + (next != null ? '<p class="scu-next" data-scu="next"></p>' : '') +
+    text + (next != null ? '<p class="scu-next" data-scu="next"></p>' : '') + recapDecisionsHtml(ui.data, { esc }) +
     '<div class="msg-foot"><p class="scu-by" data-scu="by"></p>' + copyButtonHtml(recapSource(ui.data), { deferred: true }) + '</div></div>'
 }
 
+// testplan Part 2: what the session decided since you looked, each with its word in the log (shape plus word).
+const DEC_SHAPE = { proposed: '◌', accepted: '●', rejected: '✕', superseded: '↻', unlogged: '·' }
+const DEC_WORD = { proposed: 'Proposed', accepted: 'Accepted', rejected: 'Rejected', superseded: 'Superseded', unlogged: 'Not in the log' }
+export function recapDecisionsHtml(d, { esc }) {
+  const list = (d && Array.isArray(d.decisions) ? d.decisions : []).filter((x) => x && x.text)
+  if (!list.length) return ''
+  const sinceWord = d && d.recap && d.recap.since ? 'Decided since you looked' : 'Decided in this session'
+  return '<div class="scu-decs"><h3 class="scu-dec-h">' + esc(sinceWord) + '</h3><ul class="scu-dec-l">' + list.map((x) =>
+    '<li><span class="dec-st dec-st-' + esc(x.status) + '"><span aria-hidden="true">' + (DEC_SHAPE[x.status] || '·') + '</span> ' + esc(DEC_WORD[x.status] || x.status) + '</span> ' +
+    (x.id ? '<span class="dec-id">' + esc(x.id) + '</span> ' : '') + '<span class="dec-text">' + esc(x.text) + '</span>' + (x.supersededBy ? ' <span class="faint">→ ' + esc(x.supersededBy) + '</span>' : '') + '</li>').join('') + '</ul></div>'
+}
+export function recapDecisionsText(d) {
+  const list = (d && Array.isArray(d.decisions) ? d.decisions : []).filter((x) => x && x.text)
+  return list.length ? 'Decided:\n' + list.map((x) => '- ' + (x.id ? x.id + ' ' : '') + x.text + ' (' + (DEC_WORD[x.status] || x.status).toLowerCase() + ')').join('\n') : ''
+}
+
 // 0.9.11: what Copy takes from a recap, as markdown: the goal, the lines as a
 // list (or a sentence or two, as shown), and the Next line.
 export function recapSource(d) {
   const { body, next } = recapParts(d)
   const goal = recapGoal(d)
   const text = body.length <= 2 ? body.join(' ') : body.map((b) => '- ' + b).join('\n')
-  return [goal, text, next].filter((x) => x && String(x).trim()).join('\n\n')
+  return [goal, text, next, recapDecisionsText(d)].filter((x) => x && String(x).trim()).join('\n\n')
 }
 
 // The recap's lines: what happened, and the one "Next: …" / "Up to you…" /

package/ui/session-title.js

@@ -0,0 +1,88 @@
+// 2026-11-05 session titles: one helper for the name a session goes by
+// everywhere (session header, full screen's bar, cards, tabs, pickers).
+// Line one says what the session is doing; where it runs (folder@branch) is a
+// muted second line, never glued to the front of the name. Pure and
+// deterministic (no model call): a prompt used as a name is tidied the way a
+// person would write it as a title.
+
+export const TITLE_MAX = 60
+
+// "cube_cloud@me/some-branch · Please check…": where it runs, glued to the front
+// of a name by whatever named it. The folder and branch have a line of their own.
+const WHERE_GLUED = /^\s*[\w.~-]+@[\w./~+-]+\s*(?:·|•|\||—|–|:|-)\s+/
+// Words in front of a request that a title doesn't need.
+const FILLER = /^(?:(?:please|pls|plz|hey|hi|hello|yo|ok(?:ay)?|so|alright|now)\b[\s,!.:;-]*|(?:can|could|would|will) (?:you|u)(?: please| pls)?\s+|(?:i(?:'d| would) like you to|i (?:want|need) you to)\s+)/i
+// A title doesn't end on a word that leads into the next one.
+const DANGLING = /[\s,;:–—-]+(?:and|or|but|nor|the|a|an|to|of|for|with|without|in|on|at|from|by|into|onto|about|then|so|that|this|these|those|is|are|was|be|as|if|when|while|because|my|your|our|its|&|\+)$/i
+const URL_RE = /\bhttps?:\/\/[^\s<>()]+/gi
+const LONG_PATH = /(^|\s)(?:~|\.{1,2})?(?:\/[\w.@+-]+){3,}\/?/g
+
+const repoOf = (s) => (s && (s.repoLabel || s.repoName || (s.repo && s.repo.name))) || ''
+const branchOf = (s) => (s && (s.branch || (s.repo && s.repo.branch))) || ''
+
+// Where a session runs, as one short line: "folder@branch" (the folder alone
+// when the branch says the same or there is none). '' when unknown.
+export function whereLine(s, repo = repoOf(s)) {
+  const b = branchOf(s)
+  if (!repo) return b || ''
+  return b && b !== repo ? repo + '@' + b : repo
+}
+
+// A pasted link, as the few words it stands for: a GitHub pull request or issue
+// is "PR 408" / "issue 12", anything else its host.
+function urlWords(u) {
+  const m = u.match(/^https?:\/\/(?:www\.)?github\.com\/[^/\s]+\/[^/\s]+\/(pull|issues)\/(\d+)/i)
+  if (m) return (m[1].toLowerCase() === 'pull' ? 'PR ' : 'issue ') + m[2]
+  try { return new URL(u).host.replace(/^www\./, '') } catch { return '' }
+}
+
+// Cut at a word boundary: never mid-word, never on a dangling "and"/"the"/"to".
+// Text with no spaces to cut at (CJK, one long token) is cut by character.
+export function cutTitle(text, max = TITLE_MAX) {
+  let t = String(text == null ? '' : text).replace(/\s+/g, ' ').trim()
+  let cut = false
+  if (t.length > max) {
+    const room = t.slice(0, max)
+    const sp = room.lastIndexOf(' ')
+    t = /\s/.test(t[max]) ? room : sp > 0 ? room.slice(0, sp) : t.slice(0, max - 1)
+    cut = true
+  }
+  for (let i = 0; i < 4; i++) {
+    const before = t
+    t = t.replace(DANGLING, '').replace(/[\s,;:(\[{–—-]+$/, '')
+    if (t === before) break
+    cut = true
+  }
+  if (!t) return ''
+  return cut ? t.replace(/[.…]+$/, '') + '…' : t
+}
+
+// A first prompt as a title: its first real line, no greeting or "please",
+// links as what they point at, a capital first letter, cut cleanly.
+//   "Please checkout the PR 408 and then…" -> "Check out the PR 408…"
+export function promptTitleText(text, max = TITLE_MAX) {
+  let t = String(text == null ? '' : text).split('\n').map((l) => l.trim()).find(Boolean) || ''
+  t = t.replace(URL_RE, (u) => ' ' + urlWords(u) + ' ').replace(LONG_PATH, (m, pre) => pre + m.trim().split('/').filter(Boolean).pop())
+  t = t.replace(/\s+/g, ' ').trim()
+  for (let i = 0; i < 4; i++) { const n = t.replace(FILLER, ''); if (n === t || !n.trim()) break; t = n.trim() }
+  t = t.replace(/^checkout\s+(?=the\b|pr\b|#|branch\b)/i, 'Check out ')
+  t = t.replace(/^[\s,.:;!?–—-]+/, '')
+  t = cutTitle(t, max)
+  return t && !/^\S+\.\S/.test(t) ? t.charAt(0).toUpperCase() + t.slice(1) : t // a bare host stays as written
+}
+
+// A stored name, tidied for showing: where it runs comes off the front (it has
+// its own line). A name that came from a prompt (or carried a where prefix,
+// which only automatic names do) is tidied like a prompt; a name you or Claude
+// gave it is kept as written, only cut at a word if it is very long.
+export function displayTitle(title, { source = null, max = TITLE_MAX } = {}) {
+  let t = String(title == null ? '' : title).replace(/\s+/g, ' ').trim()
+  const glued = WHERE_GLUED.test(t) && t.replace(WHERE_GLUED, '').trim()
+  if (glued) t = glued
+  if (glued || source === 'prompt' || source === 'fallback') return promptTitleText(t, max) || t
+  return t.length > 2 * max ? cutTitle(t, 2 * max) : t
+}
+
+// Is this stored name only an automatic stand-in (where it runs + the first
+// prompt's words)? Then a generated name may replace it, as for a prompt name.
+export function isPlaceholderTitle(title) { return WHERE_GLUED.test(String(title || '')) }

package/ui/summary-examples.js

@@ -40,7 +40,7 @@ export const SUMMARY_EXAMPLES = {
 }
 export const LENGTH_CHOICES = [
   { key: 'short', label: 'Short', approx: '~300 tokens', blurb: 'Doing, Stopped at, Next. Three lines.' },
-  { key: 'informative', label: 'Informative', approx: '~700 tokens', blurb: 'Adds key decisions, open questions, files touched and why, and what didn’t work.', recommended: true },
+  { key: 'informative', label: 'Informative', approx: '~700 tokens', blurb: 'Adds approach notes, open questions, files touched and why, and what didn’t work.', recommended: true },
   { key: 'long', label: 'Long', approx: '~1500 tokens', blurb: 'Adds a narrative recap and the next 3 steps.' },
 ]
 
@@ -56,7 +56,7 @@ export function formatCheckpointText(cp, { indent = '' } = {}) {
     line(title + ':')
     items.forEach((x, i) => line((title === 'Next steps' ? '  ' + (i + 1) + '. ' : '  - ') + fmt(x)))
   }
-  list('Key decisions', cp.decisions)
+  list('Approach notes', cp.decisions)
   list('Open questions', cp.questions)
   list('Files touched', cp.files, (f) => (f.path || '') + (f.path && f.why ? ' — ' : '') + (f.why || ''))
   list('What didn’t work', cp.didntWork)