Version 0.17 of Uteke shipped today, and the theme is explainability. Your local memory store should be able to show you why it returned what it returned, and what happened to the facts it replaced. Here is a quick tour of the release.
Explain mode for recall
Recall now has an explain mode. Alongside the results you get the full scoring breakdown: the vector rank, the FTS rank, how RRF fuses the two lists, and which boosts got applied along the way. The whole breakdown adds roughly 50ms on top of a normal query. So when a search result surprises you, you can check the actual scoring path instead of guessing.
Supersede ledger with undo
When a newer fact replaces an older one, 0.17 records the replacement in a supersede ledger. The history stays queryable, and mistakes stay recoverable: uteke contradictions undo reverses a supersede you regret. Anyone auditing the system gets a full trail of how each fact changed over time.
Provenance and trust tiers
Every entry now carries provenance metadata: a SHA-256 hash of its source plus a trust tier. Entries from shaky sources now rank differently from entries with verified origins, so the retrieval layer can weigh reliability instead of treating all memories as equal.
Contradiction benchmark
We stress tested the contradiction handling on 40 topics. After conflicting updates were ingested, winner@1 accuracy went from 0.850 to 1.000, and stale@5 dropped from 1.000 to 0.000 once supersede took effect. The benchmark script lives in the repo at benchmarks/longmemeval/contradiction_segment.py, so you can reproduce the numbers on your own machine.
Namespace management and pagination
Namespaces got proper management commands, and list endpoints now return pagination metadata. Building tooling on top of the API no longer means guessing how many pages are left.
Try it
Install in one line:
curl -sSL codecora.dev/uteke/install | sh
Source code is at github.com/codecoradev/uteke. The full release write-up, with more detail on everything above, is on the CodeCora blog: Uteke 0.17: memory that shows its work.
Top comments (1)
Your clear, step‑by‑step breakdown of the new recall explain mode and the auditable supersede ledger makes the complexities of Uteke 0.17 feel approachable. If you ever syndicate or cross‑post, this guide would be a great resource for the community on ZyVOP (zyvop.com).