{
  "schemaVersion": 1,
  "version": "2026-10-24.1",
  "status": "scientific contract; browser implementation and dataset validation required",
  "massConversions": {
    "gToMg": 1000,
    "mgToUg": 1000
  },
  "rules": [
    "Require all positive-weight ingredients to have the compatible field before reporting an exact reference percentage.",
    "Choose a source form once; do not sum alternate representations.",
    "Apply reference population, type and source-scope restrictions separately.",
    "An absent field remains unknown; preserve known subtotals."
  ],
  "sources": [
    "https://fdc.nal.usda.gov/data-documentation/",
    "https://ods.od.nih.gov/factsheets/VitaminK-HealthProfessional/",
    "https://www.canada.ca/en/health-canada/services/food-nutrition/healthy-eating/dietary-reference-intakes/tables/reference-values-vitamins.html"
  ],
  "crosswalks": [
    {
      "referenceNutrient": "added-sugars",
      "referenceUnits": [
        "g"
      ],
      "status": "withheld",
      "reason": "Total sugar is not added sugar; ingredient-role classification requires a separate reviewed rule."
    },
    {
      "referenceNutrient": "alpha-linolenic-acid-n3",
      "referenceUnits": [
        "g"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1404",
      "note": "Specific ALA only, not undifferentiated 18:3 or total polyunsaturated fat."
    },
    {
      "referenceNutrient": "available-carbohydrate",
      "referenceUnits": [
        "g"
      ],
      "status": "withheld",
      "reason": "Total by-difference carbohydrate is not digestible carbohydrate."
    },
    {
      "referenceNutrient": "biotin",
      "referenceUnits": [
        "ug"
      ],
      "status": "withheld",
      "reason": "No reviewed compatible canonical nutrient field in the initial catalog; missing is not zero."
    },
    {
      "referenceNutrient": "calcium",
      "referenceUnits": [
        "mg"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1087",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "carbohydrate",
      "referenceUnits": [
        "g"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1005",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "chloride",
      "referenceUnits": [
        "mg"
      ],
      "status": "withheld",
      "reason": "No reviewed compatible canonical nutrient field in the initial catalog; missing is not zero."
    },
    {
      "referenceNutrient": "cholesterol",
      "referenceUnits": [
        "mg"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1253",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "choline",
      "referenceUnits": [
        "mg"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1180",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "chromium",
      "referenceUnits": [
        "ug"
      ],
      "status": "withheld",
      "reason": "No reviewed compatible canonical nutrient field in the initial catalog; missing is not zero."
    },
    {
      "referenceNutrient": "copper",
      "referenceUnits": [
        "mg",
        "ug"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1098",
      "note": "USDA mg must convert to the selected reference unit: 1 mg = 1000 ug."
    },
    {
      "referenceNutrient": "fat",
      "referenceUnits": [
        "g"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1004",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "fiber",
      "referenceUnits": [
        "g"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1079",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "fluoride",
      "referenceUnits": [
        "mg"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1099",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "folate-dfe",
      "referenceUnits": [
        "ug"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1190",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "folic-acid",
      "referenceUnits": [
        "ug"
      ],
      "status": "withheld",
      "reason": "Need a verified synthetic-source scope; total DFE cannot be substituted."
    },
    {
      "referenceNutrient": "iodine",
      "referenceUnits": [
        "ug"
      ],
      "status": "withheld",
      "reason": "No reviewed compatible canonical nutrient field in the initial catalog; missing is not zero."
    },
    {
      "referenceNutrient": "iron",
      "referenceUnits": [
        "mg"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1089",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "linoleic-acid-n6",
      "referenceUnits": [
        "g"
      ],
      "status": "withheld",
      "reason": "Undifferentiated 18:2 is not automatically the specified n-6 form."
    },
    {
      "referenceNutrient": "magnesium",
      "referenceUnits": [
        "mg"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1090",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "manganese",
      "referenceUnits": [
        "mg"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1101",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "molybdenum",
      "referenceUnits": [
        "ug"
      ],
      "status": "withheld",
      "reason": "No reviewed compatible canonical nutrient field in the initial catalog; missing is not zero."
    },
    {
      "referenceNutrient": "niacin-equivalents",
      "referenceUnits": [
        "mg"
      ],
      "status": "withheld",
      "reason": "Preformed niacin is not NE. Preserve source NE separately; derive only after an explicitly reviewed niacin/tryptophan calculation."
    },
    {
      "referenceNutrient": "pantothenic-acid",
      "referenceUnits": [
        "mg"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1170",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "phosphorus",
      "referenceUnits": [
        "mg"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1091",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "potassium",
      "referenceUnits": [
        "mg"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1092",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "protein",
      "referenceUnits": [
        "g",
        "g/kg"
      ],
      "status": "withheld",
      "reason": "Use authority-labelled quantity goals; do not calculate a regulated protein %DV from grams alone."
    },
    {
      "referenceNutrient": "retinol",
      "referenceUnits": [
        "ug"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1105",
      "note": "UL is preformed vitamin A only; never substitute total RAE."
    },
    {
      "referenceNutrient": "riboflavin",
      "referenceUnits": [
        "mg"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1166",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "saturated-fat",
      "referenceUnits": [
        "g"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1258",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "selenium",
      "referenceUnits": [
        "ug"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1103",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "sodium",
      "referenceUnits": [
        "mg"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1093",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "supplemental-magnesium",
      "referenceUnits": [
        "mg"
      ],
      "status": "withheld",
      "reason": "Ordinary-food magnesium is outside this pharmacological-agent UL."
    },
    {
      "referenceNutrient": "synthetic-niacin",
      "referenceUnits": [
        "mg"
      ],
      "status": "withheld",
      "reason": "Preformed food niacin does not distinguish synthetic supplemental/fortified sources."
    },
    {
      "referenceNutrient": "synthetic-vitamin-e",
      "referenceUnits": [
        "mg"
      ],
      "status": "withheld",
      "reason": "Ordinary-food alpha-tocopherol does not distinguish the synthetic source scope."
    },
    {
      "referenceNutrient": "thiamin",
      "referenceUnits": [
        "mg"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1165",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "total-water",
      "referenceUnits": [
        "L"
      ],
      "status": "withheld",
      "reason": "Food moisture alone does not cover all water intake; no automatic full-day water adequacy percentage."
    },
    {
      "referenceNutrient": "vitamin-a-rae",
      "referenceUnits": [
        "ug"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1106",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "vitamin-b12",
      "referenceUnits": [
        "ug"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1178",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "vitamin-b6",
      "referenceUnits": [
        "mg"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1175",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "vitamin-c",
      "referenceUnits": [
        "mg"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1162",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "vitamin-d",
      "referenceUnits": [
        "ug"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1114",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    },
    {
      "referenceNutrient": "vitamin-e-alpha-tocopherol",
      "referenceUnits": [
        "mg"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1109",
      "note": "Natural-food alpha-tocopherol; fortification and synthetic stereoisomers need separate review."
    },
    {
      "referenceNutrient": "vitamin-k",
      "referenceUnits": [
        "ug"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1185",
      "note": "Comparison uses reported phylloquinone (K1), as in NIH food reference tables; explicitly label this form. Do not imply complete menaquinone coverage or silently add other forms."
    },
    {
      "referenceNutrient": "zinc",
      "referenceUnits": [
        "mg"
      ],
      "status": "approved-with-coverage-check",
      "nutrientId": "1095",
      "note": "Match exact nutrient identity and unit; incomplete intake withholds an exact percentage."
    }
  ]
}