{
  "capability_id": "education.final_grade",
  "tool_id": "final-grade",
  "engine": "final-grade",
  "calculation_version": "1.1.1",
  "generated_at": "2026-11-10T05:18:42.043Z",
  "engine_build": "2026-09-10",
  "test_count": 26,
  "passed": 26,
  "failed": 0,
  "tests_summary": {
    "golden": {
      "passed": 5,
      "total": 5
    },
    "boundary": {
      "passed": 12,
      "total": 12
    },
    "property": {
      "passed": 8,
      "total": 8
    },
    "formula_crosscheck": {
      "passed": 1,
      "total": 1
    }
  },
  "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/grade/final-grade",
  "api": "https://www.calculatorx.com/api/v1/calc/final-grade",
  "schema_input": "https://www.calculatorx.com/schemas/education.final_grade.input.json",
  "schema_output": "https://www.calculatorx.com/schemas/education.final_grade.output.json",
  "assumptions": [
    "Category weights are percentages that should total about 100% including remaining work.",
    "Need on final / Overall after final: Current must exclude the final. Do not enter a current grade that already counts the final as 0%.",
    "Weighted course: enter category grades and weights as they actually appear in the syllabus or LMS for completed work.",
    "No curve, drop-lowest, or extra credit unless you adjust inputs yourself."
  ],
  "limitations": [
    "Need on final / Overall: Current must exclude the final (pre-final grade). Do not enter an LMS current that already counts the final as 0%.",
    "Weighted: enter category grades and weights as they actually appear for completed work; remaining weight is optional.",
    "W is percent (40); w = W/100 is the fraction form. Do not mix W and w in one expression.",
    "Need on final with W = 0 → status invalid, code WEIGHT_REQUIRED (not a number).",
    "Points mode total ≤ 0 → TOTAL_POINTS_REQUIRED. Final points > total still computes and warns POINTS_EXCEED_TOTAL.",
    "Letter cutoffs / GPA points are a reference example, not part of the calculation model.",
    "Planning estimate only — not an official transcript. No curve, drop-lowest, or extra credit unless you adjust inputs.",
    "Engine aliases current/goal/W/finalScore/totalPoints are accepted at runtime; prefer share-URL field names in schemas."
  ],
  "boundary_conditions": [
    "Final weight must be > 0 for Need on final.",
    "Needed > 100% ⇒ goal unreachable; Needed = 0% ⇒ already secured boundary; Needed < 0% ⇒ goal already secured.",
    "W = 100% ⇒ Needed = Goal; W = 0% ⇒ validation error.",
    "Overall with W = 0% ⇒ Overall = Current; W = 100% ⇒ Overall = Final.",
    "Total points must be > 0 for Points → weight. Final points > total points is allowed but flagged."
  ],
  "sources": [
    {
      "title": "University of Chicago — Use Weighted Assignment Groups in Your Canvas Course",
      "section": "Total = Σ(category percentage × group weight); example: quizzes 20% + midterm 30% + final 40% + participation 10%",
      "url": "https://courses.uchicago.edu/2022/08/26/use-weighted-assignment-groups-in-your-canvas-course/",
      "supports": "Institutional statement of the weighted-category course grade as a linear combination of category averages",
      "kind": "reference",
      "accessed": "2026-08-18"
    },
    {
      "title": "Appalachian State University — Gradebook: Weighted Mean of Grades (Percentages)",
      "section": "Weighted mean of grades; unentered items are excluded and remaining weights are rescaled until those scores exist",
      "url": "https://confluence.appstate.edu/pages/viewpage.action?pageId=32473144",
      "supports": "Why Current grade should exclude the final, and why an LMS “current grade” may temporarily omit an ungraded final",
      "kind": "reference",
      "accessed": "2026-08-18"
    },
    {
      "title": "Weighted arithmetic mean (pre-final average and final exam weight)",
      "section": "Overall = Current×(100−W)/100 + Final×W/100, equivalently Current(1−w)+Final·w with w = W/100",
      "supports": "The algebraic identity used by Need on final and Overall after final, independent of any one school’s letter scale",
      "kind": "definition"
    }
  ],
  "methods": [],
  "fingerprint": "sha256:d0c84c4dfd54ae467be14367de1c0f3532748857b551ffe47175946d417c9479",
  "tier": "engine_tested",
  "verification": {
    "tests": {
      "passed": 26,
      "total": 26,
      "golden": 5,
      "boundary": 12,
      "property": 8,
      "formula_crosscheck": 1
    },
    "contract_checks": {
      "passed": 6,
      "total": 6
    }
  },
  "evidence_core_generated_at": "2026-09-10T22:48:17.762Z",
  "rendered_at": "2026-11-10T05:18:42.043Z",
  "release_integrity": {
    "status": "verified",
    "scope": "workspace",
    "production_attestation_required": true,
    "calculation_version": "1.1.1",
    "artifacts": {
      "engine": "1.1.1",
      "page": "1.1.1",
      "capability": "1.1.1",
      "evidence": "1.1.1",
      "input_schema": "1.1.1",
      "output_schema": "1.1.1",
      "mcp_contract": "1.1.1"
    },
    "digests": {
      "input_schema_sha256": "548a9acb12e46491968636cf4991a6f7ab8a701719afbde49b6e02c3921c9df2",
      "output_schema_sha256": "2fa2caf68de0f94e8f23cae378eed36318bc3b0edbb0cdebcadfd2b07cd7e1ba",
      "evidence_sha256": "cb7eda64b472a75f59935edace8bd3b21a18c08e62bda430d126726c25caefed",
      "evidence_core_sha256": "cb7eda64b472a75f59935edace8bd3b21a18c08e62bda430d126726c25caefed",
      "capability_sha256": "1b42e34d8aea1979f8e61c6909c7f019bbc9e592e52f58cc1172d8620d33f041",
      "engine_sha256": "c6ebd8436f08b413e1ac6317b2d48550f2e6639a90dff254244e3aa562158b8d",
      "mcp_contract_sha256": "eb3e39ad4a95ed263415b4932f185d5edfe00a2403267b7c5ed5f718d1ff6da3"
    },
    "contract_checks": {
      "total": 6,
      "passed": 6,
      "failed": 0,
      "items": [
        {
          "id": "release-artifacts-aligned",
          "status": "pass",
          "detail": "1.1.1"
        },
        {
          "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"
  },
  "tests": [],
  "disclosure": {
    "policy": "calculatorx-public-evidence-v1",
    "full_validation": "private",
    "representation": "summary"
  }
}