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
/**
* P5 (t_d067a153): `o2b brain batch-plan --reconcile` plumbs the dispatched-vs-
* ingested gap report through to the CLI. The reconcile logic is covered at the
* core level; this asserts the flag reaches the reconciler, the report rides on
* the JSON output, and omitting the flag leaves the output unchanged.
*/
import { afterEach, beforeEach, describe, expect, setDefaultTimeout, test } from "bun:test";
import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
import { join } from "node:path";
import { tmpdir } from "node:os";
import { hashFile, manifestPath } from "../../src/core/brain/ingest/content-manifest.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 vault: string;
let configHome: string;
let configPath: string;
beforeEach(() => {
vault = mkdtempSync(join(tmpdir(), "o2b-reconcile-cli-vault-"));
configHome = mkdtempSync(join(tmpdir(), "o2b-reconcile-cli-cfg-"));
configPath = join(configHome, "config.yaml");
writeFileSync(configPath, `vault: ${vault}\nagent_name: claude\n`, "utf8");
});
afterEach(() => {
rmSync(vault, { recursive: true, force: true });
rmSync(configHome, { recursive: true, force: true });
});
function write(rel: string): void {
const abs = join(vault, rel);
mkdirSync(join(abs, ".."), { recursive: true });
writeFileSync(abs, "content\n", "utf8");
}
const ENV = () => ({ OPEN_SECOND_BRAIN_CONFIG: configPath });
describe("o2b brain batch-plan --reconcile", () => {
test("emits a gap report naming un-ingested dispatched sources", async () => {
write("Docs/a.md");
write("Docs/b.md");
// No ingest has happened, so every dispatched source is in the gap.
const res = await runCli(["brain", "batch-plan", "Docs", "--reconcile", "--json"], {
env: ENV(),
});
expect(res.returncode).toBe(0);
const plan = JSON.parse(res.stdout);
expect(plan.reconcile.dispatched).toEqual(["Docs/a.md", "Docs/b.md"]);
expect(plan.reconcile.missing).toEqual(["Docs/a.md", "Docs/b.md"]);
expect(plan.reconcile.complete).toBe(false);
});
test("without the flag the JSON omits the reconcile report", async () => {
write("Docs/a.md");
const res = await runCli(["brain", "batch-plan", "Docs", "--json"], { env: ENV() });
expect(res.returncode).toBe(0);
const plan = JSON.parse(res.stdout);
expect(plan.reconcile).toBeUndefined();
});
});
/** Write a v1 (pre-fingerprint era) manifest recording `rel`'s live hash. */
function writeV1Manifest(rel: string): void {
const path = manifestPath(vault);
mkdirSync(join(path, ".."), { recursive: true });
writeFileSync(
path,
JSON.stringify({ schema_version: 1, entries: { [rel]: hashFile(join(vault, rel)) } }),
"utf8",
);
}
describe("o2b brain batch-plan — extraction contract reporting (t_586d5d8b)", () => {
test("--json surfaces the contract change with the contract-changed status", async () => {
write("Docs/a.md");
writeV1Manifest("Docs/a.md");
const res = await runCli(["brain", "batch-plan", "Docs", "--json"], { env: ENV() });
expect(res.returncode).toBe(0);
const plan = JSON.parse(res.stdout) as {
contract_changed?: boolean;
contract_changed_files?: number;
batches: Array<{ files: Array<{ path: string; bytes: number; status: string }> }>;
};
expect(plan.contract_changed).toBe(true);
expect(plan.contract_changed_files).toBe(1);
expect(plan.batches[0]!.files[0]).toEqual({
path: "Docs/a.md",
bytes: "content\n".length,
status: "contract-changed",
});
});
test("an unchanged contract emits no contract keys (byte-identical shape)", async () => {
write("Docs/a.md");
const res = await runCli(["brain", "batch-plan", "Docs", "--json"], { env: ENV() });
expect(res.returncode).toBe(0);
expect(res.stdout).not.toContain("contract_changed");
});
test("text mode reports the contract change", async () => {
write("Docs/a.md");
writeV1Manifest("Docs/a.md");
const res = await runCli(["brain", "batch-plan", "Docs"], { env: ENV() });
expect(res.returncode).toBe(0);
expect(res.stdout).toContain("extraction contract changed");
});
});