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.1 KB
Raw Blame
/**
 * `o2b brain project <link|list|remove|status>` (Workspace Insight
 * Suite, t_1375e69f): CLI surface over project vault pointers.
 */

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 { VAULT_POINTER_FILE } from "../../src/core/brain/portability/pointer.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 project: string;
let config: string;

beforeEach(() => {
  tmp = mkdtempSync(join(tmpdir(), "o2b-project-cli-"));
  vault = join(tmp, "vault");
  project = join(tmp, "project");
  mkdirSync(join(vault, "Brain"), { recursive: true });
  mkdirSync(project, { recursive: true });
  config = join(tmp, "config.yaml");
  writeFileSync(config, `vault: "${vault}"\n`);
});

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

const env = () => ({ OPEN_SECOND_BRAIN_CONFIG: config });

test("link writes the pointer and registers the project", async () => {
  const r = await runCli(["brain", "project", "link", project, "--json"], { env: env() });
  expect(r.returncode).toBe(0);
  const parsed = JSON.parse(r.stdout) as Record<string, unknown>;
  expect(parsed["vault"]).toBe(vault);
  expect(existsSync(join(project, VAULT_POINTER_FILE))).toBe(true);

  const list = await runCli(["brain", "project", "list", "--json"], { env: env() });
  const listed = JSON.parse(list.stdout) as { projects: Array<{ path: string; vault: string }> };
  expect(listed.projects).toHaveLength(1);
  expect(listed.projects[0]!.path).toBe(project);
});

test("a command launched from the linked directory resolves the owning vault", async () => {
  const otherVault = join(tmp, "other-vault");
  mkdirSync(join(otherVault, "Brain"), { recursive: true });
  const link = await runCli(["brain", "project", "link", project, "--vault", otherVault], {
    env: env(),
  });
  expect(link.returncode).toBe(0);

  const nested = join(project, "packages", "api");
  mkdirSync(nested, { recursive: true });
  const status = await runCli(["brain", "project", "status", "--json"], {
    env: env(),
    cwd: nested,
  });
  expect(status.returncode).toBe(0);
  const parsed = JSON.parse(status.stdout) as Record<string, unknown>;
  expect(parsed["resolved_vault"]).toBe(otherVault);
  expect(parsed["resolution"]).toBe("pointer");
});

test("status reports malformed pointers and registry health", async () => {
  await runCli(["brain", "project", "link", project], { env: env() });
  writeFileSync(join(project, VAULT_POINTER_FILE), "{broken");
  const status = await runCli(["brain", "project", "status", project, "--json"], { env: env() });
  expect(status.returncode).toBe(0);
  const parsed = JSON.parse(status.stdout) as {
    pointer: { error: string | null } | null;
    projects: Array<{ pointer: string }>;
  };
  expect(parsed.pointer?.error).not.toBeNull();
  expect(parsed.projects[0]!.pointer).toBe("malformed");
});

test("link refuses a directory inside the vault", async () => {
  const inside = join(vault, "Brain", "area");
  mkdirSync(inside, { recursive: true });
  const r = await runCli(["brain", "project", "link", inside], { env: env() });
  expect(r.returncode).not.toBe(0);
  expect(r.stderr).toContain("inside");
});

test("remove deletes the pointer and the registry entry", async () => {
  await runCli(["brain", "project", "link", project], { env: env() });
  const r = await runCli(["brain", "project", "remove", project, "--json"], { env: env() });
  expect(r.returncode).toBe(0);
  expect(existsSync(join(project, VAULT_POINTER_FILE))).toBe(false);
  const list = await runCli(["brain", "project", "list", "--json"], { env: env() });
  expect((JSON.parse(list.stdout) as { projects: unknown[] }).projects).toHaveLength(0);

  const again = await runCli(["brain", "project", "remove", project], { env: env() });
  expect(again.returncode).not.toBe(0);
});