hippo-memory 1.69.0 → 1.70.0

package/dist/cli/dag.js

@@ -1,14 +1,22 @@
 // DAG summary verbs: `hippo dag`, `hippo assemble` and `hippo drill`.
 import { loadAllEntries } from '../store/entry-reads.js';
-import * as api from '../api.js';
-import { resolveTenantId } from '../tenant.js';
-import { assembleCost, assembleHeading, drillCost, settleTokens } from '../context-render.js';
+import * as api from '../api/index.js';
+import { resolveTenantId } from '../store/tenant.js';
+import { assembleCost, assembleHeading, drillCost, settleTokens } from '../api/context-render.js';
 import { printError } from './output.js';
-import { parseBudgetFlag, requireInit, captureConsole } from './shared.js';
+import { parseBudgetFlag, flagIsTrue, stringFlag, numberFlag } from './flag-values.js';
+import { requireInit } from './shared.js';
+import { captureConsole } from './print.js';
+import { CONTENT_PREVIEW_CHARS } from '../util/token-text.js';
+const TREE_CHILD_PREVIEW_CHARS = 70;
+const TREE_LEAF_PREVIEW_CHARS = 60;
+const DAG_HEAD_CHARS = 120;
+const DAG_SUMMARY_PREVIEW_CHARS = 200;
+const DAG_CHILD_PREVIEW_CHARS = 100;
 export function cmdDag(hippoRoot, flags) {
     requireInit(hippoRoot);
     const entries = loadAllEntries(hippoRoot);
-    const isStats = flags['stats'] === true;
+    const isStats = flagIsTrue(flags, 'stats');
     const byLevel = new Map();
     let unlinked = 0;
     for (const entry of entries) {
@@ -18,14 +26,20 @@ export function cmdDag(hippoRoot, flags) {
             unlinked++;
     }
     if (isStats) {
-        console.log('DAG Structure:');
-        console.log(`  Level 3 (entity profiles):  ${byLevel.get(3) ?? 0}`);
-        console.log(`  Level 2 (topic summaries):  ${byLevel.get(2) ?? 0}`);
-        console.log(`  Level 1 (extracted facts):  ${byLevel.get(1) ?? 0}`);
-        console.log(`  Level 0 (raw memories):     ${byLevel.get(0) ?? 0}`);
-        console.log(`  Unlinked facts: ${unlinked}`);
+        printDagStats(byLevel, unlinked);
         return;
     }
+    printDagTree(entries);
+}
+function printDagStats(byLevel, unlinked) {
+    console.log('DAG Structure:');
+    console.log(`  Level 3 (entity profiles):  ${byLevel.get(3) ?? 0}`);
+    console.log(`  Level 2 (topic summaries):  ${byLevel.get(2) ?? 0}`);
+    console.log(`  Level 1 (extracted facts):  ${byLevel.get(1) ?? 0}`);
+    console.log(`  Level 0 (raw memories):     ${byLevel.get(0) ?? 0}`);
+    console.log(`  Unlinked facts: ${unlinked}`);
+}
+function printDagTree(entries) {
     // Tree view: L3 entity profiles as roots with L2 children indented, then orphan L2 summaries at top level.
     const profiles = entries.filter((e) => e.dag_level === 3);
     const l2List = entries.filter((e) => e.dag_level === 2);
@@ -45,48 +59,46 @@ export function cmdDag(hippoRoot, flags) {
     // L3 entity profiles as tree roots with their L2 children.
     for (const profile of profiles) {
         const profileTags = profile.tags.filter((t) => t !== 'dag-entity-profile').join(', ');
-        console.log(`\n🌲 ${profile.content.slice(0, 80)}`);
+        console.log(`\n🌲 ${profile.content.slice(0, CONTENT_PREVIEW_CHARS)}`);
         if (profileTags)
             console.log(`   [${profileTags}]`);
         const l2Children = childL2ByProfile.get(profile.id) ?? [];
         for (const l2 of l2Children) {
             const l2Tags = l2.tags.filter((t) => t !== 'dag-summary').join(', ');
-            console.log(`   └─ 📌 ${l2.content.slice(0, 70)}`);
+            console.log(`   └─ 📌 ${l2.content.slice(0, TREE_CHILD_PREVIEW_CHARS)}`);
             if (l2Tags)
                 console.log(`      [${l2Tags}]`);
             const facts = entries.filter((e) => e.dag_parent_id === l2.id);
             for (const f of facts) {
-                console.log(`      └─ ${f.content.slice(0, 60)}`);
+                console.log(`      └─ ${f.content.slice(0, TREE_LEAF_PREVIEW_CHARS)}`);
             }
         }
     }
     // Orphan L2 summaries (no L3 parent) at top level.
     for (const summary of orphanL2) {
         const summaryTags = summary.tags.filter((t) => t !== 'dag-summary').join(', ');
-        console.log(`\n📌 ${summary.content.slice(0, 80)}`);
+        console.log(`\n📌 ${summary.content.slice(0, CONTENT_PREVIEW_CHARS)}`);
         if (summaryTags)
             console.log(`   [${summaryTags}]`);
         const children = entries.filter((e) => e.dag_parent_id === summary.id);
         for (const child of children) {
-            console.log(`   └─ ${child.content.slice(0, 70)}`);
+            console.log(`   └─ ${child.content.slice(0, TREE_CHILD_PREVIEW_CHARS)}`);
         }
     }
 }
-function cmdAssemble(hippoRoot, sessionId, flags) {
+async function cmdAssemble(hippoRoot, sessionId, flags) {
     requireInit(hippoRoot);
     // Absent stays undefined so the api default applies; the 0 fallback is unreachable.
     const budget = flags['budget'] === undefined ? undefined : parseBudgetFlag(flags['budget'], 0);
-    const freshTailCount = typeof flags['fresh-tail'] === 'string' ? Number(flags['fresh-tail']) : undefined;
+    const freshTailCount = numberFlag(flags, 'fresh-tail');
     const summarizeOlder = flags['no-summarize-older'] !== true;
-    const scope = typeof flags['scope'] === 'string' && flags['scope'].length > 0
-        ? flags['scope']
-        : undefined;
+    const scope = stringFlag(flags, 'scope') || undefined;
     const ctx = {
         hippoRoot,
         tenantId: resolveTenantId({}),
         actor: api.adminActor('cli:assemble'),
     };
-    const r = api.assemble(ctx, sessionId, {
+    const r = await api.assemble(ctx, sessionId, {
         ...(Number.isFinite(budget) && budget > 0 ? { budget } : {}),
         ...(Number.isFinite(freshTailCount) && freshTailCount >= 0 ? { freshTailCount } : {}),
         summarizeOlder,
@@ -101,18 +113,18 @@ function cmdAssemble(hippoRoot, sessionId, flags) {
         console.log(assembleHeading({ ...r, items: r.items.length, tokens: t }));
         for (const it of r.items) {
             const prefix = it.isSummary ? '[summary]' : it.isFreshTail ? '[tail]' : '[older]';
-            const head = it.content.slice(0, 120);
+            const head = it.content.slice(0, DAG_HEAD_CHARS);
             console.log(`  ${prefix} ${it.createdAt} ${it.id} \u2014 ${head}${it.content.length > 120 ? '…' : ''}`);
         }
     })));
 }
-function cmdDrillDown(hippoRoot, summaryId, flags) {
+async function cmdDrillDown(hippoRoot, summaryId, flags) {
     requireInit(hippoRoot);
-    const limit = typeof flags['limit'] === 'string' ? Number(flags['limit']) : undefined;
+    const limit = numberFlag(flags, 'limit');
     // Absent stays undefined so the api default applies; the 0 fallback is unreachable.
     const budget = flags['budget'] === undefined ? undefined : parseBudgetFlag(flags['budget'], 0);
     // --depth N walks N levels down (default 1, hard cap 10); out-of-range is rejected, never silently clamped.
-    const rawDepth = typeof flags['depth'] === 'string' ? Number(flags['depth']) : undefined;
+    const rawDepth = numberFlag(flags, 'depth');
     let depth;
     if (rawDepth !== undefined) {
         if (!Number.isInteger(rawDepth) || rawDepth < 1 || rawDepth > 10) {
@@ -126,7 +138,7 @@ function cmdDrillDown(hippoRoot, summaryId, flags) {
         tenantId: resolveTenantId({}),
         actor: api.adminActor('cli:drill'),
     };
-    const r = api.drillDown(ctx, summaryId, {
+    const r = await api.drillDown(ctx, summaryId, {
         ...(Number.isFinite(limit) && limit > 0 ? { limit } : {}),
         ...(Number.isFinite(budget) && budget > 0 ? { budget } : {}),
         ...(depth !== undefined ? { depth } : {}),
@@ -148,26 +160,26 @@ function cmdDrillDown(hippoRoot, summaryId, flags) {
         return;
     }
     console.log(`Summary ${r.summary.id} — ${r.summary.descendantCount} descendants${r.summary.earliestAt ? ` (${r.summary.earliestAt} → ${r.summary.latestAt})` : ''}`);
-    console.log(`  ${r.summary.content.slice(0, 200)}${r.summary.content.length > 200 ? '…' : ''}`);
+    console.log(`  ${r.summary.content.slice(0, DAG_SUMMARY_PREVIEW_CHARS)}${r.summary.content.length > DAG_SUMMARY_PREVIEW_CHARS ? '…' : ''}`);
     console.log(`\nChildren (${r.children.length}/${r.totalChildren}${r.truncated ? ', truncated' : ''}):`);
     for (const c of r.children) {
-        console.log(`  [L${c.dagLevel}] ${c.id} — ${c.content.slice(0, 100)}${c.content.length > 100 ? '…' : ''}`);
+        console.log(`  [L${c.dagLevel}] ${c.id} — ${c.content.slice(0, DAG_CHILD_PREVIEW_CHARS)}${c.content.length > DAG_CHILD_PREVIEW_CHARS ? '…' : ''}`);
     }
 }
-export function handleDrill({ hippoRoot, args, flags }) {
+export async function handleDrill({ hippoRoot, args, flags }) {
     const summaryId = args[0];
     if (!summaryId) {
         printError('Usage: hippo drill <summary-id> [--limit N] [--budget N]');
         process.exit(1);
     }
-    cmdDrillDown(hippoRoot, summaryId, flags);
+    await cmdDrillDown(hippoRoot, summaryId, flags);
 }
-export function handleAssemble({ hippoRoot, args, flags }) {
-    const sessionId = typeof flags['session'] === 'string' ? flags['session'] : args[0];
+export async function handleAssemble({ hippoRoot, args, flags }) {
+    const sessionId = stringFlag(flags, 'session') ?? args[0];
     if (!sessionId) {
         printError('Usage: hippo assemble --session <id> [--budget N] [--fresh-tail N] [--no-summarize-older] [--json]');
         process.exit(1);
     }
-    cmdAssemble(hippoRoot, sessionId, flags);
+    await cmdAssemble(hippoRoot, sessionId, flags);
 }
 //# sourceMappingURL=dag.js.map

package/dist/cli/decisions.d.ts

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