MatCheckJSON — JSON format for auditable material compliance results

Machine-readable results of resolving MatSpecJSON and activated MatReqJSON requirements and evaluating them against normalized MatRecordJSON evidence.

Working draft · v0.1.matcheck.json

Overview

MatCheckJSON standardizes the audit trail and result semantics of a material check. It records exact input identity, requirement resolution, subject selection, calculations, observed evidence, findings, aggregation, and review state while keeping source requirements and evidence in their native MatJSON profiles.

Open the linked schema

Read the actual JSON Schema with stable object anchors, linked $ref values, and human-readable definition guides.

Open linked schema

Primary content

  • Content-hashed MatSpecJSON, MatReqJSON, and MatRecordJSON inputs
  • Project/requisition inputs used to activate or resolve requirements
  • Evaluated material subjects and selector context
  • Requirement resolution before compliance evaluation
  • Calculations, unit conversion, rounding, and comparisons
  • Per-requirement findings linked to MatRecordJSON evidence
  • Overall summary, review state, provenance, and extensions

Finding states

  • pass
  • fail
  • not_applicable
  • missing_evidence
  • missing_project_input
  • requisition_gap
  • ambiguous_material_selector
  • conflicting_requirements
  • manual_review_required
  • external_evidence_required
  • unsupported_evaluation
  • not_evaluated

Core convergence

Migration plan: MatCheckJSON v0.1 already uses MatJSON Core v0.1 for shared primitives. Its next revision will track the stabilized Core contract together with the corresponding next revisions of MatSpecJSON, MatReqJSON, and MatRecordJSON.

Schema access

Open the human-readable reference, view the versioned JSON Schema, or download a local copy.