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
3.1 KB
Raw Blame
import { afterEach, beforeEach, describe, expect, test } from "bun:test";
import { mkdirSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";

import {
  moveToRetired,
  writePreference,
  type WritePreferenceInput,
} from "../../../src/core/brain/preference.ts";
import { planSemanticsBackfill } from "../../../src/core/brain/semantics-backfill.ts";
import {
  BRAIN_CONFIDENCE,
  BRAIN_PREFERENCE_STATUS,
  BRAIN_RETIRED_REASON,
} from "../../../src/core/brain/types.ts";

let vault: string;

beforeEach(() => {
  vault = mkdtempSync(join(tmpdir(), "o2b-semantics-backfill-"));
  mkdirSync(join(vault, "Brain", "preferences"), { recursive: true });
  mkdirSync(join(vault, "Brain", "retired"), { recursive: true });
});

afterEach(() => {
  rmSync(vault, { recursive: true, force: true });
});

function basePref(
  slug: string,
  overrides: Partial<WritePreferenceInput> = {},
): WritePreferenceInput {
  return {
    slug,
    topic: "writing",
    principle: `Principle for ${slug}`,
    created_at: "2026-05-30T12:00:00Z",
    unconfirmed_until: "2026-06-06T12:00:00Z",
    status: BRAIN_PREFERENCE_STATUS.confirmed,
    evidenced_by: [],
    confirmed_at: "2026-05-30T13:00:00Z",
    pinned: false,
    confidence: BRAIN_CONFIDENCE.low,
    ...overrides,
  };
}

function retire(slug: string, supersededBy?: string): string {
  const pref = writePreference(vault, basePref(slug));
  return moveToRetired(vault, pref.path, BRAIN_RETIRED_REASON.rebutted, {
    now: new Date("2026-06-01T00:00:00Z"),
    retired_by: "[[Brain/log/2026-06-01]]",
    ...(supersededBy !== undefined ? { superseded_by: supersededBy } : {}),
  }).path;
}

describe("planSemanticsBackfill", () => {
  test("proposes inverse superseded_by for active supersedes links", () => {
    const retiredPath = retire("old");
    writePreference(
      vault,
      basePref("new", {
        supersedes: "[[ret-old]]",
      }),
    );

    const plan = planSemanticsBackfill(vault);

    expect(plan.proposals).toEqual([
      {
        source_id: "ret-old",
        target_id: "pref-new",
        relation: "superseded_by",
        field: "superseded_by",
        value: "[[pref-new]]",
        reason: "active-supersedes-retired-missing-inverse",
        path: retiredPath,
      },
    ]);
    expect(readFileSync(retiredPath, "utf8")).not.toContain("superseded_by:");
  });

  test("does not propose when retired inverse already exists", () => {
    retire("old", "[[pref-new]]");
    writePreference(
      vault,
      basePref("new", {
        supersedes: "[[ret-old]]",
      }),
    );

    const plan = planSemanticsBackfill(vault);

    expect(plan.proposals).toEqual([]);
  });

  test("returns proposals in stable source-target order", () => {
    retire("z-old");
    retire("a-old");
    writePreference(vault, basePref("z-new", { supersedes: "[[ret-z-old]]" }));
    writePreference(vault, basePref("a-new", { supersedes: "[[ret-a-old]]" }));

    const plan = planSemanticsBackfill(vault);

    expect(plan.proposals.map((p) => `${p.source_id}->${p.target_id}`)).toEqual([
      "ret-a-old->pref-a-new",
      "ret-z-old->pref-z-new",
    ]);
  });
});