Home

Groundlens wiki

Operator knowledge that doesn't belong in the README or the API docs.

Start elsewhere if you want: README for what Groundlens is and how to install it · docs.groundlens.dev for the API reference · the papers for the method.

This wiki holds the things that change at a different rate than the code, and the things that need judgement rather than a signature.

Page	What it's for
Calibration Cookbook	How to fit thresholds to your domain and encoder, with the numbers we measured. Read before you trust a flag.
Failure Gallery	Real cases where Groundlens is wrong, with the text and the score. What the geometry cannot see.
Decision Log	Why SGI is a ratio, why the DGI cut is 0.525, why torch is opt-in, why there is no server.

Research

• SGI — arXiv:2512.13771 — geometric bounds on context engagement in RAG
• Hallucination taxonomy — arXiv:2602.13224
• How transformers reject wrong answers — arXiv:2603.13259
• Human-confabulated benchmarks — methodology + 212-pair dataset Dataset
• Defendable rules for banking governance — multi-source provenance framework behind groundlens_banking_rules

Contributing to this wiki

The encoder table in the Calibration Cookbook and the cases in the Failure Gallery are meant to grow. If you measure a new encoder or find a case that breaks a check, add it — a row with the numbers is more useful than an issue describing it.