Skip to content
Open protocol · created at Genval · maintained openly

Kanonak Protocol. Semantic ontologies, distributed.

An open protocol for defining, versioning, and sharing semantic ontologies across distributed publishers.

Anyone with a domain name can publish a typed schema. Anyone can import it, validate against it, and reason over it.

npm i -g @kanonak-protocol/cli

The backstory

Extracted from Genval. Released to everyone.

Kanonak is the operational form of Derivative Centric Development. It started as the processes we ran inside Genval to turn human-authored specifications into derived implementations.

Those processes proved general. So we lifted them out of the platform, formalized the rules, and published them as an open protocol — one that doesn’t depend on Genval, doesn’t centralize control, and lets any organization publish ontologies from their own domain.

Core concepts

How it works.

Four moving parts. Each one is small. Together they let typed knowledge cross organizational boundaries without a registry.

publisher

Publishers

Any domain name. Publish packages from a static HTTP origin you control. No central authority, no gatekeeping.

package

Packages & versions

Named, semver-versioned collections of typed entities. URIs of the form publisher/package@version/name.

schema

.kan.yml files

The schema format. Classes, properties, instances, imports — all expressed in clean YAML against core RDF/OWL/XSD vocabularies.

cli

Tooling

The @kanonak-protocol/cli resolves imports over HTTP, validates documents, and manages dependencies. VS Code extension provides live validation.

In production open source

Worldview — Kanonak in a real domain.

A macro-market worldview, published as versioned typed snapshots.

Worldview is an open-source project that uses Kanonak Protocol to publish a daily macro-market worldview as versioned snapshots. Each snapshot is a typed ontology of theses — with confidence levels, machine-evaluable invalidation conditions (AND / OR / Threshold / Event / Sequenced logic trees), and citation-backed evidence.

It’s a working illustration of how Kanonak’s distributed publishing, semantic versioning, and machine-readable types apply to a real domain — well beyond a synthetic example.

The Timeline view charts how each thesis’s confidence has evolved across published snapshots — one curve per thesis, one dot per version — showing how versioned ontology snapshots compose into a longitudinal record humans and AI agents can both reason over.

domain
Macro intelligence — geopolitical & economic theses
shape
Bayesian confidence, evidence chains, invalidation logic
cadence
Versioned snapshot every 14–24 hours
audience
Macro investors & policy analysts (humans & AI agents)
source
github.com/genval-ai/worldview

Install & use

One command. Validate anything.

Terminal
$ npm install -g @kanonak-protocol/cli
$ kanonak validate my-ontology@1.0.0.kan.yml
✓ document is valid
$ kanonak deps my-ontology@1.0.0.kan.yml
→ kanonak.org/core-owl@2.0.0
→ kanonak.org/core-xsd@1.0.0

What the CLI does

validate
Fetches all imports over HTTP and checks the document against repository rules.
deps
Prints the resolved dependency tree.
install
Populates the local file cache from kanonak.lock.
capability add
Extend the CLI itself with dynamic command groups distributed as Kanonak packages.

Full reference, the protocol spec, and core vocabularies are at kanonak.org.

Resources

Where to look.

Get going

Try the protocol.

  1. Install the CLI

    npm i -g @kanonak-protocol/cli

  2. Read the spec

    At kanonak.org.

  3. Browse Worldview’s schemas

    At github.com/genval-ai/worldview.

  4. Publish your first package

    From a domain you already own.