Knolo KITE in Core 6.2.3 and CLI 6.2.6: Contract Verdicts You Can Replay
Knolo KITE checks a finite contract against a Knowledge Image and returns a verdict you can verify again. How to run knolo kite in @knolo/cli 6.2.6.
Knolo is the open-source, local-first Knowledge Image runtime and format: Apache-2.0, published on npm as @knolo/core, with the source in the Knolo core repo on GitHub. On 14 Nov 2026 npm latest moved to @knolo/core@6.2.3 and @knolo/cli@6.2.6. Those releases carry KITE, an optional, deterministic layer that checks a finite contract against a mounted V5 Knowledge Image and returns a verdict you can replay.
This post covers what Knolo KITE does, how to run it from the CLI, and where its limits are.
What Knolo KITE checks
Knolo Cortex discovers evidence in a Knowledge Image. KITE answers a narrower question: given a contract that lists typed obligations, which ones does the image meet, which are still open, and does the conclusion survive the changes the contract allows?
A contract is a small JSON file in the knolo-kite-contract-1 format. The policy example in the repo looks like this:
{
"format": "knolo-kite-contract-1",
"question": "Can contractor A access production?",
"obligations": [
{ "id": "policy", "kind": "authority", "term": "security policy" },
{ "id": "exception", "kind": "qualification", "term": "contractor exception" },
{ "id": "approval", "kind": "evidence", "term": "contractor approval" }
]
}
Each unmet obligation gets a normal V5 chunk retrieval, and that retrieval names the obligation it is for. Typed rules, completeness declarations and declared counterfactual changes then produce one of six verdicts: WARRANTED_IN_SCOPE, SUPPORTED_OPEN_WORLD, REFUTED_IN_SCOPE, CONFLICTED, UNDERDETERMINED or BOUND_EXCEEDED.
Core does not call a model. If you want a model in the loop, your host owns it.
Running Knolo KITE from the CLI
Install or update the Knolo CLI (see installation and the CLI reference):
npm install -g @knolo/cli@6.2.6
Evaluate a contract against an image and write the result:
knolo kite evaluate \
--image policy.knolo \
--contract contract.json \
--rules rules.json \
--completeness completeness.json \
--out result.json --json
Verify a certificate later:
knolo kite verify \
--image policy.knolo \
--contract contract.json \
--rules rules.json \
--certificate certificate.json
verify mounts the image again and recomputes the derivation. As the KITE docs put it, a stored hash that matches a stored hash is not verification. knolo kite is new in 6.2.6. Published @knolo/cli@6.2.5 does not include it.
In code, import from the subpath. The root @knolo/core entry does not load KITE:
import { createKiteSession, evaluateKiteSession, verifyKiteCertificate } from '@knolo/core/kite';
Knolo KITE's InvarianceRoot and bounds
A KITE session commits its inputs to an InvarianceRoot that sits beside the image's V5 stateRoot and does not replace it (see roots and receipts and verification).
The search budget starts at 5000 graph nodes, 2048 variants, 2 counterfactual changes and 64 retrievals. A caller can lower a bound but not raise it. A search that does not finish returns BOUND_EXCEEDED and no certificate.
Try the Knolo KITE policy example
From a knolo-core checkout, after building core:
node examples/kite-policy/run.mjs
node conformance/kite/v1/run.mjs
The example image holds a security policy and a contractor exception but no contractor approval. The contract requires the approval, so the verdict is UNDERDETERMINED. A missing approval is not recorded as a denial.
What Knolo KITE does not claim
- The verdict describes the contract, not real-world truth.
- The fixtures are synthetic. They are not a comparison against dense RAG, GraphRAG or agentic retrieval, and not a claim about a customer corpus.
- The Rust crate replays a certificate from a
knolo-kite-world-1snapshot. Python does not implement KITE, and the Rust, Python and ICP runtimes stay at 5.5.1.
For the standards view of these verdicts, read the companion post on Knolo open technology at knolo.org. For everything else, start at the Knolo docs on knolo.dev.
knolo · kite · release · cli · knowledge-image