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

package/ui/live-view.js

@@ -7,6 +7,7 @@ import { statusView, elapsedText, ranWithoutAsking, isQueued } from './live-stat
 import { parseAttachedLines } from './attach.js'
 import { stripChannel } from './cp-text.js' // 0.9.9: the one Live-wrapper helper
 import { repoDisplay } from './repos.js' // one repo name everywhere
+import { displayTitle, promptTitleText, whereLine } from './session-title.js' // 2026-11-05 one title helper
 import { copyButtonHtml } from './copy-msg.js' // 0.9.11: Copy on Claude's messages
 
 const clip = (s, n) => { const t = String(s == null ? '' : s).replace(/\s+/g, ' ').trim(); return t.length > n ? t.slice(0, n - 1) + '…' : t }
@@ -51,10 +52,13 @@ export function pastEmptyText(s, v, { mac = 'this Mac' } = {}) {
 export function sessionTitle(s, { untitled = 'Untitled session' } = {}) {
   if (!s) return untitled
   const wrapped = isWrapped(s.title)
-  if (s.title && !wrapped) return s.title
+  // 2026-11-05: what the session is doing, tidied (ui/session-title.js); where
+  // it runs is sessionWhere's line, never glued to the front of the name
+  if (s.title && !wrapped) return displayTitle(s.title, { source: s.titleSource }) || s.title
   // No name yet (or a raw <channel …> one an earlier beta kept): the first
   // prompt's words, which another Mac's older Leftoff may have sent without a title.
-  const first = promptLine(s.firstPrompt) || (wrapped ? promptLine(s.title) : '')
+  const raw = promptRaw(s.firstPrompt) || (wrapped ? promptRaw(s.title) : '')
+  const first = raw ? promptTitleText(raw) || promptLine(raw) : ''
   if (first && (isLiveSession(s) || wrapped)) return first
   if (isLiveSession(s)) {
     const repo = repoShown(s) || null
@@ -66,6 +70,13 @@ export function sessionTitle(s, { untitled = 'Untitled session' } = {}) {
   return untitled
 }
 
+// The muted second line under a session's name: where it runs, "folder@branch"
+// ('' when the name already is just that, or nothing is known).
+export function sessionWhere(s) {
+  if (!s || titleIsWhere(s)) return ''
+  return whereLine(s, repoShown(s))
+}
+
 // Is the card's name just where it runs ("repo · branch")? Then the repo chip
 // under it would say the same thing twice.
 export function titleIsWhere(s) {
@@ -82,6 +93,11 @@ const isWrapped = (t) => /^\s*<channel\b/.test(String(t || ''))
 const NOISE_LINE = /^\s*<\/?(local-command-\w+|command-\w+|system-reminder|pasted_content)\b/
 // The first line of a prompt in its own words: no channel wrapper (even one
 // cut short), no system reminders; 60 characters at most.
+function promptRaw(text) {
+  let t = stripChannel(text).replace(/<system-reminder>[\s\S]*?(<\/system-reminder>|$)/g, '')
+  t = t.split('\n').map((l) => l.trim()).find((l) => l && !NOISE_LINE.test(l)) || ''
+  return t.replace(/\s+/g, ' ')
+}
 export function promptLine(text) {
   let t = stripChannel(text).replace(/<system-reminder>[\s\S]*?(<\/system-reminder>|$)/g, '')
   t = t.split('\n').map((l) => l.trim()).find((l) => l && !NOISE_LINE.test(l)) || ''
@@ -246,7 +262,8 @@ export function fullBarHtml(id, { esc, icon, pills = '', stop = '', retitle = ''
     // 0.9.18 phones: the nav as a drawer (ui/navrail.js); from 700px the rail is beside full screen and this hides
     '<button type="button" class="btn lf-menu" data-nav-drawer aria-label="Menu" aria-expanded="false" aria-controls="navDrawer" data-tip="Menu">' + icon('menu') + '</button>' +
     '<button type="button" class="btn live-fs-x" data-action="live-full-exit" data-id="' + esc(id) + '" aria-label="Back to the board" data-tip="Board">' + icon('chevron-left') + '</button>' + // 0.9.16 one layout: back is the board
-    glyph + '<h2 class="lf-title"></h2>' + retitle + '<div class="lf-pills">' + pills + '</div>' + stop +
+    // 2026-11-05: what it's doing, then folder@branch muted under it
+    glyph + '<div class="lf-tt"><h2 class="lf-title"></h2><span class="lf-where"></span></div>' + retitle + '<div class="lf-pills">' + pills + '</div>' + stop +
     // 0.9.15 the embedded terminal (ui/term.js): docked under full screen, which gets shorter
     '<button type="button" class="btn lf-term" data-term-toggle aria-label="Terminal" data-tip="Terminal (⌃`)">' + icon('terminal') + '</button></div>'
 }
@@ -309,7 +326,9 @@ export function entryHtml(m, { esc, ago, md, now = Date.now(), status = null, at
   const who = senderLabel(m)
   const title = m.from === 'you' ? senderTitle(m) : ''
   let body
+  const cmd = isCommandEntry(m)
   if (m.from === 'claude') body = '<div class="lv-text lv-md">' + (md ? md(m.text || '') : esc(m.text || '')) + '</div>'
+  else if (cmd) body = commandHtml(m, { esc })
   else if (m.from === 'you') {
     const a = messageAttachments(m)
     // 0.9.9 Queued: a long one folds to two lines; a tap opens it in place
@@ -335,6 +354,8 @@ export function entryHtml(m, { esc, ago, md, now = Date.now(), status = null, at
     // 0.9.11: Copy, once the reply is whole (none while it streams)
     const cp = m.done ? copyButtonHtml(m.text) : ''
     if (cp) foot += '<div class="msg-foot">' + cp + '</div>'
+  } else if (cmd && m.status && m.status.phase === 'replied') {
+    // ran: what it printed is the body's; nothing to add
   } else if (m.status && m.from === 'you' && isQueued(m.status)) {
     foot = queuedHtml(m, { esc, may })
   } else if (m.status) {
@@ -352,6 +373,16 @@ export function entryHtml(m, { esc, ago, md, now = Date.now(), status = null, at
   return '<li class="lv lv-' + esc(m.from) + (m.history ? ' lv-history' : '') + (queued ? ' lv-queued' : '') + '" data-key="' + esc(entryKey(m)) + '" data-sig="' + esc(sigHash(sig)) + '">' + head + body + foot + '</li>'
 }
 
+// A slash command sent from the board (ui/slash-commands.js; src/live-link.js sendCommand): the command
+// in mono, then what Claude Code printed, once the transcript shows it ran (settleCommands).
+export function isCommandEntry(m) { return !!m && m.from === 'you' && m.command === true }
+export function commandHtml(m, { esc }) {
+  const ran = !!(m.status && m.status.phase === 'replied')
+  const out = typeof m.out === 'string' ? m.out.trim() : ''
+  return '<div class="lv-text lv-cmd"><code>' + esc(m.text || '') + '</code></div>' +
+    (out ? '<pre class="lv-cmd-out">' + esc(out) + '</pre>' : ran ? '<div class="lv-cmd-out lv-cmd-done">Done</div>' : '')
+}
+
 // 0.9.15: an answer that is still the Stop hook's words, clipped by the mod (280 characters ending in "…")
 export function partialAnswer(m) { return !!(m && m.from === 'claude' && m.via === 'turn' && typeof m.text === 'string' && /…\s*$/.test(m.text)) }
 
@@ -548,7 +579,7 @@ export function threadHtml(msgs, opts) {
     // 0.9.14: Edit on the message; Retry on Claude's "stopped" card (or on the message, when it didn't arrive)
     const acts = m === tgt ? { retry: m.status.phase === 'failed', edit: true, busy } : null
     html += entryHtml(m, acts ? { ...opts, lvActs: acts } : opts)
-    if (m.status && !m.status.folded && !answered.has(m.id) && m.status.phase !== 'failed' && m.status.phase !== 'sent') {
+    if (m.status && !m.status.folded && !answered.has(m.id) && m.status.phase !== 'failed' && m.status.phase !== 'sent' && !isCommandEntry(m)) { // a command has no turn: what it printed is in its own bubble
       // the asks of this turn go before Claude's Working bubble: the answer that replaces it in place then lands after them, as on a fresh page
       html += upTo(next == null ? Infinity : next)
       html += pendingClaudeHtml(m, m === tgt ? { ...opts, lvActs: { retry: true, busy } } : opts)
@@ -647,7 +678,7 @@ export { ranWithoutAsking }
 // A content signature, to replace only the entries that changed (the time-ago
 // text is left out so a minute ticking over doesn't redraw a reply).
 function sigHash(s) { let h = 5381; for (let i = 0; i < s.length; i++) h = ((h << 5) + h + s.charCodeAt(i)) | 0; return (h >>> 0).toString(36) }
-export function entrySig(m) { return JSON.stringify([m.text, (m.attachments || []).map((a) => a.id), m.state, m.status && [m.status.phase, m.status.tool, m.status.waiting, (m.status.ran || []).length, m.status.endedAt, m.status.folded || null, !!m.status.queued, !!m.status.cancellable, !!m.status.sendNow], m.done, m.ranWithoutAsking, m.ranWhy || null, m.errorText, m.via === 'turn' ? 1 : 0]) }
+export function entrySig(m) { return JSON.stringify([m.text, m.out == null ? null : m.out, (m.attachments || []).map((a) => a.id), m.state, m.status && [m.status.phase, m.status.tool, m.status.waiting, (m.status.ran || []).length, m.status.endedAt, m.status.folded || null, !!m.status.queued, !!m.status.cancellable, !!m.status.sendNow], m.done, m.ranWithoutAsking, m.ranWhy || null, m.errorText, m.via === 'turn' ? 1 : 0]) }
 
 // ------------------------------------------------------------ the DOM keeper
 

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/pull.js

@@ -7,7 +7,7 @@ export const PULL_MAX = 110 // how far the spinner travels at most
 
 // Where a pull never starts: text fields, the Live box, menus and sheets,
 // sideways scrollers, and anything open on top of the page.
-export const PULL_SKIP = 'input, textarea, [contenteditable=""], [contenteditable="true"], .live-box, lo-select, lo-combo, .lo-menu, .lo-backdrop, .cmdk, .quicklook, .moremenu, .statuspop, .doc-viewer, .emoji-sheet-wrap, .relay-screen, .tabs, pre, .scroll-x, [data-no-pull]'
+export const PULL_SKIP = 'input, textarea, [contenteditable=""], [contenteditable="true"], .live-box, lo-select, lo-combo, .lo-menu, .lo-backdrop, .cmdk, .quicklook, .moremenu, .statuspop, .doc-viewer, .emoji-sheet-wrap, .relay-screen, .tabs, pre, .scroll-x, .fs-side, [data-no-pull]'
 
 // The phone layout on a touch screen, at the very top of the page, from a
 // place that isn't a field or an overlay, and with no overlay open.
@@ -15,9 +15,22 @@ export function canStartPull({ coarse, narrow, scrollY, target, overlayOpen } =
   if (!coarse || !narrow || overlayOpen) return false
   if (scrollY > 0) return false
   if (target && typeof target.closest === 'function' && target.closest(PULL_SKIP)) return false
+  if (scrolledAbove(target)) return false
   return true
 }
 
+// 2026-11-06 (the phone's session sheet "scrolls down okay, but I cannot scroll back up. It's very
+// jumpy"): in full screen the page itself never scrolls (scrollY is 0), so a finger moving down
+// inside the sheet's own scroller was taken as a pull to refresh: the board cancelled the scroll and
+// showed the spinner instead. A pull only starts where nothing between the finger and the page is
+// itself scrolled down: a scroller with room above means the finger is scrolling it back up.
+export function scrolledAbove(el) {
+  for (let n = el; n && n.nodeType === 1; n = n.parentElement) {
+    if ((Number(n.scrollTop) || 0) > 0) return true
+  }
+  return false
+}
+
 // One finger movement: how far the spinner sits (with some resistance), how
 // far round it is, and whether letting go now refreshes. Sideways first means
 // it isn't a pull.

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)