{
  "tool": "grocery-basket",
  "title": "Grocery Receipt Time Machine",
  "datasetRelease": "release-2026-11-15-b7a8083e2af0",
  "generatedAt": "2026-11-15T22:46:38.619Z",
  "classification": "Source-price calculation with user-selected quantities",
  "inputs": {
    "a": "1995-07",
    "b": "2026-10",
    "quantities": {
      "milk": 1,
      "eggs": 1,
      "bread": 1
    }
  },
  "results": {
    "a": "1995-07",
    "b": "2026-10",
    "rows": [
      {
        "id": "milk",
        "quantity": 1,
        "priceA": 2.477,
        "priceB": 4.101,
        "costA": 2.477,
        "costB": 4.101
      },
      {
        "id": "eggs",
        "quantity": 1,
        "priceA": 0.879,
        "priceB": 2.32,
        "costA": 0.879,
        "costB": 2.32
      },
      {
        "id": "bread",
        "quantity": 1,
        "priceA": 0.789,
        "priceB": 1.861,
        "costA": 0.789,
        "costB": 1.861
      }
    ],
    "missing": [],
    "totalA": 4.145,
    "totalB": 8.282,
    "nominalChange": 99.80699638118217,
    "equivalent": 9.173659639344262,
    "realChange": -9.719781138599103
  },
  "lines": [
    {
      "label": "milk basket cost · 1995-07",
      "value": 2.477,
      "unit": "USD"
    },
    {
      "label": "milk basket cost · 2026-10",
      "value": 4.101,
      "unit": "USD"
    },
    {
      "label": "eggs basket cost · 1995-07",
      "value": 0.879,
      "unit": "USD"
    },
    {
      "label": "eggs basket cost · 2026-10",
      "value": 2.32,
      "unit": "USD"
    },
    {
      "label": "bread basket cost · 1995-07",
      "value": 0.789,
      "unit": "USD"
    },
    {
      "label": "bread basket cost · 2026-10",
      "value": 1.861,
      "unit": "USD"
    },
    {
      "label": "Basket total · 1995-07",
      "value": 4.145,
      "unit": "USD"
    },
    {
      "label": "Basket total · 2026-10",
      "value": 8.282,
      "unit": "USD"
    },
    {
      "label": "Nominal change",
      "value": 99.80699638118217,
      "unit": "%"
    },
    {
      "label": "Starting basket in 2026-10 CPI dollars",
      "value": 9.173659639344262,
      "unit": "USD"
    },
    {
      "label": "Change beyond general inflation",
      "value": -9.719781138599103,
      "unit": "%"
    }
  ],
  "observations": [
    {
      "seriesId": "bread",
      "period": "1995-07",
      "periodStart": "1995-07-01",
      "periodEnd": "1995-07-31",
      "value": 0.789,
      "sourcePrecision": "0.789",
      "classification": "published source estimate",
      "publicationDate": null,
      "publicationDateNote": "Exact original publication date not supplied by extracted row; retrieval is not publication.",
      "retrievedAt": "2026-11-15T20:34:42.969Z",
      "vintage": "29ec2f439274227e",
      "locator": "#table4; APU0000702111; 1995/Jul",
      "snapshotHash": "29ec2f439274227e147af0b55127e79fa401af12921c2b08b2efa0c69fa15150",
      "flags": [],
      "uncertainty": null
    },
    {
      "seriesId": "bread",
      "period": "2026-10",
      "periodStart": "2026-10-01",
      "periodEnd": "2026-10-31",
      "value": 1.861,
      "sourcePrecision": "1.861",
      "classification": "published source estimate",
      "publicationDate": null,
      "publicationDateNote": "Exact original publication date not supplied by extracted row; retrieval is not publication.",
      "retrievedAt": "2026-11-15T20:34:42.969Z",
      "vintage": "29ec2f439274227e",
      "locator": "#table4; APU0000702111; 2026/Oct",
      "snapshotHash": "29ec2f439274227e147af0b55127e79fa401af12921c2b08b2efa0c69fa15150",
      "flags": [],
      "uncertainty": null
    },
    {
      "seriesId": "cpi-monthly",
      "period": "1995-07",
      "periodStart": "1995-07-01",
      "periodEnd": "1995-07-31",
      "value": 152.5,
      "sourcePrecision": "152.5",
      "classification": "published source estimate",
      "publicationDate": null,
      "publicationDateNote": "Exact original publication date not supplied by extracted row; retrieval is not publication.",
      "retrievedAt": "2026-11-15T20:34:42.969Z",
      "vintage": "29ec2f439274227e",
      "locator": "#table0; CUUR0000SA0; 1995/Jul",
      "snapshotHash": "29ec2f439274227e147af0b55127e79fa401af12921c2b08b2efa0c69fa15150",
      "flags": [],
      "uncertainty": null
    },
    {
      "seriesId": "cpi-monthly",
      "period": "2026-10",
      "periodStart": "2026-10-01",
      "periodEnd": "2026-10-31",
      "value": 337.511,
      "sourcePrecision": "337.511",
      "classification": "published source estimate",
      "publicationDate": null,
      "publicationDateNote": "Exact original publication date not supplied by extracted row; retrieval is not publication.",
      "retrievedAt": "2026-11-15T20:34:42.969Z",
      "vintage": "29ec2f439274227e",
      "locator": "#table0; CUUR0000SA0; 2026/Oct",
      "snapshotHash": "29ec2f439274227e147af0b55127e79fa401af12921c2b08b2efa0c69fa15150",
      "flags": [],
      "uncertainty": null
    },
    {
      "seriesId": "eggs",
      "period": "1995-07",
      "periodStart": "1995-07-01",
      "periodEnd": "1995-07-31",
      "value": 0.879,
      "sourcePrecision": "0.879",
      "classification": "published source estimate",
      "publicationDate": null,
      "publicationDateNote": "Exact original publication date not supplied by extracted row; retrieval is not publication.",
      "retrievedAt": "2026-11-15T20:34:42.969Z",
      "vintage": "29ec2f439274227e",
      "locator": "#table3; APU0000708111; 1995/Jul",
      "snapshotHash": "29ec2f439274227e147af0b55127e79fa401af12921c2b08b2efa0c69fa15150",
      "flags": [],
      "uncertainty": null
    },
    {
      "seriesId": "eggs",
      "period": "2026-10",
      "periodStart": "2026-10-01",
      "periodEnd": "2026-10-31",
      "value": 2.32,
      "sourcePrecision": "2.320",
      "classification": "published source estimate",
      "publicationDate": null,
      "publicationDateNote": "Exact original publication date not supplied by extracted row; retrieval is not publication.",
      "retrievedAt": "2026-11-15T20:34:42.969Z",
      "vintage": "29ec2f439274227e",
      "locator": "#table3; APU0000708111; 2026/Oct",
      "snapshotHash": "29ec2f439274227e147af0b55127e79fa401af12921c2b08b2efa0c69fa15150",
      "flags": [],
      "uncertainty": null
    },
    {
      "seriesId": "milk",
      "period": "1995-07",
      "periodStart": "1995-07-01",
      "periodEnd": "1995-07-31",
      "value": 2.477,
      "sourcePrecision": "2.477",
      "classification": "published source estimate",
      "publicationDate": null,
      "publicationDateNote": "Exact original publication date not supplied by extracted row; retrieval is not publication.",
      "retrievedAt": "2026-11-15T20:34:42.969Z",
      "vintage": "29ec2f439274227e",
      "locator": "#table2; APU0000709112; 1995/Jul",
      "snapshotHash": "29ec2f439274227e147af0b55127e79fa401af12921c2b08b2efa0c69fa15150",
      "flags": [],
      "uncertainty": null
    },
    {
      "seriesId": "milk",
      "period": "2026-10",
      "periodStart": "2026-10-01",
      "periodEnd": "2026-10-31",
      "value": 4.101,
      "sourcePrecision": "4.101",
      "classification": "published source estimate",
      "publicationDate": null,
      "publicationDateNote": "Exact original publication date not supplied by extracted row; retrieval is not publication.",
      "retrievedAt": "2026-11-15T20:34:42.969Z",
      "vintage": "29ec2f439274227e",
      "locator": "#table2; APU0000709112; 2026/Oct",
      "snapshotHash": "29ec2f439274227e147af0b55127e79fa401af12921c2b08b2efa0c69fa15150",
      "flags": [],
      "uncertainty": null
    }
  ],
  "sources": [
    {
      "id": "bls",
      "publisher": "U.S. Bureau of Labor Statistics",
      "distributor": null,
      "url": "https://data.bls.gov/pdq/SurveyOutputServlet",
      "dataset": "CPI-U and Average Price Data; BLS public API v2",
      "license": "BLS numerical publications are public domain and may be reused without specific permission with BLS attribution, per https://www.bls.gov/bls/linksite.htm (Copyright). Previously copyrighted photographs/illustrations and the BLS emblem are not included in this clearance. Methodology reviewed at https://www.bls.gov/cpi/factsheets/average-prices.htm, https://www.bls.gov/cpi/factsheets/acm-gasoline.htm and https://www.bls.gov/cpi/factsheets/household-energy.htm; owner release approval remains separate.",
      "licenseStatus": "verified",
      "expectedCadenceDays": 45,
      "limitations": [
        "Official BLS Series Report metadata and 730 values independently matched to the BLS API snapshot; full-history import preserves all overlapping observations.",
        "Published average prices are levels, not constant-quality indexes; changing samples, products and collection methods can affect comparisons.",
        "Food prices exclude sales tax; gasoline and electricity prices include applicable taxes. Missing publisher values remain missing.",
        "Gasoline changed to secondary-source data with June 2021 observations. Household-energy prices depend on consumption, rate schedules, seasonal tariffs and charges/credits.",
        "Included food series begin in January 1980 or later and do not splice the pre-1978 average-food-price methodology into current history."
      ]
    }
  ],
  "caveats": [
    "Fixed illustrative quantities, not a balanced diet, official CPI basket or quality-controlled price index.",
    "Milk is per gallon, eggs per dozen, white bread per pound; food prices exclude sales tax and delivery.",
    "Missing item prices suppress the complete basket; remove an item explicitly to compare a smaller basket.",
    "Missing CPI suppresses only the inflation adjustment. No interpolation or item substitution.",
    "Private inputs stay in browser memory. This is an educational calculation, not financial advice."
  ],
  "methodVersion": "affordability-1.0.0",
  "generationConvention": "Deterministic worked-example timestamp pinned to source release creation; not build or publication time.",
  "supplementalDatasets": []
}
