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
import { describe, expect, test } from "bun:test";
import {
detectHookRuntime,
isArtifactToolName,
isBrainEventToolName,
summarizeTurn,
} from "../../hooks/lib/detect.ts";
describe("isArtifactToolName", () => {
test.each([["Write"], ["Edit"], ["MultiEdit"], ["apply_patch"]])("%s is an artifact", (name) => {
expect(isArtifactToolName(name)).toBe(true);
});
test.each([["Bash"], ["Read"], ["Grep"], ["event_log_append"], ["second_brain_status"]])(
"%s is NOT an artifact",
(name) => {
expect(isArtifactToolName(name)).toBe(false);
},
);
});
describe("isBrainEventToolName", () => {
// §32 (v0.10.8): the three Brain-native writer tools are the only
// names that clear the guardrail. `event_log_append` no longer
// qualifies — the corresponding MCP tool is gone from every runtime.
test("recognises `brain_feedback` (bare and decorated)", () => {
expect(isBrainEventToolName("brain_feedback")).toBe(true);
expect(
isBrainEventToolName("mcp__plugin_open-second-brain_open-second-brain__brain_feedback"),
).toBe(true);
expect(isBrainEventToolName("mcp__open-second-brain__brain_feedback")).toBe(true);
});
test("recognises `brain_apply_evidence` (bare and decorated)", () => {
expect(isBrainEventToolName("brain_apply_evidence")).toBe(true);
expect(
isBrainEventToolName("mcp__plugin_open-second-brain_open-second-brain__brain_apply_evidence"),
).toBe(true);
});
test("recognises `brain_note` (bare and decorated) — §32B", () => {
expect(isBrainEventToolName("brain_note")).toBe(true);
expect(
isBrainEventToolName("mcp__plugin_open-second-brain_open-second-brain-writer__brain_note"),
).toBe(true);
});
test("event_log_append no longer counts as a brain event — §32", () => {
expect(isBrainEventToolName("event_log_append")).toBe(false);
expect(
isBrainEventToolName("mcp__plugin_open-second-brain_open-second-brain__event_log_append"),
).toBe(false);
expect(isBrainEventToolName("mcp__open-second-brain__event_log_append")).toBe(false);
});
test("rejects unrelated names", () => {
expect(isBrainEventToolName("second_brain_capture")).toBe(false);
expect(isBrainEventToolName("Write")).toBe(false);
expect(isBrainEventToolName("brain_feedback_other")).toBe(false);
expect(isBrainEventToolName("not_brain_feedback")).toBe(false);
});
test("rejects names that contain the suffix but not as a `__`-bounded token", () => {
expect(isBrainEventToolName("xbrain_feedback")).toBe(false);
expect(isBrainEventToolName("xbrain_note")).toBe(false);
});
test("rejects nearby but non-matching brain_* names", () => {
expect(isBrainEventToolName("brain_query")).toBe(false);
expect(isBrainEventToolName("brain_doctor")).toBe(false);
expect(isBrainEventToolName("brain_digest")).toBe(false);
});
});
describe("summarizeTurn", () => {
test("artifact without log → hadArtifact && !hadBrainEvent", () => {
const s = summarizeTurn([{ name: "Write" }, { name: "Bash" }]);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: false });
});
test("artifact AND MCP `brain_feedback` → hadBrainEvent wins", () => {
const s = summarizeTurn([{ name: "Write" }, { name: "brain_feedback" }]);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: true });
});
test("artifact + MCP `brain_note` (§32B) clears guardrail", () => {
const s = summarizeTurn([{ name: "apply_patch" }, { name: "brain_note" }]);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: true });
});
test("artifact + bash `o2b append-event` (deprecated, §32) does NOT clear guardrail", () => {
// §32 (v0.10.8): the Daily/-targeted CLI verb still works for
// humans/cron but no longer counts as a Brain-side event.
const s = summarizeTurn(
[{ name: "apply_patch" }, { name: "Bash" }],
["o2b append-event 'fixed bug'"],
);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: false });
});
test("artifact + bash `vault-log` (deprecated, §32) does NOT clear guardrail", () => {
const s = summarizeTurn([{ name: "Write" }, { name: "Bash" }], ["vault-log 'noted finding'"]);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: false });
});
test("artifact + bash that touches a `vault-log` path is not misread as a CLI call", () => {
const s = summarizeTurn(
[{ name: "Write" }, { name: "Bash" }],
["cat /srv/audit/vault-log.json"],
);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: false });
});
test("starting the MCP server (`o2b mcp …`) does NOT count as log", () => {
// Spawning `o2b mcp` only launches the server subprocess — it
// does not append anything to the daily log. Regression guard
// against an earlier, looser needle list that incorrectly
// treated `o2b mcp` as a log call.
const s = summarizeTurn([{ name: "Write" }, { name: "Bash" }], ["o2b mcp --vault /tmp/vault"]);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: false });
});
test("bash without an OSB log command does NOT count as log", () => {
const s = summarizeTurn([{ name: "Write" }, { name: "Bash" }], ["echo hello"]);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: false });
});
test("read-only tools yield no artifact", () => {
const s = summarizeTurn([{ name: "Read" }, { name: "Grep" }]);
expect(s).toEqual({ hadArtifact: false, hadBrainEvent: false });
});
// §30 §A (v0.10.6) coverage: every brain-event variant counts.
test("artifact + `brain_feedback` MCP call clears guardrail", () => {
const s = summarizeTurn([
{ name: "Write" },
{ name: "mcp__plugin_open-second-brain_open-second-brain__brain_feedback" },
]);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: true });
});
test("artifact + `brain_apply_evidence` MCP call clears guardrail", () => {
const s = summarizeTurn([{ name: "apply_patch" }, { name: "brain_apply_evidence" }]);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: true });
});
test("artifact + bash `o2b brain feedback` clears guardrail", () => {
const s = summarizeTurn(
[{ name: "Edit" }, { name: "Bash" }],
["o2b brain feedback --topic foo --signal positive --principle bar"],
);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: true });
});
test("artifact + bash `o2b brain apply-evidence` clears guardrail", () => {
const s = summarizeTurn(
[{ name: "MultiEdit" }, { name: "Bash" }],
["o2b brain apply-evidence --pref pref-foo --artifact '[[a]]' --result applied"],
);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: true });
});
// v0.10.10 — CLI mirror of `brain_note` MCP tool.
test("artifact + bash `o2b brain note <text>` clears guardrail", () => {
const s = summarizeTurn(
[{ name: "Write" }, { name: "Bash" }],
['o2b brain note "v0.10.10 released"'],
);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: true });
});
test("artifact + env-prefixed bash `o2b brain note <text>` clears guardrail", () => {
const s = summarizeTurn(
[{ name: "Write" }, { name: "Bash" }],
['VAULT_DIR=/tmp/vault o2b brain note "v0.10.10 released"'],
);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: true });
});
test("echoing `o2b brain note` text does NOT clear guardrail", () => {
const s = summarizeTurn(
[{ name: "Write" }, { name: "Bash" }],
["echo 'o2b brain note \"not executed\"'"],
);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: false });
});
test("commented `o2b brain note` text does NOT clear guardrail", () => {
const s = summarizeTurn(
[{ name: "Write" }, { name: "Bash" }],
['# o2b brain note "not executed"'],
);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: false });
});
test("quoted `o2b brain note` after a separator does NOT clear guardrail", () => {
const s = summarizeTurn(
[{ name: "Write" }, { name: "Bash" }],
['echo "; o2b brain note not executed"'],
);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: false });
});
test("actual `o2b brain note` after a separator clears guardrail", () => {
const s = summarizeTurn(
[{ name: "Write" }, { name: "Bash" }],
['cd /tmp && o2b brain note "executed"'],
);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: true });
});
test("escaped separator does NOT split a segment", () => {
// Outside quotes, `\;` is a literal semicolon — bash treats it as
// part of the previous token, so the line is one segment. If the
// splitter were to break on `;` regardless, an echo containing
// `o2b brain note` after the escaped semicolon could falsely
// clear the guardrail.
const s = summarizeTurn(
[{ name: "Write" }, { name: "Bash" }],
['echo \\; o2b brain note "not executed"'],
);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: false });
});
test("`o2b brain notes` lookalike does NOT clear guardrail", () => {
// Trailing-space anchor in the needle list prevents a future
// `notes` / `note-...` verb from being silently treated as a
// brain event.
const s = summarizeTurn(
[{ name: "Write" }, { name: "Bash" }],
["o2b brain notes --vault /tmp/x"],
);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: false });
});
test("artifact + `o2b brain query` does NOT clear guardrail (read-only)", () => {
const s = summarizeTurn(
[{ name: "Write" }, { name: "Bash" }],
["o2b brain query --preference pref-foo"],
);
expect(s).toEqual({ hadArtifact: true, hadBrainEvent: false });
});
});
describe("detectHookRuntime", () => {
test("Claude Code Stop payload outside ~/.claude → claudecode; Codex Stop (turn_id) is not", () => {
const stop = {
hook_event_name: "Stop",
session_id: "s",
cwd: "/w",
transcript_path: "/custom/config/projects/-w/abc.jsonl",
stop_hook_active: false,
last_assistant_message: "done",
};
expect(detectHookRuntime(stop)).toBe("claudecode");
expect(detectHookRuntime({ ...stop, turn_id: "t1" })).toBe("unknown");
expect(detectHookRuntime({ ...stop, hook_event_name: "SubagentStop" })).toBe("unknown");
});
test("Claude Code transcript path → claudecode", () => {
expect(
detectHookRuntime({
transcript_path: "/Users/x/.claude/projects/-srv/projects/foo/abc.jsonl",
}),
).toBe("claudecode");
});
test("Codex transcript path → codex", () => {
expect(
detectHookRuntime({
transcript_path: "/root/.codex/sessions/2026-05-18.json",
}),
).toBe("codex");
});
test("native Windows transcript paths (backslashes) are recognised too", () => {
expect(
detectHookRuntime({
transcript_path: "C:\\Users\\x\\.claude\\projects\\C--proj\\abc.jsonl",
}),
).toBe("claudecode");
expect(
detectHookRuntime({
transcript_path: "C:\\Users\\x\\.codex\\sessions\\2026-05-18.json",
}),
).toBe("codex");
});
test("Claude Code triple without transcript_path → claudecode", () => {
expect(
detectHookRuntime({
session_id: "x",
cwd: "/srv",
tool_use_id: "y",
}),
).toBe("claudecode");
});
test("Codex apply_patch shape → codex", () => {
expect(
detectHookRuntime({
tool_name: "apply_patch",
tool_input: {
input: "*** Begin Patch\n*** Update File: /tmp/x\n*** End Patch",
},
}),
).toBe("codex");
});
test("apply_patch without a recognisable body → unknown", () => {
// The tool name alone is not enough — runtime detection requires
// the patch body so we never label hand-rolled payloads.
expect(
detectHookRuntime({
tool_name: "apply_patch",
tool_input: { input: "not a patch" },
}),
).toBe("unknown");
});
test("malformed payloads → unknown without throwing", () => {
expect(detectHookRuntime(null)).toBe("unknown");
expect(detectHookRuntime(undefined)).toBe("unknown");
expect(detectHookRuntime("string")).toBe("unknown");
expect(detectHookRuntime(42)).toBe("unknown");
expect(detectHookRuntime({})).toBe("unknown");
expect(detectHookRuntime({ transcript_path: 42 })).toBe("unknown");
});
});