Safety matrix

Key safety gates the engine checks

This page is generated from the rules that score your plan. For each curated safety gate — drug classes, conditions, allergies, life stage — it lists which supplements are excluded outright and which are routed to clinician review. The global guards at the top apply to every supplement.

The matrix is built from excludeIf and clinicianReviewIf clauses in the open-source engine. If the engine changes, this page changes with it.

Scope note.Not every rule in the engine is shown here. The engine has scoring gates that aren’t safety gates (e.g. a low ferritin lab boosts iron rather than blocking it), and a long tail of conditional clauses that would be more confusing than useful in a public matrix. The gates below are the ones most relevant to a clinician scanning “will any of this hurt someone like me.” For everything else, the source is the repo.

Global guards

These four apply to every supplement and override the per-supplement rules below.

Anyone under 18 is routed to clinician review for every supplement outside a small allow-list (vitamin D3, omega-3, multivitamin, iron, B12, calcium, psyllium, protein, probiotic). The allow-list lives in rules-engine.ts and is not editable per supplement.

Past age 80 the engine routes most non-essentials to clinician review. Polypharmacy norms, frailty, and narrower interaction tolerance push the bar higher. A small allow-list (the pediatric items plus creatine and magnesium) remains available.

If the red-flag screen returns any urgent symptom (chest pain, blood in stool/urine, suicidal thoughts, new neurological symptoms, breast lump, unintentional weight loss, severe persistent headache, persistent fever), the engine demotes everything in the plan and surfaces an urgent banner instead.

If the user reports daily aspirin or NSAID use, the engine synthesises a positive answer for the anticoagulant question downstream, so every supplement that excludes on `blood_thinner_use` also excludes on daily OTC bleeding-risk drugs. This is why the anticoagulant gate above is labelled to include OTC drugs.

Per-supplement gates

Each section is a single safety gate. Excluded means the engine will not include that supplement in any plan for someone matching the gate. Clinician review means the supplement is downgraded and flagged as needing a clinician’s sign-off before use.

Why this gate exists: Risk of additive bleeding. Daily aspirin or NSAID use is promoted into this gate inside the engine so the same exclusions apply.

Engine field: blood_thinner_use = yes | not_sure

SupplementActionEvidence
Aged Garlic ExtractExcludedTier C
BerberineClinician reviewTier B
BromelainExcludedTier C
CoQ10 (Ubiquinol)Clinician reviewTier B
Curcumin (Turmeric Extract)ExcludedTier B
Evening Primrose OilExcludedTier C
FenugreekExcludedTier C
Ginger ExtractExcludedTier B
Glucosamine SulfateExcludedTier C
Holy Basil (Tulsi)ExcludedTier D
Krill OilExcludedTier C
MelatoninClinician reviewTier B
Olive Leaf ExtractExcludedTier C
Omega-3 EPA/DHAExcludedTier B
Panax Ginseng (Korean / Asian)ExcludedTier C
Pycnogenol (French Maritime Pine Bark)ExcludedTier B
ReishiExcludedTier D
ResveratrolExcludedTier C
Vitamin EExcludedTier C
Vitamin K2 (MK-7)ExcludedTier B

Why this gate exists: A handful of supplements gate directly on the OTC question in addition to the engine-level anticoagulant promotion. Same bleeding-risk concern.

Engine field: daily_aspirin_or_nsaid = yes | not_sure

SupplementActionEvidence
BerberineClinician reviewTier B
FenugreekExcludedTier C
Krill OilExcludedTier C
Omega-3 EPA/DHAExcludedTier B

Why this gate exists: Some supplements are excluded outright at this pill load; many others are routed to clinician review because the interaction surface gets too wide for an algorithm to screen.

Engine field: medication_profile = polypharmacy

SupplementActionEvidence
5-HTPExcludedTier C
BerberineClinician reviewTier B
Curcumin (Turmeric Extract)Clinician reviewTier B
Gymnema SylvestreClinician reviewTier D
KavaClinician reviewTier D
L-TryptophanExcludedTier C
L-TyrosineClinician reviewTier C
Niacin (Vitamin B3)Clinician reviewTier B
Panax Ginseng (Korean / Asian)Clinician reviewTier C
Psyllium FiberClinician reviewTier B
Red Yeast RiceClinician reviewTier B
Saffron ExtractClinician reviewTier C
SAM-eClinician reviewTier C
Tongkat Ali (Eurycoma longifolia)Clinician reviewTier C
Vitex (Chasteberry)Clinician reviewTier C

Why this gate exists: For supplements where the engine can't rule out a pharmacokinetic clash without a full medication list, anyone on a prescription is routed to clinician review. The transparency page describes this as the unlisted_medications fallback.

Engine field: medication_profile = some_rx | polypharmacy

SupplementActionEvidence
5-HTPExcludedTier C
BerberineClinician reviewTier B
Curcumin (Turmeric Extract)Clinician reviewTier B
Gymnema SylvestreClinician reviewTier D
KavaClinician reviewTier D
L-TryptophanExcludedTier C
L-TyrosineClinician reviewTier C
Niacin (Vitamin B3)Clinician reviewTier B
Panax Ginseng (Korean / Asian)Clinician reviewTier C
Psyllium FiberClinician reviewTier B
Red Yeast RiceClinician reviewTier B
Saffron ExtractClinician reviewTier C
SAM-eClinician reviewTier C
Tongkat Ali (Eurycoma longifolia)Clinician reviewTier C
Vitex (Chasteberry)Clinician reviewTier C

Why this gate exists: Vitamin D supplementation is excluded when a recent lab puts the user in the high band — the boost gates flip into an exclusion to prevent stacking.

Engine field: lab_vitamin_d_status = high

SupplementActionEvidence
Vitamin D3ExcludedTier B

Why this gate exists: Iron is excluded when a recent lab puts the user in the high band — high ferritin (with or without inflammation context) takes iron off the table.

Engine field: lab_ferritin_status = high

SupplementActionEvidence
IronExcludedTier A

Why this gate exists: Risk of serotonin syndrome with serotonergic botanicals (5-HTP, SAM-e, St John's wort, saffron, rhodiola).

Engine field: ssri_or_serotonergic_use = yes | not_sure

SupplementActionEvidence
5-HTPExcludedTier C
L-TryptophanExcludedTier C
MelatoninClinician reviewTier B
Rhodiola RoseaClinician reviewTier D
Saffron ExtractExcludedTier C
SAM-eExcludedTier C
Vitex (Chasteberry)ExcludedTier C

Why this gate exists: Iodine, ashwagandha, soy isoflavones and a few others can alter thyroid function or interfere with levothyroxine.

Engine field: thyroid_disorder = yes | not_sure

SupplementActionEvidence
Acetyl-L-Carnitine (ALCAR)Clinician reviewTier C
Alpha-Lipoic AcidClinician reviewTier B
AshwagandhaExcludedTier D
IodineExcludedTier B
L-TyrosineExcludedTier C
MacaExcludedTier C

Why this gate exists: Many botanicals lack reproductive-safety data; high-dose fat-soluble vitamins are teratogenic. Clinician-led prenatal care takes precedence.

Engine field: pregnant_or_breastfeeding = yes | not_sure

SupplementActionEvidence
5-HTPExcludedTier C
AshwagandhaExcludedTier D
BerberineExcludedTier B
Black CohoshExcludedTier D
DIM (Diindolylmethane)ExcludedTier D
Eleuthero (Siberian Ginseng)ExcludedTier D
FenugreekExcludedTier C
Gymnema SylvestreExcludedTier D
Holy Basil (Tulsi)ExcludedTier D
KavaExcludedTier D
MelatoninExcludedTier B
Panax Ginseng (Korean / Asian)ExcludedTier C
PassionflowerExcludedTier D
Rhodiola RoseaExcludedTier D
Saffron ExtractExcludedTier C
Schisandra ChinensisExcludedTier D
Soy IsoflavonesExcludedTier C
SpirulinaExcludedTier C
Tongkat Ali (Eurycoma longifolia)ExcludedTier C
ValerianExcludedTier D
Vitamin A / Beta-CaroteneExcludedTier C
Vitex (Chasteberry)ExcludedTier C

Why this gate exists: Creatine, high-dose vitamin C, magnesium loading, and several botanicals are routed to clinician review when renal function is uncertain.

Engine field: kidney_history = yes | not_sure

SupplementActionEvidence
Creatine MonohydrateClinician reviewTier A
Electrolytes (Na/K/Mg)Clinician reviewTier B
IronClinician reviewTier A
MagnesiumClinician reviewTier B
Sodium BicarbonateExcludedTier B
Vitamin D3Clinician reviewTier B

Why this gate exists: Several botanicals (kava, green-tea extract, comfrey, some adaptogens) carry hepatotoxicity signals; high-dose niacin and fat-soluble vitamins are flagged.

Engine field: liver_history = yes | not_sure

SupplementActionEvidence
AshwagandhaExcludedTier D
Black CohoshExcludedTier D
Cinnamon (Ceylon)ExcludedTier C
Curcumin (Turmeric Extract)ExcludedTier B
IronClinician reviewTier A
KavaExcludedTier D
Niacin (Vitamin B3)ExcludedTier B
Red Yeast RiceExcludedTier B
ReishiExcludedTier D
ValerianExcludedTier D
Vitamin A / Beta-CaroteneExcludedTier C

Why this gate exists: High-dose vitamin C and calcium loading can increase oxalate burden.

Engine field: kidney_stones = yes

SupplementActionEvidence
CalciumClinician reviewTier B
Vitamin CClinician reviewTier B

Why this gate exists: Red yeast rice duplicates statin mechanism; some botanicals affect CYP3A4 statin metabolism.

Engine field: statin_use = yes

SupplementActionEvidence
Red Yeast RiceExcludedTier B

Why this gate exists: Beta-carotene supplementation increases lung-cancer mortality in current and recently-quit smokers (CARET / ATBC). The engine derives this signal from the smoking question; it overrides the supplement.

Engine field: derived_smoking_risk = current | former_recent

SupplementActionEvidence
Vitamin A / Beta-CaroteneExcludedTier C

Why this gate exists: Fish-oil omega-3 products and glucosamine derived from shellfish are excluded.

Engine field: known_allergies = allergy_fish | allergy_shellfish

SupplementActionEvidence
Krill OilExcludedTier C
Omega-3 EPA/DHAExcludedTier B

Why this gate exists: Soy isoflavones, lecithin, and several encapsulation excipients can carry soy protein traces.

Engine field: known_allergies = allergy_soy

SupplementActionEvidence
Soy IsoflavonesExcludedTier C

What this matrix doesn’t cover

Full medication-by-medication interaction screening is a clinician’s job, not an algorithm’s. The matrix above covers the drug classes and conditions the engine asks about — not every prescription a person might be on. Whenever you report any prescription medication, the engine sets an unlisted_medications risk flag so the printable plan and the clinician export both prompt for a pharmacist or clinician review of the full list.

Transparency page · Methodology