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
/**
* Capture-boundary and fact-extraction wiring at the LIVE seam
* (Memory Integrity Suite, t_0532ed5a + t_d0782ab2).
*
* Pipeline order is the contract: classify/suppress first, extract
* second. Ignored sessions produce nothing but the audit row;
* stateless sessions write no Brain state; suppressed messages never
* reach marker or fact extraction; facts extract only from text that
* passed the boundary.
*/
import { afterEach, beforeEach, describe, expect, test } from "bun:test";
import { existsSync, mkdtempSync, readFileSync, readdirSync, rmSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { bootstrapBrain } from "../../../src/core/brain/init.ts";
import { atomicWriteFileSync } from "../../../src/core/fs-atomic.ts";
import { brainConfigPath, brainDirs } from "../../../src/core/brain/paths.ts";
import { captureSessionLifecycleEvent } from "../../../src/core/brain/session-lifecycle.ts";
import { upsertEntity } from "../../../src/core/brain/entities/registry.ts";
import { parseSignal } from "../../../src/core/brain/signal.ts";
let vault: string;
const NOW = new Date("2026-06-02T10:00:00Z");
beforeEach(() => {
vault = mkdtempSync(join(tmpdir(), "o2b-lifecycle-boundary-"));
bootstrapBrain(vault);
});
afterEach(() => {
rmSync(vault, { recursive: true, force: true });
});
function setSessionsPolicy(lines: string[]): void {
const path = brainConfigPath(vault);
atomicWriteFileSync(path, readFileSync(path, "utf8") + "\n" + lines.join("\n") + "\n");
}
function inboxSignals(): string[] {
const dir = brainDirs(vault).inbox;
if (!existsSync(dir)) return [];
return readdirSync(dir).filter((n) => n.startsWith("sig-") && n.endsWith(".md"));
}
const MARKER_PROMPT =
'@osb feedback positive topic=boundary-check principle="capture only what passed the boundary"';
describe("ignored sessions", () => {
test("produce no signals, no lifecycle log, only the audit row", async () => {
setSessionsPolicy(["sessions:", " ignore_patterns:", ' - "cron-*"']);
const result = await captureSessionLifecycleEvent(
vault,
{ hook_event_name: "UserPromptSubmit", session_id: "cron-nightly", prompt: MARKER_PROMPT },
{ agent: "tester", now: NOW },
);
expect(result.boundary_decision).toBe("ignore");
expect(result.signals_created).toBe(0);
expect(result.log_path).toBeUndefined();
expect(result.audit_path).toContain("session-lifecycle");
expect(inboxSignals()).toEqual([]);
expect(existsSync(join(brainDirs(vault).log, "2026-06-02.md"))).toBe(false);
});
});
describe("stateless sessions", () => {
test("write no signals and no lifecycle log", async () => {
setSessionsPolicy(["sessions:", " stateless_patterns:", ' - "probe-*"']);
const result = await captureSessionLifecycleEvent(
vault,
{ hook_event_name: "UserPromptSubmit", session_id: "probe-7", prompt: MARKER_PROMPT },
{ agent: "tester", now: NOW },
);
expect(result.boundary_decision).toBe("stateless");
expect(result.signals_created).toBe(0);
expect(result.log_path).toBeUndefined();
expect(inboxSignals()).toEqual([]);
});
});
describe("message suppression", () => {
test("a suppressed prompt never reaches marker or fact extraction", async () => {
setSessionsPolicy(["sessions:", " ignore_message_patterns:", ' - "^.osb feedback"']);
const result = await captureSessionLifecycleEvent(
vault,
{ hook_event_name: "UserPromptSubmit", session_id: "real-session", prompt: MARKER_PROMPT },
{ agent: "tester", now: NOW },
);
expect(result.boundary_decision).toBe("capture");
expect(result.suppressed_messages).toBe(1);
expect(result.signals_created).toBe(0);
expect(inboxSignals()).toEqual([]);
// The lifecycle log still records the event (the suppression is
// counted, the content is not persisted).
expect(result.log_path).toBeDefined();
});
});
describe("unconfigured vault", () => {
test("behaves exactly as before the boundary existed", async () => {
const result = await captureSessionLifecycleEvent(
vault,
{ hook_event_name: "UserPromptSubmit", session_id: "s1", prompt: MARKER_PROMPT },
{ agent: "tester", now: NOW },
);
expect(result.boundary_decision).toBe("capture");
expect(result.suppressed_messages).toBe(0);
expect(result.signals_created).toBe(1);
});
});
describe("fact extraction at the live seam", () => {
test("facts extract from a captured user prompt and dedupe on repeat", async () => {
const payload = {
hook_event_name: "UserPromptSubmit",
session_id: "s1",
prompt: "By the way, reach me at [email protected] and the repo is https://techmeat.dev.",
};
const first = await captureSessionLifecycleEvent(vault, payload, {
agent: "tester",
now: NOW,
});
expect(first.facts_extracted).toBe(2);
expect(first.facts_deduped).toBe(0);
const names = inboxSignals();
expect(names.some((n) => n.includes("fact-email"))).toBe(true);
expect(names.some((n) => n.includes("fact-url"))).toBe(true);
const second = await captureSessionLifecycleEvent(vault, payload, {
agent: "tester",
now: new Date("2026-06-02T10:00:05Z"),
});
expect(second.facts_extracted).toBe(0);
expect(second.facts_deduped).toBe(2);
});
test("extracted signals carry source_type extracted", async () => {
await captureSessionLifecycleEvent(
vault,
{
hook_event_name: "UserPromptSubmit",
session_id: "s1",
prompt: "reach me at [email protected]",
},
{ agent: "tester", now: NOW },
);
const name = inboxSignals().find((n) => n.includes("fact-email"))!;
const sig = parseSignal(join(brainDirs(vault).inbox, name));
expect(sig.source_type).toBe("extracted");
expect(sig.principle).toContain("[email protected]");
});
test("a fact naming a registered entity gets the canonical anchor", async () => {
// The entity name must appear inside the structural fact's own text; a
// URL host carries it without any natural-language framing.
upsertEntity(vault, {
category: "projects",
name: "techmeat",
agent: "tester",
now: NOW,
});
await captureSessionLifecycleEvent(
vault,
{
hook_event_name: "UserPromptSubmit",
session_id: "s1",
prompt: "the project site is https://techmeat.dev/blog",
},
{ agent: "tester", now: NOW },
);
const name = inboxSignals().find((n) => n.includes("fact-url"))!;
const raw = readFileSync(join(brainDirs(vault).inbox, name), "utf8");
expect(raw).toContain("ent-projects-techmeat");
});
test("assistant-shaped events without prompt text extract nothing", async () => {
const result = await captureSessionLifecycleEvent(
vault,
{ hook_event_name: "Stop", session_id: "s1" },
{ agent: "tester", now: NOW },
);
expect(result.facts_extracted).toBe(0);
});
});