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 { afterEach, beforeEach, describe, expect, test } from "bun:test";
import { existsSync, mkdirSync, mkdtempSync, renameSync, rmSync, statSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { bootstrapBrain } from "../../src/core/brain/init.ts";
import {
preferencePath,
processedSignalPath,
signalPath,
vaultRelative,
} from "../../src/core/brain/paths.ts";
import { moveToRetired, writePreference } from "../../src/core/brain/preference.ts";
import { writeSignal } from "../../src/core/brain/signal.ts";
import { buildRetentionReview } from "../../src/core/brain/retention.ts";
import { BRAIN_RETIRED_REASON } from "../../src/core/brain/types.ts";
let vault: string;
beforeEach(() => {
vault = mkdtempSync(join(tmpdir(), "o2b-retention-"));
mkdirSync(vault, { recursive: true });
bootstrapBrain(vault, {});
});
afterEach(() => {
rmSync(vault, { recursive: true, force: true });
});
describe("buildRetentionReview", () => {
test("recommends keep/prune without mutating artifacts", () => {
writePreference(vault, {
slug: "useful-rule",
topic: "useful-rule",
principle: "keep useful retired rules visible",
created_at: "2026-05-01T00:00:00Z",
unconfirmed_until: "2026-05-08T00:00:00Z",
confirmed_at: "2026-05-08T00:00:00Z",
status: "confirmed",
evidenced_by: [],
applied_count: 3,
violated_count: 0,
last_evidence_at: "2026-05-20T00:00:00Z",
});
const retired = moveToRetired(
vault,
preferencePath(vault, "useful-rule"),
BRAIN_RETIRED_REASON.staleNoEvidence,
{
now: new Date("2026-05-21T00:00:00Z"),
retired_by: "test",
evidenceApplied: [],
evidenceViolated: [],
},
);
writeSignal(vault, {
topic: "discarded-signal",
signal: "negative",
agent: "test",
principle: "old one-off signal",
created_at: "2026-04-01T00:00:00Z",
date: "2026-04-01",
slug: "discarded-signal",
});
const activeSignal = signalPath(vault, "2026-04-01", "discarded-signal");
const processedSignal = processedSignalPath(vault, "2026-04-01", "discarded-signal");
renameSync(activeSignal, processedSignal);
const retiredMtimeBefore = statSync(retired.path).mtimeMs;
const processedMtimeBefore = statSync(processedSignal).mtimeMs;
const report = buildRetentionReview(vault, {
now: new Date("2026-05-28T00:00:00Z"),
});
expect(report.summary.keep).toBe(1);
expect(report.summary.prune).toBe(1);
expect(report.recommendations).toEqual([
expect.objectContaining({ id: "ret-useful-rule", action: "keep" }),
expect.objectContaining({
id: "sig-2026-04-01-discarded-signal",
action: "prune",
}),
]);
expect(existsSync(retired.path)).toBe(true);
expect(existsSync(processedSignal)).toBe(true);
expect(statSync(retired.path).mtimeMs).toBe(retiredMtimeBefore);
expect(statSync(processedSignal).mtimeMs).toBe(processedMtimeBefore);
expect(report.recommendations.map((r) => r.path)).toEqual([
vaultRelative(retired.path, vault),
vaultRelative(processedSignal, vault),
]);
expect(report.recommendations[1]!.path).toBe(
"Brain/inbox/processed/sig-2026-04-01-discarded-signal.md",
);
});
});