hippo-memory 1.69.0 → 1.70.0

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

@@ -0,0 +1,40 @@
+import { type CliFlags } from './flag-values.js';
+/** The member of `states` named by `status`, or exit 1 with the message that lists every allowed value. */
+export declare function requireStatus<S extends string>(status: string, states: ReadonlySet<S>): S;
+/** `--status` checked against the kind's states; undefined when absent or `all`. */
+export declare function statusFilter<S extends string>(flags: CliFlags, states: ReadonlySet<S>): S | undefined;
+export interface ObjectListSpec<O, S extends string> {
+    readonly plural: string;
+    readonly states: ReadonlySet<S>;
+    readonly load: (opts: {
+        status?: S;
+        limit: number;
+    }) => readonly O[];
+    readonly printRow: (o: O) => void;
+}
+export declare function listObjects<O, S extends string>(flags: CliFlags, spec: ObjectListSpec<O, S>): void;
+/** The `<id>` after the subcommand; prints `usage` and exits 1 when it is missing. */
+export declare function idArgOrExit(args: string[], usage: string, label: string, parseId?: (raw: string, label: string) => number): number;
+export declare function foundOrExit<O>(found: O | null | undefined, noun: string, id: number): O;
+/** How a kind is named in usage lines (`cmd`), in messages (`noun`) and in the invalid-id error (`idLabel`). */
+export interface ObjectNames {
+    readonly cmd: string;
+    readonly noun: string;
+    readonly idLabel: string;
+}
+/** `hippo <cmd> close <id>` for a kind whose close call returns the closed row. */
+export declare function closeObject(args: string[], names: ObjectNames, close: (id: number) => {
+    id: number;
+}, parseId?: (raw: string, label: string) => number): void;
+interface LifecycleTail {
+    readonly changeSummary?: string | null;
+    readonly supersededBy: number | null;
+    readonly supersededAt?: string | null;
+    readonly closedAt?: string | null;
+    readonly memoryId?: string | null;
+    readonly createdAt: string;
+}
+/** The detail lines every `get` ends with. */
+export declare function printLifecycleTail(o: LifecycleTail): void;
+export {};
+//# sourceMappingURL=object-verbs.d.ts.map

package/dist/cli/object-verbs.js

@@ -0,0 +1,65 @@
+// The status, list, id and not-found paths the typed-object verbs (process, policy, skill, brief, note, decide, incident, predict) share.
+import { printError } from './output.js';
+import { parseListLimit, parsePositiveId, stringFlag } from './flag-values.js';
+/** The member of `states` named by `status`, or exit 1 with the message that lists every allowed value. */
+export function requireStatus(status, states) {
+    const found = [...states].find((s) => s === status);
+    if (found === undefined) {
+        printError(`Invalid --status: "${status}". Must be one of: ${[...states, 'all'].join(' | ')}.`);
+        process.exit(1);
+    }
+    return found;
+}
+/** `--status` checked against the kind's states; undefined when absent or `all`. */
+export function statusFilter(flags, states) {
+    const status = stringFlag(flags, 'status')?.trim() ?? 'all';
+    return status === 'all' ? undefined : requireStatus(status, states);
+}
+export function listObjects(flags, spec) {
+    const limit = parseListLimit(flags);
+    const status = statusFilter(flags, spec.states);
+    const results = spec.load(status === undefined ? { limit } : { status, limit });
+    if (results.length === 0) {
+        console.log(`No ${spec.plural}.`);
+        return;
+    }
+    console.log(`Found ${results.length} ${spec.plural}:\n`);
+    for (const o of results)
+        spec.printRow(o);
+}
+/** The `<id>` after the subcommand; prints `usage` and exits 1 when it is missing. */
+export function idArgOrExit(args, usage, label, parseId = parsePositiveId) {
+    const idRaw = args[1];
+    if (!idRaw) {
+        printError(usage);
+        process.exit(1);
+    }
+    return parseId(idRaw, label);
+}
+export function foundOrExit(found, noun, id) {
+    if (!found) {
+        printError(`${noun} ${id} not found.`);
+        process.exit(1);
+    }
+    return found;
+}
+/** `hippo <cmd> close <id>` for a kind whose close call returns the closed row. */
+export function closeObject(args, names, close, parseId = parsePositiveId) {
+    const id = idArgOrExit(args, `Usage: hippo ${names.cmd} close <id>`, names.idLabel, parseId);
+    console.log(`${names.noun} #${close(id).id} closed.`);
+}
+/** The detail lines every `get` ends with. */
+export function printLifecycleTail(o) {
+    if (o.changeSummary)
+        console.log(`  change_summary: ${o.changeSummary}`);
+    if (o.supersededBy !== null)
+        console.log(`  superseded_by: #${o.supersededBy}`);
+    if (o.supersededAt)
+        console.log(`  superseded_at: ${o.supersededAt}`);
+    if (o.closedAt)
+        console.log(`  closed_at: ${o.closedAt}`);
+    if (o.memoryId)
+        console.log(`  memory: ${o.memoryId}`);
+    console.log(`  created: ${o.createdAt}`);
+}
+//# sourceMappingURL=object-verbs.js.map

package/dist/{owner-validation.d.ts → cli/owner-validation.d.ts}

@@ -9,7 +9,6 @@
  * to reject + exit. Strict mode will become the default once real auth replaces
  * the stub (see `TODOS.md` for the migration path).
  */
-export declare const OWNER_RE: RegExp;
 export declare const OWNER_CONTRACT_HINT = "Must match ^(user|agent):[A-Za-z0-9_-]+$ (e.g. user:alice, agent:capture-bot).";
 export interface OwnerValidation {
     ok: boolean;

package/dist/{owner-validation.js → cli/owner-validation.js}

@@ -9,8 +9,8 @@
  * to reject + exit. Strict mode will become the default once real auth replaces
  * the stub (see `TODOS.md` for the migration path).
  */
-import { processEnv } from './env.js';
-export const OWNER_RE = /^(user|agent):[A-Za-z0-9_-]+$/;
+import { processEnv } from '../util/env.js';
+const OWNER_RE = /^(user|agent):[A-Za-z0-9_-]+$/;
 export const OWNER_CONTRACT_HINT = 'Must match ^(user|agent):[A-Za-z0-9_-]+$ (e.g. user:alice, agent:capture-bot).';
 /**
  * Pure validator. Returns `{ ok, value, message }`. Does NOT print or

package/dist/cli/playbooks.d.ts

@@ -1,4 +1,5 @@
-export declare function cmdProcess(hippoRoot: string, args: string[], flags: Record<string, string | boolean | string[]>): void;
-export declare function cmdPolicy(hippoRoot: string, args: string[], flags: Record<string, string | boolean | string[]>): void;
-export declare function cmdSkill(hippoRoot: string, args: string[], flags: Record<string, string | boolean | string[]>): void;
+import { type CliFlags } from './flag-values.js';
+export declare function cmdProcess(hippoRoot: string, args: string[], flags: CliFlags): void;
+export declare function cmdPolicy(hippoRoot: string, args: string[], flags: CliFlags): void;
+export declare function cmdSkill(hippoRoot: string, args: string[], flags: CliFlags): void;
 //# sourceMappingURL=playbooks.d.ts.map