hippo-memory 1.72.0 → 2.1.0

package/dist/cli/setup.js

@@ -3,7 +3,7 @@ import { MINUTE_MS } from '../util/time.js';
 import * as path from 'path';
 import * as fs from 'fs';
 import { execFileSync } from 'child_process';
-import { installJsonHooks, uninstallJsonHooks, checkUninstallable, copilotHookEvents, resolveJsonHookPaths } from '../hooks/json-hooks.js';
+import { installJsonHooks, uninstallJsonHooks, checkUninstallable, copilotHookEvents, resolveJsonHookPaths, } from '../hooks/json-hooks.js';
 import { detectInstalledTools } from '../hooks/shared.js';
 import { ensureCodexWrapperInstalled, installCodexWrapper, detectRealCodexPath, uninstallCodexWrapper, } from '../hooks/codex-wrapper.js';
 import { installOpencodePlugin, uninstallOpencodePlugin, resolveOpencodePluginPath } from '../hooks/opencode.js';
@@ -23,7 +23,7 @@ import { installCodexMemoryHooks, setupDailySchedule, warnClaudeSettingsUnusable
 import { repairQualityOnceAt } from './quality-repair-once.js';
 import { HOOK_MARKERS, HOOKS, hippoBlock, withoutHookBlock } from '../hooks/hook-blocks.js';
 import { escapeRegex } from '../util/escape.js';
-import { CliExit } from './exit.js';
+import { fail } from './exit.js';
 // Hook install/uninstall
 export function handleHook({ args }) {
     const subcommand = args[0];
@@ -34,8 +34,7 @@ export function handleHook({ args }) {
         return hookInstall(target);
     if (subcommand === 'uninstall')
         return hookUninstall(target);
-    printError('Usage: hippo hook <install|uninstall|list> [target]');
-    throw new CliExit(1);
+    fail('Usage: hippo hook <install|uninstall|list> [target]');
 }
 // Cursor has no init row, so the AGENTS.md block is usually another agent's, and Cursor reads that one as it is.
 function othersBlock(target, text) {
@@ -46,7 +45,8 @@ function hookList() {
     for (const [name, hook] of Object.entries(HOOKS)) {
         console.log(`  ${name.padEnd(15)} -> ${hook.file} (${hook.description})`);
     }
-    console.log(`  ${'copilot'.padEnd(15)} -> $COPILOT_HOME or ~/.copilot, and each VS Code User folder (GitHub Copilot: hooks, MCP server and instructions)`);
+    console.log(`  ${'copilot'.padEnd(15)} -> $COPILOT_HOME or ~/.copilot, and each VS Code User folder ` +
+        '(GitHub Copilot: hooks, MCP server and instructions)');
     console.log('\nUsage: hippo hook install <name>');
     console.log('       hippo hook uninstall <name>');
 }
@@ -56,8 +56,7 @@ function hookInstall(target) {
         return printCopilotInstall(installCopilot(), '');
     if (!target || !HOOKS[target]) {
         printError(`Unknown hook target: ${target ?? '(none)'}`);
-        printError(`   Available: ${[...Object.keys(HOOKS), 'copilot'].join(', ')}`);
-        throw new CliExit(1);
+        fail(`   Available: ${[...Object.keys(HOOKS), 'copilot'].join(', ')}`);
     }
     const hook = HOOKS[target];
     patchAgentFile(hook, target);
@@ -103,8 +102,8 @@ function patchAgentFile(hook, target) {
         }
     }
     else {
-        // Do not create an agent-instructions file (CLAUDE.md, AGENTS.md, etc.) in directories without one, to avoid polluting cwd;
-        // the settings.json hook below is still installed for claude-code.
+        // Do not create an agent-instructions file (CLAUDE.md, AGENTS.md, etc.) in directories without one, to avoid
+        // polluting cwd; the settings.json hook below is still installed for claude-code.
         console.log(`${hook.file} not found in ${process.cwd()} — skipping agent-instructions patch.`);
         console.log(`   Create ${hook.file} and re-run \`hippo hook install ${target}\` if you want the agent prompt.`);
     }
@@ -155,7 +154,8 @@ function installOpencodeHook() {
         console.log(`Removed legacy Claude Code-style hooks block from opencode.json — opencode can now launch`);
     }
     if (result.jsonRepairFailed) {
-        console.log(`WARNING: opencode.json is unparseable; legacy hooks block could not be auto-removed. Fix the file manually.`);
+        console.log(`WARNING: opencode.json is unparseable; legacy hooks block could not be auto-removed. ` +
+            `Fix the file manually.`);
     }
 }
 const addByHand = (host) => `add this under "${host.key}" by hand: ${copilotMcpSnippet(host)}`;
@@ -163,20 +163,24 @@ const MCP_MERGE_LINES = {
     added: (file) => `Added the "hippo" MCP server -> ${file}`,
     present: (file) => `The "hippo" MCP server is already in ${file}`,
     'user-owned': (file) => `Left the "hippo" MCP server in ${file} as it is: hippo did not write it`,
-    unreadable: (file, host) => `WARNING: ${file} has comments or is not a JSON object hippo can merge into, so it was left unchanged; ${addByHand(host)}`,
+    unreadable: (file, host) => `WARNING: ${file} has comments or is not a JSON object hippo can merge into, so it was left unchanged; ` +
+        addByHand(host),
 };
 const mcpFailureLine = (file, failure, fix) => `WARNING: hippo could not use ${file} (${failure.failed}), so it was left unchanged; ${fix}`;
-const unclosedLine = (file) => `WARNING: ${file} has ${HOOK_MARKERS.start} with no ${HOOK_MARKERS.end}, so hippo left it unchanged; fix the markers by hand`;
+const unclosedLine = (file) => `WARNING: ${file} has ${HOOK_MARKERS.start} with no ${HOOK_MARKERS.end}, so hippo left it unchanged; ` +
+    'fix the markers by hand';
 const INSTRUCTIONS_INSTALL_LINES = {
     written: (file) => `Wrote the hippo block -> ${file}`,
     present: (file) => `The hippo block is already in ${file}`,
-    kept: (file) => `Kept the hippo block in ${file} as it is: it is not the Copilot text hippo wrote, so it was edited or is another agent's`,
+    kept: (file) => `Kept the hippo block in ${file} as it is: it is not the Copilot text hippo wrote, ` +
+        `so it was edited or is another agent's`,
     unclosed: unclosedLine,
 };
 const INSTRUCTIONS_REMOVE_LINES = {
     removed: (file) => `Removed the hippo block from ${file}`,
     absent: () => '',
-    kept: (file) => `Left the hippo block in ${file}: it is not the Copilot text hippo wrote. Delete it by hand if no agent needs it.`,
+    kept: (file) => `Left the hippo block in ${file}: it is not the Copilot text hippo wrote. ` +
+        'Delete it by hand if no agent needs it.',
     unclosed: unclosedLine,
 };
 const VSCODE_INSTRUCTIONS_INSTALL_LINES = {
@@ -189,8 +193,8 @@ const VSCODE_INSTRUCTIONS_REMOVE_LINES = {
     absent: () => '',
     kept: (file) => `Left ${file}: it is not the text hippo wrote. Delete it by hand if no agent needs it.`,
 };
-const VSCODE_HOOKS_LINE = 'VS Code: hooks need VS Code 1.109.3 or later with chat.useHooks on (the default); older versions get the MCP server and the ' +
-    'instructions file only.';
+const VSCODE_HOOKS_LINE = 'VS Code: hooks need VS Code 1.109.3 or later with chat.useHooks on (the default); ' +
+    'older versions get the MCP server and the instructions file only.';
 function mcpInstallLine(file, mcp, host) {
     return isMcpFailure(mcp) ? mcpFailureLine(file, mcp, addByHand(host)) : MCP_MERGE_LINES[mcp](file, host);
 }
@@ -201,12 +205,15 @@ function printVscodeInstall(result, indent) {
     if (paths.profiles.length > 0) {
         const names = paths.profiles.map((dir) => path.basename(dir)).join(', ');
         console.log(`${indent}Found VS Code profiles (${names}) under ${path.join(paths.userDir, 'profiles')}: ` +
-            'hippo set up the default profile only; copy the "hippo" server and prompts/hippo.instructions.md into a profile to use hippo there.');
+            'hippo set up the default profile only; copy the "hippo" server and prompts/hippo.instructions.md ' +
+            'into a profile to use hippo there.');
     }
 }
 function printCopilotInstall(result, indent) {
     const { paths } = result;
-    const hooks = result.hooks ? `Installed hippo's Copilot hooks (${copilotHookEvents().join(', ')}) ->` : "hippo's Copilot hooks are already in";
+    const hooks = result.hooks
+        ? `Installed hippo's Copilot hooks (${copilotHookEvents().join(', ')}) ->`
+        : "hippo's Copilot hooks are already in";
     console.log(`${indent}${hooks} ${paths.hooks}`);
     if (result.mcp === null || result.instructions === null) {
         console.log(`${indent}No Copilot CLI files in ${path.dirname(paths.mcpConfig)}, ` +
@@ -257,8 +264,7 @@ function hookUninstall(target) {
     if (target === 'copilot')
         return printCopilotUninstall(uninstallCopilot());
     if (!target || !HOOKS[target]) {
-        printError(`Unknown hook target: ${target ?? '(none)'}`);
-        throw new CliExit(1);
+        fail(`Unknown hook target: ${target ?? '(none)'}`);
     }
     unpatchAgentFile(HOOKS[target], target);
     // For Claude Code, also strip its SessionEnd/SessionStart entries.
@@ -271,7 +277,8 @@ function hookUninstall(target) {
         }
     }
     else if (target === 'opencode') {
-        // opencode uses a TS plugin; uninstall removes the plugin file and also runs the legacy-hooks migration, so remove leaves opencode launchable.
+        // opencode uses a TS plugin; uninstall removes the plugin file and also runs the legacy-hooks migration, so remove
+        // leaves opencode launchable.
         if (uninstallOpencodePlugin()) {
             console.log(`Removed hippo opencode plugin (and any legacy hooks block from opencode.json)`);
         }
@@ -318,7 +325,9 @@ function removeLegacyCursorRules() {
             writeFileAtomic(legacy, left + '\n');
         else
             fs.unlinkSync(legacy);
-        console.log(left ? 'Removed the old Hippo hook from .cursorrules' : 'Deleted .cursorrules, which held only the old Hippo hook');
+        console.log(left
+            ? 'Removed the old Hippo hook from .cursorrules'
+            : 'Deleted .cursorrules, which held only the old Hippo hook');
     }
 }
 function setupDetectedTools(tools, forceAll, dryRun) {
@@ -383,15 +392,19 @@ function setupCopilot(dryRun) {
     if (!dryRun)
         return printCopilotInstall(installCopilot(), indent);
     const { hooks, mcpConfig, instructions, vscode } = copilotPaths();
-    const cliFiles = isCopilotCliPresent() ? `, the MCP server in ${mcpConfig} and the hippo block in ${instructions}` : '';
+    const cliFiles = isCopilotCliPresent()
+        ? `, the MCP server in ${mcpConfig} and the hippo block in ${instructions}`
+        : '';
     console.log(`[dry-run] would install hooks in ${hooks}${cliFiles}`);
-    for (const dir of vscode)
+    for (const dir of vscode) {
         console.log(`[dry-run] would add the MCP server to ${dir.mcpConfig} and write ${dir.instructions}`);
+    }
 }
 function setupJsonTool(tool, dryRun) {
     if (tool.name === 'copilot')
         return setupCopilot(dryRun);
-    // SAFETY: detectInstalledTools gives kind 'json-hook' only to claude-code and copilot (hooks/shared.ts), and copilot returned above.
+    // SAFETY: detectInstalledTools gives kind 'json-hook' only to claude-code and copilot (hooks/shared.ts), and copilot
+    // returned above.
     const target = tool.name;
     if (dryRun) {
         // Resolve the real settings path so the filename is right for each tool
@@ -433,8 +446,9 @@ function setupJsonTool(tool, dryRun) {
 }
 function setupWrapperTool(tool, dryRun) {
     if (dryRun) {
-        if (tool.name === 'codex')
+        if (tool.name === 'codex') {
             console.log(`[dry-run] would install Codex memory hooks in ${resolveJsonHookPaths('codex').settings}`);
+        }
         console.log(`[dry-run] would wrap the detected ${tool.name} launcher in place`);
         return;
     }
@@ -478,22 +492,26 @@ function setupPluginTool(tool, dryRun) {
         console.log(`  ${tool.name.padEnd(14)} ${bits.join(', ')} -> ${result.pluginPath}`);
     }
 }
-// Three times the 10 minutes POST /v1/sleep allows a consolidation, so a slow real sleep fits and a hung child cannot stall every later workspace.
+// Three times the 10 minutes POST /v1/sleep allows a consolidation, so a slow real sleep fits and a hung child cannot
+// stall every later workspace.
 const DAILY_STEP_TIMEOUT_MS = 30 * MINUTE_MS;
-/** Why a child step failed; a child killed at the deadline says so, since its own message is only the spawn error code. */
+/** Why a child step failed; a child killed at the deadline says so, since its own message is only the spawn error
+ * code. */
 function dailyStepFailure(err, timeoutMs) {
-    if (err instanceof Error && 'code' in err && err.code === 'ETIMEDOUT')
+    if (err instanceof Error && 'code' in err && err.code === 'ETIMEDOUT') {
         return `timed out after ${timeoutMs} ms and was stopped`;
+    }
     return errorMessage(err);
 }
-export function handleDailyRunner({ tenantId }) {
+export async function handleDailyRunner({ tenantId }) {
     const globalRoot = getGlobalRoot();
     // No workspace sleep ever opens the global store, yet hooks in folders without a store compact into it.
     if (isInitialized(globalRoot)) {
         const finished = replayCompactionsAt(globalRoot, (message) => log.warn(`compaction replay: ${message}`));
-        if (finished > 0)
+        if (finished > 0) {
             console.log(`Finished saving ${finished} compaction${finished === 1 ? '' : 's'} left over in the global store.`);
-        repairQualityOnceAt(globalRoot, tenantId);
+        }
+        await repairQualityOnceAt(globalRoot, tenantId);
     }
     printAgentImport(importUserMemories(globalRoot, { machine: currentMachine() }), '');
     const workspaces = listRegisteredWorkspaces(globalRoot);
@@ -501,7 +519,8 @@ export function handleDailyRunner({ tenantId }) {
         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'}...`);
+    const plural = workspaces.length === 1 ? '' : 's';
+    console.log(`Running daily maintenance across ${workspaces.length} registered workspace${plural}...`);
     let processed = 0;
     let failed = 0;
     const timeout = envDailyStepTimeoutMs() ?? DAILY_STEP_TIMEOUT_MS;
@@ -519,7 +538,10 @@ export function handleDailyRunner({ tenantId }) {
         catch (err) {
             failed++;
             const action = args.join(' ');
-            log.error(`daily-runner failed in ${cwd} during \`${action}\`: ${dailyStepFailure(err, timeout)}`, { workspace: cwd, ...errorFields(err) });
+            log.error(`daily-runner failed in ${cwd} during \`${action}\`: ${dailyStepFailure(err, timeout)}`, {
+                workspace: cwd,
+                ...errorFields(err),
+            });
         }
     });
     console.log(`Daily maintenance complete: ${processed} workspace${processed === 1 ? '' : 's'} processed, ` +

package/dist/cli/shared.d.ts

@@ -7,7 +7,9 @@ export declare function runChurnStaleForRepo(hippoRoot: string, tenantId: string
     root: string;
     result: ChurnStaleResult;
 }[];
-/** Run an HTTP-routed command if a `hippo serve` is detected: true if it ran, false on no server or a stale pidfile (removed if it names the dead server).
+/**
+ * Run an HTTP-routed command if a `hippo serve` is detected: true if it ran, false on no server or a stale pidfile
+ * (removed if it names the dead server).
  * With HIPPO_REQUIRE_SERVER set both fallbacks throw; a stale pidfile must self-heal, not crash. */
 export declare function runViaServerIfAvailable(hippoRoot: string, httpFn: (info: ServerInfo, apiKey: string | undefined) => Promise<void>): Promise<boolean>;
 /** True, after one line, on a shared store: this account's commits and agent notes are not its members' memories. */
@@ -17,7 +19,7 @@ interface LearnFromRepoResult {
     skipped: number;
     lowInfo: number;
 }
-export declare function learnFromRepo(hippoRoot: string, tenantId: string, repoPath: string, days: number, label?: string): LearnFromRepoResult;
+export declare function learnFromRepo(hippoRoot: string, tenantId: string, repoPath: string, days: number, label?: string): Promise<LearnFromRepoResult>;
 export declare function resolveAuthRoot(hippoRoot: string, flags: CliFlags): string;
 export {};
 //# sourceMappingURL=shared.d.ts.map

package/dist/cli/shared.js

@@ -10,17 +10,23 @@ import * as client from './client.js';
 import { detectServer, removePidfileIfOwned } from '../server/server-detect.js';
 import { learn, CLI_LEARN } from '../api/index.js';
 import { cliApiContext } from './api-context.js';
-import { errorMessage, log } from '../util/log.js';
+import { errorMessage, log, errorFields } from '../util/log.js';
 import { printError } from './output.js';
 export function requireInit(hippoRoot) {
     if (!isInitialized(hippoRoot)) {
-        printError(`No hippo store at ${hippoRoot} (searched ${process.cwd()} and its parents up to your home directory). Run \`hippo init\` first.`);
+        printError(`No hippo store at ${hippoRoot} (searched ${process.cwd()} and its parents up to your home directory). Run ` +
+            `\`hippo init\` first.`);
         process.exit(1);
     }
 }
 /** Runs detectChurnStale against every store this repo's memories can live in. */
 export function runChurnStaleForRepo(hippoRoot, tenantId, dryRun) {
-    const repoRoot = execFileSync('git', ['rev-parse', '--show-toplevel'], { cwd: process.cwd(), encoding: 'utf8', timeout: 10_000, windowsHide: true }).trim();
+    const repoRoot = execFileSync('git', ['rev-parse', '--show-toplevel'], {
+        cwd: process.cwd(),
+        encoding: 'utf8',
+        timeout: 10_000,
+        windowsHide: true,
+    }).trim();
     const { name: projectName, legacyName } = resolveProjectIdentity(process.cwd());
     const globalRoot = getGlobalRoot();
     const roots = globalRoot !== hippoRoot && isInitialized(globalRoot) ? [hippoRoot, globalRoot] : [hippoRoot];
@@ -31,11 +37,16 @@ export function runChurnStaleForRepo(hippoRoot, tenantId, dryRun) {
         }
         catch (err) {
             const message = errorMessage(err);
-            return { root, result: { checked: 0, marked: 0, alreadyMarked: 0, skippedPinned: [], dryRun, preview: [], error: message } };
+            return {
+                root,
+                result: { checked: 0, marked: 0, alreadyMarked: 0, skippedPinned: [], dryRun, preview: [], error: message },
+            };
         }
     });
 }
-/** With HIPPO_REQUIRE_SERVER set, throw rather than fall back to direct DB mode, which would mask a misconfiguration and discard HIPPO_API_KEY.
+/**
+ * With HIPPO_REQUIRE_SERVER set, throw rather than fall back to direct DB mode, which would mask a misconfiguration and
+ * discard HIPPO_API_KEY.
  * Guards only the routed writes (remember, forget, archive, promote). */
 function failIfServerRequired(reason) {
     if (envRequireServer()) {
@@ -43,7 +54,9 @@ function failIfServerRequired(reason) {
             `Start \`hippo serve\`, or unset HIPPO_REQUIRE_SERVER to allow direct-mode fallback.`);
     }
 }
-/** Run an HTTP-routed command if a `hippo serve` is detected: true if it ran, false on no server or a stale pidfile (removed if it names the dead server).
+/**
+ * Run an HTTP-routed command if a `hippo serve` is detected: true if it ran, false on no server or a stale pidfile
+ * (removed if it names the dead server).
  * With HIPPO_REQUIRE_SERVER set both fallbacks throw; a stale pidfile must self-heal, not crash. */
 export async function runViaServerIfAvailable(hippoRoot, httpFn) {
     const info = await detectServer(hippoRoot);
@@ -60,16 +73,18 @@ export async function runViaServerIfAvailable(hippoRoot, httpFn) {
         const failure = err instanceof Error ? client.classifyTransportFailure(err) : 'none';
         if (failure === 'never-sent') {
             failIfServerRequired('the server pidfile was stale (connection refused)');
-            log.warn('stale server pidfile detected, falling back to direct mode');
+            log.warn('stale server pidfile detected, falling back to direct mode', errorFields(err));
             // Clear the pidfile only if it still names the dead server we just
             // probed — a newer server may have rewritten it (removePidfileIfOwned).
             removePidfileIfOwned(hippoRoot, { pid: info.pid, startedAt: info.started_at });
             return false;
         }
         if (failure === 'delivery-unknown') {
-            // Every caller is a non-idempotent write, so replaying on the direct path would store a row the server may already have committed;
+            // Every caller is a non-idempotent write, so replaying on the direct path would store a row the server may
+            // already have committed;
             // leave the pidfile alone: the next command's connect-phase failure heals it.
-            printError(`hippo: the connection to ${info.url} dropped or timed out mid-request, so the write may already have been applied. ` +
+            printError(`hippo: the connection to ${info.url} dropped or timed out mid-request, so the write may already have been ` +
+                `applied. ` +
                 'Not retrying locally. Check with `hippo recall` before running this again.');
             process.exit(1);
         }
@@ -83,9 +98,9 @@ export function skipLearnOnSharedStore(hippoRoot) {
     console.log("Shared store: skipped learning from this account's git commits and coding agents' own memories.");
     return true;
 }
-export function learnFromRepo(hippoRoot, tenantId, repoPath, days, label) {
+export async function learnFromRepo(hippoRoot, tenantId, repoPath, days, label) {
     const prefix = label ? `[${label}] ` : '';
-    const result = learn(cliApiContext(hippoRoot, tenantId), { repoPath, days, profile: CLI_LEARN });
+    const result = await learn(cliApiContext(hippoRoot, tenantId), { repoPath, days, profile: CLI_LEARN });
     if (result.status === 'not-a-repo') {
         console.log(`${prefix}No git history found (or not a git repository).`);
         return { added: 0, skipped: 0, lowInfo: 0 };

package/dist/cli/slack.js

@@ -9,7 +9,8 @@ import { addWorkspace as addSlackWorkspace, listWorkspaces as listSlackWorkspace
 import { printError } from './output.js';
 import { printSlackBackfillUsage, printSlackWorkspacesUsage } from './usage.js';
 import { stringFlag } from './flag-values.js';
-import { CliExit } from './exit.js';
+import { cliApiContext } from './api-context.js';
+import { CliExit, fail } from './exit.js';
 // Slack subcommands (`hippo slack backfill` / `hippo slack dlq list`)
 function cmdSlackBackfill(hippoRoot, tenantId, flags) {
     const channel = stringFlag(flags, 'channel');
@@ -23,15 +24,12 @@ function cmdSlackBackfill(hippoRoot, tenantId, flags) {
         printError('SLACK_BOT_TOKEN is not set. Backfill requires a Slack bot token with channels:history scope.');
         throw new CliExit(2);
     }
-    // --since is advisory in V1: the slack_cursors row drives resume, so the backfill loop always continues where it left off (keeps idempotency clean).
+    // --since is advisory in V1: the slack_cursors row drives resume, so the backfill loop always continues where it left
+    // off (keeps idempotency clean).
     const sinceIso = stringFlag(flags, 'since');
     void sinceIso;
     const fetcher = slackHistoryFetcher(token);
-    const ctx = {
-        hippoRoot,
-        tenantId,
-        actor: api.adminActor('cli:slack-backfill'),
-    };
+    const ctx = { ...cliApiContext(hippoRoot, tenantId), actor: api.adminActor('cli:slack-backfill') };
     backfillChannel(ctx, {
         teamId: envSlackTeamId() ?? 'T_UNKNOWN',
         channel: { id: channel, is_private: false },
@@ -51,25 +49,22 @@ function cmdSlackDlqList(hippoRoot, tenantId, _flags) {
         console.log(`${it.id}\t${it.receivedAt}\t${it.error}`);
     }
 }
-async function cmdSlackDlqReplay(hippoRoot, args, flags) {
+async function cmdSlackDlqReplay(hippoRoot, tenantId, args, flags) {
     const idArg = args[2];
     if (!idArg) {
-        printError('Usage: hippo slack dlq replay <id> [--force]');
-        throw new CliExit(1);
+        fail('Usage: hippo slack dlq replay <id> [--force]');
     }
     const id = Number(idArg);
     if (!Number.isFinite(id) || !Number.isInteger(id) || id < 1) {
-        printError(`replay: invalid id ${idArg}`);
-        throw new CliExit(1);
+        fail(`replay: invalid id ${idArg}`);
     }
     const force = flags.force === true;
-    const result = await replayDlqEntry({ hippoRoot }, id, {
+    const result = await replayDlqEntry(cliApiContext(hippoRoot, tenantId), id, {
         force,
         signingSecret: envSlackSigningSecret(),
     });
     if (!result.ok) {
-        printError(`replay failed: status=${result.status} retry_count=${result.retryCount}${result.reason ? ` reason=${result.reason}` : ''}`);
-        throw new CliExit(1);
+        fail(`replay failed: status=${result.status} retry_count=${result.retryCount}${result.reason ? ` reason=${result.reason}` : ''}`);
     }
     console.log(`replay ok: status=${result.status} memory_id=${result.memoryId ?? '(none)'} retry_count=${result.retryCount}`);
 }
@@ -77,8 +72,7 @@ function cmdSlackWorkspacesAdd(hippoRoot, flags) {
     const teamId = (stringFlag(flags, 'team') ?? '').trim();
     const tenantId = (stringFlag(flags, 'tenant') ?? '').trim();
     if (!teamId || !tenantId) {
-        printError('Usage: hippo slack workspaces add --team <T> --tenant <t>');
-        throw new CliExit(1);
+        fail('Usage: hippo slack workspaces add --team <T> --tenant <t>');
     }
     const ws = addSlackWorkspace(hippoRoot, { teamId, tenantId });
     console.log(`added: ${ws.teamId} -> ${ws.tenantId} (${ws.addedAt})`);
@@ -96,13 +90,11 @@ function cmdSlackWorkspacesList(hippoRoot) {
 function cmdSlackWorkspacesRemove(hippoRoot, flags) {
     const teamId = (stringFlag(flags, 'team') ?? '').trim();
     if (!teamId) {
-        printError('Usage: hippo slack workspaces remove --team <T>');
-        throw new CliExit(1);
+        fail('Usage: hippo slack workspaces remove --team <T>');
     }
     const removed = removeSlackWorkspace(hippoRoot, teamId);
     if (!removed) {
-        printError(`no workspace registered for team ${teamId}`);
-        throw new CliExit(1);
+        fail(`no workspace registered for team ${teamId}`);
     }
     console.log(`removed: ${teamId}`);
 }
@@ -117,7 +109,7 @@ export async function handleSlack({ hippoRoot, tenantId, args, flags }) {
         return;
     }
     if (sub === 'dlq' && args[1] === 'replay') {
-        await cmdSlackDlqReplay(hippoRoot, args, flags);
+        await cmdSlackDlqReplay(hippoRoot, tenantId, args, flags);
         return;
     }
     if (sub === 'workspaces') {
@@ -137,7 +129,6 @@ export async function handleSlack({ hippoRoot, tenantId, args, flags }) {
         printSlackWorkspacesUsage();
         throw new CliExit(1);
     }
-    printError('Usage: hippo slack <backfill|dlq list|dlq replay <id> [--force]|workspaces add|workspaces list|workspaces remove> [...]');
-    throw new CliExit(1);
+    fail('Usage: hippo slack <backfill|dlq list|dlq replay <id> [--force]|workspaces add|workspaces list|workspaces remove> [...]');
 }
 //# sourceMappingURL=slack.js.map

package/dist/cli/sleep-render.d.ts

@@ -1,4 +1,6 @@
 import type * as api from '../api/index.js';
-/** The lines `hippo sleep` prints for an api.sleep result; pure, so the snapshot tests read them without a console spy. */
+/**
+ * The lines `hippo sleep` prints for an api.sleep result; pure, so the snapshot tests read them without a console spy.
+ */
 export declare function sleepResultLines(result: api.SleepResult): string[];
 //# sourceMappingURL=sleep-render.d.ts.map

package/dist/cli/sleep-render.js

@@ -1,6 +1,8 @@
 // The text `hippo sleep` prints for an api.sleep result, kept pure so tests read the lines directly.
 import { renderAmbientSummary } from '../core/ambient.js';
-/** The lines `hippo sleep` prints for an api.sleep result; pure, so the snapshot tests read them without a console spy. */
+/**
+ * The lines `hippo sleep` prints for an api.sleep result; pure, so the snapshot tests read them without a console spy.
+ */
 export function sleepResultLines(result) {
     return [...sleepCountLines(result), ...(result.dryRun ? ['\n(dry run  - nothing ' +
                 'written)'] : []), ...sleepDedupeAndAuditLines(result), ...sleepShareAndGraphLines(result)];
@@ -31,12 +33,12 @@ function sleepDedupeAndAuditLines(result) {
             parts.push(`${epiDups} duplicate episodic lessons`);
         if (crossDups > 0)
             parts.push(`${crossDups} cross-layer duplicates`);
-        lines.push(`\n${result.dryRun ? 'Would ' +
-            'dedupe' : 'Deduped'} ${removed} duplicates (${parts.join(', ')}). ${result.dryRun ? 'Would keep' : 'Kept'} stronger copies.`);
+        lines.push(`\n${result.dryRun ? 'Would ' + 'dedupe' : 'Deduped'} ${removed} duplicates (${parts.join(', ')}). ${result.dryRun ? 'Would keep' : 'Kept'} stronger copies.`);
     }
     if (result.audit) {
         if (result.audit.errorsRemoved > 0) {
-            lines.push(`\nAudit: ${result.dryRun ? 'would remove' : 'removed'} ${result.audit.errorsRemoved} junk memories (too short/empty).`);
+            lines.push(`\nAudit: ${result.dryRun ? 'would remove' : 'removed'} ${result.audit.errorsRemoved} junk memories (too ` +
+                `short/empty).`);
         }
         if (result.audit.warningCount > 0) {
             lines.push(`Audit: ${result.audit.warningCount} low-quality memories detected (run \`hippo audit\` for details).`);
@@ -51,7 +53,8 @@ function sleepShareAndGraphLines(result) {
     }
     if (result.secretSkipped !== undefined && result.secretSkipped > 0) {
         // The secret veto is never silent.
-        lines.push(`\nAuto-share: withheld ${result.secretSkipped} secret-flagged ${result.secretSkipped === 1 ? 'memory' : 'memories'} (secret veto).`);
+        lines.push(`\nAuto-share: withheld ${result.secretSkipped} secret-flagged ` +
+            `${result.secretSkipped === 1 ? 'memory' : 'memories'} (secret veto).`);
     }
     if (result.ambient)
         lines.push(`\n${renderAmbientSummary(result.ambient)}`);

package/dist/cli/sleep.js

@@ -17,7 +17,8 @@ import { repairQualityOnceAt } from './quality-repair-once.js';
 import { printError } from './output.js';
 /** Runs `hippo sleep`; with `--log-file` it also tees its output to that file. */
 export async function cmdSleep(hippoRoot, tenantId, flags) {
-    // Tee stdout/stderr to a log file when --log-file is set; the SessionEnd hook uses it so the SessionStart hook can re-display the output.
+    // Tee stdout/stderr to a log file when --log-file is set; the SessionEnd hook uses it so the SessionStart hook can
+    // re-display the output.
     const logFile = stringFlag(flags, 'log-file') ?? null;
     let restoreStdout = null;
     if (logFile) {
@@ -61,7 +62,9 @@ function repairProjectTagsOnce(hippoRoot, tenantId) {
         const parts = [
             r.copies.length > 0 ? `set aside ${r.copies.length} misfiled note imports` : '',
             r.folds.length > 0 ? `folded ${r.folds.map((f) => `${f.from} into ${f.into}`).join(', ')}` : '',
-            r.toProject.length + r.setAside.length > 0 ? `re-tagged ${r.toProject.length + r.setAside.length} merged memories` : '',
+            r.toProject.length + r.setAside.length > 0
+                ? `re-tagged ${r.toProject.length + r.setAside.length} merged memories`
+                : '',
         ].filter((p) => p !== '');
         console.log(`Repaired project tags once after the upgrade: ${parts.join('; ')} (backup: ${r.backup}).`);
     }
@@ -69,18 +72,18 @@ function repairProjectTagsOnce(hippoRoot, tenantId) {
         log.warn(`project tag repair skipped, retried next sleep: ${errorMessage(err)}`);
     }
 }
-async function cmdSleepCore(hippoRoot, tenantId, flags) {
-    requireInit(hippoRoot);
+async function learnBeforeSleep(hippoRoot, tenantId, flags) {
     // Phase 1: Auto-learn from git and every coding agent's own memories (CLI-only, uses process.cwd() / os.homedir()).
     // Stays in cli.ts; api.sleep covers Phase 2-6 only.
     const learn = !flags['no-learn'] && !skipLearnOnSharedStore(hippoRoot);
     if (learn && flags['dry-run']) {
-        console.log("Dry run: skipped learning from git commits and coding agents' own memories (`hippo import --agents --dry-run` previews those).");
+        console.log("Dry run: skipped learning from git commits and coding agents' own memories (`hippo import --agents --dry-run` " +
+            "previews those).");
     }
     else if (learn) {
         const config = loadConfig(hippoRoot);
         if (config.autoLearnOnSleep && isGitRepo(process.cwd())) {
-            const { added } = learnFromRepo(hippoRoot, tenantId, process.cwd(), 1);
+            const { added } = await learnFromRepo(hippoRoot, tenantId, process.cwd(), 1);
             if (added > 0)
                 console.log(`Auto-learned ${added} lessons from today's git commits.`);
         }
@@ -95,13 +98,18 @@ async function cmdSleepCore(hippoRoot, tenantId, flags) {
         }
         printAgentImport(importForStore(hippoRoot, { machine: currentMachine() }), '');
     }
+}
+async function cmdSleepCore(hippoRoot, tenantId, flags) {
+    requireInit(hippoRoot);
+    await learnBeforeSleep(hippoRoot, tenantId, flags);
     // Finishes compactions a killed or busy post-compact hook left; never throws, and a dry run writes nothing.
     if (!flags['dry-run']) {
         const finished = replayCompactionsAt(hippoRoot, (message) => log.warn(`compaction replay: ${message}`));
-        if (finished > 0)
+        if (finished > 0) {
             console.log(`Finished saving ${finished} compaction${finished === 1 ? '' : 's'} left over from earlier sessions.`);
+        }
         repairProjectTagsOnce(hippoRoot, tenantId);
-        repairQualityOnceAt(hippoRoot, tenantId);
+        await repairQualityOnceAt(hippoRoot, tenantId);
     }
     // Phase 2-6: Pure-storage pipeline (consolidate + dedup + audit + share + ambient).
     const ctx = cliApiContext(hippoRoot, tenantId);

package/dist/cli/status.d.ts

@@ -2,11 +2,11 @@ import { type PhysicsParticle } from '../core/physics.js';
 import { type CommandContext } from './flag-values.js';
 export declare function handleStatus({ hippoRoot, tenantId }: CommandContext): void;
 export declare function physicsEnergyText(particles: PhysicsParticle[], gMemory: number): string;
-/** `hippo tokens [--days <n>] [--json] [--global]`: the token ledger per surface, tokens saved by skipped unchanged blocks, and re-read hook tokens.
- * Counts are estimates (characters / 4), the same estimate every budget uses. */
-export declare function handleTokens({ hippoRoot, tenantId, flags }: CommandContext): void;
+/** `hippo tokens [--days <n>] [--json] [--global]`: the token ledger per surface, tokens saved by skipped unchanged
+ * blocks, and re-read hook tokens. Counts are estimates (characters / 4), the same estimate every budget uses. */
+export declare function handleTokens({ hippoRoot, tenantId, flags }: CommandContext): Promise<void>;
 /** `hippo failures [--days <n>] [--json] [--global]`: failed tool calls by outcome, and repeats across sessions. */
-export declare function handleFailures({ hippoRoot, tenantId, flags }: CommandContext): void;
+export declare function handleFailures({ hippoRoot, tenantId, flags }: CommandContext): Promise<void>;
 export declare function handleCorrectionLatency({ hippoRoot, tenantId, flags }: CommandContext): void;
 export declare function handleProvenance({ hippoRoot, tenantId, flags }: CommandContext): void;
 export declare function handleDoctor({ flags }: CommandContext): void;