{ "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-12T10:00:49Z", "providers": [ "Codex" ], "breadth": "recalled by Codex without web access - no source was read", "missingProviders": [], "pass": 2, "cost": { "grok": { "seconds": 23.7, "error": "Reading additional input from stdin...\nOpenAI Codex v0.153.4\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: 01a0950e-c9c9-7610-a88a-49f15e21d448\n--------\nuser\nDescribe what is already known about one registered thing. Answer as JSON only, no prose around it.\n\nThing: ginsenoside\nSense to describe: (none recorded)\nDomain code: PHY.MAT\nAlso known as: (none)\n\n\nContext for this batch of 1001 things:\n# Batch 043: 1001 reg", "usd": 0.0, "recall": true }, "codex": { "seconds": 80.3, "error": "Reading additional input from stdin...\nOpenAI Codex v0.153.4\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: 01a0950e-c9da-7ad3-b019-323bb7cb1ce8\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: ginsenoside\nRegistry id: vr.tr.ginsenoside\nPlane / domain: PHY / PHY.MAT\nRegistry definition: (none recorded)\nNames folded into this entry: (none)\n\n\n" } }, "enrichment": { "pass": 3, "engine": "claude", "producedAt": "2026-10-06T12:00:00Z", "ingestedAt": "2026-10-06T08:43:45+00:00", "fields": [ "agent_conduct", "ethics", "failure_modes_and_hazards", "owners", "standards_and_regulation", "visual_identification" ] }, "gate": { "passed": true, "version": "1.0", "at": "2026-10-07T10:10:31+00:00", "evidence": [ "completeness 1.00", "sense: Wikidata description", "2 live sources", "review by codex: pass" ] } }, "metaModel": { "id": "THING-Q59662497", "registryId": "vr.tr.ginsenoside", "name": "ginsenoside", "version": "0.1.0-research.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "PHY.MAT" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/q59662497/", "model": { "registry_id": "vr.tr.ginsenoside", "name": "ginsenoside", "purpose": "Enable an agent to identify a ginsenoside, assess the composition and condition of material containing it, and determine which analytical, handling and use decisions the evidence supports.", "definition": "A ginsenoside is a member of a family of triterpenoid saponin glycosides characteristic of Panax species, distinguished by their aglycone structures and attached sugar residues.", "scope_statement": "This model owns vr.tr.ginsenoside in PHY / PHY.MAT as a chemical family, including member identity, structural distinctions, material quality and transformation relationships; individual congeners are represented within the family without treating all ginsenosides as one substance.", "in_scope": [ "Family membership, congener names, synonyms and structure-specific identifiers", "Aglycone skeleton, sugar residues, glycosidic linkages and stereochemistry", "Congener-resolved composition, purity and analytical identification", "Source provenance, processing history and chemical transformations", "Physical condition, stability and evidence supporting handling or use" ], "out_of_scope": [ "Taxonomy, cultivation and health of Panax plants", "Complete composition and manufacture of ginseng extracts", "Finished supplement, food or medicine formulation and labelling", "Clinical treatment decisions and patient-specific dosing", "Extraction equipment and production-process engineering" ], "distinguishing_features": [ "Require a defined glycosylated triterpenoid structure rather than identifying a material solely as a plant extract; representative ginsenoside Rg5 is classified as a triterpenoid saponin. [ChEBI](https://www.ebi.ac.uk/chebi/CHEBI%3A67992)", "Distinguish a named congener from an unspecified total-ginsenoside fraction by requiring member-resolved identity and composition.", "Compare sugar identity, attachment position, linkage and stereochemistry before treating two ginsenoside names as equivalent.", "Distinguish a glycoside from its corresponding free aglycone by recording whether sugar residues remain attached.", "Require a documented family-membership decision for related saponins rather than accepting botanical origin or a similar name as sufficient." ], "characteristics": [ { "name": "Identity resolution", "kind": "state", "unit_or_values": "family only | named congener | structure confirmed | unresolved mixture", "why_it_matters": "Determines whether member-specific properties and identifiers can be applied." }, { "name": "Congener identifiers", "kind": "relation", "unit_or_values": "Structure-linked preferred name, synonyms, CAS number, PubChem CID, ChEBI identifier and EC number where established", "why_it_matters": "Prevents assigning a single compound identifier to the entire family." }, { "name": "Aglycone structure", "kind": "category", "unit_or_values": "Recorded skeleton and substitution pattern; proposed family membership separately qualified", "why_it_matters": "Supports structural grouping without assuming that naming conventions establish chemical equivalence." }, { "name": "Glycosylation pattern", "kind": "category", "unit_or_values": "Sugar identities, residue count, attachment positions, linkage sequence and anomeric configurations", "why_it_matters": "Separates congeners that share an aglycone." }, { "name": "Stereochemical assignment", "kind": "state", "unit_or_values": "Specified stereocentres and configurations | partially assigned | unresolved", "why_it_matters": "Prevents conflating stereoisomers in identification and comparison." }, { "name": "Congener content", "kind": "measurement", "unit_or_values": "mg/g, mass %, or mol/L with analyte, matrix, method and reporting basis", "why_it_matters": "Makes quantitative results interpretable and comparable." }, { "name": "Purity and impurity profile", "kind": "measurement", "unit_or_values": "Mass fraction or method-specific chromatographic area %, with water, solvents and related congeners separately identified", "why_it_matters": "Distinguishes an assay result from evidence of overall chemical purity." }, { "name": "Physical form and dissolution behaviour", "kind": "state", "unit_or_values": "Solid form or solution composition; solubility in mg/mL at specified solvent, temperature and pH", "why_it_matters": "Supports preparation and storage decisions for the actual material." }, { "name": "Transformation history", "kind": "relation", "unit_or_values": "Precursor, resulting congener, treatment conditions, sampling time and supporting analysis", "why_it_matters": "Connects processing or degradation to changes in identity and composition." }, { "name": "Handling evidence status", "kind": "state", "unit_or_values": "Member- and material-specific safety documentation available | partial | absent", "why_it_matters": "Keeps missing hazard information distinct from demonstrated low hazard." } ], "affordances": [ "Resolve a supplied name to a defined congener or retain an explicitly unresolved family-level identity.", "Select reference standards and analytical methods appropriate to the proposed congeners and isomers.", "Compare lots using congener profiles, assay basis and impurity evidence.", "Track changes in ginsenoside composition during processing, storage or experimental conversion.", "Determine whether material meets documented requirements for a specified analytical or experimental use.", "Retrieve handling and regulatory evidence matched to the identified material and jurisdiction." ], "agent_conduct": { "may": [ "Describe ginsenosides and the research on them from scientific sources, noting the strength of evidence.", "Report ginsenoside content of products from authorized laboratory data." ], "must_not": [ "Claim that ginsenosides cure or prevent disease without solid clinical evidence.", "Advise people on blood thinners, diabetes medicines or in pregnancy to take ginseng products without medical advice.", "Misstate ginsenoside content or species on product labels.", "Promote harvesting of wild ginseng where it is protected." ], "requires_human": [ "Recommending ginseng products to patients alongside prescribed medicines." ] }, "ethics": { "considerations": [ "Supplement marketing exploits limited research to sell products to sick people.", "Wild ginseng is overharvested and protected in several countries." ], "affected_parties": [ "Consumers and patients", "Wild ginseng populations", "Growers" ] }, "owners": { "steward": "Nobody owns the compounds; producers answer for products that contain them.", "master_systems": [ "Chemical substance databases" ] }, "visual_identification": [ "Purified ginsenosides are white or off-white powders; identity requires laboratory analysis." ], "failure_modes_and_hazards": [ "Interactions with blood thinners and diabetes medicines.", "Adulterated or mislabelled ginseng products." ], "standards_and_regulation": [ "Convention on International Trade in Endangered Species of Wild Fauna and Flora, CITES Secretariat, which lists American ginseng." ], "what_it_is_for": [ "Ginsenosides are encountered in plant material, extracts and analytical reference materials derived from or associated with Panax species.", "They are studied in natural products chemistry and pharmacology and measured when characterizing the composition and consistency of botanical materials." ] }, "sources": [ { "id": "wikidata", "title": "Wikidata item Q59662497: ginsenoside", "url": "https://www.wikidata.org/wiki/Q59662497", "url_status": "live", "what_it_supports": "identity and sense of the item", "checked_by": "wikidata-api" }, { "id": "wikipedia-en", "title": "Wikipedia: Ginsenoside", "url": "https://en.wikipedia.org/wiki/Ginsenoside", "url_status": "live", "what_it_supports": "general description of the item", "checked_by": "wikidata-api sitelink" } ], "structure": { "bundles": [ { "id": "ginsenoside-identity", "name": "Ginsenoside identity", "description": "Resolve what the family label and individual congener names denote.", "rationale": "A family name cannot supply a single molecular formula, identifier or property set.", "layers": [ { "id": "family-boundary", "name": "Family boundary", "description": "Establish the chemical and naming criteria for inclusion.", "findings": [ { "id": "membership-criteria", "name": "Membership criteria", "description": "Record the adopted definition and explicitly adjudicate related saponins and aglycones.", "questions": [ { "text": "Which structural and nomenclatural criteria qualify a compound as a ginsenoside under the adopted definition?", "kind": "definition", "id": "membership-criteria-q01" }, { "text": "How are non-dammarane named compounds, related saponins and free aglycones included, excluded or linked?", "kind": "boundary", "id": "membership-criteria-q02" } ] } ] }, { "id": "congener-resolution", "name": "Congener resolution", "description": "Connect names and identifiers to chemically explicit members.", "findings": [ { "id": "name-structure-correspondence", "name": "Name-structure correspondence", "description": "Resolve aliases against complete structures while preserving ambiguity.", "questions": [ { "text": "Which structure, including stereochemistry, does each supplied congener name or synonym denote?", "kind": "definition", "id": "name-structure-correspondence-q01" }, { "text": "Which authoritative records support its identifiers, and do those records describe the same stereochemical entity?", "kind": "provenance", "id": "name-structure-correspondence-q02" } ] } ] } ] }, { "id": "aglycone-and-sugars", "name": "Aglycone and sugars", "description": "Describe the structural features needed to distinguish individual ginsenosides.", "rationale": "Closely related members require more discrimination than a shared family name or molecular mass.", "layers": [ { "id": "aglycone-configuration", "name": "Aglycone configuration", "description": "Capture the core skeleton, substitutions and stereochemical assignment.", "findings": [ { "id": "core-structure-assignment", "name": "Core structure assignment", "description": "Identify structural differences that determine congener or stereoisomer identity.", "questions": [ { "text": "What aglycone skeleton, oxidation pattern and stereocentre assignments define this member?", "kind": "definition", "id": "core-structure-assignment-q01" }, { "text": "What evidence resolves the relevant epimers, including C-20 configuration where applicable?", "kind": "measurement", "id": "core-structure-assignment-q02" } ] } ] }, { "id": "sugar-architecture", "name": "Sugar architecture", "description": "Capture attached carbohydrate residues and their arrangement.", "findings": [ { "id": "glycosidic-structure-assignment", "name": "Glycosidic structure assignment", "description": "Record sugar composition, connectivity and modifications without collapsing positional isomers.", "questions": [ { "text": "Which sugars are attached at which positions, with what sequence, linkage and anomeric configuration?", "kind": "definition", "id": "glycosidic-structure-assignment-q01" }, { "text": "Which analytical evidence distinguishes this arrangement from congeners with the same nominal mass or sugar count?", "kind": "measurement", "id": "glycosidic-structure-assignment-q02" } ] } ] } ] }, { "id": "material-assay-and-quality", "name": "Material assay and quality", "description": "Establish what a supplied sample contains and how confidently it has been measured.", "rationale": "A total-ginsenoside claim, a congener assay and purified material describe different levels of information.", "layers": [ { "id": "identity-testing", "name": "Identity testing", "description": "Evaluate the ability of analytical methods to identify the claimed members.", "findings": [ { "id": "analytical-specificity", "name": "Analytical specificity", "description": "Connect identification confidence to standards, separation and structural evidence.", "questions": [ { "text": "Which reference standards and chromatographic, mass-spectrometric or NMR evidence support each assignment?", "kind": "measurement", "id": "analytical-specificity-q01" }, { "text": "Which coeluting congeners or unresolved stereoisomers could invalidate that assignment?", "kind": "boundary", "id": "analytical-specificity-q02" } ] } ] }, { "id": "composition-and-assay-basis", "name": "Composition and assay basis", "description": "Make congener quantities and purity claims comparable.", "findings": [ { "id": "quantitative-profile", "name": "Quantitative profile", "description": "Separate actual analyte mass fractions from relative detector response and aggregate estimates.", "questions": [ { "text": "What is each measured congener's concentration, uncertainty and dry-mass or as-received reporting basis?", "kind": "measurement", "id": "quantitative-profile-q01" }, { "text": "Does total ginsenoside content mean a sum of resolved analytes or an assay expressed against a surrogate standard?", "kind": "definition", "id": "quantitative-profile-q02" }, { "text": "What residual solvents, water, related congeners or matrix components constrain acceptance for the intended use?", "kind": "action", "id": "quantitative-profile-q03" } ] } ] } ] }, { "id": "origin-and-transformation", "name": "Origin and transformation", "description": "Track where a member came from and how its chemical identity may have changed.", "rationale": "Source and treatment history are necessary to interpret a measured congener profile.", "layers": [ { "id": "source-history", "name": "Source history", "description": "Link material to its biological or preparative origin.", "findings": [ { "id": "origin-attribution", "name": "Origin attribution", "description": "Preserve botanical, isolation or synthesis evidence without treating origin as proof of structure.", "questions": [ { "text": "Was the material isolated from a documented species and plant part, synthesized, or obtained through conversion of another compound?", "kind": "provenance", "id": "origin-attribution-q01" }, { "text": "Which lot records and analytical results connect that origin to the material now being assessed?", "kind": "provenance", "id": "origin-attribution-q02" } ] } ] }, { "id": "conversion-and-stability", "name": "Conversion and stability", "description": "Record demonstrated changes under processing and storage conditions.", "findings": [ { "id": "congener-change-evidence", "name": "Congener change evidence", "description": "Distinguish observed transformations from presumed pathways.", "questions": [ { "text": "Under the recorded heat, pH, enzyme, microbial or storage conditions, which precursor and product congeners were actually measured?", "kind": "measurement", "id": "congener-change-evidence-q01" }, { "text": "What evidence distinguishes deglycosylation, epimerization or other chemical change from extraction loss or analytical variation?", "kind": "boundary", "id": "congener-change-evidence-q02" }, { "text": "Which storage conditions and retest interval are supported for this congener in this physical form or solvent?", "kind": "action", "id": "congener-change-evidence-q03" } ] } ] } ] }, { "id": "properties-and-use-evidence", "name": "Properties and use evidence", "description": "Connect member-specific physical properties and safety evidence to proposed actions.", "rationale": "Neither practical preparation conditions nor biological and hazard claims should be inherited indiscriminately across the family.", "layers": [ { "id": "physical-behaviour", "name": "Physical behaviour", "description": "Evaluate properties under conditions relevant to handling and experiments.", "findings": [ { "id": "preparation-conditions", "name": "Preparation conditions", "description": "Record physical form, dissolution and thermal observations for an identified material.", "questions": [ { "text": "What solubility and solution stability were measured for the exact congener, solvent composition, temperature and pH?", "kind": "measurement", "id": "preparation-conditions-q01" }, { "text": "Does a reported thermal value represent melting, desolvation or decomposition, and is any boiling-point claim experimentally supported?", "kind": "measurement", "id": "preparation-conditions-q02" } ] } ] }, { "id": "permitted-inferences-and-actions", "name": "Permitted inferences and actions", "description": "Bound handling and use decisions by the specificity of available evidence.", "findings": [ { "id": "use-specific-evidence", "name": "Use-specific evidence", "description": "Match safety, biological and regulatory statements to the exact member, material and context.", "questions": [ { "text": "Which current safety documents, hazard classifications or exposure limits explicitly apply to this congener and supplied material?", "kind": "provenance", "id": "use-specific-evidence-q01" }, { "text": "Were cited biological results obtained with this purified congener, a metabolite or a mixed extract, and in what experimental system?", "kind": "boundary", "id": "use-specific-evidence-q02" }, { "text": "What evidence and jurisdiction-specific requirements must be satisfied before the proposed laboratory, food or medicinal use can proceed?", "kind": "action", "id": "use-specific-evidence-q03" } ] } ] } ] }, { "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-confidence-notes", "name": "Check these first", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "This is recalled knowledge, not a researched source record.", "Resolve the individual congener before assigning a molecular formula, registry identifier, physical constant or hazard classification.", "Check applicable pharmacopoeial requirements and product regulations for the specific material and jurisdiction." ], "questions": [ { "id": "evidence-confidence-notes-q01", "text": "Which of these check these first hold for the sense of ginsenoside this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-kinds", "name": "Kinds and varieties", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "Protopanaxadiol-type ginsenosides, including Rb1, Rb2, Rc and Rd", "Protopanaxatriol-type ginsenosides, including Rg1 and Re", "Oleanane-type ginsenosides, including Ro" ], "questions": [ { "id": "evidence-kinds-q01", "text": "Which of these kinds and varieties hold for the sense of ginsenoside this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-identifiers", "name": "Identifiers and schemes", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ { "scheme": "Ginsenoside congener nomenclature", "value_or_pattern": "Ginsenoside followed by a designation such as Rb1, Rg1 or Re", "note": "These designate distinct compounds; ginsenoside alone names a family." }, { "scheme": "CAS Registry Number", "value_or_pattern": "Digits in the pattern NNNNNNN-NN-N, with a variable-length first block", "note": "An identifier must be checked against the specific congener and chemical form; no single number should represent the entire family." }, { "scheme": "PubChem Compound ID", "value_or_pattern": "An integer CID", "note": "Use the record for the individual molecular structure, including its stereochemistry." } ], "questions": [ { "id": "evidence-identifiers-q01", "text": "Which of these identifiers and schemes hold for the sense of ginsenoside this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-real-world-use", "name": "Real-world use", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "Analytical markers for identifying and assessing the quality of ginseng materials and extracts", "Reference standards for chromatographic analysis", "Research compounds for investigating metabolism and biological activity" ], "questions": [ { "id": "evidence-real-world-use-q01", "text": "Which of these real-world use hold for the sense of ginsenoside this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-measurements", "name": "Typical measurements", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ { "quantity": "Individual ginsenoside mass fraction in plant material or extract", "typical_range": "Depends on species, plant part, processing and extraction; no family-wide range is specified", "unit": "mg/g" }, { "quantity": "Purity of an isolated ginsenoside", "typical_range": "Grade-dependent; analytical method and reporting basis must be specified", "unit": "%" } ], "questions": [ { "id": "evidence-measurements-q01", "text": "Which of these typical measurements hold for the sense of ginsenoside this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-failure-modes-and-hazards", "name": "Failure modes and hazards", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "Treating total ginsenoside content as equivalent to the concentration or activity of a particular congener", "Misidentifying closely related congeners or stereoisomers when analytical separation is inadequate", "Processing or storage changing the congener profile through hydrolysis or other chemical transformations", "Attributing effects or safety findings for a whole ginseng extract to an isolated ginsenoside, or vice versa" ], "questions": [ { "id": "evidence-failure-modes-and-hazards-q01", "text": "Which of these failure modes and hazards hold for the sense of ginsenoside this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-neighbours", "name": "Neighbouring kinds and how to tell them apart", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ { "name": "Ginseng", "difference": "Ginseng is botanical material from Panax plants; ginsenosides are a family of chemical constituents." }, { "name": "Ginseng extract", "difference": "An extract is a mixture containing variable amounts of ginsenosides and other constituents." }, { "name": "Saponin", "difference": "Saponin is the broader chemical category; ginsenosides form a particular triterpenoid subgroup." }, { "name": "Protopanaxadiol", "difference": "Protopanaxadiol is an aglycone; its corresponding ginsenosides carry attached sugar residues." } ], "questions": [ { "id": "evidence-neighbours-q01", "text": "Which of these neighbouring kinds and how to tell them apart hold for the sense of ginsenoside this model covers, and on what evidence?", "kind": "provenance" } ] } ] } ] } ] }, "openQuestions": [ "Which authoritative family definition best matches the registry's intended scope, especially for non-dammarane compounds bearing ginsenoside names?", "How should related notoginsenoside names, pseudoginsenoside names and deglycosylated metabolites be linked without creating duplicate identities?", "Which analytical methods and reference standards adequately resolve the congeners and stereoisomers relevant to each intended material?", "Which member-specific physical constants, storage limits and transformation pathways have reproducible experimental support?", "Which safety classifications, exposure limits and use permissions are established for individual members, and where is evidence absent?" ], "statistics": { "bundles": 6, "layers": 11, "findings": 17, "questions": 30 } }