toon-memory 1.2.0 → 1.4.0

package/README.md

@@ -22,11 +22,14 @@ AI agents forget everything between sessions. toon-memory fixes this by providin
 
 ## Features
 
-- **5 MCP tools** — `memory_remember`, `memory_recall`, `memory_forget`, `memory_stats`, `memory_summary`
+- **6 MCP tools** — `memory_remember`, `memory_recall`, `memory_forget`, `memory_stats`, `memory_summary`, `memory_archive`
 - **7 agents supported** — OpenCode, VS Code/Copilot, Claude Code, Cursor, Windsurf, Cline, Continue
 - **TOON format** — 40% fewer tokens than JSON, better LLM comprehension
 - **Per-project memory** — each project gets its own memory file
 - **Zero config** — just install and use
+- **Auto gitignore** — automatically adds `.opencode/memory/` to `.gitignore`
+- **Date filtering** — search memory by date range
+- **Auto-archive** — old entries (>30 days) moved to archive automatically
 
 ---
 
@@ -87,6 +90,31 @@ memory_remember   # Save important decisions
 | `memory_forget` | Remove an entry by key or id |
 | `memory_stats` | View memory state |
 | `memory_summary` | Save/retrieve file summaries |
+| `memory_archive` | Archive old entries (>30 days) |
+
+### Date Filtering
+
+Search memory by date range:
+
+```typescript
+// Search with date filter
+memory_recall({
+  query: "redis",
+  from_date: "2026-07-01",
+  to_date: "2026-07-31"
+})
+```
+
+### Auto-Archive
+
+Entries older than 30 days are automatically archived to keep memory clean:
+
+```typescript
+// Manually trigger archiving
+memory_archive()
+// 📦 Archivadas 5 entradas antiguas
+// 📋 Quedan 42 entradas activas
+```
 
 ---
 
@@ -114,12 +142,55 @@ summaries:
 ## CLI Commands
 
 ```bash
-npx toon-memory          # Interactive installer
-npx toon-memory init     # Quick setup (no prompts)
-npx toon-memory mcp      # Run MCP server directly
-npx toon-memory status   # Check installation status
-npx toon-memory upgrade  # Update to latest version
-npx toon-memory uninstall # Remove from all agents
+npx toon-memory              # Interactive installer
+npx toon-memory init         # Quick setup (no prompts)
+npx toon-memory mcp          # Run MCP server directly
+npx toon-memory status       # Check installation status
+npx toon-memory stats        # View memory statistics
+npx toon-memory export       # Export memory to JSON
+npx toon-memory import <file> # Import memory from JSON
+npx toon-memory upgrade      # Update to latest version
+npx toon-memory uninstall    # Remove from all agents
+```
+
+### Stats
+
+```bash
+$ npx toon-memory stats
+
+🧠 toon-memory stats
+
+📊 Memory Stats
+━━━━━━━━━━━━━━━━━━
+Total entries: 45
+├── decision: 12
+├── pattern: 18
+├── bug: 8
+└── knowledge: 7
+Last updated: 2026-07-10
+File size: 12.4 KB
+```
+
+### Export
+
+```bash
+$ npx toon-memory export
+
+🧠 toon-memory export
+
+Exported 45 entries to:
+  /path/to/project/toon-memory-export.json
+```
+
+### Import
+
+```bash
+$ npx toon-memory import backup.json
+
+🧠 toon-memory import
+
+Imported 3 new entries
+Skipped 2 duplicates
 ```
 
 ---

package/dist/cli/setup.js

@@ -77,6 +77,23 @@ function installOpenCodeTools() {
     console.log("  Created .opencode/memory/data.toon");
   }
 }
+function ensureGitignore() {
+  const gitignorePath = join(projectRoot, ".gitignore");
+  const entry = ".opencode/memory/";
+  if (!existsSync(gitignorePath)) {
+    writeFileSync(gitignorePath, `${entry}
+`);
+    console.log("  Created .gitignore with memory exclusion");
+    return;
+  }
+  const content = readFileSync(gitignorePath, "utf-8");
+  if (!content.includes(entry)) {
+    writeFileSync(gitignorePath, `${content.trim()}
+${entry}
+`);
+    console.log("  Added .opencode/memory/ to .gitignore");
+  }
+}
 function installMCPConfig(agent, scope) {
   const configPath = scope === "global" ? agent.global : agent.local;
   if (!configPath) {
@@ -139,6 +156,7 @@ function init(scope = "local") {
     installMCPConfig(agent, scope);
     console.log("");
   }
+  ensureGitignore();
   console.log("Done! Restart your agent to use memory tools.\n");
 }
 function status() {
@@ -365,6 +383,7 @@ Installing ${scope}ly...
     installMCPConfig(agent, scope);
     console.log("");
   }
+  ensureGitignore();
   console.log("Done! Restart your agent to use memory tools.");
   console.log("Run 'npx toon-memory uninstall' to remove.\n");
   rl.close();

package/mcp/server.js

@@ -27646,6 +27646,8 @@ import { randomBytes } from "crypto";
 var __dirname = dirname(fileURLToPath(import.meta.url));
 var MEMORY_DIR = join(process.cwd(), ".opencode", "memory");
 var MEMORY_FILE = join(MEMORY_DIR, "data.toon");
+var ARCHIVE_FILE = join(MEMORY_DIR, "archive.toon");
+var ARCHIVE_DAYS = 30;
 function ensureMemoryFile() {
   if (!existsSync(MEMORY_DIR)) mkdirSync(MEMORY_DIR, { recursive: true });
   if (!existsSync(MEMORY_FILE)) {
@@ -27663,6 +27665,58 @@ function writeMemory(content) {
 function generateId() {
   return randomBytes(4).toString("hex");
 }
+function archiveOldEntries() {
+  const data = readMemory();
+  const lines = data.split("\n");
+  const headerIdx = lines.findIndex((l) => l.startsWith("entries["));
+  if (headerIdx === -1) return { archived: 0, kept: 0 };
+  const today = /* @__PURE__ */ new Date();
+  const cutoff = new Date(today);
+  cutoff.setDate(cutoff.getDate() - ARCHIVE_DAYS);
+  const cutoffStr = cutoff.toISOString().split("T")[0];
+  const entryLines = lines.slice(headerIdx + 1).filter((l) => l.trim().length > 0);
+  const toArchive = [];
+  const toKeep = [];
+  for (const line of entryLines) {
+    const parts = line.trim().split("|");
+    if (parts.length >= 7) {
+      const date5 = parts[6];
+      if (date5 < cutoffStr) {
+        toArchive.push(line.trim());
+      } else {
+        toKeep.push(line.trim());
+      }
+    } else {
+      toKeep.push(line.trim());
+    }
+  }
+  if (toArchive.length === 0) return { archived: 0, kept: toKeep.length };
+  let archiveContent = "";
+  if (existsSync(ARCHIVE_FILE)) {
+    archiveContent = readFileSync(ARCHIVE_FILE, "utf-8");
+  } else {
+    archiveContent = `version: 1
+archived:
+`;
+  }
+  const archiveLines = archiveContent.split("\n");
+  let archiveHeaderIdx = archiveLines.findIndex((l) => l.startsWith("archived["));
+  if (archiveHeaderIdx === -1) {
+    archiveLines.push(`archived[0|]{id|category|key|content|file|tags|date}:`);
+    archiveHeaderIdx = archiveLines.length - 1;
+  }
+  const archiveMatch = archiveLines[archiveHeaderIdx].match(/archived\[(\d+)\|/);
+  const archiveCount = archiveMatch ? parseInt(archiveMatch[1]) : 0;
+  for (const entry of toArchive) {
+    archiveLines.splice(archiveHeaderIdx + 1, 0, `  ${entry}`);
+  }
+  archiveLines[archiveHeaderIdx] = archiveLines[archiveHeaderIdx].replace(/archived\[\d+\|/, `[${archiveCount + toArchive.length}|`);
+  writeFileSync(ARCHIVE_FILE, archiveLines.join("\n"));
+  lines[headerIdx] = lines[headerIdx].replace(/entries\[\d+\|/, `[${toKeep.length}|`);
+  lines.splice(headerIdx + 1, entryLines.length, ...toKeep.map((l) => `  ${l}`));
+  writeMemory(lines.join("\n"));
+  return { archived: toArchive.length, kept: toKeep.length };
+}
 var server = new McpServer(
   { name: "toon-memory", version: "1.1.0" },
   { capabilities: { tools: { listChanged: true } } }
@@ -27709,10 +27763,12 @@ server.registerTool(
     description: "Busca en la memoria persistente del proyecto. Devuelve entradas relevantes. Usar ANTES de leer archivos.",
     inputSchema: {
       query: external_exports.string().describe("Texto a buscar"),
-      category: external_exports.string().optional().default("").describe("Filtrar por categor\xEDa (vac\xEDo = todos)")
+      category: external_exports.string().optional().default("").describe("Filtrar por categor\xEDa (vac\xEDo = todos)"),
+      from_date: external_exports.string().optional().default("").describe("Fecha inicio filtro (YYYY-MM-DD)"),
+      to_date: external_exports.string().optional().default("").describe("Fecha fin filtro (YYYY-MM-DD)")
     }
   },
-  async ({ query, category }) => {
+  async ({ query, category, from_date, to_date }) => {
     const data = readMemory();
     const lines = data.split("\n").filter((l) => l.startsWith("  ") && l.includes("|"));
     const queryLower = query.toLowerCase();
@@ -27722,6 +27778,8 @@ server.registerTool(
       if (parts.length < 7) return null;
       const [id, cat, key, content, file2, tags, date5] = parts;
       if (category && cat !== category) return null;
+      if (from_date && date5 < from_date) return null;
+      if (to_date && date5 > to_date) return null;
       const searchStr = `${id} ${cat} ${key} ${content} ${file2} ${tags}`.toLowerCase();
       if (!searchStr.includes(queryLower)) return null;
       return { id, cat, key, content, file: file2, tags, date: date5 };
@@ -27849,6 +27907,27 @@ server.registerTool(
     };
   }
 );
+server.registerTool(
+  "memory_archive",
+  {
+    title: "Archive Old Entries",
+    description: "Mover entradas antiguas (>30 d\xEDas) a archive.toon para mantener la memoria limpia.",
+    inputSchema: {}
+  },
+  async () => {
+    const result = archiveOldEntries();
+    if (result.archived === 0) {
+      return { content: [{ type: "text", text: "No hay entradas antiguas para archivar" }] };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `\u{1F4E6} Archivadas ${result.archived} entradas antiguas
+\u{1F4CB} Quedan ${result.kept} entradas activas`
+      }]
+    };
+  }
+);
 var transport = new StdioServerTransport();
 await server.connect(transport);
 /*! Bundled license information:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toon-memory",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Persistent memory system for AI coding agents using TOON format (40% fewer tokens than JSON)",
   "type": "module",
   "bin": {

package/src/cli/setup.ts

@@ -112,6 +112,24 @@ function installOpenCodeTools(): void {
   }
 }
 
+// Add .opencode/memory/ to .gitignore if not present
+function ensureGitignore(): void {
+  const gitignorePath = join(projectRoot, ".gitignore")
+  const entry = ".opencode/memory/"
+  
+  if (!existsSync(gitignorePath)) {
+    writeFileSync(gitignorePath, `${entry}\n`)
+    console.log("  Created .gitignore with memory exclusion")
+    return
+  }
+  
+  const content = readFileSync(gitignorePath, "utf-8")
+  if (!content.includes(entry)) {
+    writeFileSync(gitignorePath, `${content.trim()}\n${entry}\n`)
+    console.log("  Added .opencode/memory/ to .gitignore")
+  }
+}
+
 // Install MCP server config for different agents
 function installMCPConfig(agent: Agent, scope: string): void {
   const configPath = scope === "global" ? agent.global : agent.local
@@ -197,6 +215,8 @@ function init(scope: string = "local"): void {
     console.log("")
   }
   
+  ensureGitignore()
+  
   console.log("Done! Restart your agent to use memory tools.\n")
 }
 
@@ -487,6 +507,8 @@ rl.question("Install (1) Local or (2) Global? [1/2]: ", (answer: string) => {
     console.log("")
   }
   
+  ensureGitignore()
+  
   console.log("Done! Restart your agent to use memory tools.")
   console.log("Run 'npx toon-memory uninstall' to remove.\n")
   rl.close()

package/src/mcp/server.ts

@@ -9,6 +9,9 @@ import { randomBytes } from "crypto"
 const __dirname = dirname(fileURLToPath(import.meta.url))
 const MEMORY_DIR = join(process.cwd(), ".opencode", "memory")
 const MEMORY_FILE = join(MEMORY_DIR, "data.toon")
+const ARCHIVE_FILE = join(MEMORY_DIR, "archive.toon")
+const MAX_ENTRIES = 100
+const ARCHIVE_DAYS = 30
 
 function ensureMemoryFile() {
   if (!existsSync(MEMORY_DIR)) mkdirSync(MEMORY_DIR, { recursive: true })
@@ -31,6 +34,71 @@ function generateId(): string {
   return randomBytes(4).toString("hex")
 }
 
+function archiveOldEntries(): { archived: number; kept: number } {
+  const data = readMemory()
+  const lines = data.split("\n")
+  const headerIdx = lines.findIndex((l) => l.startsWith("entries["))
+  
+  if (headerIdx === -1) return { archived: 0, kept: 0 }
+  
+  const today = new Date()
+  const cutoff = new Date(today)
+  cutoff.setDate(cutoff.getDate() - ARCHIVE_DAYS)
+  const cutoffStr = cutoff.toISOString().split("T")[0]
+  
+  const entryLines = lines.slice(headerIdx + 1).filter((l) => l.trim().length > 0)
+  const toArchive: string[] = []
+  const toKeep: string[] = []
+  
+  for (const line of entryLines) {
+    const parts = line.trim().split("|")
+    if (parts.length >= 7) {
+      const date = parts[6]
+      if (date < cutoffStr) {
+        toArchive.push(line.trim())
+      } else {
+        toKeep.push(line.trim())
+      }
+    } else {
+      toKeep.push(line.trim())
+    }
+  }
+  
+  if (toArchive.length === 0) return { archived: 0, kept: toKeep.length }
+  
+  // Write archived entries
+  let archiveContent = ""
+  if (existsSync(ARCHIVE_FILE)) {
+    archiveContent = readFileSync(ARCHIVE_FILE, "utf-8")
+  } else {
+    archiveContent = `version: 1\narchived:\n`
+  }
+  
+  const archiveLines = archiveContent.split("\n")
+  let archiveHeaderIdx = archiveLines.findIndex((l) => l.startsWith("archived["))
+  if (archiveHeaderIdx === -1) {
+    archiveLines.push(`archived[0|]{id|category|key|content|file|tags|date}:`)
+    archiveHeaderIdx = archiveLines.length - 1
+  }
+  
+  const archiveMatch = archiveLines[archiveHeaderIdx].match(/archived\[(\d+)\|/)
+  const archiveCount = archiveMatch ? parseInt(archiveMatch[1]) : 0
+  
+  for (const entry of toArchive) {
+    archiveLines.splice(archiveHeaderIdx + 1, 0, `  ${entry}`)
+  }
+  archiveLines[archiveHeaderIdx] = archiveLines[archiveHeaderIdx].replace(/archived\[\d+\|/, `[${archiveCount + toArchive.length}|`)
+  
+  writeFileSync(ARCHIVE_FILE, archiveLines.join("\n"))
+  
+  // Update main file
+  lines[headerIdx] = lines[headerIdx].replace(/entries\[\d+\|/, `[${toKeep.length}|`)
+  lines.splice(headerIdx + 1, entryLines.length, ...toKeep.map((l) => `  ${l}`))
+  writeMemory(lines.join("\n"))
+  
+  return { archived: toArchive.length, kept: toKeep.length }
+}
+
 const server = new McpServer(
   { name: "toon-memory", version: "1.1.0" },
   { capabilities: { tools: { listChanged: true } } }
@@ -83,9 +151,11 @@ server.registerTool(
     inputSchema: {
       query: z.string().describe("Texto a buscar"),
       category: z.string().optional().default("").describe("Filtrar por categoría (vacío = todos)"),
+      from_date: z.string().optional().default("").describe("Fecha inicio filtro (YYYY-MM-DD)"),
+      to_date: z.string().optional().default("").describe("Fecha fin filtro (YYYY-MM-DD)"),
     },
   },
-  async ({ query, category }) => {
+  async ({ query, category, from_date, to_date }) => {
     const data = readMemory()
     const lines = data.split("\n").filter((l) => l.startsWith("  ") && l.includes("|"))
     const queryLower = query.toLowerCase()
@@ -97,6 +167,8 @@ server.registerTool(
         if (parts.length < 7) return null
         const [id, cat, key, content, file, tags, date] = parts
         if (category && cat !== category) return null
+        if (from_date && date < from_date) return null
+        if (to_date && date > to_date) return null
         const searchStr = `${id} ${cat} ${key} ${content} ${file} ${tags}`.toLowerCase()
         if (!searchStr.includes(queryLower)) return null
         return { id, cat, key, content, file, tags, date }
@@ -247,5 +319,28 @@ server.registerTool(
   }
 )
 
+server.registerTool(
+  "memory_archive",
+  {
+    title: "Archive Old Entries",
+    description: "Mover entradas antiguas (>30 días) a archive.toon para mantener la memoria limpia.",
+    inputSchema: {},
+  },
+  async () => {
+    const result = archiveOldEntries()
+    
+    if (result.archived === 0) {
+      return { content: [{ type: "text" as const, text: "No hay entradas antiguas para archivar" }] }
+    }
+    
+    return {
+      content: [{ 
+        type: "text" as const, 
+        text: `📦 Archivadas ${result.archived} entradas antiguas\n📋 Quedan ${result.kept} entradas activas` 
+      }],
+    }
+  }
+)
+
 const transport = new StdioServerTransport()
 await server.connect(transport)