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
2.4 KB
Raw Blame
/**
 * The relation vocabulary is the single validation boundary for typed
 * graph semantics. It owns the open/extensible set of semantic relation
 * names and the one normalize/classify function every edge producer and
 * consumer reads from - no relation string is hardcoded across call
 * sites.
 */

import { test, expect } from "bun:test";

import {
  DEFAULT_RELATION_TYPES,
  isKnownRelation,
  normalizeRelation,
  PROMISED_TO_RELATION,
  relationFromFrontmatterField,
} from "../../../src/core/graph/relation-vocab.ts";

test("the default vocabulary covers the declared relation types", () => {
  const actual: string[] = [...DEFAULT_RELATION_TYPES];
  expect(actual.toSorted()).toEqual([
    "contradicts",
    "depends_on",
    "extends",
    "promised_to",
    "refines",
    "related",
    "superseded_by",
  ]);
  // The pledge-to-counterparty edge is exported as its own named token, so
  // producers read the relation from this module instead of hardcoding it.
  expect(PROMISED_TO_RELATION).toBe("promised_to");
});

test("normalizeRelation is NFC + trimmed + lower-cased", () => {
  expect(normalizeRelation("  Superseded_By  ")).toBe("superseded_by");
  expect(normalizeRelation("CONTRADICTS")).toBe("contradicts");
});

test("isKnownRelation accepts the vocabulary and rejects anything else", () => {
  for (const r of DEFAULT_RELATION_TYPES) expect(isKnownRelation(r)).toBe(true);
  expect(isKnownRelation("Contradicts")).toBe(true); // normalized before lookup
  expect(isKnownRelation("supersedes")).toBe(false); // not a frontmatter relation field
  expect(isKnownRelation("bogus")).toBe(false);
  expect(isKnownRelation("")).toBe(false);
});

test("relationFromFrontmatterField maps a known relation field to its relation, else null", () => {
  expect(relationFromFrontmatterField("contradicts")).toBe("contradicts");
  expect(relationFromFrontmatterField("Depends_On")).toBe("depends_on");
  expect(relationFromFrontmatterField("refines")).toBe("refines");
  expect(relationFromFrontmatterField("Superseded_By")).toBe("superseded_by");
  expect(relationFromFrontmatterField("Promised_To")).toBe("promised_to");
  expect(relationFromFrontmatterField("title")).toBeNull();
  expect(relationFromFrontmatterField("aliases")).toBeNull();
});

test("DEFAULT_RELATION_TYPES is frozen so the vocabulary can't drift at runtime", () => {
  expect(Object.isFrozen(DEFAULT_RELATION_TYPES)).toBe(true);
});