@gamaze/hicortex 0.13.3 → 0.14.0

package/dist/storage.js

@@ -9,6 +9,7 @@ exports.insertMemory = insertMemory;
 exports.getMemory = getMemory;
 exports.updateMemory = updateMemory;
 exports.strengthenMemory = strengthenMemory;
+exports.touchMemoriesShown = touchMemoriesShown;
 exports.deleteMemory = deleteMemory;
 exports.setMemoryTags = setMemoryTags;
 exports.getMemoryTags = getMemoryTags;
@@ -130,6 +131,24 @@ function strengthenMemory(db, memoryId, nowIsoStr) {
      SET access_count = access_count + 1, last_accessed = ?
      WHERE id = ?`).run(nowIsoStr, memoryId);
 }
+/**
+ * Record that memories appeared in a pushed recall index (#192): bump
+ * shown_count and refresh last_accessed (a mild strengthen — the decay clock
+ * resets so topically-live memories stop sinking) WITHOUT touching
+ * access_count, which stays reserved for real use (hardening + prune shield).
+ */
+function touchMemoriesShown(db, memoryIds, nowIsoStr) {
+    if (memoryIds.length === 0)
+        return;
+    const stmt = db.prepare(`UPDATE memories
+     SET shown_count = COALESCE(shown_count, 0) + 1, last_accessed = ?
+     WHERE id = ?`);
+    const run = db.transaction((ids) => {
+        for (const id of ids)
+            stmt.run(nowIsoStr, id);
+    });
+    run(memoryIds);
+}
 /**
  * Delete a memory, its vector, its tags, and all its links.
  */
@@ -234,7 +253,7 @@ function vectorSearch(db, queryEmbedding, limit = 10, excludeIds = []) {
  * Full-text search using FTS5 BM25 ranking.
  * Returns memories with a rank field (lower is better).
  */
-function searchFts(db, query, limit = 10, privacy, sourceAgent) {
+function searchFts(db, query, limit = 10, privacy, sourceAgent, project) {
     const conditions = ["memories_fts MATCH ?"];
     const params = [query];
     if (privacy && privacy.length > 0) {
@@ -246,6 +265,13 @@ function searchFts(db, query, limit = 10, privacy, sourceAgent) {
         conditions.push("m.source_agent = ?");
         params.push(sourceAgent);
     }
+    // #192: project is pushed into SQL (like privacy/sourceAgent) instead of
+    // being post-filtered by the caller — post-filtering a global top-N against
+    // a small project starves the result set regardless of corpus content.
+    if (project) {
+        conditions.push("m.project = ?");
+        params.push(project);
+    }
     const where = conditions.join(" AND ");
     params.push(limit);
     const rows = db

package/dist/types.d.ts

@@ -42,6 +42,12 @@ export interface MemorySearchResult {
     project: string | null;
     created_at: string;
     connections: number;
+    /** True cosine similarity to the query for vector-matched candidates; null
+     *  for FTS-only and graph-discovered hits (no measured distance). */
+    similarity?: number | null;
+    /** Which retrieval channel produced the candidate (vector KNN, BM25 FTS,
+     *  both, or graph traversal). Used by the /recall-index relevance gate. */
+    source?: "vector" | "fts" | "both" | "graph";
 }
 /** Report returned by the consolidation pipeline. */
 export interface ConsolidationReport {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gamaze/hicortex",
-  "version": "0.13.3",
+  "version": "0.14.0",
   "description": "Self-learning memory for AI agents \u2014 experience captured automatically, distilled into lessons overnight, shared across your whole fleet. Works with Hermes, OpenClaw, Claude Code, and Pi.",
   "main": "dist/index.js",
   "bin": {