Skip to content

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
5.6 KB
Raw Blame
/**
 * Time-Aware Recall & Activation Suite - end-to-end integration over
 * one vault: access-reinforced activation with co-access companions
 * (t_2bc79017 + t_c5ef25a3), freshness-trend ranking bias
 * (t_ee09a6ce), event-time recall discipline with temporal bridging
 * (t_b7191486 + t_c3871f0c), and the self-correcting two-pass retry
 * (t_ef92dfdc).
 */

import { afterEach, beforeEach, expect, test } from "bun:test";
import { utimesSync } from "node:fs";

import { loadAccessEvents } from "../../src/core/search/activation/store.ts";
import { indexVault } from "../../src/core/search/indexer.ts";
import { search } from "../../src/core/search/search.ts";
import { createTempVault, makeConfig, writeMd } from "../helpers/search-fixtures.ts";

const DAY = 24 * 60 * 60 * 1000;

let vault: string;
let dbPath: string;
let cleanup: () => void;

function prefBody(trend: string | null): string {
  return (
    `---\nkind: brain-preference\n${trend ? `freshness_trend: ${trend}\n` : ""}---\n\n` +
    "# Rule\n\nGlacier deploy approvals are mandatory.\n"
  );
}

beforeEach(() => {
  ({ vault, dbPath, cleanup } = createTempVault("time-aware-e2e"));
});

afterEach(() => {
  cleanup();
});

test("the suite composes end to end on one vault", async () => {
  const now = Date.now();

  // -- Fixtures -------------------------------------------------------
  // A recurring working set: two notes habitually recalled together.
  writeMd(vault, "Brain/notes/runbook.md", "# Runbook\n\nGlacier deploy runbook steps.\n");
  writeMd(vault, "Brain/notes/checklist.md", "# Checklist\n\nGlacier deploy checklist items.\n");
  // Preferences: one weakening, one unstamped twin.
  writeMd(vault, "Brain/preferences/pref-fresh.md", prefBody(null));
  writeMd(vault, "Brain/preferences/pref-fading.md", prefBody("weakening"));
  // Event-time discipline: an old file describing a recent event.
  const oldFileRecentEvent = writeMd(
    vault,
    "Brain/notes/migration-window.md",
    `---\nvalid_from: ${new Date(now - 1 * DAY).toISOString()}\n---\n\n# Window\n\nGlacier migration window agreed.\n`,
  );
  // Temporal bridge: in-window incident linking to near-past prep work.
  writeMd(
    vault,
    "Brain/notes/incident.md",
    "# Incident\n\nGlacier migration window incident.\n\n[[Brain/notes/prep.md|prep]]\n",
  );
  const prep = writeMd(vault, "Brain/notes/prep.md", "# Prep\n\nPre-freeze valve work.\n");
  // Two-pass: terms split across documents (implicit AND finds nothing).
  writeMd(vault, "Brain/notes/permafrost.md", "# Permafrost\n\nPermafrost sensor archive.\n");
  writeMd(vault, "Brain/notes/turbine.md", "# Turbine\n\nTurbine maintenance ledger.\n");

  const config = makeConfig({ vault, dbPath, maxHops: 1, mmrLambda: 1 });
  await indexVault(config);
  // Age the event-time and bridge fixtures AFTER content indexing.
  const ancient = new Date(now - 200 * DAY);
  utimesSync(oldFileRecentEvent, ancient, ancient);
  const prepDate = new Date(now - 10 * DAY);
  utimesSync(prep, prepDate, prepDate);
  await indexVault(config);

  // -- Activation + co-access (t_2bc79017 + t_c5ef25a3) ---------------
  // Recall the working set repeatedly with recording on. Sequential on
  // purpose: each recording must land before the next query so the
  // event files carry distinct timestamps.
  await search(config, { query: "glacier deploy", recordAccess: true, limit: 5 });
  await search(config, { query: "glacier deploy", recordAccess: true, limit: 5 });
  await search(config, { query: "glacier deploy", recordAccess: true, limit: 5 });
  await search(config, { query: "glacier deploy", recordAccess: true, limit: 5 });
  expect(loadAccessEvents(vault).length).toBeGreaterThanOrEqual(1);
  const activated = await search(config, { query: "glacier deploy", limit: 10 });
  const runbook = activated.results.find((r) => r.path === "Brain/notes/runbook.md");
  expect(runbook).toBeDefined();
  expect(runbook!.reasons.some((x) => x.startsWith("activation: "))).toBe(true);
  expect(runbook!.reasons.some((x) => x.startsWith("co_access: "))).toBe(true);

  // -- Freshness-trend bias (t_ee09a6ce) ------------------------------
  const prefs = await search(config, { query: "glacier deploy approvals", limit: 10 });
  const fresh = prefs.results.find((r) => r.path === "Brain/preferences/pref-fresh.md");
  const fading = prefs.results.find((r) => r.path === "Brain/preferences/pref-fading.md");
  expect(fading!.score).toBeLessThan(fresh!.score);
  expect(fading!.reasons.some((x) => x.includes("weakening"))).toBe(true);

  // -- Event-time discipline + temporal bridge (t_b7191486 + t_c3871f0c)
  const windowed = await search(config, { query: "glacier migration window", since: "7d" });
  const windowedPaths = windowed.results.map((r) => r.path);
  // The 200-day-old FILE is found because its EVENT time is yesterday.
  expect(windowedPaths).toContain("Brain/notes/migration-window.md");
  // The linked prep work (10d out, within the 7d pad) bridges in.
  expect(windowedPaths).toContain("Brain/notes/prep.md");
  const bridged = windowed.results.find((r) => r.path === "Brain/notes/prep.md");
  expect(bridged!.reasons.some((x) => x.startsWith("temporal_bridge: "))).toBe(true);

  // -- Two-pass recovery (t_ef92dfdc) ---------------------------------
  const strict = await search(config, { query: "permafrost turbine" });
  expect(strict.results).toHaveLength(0);
  const recovered = await search(config, { query: "permafrost turbine", evidencePack: true });
  expect(recovered.secondPass?.triggered).toBe(true);
  const recoveredPaths = recovered.results.map((r) => r.path);
  expect(recoveredPaths).toContain("Brain/notes/permafrost.md");
  expect(recoveredPaths).toContain("Brain/notes/turbine.md");
});