Ideas · Builder Notes
Removing the graph engine to keep Kognita a control plane
Why I removed the Graphiti and Kuzu graph engine from Kognita alpha, lifted the OpenAI SDK cap and mapped the roadmap against a published trust architecture.
Kognita carried a graph engine that pulled in heavy dependencies and capped the OpenAI SDK below version 2. It didn't belong in a control plane.
I removed the graph engine (ADR 0008), lifted the openai cap and dropped the extras that existed only for it. Removed names raise an error that points at the decision record and the 0.3.0 pin, and the core's import rules still forbid the graph libraries.
It was a breaking change, so the exit path mattered: anyone who needs the engine can pin the 0.3.0 release. Removing a capability is easy to undo in git and harder to undo in users' heads. The pin and the error message are how I handled that.
The same pull request mapped Satya Nadella's trust-architecture post of 10 October principle by principle and adopted five gaps into the roadmap.
What I'd do differently
I'd keep the core smaller from the start. The graph engine was never part of the control-plane idea, and taking it out later meant a breaking change.
Sources
Kognita is an open-source alpha. This note comes from Kognita PR #33 in the Kognita repository.
