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 event-trace` CLI surface: usage errors (bad --kind / --limit,
* malformed selectors) exit with code 2 and a plain stderr message, distinct
* from the exit-1 runtime-failure path. A clean run over an empty log exits 0.
*/
import { afterEach, beforeEach, expect, setDefaultTimeout, test } from "bun:test";
import { mkdirSync, mkdtempSync, 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;
beforeEach(() => {
tmp = mkdtempSync(join(tmpdir(), "o2b-cli-event-trace-"));
vault = join(tmp, "vault");
mkdirSync(join(vault, "Brain", "log"), { recursive: true });
});
afterEach(() => {
rmSync(tmp, { recursive: true, force: true });
});
test("an unknown --kind is a usage error (exit 2, plain stderr)", async () => {
const r = await runCli(["brain", "event-trace", "--vault", vault, "--kind", "not-a-kind"]);
expect(r.returncode).toBe(2);
expect(r.stderr).toContain("unknown event kind");
});
test("a non-positive --limit is a usage error (exit 2)", async () => {
const r = await runCli(["brain", "event-trace", "--vault", vault, "--limit", "0"]);
expect(r.returncode).toBe(2);
expect(r.stderr).toContain("--limit");
});
test("a malformed --at selector is a usage error (exit 2)", async () => {
const r = await runCli(["brain", "event-trace", "--vault", vault, "--at", "10am"]);
expect(r.returncode).toBe(2);
});
test("a clean run over an empty log exits 0", async () => {
const r = await runCli(["brain", "event-trace", "--vault", vault, "--json"]);
expect(r.returncode).toBe(0);
});
test("a runtime IO error reading the log dir is exit 1, not a usage error (exit 2)", async () => {
// Brain/log exists but is a FILE, not a directory: existsSync passes the
// guard in listLogShardFiles, then readdirSync throws ENOTDIR. That is a
// runtime failure (exit 1), distinct from a selector usage error (exit 2) -
// the selectors here are all valid, so the only throw is the IO one.
const ioVault = join(tmp, "io-vault");
mkdirSync(join(ioVault, "Brain"), { recursive: true });
writeFileSync(join(ioVault, "Brain", "log"), "not a directory\n");
const r = await runCli(["brain", "event-trace", "--vault", ioVault, "--json"]);
expect(r.returncode).toBe(1);
});