hippo-memory 0.24.1 → 0.26.0

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,8 +43,10 @@ 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 { auditMemories } from './audit.js';
 import { wmPush, wmRead, wmClear, wmFlush } from './working-memory.js';
 // ---------------------------------------------------------------------------
 // Helpers
@@ -160,6 +163,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 +177,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 +209,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 +310,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 +339,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 +357,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}`);
         }
     }
@@ -758,6 +768,24 @@ function cmdSleepCore(hippoRoot, flags) {
             console.log(`\nDeduped ${dedupResult.removed} duplicates (${parts.join(', ')}). Kept stronger copies.`);
         }
     }
+    // Quality audit — remove junk, report warnings
+    if (!dryRun) {
+        const allEntries = loadAllEntries(hippoRoot);
+        const audit = auditMemories(allEntries);
+        if (audit.issues.length > 0) {
+            const errors = audit.issues.filter(i => i.severity === 'error');
+            const warnings = audit.issues.filter(i => i.severity === 'warning');
+            if (errors.length > 0) {
+                for (const issue of errors) {
+                    deleteEntry(hippoRoot, issue.memoryId);
+                }
+                console.log(`\nAudit: removed ${errors.length} junk memories (too short/empty).`);
+            }
+            if (warnings.length > 0) {
+                console.log(`Audit: ${warnings.length} low-quality memories detected (run \`hippo audit\` for details).`);
+            }
+        }
+    }
     // Auto-share high-transfer-score memories to global (unless --no-share or dry-run)
     if (!dryRun && !flags['no-share']) {
         const sleepConfig = loadConfig(hippoRoot);
@@ -2141,7 +2169,7 @@ hippo capture --stdin <<< '<decisions, errors, lessons — 2-5 bullets>'
     'codex': {
         file: 'AGENTS.md',
         description: 'OpenAI Codex',
-        content: `
+        content: `
 ## Project Memory (Hippo)
 
 At the start of every task, run:
@@ -2160,8 +2188,8 @@ On task completion:
 hippo outcome --good
 \`\`\`
 
-When Hippo's Codex wrapper is installed, session-end capture runs automatically.
-If the wrapper is not installed, capture a brief summary manually:
+When Hippo's Codex wrapper is installed, session-end capture runs automatically.
+If the wrapper is not installed, capture a brief summary manually:
 \`\`\`bash
 hippo capture --stdin <<< '<decisions, errors, lessons — 2-5 bullets>'
 \`\`\`
@@ -2391,6 +2419,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 +2493,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.
@@ -2560,7 +2626,7 @@ Commands:
     --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-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)
@@ -2583,10 +2649,12 @@ Commands:
     --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
+  audit [--fix]            Check memory quality (--fix removes junk)
   outcome                  Apply feedback to last recall
     --good                 Memories were helpful
     --bad                  Memories were irrelevant
@@ -2679,15 +2747,16 @@ Commands:
                            available SessionEnd+SessionStart hooks
     --all                  Install for every JSON-hook tool, even if not detected
     --dry-run              Show what would be installed without writing
-  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
-  codex-run [-- ...args]   Launch real Codex behind Hippo's session-end wrapper
-  hook <sub> [target]      Manage framework integrations
-    hook list              Show available hooks
-    hook install <target>  Install hook (claude-code|codex|cursor|openclaw|opencode|pi)
-                           claude-code/opencode install SessionEnd+SessionStart;
-                           codex wraps the detected launcher in place
+    --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
+  codex-run [-- ...args]   Launch real Codex behind Hippo's session-end wrapper
+  hook <sub> [target]      Manage framework integrations
+    hook list              Show available hooks
+    hook install <target>  Install hook (claude-code|codex|cursor|openclaw|opencode|pi)
+                           claude-code/opencode install SessionEnd+SessionStart;
+                           codex wraps the detected launcher in place
     hook uninstall <target> Remove hook
   decide "<decision>"      Record an architectural decision (90-day half-life)
     --context "<why>"      Why this decision was made
@@ -2756,8 +2825,8 @@ async function main() {
             break;
         case 'remember': {
             const text = args.join(' ').trim();
-            if (!text) {
-                console.error('Please provide text to remember.');
+            if (!text || text.length < 3) {
+                console.error('Memory content too short (minimum 3 characters).');
                 process.exit(1);
             }
             cmdRemember(hippoRoot, text, flags);
@@ -2793,6 +2862,40 @@ async function main() {
         case 'dedup':
             cmdDedup(hippoRoot, flags);
             break;
+        case 'audit': {
+            requireInit(hippoRoot);
+            const entries = loadAllEntries(hippoRoot);
+            const result = auditMemories(entries);
+            const shouldFix = Boolean(flags['fix']);
+            if (result.issues.length === 0) {
+                console.log(`All ${result.total} memories passed quality checks.`);
+            }
+            else {
+                console.log(`Audited ${result.total} memories: ${result.clean} clean, ${result.issues.length} issues\n`);
+                for (const issue of result.issues) {
+                    const icon = issue.severity === 'error' ? 'ERR' : 'WARN';
+                    console.log(`  [${icon}] ${issue.memoryId}: ${issue.reason}`);
+                    console.log(`         "${issue.content.slice(0, 80)}${issue.content.length > 80 ? '...' : ''}"`);
+                }
+                if (shouldFix) {
+                    const errorIds = result.issues.filter(i => i.severity === 'error').map(i => i.memoryId);
+                    if (errorIds.length > 0) {
+                        for (const id of errorIds) {
+                            deleteEntry(hippoRoot, id);
+                        }
+                        console.log(`\nRemoved ${errorIds.length} error-severity memories.`);
+                        console.log(`${result.issues.length - errorIds.length} warnings remain (review manually).`);
+                    }
+                    else {
+                        console.log(`\nNo error-severity issues. Warnings require manual review.`);
+                    }
+                }
+                else {
+                    console.log(`\nRun with --fix to auto-remove error-severity issues.`);
+                }
+            }
+            break;
+        }
         case 'status':
             cmdStatus(hippoRoot);
             break;
@@ -2844,6 +2947,9 @@ async function main() {
         case 'setup':
             cmdSetup(flags);
             break;
+        case 'daily-runner':
+            cmdDailyRunner();
+            break;
         case 'embed':
             await cmdEmbed(hippoRoot, flags);
             break;