{
  "meta": {
    "schemaVersion": "1.0",
    "id": "knowledge:methodology:value-score",
    "type": "methodology",
    "slug": "value-score",
    "title": "Value Score Methodology",
    "description": "Methodology for Value Score composition and tier assignment.",
    "canonicalUrl": "https://priceofelectricity.com/knowledge/methodology/value-score",
    "jsonUrl": "https://priceofelectricity.com/knowledge/methodology/value-score.json",
    "updatedAt": "2026-02-22T00:00:00.000Z",
    "sourceVersion": "v20260222",
    "temporalContext": {
      "sourceVersion": "v20260222",
      "isLatest": true
    },
    "provenance": [
      {
        "id": "poe-methodology-value-score",
        "sourceName": "PriceOfElectricity.com methodology: Value Score",
        "sourceUrl": "https://priceofelectricity.com/methodology/value-score",
        "publisher": "PriceOfElectricity.com",
        "license": "Site content license",
        "retrievedAt": "2026-02-22T00:00:00.000Z"
      }
    ],
    "fieldProvenance": [
      {
        "field": "data.definition",
        "provenanceIds": [
          "poe-methodology-value-score"
        ]
      },
      {
        "field": "data.inputs",
        "provenanceIds": [
          "poe-methodology-value-score"
        ]
      },
      {
        "field": "data.steps",
        "provenanceIds": [
          "poe-methodology-value-score"
        ]
      },
      {
        "field": "data.limitations",
        "provenanceIds": [
          "poe-methodology-value-score"
        ]
      },
      {
        "field": "data.relatedInternalUrls",
        "provenanceIds": [
          "poe-methodology-value-score"
        ]
      }
    ],
    "citations": [
      {
        "sourceName": "PriceOfElectricity.com methodology: Value Score",
        "sourceUrl": "https://priceofelectricity.com/methodology/value-score",
        "retrievedAt": "2026-02-22T00:00:00.000Z"
      }
    ],
    "llmHints": {
      "priority": "high",
      "entityType": "methodology",
      "semanticTopics": [
        "methodology",
        "electricity rates",
        "index calculation",
        "data freshness"
      ],
      "semanticCluster": "calculation-framework"
    },
    "freshness": {
      "datasetUpdatedAt": "2026-02-22T00:00:00.000Z",
      "computedAt": "2026-02-22T00:00:00.000Z",
      "status": "fresh",
      "ageDays": 0,
      "methodology": {
        "id": "freshness",
        "version": "1.0",
        "url": "https://priceofelectricity.com/knowledge/methodology/freshness.json",
        "canonicalUrl": "https://priceofelectricity.com/knowledge/methodology/freshness"
      }
    },
    "excerpt": "Value Score Methodology. Defines how value score is computed from inputs and produces derived fields used across state and ranking pages.",
    "disclaimerRefs": [
      "methodology"
    ],
    "methodology": {
      "id": "value-score",
      "version": "1.0",
      "lastReviewedAt": "2026-02-22",
      "relatedDerivedFields": [
        "data.derived.valueScore",
        "data.derived.affordabilityIndex",
        "data.derived.percentileRankings.valueScorePercentile",
        "data.derived.percentileRankings.affordabilityPercentile",
        "data.sortedStates"
      ]
    },
    "qualityScore": 100,
    "contentHash": "20498ca8f601438b2dcf7ef1cbc718ea806eeb06fe171db4b0e897f7d7d31bc6",
    "integrity": {
      "contentHash": "20498ca8f601438b2dcf7ef1cbc718ea806eeb06fe171db4b0e897f7d7d31bc6",
      "integrityAlgorithm": "sha256",
      "signedAtBuild": "2026-02-22T00:00:00.000Z"
    }
  },
  "data": {
    "definition": "Value Score combines affordability and freshness signals into a single ranking score.",
    "inputs": [
      "Affordability index",
      "Freshness status",
      "Normalized state rates"
    ],
    "steps": [
      "Compute affordability records from normalized states.",
      "Apply Value Score weighting.",
      "Assign value tier labels."
    ],
    "limitations": [
      "Score is a comparative heuristic, not a utility bill forecast.",
      "Dependent on monthly cadence of source updates."
    ],
    "relatedInternalUrls": [
      "https://priceofelectricity.com/knowledge/methodology/value-score",
      "https://priceofelectricity.com/value-ranking"
    ],
    "relatedEntities": {
      "national": true,
      "rankings": [
        "value-score"
      ]
    }
  }
}
