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
/**
* Dual-output wiring (t_00eece5d): with `report_snapshots_enabled`,
* the digest / daily / weekly surfaces persist one snapshot per run
* under `Brain/reports/<surface>/` and report a "Since last run"
* delta on subsequent runs - in both JSON (`delta` field) and human
* output. A vault without the flag renders byte-identically and
* writes nothing.
*/
import { afterEach, beforeEach, expect, setDefaultTimeout, test } from "bun:test";
import { existsSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { bootstrapBrain } from "../../src/core/brain/init.ts";
import { writeSignal } from "../../src/core/brain/signal.ts";
import { runCli } from "../helpers/run-cli.ts";
import { CLI_SPAWN_BUDGET_MS } from "../helpers/cli-timeout.ts";
// Tests here spawn processes; see tests/helpers/cli-timeout.ts.
setDefaultTimeout(CLI_SPAWN_BUDGET_MS);
let tmp: string;
let vault: string;
let configPath: string;
const savedEnv: Record<string, string | undefined> = {};
beforeEach(() => {
tmp = mkdtempSync(join(tmpdir(), "o2b-cli-report-delta-"));
vault = join(tmp, "vault");
configPath = join(tmp, "config.yaml");
for (const key of ["OPEN_SECOND_BRAIN_CONFIG", "OPEN_SECOND_BRAIN_REPORT_SNAPSHOTS"]) {
savedEnv[key] = process.env[key];
delete process.env[key];
}
writeFileSync(
configPath,
`vault: ${vault}\nagent_name: claude\nreport_snapshots_enabled: true\n`,
);
bootstrapBrain(vault, { configPath });
});
afterEach(() => {
rmSync(tmp, { recursive: true, force: true });
for (const [key, value] of Object.entries(savedEnv)) {
if (value === undefined) delete process.env[key];
else process.env[key] = value;
}
});
const env = () => ({ OPEN_SECOND_BRAIN_CONFIG: configPath });
test("daily brief: first run no delta, second run reports the change", async () => {
const first = await runCli(
["brain", "daily", "--date", "2026-06-04", "--vault", vault, "--json"],
{ env: env() },
);
expect(first.returncode).toBe(0);
const firstParsed = JSON.parse(first.stdout) as { delta: { prior_date: string | null } };
expect(firstParsed.delta.prior_date).toBeNull();
expect(existsSync(join(vault, "Brain", "reports", "daily", "2026-06-04.json"))).toBe(true);
// A new signal shifts the daily counters for the later date.
writeSignal(vault, {
topic: "delta-topic",
signal: "positive",
agent: "claude",
principle: "Rule for delta-topic.",
created_at: "2026-06-05T09:00:00Z",
date: "2026-06-05",
slug: "delta-1",
scope: "writing",
});
const second = await runCli(
["brain", "daily", "--date", "2026-06-05", "--vault", vault, "--json"],
{ env: env() },
);
const secondParsed = JSON.parse(second.stdout) as {
delta: { prior_date: string | null; changed: Array<{ path: string }> };
};
expect(secondParsed.delta.prior_date).toBe("2026-06-04");
expect(secondParsed.delta.changed.length).toBeGreaterThan(0);
});
test("weekly and digest surfaces persist snapshots under Brain/reports/", async () => {
const weekly = await runCli(
["brain", "weekly", "--week-end", "2026-06-05", "--vault", vault, "--json"],
{ env: env() },
);
expect(weekly.returncode).toBe(0);
expect((JSON.parse(weekly.stdout) as { delta: unknown }).delta).toBeDefined();
expect(existsSync(join(vault, "Brain", "reports", "weekly", "2026-06-05.json"))).toBe(true);
const digest = await runCli(["brain", "digest", "--vault", vault, "--json"], { env: env() });
expect(digest.returncode).toBe(0);
expect((JSON.parse(digest.stdout) as { delta: unknown }).delta).toBeDefined();
expect(existsSync(join(vault, "Brain", "reports", "digest"))).toBe(true);
});
test("a same-date rerun of identical data reports an empty delta", async () => {
// Guard against wall-clock leakage (independent review finding):
// two runs over the same date and unchanged vault must diff clean
// even though their render instants differ.
await runCli(["brain", "daily", "--date", "2026-06-04", "--vault", vault, "--json"], {
env: env(),
});
const rerun = await runCli(
["brain", "daily", "--date", "2026-06-05", "--vault", vault, "--json"],
{ env: env() },
);
// Different date, no data change: still nothing volatile in the diff.
const rerunParsed = JSON.parse(rerun.stdout) as {
delta: { changed: Array<{ path: string }> };
};
expect(rerunParsed.delta.changed.filter((c) => c.path.includes("enerated"))).toEqual([]);
const weeklyFirst = await runCli(
["brain", "weekly", "--week-end", "2026-06-05", "--vault", vault, "--json"],
{ env: env() },
);
expect(weeklyFirst.returncode).toBe(0);
const weeklyAgain = await runCli(
["brain", "weekly", "--week-end", "2026-06-05", "--vault", vault, "--json"],
{ env: env() },
);
const weeklyParsed = JSON.parse(weeklyAgain.stdout) as {
delta: { prior_date: string | null; added: string[]; changed: Array<{ path: string }> };
};
// Same date overwrites the snapshot; the prior is the older date or
// none - either way no generatedAt churn may appear.
expect(weeklyParsed.delta.changed.filter((c) => c.path.includes("enerated"))).toEqual([]);
});
test("human output renders a Since-last-run block", async () => {
await runCli(["brain", "daily", "--date", "2026-06-04", "--vault", vault], { env: env() });
const second = await runCli(["brain", "daily", "--date", "2026-06-05", "--vault", vault], {
env: env(),
});
expect(second.stdout).toContain("Since last run");
});
test("disabled vault writes nothing and emits no delta", async () => {
writeFileSync(configPath, `vault: ${vault}\nagent_name: claude\n`);
const r = await runCli(["brain", "daily", "--date", "2026-06-04", "--vault", vault, "--json"], {
env: env(),
});
expect(r.returncode).toBe(0);
expect((JSON.parse(r.stdout) as Record<string, unknown>)["delta"]).toBeUndefined();
expect(existsSync(join(vault, "Brain", "reports"))).toBe(false);
});