@booboo-brain/spec

The Booboo graph contract — the tiny JSON spec every adapter emits and every consumer reads. Types + a validator, zero runtime deps.

Install

npm install @booboo-brain/spec

Use

import { validate, type BoobooGraph, type BNode, type BLink } from "@booboo-brain/spec";

const graph: BoobooGraph = {
  booboo: "1.0",
  meta: { root: "core", title: "My System", layers: [{ name: "agents", color: "#c9a04a" }] },
  nodes: [{ id: "core", type: "root", layer: "agents", label: "CORE" }],
  links: [],
};

const { ok, errors, warnings } = validate(graph); // never throws

validate returns errors for missing required fields and warnings for dangling links / unknown layers (the builder drops those). The full human-readable spec lives in SPEC.md.

Part of Booboo — the unified operational brain. MIT.