Skip to content

chore(deps): bump the safe-minor-patches group across 1 directory with 22 updates #37

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
dependabot wants to merge 3 commits into from
Closed

chore(deps): bump the safe-minor-patches group across 1 directory with 22 updates #37

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ec06dd5
docs: lead README with LLM hallucination gate example (#29)
msertdev Nov 3, 2026
3664547
chore: resolve high/critical dependency advisories (#35)
msertdev Nov 3, 2026
a656cdf
chore(deps): bump the safe-minor-patches group across 1 directory wit…
dependabot[bot] Nov 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 29 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,12 @@

**Extract structured data. Keep the proof.**

Turn local HTML into schema-valid JSON plus field-level evidence.
Turn local HTML — or any LLM's extraction output — into schema-valid JSON where every field cites its source. Hallucinated values get caught, not shipped.

[![CI](https://github.com/msertdev/grounded-json/actions/workflows/ci.yml/badge.svg)](https://github.com/msertdev/grounded-json/actions/workflows/ci.yml)
[![CodeQL](https://github.com/msertdev/grounded-json/actions/workflows/codeql.yml/badge.svg)](https://github.com/msertdev/grounded-json/actions/workflows/codeql.yml)
[![npm](https://img.shields.io/npm/v/grounded-json?logo=npm)](https://www.npmjs.com/package/grounded-json)
[![downloads](https://img.shields.io/npm/dm/grounded-json)](https://www.npmjs.com/package/grounded-json)
[![Node.js 22+](https://img.shields.io/badge/Node.js-22%2B-5FA04E?logo=nodedotjs&logoColor=white)](https://nodejs.org/)
[![MIT](https://img.shields.io/badge/license-MIT-6ee7b7)](./LICENSE)

Expand Down Expand Up @@ -39,6 +40,33 @@ PASS 4/4 fields are source-backed

The demo is deterministic and uses built-in local data. It makes no network requests.

## Catch an LLM making things up

Your model extracted three fields. The page only supports two:

```ts
import { ground } from 'grounded-json';
import { z } from 'zod';

const source = 'Northstar Pack 24L ships in navy. Price: 149.95 USD.';

const receipt = ground({
data: { name: 'Northstar Pack 24L', price: '149.95', color: 'black' }, // from your LLM
sources: [{ mediaType: 'text/plain', content: source }],
evidence: [
{ pointer: '/name', quote: 'Northstar Pack 24L' },
{ pointer: '/price', quote: '149.95' },
{ pointer: '/color', quote: 'black' },
],
schema: z.object({ name: z.string(), price: z.string(), color: z.string() }),
});

receipt.coverage; // { grounded: 2, total: 3, invalid: 1, ratio: 0.67 }
receipt.issues; // [{ code: 'quote-not-found', pointer: '/color', ... }]
```

Ask your model to return a quote per field, then let the gate decide. With `strict: true`, the hallucinated value never reaches your database.

## Install

```bash
Expand Down
Loading
Loading