@leftoff/cli 0.9.4 → 0.9.5

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

@@ -1,6 +1,6 @@
 {
   "name": "leftoff",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "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": "Joel"

package/mod/hooks/core.js

@@ -293,7 +293,7 @@ export function parseFrontmatter(text) {
 // ---------------------------------------------------------------- checkpoint markdown
 
 const CP_ORDER = ['id', 'session_id', 'session_title', 'created_at', 'trigger', 'machine', 'repo', 'branch', 'cwd',
-  'files_touched', 'turns_since_last', 'user_note', 'open_question', 'parse_ok', 'length', 'generator', 'schema']
+  'files_touched', 'turns_since_last', 'user_note', 'open_question', 'parse_ok', 'format', 'length', 'generator', 'schema']
 
 export function resumeCommand(session) {
   const id = session.id || session.sessionId
@@ -459,14 +459,18 @@ export function renderCheckpointMd(cp) {
     user_note: cp.userNote || undefined,
     open_question: cp.openQuestion || undefined,
     parse_ok: cp.parseOk === false ? false : undefined,
+    format: cp.format === 'markdown' ? 'markdown' : undefined,
     length: cp.length && SUMMARY_LENGTHS[cp.length] ? cp.length : undefined,
     generator: cp.generator ? toSnake(cp.generator) : { by: 'unknown' },
     schema: SCHEMA,
   }
+  // 0.9.5: a markdown checkpoint keeps its lines: the ones after the first are
+  // indented two spaces under their label (older readers take the first line).
+  const field = cp.format === 'markdown' ? mdField : oneLine
   const lines = [
-    '**Doing:** ' + oneLine(cp.doing),
-    '**Stopped at:** ' + oneLine(cp.stoppedAt),
-    '**Next:** ' + oneLine(cp.next),
+    '**Doing:** ' + field(cp.doing),
+    '**Stopped at:** ' + field(cp.stoppedAt),
+    '**Next:** ' + field(cp.next),
   ]
   if (cp.openQuestion) lines.push('**Open question:** ' + oneLine(cp.openQuestion))
   if (cp.userNote) lines.push('**Note:** ' + oneLine(cp.userNote))
@@ -487,6 +491,7 @@ export function renderCheckpointMd(cp) {
 }
 
 function oneLine(s) { return String(s == null ? '' : s).replace(/\s*\n\s*/g, ' ').trim() }
+function mdField(s) { return String(s == null ? '' : s).replace(/\r\n?/g, '\n').trim().split('\n').map((l, i) => (i ? '  ' + l.replace(/\s+$/, '') : l)).join('\n') }
 
 const BODY_FIELDS = { 'doing': 'doing', 'stopped at': 'stoppedAt', 'next': 'next', 'open question': 'openQuestion', 'note': 'userNote' }
 
@@ -507,20 +512,25 @@ export function parseCheckpointMd(text) {
     userNote: data.user_note || null,
     openQuestion: data.open_question || null,
     parseOk: data.parse_ok === false ? false : true,
+    ...(data.format === 'markdown' ? { format: 'markdown' } : {}),
     generator: data.generator && typeof data.generator === 'object' ? toCamel(data.generator) : { by: 'unknown' },
     length: data.length && SUMMARY_LENGTHS[data.length] ? data.length : null,
     doing: '', stoppedAt: '', next: '',
   }
   const lines = body.split('\n')
   let k = 0
+  let open = null // 0.9.5: the field a markdown checkpoint's indented lines continue
   for (; k < lines.length; k++) {
     const line = lines[k]
+    if (open && cp.format === 'markdown' && (/^  /.test(line) || (!line.trim() && /^  \S/.test(lines.slice(k + 1).find((x) => x.trim()) || '')))) { cp[open] += '\n' + line.slice(2); continue }
+    open = null
     if (/^###\s/.test(line)) break // the sections of an informative / long checkpoint
     const m = line.match(/^\s*\*\*([A-Za-z ]+):\*\*\s*(.*)$/)
     if (!m) continue
     const f = BODY_FIELDS[m[1].trim().toLowerCase()]
-    if (f) cp[f] = m[2].trim()
+    if (f) { cp[f] = m[2].trim(); open = f }
   }
+  if (cp.format === 'markdown') for (const f of ['doing', 'stoppedAt', 'next']) cp[f] = cp[f].replace(/\n{3,}/g, '\n\n').trim()
   const sec = []
   for (; k < lines.length; k++) { if (/^Resume: `/.test(lines[k])) break; sec.push(lines[k]) }
   Object.assign(cp, parseSections(sec))
@@ -1348,12 +1358,68 @@ export function parseCheckpointReply(text) {
     else rest.push(raw)
   }
   if (!out.doing || !out.stoppedAt || !out.next) {
-    return { doing: clip(text, 600) || '(empty reply)', stoppedAt: out.stoppedAt || '', next: out.next || '', title: out.title, openQuestion: null, parseOk: false, ...emptyExtras() }
+    // 0.9.5: not the format asked for (a small model's markdown write-up): read what we can
+    // from its headings and labels, keep the whole text (no 600-character cut), mark it.
+    return { ...salvageCheckpointReply(text), title: out.title ? clip(out.title.replace(/^["']|["']$/g, ''), 60) : null }
   }
   if (out.title) out.title = clip(out.title.replace(/^["']|["']$/g, ''), 60)
   return { ...out, ...parseSections(rest) }
 }
 
+// 0.9.5: a reply that didn't follow the format, read leniently. Headings
+// (### Summary), bold labels (**Status:** …, **Next steps**) and plain labels
+// (Next: …) map onto the three fields; whatever doesn't map stays in Doing.
+// The markdown is kept as written (the session page renders it; cards and the
+// digest strip it), up to MD_CAP characters a field.
+export const MD_CAP = 8000
+const SALVAGE_KEYS = [
+  ['doing', /^(doing|what i'?m doing|what i am doing|working on|what was being done|summary|overview|tl;?dr|current (task|work|focus)|task|goal|context|what happened|background)$/],
+  ['stoppedAt', /^(stopped( at)?|where (it|we|i|things) (stopped|left off|stands?)|left off|status|current status|state|current state|progress|where things stand|last step|result|results|outcome)$/],
+  ['next', /^(next|next steps?|what'?s next|to ?dos?|todo list|next actions?|remaining( work)?|follow[- ]?ups?|action items?|recommendations?)$/],
+]
+function salvageKey(label) {
+  const l = String(label || '').replace(/[’`]/g, '\'').replace(/\*\*|__/g, '').replace(/^[^A-Za-z]+/, '').replace(/[\s:.\-–—]+$/, '').trim().toLowerCase()
+  if (!l || l.length > 40) return null
+  // "Session summary", "Summary of the session", "Current status", "Next steps for the PR"
+  const core_ = l.replace(/^(the|my|our|session|current|work|overall)\s+/, '').replace(/\s+(of|for|on|so far|in)\b.*$/, '').trim()
+  for (const [k, re] of SALVAGE_KEYS) if (re.test(l) || re.test(core_)) return k
+  return null
+}
+const capText = (s) => { const t = String(s || '').replace(/\n{3,}/g, '\n\n').trim(); return t.length > MD_CAP ? t.slice(0, MD_CAP - 1).trimEnd() + '…' : t }
+export function salvageCheckpointReply(text) {
+  const buckets = { doing: [], stoppedAt: [], next: [], rest: [] }
+  let cur = 'rest'
+  for (const raw of String(text || '').replace(/\r\n?/g, '\n').split('\n')) {
+    const line = raw.replace(/\s+$/, '')
+    let m
+    if ((m = line.match(/^\s{0,3}#{1,6}\s+(.*?)\s*#*$/))) {
+      const k = salvageKey(m[1])
+      if (k) { cur = k; continue }
+      cur = 'rest'; buckets.rest.push(line); continue
+    }
+    if ((m = line.match(/^\s*(?:[-*+]\s+)?(?:\*\*|__)([^*_]{1,40}?)(?:\*\*|__)\s*(:?)\s*(.*)$/))) {
+      const label = m[1].replace(/:\s*$/, '')
+      const k = (m[1].trim().endsWith(':') || m[2] || !m[3]) ? salvageKey(label) : null
+      if (k) { cur = k; if (m[3].trim()) buckets[k].push(m[3].trim()); continue }
+    }
+    if ((m = line.match(/^\s*([A-Za-z][A-Za-z '’]{1,30}):\s*(.*)$/))) {
+      const k = salvageKey(m[1])
+      if (k) { cur = k; if (m[2].trim()) buckets[k].push(m[2].trim()); continue }
+    }
+    buckets[cur].push(line)
+  }
+  const doing = capText([...buckets.doing, ...(buckets.doing.length && buckets.rest.some((x) => x.trim()) ? [''] : []), ...buckets.rest].join('\n'))
+  return { doing: doing || '(empty reply)', stoppedAt: capText(buckets.stoppedAt.join('\n')), next: capText(buckets.next.join('\n')), title: null, openQuestion: null, parseOk: false, format: 'markdown', ...emptyExtras() }
+}
+// Of two salvaged replies (the first and the retry's), the one that filled more fields.
+export function betterSalvage(a, b) {
+  const score = (r) => (r && r.stoppedAt ? 1 : 0) + (r && r.next ? 1 : 0)
+  return score(b) > score(a) ? b : a
+}
+// The retry's prompt: the same request, with the format restated plainly.
+export const RETRY_REMINDER = '\n\nIMPORTANT: your reply must use exactly this format, starting with the first line. No headings (#), no bold (**), no preamble:\nDoing: <one or two sentences>\nStopped at: <one or two sentences>\nNext: <one sentence>\n(Then the section headings above, if this length asks for them.)'
+export const retryCheckpointPrompt = (prompt) => String(prompt || '') + RETRY_REMINDER
+
 // 0.9.2: a checkpoint written with nothing to go on: no prompt and no reply were
 // found (the heuristic's placeholder lines). Never saved; old ones are set aside.
 export function isEmptyCheckpoint(cp) {

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, heuristicCheckpoint, isEmptyCheckpoint, NOTHING_TO_CHECKPOINT, renderCheckpointMd, checkpointId, checkpointFileName,
+  parseCheckpointReply, retryCheckpointPrompt, betterSalvage, heuristicCheckpoint, isEmptyCheckpoint, NOTHING_TO_CHECKPOINT, renderCheckpointMd, checkpointId, checkpointFileName,
   sessionFolderName, id8, clip, toIso, resumeCommand, repoName,
   shortId, formatTabTitle, parseTabTitle, detectTerminal, parseProcLine, trailingQuestion,
   parseCheckpointArgs, SUMMARY_LENGTHS, parseBulletList, parseCatchupArgs,
@@ -28,7 +28,7 @@ const END_TIMEOUT_MS = 1000
 const MODEL_TIMEOUT_MS = 20000
 
 // Module state. $.state is not used: the pane redraws with $.ui.invalidate.
-const MOD_VERSION = '0.9.4' // keep in step with .claude-plugin/plugin.json
+const MOD_VERSION = '0.9.5' // keep in step with .claude-plugin/plugin.json
 
 const st = {
   internal: false,
@@ -645,6 +645,14 @@ async function makeCheckpoint($, trigger, userNote, length, opts = {}) {
     const reply = await callModel($, ctx)
     let parsed = reply ? parseCheckpointReply(reply.text) : null
     let generator = reply ? { by: 'mod', model: reply.model, ...(reply.backend ? { backend: reply.backend } : {}) } : null
+    // 0.9.5: a reply not in the format (a markdown write-up): ask once more, with the format restated
+    if (parsed && parsed.parseOk === false) {
+      const again = await callModel($, { ...ctx, prompt: retryCheckpointPrompt(ctx.prompt) })
+      const p2 = again ? parseCheckpointReply(again.text) : null
+      if (p2 && p2.parseOk !== false) parsed = p2
+      else if (p2) parsed = betterSalvage(parsed, p2)
+      generator = { ...generator, retried: true }
+    }
     if (!parsed) {
       // No model answer: let the daemon try its own summarizer, if it's there.
       const r = await api($, 'POST', '/v1/sessions/' + encodeURIComponent(st.sessionId) + '/checkpoints', { trigger, generate: true, userNote: userNote || undefined, length: ctx.length, next: opts.next || undefined }, MODEL_TIMEOUT_MS * 3)
@@ -660,7 +668,7 @@ async function makeCheckpoint($, trigger, userNote, length, opts = {}) {
       sessionTitle: record.title || null, repo: record.repo ? repoName(record) : null, branch: (record.repo && record.repo.branch) || null, cwd: record.cwd || null,
       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, generator, length: ctx.length,
+      parseOk: parsed.parseOk, ...(parsed.format === 'markdown' ? { format: 'markdown' } : {}), generator, length: ctx.length,
       decisions: parsed.decisions || [], questions: parsed.questions || [], files: parsed.files || [],
       didntWork: parsed.didntWork || [], recap: parsed.recap || '', nextSteps: parsed.nextSteps || [],
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leftoff/cli",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "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",

package/ui/app.css

@@ -1106,6 +1106,11 @@ lo-combo .lo-combo-input:focus { outline: none; border-color: var(--accent); box
 .form .set-pane > .section:first-child { border-top: 0; padding-top: 0; margin-top: 0; }
 .form .set-save { align-items: center; justify-content: flex-end; flex-wrap: wrap; border-top: 1px solid var(--line); padding-top: 14px; }
 .form .set-save .faint { color: var(--faint); font-size: 12px; margin-right: auto; }
+/* 0.9.5: Save is off until something changes. Off reads as a plain grey button, still legible. */
+.form .set-save .btn.primary { transition: background-color .15s, border-color .15s, color .15s; }
+.form .set-save .btn.primary:disabled { background: var(--bg2); border-color: var(--line); color: var(--muted); font-weight: 500; opacity: 1; cursor: default; filter: none; }
+.form .set-save.dirty .faint { color: var(--muted); }
+@media (prefers-reduced-motion: reduce) { .form .set-save .btn.primary { transition: none; } }
 .form .set-empty, .form .set-link { grid-column: 1 / -1; margin-top: 0; }
 .form .aboutline { display: flex; align-items: center; gap: 6px 14px; flex-wrap: wrap; }
 .form .aboutline a { color: var(--accent); text-decoration: none; }
@@ -1431,8 +1436,7 @@ a.cpr:hover { border-color: var(--line-strong); }
 .pr-sess .sesslink::before { content: '↳ '; color: var(--faint); }
 .pr-actions { display: flex; flex-direction: column; gap: 6px; flex: none; align-items: stretch; }
 .prlist { margin-bottom: 8px; }
-.prlink { display: flex; gap: 8px; margin: 6px 0 16px; }
-.prlink input { flex: 1 1 auto; min-width: 0; font-size: 16px; }
+.prlink { margin: 6px 0 16px; }
 .prs-gh { margin-top: 6px; }
 .prs-foot { font-size: 12px; margin-top: 6px; }
 /* 0.8.5: PR filters (search, repo chips, state/check chips), the why, Quiet, details on tap */
@@ -1532,9 +1536,11 @@ li.todo.ticked .todo-text { text-decoration: line-through; }
 .todo-code code { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; min-width: 0; }
 .todo-code .todo-cp { flex: none; font-size: 11.5px; color: var(--accent); }
 .todo-meta { margin-top: 3px; font-size: 12px; color: var(--faint); }
-.todo-add { display: flex; gap: 8px; margin-top: 10px; }
-.todo-add input { flex: 1; min-width: 0; font-size: 16px; padding: 9px 12px; border-radius: 10px; border: 1px solid var(--line); background: var(--field); color: var(--text); }
-.todo-add input:focus { outline: none; border-color: var(--accent); box-shadow: 0 0 0 3px var(--focus); }
+/* 0.9.5: the session page's inline fields (Add a to-do, Link a PR) share one look */
+.sess-add { display: flex; gap: 8px; align-items: center; }
+.sess-add input { flex: 1; min-width: 0; font-size: 16px; padding: 9px 12px; border-radius: 10px; border: 1px solid var(--line); background: var(--field); color: var(--text); }
+.sess-add input:focus { outline: none; border-color: var(--accent); box-shadow: 0 0 0 3px var(--focus); }
+.todo-add { margin-top: 10px; }
 /* 0.8.2: Parked */
 .s-parked { color: var(--accent); background: var(--tint-accent); }
 .parked-sec { margin-top: 22px; }
@@ -1833,3 +1839,42 @@ html.dv-open .lo-menu { z-index: 62; }
 .statuspop .sp-theme .theme { flex: 1 1 100%; display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); flex-wrap: nowrap; }
 .statuspop .sp-theme .theme button { justify-content: center; white-space: nowrap; min-width: 0; height: 30px; padding: 0 6px; }
 @media (pointer: coarse) { .statuspop .sp-theme .theme button { height: 36px; font-size: 13px; } }
+
+/* 0.9.5: Checkpoint now while it's written: a line that stays until it lands or fails */
+.cp-writing { display: flex; align-items: center; gap: 8px; font-size: 12.5px; color: var(--muted); background: var(--tint-accent); border: 1px solid var(--line); border-radius: 10px; padding: 7px 10px; min-height: 34px; }
+.card > .cp-writing { margin-top: 8px; }
+.cp-stale > .cp { margin-top: 0; }
+.cp-writing .wtext { flex: 1; min-width: 0; overflow-wrap: anywhere; }
+.cp-writing.writing .wtext, .cp-writing.syncing .wtext { color: var(--text); font-weight: 500; }
+.cp-writing .ic { width: 14px; height: 14px; flex: none; }
+.cp-writing.late { background: var(--subtle); color: var(--faint); }
+.cp-writing.failed { background: var(--tint-red); border-color: transparent; color: var(--red); }
+.cp-writing.failed .wtext { color: var(--red); }
+.cp-writing .wx { margin-left: auto; color: inherit; opacity: .8; min-width: 28px; min-height: 28px; display: inline-flex; align-items: center; justify-content: center; }
+.cp-writing .wx:hover { opacity: 1; }
+.cp-writing.tl { margin: 0; }
+.cp-stale { opacity: .45; transition: opacity .2s; }
+.tl-item.tl-writing { padding-top: 2px; }
+.split.is-writing .split-main { gap: 7px; }
+.split.is-writing .btn:disabled { opacity: .8; cursor: progress; }
+.split.is-writing .spin { width: 12px; height: 12px; border-color: color-mix(in srgb, var(--on-accent) 35%, transparent); border-top-color: var(--on-accent); }
+@keyframes cpfresh { 0%, 60% { background-color: var(--tint-accent); box-shadow: 0 0 0 4px var(--tint-accent); } 100% { background-color: transparent; box-shadow: 0 0 0 4px transparent; } }
+.cp-fresh > .cp, .tl-item.cp-fresh { animation: cpfresh 2.4s ease-out; border-radius: 10px; }
+@media (prefers-reduced-motion: reduce) { .cp-fresh > .cp, .tl-item.cp-fresh { animation: none; } .cp-writing.writing .spin, .cp-writing.syncing .spin { animation: pulse 1.6s ease-in-out infinite; } .cp-stale { transition: none; } }
+
+/* 0.9.5: a markdown checkpoint (a model's write-up) rendered on the session page; elsewhere a long one is clamped */
+.cp dd.clamp { display: -webkit-box; -webkit-box-orient: vertical; -webkit-line-clamp: 4; line-clamp: 4; overflow: hidden; }
+.cp dd.cp-md { min-width: 0; overflow-wrap: anywhere; }
+.cp dd.cp-md > :first-child { margin-top: 0; }
+.cp dd.cp-md > :last-child { margin-bottom: 0; }
+.cp dd.cp-md p { margin: 0 0 6px; }
+.cp dd.cp-md h2, .cp dd.cp-md h3, .cp dd.cp-md h4, .cp dd.cp-md h5, .cp dd.cp-md h6 { font-size: 13px; font-weight: 650; color: var(--text); margin: 10px 0 4px; letter-spacing: 0; text-transform: none; }
+.cp dd.cp-md ul, .cp dd.cp-md ol { margin: 2px 0 6px; padding-left: 18px; }
+.cp dd.cp-md li { margin: 2px 0; }
+.cp dd.cp-md li > ul, .cp dd.cp-md li > ol { margin: 2px 0; }
+.cp dd.cp-md code { font-family: var(--mono); font-size: 12px; background: var(--tint-gray); padding: 1px 4px; border-radius: 4px; }
+.cp dd.cp-md pre { overflow-x: auto; background: var(--subtle); border: 1px solid var(--line); border-radius: 8px; padding: 8px 10px; margin: 4px 0 8px; }
+.cp dd.cp-md pre code { background: none; padding: 0; }
+.cp dd.cp-md a { color: var(--accent); }
+.cp dd.cp-md blockquote { margin: 4px 0; padding-left: 10px; border-left: 2px solid var(--line-strong); color: var(--muted); }
+.cp dd.cp-md hr { border: 0; border-top: 1px solid var(--line); margin: 8px 0; }