toon-memory 1.1.1 → 1.2.0

package/README.md

@@ -2,14 +2,9 @@
 
 Persistent memory for AI coding agents — remember decisions, patterns, and bugs between sessions.
 
-🎉 **1.0 Released!**
-
-Supercharge **OpenCode, VS Code Copilot, Claude Code, Cursor, Windsurf, Cline, Continue** and more with Persistent Memory
-
-Saves context in **TOON format** (40% fewer tokens than JSON) · 5 MCP tools · Works everywhere
-
 [![npm version](https://img.shields.io/npm/v/toon-memory.svg)](https://www.npmjs.com/package/toon-memory)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/LuiggiVal08/toon-memory/actions/workflows/ci.yml/badge.svg)](https://github.com/LuiggiVal08/toon-memory/actions/workflows/ci.yml)
 
 ---
 
@@ -25,9 +20,19 @@ AI agents forget everything between sessions. toon-memory fixes this by providin
 
 ---
 
-## Get Started
+## Features
+
+- **5 MCP tools** — `memory_remember`, `memory_recall`, `memory_forget`, `memory_stats`, `memory_summary`
+- **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
+
+---
+
+## Quick Start
 
-### 1. Install (one command)
+### 1. Install
 
 ```bash
 # macOS / Linux
@@ -60,16 +65,16 @@ memory_remember   # Save important decisions
 
 ## Supported Agents
 
-| Agent | Config Location | Status |
-|-------|-----------------|--------|
-| **OpenCode** | `.opencode/opencode.json` | ✅ Full support |
-| **VS Code / Copilot** | `.vscode/mcp.json` | ✅ Full support |
-| **Claude Code** | `.claude/settings.json` | ✅ Full support |
-| **Cursor** | `.cursor/mcp.json` | ✅ Full support |
-| **Windsurf** | `.windsurfrules` | ✅ Full support |
-| **Cline** | `.cline/mcp.json` | ✅ Full support |
-| **Continue** | `.continue/config.json` | ✅ Full support |
-| **Aider** | `.aider.conf.yml` | ⚠️ Manual config |
+| Agent | Config Location | Auto-Setup |
+|-------|-----------------|------------|
+| **OpenCode** | `.opencode/opencode.json` | ✅ |
+| **VS Code / Copilot** | `.vscode/mcp.json` | ✅ |
+| **Claude Code** | `.claude/settings.json` | ✅ |
+| **Cursor** | `.cursor/mcp.json` | ✅ |
+| **Windsurf** | `.windsurfrules` | ✅ |
+| **Cline** | `.cline/mcp.json` | ✅ |
+| **Continue** | `.continue/config.json` | ✅ |
+| **Aider** | `.aider.conf.yml` | ⚠️ Manual |
 
 ---
 
@@ -119,18 +124,6 @@ npx toon-memory uninstall # Remove from all agents
 
 ---
 
-## Uninstall
-
-```bash
-# Remove from all agents and uninstall CLI
-npx toon-memory uninstall
-
-# Or with the global install
-toon-memory uninstall
-```
-
----
-
 ## Configuration
 
 ### Global (all projects)
@@ -205,10 +198,23 @@ git clone https://github.com/LuiggiVal08/toon-memory.git
 cd toon-memory
 npm install
 npm run build
+npm test
 ```
 
 ---
 
+## Contributing
+
+Contributions are welcome! Please read our [Code of Conduct](CODE_OF_CONDUCT.md) first.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'feat: add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+---
+
 ## License
 
 MIT

package/bin/toon-memory.js

@@ -1,15 +1,10 @@
 #!/usr/bin/env node
-import { dirname, join } from "path"
-import { fileURLToPath } from "url"
-import { spawn } from "child_process"
-
-const __dirname = dirname(fileURLToPath(import.meta.url))
-const args = process.argv.slice(2)
-
-const target = args[0] === "mcp"
-  ? join(__dirname, "..", "mcp", "server.js")
-  : join(__dirname, "..", "dist", "cli", "setup.js")
-
-const extraArgs = args[0] === "mcp" ? [] : args
-const child = spawn("node", [target, ...extraArgs], { stdio: "inherit" })
-child.on("exit", (code) => process.exit(code ?? 0))
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { spawn } from "child_process";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const args = process.argv.slice(2);
+const target = args[0] === "mcp" ? join(__dirname, "..", "mcp", "server.js") : join(__dirname, "..", "dist", "cli", "setup.js");
+const extraArgs = args[0] === "mcp" ? [] : args;
+const child = spawn("node", [target, ...extraArgs], { stdio: "inherit" });
+child.on("exit", (code) => process.exit(code ?? 0));

package/dist/cli/setup.js

@@ -1,12 +1,12 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync, cpSync, unlinkSync } from "fs";
-import { dirname, join } from "path";
+import { basename, dirname, join } from "path";
 import { fileURLToPath } from "url";
 import { execSync } from "child_process";
 import { createInterface } from "readline";
 import { createRequire } from "module";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const projectRoot = process.cwd();
-const sourceDir = join(__dirname, "..", "src");
+const sourceDir = join(__dirname, "..", "..", "src");
 const HOME = process.env.HOME || process.env.USERPROFILE || "~";
 try {
   createRequire(import.meta.url).resolve("@toon-format/toon");
@@ -195,6 +195,128 @@ function upgrade() {
     console.error("Upgrade failed:", error.message);
   }
 }
+function stats() {
+  console.log("\n\u{1F9E0} toon-memory stats\n");
+  const memoryFile = join(projectRoot, ".opencode", "memory", "data.toon");
+  if (!existsSync(memoryFile)) {
+    console.log("Memory not initialized. Run 'npx toon-memory init' first.\n");
+    return;
+  }
+  const data = readFileSync(memoryFile, "utf-8");
+  const lines = data.split("\n").filter((l) => l.startsWith("  ") && l.includes("|"));
+  const categories = {};
+  let latestDate = "";
+  for (const line of lines) {
+    const parts = line.trim().split("|");
+    if (parts.length >= 7) {
+      const category = parts[1];
+      const date = parts[6];
+      categories[category] = (categories[category] || 0) + 1;
+      if (date > latestDate) latestDate = date;
+    }
+  }
+  console.log("\u{1F4CA} Memory Stats");
+  console.log("\u2501".repeat(20));
+  console.log(`Total entries: ${lines.length}`);
+  for (const [cat, count] of Object.entries(categories)) {
+    console.log(`\u251C\u2500\u2500 ${cat}: ${count}`);
+  }
+  console.log(`Last updated: ${latestDate || "never"}`);
+  const fileSize = Buffer.byteLength(data, "utf-8");
+  console.log(`File size: ${(fileSize / 1024).toFixed(1)} KB`);
+  console.log("");
+}
+function exportMemory() {
+  console.log("\n\u{1F9E0} toon-memory export\n");
+  const memoryFile = join(projectRoot, ".opencode", "memory", "data.toon");
+  if (!existsSync(memoryFile)) {
+    console.log("Memory not initialized. Run 'npx toon-memory init' first.\n");
+    return;
+  }
+  const data = readFileSync(memoryFile, "utf-8");
+  const lines = data.split("\n").filter((l) => l.startsWith("  ") && l.includes("|"));
+  const entries = lines.map((line) => {
+    const parts = line.trim().split("|");
+    return {
+      id: parts[0],
+      category: parts[1],
+      key: parts[2],
+      content: parts[3],
+      file: parts[4],
+      tags: parts[5] ? parts[5].split(";") : [],
+      date: parts[6]
+    };
+  });
+  const exportData = {
+    project: basename(projectRoot),
+    exported_at: (/* @__PURE__ */ new Date()).toISOString(),
+    entries,
+    summaries: {}
+  };
+  const outputPath = join(projectRoot, "toon-memory-export.json");
+  writeFileSync(outputPath, JSON.stringify(exportData, null, 2));
+  console.log(`Exported ${entries.length} entries to:`);
+  console.log(`  ${outputPath}
+`);
+}
+function importMemory() {
+  console.log("\n\u{1F9E0} toon-memory import\n");
+  const importFile = process.argv[3];
+  if (!importFile) {
+    console.log("Usage: npx toon-memory import <file.json>\n");
+    return;
+  }
+  const importPath = importFile.startsWith("/") ? importFile : join(projectRoot, importFile);
+  if (!existsSync(importPath)) {
+    console.log(`File not found: ${importPath}
+`);
+    return;
+  }
+  let importData;
+  try {
+    importData = JSON.parse(readFileSync(importPath, "utf-8"));
+  } catch {
+    console.log("Invalid JSON file\n");
+    return;
+  }
+  if (!importData.entries || !Array.isArray(importData.entries)) {
+    console.log("Invalid format: missing 'entries' array\n");
+    return;
+  }
+  const memoryDir = join(projectRoot, ".opencode", "memory");
+  const memoryFile = join(memoryDir, "data.toon");
+  if (!existsSync(memoryDir)) mkdirSync(memoryDir, { recursive: true });
+  let existingKeys = [];
+  if (existsSync(memoryFile)) {
+    const existing = readFileSync(memoryFile, "utf-8");
+    existingKeys = existing.split("\n").filter((l) => l.startsWith("  ") && l.includes("|")).map((l) => l.trim().split("|")[2]);
+  }
+  const newEntries = importData.entries.filter((e) => !existingKeys.includes(e.key));
+  if (newEntries.length === 0) {
+    console.log("No new entries to import (all keys already exist)\n");
+    return;
+  }
+  const newLines = newEntries.map((e) => {
+    const tags = Array.isArray(e.tags) ? e.tags.join(";") : e.tags || "";
+    return `  ${e.id}|${e.category}|${e.key}|${e.content}|${e.file}|${tags}|${e.date}`;
+  }).join("\n");
+  if (existsSync(memoryFile)) {
+    const existing = readFileSync(memoryFile, "utf-8");
+    const updated = existing.replace(
+      /entries\[\d+\|]/,
+      `entries[${newEntries.length}|]`
+    ) + "\n" + newLines;
+    writeFileSync(memoryFile, updated);
+  } else {
+    writeFileSync(memoryFile, `version: 1
+entries[${newEntries.length}|]{id|category|key|content|file|tags|date}:
+${newLines}
+`);
+  }
+  console.log(`Imported ${newEntries.length} new entries`);
+  console.log(`Skipped ${importData.entries.length - newEntries.length} duplicates
+`);
+}
 const args = process.argv.slice(2);
 if (args[0] === "uninstall") {
   uninstall();
@@ -212,6 +334,18 @@ if (args[0] === "upgrade") {
   upgrade();
   process.exit(0);
 }
+if (args[0] === "stats") {
+  stats();
+  process.exit(0);
+}
+if (args[0] === "export") {
+  exportMemory();
+  process.exit(0);
+}
+if (args[0] === "import") {
+  importMemory();
+  process.exit(0);
+}
 const agents = detectAgents();
 console.log("\n\u{1F9E0} toon-memory installer\n");
 console.log("Supported agents:");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toon-memory",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "Persistent memory system for AI coding agents using TOON format (40% fewer tokens than JSON)",
   "type": "module",
   "bin": {
@@ -17,10 +17,13 @@
     "uninstall.sh"
   ],
   "scripts": {
-    "build": "npm run build:mcp && npm run build:cli",
+    "build": "npm run build:bin && npm run build:mcp && npm run build:cli",
+    "build:bin": "esbuild src/bin/toon-memory.ts --platform=node --format=esm --outfile=bin/toon-memory.js",
     "build:mcp": "esbuild src/mcp/server.ts --bundle --platform=node --format=esm --outfile=mcp/server.js",
     "build:cli": "esbuild src/cli/setup.ts --platform=node --format=esm --outfile=dist/cli/setup.js && esbuild src/cli/toon-memory.ts --platform=node --format=esm --outfile=dist/cli/toon-memory.js",
-    "prepublishOnly": "npm run build"
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build && npm test"
   },
   "dependencies": {
     "@modelcontextprotocol/server": "^2.0.0-beta.3",
@@ -28,7 +31,10 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "esbuild": "^0.25.0"
+    "@types/node": "^26.1.1",
+    "esbuild": "^0.25.0",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
   },
   "keywords": [
     "opencode",

package/src/bin/toon-memory.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { dirname, join } from "path"
+import { fileURLToPath } from "url"
+import { spawn } from "child_process"
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const args = process.argv.slice(2)
+
+const target = args[0] === "mcp"
+  ? join(__dirname, "..", "mcp", "server.js")
+  : join(__dirname, "..", "dist", "cli", "setup.js")
+
+const extraArgs = args[0] === "mcp" ? [] : args
+const child = spawn("node", [target, ...extraArgs], { stdio: "inherit" })
+child.on("exit", (code) => process.exit(code ?? 0))

package/src/cli/setup.ts

@@ -1,5 +1,5 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync, cpSync, unlinkSync } from "fs"
-import { dirname, join } from "path"
+import { basename, dirname, join } from "path"
 import { fileURLToPath } from "url"
 import { execSync } from "child_process"
 import { createInterface } from "readline"
@@ -7,7 +7,9 @@ import { createRequire } from "module"
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 const projectRoot = process.cwd()
-const sourceDir = join(__dirname, "..", "src")
+// When compiled to dist/cli/, src is at ../../src
+// When running directly from src/cli/, src is at ../src
+const sourceDir = join(__dirname, "..", "..", "src")
 const HOME = process.env.HOME || process.env.USERPROFILE || "~"
 
 interface Agent {
@@ -269,6 +271,161 @@ function upgrade(): void {
   }
 }
 
+// Show memory statistics
+function stats(): void {
+  console.log("\n🧠 toon-memory stats\n")
+  
+  const memoryFile = join(projectRoot, ".opencode", "memory", "data.toon")
+  
+  if (!existsSync(memoryFile)) {
+    console.log("Memory not initialized. Run 'npx toon-memory init' first.\n")
+    return
+  }
+  
+  const data = readFileSync(memoryFile, "utf-8")
+  const lines = data.split("\n").filter((l: string) => l.startsWith("  ") && l.includes("|"))
+  
+  const categories: Record<string, number> = {}
+  let latestDate = ""
+  
+  for (const line of lines) {
+    const parts = line.trim().split("|")
+    if (parts.length >= 7) {
+      const category = parts[1]
+      const date = parts[6]
+      categories[category] = (categories[category] || 0) + 1
+      if (date > latestDate) latestDate = date
+    }
+  }
+  
+  console.log("📊 Memory Stats")
+  console.log("━".repeat(20))
+  console.log(`Total entries: ${lines.length}`)
+  
+  for (const [cat, count] of Object.entries(categories)) {
+    console.log(`├── ${cat}: ${count}`)
+  }
+  
+  console.log(`Last updated: ${latestDate || "never"}`)
+  
+  const fileSize = Buffer.byteLength(data, "utf-8")
+  console.log(`File size: ${(fileSize / 1024).toFixed(1)} KB`)
+  console.log("")
+}
+
+// Export memory to JSON
+function exportMemory(): void {
+  console.log("\n🧠 toon-memory export\n")
+  
+  const memoryFile = join(projectRoot, ".opencode", "memory", "data.toon")
+  
+  if (!existsSync(memoryFile)) {
+    console.log("Memory not initialized. Run 'npx toon-memory init' first.\n")
+    return
+  }
+  
+  const data = readFileSync(memoryFile, "utf-8")
+  const lines = data.split("\n").filter((l: string) => l.startsWith("  ") && l.includes("|"))
+  
+  const entries = lines.map((line: string) => {
+    const parts = line.trim().split("|")
+    return {
+      id: parts[0],
+      category: parts[1],
+      key: parts[2],
+      content: parts[3],
+      file: parts[4],
+      tags: parts[5] ? parts[5].split(";") : [],
+      date: parts[6]
+    }
+  })
+  
+  const exportData = {
+    project: basename(projectRoot),
+    exported_at: new Date().toISOString(),
+    entries,
+    summaries: {}
+  }
+  
+  const outputPath = join(projectRoot, "toon-memory-export.json")
+  writeFileSync(outputPath, JSON.stringify(exportData, null, 2))
+  
+  console.log(`Exported ${entries.length} entries to:`)
+  console.log(`  ${outputPath}\n`)
+}
+
+// Import memory from JSON
+function importMemory(): void {
+  console.log("\n🧠 toon-memory import\n")
+  
+  const importFile = process.argv[3]
+  
+  if (!importFile) {
+    console.log("Usage: npx toon-memory import <file.json>\n")
+    return
+  }
+  
+  // Use absolute path if provided, otherwise resolve relative to project root
+  const importPath = importFile.startsWith("/") ? importFile : join(projectRoot, importFile)
+  
+  if (!existsSync(importPath)) {
+    console.log(`File not found: ${importPath}\n`)
+    return
+  }
+  
+  let importData: any
+  try {
+    importData = JSON.parse(readFileSync(importPath, "utf-8"))
+  } catch {
+    console.log("Invalid JSON file\n")
+    return
+  }
+  
+  if (!importData.entries || !Array.isArray(importData.entries)) {
+    console.log("Invalid format: missing 'entries' array\n")
+    return
+  }
+  
+  const memoryDir = join(projectRoot, ".opencode", "memory")
+  const memoryFile = join(memoryDir, "data.toon")
+  
+  if (!existsSync(memoryDir)) mkdirSync(memoryDir, { recursive: true })
+  
+  let existingKeys: string[] = []
+  if (existsSync(memoryFile)) {
+    const existing = readFileSync(memoryFile, "utf-8")
+    existingKeys = existing.split("\n")
+      .filter((l: string) => l.startsWith("  ") && l.includes("|"))
+      .map((l: string) => l.trim().split("|")[2])
+  }
+  
+  const newEntries = importData.entries.filter((e: any) => !existingKeys.includes(e.key))
+  
+  if (newEntries.length === 0) {
+    console.log("No new entries to import (all keys already exist)\n")
+    return
+  }
+  
+  const newLines = newEntries.map((e: any) => {
+    const tags = Array.isArray(e.tags) ? e.tags.join(";") : (e.tags || "")
+    return `  ${e.id}|${e.category}|${e.key}|${e.content}|${e.file}|${tags}|${e.date}`
+  }).join("\n")
+  
+  if (existsSync(memoryFile)) {
+    const existing = readFileSync(memoryFile, "utf-8")
+    const updated = existing.replace(
+      /entries\[\d+\|]/,
+      `entries[${newEntries.length}|]`
+    ) + "\n" + newLines
+    writeFileSync(memoryFile, updated)
+  } else {
+    writeFileSync(memoryFile, `version: 1\nentries[${newEntries.length}|]{id|category|key|content|file|tags|date}:\n${newLines}\n`)
+  }
+  
+  console.log(`Imported ${newEntries.length} new entries`)
+  console.log(`Skipped ${importData.entries.length - newEntries.length} duplicates\n`)
+}
+
 // Main
 const args = process.argv.slice(2)
 
@@ -292,6 +449,21 @@ if (args[0] === "upgrade") {
   process.exit(0)
 }
 
+if (args[0] === "stats") {
+  stats()
+  process.exit(0)
+}
+
+if (args[0] === "export") {
+  exportMemory()
+  process.exit(0)
+}
+
+if (args[0] === "import") {
+  importMemory()
+  process.exit(0)
+}
+
 const agents = detectAgents()
 console.log("\n🧠 toon-memory installer\n")