@hasna/mementos 0.4.35 → 0.4.37

package/dist/cli/index.js

@@ -4785,7 +4785,7 @@ program2.command("recall <key>").description("Recall a memory by key").option("-
     handleError(e);
   }
 });
-program2.command("list").description("List memories with optional filters").option("-s, --scope <scope>", "Scope filter").option("-c, --category <cat>", "Category filter").option("--tags <tags>", "Comma-separated tags filter").option("--importance-min <n>", "Minimum importance", parseInt).option("--pinned", "Show only pinned").option("--agent <name>", "Agent filter").option("--project <path>", "Project filter").option("--limit <n>", "Max results", parseInt).option("--offset <n>", "Offset for pagination", parseInt).option("--status <status>", "Status filter: active, archived, expired").option("--format <fmt>", "Output format: compact (default), json, csv, yaml").action((opts) => {
+program2.command("list").description("List memories with optional filters").option("-s, --scope <scope>", "Scope filter").option("-c, --category <cat>", "Category filter").option("--tags <tags>", "Comma-separated tags filter").option("--importance-min <n>", "Minimum importance", parseInt).option("--pinned", "Show only pinned").option("--agent <name>", "Agent filter").option("--project <path>", "Project filter").option("--session <id>", "Session ID filter").option("--limit <n>", "Max results", parseInt).option("--offset <n>", "Offset for pagination", parseInt).option("--status <status>", "Status filter: active, archived, expired").option("--format <fmt>", "Output format: compact (default), json, csv, yaml").action((opts) => {
   try {
     const globalOpts = program2.opts();
     const agentId = opts.agent || globalOpts.agent;
@@ -4807,7 +4807,7 @@ program2.command("list").description("List memories with optional filters").opti
       limit: opts.limit || 50,
       offset: opts.offset,
       status: opts.status,
-      session_id: globalOpts.session
+      session_id: opts.session || globalOpts.session
     };
     const memories = listMemories(filter);
     const fmt = getOutputFormat(opts.format);
@@ -5980,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();
@@ -6502,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.35",
+  "version": "0.4.37",
   "description": "Universal memory system for AI agents - CLI + MCP server + library API",
   "type": "module",
   "main": "dist/index.js",