toon-memory 1.2.0 → 1.3.0

package/README.md

@@ -27,6 +27,8 @@ AI agents forget everything between sessions. toon-memory fixes this by providin
 - **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
 
 ---
 
@@ -88,6 +90,19 @@ memory_remember   # Save important decisions
 | `memory_stats` | View memory state |
 | `memory_summary` | Save/retrieve file summaries |
 
+### 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"
+})
+```
+
 ---
 
 ## How It Works
@@ -114,12 +129,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

@@ -27709,10 +27709,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 +27724,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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toon-memory",
-  "version": "1.2.0",
+  "version": "1.3.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

@@ -83,9 +83,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 +99,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 }