@aiplumber/session-recall 1.6.0 → 1.6.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiplumber/session-recall",
-  "version": "1.6.0",
+  "version": "1.6.7",
   "description": "Pull context from previous Claude Code sessions. Sessions end, context resets - this tool lets you continue where you left off.",
   "bin": {
     "session-recall": "./session-recall"

package/session-recall

@@ -1,8 +1,13 @@
 #!/usr/bin/env node
 
+const VERSION = '1.6.7';
+
 const fs = require('fs');
 const path = require('path');
 
+// Cross-platform home directory
+const HOME = HOME || process.env.USERPROFILE;
+
 // Filter patterns
 const SHELL_PREFIXES = ['ls ', 'cat ', 'npm ', 'cd ', 'git ', 'mkdir ', 'rm ', 'cp ', 'mv ', 'grep ', 'find '];
 const NOISE_TYPES = ['progress', 'file-history-snapshot', 'system', 'queue-operation'];
@@ -983,7 +988,7 @@ function cwdToProjectFolder() {
   // Both / and . are replaced with -
   const cwd = process.cwd();
   const projectName = cwd.replace(/[\/\.]/g, '-');
-  const projectsDir = path.join(process.env.HOME, '.claude', 'projects');
+  const projectsDir = path.join(HOME, '.claude', 'projects');
   const projectPath = path.join(projectsDir, projectName);
 
   if (fs.existsSync(projectPath)) {
@@ -996,7 +1001,7 @@ function cmdLast(arg1, arg2, opts) {
   // Usage: last [N] [folder]
   // arg1 could be: undefined, a number string, or a folder path
   // arg2 could be: undefined, or a folder path (if arg1 was a number)
-  const projectsDir = path.join(process.env.HOME, '.claude', 'projects');
+  const projectsDir = path.join(HOME, '.claude', 'projects');
 
   let n = 1;
   let dir = null;
@@ -1200,26 +1205,31 @@ function cmdLast(arg1, arg2, opts) {
     return;
   }
 
-  // Output combined rinse (gotime mode)
-  let allMsgs = selected.flatMap(s => s.msgs);
-  // Sort by timestamp
-  allMsgs.sort((a, b) => new Date(a.timestamp || 0) - new Date(b.timestamp || 0));
+  // Print header
+  console.log(`[session-recall v${VERSION}] This context has been stripped of most tool results to reduce noise.`);
+  console.log(`---`);
 
-  // Filter by checkpoint timestamp if --after was specified
-  if (filterAfterTs) {
-    allMsgs = allMsgs.filter(msg => {
-      const msgTs = msg.timestamp ? new Date(msg.timestamp).getTime() : 0;
-      return msgTs > filterAfterTs;
-    });
-  }
+  // Process each session separately to add separators
+  for (let sessionIdx = 0; sessionIdx < selected.length; sessionIdx++) {
+    const session = selected[sessionIdx];
+    let sessionMsgs = session.msgs;
 
-  // Build tool result metadata (size, duration)
-  const resultMeta = buildToolResultMeta(allMsgs);
+    // Sort by timestamp
+    sessionMsgs.sort((a, b) => new Date(a.timestamp || 0) - new Date(b.timestamp || 0));
+
+    // Filter by checkpoint timestamp if --after was specified
+    if (filterAfterTs) {
+      sessionMsgs = sessionMsgs.filter(msg => {
+        const msgTs = msg.timestamp ? new Date(msg.timestamp).getTime() : 0;
+        return msgTs > filterAfterTs;
+      });
+    }
 
-  // Build tag map for injection
-  // Tag map: { uuid -> { type, level, reason } }
-  const tagMap = {};
-  for (const session of selected) {
+    // Build tool result metadata (size, duration)
+    const resultMeta = buildToolResultMeta(sessionMsgs);
+
+    // Build tag map for this session
+    const tagMap = {};
     const sessionTags = scanSessionTags(session.filePath);
     for (const tag of sessionTags) {
       if (tag.targetUuid) {
@@ -1230,62 +1240,69 @@ function cmdLast(arg1, arg2, opts) {
         };
       }
     }
-  }
 
-  for (const msg of allMsgs) {
-    if (NOISE_TYPES.includes(msg.type)) continue;
+    for (const msg of sessionMsgs) {
+      if (NOISE_TYPES.includes(msg.type)) continue;
 
-    // Check if this message has a tag
-    const toolId = getToolUseId(msg);
-    const msgUuid = toolId || msg.uuid;
-    const tag = msgUuid ? tagMap[msgUuid] : null;
+      // Check if this message has a tag
+      const toolId = getToolUseId(msg);
+      const msgUuid = toolId || msg.uuid;
+      const tag = msgUuid ? tagMap[msgUuid] : null;
 
-    // Determine if we should show this tag
-    const showTag = tag && (
-      tag.level === 'critical' ||
-      (tag.level === 'important' && opts.showImportant)
-    );
+      // Determine if we should show this tag
+      const showTag = tag && (
+        tag.level === 'critical' ||
+        (tag.level === 'important' && opts.showImportant)
+      );
 
-    if (msg.type === 'user') {
-      if (isToolResult(msg)) continue;
-      const text = getUserText(msg);
-      if (text) {
+      if (msg.type === 'user') {
+        if (isToolResult(msg)) continue;
+        const text = getUserText(msg);
+        if (text) {
+          const ts = msg.timestamp ? new Date(msg.timestamp).toISOString().substring(11, 19) : '';
+          if (showTag) {
+            const marker = tag.level === 'critical' ? '\u26A0' : '\u2139';
+            console.log(`[${ts}] ${marker} ${tag.level.toUpperCase()} [${tag.type}] USER: ${text.substring(0, 500)}`);
+            console.log(`         Reason: "${tag.reason}"`);
+          } else {
+            console.log(`[${ts}] USER: ${text.substring(0, 500)}`);
+          }
+        }
+      } else if (msg.type === 'assistant') {
+        const text = getAssistantText(msg);
+        const toolSummary = collapseToolCall(msg, resultMeta);
         const ts = msg.timestamp ? new Date(msg.timestamp).toISOString().substring(11, 19) : '';
+
         if (showTag) {
           const marker = tag.level === 'critical' ? '\u26A0' : '\u2139';
-          console.log(`[${ts}] ${marker} ${tag.level.toUpperCase()} [${tag.type}] USER: ${text.substring(0, 500)}`);
+          if (text) {
+            console.log(`[${ts}] ${marker} ${tag.level.toUpperCase()} [${tag.type}] ASSISTANT: ${text.substring(0, 500)}`);
+          } else if (toolSummary) {
+            console.log(`[${ts}] ${marker} ${tag.level.toUpperCase()} [${tag.type}] ${toolSummary}`);
+          }
           console.log(`         Reason: "${tag.reason}"`);
         } else {
-          console.log(`[${ts}] USER: ${text.substring(0, 500)}`);
+          if (text) {
+            console.log(`[${ts}] ASSISTANT: ${text.substring(0, 500)}`);
+          } else if (toolSummary) {
+            console.log(`[${ts}] ASSISTANT: ${toolSummary}`);
+          }
         }
       }
-    } else if (msg.type === 'assistant') {
-      const text = getAssistantText(msg);
-      const toolSummary = collapseToolCall(msg, resultMeta);
-      const ts = msg.timestamp ? new Date(msg.timestamp).toISOString().substring(11, 19) : '';
+    }
 
-      if (showTag) {
-        const marker = tag.level === 'critical' ? '\u26A0' : '\u2139';
-        if (text) {
-          console.log(`[${ts}] ${marker} ${tag.level.toUpperCase()} [${tag.type}] ASSISTANT: ${text.substring(0, 500)}`);
-        } else if (toolSummary) {
-          console.log(`[${ts}] ${marker} ${tag.level.toUpperCase()} [${tag.type}] ${toolSummary}`);
-        }
-        console.log(`         Reason: "${tag.reason}"`);
-      } else {
-        if (text) {
-          console.log(`[${ts}] ASSISTANT: ${text.substring(0, 500)}`);
-        } else if (toolSummary) {
-          console.log(`[${ts}] ASSISTANT: ${toolSummary}`);
-        }
-      }
+    // Print session separator if not the last session
+    if (sessionIdx < selected.length - 1) {
+      const nextSession = selected[sessionIdx + 1];
+      const nextTs = nextSession.lastTs ? nextSession.lastTs.toISOString().replace('T', ' ').substring(0, 16) : 'unknown';
+      console.log(`\n=== END SESSION ${sessionIdx + 1} === NEXT SESSION: ${nextSession.project} (${nextTs}) ===\n`);
     }
   }
 
   // Print instructions for Claude
   console.log(``);
   console.log(`---`);
-  console.log(`To get a specific tool result: session-recall tools --show <id>`);
+  console.log(`Tool results: Most are noise. Only fetch with "session-recall tools --show <id>" when you see something you actually need.`);
   console.log(`Session file: ${selected[0]?.filePath || 'unknown'}`);
 }
 
@@ -1349,6 +1366,10 @@ TAGGING:
   tags [filter]              List all tags in current project
                              Filter by type or level
 
+OPTIONS:
+  -v, --version              Show version number
+  -h, --help                 Show this help
+
 EXAMPLES:
   session-recall last 1 -d                          # Check what's available
   session-recall last 1 -f text                     # Pull last session
@@ -1797,6 +1818,8 @@ function parseArgs(args) {
       opts.showImportant = true;
     } else if (arg === '-h' || arg === '--help') {
       opts.help = true;
+    } else if (arg === '-v' || arg === '--version') {
+      opts.version = true;
     } else if (!arg.startsWith('-')) {
       positional.push(arg);
     }
@@ -1810,6 +1833,12 @@ function parseArgs(args) {
 const args = process.argv.slice(2);
 const { opts, positional } = parseArgs(args);
 
+// Handle --version flag
+if (opts.version) {
+  console.log(`session-recall v${VERSION}`);
+  process.exit(0);
+}
+
 // Handle --checkpoint flag first (no-op marker that gets logged)
 if (opts.checkpoint) {
   // Output marker format - this IS the checkpoint storage (searched in tool_result)
@@ -1818,7 +1847,7 @@ if (opts.checkpoint) {
 
   // Detect current session UUID by finding most recently modified .jsonl
   let currentUuid = 'unknown';
-  const claudeProjectsDir = path.join(process.env.HOME, '.claude', 'projects');
+  const claudeProjectsDir = path.join(HOME, '.claude', 'projects');
   if (fs.existsSync(claudeProjectsDir)) {
     let newestFile = null;
     let newestTime = 0;