nexusmem 0.10.0 → 0.10.1

package/CHANGELOG.md

@@ -11,6 +11,29 @@ built from, matched by publish timestamp: `v0.1.0` → `67a4776`, `v0.1.1` → `
 
 No unreleased changes yet.
 
+## [0.10.1] — 2026-08-30
+
+### Added
+
+- `nodes.retrieved_count`/`nodes.last_retrieved_at` (schema V12): retrieval outcomes are now recorded
+  instead of silently discarded. Bumped once per completed `nexusmem query`/MCP `search_memory` call,
+  for every node actually packed into the returned context (both CLI and MCP share one pipeline, so
+  both are covered from a single call site). Not yet folded into `rank.ts`'s score formula — every
+  existing ranking factor was tuned against real dogfooded queries and validated with `npm run eval`
+  before being trusted, and a new factor needs the same treatment. This release is the instrumentation
+  half only; confirmed eval-neutral (MRR 0.943 / Recall@5 0.964, unchanged).
+
+### Fixed
+
+- `nexusmem precheck`'s "What already failed here" warning implied the failure was located in the
+  flagged file, but the match is against basename word-tokens (`tokensForFile`) — a failing `npm run
+  precheck` flagged every file whose name contained that word, not just the one actually responsible.
+  Reworded to state what's actually true ("commands naming this file failed").
+- The high-churn warning in `nexusmem precheck` was rendered as a `WARN`, the same severity as the
+  dogfooded failure-correlation warning, despite `HIGH_CHURN_THRESHOLD` being an admitted, untuned
+  guess. Demoted to a lower-severity `note`, explicitly labeled as an untuned heuristic, so it no
+  longer reads as equally trustworthy.
+
 ## [0.10.0] — 2026-08-29
 
 ### Added
@@ -575,7 +598,8 @@ First public release.
   there is no local-model summarization pass, and the conversation collector has never been audited
   for the stale-node bug that was found and fixed in the docs collector.
 
-[Unreleased]: https://github.com/yaminbkk/NexusMem/compare/v0.10.0...HEAD
+[Unreleased]: https://github.com/yaminbkk/NexusMem/compare/v0.10.1...HEAD
+[0.10.1]: https://github.com/yaminbkk/NexusMem/compare/v0.10.0...v0.10.1
 [0.10.0]: https://github.com/yaminbkk/NexusMem/compare/v0.9.1...v0.10.0
 [0.9.1]: https://github.com/yaminbkk/NexusMem/compare/v0.9.0...v0.9.1
 [0.9.0]: https://github.com/yaminbkk/NexusMem/compare/v0.8.0...v0.9.0

package/README.md

@@ -6,7 +6,7 @@
 [![License: MIT](https://img.shields.io/badge/license-MIT-informational)](LICENSE)
 ![Node](https://img.shields.io/badge/node-%3E%3D22-brightgreen)
 
-![NexusMem: init, sync, status, and a query against this repo's own history](docs/demo.gif)
+![NexusMem: init, sync --github, and a query against this repo's own history — surfacing a real issue, the PR that closed it, and the commits it shipped](docs/demo.gif)
 
 Your coding agent can read `git log`. It cannot read the four things you tried last Tuesday that
 didn't work.

package/dist/cli/index.js

@@ -1033,6 +1033,10 @@ INSERT INTO nodes_vec (rowid, project_id, embedding)
 
 DROP TABLE nodes_vec_stage;
 `;
+var V12 = `
+ALTER TABLE nodes ADD COLUMN retrieved_count INTEGER NOT NULL DEFAULT 0;
+ALTER TABLE nodes ADD COLUMN last_retrieved_at INTEGER;
+`;
 var MIGRATIONS = [
   { version: 1, up: (db) => db.exec(V1) },
   { version: 2, up: (db) => db.exec(V2) },
@@ -1044,7 +1048,8 @@ var MIGRATIONS = [
   { version: 8, up: (db) => db.exec(V8) },
   { version: 9, up: (db) => db.exec(V9) },
   { version: 10, up: (db) => db.exec(V10) },
-  { version: 11, up: (db) => db.exec(V11) }
+  { version: 11, up: (db) => db.exec(V11) },
+  { version: 12, up: (db) => db.exec(V12) }
 ];
 var LATEST_SCHEMA_VERSION = MIGRATIONS[MIGRATIONS.length - 1]?.version ?? 0;
 function currentSchemaVersion(db) {
@@ -1316,6 +1321,19 @@ function listStaleCandidates(db, projectId, opts = {}) {
     ageDays: Math.round((now.getTime() - r.tsEpoch) / 864e5)
   }));
 }
+function recordRetrievals(db, ids) {
+  if (ids.length === 0) return;
+  db.prepare(
+    `UPDATE nodes SET retrieved_count = retrieved_count + 1, last_retrieved_at = @now
+     WHERE id IN (SELECT value FROM json_each(@ids))`
+  ).run({ now: Date.now(), ids: JSON.stringify(ids) });
+}
+function getRetrievalStats(db, id) {
+  const row = db.prepare("SELECT retrieved_count AS retrievedCount, last_retrieved_at AS lastRetrievedAt FROM nodes WHERE id = ?").get(
+    id
+  );
+  return row ?? null;
+}
 function countStaleCandidates(db, projectId, opts = {}) {
   const now = opts.now ?? /* @__PURE__ */ new Date();
   const minAgeDays = opts.minAgeDays ?? 45;
@@ -1845,6 +1863,14 @@ var MemoryStore = class _MemoryStore {
   countStaleCandidates(projectId, opts = {}) {
     return countStaleCandidates(this.db, projectId, opts);
   }
+  /** Bump retrieval bookkeeping for nodes actually packed into a query result. See `nodes.ts`'s `recordRetrievals` for why this doesn't touch ranking. */
+  recordRetrievals(ids) {
+    recordRetrievals(this.db, ids);
+  }
+  /** Retrieval bookkeeping for one node, or null if it doesn't exist. Mainly for tests. */
+  getRetrievalStats(id) {
+    return getRetrievalStats(this.db, id);
+  }
   /** Memoize one SLM contradiction judgment (either verdict). Suggest-only: never writes `supersedes`. */
   recordContradictionCheck(input) {
     recordContradictionCheck(this.db, input);
@@ -2812,8 +2838,21 @@ async function runCrossProjectQuery(sources, query, opts) {
     rankHits(hits, { halfLifeDays: opts.halfLifeDays, relevanceScores, supersededIds })
   );
   const packed = packContext(ranked, opts.budget, { query });
+  recordRetrievalsByProject(storeByLabel, packed.nodes);
   return { bm25Count, vectorCount, hits, packed, perProject };
 }
+function recordRetrievalsByProject(storeByLabel, nodes) {
+  const idsByLabel = /* @__PURE__ */ new Map();
+  for (const node of nodes) {
+    if (!node.project) continue;
+    const ids = idsByLabel.get(node.project) ?? [];
+    ids.push(node.id);
+    idsByLabel.set(node.project, ids);
+  }
+  for (const [label, ids] of idsByLabel) {
+    storeByLabel.get(label)?.recordRetrievals(ids);
+  }
+}
 async function runHybridQuery(store, projectId, query, opts) {
   const bm25Hits = store.search(projectId, query, opts.candidates, { asOfEpoch: opts.asOfEpoch });
   let vectorHits = [];
@@ -2829,6 +2868,7 @@ async function runHybridQuery(store, projectId, query, opts) {
     rankHits(hits, { halfLifeDays: opts.halfLifeDays, relevanceScores, supersededIds })
   );
   const packed = packContext(ranked, opts.budget, { query });
+  store.recordRetrievals(packed.nodes.map((n) => n.id));
   return { bm25Count: bm25Hits.length, vectorCount: vectorHits.length, hits, packed };
 }
 
@@ -5876,7 +5916,7 @@ ${pc8.dim("-".repeat(40))}
     out(`  ${pc8.bold(risk.path)}
 `);
     if (risk.unresolvedFailures.length > 0) {
-      out(`    ${pc8.yellow("WARN")}  What already failed here (${risk.unresolvedFailures.length} unresolved):
+      out(`    ${pc8.yellow("WARN")}  commands naming this file failed, still unresolved (${risk.unresolvedFailures.length}):
 `);
       for (const f of risk.unresolvedFailures.slice(0, 3)) {
         out(`           ${pc8.dim(`${f.ts.slice(0, 10)}  ${f.command.slice(0, 90)}`)}
@@ -5888,7 +5928,7 @@ ${pc8.dim("-".repeat(40))}
       }
     }
     if (risk.commitsRecent >= HIGH_CHURN_THRESHOLD) {
-      out(`    ${pc8.yellow("WARN")}  high churn: ${risk.commitsRecent} commits touched this file recently
+      out(`    ${pc8.dim("note")}  high churn (untuned heuristic): ${risk.commitsRecent} commits touched this file recently
 `);
     }
     out("\n");