Skip to content

v0.3.0

Choose a tag to compare

@chasen2041maker chasen2041maker released this 07 Jul 01:26

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.v1 protocol 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-server entrypoint with POST /check.

Install

python -m pip install -U groundguard-ai==0.3.0

The 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)  # contradicted

Verification

  • python -m pytest -q: 103 passed
  • python -m mkdocs build --strict: passed
  • groundguard-benchmark: 200-case bilingual realistic dataset, 71/71 expected failures detected, 0 false positives, 0 false negatives