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
5.0 KB
Raw Blame
/**
 * `o2b brain vitals` CLI surface: aggregate governance scorecard over
 * confirmed `Brain/preferences/` (domain diversity, connectivity
 * index, orphan preferences, gap pressure), plus the recorded
 * `vault_vitals` metric.
 */

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

import { bootstrapBrain } from "../../src/core/brain/init.ts";
import { writePreference } from "../../src/core/brain/preference.ts";
import { listMetrics } from "../../src/core/brain/metrics.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;

function pref(
  slug: string,
  scope: string,
  evidencedBy: string[],
  status: "confirmed" | "unconfirmed" = "confirmed",
): void {
  writePreference(vault, {
    slug,
    topic: slug,
    principle: `principle for ${slug}`,
    created_at: "2026-05-20T00:00:00Z",
    confirmed_at: status === "confirmed" ? "2026-05-21T00:00:00Z" : null,
    unconfirmed_until: "2026-06-03T00:00:00Z",
    status,
    scope,
    evidenced_by: evidencedBy,
    applied_count: evidencedBy.length,
    violated_count: 0,
    last_evidence_at: "2026-05-22T00:00:00Z",
    confidence: "low",
  });
}

beforeEach(() => {
  vault = mkdtempSync(join(tmpdir(), "o2b-cli-vitals-"));
  bootstrapBrain(vault);
});

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

test("no preferences: zeroed report, no crash", async () => {
  const r = await runCli(["brain", "vitals", "--vault", vault, "--json"]);
  expect(r.returncode).toBe(0);
  expect(JSON.parse(r.stdout)).toMatchObject({
    preferences_scanned: 0,
    domain_diversity: 0,
    connectivity_index: 0,
    gap_pressure: 0,
    orphan_preferences: [],
  });
});

test("single scope: zero diversity even with many preferences", async () => {
  pref("a", "coding", ["[[sig-1]]", "[[sig-2]]"]);
  pref("b", "coding", ["[[sig-3]]", "[[sig-4]]"]);
  const r = await runCli(["brain", "vitals", "--vault", vault, "--json"]);
  const parsed = JSON.parse(r.stdout) as { domain_diversity: number; preferences_scanned: number };
  expect(parsed.preferences_scanned).toBe(2);
  expect(parsed.domain_diversity).toBe(0);
});

test("evenly split scopes: diversity approaches 1", async () => {
  pref("a", "coding", ["[[sig-1]]", "[[sig-2]]"]);
  pref("b", "personal", ["[[sig-3]]", "[[sig-4]]"]);
  const r = await runCli(["brain", "vitals", "--vault", vault, "--json"]);
  const parsed = JSON.parse(r.stdout) as { domain_diversity: number };
  expect(parsed.domain_diversity).toBe(1);
});

test("connectivity_index averages evidenced_by length over confirmed prefs only", async () => {
  pref("a", "coding", ["[[sig-1]]", "[[sig-2]]", "[[sig-3]]"]); // 3
  pref("b", "coding", ["[[sig-4]]"]); // 1
  pref("c", "coding", ["[[sig-5]]", "[[sig-6]]"], "unconfirmed"); // excluded
  const r = await runCli(["brain", "vitals", "--vault", vault, "--json"]);
  const parsed = JSON.parse(r.stdout) as {
    connectivity_index: number;
    preferences_scanned: number;
  };
  expect(parsed.preferences_scanned).toBe(2); // unconfirmed excluded
  expect(parsed.connectivity_index).toBe(2); // (3 + 1) / 2
});

test("orphan_preferences below --orphan-threshold, default 2", async () => {
  pref("thin", "coding", ["[[sig-1]]"]); // 1 < 2 -> orphan
  pref("solid", "coding", ["[[sig-2]]", "[[sig-3]]"]); // 2 -> not orphan
  const r = await runCli(["brain", "vitals", "--vault", vault, "--json"]);
  const parsed = JSON.parse(r.stdout) as {
    orphan_preferences: Array<{ id: string; evidence_count: number }>;
  };
  expect(parsed.orphan_preferences).toHaveLength(1);
  expect(parsed.orphan_preferences[0]).toMatchObject({ id: "pref-thin", evidence_count: 1 });
});

test("--orphan-threshold overrides the default", async () => {
  pref("solid", "coding", ["[[sig-1]]", "[[sig-2]]", "[[sig-3]]"]); // 3
  const r = await runCli([
    "brain",
    "vitals",
    "--orphan-threshold",
    "4",
    "--vault",
    vault,
    "--json",
  ]);
  const parsed = JSON.parse(r.stdout) as { orphan_preferences: unknown[] };
  expect(parsed.orphan_preferences).toHaveLength(1); // 3 < 4 now counts
});

test("records one vault_vitals metric per run", async () => {
  pref("a", "coding", ["[[sig-1]]", "[[sig-2]]"]);
  await runCli(["brain", "vitals", "--vault", vault, "--json"]);
  const metrics = listMetrics(vault, { surface: "vault_vitals" });
  expect(metrics).toHaveLength(1);
  expect(metrics[0]!.payload).toMatchObject({
    preferences_scanned: 1,
    connectivity_index: 2,
  });
});

test("usage errors exit 2", async () => {
  const badThreshold = await runCli([
    "brain",
    "vitals",
    "--orphan-threshold",
    "0",
    "--vault",
    vault,
  ]);
  expect(badThreshold.returncode).toBe(2);
  const extraArg = await runCli(["brain", "vitals", "nope", "--vault", vault]);
  expect(extraArg.returncode).toBe(2);
});