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
/**
* Wikilink output format kernel (Workspace Insight Suite, t_5f31b5f1):
* pure functions that rewrite wikilink targets to a configured path
* format - preserve (byte-identical), full (vault-relative key path),
* short (shortest unambiguous suffix). Decorations (anchor, block,
* alias) and code blocks are never touched; ambiguous and unresolved
* targets stay as typed.
*/
import { expect, test } from "bun:test";
import {
formatWikilinkBody,
normalizeWikilinks,
shortestUniqueSuffix,
} from "../../../src/core/brain/link-graph/format-wikilink.ts";
const PAGES = [
"Brain/notes/alpha",
"Brain/notes/deep/beta",
"Brain/archive/beta",
"Projects/gamma",
] as const;
// ββ shortestUniqueSuffix ββββββββββββββββββββββββββββββββββββββββββββββββββββ
test("shortestUniqueSuffix returns the basename when unique", () => {
expect(shortestUniqueSuffix("Brain/notes/alpha", PAGES)).toBe("alpha");
});
test("shortestUniqueSuffix grows until the suffix is unambiguous", () => {
expect(shortestUniqueSuffix("Brain/notes/deep/beta", PAGES)).toBe("deep/beta");
expect(shortestUniqueSuffix("Brain/archive/beta", PAGES)).toBe("archive/beta");
});
test("shortestUniqueSuffix: memoized index stays correct across repeated calls and a 3-way basename clash", () => {
const pages = [
"a/x/beta",
"b/y/beta",
"c/z/beta", // three pages share basename `beta`; each needs 2 segments
"solo/gamma",
];
// Repeated calls reuse the memoized suffix index built from `pages`.
expect(shortestUniqueSuffix("a/x/beta", pages)).toBe("x/beta");
expect(shortestUniqueSuffix("b/y/beta", pages)).toBe("y/beta");
expect(shortestUniqueSuffix("a/x/beta", pages)).toBe("x/beta"); // no corruption on reuse
expect(shortestUniqueSuffix("solo/gamma", pages)).toBe("gamma");
// A fresh array with identical content rebuilds the index and agrees.
expect(shortestUniqueSuffix("c/z/beta", [...pages])).toBe("z/beta");
});
// ββ formatWikilinkBody ββββββββββββββββββββββββββββββββββββββββββββββββββββββ
test("full mode rewrites a unique basename to its full key path", () => {
expect(formatWikilinkBody("alpha", "full", PAGES)).toBe("Brain/notes/alpha");
expect(formatWikilinkBody("gamma", "full", PAGES)).toBe("Projects/gamma");
});
test("full mode keeps decorations verbatim", () => {
expect(formatWikilinkBody("alpha#Heading|shown", "full", PAGES)).toBe(
"Brain/notes/alpha#Heading|shown",
);
expect(formatWikilinkBody("alpha#^blk", "full", PAGES)).toBe("Brain/notes/alpha#^blk");
});
test("short mode rewrites a full path to the shortest unambiguous suffix", () => {
expect(formatWikilinkBody("Brain/notes/alpha", "short", PAGES)).toBe("alpha");
expect(formatWikilinkBody("Brain/notes/deep/beta", "short", PAGES)).toBe("deep/beta");
});
test("an ambiguous bare target is left untouched in both modes", () => {
expect(formatWikilinkBody("beta", "full", PAGES)).toBe("beta");
expect(formatWikilinkBody("beta", "short", PAGES)).toBe("beta");
});
test("an unknown target is left untouched", () => {
expect(formatWikilinkBody("ghost", "full", PAGES)).toBe("ghost");
});
test("a partial-path suffix resolves when unique", () => {
expect(formatWikilinkBody("notes/deep/beta", "full", PAGES)).toBe("Brain/notes/deep/beta");
});
test("preserve mode is the identity", () => {
expect(formatWikilinkBody("alpha", "preserve", PAGES)).toBe("alpha");
});
// ββ normalizeWikilinks ββββββββββββββββββββββββββββββββββββββββββββββββββββββ
test("normalizeWikilinks rewrites links outside code blocks only", () => {
const content = [
"See [[alpha]] and [[beta]].",
"```",
"[[alpha]] inside a fence stays",
"```",
"Inline `[[alpha]]` stays too; [[gamma|G]] changes.",
].join("\n");
const result = normalizeWikilinks(content, "full", PAGES);
expect(result.content).toContain("[[Brain/notes/alpha]] and [[beta]].");
expect(result.content).toContain("[[alpha]] inside a fence stays");
expect(result.content).toContain("`[[alpha]]` stays too");
expect(result.content).toContain("[[Projects/gamma|G]]");
expect(result.changed).toBe(2);
expect(result.ambiguous).toEqual(["beta"]);
});
test("normalizeWikilinks in preserve mode returns byte-identical content", () => {
const content = "A [[alpha]] link and a [[Brain/archive/beta]] link.";
const result = normalizeWikilinks(content, "preserve", PAGES);
expect(result.content).toBe(content);
expect(result.changed).toBe(0);
});
test("tilde and long-backtick fences are preserved too", () => {
const content = [
"Outside [[alpha]].",
"~~~",
"[[alpha]] in a tilde fence stays",
"~~~",
"````",
"[[alpha]] in a four-backtick fence stays",
"````",
].join("\n");
const result = normalizeWikilinks(content, "full", PAGES);
expect(result.content).toContain("Outside [[Brain/notes/alpha]].");
expect(result.content).toContain("[[alpha]] in a tilde fence stays");
expect(result.content).toContain("[[alpha]] in a four-backtick fence stays");
expect(result.changed).toBe(1);
});
test("media embeds are never rewritten", () => {
const content = "![[diagram.png]] and [[alpha]]";
const result = normalizeWikilinks(content, "full", PAGES);
expect(result.content).toContain("![[diagram.png]]");
expect(result.content).toContain("[[Brain/notes/alpha]]");
});
test("an already-canonical link is not counted as a change", () => {
const content = "[[Brain/notes/alpha]]";
const result = normalizeWikilinks(content, "full", PAGES);
expect(result.content).toBe(content);
expect(result.changed).toBe(0);
});
test("a backtick or tilde fence closed by a longer run ends at the end of that run", () => {
for (const [open, close, tail] of [
["```", "````", "`x`"],
["~~~", "~~~~~~", "~~~"],
]) {
const content = [open, "[[alpha]] in a fence stays", close, "After [[alpha]].", tail].join(
"\n",
);
const result = normalizeWikilinks(content, "full", PAGES);
expect(result.content).toContain("[[alpha]] in a fence stays");
expect(result.content).toContain("After [[Brain/notes/alpha]].");
expect(result.changed).toBe(1);
}
});