hippo-memory 0.6.2 → 0.7.0

package/README.md

@@ -47,6 +47,7 @@ That's it. You have a memory system.
 
 - **SQLite-first storage** with markdown/JSON mirrors for humans and git
 - **Active task snapshots** for bare `continue` recovery
+- **Session event trails** for short-term continuity across stops and resumes
 - **Persistent stale-memory lifecycle** during `hippo sleep`
 - **Conflict tracking** with `hippo conflicts` and `.hippo/conflicts/` mirrors
 
@@ -126,6 +127,29 @@ hippo snapshot clear
 
 `hippo context --auto` includes the active task snapshot before long-term memories, so agents get both the immediate thread and the deeper lessons.
 
+### Session event trails
+
+Manual snapshots are useful, but real work also needs a breadcrumb trail. Hippo can now store short session events and link them to the active snapshot so context output shows the latest steps, not just the last summary.
+
+```bash
+hippo session log \
+  --id sess_20260326 \
+  --task "Ship continuity" \
+  --type progress \
+  --content "Schema migration is done, next step is CLI wiring"
+
+hippo snapshot save \
+  --task "Ship continuity" \
+  --summary "Structured session events are flowing" \
+  --next-step "Surface them in framework hooks" \
+  --session sess_20260326
+
+hippo session show --id sess_20260326
+hippo context --auto --budget 1500
+```
+
+Hippo mirrors the latest trail to `.hippo/buffer/recent-session.md` so you can inspect the short-term thread without opening SQLite.
+
 ---
 
 ## How It Works
@@ -555,11 +579,9 @@ Issues and PRs welcome. Before contributing, run `hippo status` in the repo root
 
 The interesting problems:
 - Better consolidation heuristics (what makes a good semantic memory?)
-- Embedding-based search (currently BM25 only)
-- MCP server wrapper
-- Conflict detection between semantic memories
 - Schema acceleration (fast-track memories that fit existing patterns)
 - Multi-agent shared memory with attribution
+- Benchmark eval: memory-augmented agent vs static memory vs no memory
 
 ## License
 

package/dist/autolearn.d.ts

@@ -26,6 +26,10 @@ export declare function runWatched(command: string): Promise<{
     exitCode: number;
     stderr: string;
 }>;
+/**
+ * Check whether a directory is a git work tree.
+ */
+export declare function isGitRepo(cwd: string): boolean;
 /**
  * Fetch recent git log lines (subject lines only).
  * days: how many days of history to include.

package/dist/autolearn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autolearn.d.ts","sourceRoot":"","sources":["../src/autolearn.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAuB,MAAM,aAAa,CAAC;AAI/D;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,WAAW,CAkBb;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAsClF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,SAAM,GACd,OAAO,CAST;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBzF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAW7D"}
+{"version":3,"file":"autolearn.d.ts","sourceRoot":"","sources":["../src/autolearn.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAuB,MAAM,aAAa,CAAC;AAI/D;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,WAAW,CAkBb;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAsClF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,SAAM,GACd,OAAO,CAST;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBzF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAY9C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAW7D"}

package/dist/autolearn.js

@@ -104,6 +104,23 @@ export function runWatched(command) {
         });
     });
 }
+/**
+ * Check whether a directory is a git work tree.
+ */
+export function isGitRepo(cwd) {
+    try {
+        const raw = execSync('git rev-parse --is-inside-work-tree', {
+            encoding: 'utf8',
+            cwd,
+            timeout: 10000,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        return raw.trim() === 'true';
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Fetch recent git log lines (subject lines only).
  * days: how many days of history to include.

package/dist/autolearn.js.map

@@ -1 +1 @@
-{"version":3,"file":"autolearn.js","sourceRoot":"","sources":["../src/autolearn.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"autolearn.js","sourceRoot":"","sources":["../src/autolearn.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -11,6 +11,7 @@
  *   hippo outcome --good | --bad [--id <id>]
  *   hippo conflicts [--status <status>] [--json]
  *   hippo snapshot <save|show|clear>
+ *   hippo session <log|show>
  *   hippo forget <id>
  *   hippo inspect <id>
  *   hippo embed [--status]

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;GAmBG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/cli.js

@@ -11,6 +11,7 @@
  *   hippo outcome --good | --bad [--id <id>]
  *   hippo conflicts [--status <status>] [--json]
  *   hippo snapshot <save|show|clear>
+ *   hippo session <log|show>
  *   hippo forget <id>
  *   hippo inspect <id>
  *   hippo embed [--status]
@@ -23,12 +24,12 @@ import * as path from 'path';
 import * as fs from 'fs';
 import { execSync } from 'child_process';
 import { createMemory, calculateStrength, resolveConfidence, applyOutcome, Layer, } from './memory.js';
-import { getHippoRoot, isInitialized, initStore, writeEntry, readEntry, deleteEntry, loadAllEntries, loadSearchEntries, loadIndex, saveIndex, loadStats, updateStats, saveActiveTaskSnapshot, loadActiveTaskSnapshot, clearActiveTaskSnapshot, listMemoryConflicts, } from './store.js';
-import { search, markRetrieved, estimateTokens } from './search.js';
+import { getHippoRoot, isInitialized, initStore, writeEntry, readEntry, deleteEntry, loadAllEntries, loadSearchEntries, loadIndex, saveIndex, loadStats, updateStats, saveActiveTaskSnapshot, loadActiveTaskSnapshot, clearActiveTaskSnapshot, appendSessionEvent, listSessionEvents, listMemoryConflicts, } from './store.js';
+import { markRetrieved, estimateTokens, hybridSearch } from './search.js';
 import { consolidate } from './consolidate.js';
 import { isEmbeddingAvailable, embedAll, embedMemory, loadEmbeddingIndex, } from './embeddings.js';
-import { captureError, extractLessons, deduplicateLesson, runWatched, fetchGitLog, } from './autolearn.js';
-import { getGlobalRoot, initGlobal, promoteToGlobal, searchBoth, syncGlobalToLocal, } from './shared.js';
+import { captureError, extractLessons, deduplicateLesson, runWatched, fetchGitLog, isGitRepo, } from './autolearn.js';
+import { getGlobalRoot, initGlobal, promoteToGlobal, searchBothHybrid, syncGlobalToLocal, } from './shared.js';
 import { importChatGPT, importClaude, importCursor, importGenericFile, importMarkdown, } from './importers.js';
 import { cmdCapture } from './capture.js';
 // ---------------------------------------------------------------------------
@@ -259,7 +260,7 @@ function cmdRemember(hippoRoot, text, flags) {
         });
     }
 }
-function cmdRecall(hippoRoot, query, flags) {
+async function cmdRecall(hippoRoot, query, flags) {
     requireInit(hippoRoot);
     const budget = parseInt(String(flags['budget'] ?? '4000'), 10);
     const asJson = Boolean(flags['json']);
@@ -269,12 +270,11 @@ function cmdRecall(hippoRoot, query, flags) {
     const hasGlobal = globalEntries.length > 0;
     let results;
     if (hasGlobal) {
-        // Use searchBoth for merged results
-        const merged = searchBoth(query, hippoRoot, globalRoot, { budget });
-        results = merged;
+        // Use searchBothHybrid for merged results with embedding support
+        results = await searchBothHybrid(query, hippoRoot, globalRoot, { budget });
     }
     else {
-        results = search(query, localEntries, { budget });
+        results = await hybridSearch(query, localEntries, { budget, hippoRoot });
     }
     if (results.length === 0) {
         if (asJson) {
@@ -494,6 +494,9 @@ function printActiveTaskSnapshot(snapshot) {
     console.log(`- Status: ${snapshot.status}`);
     console.log(`- Updated: ${snapshot.updated_at}`);
     console.log(`- Source: ${snapshot.source}`);
+    if (snapshot.session_id) {
+        console.log(`- Session: ${snapshot.session_id}`);
+    }
     console.log('');
     console.log('### Summary');
     console.log(snapshot.summary);
@@ -502,6 +505,22 @@ function printActiveTaskSnapshot(snapshot) {
     console.log(snapshot.next_step);
     console.log('');
 }
+function printSessionEvents(events) {
+    if (events.length === 0) {
+        console.log('No session events found.');
+        return;
+    }
+    const latest = events[events.length - 1];
+    console.log('## Recent Session Trail\n');
+    console.log(`- Session: ${latest.session_id}`);
+    console.log(`- Task: ${latest.task ?? 'n/a'}`);
+    console.log(`- Updated: ${latest.created_at}`);
+    console.log('');
+    for (const event of events) {
+        console.log(`- [${event.created_at}] (${event.event_type}) ${event.content}`);
+    }
+    console.log('');
+}
 function cmdConflicts(hippoRoot, flags) {
     requireInit(hippoRoot);
     const conflicts = listMemoryConflicts(hippoRoot, String(flags['status'] ?? 'open'));
@@ -528,8 +547,9 @@ function cmdSnapshot(hippoRoot, args, flags) {
         const task = String(flags['task'] ?? '').trim();
         const summary = String(flags['summary'] ?? '').trim();
         const nextStep = String(flags['next-step'] ?? '').trim();
+        const sessionId = String(flags['session'] ?? flags['id'] ?? '').trim();
         if (!task || !summary || !nextStep) {
-            console.error('Usage: hippo snapshot save --task <task> --summary <summary> --next-step <step> [--source <source>]');
+            console.error('Usage: hippo snapshot save --task <task> --summary <summary> --next-step <step> [--source <source>] [--session <session-id>]');
             process.exit(1);
         }
         const snapshot = saveActiveTaskSnapshot(hippoRoot, {
@@ -537,10 +557,14 @@ function cmdSnapshot(hippoRoot, args, flags) {
             summary,
             next_step: nextStep,
             source: String(flags['source'] ?? 'cli'),
+            session_id: sessionId || null,
         });
         console.log(`Saved active task snapshot #${snapshot.id}`);
         console.log(`   Task: ${snapshot.task}`);
         console.log(`   Next: ${snapshot.next_step}`);
+        if (snapshot.session_id) {
+            console.log(`   Session: ${snapshot.session_id}`);
+        }
         return;
     }
     if (subcommand === 'clear') {
@@ -573,7 +597,48 @@ function cmdSnapshot(hippoRoot, args, flags) {
     console.error('Usage: hippo snapshot <save|show|clear>');
     process.exit(1);
 }
-function cmdContext(hippoRoot, args, flags) {
+function cmdSession(hippoRoot, args, flags) {
+    requireInit(hippoRoot);
+    const subcommand = args[0] ?? 'show';
+    const sessionId = String(flags['id'] ?? flags['session'] ?? '').trim();
+    const task = String(flags['task'] ?? '').trim();
+    const limit = Math.max(1, parseInt(String(flags['limit'] ?? '8'), 10) || 8);
+    if (subcommand === 'log') {
+        const eventType = String(flags['type'] ?? 'note').trim();
+        const content = String(flags['content'] ?? '').trim();
+        if (!sessionId || !content) {
+            console.error('Usage: hippo session log --id <session-id> --content <text> [--type <type>] [--task <task>] [--source <source>]');
+            process.exit(1);
+        }
+        const event = appendSessionEvent(hippoRoot, {
+            session_id: sessionId,
+            task: task || null,
+            event_type: eventType || 'note',
+            content,
+            source: String(flags['source'] ?? 'cli'),
+        });
+        console.log(`Logged session event #${event.id}`);
+        console.log(`   Session: ${event.session_id}`);
+        console.log(`   Type: ${event.event_type}`);
+        return;
+    }
+    if (subcommand === 'show') {
+        const events = listSessionEvents(hippoRoot, {
+            session_id: sessionId || undefined,
+            task: task || undefined,
+            limit,
+        });
+        if (flags['json']) {
+            console.log(JSON.stringify({ events }, null, 2));
+            return;
+        }
+        printSessionEvents(events);
+        return;
+    }
+    console.error('Usage: hippo session <log|show>');
+    process.exit(1);
+}
+async function cmdContext(hippoRoot, args, flags) {
     requireInit(hippoRoot);
     const budget = parseInt(String(flags['budget'] ?? '1500'), 10);
     // If budget is 0, skip entirely (zero token cost)
@@ -598,6 +663,9 @@ function cmdContext(hippoRoot, args, flags) {
     let selectedItems = [];
     let totalTokens = 0;
     const activeSnapshot = loadActiveTaskSnapshot(hippoRoot);
+    const recentSessionEvents = activeSnapshot?.session_id
+        ? listSessionEvents(hippoRoot, { session_id: activeSnapshot.session_id, limit: 5 })
+        : [];
     if (query === '*') {
         // No query: return strongest memories by strength, up to budget
         const now = new Date();
@@ -630,7 +698,7 @@ function cmdContext(hippoRoot, args, flags) {
     else {
         let results;
         if (hasGlobal) {
-            const merged = searchBoth(query, hippoRoot, globalRoot, { budget });
+            const merged = await searchBothHybrid(query, hippoRoot, globalRoot, { budget });
             const localIndex = loadIndex(hippoRoot);
             results = merged.map((r) => ({
                 entry: r.entry,
@@ -640,7 +708,7 @@ function cmdContext(hippoRoot, args, flags) {
             }));
         }
         else {
-            results = search(query, localEntries, { budget }).map((r) => ({
+            results = (await hybridSearch(query, localEntries, { budget, hippoRoot })).map((r) => ({
                 entry: r.entry,
                 score: r.score,
                 tokens: r.tokens,
@@ -650,7 +718,7 @@ function cmdContext(hippoRoot, args, flags) {
         selectedItems = results;
         totalTokens = results.reduce((sum, r) => sum + r.tokens, 0);
     }
-    if (selectedItems.length === 0 && !activeSnapshot)
+    if (selectedItems.length === 0 && !activeSnapshot && recentSessionEvents.length === 0)
         return;
     // Mark retrieved and persist
     const toUpdate = selectedItems.map((s) => s.entry);
@@ -675,12 +743,15 @@ function cmdContext(hippoRoot, args, flags) {
             content: r.entry.content,
             global: r.isGlobal ?? false,
         }));
-        console.log(JSON.stringify({ query, activeSnapshot, memories: output, tokens: totalTokens }));
+        console.log(JSON.stringify({ query, activeSnapshot, recentSessionEvents, memories: output, tokens: totalTokens }));
     }
     else {
         if (activeSnapshot) {
             printActiveTaskSnapshot(activeSnapshot);
         }
+        if (recentSessionEvents.length > 0) {
+            printSessionEvents(recentSessionEvents);
+        }
         printContextMarkdown(selectedItems.map((r) => ({
             entry: updatedEntries.find((u) => u.id === r.entry.id) ?? r.entry,
             score: r.score,
@@ -813,9 +884,13 @@ async function cmdWatch(command, hippoRoot) {
 // ---------------------------------------------------------------------------
 function learnFromRepo(hippoRoot, repoPath, days, label) {
     const prefix = label ? `[${label}] ` : '';
+    if (!isGitRepo(repoPath)) {
+        console.log(`${prefix}No git history found (or not a git repository).`);
+        return { added: 0, skipped: 0 };
+    }
     const gitLog = fetchGitLog(repoPath, days);
     if (!gitLog.trim()) {
-        console.log(`${prefix}No git history found (or not a git repository).`);
+        console.log(`${prefix}No fix/revert/bug commits found in the specified period.`);
         return { added: 0, skipped: 0 };
     }
     const lessons = extractLessons(gitLog);
@@ -1217,10 +1292,23 @@ Commands:
       --summary <summary>
       --next-step <step>
       --source <source>    Optional source label
+      --session <id>       Link snapshot to a session trail
     snapshot show          Show the active task snapshot
       --json               Output as JSON
     snapshot clear         Clear the active task snapshot
       --status <status>    Mark final status (default: cleared)
+  session <sub>            Append or inspect short-term session history
+    session log            Append a structured session event
+      --id <session-id>
+      --content <text>
+      --type <type>        Event type (default: note)
+      --task <task>        Optional task label
+      --source <source>    Optional source label
+    session show           Show recent events for a session or task
+      --id <session-id>
+      --task <task>
+      --limit <n>          Event limit (default: 8)
+      --json               Output as JSON
   forget <id>              Force remove a memory
   inspect <id>             Show full memory detail
   embed                    Embed all memories for semantic search
@@ -1259,7 +1347,8 @@ Examples:
   hippo recall "data pipeline issues" --budget 2000
   hippo context --auto --budget 1500
   hippo conflicts
-  hippo snapshot save --task "Ship feature" --summary "Tests are green" --next-step "Open the PR"
+  hippo session log --id sess_123 --task "Ship feature" --type progress --content "Build is green, next step is docs"
+  hippo snapshot save --task "Ship feature" --summary "Tests are green" --next-step "Open the PR" --session sess_123
   hippo embed --status
   hippo watch "npm run build"
   hippo learn --git --days 30
@@ -1296,7 +1385,7 @@ async function main() {
                 console.error('Please provide a search query.');
                 process.exit(1);
             }
-            cmdRecall(hippoRoot, query, flags);
+            await cmdRecall(hippoRoot, query, flags);
             break;
         }
         case 'sleep':
@@ -1314,6 +1403,9 @@ async function main() {
         case 'snapshot':
             cmdSnapshot(hippoRoot, args, flags);
             break;
+        case 'session':
+            cmdSession(hippoRoot, args, flags);
+            break;
         case 'forget': {
             const id = args[0];
             if (!id) {
@@ -1333,7 +1425,7 @@ async function main() {
             break;
         }
         case 'context':
-            cmdContext(hippoRoot, args, flags);
+            await cmdContext(hippoRoot, args, flags);
             break;
         case 'hook':
             cmdHook(args, flags);