{ "model": { "rank": 2710, "code": "thing-q60235", "model_id": "vr.tr.caffeine", "name": "caffeine", "purpose": "Enable an AI agent to recognise caffeine, assess the identity and condition of a particular quantity, and determine which handling, formulation or transfer actions are supported by evidence.", "family": "Thing Registry", "category": "Physical world and living systems", "status": "research-draft", "kind": "thing", "plane": "PHY", "domain": "PHY.MAT", "industry": "", "version": "", "url": "/models/thing/q60235/", "tier": 2, "score": 98, "payload": { "layer": "wikidata", "aliases": [ "Buckfast Tonic Wine", "Caffeine-13C3 solution", "1,7-Dimethyl-3-(¹³C)methyl-3,7-dihydro-1H-purine-2,6-dione", "(14-C)Caffeine" ], "aliasCount": 4, "merged": 4, "knownIn": 98, "facets": null, "markers": [], "lexicalClass": "", "senseRank": null, "alsoRegisteredAs": "vr.tr.caffeine", "source": { "dataset": "wikidata", "item": "Q60235", "url": "https://www.wikidata.org/wiki/Q60235", "license": "CC0 1.0" } }, "research": { "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-07T11:16:59Z", "providers": [ "Codex", "Grok" ], "missingProviders": [], "pass": 2, "cost": { "grok": { "usd": 0.00982022, "turns": 1, "seconds": 158.5, "error": null }, "codex": { "seconds": 79.4, "error": "Reading additional input from stdin...\nOpenAI Codex v0.153.3\n--------\nworkdir: R:\\02_PROJECTS\\02_Meta_Models_Platforms\\Ver.cy\\current\\thing-registry-backlog\nmodel: gpt-6-astra\nprovider: openai\napproval: never\nsandbox: read-only\nreasoning effort: none\nreasoning summaries: none\nsession id: 01a07b91-4a2f-7e40-a043-4a78144b5ecc\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: caffeine\nRegistry id: vr.tr.caffeine\nPlane / domain: PHY / PHY.MAT\nRegistry definition: (none recorded)\nNames folded into this entry: (none)\n\nA Vercy" } } }, "metaModel": { "id": "THING-Q60235", "registryId": "vr.tr.caffeine", "name": "caffeine", "version": "0.1.0-research.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "PHY.MAT" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/q60235/", "model": { "registry_id": "vr.tr.caffeine", "name": "caffeine", "purpose": "Enable an AI agent to recognise caffeine, assess the identity and condition of a particular quantity, and determine which handling, formulation or transfer actions are supported by evidence.", "definition": "Caffeine is the xanthine alkaloid 1,3,7-trimethylxanthine, a competitive antagonist at adenosine A1 and A2A receptors, that occurs in Coffea, Camellia, Theobroma, Paullinia, Ilex and related plants and is isolated or synthesised as an anhydrous crystalline solid for use as a food flavour, CNS stimulant, analgesic adjuvant and neonatal respiratory stimulant.", "scope_statement": "This model owns caffeine as a chemical substance and identifiable material constituent, including its molecular identity, physical form, quantity, purity, condition and constraints on use; it links to models of mixtures, products, exposures and people where caffeine participates.", "in_scope": [ "Chemical identity and evidence distinguishing caffeine from related methylxanthines", "Physical form and composition of an identified caffeine sample or lot", "Caffeine quantity, concentration and the basis of each measurement", "Source, processing history and evidence supporting grade or purity claims", "Condition and constraints governing storage, handling, formulation and transfer" ], "out_of_scope": [ "Complete composition and quality of coffee, tea, energy drinks and other caffeine-containing products", "Cultivation and biology of plants that produce caffeine", "Individual consumption histories, metabolism, symptoms and clinical treatment", "Manufacturing equipment and complete extraction or synthesis processes", "Commercial orders, inventory accounting and transport operations", "Legal rules themselves, which belong to jurisdictional models referenced for a particular use" ], "distinguishing_features": [ "Require identity evidence consistent with 1,3,7-trimethylxanthine; a methylxanthine-family label alone does not distinguish caffeine from theobromine or theophylline.", "Use molecular formula C8H10N4O2 as a consistency check, while requiring structural or analytical evidence because formula alone does not establish identity.", "Distinguish caffeine substance from a caffeine-containing extract or beverage by recording the surrounding matrix and measured caffeine fraction.", "Distinguish anhydrous caffeine, hydrated material and caffeine-containing preparations through declared composition and suitable analytical evidence; do not treat their gross masses as interchangeable caffeine masses." ], "characteristics": [ { "name": "Identity assignment", "kind": "category", "unit_or_values": "Declared caffeine identity, identifiers and supporting analytical evidence", "why_it_matters": "Prevents a label or nonspecific methylxanthine result from being treated as confirmed caffeine." }, { "name": "Material presentation", "kind": "category", "unit_or_values": "Isolated solid, solution, extract constituent or other specified mixture constituent", "why_it_matters": "Determines whether an action concerns caffeine itself or a host material." }, { "name": "Solid form and hydration", "kind": "state", "unit_or_values": "Reported solid form, hydration status, method and unknown status", "why_it_matters": "Supports interpretation of mass, assay and formulation behaviour." }, { "name": "Caffeine amount", "kind": "measurement", "unit_or_values": "mg, g or mol of caffeine with uncertainty and calculation basis", "why_it_matters": "Separates caffeine quantity from the total mass of its container or preparation." }, { "name": "Caffeine concentration", "kind": "measurement", "unit_or_values": "mg/mL, mg/g, mol/L or explicitly defined mass fraction", "why_it_matters": "Allows defensible dilution and transfer calculations without confusing concentration with total amount." }, { "name": "Assay and impurity profile", "kind": "measurement", "unit_or_values": "Caffeine assay on a stated basis; named impurities and their concentrations or reporting limits", "why_it_matters": "Determines whether the material meets the requirements of an intended use." }, { "name": "Origin and processing lineage", "kind": "relation", "unit_or_values": "Links to supplier, lot, extraction or synthesis route, and subsequent processing records", "why_it_matters": "Makes origin claims traceable without using origin as a substitute for chemical identity." }, { "name": "Observed material condition", "kind": "state", "unit_or_values": "Recorded observations of moisture, clumping, dissolution, precipitation or contamination, with observation time", "why_it_matters": "Identifies conditions that may require reassessment before weighing, sampling or formulation." }, { "name": "Use qualification", "kind": "relation", "unit_or_values": "Links to an intended use, applicable specification, test results and release decision", "why_it_matters": "Prevents suitability for one application from being assumed for another." } ], "affordances": [ "Request or compare identity testing that discriminates caffeine from related methylxanthines.", "Calculate caffeine quantities and dilutions from supported assay, concentration and measurement bases.", "Select sampling, weighing, dissolution or transfer actions consistent with the material's documented form and handling requirements.", "Compare a caffeine lot with the specification required for a proposed formulation or analytical use.", "Quarantine or route material for reassessment when identity, concentration, contamination or condition evidence is inadequate.", "Link caffeine quantities into product and exposure models while preserving their measurement basis." ] }, "sources": [ { "id": "pubchem-2519", "title": "PubChem Compound Summary for CID 2519, Caffeine - NCBI/NLM", "url": "https://pubchem.ncbi.nlm.nih.gov/compound/2519", "what_it_supports": "Identity (CAS, InChIKey, formula, melting point, solubility) and pharmacological classification as a methylxanthine adenosine-receptor antagonist.", "url_status": "live" }, { "id": "efsa-2015-4102", "title": "Scientific Opinion on the safety of caffeine - EFSA Panel on Dietetic Products, Nutrition and Allergies, EFSA Journal 2015;13(5):4102", "url": "https://doi.org/10.2903/j.efsa.2015.4102", "what_it_supports": "Adult, child and pregnancy intake levels considered without safety concern, and characterisation of acute and habitual exposure from foods and drinks.", "url_status": "blocked" }, { "id": "fda-21cfr-182-1180", "title": "21 CFR 182.1180 Caffeine - U.S. Food and Drug Administration (eCFR)", "url": "https://www.ecfr.gov/current/title-21/section-182.1180", "what_it_supports": "U.S. GRAS listing of caffeine in cola-type beverages at not more than 0.02 percent.", "url_status": "live" }, { "id": "eu-1169-2011", "title": "Regulation (EU) No 1169/2011 on the provision of food information to consumers, Annex III - European Union", "url": "https://eur-lex.europa.eu/eli/reg/2011/1169/oj", "what_it_supports": "Mandatory high-caffeine warning on beverages other than tea or coffee with caffeine above 150 mg/L.", "url_status": "live" }, { "id": "wikidata-q60235", "title": "Caffeine (Q60235) - Wikidata", "url": "https://www.wikidata.org/wiki/Q60235", "what_it_supports": "Crosswalk of CAS, UNII, ChEBI, ATC, PubChem and other public identifiers.", "url_status": "live" } ], "structure": { "bundles": [ { "id": "caffeine-identity-and-boundaries", "name": "Caffeine identity and boundaries", "description": "Establishes that the represented substance is caffeine and identifies the material boundary around it.", "rationale": "Caffeine is easily conflated with related methylxanthines, stimulant effects or the products that contain it.", "layers": [ { "id": "molecular-identification", "name": "Molecular identification", "description": "Records the chemical assignment and the evidence needed to discriminate caffeine.", "findings": [ { "id": "caffeine-identity-evidence", "name": "Caffeine identity evidence", "description": "Capture the declared identity, reference material and analytical evidence, preserving the distinction between declaration and confirmation.", "questions": [ { "text": "What evidence identifies this material as 1,3,7-trimethylxanthine rather than another methylxanthine?", "kind": "definition", "id": "caffeine-identity-evidence-q01" }, { "text": "Which method and reference support the identity assignment, and what interfering compounds can that method distinguish?", "kind": "measurement", "id": "caffeine-identity-evidence-q02" } ] } ] }, { "id": "substance-and-preparation-boundary", "name": "Substance and preparation boundary", "description": "Separates caffeine from its host matrix and from preparations whose names include caffeine.", "findings": [ { "id": "represented-caffeine-entity", "name": "Represented caffeine entity", "description": "Specify whether the record concerns isolated caffeine or the caffeine constituent of a larger material.", "questions": [ { "text": "Does this record represent isolated caffeine, caffeine in a solution, or caffeine within a botanical or formulated mixture?", "kind": "boundary", "id": "represented-caffeine-entity-q01" }, { "text": "If the preparation includes water or other components, which mass and composition belong to caffeine and which belong to the preparation model?", "kind": "boundary", "id": "represented-caffeine-entity-q02" } ] } ] } ] }, { "id": "caffeine-form-and-condition", "name": "Caffeine form and condition", "description": "Records the physical state relevant to measuring and using a caffeine material.", "rationale": "A solid powder, hydrated material and dissolved caffeine require different interpretations of mass and different preparation actions.", "layers": [ { "id": "solid-form-and-moisture", "name": "Solid form and moisture", "description": "Captures the declared and observed state of solid caffeine.", "findings": [ { "id": "solid-state-basis", "name": "Solid state basis", "description": "Record hydration, moisture and powder condition without inferring them from appearance alone.", "questions": [ { "text": "What evidence establishes the caffeine material's hydration or solid form, and what remains uncharacterised?", "kind": "measurement", "id": "solid-state-basis-q01" }, { "text": "What moisture measurement or observed clumping requires reassessment of sampling, weighing or the assay basis?", "kind": "action", "id": "solid-state-basis-q02" } ] } ] }, { "id": "dissolved-state", "name": "Dissolved state", "description": "Describes caffeine's state within a solvent or formulation under recorded conditions.", "findings": [ { "id": "dissolution-and-precipitation-status", "name": "Dissolution and precipitation status", "description": "Capture whether the assigned caffeine quantity is dissolved and whether that state supports representative transfer.", "questions": [ { "text": "For the recorded solvent composition, temperature and caffeine concentration, what evidence shows complete dissolution or remaining solids?", "kind": "measurement", "id": "dissolution-and-precipitation-status-q01" }, { "text": "Has storage or a formulation change produced precipitation that requires mixing, reassay or a revised transfer procedure?", "kind": "action", "id": "dissolution-and-precipitation-status-q02" } ] } ] } ] }, { "id": "caffeine-quantity-and-assay", "name": "Caffeine quantity and assay", "description": "Makes caffeine amounts interpretable across solids, solutions and mixtures.", "rationale": "Gross material mass, caffeine mass, dry-basis assay and solution concentration cannot safely substitute for one another.", "layers": [ { "id": "amount-and-concentration-basis", "name": "Amount and concentration basis", "description": "Records quantities with the denominators and corrections needed for calculations.", "findings": [ { "id": "interpretable-caffeine-quantity", "name": "Interpretable caffeine quantity", "description": "Attach units, sample boundary, assay basis and uncertainty to each caffeine quantity.", "questions": [ { "text": "Is the stated quantity gross material mass, caffeine mass or caffeine concentration, and what is its denominator?", "kind": "measurement", "id": "interpretable-caffeine-quantity-q01" }, { "text": "What assay, moisture or preparation-composition correction is required to calculate the caffeine amount available for transfer?", "kind": "action", "id": "interpretable-caffeine-quantity-q02" } ] } ] }, { "id": "analytical-selectivity-and-sampling", "name": "Analytical selectivity and sampling", "description": "Establishes what a caffeine measurement demonstrates about the sampled material.", "findings": [ { "id": "representative-caffeine-assay", "name": "Representative caffeine assay", "description": "Record method selectivity, calibration and sampling limits before treating a result as representative of a lot or mixture.", "questions": [ { "text": "How does the assay separate caffeine response from related methylxanthines and matrix interference?", "kind": "measurement", "id": "representative-caffeine-assay-q01" }, { "text": "Which sample, sampling procedure and calibration evidence support applying this caffeine result to the represented material?", "kind": "provenance", "id": "representative-caffeine-assay-q02" } ] } ] } ] }, { "id": "caffeine-origin-and-quality", "name": "Caffeine origin and quality", "description": "Connects source and processing claims to evidence about the actual caffeine material.", "rationale": "Extracted and synthesised caffeine may share chemical identity while having different documented histories and impurity profiles.", "layers": [ { "id": "origin-claim-traceability", "name": "Origin claim traceability", "description": "Preserves the evidence behind extraction, synthesis and source claims.", "findings": [ { "id": "documented-caffeine-lineage", "name": "Documented caffeine lineage", "description": "Link the caffeine lot to source and processing records without deriving purity or suitability from an origin label.", "questions": [ { "text": "Which records support a botanical extraction, synthesis or other origin claim for this caffeine lot?", "kind": "provenance", "id": "documented-caffeine-lineage-q01" }, { "text": "Which purification, blending or repackaging steps connect the supplied lot to the material currently represented?", "kind": "provenance", "id": "documented-caffeine-lineage-q02" } ] } ] }, { "id": "purity-and-use-specification", "name": "Purity and use specification", "description": "Tests grade and suitability claims against an identified specification.", "findings": [ { "id": "supported-caffeine-grade", "name": "Supported caffeine grade", "description": "Record caffeine assay and relevant impurity results against the requirements of a specific intended use.", "questions": [ { "text": "Which specification and version define the claimed caffeine grade, and which lot-specific results demonstrate conformity?", "kind": "provenance", "id": "supported-caffeine-grade-q01" }, { "text": "Which related methylxanthines, residual processing substances or matrix contaminants require limits for the proposed use, and which have actually been measured?", "kind": "measurement", "id": "supported-caffeine-grade-q02" } ] } ] } ] }, { "id": "caffeine-handling-and-use-decisions", "name": "Caffeine handling and use decisions", "description": "Connects caffeine identity, quantity and condition to justified material actions.", "rationale": "Actions involving concentrated caffeine depend on reliable quantity control, suitable handling information and application-specific acceptance evidence.", "layers": [ { "id": "material-handling-controls", "name": "Material handling controls", "description": "Identifies the handling and storage instructions applicable to the actual caffeine preparation.", "findings": [ { "id": "supported-handling-action", "name": "Supported handling action", "description": "Associate proposed weighing, transfer and storage actions with current material documentation and operational capability.", "questions": [ { "text": "Which safety and storage documentation applies to this caffeine material's form, concentration and supplier lot?", "kind": "provenance", "id": "supported-handling-action-q01" }, { "text": "Do the available weighing, containment and labelling procedures support the proposed caffeine quantity and transfer accuracy?", "kind": "action", "id": "supported-handling-action-q02" } ] } ] }, { "id": "qualification-and-downstream-handoff", "name": "Qualification and downstream handoff", "description": "Determines whether a proposed use is supported and passes caffeine quantities to neighbouring models.", "findings": [ { "id": "caffeine-use-decision", "name": "Caffeine use decision", "description": "Record release, restriction or reassessment decisions for a stated application while delegating product and person-specific judgments.", "questions": [ { "text": "For the proposed application and jurisdiction, what evidence supports releasing this caffeine material, and what missing result requires holding it?", "kind": "action", "id": "caffeine-use-decision-q01" }, { "text": "Which product or exposure model receives the caffeine amount, uncertainty and preparation basis for downstream assessment?", "kind": "boundary", "id": "caffeine-use-decision-q02" } ] } ] } ] }, { "id": "evidence-and-external-alignment", "name": "Evidence and external alignment", "description": "What the world already says about this thing, gathered so the model can be checked against it.", "rationale": "A model that cannot be lined up against existing standards, identifiers and practice cannot be adopted by anyone who already uses them.", "layers": [ { "id": "reported-evidence", "name": "Reported evidence", "description": "Findings from the breadth pass, kept separate from the structural claims.", "findings": [ { "id": "evidence-kinds", "name": "Kinds and varieties", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "Anhydrous caffeine (pharmaceutical and food-grade crystalline solid)", "Caffeine citrate (neonatal apnea-of-prematurity injection and oral solution)", "Caffeine monohydrate", "Coffee-derived caffeine (Coffea spp., including residual caffeine in decaffeinated coffee)", "Tea-derived caffeine (Camellia sinensis)", "Cacao-derived caffeine (Theobroma cacao, always accompanied by theobromine)", "Guarana- and mate-derived caffeine (Paullinia cupana, Ilex paraguariensis)", "Synthetic caffeine added to cola-type and energy drinks" ], "questions": [ { "id": "evidence-kinds-q01", "text": "Which of these kinds and varieties hold for the sense of caffeine this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-identifiers", "name": "Identifiers and schemes", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ { "scheme": "Wikidata", "value_or_pattern": "Q60235", "note": "Item for the chemical substance caffeine." }, { "scheme": "CAS Registry Number", "value_or_pattern": "58-08-2", "note": "Anhydrous caffeine; caffeine citrate is a different CAS." }, { "scheme": "PubChem CID", "value_or_pattern": "2519", "note": "Compound record for 1,3,7-trimethylxanthine." }, { "scheme": "UNII", "value_or_pattern": "3G6A5W338E", "note": "FDA Substance Registration System identifier." }, { "scheme": "ATC", "value_or_pattern": "N06BC01", "note": "WHO Anatomical Therapeutic Chemical code (xanthine derivatives)." }, { "scheme": "EC / EINECS", "value_or_pattern": "200-362-1", "note": "European Inventory of Existing Commercial Chemical Substances." }, { "scheme": "InChIKey", "value_or_pattern": "RYYVLZVUVIJVGH-UHFFFAOYSA-N", "note": "Standard InChIKey of the parent molecule." }, { "scheme": "ChEBI", "value_or_pattern": "CHEBI:27732", "note": "Chemical Entities of Biological Interest." }, { "scheme": "HS (Harmonized System)", "value_or_pattern": "2939.30", "note": "Heading for caffeine and its salts in trade statistics." } ], "questions": [ { "id": "evidence-identifiers-q01", "text": "Which of these identifiers and schemes hold for the sense of caffeine this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-standards-and-regulation", "name": "Standards and regulation", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "USP and Ph. Eur. monographs for caffeine (identity, assay, related substances) - United States Pharmacopeia; European Directorate for the Quality of Medicines.", "21 CFR 182.1180: caffeine GRAS in cola-type beverages at ≤0.02% - U.S. FDA.", "EFSA NDA Scientific Opinion on the safety of caffeine (2015): 400 mg/day in healthy adults, 200 mg/day in pregnant women, as levels of no safety concern - European Food Safety Authority.", "Regulation (EU) No 1169/2011 Annex III: high-caffeine labelling for drinks other than tea or coffee containing >150 mg/L - European Union.", "Australia New Zealand Food Standards Code Standard 2.6.4 (formulated caffeinated beverages), typical compositional window about 145-320 mg/L - Food Standards Australia New Zealand.", "Health Canada: caffeine as a food additive and mandatory labelling/limits for caffeinated energy drinks - Health Canada.", "WHO Model List of Essential Medicines: caffeine citrate for apnoea of prematurity - World Health Organization.", "Codex / national flavouring inventories (e.g. FEMA GRAS 2224 in the United States) for caffeine used as a flavour - Codex Alimentarius / FEMA." ], "questions": [ { "id": "evidence-standards-and-regulation-q01", "text": "Which of these standards and regulation hold for the sense of caffeine this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-real-world-use", "name": "Real-world use", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "Dietary stimulant in brewed coffee, tea, yerba mate, cola and energy drinks.", "Over-the-counter analgesic adjuvant combined with paracetamol, aspirin or ibuprofen for tension-type headache and migraine.", "First-line pharmacologic treatment of apnoea of prematurity as caffeine citrate (loading and maintenance dosing in neonatal units).", "Ergogenic aid in endurance sport, taken as coffee, tablets or gum before competition.", "Analytical reference standard and HPLC marker for coffee, tea and cocoa authenticity and decaffeination control.", "Industrial raw material: extracted from coffee/tea waste or synthesised, then added to soft drinks and dietary supplements." ], "questions": [ { "id": "evidence-real-world-use-q01", "text": "Which of these real-world use hold for the sense of caffeine this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-measurements", "name": "Typical measurements", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ { "quantity": "Molar mass (anhydrous)", "typical_range": "194.19", "unit": "g/mol" }, { "quantity": "Mass per 240 mL brewed coffee serving", "typical_range": "70-140", "unit": "mg" }, { "quantity": "Mass per 240 mL black tea serving", "typical_range": "20-70", "unit": "mg" }, { "quantity": "Mass per energy-drink can", "typical_range": "80-300", "unit": "mg" }, { "quantity": "Adult habitual intake of no safety concern (EFSA 2015)", "typical_range": "up to 400", "unit": "mg/day" }, { "quantity": "Pregnancy intake of no safety concern (EFSA 2015)", "typical_range": "up to 200", "unit": "mg/day" }, { "quantity": "Plasma elimination half-life in healthy adults", "typical_range": "3-7", "unit": "h" }, { "quantity": "Melting point (anhydrous)", "typical_range": "234-239", "unit": "°C" }, { "quantity": "Estimated adult oral lethal dose", "typical_range": "about 10 (roughly 150-200 mg/kg)", "unit": "g" } ], "questions": [ { "id": "evidence-measurements-q01", "text": "Which of these typical measurements hold for the sense of caffeine this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-failure-modes-and-hazards", "name": "Failure modes and hazards", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "Acute caffeine toxicity from concentrated powder, multiple energy drinks or mis-dosed supplements: tachycardia, arrhythmia, seizures, hypokalaemia, vomiting.", "Caffeine withdrawal after abrupt cessation of habitual use: headache, fatigue, irritability, lasting one to several days.", "Sleep onset delay and reduced slow-wave sleep when taken in the afternoon or evening.", "Pharmacokinetic interactions via CYP1A2 (induction by smoking; inhibition by fluvoxamine, ciprofloxacin and some oral contraceptives) altering both caffeine and co-substrates such as clozapine or theophylline.", "High gestational intake associated in observational data with lower birth weight and miscarriage risk above the EFSA 200 mg/day guidance.", "Dependence and reinforcing use; not a controlled substance in most jurisdictions, which increases access to high-dose powders.", "Label/assay mismatch in some dietary supplements and 'natural caffeine' extracts, producing super-potent servings." ], "questions": [ { "id": "evidence-failure-modes-and-hazards-q01", "text": "Which of these failure modes and hazards hold for the sense of caffeine this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-regional-variation", "name": "Regional variation", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "Primary dietary vehicle: drip/filter coffee in much of the Americas and Nordics; espresso in southern Europe; tea in the UK, China, India and North Africa; yerba mate in Argentina, Uruguay and Paraguay; guarana drinks in Brazil.", "Legal drink composition: U.S. cola GRAS cap 0.02% (200 mg/L) versus EU high-caffeine warning above 150 mg/L for non-tea/coffee drinks versus tighter per-serving caps on energy drinks in Canada and compositional windows under FSANZ 2.6.4.", "Sale restrictions to minors for high-caffeine energy drinks in several EU member states and some Gulf jurisdictions; not a uniform federal rule in the United States.", "Religious practice: some Latter-day Saint and Adventist communities avoid coffee and/or caffeinated soft drinks; tea remains the everyday caffeine source across large parts of Asia.", "Nordic countries among the highest per-capita coffee (hence caffeine) intakes; East Asian intakes historically tea-dominant with later growth of coffee and energy drinks." ], "questions": [ { "id": "evidence-regional-variation-q01", "text": "Which of these regional variation hold for the sense of caffeine this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-neighbours", "name": "Neighbouring kinds and how to tell them apart", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ { "name": "Theobromine", "difference": "3,7-dimethylxanthine (no N1-methyl), dominant in cacao and a much weaker CNS stimulant; separate by HPLC-UV or LC-MS (neutral mass 180 vs 194 Da) rather than by beverage name." }, { "name": "Theophylline", "difference": "1,3-dimethylxanthine used as a bronchodilator; same xanthine core but licensed as a drug with a narrow therapeutic window; distinguish by chromatography and by clinical indication, not by 'tea content' claims." }, { "name": "Paraxanthine", "difference": "1,7-dimethylxanthine, the main human metabolite of caffeine, present in plasma after a dose but not added as a food ingredient; appears in bioanalysis, not on ingredient lists." }, { "name": "Guarana extract", "difference": "The caffeine molecule is the same; the extract also carries other Paullinia constituents and is often labelled as if it were a different stimulant. Total 1,3,7-trimethylxanthine by assay is the separator, not the plant name." }, { "name": "Decaffeinated coffee or tea", "difference": "Same beverage matrix with residual caffeine typically about 2-5 mg per cup versus 70-140 mg (coffee) or 20-70 mg (tea); confirm by quantitative HPLC, not by 'decaf' branding alone." }, { "name": "Amphetamines and methylphenidate", "difference": "DAT/NET releasers or reuptake inhibitors, not adenosine antagonists; separated in toxicology by immunoassay class and confirmatory LC-MS/MS, and clinically by much stronger reinforcing and cardiovascular effects at therapeutic doses." } ], "questions": [ { "id": "evidence-neighbours-q01", "text": "Which of these neighbouring kinds and how to tell them apart hold for the sense of caffeine this model covers, and on what evidence?", "kind": "provenance" } ] } ] } ] } ] }, "openQuestions": [ "Does an existing Vercy world model already own caffeine or its chemical-substance identity, requiring this registry entry to link to it?", "Which authoritative references and analytical methods should establish caffeine identity and discriminate relevant methylxanthines in each supported matrix?", "Which caffeine solid forms and hydration states need explicit representation, and what evidence is sufficient to assign them?", "Which specifications, impurity limits and assay conventions govern the intended food, pharmaceutical, laboratory or industrial applications?", "What verified storage, dissolution and reassessment criteria apply to the caffeine forms and preparations this model will support?" ], "statistics": { "bundles": 6, "layers": 11, "findings": 18, "questions": 28 } }, "draft": { "generator": "vr.draft.v3", "status": "draft-generated", "researched": false, "archetype": "chemical substance or material", "method": "Written from the archetype playbook - what this kind of thing needs beyond identity and provenance - and from the structure that recurred across 6,333 models already researched by two engines. Applied to this entry by rule. No source was read for this thing and no claim here is researched. This entry carries no facets of its own, so they were inferred from its domain - a guess about a whole domain applied to one thing.", "facetsInferred": true, "nextPass": "A researcher replaces this draft with a sourced specification. Treat every sentence below as a proposal to argue with.", "purpose": "Give an agent a durable, checkable way to recognise a caffeine, record what state it is in, and decide what may be done with it.", "whatItIs": "Enable an AI agent to recognise caffeine, assess the identity and condition of a particular quantity, and determine which handling, formulation or transfer actions are supported by evidence.", "characteristics": { "substance": "material", "origin": "natural", "agency": "inert", "mobility": "varies" }, "whatYouCanDoWithIt": [ "observed and measured", "consumed or used up" ], "distinguishingFeatures": [ "Names folded into this entry, which a task may need to split apart again: Buckfast Tonic Wine, Caffeine-13C3 solution, 1,7-Dimethyl-3-(¹³C)methyl-3,7-dihydro-1H-purine-2,6-dione, (14-C)Caffeine.", "4 finer distinctions are held as aliases rather than separate entries, because telling them apart needs a task that asks for it.", "Described in 98 Wikipedia languages, which is a measure of how widely the thing is known, not of how important it is." ], "openQuestionsForResearch": [ "Which of the bundles below does a real task actually need, and which are ceremony?", "What does this thing have that the facets do not capture at all?", "Which neighbouring kind is most often confused with a caffeine, and on what evidence are they told apart?" ], "whatItIsMadeOf": "matter you can touch", "physicalCharacter": [ "Mobility varies between examples.", "Does nothing on its own; everything it does, something else did to it.", "These come from the domain this entry sits in rather than from the entry itself, so treat them as a first guess about the whole domain applied to one thing." ], "whatCanBeDoneWithIt": [ "observe it, measure it, record its state", "use it up, and then need more of it" ], "howItIsRecognised": [ "Not recognisable by sight in any reliable way. Appearance varies with grade, form and additives; identification is by label, by documentation, or by assay." ], "relatedModels": [ { "relation": "covers", "note": "Finer kinds folded into this entry because telling them apart needs a task that asks for it. Each is a model waiting to be split out when one does.", "targets": [ "Buckfast Tonic Wine", "Caffeine-13C3 solution", "1,7-Dimethyl-3-(¹³C)methyl-3,7-dihydro-1H-purine-2,6-dione", "(14-C)Caffeine" ] } ], "standing": "Described in 98 Wikipedia languages, which measures how widely it is written about rather than how important or how common it is. 4 finer distinctions are held inside this entry as names rather than as separate models.", "structure": { "bundles": [ { "id": "identity-and-classification", "name": "Identity, naming and classification", "description": "How an agent tells one caffeine from another, and a caffeine from things that resemble it.", "rationale": "Recognition comes before every other claim. Without stable identity nothing else in the model can be trusted to be about the same thing twice.", "layers": [ { "id": "naming-and-identifiers", "name": "Names and identifiers", "description": "The names this thing goes by and the identifiers that survive translation and time.", "findings": [ { "id": "preferred-name-and-aliases", "name": "Preferred name, aliases and local names", "description": "Which name to use, which names mean the same thing, and which merely sound similar.", "questions": [ { "id": "preferred-name-and-aliases-q01", "text": "What identifies and describes the name of a caffeine, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "preferred-name-and-aliases-q02", "text": "Who or what asserted this about the name of a caffeine, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "preferred-name-and-aliases-q03", "text": "What may an agent decide or do once the name of a caffeine is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] }, { "id": "stable-identifiers", "name": "Stable identifiers and external keys", "description": "Identifiers that keep pointing at this kind of thing across systems and languages.", "questions": [ { "id": "stable-identifiers-q01", "text": "What identifies and describes an identifier for a caffeine, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "stable-identifiers-q02", "text": "Who or what asserted this about an identifier for a caffeine, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "stable-identifiers-q03", "text": "What may an agent decide or do once an identifier for a caffeine is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "classification-and-granularity", "name": "Classification and granularity", "description": "Where a caffeine sits among kinds, and how finely a task needs to cut it.", "findings": [ { "id": "kind-and-parents", "name": "Kind, parents and neighbouring kinds", "description": "The classes this thing belongs to and the ones it is next to.", "questions": [ { "id": "kind-and-parents-q01", "text": "What identifies and describes the kind of a caffeine, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "kind-and-parents-q02", "text": "Who or what asserted this about the kind of a caffeine, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "kind-and-parents-q03", "text": "What may an agent decide or do once the kind of a caffeine is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] }, { "id": "distinguishing-features", "name": "Distinguishing features", "description": "What separates a caffeine from the things most often confused with it.", "questions": [ { "id": "distinguishing-features-q01", "text": "What identifies and describes what distinguishes a caffeine, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "distinguishing-features-q02", "text": "Who or what asserted this about what distinguishes a caffeine, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "distinguishing-features-q03", "text": "What may an agent decide or do once what distinguishes a caffeine is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "form-and-composition", "name": "Form, composition and condition", "description": "What a caffeine is made of, what shape and size it takes, and what state it is in.", "rationale": "A physical thing can be measured, and a model that cannot record its measurements cannot support any decision that depends on them.", "layers": [ { "id": "form-and-dimensions", "name": "Form and dimensions", "description": "Shape, size, mass and the ranges these take across examples.", "findings": [ { "id": "measurable-dimensions", "name": "Measurable dimensions and their units", "description": "The quantities worth recording and the units they are recorded in.", "questions": [ { "id": "measurable-dimensions-q01", "text": "What identifies and describes the dimensions of a caffeine, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "measurable-dimensions-q02", "text": "Who or what asserted this about the dimensions of a caffeine, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "measurable-dimensions-q03", "text": "What may an agent decide or do once the dimensions of a caffeine is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "material-and-composition", "name": "Material and composition", "description": "Materials, parts and how they are put together.", "findings": [ { "id": "parts-and-materials", "name": "Parts and materials", "description": "What a caffeine is built from and which parts are replaceable.", "questions": [ { "id": "parts-and-materials-q01", "text": "What identifies and describes the composition of a caffeine, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "parts-and-materials-q02", "text": "Who or what asserted this about the composition of a caffeine, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "parts-and-materials-q03", "text": "What may an agent decide or do once the composition of a caffeine is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "condition-and-integrity", "name": "Condition and integrity", "description": "Wear, damage, health and the difference between working and broken.", "findings": [ { "id": "condition-assessment", "name": "Condition, damage and health", "description": "How the condition of a caffeine is judged and by whom.", "questions": [ { "id": "condition-assessment-q01", "text": "What identifies and describes the condition of a caffeine, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "condition-assessment-q02", "text": "Who or what asserted this about the condition of a caffeine, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "condition-assessment-q03", "text": "What may an agent decide or do once the condition of a caffeine is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "place-and-movement", "name": "Place and movement", "description": "Where a caffeine is, how it got there and where it may go (varies).", "rationale": "A thing that can move needs its position recorded with a time, or every later claim about it is about a place it has left.", "layers": [ { "id": "location-and-placement", "name": "Location and placement", "description": "Position, containment and the reference frame the position is given in.", "findings": [ { "id": "position-and-frame", "name": "Position, container and reference frame", "description": "Where a caffeine is, and what that position is measured against.", "questions": [ { "id": "position-and-frame-q01", "text": "What identifies and describes the location of a caffeine, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "position-and-frame-q02", "text": "Who or what asserted this about the location of a caffeine, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "position-and-frame-q03", "text": "What may an agent decide or do once the location of a caffeine is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "movement-and-transfer", "name": "Movement and transfer", "description": "How a caffeine is carried, installed or relocated.", "findings": [ { "id": "movement-events", "name": "Movement events and constraints", "description": "What counts as a movement, what records it and what limits it.", "questions": [ { "id": "movement-events-q01", "text": "What identifies and describes the movement of a caffeine, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "movement-events-q02", "text": "Who or what asserted this about the movement of a caffeine, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "movement-events-q03", "text": "What may an agent decide or do once the movement of a caffeine is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "state-and-lifecycle", "name": "State and lifecycle", "description": "The states a caffeine passes through and the events that move it between them.", "rationale": "Most decisions about a thing depend on what state it is in now, which is a claim with a time on it, not a property.", "layers": [ { "id": "lifecycle-stages", "name": "Lifecycle stages", "description": "From coming into existence to ceasing to be one of these.", "findings": [ { "id": "stages-and-transitions", "name": "Stages and transitions", "description": "The stages worth naming and what moves a caffeine between them.", "questions": [ { "id": "stages-and-transitions-q01", "text": "What identifies and describes the lifecycle of a caffeine, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "stages-and-transitions-q02", "text": "Who or what asserted this about the lifecycle of a caffeine, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "stages-and-transitions-q03", "text": "What may an agent decide or do once the lifecycle of a caffeine is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "observations-and-status", "name": "Observations and current status", "description": "What is observed about a caffeine, how often and by whom.", "findings": [ { "id": "observation-record", "name": "Observation record", "description": "How an observation of a caffeine is recorded so that it can be superseded rather than overwritten.", "questions": [ { "id": "observation-record-q01", "text": "What identifies and describes an observation of a caffeine, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "observation-record-q02", "text": "Who or what asserted this about an observation of a caffeine, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "observation-record-q03", "text": "What may an agent decide or do once an observation of a caffeine is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "use-and-operation", "name": "Use and operation", "description": "What can be done with a caffeine and what it takes to do it.", "rationale": "An agent that can recognise a thing but not act on it has only half a model.", "layers": [ { "id": "intended-use", "name": "Intended use and function", "description": "What a caffeine is for, and what it is used for anyway.", "findings": [ { "id": "function-and-purpose", "name": "Function, purpose and misuse", "description": "The function a caffeine performs and the uses that fall outside it.", "questions": [ { "id": "function-and-purpose-q01", "text": "What identifies and describes the use of a caffeine, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "function-and-purpose-q02", "text": "Who or what asserted this about the use of a caffeine, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "function-and-purpose-q03", "text": "What may an agent decide or do once the use of a caffeine is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "handling-and-procedure", "name": "Handling and procedure", "description": "The steps, skills and tools involved in using a caffeine.", "findings": [ { "id": "procedures-and-skills", "name": "Procedures, skills and required tools", "description": "What an agent needs before it can act on a caffeine at all.", "questions": [ { "id": "procedures-and-skills-q01", "text": "What identifies and describes handling a caffeine, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "procedures-and-skills-q02", "text": "Who or what asserted this about handling a caffeine, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "procedures-and-skills-q03", "text": "What may an agent decide or do once handling a caffeine is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "supply-and-consumption", "name": "Supply and consumption", "description": "Quantities, rates and what running out means.", "findings": [ { "id": "consumption-and-stock", "name": "Consumption, stock and replenishment", "description": "How much of a caffeine there is and how fast it goes.", "questions": [ { "id": "consumption-and-stock-q01", "text": "What identifies and describes the supply of a caffeine, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "consumption-and-stock-q02", "text": "Who or what asserted this about the supply of a caffeine, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "consumption-and-stock-q03", "text": "What may an agent decide or do once the supply of a caffeine is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "composition-and-identity", "name": "Composition, grade and chemical identity", "description": "What caffeine is made of and how pure the thing in hand is.", "rationale": "Grade decides what a substance may be used for, so a model that records only the name cannot support any decision about use.", "layers": [ { "id": "chemical-identity", "name": "Chemical identity", "description": "Formula, structure and the registry numbers that name it unambiguously.", "findings": [ { "id": "identity-record", "name": "Identity and registry numbers", "description": "What identifies this substance across suppliers and regulators.", "questions": [ { "id": "identity-record-q01", "text": "What formula, structure and registry identifiers name caffeine unambiguously?", "kind": "definition" }, { "id": "identity-record-q02", "text": "Which related substances share a name in common use but not an identifier?", "kind": "boundary" } ] } ] }, { "id": "grade-and-impurities", "name": "Grade, purity and impurities", "description": "The specification a batch meets and what else is in it.", "findings": [ { "id": "specification", "name": "Specification and assay", "description": "How purity is stated and measured, and which impurities matter.", "questions": [ { "id": "specification-q01", "text": "What grades of caffeine exist, how is purity assayed, and which impurities are limited?", "kind": "measurement" }, { "id": "specification-q02", "text": "Which use requires which grade, and what happens when a lower grade is substituted?", "kind": "action" } ] } ] } ] }, { "id": "properties-and-behaviour", "name": "Properties and behaviour", "description": "How caffeine behaves under conditions an agent can measure or change.", "rationale": "Physical constants are the part of a substance model that transfers between contexts, and each needs its unit and its conditions.", "layers": [ { "id": "physical-constants", "name": "Physical constants", "description": "Values that hold for the pure substance, with their conditions.", "findings": [ { "id": "constants-record", "name": "Constants and conditions", "description": "The quantities worth recording and the state they apply in.", "questions": [ { "id": "constants-record-q01", "text": "What are the defining physical constants of caffeine, in what units and under what conditions?", "kind": "measurement" }, { "id": "constants-record-q02", "text": "Which of these values change with grade or form rather than being fixed?", "kind": "boundary" } ] } ] }, { "id": "stability-and-reactivity", "name": "Stability and reactivity", "description": "What it reacts with, degrades into, and how it is stored.", "findings": [ { "id": "incompatibilities", "name": "Incompatibilities and degradation", "description": "What must not meet it, and what it becomes over time.", "questions": [ { "id": "incompatibilities-q01", "text": "What is caffeine incompatible with, and what does it degrade into under storage?", "kind": "definition" }, { "id": "incompatibilities-q02", "text": "What storage and handling does that require, and who is competent to do it?", "kind": "action" } ] } ] } ] }, { "id": "hazard-and-regulation", "name": "Hazard classification and regulation", "description": "How caffeine can harm, and what the law says about holding and moving it.", "rationale": "A substance model without its hazard class and its regulatory identity is unusable in exactly the situations that matter.", "layers": [ { "id": "hazard-class", "name": "Hazard classification", "description": "Classified hazards, exposure limits and protective measures.", "findings": [ { "id": "classified-hazards", "name": "Classified hazards and limits", "description": "The classification, the scheme it belongs to, and the limits set.", "questions": [ { "id": "classified-hazards-q01", "text": "How is caffeine classified for hazard, under which scheme, and what exposure limits apply?", "kind": "definition" }, { "id": "classified-hazards-q02", "text": "What protection does handling require, and what must an agent refuse to do without it?", "kind": "action" } ] } ] }, { "id": "regulatory-identity", "name": "Regulatory identity and control", "description": "Registration, restriction and transport rules by jurisdiction.", "findings": [ { "id": "controls", "name": "Controls and jurisdiction", "description": "Where it is restricted and what the restriction attaches to.", "questions": [ { "id": "controls-q01", "text": "Which registrations, restrictions or transport rules cover caffeine, and where?", "kind": "provenance" }, { "id": "controls-q02", "text": "Does the control attach to the substance, its concentration, or its intended use?", "kind": "boundary" } ] } ] } ] }, { "id": "provenance-and-evidence", "name": "Provenance, evidence and time", "description": "Where every claim about a caffeine came from and when it held.", "rationale": "A claim without a source and a time cannot be superseded, only overwritten, and an agent that overwrites loses the ability to explain itself.", "layers": [ { "id": "source-and-authority", "name": "Source and authority", "description": "Who said it, on what evidence, and how strongly.", "findings": [ { "id": "claim-provenance", "name": "Claim provenance and confidence", "description": "The authority behind each claim about a caffeine and how confident it is.", "questions": [ { "id": "claim-provenance-q01", "text": "What identifies and describes a claim about a caffeine, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "claim-provenance-q02", "text": "Who or what asserted this about a claim about a caffeine, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "claim-provenance-q03", "text": "What may an agent decide or do once a claim about a caffeine is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "time-and-versions", "name": "Time, versions and supersession", "description": "When a claim was true, when it was learnt, and what replaced it.", "findings": [ { "id": "validity-and-supersession", "name": "Validity period and supersession", "description": "How an old claim about a caffeine is retired without being erased.", "questions": [ { "id": "validity-and-supersession-q01", "text": "What identifies and describes the validity of a claim about a caffeine, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "validity-and-supersession-q02", "text": "Who or what asserted this about the validity of a claim about a caffeine, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "validity-and-supersession-q03", "text": "What may an agent decide or do once the validity of a claim about a caffeine is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] } ] }, "statistics": { "bundles": 9, "layers": 20, "findings": 22, "questions": 60 } } } }