Free MIT-licensed release · Version 0.1.0

Catch product-page contradictions before buyers do.

Surface Contract Check compares selected prices, limits, plan names or versions across public pages and local files. Every run records source locators, byte counts and SHA-256 hashes, then exits with a CI-friendly status.

Python 3.9+ · Zero runtime dependencies · 16/16 tests passed locally and in GitHub Actions · AI-assisted implementation, manually reviewed

Download and install

Download source release View source on GitHub

unzip surface-contract-check-0.1.0.zip
cd surface-contract-check-0.1.0
python3 -m venv .venv
.venv/bin/pip install .

The archive includes the source, tests, examples, GitHub Actions workflow and MIT license.

Define one product contract

{
  "sources": {
    "pricing": {"url": "https://example.com/pricing", "format": "html"},
    "docs": {"url": "https://example.com/docs/billing", "format": "html"}
  },
  "checks": [{
    "name": "starter monthly price",
    "rule": "equal",
    "extract": [
      {"source": "pricing", "pattern": "Starter:\\s*\\$(\\d+)"},
      {"source": "docs", "pattern": "Starter:\\s*\\$(\\d+)"}
    ]
  }]
}

surface-contract check product-facts.json --json

Use the exit code in a release check

Exit	Meaning	Release action
`0`	Every configured value matched.	Continue the pipeline.
`1`	A value was missing or inconsistent.	Review the named source and extracted evidence.
`2`	The contract, source or regular expression was invalid or unavailable.	Repair the check before treating the result as product evidence.

Evidence boundary

The report proves what the configured sources returned during that run. It does not execute client-side JavaScript, inspect private dashboards, determine checkout billing, establish legal compliance or decide which conflicting value is authoritative. The product owner still chooses the canonical rule.

Release integrity

SHA-256 for surface-contract-check-0.1.0.zip:

f41058fa1ebe0aba3789ac9c100d17ff3bdbcc56a94f71360ef64954a1b7c2d0

This is an original, client-neutral release. It contains no client code and does not claim a third-party customer relationship. The archive is free to inspect and use under the MIT license.

Need the first contract wired into your product?

Send up to four public surfaces and the rule your product owner confirms. A US$60 fixed-scope integration includes the contract, one focused repair, a regression check and acceptance evidence.

Request the fixed-scope integration