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
/**
* CLI coverage for `o2b brain snapshot diff` and the new
* `--dry-run` mode of `o2b brain rollback`.
*
* Both surfaces share the same diff renderer, so the assertions
* here focus on argument handling, exit codes, and the integration
* between `extractSnapshotToTemp`, `diffBrainTrees`, and the
* markdown / JSON output channels.
*/
import { afterEach, beforeEach, describe, expect, setDefaultTimeout, test } from "bun:test";
import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
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 config: string;
beforeEach(() => {
tmp = mkdtempSync(join(tmpdir(), "o2b-cli-snapdiff-"));
vault = join(tmp, "vault");
config = join(tmp, "config.yaml");
});
afterEach(() => {
rmSync(tmp, { recursive: true, force: true });
});
async function bootstrap(): Promise<void> {
const init = await runCli(["init", "--vault", vault, "--name", "Test"], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
expect(init.returncode).toBe(0);
const brainInit = await runCli(["brain", "init", "--vault", vault], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
expect(brainInit.returncode).toBe(0);
}
async function seedDream(): Promise<string> {
for (const slug of ["a", "b", "c"]) {
const r = await runCli(
[
"brain",
"feedback",
"--vault",
vault,
"--topic",
"diff-demo",
"--signal",
"positive",
"--principle",
"Take care",
"--slug",
`diff-demo-${slug}`,
],
{ env: { OPEN_SECOND_BRAIN_CONFIG: config } },
);
expect(r.returncode).toBe(0);
}
const d = await runCli(["brain", "dream", "--vault", vault], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
expect(d.returncode).toBe(0);
const list = await runCli(["brain", "rollback", "--list", "--vault", vault, "--json"], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
expect(list.returncode).toBe(0);
const snaps = JSON.parse(list.stdout) as ReadonlyArray<{ run_id: string }>;
expect(snaps.length).toBeGreaterThan(0);
return snaps[0]!.run_id;
}
describe("brain rollback --dry-run", () => {
test("prints diff without modifying Brain/", async () => {
await bootstrap();
const runId = await seedDream();
// Add a fresh pref AFTER the snapshot so the diff has content
// (the "added" side appears in live but not in the snapshot).
writeFileSync(
join(vault, "Brain", "preferences", "pref-extra.md"),
`---
kind: brain-preference
id: pref-extra
created_at: 2026-05-17T10:00:00Z
_confirmed_at: "null"
unconfirmed_until: 2026-06-17T10:00:00Z
tags: [brain, brain/preference]
topic: extra
_status: unconfirmed
principle: Added after snapshot
_evidenced_by: []
_applied_count: 0
_violated_count: 0
_last_evidence_at: "null"
_confidence: low
_confidence_value: 0
pinned: false
---
`,
"utf8",
);
const r = await runCli(["brain", "rollback", runId, "--dry-run", "--vault", vault], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
expect(r.returncode).toBe(0);
expect(r.stdout).toMatch(/^# Brain snapshot diff$/m);
expect(r.stdout).toMatch(/^- A: live$/m);
expect(r.stdout).toContain(`- B: ${runId}`);
expect(r.stdout).toMatch(/^- - \[\[pref-extra\|Added after snapshot\]\] \(removed\)$/m);
// Live tree must NOT have been touched.
expect(existsSync(join(vault, "Brain", "preferences", "pref-extra.md"))).toBe(true);
});
test("--dry-run + --yes is an error", async () => {
await bootstrap();
const runId = await seedDream();
const r = await runCli(["brain", "rollback", runId, "--dry-run", "--yes", "--vault", vault], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
expect(r.returncode).toBe(1);
expect(r.stderr).toMatch(/mutually exclusive/);
});
test("--dry-run --json returns parseable JSON", async () => {
await bootstrap();
const runId = await seedDream();
const r = await runCli(["brain", "rollback", runId, "--dry-run", "--vault", vault, "--json"], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
expect(r.returncode).toBe(0);
const payload = JSON.parse(r.stdout);
expect(payload).toHaveProperty("added");
expect(payload).toHaveProperty("removed");
expect(payload).toHaveProperty("modified");
});
test("unknown run_id exits 2", async () => {
await bootstrap();
const r = await runCli(["brain", "rollback", "no-such-run", "--dry-run", "--vault", vault], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
expect(r.returncode).toBe(2);
});
});
describe("brain snapshot diff", () => {
test("snapshot vs live", async () => {
await bootstrap();
const runId = await seedDream();
// Mutate live so the diff has content.
writeFileSync(
join(vault, "Brain", "preferences", "pref-added.md"),
`---
kind: brain-preference
id: pref-added
created_at: 2026-05-17T10:00:00Z
_confirmed_at: "null"
unconfirmed_until: 2026-06-17T10:00:00Z
tags: [brain, brain/preference]
topic: added
_status: unconfirmed
principle: Added principle
_evidenced_by: []
_applied_count: 0
_violated_count: 0
_last_evidence_at: "null"
_confidence: low
_confidence_value: 0
pinned: false
---
`,
"utf8",
);
const r = await runCli(["brain", "snapshot", "diff", runId, "--vault", vault], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
expect(r.returncode).toBe(0);
expect(r.stdout).toMatch(/^- B: live$/m);
expect(r.stdout).toMatch(/\[\[pref-added\|Added principle\]\]/);
});
test("two snapshots", async () => {
await bootstrap();
const first = await seedDream();
// Add evidence and run dream again so a second snapshot is created.
const fb = await runCli(
[
"brain",
"feedback",
"--vault",
vault,
"--topic",
"again",
"--signal",
"positive",
"--principle",
"Be careful",
"--slug",
"again-1",
],
{ env: { OPEN_SECOND_BRAIN_CONFIG: config } },
);
expect(fb.returncode).toBe(0);
for (const s of ["2", "3"]) {
const seed = await runCli(
[
"brain",
"feedback",
"--vault",
vault,
"--topic",
"again",
"--signal",
"positive",
"--principle",
"Be careful",
"--slug",
`again-${s}`,
],
{ env: { OPEN_SECOND_BRAIN_CONFIG: config } },
);
expect(seed.returncode).toBe(0);
}
const d2 = await runCli(["brain", "dream", "--vault", vault], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
expect(d2.returncode).toBe(0);
const list = await runCli(["brain", "rollback", "--list", "--vault", vault, "--json"], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
const snaps = JSON.parse(list.stdout) as ReadonlyArray<{ run_id: string }>;
expect(snaps.length).toBeGreaterThanOrEqual(2);
const second = snaps.find((s) => s.run_id !== first)!.run_id;
const r = await runCli(["brain", "snapshot", "diff", first, second, "--vault", vault], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
expect(r.returncode).toBe(0);
expect(r.stdout).toContain(`- A: ${first}`);
expect(r.stdout).toContain(`- B: ${second}`);
// Seven sequential CLI invocations legitimately exceed bun's 5s
// default per-test timeout on a loaded machine.
}, 20000);
test("--json returns parseable JSON", async () => {
await bootstrap();
const runId = await seedDream();
const r = await runCli(["brain", "snapshot", "diff", runId, "--vault", vault, "--json"], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
expect(r.returncode).toBe(0);
const parsed = JSON.parse(r.stdout);
expect(parsed).toHaveProperty("added");
});
test("missing positional arg exits 1", async () => {
await bootstrap();
const r = await runCli(["brain", "snapshot", "diff", "--vault", vault], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
expect(r.returncode).toBe(1);
});
test("unknown run_id exits 2", async () => {
await bootstrap();
const r = await runCli(["brain", "snapshot", "diff", "no-such-run", "--vault", vault], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
expect(r.returncode).toBe(2);
});
test("snapshot help exits 0", async () => {
await bootstrap();
const r = await runCli(["brain", "snapshot", "--help", "--vault", vault], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
// Without --help arg → return 2; WITH --help → 0.
expect(r.returncode).toBe(0);
expect(r.stdout).toContain("o2b brain snapshot");
expect(r.stdout).toContain("diff");
});
test("unknown sub-verb exits 2", async () => {
await bootstrap();
const r = await runCli(["brain", "snapshot", "no-such-verb", "--vault", vault], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
expect(r.returncode).toBe(2);
});
});
// Silence the unused-import warning when test fixtures change.
void readFileSync;