hippo-memory 1.19.0 → 1.20.0

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAwBH,OAAO,EASL,WAAW,EAEZ,MAAM,aAAa,CAAC;AAiGrB,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AA2ChC,kFAAkF;AAClF,wBAAgB,8BAA8B,IAAI,IAAI,CAErD;AA60ED;;;GAGG;AACH,oHAAoH;AACpH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAkD/D;AAwnFD,oHAAoH;AACpH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,EACtF,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,MAAkB,GAC1B,IAAI,CA6BN"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAwBH,OAAO,EASL,WAAW,EAEZ,MAAM,aAAa,CAAC;AAiGrB,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AA4ChC,kFAAkF;AAClF,wBAAgB,8BAA8B,IAAI,IAAI,CAErD;AA60ED;;;GAGG;AACH,oHAAoH;AACpH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAkD/D;AAgsFD,oHAAoH;AACpH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,EACtF,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,MAAkB,GAC1B,IAAI,CA6BN"}

package/dist/cli.js

@@ -66,6 +66,7 @@ import * as skillsModule from './skills.js';
 import * as briefsModule from './project-briefs.js';
 import * as customerNotesModule from './customer-notes.js';
 import { extractGraph } from './graph-extract.js';
+import { buildGraphModel, renderGraphHtml, renderGraphCanvas, DEFAULT_VIEW_LIMIT } from './graph-view.js';
 import { createHash } from 'node:crypto';
 import { detectAnchoring, hashQueryText, buildSessionKey, getOrCreateRing, appendRecall, snapshotRing, } from './recall-history.js';
 import { detectAvailabilityBias } from './availability.js';
@@ -4522,7 +4523,7 @@ function noteUsage() {
     console.error('       hippo note supersede <id> --text "<note>" [--change "<summary>"]');
     console.error('       hippo note close <id>');
 }
-function cmdGraph(hippoRoot, args, _flags) {
+function cmdGraph(hippoRoot, args, flags) {
     requireInit(hippoRoot);
     const tenantId = resolveTenantId({});
     const subcommand = args[0] ?? '';
@@ -4538,7 +4539,75 @@ function cmdGraph(hippoRoot, args, _flags) {
         }
         return;
     }
-    console.error('Usage: hippo graph extract   (rebuild the entity/relation graph from consolidated decisions/policies/customer-notes/project-briefs)');
+    const entity = typeof flags['entity'] === 'string' ? flags['entity'] : undefined;
+    if (subcommand === 'show') {
+        const model = buildGraphModel(hippoRoot, tenantId, { entity, limit: DEFAULT_VIEW_LIMIT });
+        if (flags['json']) {
+            console.log(JSON.stringify(model, null, 2));
+            return;
+        }
+        if (model.nodes.length === 0) {
+            console.log(entity ? `No entity named "${entity}".` : 'Graph is empty. Run `hippo graph extract` first.');
+            return;
+        }
+        console.log(`Graph: ${model.nodes.length} entities, ${model.edges.length} relations${model.truncated ? ' (truncated)' : ''}`);
+        const byType = new Map();
+        for (const n of model.nodes) {
+            const arr = byType.get(n.type) ?? [];
+            arr.push({ id: n.id, name: n.name });
+            byType.set(n.type, arr);
+        }
+        for (const [type, ns] of byType) {
+            console.log(`\n${type} (${ns.length}):`);
+            for (const n of ns)
+                console.log(`  [${n.id}] ${n.name}`);
+        }
+        if (model.edges.length > 0) {
+            const nameById = new Map(model.nodes.map((n) => [n.id, n.name]));
+            console.log('\nrelations:');
+            for (const e of model.edges) {
+                console.log(`  ${nameById.get(e.from)} --${e.relType}--> ${nameById.get(e.to)}`);
+            }
+        }
+        return;
+    }
+    if (subcommand === 'view') {
+        const format = typeof flags['format'] === 'string' ? flags['format'] : 'html';
+        if (format !== 'html' && format !== 'canvas') {
+            console.error("graph view: --format must be 'html' or 'canvas'");
+            process.exit(1);
+        }
+        const model = buildGraphModel(hippoRoot, tenantId, { entity, limit: DEFAULT_VIEW_LIMIT });
+        const content = format === 'canvas' ? renderGraphCanvas(model) : renderGraphHtml(model);
+        const defaultOut = format === 'canvas' ? 'hippo-graph.canvas' : 'hippo-graph.html';
+        const out = typeof flags['out'] === 'string' ? flags['out'] : defaultOut;
+        fs.writeFileSync(out, content, 'utf8');
+        console.log(`Wrote ${model.nodes.length} entities + ${model.edges.length} relations to ${out}${model.truncated ? ' (truncated)' : ''}`);
+        if (flags['open'] && format === 'html') {
+            // Best-effort browser launch; never fail the command if it doesn't work.
+            try {
+                const [cmd, cmdArgs] = process.platform === 'win32'
+                    ? ['cmd', ['/c', 'start', '', out]]
+                    : process.platform === 'darwin'
+                        ? ['open', [out]]
+                        : ['xdg-open', [out]];
+                const child = spawn(cmd, cmdArgs, { detached: true, stdio: 'ignore' });
+                // A missing launcher (e.g. xdg-open absent) emits 'error' asynchronously;
+                // an unhandled 'error' event would throw, so swallow it — the file is
+                // already written and its path printed above.
+                child.on('error', () => { });
+                child.unref();
+            }
+            catch {
+                /* ignore — the file is written; the path is printed above */
+            }
+        }
+        return;
+    }
+    console.error('Usage:\n' +
+        '  hippo graph extract                     Rebuild the entity/relation graph from consolidated objects\n' +
+        '  hippo graph show [--entity NAME] [--json]   Inspect entities + their edges (text or JSON)\n' +
+        '  hippo graph view [--out FILE] [--open] [--format html|canvas] [--entity NAME]   Generate an interactive node-link diagram');
     process.exit(1);
 }
 function cmdCustomerNote(hippoRoot, args, flags) {