Skip to content

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
3.8 KB
Raw Blame
/**
 * CLI tests for `o2b brain audit`.
 *
 * The verb wraps `readPrefAudit` / `renderPrefAudit`. Here we lock the
 * CLI surface: argument normalisation (pref- / ret- / bare slug all
 * resolve to one trail), `--json`, the empty-trail path, and exit code.
 * The audit trail itself is produced by the merge chokepoint, which has
 * its own unit coverage.
 */

import { afterEach, beforeEach, describe, expect, setDefaultTimeout, test } from "bun:test";
import { mkdtempSync, rmSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";

import { writePreference } from "../../src/core/brain/preference.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 config: string;

beforeEach(() => {
  tmp = mkdtempSync(join(tmpdir(), "o2b-audit-cli-test-"));
  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);
}

function makePref(slug: string): void {
  writePreference(vault, {
    slug,
    topic: "commits",
    principle: `Principle for ${slug}`,
    created_at: "2026-05-01T00:00:00Z",
    unconfirmed_until: "2026-05-08T00:00:00Z",
    status: "confirmed",
    confirmed_at: "2026-05-02T00:00:00Z",
    evidenced_by: [`[[sig-2026-05-01-${slug}]]`],
  });
}

describe("o2b brain audit", () => {
  test("usage error with no argument", async () => {
    await bootstrap();
    const r = await runCli(["brain", "audit"], {
      env: { OPEN_SECOND_BRAIN_CONFIG: config },
    });
    expect(r.returncode).not.toBe(0);
  });

  test("reports no records for a preference with no audit trail", async () => {
    await bootstrap();
    const r = await runCli(["brain", "audit", "pref-nothing"], {
      env: { OPEN_SECOND_BRAIN_CONFIG: config },
    });
    expect(r.returncode).toBe(0);
    expect(r.stdout).toContain("no audit records");
  });

  test("renders the merge audit trail (text + json, bare-slug normalised)", async () => {
    await bootstrap();
    makePref("keep");
    makePref("drop");
    const merge = await runCli(["brain", "merge", "pref-keep", "pref-drop", "--force"], {
      env: { OPEN_SECOND_BRAIN_CONFIG: config },
    });
    expect(merge.returncode).toBe(0);

    // Bare slug resolves to the same `pref-keep` trail.
    const text = await runCli(["brain", "audit", "keep"], {
      env: { OPEN_SECOND_BRAIN_CONFIG: config },
    });
    expect(text.returncode).toBe(0);
    expect(text.stdout).toContain("pref-keep");
    expect(text.stdout).toContain("merge");

    const json = await runCli(["brain", "audit", "pref-keep", "--json"], {
      env: { OPEN_SECOND_BRAIN_CONFIG: config },
    });
    expect(json.returncode).toBe(0);
    const parsed = JSON.parse(json.stdout) as {
      pref_id: string;
      records: Array<{ op: string }>;
    };
    expect(parsed.pref_id).toBe("pref-keep");
    expect(parsed.records.some((r) => r.op === "merge")).toBe(true);

    // The dropped pref's trail shows the retire(merged-into).
    const drop = await runCli(["brain", "audit", "ret-drop", "--json"], {
      env: { OPEN_SECOND_BRAIN_CONFIG: config },
    });
    const dropParsed = JSON.parse(drop.stdout) as { records: Array<{ op: string }> };
    expect(dropParsed.records.some((r) => r.op === "retire")).toBe(true);
  });
});