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
/**
* `o2b brain continuity export` (Memory Observability Suite,
* t_51959aeb): read-only ATOF/ATIF export of the continuity store.
*/
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 { bootstrapBrain } from "../../src/core/brain/init.ts";
import { appendContinuityRecord } from "../../src/core/brain/continuity/store.ts";
import { emitRecallTelemetry, RECALL_CHANNEL } from "../../src/core/brain/recall-telemetry.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;
let outDir: string;
beforeEach(() => {
tmp = mkdtempSync(join(tmpdir(), "o2b-continuity-cli-"));
vault = join(tmp, "vault");
configPath = join(tmp, "config.yaml");
outDir = join(tmp, "out");
writeFileSync(configPath, `vault: ${vault}\nagent_name: test-agent\n`);
bootstrapBrain(vault, { configPath });
appendContinuityRecord(vault, {
kind: "session_turn",
createdAt: "2026-06-03T10:00:00.000Z",
payload: { session_id: "s-1", turn_id: "t-1", role: "user", text: "hello" },
});
appendContinuityRecord(vault, {
kind: "gate_telemetry",
createdAt: "2026-06-03T10:00:01.000Z",
payload: { host: "mcp", session_id: "s-1", decision: "skip", reason: "smalltalk" },
});
// A private record must never reach an export file.
appendContinuityRecord(vault, {
kind: "session_turn",
createdAt: "2026-06-03T10:00:02.000Z",
payload: {
session_id: "s-1",
turn_id: "t-2",
role: "user",
text: "carries a <private>secret plan</private> region",
},
});
});
afterEach(() => {
rmSync(tmp, { recursive: true, force: true });
});
const env = () => ({ OPEN_SECOND_BRAIN_CONFIG: configPath });
describe("o2b brain continuity export", () => {
test("atof export writes one JSONL stream and drops private records", async () => {
const out = await runCli(
["brain", "continuity", "export", "--format", "atof", "--out", outDir, "--json"],
{ env: env() },
);
expect(out.returncode).toBe(0);
const parsed = JSON.parse(out.stdout) as { records: number; files: string[] };
expect(parsed.records).toBe(2);
expect(parsed.files).toHaveLength(1);
const content = readFileSync(parsed.files[0]!, "utf8");
expect(content).toContain('"atof_version"');
expect(content).not.toContain("secret plan");
});
test("atif export writes one trajectory per session", async () => {
const out = await runCli(
["brain", "continuity", "export", "--format", "atif", "--out", outDir],
{ env: env() },
);
expect(out.returncode).toBe(0);
const path = join(outDir, "o2b-continuity-s-1.atif.json");
expect(existsSync(path)).toBe(true);
const trajectory = JSON.parse(readFileSync(path, "utf8")) as {
schema_version: string;
steps: Array<{ source: string }>;
};
expect(trajectory.schema_version).toBe("ATIF-v1.7");
expect(trajectory.steps).toHaveLength(2);
expect(trajectory.steps.some((s) => s.source === "system")).toBe(true);
});
test("unknown format and bad month fail with usage errors", async () => {
const bad = await runCli(
["brain", "continuity", "export", "--format", "csv", "--out", outDir],
{ env: env() },
);
expect(bad.returncode).not.toBe(0);
const badMonth = await runCli(
["brain", "continuity", "export", "--format", "atof", "--month", "June", "--out", outDir],
{ env: env() },
);
expect(badMonth.returncode).not.toBe(0);
});
});
describe("o2b brain continuity rank", () => {
test("ranks records by usage decay, recalled source above untouched", async () => {
// A surfaced artifact gives its receipt a usage signal; an equally-aged
// receipt whose source was never surfaced has none and ranks lower.
emitRecallTelemetry(vault, {
createdAt: "2026-06-13T00:00:00.000Z",
host: "t",
channel: RECALL_CHANNEL.cli,
mode: "search",
status: "ok",
durationMs: 1,
resultCount: 1,
topArtifacts: [{ id: "fresh", path: "Brain/notes/fresh.md", score: 0.9 }],
});
appendContinuityRecord(vault, {
kind: "context_receipt",
createdAt: "2026-05-01T00:00:00.000Z",
sourceRefs: [{ id: "fresh", path: "Brain/notes/fresh.md" }],
});
appendContinuityRecord(vault, {
kind: "context_receipt",
createdAt: "2026-05-01T00:00:00.000Z",
sourceRefs: [{ id: "stale", path: "Brain/notes/stale.md" }],
});
const out = await runCli(["brain", "continuity", "rank", "--all", "--json"], { env: env() });
expect(out.returncode).toBe(0);
const parsed = JSON.parse(out.stdout) as {
scope: string;
ranked: Array<{ id: string; weight: number; access_count: number }>;
};
expect(parsed.scope).toBe("all");
const fresh = parsed.ranked.find((r) => r.access_count === 1)!;
const stale = parsed.ranked.find((r) => r.access_count === 0 && r.id !== fresh.id)!;
expect(fresh.weight).toBeGreaterThan(stale.weight);
});
test("a bad --limit fails with a usage error", async () => {
const bad = await runCli(["brain", "continuity", "rank", "--limit", "0"], { env: env() });
expect(bad.returncode).not.toBe(0);
});
});