@staff0rd/assist 0.196.1 → 0.197.0

package/README.md

@@ -195,6 +195,7 @@ After installation, the `assist` command will be available globally. You can als
 - `assist voice logs [-n <count>]` - Show recent voice daemon log entries
 - `assist sessions` - Start the sessions web dashboard (same as `sessions web`)
 - `assist sessions web [-p, --port <number>]` - Start a web dashboard for Claude Code sessions with xterm.js terminals (default port 3100)
+- `assist sessions summarise [-f, --force] [-n, --limit <count>]` - Generate one-line summaries for unsummarised Claude sessions (force re-generates all; limit caps how many to process)
 - `assist next` - Alias for `backlog next -w`
 - `assist draft` (alias: `feat`) - Launch Claude in `/draft` mode, chain into next on `/next` signal
 - `assist bug` - Launch Claude in `/bug` mode, chain into next on `/next` signal

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.196.1",
+  version: "0.197.0",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -12590,11 +12590,319 @@ function screenshot(processName) {
   }
 }
 
+// src/commands/sessions/summarise/index.ts
+import * as fs27 from "fs";
+import chalk134 from "chalk";
+
+// src/commands/sessions/web/discoverSessions.ts
+import * as fs24 from "fs";
+import * as os from "os";
+import * as path47 from "path";
+
+// src/commands/sessions/web/parseSessionFile.ts
+import * as fs23 from "fs";
+import * as path46 from "path";
+
+// src/commands/sessions/web/extractSessionMeta.ts
+function extractSessionMeta(lines) {
+  let sessionId = "";
+  let cwd = "";
+  let timestamp = "";
+  let name = "";
+  for (const line of lines) {
+    const entry = safeParse(line);
+    if (!entry) continue;
+    sessionId ||= typeof entry.sessionId === "string" ? entry.sessionId : "";
+    timestamp ||= typeof entry.timestamp === "string" ? entry.timestamp : "";
+    cwd ||= typeof entry.cwd === "string" ? entry.cwd : "";
+    if (entry.type === "user" && !entry.isMeta) {
+      name = extractName(entry);
+      break;
+    }
+  }
+  return { sessionId, cwd, timestamp, name };
+}
+function safeParse(line) {
+  try {
+    return JSON.parse(line);
+  } catch {
+    return null;
+  }
+}
+function extractName(entry) {
+  const msg = entry.message;
+  const content = msg?.content;
+  const text = typeof content === "string" ? content : Array.isArray(content) ? content.find((c) => c.type === "text")?.text ?? "" : "";
+  return text.replace(/<command-[^>]*>[^<]*<\/command-[^>]*>/g, "").trim().slice(0, 80);
+}
+
+// src/commands/sessions/web/parseSessionFile.ts
+async function parseSessionFile(filePath) {
+  let handle;
+  try {
+    handle = await fs23.promises.open(filePath, "r");
+    const buf = Buffer.alloc(16384);
+    const { bytesRead } = await handle.read(buf, 0, buf.length, 0);
+    const lines = buf.toString("utf8", 0, bytesRead).split("\n").filter(Boolean);
+    const meta = extractSessionMeta(lines);
+    if (!meta.sessionId) return null;
+    const timestamp = meta.timestamp || (await fs23.promises.stat(filePath)).mtime.toISOString();
+    const project = meta.cwd ? path46.basename(meta.cwd) : dirNameToProject(filePath);
+    return {
+      sessionId: meta.sessionId,
+      name: meta.name || `Session ${meta.sessionId.slice(0, 8)}`,
+      project,
+      cwd: meta.cwd,
+      timestamp
+    };
+  } catch {
+    return null;
+  } finally {
+    await handle?.close();
+  }
+}
+function dirNameToProject(filePath) {
+  const dirName = path46.basename(path46.dirname(filePath));
+  const parts = dirName.split("--");
+  return parts[parts.length - 1].replace(/-/g, "/");
+}
+
+// src/commands/sessions/web/discoverSessions.ts
+async function discoverSessionJsonlPaths() {
+  const projectsDir = path47.join(os.homedir(), ".claude", "projects");
+  let projectDirs;
+  try {
+    projectDirs = await fs24.promises.readdir(projectsDir);
+  } catch {
+    return [];
+  }
+  const paths = [];
+  await Promise.all(
+    projectDirs.map(async (dirName) => {
+      const dirPath = path47.join(projectsDir, dirName);
+      let entries;
+      try {
+        entries = await fs24.promises.readdir(dirPath);
+      } catch {
+        return;
+      }
+      const jsonlFiles = entries.filter((e) => e.endsWith(".jsonl"));
+      for (const file of jsonlFiles) {
+        paths.push(path47.join(dirPath, file));
+      }
+    })
+  );
+  return paths;
+}
+async function discoverSessions() {
+  const paths = await discoverSessionJsonlPaths();
+  const sessions = [];
+  await Promise.all(
+    paths.map(async (filePath) => {
+      const session = await parseSessionFile(filePath);
+      if (session) sessions.push(session);
+    })
+  );
+  sessions.sort(
+    (a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime()
+  );
+  return sessions;
+}
+
+// src/commands/sessions/summarise/shared.ts
+import * as fs25 from "fs";
+function writeSummary(jsonlPath, summary) {
+  fs25.writeFileSync(summaryPathFor(jsonlPath), `${summary.trim()}
+`, "utf8");
+}
+function hasSummary(jsonlPath) {
+  return fs25.existsSync(summaryPathFor(jsonlPath));
+}
+function summaryPathFor(jsonlPath) {
+  return jsonlPath.replace(/\.jsonl$/, ".summary");
+}
+
+// src/commands/sessions/summarise/summariseSession.ts
+import { execFileSync as execFileSync2 } from "child_process";
+
+// src/commands/sessions/summarise/iterateUserMessages.ts
+import * as fs26 from "fs";
+function* iterateUserMessages(filePath, maxBytes = 65536) {
+  let content;
+  try {
+    const fd = fs26.openSync(filePath, "r");
+    try {
+      const buf = Buffer.alloc(maxBytes);
+      const bytesRead = fs26.readSync(fd, buf, 0, buf.length, 0);
+      content = buf.toString("utf8", 0, bytesRead);
+    } finally {
+      fs26.closeSync(fd);
+    }
+  } catch {
+    return;
+  }
+  for (const line of content.split("\n")) {
+    if (!line) continue;
+    let entry;
+    try {
+      entry = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    if (entry.type !== "user") continue;
+    const msg = entry.message;
+    const c = msg?.content;
+    if (typeof c === "string") {
+      yield c;
+    } else if (Array.isArray(c)) {
+      const text = c.filter((b) => b.type === "text").map((b) => b.text ?? "").join("\n");
+      if (text) yield text;
+    }
+  }
+}
+
+// src/commands/sessions/summarise/extractFirstUserMessage.ts
+function extractFirstUserMessage(filePath) {
+  for (const text of iterateUserMessages(filePath)) {
+    return truncate2(text);
+  }
+  return void 0;
+}
+function truncate2(text, maxChars = 500) {
+  const trimmed = text.trim();
+  if (trimmed.length <= maxChars) return trimmed;
+  return `${trimmed.slice(0, maxChars)}\u2026`;
+}
+
+// src/commands/sessions/summarise/scanSessionBacklogRefs.ts
+function scanSessionBacklogRefs(filePath) {
+  const ids = /* @__PURE__ */ new Set();
+  for (const text of iterateUserMessages(filePath, Number.MAX_SAFE_INTEGER)) {
+    for (const id of extractBacklogIds(text)) {
+      ids.add(id);
+    }
+  }
+  return [...ids].sort((a, b) => a - b);
+}
+function extractBacklogIds(text) {
+  const ids = [];
+  for (const m of text.matchAll(/backlog\s+run\s+(\d+)/gi)) {
+    ids.push(Number.parseInt(m[1], 10));
+  }
+  for (const m of text.matchAll(/backlog\s+(?:item\s+)?#(\d+)/gi)) {
+    ids.push(Number.parseInt(m[1], 10));
+  }
+  for (const m of text.matchAll(/backlog\s+phase-done\s+(\d+)/gi)) {
+    ids.push(Number.parseInt(m[1], 10));
+  }
+  for (const m of text.matchAll(/backlog\s+comment\s+(\d+)/gi)) {
+    ids.push(Number.parseInt(m[1], 10));
+  }
+  for (const m of text.matchAll(/(?:^|[\s(])#(\d{1,4})(?=[\s).,;:!?]|$)/gm)) {
+    ids.push(Number.parseInt(m[1], 10));
+  }
+  return ids;
+}
+
+// src/commands/sessions/summarise/summariseSession.ts
+function summariseSession(jsonlPath) {
+  const firstMessage = extractFirstUserMessage(jsonlPath);
+  const backlogIds = scanSessionBacklogRefs(jsonlPath);
+  if (!firstMessage && backlogIds.length === 0) {
+    return void 0;
+  }
+  const prompt = buildPrompt2(firstMessage, backlogIds);
+  try {
+    const output = execFileSync2("claude", ["-p", "--model", "haiku", prompt], {
+      encoding: "utf8",
+      timeout: 3e4,
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    const summary = output.trim();
+    if (!summary) return void 0;
+    return summary.split("\n")[0].replace(/^["']|["']$/g, "").trim();
+  } catch {
+    return void 0;
+  }
+}
+function buildPrompt2(firstMessage, backlogIds) {
+  const parts = [
+    "Summarise this Claude Code session in ONE short sentence (under 100 chars).",
+    "Return ONLY the summary, no quotes or explanation."
+  ];
+  if (backlogIds.length > 0) {
+    const refs = backlogIds.map((id) => `#${id}`).join(", ");
+    parts.push(
+      `The session references backlog item(s) ${refs}. Start the summary with "Backlog ${refs} \u2014" if relevant.`
+    );
+  }
+  if (firstMessage) {
+    parts.push(`First user message:
+${firstMessage}`);
+  }
+  return parts.join("\n");
+}
+
+// src/commands/sessions/summarise/index.ts
+async function summarise3(options2) {
+  const files = await discoverSessionJsonlPaths();
+  if (files.length === 0) {
+    console.log(chalk134.yellow("No sessions found."));
+    return;
+  }
+  const toProcess = selectCandidates(files, options2);
+  if (toProcess.length === 0) {
+    console.log(chalk134.green("All sessions already summarised."));
+    return;
+  }
+  console.log(
+    chalk134.cyan(
+      `Summarising ${toProcess.length} session(s) (${files.length} total)\u2026`
+    )
+  );
+  const { succeeded, failed } = processSessions(toProcess);
+  console.log(
+    chalk134.green(`Done: ${succeeded} summarised`) + (failed > 0 ? chalk134.yellow(`, ${failed} skipped`) : "")
+  );
+}
+function selectCandidates(files, options2) {
+  const candidates = options2.force ? files : files.filter((f) => !hasSummary(f));
+  candidates.sort((a, b) => {
+    try {
+      return fs27.statSync(b).mtimeMs - fs27.statSync(a).mtimeMs;
+    } catch {
+      return 0;
+    }
+  });
+  const limit = options2.limit ? Number.parseInt(options2.limit, 10) : void 0;
+  return limit && limit > 0 ? candidates.slice(0, limit) : candidates;
+}
+function processSessions(files) {
+  let succeeded = 0;
+  let failed = 0;
+  for (let i = 0; i < files.length; i++) {
+    const file = files[i];
+    process.stdout.write(chalk134.dim(`  [${i + 1}/${files.length}] `));
+    const summary = summariseSession(file);
+    if (summary) {
+      writeSummary(file, summary);
+      succeeded++;
+      process.stdout.write(`${chalk134.green("\u2713")} ${summary}
+`);
+    } else {
+      failed++;
+      process.stdout.write(` ${chalk134.yellow("skip")}
+`);
+    }
+  }
+  return { succeeded, failed };
+}
+
 // src/commands/sessions/web/index.ts
 import { WebSocketServer } from "ws";
 
 // src/commands/sessions/web/handleRequest.ts
-import { readFileSync as readFileSync34 } from "fs";
+import { readFileSync as readFileSync35 } from "fs";
 import { createRequire as createRequire2 } from "module";
 
 // src/commands/sessions/web/getHtml.ts
@@ -12629,7 +12937,7 @@ function createCssHandler(packageEntry) {
   return (_req, res) => {
     if (!cache) {
       const resolved = require3.resolve(packageEntry);
-      cache = readFileSync34(resolved, "utf-8");
+      cache = readFileSync35(resolved, "utf-8");
     }
     res.writeHead(200, { "Content-Type": "text/css" });
     res.end(cache);
@@ -12752,114 +13060,6 @@ function resumeSession(id, sessionId, cwd, name) {
   };
 }
 
-// src/commands/sessions/web/discoverSessions.ts
-import * as fs24 from "fs";
-import * as os from "os";
-import * as path47 from "path";
-
-// src/commands/sessions/web/parseSessionFile.ts
-import * as fs23 from "fs";
-import * as path46 from "path";
-
-// src/commands/sessions/web/extractSessionMeta.ts
-function extractSessionMeta(lines) {
-  let sessionId = "";
-  let cwd = "";
-  let timestamp = "";
-  let name = "";
-  for (const line of lines) {
-    const entry = safeParse(line);
-    if (!entry) continue;
-    sessionId ||= typeof entry.sessionId === "string" ? entry.sessionId : "";
-    timestamp ||= typeof entry.timestamp === "string" ? entry.timestamp : "";
-    cwd ||= typeof entry.cwd === "string" ? entry.cwd : "";
-    if (entry.type === "user" && !entry.isMeta) {
-      name = extractName(entry);
-      break;
-    }
-  }
-  return { sessionId, cwd, timestamp, name };
-}
-function safeParse(line) {
-  try {
-    return JSON.parse(line);
-  } catch {
-    return null;
-  }
-}
-function extractName(entry) {
-  const msg = entry.message;
-  const content = msg?.content;
-  const text = typeof content === "string" ? content : Array.isArray(content) ? content.find((c) => c.type === "text")?.text ?? "" : "";
-  return text.replace(/<command-[^>]*>[^<]*<\/command-[^>]*>/g, "").trim().slice(0, 80);
-}
-
-// src/commands/sessions/web/parseSessionFile.ts
-async function parseSessionFile(filePath) {
-  let handle;
-  try {
-    handle = await fs23.promises.open(filePath, "r");
-    const buf = Buffer.alloc(16384);
-    const { bytesRead } = await handle.read(buf, 0, buf.length, 0);
-    const lines = buf.toString("utf8", 0, bytesRead).split("\n").filter(Boolean);
-    const meta = extractSessionMeta(lines);
-    if (!meta.sessionId) return null;
-    const timestamp = meta.timestamp || (await fs23.promises.stat(filePath)).mtime.toISOString();
-    const project = meta.cwd ? path46.basename(meta.cwd) : dirNameToProject(filePath);
-    return {
-      sessionId: meta.sessionId,
-      name: meta.name || `Session ${meta.sessionId.slice(0, 8)}`,
-      project,
-      cwd: meta.cwd,
-      timestamp
-    };
-  } catch {
-    return null;
-  } finally {
-    await handle?.close();
-  }
-}
-function dirNameToProject(filePath) {
-  const dirName = path46.basename(path46.dirname(filePath));
-  const parts = dirName.split("--");
-  return parts[parts.length - 1].replace(/-/g, "/");
-}
-
-// src/commands/sessions/web/discoverSessions.ts
-async function discoverSessions() {
-  const projectsDir = path47.join(os.homedir(), ".claude", "projects");
-  let projectDirs;
-  try {
-    projectDirs = await fs24.promises.readdir(projectsDir);
-  } catch {
-    return [];
-  }
-  const sessions = [];
-  await Promise.all(
-    projectDirs.map(async (dirName) => {
-      const dirPath = path47.join(projectsDir, dirName);
-      let entries;
-      try {
-        entries = await fs24.promises.readdir(dirPath);
-      } catch {
-        return;
-      }
-      const jsonlFiles = entries.filter((e) => e.endsWith(".jsonl"));
-      await Promise.all(
-        jsonlFiles.map(async (file) => {
-          const filePath = path47.join(dirPath, file);
-          const session = await parseSessionFile(filePath);
-          if (session) sessions.push(session);
-        })
-      );
-    })
-  );
-  sessions.sort(
-    (a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime()
-  );
-  return sessions;
-}
-
 // src/commands/sessions/web/scheduleIdle.ts
 var IDLE_MS = 3e3;
 function scheduleIdle(session, onIdle) {
@@ -13033,13 +13233,14 @@ async function web3(options2) {
 function registerSessions(program2) {
   const cmd = program2.command("sessions").description("Web dashboard for Claude Code sessions").action(() => web3({ port: "3100" }));
   cmd.command("web").description("Start the sessions web dashboard").option("-p, --port <number>", "Port to listen on", "3100").action(web3);
+  cmd.command("summarise").description("Generate one-line summaries for Claude sessions").option("-f, --force", "Re-generate all summaries, even existing ones").option("-n, --limit <count>", "Maximum number of sessions to summarise").action(summarise3);
 }
 
 // src/commands/statusLine.ts
-import chalk135 from "chalk";
+import chalk136 from "chalk";
 
 // src/commands/buildLimitsSegment.ts
-import chalk134 from "chalk";
+import chalk135 from "chalk";
 var FIVE_HOUR_SECONDS = 5 * 3600;
 var SEVEN_DAY_SECONDS = 7 * 86400;
 function formatTimeLeft(resetsAt) {
@@ -13062,10 +13263,10 @@ function projectUsage(pct, resetsAt, windowSeconds) {
 function colorizeRateLimit(pct, resetsAt, windowSeconds) {
   const label2 = `${Math.round(pct)}%`;
   const projected = projectUsage(pct, resetsAt, windowSeconds);
-  if (projected == null) return chalk134.green(label2);
-  if (projected > 100) return chalk134.red(label2);
-  if (projected > 75) return chalk134.yellow(label2);
-  return chalk134.green(label2);
+  if (projected == null) return chalk135.green(label2);
+  if (projected > 100) return chalk135.red(label2);
+  if (projected > 75) return chalk135.yellow(label2);
+  return chalk135.green(label2);
 }
 function formatLimit(pct, resetsAt, windowSeconds, fallbackLabel) {
   const timeLabel = resetsAt ? formatTimeLeft(resetsAt) : fallbackLabel;
@@ -13091,14 +13292,14 @@ function buildLimitsSegment(rateLimits) {
 }
 
 // src/commands/statusLine.ts
-chalk135.level = 3;
+chalk136.level = 3;
 function formatNumber(num) {
   return num.toLocaleString("en-US");
 }
 function colorizePercent(pct) {
   const label2 = `${Math.round(pct)}%`;
-  if (pct > 80) return chalk135.red(label2);
-  if (pct > 40) return chalk135.yellow(label2);
+  if (pct > 80) return chalk136.red(label2);
+  if (pct > 40) return chalk136.yellow(label2);
   return label2;
 }
 async function statusLine() {
@@ -13113,29 +13314,29 @@ async function statusLine() {
 }
 
 // src/commands/sync.ts
-import * as fs27 from "fs";
+import * as fs30 from "fs";
 import * as os2 from "os";
 import * as path50 from "path";
 import { fileURLToPath as fileURLToPath7 } from "url";
 
 // src/commands/sync/syncClaudeMd.ts
-import * as fs25 from "fs";
+import * as fs28 from "fs";
 import * as path48 from "path";
-import chalk136 from "chalk";
+import chalk137 from "chalk";
 async function syncClaudeMd(claudeDir, targetBase, options2) {
   const source = path48.join(claudeDir, "CLAUDE.md");
   const target = path48.join(targetBase, "CLAUDE.md");
-  const sourceContent = fs25.readFileSync(source, "utf-8");
-  if (fs25.existsSync(target)) {
-    const targetContent = fs25.readFileSync(target, "utf-8");
+  const sourceContent = fs28.readFileSync(source, "utf-8");
+  if (fs28.existsSync(target)) {
+    const targetContent = fs28.readFileSync(target, "utf-8");
     if (sourceContent !== targetContent) {
       console.log(
-        chalk136.yellow("\n\u26A0\uFE0F  Warning: CLAUDE.md differs from existing file")
+        chalk137.yellow("\n\u26A0\uFE0F  Warning: CLAUDE.md differs from existing file")
       );
       console.log();
       printDiff(targetContent, sourceContent);
       const confirm = options2?.yes || await promptConfirm(
-        chalk136.red("Overwrite existing CLAUDE.md?"),
+        chalk137.red("Overwrite existing CLAUDE.md?"),
         false
       );
       if (!confirm) {
@@ -13144,21 +13345,21 @@ async function syncClaudeMd(claudeDir, targetBase, options2) {
       }
     }
   }
-  fs25.copyFileSync(source, target);
+  fs28.copyFileSync(source, target);
   console.log("Copied CLAUDE.md to ~/.claude/CLAUDE.md");
 }
 
 // src/commands/sync/syncSettings.ts
-import * as fs26 from "fs";
+import * as fs29 from "fs";
 import * as path49 from "path";
-import chalk137 from "chalk";
+import chalk138 from "chalk";
 async function syncSettings(claudeDir, targetBase, options2) {
   const source = path49.join(claudeDir, "settings.json");
   const target = path49.join(targetBase, "settings.json");
-  const sourceContent = fs26.readFileSync(source, "utf-8");
+  const sourceContent = fs29.readFileSync(source, "utf-8");
   const mergedContent = JSON.stringify(JSON.parse(sourceContent), null, "	");
-  if (fs26.existsSync(target)) {
-    const targetContent = fs26.readFileSync(target, "utf-8");
+  if (fs29.existsSync(target)) {
+    const targetContent = fs29.readFileSync(target, "utf-8");
     const normalizedTarget = JSON.stringify(
       JSON.parse(targetContent),
       null,
@@ -13167,14 +13368,14 @@ async function syncSettings(claudeDir, targetBase, options2) {
     if (mergedContent !== normalizedTarget) {
       if (!options2?.yes) {
         console.log(
-          chalk137.yellow(
+          chalk138.yellow(
             "\n\u26A0\uFE0F  Warning: settings.json differs from existing file"
           )
         );
         console.log();
         printDiff(targetContent, mergedContent);
         const confirm = await promptConfirm(
-          chalk137.red("Overwrite existing settings.json?"),
+          chalk138.red("Overwrite existing settings.json?"),
           false
         );
         if (!confirm) {
@@ -13184,7 +13385,7 @@ async function syncSettings(claudeDir, targetBase, options2) {
       }
     }
   }
-  fs26.writeFileSync(target, mergedContent);
+  fs29.writeFileSync(target, mergedContent);
   console.log("Copied settings.json to ~/.claude/settings.json");
 }
 
@@ -13203,10 +13404,10 @@ async function sync(options2) {
 function syncCommands(claudeDir, targetBase) {
   const sourceDir = path50.join(claudeDir, "commands");
   const targetDir = path50.join(targetBase, "commands");
-  fs27.mkdirSync(targetDir, { recursive: true });
-  const files = fs27.readdirSync(sourceDir);
+  fs30.mkdirSync(targetDir, { recursive: true });
+  const files = fs30.readdirSync(sourceDir);
   for (const file of files) {
-    fs27.copyFileSync(path50.join(sourceDir, file), path50.join(targetDir, file));
+    fs30.copyFileSync(path50.join(sourceDir, file), path50.join(targetDir, file));
     console.log(`Copied ${file} to ${targetDir}`);
   }
   console.log(`Synced ${files.length} command(s) to ~/.claude/commands`);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@staff0rd/assist",
-	"version": "0.196.1",
+	"version": "0.197.0",
 	"type": "module",
 	"main": "dist/index.js",
 	"bin": {