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
/**
* Tests for `scripts/_bun-precheck.sh`.
*
* The precheck is sourced by `scripts/o2b` and `scripts/vault-log`; it is
* exercised here in isolation by sourcing it from a one-liner shell with a
* fully controlled PATH and HOME. A Hermes gateway spawns its plugins with a
* minimal inherited PATH, which is the environment reproduced below: Bun is
* installed at the standard location and simply not on the search path.
*/
import { afterEach, describe, expect, setDefaultTimeout, test } from "bun:test";
import { chmodSync, mkdirSync, mkdtempSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
import { tmpdir } from "node:os";
import { dirname, join, resolve } from "node:path";
import { fileURLToPath } from "node:url";
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);
const PRECHECK = resolve(
dirname(fileURLToPath(import.meta.url)),
"..",
"..",
"scripts",
"_bun-precheck.sh",
);
const tmps: string[] = [];
function freshHome(): string {
const home = mkdtempSync(join(tmpdir(), "o2b-precheck-"));
tmps.push(home);
return home;
}
// Everything `_bun-precheck.sh` reaches for that is not a shell builtin. The
// child's PATH is built from exactly these, so a Bun installed anywhere on this
// machine cannot satisfy the check the test is about.
const REQUIRED_UTILITIES = ["bash", "cat", "tr", "head"];
/** A PATH holding the script's utilities and provably no `bun`. */
function isolatedPath(): string {
const bin = mkdtempSync(join(tmpdir(), "o2b-precheck-bin-"));
tmps.push(bin);
for (const name of REQUIRED_UTILITIES) {
const resolved = Bun.which(name);
if (!resolved) throw new Error(`test prerequisite missing from this machine: ${name}`);
symlinkSync(resolved, join(bin, name));
}
if (Bun.which("bun", { PATH: bin })) throw new Error("isolated PATH leaked a bun");
return bin;
}
/** Plant an executable `bun` stub reporting `version` at `<home>/.bun/bin`. */
function plantBun(home: string, version: string): void {
const bin = join(home, ".bun", "bin");
mkdirSync(bin, { recursive: true });
const stub = join(bin, "bun");
writeFileSync(stub, `#!/bin/sh\nprintf '%s\\n' "${version}"\n`);
chmodSync(stub, 0o755);
}
async function runPrecheck(home: string): Promise<{ code: number; stderr: string }> {
// PATH deliberately excludes every directory a Bun install could live in.
const proc = Bun.spawn(["bash", "-c", `. "${PRECHECK}"; echo PRECHECK_PASSED`], {
env: { HOME: home, PATH: isolatedPath() },
stdout: "pipe",
stderr: "pipe",
});
const stderr = await new Response(proc.stderr).text();
const code = await proc.exited;
return { code, stderr };
}
afterEach(() => {
while (tmps.length) {
try {
rmSync(tmps.pop()!, { recursive: true, force: true });
} catch {
// ignore
}
}
});
// Sources a bash script under a controlled POSIX PATH; native Windows has no
// such shell (its launchers are the scripts/*.cmd files).
describe.skipIf(process.platform === "win32")("_bun-precheck.sh PATH repair", () => {
test("adopts ~/.bun/bin when a minimal PATH hides an installed Bun", async () => {
const home = freshHome();
plantBun(home, "1.4.0");
const { code, stderr } = await runPrecheck(home);
expect(code).toBe(0);
expect(stderr).not.toContain("'bun' is not on PATH");
});
test("still refuses with 127 when no Bun exists anywhere", async () => {
const home = freshHome();
const { code, stderr } = await runPrecheck(home);
expect(code).toBe(127);
expect(stderr).toContain("'bun' is not on PATH");
});
test("the adopted Bun is still version-checked", async () => {
const home = freshHome();
plantBun(home, "1.0.9");
const { code, stderr } = await runPrecheck(home);
expect(code).toBe(1);
expect(stderr).toContain("is older than the required");
});
});