Local-first 🧠memory for Hermes Agent that lives in your Obsidian vault and remembers project context. Nightly 😴 dream passes turn repeat corrections into confirmed preferences with measurable confidence. Adapters ship for Claude Code, Codex, and OpenClaw, with an MCP server for anything else.
TypeScript
import { test, expect } from "bun:test";
import { buildCacheKey } from "../../../src/core/search/query-cache.ts";
import type { SearchOptions } from "../../../src/core/search/types.ts";
const opts = (o: Partial<SearchOptions>): SearchOptions => ({ query: "alpha", ...o });
test("identical request, plan, and config fingerprint produce the same key", () => {
expect(buildCacheKey(opts({}), "plan1", "fp1")).toBe(buildCacheKey(opts({}), "plan1", "fp1"));
});
test("a different query changes the key", () => {
expect(buildCacheKey(opts({ query: "alpha" }), "p", "fp")).not.toBe(
buildCacheKey(opts({ query: "beta" }), "p", "fp"),
);
});
test("a different limit changes the key", () => {
expect(buildCacheKey(opts({ limit: 10 }), "p", "fp")).not.toBe(
buildCacheKey(opts({ limit: 20 }), "p", "fp"),
);
});
test("a different plan hash changes the key", () => {
expect(buildCacheKey(opts({}), "planA", "fp")).not.toBe(buildCacheKey(opts({}), "planB", "fp"));
});
test("a different config fingerprint changes the key", () => {
expect(buildCacheKey(opts({}), "p", "fpA")).not.toBe(buildCacheKey(opts({}), "p", "fpB"));
});
test("property-filter order does not change the key (canonical)", () => {
const a = buildCacheKey(opts({ properties: new Map([["k", ["1", "2"]]]) }), "p", "fp");
const b = buildCacheKey(opts({ properties: new Map([["k", ["2", "1"]]]) }), "p", "fp");
expect(a).toBe(b);
});
// --- Transport reach partitions the cache (private-is-not-a-suggestion) -----
//
// The reach decides which pages are in the pool at all, so a `local`
// outcome and a `remote` outcome must never collide on one row. The
// cache lives in the shared `query_cache` table, which the operator's
// CLI (local) and the HTTP MCP server (remote) both write to.
test("a different transport reach changes the key", () => {
expect(buildCacheKey(opts({ transportReach: "local" }), "p", "fp")).not.toBe(
buildCacheKey(opts({ transportReach: "remote" }), "p", "fp"),
);
});
test("an absent transport reach keys as the narrowest, not as its own third state", () => {
expect(buildCacheKey(opts({}), "p", "fp")).toBe(
buildCacheKey(opts({ transportReach: "remote" }), "p", "fp"),
);
});
test("a local outcome cannot be served to a caller that established nothing", () => {
expect(buildCacheKey(opts({}), "p", "fp")).not.toBe(
buildCacheKey(opts({ transportReach: "local" }), "p", "fp"),
);
});
test("an any-mode search keys apart from the strict default", () => {
expect(buildCacheKey(opts({ query: "alpha beta", matchMode: "any" }), "p", "fp")).not.toBe(
buildCacheKey(opts({ query: "alpha beta" }), "p", "fp"),
);
});
test("an explicit all mode keys identically to an absent mode", () => {
expect(buildCacheKey(opts({ query: "alpha beta", matchMode: "all" }), "p", "fp")).toBe(
buildCacheKey(opts({ query: "alpha beta" }), "p", "fp"),
);
});