{
  "capability_id": "electrical.battery.runtime_temp",
  "tool_id": "battery-runtime-temp",
  "engine": "battery-runtime-temp",
  "calculation_version": "1.2.1",
  "generated_at": "2026-11-10T05:18:41.731Z",
  "engine_build": "2026-09-10",
  "test_count": 31,
  "passed": 31,
  "failed": 0,
  "tests_summary": {
    "golden": {
      "passed": 5,
      "total": 5
    },
    "boundary": {
      "passed": 10,
      "total": 10
    },
    "property": {
      "passed": 16,
      "total": 16
    }
  },
  "engine_tested": true,
  "expert_reviewed": false,
  "internally_reviewed": true,
  "review_kind": "internal",
  "source_checked": true,
  "reviewed_by": "CalculatorX electrical review",
  "reviewer_role": "electrical-engineer",
  "last_reviewed": "2026-08-12",
  "expert_review": {
    "status": "not_applicable",
    "reviewer": null,
    "note": "Internal domain review completed; not a named external expert review.",
    "kind": "internal"
  },
  "internal_review": {
    "status": "approved",
    "reviewer": {
      "name": "CalculatorX electrical review",
      "role": "electrical-engineer"
    },
    "reviewed_at": "2026-08-12",
    "scope": [
      "formula",
      "input semantics",
      "assumptions",
      "limitations",
      "sources",
      "tests"
    ],
    "kind": "internal"
  },
  "page": "https://www.calculatorx.com/calc/electric/battery-runtime-temp",
  "api": "https://www.calculatorx.com/api/v1/calc/battery-runtime-temp",
  "schema_input": "https://www.calculatorx.com/schemas/electrical.battery.runtime_temp.input.json",
  "schema_output": "https://www.calculatorx.com/schemas/electrical.battery.runtime_temp.output.json",
  "assumptions": [
    "Default: cold-only linear derating about 25 °C; T≥25 °C → f_T=1 (no high-temp bonus).",
    "Clamp is a numerical safeguard, not an operating-temperature envelope.",
    "Default k_T=0.006 is a planning default (parameter_validated=false).",
    "Constant load; not Peukert / chemistry Arrhenius / manufacturer curve.",
    "Amps mode I_A is battery-side; η does not enter t_h."
  ],
  "limitations": [
    "Generic cold-derating planning model by default — not Peukert, Arrhenius, or manufacturer curves",
    "Default k_T=0.006 is a planning default (parameter_validated=false), not a validated chemistry coefficient",
    "Clamp is a numerical safeguard, not an operating-temperature envelope",
    "T≥25 °C under generic_cold_derating does not increase capacity (no high-temp bonus)",
    "custom_symmetric_linear is advanced opt-in and still a first-order heuristic",
    "Amps mode = battery-side current; η does not enter runtime",
    "capacity_Ah XOR capacity_mAh; both → INVALID_INPUT",
    "k_T < 0 → VALUE_MUST_BE_NON_NEGATIVE",
    "Intermediate layer toward chemistry/manufacturer profile runtime — not a Battery Simulator"
  ],
  "boundary_conditions": [
    "Missing capacity/V/T_C/load → MISSING_REQUIRED_INPUT / domain codes",
    "Both capacity_Ah and capacity_mAh → INVALID_INPUT",
    "dod/eta outside (0,1] → FRACTION_OUT_OF_RANGE",
    "k_T < 0 → VALUE_MUST_BE_NON_NEGATIVE",
    "Bad mode / temperature_model → INVALID_MODE",
    "f_T at clamp → TEMP_FACTOR_CLAMPED warning"
  ],
  "sources": [
    {
      "title": "Victron Lithium Battery Smart — Operation (capacity vs temperature example)",
      "section": "Capacity vs temperature (product example)",
      "url": "https://www.victronenergy.com/media/pg/Lithium_Battery_Smart/en/operation.html",
      "supports": "Illustrative manufacturer evidence that capacity is rated at 25 °C and falls at low T (e.g. ~−20% at 0 °C, ~−50% at −20 °C under their conditions). Motivates a generic first-order cold planning derating — not a universal k_T calibration. CalculatorX default 0 °C ≈ −15% is first-order planning only.",
      "kind": "reference"
    },
    {
      "title": "Victron SmartShunt — temperature capacity compensation note",
      "section": "Temperature compensation engineering simplification",
      "url": "https://www.victronenergy.com/media/pg/SmartShunt/en/all-features-and-settings.html",
      "supports": "Example of an engineering practice that applies capacity derating below ~20 °C and treats warmer temperatures as lower impact — aligns with CalculatorX default cold-only (no high-temp bonus) planning stance.",
      "kind": "reference"
    },
    {
      "title": "Trojan Battery — temperature effects FAQ",
      "section": "Temperature and capacity / life",
      "url": "https://www.trojanbattery.com/resources/faqs",
      "supports": "High temperature can increase available capacity for some lead-acid chemistries while harming life — reason not to default-reward high T in a generic planning tool.",
      "kind": "reference"
    },
    {
      "title": "CalculatorX Battery Runtime capability",
      "section": "Constant-load watts/amps model (1.2+)",
      "supports": "Base runtime model (BatteryRuntimeBaseInput) extended by temperature factor",
      "kind": "reference"
    }
  ],
  "methods": [],
  "fingerprint": "sha256:07a2cd571bc7cee190b40451e118cf16ebd66763314e9b2be71bd89b98c5a2de",
  "tier": "internally_reviewed",
  "verification": {
    "tests": {
      "passed": 31,
      "total": 31,
      "golden": 5,
      "boundary": 10,
      "property": 16
    },
    "contract_checks": {
      "passed": 6,
      "total": 6
    }
  },
  "evidence_core_generated_at": "2026-09-05T02:35:39.217Z",
  "rendered_at": "2026-11-10T05:18:41.731Z",
  "release_integrity": {
    "status": "verified",
    "scope": "workspace",
    "production_attestation_required": true,
    "calculation_version": "1.2.1",
    "artifacts": {
      "engine": "1.2.1",
      "page": "1.2.1",
      "capability": "1.2.1",
      "evidence": "1.2.1",
      "input_schema": "1.2.1",
      "output_schema": "1.2.1",
      "mcp_contract": "1.2.1"
    },
    "digests": {
      "input_schema_sha256": "1f6dc4f1560deb6a6dc6773554e9402f11937cad9a9add1b3ce3bd2b81e77624",
      "output_schema_sha256": "b86641f8a4c60c84fe3c975df10a72394fe8a16220513508156a50fede69cae6",
      "evidence_sha256": "2348c4f1a9a3007a111156fbd248179b250d0e91bf61199873dedb0f7d80d911",
      "evidence_core_sha256": "2348c4f1a9a3007a111156fbd248179b250d0e91bf61199873dedb0f7d80d911",
      "capability_sha256": "ae57e65f67141a4030abfe30eca9c67932f1dec2ae8277c351d1eac58fb54974",
      "engine_sha256": "c6ebd8436f08b413e1ac6317b2d48550f2e6639a90dff254244e3aa562158b8d",
      "mcp_contract_sha256": "eb3e39ad4a95ed263415b4932f185d5edfe00a2403267b7c5ed5f718d1ff6da3"
    },
    "contract_checks": {
      "total": 6,
      "passed": 6,
      "failed": 0,
      "items": [
        {
          "id": "release-artifacts-aligned",
          "status": "pass",
          "detail": "1.2.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"
  }
}