hippo-memory 0.24.0 → 0.24.2

package/README.md

@@ -60,6 +60,18 @@ hippo recall "data pipeline issues" --budget 2000
 
 ---
 
+### What's new in v0.24.2
+
+- **One daily runner per machine, not one task per project.** `hippo init` now registers each workspace and installs a machine-level `hippo daily-runner` job that sweeps every registered Hippo project at 6:15am.
+- **OpenClaw session-end autosleep no longer blocks shutdown.** The native OpenClaw plugin now detaches `hippo sleep` on `session_end` when `autoSleep` is enabled.
+- **Retrieval and refresh are now documented separately across tools.** Query-time recall still uses local plus global memory, while session-end hooks and the daily runner handle consolidation on their own paths.
+
+### What's new in v0.24.1
+
+- **Conflict detection stops over-weighting shared tags.** `feedback` / `policy` tags no longer make unrelated memories look contradictory on the next `hippo sleep`.
+- **Reworded contradictions still get caught.** Hippo keeps pairs like `API auth must be enabled in prod` / `Disable API auth in prod` while dropping the false positives that triggered the review.
+- **Broader regression coverage.** This release adds tests for the exact false-positive examples from the migrated store plus extra polarity cases like `must` vs `should not` and `available` vs `missing`.
+
 ### What's new in v0.24.0
 
 - **Codex session-end memory is now automatic on install/update.** Hippo no longer tells Codex users to fix `PATH` by hand. The published package now attempts to wrap the detected `codex` launcher during install or upgrade, and it can self-heal on later Hippo commands if Codex shows up afterward.
@@ -88,7 +100,7 @@ hippo setup              # picks up the new SessionEnd capture hook
 
 ### What's new in v0.21.0
 
-- **`hippo setup` — one command, every tool.** Detects Claude Code, OpenCode, OpenClaw, Codex, Cursor, and Pi on your machine and installs all available SessionEnd + SessionStart hooks in one pass. Idempotent — safe to re-run.
+- **`hippo setup` — one command, every tool.** Detects Claude Code, OpenCode, OpenClaw, Codex, Cursor, and Pi on your machine and installs all available SessionEnd + SessionStart hooks in one pass. It also repairs the machine-level daily runner. Idempotent — safe to re-run.
 - **OpenCode hooks.** SessionEnd + SessionStart install into `~/.config/opencode/opencode.json` (OpenCode added Claude-Code-compatible hooks in Jan 2026).
 - **You actually see consolidation output now.** New `SessionStart` hook prints the previous session's `hippo sleep` output between banners on the next startup. Previously, SessionEnd output was invisible because the TUI was tearing down when it ran.
 
@@ -204,8 +216,8 @@ hippo init
 ```
 
 If you have a `CLAUDE.md`, it patches it. `AGENTS.md` for Codex/OpenClaw/OpenCode. `.cursorrules` for Cursor. For Codex, Hippo also wraps the detected launcher in place so `/exit` can consolidate memory without a manual PATH step. No manual `hook install` needed. Your agent starts using Hippo on its next session.
-
-It also sets up a daily cron job (6:15am) that runs `hippo learn --git` and `hippo sleep` automatically. Memories get captured from your commits and consolidated every day without you thinking about it.
+
+It also registers the current project in Hippo's workspace registry and installs one machine-level daily runner (6:15am). That runner sweeps every registered workspace, runs `hippo learn --git --days 1`, then `hippo sleep`. You get strict daily consolidation without creating one OS task per project.
 
 To skip: `hippo init --no-hooks --no-schedule`
 
@@ -476,9 +488,9 @@ Agents can see at a glance what's established fact vs. a pattern worth questioni
 
 Memories unretrieved for 30+ days are automatically marked `stale` during the next `hippo sleep`. If one gets recalled again, Hippo wakes it back up to `observed` so it can earn trust again instead of staying permanently stale.
 
-### Conflict tracking
-
-Hippo now detects obvious contradictions between overlapping memories and keeps them visible instead of silently letting both masquerade as truth.
+### Conflict tracking
+
+Hippo detects obvious contradictions between overlapping memories and keeps them visible instead of silently letting both masquerade as truth. Shared tags alone do not count; the statements themselves need to overlap in content.
 
 ```bash
 hippo sleep       # refreshes open conflicts
@@ -653,9 +665,10 @@ hippo watch "npm run build"
 | `hippo embed` | Embed all memories for semantic search |
 | `hippo embed --status` | Show embedding coverage |
 | `hippo watch "<command>"` | Run command, auto-learn from failures |
-| `hippo learn --git` | Scan recent git commits for lessons |
-| `hippo learn --git --days <n>` | Scan N days back (default: 7) |
-| `hippo learn --git --repos <paths>` | Scan multiple repos (comma-separated) |
+| `hippo learn --git` | Scan recent git commits for lessons |
+| `hippo learn --git --days <n>` | Scan N days back (default: 7) |
+| `hippo learn --git --repos <paths>` | Scan multiple repos (comma-separated) |
+| `hippo daily-runner` | Sweep registered workspaces and run daily learn+sleep |
 | `hippo conflicts` | List detected open memory conflicts |
 | `hippo conflicts --json` | Output conflicts as JSON |
 | `hippo resolve <id>` | Show both conflicting memories for comparison |
@@ -703,7 +716,7 @@ hippo watch "npm run build"
 | Claude Code | `CLAUDE.md` or `.claude/settings.json` | `CLAUDE.md` + `SessionStart`/`SessionEnd` hooks in `settings.json` |
 | Codex | `AGENTS.md` or `.codex` | `AGENTS.md` + automatic in-place Codex launcher wrapper |
 | Cursor | `.cursorrules` or `.cursor/rules` | `.cursorrules` |
-| OpenClaw | `.openclaw` or `AGENTS.md` | `AGENTS.md` |
+| OpenClaw | `.openclaw` or `AGENTS.md` | native OpenClaw plugin or `AGENTS.md` |
 | OpenCode | `.opencode/` or `opencode.json` | `AGENTS.md` |
 
 No extra commands needed. Just `hippo init` and your agent knows about Hippo.
@@ -769,8 +782,14 @@ Exposes tools: `hippo_recall`, `hippo_remember`, `hippo_outcome`, `hippo_context
 
 ### OpenClaw Plugin
 
-Native plugin with auto-context injection, workspace-aware memory lookup, and
-tool hooks for auto-learn / auto-sleep.
+Native plugin with auto-context injection, workspace-aware memory lookup, and
+tool hooks for auto-learn / auto-sleep. When `autoSleep` is enabled, the
+OpenClaw plugin now launches `hippo sleep` in a detached background worker at
+session end so the live session can exit immediately.
+
+Query-time retrieval still uses the active workspace store plus the shared
+global store. Daily consolidation comes from the machine-level runner that
+`hippo init` / `hippo setup` installs.
 
 ```bash
 openclaw plugins install hippo-memory

package/dist/cli.d.ts

@@ -19,6 +19,7 @@
  *   hippo embed [--status]
  *   hippo watch "<command>"
  *   hippo learn --git [--days <n>] [--repos <paths>]
+ *   hippo daily-runner
  *   hippo promote <id>
  *   hippo sync
  *   hippo decide "<decision>" [--context "<why>"] [--supersedes <id>]

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -19,6 +19,7 @@
  *   hippo embed [--status]
  *   hippo watch "<command>"
  *   hippo learn --git [--days <n>] [--repos <paths>]
+ *   hippo daily-runner
  *   hippo promote <id>
  *   hippo sync
  *   hippo decide "<decision>" [--context "<why>"] [--supersedes <id>]
@@ -27,7 +28,7 @@
 import * as path from 'path';
 import * as fs from 'fs';
 import * as os from 'os';
-import { execSync, spawn } from 'child_process';
+import { execFileSync, execSync, spawn } from 'child_process';
 import { installJsonHooks, uninstallJsonHooks, resolveJsonHookPaths, detectInstalledTools, defaultSleepLogPath, ensureCodexWrapperInstalled, installCodexWrapper, uninstallCodexWrapper, resolveCodexSessionTranscript, resolveCodexWrapperPaths, } from './hooks.js';
 import { createMemory, calculateStrength, calculateRewardFactor, deriveHalfLife, resolveConfidence, applyOutcome, computeSchemaFit, Layer, DECISION_HALF_LIFE_DAYS, } from './memory.js';
 import { getHippoRoot, isInitialized, initStore, writeEntry, readEntry, deleteEntry, loadAllEntries, loadSearchEntries, loadIndex, saveIndex, loadStats, updateStats, saveActiveTaskSnapshot, loadActiveTaskSnapshot, clearActiveTaskSnapshot, appendSessionEvent, listSessionEvents, listMemoryConflicts, resolveConflict, saveSessionHandoff, loadLatestHandoff, loadHandoffById, } from './store.js';
@@ -42,6 +43,7 @@ import { captureError, extractLessons, deduplicateLesson, runWatched, fetchGitLo
 import { extractInvalidationTarget, invalidateMatching } from './invalidation.js';
 import { extractPathTags } from './path-context.js';
 import { getGlobalRoot, initGlobal, promoteToGlobal, shareMemory, listPeers, autoShare, transferScore, searchBothHybrid, syncGlobalToLocal, } from './shared.js';
+import { DAILY_TASK_NAME, buildDailyRunnerCommand, listRegisteredWorkspaces, registerWorkspace, runDailyMaintenance, } from './scheduler.js';
 import { importChatGPT, importClaude, importCursor, importGenericFile, importMarkdown, } from './importers.js';
 import { cmdCapture } from './capture.js';
 import { wmPush, wmRead, wmClear, wmFlush } from './working-memory.js';
@@ -160,6 +162,7 @@ function cmdInitScan(scanDir, flags) {
         if (!alreadyExists) {
             initStore(repoHippo);
         }
+        registerWorkspace(globalRoot, repo);
         // Learn from git history
         let added = 0;
         if (!flags['no-learn'] && isGitRepo(repo)) {
@@ -173,6 +176,9 @@ function cmdInitScan(scanDir, flags) {
     }
     console.log(`\n${repos.length} repositories, ${totalLessons} new lessons learned.`);
     console.log(`Global store: ${globalRoot}`);
+    if (!flags['no-schedule']) {
+        setupDailySchedule(globalRoot);
+    }
     console.log(`\nRun \`hippo sleep\` in any project to consolidate and auto-share to global.`);
 }
 function cmdInit(hippoRoot, flags) {
@@ -202,13 +208,15 @@ function cmdInit(hippoRoot, flags) {
         console.log('   Directories: buffer/ episodic/ semantic/ conflicts/');
         console.log('   Files: hippo.db index.json stats.json');
     }
+    const globalRoot = getGlobalRoot();
+    registerWorkspace(globalRoot, path.dirname(hippoRoot));
     // Auto-detect and install hooks (unless --no-hooks)
     if (!flags['no-hooks']) {
         autoInstallHooks(alreadyExists);
     }
     // Auto-setup daily schedule (unless --no-schedule)
     if (!flags['no-schedule'] && !flags['global']) {
-        setupDailySchedule(hippoRoot);
+        setupDailySchedule(globalRoot);
     }
     // Seed with git history on first init (unless --no-learn)
     if (!alreadyExists && !flags['no-learn'] && !flags['global']) {
@@ -301,22 +309,24 @@ function autoInstallHooks(quiet) {
     }
 }
 /**
- * Set up a daily cron job for hippo learn + sleep.
+ * Set up a machine-level daily runner that sweeps all registered Hippo
+ * workspaces.
  * Linux/macOS: writes to user crontab.
  * Windows: creates a scheduled task.
  * Skips if already installed.
  */
-function setupDailySchedule(hippoRoot) {
-    const projectDir = path.resolve(path.dirname(hippoRoot));
+function setupDailySchedule(globalRoot) {
+    const runnerDir = path.resolve(globalRoot);
     // Reject paths with characters that could break shell/crontab quoting
     // (backslash is normal on Windows, only dangerous in Unix shell/crontab)
     const unsafeChars = process.platform === 'win32' ? /["`$%\n\r]/ : /["`$\n\r\\]/;
-    if (unsafeChars.test(projectDir)) {
-        console.log(`   Skipping schedule: project path contains unsafe characters.`);
+    if (unsafeChars.test(runnerDir)) {
+        console.log(`   Skipping schedule: runner path contains unsafe characters.`);
         return;
     }
     const isWindows = process.platform === 'win32';
-    const taskName = `hippo-daily-${path.basename(projectDir)}`.replace(/[^a-zA-Z0-9_-]/g, '-');
+    const taskName = DAILY_TASK_NAME;
+    const cmd = buildDailyRunnerCommand(runnerDir);
     if (isWindows) {
         // Check if task already exists
         try {
@@ -328,14 +338,13 @@ function setupDailySchedule(hippoRoot) {
         catch {
             // Task doesn't exist, create it
         }
-        const cmd = `cd /d "${projectDir}" && hippo learn --git --days 1 && hippo sleep`;
         try {
             execSync(`schtasks /create /tn "${taskName}" /tr "cmd /c ${cmd.replace(/"/g, '""')}" /sc daily /st 06:15 /f`, { stdio: 'pipe' });
-            console.log(`   Scheduled daily learn+sleep (6:15am) via Task Scheduler: ${taskName}`);
+            console.log(`   Scheduled machine-level daily runner (6:15am) via Task Scheduler: ${taskName}`);
         }
         catch {
             // No admin rights or schtasks unavailable, fall back to printing instructions
-            console.log(`   To schedule daily learn+sleep, run:`);
+            console.log(`   To schedule the machine-level daily runner, run:`);
             console.log(`   schtasks /create /tn "${taskName}" /tr "cmd /c ${cmd}" /sc daily /st 06:15`);
         }
     }
@@ -347,14 +356,14 @@ function setupDailySchedule(hippoRoot) {
             if (existing.includes(marker)) {
                 return; // already scheduled
             }
-            const cronLine = `15 6 * * * cd "${projectDir}" && hippo learn --git --days 1 && hippo sleep ${marker}`;
+            const cronLine = `15 6 * * * ${cmd} ${marker}`;
             const newCrontab = existing.trimEnd() + '\n' + cronLine + '\n';
             execSync('crontab -', { input: newCrontab, stdio: ['pipe', 'pipe', 'pipe'] });
-            console.log(`   Scheduled daily learn+sleep (6:15am) via crontab`);
+            console.log(`   Scheduled machine-level daily runner (6:15am) via crontab`);
         }
         catch {
-            const cronLine = `15 6 * * * cd "${projectDir}" && hippo learn --git --days 1 && hippo sleep`;
-            console.log(`   To schedule daily learn+sleep, add to crontab (crontab -e):`);
+            const cronLine = `15 6 * * * ${cmd}`;
+            console.log(`   To schedule the machine-level daily runner, add to crontab (crontab -e):`);
             console.log(`   ${cronLine}`);
         }
     }
@@ -2391,6 +2400,7 @@ function cmdSetup(flags) {
     const dryRun = Boolean(flags['dry-run']);
     const forceAll = Boolean(flags['all']);
     const tools = detectInstalledTools();
+    const globalRoot = getGlobalRoot();
     console.log('Hippo setup -- configuring SessionEnd + SessionStart hooks');
     console.log('');
     const jsonTools = tools.filter((t) => t.kind === 'json-hook' && (t.detected || forceAll));
@@ -2464,9 +2474,46 @@ function cmdSetup(flags) {
             console.log(`  ${tool.name.padEnd(14)} ${tool.notes}`);
         }
     }
+    if (!flags['no-schedule']) {
+        console.log('');
+        if (dryRun) {
+            console.log(`[dry-run] would install the machine-level daily runner around ${globalRoot}`);
+        }
+        else {
+            setupDailySchedule(globalRoot);
+        }
+    }
     console.log('');
     console.log('Done. Restart your AI tool to activate the hooks.');
 }
+function cmdDailyRunner() {
+    const globalRoot = getGlobalRoot();
+    const workspaces = listRegisteredWorkspaces(globalRoot);
+    if (workspaces.length === 0) {
+        console.log('No registered Hippo workspaces found. Run `hippo init` inside a project first.');
+        return;
+    }
+    console.log(`Running daily maintenance across ${workspaces.length} registered workspace${workspaces.length === 1 ? '' : 's'}...`);
+    let processed = 0;
+    let failed = 0;
+    runDailyMaintenance(workspaces, (cwd, args) => {
+        try {
+            execFileSync(process.execPath, [process.argv[1], ...args], {
+                cwd,
+                stdio: 'inherit',
+                windowsHide: true,
+            });
+            if (args[0] === 'sleep')
+                processed++;
+        }
+        catch (err) {
+            failed++;
+            const action = args.join(' ');
+            console.error(`[hippo] daily-runner failed in ${cwd} during \`${action}\`: ${err.message}`);
+        }
+    });
+    console.log(`Daily maintenance complete: ${processed} workspace${processed === 1 ? '' : 's'} processed, ${failed} command failure${failed === 1 ? '' : 's'}.`);
+}
 // JSON-hook install/uninstall lives in ./hooks.ts so tests can import it
 // without running the CLI main(). Backwards-compatible wrappers below keep
 // older call sites working.
@@ -2555,13 +2602,13 @@ Hippo - biologically-inspired memory system for AI agents
 Usage: hippo <command> [options]
 
 Commands:
-  init                     Create .hippo/ structure in current directory
-    --scan [dir]           Find all git repos under dir (default: ~) and init each
-    --days <n>             Days of git history to seed (default: 365 for --scan, 30 for single)
-    --global               Init the global store ($HIPPO_HOME or ~/.hippo/)
-    --no-hooks             Skip auto-detecting and installing agent hooks
-    --no-schedule          Skip auto-creating daily learn+sleep cron job
-    --no-learn             Skip seeding memories from git history
+  init                     Create .hippo/ structure in current directory
+    --scan [dir]           Find all git repos under dir (default: ~) and init each
+    --days <n>             Days of git history to seed (default: 365 for --scan, 30 for single)
+    --global               Init the global store ($HIPPO_HOME or ~/.hippo/)
+    --no-hooks             Skip auto-detecting and installing agent hooks
+    --no-schedule          Skip auto-creating the machine-level daily runner
+    --no-learn             Skip seeding memories from git history
   remember <text>          Store a memory
     --tag <tag>            Add a tag (repeatable)
     --error                Tag as error (boosts retention)
@@ -2574,16 +2621,17 @@ Commands:
     --budget <n>           Token budget (default: 4000)
     --json                 Output as JSON
     --why                  Show match reasons and source annotations
-  context                  Smart context injection for AI agents
+  context                  Smart context injection for AI agents
     --auto                 Auto-detect task from git state
     --budget <n>           Token budget (default: 1500)
     --format <fmt>         Output format: markdown (default) or json
     --framing <mode>       Framing: observe (default), suggest, assert
-  sleep                    Run consolidation pass (auto-learns + dedup + auto-shares)
-    --dry-run              Preview without writing
-    --no-learn             Skip auto git-learn before consolidation
-    --no-share             Skip auto-sharing to global store
-  dedup                    Remove duplicate memories (keeps stronger copy)
+  sleep                    Run consolidation pass (auto-learns + dedup + auto-shares)
+    --dry-run              Preview without writing
+    --no-learn             Skip auto git-learn before consolidation
+    --no-share             Skip auto-sharing to global store
+  daily-runner             Sweep registered workspaces and run daily learn+sleep
+  dedup                    Remove duplicate memories (keeps stronger copy)
     --dry-run              Preview without removing
     --threshold <n>        Overlap threshold 0-1 (default: 0.7)
   status                   Show memory health stats
@@ -2675,10 +2723,11 @@ Commands:
     --log-file <path>      Tee output to a log file (paired with 'hippo last-sleep')
     --dry-run              Preview without writing
     --global               Write to global store ($HIPPO_HOME or ~/.hippo/)
-  setup                    One-shot: detect installed AI tools and install all
-                           available SessionEnd+SessionStart hooks
-    --all                  Install for every JSON-hook tool, even if not detected
-    --dry-run              Show what would be installed without writing
+  setup                    One-shot: detect installed AI tools and install all
+                           available SessionEnd+SessionStart hooks
+    --all                  Install for every JSON-hook tool, even if not detected
+    --dry-run              Show what would be installed without writing
+    --no-schedule          Skip installing or repairing the daily runner
   last-sleep               Print the last 'hippo sleep --log-file' output and clear it
     --path <p>             Log path (default: ~/.hippo/logs/last-sleep.log)
     --keep                 Print without clearing
@@ -2844,6 +2893,9 @@ async function main() {
         case 'setup':
             cmdSetup(flags);
             break;
+        case 'daily-runner':
+            cmdDailyRunner();
+            break;
         case 'embed':
             await cmdEmbed(hippoRoot, flags);
             break;