@leftoff/cli 0.9.18-beta.4 → 0.9.18-beta.6

package/mod/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "leftoff",
-  "version": "0.9.18-beta.4",
+  "version": "0.9.18-beta.6",
   "description": "Leftoff (formerly Checkpoints): WTF was I working on? Tracks every Claude Code session on this machine, writes a 3-line checkpoint when one goes quiet, and adds /cp (checkpoint now), /cp-name and a /leftoff pane. Talks to the local Leftoff daemon on 127.0.0.1:7429 and falls back to writing markdown in ~/checkpoints.",
   "author": {
     "name": "One Silly App"

package/mod/hooks/core.js

@@ -506,6 +506,10 @@ export function renderCheckpointMd(cp) {
   // Informative / long checkpoints (v0.4.6): sections below the three lines.
   // Older readers only pick up the **Label:** lines, so they still work.
   const bullet = (x) => '- ' + oneLine(x).replace(/^\*+/, '')
+  // 2026-11-03 decision memory: the decisions this checkpoint saw, first of the
+  // sections, so an older reader (no section open yet) skips the heading and its lines.
+  const decided = cleanDecided(cp.decided)
+  if (decided.length) { lines.push('', '### ' + DECIDED_TITLE); for (const d of decided) lines.push(renderDecidedLine(d)) }
   for (const k of SECTION_ORDER) {
     const v = cp[k]
     if (k === 'recap') { if (v) lines.push('', '### ' + SECTION_TITLES[k], oneLine(v).replace(/^\*+/, '')); continue }
@@ -1389,6 +1393,12 @@ const CHECKPOINT_BASE = [
   'If the session is blocked on the human (a question, a permission, a decision), start Next with "YOU:".',
   'Describe only what the transcript shows; the lines above it (repo, branch, title, what was asked, previous checkpoint) are background and may be out of date.',
 ]
+// 2026-11-03 decision memory: only when the transcript shows one, quoted, never invented.
+const DECIDED_SECTION = [
+  'Only if the transcript shows a decision (a choice between real alternatives that the developer made or approved, a plan they approved, a correction they gave such as "no, do X instead", or a trade-off the agent chose and said so), add after those lines a "Decided:" heading and one "- " line per decision, at most 4:',
+  '- <what was decided, in the words the transcript uses> · why: <the reason given, one line> · over: <alternative>; <alternative> · from: <asked | plan | correction | agent>',
+  'A task done, a file edited or a routine step is not a decision. Never invent a choice or a reason the transcript does not show. When unsure, or when there is none, leave the Decided heading out entirely. Skip decisions listed as already recorded.',
+]
 const INFORMATIVE_SECTIONS = [
   'Then these sections, each a heading line followed by "- " bullets (write "- none" when there is nothing; never invent):',
   'Decisions:',
@@ -1409,9 +1419,9 @@ const LONG_SECTIONS = [
   '3. <the step after that>',
 ]
 export const CHECKPOINT_SYSTEMS = {
-  short: [...CHECKPOINT_BASE, 'Write only those five lines.', 'Optionally a 6th line "Title: <max 6 words>" if asked for a title.', 'No preamble. No markdown. Under 90 words total.'].join('\n'),
-  informative: [...CHECKPOINT_BASE, ...INFORMATIVE_SECTIONS, 'Optionally a final line "Title: <max 6 words>" if asked for a title.', 'No preamble. No other markdown. Under 280 words total.'].join('\n'),
-  long: [...CHECKPOINT_BASE, ...INFORMATIVE_SECTIONS, ...LONG_SECTIONS, 'Optionally a final line "Title: <max 6 words>" if asked for a title.', 'No preamble. No other markdown. Under 630 words total.'].join('\n'),
+  short: [...CHECKPOINT_BASE, ...DECIDED_SECTION, 'Write only those five lines (and Decided, when there is one).', 'Optionally a 6th line "Title: <max 6 words>" if asked for a title.', 'No preamble. No markdown. Under 90 words total.'].join('\n'),
+  informative: [...CHECKPOINT_BASE, ...DECIDED_SECTION, ...INFORMATIVE_SECTIONS, 'Optionally a final line "Title: <max 6 words>" if asked for a title.', 'No preamble. No other markdown. Under 280 words total.'].join('\n'),
+  long: [...CHECKPOINT_BASE, ...DECIDED_SECTION, ...INFORMATIVE_SECTIONS, ...LONG_SECTIONS, 'Optionally a final line "Title: <max 6 words>" if asked for a title.', 'No preamble. No other markdown. Under 630 words total.'].join('\n'),
 }
 // The short prompt, as before v0.4.6 (kept under its old name for anything importing it).
 export const CHECKPOINT_SYSTEM = CHECKPOINT_SYSTEMS.short
@@ -1463,12 +1473,153 @@ export function buildCheckpointPrompt({ session, previous, messages, cfg = DEFAU
   head.push('Previous checkpoint: ' + prev, 'Files touched since then: ' + (files.length ? files.join(', ') : 'none'))
   if (Array.isArray(uncommitted)) head.push('Uncommitted files now: ' + (uncommitted.length ? uncommitted.slice(0, 12).join(', ') + (uncommitted.length > 12 ? ' and ' + (uncommitted.length - 12) + ' more' : '') : 'none (everything is committed)'))
   if (userNote) head.push('Note from the developer: ' + userNote)
+  // 2026-11-03: already read from its questions and plans, no model needed; redacted like the prompt, since they're saved
+  const red = (t) => redact(String(t || ''), (cfg.redact && cfg.redact.patterns) || [])
+  const found = decisionsFromMessages(messages).map((d) => ({ ...d, text: red(d.text), why: red(d.why), alternatives: d.alternatives.map(red) }))
+  if (found.length) head.push('Decisions already recorded from the session\'s questions and plans (don\'t repeat them): ' + found.map((d) => '“' + clip(d.text, 120) + '”').join('; '))
   if (session.needsInput) head.push('State: the session is waiting on the developer (' + (session.lastNotification || 'a prompt') + ').')
   if (wantTitle) head.push('Also write the line: Title: <max 6 words>.')
   const slice = transcriptSlice(messages, { maxInputChars, cwd })
   const patterns = (cfg.redact && cfg.redact.patterns) || []
   const prompt = redact(head.join('\n') + '\nTranscript (oldest→newest, trimmed):\n' + (slice || '(empty)'), patterns)
-  return { system: CHECKPOINT_SYSTEMS[len], prompt, filesTouched: files, inputChars: prompt.length, length: len, maxTokens: SUMMARY_LENGTHS[len].maxTokens }
+  return { system: CHECKPOINT_SYSTEMS[len], prompt, filesTouched: files, inputChars: prompt.length, length: len, maxTokens: SUMMARY_LENGTHS[len].maxTokens, found }
+}
+
+// ---------------------------------------------------------------- decisions (2026-11-03)
+//
+// A decision is a choice between real alternatives that someone made or
+// approved in a session: a question you answered from its options, a plan you
+// approved, a correction you gave, or a trade-off the agent chose and said so.
+// Not a task done or a file edited. A checkpoint with none is normal.
+// In a checkpoint each is one line under "### Decided":
+//   - <what was decided> · why: <one line> · over: <alt>; <alt> · from: asked
+// Both "·" and "|" separate the labelled parts (a model may write either).
+export const DECIDED_TITLE = 'Decided'
+export const DECIDED_MAX = 8
+export const DECISION_SOURCES = ['asked', 'plan', 'correction', 'agent']
+const DEC_PART = /\s+[·|]\s+(why|over|instead of|alternatives|from|source)\s*:\s*/i
+
+export function parseDecidedLine(line) {
+  let t = String(line == null ? '' : line).replace(/^\s*(?:[-*•]|\d+[.)])\s+/, '').replace(/\*\*/g, '').trim()
+  if (!t || NONE_RE.test(t)) return null
+  const d = { text: '', why: '', alternatives: [], source: 'agent' }
+  const m0 = t.match(/^\[(asked|plan|correction|agent)\]\s*/i) // "[asked] …" also reads
+  if (m0) { d.source = m0[1].toLowerCase(); t = t.slice(m0[0].length) }
+  const parts = t.split(DEC_PART)
+  d.text = parts[0].trim()
+  for (let i = 1; i + 1 < parts.length; i += 2) {
+    const k = parts[i].toLowerCase(), v = parts[i + 1].trim()
+    if (k === 'why') d.why = v
+    else if (k === 'from' || k === 'source') { const src = v.toLowerCase().replace(/[^a-z]/g, ''); if (DECISION_SOURCES.includes(src)) d.source = src }
+    else d.alternatives = v.split(/\s*;\s*/).map((x) => x.trim()).filter((x) => x && !NONE_RE.test(x))
+  }
+  return cleanDecided([d])[0] || null
+}
+
+export function renderDecidedLine(d) {
+  const safe = (x) => oneLine(x).replace(/\s+[·|]\s+/g, ' - ')
+  return '- ' + safe(d.text) + (d.why ? ' · why: ' + safe(d.why) : '') + (d.alternatives && d.alternatives.length ? ' · over: ' + d.alternatives.map((a) => safe(a).replace(/;/g, ',')).join('; ') : '') + ' · from: ' + (d.source || 'agent')
+}
+
+// Any list -> [{ text, why, alternatives, source }], one line each, deduplicated by text.
+export function cleanDecided(list) {
+  const out = [], seen = new Set()
+  for (const x of Array.isArray(list) ? list : []) {
+    if (!x || typeof x !== 'object') continue
+    const text = clip(oneLine(x.text).replace(/^["“]|["”]$/g, ''), 240)
+    if (!text || NONE_RE.test(text)) continue
+    const k = decisionNorm(text)
+    if (seen.has(k)) continue
+    seen.add(k)
+    const alternatives = (Array.isArray(x.alternatives) ? x.alternatives : []).map((a) => clip(oneLine(a), 120)).filter(Boolean).slice(0, 6)
+    out.push({ text, why: clip(oneLine(x.why), 240), alternatives, source: DECISION_SOURCES.includes(x.source) ? x.source : 'agent' })
+    if (out.length >= DECIDED_MAX) break
+  }
+  return out
+}
+export const decisionNorm = (t) => String(t || '').toLowerCase().replace(/[^\p{L}\p{N}]+/gu, ' ').trim()
+
+// A decision's key in a repo's log: the same decision from the same session is
+// the same entry wherever it was read (the mod or the daemon). 12 hex characters.
+export function decisionKey(sessionId, text) {
+  const str = String(sessionId || '') + '\n' + decisionNorm(text)
+  let h1 = 0x811c9dc5, h2 = 0x01000193 ^ 0x5bd1e995
+  for (let i = 0; i < str.length; i++) {
+    const c = str.charCodeAt(i)
+    h1 = Math.imul(h1 ^ c, 0x01000193) >>> 0
+    h2 = Math.imul(h2 ^ c, 0x5bd1e995) >>> 0
+    h2 = (h2 ^ (h2 >>> 15)) >>> 0
+  }
+  return (h1.toString(16).padStart(8, '0') + h2.toString(16).padStart(8, '0')).slice(0, 12)
+}
+
+// "User has answered your questions: "Q"="A", "Q2"="B". You can now continue…" -> { Q: A }
+function questionAnswers(text, questions) {
+  const out = {}
+  const t = String(text || '')
+  for (let i = 0; i < questions.length; i++) {
+    const q = questions[i]
+    const at = t.indexOf('"' + q + '"="')
+    if (at < 0) continue
+    const from = at + q.length + 4
+    let end = -1
+    for (let j = i + 1; j < questions.length && end < 0; j++) { const n = t.indexOf('", "' + questions[j] + '"="', from); if (n >= 0) end = n }
+    if (end < 0) { const m = t.slice(from).search(/"(?:\.\s|\.?$|,\s*"[^"]*"=")/); end = m >= 0 ? from + m : t.length }
+    out[q] = t.slice(from, end).trim()
+  }
+  return out
+}
+
+const PLAN_OK = /(?:approved your plan|user has approved|plan (?:was )?approved)/i
+function planHeadline(plan) {
+  const lines = String(plan || '').replace(/\r\n?/g, '\n').split('\n').map((l) => l.trim()).filter(Boolean)
+  const h = lines.find((l) => /^#{1,3}\s+\S/.test(l)) || lines[0] || ''
+  return h.replace(/^#{1,6}\s+/, '').replace(/^(?:plan|implementation plan)\s*[:\-–—]\s*/i, '').replace(/\*\*/g, '').trim()
+}
+
+// The decisions a transcript states outright, with no model: a question you
+// answered from its options (AskUserQuestion, the board's Needs you), its other
+// options as the alternatives; a plan you approved (ExitPlanMode). Messages are
+// src/transcript.js's shape, which is also $.session.messages()'s.
+export function decisionsFromMessages(messages) {
+  const out = []
+  for (const m of messages || []) {
+    if (!m || m.role !== 'assistant') continue
+    for (const u of m.toolUses || []) {
+      const name = u && (u.tool || u.name)
+      if (!u || u.isError || !u.input) continue
+      if (name === 'AskUserQuestion' && Array.isArray(u.input.questions) && u.text) {
+        const qs = u.input.questions.filter((q) => q && q.question && Array.isArray(q.options) && q.options.length >= 2)
+        const ans = questionAnswers(u.text, qs.map((q) => String(q.question)))
+        for (const q of qs) {
+          const a = ans[q.question]
+          if (!a) continue
+          const labels = q.options.map((o) => String((o && o.label) || o || '').trim()).filter(Boolean)
+          const picked = labels.filter((l) => a === l || a.split(/\s*,\s*/).includes(l))
+          const chosen = picked.length ? picked.join(', ') : a
+          const opt = q.options.find((o) => o && o.label === picked[0])
+          out.push({
+            text: clip(String(q.header ? q.header + ': ' : '') + chosen.replace(/\s*\(Recommended\)\s*/i, ''), 240),
+            why: opt && opt.description ? opt.description : '',
+            alternatives: labels.filter((l) => !picked.includes(l)).map((l) => l.replace(/\s*\(Recommended\)\s*/i, '')),
+            source: 'asked',
+          })
+        }
+      }
+      if (name === 'ExitPlanMode' && u.text && PLAN_OK.test(u.text)) {
+        const head = planHeadline(u.input.plan)
+        if (head) out.push({ text: clip('Plan approved: ' + head, 240), why: '', alternatives: [], source: 'plan' })
+      }
+    }
+  }
+  return cleanDecided(out)
+}
+
+// The checkpoint's decisions: what the transcript states outright first, then the model's.
+// earlier: decisions already in this session's previous checkpoints (by text), left out.
+export function mergeDecided(found, fromModel, { earlier = [] } = {}) {
+  const seen = new Set((earlier || []).map((d) => decisionNorm(d && d.text)))
+  return cleanDecided([...(found || []), ...(fromModel || [])]).filter((d) => !seen.has(decisionNorm(d.text)))
 }
 
 // The extra sections of an informative / long checkpoint, by the heading a
@@ -1480,11 +1631,12 @@ const SECTION_KEYS = {
   'didn\'t work': 'didntWork', 'didnt work': 'didntWork', 'did not work': 'didntWork', 'what didn\'t work': 'didntWork', 'what didnt work': 'didntWork', 'tried': 'didntWork',
   'recap': 'recap',
   'next steps': 'nextSteps', 'next 3 steps': 'nextSteps',
+  'decided': 'decided', // 2026-11-03 decision memory
 }
 export const SECTION_TITLES = { decisions: 'Key decisions', questions: 'Open questions', files: 'Files touched', didntWork: 'What didn\'t work', recap: 'Recap', nextSteps: 'Next steps' }
 const SECTION_ORDER = ['decisions', 'questions', 'files', 'didntWork', 'recap', 'nextSteps']
 const NONE_RE = /^(none|n\/a|nothing|-|—|none yet|no(ne)? (open )?questions?)\.?$/i
-const LIMITS = { decisions: 6, questions: 5, files: 10, didntWork: 5, nextSteps: 5 }
+const LIMITS = { decided: DECIDED_MAX, decisions: 6, questions: 5, files: 10, didntWork: 5, nextSteps: 5 }
 
 // "src/a.js — retry loop" / "`src/a.js`: why" -> { path, why }
 export function parseFileNote(text) {
@@ -1495,7 +1647,7 @@ export function parseFileNote(text) {
   return p ? { path: p[1], why: '' } : { path: '', why: t }
 }
 
-function emptyExtras() { return { decisions: [], questions: [], files: [], didntWork: [], recap: '', nextSteps: [] } }
+function emptyExtras() { return { decided: [], decisions: [], questions: [], files: [], didntWork: [], recap: '', nextSteps: [] } }
 export function hasExtras(cp) {
   return !!cp && (['decisions', 'questions', 'files', 'didntWork', 'nextSteps'].some((k) => Array.isArray(cp[k]) && cp[k].length) || !!cp.recap)
 }
@@ -1510,6 +1662,7 @@ function parseSections(lines) {
     if (!v || NONE_RE.test(v)) return
     if (k === 'recap') { ex.recap = ex.recap ? ex.recap + ' ' + v : v; return }
     if (k === 'files') { const f = parseFileNote(v); if (f.path || f.why) ex.files.push(f); return }
+    if (k === 'decided') { const d = parseDecidedLine(v); if (d) ex.decided.push(d); return }
     ex[k].push(v)
   }
   for (const raw of lines) {
@@ -1528,6 +1681,7 @@ function parseSections(lines) {
     if (item) push(cur, item[1])
     else if (cur === 'recap') push(cur, line)
     else if (/^(doing|stopped at|next|title|open question|note|resume)\s*:/i.test(h)) cur = null
+    else if (cur === 'decided') continue // a decision is one bullet line; loose prose under the heading is not one
     else push(cur, line)
   }
   for (const k of Object.keys(LIMITS)) ex[k] = ex[k].slice(0, LIMITS[k])
@@ -1707,6 +1861,8 @@ export function heuristicCheckpoint(messages, session = {}, { length = 'short',
   else if (lastError) next = 'Look at the last error and decide whether to retry or change approach.'
   else if (lastEdit >= 0 && lastCommit < lastEdit) next = 'Commit, or keep going.'
   const base = { doing, stoppedAt, next, title: null, openQuestion: null, parseOk: true }
+  const found = decisionsFromMessages(ms_) // 2026-11-03: only what the transcript states outright; the heuristic guesses none
+  if (found.length) base.decided = found
   const len = normalizeLength(length)
   if (len === 'short') return base
   const ex = emptyExtras()
@@ -1733,7 +1889,7 @@ export function heuristicCheckpoint(messages, session = {}, { length = 'short',
     ].filter(Boolean).join(' ')
     ex.nextSteps = next ? [next] : []
   }
-  return { ...base, ...ex }
+  return { ...base, ...ex, decided: base.decided || [] }
 }
 
 // Fallback title: {repo}@{branch} · {first 6 words of the first prompt}

package/mod/hooks/register.js

@@ -14,7 +14,7 @@
 // each event is registered once per matcher.
 import {
   DEFAULT_CONFIG, DEFAULT_PORT, mergeConfig, resolveMachine, applyEvent, checkpointDue, buildCheckpointPrompt,
-  parseCheckpointReply, retryCheckpointPrompt, betterSalvage, heuristicCheckpoint, isEmptyCheckpoint, NOTHING_TO_CHECKPOINT, renderCheckpointMd, checkpointId, checkpointFileName,
+  parseCheckpointReply, retryCheckpointPrompt, mergeDecided, betterSalvage, heuristicCheckpoint, isEmptyCheckpoint, NOTHING_TO_CHECKPOINT, renderCheckpointMd, checkpointId, checkpointFileName,
   sessionFolderName, id8, clip, toIso, resumeCommand, repoName,
   shortId, formatTabTitle, parseTabTitle, tabRenameWaits, detectTerminal, parseProcLine, trailingQuestion,
   parseCheckpointArgs, SUMMARY_LENGTHS, parseBulletList, parseCatchupArgs,
@@ -27,9 +27,12 @@ const POST_TIMEOUT_MS = 800
 const END_TIMEOUT_MS = 1000
 const MODEL_TIMEOUT_MS = 20000
 const STOP_GRACE_MS = 2500 // 2026-11-03 how long a completed turn waits for its Stop before the mod reports the end itself
+const SKIP_GRACE_MS = 4000 // 2026-11-03 how long a mod event waits for its classic twin before that classic event counts as passed over
+const START_SKIP_GRACE_MS = 15000 // the same for SessionStart (a cold start can be slow)
+const PERM_GRACE_MS = 1500 // how long a permission prompt tool.check saw waits for classic.PermissionRequest before the mod reports it
 
 // Module state. $.state is not used: the pane redraws with $.ui.invalidate.
-const MOD_VERSION = '0.9.18-beta.4' // keep in step with .claude-plugin/plugin.json
+const MOD_VERSION = '0.9.18-beta.6' // keep in step with .claude-plugin/plugin.json
 
 const st = {
   internal: false,
@@ -72,6 +75,13 @@ const st = {
   paneNeeds: 0, // sessions that need you (the pane's top line)
   turnStartAt: 0, // 2026-11-03 when this process's current turn started (turn.start)
   stopAt: 0, // and when a Stop last came (classic.Stop)
+  // 2026-11-03 Claude Code 2.1.31x passes every classic.* event of a plugin you
+  // installed over when its built-in cc-plugin-sec-default is seated first (a
+  // Team or Enterprise plan, or managed settings): see SKIP_GRACE_MS below.
+  classicSeen: false, // a classic.* hook of this mod ran in this process
+  hooksSkipped: null, // the classic events we saw passed over, as last told to the daemon
+  permAt: 0, // when classic.PermissionRequest last ran
+  watchAsks: {}, // tool_use_id -> { tool, at, reported, done }: permission prompts tool.check saw
 }
 
 // Millisecond precision: the daemon dedupes events per (sessionId, type, at).
@@ -233,7 +243,7 @@ async function readRepo($, cwd) {
 
 async function heartbeat($) {
   if (st.internal || !st.sessionId) return
-  const res = await sendOrSpool($, 'heartbeat', { inTurn: !!(st.record && st.record.inTurn) })
+  const res = await sendOrSpool($, 'heartbeat', { inTurn: !!(st.record && st.record.inTurn), ...(st.hooksSkipped && st.hooksSkipped.length ? { hooksSkipped: st.hooksSkipped } : {}) })
   if (res && !st.modHealthSent) await reportModHealth($)
   if (res && st.daemonTitle) await noteTitle($, st.daemonTitle)
   else if (res && st.tabTitle && !(st.record && st.record.inTurn)) await applyTabTitle($, null) // the marker came (it never goes: tabMarkerKept), or a rename that had to wait
@@ -256,6 +266,89 @@ async function stopFallback($, completedAt, reason) {
   await sendOrSpool($, 'turn_completed', { endReason: String(reason || 'end').slice(0, 40), settledBy: 'mod', completedAt: new Date(completedAt).toISOString() })
 }
 
+// ---------------------------------------------------------------- passed-over classic hooks (2026-11-03)
+//
+// Claude Code 2.1.31x seats its built-in "cc-plugin-sec-default" outermost on
+// a Team or Enterprise plan or a machine with managed settings, and its hooks
+// module answers every classic.* event with next.to(e, "append"): the event
+// jumps past the user tier, where a plugin you installed (this one) sits, so
+// none of our classic.* hooks run (Claude Code then says "leftoff: its
+// classic.Stop hook was skipped. "cc-plugin-sec-default" runs first and sent
+// the event on past it."). Our other events are untouched: session.start,
+// prompt.submit, turn.start, turn.complete, tool.check and tool.call.
+// So: each of those notes the classic event that should come with it; when it
+// doesn't come within the grace and no classic hook has run in this process at
+// all, the classic event counts as passed over and the daemon hears which.
+function sawClassic($, name) {
+  if (name === 'PermissionRequest') st.permAt = Date.now()
+  if (st.classicSeen) return
+  st.classicSeen = true
+  if (st.hooksSkipped && st.hooksSkipped.length) { // a slow SessionStart we counted out too early, a setting changed: they run
+    st.hooksSkipped = []
+    sendOrSpool($, 'heartbeat', { hooksSkipped: [], fromMod: true }).catch(() => {})
+  }
+}
+
+function expectClassic($, name, graceMs) {
+  if (st.classicSeen || st.internal) return
+  $.clock.after(graceMs || SKIP_GRACE_MS, () => { noteSkipped($, name).catch(() => {}) })
+}
+
+async function noteSkipped($, name) {
+  if (st.classicSeen || st.internal || !st.sessionId) return
+  const cur = st.hooksSkipped || []
+  if (cur.includes(name)) return
+  st.hooksSkipped = cur.concat(name)
+  await sendOrSpool($, 'heartbeat', { hooksSkipped: st.hooksSkipped, fromMod: true })
+}
+
+// A permission prompt, seen from tool.check: next(e) is the whole check
+// (rules, modes, other plugins' hooks, Claude Code's own), and { decision: "ask" }
+// with approver "person" is the terminal's permission dialog (a host such as
+// headless answers "host"; no approver means it is never asked). We only
+// look: the answer goes back as it came. Reported as Claude Code's own
+// permission_prompt notification would be, unless classic.PermissionRequest
+// ran for it (then permissionHook has put it on the board, answerable there).
+function watchAsk($, e) {
+  if (st.internal || st.headless || !st.sessionId) return
+  const at = Date.now()
+  const id = String(e.tool_use_id || (String(e.tool || '') + '@' + at))
+  st.watchAsks[id] = { tool: e.tool, at, reported: false, done: false }
+  expectClassic($, 'PermissionRequest')
+  $.clock.after(PERM_GRACE_MS, () => { reportAsk($, id, e).catch(() => {}) })
+}
+
+async function reportAsk($, id, e) {
+  const w = st.watchAsks[id]
+  if (!w || w.done) return
+  if (st.permAt >= w.at) { delete st.watchAsks[id]; return } // its PermissionRequest hook ran: the board has it
+  w.reported = true
+  await sendOrSpool($, 'notification', {
+    notificationType: 'permission_prompt', message: clip(askMessage(e.tool), 200), tool: e.tool || null, fromMod: true,
+    ...(st.hooksSkipped && st.hooksSkipped.length ? { hooksSkipped: st.hooksSkipped } : {}),
+  })
+}
+
+function askMessage(tool) {
+  if (tool === 'AskUserQuestion') return 'Claude has a question for you'
+  return 'Claude needs your permission to use ' + (tool || 'a tool')
+}
+
+// The prompt went away: the tool runs (tool.call) or the turn is over. Says so
+// only for prompts the mod reported (an activity the board reads as a tool
+// that ran, which ends "Needs you" for a permission prompt).
+async function settleAsks($, toolUseId, tool) {
+  let reported = false
+  for (const id of Object.keys(st.watchAsks)) {
+    const w = st.watchAsks[id]
+    if (toolUseId !== undefined && (toolUseId ? id !== String(toolUseId) : w.tool !== tool)) continue
+    w.done = true
+    if (w.reported) reported = true
+    delete st.watchAsks[id]
+  }
+  if (reported) await sendOrSpool($, 'activity', { kind: 'tool', phase: 'post', tool: tool || null, fromMod: true })
+}
+
 // The commands, in the order they're tried. Claude Code 2.1.295's built-ins
 // own /checkpoint (an alias of /rewind) and /name (an alias of /rename), so
 // ours share a /cp prefix; each command lists fallbacks in case a later
@@ -384,6 +477,20 @@ async function unlockOwnParkLocks($, cwd) {
   } catch {}
 }
 
+// ------------------------------------------------------------ decisions (2026-11-03)
+
+// The daemon's short read of this repo's accepted decisions (id + one line each, capped), or null:
+// nothing for Leftoff's own runs or a board-run headless session, when the daemon doesn't answer quickly,
+// or when the repo has none.
+const DECISIONS_TIMEOUT_MS = 800
+async function decisionContext($, e) {
+  if (st.internal || await isHeadless($)) return null
+  const q = '?session=' + encodeURIComponent(e.session_id || st.sessionId || '') + (e.cwd ? '&cwd=' + encodeURIComponent(e.cwd) : '')
+  const r = await api($, 'GET', '/v1/decisions/context' + q, undefined, DECISIONS_TIMEOUT_MS)
+  const t = r && r.ok && r.json && typeof r.json.context === 'string' ? r.json.context.trim() : ''
+  return t ? t.slice(0, 2000) : null
+}
+
 // ------------------------------------------------------------ lists (v0.5.1)
 
 // This session's saved lists, when they changed since Claude last heard
@@ -748,6 +855,7 @@ async function makeCheckpoint($, trigger, userNote, length, opts = {}) {
       doing: parsed.doing, stoppedAt: parsed.stoppedAt, next: parsed.next, openQuestion: parsed.openQuestion || null,
       userNote: userNote || null, filesTouched: ctx.filesTouched, turnsSinceLast: record.turnsSinceCheckpoint || 0,
       parseOk: parsed.parseOk, ...(parsed.format === 'markdown' ? { format: 'markdown' } : {}), generator, length: ctx.length,
+      decided: mergeDecided(ctx.found, generator && generator.by === 'heuristic' ? [] : parsed.decided, { earlier: st.lastCheckpoint && st.lastCheckpoint.decided }), // 2026-11-03 decision memory
       decisions: parsed.decisions || [], questions: parsed.questions || [], files: parsed.files || [],
       didntWork: parsed.didntWork || [], recap: parsed.recap || '', nextSteps: parsed.nextSteps || [],
     }
@@ -1042,6 +1150,7 @@ export function register(on, options) {
       st.heartbeat = $.clock.every(60000, () => { heartbeat($).catch(() => {}); startReplyLoop($) })
       st.ready = true
       startReplyLoop($)
+      expectClassic($, 'SessionStart', START_SKIP_GRACE_MS) // 2026-11-03 passed over? (sawClassic)
     } catch {}
     // Commands last, each on its own: a taken name throws, so a
     // clash costs only that command, and registerCommands reports it.
@@ -1050,6 +1159,7 @@ export function register(on, options) {
   })
 
   on('classic.SessionStart', async ($, e, next) => {
+    sawClassic($, 'SessionStart')
     if (!(await internalOnce($)) && !st.internal && e.session_id) {
       let parentSessionId
       if (st.sessionId && e.session_id !== st.sessionId) {
@@ -1077,11 +1187,20 @@ export function register(on, options) {
         const name = own && !own.id ? own.name : (own && own.name) || st.daemonTitle || null
         await applyTabTitle($, name, { force: !!parentSessionId, current: e.session_title || null })
       }
+      // 2026-11-03 decision memory: the repo's accepted decisions go to Claude as this event's context.
+      // Added to what the hooks below (yours included) answer, never in place of it.
+      const ctx = await decisionContext($, e)
+      if (ctx) {
+        const res = await next(e)
+        const r = res && typeof res === 'object' ? res : {}
+        return { ...r, additionalContext: [...(Array.isArray(r.additionalContext) ? r.additionalContext : []), ctx] }
+      }
     }
     return next(e)
   })
 
   on('classic.UserPromptSubmit', async ($, e, next) => {
+    sawClassic($, 'UserPromptSubmit')
     await sendOrSpool($, 'activity', { kind: 'prompt', prompt: clip(e.prompt || '', 300), sessionTitle: e.session_title && e.session_title === st.tabTitle ? null : e.session_title, ...moved(e) }) // our own /rename isn't a name you chose
     return next(e)
   })
@@ -1091,6 +1210,7 @@ export function register(on, options) {
   // context entry: the list, its numbers, and `leftoff todo done <list> <n>`.
   // Context goes on the event before next(); on the result it would be too late.
   on('prompt.submit', async ($, e, next) => {
+    expectClassic($, 'UserPromptSubmit')
     const ctx = await listContextFor($)
     return next(ctx ? { ...e, context: [...(Array.isArray(e.context) ? e.context : []), ctx] } : e)
   })
@@ -1104,6 +1224,7 @@ export function register(on, options) {
   on('turn.complete', async ($, e, next) => {
     // classic.Stop reports a normal end with its details; Stop doesn't fire for
     // an interrupted or failed turn, so those are reported here.
+    await settleAsks($, undefined).catch(() => {}) // 2026-11-03 a permission prompt the mod reported is over with the turn
     if (e.reason === 'aborted' || e.reason === 'error' || e.reason === 'refusal') await sendOrSpool($, 'turn_completed', { endReason: e.reason })
     // 2026-11-03 Claude Code doesn't run every Stop for every end of a turn
     // (2.1.317: a turn its loop ends runs Stop without the in-process hooks,
@@ -1111,11 +1232,12 @@ export function register(on, options) {
     // for good. If no Stop came for this turn shortly after it completed, the
     // end is reported from here; a Stop that comes later is the same turn
     // (the daemon doesn't count it twice).
-    else { const at = Date.now(); $.clock.after(STOP_GRACE_MS, () => { stopFallback($, at, e.reason).catch(() => {}) }) }
+    else { const at = Date.now(); $.clock.after(STOP_GRACE_MS, () => { stopFallback($, at, e.reason).catch(() => {}) }); expectClassic($, 'Stop') }
     return next(e)
   })
 
   on('classic.Stop', async ($, e, next) => {
+    sawClassic($, 'Stop')
     st.stopAt = Date.now()
     // v0.5.1: a checklist of 3+ in this reply (a cheap regex, no model) -> the
     // board's card offers "Claude wrote a 7-step list · Save". Nothing is saved here.
@@ -1140,20 +1262,36 @@ export function register(on, options) {
   })
 
   on('classic.Notification', async ($, e, next) => {
+    sawClassic($, 'Notification')
     await sendOrSpool($, 'notification', { notificationType: e.notification_type || null, message: clip(e.message || '', 200), ...moved(e) })
     return next(e)
   })
 
-  on('classic.PermissionRequest', permissionHook)
+  on('classic.PermissionRequest', async ($, e, next) => { sawClassic($, 'PermissionRequest'); return permissionHook($, e, next) })
+
+  // 2026-11-03 a permission prompt, seen whether or not classic.PermissionRequest
+  // reaches us (see watchAsk): we only look, and hand the answer back as it came.
+  on('tool.check', async ($, e, next) => {
+    const r = await next(e)
+    try { if (r && r.decision === 'ask' && e && e.approver === 'person') watchAsk($, e) } catch {}
+    return r
+  })
+
+  // The tool runs: a prompt the mod reported for it was answered in the terminal.
+  on('tool.call', async ($, e, next) => {
+    if (e && Object.keys(st.watchAsks).length) await settleAsks($, e.tool_use_id || null, e.tool).catch(() => {})
+    return next(e)
+  })
 
   on('classic.PostToolUse', async ($, e, next) => {
+    sawClassic($, 'PostToolUse')
     await toolRan($, e)
     const m = moved(e) // EnterWorktree, or a cd: say so now, not at the end of the turn
     if (m.cwd || m.transcriptPath) await sendOrSpool($, 'activity', { kind: 'cwd', ...m })
     return next(e)
   })
 
-  on('classic.PostToolUseFailure', async ($, e, next) => { await toolRan($, e); return next(e) })
+  on('classic.PostToolUseFailure', async ($, e, next) => { sawClassic($, 'PostToolUseFailure'); await toolRan($, e); return next(e) })
 
   on('session.end', async ($, e, next) => {
     // About 1.5 s shared by every SessionEnd hook: post and go. The daemon makes

package/mod/skills/walkthrough/SKILL.md

@@ -11,10 +11,12 @@ How to walk through a change:
 
 1. Order the steps the way the change makes sense to read: the core idea first, then what follows from it. Not file order.
 2. Each step gets a short title and one or two sentences of why: the request it answers, the bug it fixes, or the trade-off you chose and the alternative you didn't take.
-3. Mark what matters. A step that changes behaviour is Core; a small follow-on (config, docs, a helper, a rename) is Supporting. Tests that only follow along, imports and formatting are mechanical and need no story.
+3. Mark what matters. A step that changes behaviour is Core; a small follow-on (config, docs, a helper, a rename) is Supporting. Tests that only follow along (updated to match the change), imports and formatting are mechanical and need no story.
+   - A test that doesn't really test anything is never mechanical and never safe to skip. That is a test that asserts nothing meaningful or asserts a tautology, mocks the very thing under test, snapshots its own output, had an assertion loosened or deleted to make it pass, or was skipped or disabled. Put it in a step and give it a look callout at its line saying why.
 4. Point out what deserves a second look, at the exact line: something risky or subtle (look), a guess the code makes (assumption), or behaviour no test covers (untested). Be honest about the parts you were unsure of.
-5. Never paste code. Point at it.
+5. Cite the decisions behind a step. When Leftoff lists the repo's accepted decisions (D-7f3a: …), a step may name the ones it follows or changes ("decisions": ["D-7f3a"]), using only ids from that list. A step that reverses or departs from an accepted decision gets a look callout at its line naming the decision and how it departs.
+6. Never paste code. Point at it.
 
-When Leftoff asks (the request lists hunks H1…Hn and a JSON shape): reply with that JSON object only, no prose and no code fences. Every ref is a hunk id from the list ("H3", "H3:new 14-19", "H3:old 7"); never invent ids or line numbers; put every hunk in a step or in mechanical. You may read files with Read, Grep and Glob to check details; change nothing.
+When Leftoff asks (the request lists hunks H1…Hn and a JSON shape): reply with that JSON object only, no prose and no code fences. Every ref is a hunk id from the list ("H3", "H3:new 14-19", "H3:old 7"); never invent ids or line numbers; put every hunk in a step or in mechanical. A step's "decisions" are ids from the decisions listed, never made up. You may read files with Read, Grep and Glob to check details; change nothing.
 
 When the developer asks in the terminal: give the same walkthrough as a short numbered list (title, why, file:line for each step, then what to look at closely).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leftoff/cli",
-  "version": "0.9.18-beta.4",
+  "version": "0.9.18-beta.6",
   "description": "Leftoff: WTF was I working on? Tracks every Claude Code session, writes a 3-line checkpoint when one goes quiet, and gives you a daily digest and a board, on your Mac and (optionally) your phone.",
   "keywords": [
     "claude",