{
  "capability_id": "mechanical.statics.planar_equilibrium",
  "tool_id": "planar-equilibrium",
  "engine": "planar-equilibrium",
  "calculation_version": "1.0.0",
  "generated_at": "2026-09-23T10:57:00.181Z",
  "engine_build": "2026-09-23",
  "test_count": 6,
  "passed": 6,
  "failed": 0,
  "tests_summary": {
    "golden": {
      "total": 2,
      "passed": 2
    },
    "boundary": {
      "total": 4,
      "passed": 4
    },
    "property": {
      "total": 0,
      "passed": 0
    }
  },
  "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/physics/planar-equilibrium",
  "api": "https://www.calculatorx.com/api/v1/calc/planar-equilibrium",
  "schema_input": "https://www.calculatorx.com/schemas/mechanical.statics.planar_equilibrium.input.json",
  "schema_output": "https://www.calculatorx.com/schemas/mechanical.statics.planar_equilibrium.output.json",
  "assumptions": [],
  "limitations": [
    "2-D point forces and concentrated moments only",
    "Moment about the origin, CCW positive",
    "Solve path is exactly 2 or 3 unknowns",
    "Not beam deflection, distributed load, frames, or 3-D"
  ],
  "boundary_conditions": [
    "no forces and no moments → MISSING_REQUIRED_INPUT",
    "unknowns in resultant mode → INVALID_INPUT",
    "1 or more than 3 unknowns → INVALID_INPUT",
    "2 unknowns that cannot satisfy all three equations → INVALID_INPUT"
  ],
  "sources": [
    {
      "title": "Hibbeler, Engineering Mechanics: Statics",
      "section": "Force systems and rigid-body equilibrium",
      "supports": "ΣFx = 0, ΣFy = 0, ΣM = 0 for a planar rigid body",
      "kind": "reference"
    }
  ],
  "methods": [],
  "fingerprint": "sha256:d0264a345a6a0ef94c239f59a9481be4349685c86578c9fb0bb90b7f0c17878a",
  "tests": [
    {
      "id": "golden-resultant-345",
      "ok": true,
      "kind": "golden",
      "inputs": {
        "mode": "resultant",
        "forces": "3,0; 0,4"
      },
      "expect": {
        "resultant_n": 5,
        "sum_fx": 3,
        "sum_fy": 4,
        "sum_m": 0,
        "model": "planar_equilibrium"
      },
      "expectWarning": null,
      "actual": {
        "mode": "resultant",
        "model": "planar_equilibrium",
        "sum_fx": 3,
        "sum_fy": 4,
        "sum_m": 0,
        "resultant_n": 5,
        "angle_deg": 53.13010235415598,
        "convention": "CCW positive; M = x Fy − y Fx about the origin",
        "balanced": false,
        "unknowns": [],
        "solver": "math.vector add + cross"
      },
      "tol": 1e-12
    },
    {
      "id": "boundary-moment",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "mode": "resultant",
        "forces": "0,-10,2,0"
      },
      "expect": {
        "sum_m": -20
      },
      "expectWarning": null,
      "actual": {
        "mode": "resultant",
        "model": "planar_equilibrium",
        "sum_fx": 0,
        "sum_fy": -10,
        "sum_m": -20,
        "resultant_n": 10,
        "angle_deg": -90,
        "convention": "CCW positive; M = x Fy − y Fx about the origin",
        "balanced": false,
        "unknowns": [],
        "solver": "math.vector add + cross"
      },
      "tol": 1e-9
    },
    {
      "id": "golden-equilibrium",
      "ok": true,
      "kind": "golden",
      "inputs": {
        "mode": "equilibrium",
        "forces": "0,-100,2,0; 0,0,0,0,fx+fy",
        "moments": "0,m"
      },
      "expect": {
        "balanced": true,
        "solver": "math.linear_algebra solve order 3"
      },
      "expectWarning": null,
      "actual": {
        "mode": "equilibrium",
        "model": "planar_equilibrium",
        "sum_fx": 0,
        "sum_fy": -100,
        "sum_m": -200,
        "resultant_n": 100,
        "angle_deg": -90,
        "convention": "CCW positive; M = x Fy − y Fx about the origin",
        "balanced": true,
        "unknowns": [
          {
            "id": "F2.fx",
            "value": 0
          },
          {
            "id": "F2.fy",
            "value": 100
          },
          {
            "id": "M1",
            "value": 200
          }
        ],
        "solver": "math.linear_algebra solve order 3"
      },
      "tol": null
    },
    {
      "id": "boundary-empty",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "mode": "resultant"
      },
      "expectError": "MISSING_REQUIRED_INPUT",
      "code": "MISSING_REQUIRED_INPUT",
      "error": "Enter at least one force or moment."
    },
    {
      "id": "boundary-mode",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "mode": "beam",
        "forces": "1,0"
      },
      "expectError": "INVALID_MODE",
      "code": "INVALID_MODE",
      "error": "mode must be resultant or equilibrium."
    },
    {
      "id": "boundary-inconsistent",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "mode": "equilibrium",
        "forces": "0,-10,2,0; 0,0,fx+fy"
      },
      "expectError": "INVALID_INPUT",
      "code": "INVALID_INPUT",
      "error": "These 2 unknowns cannot satisfy ΣFx, ΣFy, and ΣM (residual 20)."
    }
  ],
  "tier": "engine_tested",
  "verification": {
    "tests": {
      "passed": 6,
      "total": 6,
      "golden": 2,
      "boundary": 4,
      "property": 0
    },
    "contract_checks": {
      "passed": 6,
      "total": 6
    }
  },
  "evidence_core_generated_at": "2026-09-23T06:12:30.048Z",
  "rendered_at": "2026-09-23T10:57:00.181Z",
  "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": "41d2fa8229214b25c71e2bb5ff68b7d8e72ccf50a520d034be955ec241c3b67e",
      "output_schema_sha256": "771c270f4d80d40a536ac26f6779701ef3e836ffa1cc2137a8dd3fa9fabc5b0d",
      "evidence_sha256": "7fa19e8831ab7055041cd4db7a49a3e480eb98791a6e4c07d0c3dd798a803058",
      "evidence_core_sha256": "7fa19e8831ab7055041cd4db7a49a3e480eb98791a6e4c07d0c3dd798a803058",
      "capability_sha256": "62446c4da1404e12e060c4fbbda7e2456bac0ef9276acc6d6f562c082e46c7f3",
      "engine_sha256": "2834c6bc0e697b4d1e17766004f95cbfb57722d30aac4f3245109e79ef19ffae",
      "mcp_contract_sha256": "7015b0a59a475803dcfdfe80a660fa9d4d216cc36bd496d9466d1918d64ff186"
    },
    "contract_checks": {
      "total": 6,
      "passed": 6,
      "failed": 0,
      "items": [
        {
          "id": "release-artifacts-aligned",
          "status": "pass",
          "detail": "1.0.0"
        },
        {
          "id": "schema-output-required-declared",
          "status": "pass"
        },
        {
          "id": "schema-valid-input-executes",
          "status": "pass"
        },
        {
          "id": "engine-success-output-validates-schema",
          "status": "pass"
        },
        {
          "id": "schema-rejects-incomplete-input",
          "status": "pass"
        },
        {
          "id": "rest-success-payload-validates-schema",
          "status": "pass"
        }
      ]
    },
    "report": "https://www.calculatorx.com/.well-known/calculatorx-release-integrity.json"
  }
}
