@hasna/mementos 0.4.34 → 0.4.36

package/dist/cli/index.js

@@ -4958,7 +4958,7 @@ Use the full ID, or narrow with --scope, --agent, --project, or --all.`));
     handleError(e);
   }
 });
-program2.command("search <query>").description("Full-text search across memories").option("-s, --scope <scope>", "Scope filter").option("-c, --category <cat>", "Category filter").option("--tags <tags>", "Comma-separated tags filter").option("--limit <n>", "Max results", parseInt).option("--format <fmt>", "Output format: compact (default), json, csv, yaml").option("--history", "Show recent search queries instead of searching").option("--popular", "Show most popular search queries").action((query, opts) => {
+program2.command("search <query>").description("Full-text search across memories").option("-s, --scope <scope>", "Scope filter").option("-c, --category <cat>", "Category filter").option("--tags <tags>", "Comma-separated tags filter").option("--project <path>", "Project filter (path or name)").option("--agent <name>", "Agent filter").option("--session <id>", "Session ID filter").option("--limit <n>", "Max results", parseInt).option("--format <fmt>", "Output format: compact (default), json, csv, yaml").option("--history", "Show recent search queries instead of searching").option("--popular", "Show most popular search queries").action((query, opts) => {
   try {
     if (opts.history) {
       const history = getSearchHistory(20);
@@ -4994,10 +4994,28 @@ program2.command("search <query>").description("Full-text search across memories
       }
       return;
     }
+    const globalOpts = program2.opts();
+    const projectPath = opts.project || globalOpts.project;
+    let projectId;
+    if (projectPath) {
+      const project = getProject(resolve3(projectPath));
+      if (project)
+        projectId = project.id;
+    }
+    const agentName = opts.agent || globalOpts.agent;
+    let agentId;
+    if (agentName) {
+      const agent = getAgent(agentName);
+      if (agent)
+        agentId = agent.id;
+    }
     const filter = {
       scope: opts.scope,
       category: opts.category,
       tags: opts.tags ? opts.tags.split(",").map((t) => t.trim()) : undefined,
+      project_id: projectId,
+      agent_id: agentId,
+      session_id: opts.session || globalOpts.session,
       limit: opts.limit || 20
     };
     const results = searchMemories(query, filter);
@@ -5962,6 +5980,55 @@ program2.command("unpin <keyOrId>").description("Unpin a memory by key or partia
     handleError(e);
   }
 });
+program2.command("archive <keyOrId>").description("Archive a memory by key or ID (hides from lists, keeps history)").option("-s, --scope <scope>", "Scope filter for key lookup").action((keyOrId, opts) => {
+  try {
+    const globalOpts = program2.opts();
+    let memory = getMemory(resolvePartialId(getDatabase(), "memories", keyOrId) || keyOrId) || getMemoryByKey(keyOrId, opts.scope, globalOpts.agent);
+    if (!memory) {
+      console.error(chalk.red(`No memory found: ${keyOrId}`));
+      process.exit(1);
+    }
+    updateMemory(memory.id, { status: "archived", version: memory.version });
+    if (globalOpts.json) {
+      outputJson({ archived: true, id: memory.id, key: memory.key });
+    } else {
+      console.log(chalk.green(`\u2713 Archived: ${chalk.bold(memory.key)} (${memory.id.slice(0, 8)})`));
+    }
+  } catch (e) {
+    console.error(chalk.red(`archive failed: ${e instanceof Error ? e.message : String(e)}`));
+    process.exit(1);
+  }
+});
+program2.command("versions <keyOrId>").description("Show version history for a memory").option("-s, --scope <scope>", "Scope filter for key lookup").action((keyOrId, opts) => {
+  try {
+    const globalOpts = program2.opts();
+    let memory = getMemory(resolvePartialId(getDatabase(), "memories", keyOrId) || keyOrId) || getMemoryByKey(keyOrId, opts.scope, globalOpts.agent);
+    if (!memory) {
+      console.error(chalk.red(`No memory found: ${keyOrId}`));
+      process.exit(1);
+    }
+    const versions = getMemoryVersions(memory.id);
+    if (globalOpts.json) {
+      outputJson({ memory: { id: memory.id, key: memory.key, current_version: memory.version }, versions });
+      return;
+    }
+    console.log(chalk.bold(`
+Version history: ${memory.key} (current: v${memory.version})
+`));
+    if (versions.length === 0) {
+      console.log(chalk.dim("  No previous versions."));
+      return;
+    }
+    for (const v of versions) {
+      console.log(`  ${chalk.cyan(`v${v.version}`)} ${chalk.dim(v.created_at.slice(0, 16))} scope=${v.scope} imp=${v.importance}`);
+      console.log(`    ${v.value.slice(0, 120)}${v.value.length > 120 ? "..." : ""}`);
+    }
+    console.log("");
+  } catch (e) {
+    console.error(chalk.red(`versions failed: ${e instanceof Error ? e.message : String(e)}`));
+    process.exit(1);
+  }
+});
 program2.command("tail").description("Watch for new/updated memories in real-time (like tail -f)").option("-s, --scope <scope>", "Scope filter: global, shared, private").option("-c, --category <cat>", "Category filter: preference, fact, knowledge, history").option("--agent <name>", "Agent filter").option("--project <path>", "Project filter").option("--interval <ms>", "Poll interval in milliseconds (default: 2000)", parseInt).option("--notify", "Send macOS notifications for each change").action((opts) => {
   try {
     const globalOpts = program2.opts();
@@ -6484,7 +6551,7 @@ function diffLines(oldText, newText) {
   }
 }
 program2.command("completions <shell>").description("Output shell completion script (bash, zsh, fish)").action((shell) => {
-  const commands = "save recall list update forget search stats export import clean inject context pin unpin doctor tail diff init agents projects bulk completions config backup restore report profile mcp";
+  const commands = "save recall list update forget search stats export import clean inject context pin unpin archive versions doctor tail diff init agents projects bulk completions config backup restore report profile mcp";
   const commandList = commands.split(" ");
   switch (shell.toLowerCase()) {
     case "bash": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/mementos",
-  "version": "0.4.34",
+  "version": "0.4.36",
   "description": "Universal memory system for AI agents - CLI + MCP server + library API",
   "type": "module",
   "main": "dist/index.js",