hippo-memory 1.61.0 → 1.63.0

package/dist/cli/setup.js

@@ -15,196 +15,208 @@ import { log } from '../log.js';
 import { printError } from './output.js';
 import { printAgentImport, installCodexMemoryHooks, setupDailySchedule } from './shared.js';
 import { HOOK_MARKERS, HOOKS, hippoBlock } from './hook-blocks.js';
+import { escapeRegex } from '../escape.js';
 // ---------------------------------------------------------------------------
 // Hook install/uninstall
 // ---------------------------------------------------------------------------
-export function cmdHook(args, flags) {
+export function cmdHook(args) {
     const subcommand = args[0];
     const target = args[1];
-    // Cursor has no init row, so the AGENTS.md block is usually another agent's, and Cursor reads that one as it is.
-    const othersBlock = (text) => target === 'cursor' && hippoBlock(text)?.owner !== 'cursor';
-    if (subcommand === 'list') {
-        console.log('Available hooks:\n');
-        for (const [name, hook] of Object.entries(HOOKS)) {
-            console.log(`  ${name.padEnd(15)} -> ${hook.file} (${hook.description})`);
-        }
-        console.log('\nUsage: hippo hook install <name>');
-        console.log('       hippo hook uninstall <name>');
-        return;
+    if (subcommand === 'list')
+        return hookList();
+    if (subcommand === 'install')
+        return hookInstall(target);
+    if (subcommand === 'uninstall')
+        return hookUninstall(target);
+    printError('Usage: hippo hook <install|uninstall|list> [target]');
+    process.exit(1);
+}
+// 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) {
+    return target === 'cursor' && hippoBlock(text)?.owner !== 'cursor';
+}
+function hookList() {
+    console.log('Available hooks:\n');
+    for (const [name, hook] of Object.entries(HOOKS)) {
+        console.log(`  ${name.padEnd(15)} -> ${hook.file} (${hook.description})`);
     }
-    if (subcommand === 'install') {
-        if (!target || !HOOKS[target]) {
-            printError(`Unknown hook target: ${target ?? '(none)'}`);
-            printError(`   Available: ${Object.keys(HOOKS).join(', ')}`);
-            process.exit(1);
-        }
-        const hook = HOOKS[target];
-        const filepath = path.resolve(process.cwd(), hook.file);
-        const block = `${HOOK_MARKERS.start}\n${hook.content}\n${HOOK_MARKERS.end}`;
-        let agentFileTouched = false;
-        if (fs.existsSync(filepath)) {
-            const existing = fs.readFileSync(filepath, 'utf8');
-            if (existing.includes(HOOK_MARKERS.start) && othersBlock(existing)) {
-                console.log(`${hook.file} already has a hippo block, which Cursor reads; left it as is.`);
-            }
-            else if (existing.includes(HOOK_MARKERS.start)) {
-                const re = new RegExp(`${escapeRegex(HOOK_MARKERS.start)}[\\s\\S]*?${escapeRegex(HOOK_MARKERS.end)}`, 'g');
-                const updated = existing.replace(re, block);
-                fs.writeFileSync(filepath, updated, 'utf8');
-                console.log(`Updated Hippo hook in ${hook.file}`);
-            }
-            else {
-                const sep = existing.endsWith('\n') ? '\n' : '\n\n';
-                fs.writeFileSync(filepath, existing + sep + block + '\n', 'utf8');
-                console.log(`Installed Hippo hook in ${hook.file} (appended)`);
-            }
-            agentFileTouched = true;
+    console.log('\nUsage: hippo hook install <name>');
+    console.log('       hippo hook uninstall <name>');
+}
+function hookInstall(target) {
+    if (!target || !HOOKS[target]) {
+        printError(`Unknown hook target: ${target ?? '(none)'}`);
+        printError(`   Available: ${Object.keys(HOOKS).join(', ')}`);
+        process.exit(1);
+    }
+    const hook = HOOKS[target];
+    patchAgentFile(hook, target);
+    // For Claude Code, also install SessionEnd+SessionStart entries in its
+    // settings file.
+    if (target === 'claude-code') {
+        printClaudeHookInstall(installJsonHooks(target));
+    }
+    else if (target === 'opencode') {
+        installOpencodeHook();
+    }
+    else if (target === 'codex') {
+        installCodexMemoryHooks('');
+        // The wrapper stays the capture path; the hooks above work without it, so a missing launcher is not an error.
+        if (detectRealCodexPath()) {
+            const result = installCodexWrapper();
+            console.log(`Installed Codex session-end integration -> ${result.metadataPath}`);
+            console.log(`   Wrapped detected Codex launcher at ${result.commandPath}`);
         }
         else {
-            // Do not create a new agent-instructions file (CLAUDE.md, AGENTS.md, etc.)
-            // in directories that don't already have one — avoids polluting cwd with
-            // files the user didn't ask for. The settings.json hook below is still
-            // installed for claude-code, so the consolidation hook still runs.
-            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.`);
-        }
-        // For Claude Code, also install SessionEnd+SessionStart entries in its
-        // settings file.
-        if (target === 'claude-code') {
-            const result = installJsonHooks(target);
-            if (result.installedSessionEnd) {
-                console.log(`Installed hippo session-end SessionEnd hook in ${result.target} settings`);
-            }
-            if (result.installedSessionStart) {
-                console.log(`Installed hippo last-sleep SessionStart hook in ${result.target} settings`);
-            }
-            if (result.installedUserPromptSubmit) {
-                console.log(`Installed hippo pinned-inject UserPromptSubmit hook in ${result.target} settings`);
-            }
-            if (result.installedPreCompact) {
-                console.log(`Installed hippo pre-compact PreCompact hook in ${result.target} settings`);
-            }
-            if (result.installedCompactResume) {
-                console.log(`Installed hippo compact-resume SessionStart(compact) hook in ${result.target} settings`);
-            }
-            if (result.installedPostCompact) {
-                console.log(`Installed hippo post-compact PostCompact hook in ${result.target} settings`);
-            }
-            if (result.installedCaptureError) {
-                console.log(`Installed hippo capture-error PostToolUseFailure hook in ${result.target} settings`);
-            }
-            if (result.migratedFromStop) {
-                console.log(`Migrated legacy Stop hook → SessionEnd (was running every turn; now fires once on session exit)`);
-            }
-            if (result.migratedSplitSessionEnd) {
-                console.log(`Migrated split sleep+capture SessionEnd entries → single detached hippo session-end`);
-            }
-            else if (result.migratedLegacySessionEnd) {
-                console.log(`Migrated legacy SessionEnd entry to the new detached form`);
-            }
-        }
-        else if (target === 'opencode') {
-            // opencode uses a TS plugin, not JSON hooks. See src/hooks.ts.
-            const result = installOpencodePlugin();
-            if (result.installed) {
-                console.log(`Installed hippo opencode plugin at ${result.pluginPath}`);
-            }
-            else {
-                console.log(`opencode plugin already up to date at ${result.pluginPath}`);
-            }
-            if (result.migratedLegacyHooks) {
-                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('No codex launcher on PATH, so session-end capture was not set up; re-run once `codex` is on PATH.');
         }
-        else if (target === 'codex') {
-            installCodexMemoryHooks('');
-            // The wrapper stays the capture path; the hooks above work without it, so a missing launcher is not an error.
-            if (detectRealCodexPath()) {
-                const result = installCodexWrapper();
-                console.log(`Installed Codex session-end integration -> ${result.metadataPath}`);
-                console.log(`   Wrapped detected Codex launcher at ${result.commandPath}`);
-            }
-            else {
-                console.log('No codex launcher on PATH, so session-end capture was not set up; re-run once `codex` is on PATH.');
-            }
-        }
-        return;
     }
-    if (subcommand === 'uninstall') {
-        if (!target || !HOOKS[target]) {
-            printError(`Unknown hook target: ${target ?? '(none)'}`);
-            process.exit(1);
+}
+function patchAgentFile(hook, target) {
+    const filepath = path.resolve(process.cwd(), hook.file);
+    const block = `${HOOK_MARKERS.start}\n${hook.content}\n${HOOK_MARKERS.end}`;
+    if (fs.existsSync(filepath)) {
+        const existing = fs.readFileSync(filepath, 'utf8');
+        if (existing.includes(HOOK_MARKERS.start) && othersBlock(target, existing)) {
+            console.log(`${hook.file} already has a hippo block, which Cursor reads; left it as is.`);
         }
-        const hook = HOOKS[target];
-        const filepath = path.resolve(process.cwd(), hook.file);
-        if (fs.existsSync(filepath)) {
-            const existing = fs.readFileSync(filepath, 'utf8');
-            if (existing.includes(HOOK_MARKERS.start) && othersBlock(existing)) {
-                const owner = hippoBlock(existing)?.owner;
-                const whose = owner ? `hippo wrote it for ${owner}` : 'it has been edited, so hippo cannot tell whose it is';
-                console.log(`Left the hippo block in ${hook.file}: ${whose}. Delete it by hand if no agent needs it.`);
-            }
-            else if (existing.includes(HOOK_MARKERS.start)) {
-                fs.writeFileSync(filepath, withoutHookBlock(existing) + '\n', 'utf8');
-                console.log(`Removed Hippo hook from ${hook.file}`);
-            }
-            else {
-                console.log(`No Hippo hook found in ${hook.file}.`);
-            }
+        else if (existing.includes(HOOK_MARKERS.start)) {
+            const re = new RegExp(`${escapeRegex(HOOK_MARKERS.start)}[\\s\\S]*?${escapeRegex(HOOK_MARKERS.end)}`, 'g');
+            const updated = existing.replace(re, block);
+            fs.writeFileSync(filepath, updated, 'utf8');
+            console.log(`Updated Hippo hook in ${hook.file}`);
         }
         else {
-            console.log(`${hook.file} not found, skipping agent-instructions uninstall.`);
+            const sep = existing.endsWith('\n') ? '\n' : '\n\n';
+            fs.writeFileSync(filepath, existing + sep + block + '\n', 'utf8');
+            console.log(`Installed Hippo hook in ${hook.file} (appended)`);
         }
-        // For Claude Code, also strip its SessionEnd/SessionStart entries.
-        if (target === 'claude-code') {
-            if (uninstallJsonHooks(target)) {
-                console.log(`Removed hippo hooks from ${target} settings`);
-            }
+    }
+    else {
+        // Do not create a new agent-instructions file (CLAUDE.md, AGENTS.md, etc.) in directories that don't already have one —
+        // avoids polluting cwd with files the user didn't ask for. The settings.json hook below is still installed for
+        // claude-code, so the consolidation hook still runs.
+        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.`);
+    }
+}
+function printClaudeHookInstall(result) {
+    if (result.installedSessionEnd) {
+        console.log(`Installed hippo session-end SessionEnd hook in ${result.target} settings`);
+    }
+    if (result.installedSessionStart) {
+        console.log(`Installed hippo last-sleep SessionStart hook in ${result.target} settings`);
+    }
+    if (result.installedUserPromptSubmit) {
+        console.log(`Installed hippo pinned-inject UserPromptSubmit hook in ${result.target} settings`);
+    }
+    if (result.installedPreCompact) {
+        console.log(`Installed hippo pre-compact PreCompact hook in ${result.target} settings`);
+    }
+    if (result.installedCompactResume) {
+        console.log(`Installed hippo compact-resume SessionStart(compact) hook in ${result.target} settings`);
+    }
+    if (result.installedPostCompact) {
+        console.log(`Installed hippo post-compact PostCompact hook in ${result.target} settings`);
+    }
+    if (result.installedCaptureError) {
+        console.log(`Installed hippo capture-error PostToolUseFailure hook in ${result.target} settings`);
+    }
+    if (result.migratedFromStop) {
+        console.log(`Migrated legacy Stop hook → SessionEnd (was running every turn; now fires once on session exit)`);
+    }
+    if (result.migratedSplitSessionEnd) {
+        console.log(`Migrated split sleep+capture SessionEnd entries → single detached hippo session-end`);
+    }
+    else if (result.migratedLegacySessionEnd) {
+        console.log(`Migrated legacy SessionEnd entry to the new detached form`);
+    }
+}
+function installOpencodeHook() {
+    // opencode uses a TS plugin, not JSON hooks. See src/hooks.ts.
+    const result = installOpencodePlugin();
+    if (result.installed) {
+        console.log(`Installed hippo opencode plugin at ${result.pluginPath}`);
+    }
+    else {
+        console.log(`opencode plugin already up to date at ${result.pluginPath}`);
+    }
+    if (result.migratedLegacyHooks) {
+        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.`);
+    }
+}
+function hookUninstall(target) {
+    if (!target || !HOOKS[target]) {
+        printError(`Unknown hook target: ${target ?? '(none)'}`);
+        process.exit(1);
+    }
+    unpatchAgentFile(HOOKS[target], target);
+    // For Claude Code, also strip its SessionEnd/SessionStart entries.
+    if (target === 'claude-code') {
+        if (uninstallJsonHooks(target)) {
+            console.log(`Removed hippo hooks from ${target} settings`);
         }
-        else if (target === 'opencode') {
-            // opencode uses a TS plugin; uninstall removes the plugin file AND
-            // also runs the legacy-hooks migration so the downgrade/remove path
-            // leaves opencode launchable.
-            if (uninstallOpencodePlugin()) {
-                console.log(`Removed hippo opencode plugin (and any legacy hooks block from opencode.json)`);
-            }
+    }
+    else if (target === 'opencode') {
+        // opencode uses a TS plugin; uninstall removes the plugin file AND
+        // also runs the legacy-hooks migration so the downgrade/remove path
+        // leaves opencode launchable.
+        if (uninstallOpencodePlugin()) {
+            console.log(`Removed hippo opencode plugin (and any legacy hooks block from opencode.json)`);
         }
-        else if (target === 'codex') {
-            if (uninstallJsonHooks('codex')) {
-                console.log(`Removed hippo's Codex memory hooks from ${resolveJsonHookPaths('codex').settings}`);
-            }
-            if (uninstallCodexWrapper()) {
-                console.log('Removed Codex wrapper integration');
-            }
+    }
+    else if (target === 'codex') {
+        if (uninstallJsonHooks('codex')) {
+            console.log(`Removed hippo's Codex memory hooks from ${resolveJsonHookPaths('codex').settings}`);
         }
-        else if (target === 'cursor') {
-            // Older hippo wrote Cursor's block to .cursorrules, creating the file when it was missing.
-            const legacy = path.resolve(process.cwd(), '.cursorrules');
-            const old = fs.existsSync(legacy) ? fs.readFileSync(legacy, 'utf8') : '';
-            if (old.includes(HOOK_MARKERS.start)) {
-                const left = withoutHookBlock(old);
-                if (left)
-                    fs.writeFileSync(legacy, left + '\n', 'utf8');
-                else
-                    fs.unlinkSync(legacy);
-                console.log(left ? 'Removed the old Hippo hook from .cursorrules' : 'Deleted .cursorrules, which held only the old Hippo hook');
-            }
+        if (uninstallCodexWrapper()) {
+            console.log('Removed Codex wrapper integration');
         }
+    }
+    else if (target === 'cursor') {
+        removeLegacyCursorRules();
+    }
+}
+function unpatchAgentFile(hook, target) {
+    const filepath = path.resolve(process.cwd(), hook.file);
+    if (!fs.existsSync(filepath)) {
+        console.log(`${hook.file} not found, skipping agent-instructions uninstall.`);
         return;
     }
-    printError('Usage: hippo hook <install|uninstall|list> [target]');
-    process.exit(1);
+    const existing = fs.readFileSync(filepath, 'utf8');
+    if (existing.includes(HOOK_MARKERS.start) && othersBlock(target, existing)) {
+        const owner = hippoBlock(existing)?.owner;
+        const whose = owner ? `hippo wrote it for ${owner}` : 'it has been edited, so hippo cannot tell whose it is';
+        console.log(`Left the hippo block in ${hook.file}: ${whose}. Delete it by hand if no agent needs it.`);
+    }
+    else if (existing.includes(HOOK_MARKERS.start)) {
+        fs.writeFileSync(filepath, withoutHookBlock(existing) + '\n', 'utf8');
+        console.log(`Removed Hippo hook from ${hook.file}`);
+    }
+    else {
+        console.log(`No Hippo hook found in ${hook.file}.`);
+    }
+}
+// Older hippo wrote Cursor's block to .cursorrules, creating the file when it was missing.
+function removeLegacyCursorRules() {
+    const legacy = path.resolve(process.cwd(), '.cursorrules');
+    const old = fs.existsSync(legacy) ? fs.readFileSync(legacy, 'utf8') : '';
+    if (old.includes(HOOK_MARKERS.start)) {
+        const left = withoutHookBlock(old);
+        if (left)
+            fs.writeFileSync(legacy, left + '\n', 'utf8');
+        else
+            fs.unlinkSync(legacy);
+        console.log(left ? 'Removed the old Hippo hook from .cursorrules' : 'Deleted .cursorrules, which held only the old Hippo hook');
+    }
 }
 function withoutHookBlock(text) {
     const re = new RegExp(`\\n?${escapeRegex(HOOK_MARKERS.start)}[\\s\\S]*?${escapeRegex(HOOK_MARKERS.end)}\\n?`, 'g');
     return text.replace(re, '\n').replace(/\n{3,}/g, '\n\n').trim();
 }
-function escapeRegex(s) {
-    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
 // `hippo setup` -- one-shot configuration for every AI coding tool on the box.
 // Detection and install logic live in ./hooks.ts.
 export function cmdSetup(flags) {
@@ -223,97 +235,18 @@ export function cmdSetup(flags) {
         console.log('No JSON-hook-capable tools detected (checked: claude-code).');
         console.log('Run with --all to install hooks anyway.');
     }
-    for (const tool of jsonTools) {
-        if (dryRun) {
-            // Resolve the real settings path so the filename is right for each tool
-            // (claude-code -> settings.json, opencode -> opencode.json).
-            const { settings } = resolveJsonHookPaths(tool.name);
-            console.log(`[dry-run] would install hooks in ${settings}`);
-            continue;
-        }
-        const result = installJsonHooks(tool.name);
-        const bits = [];
-        if (result.installedSessionEnd)
-            bits.push('SessionEnd (session-end)');
-        if (result.installedSessionStart)
-            bits.push('SessionStart');
-        if (result.installedUserPromptSubmit)
-            bits.push('UserPromptSubmit (pinned-inject)');
-        if (result.installedPreCompact)
-            bits.push('PreCompact (pre-compact)');
-        if (result.installedCompactResume)
-            bits.push('SessionStart(compact) (compact-resume)');
-        if (result.installedPostCompact)
-            bits.push('PostCompact (post-compact)');
-        if (result.installedCaptureError)
-            bits.push('PostToolUseFailure (capture-error)');
-        if (result.migratedFromStop)
-            bits.push('migrated legacy Stop');
-        if (result.migratedSplitSessionEnd)
-            bits.push('migrated split SessionEnd → session-end');
-        else if (result.migratedLegacySessionEnd)
-            bits.push('migrated legacy SessionEnd');
-        if (bits.length === 0) {
-            console.log(`  ${tool.name.padEnd(14)} already configured (${result.settingsPath})`);
-        }
-        else {
-            console.log(`  ${tool.name.padEnd(14)} ${bits.join(', ')} -> ${result.settingsPath}`);
-        }
-    }
+    for (const tool of jsonTools)
+        setupJsonTool(tool, dryRun);
     for (const tool of skipped) {
         console.log(`  ${tool.name.padEnd(14)} not detected at ${tool.configDir} -- skipping`);
     }
-    for (const tool of wrapperTools) {
-        if (dryRun) {
-            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`);
-            continue;
-        }
-        if (tool.name === 'codex') {
-            installCodexMemoryHooks(`  ${tool.name.padEnd(14)} `);
-            const result = ensureCodexWrapperInstalled();
-            if (result.status === 'installed') {
-                console.log(`  ${tool.name.padEnd(14)} wrapped launcher -> ${result.commandPath}`);
-            }
-            else if (result.status === 'already-installed') {
-                console.log(`  ${tool.name.padEnd(14)} already wrapped -> ${result.commandPath}`);
-            }
-            else {
-                console.log(`  ${tool.name.padEnd(14)} not found on PATH -- skipping`);
-            }
-        }
-    }
+    for (const tool of wrapperTools)
+        setupWrapperTool(tool, dryRun);
     if (pluginTools.length > 0) {
         console.log('');
         console.log('Plugin-based tools (hook API via plugin, not JSON):');
-        for (const tool of pluginTools) {
-            if (tool.name === 'opencode') {
-                if (dryRun) {
-                    console.log(`  ${tool.name.padEnd(14)} [dry-run] would install hippo plugin at ${resolveOpencodePluginPath()}`);
-                    continue;
-                }
-                const result = installOpencodePlugin();
-                const bits = [];
-                if (result.installed)
-                    bits.push('installed plugin');
-                if (result.migratedLegacyHooks)
-                    bits.push('migrated legacy hooks block');
-                if (result.jsonRepairFailed)
-                    bits.push('WARNING: opencode.json unparseable — manual fix needed');
-                if (bits.length === 0) {
-                    console.log(`  ${tool.name.padEnd(14)} already configured (${result.pluginPath})`);
-                }
-                else {
-                    console.log(`  ${tool.name.padEnd(14)} ${bits.join(', ')} -> ${result.pluginPath}`);
-                }
-            }
-            else {
-                // Other plugin tools (openclaw) have their own installer; the notes
-                // line points the user at it.
-                console.log(`  ${tool.name.padEnd(14)} ${tool.notes}`);
-            }
-        }
+        for (const tool of pluginTools)
+            setupPluginTool(tool, dryRun);
     }
     if (markdownTools.length > 0) {
         console.log('');
@@ -338,6 +271,90 @@ export function cmdSetup(flags) {
     console.log('');
     console.log('Done. Restart your AI tool to activate the hooks.');
 }
+function setupJsonTool(tool, dryRun) {
+    if (dryRun) {
+        // Resolve the real settings path so the filename is right for each tool
+        // (claude-code -> settings.json, opencode -> opencode.json).
+        const { settings } = resolveJsonHookPaths(tool.name);
+        console.log(`[dry-run] would install hooks in ${settings}`);
+        return;
+    }
+    const result = installJsonHooks(tool.name);
+    const bits = [];
+    if (result.installedSessionEnd)
+        bits.push('SessionEnd (session-end)');
+    if (result.installedSessionStart)
+        bits.push('SessionStart');
+    if (result.installedUserPromptSubmit)
+        bits.push('UserPromptSubmit (pinned-inject)');
+    if (result.installedPreCompact)
+        bits.push('PreCompact (pre-compact)');
+    if (result.installedCompactResume)
+        bits.push('SessionStart(compact) (compact-resume)');
+    if (result.installedPostCompact)
+        bits.push('PostCompact (post-compact)');
+    if (result.installedCaptureError)
+        bits.push('PostToolUseFailure (capture-error)');
+    if (result.migratedFromStop)
+        bits.push('migrated legacy Stop');
+    if (result.migratedSplitSessionEnd)
+        bits.push('migrated split SessionEnd → session-end');
+    else if (result.migratedLegacySessionEnd)
+        bits.push('migrated legacy SessionEnd');
+    if (bits.length === 0) {
+        console.log(`  ${tool.name.padEnd(14)} already configured (${result.settingsPath})`);
+    }
+    else {
+        console.log(`  ${tool.name.padEnd(14)} ${bits.join(', ')} -> ${result.settingsPath}`);
+    }
+}
+function setupWrapperTool(tool, dryRun) {
+    if (dryRun) {
+        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;
+    }
+    if (tool.name !== 'codex')
+        return;
+    installCodexMemoryHooks(`  ${tool.name.padEnd(14)} `);
+    const result = ensureCodexWrapperInstalled();
+    if (result.status === 'installed') {
+        console.log(`  ${tool.name.padEnd(14)} wrapped launcher -> ${result.commandPath}`);
+    }
+    else if (result.status === 'already-installed') {
+        console.log(`  ${tool.name.padEnd(14)} already wrapped -> ${result.commandPath}`);
+    }
+    else {
+        console.log(`  ${tool.name.padEnd(14)} not found on PATH -- skipping`);
+    }
+}
+function setupPluginTool(tool, dryRun) {
+    if (tool.name !== 'opencode') {
+        // Other plugin tools (openclaw) have their own installer; the notes
+        // line points the user at it.
+        console.log(`  ${tool.name.padEnd(14)} ${tool.notes}`);
+        return;
+    }
+    if (dryRun) {
+        console.log(`  ${tool.name.padEnd(14)} [dry-run] would install hippo plugin at ${resolveOpencodePluginPath()}`);
+        return;
+    }
+    const result = installOpencodePlugin();
+    const bits = [];
+    if (result.installed)
+        bits.push('installed plugin');
+    if (result.migratedLegacyHooks)
+        bits.push('migrated legacy hooks block');
+    if (result.jsonRepairFailed)
+        bits.push('WARNING: opencode.json unparseable — manual fix needed');
+    if (bits.length === 0) {
+        console.log(`  ${tool.name.padEnd(14)} already configured (${result.pluginPath})`);
+    }
+    else {
+        console.log(`  ${tool.name.padEnd(14)} ${bits.join(', ')} -> ${result.pluginPath}`);
+    }
+}
 export function cmdDailyRunner() {
     const globalRoot = getGlobalRoot();
     // No workspace sleep ever opens the global store, yet hooks in folders without a store compact into it.

package/dist/cli/shared.js

@@ -91,14 +91,14 @@ export function requireInit(hippoRoot) {
 /** Runs detectChurnStale against every store this repo's memories can live in. */
 export function runChurnStaleForRepo(hippoRoot, dryRun) {
     const repoRoot = execFileSync('git', ['rev-parse', '--show-toplevel'], { cwd: process.cwd(), encoding: 'utf8', timeout: 10_000, windowsHide: true }).trim();
-    const projectName = resolveProjectIdentity(process.cwd()).name;
+    const { name: projectName, legacyName } = resolveProjectIdentity(process.cwd());
     const globalRoot = getGlobalRoot();
     const roots = globalRoot !== hippoRoot && isInitialized(globalRoot) ? [hippoRoot, globalRoot] : [hippoRoot];
     const tenantId = resolveTenantId({});
     return roots.map((root) => {
         // One store failing must not abort sleep's later phases or skip the other store.
         try {
-            return { root, result: detectChurnStale(root, repoRoot, { tenantId, projectName, dryRun }) };
+            return { root, result: detectChurnStale(root, repoRoot, { tenantId, projectName, legacyName, dryRun }) };
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
@@ -405,7 +405,7 @@ export function cardStringFlag(flags, key) {
 }
 // Claude Code exports its own session var, not ours; without the fallback agent-run recalls trace with no session.
 export function hostSessionId() {
-    return envHippoSessionId()?.trim() || envClaudeCodeSessionId()?.trim() || undefined;
+    return envHippoSessionId() ?? envClaudeCodeSessionId();
 }
 /**
  * Compaction drops the pinned blocks the per-prompt hook injected

package/dist/cli/slack.js

@@ -10,7 +10,7 @@ import { addWorkspace as addSlackWorkspace, listWorkspaces as listSlackWorkspace
 import { printError } from './output.js';
 import { printSlackBackfillUsage, printSlackWorkspacesUsage } from './usage.js';
 // ---------------------------------------------------------------------------
-// Slack subcommands (E1.3 — `hippo slack backfill` / `hippo slack dlq list`)
+// Slack subcommands (`hippo slack backfill` / `hippo slack dlq list`)
 // ---------------------------------------------------------------------------
 function cmdSlackBackfill(hippoRoot, flags) {
     const channel = typeof flags['channel'] === 'string' ? flags['channel'] : undefined;

package/dist/cli/sleep.js

@@ -8,7 +8,9 @@ import { replayCompactionsAt } from '../compaction-record.js';
 import * as api from '../api.js';
 import { resolveTenantId } from '../tenant.js';
 import { renderAmbientSummary } from '../ambient.js';
-import { log } from '../log.js';
+import { errorMessage, log } from '../log.js';
+import { closeHippoDb, openHippoDb } from '../db.js';
+import { repairOnceOnSleep } from '../project-merge.js';
 import { requireInit, learnFromRepo, runChurnStaleForRepo, printAgentImport } from './shared.js';
 import { printError } from './output.js';
 /** Runs `hippo sleep`; with `--log-file` it also tees its output to that file. */
@@ -127,6 +129,29 @@ export function renderSleepResult(result) {
         console.log(`\nGraph: rebuilt ${tenants} tenant${tenants === 1 ? '' : 's'} (${entities} entities, ${relations} relations).`);
     }
 }
+/** Fault-isolated: a failed repair warns and runs again next sleep, and never stops the sleep. */
+function repairProjectTagsOnce(hippoRoot) {
+    let db;
+    try {
+        db = openHippoDb(hippoRoot);
+        const r = repairOnceOnSleep(db, hippoRoot, resolveTenantId({}));
+        if (r === null)
+            return;
+        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` : '',
+        ].filter((p) => p !== '');
+        console.log(`Repaired project tags once after the upgrade: ${parts.join('; ')} (backup: ${r.backup}).`);
+    }
+    catch (err) {
+        log.warn(`project tag repair skipped, retried next sleep: ${errorMessage(err)}`);
+    }
+    finally {
+        if (db)
+            closeHippoDb(db);
+    }
+}
 async function cmdSleepCore(hippoRoot, flags) {
     requireInit(hippoRoot);
     // Phase 1: Auto-learn from git and every coding agent's own memories (CLI-only, uses process.cwd() / os.homedir()).
@@ -157,6 +182,7 @@ async function cmdSleepCore(hippoRoot, flags) {
         const finished = replayCompactionsAt(hippoRoot, (message) => log.warn(`compaction replay: ${message}`));
         if (finished > 0)
             console.log(`Finished saving ${finished} compaction${finished === 1 ? '' : 's'} left over from earlier sessions.`);
+        repairProjectTagsOnce(hippoRoot);
     }
     // Phase 2-6: Pure-storage pipeline (consolidate + dedup + audit + share + ambient).
     const ctx = {