@hasna/mementos 0.4.22 → 0.4.24

package/dist/cli/index.js

@@ -5110,6 +5110,90 @@ program2.command("stats").description("Show memory statistics").option("--format
     handleError(e);
   }
 });
+program2.command("report").description("Rich summary of memory activity and top memories").option("--days <n>", "Activity window in days (default: 7)", "7").option("--project <path>", "Filter by project path").option("--markdown", "Output as Markdown (for PRs, docs, etc.)").option("--json", "Output as JSON").action((opts) => {
+  try {
+    const globalOpts = program2.opts();
+    const days = parseInt(opts.days, 10) || 7;
+    const projectPath = opts.project || globalOpts.project;
+    let projectId;
+    if (projectPath) {
+      const project = getProject(resolve3(projectPath));
+      if (project)
+        projectId = project.id;
+    }
+    const db = getDatabase();
+    const conditions = projectId ? "AND project_id = ?" : "";
+    const params = projectId ? [projectId] : [];
+    const total = db.query(`SELECT COUNT(*) as c FROM memories WHERE status = 'active' ${conditions}`).get(...params).c;
+    const pinned = db.query(`SELECT COUNT(*) as c FROM memories WHERE status = 'active' AND pinned = 1 ${conditions}`).get(...params).c;
+    const activityRows = db.query(`
+        SELECT date(created_at) AS d, COUNT(*) AS cnt
+        FROM memories WHERE status = 'active' AND date(created_at) >= date('now', '-${days} days') ${conditions}
+        GROUP BY d ORDER BY d ASC
+      `).all(...params);
+    const recentTotal = activityRows.reduce((s, r) => s + r.cnt, 0);
+    const avgPerDay = activityRows.length > 0 ? (recentTotal / activityRows.length).toFixed(1) : "0";
+    const byScopeRows = db.query(`SELECT scope, COUNT(*) as c FROM memories WHERE status = 'active' ${conditions} GROUP BY scope`).all(...params);
+    const byScope = Object.fromEntries(byScopeRows.map((r) => [r.scope, r.c]));
+    const byCatRows = db.query(`SELECT category, COUNT(*) as c FROM memories WHERE status = 'active' ${conditions} GROUP BY category`).all(...params);
+    const byCat = Object.fromEntries(byCatRows.map((r) => [r.category, r.c]));
+    const topMems = db.query(`SELECT key, value, importance, scope, category FROM memories WHERE status = 'active' ${conditions} ORDER BY importance DESC, access_count DESC LIMIT 5`).all(...params);
+    const topAgents = db.query(`SELECT agent_id, COUNT(*) as c FROM memories WHERE status = 'active' AND agent_id IS NOT NULL ${conditions} GROUP BY agent_id ORDER BY c DESC LIMIT 5`).all(...params);
+    if (opts.json) {
+      console.log(JSON.stringify({ total, pinned, recent: { days, total: recentTotal, avg_per_day: parseFloat(avgPerDay) }, by_scope: byScope, by_category: byCat, top_memories: topMems, top_agents: topAgents }, null, 2));
+      return;
+    }
+    if (opts.markdown) {
+      const lines = [
+        `## Mementos Report (last ${days} days)`,
+        "",
+        `- **Total memories:** ${total} (${pinned} pinned)`,
+        `- **Recent activity:** ${recentTotal} new in ${days} days (~${avgPerDay}/day)`,
+        `- **Scopes:** global=${byScope["global"] || 0} shared=${byScope["shared"] || 0} private=${byScope["private"] || 0}`,
+        `- **Categories:** knowledge=${byCat["knowledge"] || 0} fact=${byCat["fact"] || 0} preference=${byCat["preference"] || 0} history=${byCat["history"] || 0}`,
+        "",
+        "### Top Memories",
+        ...topMems.map((m) => `- **${m.key}** (${m.scope}/${m.category}, imp:${m.importance}): ${m.value.slice(0, 80)}${m.value.length > 80 ? "..." : ""}`)
+      ];
+      if (topAgents.length > 0) {
+        lines.push("", "### Top Agents", ...topAgents.map((a) => `- ${a.agent_id}: ${a.c} memories`));
+      }
+      console.log(lines.join(`
+`));
+      return;
+    }
+    const sparkline = activityRows.map((r) => {
+      const bars = "\u2581\u2582\u2583\u2584\u2585\u2586\u2587\u2588";
+      const maxC = Math.max(...activityRows.map((x) => x.cnt), 1);
+      return bars[Math.round(r.cnt / maxC * 7)] || "\u2581";
+    }).join("");
+    console.log(chalk.bold(`
+mementos report \u2014 last ${days} days
+`));
+    console.log(`  ${chalk.cyan("Total:")}     ${total} memories (${chalk.yellow(String(pinned))} pinned)`);
+    console.log(`  ${chalk.cyan("Recent:")}    ${recentTotal} new \xB7 ${chalk.dim(`~${avgPerDay}/day`)}`);
+    console.log(`  ${chalk.cyan("Activity:")}  ${sparkline || chalk.dim("no activity")}`);
+    console.log(`  ${chalk.cyan("Scopes:")}    global=${byScope["global"] || 0} shared=${byScope["shared"] || 0} private=${byScope["private"] || 0}`);
+    console.log(`  ${chalk.cyan("Categories:")} knowledge=${byCat["knowledge"] || 0} fact=${byCat["fact"] || 0} preference=${byCat["preference"] || 0} history=${byCat["history"] || 0}`);
+    if (topMems.length > 0) {
+      console.log(`
+  ${chalk.bold("Top memories by importance:")}`);
+      topMems.forEach((m) => {
+        console.log(`    ${chalk.green(`[${m.importance}]`)} ${chalk.bold(m.key)} ${chalk.dim(`(${m.scope}/${m.category})`)}`);
+        console.log(`       ${m.value.slice(0, 90)}${m.value.length > 90 ? "..." : ""}`);
+      });
+    }
+    if (topAgents.length > 0) {
+      console.log(`
+  ${chalk.bold("Top agents:")}`);
+      topAgents.forEach((a) => console.log(`    ${a.agent_id}: ${a.c} memories`));
+    }
+    console.log("");
+  } catch (e) {
+    console.error(chalk.red(`report 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();

package/package.json

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