hippo-memory 1.71.0 → 1.72.0

package/dist/cli/status.js

@@ -1,17 +1,12 @@
 // Read-only report verbs: status, inspect, tokens, failures, provenance, correction latency, doctor and support bundle.
 import { envHomeDir } from '../util/env.js';
-import { evalNow } from '../core/ablation.js';
+import { evalNow, strengthAblation } from '../core/ablation.js';
 import * as path from 'path';
 import * as fs from 'fs';
 import * as os from 'os';
 import { fileURLToPath } from 'node:url';
 import { calculateStrength, calculateRewardFactor, resolveConfidence, Layer } from '../core/memory.js';
-import { loadCorrectionEntries, loadRawEntries } from '../store/report-reads.js';
-import { loadStats } from '../store/index-and-stats.js';
-import { loadStatusCounts } from '../store/candidates.js';
-import { embeddingModelRequiresReindex } from '../store/embeddings/index.js';
-import { resolveEmbeddingProvider } from '../store/embeddings/provider.js';
-import { loadStoredParticles, storedVectorSummary } from '../store/vector-index.js';
+import { resolveEmbeddingProvider } from '../embeddings/provider.js';
 import { computeSystemEnergy, vecNorm } from '../core/physics.js';
 import { loadConfig } from '../core/config.js';
 import { runDoctor, formatDoctor } from '../doctor.js';
@@ -19,10 +14,9 @@ import { buildSupportBundle, TAIL_MAX_LINES } from '../support-bundle.js';
 import { PACKAGE_VERSION } from '../util/version.js';
 import { FAILURE_LOG_RETENTION_DAYS } from '../store/failure-log.js';
 import { getGlobalRoot } from '../sharing/global-store.js';
-import { buildProvenanceCoverage } from './provenance-coverage.js';
-import { buildCorrectionLatency } from './correction-latency.js';
 import * as api from '../api/index.js';
 import { getMemory } from '../api/memories.js';
+import { correctionLatencyReport, embeddingReindexNeeded, provenanceCoverageReport, storeStatus, storedParticles, vectorSummary, } from '../api/status.js';
 import { cliApiContext } from './api-context.js';
 import { errorMessage, log } from '../util/log.js';
 import { printError } from './output.js';
@@ -31,12 +25,12 @@ import { requireInit, resolveAuthRoot } from './shared.js';
 import { fmt } from './print.js';
 import { isJsonObject } from '../util/json.js';
 import { hookStoreRoot } from './hook-runtime.js';
-import { DAY_MS } from '../util/time.js';
+import { DAY_MS, HOUR_MS, MINUTE_MS } from '../util/time.js';
 import { CliExit } from './exit.js';
-export function handleStatus({ hippoRoot }) {
+export function handleStatus({ hippoRoot, tenantId }) {
     requireInit(hippoRoot);
-    const stats = loadStats(hippoRoot);
-    const counts = loadStatusCounts(hippoRoot, evalNow(), 0.2);
+    const ctx = cliApiContext(hippoRoot, tenantId);
+    const { stats, counts } = storeStatus(ctx, evalNow(), 0.2);
     const { byLayer, byConfidence, pinned, atRisk, agedOut, avgStrength } = counts;
     console.log('Hippo Status');
     console.log('---------------------------');
@@ -68,14 +62,14 @@ export function handleStatus({ hippoRoot }) {
     else {
         console.log(`Last sleep:        never`);
     }
-    printEmbeddingStatus(hippoRoot, counts);
-    printPhysicsStatus(hippoRoot);
+    printEmbeddingStatus(ctx, counts);
+    printPhysicsStatus(ctx);
 }
 // Embedding status (provider-aware)
-function printEmbeddingStatus(hippoRoot, counts) {
+function printEmbeddingStatus(ctx, counts) {
     const embedProvider = (() => {
         try {
-            return resolveEmbeddingProvider(hippoRoot);
+            return resolveEmbeddingProvider(ctx.hippoRoot);
         }
         catch {
             // Status reports a bad provider config as "misconfigured" below instead of failing.
@@ -87,7 +81,7 @@ function printEmbeddingStatus(hippoRoot, counts) {
         console.log(`Embeddings:        misconfigured (check embeddings.provider / apiBaseUrl), BM25 only`);
         return;
     }
-    const embeddingsDisabled = loadConfig(hippoRoot).embeddings.enabled === false;
+    const embeddingsDisabled = loadConfig(ctx.hippoRoot).embeddings.enabled === false;
     const embAvail = embedProvider.isAvailable();
     if (embeddingsDisabled) {
         console.log(`Embeddings:        disabled in config (embeddings.enabled = false), BM25 only`);
@@ -103,7 +97,7 @@ function printEmbeddingStatus(hippoRoot, counts) {
     }
     // 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 { ids: embeddedIds, dims } = storedVectorSummary(hippoRoot);
+    const { ids: embeddedIds, dims } = vectorSummary(ctx);
     if (!embAvail && embeddedIds.size === 0)
         return;
     const orphaned = embeddedIds.size - counts.embedded;
@@ -114,23 +108,24 @@ function printEmbeddingStatus(hippoRoot, counts) {
         line += ` (${orphaned} orphaned, run \`hippo embed\` to prune)`;
     console.log(line);
     // No index argument: the check then asks SQLite whether any vector exists instead of loading them.
-    if (embeddingModelRequiresReindex(hippoRoot, embedProvider.id)) {
+    if (embeddingReindexNeeded(ctx, embedProvider.id)) {
         console.log(`                   model changed, run \`hippo embed\` to reindex`);
     }
 }
 // The all-pairs energy sum is quadratic, so a large particle set skips it.
 const PHYSICS_ENERGY_STATUS_MAX = 2000;
 // Physics status
-function printPhysicsStatus(hippoRoot) {
+function printPhysicsStatus(ctx) {
     try {
-        const particles = loadStoredParticles(hippoRoot);
+        const particles = storedParticles(ctx);
         if (particles.length > 0) {
             let sumVelMag = 0;
             for (const p of particles)
                 sumVelMag += vecNorm(p.velocity);
             const avgVelMag = sumVelMag / particles.length;
             console.log('');
-            console.log(`Physics: ${particles.length} particles, ${physicsEnergyText(particles, loadConfig(hippoRoot).physics.G_memory)}, avg vel: ${fmt(avgVelMag, 4)}`);
+            console.log(`Physics: ${particles.length} particles, ` +
+                `${physicsEnergyText(particles, loadConfig(ctx.hippoRoot).physics.G_memory)}, avg vel: ${fmt(avgVelMag, 4)}`);
         }
     }
     catch (err) {
@@ -152,7 +147,7 @@ async function cmdInspect(hippoRoot, tenantId, id) {
         throw new CliExit(1);
     }
     const now = evalNow();
-    const currentStrength = calculateStrength(entry, now);
+    const currentStrength = calculateStrength(entry, now, { ablation: strengthAblation() });
     const lastRetrieved = new Date(entry.last_retrieved);
     const created = new Date(entry.created);
     const ageDays = (now.getTime() - created.getTime()) / DAY_MS;
@@ -171,7 +166,7 @@ async function cmdInspect(hippoRoot, tenantId, id) {
     console.log(`Schema fit:       ${entry.schema_fit}`);
     console.log(`Pinned:           ${entry.pinned}`);
     console.log(`Tags:             ${entry.tags.join(', ') || 'none'}`);
-    const rewardFactor = calculateRewardFactor(entry);
+    const rewardFactor = calculateRewardFactor(entry, strengthAblation());
     const pos = entry.outcome_positive ?? 0;
     const neg = entry.outcome_negative ?? 0;
     const outcomeLabel = pos === 0 && neg === 0
@@ -257,9 +252,9 @@ export function handleFailures({ hippoRoot, tenantId, flags }) {
         console.log(`\n  Repeats: ${summary.repeats} of ${summary.rated} errors first happened in another session.${unrated}`);
     }
 }
-export function handleCorrectionLatency({ hippoRoot, flags }) {
+export function handleCorrectionLatency({ hippoRoot, tenantId, flags }) {
     requireInit(hippoRoot);
-    const report = buildCorrectionLatency(loadCorrectionEntries(hippoRoot));
+    const report = correctionLatencyReport(cliApiContext(hippoRoot, tenantId));
     if (flags['json']) {
         console.log(JSON.stringify(report, null, 2));
     }
@@ -272,11 +267,11 @@ export function handleCorrectionLatency({ hippoRoot, flags }) {
                 return 'n/a';
             if (ms < 1000)
                 return `${ms}ms`;
-            if (ms < 60_000)
+            if (ms < MINUTE_MS)
                 return `${(ms / 1000).toFixed(1)}s`;
-            if (ms < 3_600_000)
-                return `${(ms / 60_000).toFixed(1)}m`;
-            return `${(ms / 3_600_000).toFixed(1)}h`;
+            if (ms < HOUR_MS)
+                return `${(ms / MINUTE_MS).toFixed(1)}m`;
+            return `${(ms / HOUR_MS).toFixed(1)}h`;
         };
         console.log(`Corrections: ${report.count} total (${report.extractionCount} extraction-driven, ${report.manualCount} manual)`);
         console.log(`Latency p50: ${fmt(report.p50Ms)}, p95: ${fmt(report.p95Ms)}, max: ${fmt(report.maxMs)}`);
@@ -286,9 +281,9 @@ export function handleCorrectionLatency({ hippoRoot, flags }) {
         }
     }
 }
-export function handleProvenance({ hippoRoot, flags }) {
+export function handleProvenance({ hippoRoot, tenantId, flags }) {
     requireInit(hippoRoot);
-    const coverage = buildProvenanceCoverage(loadRawEntries(hippoRoot));
+    const coverage = provenanceCoverageReport(cliApiContext(hippoRoot, tenantId));
     if (flags['json']) {
         console.log(JSON.stringify(coverage, null, 2));
     }
@@ -345,8 +340,10 @@ export function handleSupportBundle({ flags }) {
     const kb = Math.round(Buffer.byteLength(json) / 1024);
     console.log(`Wrote ${file} (${kb} KB).`);
     console.log(includeLogs
-        ? `It holds versions, doctor checks, config with secrets removed, store counts, and the last ${TAIL_MAX_LINES} lines of each hippo log with known secret shapes removed. Those log lines can quote memory text. Read it before you attach it to a ticket.`
-        : 'It holds versions, doctor checks, config with secrets removed, store counts and log file names. It never holds memory text. Read it before you attach it to a ticket.');
+        ? `It holds versions, doctor checks, config with secrets removed, store counts, and the last ${TAIL_MAX_LINES} lines of ` +
+            'each hippo log with known secret shapes removed. Those log lines can quote memory text. Read it before you attach it to a ticket.'
+        : 'It holds versions, doctor checks, config with secrets removed, store counts and log file names. It never holds memory text. Read it before you ' +
+            'attach it to a ticket.');
 }
 export async function handleInspect({ hippoRoot, tenantId, args }) {
     const id = args[0];

package/dist/cli/transfer.d.ts

@@ -1,5 +1,5 @@
 import { type CommandContext } from './flag-values.js';
-export declare function handleLearn({ hippoRoot, flags }: CommandContext): void;
+export declare function handleLearn({ hippoRoot, tenantId, flags }: CommandContext): void;
 export declare function handleImport({ hippoRoot, tenantId, args, flags }: CommandContext): void;
 export declare function handleSync({ hippoRoot, flags }: CommandContext): void;
 export declare function handleWatch({ hippoRoot, tenantId, args }: CommandContext): Promise<void>;

package/dist/cli/transfer.js

@@ -1,29 +1,27 @@
 // Verbs that move memories in and out: watch, learn, import, export, promote, sync, share and peers.
 import * as path from 'path';
 import * as fs from 'fs';
-import { isInitialized } from '../store/open.js';
-import { loadAllEntries } from '../store/entry-reads.js';
-import { RejectedValueError } from '../store/rejection.js';
-import { embedAll } from '../store/embeddings/index.js';
-import { loadEmbeddingIndex } from '../store/vector-index.js';
+import { isInitialized } from '../core/project-identity.js';
+import { RejectedValueError } from '../core/api-errors.js';
+import { embedCoverage, embedMissingMemories } from '../api/embeddings.js';
 import { captureError, runWatched } from '../learn/autolearn.js';
 import { currentMachine, importAtSessionEnd, importForStore } from '../agent-memories/sync.js';
 import { detailLines } from '../agent-memories/report.js';
 import { getGlobalRoot, initGlobal } from '../sharing/global-store.js';
-import { shareMemory, listPeers, autoShare, transferScore } from '../sharing/share.js';
+import { AUTO_SHARE_MIN_SCORE, shareMemory, listPeers, autoShare, transferScore } from '../sharing/share.js';
 import { syncGlobalToLocal } from '../sharing/global-sync.js';
 import { importChatGPT, importClaude, importCursor, importGenericFile, } from '../importers/sources.js';
 import { importMarkdown } from '../importers/markdown.js';
 import { importVault } from '../importers/vault.js';
 import * as api from '../api/index.js';
-import { getMemory } from '../api/memories.js';
+import { getMemory, listMemories } from '../api/memories.js';
 import * as client from './client.js';
 import { cliApiContext } from './api-context.js';
 import { printError } from './output.js';
 import { errorMessage, log } from '../util/log.js';
 import { requireInit, runViaServerIfAvailable, learnFromRepo } from './shared.js';
 import { fmt } from './print.js';
-import { boolFlag, flagIsTrue, isStringFlag, nonEmptyStringFlag } from './flag-values.js';
+import { boolFlag, flagIsTrue, isStringFlag, nonEmptyStringFlag, numberFlag } from './flag-values.js';
 import { CONTENT_PREVIEW_CHARS, DATE_PREFIX_CHARS } from '../util/token-text.js';
 import { CliExit } from './exit.js';
 const STDERR_PREVIEW_CHARS = 80;
@@ -71,13 +69,13 @@ async function cmdWatch(command, hippoRoot, tenantId) {
     throw new CliExit(exitCode);
 }
 // Learn command
-export function handleLearn({ hippoRoot, flags }) {
+export function handleLearn({ hippoRoot, tenantId, flags }) {
     requireInit(hippoRoot);
     if (!flags['git']) {
         printError('Usage: hippo learn --git [--days <n>] [--repos <paths>]');
         throw new CliExit(1);
     }
-    const days = parseInt(String(flags['days'] ?? '7'), 10);
+    const days = numberFlag(flags, 'days') ?? 7;
     console.log(`Scanning git log for the last ${days} days...`);
     const reposFlag = nonEmptyStringFlag(flags, 'repos');
     if (reposFlag) {
@@ -86,30 +84,36 @@ export function handleLearn({ hippoRoot, flags }) {
         let totalSkipped = 0;
         for (const repo of repos) {
             const label = path.basename(repo);
-            const { added, skipped } = learnFromRepo(hippoRoot, repo, days, label);
+            const { added, skipped } = learnFromRepo(hippoRoot, tenantId, repo, days, label);
             totalAdded += added;
             totalSkipped += skipped;
         }
         console.log(`Git learn complete: ${totalAdded} new lessons added, ${totalSkipped} duplicates skipped across ${repos.length} repos.`);
     }
     else {
-        const { added, skipped } = learnFromRepo(hippoRoot, process.cwd(), days);
+        const { added, skipped } = learnFromRepo(hippoRoot, tenantId, process.cwd(), days);
         console.log(`Git learn complete: ${added} new lessons added, ${skipped} duplicates skipped.`);
     }
 }
 // Import command
 /** The rows are saved either way; a failed backfill only delays vectors, so it warns with how many wait and the command that finishes them. */
-function warnBackfillFailed(root, embedCommand, err) {
+function warnBackfillFailed(ctx, embedCommand, err) {
     let waiting;
     try {
-        const vectors = loadEmbeddingIndex(root);
-        waiting = String(loadAllEntries(root).filter((entry) => !Object.hasOwn(vectors, entry.id)).length);
+        const { memoryIds, vectorIds } = embedCoverage(ctx);
+        const embedded = new Set(vectorIds);
+        waiting = String(memoryIds.filter((id) => !embedded.has(id)).length);
     }
     catch (countErr) {
         waiting = `an unknown number of (count failed: ${errorMessage(countErr)})`;
     }
     log.warn(`import: embedding backfill failed (${errorMessage(err)}); ${waiting} rows have no vector; run '${embedCommand}' to backfill`);
 }
+/** Batch-embed freshly imported rows. The floating promise is deliberate: libuv keeps the process alive until it settles, and awaiting
+ *  would block the CLI on model load; `hippo embed` is the backstop if interrupted. */
+function backfillVectors(ctx, embedCommand) {
+    void embedMissingMemories(ctx).catch((err) => warnBackfillFailed(ctx, embedCommand, err));
+}
 function warnRedacted(count) {
     if (count)
         printError(`Warning: secret-shaped text was redacted from ${count} imported ${count === 1 ? 'entry' : 'entries'} before storing`);
@@ -141,7 +145,7 @@ export function handleImport({ hippoRoot, tenantId, args, flags }) {
     // so the tenant is resolved and passed through. --global is unsupported (the connector raw-archive path is tenant-local).
     if (flags['vault'])
         return importVaultFolder(hippoRoot, tenantId, flags, importOptions, useGlobal, dryRun);
-    importFromFile(targetRoot, args, flags, { importOptions, useGlobal, dryRun });
+    importFromFile(targetRoot, args, flags, { importOptions, useGlobal, dryRun, tenantId });
 }
 // Determine which importer to use based on flag
 function pickImporter(args, flags) {
@@ -161,7 +165,7 @@ function pickImporter(args, flags) {
     return { filePath: undefined, importer: undefined, importerName: '' };
 }
 function importFromFile(targetRoot, args, flags, options) {
-    const { importOptions, useGlobal, dryRun } = options;
+    const { importOptions, useGlobal, dryRun, tenantId } = options;
     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]');
@@ -172,10 +176,9 @@ function importFromFile(targetRoot, args, flags, options) {
         throw new CliExit(1);
     }
     const result = importer(filePath, importOptions);
-    // Batch-embed newly imported rows in one pass (the importers' writeEntry sites don't embed). The floating promise is deliberate: libuv keeps the process
-    // alive until it settles; do not await it, that would block the CLI on model load. `hippo embed` is the backstop if interrupted.
+    // The importers' writeEntry sites don't embed, so the new rows are embedded here in one pass.
     if (!dryRun && result.imported >= 1) {
-        void embedAll(targetRoot).catch((err) => warnBackfillFailed(targetRoot, useGlobal ? 'hippo embed --global' : 'hippo embed', err));
+        backfillVectors(cliApiContext(targetRoot, tenantId), useGlobal ? 'hippo embed --global' : 'hippo embed');
     }
     const storeLabel = useGlobal ? `global (${getGlobalRoot()})` : targetRoot;
     printFileImportSummary(result, importerName, filePath, storeLabel, dryRun);
@@ -226,7 +229,7 @@ function importVaultFolder(hippoRoot, tenantId, flags, importOptions, useGlobal,
         scope: flags['scope'] ? String(flags['scope']) : undefined,
     };
     const vaultResult = importVault(folderPath, vaultOptions);
-    printVaultSummary(vaultResult, folderPath, hippoRoot, dryRun);
+    printVaultSummary(vaultResult, folderPath, cliApiContext(hippoRoot, tenantId), dryRun);
 }
 function checkVaultArgs(folderPath, flags, useGlobal) {
     if (!fs.existsSync(folderPath) || !fs.statSync(folderPath).isDirectory()) {
@@ -250,7 +253,7 @@ function checkVaultArgs(folderPath, flags, useGlobal) {
         throw new CliExit(1);
     }
 }
-function printVaultSummary(vaultResult, folderPath, hippoRoot, dryRun) {
+function printVaultSummary(vaultResult, folderPath, ctx, dryRun) {
     console.log(`\nImport Vault: ${folderPath}${dryRun ? ' (dry run - no writes)' : ''}`);
     console.log(`  Notes found:           ${vaultResult.total}`);
     console.log(`  ${dryRun ? 'Would import:         ' : 'Imported:             '}${vaultResult.imported}`);
@@ -260,12 +263,10 @@ function printVaultSummary(vaultResult, folderPath, hippoRoot, dryRun) {
     }
     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.
-    // The floating promise is deliberate; see the single-file site.
-    if (!dryRun && vaultResult.imported >= 1) {
-        void embedAll(hippoRoot).catch((err) => warnBackfillFailed(hippoRoot, 'hippo embed', err));
-    }
+    console.log(`  Store:                 ${ctx.hippoRoot}`);
+    // Vault rows write through api.remember, which never embeds, so backfill them as the single-file import does.
+    if (!dryRun && vaultResult.imported >= 1)
+        backfillVectors(ctx, 'hippo embed');
 }
 // Promote command
 function cmdPromote(hippoRoot, tenantId, id) {
@@ -296,7 +297,8 @@ export function handleSync({ hippoRoot, flags }) {
     // v39: other-project rows are skipped by default; secrets always are.
     const includeCrossProject = flagIsTrue(flags, 'cross-project');
     const count = syncGlobalToLocal(hippoRoot, globalRoot, { includeCrossProject });
-    console.log(`Synced ${count} global memories into local project.${includeCrossProject ? '' : ' (other-project rows skipped; use --cross-project to include them)'}`);
+    console.log(`Synced ${count} global memories into local project.${includeCrossProject ? '' : ' (other-project rows skipped; use --cross-project to ' +
+        'include them)'}`);
 }
 export async function handleWatch({ hippoRoot, tenantId, args }) {
     const watchCmd = args.join(' ').trim();
@@ -327,7 +329,7 @@ export async function handleShare({ hippoRoot, tenantId, args, flags }) {
     if (shareId === '--auto' || flags['auto']) {
         // Auto-share mode
         requireInit(hippoRoot);
-        const minScore = parseFloat(String(flags['min-score'] ?? '0.6'));
+        const minScore = numberFlag(flags, 'min-score') ?? AUTO_SHARE_MIN_SCORE;
         const dryRun = boolFlag(flags, 'dry-run');
         const results = autoShare(hippoRoot, { minScore, dryRun, tenantId });
         if (results.length === 0) {
@@ -393,7 +395,7 @@ export function handleExport({ hippoRoot, tenantId, args, flags }) {
     requireInit(hippoRoot);
     const format = String(flags['format'] || 'json');
     const outputPath = args[0] || null;
-    const entries = loadAllEntries(hippoRoot, tenantId);
+    const entries = listMemories(cliApiContext(hippoRoot, tenantId));
     let output;
     if (format === 'markdown' || format === 'md') {
         output = entries.map(e => {

package/dist/cli/usage.d.ts

@@ -3,83 +3,4 @@ export declare function printSlackBackfillUsage(): void;
 export declare function printSlackWorkspacesUsage(): void;
 export declare const USAGE_HEADER = "\nHippo - Make your agent's memory work like a brain. Hippo is long-term memory for coding agents.\n\nUsage: hippo <command> [options]\n\nCommands:";
 export declare const USAGE_EXAMPLES = "\n\nExamples:\n  hippo init\n  hippo remember \"FRED cache can silently drop series\" --tag error\n  hippo recall \"data pipeline issues\" --budget 2000\n  hippo context --auto --budget 1500\n  hippo conflicts\n  hippo reject mem_abc123 --reason \"leaked credential\"\n  hippo reject --value \"never store my key again\" --reason \"secret\"\n  hippo rejections\n  hippo unreject a1b2c3d4e5f6\n  hippo dormant \"staging hostname\"\n  hippo dormant restore mem_abc123\n  hippo tokens --days 7\n  hippo session log --id sess_123 --task \"Ship feature\" --type progress --content \"Build is green, next step is docs\"\n  hippo session latest --json\n  hippo session resume\n  hippo snapshot save --task \"Ship feature\" --summary \"Tests are green\" --next-step \"Open the PR\" --session sess_123\n  hippo handoff create --summary \"PR is open, tests green\" --next \"Merge after review\" --session sess_123 --artifact src/foo.ts\n  hippo handoff create --summary s --constraint a --constraint b --outcome partial --target-runtime codex --card-id c1 --tests pass\n  hippo card create --title \"Add cards table\" --repo hippo --depends-on card_abc\n  hippo card claim card_abc --runtime codex\n  hippo card complete card_abc --outcome success\n  hippo card heartbeat card_abc --run 7\n  hippo card reclaim\n  hippo embed --status\n  hippo watch \"npm run build\"\n  hippo learn --git --days 30\n  hippo promote mem_abc123\n  hippo sync\n  hippo setup\n  hippo hook install claude-code\n  hippo decide \"Use PostgreSQL for new services\" --context \"JSONB support\"\n  hippo incident \"Prod outage: DB connection pool exhausted\" --context \"spike at 14:00\"\n  hippo process new \"Release\" --step \"run tests\" --step \"bump version\" --step \"publish\"\n  hippo policy new \"Data retention\" --text \"Delete logs after 90 days\" --from 2026-01-01\n  hippo policy asof 2026-03-01 --name \"Data retention\"\n  hippo skill new \"Run tests\" --instructions \"npm test before every commit\" --trigger \"before commit\"\n  hippo skill export\n  hippo brief new \"hippo\" --summary \"Agent-memory library; E2 first-class objects in progress\"\n  hippo brief refresh \"hippo\"\n  hippo note new \"Acme Corp\" --text \"Renewal call: wants SSO before Q3; champion is the VP Eng\"\n  hippo note list --customer \"Acme Corp\" --status active\n  hippo graph extract\n  hippo invalidate \"REST API\" --dry-run\n  hippo invalidate \"REST API\" --reason \"migrated to GraphQL\"\n  hippo invalidate --id mem_a1b2c3d4e5f6 --reason \"superseded by new policy\"\n  hippo invalidate --churn --dry-run\n  hippo export memories.json\n  hippo export --format markdown memories.md\n  hippo sleep --dry-run\n  hippo outcome --good\n  hippo status\n";
-/** Each verb's help blocks for the command table, keyed like COMMANDS; a block opens with a newline. */
-export declare const VERB_USAGE: {
-    init: string[];
-    remember: string[];
-    recall: string[];
-    drill: string[];
-    assemble: string[];
-    supersede: string[];
-    explain: string[];
-    eval: string[];
-    trace: string[];
-    refine: string[];
-    sleep: string[];
-    'last-sleep': string[];
-    'session-end': string[];
-    'pre-compact': string[];
-    'post-compact': string[];
-    'capture-error': string[];
-    'compact-resume': string[];
-    'codex-run': string[];
-    dedup: string[];
-    dag: string[];
-    auth: string[];
-    goal: string[];
-    slack: string[];
-    github: string[];
-    audit: string[];
-    'correction-latency': string[];
-    provenance: string[];
-    status: string[];
-    outcome: string[];
-    conflicts: string[];
-    resolve: string[];
-    reject: string[];
-    rejections: string[];
-    unreject: string[];
-    dormant: string[];
-    projects: string[];
-    quarantine: string[];
-    tokens: string[];
-    failures: string[];
-    doctor: string[];
-    'support-bundle': string[];
-    snapshot: string[];
-    session: string[];
-    handoff: string[];
-    card: string[];
-    predict: string[];
-    current: string[];
-    forget: string[];
-    inspect: string[];
-    context: string[];
-    hook: string[];
-    setup: string[];
-    'daily-runner': string[];
-    embed: string[];
-    watch: string[];
-    learn: string[];
-    promote: string[];
-    sync: string[];
-    share: string[];
-    peers: string[];
-    import: string[];
-    export: string[];
-    capture: string[];
-    dashboard: string[];
-    wm: string[];
-    mcp: string[];
-    serve: string[];
-    invalidate: string[];
-    decide: string[];
-    incident: string[];
-    process: string[];
-    policy: string[];
-    skill: string[];
-    brief: string[];
-    note: string[];
-    graph: string[];
-};
 //# sourceMappingURL=usage.d.ts.map