genesiscode2026/genesis-rag-grounding-regression · v1.0.0
What an agent reads when it fetches this URL: the whole manifest, in order, with the offer on the last line as a 402 it can pay. Nothing here is a button — an agent does not click, it signs. The page a person reads is here.
Toolkit · 4 scripts · 4 test files · 5 docs · 1 config file · 1 asset · 1 other file · 16 files · text 16.7 kB · binary 221 B (1%) · Python 100% · MIT, resale permitted
scan passed 2026-09-17 · scanner 2026.09.1 · 1 release · last release today · 13% of files seen elsewhere
computed 2026-09-17 11:49 UTC · analyzer 0.1.0Security scan report
Scanned by X402 Git, OSV (opens in a new tab) and Socket (opens in a new tab) — passed on all three. Findings from X402 Git and Socket are listed below.
- secrets
- none found
- X402 Git
- size limits
- within caps
- X402 Git
- known malware
- no dependency manifests to check
- OSV
- known vulnerabilities
- no dependency manifests to check
- OSV
- dependency behaviour
- 1 direct package declares shell access, filesystem access, environment variables and more · 1 more in transitive packages · 7 packages flagged for review
- Socket
- instruction smuggling
- none found
- X402 Git
- what it can do
- listed below
- X402 Git
What this can do
- Tools
- none
- Runs
- pyproject.toml ([build-system])
- bin/genesis-rag-grounding
- genesis_rag_grounding/__main__.py
- Talks to
- nothing
- Reads
- no environment variables
- At install
- something runs
- Links to
- github.com
- img.shields.io
- keepachangelog.com
- semver.org
Findings (23)
- MODERATEpyproject.toml — [build-system] runs when this is installed
- MODERATEsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — ships compiled native code
- MODERATEsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — ships compiled native code
- MODERATEsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — runs shell commands
- MODERATEsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — runs shell commands
- MODERATEsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — evaluates code at runtime
- MODERATEsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — evaluates code at runtime
- LOWsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — reads environment variables
- LOWsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — reads environment variables
- LOWsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — reads or writes files
- LOWsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — reads or writes files
- flagged for reviewsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous
- flagged for reviewsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous
- flagged for reviewsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous
- flagged for reviewsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous
- flagged for reviewsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous
- flagged for reviewsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous
- flagged for reviewsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous
- LOWSocket SBOM Resolver — Socket SBOM Resolver (transitive) — no lockfile, so installs are not reproducible
- LOWbin/genesis-rag-grounding — Ships the script bin/genesis-rag-grounding
- LOWgenesis_rag_grounding/__main__.py — Ships the script genesis_rag_grounding/__main__.py
- LOWsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — contains hard-coded URLs
- LOWsetuptools 84.0.0 (dev only) — setuptools 84.0.0 (direct, dev only) — contains hard-coded URLs
Description self_reported
Written by the creator. Not verified by this platform — everything above and below this section is computed from the repository.
Verify factual grounding of RAG output against sources
When to use it. When requiring verified RAG Reliability functionality in autonomous workflows
Readme
genesis-rag-grounding-regression
Deterministic RAG factual grounding verifier and hallucination regression kit.
The Problem
Retrieval-Augmented Generation (RAG) applications frequently suffer from insidious subtle hallucinations:
- Models introduce unsupported numbers (e.g. inflating discounts, fabricating transaction amounts, hallucinating statistical claims).
- Answers weave external parametric training memory that contradicts retrieved enterprise context chunks.
- LLM-as-a-judge evaluators are non-deterministic, slow, expensive, and subject to their own hallucinations.
The Solution
genesis-rag-grounding-regression provides deterministic, fast, zero-dependency factual grounding auditing for RAG outputs. It computes sentence-level lexical alignment against source chunks and performs strict numeric claim validation to catch fabricated quantities, dates, and amounts before answers reach users or production databases.
Key Features
- Zero Third-Party Dependencies: Pure Python 3 standard library.
- Sentence-Level Grounding: Tokenizes outputs into discrete claims and audits lexical citation coverage.
- Strict Numeric Verification: Flags any numeric value (currencies, percentages, quantities, years) in the answer not explicitly present in source chunks.
- Normalized Grounding Score: Generates factual grounding metrics from 0.00 to 1.00 with customizable failure gates (
--min-score). - Instant CI Execution: Audits standard multi-paragraph RAG outputs in under 2ms.
Quickstart
# Clone the repository
git clone git@github.com:genesiscode2026/genesis-rag-grounding-regression.git
cd genesis-rag-grounding-regression
# Verify answer against retrieved context chunks
./bin/genesis-rag-grounding --contexts ./contexts.json --answer ./generated_answer.txt
# Enforce strict 0.90 grounding threshold in CI
./bin/genesis-rag-grounding --contexts contexts.json --answer answer.txt --min-score 0.90
# Output machine-readable JSON report
./bin/genesis-rag-grounding --contexts contexts.json --answer answer.txt --json
Commercial Distribution
- Product Name:
genesis-rag-grounding-regression - Catalog ID:
P11 - Price: $79
- Seller:
genesiscode2026 - Authorized Payout Rail: USDC on Base (
0xC6F86e170411182114FcCdb28793dC76B5e8D144) - License: MIT
Contents
| Size | Path |
|---|---|
| 103 B | .gitignore |
| 675 B | CHANGELOG.md |
| 1.1 kB | LICENSE |
| 679 B | QUICKSTART.md |
| 2.6 kB | README.md |
| 281 B | SECURITY.md |
| 6 B | VERSION · binary |
| 215 B | bin/genesis-rag-grounding · binary |
| 139 B | genesis_rag_grounding/__init__.py |
| 2.9 kB | genesis_rag_grounding/__main__.py |
| 5.1 kB | genesis_rag_grounding/verifier.py |
| 655 B | pyproject.toml |
| 222 B | tests/fixtures/contexts.json |
| 135 B | tests/fixtures/grounded_answer.txt |
| 112 B | tests/fixtures/hallucinated_answer.txt |
| 2 kB | tests/test_verifier.py |
Dependencies
None found in the software bill of materials for this release.
computed 2026-09-17 11:49 UTC · analyzer 0.1.0Releases
| Version | Date | Scan | Changed | Notes |
|---|---|---|---|---|
| v1.0.0 | 2026-09-17 | pass | — | Production-ready release. Tests and validates RAG pipeline grounding quality and source attribution accuracy. |
Machine-readable at https://x402git.com/api/v/genesiscode2026/genesis-rag-grounding-regression/releases. Entries cannot be deleted by the creator.
Order
GET v1.0.0 · $79 · new releases $15
The resource endpoint answers 402 with the price and the exact bytes to sign; the same request carrying PAYMENT-SIGNATURE returns a signed download URL. Access is granted only after settlement returns a transaction hash. A person can do the same thing with a browser wallet on the product page.
# the 402, with the price and the exact bytes to sign
curl -si https://x402git.com/api/r/genesiscode2026/genesis-rag-grounding-regression
# what your wallet already owns, and what the next fetch would cost it
curl -s https://x402git.com/api/v/genesiscode2026/genesis-rag-grounding-regression \
-H "X-Wallet-Signature: 0xYOURADDRESS.<nonce>.<signature>"The first request answers this — a real quote, made for this page load:
HTTP/1.1 402 Payment Required
Content-Type: application/json
{
"x402Version": 2,
"resource": {
"url": "https://x402git.com/api/r/genesiscode2026/genesis-rag-grounding-regression",
"description": "genesiscode2026/genesis-rag-grounding-regression v1.0.0 — release. Verify factual grounding of RAG output against sources Security scan passed; signed download, 5-minute URL.",
"mimeType": "application/zip",
"serviceName": "genesis-rag-grounding-regression",
"tags": [
"toolkit",
"scripts",
"tests",
"docs",
"config"
]
},
"accepts": [
{
"scheme": "exact",
"network": "eip155:8453",
"amount": "79000000",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0xDbd32F7565FFdb901Ea48281777aD03d35bB4b60",
"maxTimeoutSeconds": 300,
"extra": {
"name": "USD Coin",
"version": "2"
},
"maxAmountRequired": "79000000",
"resource": "https://x402git.com/api/r/genesiscode2026/genesis-rag-grounding-regression",
"description": "genesiscode2026/genesis-rag-grounding-regression v1.0.0 — release. Verify factual grounding of RAG output against sources Security scan passed; signed download, 5-minute URL.",
"mimeType": "application/zip"
}
],
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"queryParams": {},
"method": "GET"
},
"output": {
"type": "json",
"example": {
"version": "1.0.0",
"artifact_sha256": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
"download_url": "https://storage.example/genesiscode2026/genesis-rag-grounding-regression/1.0.0.zip?signed=…",
"expires_at": "2026-09-16T12:05:00.000Z",
"version_endpoint": "https://x402git.com/api/r/genesiscode2026/genesis-rag-grounding-regression/v/1.0.0",
"manifest_url": "https://x402git.com/api/label/genesiscode2026/genesis-rag-grounding-regression",
"all_versions": false
}
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"input": {
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"type": "string",
"enum": [
"GET"
]
},
"queryParams": {
"type": "object",
"properties": {}
}
},
"required": [
"type",
"method"
],
"additionalProperties": false
},
"output": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"properties": {
"version": {
"type": "string",
"description": "Semantic version of the release served."
},
"artifact_sha256": {
"type": "string",
"description": "sha256 of the zip; verify the download against it."
},
"download_url": {
"type": "string",
"description": "Signed URL over the exact bytes that were scanned. Valid five minutes."
},
"expires_at": {
"type": "string",
"format": "date-time"
},
"version_endpoint": {
"type": "string",
"description": "Re-fetch this exact version later, free, with X-Wallet-Signature."
},
"manifest_url": {
"type": "string",
"description": "The public manifest for this listing."
},
"all_versions": {
"type": "boolean",
"description": "True when the purchase covers every later release too."
}
},
"required": [
"version",
"artifact_sha256",
"download_url",
"expires_at",
"version_endpoint",
"manifest_url",
"all_versions"
],
"additionalProperties": false
}
},
"required": [
"type"
]
}
},
"required": [
"input"
]
}
}
},
"extra": {
"kind": "new",
"version": "1.0.0",
"manifest_url": "https://x402git.com/api/label/genesiscode2026/genesis-rag-grounding-regression",
"scan_badge_url": "https://x402git.com/api/label/genesiscode2026/genesis-rag-grounding-regression#scan",
"update_price_micro": "15000000",
"quote_id": "q_a629580d4407c47cbead86f8ceb7651b",
"valid_before": "2026-09-17T14:55:42.442Z",
"instructions": "This is an x402 paywall, not an error. To buy: sign accepts[0] from the 402 as an EIP-3009 USDC authorization on Base with your own wallet, then GET https://x402git.com/api/r/genesiscode2026/genesis-rag-grounding-regression again with the payment in the PAYMENT-SIGNATURE header and extra.quote_id in X-Quote-Id — or, over MCP, call `purchase` again with the same payment as `payment_signature`. The full procedure is at https://x402git.com/.well-known/agent-skills/buy-a-repo/SKILL.md; the same tools are an MCP server at https://x402git.com/api/mcp. No wallet? A person can buy at https://x402git.com/genesiscode2026/genesis-rag-grounding-regression, and the free manifest at https://x402git.com/api/label/genesiscode2026/genesis-rag-grounding-regression shows what is inside before anyone pays.",
"listing_url": "https://x402git.com/genesiscode2026/genesis-rag-grounding-regression",
"skill_url": "https://x402git.com/.well-known/agent-skills/buy-a-repo/SKILL.md",
"mcp_url": "https://x402git.com/api/mcp"
}
}- Resource
- https://x402git.com/api/r/genesiscode2026/genesis-rag-grounding-regression
- Manifest
- https://x402git.com/api/label/genesiscode2026/genesis-rag-grounding-regression
- Version
- https://x402git.com/api/v/genesiscode2026/genesis-rag-grounding-regression
- Artifact sha256
- f5159583c9e2616553af979949a238e7fe3dce71017b3c54ab4f43a45e73f326
Later releases cost $15, and never more than the update price in force when you bought. One charge per update, whatever the release cadence.
Sold by genesiscode2026. Read the terms and the route documentation before you script against this. Base URL https://x402git.com.