@leftoff/cli 0.9.18-beta.5 → 0.9.18-beta.7

package/ui/app.js

@@ -2,6 +2,7 @@
 // /v1 API on the same origin (auth rides the cookie set at GET /).
 import { goWithFeedback, goState, GIVE_UP_MS } from './go.js'
 import { icon } from './icons.js'
+import { fullViewportFit, isTypingTarget, SETTLE_AFTER_BLUR_MS } from './viewport-fit.js' // 2026-11-03: no gap above full screen after the keyboard closes
 import { selectHtml, comboHtml, closeMenu, openActionMenu, closeActionMenu, actionMenuKey, openNameSheet, openProjectSheet, refreshActionMenu } from './picker.js'
 import { sheetRepos, sheetPlan, runSheetPlan, askScopeItems } from './project-sheet.js' // 0.9.12: New project with several repos
 import { watchChipFades } from './chip-fade.js' // 0.9.12: chip rows fade only where chips run off
@@ -74,6 +75,8 @@ import { loginBannersHtml, loginSig, dismissedKeys as loginDismissed, dismissLog
 import { isDone, stillWorking, canMarkDone, DONE_CONFIRM, DONE_TIP, UNDONE_TIP, doneChipHtml } from './done.js' // 0.9.15 Done
 import { mountTerminal, escInTerminal } from './term.js' // 0.9.15 the embedded terminal
 import { termTipFor } from './term-host.js' // 0.9.15 a terminal for another Mac's session
+import { testplanPageHtml, testplanNewHtml, planMarkdown, planHtmlDoc, testplanHref } from './testplan.js' // testplan Part 3
+import { decidedListHtml, decisionsGivenHtml, reviewCountHtml, decisionScope, decisionsPageHtml, projectDecisionsHtml, decisionItemHtml, decisionsHref } from './decisions.js' // 2026-11-03 decision memory
 import { recapLineHtml, beforeClearHtml } from './recap-line.js' // 0.9.15 Claude Code's recap; before /clear
 import { Presence, cardRows, awayWords } from './away.js' // 0.9.15 a card shows more the longer you've been away
 import { backLine, backLineHtml, BACK_PREFIX, BACK_AWAY_MS } from './back-line.js' // 0.9.15 the recap above the Live composer
@@ -494,7 +497,7 @@ const offlinePill = (s) => { const w = offlineLine(s); return '<span class="pill
 const fmtCode = (x) => esc(x).replace(/`([^`]+)`/g, '<code>$1</code>')
 
 // The sections an informative / long checkpoint adds below the three lines (v0.4.6).
-const EXTRA_TITLES = [['decisions', 'Key decisions'], ['questions', 'Open questions'], ['files', 'Files touched'], ['didntWork', 'What didn’t work'], ['recap', 'Recap'], ['nextSteps', 'Next steps']]
+const EXTRA_TITLES = [['decisions', 'Approach notes'], ['questions', 'Open questions'], ['files', 'Files touched'], ['didntWork', 'What didn’t work'], ['recap', 'Recap'], ['nextSteps', 'Next steps']]
 function hasExtras(cp) { return !!cp && EXTRA_TITLES.some(([k]) => (Array.isArray(cp[k]) ? cp[k].length : !!cp[k])) }
 function cpExtras(cp, paths = null) {
   let h = ''
@@ -1910,7 +1913,7 @@ function projectRow(list, sel, action, counts, tail = '') {
   const manage = sel && projectsUi.mayEdit && projectsUi.list.some((p) => p.id === sel) ? '<button type="button" class="btn icon-btn more proj-more" data-action="project-manage" data-project="' + esc(sel) + '" aria-label="Project actions" data-tip="Rename, edit repos, delete" aria-haspopup="menu" aria-expanded="false">' + icon('ellipsis') + '</button>' : ''
   // the ⋯ sits just past the scrolling track (whose edge fades only while chips run past it), never clipped
   return '<div class="repos projects" role="group" aria-label="Filter by project"><div class="track">' + b('', 'All projects', total, !sel) +
-    chips.map((c) => b(c.id, (c.emoji ? '<span class="pe" aria-hidden="true">' + esc(c.emoji) + '</span>' : '') + esc(c.name), c.count, sel === c.id)).join('') + '</div>' + manage + tail + '</div>'
+    chips.map((c) => b(c.id, (c.emoji ? '<span class="pe" aria-hidden="true">' + esc(c.emoji) + '</span>' : '') + esc(c.name) + reviewCountHtml(((projectsUi.list.find((p) => p.id === c.id) || {}).decisionsToReview) || 0, { esc, cls: 'pchip-rc' }), c.count, sel === c.id)).join('') + '</div>' + manage + tail + '</div>'
 }
 // 0.9.12: the board's own way in to a project with several repos: a "New
 // project" button at the end of the project row (or the repo row before there
@@ -2940,6 +2943,10 @@ function sessionPageHtml(s, { spv = null, live: liveV = null, lists = null } = {
   // 2026-10-29 a calmer panel: only the newest checkpoint (Stopped + Next, the rest behind More); older ones fold
   side += '<section class="fs-sec fs-cps" id="fsCps"><h2>Checkpoints <span class="count">' + cps.length + '</span></h2>'
   side += !cps.length && !wrRow ? '<div class="empty">No checkpoints yet.</div>' : '<div class="timeline">' + wrRow + (cps.length ? cpLatestHtml(cps[0], s.agent ? null : s.id, paths) : '') + '</div>'
+  side += decisionsGivenHtml(s, { esc, when: (iso) => clock(iso) + ' · ' + ago(iso) }) // 1b
+  decisionsUi.panelSession = s // 1k: the session whose panel is drawn (Accept / Edit there redraw it)
+  if (cps.length && Array.isArray(cps[0].decided) && cps[0].decided.length) noteSessionDecisions(s)
+  if (cps.length && Array.isArray(cps[0].decided) && cps[0].decided.length) side += foldHtml({ key: 'cp-decided', title: 'Decided', count: cps[0].decided.length, open: sideFolds.open('cp-decided'), cls: 'fs-fold-in', body: decidedListHtml(cps[0].decided, { esc, log: decisionsUi.bySession[s.id] || null, repoId: s.decisionRepo || null, trusted: decisionsTrusted(), editing: decisionsUi.editing, may: !s.agent }) }, { esc }) // 2026-11-03 decision memory; 1k Accept / Reject / Edit right here
   if (cps.length > 1) side += foldHtml({ key: 'cps-earlier', title: 'Earlier checkpoints', count: cps.length - 1, open: sideFolds.open('cps-earlier'), cls: 'fs-fold-in', body: '<div class="timeline">' + cpTimeline(cps.slice(1), null, null, paths) + '</div>' }, { esc })
   const doubted = s.checkpoints.filter((cp) => cp.doubt && cp.doubt !== 'empty') // 0.9.0: written with another session's branch: kept, folded away
   if (doubted.length) side += '<details class="tl-doubt"><summary>' + doubted.length + ' checkpoint' + (doubted.length === 1 ? '' : 's') + ' set aside: written with another session’s branch</summary><div class="timeline">' + cpTimeline(doubted, null) + '</div></details>'
@@ -3424,21 +3431,49 @@ function setFullClass(on) {
   applyNav()
 }
 // The window as you see it: on a phone the keyboard takes the bottom of it,
-// and the composer stays just above the keyboard.
+// and the composer stays just above the keyboard. When the keyboard closes the
+// layout goes back exactly to where it was (ui/viewport-fit.js: iOS can leave
+// its pan behind after a send, which put full screen ~300px down the screen).
+const lfKb = { scroll: null, settle: 0 } // scroll: window.scrollY as a text box took focus (iOS may scroll the page under the keyboard)
 function fitFullViewport() {
   const vv = window.visualViewport
-  const st = document.documentElement.style
-  if (!document.documentElement.classList.contains('live-full')) { st.removeProperty('--lf-h'); st.removeProperty('--lf-top'); st.removeProperty('--lf-bar'); return }
+  const html = document.documentElement, st = html.style
+  if (!html.classList.contains('live-full')) { st.removeProperty('--lf-h'); st.removeProperty('--lf-top'); st.removeProperty('--lf-bar'); html.classList.remove('lf-kb'); lfKb.scroll = null; return }
   // 0.9.14: from 700px full screen starts under the board's own tab bar (pinned to the top, the rail hidden)
   const strip = document.getElementById('tabStrip')
   const bar = strip && !strip.hidden && getComputedStyle(strip).display !== 'none' ? Math.round(strip.getBoundingClientRect().height) : 0
   st.setProperty('--lf-bar', bar + 'px')
-  if (!vv) { st.removeProperty('--lf-h'); st.removeProperty('--lf-top'); return }
-  st.setProperty('--lf-h', Math.round(vv.height) + 'px')
-  st.setProperty('--lf-top', Math.round(vv.offsetTop) + 'px')
-  document.documentElement.classList.toggle('lf-kb', window.innerHeight - vv.height > 120) // the keyboard is up: no home-indicator gap under the composer
+  const typing = isTypingTarget(document.activeElement)
+  const fit = fullViewportFit({ innerHeight: window.innerHeight, vv, typing })
+  if (!fit) { st.removeProperty('--lf-h'); st.removeProperty('--lf-top'); html.classList.remove('lf-kb'); return }
+  st.setProperty('--lf-h', fit.h + 'px')
+  st.setProperty('--lf-top', fit.top + 'px')
+  html.classList.toggle('lf-kb', fit.kb) // the keyboard is up: no home-indicator gap under the composer
+  // the keyboard's gone: the page under full screen back where it was before the text box took focus
+  if (!typing && lfKb.scroll != null && Math.abs(window.scrollY - lfKb.scroll) >= 1) window.scrollTo(window.scrollX, lfKb.scroll)
 }
 if (window.visualViewport) for (const ev of ['resize', 'scroll']) window.visualViewport.addEventListener(ev, fitFullViewport)
+for (const ev of ['resize', 'orientationchange', 'pageshow']) window.addEventListener(ev, fitFullViewport)
+document.addEventListener('visibilitychange', () => { if (document.visibilityState === 'visible') fitFullViewport() })
+document.addEventListener('focusin', (e) => {
+  if (!isTypingTarget(e.target) || !document.documentElement.classList.contains('live-full')) return
+  clearTimeout(lfKb.settle)
+  if (lfKb.scroll == null) lfKb.scroll = window.scrollY
+})
+// A text box let go (a send closes the phone's keyboard, or a tap away): look again as the keyboard
+// goes down, whatever iOS reports or doesn't on the way.
+document.addEventListener('focusout', (e) => {
+  if (!isTypingTarget(e.target) || !document.documentElement.classList.contains('live-full')) return
+  clearTimeout(lfKb.settle)
+  let i = 0
+  const step = () => {
+    fitFullViewport()
+    if (isTypingTarget(document.activeElement)) return // another text box took focus: the keyboard stays
+    if (++i < SETTLE_AFTER_BLUR_MS.length) lfKb.settle = setTimeout(step, SETTLE_AFTER_BLUR_MS[i] - SETTLE_AFTER_BLUR_MS[i - 1])
+    else lfKb.scroll = null
+  }
+  lfKb.settle = setTimeout(step, SETTLE_AFTER_BLUR_MS[0])
+})
 function fullAfterRender(sid) {
   const box = document.querySelector('.live-box.full')
   setFullClass(!!box)
@@ -4443,6 +4478,243 @@ function cpHeadLine(cp) {
   return '<div class="tl-head"><span class="t">' + esc(clock(cp.createdAt)) + '</span><span class="trig">' + esc(cp.trigger) + '</span><span>' + esc(ago(cp.createdAt)) + '</span>' +
     (cp.generator && cp.generator.by ? '<span>· ' + esc(cpByText(cp.generator)) + cpByHintHtml(cp.generator) + '</span>' : '') + '</div>'
 }
+// 2026-11-03 decision memory: the log's word on a session's decisions (by text), once its repo's log is loaded
+const decisionsUi = { bySession: {}, scope: null, view: null, all: false, editing: null, project: null, loadedRepo: {}, panelSession: null }
+const panelSess = () => (state.route && state.route.name === 's' && decisionsUi.panelSession && decisionsUi.panelSession.id === state.route.arg ? decisionsUi.panelSession : null)
+// The session panel's Decided list reads the log's word on each one (once per repo per visit, quietly)
+function noteSessionDecisions(s) {
+  const repo = s && s.decisionRepo
+  if (!repo || decisionsUi.loadedRepo[repo]) return
+  decisionsUi.loadedRepo[repo] = true
+  api('GET', '/v1/decisions?repo=' + encodeURIComponent(repo), undefined, { timeoutMs: 8000 }).then((v) => {
+    const norm = (t) => String(t || '').toLowerCase().replace(/[^\p{L}\p{N}]+/gu, ' ').trim()
+    const by = {}
+    for (const d of v.decisions || []) if (d.sessionId === s.id) { by[norm(d.text)] = d; if (d.original) by[norm(d.original.text)] = d }
+    decisionsUi.bySession[s.id] = by
+    const box = document.querySelector('[data-fold="cp-decided"] .fs-fold-b')
+    const cp = (s.checkpoints || []).filter((c) => !c.doubt).sort((a, b) => String(b.createdAt).localeCompare(String(a.createdAt)))[0]
+    if (box && cp && cp.decided) box.innerHTML = decidedListHtml(cp.decided, { esc, log: by, repoId: repo, trusted: decisionsTrusted(), editing: decisionsUi.editing, may: !s.agent })
+  }).catch(() => { decisionsUi.loadedRepo[repo] = false })
+}
+// ---- testplan Part 3: #/testplan/new?scope=…&prs=… (before a run) and #/testplan/<id>?machine=… (a plan)
+const tpUi = { id: null, machine: null, plan: null, timer: null, noting: null, proposing: null, nu: null }
+const tpTrusted = () => state.mayAnswer !== false && (state.viewerLocal !== false || !!(state.health && state.health.answering && state.health.answering.remoteAllowed))
+async function viewTestplan(arg, params) {
+  clearTimeout(tpUi.timer)
+  if (arg === 'new') {
+    const q = { scope: params.get('scope') || '', since: params.get('since') || '', prs: params.get('prs') || '' }
+    const key = JSON.stringify(q)
+    if (!tpUi.nu || tpUi.nu.key !== key) tpUi.nu = { key, q, preview: null, recent: null, minutes: 30, starting: false, error: null }
+    paintTestplanNew()
+    const qs = 'scope=' + encodeURIComponent(q.scope) + (q.since ? '&since=' + encodeURIComponent(q.since) : '') + (q.prs ? '&prs=' + q.prs.split(',').map((u) => encodeURIComponent(decodeURIComponent(u))).join(',') : '')
+    try { tpUi.nu.preview = await api('GET', '/v1/testplans/preview?' + qs, undefined, { timeoutMs: 30000 }) } catch (e) { tpUi.nu.error = e.message || String(e) }
+    try { tpUi.nu.recent = await api('GET', '/v1/testplans' + (q.scope ? '?scope=' + encodeURIComponent(q.scope) : ''), undefined, { timeoutMs: 8000 }) } catch {}
+    paintTestplanNew()
+    const w = tpUi.nu.preview && tpUi.nu.preview.walking
+    if (w && w.running) tpUi.timer = setTimeout(() => { if (state.route && state.route.name === 'testplan' && state.route.arg === 'new') viewTestplan('new', params) }, 2500)
+    return
+  }
+  const machine = params.get('machine') || null
+  if (tpUi.id !== arg || tpUi.machine !== machine) { tpUi.id = arg; tpUi.machine = machine; tpUi.plan = null; tpUi.noting = null; tpUi.proposing = null; paintTestplan() }
+  tpUi.plan = await api('GET', '/v1/testplans/' + encodeURIComponent(arg) + (machine ? '?machine=' + encodeURIComponent(machine) : ''), undefined, { timeoutMs: 10000 })
+  paintTestplan()
+  if (tpUi.plan && tpUi.plan.status === 'running') tpUi.timer = setTimeout(() => { if (state.route && state.route.name === 'testplan' && state.route.arg === arg) viewTestplan(arg, params) }, 1500)
+}
+function paintTestplanNew() {
+  if (!state.route || state.route.name !== 'testplan' || state.route.arg !== 'new' || !tpUi.nu) return
+  const n = tpUi.nu
+  $app.innerHTML = testplanNewHtml(n.preview, { minutes: n.minutes, trusted: tpTrusted(), starting: n.starting, recent: n.recent, here: state.health && state.health.machine }, { esc }) + (n.error ? '<div class="banner warn" role="alert"><span>' + esc(n.error) + '</span></div>' : '')
+}
+function paintTestplan() {
+  if (!state.route || state.route.name !== 'testplan' || state.route.arg === 'new') return
+  $app.innerHTML = testplanPageHtml(tpUi.plan, { trusted: tpTrusted(), noting: tpUi.noting, proposing: tpUi.proposing, here: state.health && state.health.machine }, { esc })
+}
+async function tpCheck(id, check, body) {
+  try { tpUi.plan = await api('POST', '/v1/testplans/' + encodeURIComponent(id) + '/check' + (tpUi.machine ? '?machine=' + encodeURIComponent(tpUi.machine) : ''), { check, ...body }); paintTestplan() } catch (e) { toast(e.message || String(e)) }
+}
+document.addEventListener('click', async (ev) => {
+  const b = ev.target.closest && ev.target.closest('[data-action^="tp-"]')
+  if (!b || b.tagName === 'FORM' || b.disabled) return
+  const a = b.dataset.action
+  if (a === 'tp-minutes') { if (tpUi.nu) { tpUi.nu.minutes = Number(b.dataset.m) || 30; paintTestplanNew() } return }
+  if (a === 'tp-run' || a === 'tp-walk') {
+    const n = tpUi.nu
+    if (!n) return
+    const body = { scope: n.q.scope, since: n.q.since || null, prs: n.q.prs ? n.q.prs.split(',').map((u) => decodeURIComponent(u)) : null }
+    if (a === 'tp-walk') { try { await api('POST', '/v1/testplans/walk', body); toast('Walking through them one at a time'); viewTestplan('new', state.route.params) } catch (e) { toast(e.message || String(e)) } return }
+    n.starting = true; paintTestplanNew()
+    try { const r = await api('POST', '/v1/testplans', { ...body, minutes: n.minutes }, { timeoutMs: 90000 }); location.hash = testplanHref(r.id) } catch (e) { n.starting = false; n.error = e.message || String(e); paintTestplanNew() }
+    return
+  }
+  const id = b.dataset.id, check = b.dataset.check
+  if (a === 'tp-tick') { const cur = tpUi.plan && tpUi.plan.ticks && tpUi.plan.ticks[check]; const want = b.dataset.state || null; return tpCheck(id, check, { state: cur && cur.state === want ? null : want }) }
+  if (a === 'tp-propose') { tpUi.proposing = check; paintTestplan(); const i = document.querySelector('.tp-propf .dec-in'); if (i) i.focus({ preventScroll: true }); return }
+  if (a === 'tp-propose-cancel') { tpUi.proposing = null; return paintTestplan() }
+  if (a === 'tp-copy') { const md = tpUi.plan && planMarkdown(tpUi.plan); if (md && await clipWrite(md)) toast('Copied as Markdown'); else if (md) prompt('Copy this:', md); return }
+  if (a === 'tp-download') {
+    if (!tpUi.plan) return
+    const url = URL.createObjectURL(new Blob([planHtmlDoc(tpUi.plan)], { type: 'text/html' }))
+    const x = document.createElement('a'); x.href = url; x.download = exportName('Test plan ' + ((tpUi.plan.scope && tpUi.plan.scope.label) || '')); document.body.appendChild(x); x.click(); x.remove()
+    setTimeout(() => URL.revokeObjectURL(url), 4000)
+    return
+  }
+  if (a === 'tp-delete') { if (!confirm('Delete this test plan?')) return; try { await api('DELETE', '/v1/testplans/' + encodeURIComponent(id)); location.hash = '#/prs' } catch (e) { toast(e.message || String(e)) } }
+})
+document.addEventListener('submit', async (ev) => {
+  const f = ev.target.closest && ev.target.closest('form[data-action^="tp-"]')
+  if (!f) return
+  ev.preventDefault()
+  if (f.dataset.action === 'tp-note') return tpCheck(f.dataset.id, f.dataset.check, { note: f.querySelector('[name="note"]').value })
+  if (f.dataset.action === 'tp-propose-save') {
+    try {
+      const r = await api('POST', '/v1/testplans/' + encodeURIComponent(f.dataset.id) + '/propose', { check: f.dataset.check, text: f.querySelector('[name="text"]').value })
+      tpUi.plan = r.plan; tpUi.proposing = null; paintTestplan(); toast('Proposed ' + (r.decision ? r.decision.id : '') + ': review it in the decision log')
+    } catch (e) { toast(e.message || String(e)) }
+  }
+})
+// 1k: the panel's Decided list, drawn again in place (editing one, or after the log loaded)
+function paintPanelDecided(s) {
+  const box = document.querySelector('[data-fold="cp-decided"] .fs-fold-b')
+  const cp = s && (s.checkpoints || []).filter((c) => !c.doubt).sort((a, b) => String(b.createdAt).localeCompare(String(a.createdAt)))[0]
+  if (box && cp && cp.decided) box.innerHTML = decidedListHtml(cp.decided, { esc, log: decisionsUi.bySession[s.id] || null, repoId: s.decisionRepo || null, trusted: decisionsTrusted(), editing: decisionsUi.editing, may: !s.agent })
+}
+// 1k: after Accept / Reject / Edit, the panel's Decided list reads the log again
+function refreshPanelDecisions(s) {
+  if (!s || !s.decisionRepo) return
+  decisionsUi.loadedRepo[s.decisionRepo] = false
+  noteSessionDecisions(s)
+}
+// ---- the decision log page (#/decisions/<repo id> or #/decisions/project:<id>)
+async function viewDecisions(arg) {
+  const raw = decodeURIComponent(arg || '')
+  if (decisionsUi.scope !== raw) { decisionsUi.scope = raw; decisionsUi.view = null; decisionsUi.editing = null }
+  decisionsUi.view = await api('GET', '/v1/decisions?' + decisionScope(raw).api)
+  const want = state.route && state.route.params && state.route.params.get('d')
+  if (want && (decisionsUi.view.decisions || []).some((d) => d.id === want && (d.status === 'superseded' || d.status === 'rejected'))) decisionsUi.all = true
+  paintDecisions()
+  if (want) { const el = document.getElementById('dec-' + want); if (el) { el.scrollIntoView({ block: 'center' }); el.classList.add('dec-flash'); setTimeout(() => el.classList.remove('dec-flash'), 1600) } }
+}
+function paintDecisions() {
+  if (!decisionsUi.view || !state.route || state.route.name !== 'decisions') return
+  $app.innerHTML = decisionsPageHtml(decisionsUi.view, { all: decisionsUi.all, editing: decisionsUi.editing, may: state.mayAnswer !== false, trusted: decisionsTrusted() }, { esc })
+  if (decisionsUi.editing) { const i = $app.querySelector('.dec-edit .dec-in'); if (i) i.focus({ preventScroll: true }) }
+}
+async function decisionAction(repo, ref, action, body = {}) {
+  try {
+    const r = await api('POST', '/v1/decisions/action', { repo, ref, action, ...body })
+    decisionsUi.loadedRepo = {}
+    // a walkthrough citing it shows its new word (Proposed goes once accepted)
+    const dd = r && r.decision
+    if (dd) for (const w of wtUi.data.values()) for (const x of (w && w.decisions) || []) if (x.id === dd.id) { if (dd.status === 'proposed') x.status = 'proposed'; else delete x.status; wtUi.sig = '' }
+    if (wtUi.sid) wtFill(wtSession(wtUi.sid))
+    const dv = document.querySelector('.dv-isdec:not([hidden])')
+    if (dv && decViewerCtx) openDecisionViewer(decViewerCtx.repo, decViewerCtx.id, decViewerCtx.from, decViewerCtx.ctx)
+    if (panelSess()) refreshPanelDecisions(panelSess()) // 1k
+    if (state.route && state.route.name === 'decisions') await viewDecisions(decisionsUi.scope)
+    else if (state.route && state.route.name === 'project') loadProjectDecisions(qaUi.token, true)
+  } catch (e) { toast(e.message || String(e)) }
+}
+document.addEventListener('click', async (ev) => {
+  const btn = ev.target.closest && ev.target.closest('[data-action^="dec-"]')
+  if (!btn || btn.tagName === 'FORM') return
+  const a = btn.dataset.action
+  if (a === 'dec-act') return decisionAction(btn.dataset.repo, btn.dataset.id, btn.dataset.act, btn.dataset.act === 'accept' ? {} : {})
+  if (a === 'dec-link') return decisionAction(btn.dataset.repo, btn.dataset.id, 'link', { supersedes: [btn.dataset.to] })
+  if (a === 'dec-edit') { decisionsUi.editing = btn.dataset.id; if (panelSess()) { paintPanelDecided(panelSess()); const i = document.querySelector('#decp-' + CSS.escape(btn.dataset.id) + ' .dec-in'); if (i) i.focus({ preventScroll: true }); return } return paintDecisions() }
+  if (a === 'dec-cancel') { decisionsUi.editing = null; if (panelSess()) return paintPanelDecided(panelSess()); return paintDecisions() }
+  if (a === 'dec-all') { decisionsUi.all = !decisionsUi.all; return paintDecisions() }
+  if (a === 'dec-copy') { const md = decisionsUi.view && decisionsUi.view.markdown; if (md && await clipWrite(md)) toast('Copied as Markdown'); else if (md) prompt('Copy this:', md); return }
+  if (a === 'dec-show') {
+    const el = document.getElementById('dec-' + btn.dataset.id)
+    if (el) { el.scrollIntoView({ block: 'center', behavior: matchMedia('(prefers-reduced-motion: reduce)').matches ? 'auto' : 'smooth' }); el.classList.add('dec-flash'); setTimeout(() => el.classList.remove('dec-flash'), 1600); return }
+    if (btn.dataset.repo) { location.hash = '#/decisions/' + btn.dataset.repo + '?d=' + encodeURIComponent(btn.dataset.id) }
+    return
+  }
+  if (a === 'dec-store') {
+    const on = btn.dataset.on === 'true'
+    try {
+      await api('POST', '/v1/projects/' + encodeURIComponent(btn.dataset.project) + '/decision-log', { inRepo: on })
+      toast(on ? 'Accepted decisions now go into each repo’s docs/DECISIONS.md' : 'The decision log stays in Leftoff; repo files are left as they are')
+      if (state.route && state.route.name === 'decisions') await viewDecisions(decisionsUi.scope)
+      else loadProjectDecisions(qaUi.token, true)
+    } catch (e) { toast(e.message || String(e)) }
+  }
+})
+// A walkthrough step's decision chip: the decision and its chain, in the viewer (centered; a bottom sheet on a phone)
+document.addEventListener('click', (ev) => {
+  const b = ev.target.closest && ev.target.closest('[data-action="wt-dec"]')
+  if (!b) return
+  ev.preventDefault()
+  const s = wtSession(wtUi.sid)
+  openDecisionViewer(b.dataset.repo || (s && s.decisionRepo) || '', b.dataset.id, b, { departs: b.dataset.departs === '1', sessionId: wtUi.sid || null })
+})
+// 1h: the board's gate for changing the decision log (POST /v1/decisions/action is trustedOnly)
+const decisionsTrusted = () => state.mayAnswer !== false && (state.viewerLocal !== false || !!(state.health && state.health.answering && state.health.answering.remoteAllowed))
+let decViewerCtx = null // 1f/1g: the viewer's last open, to redraw after Accept / Reject / a link
+async function openDecisionViewer(repo, id, from, ctx = {}) {
+  if (!repo || !id) return
+  decViewerCtx = { repo, id, from, ctx }
+  let v
+  try { v = await api('GET', '/v1/decisions?repo=' + encodeURIComponent(repo), undefined, { timeoutMs: 8000 }) } catch (e) { toast(e.message || String(e)); return }
+  const list = v.decisions || [], byId = new Map(list.map((d) => [d.id, d]))
+  const d = byId.get(id)
+  const el = docViewerEl()
+  el.querySelector('.dv-title').textContent = 'Decision ' + id
+  el.querySelector('.dv-dl').hidden = true
+  el.querySelector('.dv-ref').innerHTML = ''; el.querySelector('.dv-ptitle').textContent = ''
+  el.querySelector('.dv-sub').textContent = d ? (d.repoLabel || '') : 'Not in the log any more'
+  // the chain: what it replaced (oldest first), the decision, what replaced it
+  const chain = []
+  if (d) {
+    const back = []; let cur = d, guard = 0
+    while (cur && cur.supersedes && cur.supersedes.length && guard++ < 20) { const o = byId.get(cur.supersedes[0]); if (!o || back.includes(o)) break; back.unshift(o); cur = o }
+    chain.push(...back, d)
+    cur = d; guard = 0
+    while (cur && cur.supersededBy && guard++ < 20) { const n = byId.get(cur.supersededBy); if (!n || chain.includes(n)) break; chain.push(n); cur = n }
+  }
+  // 1f: a proposed one (a walkthrough cites this session's own) can be accepted or rejected right here, same API and gate.
+  // 1g: from a step that departs from it, this session's own decisions offer the supersede link (once accepted).
+  const trusted = decisionsTrusted()
+  const item = (x) => decisionItemHtml(x, { esc, byId, may: x === d && x.status === 'proposed', review: x === d && x.status === 'proposed', edit: false, trusted })
+  let offer = ''
+  if (d && ctx.departs && ctx.sessionId) {
+    const own = list.filter((x) => x.sessionId === ctx.sessionId && x.id !== d.id && (x.status === 'proposed' || x.status === 'accepted') && !(x.supersedes || []).includes(d.id))
+    if (own.length) offer = '<section class="dec-offer"><h3>This step departs from ' + esc(d.id) + '</h3><p class="faint">If one of this session’s decisions changes it, link them so ' + esc(d.id) + ' reads as superseded.</p><ul class="dec-tl">' +
+      own.map((x) => decisionItemHtml(x, { esc, byId, may: x.status === 'proposed', review: x.status === 'proposed', edit: false, trusted, replaces: x.status === 'accepted' ? d.id : null })).join('') + '</ul></section>'
+  }
+  el.querySelector('.dv-body').innerHTML = (chain.length ? '<ol class="dec-tl dec-chainview">' + chain.map(item).join('') + '</ol>' : '<p class="faint">This decision isn’t in the repo’s log.</p>') + offer +
+    '<p><a class="linkish dec-open" href="' + esc(decisionsHref(repo)) + '?d=' + encodeURIComponent(id) + '">Open the decision log →</a></p>'
+  el.classList.remove('dv-isref'); el.classList.add('dv-isdec')
+  refUi.from = from || null
+  el.hidden = false
+  document.documentElement.classList.add('dv-open')
+  const x = el.querySelector('.dv-x'); if (x) x.focus({ preventScroll: true })
+}
+document.addEventListener('submit', (ev) => {
+  const f = ev.target.closest && ev.target.closest('form[data-action="dec-save"]')
+  if (!f) return
+  ev.preventDefault()
+  const text = f.querySelector('[name="text"]').value, why = f.querySelector('[name="why"]').value
+  decisionsUi.editing = null
+  decisionAction(f.dataset.repo, f.dataset.id, 'edit', { text, why })
+})
+// The project page's Decisions section
+async function loadProjectDecisions(token, force = false) {
+  if (!token) return
+  try {
+    const v = await api('GET', '/v1/decisions?project=' + encodeURIComponent(token), undefined, { timeoutMs: 8000 })
+    decisionsUi.project = { token, v }
+    paintProjectDecisions()
+  } catch { decisionsUi.project = null }
+}
+function paintProjectDecisions() {
+  const box = document.getElementById('projDecisionsBox')
+  const pd = decisionsUi.project
+  if (!box || !pd || pd.token !== qaUi.token) return
+  box.innerHTML = projectDecisionsHtml(pd.v, { esc, may: state.mayAnswer !== false, trusted: decisionsTrusted(), scopeArg: 'project:' + ((pd.v.scope && pd.v.scope.id) || pd.token) })
+  const slot = document.getElementById('projDecReview') // 1k: the header's quiet count
+  if (slot) slot.innerHTML = reviewCountHtml((pd.v.decisions || []).filter((d) => d.status === 'proposed').length, { esc, href: decisionsHref('project:' + ((pd.v.scope && pd.v.scope.id) || pd.token)), cls: 'proj-review' })
+}
 // 2026-10-29 The panel's newest checkpoint: Stopped + Next; Goal, Doing, the extra sections,
 // your note and the files behind More (open or closed as you last left it on this device).
 function cpLatestHtml(cp, wtSid, paths) {
@@ -4470,10 +4742,10 @@ function fact(k, v, cls, opts = {}) { return factHtml(k, v, { cls, ...opts }) }
 // PRs (0.6.9): Mine (PRs linked to your sessions, grouped) and Team (every open
 // PR in the repos your sessions are in). The daemon fetches with gh (or asks
 // the Mac that has it) and caches ~5 min; while it loads we look again shortly.
-const prsUi = { fresh: false, polls: 0, timer: null, data: {}, at: {}, open: new Set(), details: {}, quietOpen: false, doneOpen: {}, view: 'mine', filter: {}, done: {} }
+const prsUi = { fresh: false, polls: 0, timer: null, data: {}, at: {}, open: new Set(), details: {}, quietOpen: false, doneOpen: {}, view: 'mine', filter: {}, done: {}, picks: new Set() } // testplan Part 3: picks, merged PRs for a test plan
 // 0.8.5: the filters live in the hash (linkable; back/forward work); a chip
 // tap repaints from what we have and reads again only when that is old.
-function prsOpts(view, filter) { return { view, mayEdit: true, sessionAction: prSessionAction, filter, open: prsUi.open, details: prsUi.details, quietOpen: prsUi.quietOpen, doneOpen: prsUi.doneOpen, projects: projectsUi.list } }
+function prsOpts(view, filter) { return { view, mayEdit: true, sessionAction: prSessionAction, filter, open: prsUi.open, details: prsUi.details, quietOpen: prsUi.quietOpen, doneOpen: prsUi.doneOpen, projects: projectsUi.list, picks: prsUi.picks } }
 function paintPrs(d) {
   const q = document.getElementById('prs-q')
   const focused = q && document.activeElement === q, caret = focused ? q.selectionStart : null
@@ -4622,7 +4894,8 @@ function briefAction(id, sessions, viewer) {
 
 function renderMd(md, { spaces = [], sessions = null, viewer = null } = {}) {
   const body = md.replace(/^---\n[\s\S]*?\n---\n/, '')
-  const inline = (t) => esc(t).replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>').replace(/`([^`]+)`/g, '<code>$1</code>').replace(/(^|[^\w*])_([^_\s][^_]*?)_(?!\w)/g, '$1<em>$2</em>')  // not inside snake_case names (clutch_hockey)
+  // testplan Part 2: the Decisions part links into the log: [D-7f3a](#/decisions/…) only, nothing else becomes a link
+  const inline = (t) => esc(t).replace(/\[([^\]]{1,80})\]\((#\/decisions\/[^)\s"<>]{1,200})\)/g, '<a class="dg-dec" href="$2">$1</a>').replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>').replace(/`([^`]+)`/g, '<code>$1</code>').replace(/(^|[^\w*])_([^_\s][^_]*?)_(?!\w)/g, '$1<em>$2</em>')  // not inside snake_case names (clutch_hockey)
   const out = []
   let inList = false, inSec = false, inFin = false, seenH2 = false, inUnf = false
   const closeList = () => { if (inList) { out.push(inList === 'ol' ? '</ol>' : '</ul>'); inList = false } if (inFin) { out.push('</details>'); inFin = false } }
@@ -6646,6 +6919,8 @@ async function render() {
     else if (r.name === 'search') await viewSearch(r.q || '')
     else if (r.name === 'new') await viewNewSession()
     else if (r.name === 'project' && r.arg) await viewProject(r.arg)
+    else if (r.name === 'decisions' && r.arg) await viewDecisions(location.hash.replace(/^#\/decisions\//, '').split('?')[0])
+    else if (r.name === 'testplan' && r.arg) await viewTestplan(r.arg, r.params) // testplan Part 3
     else if (r.name === 'ask' && r.arg) await viewAsk(r.arg, r.params.get('m'))
     else if (r.name === 'setup') await viewSetup()
     else if (r.name === 'tour') { location.replace('#/'); startTour({ api }); return }
@@ -6680,6 +6955,7 @@ async function viewProject(token) {
   const [page] = await Promise.all([api('GET', '/v1/project-page?scope=' + encodeURIComponent(token)), loadProjects()]) // 0.9.12: the projects, for the title's scope menu
   qaUi.page = page
   paintProject()
+  if (page && page.scope && page.scope.kind === 'project') loadProjectDecisions(token)
   if (fresh) window.scrollTo(0, 0)
   const r = state.route || {}
   if (sAskUi.carry && sAskUi.carry.token === token) { // 0.9.11: "Whole project" from a session's Ask carries the question here
@@ -6699,6 +6975,11 @@ function paintProject() {
   const kf = fa && fa.id === 'askIn' ? { a: fa.selectionStart, b: fa.selectionEnd } : null
   $app.innerHTML = out.html
   fillAsk($app, out.keys)
+  if (p.scope && p.scope.kind === 'project') { // 2026-11-03 decision memory: the project's log and where it's kept
+    const at = document.getElementById('projAsks')
+    if (at && !document.getElementById('projDecisionsBox')) { const box = document.createElement('div'); box.id = 'projDecisionsBox'; at.after(box) }
+    paintProjectDecisions()
+  }
   const ta = document.getElementById('askIn')
   if (ta) { ta.value = state.drafts['ask:' + ((p.scope || {}).key || '')] || ''; fitComposer(ta); if (kf && !ta.disabled) { ta.focus({ preventScroll: true }); try { ta.setSelectionRange(kf.a, kf.b) } catch {} } }
 }
@@ -8670,6 +8951,8 @@ document.addEventListener('click', async (ev) => {
     if (action === 'prs-clear') { const q = document.getElementById('prs-q'); if (q) q.value = ''; return setPrsFilter({}) }
     if (action === 'pr-expand') return togglePr(btn.dataset.url)
     if (action === 'pr-expand-retry') return togglePr(btn.dataset.url, { retry: true })
+    if (action === 'prs-pick') { const u = btn.dataset.url; if (prsUi.picks.has(u)) prsUi.picks.delete(u); else prsUi.picks.add(u); return paintPrsBody() } // testplan Part 3
+    if (action === 'prs-pick-clear') { prsUi.picks.clear(); return paintPrsBody() }
     if (action === 'prs-older') { const d = prsUi.data[prsUi.view]; if (!d) return; d.olderLoading = true; btn.disabled = true; btn.textContent = 'Loading…'; prsUi.done[prsUi.view] = (Number(d.doneShown) || 0) + 100; prsUi.at[prsUi.view] = 0; return render() } // 0.9.12
     if (action === 'prs-refresh') { btn.disabled = true; prsUi.fresh = true; return render() }
     if (action === 'pr-unlink') {
@@ -9538,7 +9821,7 @@ function docViewerEl() {
   document.body.appendChild(el)
   return el
 }
-function closeDoc() { closeActionMenu(); endDocPrint(); const el = document.getElementById('docViewer'); if (el) { el.hidden = true; el.querySelector('.dv-body').innerHTML = ''; const back = el.classList.contains('dv-isref') ? refUi.from : null; el.classList.remove('dv-isref'); refUi.sid = null; refUi.from = null; refUi.r = null; if (back && back.isConnected) back.focus({ preventScroll: true }) } docUi.r = null; document.documentElement.classList.remove('dv-open') }
+function closeDoc() { closeActionMenu(); endDocPrint(); const el = document.getElementById('docViewer'); if (el) { el.hidden = true; el.classList.remove('dv-isdec'); el.querySelector('.dv-body').innerHTML = ''; const back = el.classList.contains('dv-isref') ? refUi.from : null; el.classList.remove('dv-isref'); refUi.sid = null; refUi.from = null; refUi.r = null; if (back && back.isConnected) back.focus({ preventScroll: true }) } docUi.r = null; document.documentElement.classList.remove('dv-open') }
 document.addEventListener('keydown', (ev) => { if (ev.key === 'Escape' && !escInTerminal(ev) && document.getElementById('docViewer') && !document.getElementById('docViewer').hidden) closeDoc() })
 async function openDoc(sessionId, { path, plan } = {}) {
   if (!sessionId || (!path && !plan)) return

package/ui/ask.js

@@ -19,7 +19,7 @@ import { glyphState, glyphHtml } from './sglyph.js' // 0.9.14: the status glyph,
 export const projectHref = (token) => '#/project/' + encodeURIComponent(String(token || ''))
 export const threadHref = (id, machine = null) => '#/ask/' + encodeURIComponent(String(id || '')) + (machine ? '?m=' + encodeURIComponent(machine) : '')
 
-const TAG = /\[((?:s|cp)\d{1,3}|c:[0-9a-f]{7}|d:\d{4}-\d{2}-\d{2})\]/g
+const TAG = /\[((?:s|cp)\d{1,3}|c:[0-9a-f]{7}|d:\d{4}-\d{2}-\d{2}|dec:D-[0-9a-f]{4,12})\]/g
 
 // Where a citation chip goes: a session, a checkpoint on its session page,
 // a digest day; a commit has no page here (its sha is copied).
@@ -28,15 +28,17 @@ export function chipHref(c) {
   if (c.kind === 'session' && c.sessionId) return '#/s/' + encodeURIComponent(c.sessionId)
   if (c.kind === 'checkpoint' && c.sessionId) return '#/s/' + encodeURIComponent(c.sessionId) + (c.cpId ? '?cp=' + encodeURIComponent(c.cpId) : '')
   if (c.kind === 'digest' && c.date) return '#/digest/' + encodeURIComponent(c.date)
+  if (c.kind === 'decision' && c.repo && c.id) return '#/decisions/' + String(c.repo).replace(/[^\w:./@-]/g, encodeURIComponent) + '?d=' + encodeURIComponent(c.id) // 2026-11-03
   return null
 }
 export function chipText(c) {
   if (!c) return ''
   if (c.kind === 'commit') return (c.short || String(c.sha || '').slice(0, 7)) + (c.label ? ' ' + c.label : '')
   if (c.kind === 'digest') return 'Digest ' + (c.date || '')
+  if (c.kind === 'decision') return (c.id || 'Decision') + (c.label ? ' ' + c.label : '')
   return c.label || (c.kind === 'checkpoint' ? 'Checkpoint' : 'Session')
 }
-const KIND_ICON = { session: 'history', checkpoint: 'check', commit: 'copy', digest: 'newspaper' }
+const KIND_ICON = { session: 'history', checkpoint: 'check', commit: 'copy', digest: 'newspaper', decision: 'route' }
 
 // One chip. Its words are filled in as text (data-qt).
 export function chipHtml(c, key, { esc, icon = () => '', n = null } = {}) {
@@ -236,7 +238,7 @@ export function projectHeadHtml(p, { esc, icon = () => '', switcher = false, edi
   const sc = (p && p.scope) || {}
   const repos = (sc.repoNames && sc.repoNames.length ? sc.repoNames : sc.repos) || []
   const keys = { 'p-title': (sc.emoji ? sc.emoji + ' ' : '') + scopeName(sc), 'p-sub': [sc.kind === 'project' ? (repos.length ? repos.join(', ') : null) : (sc.sub ? 'folder ' + sc.sub : null), (sc.machines || []).length ? 'on ' + sc.machines.join(', ') : null, p && p.sessionCount != null ? p.sessionCount + (p.sessionCount === 1 ? ' session' : ' sessions') : null].filter(Boolean).join(' · ') }
-  return { html: '<div class="pagehead proj-head"><div class="proj-head-main"><div class="proj-kicker">' + icon('folder') + '<span>Project</span></div>' + (switcher ? '<h1 class="proj-title"><button type="button" class="proj-switch" data-action="project-ask-menu" aria-haspopup="menu" aria-expanded="false" data-tip="Ask about another project or repo"><span data-qt="p-title"></span>' + icon('chevron-down') + '</button></h1>' : '<h1 data-qt="p-title"></h1>') + '<div class="sub" data-qt="p-sub"></div></div>' +
+  return { html: '<div class="pagehead proj-head"><div class="proj-head-main"><div class="proj-kicker">' + icon('folder') + '<span>Project</span></div>' + (switcher ? '<h1 class="proj-title"><button type="button" class="proj-switch" data-action="project-ask-menu" aria-haspopup="menu" aria-expanded="false" data-tip="Ask about another project or repo"><span data-qt="p-title"></span>' + icon('chevron-down') + '</button></h1>' : '<h1 data-qt="p-title"></h1>') + '<div class="sub" data-qt="p-sub"></div><div class="proj-review-slot" id="projDecReview"></div></div>' + // 1k: decisions to review, filled once the log loads
     // 0.9.12: Edit (the project's own menu: Rename…, Edit repos…, Delete project) where projects can change
     (edit && sc.kind === 'project' ? '<button type="button" class="btn proj-edit" data-action="project-manage" data-project="' + esc(edit) + '" aria-haspopup="menu" aria-expanded="false" data-tip="Rename, edit repos, delete">' + icon('pencil') + '<span>Edit</span></button>' : '') + '</div>', keys }
 }