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
6.1 KB
Raw Blame
/**
 * Tier drift detection (t_3f92d3f1, part 2): the indexer seeds a
 * tiered-frontmatter snapshot per framework-kind document and, on
 * later runs, stages a tier_drift finding when an identity field's
 * value changed against the snapshot. The snapshot keeps the expected
 * value, so repeated reindexes never absorb a hand-edit; system-tier
 * fields update silently because framework writers mutate them
 * legitimately on every pass.
 */

import { afterEach, beforeEach, expect, test } from "bun:test";
import { mkdirSync, writeFileSync } from "node:fs";
import { join } from "node:path";

import { runDoctor } from "../../../src/core/brain/doctor.ts";
import { TIER_DRIFT_CODE } from "../../../src/core/brain/doctor/store-integrity.ts";
import { indexVault } from "../../../src/core/search/indexer.ts";
import { Store } from "../../../src/core/search/store.ts";
import { createTempVault, makeConfig, writeMd } from "../../helpers/search-fixtures.ts";

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

beforeEach(() => {
  ({ vault, dbPath, cleanup } = createTempVault("tier-drift"));
  mkdirSync(join(vault, "Brain"), { recursive: true });
  writeFileSync(join(vault, "Brain", "_brain.yaml"), "schema_version: 1\n");
});

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

function writePref(id: string, createdAt = "2026-05-01T00:00:00Z", body = "Use spaces.\n"): void {
  writeMd(
    vault,
    "Brain/preferences/pref-spaces.md",
    `---\nkind: brain-preference\nid: ${id}\ncreated_at: ${createdAt}\ntopic: style\n---\n\n${body}`,
  );
}

async function drift(): Promise<ReturnType<Store["listTierDrift"]>> {
  const store = await Store.open(makeConfig({ vault, dbPath }), { mode: "read" });
  try {
    return store.listTierDrift();
  } finally {
    await store.close();
  }
}

test("a hand-edited identity field stages drift the reindex never absorbs", async () => {
  const config = makeConfig({ vault, dbPath });
  writePref("pref-spaces");
  const first = await indexVault(config);
  expect(first.tierDrift).toHaveLength(0);
  expect(await drift()).toHaveLength(0);

  // Hand-edit the join key.
  writePref("pref-tabs");
  const second = await indexVault(config);
  expect(second.tierDrift).toEqual([
    {
      path: "Brain/preferences/pref-spaces.md",
      field: "id",
      expected: "pref-spaces",
      actual: "pref-tabs",
    },
  ]);
  const rows = await drift();
  expect(rows).toHaveLength(1);
  expect(rows[0]).toMatchObject({ field: "id", expected: "pref-spaces", actual: "pref-tabs" });

  // A third run with the same hand-edit still reports against the
  // ORIGINAL expected value - the snapshot did not absorb the edit.
  // (The body must change SIZE: the indexer's mtime+size fastpath
  // skips same-second same-size rewrites.)
  writePref("pref-tabs", "2026-05-01T00:00:00Z", "Use considerably more spaces!\n");
  const third = await indexVault(config);
  expect(third.tierDrift).toEqual([
    {
      path: "Brain/preferences/pref-spaces.md",
      field: "id",
      expected: "pref-spaces",
      actual: "pref-tabs",
    },
  ]);
});

test("restoring the original value clears the drift on the next run", async () => {
  const config = makeConfig({ vault, dbPath });
  writePref("pref-spaces");
  await indexVault(config);
  writePref("pref-tabs");
  await indexVault(config);
  expect(await drift()).toHaveLength(1);

  writePref("pref-spaces", "2026-05-01T00:00:00Z", "Use spaces - restored by hand.\n");
  const healed = await indexVault(config);
  expect(healed.tierDrift).toHaveLength(0);
  expect(await drift()).toHaveLength(0);
});

test("deleting an identity field stages drift with a null actual", async () => {
  const config = makeConfig({ vault, dbPath });
  writePref("pref-spaces");
  await indexVault(config);
  writeMd(
    vault,
    "Brain/preferences/pref-spaces.md",
    "---\nkind: brain-preference\ncreated_at: 2026-05-01T00:00:00Z\ntopic: style\n---\n\nNo id anymore.\n",
  );
  const stats = await indexVault(config);
  expect(stats.tierDrift).toEqual([
    {
      path: "Brain/preferences/pref-spaces.md",
      field: "id",
      expected: "pref-spaces",
      actual: null,
    },
  ]);
});

test("system-tier changes update the snapshot without staging drift", async () => {
  const config = makeConfig({ vault, dbPath });
  writePref("pref-spaces", "2026-05-01T00:00:00Z");
  await indexVault(config);
  writePref("pref-spaces", "2026-06-01T12:00:00Z", "Use spaces, refreshed by the framework.\n");
  const stats = await indexVault(config);
  expect(stats.tierDrift).toHaveLength(0);
  expect(await drift()).toHaveLength(0);
});

test("unknown kinds never seed snapshots or drift", async () => {
  const config = makeConfig({ vault, dbPath });
  writeMd(vault, "notes/list.md", "---\nkind: shopping-list\nid: original\n---\n\nMilk.\n");
  await indexVault(config);
  writeMd(vault, "notes/list.md", "---\nkind: shopping-list\nid: changed\n---\n\nMilk.\n");
  const stats = await indexVault(config);
  expect(stats.tierDrift).toHaveLength(0);
  expect(await drift()).toHaveLength(0);
});

test("deleting the document drops its drift rows", async () => {
  const config = makeConfig({ vault, dbPath });
  writePref("pref-spaces");
  await indexVault(config);
  writePref("pref-tabs");
  await indexVault(config);
  expect(await drift()).toHaveLength(1);

  const { rmSync } = await import("node:fs");
  rmSync(join(vault, "Brain", "preferences", "pref-spaces.md"));
  await indexVault(config);
  expect(await drift()).toHaveLength(0);
});

test("the doctor counts only the drift rows on pages the caller may read", async () => {
  const config = makeConfig({ vault, dbPath });
  writePref("pref-spaces");
  await indexVault(config);
  writePref("pref-tabs");
  await indexVault(config);
  const driftWarnings = (readable?: (rel: string) => boolean) =>
    runDoctor(vault, { dbPath, ...(readable !== undefined ? { readable } : {}) }).warnings.filter(
      (w) => w.code === TIER_DRIFT_CODE,
    );
  expect(driftWarnings()).toHaveLength(1);
  expect(driftWarnings((rel) => rel === "Brain/preferences/pref-spaces.md")).toHaveLength(1);
  // A caller that may not read the drifted page is told nothing about it.
  expect(driftWarnings(() => false)).toEqual([]);
});