@hasna/mementos 0.4.37 → 0.4.39

package/dist/cli/index.js

@@ -5214,6 +5214,65 @@ mementos report \u2014 last ${days} days
     process.exit(1);
   }
 });
+program2.command("stale").description("Find memories not accessed recently (for cleanup/review)").option("--days <n>", "Stale threshold in days (default: 30)", parseInt).option("--project <path>", "Project filter").option("--agent <name>", "Agent filter").option("--limit <n>", "Max results (default: 20)", parseInt).option("--format <fmt>", "Output format: compact (default), json").action((opts) => {
+  try {
+    const globalOpts = program2.opts();
+    const days = opts.days || 30;
+    const limit = opts.limit || 20;
+    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 db = getDatabase();
+    const conds = [
+      "status = 'active'",
+      `(accessed_at IS NULL OR accessed_at < datetime('now', '-${days} days'))`,
+      "pinned = 0"
+    ];
+    const params = [];
+    if (projectId) {
+      conds.push("project_id = ?");
+      params.push(projectId);
+    }
+    if (agentId) {
+      conds.push("agent_id = ?");
+      params.push(agentId);
+    }
+    const rows = db.query(`SELECT id, key, value, importance, scope, category, accessed_at, access_count FROM memories WHERE ${conds.join(" AND ")} ORDER BY COALESCE(accessed_at, created_at) ASC LIMIT ?`).all(...params, limit);
+    const fmt = getOutputFormat(opts.format);
+    if (fmt === "json") {
+      outputJson({ memories: rows, count: rows.length, days });
+      return;
+    }
+    if (rows.length === 0) {
+      console.log(chalk.green(`No stale memories (not accessed in ${days}+ days).`));
+      return;
+    }
+    console.log(chalk.bold(`
+Stale memories (not accessed in ${days}+ days):
+`));
+    for (const m of rows) {
+      const lastAccess = m.accessed_at ? m.accessed_at.slice(0, 10) : chalk.dim("never");
+      console.log(`  ${chalk.dim(`[${m.importance}]`)} ${chalk.bold(m.key)} ${chalk.dim(`(${m.scope}/${m.category})`)}`);
+      console.log(`    Last accessed: ${lastAccess} \xB7 ${m.access_count} reads \xB7 ${m.value.slice(0, 80)}${m.value.length > 80 ? "..." : ""}`);
+    }
+    console.log(`
+${chalk.dim(`${rows.length} result(s). Run 'mementos archive <key>' or 'mementos forget <key>' to clean up.`)}`);
+  } catch (e) {
+    console.error(chalk.red(`stale failed: ${e instanceof Error ? e.message : String(e)}`));
+    process.exit(1);
+  }
+});
 program2.command("export").description("Export memories as JSON").option("-s, --scope <scope>", "Scope filter").option("-c, --category <cat>", "Category filter").option("--agent <name>", "Agent filter").option("--project <path>", "Project filter").action((opts) => {
   try {
     const globalOpts = program2.opts();
@@ -5404,7 +5463,7 @@ program2.command("projects").description("Manage projects").option("--add", "Add
     handleError(e);
   }
 });
-program2.command("inject").description("Output injection context for agent system prompts").option("--agent <name>", "Agent ID for scope filtering").option("--project <path>", "Project path for scope filtering").option("--session <id>", "Session ID for scope filtering").option("--max-tokens <n>", "Max approximate token budget", parseInt).option("--categories <cats>", "Comma-separated categories to include").action((opts) => {
+program2.command("inject").description("Output injection context for agent system prompts").option("--agent <name>", "Agent ID for scope filtering").option("--project <path>", "Project path for scope filtering").option("--session <id>", "Session ID for scope filtering").option("--max-tokens <n>", "Max approximate token budget", parseInt).option("--categories <cats>", "Comma-separated categories to include").option("--format <fmt>", "Output format: xml (default), compact, markdown, json").action((opts) => {
   try {
     const globalOpts = program2.opts();
     const maxTokens = opts.maxTokens || 500;
@@ -5468,8 +5527,16 @@ program2.command("inject").description("Output injection context for agent syste
     const charBudget = maxTokens * 4;
     const lines = [];
     let totalChars = 0;
+    const fmt = opts.format || "xml";
     for (const m of unique) {
-      const line = `- [${m.scope}/${m.category}] ${m.key}: ${m.value}`;
+      let line;
+      if (fmt === "compact") {
+        line = `${m.key}: ${m.value}`;
+      } else if (fmt === "json") {
+        line = JSON.stringify({ key: m.key, value: m.value, scope: m.scope, category: m.category, importance: m.importance });
+      } else {
+        line = `- [${m.scope}/${m.category}] ${m.key}: ${m.value}`;
+      }
       if (totalChars + line.length > charBudget)
         break;
       lines.push(line);
@@ -5484,10 +5551,23 @@ program2.command("inject").description("Output injection context for agent syste
       }
       return;
     }
-    const context = `<agent-memories>
+    let context;
+    if (fmt === "compact") {
+      context = lines.join(`
+`);
+    } else if (fmt === "json") {
+      context = `[${lines.join(",")}]`;
+    } else if (fmt === "markdown") {
+      context = `## Agent Memories
+
+${lines.join(`
+`)}`;
+    } else {
+      context = `<agent-memories>
 ${lines.join(`
 `)}
 </agent-memories>`;
+    }
     if (globalOpts.json) {
       outputJson({ context, count: lines.length });
     } else {
@@ -5566,7 +5646,7 @@ program2.command("bulk <action> <ids...>").description("Batch operations: forget
     handleError(e);
   }
 });
-program2.command("doctor").description("Diagnose common issues with the mementos installation").action(() => {
+program2.command("doctor").description("Diagnose common issues with the mementos installation").action(async () => {
   const globalOpts = program2.opts();
   const checks = [];
   const version = getPackageVersion();
@@ -5693,9 +5773,22 @@ program2.command("doctor").description("Diagnose common issues with the mementos
   }
   try {
     const mementosUrl = process.env["MEMENTOS_URL"] || `http://127.0.0.1:19428`;
-    checks.push({ name: "REST server URL", status: "ok", detail: `${mementosUrl} (use 'mementos-serve' to start)` });
+    let serverStatus = "warn";
+    let serverDetail = `${mementosUrl} \u2014 not reachable (run 'mementos-serve' to start)`;
+    try {
+      const controller = new AbortController;
+      const timeout = setTimeout(() => controller.abort(), 1000);
+      const res = await fetch(`${mementosUrl}/api/health`, { signal: controller.signal });
+      clearTimeout(timeout);
+      if (res.ok) {
+        const data = await res.json();
+        serverStatus = "ok";
+        serverDetail = `${mementosUrl} \u2014 running v${data.version || "?"} (${data.status || "ok"})`;
+      }
+    } catch {}
+    checks.push({ name: "REST server", status: serverStatus, detail: serverDetail });
   } catch {
-    checks.push({ name: "REST server URL", status: "ok", detail: "http://127.0.0.1:19428" });
+    checks.push({ name: "REST server", status: "warn", detail: "Could not check REST server" });
   }
   outputDoctorResults(globalOpts, checks);
 });
@@ -6551,7 +6644,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 archive versions 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 stale 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.37",
+  "version": "0.4.39",
   "description": "Universal memory system for AI agents - CLI + MCP server + library API",
   "type": "module",
   "main": "dist/index.js",