{
  "meta": {
    "schemaVersion": "1.0",
    "id": "knowledge:methodology:freshness",
    "type": "methodology",
    "slug": "freshness",
    "title": "Freshness Scoring Methodology",
    "description": "Methodology for data freshness status and recency labels.",
    "canonicalUrl": "https://priceofelectricity.com/knowledge/methodology/freshness",
    "jsonUrl": "https://priceofelectricity.com/knowledge/methodology/freshness.json",
    "updatedAt": "2026-02-22T00:00:00.000Z",
    "sourceVersion": "v20260222",
    "temporalContext": {
      "sourceVersion": "v20260222",
      "isLatest": true
    },
    "provenance": [
      {
        "id": "poe-methodology-freshness",
        "sourceName": "PriceOfElectricity.com methodology: Freshness Scoring",
        "sourceUrl": "https://priceofelectricity.com/methodology/freshness-scoring",
        "publisher": "PriceOfElectricity.com",
        "license": "Site content license",
        "retrievedAt": "2026-02-22T00:00:00.000Z"
      }
    ],
    "fieldProvenance": [
      {
        "field": "data.definition",
        "provenanceIds": [
          "poe-methodology-freshness"
        ]
      },
      {
        "field": "data.inputs",
        "provenanceIds": [
          "poe-methodology-freshness"
        ]
      },
      {
        "field": "data.steps",
        "provenanceIds": [
          "poe-methodology-freshness"
        ]
      },
      {
        "field": "data.limitations",
        "provenanceIds": [
          "poe-methodology-freshness"
        ]
      },
      {
        "field": "data.relatedInternalUrls",
        "provenanceIds": [
          "poe-methodology-freshness"
        ]
      }
    ],
    "citations": [
      {
        "sourceName": "PriceOfElectricity.com methodology: Freshness Scoring",
        "sourceUrl": "https://priceofelectricity.com/methodology/freshness-scoring",
        "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": "Freshness Scoring Methodology. Defines how freshness status is computed from inputs and produces derived fields used across state and ranking pages.",
    "disclaimerRefs": [
      "methodology"
    ],
    "methodology": {
      "id": "freshness",
      "version": "1.0",
      "lastReviewedAt": "2026-02-22",
      "relatedDerivedFields": [
        "data.derived.freshnessStatus"
      ]
    },
    "qualityScore": 100,
    "contentHash": "06c79630636226a73cc50a614b0dbe5ac0fac7ebc254cb8b1d46fea6bc5a18ac",
    "integrity": {
      "contentHash": "06c79630636226a73cc50a614b0dbe5ac0fac7ebc254cb8b1d46fea6bc5a18ac",
      "integrityAlgorithm": "sha256",
      "signedAtBuild": "2026-02-22T00:00:00.000Z"
    }
  },
  "data": {
    "definition": "Freshness scoring classifies data recency based on the updated field age.",
    "inputs": [
      "Updated month",
      "Current date"
    ],
    "steps": [
      "Parse updated month/year into UTC date.",
      "Calculate age in days.",
      "Map age to freshness status and label."
    ],
    "limitations": [
      "Recency does not guarantee source revision significance.",
      "Cadence assumptions may vary by external publisher."
    ],
    "relatedInternalUrls": [
      "https://priceofelectricity.com/knowledge/methodology/freshness",
      "https://priceofelectricity.com/data-policy"
    ],
    "relatedEntities": {
      "national": true
    }
  }
}