hippo-memory 1.71.0 → 2.0.0

package/dist/cli/verbs.d.ts

@@ -0,0 +1,81 @@
+export declare const COMMANDS: {
+    predict: import("./verb-row.js").VerbSpec;
+    decide: import("./verb-row.js").VerbSpec;
+    incident: import("./verb-row.js").VerbSpec;
+    process: import("./verb-row.js").VerbSpec;
+    policy: import("./verb-row.js").VerbSpec;
+    skill: import("./verb-row.js").VerbSpec;
+    brief: import("./verb-row.js").VerbSpec;
+    note: import("./verb-row.js").VerbSpec;
+    graph: import("./verb-row.js").VerbSpec;
+    invalidate: import("./verb-row.js").VerbSpec;
+    wm: import("./verb-row.js").VerbSpec;
+    dashboard: import("./verb-row.js").VerbSpec;
+    mcp: import("./verb-row.js").VerbSpec;
+    serve: import("./verb-row.js").VerbSpec;
+    goal: import("./verb-row.js").VerbSpec;
+    auth: import("./verb-row.js").VerbSpec;
+    snapshot: import("./verb-row.js").VerbSpec;
+    session: import("./verb-row.js").VerbSpec;
+    handoff: import("./verb-row.js").VerbSpec;
+    card: import("./verb-row.js").VerbSpec;
+    current: import("./verb-row.js").VerbSpec;
+    forget: import("./verb-row.js").VerbSpec;
+    inspect: import("./verb-row.js").VerbSpec;
+    embed: import("./verb-row.js").VerbSpec;
+    watch: import("./verb-row.js").VerbSpec;
+    learn: import("./verb-row.js").VerbSpec;
+    promote: import("./verb-row.js").VerbSpec;
+    share: import("./verb-row.js").VerbSpec;
+    peers: import("./verb-row.js").VerbSpec;
+    sync: import("./verb-row.js").VerbSpec;
+    import: import("./verb-row.js").VerbSpec;
+    export: import("./verb-row.js").VerbSpec;
+    capture: import("./verb-row.js").VerbSpec;
+    setup: import("./verb-row.js").VerbSpec;
+    'last-sleep': import("./verb-row.js").VerbSpec;
+    'session-end': import("./verb-row.js").VerbSpec;
+    '__session-end-worker': import("./verb-row.js").VerbSpec;
+    'pre-compact': import("./verb-row.js").VerbSpec;
+    'compact-resume': import("./verb-row.js").VerbSpec;
+    'post-compact': import("./verb-row.js").VerbSpec;
+    'codex-run': import("./verb-row.js").VerbSpec;
+    '__codex-session-end-worker': import("./verb-row.js").VerbSpec;
+    hook: import("./verb-row.js").VerbSpec;
+    status: import("./verb-row.js").VerbSpec;
+    audit: import("./verb-row.js").VerbSpec;
+    github: import("./verb-row.js").VerbSpec;
+    slack: import("./verb-row.js").VerbSpec;
+    provenance: import("./verb-row.js").VerbSpec;
+    dag: import("./verb-row.js").VerbSpec;
+    drill: import("./verb-row.js").VerbSpec;
+    assemble: import("./verb-row.js").VerbSpec;
+    'correction-latency': import("./verb-row.js").VerbSpec;
+    outcome: import("./verb-row.js").VerbSpec;
+    conflicts: import("./verb-row.js").VerbSpec;
+    resolve: import("./verb-row.js").VerbSpec;
+    reject: import("./verb-row.js").VerbSpec;
+    rejections: import("./verb-row.js").VerbSpec;
+    unreject: import("./verb-row.js").VerbSpec;
+    dormant: import("./verb-row.js").VerbSpec;
+    projects: import("./verb-row.js").VerbSpec;
+    quarantine: import("./verb-row.js").VerbSpec;
+    'capture-error': import("./verb-row.js").VerbSpec;
+    doctor: import("./verb-row.js").VerbSpec;
+    'support-bundle': import("./verb-row.js").VerbSpec;
+    tokens: import("./verb-row.js").VerbSpec;
+    failures: import("./verb-row.js").VerbSpec;
+    init: import("./verb-row.js").VerbSpec;
+    remember: import("./verb-row.js").VerbSpec;
+    supersede: import("./verb-row.js").VerbSpec;
+    recall: import("./verb-row.js").VerbSpec;
+    explain: import("./verb-row.js").VerbSpec;
+    trace: import("./verb-row.js").VerbSpec;
+    refine: import("./verb-row.js").VerbSpec;
+    eval: import("./verb-row.js").VerbSpec;
+    context: import("./verb-row.js").VerbSpec;
+    sleep: import("./verb-row.js").VerbSpec;
+    'daily-runner': import("./verb-row.js").VerbSpec;
+    dedup: import("./verb-row.js").VerbSpec;
+};
+//# sourceMappingURL=verbs.d.ts.map

package/dist/cli/verbs.js

@@ -0,0 +1,7 @@
+// Every CLI verb, one row each: dispatch, flags, help and the help listing's order all read this table.
+import { MEMORY_VERBS } from './verbs/memory.js';
+import { HEALTH_VERBS } from './verbs/health.js';
+import { SESSION_VERBS } from './verbs/sessions.js';
+import { OBJECT_VERBS } from './verbs/objects.js';
+export const COMMANDS = { ...MEMORY_VERBS, ...HEALTH_VERBS, ...SESSION_VERBS, ...OBJECT_VERBS };
+//# sourceMappingURL=verbs.js.map

package/dist/cli/versioned-verbs.d.ts

@@ -0,0 +1,51 @@
+import { type CliFlags, type CommandContext } from './flag-values.js';
+import { printLifecycleTail, type ObjectNames } from './object-verbs.js';
+type VersionedRow = Parameters<typeof printLifecycleTail>[0] & {
+    readonly id: number;
+    readonly version: number;
+};
+/** The predecessor a new version replaces, and the delta note it carries. */
+export interface Succession {
+    readonly id: number;
+    readonly changeSummary: string | undefined;
+}
+/** How one kind reads, saves and prints; `O` is its row, `S` its status, `B` the body flags a version is saved from. */
+export interface VersionedKind<O extends VersionedRow, S extends string, B> {
+    readonly names: ObjectNames;
+    readonly plural: string;
+    readonly states: ReadonlySet<S>;
+    /** Printed when `new` lacks its key or its body. */
+    readonly usage: readonly string[];
+    readonly supersedeUsage: string;
+    /** Named in the refusal of a supersede without a body: `requires <this> for the new version`. */
+    readonly bodyRequired: string;
+    /** The body of a new version, or undefined when its required flag is missing or blank. */
+    readonly body: (flags: CliFlags, verb: 'new' | 'supersede') => B | undefined;
+    /** What a new version keeps from the one it supersedes: the repo, customer or name. */
+    readonly keyOf: (o: O) => string;
+    readonly save: (key: string, body: B, extraTags: string[], from?: Succession) => O;
+    /** The first line `new` prints. */
+    readonly recorded: (o: O) => string;
+    readonly list: (opts: {
+        status?: S;
+        limit: number;
+    }, flags: CliFlags) => readonly O[];
+    readonly loadById: (id: number) => O | null;
+    readonly close: (id: number) => {
+        id: number;
+    };
+    readonly printRow: (o: O) => void;
+    /** The `get` lines between the header and the lifecycle tail. */
+    readonly printDetail: (o: O) => void;
+    /** A subcommand only this kind has. */
+    readonly extra?: {
+        readonly sub: string;
+        readonly run: (args: string[], flags: CliFlags) => void;
+    };
+}
+/** A flag that must carry text: its raw value, or undefined when absent or blank. */
+export declare function requiredText(flags: CliFlags, name: string): string | undefined;
+/** The `hippo <cmd>` handler for a kind; `kindAt` binds the descriptor to the store the command runs against. */
+export declare function versionedVerbs<O extends VersionedRow, S extends string, B>(kindAt: (hippoRoot: string, tenantId: string) => VersionedKind<O, S, B>): (ctx: CommandContext) => void;
+export {};
+//# sourceMappingURL=versioned-verbs.d.ts.map

package/dist/cli/versioned-verbs.js

@@ -0,0 +1,79 @@
+// One handler set for the kinds that evolve by supersession (brief, note, policy, process, skill), each driven by a descriptor.
+import { extractPathTags } from '../search/path-context.js';
+import { errorMessage } from '../util/log.js';
+import { printError } from './output.js';
+import { nonEmptyStringFlag, stringFlag } from './flag-values.js';
+import { requireInit } from './shared.js';
+import { closeObject, foundOrExit, idArgOrExit, listObjects, printLifecycleTail } from './object-verbs.js';
+import { CliExit } from './exit.js';
+/** A flag that must carry text: its raw value, or undefined when absent or blank. */
+export function requiredText(flags, name) {
+    const raw = stringFlag(flags, name);
+    return raw?.trim() ? raw : undefined;
+}
+/** The `hippo <cmd>` handler for a kind; `kindAt` binds the descriptor to the store the command runs against. */
+export function versionedVerbs(kindAt) {
+    return ({ hippoRoot, tenantId, args, flags }) => {
+        requireInit(hippoRoot);
+        const kind = kindAt(hippoRoot, tenantId);
+        const sub = args[0] ?? '';
+        if (sub === kind.extra?.sub)
+            return kind.extra.run(args, flags);
+        if (sub === 'list') {
+            return listObjects(flags, { plural: kind.plural, states: kind.states, load: (opts) => kind.list(opts, flags), printRow: kind.printRow });
+        }
+        if (sub === 'get')
+            return getVersion(kind, args);
+        if (sub === 'supersede')
+            return supersedeVersion(kind, args, flags);
+        if (sub === 'close')
+            return closeObject(args, kind.names, kind.close);
+        // Both `<cmd> new "<key>"` and the bare `<cmd> "<key>"` create.
+        createVersion(kind, sub === 'new' ? (args[1] ?? '') : sub, flags);
+    };
+}
+function getVersion(kind, args) {
+    const id = idArgOrExit(args, `Usage: hippo ${kind.names.cmd} get <id>`, kind.names.idLabel);
+    const o = foundOrExit(kind.loadById(id), kind.names.noun, id);
+    console.log(`${kind.names.noun} #${o.id}`);
+    kind.printDetail(o);
+    printLifecycleTail(o);
+}
+function createVersion(kind, key, flags) {
+    const body = key ? kind.body(flags, 'new') : undefined;
+    if (body === undefined) {
+        for (const line of kind.usage)
+            printError(line);
+        throw new CliExit(1);
+    }
+    const created = saveVersion(kind, key, body);
+    printSaved(kind.recorded(created), created);
+}
+function supersedeVersion(kind, args, flags) {
+    const id = idArgOrExit(args, kind.supersedeUsage, kind.names.idLabel);
+    const body = kind.body(flags, 'supersede');
+    if (body === undefined) {
+        printError(`hippo ${kind.names.cmd} supersede requires ${kind.bodyRequired} for the new version.`);
+        throw new CliExit(1);
+    }
+    // The lookup only gives a missing id its not-found line; the save's own preflight is the authoritative active-state check.
+    const existing = foundOrExit(kind.loadById(id), kind.names.noun, id);
+    const created = saveVersion(kind, kind.keyOf(existing), body, { id, changeSummary: nonEmptyStringFlag(flags, 'change') });
+    printSaved(`${kind.names.noun} #${created.id} recorded (v${created.version}), superseding #${id}.`, created);
+}
+/** Every kind's save goes through here, so a refused write always prints the store's message and exits 1. */
+function saveVersion(kind, key, body, from) {
+    try {
+        return kind.save(key, body, extractPathTags(process.cwd()), from);
+    }
+    catch (e) {
+        printError(errorMessage(e));
+        throw new CliExit(1);
+    }
+}
+function printSaved(line, o) {
+    console.log(line);
+    if (o.memoryId)
+        console.log(`  memory: ${o.memoryId}`);
+}
+//# sourceMappingURL=versioned-verbs.js.map

package/dist/cli.d.ts

@@ -1,284 +1,13 @@
 #!/usr/bin/env node
-import { type CliFlags, type CommandContext } from './cli/flag-values.js';
-import { type VerbFlags } from './cli/flags.js';
+import { type CliFlags } from './cli/flag-values.js';
 export declare function parseArgs(argv: string[]): {
     command: string;
     args: string[];
     flags: CliFlags;
 };
 export declare function shouldAutoRepairCodexWrapper(currentCommand: string, flags: CliFlags): boolean;
-/** What a verb's row states; its help blocks and flags are looked up by the row's key. */
-interface VerbHandler {
-    readonly run: (ctx: CommandContext) => void | Promise<void>;
-    readonly aliases?: readonly string[];
-    /** Runs in a request scope, opening each store once; set on api-backed verbs, as hook verbs open their own. */
-    readonly scoped?: true;
-}
-interface CommandSpec extends VerbHandler {
-    readonly usage: readonly string[];
-    /** The flags this verb reads; any other flag still parses, and the verb says it ignores it. */
-    readonly flags: VerbFlags;
-}
-/** Every verb main() dispatches, keyed by name; a verb without a VERB_FLAGS entry, or the reverse, fails to compile. */
-export declare const VERB_HANDLERS: {
-    init: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    remember: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    recall: {
-        run: (c: CommandContext) => Promise<void>;
-        scoped: true;
-    };
-    drill: {
-        run: (c: CommandContext) => Promise<void>;
-        scoped: true;
-    };
-    assemble: {
-        run: (c: CommandContext) => Promise<void>;
-        scoped: true;
-    };
-    supersede: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    explain: {
-        run: (c: CommandContext) => Promise<void>;
-        scoped: true;
-    };
-    eval: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    trace: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    refine: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    sleep: {
-        run: (c: CommandContext) => Promise<void>;
-        scoped: true;
-    };
-    'last-sleep': {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    'session-end': {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    '__session-end-worker': {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    'pre-compact': {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    'post-compact': {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    'capture-error': {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    'compact-resume': {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    'codex-run': {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    '__codex-session-end-worker': {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    dedup: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    dag: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    auth: {
-        run: (c: CommandContext) => Promise<void>;
-        scoped: true;
-    };
-    goal: {
-        run: (c: CommandContext) => Promise<void>;
-        scoped: true;
-    };
-    slack: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    github: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    audit: {
-        run: (c: CommandContext) => Promise<void>;
-        scoped: true;
-    };
-    'correction-latency': {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    provenance: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    status: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    outcome: {
-        run: (c: CommandContext) => Promise<void>;
-        scoped: true;
-    };
-    conflicts: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    resolve: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    reject: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    rejections: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    unreject: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    dormant: {
-        run: (c: CommandContext) => Promise<void>;
-        scoped: true;
-    };
-    projects: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    quarantine: {
-        run: (c: CommandContext) => Promise<void>;
-        scoped: true;
-    };
-    tokens: {
-        run: (c: CommandContext) => Promise<void>;
-        scoped: true;
-    };
-    failures: {
-        run: (c: CommandContext) => Promise<void>;
-        scoped: true;
-    };
-    doctor: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    'support-bundle': {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    snapshot: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    session: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    handoff: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    card: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    predict: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    current: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    forget: {
-        run: (c: CommandContext) => Promise<void>;
-        scoped: true;
-    };
-    inspect: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    context: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    hook: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    setup: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    'daily-runner': {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    embed: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    watch: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    learn: {
-        run: (c: CommandContext) => Promise<void>;
-        scoped: true;
-    };
-    promote: {
-        run: (c: CommandContext) => Promise<void>;
-        scoped: true;
-    };
-    sync: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    share: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    peers: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    import: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    export: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    capture: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    dashboard: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    wm: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    mcp: {
-        run: () => Promise<void>;
-    };
-    serve: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    invalidate: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    decide: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    incident: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    process: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    policy: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    skill: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-    brief: {
-        run: (c: CommandContext) => Promise<void>;
-        aliases: string[];
-    };
-    note: {
-        run: (c: CommandContext) => Promise<void>;
-        aliases: string[];
-    };
-    graph: {
-        run: (c: CommandContext) => Promise<void>;
-    };
-};
-/** Every verb's handler, aliases, help blocks and flags, keyed by name. */
-export declare const COMMANDS: Readonly<Record<"trace" | "session" | "capture" | "dormant" | "pre-compact" | "post-compact" | "session-end" | "outcome" | "eval" | "recall" | "conflicts" | "remember" | "promote" | "supersede" | "forget" | "quarantine" | "policy" | "status" | "hook" | "context" | "tokens" | "compact-resume" | "reject" | "mcp" | "note" | "snapshot" | "incident" | "process" | "skill" | "slack" | "github" | "failures" | "audit" | "embed" | "current" | "explain" | "auth" | "handoff" | "goal" | "inspect" | "sleep" | "dag" | "brief" | "graph" | "projects" | "doctor" | "init" | "drill" | "assemble" | "refine" | "last-sleep" | "__session-end-worker" | "capture-error" | "codex-run" | "__codex-session-end-worker" | "dedup" | "correction-latency" | "provenance" | "resolve" | "rejections" | "unreject" | "support-bundle" | "card" | "predict" | "setup" | "daily-runner" | "watch" | "learn" | "sync" | "share" | "peers" | "import" | "export" | "dashboard" | "wm" | "serve" | "invalidate" | "decide", CommandSpec>>;
 export declare function usageText(): string;
 /** One verb's help blocks as `hippo <verb> --help` prints them, or null for a verb with none. */
 export declare function verbUsage(verb: string): string | null;
 export declare function runCli(argv?: string[]): Promise<void>;
-export {};
 //# sourceMappingURL=cli.d.ts.map