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.6 KB
Raw Blame
import { afterEach, beforeEach, describe, expect, test } from "bun:test";
import { mkdtempSync, readdirSync, rmSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";

import { bootstrapBrain } from "../../../src/core/brain/init.ts";
import { parseSignal } from "../../../src/core/brain/signal.ts";
import { captureSessionLifecycleEvent } from "../../../src/core/brain/session-lifecycle.ts";
import { useUnshardedLegacyLog } from "../../helpers/device-id.ts";

// The legacy day log and ledgers are read under their un-sharded names.
useUnshardedLegacyLog();

let vault: string;

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

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

describe("captureSessionLifecycleEvent", () => {
  test("writes prompt markers immediately and dedupes repeats", async () => {
    const payload = {
      hook_event_name: "UserPromptSubmit",
      session_id: "session-1",
      prompt: '@osb feedback positive topic=lifecycle principle="capture prompt markers"',
    };

    const first = await captureSessionLifecycleEvent(vault, payload, {
      agent: "tester",
      now: new Date("2026-05-30T10:00:00Z"),
    });
    const second = await captureSessionLifecycleEvent(vault, payload, {
      agent: "tester",
      now: new Date("2026-05-30T10:00:01Z"),
    });

    expect(first.event).toBe("UserPromptSubmit");
    expect(first.signals_created).toBe(1);
    expect(first.signals_deduped).toBe(0);
    expect(first.audit_path).toContain("session-lifecycle");
    expect(first.log_path).toContain(join("Brain", "log", "2026-05-30.md"));
    expect(second.signals_created).toBe(0);
    expect(second.signals_deduped).toBe(1);

    const signalFiles = readdirSync(join(vault, "Brain", "inbox")).filter((name) =>
      name.endsWith(".md"),
    );
    expect(signalFiles).toHaveLength(1);
    const signal = parseSignal(join(vault, "Brain", "inbox", signalFiles[0]!));
    expect(signal.topic).toBe("lifecycle");
    expect(signal.source_type).toBe("session");
    expect(signal.session_ref).toBe("session:session-1#UserPromptSubmit");
  });

  test("captures only feedback markers, ignoring loop and set kinds", async () => {
    const result = await captureSessionLifecycleEvent(
      vault,
      {
        hook_event_name: "UserPromptSubmit",
        session_id: "session-kinds",
        prompt: [
          "@osb feedback positive topic=only-feedback principle=p",
          "@osb loop follow up on vendor id=vendor",
          "@osb set note=Roadmap field=completion value=65",
        ].join("\n"),
      },
      { agent: "tester", now: new Date("2026-05-30T10:20:00Z") },
    );
    expect(result.signals_created).toBe(1);
    const signalFiles = readdirSync(join(vault, "Brain", "inbox")).filter((name) =>
      name.endsWith(".md"),
    );
    expect(signalFiles).toHaveLength(1);
    const signal = parseSignal(join(vault, "Brain", "inbox", signalFiles[0]!));
    expect(signal.topic).toBe("only-feedback");
  });

  test("replays brain_feedback tool input through the same signal boundary", async () => {
    const result = await captureSessionLifecycleEvent(
      vault,
      {
        hook_event_name: "PostToolUse",
        session_id: "session-2",
        tool_name: "brain_feedback",
        tool_input: {
          topic: "tool-feedback",
          signal: "negative",
          principle: "capture feedback tool calls",
          raw: "from hook payload",
        },
      },
      { agent: "tester", now: new Date("2026-05-30T10:05:00Z") },
    );

    expect(result.signals_created).toBe(1);
    expect(result.tool_replays).toBe(1);
  });

  test("records malformed payloads without throwing", async () => {
    const result = await captureSessionLifecycleEvent(vault, null, {
      agent: "tester",
      now: new Date("2026-05-30T10:10:00Z"),
    });

    expect(result.event).toBe("unknown");
    expect(result.malformed).toBe(1);
    expect(result.signals_created).toBe(0);
    expect(result.audit_path).toContain("session-lifecycle");
  });

  test.each(["SessionStart", "Stop", "SessionEnd"])(
    "records %s as lifecycle-only observation",
    async (event) => {
      const result = await captureSessionLifecycleEvent(
        vault,
        { hook_event_name: event, session_id: "session-lifecycle-only" },
        { agent: "tester", now: new Date("2026-05-30T10:15:00Z") },
      );

      expect(result.event).toBe(event);
      expect(result.signals_created).toBe(0);
      expect(result.signals_deduped).toBe(0);
      expect(result.log_path).toContain(join("Brain", "log", "2026-05-30.md"));
    },
  );
});