hippo-memory 1.70.0 → 1.72.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