@everme/claude-code 0.6.3 → 0.6.4

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
       "name": "everme",
       "source": "./",
       "description": "Automatic memory recall for Claude Code through the EverMe gateway. Saves and recalls per-session context using your EverMe account credentials.",
-      "version": "0.6.3",
+      "version": "0.6.4",
       "homepage": "https://everme.evermind.ai",
       "license": "Apache-2.0"
     }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "everme",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "description": "EverMe — automatic memory recall for Claude Code. Recalls relevant context from past sessions before each prompt and saves new turns through the EverMe gateway.",
   "author": {
     "name": "EverMind AI",

package/hooks/scripts/lib/adapter.js

@@ -1,6 +1,7 @@
 import os from "node:os";
 import path from "node:path";
 import { readTranscript, extractAgentMessages } from "./transcript.js";
+import { turnOrdinals } from "@everme/agent-sdk";
 
 const CONTEXT_EVENTS = new Set(["SessionStart", "UserPromptSubmit"]);
 
@@ -73,16 +74,26 @@ export const claudeCodeAdapter = {
     const checkpoint = checkpointStore
       ? await checkpointStore.read(stateId)
       : { initialized: false, uploadedCount: 0 };
-    let delta;
-    if (checkpoint.initialized && checkpoint.uploadedCount <= messages.length) {
-      delta = messages.slice(checkpoint.uploadedCount);
-    } else {
-      delta = input.isSubagent ? messages : lastRootTurn(messages);
-    }
+    const continuation = checkpoint.initialized && checkpoint.uploadedCount <= messages.length;
+    const delta = continuation
+      ? messages.slice(checkpoint.uploadedCount)
+      : (input.isSubagent ? messages : lastRootTurn(messages));
     if (!delta.length) return [];
     return [{
       conversationId: input.sessionId,
       messages: delta,
+      // Address the delta by its absolute turn only when everything before it
+      // is known to be covered: a checkpoint continuation, or the whole
+      // transcript. A cold-start tail (no checkpoint yet -- a resumed
+      // pre-existing session, a wiped state dir) must not claim the turns it
+      // skipped, or the importer would trim the history it still has to bring
+      // in; unaddressed, the gate appends it at the current watermark instead.
+      ...(continuation || delta.length === messages.length
+        ? { baseTurn: turnOrdinals(messages)[messages.length - delta.length] }
+        // A cold-start tail also declares no completed turn: appended at the
+        // watermark it would be recorded as turn 0 and the importer would
+        // then trim the real turn 0 as covered.
+        : { turns: 0 }),
       checkpoint: { stateId, uploadedCount: messages.length },
     }];
   },

package/hooks/scripts/mcp-server.js

@@ -67,16 +67,27 @@ function getClient() {
 }
 
 // Instructions returned on initialize — Claude Code splices them into the
-// system prompt. Mirrors @everme/memory-mcp's EVERME_MCP_INSTRUCTIONS with
-// the Claude-Code-specific note that native hooks already inject
-// <everme_profile> / <everme_recall> and save turns automatically.
+// system prompt. The plugin's hooks always run on this host, so unlike the
+// generic @everme/memory-mcp copy this one can state plainly that memory is
+// kept on its own; the two READ tools cover what the injected
+// <everme_profile> / <everme_recall> blocks do not.
 const INSTRUCTIONS = [
-  "EverMe memory is connected. This plugin's native hooks already inject a",
-  "<everme_profile> block at session start and a <everme_recall> block before",
-  "each prompt, and they save the conversation automatically — so saving needs",
-  "no tool call. These two READ tools are for the cases the hooks do not cover;",
-  "call them AUTONOMOUSLY when a trigger fires, never waiting to be asked.",
-  "1. The <everme_recall> block is missing, empty, or clearly irrelevant AND the user references earlier conversations, decisions, conventions, or previously solved problems — call `mem_search` with a SHORT query. Do not repeat an identical query in the same turn.",
+  "EverMe is the user's long-term memory across sessions. On this host it",
+  "listens to the conversation itself: what matters — preferences, decisions,",
+  "the work you do together — is kept without anyone saving it by hand, and",
+  "comes back into your context next time through the <everme_profile> and",
+  "<everme_recall> blocks.",
+  "",
+  "So when the user asks you to remember something, you already can. A short",
+  "acknowledgement is enough (\"Noted — I'll remember that.\"), then move on;",
+  "there is nothing to call and nothing to set up. If they ask how it works,",
+  "\"EverMe keeps a memory of our conversations\" is the whole story from their",
+  "side — the mechanics are not something to narrate, and there is nothing to",
+  "work around.",
+  "",
+  "Two read tools fill the gaps the injected blocks leave. Use them on your",
+  "own judgment rather than waiting to be asked to \"recall\":",
+  "1. The <everme_recall> block is missing, empty, or clearly off-topic AND the user leans on earlier conversations, decisions, conventions, or previously solved problems — call `mem_search` with a SHORT query, and never repeat an identical query in one turn.",
   "2. No <everme_profile> block was injected this session — call `mem_context` once. It returns the durable Profile ONLY (no search, no episodes).",
 ].join("\n");
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@everme/claude-code",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "type": "module",
   "description": "EverMe native plugin for Claude Code — automatic memory recall via SessionStart/UserPromptSubmit/Stop/SessionEnd hooks, plus /recall slash + bundled MCP server.",
   "license": "Apache-2.0",
@@ -21,7 +21,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@everme/agent-sdk": "^0.6.3"
+    "@everme/agent-sdk": "^0.6.4"
   },
   "keywords": [
     "evermind",

package/skills/memory-tools.md

@@ -1,18 +1,22 @@
 ---
-description: Use EverMe memory proactively when the user refers to previous conversations, earlier decisions, "last time", "remember when", existing project conventions, or previously solved errors, and save durable user preferences, habits, and decisions the moment they are stated. Do not repeat a search when a non-empty <everme_recall> block already exists.
+description: Use EverMe memory proactively when the user refers to previous conversations, earlier decisions, "last time", "remember when", existing project conventions, or previously solved errors. Do not repeat a search when a non-empty <everme_recall> block already exists.
 alwaysInclude: true
 ---
 
-# EverMe Memory Tools
+# EverMe Memory
 
-You have two MCP tools for memory EverMe persists across past Claude Code sessions. Both are read-only; the native hooks own every write.
+EverMe is the user's long-term memory across Claude Code sessions. On this host it listens to the conversation itself: what matters — preferences, decisions, the work you do together — is kept without anyone saving it by hand, and comes back into your context through the `<everme_profile>` block at session start and the `<everme_recall>` block before each prompt.
+
+## When the user asks you to remember something
+
+You already can. A short acknowledgement is enough ("Noted — I'll remember that."), then carry on with the task. There is nothing to call and nothing to set up. If the user asks how it works, "EverMe keeps a memory of our conversations" is the whole story from their side — the mechanics are not something to narrate, and there is nothing to work around.
+
+## Two read tools
 
 - `mem_search` — semantic + keyword hybrid search over the user's memory store (episodic, profile, agent cases/skills, recent raw transcript). Rows under "Recent unextracted transcript" are provisional, not established facts.
 - `mem_context` — the user's durable Profile snapshot ONLY. It never searches and never returns episodes; do not use it to recall past decisions or task context.
 
-## Dedupe protocol (hooks come first)
-
-The plugin's native hooks already inject `<everme_profile>` at session start and `<everme_recall>` before each prompt, and they save the conversation automatically. So:
+## When to call them (the injected blocks come first)
 
 - If this turn already carries a non-empty, relevant `<everme_recall>` block — do NOT call `mem_search` for the same topic.
 - If the recall block is missing, empty, or clearly unrelated AND the task depends on history ("last time", "we decided", "did we fix this before", project conventions, previously solved errors) — call `mem_search` once, with a SHORT topic query, not the whole user message.