v0.3.0
Highlights
- Added
FactGate, a high-level runtime API for config-driven record/check flows. - Added built-in scoped extractor packs for finance, SaaS, ecommerce, and ops metrics.
- Added stable
groundguard.report.v1protocol objects and report renderers. - Added Markdown, HTML, and GitHub PR comment report output.
- Added dependency-free OpenTelemetry-style event export plus Langfuse and Phoenix payload exporters.
- Added a minimal dependency-free
groundguard-serverentrypoint withPOST /check.
Install
python -m pip install -U groundguard-ai==0.3.0The PyPI distribution name is groundguard-ai; the Python import name remains groundguard.
Quick Check
from groundguard import FactGate
gate = FactGate()
gate.record_tool_result("q3_revenue", "5.2", "billion_usd")
report = gate.check("Q3 revenue came in at $4.8 billion [fact:q3_revenue].", required=["q3_revenue"])
print(report.output_claims[0].status) # contradictedVerification
python -m pytest -q: 103 passedpython -m mkdocs build --strict: passedgroundguard-benchmark: 200-case bilingual realistic dataset, 71/71 expected failures detected, 0 false positives, 0 false negatives