@gamaze/hicortex 0.14.3 → 0.15.0

package/dist/storage.js

@@ -15,6 +15,7 @@ exports.deleteMemory = deleteMemory;
 exports.setMemoryTags = setMemoryTags;
 exports.getMemoryTags = getMemoryTags;
 exports.getMemoryTagsWeighted = getMemoryTagsWeighted;
+exports.getStoredEmbedding = getStoredEmbedding;
 exports.vectorSearch = vectorSearch;
 exports.searchFts = searchFts;
 exports.addLink = addLink;
@@ -115,6 +116,10 @@ const ALLOWED_UPDATE_FIELDS = new Set([
     "base_strength",
     "last_accessed",
     "access_count",
+    // shown_count is normally maintained by touchMemoriesShown (bulk +1 per
+    // recall-index appearance); it's also allowed here so `hicortex dedup`
+    // (#100) can sum a merged cluster's counters onto the canonical row.
+    "shown_count",
     "source_agent",
     "source_session",
     "project",
@@ -239,6 +244,24 @@ function getMemoryTagsWeighted(db, memoryId) {
         .all(memoryId);
     return rows;
 }
+/**
+ * Read the stored embedding for a memory from memory_vectors.
+ * Returns null when the row is missing (caller falls back to re-embedding).
+ *
+ * Shared by `hicortex relink` and the nightly's supersession stage
+ * (consolidate.ts) — lives here (not in relink.ts) so consolidate.ts can use
+ * it without importing from relink.ts, which itself imports from
+ * consolidate.ts (BudgetTracker, discoverLinkCandidates).
+ */
+function getStoredEmbedding(db, memoryId) {
+    const row = db
+        .prepare("SELECT embedding FROM memory_vectors WHERE id = ?")
+        .get(memoryId);
+    if (!row?.embedding)
+        return null;
+    const buf = row.embedding;
+    return new Float32Array(buf.buffer, buf.byteOffset, buf.byteLength / 4);
+}
 // ---------------------------------------------------------------------------
 // Vector search
 // ---------------------------------------------------------------------------

package/dist/types.d.ts

@@ -108,6 +108,21 @@ export interface ConsolidationReport {
             heuristic_fallback?: number;
             failed: number;
         };
+        /** Supersession detection (#191 Phase B) — runs after linking, before decay/prune. */
+        supersession?: {
+            /** Decision/correction-shaped candidates examined this run. */
+            scanned: number;
+            /** Older-neighbor pairs actually sent to the classify-tier LLM. */
+            evaluated: number;
+            /** Pairs the LLM judged superseded — a `superseded_by` link was created. */
+            superseded: number;
+            /** Pairs skipped on a parse/infra error (retried naturally next night). */
+            skipped_infra: number;
+            /** Pairs skipped because a superseded_by link already existed (either direction). */
+            skipped_idempotent: number;
+            /** supersessionCursor after this run (unchanged in dry-run). */
+            cursor: number;
+        };
         decay_prune?: {
             candidates: number;
             pruned: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gamaze/hicortex",
-  "version": "0.14.3",
+  "version": "0.15.0",
   "description": "Self-learning memory for AI agents — 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": {
@@ -37,6 +37,7 @@
     "build": "rm -rf dist && tsc",
     "test": "vitest run",
     "test:watch": "vitest",
+    "eval": "node dist/eval/run-eval.js",
     "prepack": "npm run build && rm -rf ./hermes-plugin && mkdir -p ./hermes-plugin && cp -r ../../hermes-plugin/hicortex ./hermes-plugin/ && find ./hermes-plugin -name __pycache__ -type d -exec rm -rf {} + 2>/dev/null || true",
     "prepublishOnly": "npm run build && rm -rf ./hermes-plugin && mkdir -p ./hermes-plugin && cp -r ../../hermes-plugin/hicortex ./hermes-plugin/ && find ./hermes-plugin -name __pycache__ -type d -exec rm -rf {} + 2>/dev/null || true"
   },