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
/**
* Unit tests for `parseWikilinkRich` - the rich-parse helper that
* returns `{target, anchor, block, alias}` from any Obsidian wikilink
* shape. The existing `parseWikilink` / `normaliseWikilinkTarget`
* (string-returning) helpers keep their contracts; this test set
* locks in the additive richer surface introduced by v0.10.17.
*/
import { describe, expect, test } from "bun:test";
import {
extractWikilinkRichBodies,
parseWikilinkRich,
} from "../../../../src/core/brain/link-graph/parse-wikilink.ts";
import { renderExcerptSection } from "../../../../src/core/brain/provenance/capture-scope.ts";
describe("parseWikilinkRich - bare target", () => {
test("bare target inside brackets", () => {
const r = parseWikilinkRich("[[Note]]");
expect(r.target).toBe("Note");
expect(r.anchor).toBeUndefined();
expect(r.block).toBeUndefined();
expect(r.alias).toBeUndefined();
});
test("bare target without brackets", () => {
const r = parseWikilinkRich("Note");
expect(r.target).toBe("Note");
});
test("trailing .md extension stripped", () => {
const r = parseWikilinkRich("[[Note.md]]");
expect(r.target).toBe("Note");
});
test("folder prefix collapses to basename", () => {
const r = parseWikilinkRich("[[Folder/Note]]");
expect(r.target).toBe("Note");
});
test("empty input returns empty target", () => {
const r = parseWikilinkRich("");
expect(r.target).toBe("");
});
});
describe("parseWikilinkRich - heading anchor", () => {
test("simple heading", () => {
const r = parseWikilinkRich("[[Note#Heading]]");
expect(r.target).toBe("Note");
expect(r.anchor).toBe("Heading");
expect(r.block).toBeUndefined();
});
test("heading with spaces", () => {
const r = parseWikilinkRich("[[Note#Section Two]]");
expect(r.target).toBe("Note");
expect(r.anchor).toBe("Section Two");
});
test("heading with non-ASCII characters", () => {
const r = parseWikilinkRich("[[Note#Раздел]]");
expect(r.target).toBe("Note");
expect(r.anchor).toBe("Раздел");
});
test("anchor on folder-prefixed target", () => {
const r = parseWikilinkRich("[[Folder/Note#Heading]]");
expect(r.target).toBe("Note");
expect(r.anchor).toBe("Heading");
});
});
describe("parseWikilinkRich - block anchor", () => {
test("block id detected via caret sigil", () => {
const r = parseWikilinkRich("[[Note#^abc123]]");
expect(r.target).toBe("Note");
expect(r.block).toBe("abc123");
expect(r.anchor).toBeUndefined();
});
test("block id with hyphens preserved", () => {
const r = parseWikilinkRich("[[Note#^block-id-x]]");
expect(r.block).toBe("block-id-x");
});
});
describe("parseWikilinkRich - alias", () => {
test("alias preserved separately from target", () => {
const r = parseWikilinkRich("[[Note|display name]]");
expect(r.target).toBe("Note");
expect(r.alias).toBe("display name");
});
test("alias plus anchor", () => {
const r = parseWikilinkRich("[[Note#Heading|display]]");
expect(r.target).toBe("Note");
expect(r.anchor).toBe("Heading");
expect(r.alias).toBe("display");
});
test("alias plus block id", () => {
const r = parseWikilinkRich("[[Note#^abc|display]]");
expect(r.target).toBe("Note");
expect(r.block).toBe("abc");
expect(r.alias).toBe("display");
});
});
describe("parseWikilinkRich - immutability", () => {
test("returned object is frozen", () => {
const r = parseWikilinkRich("[[Note#H|alias]]");
expect(Object.isFrozen(r)).toBe(true);
});
});
describe("extractWikilinkRichBodies - code masking", () => {
test("a longer fence is not closed by a shorter backtick run inside it", () => {
const content = "````\nx ```\n[[Hidden/Note]]\n````\nReal: [[real-link]]";
expect(extractWikilinkRichBodies(content)).toEqual(["real-link"]);
});
test("a fence closed by a longer run ends at the end of that run", () => {
const content = "```\ncode\n````\nAfter: [[after-link]]\n`x`";
expect(extractWikilinkRichBodies(content)).toEqual(["after-link"]);
});
test("a stored excerpt never contributes links, whatever backtick runs it holds", () => {
for (const excerpt of ["x ```\n[[Secret/Note]]\n", "```` [[A]] ``` [[B]]", "`` [[C]] ```"]) {
expect(extractWikilinkRichBodies(renderExcerptSection(excerpt))).toEqual([]);
}
});
});
describe("extractWikilinkRichBodies - escaped brackets", () => {
// The same odd-backslash-run rule the neutralizer's detector applies:
// a backslash-escaped bracket opens or closes no link, so an escaped
// `[[target]]` in a body contributes no backlink edge.
test("an escaped opening bracket opens no link", () => {
expect(extractWikilinkRichBodies("\\[[a]]")).toEqual([]);
});
test("an escaped closing bracket closes no link", () => {
expect(extractWikilinkRichBodies("[[a\\]]")).toEqual([]);
});
test("a link after an even backslash run stays live", () => {
expect(extractWikilinkRichBodies("\\\\[[a]]")).toEqual(["a"]);
});
test("an escaped link beside a live one leaves only the live one", () => {
expect(extractWikilinkRichBodies("\\[[a]] and [[b]]")).toEqual(["b"]);
});
});