om-memory-system 4.15.0-next.116 → 4.17.0-next.124

package/dist/core/retrieval.js

@@ -48,6 +48,7 @@ export async function buildRecentMemoriesSection(options) {
         return null;
     const projectMemories = {
         results: memories.map((m) => ({
+            id: m.id,
             similarity: 1.0,
             memory: m.summary,
         })),
@@ -105,7 +106,7 @@ export function formatMemoriesForCompaction(memories, budget) {
         const body = tags.length > 0 ? stripMatchingEmbeddedTagsFooter(m.memory ?? "", tags) : (m.memory ?? "");
         const tagsFooter = tags.length > 0 ? `Tags: ${tags.join(", ")}\n\n` : "";
         return {
-            prefix: `### Memory ${i + 1}\n`,
+            prefix: m.id ? `### Memory ${i + 1} (${m.id})\n` : `### Memory ${i + 1}\n`,
             body,
             suffix: `\n\n${tagsFooter}`,
         };

package/dist/importer/import-sources.js

@@ -84,6 +84,8 @@ function isSqliteFile(path) {
 export function defaultClaudeSourcePath(claudeConfigDir) {
     return claudeProjectsRoot(claudeConfigDir);
 }
+// One of about 29 host-name branches outside src/adapters/. A host registry would replace
+// them. Read "Host parity" in AGENTS.md before you add a fourth host.
 export function defaultImportSourcePath(host, claudeConfigDir) {
     if (host === "pi")
         return DEFAULT_PI_SESSION_ROOT;

package/dist/services/context.d.ts

@@ -1,5 +1,6 @@
 import { type ContextBudgetOptions } from "../core/context-budget.js";
 interface MemoryResultMinimal {
+    id?: string;
     similarity: number;
     memory?: string;
     chunk?: string;

package/dist/services/context.js

@@ -36,8 +36,10 @@ export async function formatContextForPrompt(userId, projectMemories, budget) {
             entries: projectResults.map((mem) => {
                 const similarity = Math.round(mem.similarity * 100);
                 const content = mem.memory || mem.chunk || "";
+                // The id lets the agent pass a recalled memory to `forget` with no search first.
+                const id = mem.id ? `id="${mem.id}" ` : "";
                 return {
-                    prefix: `<memory relevance="${similarity}%">\n`,
+                    prefix: `<memory ${id}relevance="${similarity}%">\n`,
                     body: content,
                     suffix: "\n</memory>",
                 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "om-memory-system",
-  "version": "4.15.0-next.116",
+  "version": "4.17.0-next.124",
   "description": "Opinionated modular memory system for coding agents (OpenCode + Pi)",
   "type": "module",
   "main": "dist/plugin.js",

package/skills/omms-memory/SKILL.md

@@ -9,8 +9,17 @@ OMMS keeps memories for each project: earlier fixes, decisions, and conventions.
 
 ## How to call OMMS
 
-- If your tool list has a `memory` tool (Pi and OpenCode), use it.
-- If it does not (Claude Code), run the `om-memory-system memory` command with the Bash tool from the project directory. Each command prints one JSON document. A result with `"success": false` has an `error` field.
+- If your tool list has a `memory` tool, use it. Pi and OpenCode call it `memory`. Claude Code with the OMMS plugin calls it `mcp__omms__memory`.
+- If no `memory` tool is listed, run the `om-memory-system memory` command with the Bash tool from the project directory. Each command prints one JSON document. A result with `"success": false` has an `error` field.
+
+## Using OMMS in Claude Code
+
+- Recall arrives as added context. The user sees it as `▸ ● memory [mode=…]` rows at the top of your reply. The context holds the closest matches only.
+- When `mcp__omms__memory` is listed, call it. Do not run the command through Bash.
+- The tool refuses the `import`, `export`, `migrate` and `list-shards` modes. Tell the user to run them with `om-memory-system memory` in a terminal.
+- With hand-written hooks or an older plugin, no `memory` tool is listed. Then run `om-memory-system memory` through Bash.
+- Each injected memory shows its id. When the user asks you to remove that memory, pass the id to `forget`.
+- Capture runs after each reply in the background. Do not save the same turn again, unless it holds a decision, a fix or a preference that the user asked you to keep.
 
 ## When to search