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
2.8 KB
Raw Blame
/**
 * `o2b brain activation` CLI surface (Time-Aware Recall & Activation
 * Suite, t_2bc79017): status and sweep over the activation event store.
 */

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

import { recordAccessEvent } from "../../src/core/search/activation/store.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-activation-"));
  vault = join(tmp, "vault");
  mkdirSync(join(vault, "Brain"), { recursive: true });
});

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

test("status reports the folded activation state", async () => {
  const now = Date.now();
  recordAccessEvent(vault, {
    ts: now - 1000,
    queryHash: "abcd0001",
    paths: ["Brain/notes/a.md", "Brain/notes/b.md"],
  });
  recordAccessEvent(vault, {
    ts: now,
    queryHash: "abcd0002",
    paths: ["Brain/notes/a.md"],
  });
  const res = await runCli(["brain", "activation", "status", "--vault", vault, "--json"]);
  expect(res.returncode).toBe(0);
  const body = JSON.parse(res.stdout) as {
    events: number;
    paths: number;
    co_access_pairs: number;
    top: Array<{ path: string; access_count: number }>;
  };
  expect(body.events).toBe(2);
  expect(body.paths).toBe(2);
  expect(body.co_access_pairs).toBe(1);
  expect(body.top[0]?.path).toBe("Brain/notes/a.md");
  expect(body.top[0]?.access_count).toBe(2);
});

test("status on an empty vault is a zero envelope, not an error", async () => {
  const res = await runCli(["brain", "activation", "status", "--vault", vault, "--json"]);
  expect(res.returncode).toBe(0);
  const body = JSON.parse(res.stdout) as { events: number };
  expect(body.events).toBe(0);
});

test("sweep drops events beyond the cap and reports counts", async () => {
  const now = Date.now();
  for (let i = 0; i < 5; i++) {
    recordAccessEvent(vault, {
      ts: now - i * 1000,
      queryHash: "abcd0003",
      paths: [`Brain/n${i}.md`],
    });
  }
  const res = await runCli([
    "brain",
    "activation",
    "sweep",
    "--max-events",
    "2",
    "--vault",
    vault,
    "--json",
  ]);
  expect(res.returncode).toBe(0);
  const body = JSON.parse(res.stdout) as { removed: number; kept: number };
  expect(body.removed).toBe(3);
  expect(body.kept).toBe(2);
});

test("an unknown operation exits 2 with usage", async () => {
  const res = await runCli(["brain", "activation", "bogus", "--vault", vault]);
  expect(res.returncode).toBe(2);
});