hippo-memory 0.32.0 → 0.33.0

package/README.md

@@ -60,6 +60,14 @@ hippo recall "data pipeline issues" --budget 2000
 
 ---
 
+### What's new in v0.33.0
+
+- **Fact extraction at sleep time.** `hippo sleep` now extracts standalone facts from episodic memories via LLM, stored as semantic-layer entries that score 1.3x higher and auto-deduplicate against their raw source in search results.
+- **DAG summarization.** Extracted facts cluster by entity similarity into summary nodes. When a summary matches your query, its children drill down into results automatically.
+- **Multi-hop retrieval.** `hippo recall --multihop` chains two search passes via entity tags discovered in the first pass, finding connections that single-pass search misses.
+- **`hippo dag --stats`** shows how your memory is organized across DAG levels.
+- **Performance fix.** Temporal scoring refactored from O(N^2) to O(N), eliminating stack overflow risk on large stores.
+
 ### What's new in v0.32.0
 
 - **Correction without deletion.** `hippo supersede <old-id> "<new content>"` links the old memory as historical truth and creates a successor. Default recall shows only current beliefs; the old one stays in the store so you can audit what changed and when.

package/dist/cli.js

@@ -53,6 +53,7 @@ import { auditMemories } from './audit.js';
 import { runEval, bootstrapCorpus, compareSummaries } from './eval.js';
 import { refineStore } from './refine-llm.js';
 import { wmPush, wmRead, wmClear, wmFlush } from './working-memory.js';
+import { multihopSearch } from './multihop.js';
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -377,7 +378,7 @@ function setupDailySchedule(globalRoot) {
         }
     }
 }
-function cmdRemember(hippoRoot, text, flags) {
+async function cmdRemember(hippoRoot, text, flags) {
     const useGlobal = Boolean(flags['global']);
     const targetRoot = useGlobal ? getGlobalRoot() : hippoRoot;
     if (useGlobal) {
@@ -437,6 +438,28 @@ function cmdRemember(hippoRoot, text, flags) {
             // Silently ignore embedding errors
         });
     }
+    const config = loadConfig(targetRoot);
+    const shouldExtract = flags['extract'] || config.extraction.enabled === true;
+    const apiKey = process.env.ANTHROPIC_API_KEY ?? '';
+    if (shouldExtract && apiKey) {
+        try {
+            const { extractFacts, storeExtractedFacts } = await import('./extract.js');
+            const facts = await extractFacts(entry.content, {
+                apiKey,
+                model: config.extraction.model,
+            });
+            if (facts.length > 0) {
+                storeExtractedFacts(targetRoot, entry, facts);
+                console.error(`  extracted ${facts.length} fact(s)`);
+            }
+        }
+        catch {
+            // Extraction is best-effort — never block remember
+        }
+    }
+    else if (shouldExtract && !apiKey) {
+        console.error('  (extraction skipped: ANTHROPIC_API_KEY not set)');
+    }
 }
 function cmdSupersede(hippoRoot, oldId, newContent, flags) {
     requireInit(hippoRoot);
@@ -535,8 +558,19 @@ async function cmdRecall(hippoRoot, query, flags) {
         : undefined;
     const recallExplicitScope = flags['scope'] !== undefined ? String(flags['scope']).trim() : null;
     const recallActiveScope = recallExplicitScope || detectScope();
+    const useMultihop = flags['multihop'] === true || config.multihop.enabled;
     let results;
-    if (usePhysics && !hasGlobal) {
+    if (useMultihop) {
+        const allEntries = [...localEntries, ...globalEntries];
+        results = multihopSearch(query, allEntries, {
+            budget,
+            hippoRoot,
+            minResults,
+            includeSuperseded,
+            asOf,
+        });
+    }
+    else if (usePhysics && !hasGlobal) {
         results = await physicsSearch(query, localEntries, {
             budget,
             hippoRoot,
@@ -1296,7 +1330,7 @@ function cmdDedup(hippoRoot, flags) {
         console.log(`  ... and ${result.pairs.length - 15} more (run with --dry-run to see all)`);
     }
 }
-function cmdSleep(hippoRoot, flags) {
+async function cmdSleep(hippoRoot, flags) {
     // Tee stdout/stderr to a log file when --log-file is set. The SessionEnd
     // hook uses this so the output is captured somewhere the SessionStart hook
     // can re-display it next time the agent UI starts.
@@ -1335,7 +1369,7 @@ function cmdSleep(hippoRoot, flags) {
         }
     }
     try {
-        cmdSleepCore(hippoRoot, flags);
+        await cmdSleepCore(hippoRoot, flags);
         if (logFile)
             console.log('[hippo] sleep complete');
     }
@@ -1349,7 +1383,7 @@ function cmdSleep(hippoRoot, flags) {
             restoreStdout();
     }
 }
-function cmdSleepCore(hippoRoot, flags) {
+async function cmdSleepCore(hippoRoot, flags) {
     requireInit(hippoRoot);
     // Auto-learn from git before consolidating (unless --no-learn)
     if (!flags['no-learn']) {
@@ -1366,7 +1400,7 @@ function cmdSleepCore(hippoRoot, flags) {
     }
     const dryRun = Boolean(flags['dry-run']);
     console.log(`Running consolidation${dryRun ? ' (dry run)' : ''}...`);
-    const result = consolidate(hippoRoot, { dryRun });
+    const result = await consolidate(hippoRoot, { dryRun });
     console.log(`\nResults:`);
     console.log(`   Active memories:  ${result.decayed}`);
     console.log(`   Removed (decayed): ${result.removed}`);
@@ -3374,6 +3408,44 @@ function cmdWm(hippoRoot, args, flags) {
     console.error('Usage: hippo wm <push|read|clear|flush>');
     process.exit(1);
 }
+function cmdDag(hippoRoot, flags) {
+    requireInit(hippoRoot);
+    const entries = loadAllEntries(hippoRoot);
+    const isStats = flags['stats'] === true;
+    const byLevel = new Map();
+    let unlinked = 0;
+    for (const entry of entries) {
+        const level = entry.dag_level ?? 0;
+        byLevel.set(level, (byLevel.get(level) ?? 0) + 1);
+        if (level === 1 && !entry.dag_parent_id)
+            unlinked++;
+    }
+    if (isStats) {
+        console.log('DAG Structure:');
+        console.log(`  Level 3 (entity profiles):  ${byLevel.get(3) ?? 0}`);
+        console.log(`  Level 2 (topic summaries):  ${byLevel.get(2) ?? 0}`);
+        console.log(`  Level 1 (extracted facts):  ${byLevel.get(1) ?? 0}`);
+        console.log(`  Level 0 (raw memories):     ${byLevel.get(0) ?? 0}`);
+        console.log(`  Unlinked facts: ${unlinked}`);
+        return;
+    }
+    // Tree view: show summaries and their children
+    const summaries = entries.filter((e) => e.dag_level === 2);
+    if (summaries.length === 0) {
+        console.log('No DAG summaries yet. Run `hippo sleep` with ANTHROPIC_API_KEY set.');
+        return;
+    }
+    for (const summary of summaries) {
+        const summaryTags = summary.tags.filter((t) => t !== 'dag-summary').join(', ');
+        console.log(`\n📌 ${summary.content.slice(0, 80)}`);
+        if (summaryTags)
+            console.log(`   [${summaryTags}]`);
+        const children = entries.filter((e) => e.dag_parent_id === summary.id);
+        for (const child of children) {
+            console.log(`   └─ ${child.content.slice(0, 70)}`);
+        }
+    }
+}
 function printUsage() {
     console.log(`
 Hippo - biologically-inspired memory system for AI agents
@@ -3638,7 +3710,7 @@ async function main() {
                 console.error('Memory content too short (minimum 3 characters).');
                 process.exit(1);
             }
-            cmdRemember(hippoRoot, text, flags);
+            await cmdRemember(hippoRoot, text, flags);
             break;
         }
         case 'recall': {
@@ -3691,7 +3763,7 @@ async function main() {
             await cmdRefine(hippoRoot, flags);
             break;
         case 'sleep':
-            cmdSleep(hippoRoot, flags);
+            await cmdSleep(hippoRoot, flags);
             break;
         case 'last-sleep':
             cmdLastSleep(flags);
@@ -3711,6 +3783,9 @@ async function main() {
         case 'dedup':
             cmdDedup(hippoRoot, flags);
             break;
+        case 'dag':
+            cmdDag(hippoRoot, flags);
+            break;
         case 'audit': {
             requireInit(hippoRoot);
             const entries = loadAllEntries(hippoRoot);