@hir4ta/mneme 0.24.2 → 0.25.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "mneme",
   "description": "A plugin that provides long-term memory for Claude Code. It automatically saves context lost during auto-compact, offering features for session restoration, recording technical decisions, and learning developer patterns.",
-  "version": "0.24.2",
+  "version": "0.25.0",
   "author": {
     "name": "hir4ta"
   },

package/README.ja.md

@@ -1,6 +1,6 @@
 # mneme
 
-![Version](https://img.shields.io/badge/version-0.24.2-blue)
+![Version](https://img.shields.io/badge/version-0.25.0-blue)
 ![Node.js](https://img.shields.io/badge/node-%3E%3D22.5.0-brightgreen)
 [![NPM Version](https://img.shields.io/npm/v/%40hir4ta%2Fmneme)](https://www.npmjs.com/package/@hir4ta/mneme)
 [![MIT License](https://img.shields.io/npm/l/%40hir4ta%2Fmneme)](https://github.com/hir4ta/mneme/blob/main/LICENSE)

package/README.md

@@ -1,6 +1,6 @@
 # mneme
 
-![Version](https://img.shields.io/badge/version-0.24.2-blue)
+![Version](https://img.shields.io/badge/version-0.25.0-blue)
 ![Node.js](https://img.shields.io/badge/node-%3E%3D22.5.0-brightgreen)
 [![NPM Version](https://img.shields.io/npm/v/%40hir4ta%2Fmneme)](https://www.npmjs.com/package/@hir4ta/mneme)
 [![MIT License](https://img.shields.io/npm/l/%40hir4ta%2Fmneme)](https://github.com/hir4ta/mneme/blob/main/LICENSE)

package/bin/mneme.js

@@ -100,11 +100,14 @@ function initMneme() {
   );
   fs.writeFileSync(path.join(rulesDir, "dev-rules.json"), rulesTemplate);
 
-  // Create .gitignore for local.db
+  // Create .gitignore for local.db and temporary files
   const gitignoreContent = `# Local SQLite database (private interactions)
 local.db
 local.db-wal
 local.db-shm
+
+# Temporary files
+.pending-compact.json
 `;
   fs.writeFileSync(gitignorePath, gitignoreContent);
 

package/dist/lib/save/index.js

@@ -417,6 +417,14 @@ function updateSaveState(db, claudeSessionId, lastSavedTimestamp, lastSavedLine)
   `);
   stmt.run(lastSavedTimestamp, lastSavedLine, claudeSessionId);
 }
+function updateSaveStateMnemeSessionId(db, claudeSessionId, mnemeSessionId) {
+  const stmt = db.prepare(`
+    UPDATE session_save_state
+    SET mneme_session_id = ?, updated_at = datetime('now')
+    WHERE claude_session_id = ?
+  `);
+  stmt.run(mnemeSessionId, claudeSessionId);
+}
 
 // lib/save/parser.ts
 import * as fs4 from "node:fs";
@@ -523,7 +531,7 @@ async function parseTranscriptIncremental(transcriptPath, lastSavedLine) {
     return {
       timestamp: e.timestamp,
       content,
-      isCompactSummary: e.isCompactSummary || false,
+      isCompactSummary: e.isCompactSummary || !!e.planContent || false,
       slashCommand: extractSlashCommand(content)
     };
   });
@@ -569,6 +577,35 @@ async function parseTranscriptIncremental(transcriptPath, lastSavedLine) {
     return { timestamp: e.timestamp, thinking, text, toolDetails };
   }).filter((m) => m !== null);
   const interactions = [];
+  const firstUserTs = userMessages.length > 0 ? userMessages[0].timestamp : "9999-12-31T23:59:59Z";
+  const orphanedResponses = assistantMessages.filter(
+    (a) => a.timestamp < firstUserTs
+  );
+  if (orphanedResponses.length > 0) {
+    const allToolDetails = orphanedResponses.flatMap((r) => r.toolDetails);
+    const orphanedTimeKeys = new Set(
+      orphanedResponses.map((r) => r.timestamp.slice(0, 16))
+    );
+    const allToolResults = [...orphanedTimeKeys].flatMap(
+      (k) => toolResultsByTimestamp.get(k) || []
+    );
+    const allProgressEvents = [...orphanedTimeKeys].flatMap(
+      (k) => progressEvents.get(k) || []
+    );
+    interactions.push({
+      timestamp: orphanedResponses[0].timestamp,
+      user: "",
+      thinking: orphanedResponses.filter((r) => r.thinking).map((r) => r.thinking).join("\n"),
+      assistant: orphanedResponses.filter((r) => r.text).map((r) => r.text).join("\n"),
+      isCompactSummary: false,
+      isContinuation: true,
+      toolsUsed: [...new Set(allToolDetails.map((t) => t.name))],
+      toolDetails: allToolDetails,
+      inPlanMode: isInPlanMode(orphanedResponses[0].timestamp) || void 0,
+      toolResults: allToolResults.length > 0 ? allToolResults : void 0,
+      progressEvents: allProgressEvents.length > 0 ? allProgressEvents : void 0
+    });
+  }
   for (let i = 0; i < userMessages.length; i++) {
     const user = userMessages[i];
     const nextUserTs = i + 1 < userMessages.length ? userMessages[i + 1].timestamp : "9999-12-31T23:59:59Z";
@@ -610,6 +647,61 @@ var IGNORED_PREFIXES = [
   ".claude/"
 ];
 var IGNORED_FILES = ["package-lock.json", "pnpm-lock.yaml", "yarn.lock"];
+function detectCompactContinuation(interactions, projectPath) {
+  const compactInteraction = interactions.find((i) => i.isCompactSummary);
+  if (!compactInteraction?.user) return null;
+  const match = compactInteraction.user.match(
+    /read the full transcript at:.*?\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\.jsonl/
+  );
+  if (!match) return null;
+  const oldClaudeSessionId = match[1];
+  return resolveMnemeSessionId(projectPath, oldClaudeSessionId);
+}
+function linkToMasterSession(projectPath, claudeSessionId, masterMnemeSessionId) {
+  const sessionLinksDir = path4.join(projectPath, ".mneme", "session-links");
+  if (!fs5.existsSync(sessionLinksDir)) {
+    fs5.mkdirSync(sessionLinksDir, { recursive: true });
+  }
+  const linkFile = path4.join(sessionLinksDir, `${claudeSessionId}.json`);
+  if (!fs5.existsSync(linkFile)) {
+    fs5.writeFileSync(
+      linkFile,
+      JSON.stringify(
+        {
+          masterSessionId: masterMnemeSessionId,
+          claudeSessionId,
+          linkedAt: (/* @__PURE__ */ new Date()).toISOString()
+        },
+        null,
+        2
+      )
+    );
+    console.error(
+      `[mneme] Compact continuation linked: ${claudeSessionId} \u2192 ${masterMnemeSessionId}`
+    );
+  }
+  const masterFile = findSessionFileById(projectPath, masterMnemeSessionId);
+  if (masterFile && fs5.existsSync(masterFile)) {
+    try {
+      const master = JSON.parse(fs5.readFileSync(masterFile, "utf8"));
+      const workPeriods = master.workPeriods || [];
+      const alreadyLinked = workPeriods.some(
+        (wp) => wp.claudeSessionId === claudeSessionId
+      );
+      if (!alreadyLinked) {
+        workPeriods.push({
+          claudeSessionId,
+          startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          endedAt: null
+        });
+        master.workPeriods = workPeriods;
+        master.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+        fs5.writeFileSync(masterFile, JSON.stringify(master, null, 2));
+      }
+    } catch {
+    }
+  }
+}
 function isIgnoredPath(relativePath) {
   return IGNORED_PREFIXES.some((p) => relativePath.startsWith(p)) || IGNORED_FILES.includes(relativePath);
 }
@@ -663,7 +755,7 @@ async function incrementalSave(claudeSessionId, transcriptPath, projectPath) {
   }
   const dbPath = path4.join(projectPath, ".mneme", "local.db");
   const db = initDatabase(dbPath);
-  const mnemeSessionId = resolveMnemeSessionId(projectPath, claudeSessionId);
+  let mnemeSessionId = resolveMnemeSessionId(projectPath, claudeSessionId);
   const saveState = getSaveState(
     db,
     claudeSessionId,
@@ -674,7 +766,25 @@ async function incrementalSave(claudeSessionId, transcriptPath, projectPath) {
     transcriptPath,
     saveState.lastSavedLine
   );
+  if (saveState.lastSavedLine === 0 && interactions.length > 0) {
+    const masterSessionId = detectCompactContinuation(
+      interactions,
+      projectPath
+    );
+    if (masterSessionId && masterSessionId !== mnemeSessionId) {
+      linkToMasterSession(projectPath, claudeSessionId, masterSessionId);
+      mnemeSessionId = masterSessionId;
+      updateSaveStateMnemeSessionId(db, claudeSessionId, masterSessionId);
+    }
+  }
   if (interactions.length === 0) {
+    updateSaveState(
+      db,
+      claudeSessionId,
+      saveState.lastSavedTimestamp || "",
+      totalLines
+    );
+    db.close();
     return {
       success: true,
       savedCount: 0,
@@ -701,6 +811,7 @@ async function incrementalSave(claudeSessionId, transcriptPath, projectPath) {
         toolsUsed: interaction.toolsUsed,
         toolDetails: interaction.toolDetails,
         ...interaction.inPlanMode && { inPlanMode: true },
+        ...interaction.isContinuation && { isContinuation: true },
         ...interaction.slashCommand && {
           slashCommand: interaction.slashCommand
         },
@@ -711,27 +822,30 @@ async function incrementalSave(claudeSessionId, transcriptPath, projectPath) {
           progressEvents: interaction.progressEvents
         }
       });
-      insertStmt.run(
-        mnemeSessionId,
-        claudeSessionId,
-        projectPath,
-        repository,
-        repositoryUrl,
-        repositoryRoot,
-        owner,
-        "user",
-        interaction.user,
-        null,
-        metadata,
-        interaction.timestamp,
-        interaction.isCompactSummary ? 1 : 0
-      );
-      insertedCount++;
-      if (interaction.assistant) {
+      if (!interaction.isContinuation) {
+        insertStmt.run(
+          mnemeSessionId,
+          claudeSessionId,
+          projectPath,
+          repository,
+          repositoryUrl,
+          repositoryRoot,
+          owner,
+          "user",
+          interaction.user,
+          null,
+          metadata,
+          interaction.timestamp,
+          interaction.isCompactSummary ? 1 : 0
+        );
+        insertedCount++;
+      }
+      if (interaction.assistant || interaction.thinking) {
         const assistantMetadata = JSON.stringify({
           toolsUsed: interaction.toolsUsed,
           toolDetails: interaction.toolDetails,
           ...interaction.inPlanMode && { inPlanMode: true },
+          ...interaction.isContinuation && { isContinuation: true },
           ...interaction.toolResults?.length && {
             toolResults: interaction.toolResults
           },
@@ -748,7 +862,7 @@ async function incrementalSave(claudeSessionId, transcriptPath, projectPath) {
           repositoryRoot,
           owner,
           "assistant",
-          interaction.assistant,
+          interaction.assistant || "",
           interaction.thinking || null,
           assistantMetadata,
           interaction.timestamp,

package/dist/lib/session/finalize.js

@@ -421,6 +421,14 @@ function updateSaveState(db, claudeSessionId, lastSavedTimestamp, lastSavedLine)
   `);
   stmt.run(lastSavedTimestamp, lastSavedLine, claudeSessionId);
 }
+function updateSaveStateMnemeSessionId(db, claudeSessionId, mnemeSessionId) {
+  const stmt = db.prepare(`
+    UPDATE session_save_state
+    SET mneme_session_id = ?, updated_at = datetime('now')
+    WHERE claude_session_id = ?
+  `);
+  stmt.run(mnemeSessionId, claudeSessionId);
+}
 
 // lib/save/parser.ts
 import * as fs4 from "node:fs";
@@ -527,7 +535,7 @@ async function parseTranscriptIncremental(transcriptPath, lastSavedLine) {
     return {
       timestamp: e.timestamp,
       content,
-      isCompactSummary: e.isCompactSummary || false,
+      isCompactSummary: e.isCompactSummary || !!e.planContent || false,
       slashCommand: extractSlashCommand(content)
     };
   });
@@ -573,6 +581,35 @@ async function parseTranscriptIncremental(transcriptPath, lastSavedLine) {
     return { timestamp: e.timestamp, thinking, text, toolDetails };
   }).filter((m) => m !== null);
   const interactions = [];
+  const firstUserTs = userMessages.length > 0 ? userMessages[0].timestamp : "9999-12-31T23:59:59Z";
+  const orphanedResponses = assistantMessages.filter(
+    (a) => a.timestamp < firstUserTs
+  );
+  if (orphanedResponses.length > 0) {
+    const allToolDetails = orphanedResponses.flatMap((r) => r.toolDetails);
+    const orphanedTimeKeys = new Set(
+      orphanedResponses.map((r) => r.timestamp.slice(0, 16))
+    );
+    const allToolResults = [...orphanedTimeKeys].flatMap(
+      (k) => toolResultsByTimestamp.get(k) || []
+    );
+    const allProgressEvents = [...orphanedTimeKeys].flatMap(
+      (k) => progressEvents.get(k) || []
+    );
+    interactions.push({
+      timestamp: orphanedResponses[0].timestamp,
+      user: "",
+      thinking: orphanedResponses.filter((r) => r.thinking).map((r) => r.thinking).join("\n"),
+      assistant: orphanedResponses.filter((r) => r.text).map((r) => r.text).join("\n"),
+      isCompactSummary: false,
+      isContinuation: true,
+      toolsUsed: [...new Set(allToolDetails.map((t) => t.name))],
+      toolDetails: allToolDetails,
+      inPlanMode: isInPlanMode(orphanedResponses[0].timestamp) || void 0,
+      toolResults: allToolResults.length > 0 ? allToolResults : void 0,
+      progressEvents: allProgressEvents.length > 0 ? allProgressEvents : void 0
+    });
+  }
   for (let i = 0; i < userMessages.length; i++) {
     const user = userMessages[i];
     const nextUserTs = i + 1 < userMessages.length ? userMessages[i + 1].timestamp : "9999-12-31T23:59:59Z";
@@ -614,6 +651,61 @@ var IGNORED_PREFIXES = [
   ".claude/"
 ];
 var IGNORED_FILES = ["package-lock.json", "pnpm-lock.yaml", "yarn.lock"];
+function detectCompactContinuation(interactions, projectPath) {
+  const compactInteraction = interactions.find((i) => i.isCompactSummary);
+  if (!compactInteraction?.user) return null;
+  const match = compactInteraction.user.match(
+    /read the full transcript at:.*?\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\.jsonl/
+  );
+  if (!match) return null;
+  const oldClaudeSessionId = match[1];
+  return resolveMnemeSessionId(projectPath, oldClaudeSessionId);
+}
+function linkToMasterSession(projectPath, claudeSessionId, masterMnemeSessionId) {
+  const sessionLinksDir = path4.join(projectPath, ".mneme", "session-links");
+  if (!fs5.existsSync(sessionLinksDir)) {
+    fs5.mkdirSync(sessionLinksDir, { recursive: true });
+  }
+  const linkFile = path4.join(sessionLinksDir, `${claudeSessionId}.json`);
+  if (!fs5.existsSync(linkFile)) {
+    fs5.writeFileSync(
+      linkFile,
+      JSON.stringify(
+        {
+          masterSessionId: masterMnemeSessionId,
+          claudeSessionId,
+          linkedAt: (/* @__PURE__ */ new Date()).toISOString()
+        },
+        null,
+        2
+      )
+    );
+    console.error(
+      `[mneme] Compact continuation linked: ${claudeSessionId} \u2192 ${masterMnemeSessionId}`
+    );
+  }
+  const masterFile = findSessionFileById(projectPath, masterMnemeSessionId);
+  if (masterFile && fs5.existsSync(masterFile)) {
+    try {
+      const master = JSON.parse(fs5.readFileSync(masterFile, "utf8"));
+      const workPeriods = master.workPeriods || [];
+      const alreadyLinked = workPeriods.some(
+        (wp) => wp.claudeSessionId === claudeSessionId
+      );
+      if (!alreadyLinked) {
+        workPeriods.push({
+          claudeSessionId,
+          startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          endedAt: null
+        });
+        master.workPeriods = workPeriods;
+        master.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+        fs5.writeFileSync(masterFile, JSON.stringify(master, null, 2));
+      }
+    } catch {
+    }
+  }
+}
 function isIgnoredPath(relativePath) {
   return IGNORED_PREFIXES.some((p) => relativePath.startsWith(p)) || IGNORED_FILES.includes(relativePath);
 }
@@ -667,7 +759,7 @@ async function incrementalSave(claudeSessionId, transcriptPath, projectPath) {
   }
   const dbPath = path4.join(projectPath, ".mneme", "local.db");
   const db = initDatabase(dbPath);
-  const mnemeSessionId = resolveMnemeSessionId(projectPath, claudeSessionId);
+  let mnemeSessionId = resolveMnemeSessionId(projectPath, claudeSessionId);
   const saveState = getSaveState(
     db,
     claudeSessionId,
@@ -678,7 +770,25 @@ async function incrementalSave(claudeSessionId, transcriptPath, projectPath) {
     transcriptPath,
     saveState.lastSavedLine
   );
+  if (saveState.lastSavedLine === 0 && interactions.length > 0) {
+    const masterSessionId = detectCompactContinuation(
+      interactions,
+      projectPath
+    );
+    if (masterSessionId && masterSessionId !== mnemeSessionId) {
+      linkToMasterSession(projectPath, claudeSessionId, masterSessionId);
+      mnemeSessionId = masterSessionId;
+      updateSaveStateMnemeSessionId(db, claudeSessionId, masterSessionId);
+    }
+  }
   if (interactions.length === 0) {
+    updateSaveState(
+      db,
+      claudeSessionId,
+      saveState.lastSavedTimestamp || "",
+      totalLines
+    );
+    db.close();
     return {
       success: true,
       savedCount: 0,
@@ -705,6 +815,7 @@ async function incrementalSave(claudeSessionId, transcriptPath, projectPath) {
         toolsUsed: interaction.toolsUsed,
         toolDetails: interaction.toolDetails,
         ...interaction.inPlanMode && { inPlanMode: true },
+        ...interaction.isContinuation && { isContinuation: true },
         ...interaction.slashCommand && {
           slashCommand: interaction.slashCommand
         },
@@ -715,27 +826,30 @@ async function incrementalSave(claudeSessionId, transcriptPath, projectPath) {
           progressEvents: interaction.progressEvents
         }
       });
-      insertStmt.run(
-        mnemeSessionId,
-        claudeSessionId,
-        projectPath,
-        repository,
-        repositoryUrl,
-        repositoryRoot,
-        owner,
-        "user",
-        interaction.user,
-        null,
-        metadata,
-        interaction.timestamp,
-        interaction.isCompactSummary ? 1 : 0
-      );
-      insertedCount++;
-      if (interaction.assistant) {
+      if (!interaction.isContinuation) {
+        insertStmt.run(
+          mnemeSessionId,
+          claudeSessionId,
+          projectPath,
+          repository,
+          repositoryUrl,
+          repositoryRoot,
+          owner,
+          "user",
+          interaction.user,
+          null,
+          metadata,
+          interaction.timestamp,
+          interaction.isCompactSummary ? 1 : 0
+        );
+        insertedCount++;
+      }
+      if (interaction.assistant || interaction.thinking) {
         const assistantMetadata = JSON.stringify({
           toolsUsed: interaction.toolsUsed,
           toolDetails: interaction.toolDetails,
           ...interaction.inPlanMode && { inPlanMode: true },
+          ...interaction.isContinuation && { isContinuation: true },
           ...interaction.toolResults?.length && {
             toolResults: interaction.toolResults
           },
@@ -752,7 +866,7 @@ async function incrementalSave(claudeSessionId, transcriptPath, projectPath) {
           repositoryRoot,
           owner,
           "assistant",
-          interaction.assistant,
+          interaction.assistant || "",
           interaction.thinking || null,
           assistantMetadata,
           interaction.timestamp,

package/dist/lib/session/init.js

@@ -209,6 +209,69 @@ function initTags(mnemeDir, pluginRoot) {
 }
 
 // lib/session/init.ts
+function resolveSessionLink(sessionLinksDir, claudeSessionId) {
+  const fullPath = path3.join(sessionLinksDir, `${claudeSessionId}.json`);
+  const shortPath = claudeSessionId.length > 8 ? path3.join(sessionLinksDir, `${claudeSessionId.slice(0, 8)}.json`) : fullPath;
+  const linkPath = fs3.existsSync(fullPath) ? fullPath : shortPath;
+  if (fs3.existsSync(linkPath)) {
+    try {
+      const link = JSON.parse(fs3.readFileSync(linkPath, "utf8"));
+      if (link.masterSessionId) {
+        return link.masterSessionId;
+      }
+    } catch {
+    }
+  }
+  return claudeSessionId;
+}
+function handlePendingCompact(mnemeDir, sessionLinksDir, currentClaudeSessionId) {
+  const pendingFile = path3.join(mnemeDir, ".pending-compact.json");
+  if (!fs3.existsSync(pendingFile)) return;
+  try {
+    const pending = JSON.parse(fs3.readFileSync(pendingFile, "utf8"));
+    const oldClaudeSessionId = pending.claudeSessionId || "";
+    const timestamp = pending.timestamp || "";
+    if (timestamp) {
+      const age = Date.now() - new Date(timestamp).getTime();
+      if (age > 5 * 60 * 1e3) {
+        fs3.unlinkSync(pendingFile);
+        console.error("[mneme] Stale pending-compact removed");
+        return;
+      }
+    }
+    if (!oldClaudeSessionId || oldClaudeSessionId === currentClaudeSessionId) {
+      fs3.unlinkSync(pendingFile);
+      return;
+    }
+    const masterSessionId = resolveSessionLink(
+      sessionLinksDir,
+      oldClaudeSessionId
+    );
+    ensureDir(sessionLinksDir);
+    const linkFile = path3.join(
+      sessionLinksDir,
+      `${currentClaudeSessionId}.json`
+    );
+    if (!fs3.existsSync(linkFile)) {
+      const linkData = {
+        masterSessionId,
+        claudeSessionId: currentClaudeSessionId,
+        linkedAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      fs3.writeFileSync(linkFile, JSON.stringify(linkData, null, 2));
+      console.error(
+        `[mneme] Compact continuation linked: ${currentClaudeSessionId} \u2192 ${masterSessionId}`
+      );
+    }
+    fs3.unlinkSync(pendingFile);
+  } catch (e) {
+    console.error(`[mneme] Error handling pending-compact: ${e}`);
+    try {
+      fs3.unlinkSync(path3.join(mnemeDir, ".pending-compact.json"));
+    } catch {
+    }
+  }
+}
 function sessionInit(sessionId, cwd) {
   const pluginRoot = path3.resolve(__dirname, "..", "..");
   const mnemeDir = path3.join(cwd, ".mneme");
@@ -223,6 +286,7 @@ function sessionInit(sessionId, cwd) {
   }
   const now = nowISO();
   const fileId = sessionId || "";
+  handlePendingCompact(mnemeDir, sessionLinksDir, fileId);
   const git = getGitInfo(cwd);
   const repoInfo = getRepositoryInfo(cwd);
   const projectName = path3.basename(cwd);

package/dist/server.js

@@ -4493,7 +4493,7 @@ misc.get("/project", (c) => {
     }
   } catch {
   }
-  const version = "0.24.2";
+  const version = "0.25.0";
   return c.json({
     name: projectName,
     path: projectRoot,

package/hooks/pre-compact.sh

@@ -70,4 +70,11 @@ else
     echo "[mneme:pre-compact] Save result: ${result}" >&2
 fi
 
+# Write pending-compact breadcrumb for session linking on next SessionStart
+# The new session (post-compact) will read this to link back to the current mneme session
+pending_compact_file="${cwd}/.mneme/.pending-compact.json"
+printf '{"claudeSessionId":"%s","timestamp":"%s"}\n' \
+    "$session_id" "$(date -u +%Y-%m-%dT%H:%M:%SZ)" > "$pending_compact_file"
+echo "[mneme:pre-compact] Wrote pending-compact breadcrumb for session linking" >&2
+
 exit 0

package/hooks/user-prompt-submit.sh

@@ -4,8 +4,9 @@
 #
 # Purpose: Search mneme for relevant context and approved rules,
 # inject as additionalContext using shared search-core logic.
+# Also injects Claude Session ID (workaround for anthropics/claude-code#16538).
 #
-# Input (stdin): JSON with prompt, cwd
+# Input (stdin): JSON with prompt, session_id, cwd
 # Output (stdout): JSON with hookSpecificOutput.additionalContext (if matches found)
 #
 
@@ -23,13 +24,16 @@ fi
 
 prompt=$(echo "$input_json" | jq -r ".prompt // empty" 2>/dev/null || echo "")
 cwd=$(echo "$input_json" | jq -r ".cwd // empty" 2>/dev/null || echo "")
+session_id=$(echo "$input_json" | jq -r ".session_id // empty" 2>/dev/null || echo "")
 
+# Determine if search should run (session ID is always injected regardless)
+run_search=true
 if [ -z "$prompt" ] || [ ${#prompt} -lt 10 ]; then
-  exit 0
+  run_search=false
 fi
 
 if [[ "$prompt" == /mneme* ]]; then
-  exit 0
+  run_search=false
 fi
 
 if [ -z "$cwd" ]; then
@@ -37,104 +41,114 @@ if [ -z "$cwd" ]; then
 fi
 cwd=$(cd "$cwd" 2>/dev/null && pwd || echo "$cwd")
 
-# Cap very large prompts to avoid overly expensive search
-if [ ${#prompt} -gt 4000 ]; then
-  prompt="${prompt:0:4000}"
-fi
-
 if ! validate_mneme "$cwd"; then
   exit 0
 fi
 
-PLUGIN_ROOT="$(get_plugin_root)"
-
-search_script=$(find_script "$PLUGIN_ROOT" "prompt-search")
-if [ -z "$search_script" ]; then
-  exit 0
-fi
-
-# Detect changed files for file-based session recommendation
-changed_files=""
-if command -v git >/dev/null 2>&1 && git -C "$cwd" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
-  changed_files=$(cd "$cwd" && {
-    git diff --name-only HEAD 2>/dev/null
-    git diff --name-only --cached 2>/dev/null
-  } | sort -u | head -20 | paste -sd "," - 2>/dev/null || echo "")
-fi
-
-search_output=$(invoke_node "$search_script" \
-  --query "$prompt" --project "$cwd" --limit 5 \
-  ${changed_files:+--files "$changed_files"} 2>/dev/null || echo "")
+# --- Search (skipped for short prompts and /mneme commands) ---
+context_message=""
+rules_message=""
 
-if [ -z "$search_output" ]; then
-  exit 0
-fi
+if [ "$run_search" = true ]; then
+  # Cap very large prompts to avoid overly expensive search
+  if [ ${#prompt} -gt 4000 ]; then
+    prompt="${prompt:0:4000}"
+  fi
 
-success=$(echo "$search_output" | jq -r ".success // false" 2>/dev/null || echo "false")
-if [ "$success" != "true" ]; then
-  exit 0
-fi
+  PLUGIN_ROOT="$(get_plugin_root)"
+
+  search_script=$(find_script "$PLUGIN_ROOT" "prompt-search")
+  if [ -n "$search_script" ]; then
+    # Detect changed files for file-based session recommendation
+    changed_files=""
+    if command -v git >/dev/null 2>&1 && git -C "$cwd" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+      changed_files=$(cd "$cwd" && {
+        git diff --name-only HEAD 2>/dev/null
+        git diff --name-only --cached 2>/dev/null
+      } | sort -u | head -20 | paste -sd "," - 2>/dev/null || echo "")
+    fi
 
-# Format session/interaction context (existing behavior)
-context_message=""
-context_lines=$(echo "$search_output" | jq -r '
-  .results
-  | map(select(.score >= 3 and (.type == "session" or .type == "unit")))
-  | .[:3]
-  | map("[\(.type):\(.id)] \(.title) | match: \((.matchedFields // []) | join(","))")
-  | join("\n")
-')
-
-# Format file-based session recommendations
-file_rec_lines=$(echo "$search_output" | jq -r '
-  .fileRecommendations // []
-  | .[:3]
-  | map("[session:\(.sessionId)] \(.title) | files: \(.matchedFiles | join(", "))")
-  | join("\n")
-')
-
-if [ -n "$context_lines" ] && [ "$context_lines" != "null" ] || \
-   [ -n "$file_rec_lines" ] && [ "$file_rec_lines" != "null" ]; then
-  context_parts=""
-  if [ -n "$context_lines" ] && [ "$context_lines" != "null" ]; then
-    context_parts="Related context found (sessions/units):
+    search_output=$(invoke_node "$search_script" \
+      --query "$prompt" --project "$cwd" --limit 5 \
+      ${changed_files:+--files "$changed_files"} 2>/dev/null || echo "")
+
+    if [ -n "$search_output" ]; then
+      success=$(echo "$search_output" | jq -r ".success // false" 2>/dev/null || echo "false")
+      if [ "$success" = "true" ]; then
+        # Format session/interaction context
+        context_lines=$(echo "$search_output" | jq -r '
+          .results
+          | map(select(.score >= 3 and (.type == "session" or .type == "unit")))
+          | .[:3]
+          | map("[\(.type):\(.id)] \(.title) | match: \((.matchedFields // []) | join(","))")
+          | join("\n")
+        ')
+
+        # Format file-based session recommendations
+        file_rec_lines=$(echo "$search_output" | jq -r '
+          .fileRecommendations // []
+          | .[:3]
+          | map("[session:\(.sessionId)] \(.title) | files: \(.matchedFiles | join(", "))")
+          | join("\n")
+        ')
+
+        if [ -n "$context_lines" ] && [ "$context_lines" != "null" ] || \
+           [ -n "$file_rec_lines" ] && [ "$file_rec_lines" != "null" ]; then
+          context_parts=""
+          if [ -n "$context_lines" ] && [ "$context_lines" != "null" ]; then
+            context_parts="Related context found (sessions/units):
 ${context_lines}"
-  fi
-  if [ -n "$file_rec_lines" ] && [ "$file_rec_lines" != "null" ]; then
-    if [ -n "$context_parts" ]; then
-      context_parts="${context_parts}
+          fi
+          if [ -n "$file_rec_lines" ] && [ "$file_rec_lines" != "null" ]; then
+            if [ -n "$context_parts" ]; then
+              context_parts="${context_parts}
 "
-    fi
-    context_parts="${context_parts}Related sessions (editing same files):
+            fi
+            context_parts="${context_parts}Related sessions (editing same files):
 ${file_rec_lines}"
-  fi
-  context_message="<mneme-context>
+          fi
+          context_message="<mneme-context>
 ${context_parts}
 To explore deeper: use /mneme:search with specific technical terms, error messages, or file paths.
 </mneme-context>"
-fi
-
-# Format approved rules
-rules_message=""
-rules_lines=$(echo "$search_output" | jq -r '
-  .rules // []
-  | map(select(.score >= 2))
-  | .[:5]
-  | map("[\(.sourceType):\(.id)] (\(.priority // "—")) \(.text)")
-  | join("\n")
-')
-
-if [ -n "$rules_lines" ] && [ "$rules_lines" != "null" ]; then
-  rules_message="<mneme-rules>
+        fi
+
+        # Format approved rules
+        rules_lines=$(echo "$search_output" | jq -r '
+          .rules // []
+          | map(select(.score >= 2))
+          | .[:5]
+          | map("[\(.sourceType):\(.id)] (\(.priority // "—")) \(.text)")
+          | join("\n")
+        ')
+
+        if [ -n "$rules_lines" ] && [ "$rules_lines" != "null" ]; then
+          rules_message="<mneme-rules>
 Approved development rules (apply during this response):
 ${rules_lines}
 </mneme-rules>"
+        fi
+      fi
+    fi
+  fi
 fi
 
-# Combine both sections
+# --- Assemble full context ---
 full_context=""
+
+# Session ID injection (workaround for anthropics/claude-code#16538:
+# Plugin SessionStart hooks don't surface additionalContext to Claude)
+if [ -n "$session_id" ]; then
+  full_context="**Claude Session ID:** ${session_id}"
+fi
+
 if [ -n "$context_message" ]; then
-  full_context="$context_message"
+  if [ -n "$full_context" ]; then
+    full_context="${full_context}
+${context_message}"
+  else
+    full_context="$context_message"
+  fi
 fi
 if [ -n "$rules_message" ]; then
   if [ -n "$full_context" ]; then

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hir4ta/mneme",
-  "version": "0.24.2",
+  "version": "0.25.0",
   "description": "Long-term memory plugin for Claude Code - automated session saving, recording technical decisions, and web dashboard",
   "keywords": [
     "claude",

package/skills/save/SKILL.md

@@ -45,7 +45,7 @@ Always render missing required fields as blocking errors before write.
 
 **STOP. Before doing ANYTHING else, find the Claude Session ID.**
 
-Scan upward in this conversation for the SessionStart context block. It contains a line matching this exact format:
+The UserPromptSubmit hook injects the session ID into every prompt's context. Look for this exact line in the system-reminder messages above:
 
 ```
 **Claude Session ID:** <UUID>
@@ -54,8 +54,8 @@ Scan upward in this conversation for the SessionStart context block. It contains
 Copy the full UUID value (36 characters, e.g. `a1b2c3d4-e5f6-7890-abcd-ef1234567890`).
 
 <required>
-- The Claude Session ID is ALREADY in this conversation — injected by the session-start hook at the very beginning
-- Search for the literal text `**Claude Session ID:**` in the messages above
+- The Claude Session ID is ALREADY in this conversation — injected by the UserPromptSubmit hook on every prompt
+- Search for the literal text `**Claude Session ID:**` in system-reminder messages above
 - Copy the full 36-character UUID that follows it
 - Do NOT run Bash, Glob, Grep, or any other tool to discover the session ID
 - Do NOT call `mneme_list_sessions` to find it (that is only for the fallback below)