JSON Schema Enforcer

Required inputs

• contract_definition (json)

  Required fields, expected types, allowed values, and forbidden fields.

• candidate_output (json)

  Generated JSON to validate.

Expected outputs

• validated_output (json)

  JSON payload that passes all contract checks.

• validation_report (markdown)

  Deterministic list of schema violations and fixes.

Included checks and assets

• scripts/assert_contract.py (script)

  Validates JSON output against a lightweight contract spec.

• references/contract-format.md (reference)

  Defines the contract JSON format used by the validator.

• references/edge-cases.md (reference)

  Covers nullability, enum drift, and nested-structure edge cases.

• references/repair-playbook.md (reference)

  Defines deterministic repair ordering and retry policy.

Failure modes

• Semantically incorrect values can still pass if contract is incomplete.
• Nested object constraints are limited in the lightweight checker.
• Human review is still needed for business-rule correctness.

Ideal use cases

• Agent output for API calls
• Structured tool invocation payloads
• Automated compliance checks for JSON responses

Example runs

contract.json + candidate_fail.json

3 deterministic failures with field paths

Changelog summary

• 0.1.0 · Apr 22, 2026

  Initial release with deterministic contract checks.

Links

Inspect the source, read authored documentation, or download the published skill bundle.