{
  "schema_version": 3,
  "as_of": "2026-09-07T17:06:31.356950+00:00",
  "description": "Dated product-lookup coverage. Unknown units expose product metadata and resolution_required; they do not supply nutrition amounts.",
  "servable_record_counts": {
    "barcode": 3360885,
    "drink": 18,
    "food": 13133,
    "recipe": 57
  },
  "servable_criteria": {
    "minimum_validity": 60,
    "minimum_confidence": 50,
    "keyed_records_only": true,
    "quarantined_records_excluded": true,
    "barcode_unknown_units_return_metadata_only": true
  },
  "sources": [
    {
      "provider": "openfoodfacts",
      "servable": 2956082,
      "source_type": "barcode"
    },
    {
      "provider": "usda_fdc",
      "servable": 404803,
      "source_type": "barcode"
    },
    {
      "provider": "apileague",
      "servable": 18,
      "source_type": "drink"
    },
    {
      "provider": "usda_fdc",
      "servable": 13133,
      "source_type": "food"
    },
    {
      "provider": "apileague",
      "servable": 12,
      "source_type": "recipe"
    },
    {
      "provider": "nih_nhlbi",
      "servable": 44,
      "source_type": "recipe"
    },
    {
      "provider": "reference-provider",
      "servable": 1,
      "source_type": "recipe"
    }
  ],
  "imports": [
    {
      "dataset": "foundation",
      "source_url": "https://fdc.nal.usda.gov/fdc-datasets/FoodData_Central_foundation_food_json_2026-04-30.zip",
      "source_revision": "FoodData_Central_foundation_food_json_2026-04-30",
      "license": "CC0-1.0",
      "attribution": "USDA Agricultural Research Service, FoodData Central",
      "source_records": 395,
      "prepared_records_processed": 363,
      "accepted_records_processed": 311,
      "excluded_records_processed": 52,
      "production_import_status": "complete"
    },
    {
      "dataset": "legacy",
      "source_url": "https://fdc.nal.usda.gov/fdc-datasets/FoodData_Central_sr_legacy_food_json_2018-04.zip",
      "source_revision": "FoodData_Central_sr_legacy_food_json_2018-04",
      "license": "CC0-1.0",
      "attribution": "USDA Agricultural Research Service, FoodData Central",
      "source_records": 7793,
      "prepared_records_processed": 7793,
      "accepted_records_processed": 7683,
      "excluded_records_processed": 110,
      "production_import_status": "complete"
    },
    {
      "dataset": "survey-csv",
      "source_url": "https://fdc.nal.usda.gov/fdc-datasets/FoodData_Central_survey_food_csv_2024-10-31.zip",
      "source_revision": "FoodData_Central_survey_food_csv_2024-10-31",
      "license": "CC0-1.0",
      "attribution": "USDA Agricultural Research Service, FoodData Central",
      "source_records": 5432,
      "prepared_records_processed": 5432,
      "accepted_records_processed": 5326,
      "excluded_records_processed": 106,
      "production_import_status": "complete"
    },
    {
      "dataset": "branded",
      "source_url": "https://fdc.nal.usda.gov/fdc-datasets/FoodData_Central_branded_food_json_2026-04-30.zip",
      "source_revision": "FoodData_Central_branded_food_json_2026-04-30",
      "license": "CC0-1.0",
      "attribution": "USDA Agricultural Research Service, FoodData Central",
      "source_records": 455458,
      "prepared_records_processed": 455458,
      "accepted_records_processed": 404807,
      "excluded_records_processed": 50651,
      "production_import_status": "complete"
    },
    {
      "dataset": "recipes-v2",
      "source_url": "https://www.nhlbi.nih.gov/health/heart-healthy-living/healthy-foods/healthy-eating-recipes",
      "source_revision": "2026-09-06",
      "license": "US-Government-Public-Domain",
      "attribution": "Source: National Heart, Lung, and Blood Institute; National Institutes of Health; U.S. Department of Health and Human Services.",
      "source_records": 54,
      "prepared_records_processed": 54,
      "accepted_records_processed": 44,
      "excluded_records_processed": 10,
      "production_import_status": "complete"
    },
    {
      "dataset": "off-ready",
      "source_url": "https://huggingface.co/datasets/openfoodfacts/product-database/resolve/866fa58ccb5a369cc6043307954c5707b4c2a562/food.parquet",
      "source_revision": "866fa58ccb5a369cc6043307954c5707b4c2a562",
      "license": "ODbL-1.0",
      "attribution": "Open Food Facts contributors \u2014 https://world.openfoodfacts.org",
      "source_records": 4720100,
      "prepared_records_processed": 4720100,
      "accepted_records_processed": 2979232,
      "excluded_records_processed": 1740868,
      "production_import_status": "complete",
      "full_snapshot_validation_accepted": 2979232,
      "full_source_downloaded": true
    }
  ],
  "nutrition_basis": {
    "bulk_foods_and_barcodes": "Generic foods use 100g. Barcode reads resolve source evidence as 100g, 100ml, per_serving or unknown; legacy flags alone are never mass evidence.",
    "imported_recipes": "per serving; recipe yield stored separately",
    "exact_label_enrichment_and_recipe_calculation": "Source-compatible gram, milliliter and serving inputs. Cross-dimension conversion requires reviewed density or paired serving measurements."
  },
  "quality_gate": "Required source calories and macros, barcode check digits, and nutrition consistency validation. No missing source nutrition is guessed.",
  "limitations": [
    "Record counts are not unique physical-product counts; equivalent GTIN representations can refer to the same product.",
    "Source validation acceptance includes conflicts with existing records. Existing curated records are preserved, so acceptance is not a count of new inserts.",
    "This catalogue does not contain every food, barcode, or recipe worldwide.",
    "Consistency scores and dataset size do not establish measured photo-recognition accuracy or imply model training.",
    "Open Food Facts-derived data retains its ODbL obligations and attribution.",
    "All rows of the pinned Open Food Facts snapshot were processed; invalid, incomplete, contradictory and conservatively excluded zero-energy records are not served.",
    "The separately evaluated owned photo research model failed its production gate and is not used for new-photo recognition.",
    "614 of 13,133 generic foods and many packaged products have fewer than 25 source-reported nutrient keys. Unsupported values remain unknown; separate estimates are not measurements.",
    "1,720,250 barcode records lack a supported source unit and return metadata plus evidence requirements. Their stored nutrient observations remain preserved and unavailable for arithmetic until resolved."
  ],
  "nutrient_coverage": {
    "as_of": "2026-09-06T16:08:49.095827+00:00",
    "generic_foods": 13133,
    "at_least_25_reported": 12519,
    "below_25_reported": 614,
    "source_reported_fields": 586295,
    "source_reported_values_imputed": false,
    "foods_with_separate_estimates": 66,
    "separate_estimated_fields": 1951,
    "estimate_policy": "Compatible reference values remain separate estimates of the target food; they do not overwrite source facts or supply authoritative macros."
  },
  "retrieval": {
    "generic_foods_embedded": 13133,
    "modes": [
      "hybrid",
      "semantic",
      "lexical"
    ],
    "default": "hybrid",
    "owned_photo_model_promoted": false
  },
  "nutrient_enrichment": {
    "as_of": "2026-09-06T16:08:49.095827+00:00",
    "status": "complete",
    "generic_food_source_fields_added": 46525,
    "total_added_source_fields_lower_bound": 7003554,
    "packaged_label_passes": [
      {
        "dataset": "branded",
        "source_sha256": "6aa4bbed269fa9bbb14204d911164ee46811ecb338425e01f02e75b24db93fc9",
        "source_rows_processed": 455458,
        "complete": true,
        "eligible_record_visits": 404720,
        "unique_enriched_records": 404720,
        "added_source_fields_lower_bound": 1785930,
        "skipped_record_visits": 463,
        "conflicts": 0
      },
      {
        "dataset": "off",
        "source_sha256": "60bd9286924bb772a09e4b51b99f5f16d24ec73d5c249eebf36a3a77024267e0",
        "source_rows_processed": 1344177,
        "complete": true,
        "eligible_record_visits": 1099505,
        "unique_enriched_records": 1099505,
        "added_source_fields_lower_bound": 5171099,
        "skipped_record_visits": 56861,
        "conflicts": 0
      }
    ],
    "counting_note": "Database counts are unique stored reference records, not unique physical products. Import visits can repeat identities. Safe replay after interrupted or uncertain writes can undercount additions.",
    "source_fidelity_checks": [
      {
        "mode": "branded",
        "source_sha256": "6aa4bbed269fa9bbb14204d911164ee46811ecb338425e01f02e75b24db93fc9",
        "records_checked": 179,
        "nutrient_values_checked": 1313,
        "reported_zeros_checked": 400,
        "mismatches": 0,
        "scope": "Independent mapping arithmetic compared with the owned source archive, not laboratory accuracy."
      },
      {
        "mode": "off",
        "source_sha256": "60bd9286924bb772a09e4b51b99f5f16d24ec73d5c249eebf36a3a77024267e0",
        "records_checked": 166,
        "nutrient_values_checked": 719,
        "reported_zeros_checked": 146,
        "mismatches": 0,
        "scope": "Independent mapping arithmetic compared with the owned source archive, not laboratory accuracy."
      }
    ]
  },
  "recipe_calculation": {
    "endpoint": "POST /v1/recipes/calculate",
    "retention_profiles": 270,
    "published_retention_factors": 6994,
    "retention_release": "USDA Release 6 (2007)",
    "basis": "Ingredient edible weights, compatible source nutrients, selected USDA cooking factors and measured finished yield.",
    "missing_values": "Missing ingredient values or cooking factors remain unresolved. Calculated values are labeled estimates."
  },
  "barcode_nutrition_basis": {
    "resolver": "reference-basis-v1",
    "records_by_basis": {
      "100g": 1486664,
      "100ml": 153971,
      "per_serving": 0,
      "unknown": 1720250
    },
    "by_source": [
      {
        "provider": "openfoodfacts",
        "basis": "100g",
        "records": 1128936
      },
      {
        "provider": "openfoodfacts",
        "basis": "100ml",
        "records": 108624
      },
      {
        "provider": "openfoodfacts",
        "basis": "unknown",
        "records": 1718522
      },
      {
        "provider": "usda_fdc",
        "basis": "100g",
        "records": 357728
      },
      {
        "provider": "usda_fdc",
        "basis": "100ml",
        "records": 45347
      },
      {
        "provider": "usda_fdc",
        "basis": "unknown",
        "records": 1728
      }
    ],
    "resolved_nutrition_records": 1640635,
    "unknown_unit_records": 1720250,
    "original_observations_preserved": true,
    "source_report_note": "Source-unit interpretation, not laboratory measurement. USDA SI and GS1 unit aliases normalized. Unknown values are not zero."
  },
  "reference_unit_upgrade": {
    "as_of": "2026-09-06T17:09:16.431861+00:00",
    "full_volume_source_records_processed": 149221,
    "volume_products_enriched": 104334,
    "added_nutrient_fields_lower_bound": 543606,
    "immutable_source_sha256": "5b5673d43cba8b035547e505c628fb91d1f7963f4fa5cf9c704a4992b9e0518a",
    "source_fidelity": {
      "records": 150,
      "values": 723,
      "zeros": 164,
      "mismatches": 0
    },
    "native_api_verified": true,
    "unknown_nutrients_imputed": false,
    "reviewed_evidence_service_only": true
  },
  "counting_window": {
    "started_at": "2026-09-07T16:46:30.114964+00:00",
    "completed_at": "2026-09-07T17:06:31.356950+00:00",
    "method": "Serial indexed key ranges, 25000 rows per page; no wide materialized payloads. This is a counting window, not a single MVCC snapshot.",
    "stable_barcode_record_count": true,
    "non_barcode_as_of": "2026-09-07 16:38:18.151825+00"
  },
  "source_input_set_recovery": {
    "as_of": "2026-09-07T17:06:31.356950+00:00",
    "status": "complete",
    "source_archive_sha256": "1ae9e95377ef8a926d1902f6fe0f6bf1ff8dd4946c904050c76868d41b628392",
    "projection_sha256": "81a5256914993ec06ae980adc8588d3d447edbc1ef809104ebbcb36fc42093f5",
    "source_rows_processed": 2533571,
    "source_candidates": 2130047,
    "excluded_source_rows": {
      "source_quality": 190527,
      "no_unambiguous_reported_macro_set": 186134,
      "implausible_reported_macros": 26863
    },
    "updated_record_visits": 611725,
    "newly_resolved_record_visits": 7943,
    "added_source_fields_lower_bound": 9739,
    "unique_verified_records": 613799,
    "unique_recovered_unknown_units": 8036,
    "counting_note": "Database totals count unique eligible stored records. Import counters count record visits and can undercount additions after uncertain-write replay; neither is a count of new physical products.",
    "unit_verification": "Requires existing explicit serving evidence corroborating the source input set; migrated per-unit defaults alone do not establish units.",
    "unknown_nutrients_imputed": false,
    "source_fidelity": {
      "records_checked": 253,
      "nutrient_values_checked": 1826,
      "reported_zeros_checked": 617,
      "mismatches": 0,
      "scope": "Independent source-unit arithmetic, not a laboratory accuracy benchmark."
    }
  },
  "recipe_catalogue": {
    "as_of": "2026-09-10T04:10:39.550267+00:00",
    "eligible_records": 111,
    "complete_usable_recipes": 98,
    "recovered_cookbook_records": 4,
    "cookbook_extraction_quarantines_remaining": 0,
    "scope": "Owned complete recipe content with explicit per-serving nutrition. Other coverage sections retain their own observation dates.",
    "verification": "74 source/database/public API checks; previous 50 cookbook recipes unchanged."
  }
}