hippo-memory 2.0.0 → 2.1.0

package/dist/graph/stream.js

@@ -9,7 +9,10 @@ export const DEFAULT_GRAPH_SEED_COUNT = 10;
 /** Recommended RRF weight for the graph stream — a CLI-only convenience default. The
  *  library `graphStream.weight` option stays REQUIRED (opt-in is explicit). */
 export const DEFAULT_GRAPH_STREAM_WEIGHT = 0.5;
-/** Pick the top `seedCount` candidates by best lexical rank (lowest position across BM25 and dense), strength = 1/(bestRank + 1). Pure. */
+/**
+ * Pick the top `seedCount` candidates by best lexical rank (lowest position across BM25 and dense), strength =
+ * 1/(bestRank + 1). Pure.
+ */
 export function selectGraphSeeds(bm25Ranked, cosineRanked, seedCount) {
     if (seedCount <= 0)
         return [];
@@ -29,7 +32,8 @@ export function selectGraphSeeds(bm25Ranked, cosineRanked, seedCount) {
         .slice(0, seedCount)
         .map(([index, best]) => ({ index, strength: 1 / (best + 1) }));
 }
-// Pass 1: take the STRONGEST reaching-seed strength per new neighbour across ALL relations at this depth before committing any to `visited`;
+// Pass 1: take the STRONGEST reaching-seed strength per new neighbour across ALL relations at this depth before
+// committing any to `visited`;
 // marking mid-loop would lock a node to whichever relation SQLite returned first and drop a stronger seed's later edge.
 function bestStrengthAtDepth(rels, frontierSet, visited, frontierStrength, originStrength) {
     const bestStrengthThisDepth = new Map();
@@ -91,8 +95,12 @@ function reachedEntityScores(root, tenantId, seedIds, originStrength, options) {
     }
     return reachedScore;
 }
-/** Accumulate per-entryIndex graph-proximity scores from ONE store's graph into `graphScore`; only seeds whose entities live in THIS store are expanded.
- *  A neighbour's score = originSeedStrength x decay^(graph distance); the seed strength is carried unchanged along each BFS path. */
+/**
+ * Accumulate per-entryIndex graph-proximity scores from ONE store's graph into `graphScore`; only seeds whose entities
+ * live in THIS store are expanded.
+ * A neighbour's score = originSeedStrength x decay^(graph distance); the seed strength is carried unchanged along each
+ * BFS path.
+ */
 function accumulateForRoot(root, seeds, entries, options) {
     const { memIdToIndex, graphScore, hops, decay, maxNeighbors, tenantId } = options;
     if (seeds.length === 0)
@@ -107,7 +115,8 @@ function accumulateForRoot(root, seeds, entries, options) {
     const seedEntities = loadEntitiesByMemoryId(root, tenantId, [...strengthByMemId.keys()]);
     if (seedEntities.length === 0)
         return;
-    // entityId -> origin seed strength. Seeds load by memory id so memoryId is non-null here; the guard keeps the widened (string | null) type honest.
+    // entityId -> origin seed strength. Seeds load by memory id so memoryId is non-null here; the guard keeps the widened
+    // (string | null) type honest.
     const originStrength = new Map();
     for (const e of seedEntities) {
         if (e.memoryId === null)
@@ -132,8 +141,12 @@ function accumulateForRoot(root, seeds, entries, options) {
         graphScore.set(idx, Math.max(graphScore.get(idx) ?? 0, score));
     }
 }
-/** Produce the graph-retrieval ranked list: `entries[]` indices by graph proximity (desc) to the lexical `seeds`; absent indices fall to rrfFuse absentRank.
- *  Returns `[]` when there are no seeds/entries, the graph is empty, or nothing reached is in-pool, so the caller skips the 3rd fusion list. */
+/**
+ * Produce the graph-retrieval ranked list: `entries[]` indices by graph proximity (desc) to the lexical `seeds`; absent
+ * indices fall to rrfFuse absentRank.
+ * Returns `[]` when there are no seeds/entries, the graph is empty, or nothing reached is in-pool, so the caller skips
+ * the 3rd fusion list.
+ */
 export function graphRankStream(entries, seeds, opts) {
     if (seeds.length === 0 || entries.length === 0)
         return [];
@@ -148,10 +161,19 @@ export function graphRankStream(entries, seeds, opts) {
         ? [opts.hippoRoot, opts.globalRoot]
         : [opts.hippoRoot];
     for (const root of roots) {
-        accumulateForRoot(root, seeds, entries, { memIdToIndex, graphScore, hops, decay, maxNeighbors, tenantId: opts.tenantId });
+        accumulateForRoot(root, seeds, entries, {
+            memIdToIndex,
+            graphScore,
+            hops,
+            decay,
+            maxNeighbors,
+            tenantId: opts.tenantId,
+        });
     }
-    // Seed-exclusion guard: graphScore is keyed by entryIndex across roots but each root's visited-set is per-root, so a seed in one store
-    // could score as a neighbour in the other; drop every seed index so "seeds are never graph-scored" holds across roots.
+    // Seed-exclusion guard: graphScore is keyed by entryIndex across roots but each root's visited-set is per-root, so a
+    // seed in one store
+    // could score as a neighbour in the other; drop every seed index so "seeds are never graph-scored" holds across
+    // roots.
     for (const s of seeds)
         graphScore.delete(s.index);
     if (graphScore.size === 0)

package/dist/graph/view.d.ts

@@ -1,4 +1,6 @@
-/** Graph observability and visualization, READ-ONLY over the entity/relation graph (no writes, so `scripts/check-graph-writes.mjs` stays green).
+/**
+ * Graph observability and visualization, READ-ONLY over the entity/relation graph (no writes, so
+ * `scripts/check-graph-writes.mjs` stays green).
  *  Shared by `hippo graph show|view` and the HTTP `GET /v1/graph` route, which all build the same `GraphModel`. */
 import type { GraphRows } from '../store/port.js';
 import type { EntityType, RelationType } from '../store/graph-rows.js';
@@ -21,7 +23,9 @@ export interface GraphModel {
 }
 /** Default bound for the CLI viewer / show so an unbounded set is never laid out. */
 export declare const DEFAULT_VIEW_LIMIT = 500;
-/** Build the view-model (reads only); with `opts.entity`, a focus subgraph of the entities named so plus their 1-hop neighbours.
+/**
+ * Build the view-model (reads only); with `opts.entity`, a focus subgraph of the entities named so plus their 1-hop
+ * neighbours.
  *  Dangling edges (an endpoint outside the node set) are always dropped. */
 export declare function buildGraphModel(hippoRoot: string, tenantId: string, opts?: {
     entity?: string;
@@ -30,7 +34,9 @@ export declare function buildGraphModel(hippoRoot: string, tenantId: string, opt
 }): GraphModel;
 /** The reply model of the rows a store read: an edge with an endpoint outside the node set is dropped. */
 export declare function graphModelOf({ entities, relations, truncated }: GraphRows): GraphModel;
-/** Deterministic Fruchterman-Reingold-style force layout: seeded circular init, fixed iterations, no `Math.random`, so one model gives the same positions.
+/**
+ * Deterministic Fruchterman-Reingold-style force layout: seeded circular init, fixed iterations, no `Math.random`, so
+ * one model gives the same positions.
  *  Non-finite coordinates are clamped to the viewport centre and all positions to the bounds. */
 export declare function layoutGraph(model: GraphModel, opts?: {
     width?: number;
@@ -42,9 +48,16 @@ export declare function layoutGraph(model: GraphModel, opts?: {
 }>;
 /** HTML-escape for SVG text / title / markup content (XSS guard). */
 export declare function escapeHtml(s: string): string;
-/** Render the model as a self-contained, offline interactive HTML node-link diagram with server-side deterministic positions.
- *  The model is inlined as `<script type="application/json">` with `<`, `>`, `&` unicode-escaped so a `</script>` in an entity name cannot break out. */
+/**
+ * Render the model as a self-contained, offline interactive HTML node-link diagram with server-side deterministic
+ * positions.
+ * The model is inlined as `<script type="application/json">` with `<`, `>`, `&` unicode-escaped so a `</script>` in an
+ * entity name cannot break out.
+ */
 export declare function renderGraphHtml(model: GraphModel): string;
-/** Render the model as a JSON Canvas (jsoncanvas.org) document: `text` nodes at the same deterministic layout positions, `edges[]` linking them by id. */
+/**
+ * Render the model as a JSON Canvas (jsoncanvas.org) document: `text` nodes at the same deterministic layout positions,
+ * `edges[]` linking them by id.
+ */
 export declare function renderGraphCanvas(model: GraphModel): string;
 //# sourceMappingURL=view.d.ts.map

package/dist/graph/view.js

@@ -1,4 +1,6 @@
-/** Graph observability and visualization, READ-ONLY over the entity/relation graph (no writes, so `scripts/check-graph-writes.mjs` stays green).
+/**
+ * Graph observability and visualization, READ-ONLY over the entity/relation graph (no writes, so
+ * `scripts/check-graph-writes.mjs` stays green).
  *  Shared by `hippo graph show|view` and the HTTP `GET /v1/graph` route, which all build the same `GraphModel`. */
 import { withGraphReadSnapshot } from '../store/graph-reads.js';
 import { graphViewRows } from '../store/graph-view-rows.js';
@@ -6,7 +8,9 @@ const DEFAULT_LAYOUT_ITERATIONS = 300;
 const NODE_LABEL_MAX_CHARS = 22;
 /** Default bound for the CLI viewer / show so an unbounded set is never laid out. */
 export const DEFAULT_VIEW_LIMIT = 500;
-/** Build the view-model (reads only); with `opts.entity`, a focus subgraph of the entities named so plus their 1-hop neighbours.
+/**
+ * Build the view-model (reads only); with `opts.entity`, a focus subgraph of the entities named so plus their 1-hop
+ * neighbours.
  *  Dangling edges (an endpoint outside the node set) are always dropped. */
 export function buildGraphModel(hippoRoot, tenantId, opts = {}) {
     const limit = opts.limit ?? DEFAULT_VIEW_LIMIT;
@@ -94,7 +98,9 @@ function applyDisplacement(nodes, pos, disp, temp, width, height) {
         p.y = Math.max(20, Math.min(height - 20, ny));
     });
 }
-/** Deterministic Fruchterman-Reingold-style force layout: seeded circular init, fixed iterations, no `Math.random`, so one model gives the same positions.
+/**
+ * Deterministic Fruchterman-Reingold-style force layout: seeded circular init, fixed iterations, no `Math.random`, so
+ * one model gives the same positions.
  *  Non-finite coordinates are clamped to the viewport centre and all positions to the bounds. */
 export function layoutGraph(model, opts = {}) {
     const width = opts.width ?? LAYOUT_W;
@@ -143,25 +149,36 @@ const CLIENT_JS = [
     "  var vb=svg.getAttribute('viewBox').split(' ').map(Number);",
     "  var view={x:vb[0],y:vb[1],w:vb[2],h:vb[3]};",
     "  function apply(){svg.setAttribute('viewBox',view.x+' '+view.y+' '+view.w+' '+view.h);}",
-    "  var panning=false,sx=0,sy=0;",
-    "  svg.addEventListener('mousedown',function(e){if(e.target.closest('.node'))return;panning=true;sx=e.clientX;sy=e.clientY;});",
+    '  var panning=false,sx=0,sy=0;',
+    '  ' +
+        "svg.addEventListener('mousedown',function(e){" +
+        "if(e.target.closest('.node'))return;panning=true;sx=e.clientX;sy=e.clientY;});",
     "  window.addEventListener('mouseup',function(){panning=false;});",
     "  window.addEventListener('mousemove',function(e){if(!panning)return;var r=svg.getBoundingClientRect();var " +
         "k=view.w/r.width;view.x-=(e.clientX-sx)*k;view.y-=(e.clientY-sy)*k;sx=e.clientX;sy=e.clientY;apply();});",
-    "  svg.addEventListener('wheel',function(e){e.preventDefault();var r=svg.getBoundingClientRect();var mx=view.x+(e.clientX-r.left)/r.width*view.w;var " +
-        "my=view.y+(e.clientY-r.top)/r.height*view.h;var " +
-        "f=e.deltaY<0?0.9:1.1;view.x=mx-(mx-view.x)*f;view.y=my-(my-view.y)*f;view.w*=f;view.h*=f;apply();},{passive:false});",
+    "  svg.addEventListener('wheel',function(e){e.preventDefault();var r=svg.getBoundingClientRect();var " +
+        "mx=view.x+(e.clientX-r.left)/r.width*view.w;var " +
+        'my=view.y+(e.clientY-r.top)/r.height*view.h;var ' +
+        'f=e.deltaY<0?0.9:1.1;view.x=mx-(mx-view.x)*f;view.y=my-(my-view.y)*f;' +
+        'view.w*=f;view.h*=f;apply();},{passive:false});',
     "  var data={};try{data=JSON.parse(document.getElementById('graph-data').textContent);}",
     "  catch(e){console.error('hippo graph: embedded model is not valid JSON',e);}",
-    "  var adj={};(data.edges||[]).forEach(function(e){(adj[e.from]=adj[e.from]||[]).push(e.to);(adj[e.to]=adj[e.to]||[]).push(e.from);});",
-    "  var active=null;",
-    "  document.querySelectorAll('.node').forEach(function(g){g.addEventListener('click',function(ev){ev.stopPropagation();var " +
+    '  var ' +
+        'adj={};(data.edges||[]).forEach(function(e){' +
+        '(adj[e.from]=adj[e.from]||[]).push(e.to);(adj[e.to]=adj[e.to]||[]).push(e.from);});',
+    '  var active=null;',
+    '  ' +
+        "document.querySelectorAll('.node').forEach(function(g){" +
+        "g.addEventListener('click',function(ev){ev.stopPropagation();var " +
         "id=g.getAttribute('data-id');if(active===id){clearHi();active=null;return;}active=id;highlight(id);});});",
     "  svg.addEventListener('click',function(){clearHi();active=null;});",
-    "  function clearHi(){svg.classList.remove('focused');document.querySelectorAll('.hi').forEach(function(el){el.classList.remove('hi');});}",
+    '  function ' +
+        "clearHi(){svg.classList.remove('focused');" +
+        "document.querySelectorAll('.hi').forEach(function(el){el.classList.remove('hi');});}",
     "  function highlight(id){clearHi();svg.classList.add('focused');var " +
         "keep={};keep[id]=1;(adj[id]||[]).forEach(function(n){keep[n]=1;});document.querySelectorAll('.node').forEach(" +
-        "function(g){if(keep[g.getAttribute('data-id')])g.classList.add('hi');});document.querySelectorAll('.edge').forEach(" +
+        "function(g){if(keep[g.getAttribute('data-id')])g.classList.add('hi');" +
+        "});document.querySelectorAll('.edge').forEach(" +
         "function(l){if(l.getAttribute('data-from')===id||l.getAttribute('data-to')===id)l.classList.add('hi');});}",
     "})();",
 ].join("\n");
@@ -222,8 +239,12 @@ function renderLegend(model) {
         .map((t) => `<span style="color:${nodeColor(t)}">●</span> ${escapeHtml(t)}`)
         .join('  ');
 }
-/** Render the model as a self-contained, offline interactive HTML node-link diagram with server-side deterministic positions.
- *  The model is inlined as `<script type="application/json">` with `<`, `>`, `&` unicode-escaped so a `</script>` in an entity name cannot break out. */
+/**
+ * Render the model as a self-contained, offline interactive HTML node-link diagram with server-side deterministic
+ * positions.
+ * The model is inlined as `<script type="application/json">` with `<`, `>`, `&` unicode-escaped so a `</script>` in an
+ * entity name cannot break out.
+ */
 export function renderGraphHtml(model) {
     const pos = layoutGraph(model);
     const edgeSvg = renderEdgeSvg(model, pos);
@@ -238,7 +259,8 @@ export function renderGraphHtml(model) {
         '<style>' + STYLE + '</style></head><body>',
         `<div class="legend"><b>hippo graph</b> · ${model.nodes.length} entities · ${model.edges.length} relations` +
             (model.truncated ? ' · <b style="color:#f59e0b">truncated</b>' : '') +
-            `<br>${legend}<br><span style="color:#64748b">drag to pan · scroll to zoom · click a node to focus</span></div>`,
+            `<br>${legend}<br><span style="color:#64748b">drag to pan ` +
+            `· scroll to zoom · click a node to focus</span></div>`,
         `<svg id="g" viewBox="0 0 ${LAYOUT_W} ${LAYOUT_H}" preserveAspectRatio="xMidYMid meet">`,
         `<g id="edges">${edgeSvg}</g><g id="nodes">${nodeSvg}</g>`,
         '</svg>',
@@ -247,7 +269,10 @@ export function renderGraphHtml(model) {
         '</body></html>',
     ].join('\n');
 }
-/** Render the model as a JSON Canvas (jsoncanvas.org) document: `text` nodes at the same deterministic layout positions, `edges[]` linking them by id. */
+/**
+ * Render the model as a JSON Canvas (jsoncanvas.org) document: `text` nodes at the same deterministic layout positions,
+ * `edges[]` linking them by id.
+ */
 export function renderGraphCanvas(model) {
     const pos = layoutGraph(model, { width: 2400, height: 1600 });
     const nodes = model.nodes.map((node) => {

package/dist/hooks/codex-session.js

@@ -1,7 +1,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { isJsonString } from '../util/json.js';
-import { errorMessage, log } from '../util/log.js';
+import { errorMessage, log, errorFields } from '../util/log.js';
 function collectFiles(dir) {
     if (!fs.existsSync(dir))
         return [];
@@ -44,7 +44,7 @@ function readCodexSessionIdsFromHistoryDelta(historyPath, startOffsetBytes) {
             }
         }
         catch (err) {
-            log.warn(`codex history ${historyPath}: skipped a malformed JSONL line (${errorMessage(err)})`);
+            log.warn(`codex history ${historyPath}: skipped a malformed JSONL line (${errorMessage(err)})`, errorFields(err));
         }
     }
     return ordered;

package/dist/hooks/codex-wrapper.d.ts

@@ -25,9 +25,11 @@ export interface CodexWrapperMetadata {
     installMode: 'same-path' | 'cmd-shim';
     logFile: string;
     installedAt: string;
+    /** The hippo CLI the user opted in; absent in metadata written before this field. */
+    hippoCliPath?: string;
 }
 export interface EnsureCodexWrapperResult {
-    status: 'installed' | 'already-installed' | 'not-found' | 'source-checkout';
+    status: 'installed' | 'already-installed' | 'not-found' | 'source-checkout' | 'other-install';
     metadataPath?: string;
     realCodexPath?: string;
     commandPath?: string;

package/dist/hooks/codex-wrapper.js

@@ -2,7 +2,7 @@ import { envPath } from '../util/env.js';
 import * as fs from 'fs';
 import * as path from 'path';
 import { PACKAGE_ROOT } from '../core/package-root.js';
-import { errorMessage, log } from '../util/log.js';
+import { errorMessage, log, errorFields } from '../util/log.js';
 import { HIPPO_CODEX_WRAPPER_MARKER, ensureDir } from './shared.js';
 import { homeDir, codexHomeDir } from '../util/agent-homes.js';
 import { isJsonString } from '../util/json.js';
@@ -161,7 +161,7 @@ function writeExecutableFile(filePath, content) {
     }
     catch (err) {
         // The mode bit means nothing on Windows; elsewhere a wrapper that is not executable breaks `codex`, so say so.
-        log.warn(`could not mark ${filePath} executable: ${errorMessage(err)}`);
+        log.warn(`could not mark ${filePath} executable: ${errorMessage(err)}`, errorFields(err));
     }
 }
 export function installCodexWrapper(realCodexPath) {
@@ -196,6 +196,7 @@ export function installCodexWrapper(realCodexPath) {
         installMode: plan.installMode,
         logFile: paths.logFile,
         installedAt: new Date().toISOString(),
+        hippoCliPath: resolveHippoCliPath(),
     };
     writeFileAtomic(paths.metadataPath, JSON.stringify(metadata, null, 2) + '\n');
     return installResult(paths.metadataPath, metadata);
@@ -275,11 +276,15 @@ export function isCodexWrapperInstalled() {
  * reads as binary hijacking to security scanners.
  */
 export function repairCodexWrapperIfInstalled(hippoCliPath = resolveHippoCliPath()) {
-    if (readCodexWrapperMetadata() === null) {
+    const metadata = readCodexWrapperMetadata();
+    if (metadata === null) {
         return { status: 'not-found' };
     }
+    // Only the CLI the user opted in may re-point their launcher, not an npx cache or a project dependency.
+    if (isJsonString(metadata.hippoCliPath) && !pathEquals(metadata.hippoCliPath, hippoCliPath)) {
+        return { status: 'other-install' };
+    }
     // A checkout's own `npm install` or CLI would point the user's launcher at a folder that may be deleted.
-    // SHORTCUT: any node_modules copy (npx cache, a project dependency) still repairs; record the opted-in CLI path in the metadata to close that.
     const packageDir = path.dirname(path.dirname(hippoCliPath));
     if (path.basename(path.dirname(packageDir)).toLowerCase() !== 'node_modules') {
         return { status: 'source-checkout' };

package/dist/hooks/copilot.d.ts

@@ -30,19 +30,30 @@ export type McpMergeStatus = 'added' | 'present' | 'user-owned' | 'unreadable';
 export type McpRemoveStatus = 'removed' | 'absent' | 'user-owned' | 'unreadable';
 /** Removes the "hippo" key only when hippo wrote it. */
 export declare function removeMcpServer(file: string, host?: McpHost): McpRemoveStatus;
-/** A filesystem error on an MCP config file (EACCES, EISDIR, EBUSY), kept as its own message so setup can report it and go on. */
+/**
+ * A filesystem error on an MCP config file (EACCES, EISDIR, EBUSY), kept as its own message so setup can report it and
+ * go on.
+ */
 export interface McpFailure {
     readonly failed: string;
 }
 export declare function isMcpFailure(status: string | McpFailure): status is McpFailure;
-/** `kept`: a hippo block that is not the Copilot text (edited, or another agent's in a shared file); `unclosed`: a start marker with no end. */
+/**
+ * `kept`: a hippo block that is not the Copilot text (edited, or another agent's in a shared file); `unclosed`: a start
+ * marker with no end.
+ */
 export type InstructionsInstallStatus = 'written' | 'present' | 'kept' | 'unclosed';
 export type InstructionsRemoveStatus = 'removed' | 'absent' | 'kept' | 'unclosed';
-/** Splices out only hippo's own Copilot block and keeps every other byte; a file left with nothing but whitespace goes. */
+/**
+ * Splices out only hippo's own Copilot block and keeps every other byte; a file left with nothing but whitespace goes.
+ */
 export declare function removeInstructionsBlock(file: string): InstructionsRemoveStatus;
 /** `kept`: the file is there but is not the text hippo writes, so the user edited it or it is someone else's. */
 export type VscodeInstructionsInstallStatus = 'written' | 'present' | 'kept';
-/** The file is hippo's alone, so it is written whole; an earlier hippo text is upgraded, and any other text already there stays. */
+/**
+ * The file is hippo's alone, so it is written whole; an earlier hippo text is upgraded, and any other text already
+ * there stays.
+ */
 export declare function ensureVscodeInstructions(file: string): VscodeInstructionsInstallStatus;
 export type VscodeInstructionsRemoveStatus = 'removed' | 'absent' | 'kept';
 /** Deletes the file only when it still holds exactly what a hippo release wrote. */
@@ -61,7 +72,10 @@ export interface CopilotInstallResult {
     readonly instructions: InstructionsInstallStatus | null;
     readonly vscode: readonly VscodeInstallResult[];
 }
-/** The CLI's folder holds more than the hooks folder setup makes for VS Code, so a rerun on a VS Code-only machine still finds no CLI. */
+/**
+ * The CLI's folder holds more than the hooks folder setup makes for VS Code, so a rerun on a VS Code-only machine still
+ * finds no CLI.
+ */
 export declare function isCopilotCliPresent(home?: string): boolean;
 export declare function installCopilot(): CopilotInstallResult;
 export interface VscodeUninstallResult {

package/dist/hooks/copilot.js

@@ -24,7 +24,10 @@ for a failure. Leave out secrets and personal details.
 The installed hooks load pinned memories when a session starts and capture
 the session as you work, so there is nothing to run before you finish.
 `.trim();
-/** Every Copilot text a release has written, so install upgrades an old block and uninstall still removes it; add the old text when the text changes. */
+/**
+ * Every Copilot text a release has written, so install upgrades an old block and uninstall still removes it; add the
+ * old text when the text changes.
+ */
 const SHIPPED_COPILOT_INSTRUCTIONS = [
     COPILOT_INSTRUCTIONS,
     `
@@ -53,7 +56,11 @@ function profileDirs(userDir) {
     const dir = path.join(userDir, 'profiles');
     if (!fs.existsSync(dir))
         return [];
-    return fs.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => path.join(dir, e.name)).sort();
+    return fs
+        .readdirSync(dir, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => path.join(dir, e.name))
+        .sort();
 }
 export function copilotPaths() {
     const home = copilotHomeDir();
@@ -74,22 +81,31 @@ function hippoCommand() {
     return process.platform === 'win32' ? 'hippo.cmd' : 'hippo';
 }
 /** The Copilot CLI's mcp-config.json keeps servers under "mcpServers", each with an env and a tool list. */
-export const COPILOT_CLI_MCP = { key: 'mcpServers', server: () => ({ type: 'local', command: hippoCommand(), args: ['mcp'], env: {}, tools: ['*'] }) };
+export const COPILOT_CLI_MCP = {
+    key: 'mcpServers',
+    server: () => ({ type: 'local', command: hippoCommand(), args: ['mcp'], env: {}, tools: ['*'] }),
+};
 /** VS Code's mcp.json keeps stdio servers under "servers"; it has no "mcpServers" key. */
-export const VSCODE_MCP = { key: 'servers', server: () => ({ type: 'stdio', command: hippoCommand(), args: ['mcp'] }) };
+export const VSCODE_MCP = {
+    key: 'servers',
+    server: () => ({ type: 'stdio', command: hippoCommand(), args: ['mcp'] }),
+};
 /** Only a server hippo wrote counts as hippo's: another command, other args, or
  * any key or value setup does not write (an env you added) makes it the user's. */
 function isHipposServer(entry, host) {
     if (!isJsonObjectLiteral(entry) || !('command' in entry) || !('args' in entry))
         return false;
     const ours = host.server();
-    return Object.entries(entry).every(([key, value]) => (key === 'command' ? value === 'hippo' || value === 'hippo.cmd' : isDeepStrictEqual(value, ours[key])));
+    return Object.entries(entry).every(([key, value]) => key === 'command' ? value === 'hippo' || value === 'hippo.cmd' : isDeepStrictEqual(value, ours[key]));
 }
 /** What to paste under the host's key when hippo cannot edit the file itself. */
 export function copilotMcpSnippet(host = COPILOT_CLI_MCP) {
     return `"${MCP_KEY}": ${JSON.stringify(host.server())}`;
 }
-/** Null for a file with comments, one that is not JSON, or one whose shape a merge would overwrite; a missing file reads as empty. */
+/**
+ * Null for a file with comments, one that is not JSON, or one whose shape a merge would overwrite; a missing file reads
+ * as empty.
+ */
 function readMcpConfig(file, host) {
     let config = {};
     if (fs.existsSync(file)) {
@@ -97,7 +113,8 @@ function readMcpConfig(file, host) {
             config = readJsonFile(file);
         }
         catch (err) {
-            // Only a parse failure means the text is not JSON hippo can merge; EACCES or EISDIR is thrown with its own message.
+            // Only a parse failure means the text is not JSON hippo can merge; EACCES or EISDIR is thrown with its own
+            // message.
             if (!(err instanceof SyntaxError))
                 throw err;
             // An empty file is a new one with no servers yet, not one with comments.
@@ -112,7 +129,10 @@ function readMcpConfig(file, host) {
     const servers = config[host.key];
     return isJsonObjectLiteral(servers) ? { config, servers } : null;
 }
-/** Adds hippo's server and keeps every other key; a file hippo cannot parse, or a "hippo" key it did not write, stays as it is. */
+/**
+ * Adds hippo's server and keeps every other key; a file hippo cannot parse, or a "hippo" key it did not write, stays as
+ * it is.
+ */
 function mergeMcpServer(file, host = COPILOT_CLI_MCP) {
     const read = readMcpConfig(file, host);
     if (read === null)
@@ -148,7 +168,10 @@ export function isMcpFailure(status) {
 function hasErrnoCode(err) {
     return 'code' in err && typeof err.code === 'string';
 }
-/** One MCP config step; a filesystem error comes back as a failure, so the hooks file and the instructions still install. */
+/**
+ * One MCP config step; a filesystem error comes back as a failure, so the hooks file and the instructions still
+ * install.
+ */
 function mcpStep(step) {
     try {
         return step();
@@ -162,7 +185,9 @@ function mcpStep(step) {
 function isCopilotBlock(inner) {
     return SHIPPED_COPILOT_INSTRUCTIONS.includes(inner);
 }
-/** Replaces only the text between the markers, in the file's own line ending, or appends a block after the user's text. */
+/**
+ * Replaces only the text between the markers, in the file's own line ending, or appends a block after the user's text.
+ */
 function withCopilotBlock(text, found) {
     if (found !== null) {
         const { start, end, eol } = found;
@@ -173,7 +198,10 @@ function withCopilotBlock(text, found) {
         return block;
     return `${text}${text.endsWith('\n') ? '\n' : '\n\n'}${block}`;
 }
-/** Creates the file when missing; any block but hippo's own Copilot one, and a start marker with no end, leave the file as it is. */
+/**
+ * Creates the file when missing; any block but hippo's own Copilot one, and a start marker with no end, leave the file
+ * as it is.
+ */
 function ensureInstructionsBlock(file) {
     const old = fs.existsSync(file) ? fs.readFileSync(file, 'utf8') : '';
     const found = hippoBlock(old);
@@ -187,7 +215,10 @@ function ensureInstructionsBlock(file) {
     writeFileAtomic(file, next);
     return 'written';
 }
-/** `text` without the block and its markers, plus the line break after the end marker, else the one before the start marker. */
+/**
+ * `text` without the block and its markers, plus the line break after the end marker, else the one before the start
+ * marker.
+ */
 function withoutCopilotBlock(text, found) {
     const from = found.start - HOOK_MARKERS.start.length;
     const to = found.end + HOOK_MARKERS.end.length;
@@ -195,7 +226,9 @@ function withoutCopilotBlock(text, found) {
     const before = after > 0 ? 0 : text.endsWith('\r\n', from) ? 2 : text.endsWith('\n', from) ? 1 : 0;
     return text.slice(0, from - before) + text.slice(to + after);
 }
-/** Splices out only hippo's own Copilot block and keeps every other byte; a file left with nothing but whitespace goes. */
+/**
+ * Splices out only hippo's own Copilot block and keeps every other byte; a file left with nothing but whitespace goes.
+ */
 export function removeInstructionsBlock(file) {
     if (!fs.existsSync(file))
         return 'absent';
@@ -212,7 +245,10 @@ export function removeInstructionsBlock(file) {
         writeFileAtomic(file, left);
     return 'removed';
 }
-/** The file is hippo's alone, so it is written whole; an earlier hippo text is upgraded, and any other text already there stays. */
+/**
+ * The file is hippo's alone, so it is written whole; an earlier hippo text is upgraded, and any other text already
+ * there stays.
+ */
 export function ensureVscodeInstructions(file) {
     if (fs.existsSync(file)) {
         const old = fs.readFileSync(file, 'utf8');
@@ -233,7 +269,10 @@ export function removeVscodeInstructions(file) {
     fs.rmSync(file);
     return 'removed';
 }
-/** The CLI's folder holds more than the hooks folder setup makes for VS Code, so a rerun on a VS Code-only machine still finds no CLI. */
+/**
+ * The CLI's folder holds more than the hooks folder setup makes for VS Code, so a rerun on a VS Code-only machine still
+ * finds no CLI.
+ */
 export function isCopilotCliPresent(home = copilotHomeDir()) {
     if (fs.statSync(home, { throwIfNoEntry: false })?.isDirectory() !== true)
         return false;

package/dist/hooks/hook-blocks.d.ts

@@ -11,7 +11,10 @@ export interface HookTable {
     [agent: string]: HookSpec;
 }
 export declare const HOOKS: HookTable;
-/** The first hippo block in `text` and the agent whose current or shipped text it is; `owner` is undefined for an edited block. */
+/**
+ * The first hippo block in `text` and the agent whose current or shipped text it is; `owner` is undefined for an edited
+ * block.
+ */
 export declare function hippoBlock(text: string): {
     start: number;
     end: number;

package/dist/hooks/hook-blocks.js

@@ -108,7 +108,8 @@ hippo capture --stdin <<< '<decisions, errors, lessons: 2-5 bullets>'
     'opencode': { file: 'AGENTS.md', description: 'OpenCode', content: agentsBlock('task', { recall: true }) },
     'pi': { file: 'AGENTS.md', description: 'Pi', content: agentsBlock('session', { footer: PI_FOOTER }) },
 };
-// sha256 of each trimmed block an earlier hippo wrote, so init refreshes only blocks nobody edited. Add the old hash when a block changes.
+// sha256 of each trimmed block an earlier hippo wrote, so init refreshes only blocks nobody edited. Add the old hash
+// when a block changes.
 const SHIPPED_HOOK_HASHES = new Map([
     ['c04e48f2896a4fee9ae98f8f832e2d26a3910269df3beb5bcd6baee3cd9db68e', 'claude-code'],
     ['e6b12bd8983c032e5ca8e95a97aeff4178a5a05026d10acad5b2e1b25d5656dd', 'claude-code'],
@@ -131,7 +132,10 @@ const SHIPPED_HOOK_HASHES = new Map([
     ['37767b355e18beac726b05b9e2b898dab8c6135fd7b98f3aa52edc734d5dd283', 'pi'],
     ['6e85a5cccb3cfeaa9a080713754936db730f96376f94cc9a9888a746149c7268', 'pi'],
 ]);
-/** The first hippo block in `text` and the agent whose current or shipped text it is; `owner` is undefined for an edited block. */
+/**
+ * The first hippo block in `text` and the agent whose current or shipped text it is; `owner` is undefined for an edited
+ * block.
+ */
 export function hippoBlock(text) {
     const at = text.indexOf(HOOK_MARKERS.start);
     const start = at + HOOK_MARKERS.start.length;
@@ -141,7 +145,8 @@ export function hippoBlock(text) {
     // git autocrlf checks these files out with CRLF: match as LF, write back in the file's own ending.
     const raw = text.slice(start, end);
     const inner = raw.replace(/\r\n/g, '\n').trim();
-    const owner = Object.keys(HOOKS).find((k) => HOOKS[k].content === inner) ?? SHIPPED_HOOK_HASHES.get(createHash('sha256').update(inner).digest('hex'));
+    const owner = Object.keys(HOOKS).find((k) => HOOKS[k].content === inner) ??
+        SHIPPED_HOOK_HASHES.get(createHash('sha256').update(inner).digest('hex'));
     return { start, end, eol: raw.includes('\r\n') ? '\r\n' : '\n', inner, owner };
 }
 /** `text` with every hippo block and its markers removed, trimmed. */

package/dist/hooks/json-hooks.d.ts

@@ -1,5 +1,6 @@
-/** Hook install/uninstall for AI coding tools. Claude Code gets a JSON `hooks` block in settings.json; older forms are migrated automatically.
- * OpenCode rejects the JSON-hook schema (no `hooks` key), so it gets a TS plugin (OPENCODE_PLUGIN_SOURCE); see installCodexHooks, installCopilotHooks. */
+/** Hook install/uninstall for AI coding tools. Claude Code gets a JSON `hooks` block in settings.json; older forms are
+ * migrated automatically. OpenCode rejects the JSON-hook schema (no `hooks` key), so it gets a TS plugin
+ * (OPENCODE_PLUGIN_SOURCE); see installCodexHooks, installCopilotHooks. */
 import { type JsonHookTarget } from './shared.js';
 import { type JsonValue } from '../util/json.js';
 /** A target's hook settings file, the log its SessionEnd hook writes, and the tool's display name. */
@@ -32,11 +33,14 @@ export interface InstallResult {
 export declare function resolveJsonHookPaths(target: JsonHookTarget): JsonHookPaths;
 /** The events in hippo's Copilot hooks file, in file order, for setup to name. */
 export declare function copilotHookEvents(): string[];
-/** Adds hippo's hooks to `target`'s settings file and migrates older hippo entries; a file that is not JSON stays untouched. */
+/** Adds hippo's hooks to `target`'s settings file and migrates older hippo entries; a file that is not JSON stays
+ * untouched. */
 export declare function installJsonHooks(target: JsonHookTarget): InstallResult;
-/** Swaps the file in with one rename, so a crash mid-write cannot leave a truncated settings.json that Claude Code cannot parse. */
+/** Swaps the file in with one rename, so a crash mid-write cannot leave a truncated settings.json that Claude Code
+ * cannot parse. */
 export declare function writeSettingsFile(file: string, settings: JsonValue): void;
-/** Removes hippo's own hook handlers from `target`'s settings file and keeps every other handler; true when the file changed. */
+/** Removes hippo's own hook handlers from `target`'s settings file and keeps every other handler; true when the file
+ * changed. */
 export declare function uninstallJsonHooks(target: JsonHookTarget): boolean;
 /** Whether uninstall can edit settings.json; `invalidJson` marks a file that exists
  * but is not JSON hippo can edit, which `uninstallJsonHooks` reports only as false. */