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
5.1 KB
Raw Blame
/**
 * 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"]);
  });
});