{
  "capability_id": "engineering.msa.hysteresis",
  "tool_id": "hysteresis",
  "engine": "hysteresis",
  "calculation_version": "1.0.0",
  "generated_at": "2026-09-15T23:38:12.912Z",
  "engine_build": "2026-09-15",
  "test_count": 8,
  "passed": 8,
  "failed": 0,
  "tests_summary": {
    "golden": {
      "total": 0,
      "passed": 0
    },
    "boundary": {
      "total": 5,
      "passed": 5
    },
    "property": {
      "total": 3,
      "passed": 3
    }
  },
  "engine_tested": true,
  "expert_reviewed": false,
  "internally_reviewed": false,
  "review_kind": null,
  "source_checked": true,
  "reviewed_by": null,
  "reviewer_role": null,
  "last_reviewed": null,
  "expert_review": {
    "status": "optional_not_performed",
    "reviewer": null,
    "scope": [
      "formula",
      "input semantics",
      "assumptions",
      "limitations",
      "sources",
      "tests"
    ],
    "note": "Domain expert review is optional under CVP (CVP-EXP-01). Absence does not block CVP Verified. See Review policy for supplemental domain assurance."
  },
  "internal_review": {
    "status": "not_applicable",
    "reviewer": null
  },
  "page": "https://www.calculatorx.com/calc/engineering/hysteresis",
  "api": "https://www.calculatorx.com/api/v1/calc/hysteresis",
  "schema_input": "https://www.calculatorx.com/schemas/engineering.msa.hysteresis.input.json",
  "schema_output": "https://www.calculatorx.com/schemas/engineering.msa.hysteresis.output.json",
  "assumptions": [
    "VIM 4.17 hysteresis as max |y_up − y_down| at index-paired stations",
    "n≥2; pairing is by index, not interpolated vs xref",
    "Not OLS linearity, not a %Hysteresis verdict, and not AIAG GRR"
  ],
  "limitations": [
    "Maximum paired |y_up − y_down| — not a %Hysteresis / process-variation verdict",
    "Not OLS of ε versus xref (Linearity) and not a single-shot measurement error",
    "Does not take T and does not issue pass/fail",
    "n≥2 index-paired points; not AIAG GRR"
  ],
  "boundary_conditions": [
    "missing y_up or y_down → MISSING_REQUIRED_INPUT",
    "n < 2 → VALUE_OUT_OF_RANGE",
    "length mismatch → INVALID_INPUT",
    "identical curves → H=0 (valid)"
  ],
  "sources": [
    {
      "title": "JCGM 200:2012 — International vocabulary of metrology (VIM)",
      "section": "4.17 hysteresis",
      "supports": "Difference of indication when the measured quantity is approached from opposite directions.",
      "kind": "standard"
    }
  ],
  "methods": [],
  "fingerprint": "sha256:b634e7051166eaf150ddc82867a3f461e27e01d7d0fb4dfb6d48767da5846b54",
  "tests": [
    {
      "id": "boundary-hyst",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "y_up": [
          0,
          2,
          4
        ],
        "y_down": [
          0,
          1,
          4
        ]
      },
      "expect": {
        "hysteresis": 1,
        "n": 3
      },
      "expectWarning": null,
      "actual": {
        "hysteresis": 1,
        "mean_abs": 0.3333333333333333,
        "n": 3,
        "delta": [
          0,
          1,
          0
        ],
        "y_up": [
          0,
          2,
          4
        ],
        "y_down": [
          0,
          1,
          4
        ]
      },
      "tol": 1e-12
    },
    {
      "id": "boundary-hyst-zero",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "y_up": [
          0,
          2,
          4
        ],
        "y_down": [
          0,
          2,
          4
        ]
      },
      "expect": {
        "hysteresis": 0,
        "n": 3
      },
      "expectWarning": null,
      "actual": {
        "hysteresis": 0,
        "mean_abs": 0,
        "n": 3,
        "delta": [
          0,
          0,
          0
        ],
        "y_up": [
          0,
          2,
          4
        ],
        "y_down": [
          0,
          2,
          4
        ]
      },
      "tol": 1e-12
    },
    {
      "id": "boundary-hyst-n1",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "y_up": [
          0
        ],
        "y_down": [
          1
        ]
      },
      "expectError": "VALUE_OUT_OF_RANGE",
      "code": "VALUE_OUT_OF_RANGE",
      "error": "hysteresis needs at least 2 paired points"
    },
    {
      "id": "boundary-hyst-len",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "y_up": [
          0,
          2,
          4
        ],
        "y_down": [
          0,
          1
        ]
      },
      "expectError": "INVALID_INPUT",
      "code": "INVALID_INPUT",
      "error": "y_up and y_down must have the same length"
    },
    {
      "id": "boundary-hyst-missing",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "y_up": [
          0,
          2,
          4
        ]
      },
      "expectError": "MISSING_REQUIRED_INPUT",
      "code": "MISSING_REQUIRED_INPUT",
      "error": "y_down is required"
    },
    {
      "id": "property-hyst",
      "ok": true,
      "kind": "property",
      "detail": "1",
      "expect": 1,
      "actual": 1
    },
    {
      "id": "property-hyst-zero",
      "ok": true,
      "kind": "property",
      "detail": "0",
      "expect": 0,
      "actual": 0
    },
    {
      "id": "property-hyst-alias",
      "ok": true,
      "kind": "property",
      "detail": "1",
      "expect": 1,
      "actual": 1
    }
  ],
  "tier": "engine_tested",
  "verification": {
    "tests": {
      "passed": 8,
      "total": 8,
      "golden": 0,
      "boundary": 5,
      "property": 3
    },
    "contract_checks": {
      "passed": 4,
      "total": 4
    }
  },
  "evidence_core_generated_at": "2026-09-15T22:49:35.937Z",
  "rendered_at": "2026-09-15T23:38:12.912Z",
  "release_integrity": {
    "status": "verified",
    "scope": "workspace",
    "production_attestation_required": true,
    "calculation_version": "1.0.0",
    "artifacts": {
      "engine": "1.0.0",
      "page": "1.0.0",
      "capability": "1.0.0",
      "evidence": "1.0.0",
      "input_schema": "1.0.0",
      "output_schema": "1.0.0",
      "mcp_contract": "1.0.0"
    },
    "digests": {
      "input_schema_sha256": "629ef1b645a802b27d191bd3564c170f1221795f8acd7fa679ce17955ece99c2",
      "output_schema_sha256": "7d72b54ae4ea5c131ff694ba735e95c04a149f46d54e6e5351274e5a14ffeba8",
      "evidence_sha256": "1b7581bc5df2799e2d8154cb19fc5b0e9f9e7592834c112d36ac86405cc1a98c",
      "evidence_core_sha256": "1b7581bc5df2799e2d8154cb19fc5b0e9f9e7592834c112d36ac86405cc1a98c",
      "capability_sha256": "462512d03efc85dd4d9bcf04c035b28206185575f9d11e0b2ff71088760d3c1d",
      "engine_sha256": "9265836b6b06f498f3f985320eab21319806f5471a924aead2cf954a9b6ffd8f",
      "mcp_contract_sha256": "ef59a935293be4e8212bcd43a3fc15993093aab9a9136fa56d3a8d267774178c"
    },
    "contract_checks": {
      "total": 4,
      "passed": 4,
      "failed": 0,
      "items": [
        {
          "id": "release-artifacts-aligned",
          "status": "pass",
          "detail": "1.0.0"
        },
        {
          "id": "schema-valid-input-executes",
          "status": "pass"
        },
        {
          "id": "engine-success-output-validates-schema",
          "status": "pass"
        },
        {
          "id": "schema-rejects-incomplete-input",
          "status": "pass"
        }
      ]
    },
    "report": "https://www.calculatorx.com/.well-known/calculatorx-release-integrity.json"
  }
}
