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
4.5 KB
Raw Blame
/**
 * `o2b brain bridges` CLI surface (t_ab540afe): discover regenerates
 * the proposals artifact and records the bridge_discovery metric;
 * accept/dismiss manage one pair; list reads the artifact back.
 * Fail-soft paths (no index, no embeddings) exit 0 with a reason.
 */

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

import { indexVault } from "../../src/core/search/indexer.ts";
import { listMetrics } from "../../src/core/brain/metrics.ts";
import { makeConfig } from "../helpers/search-fixtures.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;

beforeEach(() => {
  tmp = mkdtempSync(join(tmpdir(), "o2b-cli-bridges-"));
  vault = join(tmp, "vault");
  mkdirSync(join(vault, "Brain"), { recursive: true });
  writeFileSync(join(vault, "a-note.md"), "# A note\n\nCanary deployment content here.\n");
  writeFileSync(join(vault, "b-note.md"), "# B note\n\nUnrelated content entirely.\n");
});

afterEach(() => {
  rmSync(tmp, { recursive: true, force: true });
});

async function indexWithoutEmbeddings(): Promise<void> {
  const config = makeConfig({
    vault,
    dbPath: join(vault, ".open-second-brain", "brain.sqlite"),
  });
  await indexVault(config);
}

test("discover on an unindexed vault exits 0 with a reason", async () => {
  const r = await runCli(["brain", "bridges", "discover", "--vault", vault, "--json"]);
  expect(r.returncode).toBe(0);
  const parsed = JSON.parse(r.stdout) as { vec_available: boolean; reason: string };
  expect(parsed.vec_available).toBe(false);
  expect(parsed.reason).toContain("index");
});

test("discover without embeddings writes the artifact, metric, and exits 0", async () => {
  await indexWithoutEmbeddings();
  const r = await runCli(["brain", "bridges", "discover", "--vault", vault, "--json"]);
  expect(r.returncode).toBe(0);
  const parsed = JSON.parse(r.stdout) as { vec_available: boolean; proposals: unknown[] };
  expect(parsed.vec_available).toBe(false);
  expect(parsed.proposals).toEqual([]);
  expect(existsSync(join(vault, "Brain", "proposals", "bridges.md"))).toBe(true);
  const metrics = listMetrics(vault, { surface: "bridge_discovery" });
  expect(metrics).toHaveLength(1);
  expect(metrics[0]!.payload["vec_available"]).toBe(false);
});

test("list before and after discover", async () => {
  const before = await runCli(["brain", "bridges", "list", "--vault", vault, "--json"]);
  expect(JSON.parse(before.stdout)).toMatchObject({ exists: false });

  await indexWithoutEmbeddings();
  await runCli(["brain", "bridges", "discover", "--vault", vault]);
  const after = await runCli(["brain", "bridges", "list", "--vault", vault, "--json"]);
  const parsed = JSON.parse(after.stdout) as { exists: boolean; proposals: number };
  expect(parsed.exists).toBe(true);
  expect(parsed.proposals).toBe(0);
});

test("accept writes related into the source and is idempotent", async () => {
  const first = await runCli([
    "brain",
    "bridges",
    "accept",
    "a-note.md",
    "b-note.md",
    "--vault",
    vault,
    "--json",
  ]);
  expect(first.returncode).toBe(0);
  expect(JSON.parse(first.stdout)).toMatchObject({ changed: true, related: ["[[b-note]]"] });

  const again = await runCli([
    "brain",
    "bridges",
    "accept",
    "a-note.md",
    "b-note.md",
    "--vault",
    vault,
    "--json",
  ]);
  expect(JSON.parse(again.stdout)).toMatchObject({ changed: false });
});

test("dismiss persists and reports repeats", async () => {
  const first = await runCli([
    "brain",
    "bridges",
    "dismiss",
    "a-note.md",
    "b-note.md",
    "--vault",
    vault,
    "--json",
  ]);
  expect(JSON.parse(first.stdout)).toMatchObject({ added: true });
  const again = await runCli([
    "brain",
    "bridges",
    "dismiss",
    "b-note.md",
    "a-note.md",
    "--vault",
    vault,
    "--json",
  ]);
  expect(JSON.parse(again.stdout)).toMatchObject({ added: false });
});

test("usage errors exit 2", async () => {
  const r = await runCli(["brain", "bridges", "accept", "only-one.md", "--vault", vault]);
  expect(r.returncode).toBe(2);
  const bad = await runCli([
    "brain",
    "bridges",
    "discover",
    "--min-similarity",
    "5",
    "--vault",
    vault,
  ]);
  expect(bad.returncode).toBe(2);
});