nexusmem 0.5.3 → 0.5.4

package/CHANGELOG.md

@@ -9,6 +9,13 @@ built from, matched by publish timestamp: `v0.1.0` → `67a4776`, `v0.1.1` → `
 
 ## [Unreleased]
 
+## [0.5.4] — 2026-08-20
+
+### Added
+
+- `nexusmem status --share`: a plain-text, no-color summary (node count, failure→fix chains
+  linked, days of history) meant to be pasted somewhere, not scraped by a script.
+
 ## [0.5.3] — 2026-08-19
 
 No functional changes to the CLI, MCP server, or published package -- a test-coverage and

package/README.md

@@ -351,8 +351,9 @@ problem.
 
 ## Commands
 
-`init`, `sync`, `query <text>`, `status`, `projects`, `mcp`, `forget <value>`,
-`mark-stale <nodeId> --supersedes <newNodeId>`, and `hook install|remove|status`.
+`init`, `sync`, `query <text>`, `status` (add `--share` for a plain-text summary worth pasting
+somewhere), `projects`, `mcp`, `forget <value>`, `mark-stale <nodeId> --supersedes <newNodeId>`,
+and `hook install|remove|status`.
 
 There are also five dry-run previews (`scan-git`, `scan-diff`, `scan-shell`, `scan-docs`,
 `scan-conversation`)

package/dist/cli/index.js

@@ -5370,8 +5370,35 @@ ${pc17.bold(String(edges.length))} edge(s) from ${filesScanned} tracked .ts/.tsx
 }
 
 // src/cli/commands/status.ts
+import { basename as basename4 } from "path";
 import { statSync } from "fs";
 import pc18 from "picocolors";
+function daySpan(oldest, newest) {
+  const oldestDay = Date.parse(oldest.slice(0, 10));
+  const newestDay = Date.parse(newest.slice(0, 10));
+  return Math.round((newestDay - oldestDay) / 864e5) + 1;
+}
+function buildShareText(repo, stats2, chains) {
+  if (stats2.total === 0) {
+    return "Nothing synced yet in this repo -- run `nexusmem sync` first, then `nexusmem status --share`.\n";
+  }
+  const days = daySpan(stats2.oldest ?? stats2.newest ?? "", stats2.newest ?? stats2.oldest ?? "");
+  const commits = stats2.byKind.git_commit ?? 0;
+  const shellCommands = stats2.byKind.shell_command ?? 0;
+  const docs = stats2.byKind.doc_section ?? 0;
+  const parts = [`${commits} commit(s)`, `${shellCommands} shell command(s)`, `${docs} doc section(s)`].filter(
+    (p) => !p.startsWith("0 ")
+  );
+  const lines = [
+    `NexusMem has been watching ${basename4(repo.root)} for ${days} day(s):`,
+    `  ${stats2.total} memories${parts.length ? ` (${parts.join(", ")})` : ""}`
+  ];
+  if (chains.failuresTotal) {
+    lines.push(`  ${chains.resolvedTotal}/${chains.failuresTotal} failure -> fix chain(s) linked`);
+  }
+  lines.push("", "Local-only SQLite, no cloud, no telemetry.", "https://github.com/yaminbkk/NexusMem");
+  return lines.join("\n").concat("\n");
+}
 function humanBytes(bytes) {
   if (bytes < 1024) return `${bytes} B`;
   if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
@@ -5390,10 +5417,14 @@ async function runStatus(opts) {
   const store = MemoryStore.open(ws.dbPath);
   try {
     const stats2 = store.stats(projectId);
+    const chains = getChainStats(store, projectId);
+    if (opts.share) {
+      out(buildShareText(repo, stats2, chains));
+      return 0;
+    }
     const sources = store.listSyncState(projectId);
     const gitCursor = sources.find((s) => s.source === "git")?.cursor ?? null;
     const schema = currentSchemaVersion(store.raw);
-    const chains = getChainStats(store, projectId);
     const otherProjectIds = store.listOtherProjectIds(projectId);
     const otherProjectNodes = store.countProjectNodes(otherProjectIds);
     const structure = store.fileEdgeStats(projectId);
@@ -5509,7 +5540,7 @@ program.command("hook").description("Manage the opt-in PowerShell hook that logs
     new Command("status").description("Show whether the git pre-commit hook is installed").option("-C, --cwd <path>", "repository path", process.cwd()).action((options) => guard(() => runHookGitStatus({ cwd: options.cwd }))())
   )
 );
-program.command("status").description("Show what is currently remembered for this repository").option("-C, --cwd <path>", "repository path", process.cwd()).action((options) => guard(() => runStatus({ cwd: options.cwd }))());
+program.command("status").description("Show what is currently remembered for this repository").option("-C, --cwd <path>", "repository path", process.cwd()).option("--share", "print a plain-text summary formatted for sharing, e.g. on X or Reddit").action((options) => guard(() => runStatus({ cwd: options.cwd, share: options.share }))());
 program.command("query").description("Search remembered history and print a token-budgeted context block").argument("<text>", "free-text query").option("-C, --cwd <path>", "repository path", process.cwd()).option("-b, --budget <tokens>", "max tokens in the packed context", (v) => Number.parseInt(v, 10), 2e3).option("-n, --candidates <count>", "how many search hits to rank before packing", (v) => Number.parseInt(v, 10), 30).option("--half-life <days>", "days for a node's recency weight to halve", (v) => Number.parseFloat(v)).option("--no-vector", "BM25 only -- skip embedding the query and vector search").option("-a, --all-projects", "search every registered repository, not just this one", false).option("--json", "emit the packed result as JSON on stdout", false).action(
   (text, options) => guard(
     () => runQuery({