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
/**
* `brain_digest` v0.10.11 — `most_applied` block in Markdown + JSON.
*
* Mirrors `Brain/active.md`'s `Most-applied (Nd)` section behind the
* same `_brain.yaml:active.most_applied_*` knobs.
*/
import { describe, expect, test, beforeEach, afterEach } from "bun:test";
import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { renderDigest } from "../../../src/core/brain/digest.ts";
import { appendLogEvent } from "../../../src/core/brain/log.ts";
import { BrainConfigError } from "../../../src/core/brain/policy.ts";
import { BRAIN_APPLY_RESULT, BRAIN_LOG_EVENT_KIND } from "../../../src/core/brain/types.ts";
let vault: string;
beforeEach(() => {
vault = mkdtempSync(join(tmpdir(), "osb-digest-ma-"));
mkdirSync(join(vault, "Brain", "preferences"), { recursive: true });
mkdirSync(join(vault, "Brain", "retired"), { recursive: true });
mkdirSync(join(vault, "Brain", "log"), { recursive: true });
// confirmed preference referenced by apply-evidence events
writeFileSync(
join(vault, "Brain", "preferences", "pref-a.md"),
`---
kind: brain-preference
id: pref-a
created_at: 2026-04-01T00:00:00Z
_confirmed_at: 2026-04-05T00:00:00Z
unconfirmed_until: 2026-04-08T00:00:00Z
tags: []
topic: a
_status: confirmed
principle: principle a
_evidenced_by: []
_applied_count: 0
_violated_count: 0
_last_evidence_at: null
_confidence: medium
_confidence_value: 0.5
pinned: false
---
body
`,
);
});
afterEach(() => {
try {
rmSync(vault, { recursive: true, force: true });
} catch {}
});
function writeBrainYaml(content: string): void {
writeFileSync(join(vault, "Brain", "_brain.yaml"), content);
}
function seedApplied(stamp: string, prefRef: string): void {
appendLogEvent(vault, {
timestamp: stamp,
eventType: BRAIN_LOG_EVENT_KIND.applyEvidence,
body: { preference: prefRef, result: BRAIN_APPLY_RESULT.applied, artifact: "[[x.md]]" },
});
}
describe("digest most_applied block — defaults", () => {
test("JSON contains the block at defaults (30d / 10) even when empty", () => {
const result = renderDigest(vault, {
format: "json",
now: new Date("2026-05-20T12:00:00Z"),
since: new Date("2026-05-19T12:00:00Z"),
until: new Date("2026-05-20T12:00:00Z"),
});
const parsed = JSON.parse(result.content);
expect(parsed.most_applied).toBeDefined();
expect(parsed.most_applied.window_days).toBe(30);
expect(parsed.most_applied.limit).toBe(10);
expect(parsed.most_applied.entries).toEqual([]);
});
test("Markdown omits the section when window has no applied events", () => {
const result = renderDigest(vault, {
format: "markdown",
now: new Date("2026-05-20T12:00:00Z"),
since: new Date("2026-05-19T12:00:00Z"),
until: new Date("2026-05-20T12:00:00Z"),
});
expect(result.content).not.toContain("## Most-applied");
});
test("JSON entries populated when applied events exist in window", () => {
seedApplied("2026-05-15T10:00:00Z", "[[pref-a]]");
seedApplied("2026-05-15T11:00:00Z", "[[pref-a]]");
const result = renderDigest(vault, {
format: "json",
now: new Date("2026-05-20T12:00:00Z"),
since: new Date("2026-05-19T12:00:00Z"),
until: new Date("2026-05-20T12:00:00Z"),
});
const parsed = JSON.parse(result.content);
expect(parsed.most_applied.entries.length).toBe(1);
expect(parsed.most_applied.entries[0].id).toBe("pref-a");
expect(parsed.most_applied.entries[0].applied_in_window).toBe(2);
});
test("Markdown renders the section with the default window in the header", () => {
seedApplied("2026-05-15T10:00:00Z", "[[pref-a]]");
const result = renderDigest(vault, {
format: "markdown",
now: new Date("2026-05-20T12:00:00Z"),
since: new Date("2026-05-19T12:00:00Z"),
until: new Date("2026-05-20T12:00:00Z"),
});
expect(result.content).toContain("## Most-applied (30d)");
});
});
describe("digest most_applied block — custom config", () => {
test("honours window_days / limit from _brain.yaml", () => {
writeBrainYaml(
"schema_version: 1\n" +
"active:\n" +
" most_applied_window_days: 7\n" +
" most_applied_limit: 3\n",
);
seedApplied("2026-05-19T10:00:00Z", "[[pref-a]]"); // within 7d
const result = renderDigest(vault, {
format: "json",
now: new Date("2026-05-20T12:00:00Z"),
since: new Date("2026-05-19T12:00:00Z"),
until: new Date("2026-05-20T12:00:00Z"),
});
const parsed = JSON.parse(result.content);
expect(parsed.most_applied.window_days).toBe(7);
expect(parsed.most_applied.limit).toBe(3);
});
test("Markdown header reflects custom window", () => {
writeBrainYaml(
"schema_version: 1\n" +
"active:\n" +
" most_applied_window_days: 14\n" +
" most_applied_limit: 5\n",
);
seedApplied("2026-05-19T10:00:00Z", "[[pref-a]]");
const result = renderDigest(vault, {
format: "markdown",
now: new Date("2026-05-20T12:00:00Z"),
since: new Date("2026-05-19T12:00:00Z"),
until: new Date("2026-05-20T12:00:00Z"),
});
expect(result.content).toContain("## Most-applied (14d)");
});
/**
* Corrected assertion. This used to expect the default window on a
* malformed `_brain.yaml`, which is the collapse the read split removed:
* the operator's window is not in force, and re-windowing silently makes
* the digest name a different set of rules while reporting healthy. The
* fallback exists for a vault with NO config, and that case keeps its own
* coverage in the `defaults` block above.
*/
test("malformed _brain.yaml raises rather than re-windowing the digest", () => {
writeBrainYaml("this is not yaml\nschema_version: nope\n");
expect(() =>
renderDigest(vault, {
format: "json",
now: new Date("2026-05-20T12:00:00Z"),
since: new Date("2026-05-19T12:00:00Z"),
until: new Date("2026-05-20T12:00:00Z"),
}),
).toThrow(BrainConfigError);
});
});