hippo-memory 1.61.0 → 1.63.0

package/dist/cli/status.d.ts

@@ -1,14 +1,14 @@
 import { type CommandContext } from './shared.js';
 export declare function cmdStatus(hippoRoot: string): void;
 /**
- * `hippo tokens [--days <n>] [--json] [--global]`: the token ledger
- * (ROADMAP TE0). Tokens of memory text handed to agents per surface, blocks
- * the per-prompt hook skipped as unchanged (TE2) and the tokens that saved,
+ * `hippo tokens [--days <n>] [--json] [--global]`: the token ledger.
+ * Tokens of memory text handed to agents per surface, blocks
+ * the per-prompt hook skipped as unchanged and the tokens that saved,
  * and the hook blocks' tokens later model calls re-read, counted when each session ends.
  * Counts are estimates (characters / 4), the same estimate every budget uses.
  */
 export declare function cmdTokens(hippoRoot: string, flags: Record<string, string | boolean | string[]>): void;
-/** `hippo failures [--days <n>] [--json] [--global]`: failed tool calls by outcome, and repeats across sessions (CD13). */
+/** `hippo failures [--days <n>] [--json] [--global]`: failed tool calls by outcome, and repeats across sessions. */
 export declare function cmdFailures(hippoRoot: string, flags: Record<string, string | boolean | string[]>): void;
 export declare function handleCorrectionLatency({ hippoRoot, flags }: CommandContext): void;
 export declare function handleProvenance({ hippoRoot, flags }: CommandContext): void;

package/dist/cli/status.js

@@ -31,36 +31,7 @@ export function cmdStatus(hippoRoot) {
     const entries = loadAllEntries(hippoRoot);
     const stats = loadStats(hippoRoot);
     const now = evalNow();
-    const byLayer = {
-        [Layer.Buffer]: 0,
-        [Layer.Episodic]: 0,
-        [Layer.Semantic]: 0,
-        [Layer.Trace]: 0,
-    };
-    const byConfidence = {
-        verified: 0,
-        observed: 0,
-        inferred: 0,
-        stale: 0,
-    };
-    let totalStrength = 0;
-    let pinned = 0;
-    let atRisk = 0; // strength < 0.2
-    let agedOut = 0;
-    for (const e of entries) {
-        const s = calculateStrength(e, now);
-        byLayer[e.layer] = (byLayer[e.layer] ?? 0) + 1;
-        totalStrength += s;
-        if (e.pinned)
-            pinned++;
-        if (s < 0.2)
-            atRisk++;
-        const facets = confidenceFacets(e, now);
-        byConfidence[facets.tier] = (byConfidence[facets.tier] ?? 0) + 1;
-        if (facets.agedOut)
-            agedOut++;
-    }
-    const avgStrength = entries.length > 0 ? totalStrength / entries.length : 0;
+    const { byLayer, byConfidence, pinned, atRisk, agedOut, avgStrength } = tallyStatus(entries, now);
     console.log('Hippo Status');
     console.log('---------------------------');
     console.log(`Total memories:    ${entries.length}`);
@@ -92,7 +63,44 @@ export function cmdStatus(hippoRoot) {
     else {
         console.log(`Last sleep:        never`);
     }
-    // Embedding status (provider-aware)
+    printEmbeddingStatus(hippoRoot, entries);
+    printPhysicsStatus(hippoRoot);
+}
+function tallyStatus(entries, now) {
+    const byLayer = {
+        [Layer.Buffer]: 0,
+        [Layer.Episodic]: 0,
+        [Layer.Semantic]: 0,
+        [Layer.Trace]: 0,
+    };
+    const byConfidence = {
+        verified: 0,
+        observed: 0,
+        inferred: 0,
+        stale: 0,
+    };
+    let totalStrength = 0;
+    let pinned = 0;
+    let atRisk = 0; // strength < 0.2
+    let agedOut = 0;
+    for (const e of entries) {
+        const s = calculateStrength(e, now);
+        byLayer[e.layer] = (byLayer[e.layer] ?? 0) + 1;
+        totalStrength += s;
+        if (e.pinned)
+            pinned++;
+        if (s < 0.2)
+            atRisk++;
+        const facets = confidenceFacets(e, now);
+        byConfidence[facets.tier] = (byConfidence[facets.tier] ?? 0) + 1;
+        if (facets.agedOut)
+            agedOut++;
+    }
+    const avgStrength = entries.length > 0 ? totalStrength / entries.length : 0;
+    return { byLayer, byConfidence, pinned, atRisk, agedOut, avgStrength };
+}
+// Embedding status (provider-aware)
+function printEmbeddingStatus(hippoRoot, entries) {
     const embedProvider = (() => {
         try {
             return resolveEmbeddingProvider(hippoRoot);
@@ -105,42 +113,43 @@ export function cmdStatus(hippoRoot) {
     console.log('');
     if (!embedProvider) {
         console.log(`Embeddings:        misconfigured (check embeddings.provider / apiBaseUrl), BM25 only`);
+        return;
+    }
+    const embeddingsDisabled = loadConfig(hippoRoot).embeddings.enabled === false;
+    const embAvail = embedProvider.isAvailable();
+    if (embeddingsDisabled) {
+        console.log(`Embeddings:        disabled in config (embeddings.enabled = false), BM25 only`);
+    }
+    else if (embedProvider.kind === 'local') {
+        console.log(`Embeddings:        ${embAvail ? `available [${embedProvider.id}]` : 'not installed (BM25 only)'}`);
+    }
+    else if (embAvail) {
+        console.log(`Embeddings:        ${embedProvider.kind} api [${embedProvider.id}]`);
     }
     else {
-        const embeddingsDisabled = loadConfig(hippoRoot).embeddings.enabled === false;
-        const embAvail = embedProvider.isAvailable();
-        if (embeddingsDisabled) {
-            console.log(`Embeddings:        disabled in config (embeddings.enabled = false), BM25 only`);
-        }
-        else if (embedProvider.kind === 'local') {
-            console.log(`Embeddings:        ${embAvail ? `available [${embedProvider.id}]` : 'not installed (BM25 only)'}`);
-        }
-        else if (embAvail) {
-            console.log(`Embeddings:        ${embedProvider.kind} api [${embedProvider.id}]`);
-        }
-        else {
-            console.log(`Embeddings:        ${embedProvider.kind} configured but ${embedProvider.keyEnv} not set (BM25 only)`);
-        }
-        // Show cached counts whenever vectors exist on disk (even when disabled or
-        // the key was removed), so the user still sees what is already indexed.
-        const embIndex = loadEmbeddingIndex(hippoRoot);
-        if (embAvail || Object.keys(embIndex).length > 0) {
-            const activeIds = new Set(entries.map((e) => e.id));
-            const activeEmbedded = Object.keys(embIndex).filter((id) => activeIds.has(id)).length;
-            const orphaned = Object.keys(embIndex).length - activeEmbedded;
-            const dims = Object.values(embIndex)[0]?.length;
-            let line = `Embedded:          ${activeEmbedded}/${entries.length} memories`;
-            if (dims)
-                line += ` (${dims}-dim)`;
-            if (orphaned > 0)
-                line += ` (${orphaned} orphaned, run \`hippo embed\` to prune)`;
-            console.log(line);
-            if (embeddingModelRequiresReindex(hippoRoot, embedProvider.id, embIndex)) {
-                console.log(`                   model changed, run \`hippo embed\` to reindex`);
-            }
-        }
+        console.log(`Embeddings:        ${embedProvider.kind} configured but ${embedProvider.keyEnv} not set (BM25 only)`);
+    }
+    // Show cached counts whenever vectors exist on disk (even when disabled or
+    // the key was removed), so the user still sees what is already indexed.
+    const embIndex = loadEmbeddingIndex(hippoRoot);
+    if (!embAvail && Object.keys(embIndex).length === 0)
+        return;
+    const activeIds = new Set(entries.map((e) => e.id));
+    const activeEmbedded = Object.keys(embIndex).filter((id) => activeIds.has(id)).length;
+    const orphaned = Object.keys(embIndex).length - activeEmbedded;
+    const dims = Object.values(embIndex)[0]?.length;
+    let line = `Embedded:          ${activeEmbedded}/${entries.length} memories`;
+    if (dims)
+        line += ` (${dims}-dim)`;
+    if (orphaned > 0)
+        line += ` (${orphaned} orphaned, run \`hippo embed\` to prune)`;
+    console.log(line);
+    if (embeddingModelRequiresReindex(hippoRoot, embedProvider.id, embIndex)) {
+        console.log(`                   model changed, run \`hippo embed\` to reindex`);
     }
-    // Physics status
+}
+// Physics status
+function printPhysicsStatus(hippoRoot) {
     try {
         const db = openHippoDb(hippoRoot);
         try {
@@ -150,13 +159,8 @@ export function cmdStatus(hippoRoot) {
                 const physConfig = loadConfig(hippoRoot);
                 const energy = computeSystemEnergy(particles, physConfig.physics.G_memory);
                 let sumVelMag = 0;
-                let maxVelMag = 0;
-                for (const p of particles) {
-                    const mag = vecNorm(p.velocity);
-                    sumVelMag += mag;
-                    if (mag > maxVelMag)
-                        maxVelMag = mag;
-                }
+                for (const p of particles)
+                    sumVelMag += vecNorm(p.velocity);
                 const avgVelMag = sumVelMag / particles.length;
                 console.log('');
                 console.log(`Physics: ${particles.length} particles, energy: ${fmt(energy.total, 4)} (KE: ${fmt(energy.kinetic, 4)}, PE: ${fmt(energy.potential, 4)}), avg vel: ${fmt(avgVelMag, 4)}`);
@@ -213,9 +217,9 @@ function cmdInspect(hippoRoot, id) {
     console.log(entry.content);
 }
 /**
- * `hippo tokens [--days <n>] [--json] [--global]`: the token ledger
- * (ROADMAP TE0). Tokens of memory text handed to agents per surface, blocks
- * the per-prompt hook skipped as unchanged (TE2) and the tokens that saved,
+ * `hippo tokens [--days <n>] [--json] [--global]`: the token ledger.
+ * Tokens of memory text handed to agents per surface, blocks
+ * the per-prompt hook skipped as unchanged and the tokens that saved,
  * and the hook blocks' tokens later model calls re-read, counted when each session ends.
  * Counts are estimates (characters / 4), the same estimate every budget uses.
  */
@@ -254,7 +258,7 @@ export function cmdTokens(hippoRoot, flags) {
     console.log('  Re-reads are counted for hook and compact-resume blocks when a session ends; other surfaces, and open or crashed sessions, show sent only.');
     console.log("  Re-reads usually bill at the provider's cached-input rate, a fraction of the full input price.");
 }
-/** `hippo failures [--days <n>] [--json] [--global]`: failed tool calls by outcome, and repeats across sessions (CD13). */
+/** `hippo failures [--days <n>] [--json] [--global]`: failed tool calls by outcome, and repeats across sessions. */
 export function cmdFailures(hippoRoot, flags) {
     // The store the capture-error hook writes to; a report never creates one.
     const root = flags['global'] ? getGlobalRoot() : hookStoreRoot(hippoRoot);
@@ -289,7 +293,7 @@ export function cmdFailures(hippoRoot, flags) {
     for (const [label, count, note] of rows) {
         console.log(`  ${label.padEnd(13)}${String(count).padStart(6)}  ${note}`.trimEnd());
     }
-    // Counts, not a rate: a share means little without a holdout arm to compare against (CD11).
+    // Counts, not a rate: a share means little without a holdout arm to compare against.
     if (summary.rated > 0) {
         const noSession = errors - summary.rated;
         const unrated = noSession > 0 ? ` ${noSession} more had no session id.` : '';

package/dist/cli/transfer.js

@@ -46,10 +46,8 @@ async function cmdWatch(command, hippoRoot) {
     entry.schema_fit = watchFit;
     entry.half_life_days = deriveHalfLife(loadConfig(hippoRoot).defaultHalfLifeDays, entry);
     entry.strength = calculateStrength(entry);
-    // AT1 (plan §3 containment): mechanical content from a failed command — a
-    // rejection-guard refusal here must not crash the watcher. Skip silently
-    // (loud enough via the message below) and still exit with the wrapped
-    // command's real exit code.
+    // A rejection-guard refusal of a failed command's output must not crash the watcher:
+    // skip with the message below and still exit with the wrapped command's real exit code.
     try {
         writeEntry(hippoRoot, entry);
         updateStats(hippoRoot, { remembered: 1 });
@@ -112,18 +110,8 @@ export function cmdImport(hippoRoot, args, flags) {
             ? [String(flags['tag'])]
             : [];
     const targetRoot = useGlobal ? getGlobalRoot() : hippoRoot;
-    if (flags['agents']) {
-        const opts = { machine: currentMachine(), dryRun };
-        // A folder without a store of its own imports as session end would there, so its notes are not hidden.
-        const report = useGlobal || isInitialized(hippoRoot)
-            ? importForStore(useGlobal ? getGlobalRoot() : hippoRoot, opts)
-            : importAtSessionEnd(process.cwd(), undefined, opts);
-        for (const line of detailLines(report, dryRun))
-            console.log(line);
-        for (const warning of report.warnings)
-            printError(`hippo: agent memories: ${warning}`);
-        return;
-    }
+    if (flags['agents'])
+        return importAgentMemories(hippoRoot, useGlobal, dryRun);
     if (useGlobal) {
         initGlobal();
     }
@@ -136,99 +124,35 @@ export function cmdImport(hippoRoot, args, flags) {
         extraTags,
         hippoRoot,
     };
-    // K1 vault import: a FOLDER importer that mirrors the connector pattern
+    // Vault import: a FOLDER importer that mirrors the connector pattern
     // (kind='raw' + tag provenance + archiveRaw deletions), so it dispatches
     // separately from the single-file `importer` function-pointer slot below.
     // It writes through api.remember/archiveRaw which are tenant-scoped, so we
     // resolve the tenant and pass it through. --global is not supported for
     // vault import (the connector raw-archive path is tenant-local).
-    if (flags['vault']) {
-        const folderPath = String(flags['vault']);
-        if (!fs.existsSync(folderPath) || !fs.statSync(folderPath).isDirectory()) {
-            printError(`Vault folder not found (or not a directory): ${folderPath}`);
-            process.exit(1);
-        }
-        if (useGlobal) {
-            printError('hippo import --vault does not support --global (raw rows are tenant-local).');
-            process.exit(1);
-        }
-        if (typeof flags['name'] !== 'string' || !flags['name'].trim()) {
-            // --name is the vault identity key for the destructive source-deletion sync;
-            // inferring it from the folder basename let same-basename vaults collide and
-            // clobber each other (codex R10 P2). A valueless `--name` parses as boolean
-            // true, and String(true) === "true" would silently import under vault:true:*
-            // - reject a non-string so it fails fast instead (codex R11 P2).
-            printError('hippo import --vault requires --name <vault> (a non-empty identity key for source-deletion sync).');
-            process.exit(1);
-        }
-        if (flags['scope'] !== undefined && (typeof flags['scope'] !== 'string' || !flags['scope'].trim())) {
-            // Same valueless-flag trap: a bare `--scope` must not become scope "true".
-            // Example uses the source-prefixed private form, since a bare `private` scope
-            // is NOT treated as private by recall and importVault rejects it (R13 P2).
-            printError('hippo import --vault: --scope requires a value (e.g. --scope vault:private:notes).');
-            process.exit(1);
-        }
-        const tenantId = resolveTenantId({});
-        const vaultOptions = {
-            ...importOptions,
-            tenantId,
-            name: flags['name'] ? String(flags['name']) : undefined,
-            scope: flags['scope'] ? String(flags['scope']) : undefined,
-        };
-        const vaultResult = importVault(folderPath, vaultOptions);
-        console.log(`\nImport Vault: ${folderPath}${dryRun ? ' (dry run - no writes)' : ''}`);
-        console.log(`  Notes found:           ${vaultResult.total}`);
-        console.log(`  ${dryRun ? 'Would import:         ' : 'Imported:             '}${vaultResult.imported}`);
-        console.log(`  Skipped (unchanged):   ${vaultResult.skipped}`);
-        if ((vaultResult.rejected ?? 0) > 0) {
-            console.log(`  Rejected (tombstoned): ${vaultResult.rejected}`);
-        }
-        warnRedacted(vaultResult.redacted);
-        console.log(`  ${dryRun ? 'Would archive:        ' : 'Archived (removed):   '}${vaultResult.archived ?? 0}`);
-        console.log(`  Store:                 ${hippoRoot}`);
-        // Batch producer, same contract as the single-file import below: vault rows
-        // write through api.remember (which never embeds), so backfill them here.
-        // Floating promise is deliberate; see the comment at the single-file site.
-        if (!dryRun && vaultResult.imported >= 1) {
-            void embedAll(hippoRoot).catch(() => { });
-        }
-        return;
-    }
-    // Determine which importer to use based on flag
-    let filePath;
-    let importer;
-    let importerName = '';
-    if (flags['chatgpt']) {
-        filePath = String(flags['chatgpt']);
-        importer = importChatGPT;
-        importerName = 'ChatGPT';
-    }
-    else if (flags['claude']) {
-        filePath = String(flags['claude']);
-        importer = importClaude;
-        importerName = 'Claude';
-    }
-    else if (flags['cursor']) {
-        filePath = String(flags['cursor']);
-        importer = importCursor;
-        importerName = 'Cursor';
-    }
-    else if (flags['file']) {
-        filePath = String(flags['file']);
-        importer = importGenericFile;
-        importerName = 'File';
-    }
-    else if (flags['markdown']) {
-        filePath = String(flags['markdown']);
-        importer = importMarkdown;
-        importerName = 'Markdown';
-    }
-    else if (args[0]) {
-        // Positional: try to auto-detect from extension
-        filePath = args[0];
-        importer = importGenericFile;
-        importerName = 'File';
-    }
+    if (flags['vault'])
+        return importVaultFolder(hippoRoot, flags, importOptions, useGlobal, dryRun);
+    importFromFile(targetRoot, args, flags, importOptions, useGlobal, dryRun);
+}
+// Determine which importer to use based on flag
+function pickImporter(args, flags) {
+    if (flags['chatgpt'])
+        return { filePath: String(flags['chatgpt']), importer: importChatGPT, importerName: 'ChatGPT' };
+    if (flags['claude'])
+        return { filePath: String(flags['claude']), importer: importClaude, importerName: 'Claude' };
+    if (flags['cursor'])
+        return { filePath: String(flags['cursor']), importer: importCursor, importerName: 'Cursor' };
+    if (flags['file'])
+        return { filePath: String(flags['file']), importer: importGenericFile, importerName: 'File' };
+    if (flags['markdown'])
+        return { filePath: String(flags['markdown']), importer: importMarkdown, importerName: 'Markdown' };
+    // Positional: try to auto-detect from extension
+    if (args[0])
+        return { filePath: args[0], importer: importGenericFile, importerName: 'File' };
+    return { filePath: undefined, importer: undefined, importerName: '' };
+}
+function importFromFile(targetRoot, args, flags, importOptions, useGlobal, dryRun) {
+    const { filePath, importer, importerName } = pickImporter(args, flags);
     if (!filePath || !importer) {
         printError('Usage: hippo import <--chatgpt|--claude|--cursor|--file|--markdown|--vault> <path>, or hippo import --agents [--dry-run]');
         process.exit(1);
@@ -272,6 +196,65 @@ export function cmdImport(hippoRoot, args, flags) {
         console.log(`  Store:                 ${storeLabel}`);
     }
 }
+function importAgentMemories(hippoRoot, useGlobal, dryRun) {
+    const opts = { machine: currentMachine(), dryRun };
+    // A folder without a store of its own imports as session end would there, so its notes are not hidden.
+    const report = useGlobal || isInitialized(hippoRoot)
+        ? importForStore(useGlobal ? getGlobalRoot() : hippoRoot, opts)
+        : importAtSessionEnd(process.cwd(), undefined, opts);
+    for (const line of detailLines(report, dryRun))
+        console.log(line);
+    for (const warning of report.warnings)
+        printError(`hippo: agent memories: ${warning}`);
+}
+function importVaultFolder(hippoRoot, flags, importOptions, useGlobal, dryRun) {
+    const folderPath = String(flags['vault']);
+    if (!fs.existsSync(folderPath) || !fs.statSync(folderPath).isDirectory()) {
+        printError(`Vault folder not found (or not a directory): ${folderPath}`);
+        process.exit(1);
+    }
+    if (useGlobal) {
+        printError('hippo import --vault does not support --global (raw rows are tenant-local).');
+        process.exit(1);
+    }
+    if (typeof flags['name'] !== 'string' || !flags['name'].trim()) {
+        // --name keys the destructive source-deletion sync; a folder-basename default lets same-basename vaults clobber
+        // each other, and a valueless `--name` (boolean true) would silently import under vault:true:*.
+        printError('hippo import --vault requires --name <vault> (a non-empty identity key for source-deletion sync).');
+        process.exit(1);
+    }
+    if (flags['scope'] !== undefined && (typeof flags['scope'] !== 'string' || !flags['scope'].trim())) {
+        // Same valueless-flag trap: a bare `--scope` must not become scope "true".
+        // Example uses the source-prefixed private form, since a bare `private` scope
+        // is NOT treated as private by recall and importVault rejects it.
+        printError('hippo import --vault: --scope requires a value (e.g. --scope vault:private:notes).');
+        process.exit(1);
+    }
+    const tenantId = resolveTenantId({});
+    const vaultOptions = {
+        ...importOptions,
+        tenantId,
+        name: flags['name'] ? String(flags['name']) : undefined,
+        scope: flags['scope'] ? String(flags['scope']) : undefined,
+    };
+    const vaultResult = importVault(folderPath, vaultOptions);
+    console.log(`\nImport Vault: ${folderPath}${dryRun ? ' (dry run - no writes)' : ''}`);
+    console.log(`  Notes found:           ${vaultResult.total}`);
+    console.log(`  ${dryRun ? 'Would import:         ' : 'Imported:             '}${vaultResult.imported}`);
+    console.log(`  Skipped (unchanged):   ${vaultResult.skipped}`);
+    if ((vaultResult.rejected ?? 0) > 0) {
+        console.log(`  Rejected (tombstoned): ${vaultResult.rejected}`);
+    }
+    warnRedacted(vaultResult.redacted);
+    console.log(`  ${dryRun ? 'Would archive:        ' : 'Archived (removed):   '}${vaultResult.archived ?? 0}`);
+    console.log(`  Store:                 ${hippoRoot}`);
+    // Batch producer, same contract as the single-file import above: vault rows
+    // write through api.remember (which never embeds), so backfill them here.
+    // Floating promise is deliberate; see the comment at the single-file site.
+    if (!dryRun && vaultResult.imported >= 1) {
+        void embedAll(hippoRoot).catch(() => { });
+    }
+}
 // ---------------------------------------------------------------------------
 // Promote command
 // ---------------------------------------------------------------------------
@@ -388,9 +371,7 @@ export function handleShare({ hippoRoot, args, flags }) {
     }
 }
 export function handlePeers({ flags }) {
-    // D4 v1.12.10: tenant-scoped by default. --all-tenants restores the
-    // pre-D4 host-wide view for the rare operator who genuinely wants
-    // cross-tenant peer discovery.
+    // Tenant-scoped by default; --all-tenants gives the host-wide view for cross-tenant peer discovery.
     const allTenants = flags['all-tenants'] === true;
     const tenantScope = allTenants ? undefined : resolveTenantId({});
     const peers = listPeers(undefined, tenantScope);

package/dist/cli/usage.js

@@ -1,5 +1,7 @@
 // Help text for every verb, keyed like the command table in cli.ts; no command logic lives here.
 import { TAIL_MAX_LINES } from '../support-bundle.js';
+import { DEFAULT_LOCAL_BUMP, DEFAULT_RECALL_BUDGET } from '../search/types.js';
+import { DEFAULT_ASSEMBLE_BUDGET } from '../api/assemble.js';
 export function printAuditPruneUsage() {
     console.log('hippo audit prune --older-than <Nd> [--dry-run] [--tenant <t>]');
     console.log('  --older-than <Nd>  Delete audit_log rows with ts older than N days (e.g. 90d).');
@@ -102,7 +104,7 @@ export const VERB_USAGE = {
     --global               Store in global store ($HIPPO_HOME or ~/.hippo/)`],
     recall: [`
   recall <query>           Search and retrieve memories (local + global)
-    --budget <n>           Token budget for the whole printed block (default: 4000)
+    --budget <n>           Token budget for the whole printed block (default: ${DEFAULT_RECALL_BUDGET})
     --min-results <n>      Minimum results regardless of budget (default: 1)
     --json                 Output as JSON
     --why                  Show match reasons and source annotations
@@ -193,7 +195,7 @@ export const VERB_USAGE = {
     --json                 Output as JSON`],
     assemble: [`
   assemble --session <id>  Build a session's chronological context window
-    --budget N             Token budget for the printed window (default 4000)
+    --budget N             Token budget for the printed window (default ${DEFAULT_ASSEMBLE_BUDGET})
     --fresh-tail N         Recent rows always kept verbatim (default 10)
     --no-summarize-older   Disable older-row summary substitution
     --scope <s>            Restrict to exact scope (default: deny *:private:*)
@@ -205,7 +207,7 @@ export const VERB_USAGE = {
     --pin                  Pin the new memory (default: pinned if the old one was)`],
     explain: [`
   explain <query>          Show full score breakdown for each retrieved memory
-    --budget <n>           Token budget, counted as recall prints (default: 4000)
+    --budget <n>           Token budget, counted as recall prints (default: ${DEFAULT_RECALL_BUDGET})
     --limit <n>            Cap the number of results displayed
     --json                 Output as JSON
     --physics | --classic  Force search mode (default: from config)
@@ -221,7 +223,7 @@ export const VERB_USAGE = {
     --no-mmr               Disable MMR for this eval run
     --mmr-lambda <f>       Override MMR lambda for this run
     --embedding-weight <f> Override cosine weight (default: 0.6)
-    --local-bump <f>       Local-over-global priority multiplier (default: 1.2)
+    --local-bump <f>       Local-over-global priority multiplier (default: ${DEFAULT_LOCAL_BUMP})
     --equal-sources        Shortcut for --local-bump 1.0
     --min-mrr <f>          Exit non-zero if mean MRR falls below this
     --json                 Output full summary as JSON`],
@@ -393,8 +395,9 @@ export const VERB_USAGE = {
                            Fold one project name into another (dry run unless --apply;
                            writes a backup and one audit event first)
     projects repair [--apply]
-                           Re-tag merged rows older versions of sleep saved as user-global,
-                           by their parents' project (dry run unless --apply)`],
+                           Set aside misfiled note imports, fold old project names into
+                           their ids, re-tag merged rows (dry run unless --apply;
+                           writes a backup and one audit event first)`],
     quarantine: [`
   quarantine [list]       List memories a connector flagged as an instruction attempt, pending review
     --all                  Include approved and rejected rows too (default: pending only)

package/dist/cli.d.ts

@@ -253,7 +253,7 @@ export declare const COMMANDS: {
         usage: string[];
     };
     hook: {
-        run: ({ args, flags }: CommandContext) => Promise<void>;
+        run: ({ args }: CommandContext) => Promise<void>;
         usage: string[];
     };
     setup: {

package/dist/cli.js

@@ -185,7 +185,7 @@ export function shouldAutoRepairCodexWrapper(currentCommand, flags) {
 // hook install codex` (a Codex update can restore the real binary over our
 // shim). Never first-installs — silently swapping the codex binary on routine
 // commands is a consent violation and reads as binary hijacking to
-// supply-chain scanners (issue #133).
+// supply-chain scanners.
 function maybeRepairCodexWrapper(currentCommand, flags) {
     if (!shouldAutoRepairCodexWrapper(currentCommand, flags))
         return;
@@ -407,7 +407,7 @@ export const COMMANDS = {
         usage: VERB_USAGE.context,
     },
     hook: {
-        run: async ({ args, flags }) => { (await import('./cli/setup.js')).cmdHook(args, flags); },
+        run: async ({ args }) => { (await import('./cli/setup.js')).cmdHook(args); },
         usage: VERB_USAGE.hook,
     },
     setup: {
@@ -579,13 +579,8 @@ async function main(command, args, flags, hippoRoot) {
         return;
     }
     maybeRepairCodexWrapper(command, flags);
-    /** Global --scope well-formedness guard (v1.26.2). parseArgs stores a value-less
-     *  flag as boolean true; downstream the 14 consumer sites either coerced that to
-     *  the literal scope string 'true' (recall filter/unlock input, wm session scope,
-     *  the remember scope-tag dual-write) or silently dropped the user's scoping
-     *  intent (the remember envelope WRITE). Reject it once here, mirroring the
-     *  --hops value-less guard, so every current and future command - including the
-     *  thin-client dispatch relays - sees --scope only as a non-empty string. */
+    /** A value-less --scope parses as boolean true, which consumers coerced to the scope 'true' or dropped;
+     *  reject it once here so every command, thin-client relays included, sees only a non-empty string. */
     if ('scope' in flags && (typeof flags['scope'] !== 'string' || !flags['scope'].trim())) {
         printError('--scope requires a non-empty value (e.g. --scope slack:private:C1).');
         process.exit(1);

package/dist/compaction-record.d.ts

@@ -25,8 +25,6 @@ export interface CompactionRecord {
     status: CompactionStatus;
 }
 export type Log = (message: string) => void;
-/** Where the session ran: rows written through the global store keep the project the session was in. */
-export declare function compactionOrigin(hippoRoot: string, cwd: string | null): string;
 interface ScrubbedSummary {
     summary: string;
     items: string[];
@@ -58,6 +56,8 @@ export interface ItemContext {
     recordId: string | null;
     sessionId: string;
     originProject: string;
+    /** Where the session ran, so rows held under the project's older folder name count too. */
+    cwd: string | null;
     items: string[];
 }
 /** Items that become rows, then the record `done`, in one transaction so two sessions cannot both insert one text. Mirrors after commit. */