{ "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-12T09:14:56Z", "providers": [ "Codex" ], "breadth": "recalled by Codex without web access - no source was read", "missingProviders": [], "pass": 2, "cost": { "grok": { "seconds": 20.2, "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: 01a094e4-f639-77d3-a448-456735b683e0\n--------\nuser\nDescribe what is already known about one registered thing. Answer as JSON only, no prose around it.\n\nThing: dissolved organic carbon\nSense to describe: (none recorded)\nDomain code: PHY.MAT\nAlso known as: (none)\n\n\nContext for this batch of 1001 things:\n# Batch ", "usd": 0.0, "recall": true }, "codex": { "seconds": 68.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: 01a094e4-f625-7e60-aa64-0bfa5e494182\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: dissolved organic carbon\nRegistry id: vr.tr.dissolved-organic-carbon\nPlane / domain: PHY / PHY.MAT\nRegistry definition: (none recorded)\nNames folded " } }, "enrichment": { "pass": 3, "engine": "claude", "producedAt": "2026-10-06T12:00:00Z", "ingestedAt": "2026-10-06T08:51:51+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-Q449096", "registryId": "vr.tr.dissolved-organic-carbon", "name": "dissolved organic carbon", "version": "0.1.0-research.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "PHY.MAT" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/q449096/", "model": { "registry_id": "vr.tr.dissolved-organic-carbon", "name": "dissolved organic carbon", "purpose": "Enable an agent to recognise dissolved organic carbon as an operationally defined carbon fraction, assess whether its measurements are comparable, and judge its potential transport, transformation and treatment behaviour.", "definition": "Dissolved organic carbon (DOC) is the carbon contained in organic matter in water that passes a specified filter, commonly with a nominal pore size of 0.45 micrometres, making it an operationally defined fraction rather than a single chemical substance.", "scope_statement": "This model owns the identity, measured amount, compositional character and context-dependent behaviour of organic carbon assigned to the dissolved fraction of an aqueous sample, including the operational boundary used to separate it.", "in_scope": [ "Operational definition of the dissolved fraction, including filtration and sample preparation", "DOC concentration, uncertainty and measurement basis", "Organic composition and properties relevant to reactivity", "Sources, transport and transformations of DOC", "Evidence supporting decisions about DOC monitoring or removal" ], "out_of_scope": [ "Dissolved inorganic carbon, including carbonate-system modelling", "Particulate organic carbon retained by the selected separation procedure", "Complete dissolved organic matter composition beyond its carbon-related characterisation", "Whole-water ecosystem or catchment models", "Treatment equipment design and operating procedures", "Identity and hazard classification of individual organic compounds" ], "distinguishing_features": [ "The reported quantity concerns organic carbon assigned to an aqueous dissolved fraction; the separation method must accompany that assignment.", "DOC expresses carbon mass rather than the total mass of dissolved organic matter.", "A DOC result must distinguish organic carbon from dissolved inorganic carbon through the analytical procedure.", "DOC and particulate organic carbon are separated operationally; the treatment of colloids depends on the selected procedure.", "DOC is a mixture-level fraction rather than a single chemical substance with a universal molecular formula, purity or set of physical constants." ], "characteristics": [ { "name": "Aqueous matrix", "kind": "category", "unit_or_values": "Freshwater, seawater, groundwater, porewater, wastewater, aqueous extract or other specified matrix", "why_it_matters": "Establishes the environmental or experimental setting and potential analytical interferences." }, { "name": "Dissolved-fraction boundary", "kind": "category", "unit_or_values": "Separation method; filter material and nominal pore size in µm where applicable", "why_it_matters": "Determines what material enters the reported DOC fraction and whether results can be compared." }, { "name": "DOC concentration", "kind": "measurement", "unit_or_values": "mg C/L or µmol C/L, with uncertainty and reporting limit", "why_it_matters": "Quantifies carbon abundance while keeping the carbon-mass basis explicit." }, { "name": "Analytical carbon coverage", "kind": "category", "unit_or_values": "Method-defined DOC coverage, including handling of inorganic and purgeable organic carbon", "why_it_matters": "Reveals which carbon fractions the analytical result includes or may omit." }, { "name": "Sample integrity", "kind": "state", "unit_or_values": "Documented preservation and holding conditions; verified, compromised or unknown integrity", "why_it_matters": "Supports judgment about whether handling altered the fraction before measurement." }, { "name": "Optical character", "kind": "measurement", "unit_or_values": "Specified absorbance or fluorescence measurements, with wavelength, units and normalisation", "why_it_matters": "Provides supporting characterisation without treating optical response as equivalent to total DOC." }, { "name": "Biodegradable fraction", "kind": "measurement", "unit_or_values": "mg C/L or percentage of initial DOC under a specified incubation protocol", "why_it_matters": "Describes biological availability under defined conditions rather than assigning universal lability." }, { "name": "Source attribution", "kind": "relation", "unit_or_values": "Links to candidate sources, supporting observations and attribution confidence", "why_it_matters": "Separates measured DOC from hypotheses about its origin." }, { "name": "DOC flux", "kind": "measurement", "unit_or_values": "g C/day or kg C/day across a specified boundary and interval", "why_it_matters": "Distinguishes transport of carbon from changes in concentration caused by dilution." } ], "affordances": [ "Determine whether a reported result qualifies as DOC under a documented operational definition.", "Compare DOC observations after checking separation methods, analytical coverage, units and sample handling.", "Identify additional analyses needed to assess composition, origin or reactivity.", "Estimate DOC transport when concentration and compatible water-flow observations are available.", "Evaluate observed DOC changes against dilution, transformation and transfer between fractions.", "Assess DOC removal or monitoring options using matrix-specific evidence." ], "agent_conduct": { "may": [ "Measure and report DOC with the filtration method and pore size used.", "Explain DOC trends in water bodies from monitoring data." ], "must_not": [ "Report DOC values without stating the operational method that defines them.", "Alter or omit monitoring results to hide pollution or water treatment problems.", "Present DOC as a measure of safety for drinking water on its own." ], "requires_human": [ "Changing water treatment because of a DOC result." ] }, "ethics": { "considerations": [ "High organic carbon can form harmful by-products when drinking water is disinfected.", "Monitoring data informs public decisions and must be honest." ], "affected_parties": [ "Drinking water consumers", "Aquatic ecosystems", "Water utilities" ] }, "owners": { "steward": "Nobody owns it; water utilities and environmental agencies answer for monitoring.", "master_systems": [ "Environmental agency water quality databases" ] }, "visual_identification": [ "Often shows as brown or tea-coloured water, though colour alone does not measure it." ], "failure_modes_and_hazards": [ "Reacts with chlorine to form disinfection by-products.", "Different methods give results that are not comparable." ], "standards_and_regulation": [ "ISO 8245, Water quality: guidelines for the determination of total organic carbon and dissolved organic carbon, International Organization for Standardization." ], "what_it_is_for": [ "Dissolved organic carbon is measured in rivers, lakes, groundwater, seawater and water treatment systems to characterize organic carbon in the filtered water fraction.", "It supports studies of carbon transport, microbial activity and oxygen consumption during organic matter degradation.", "Water treatment assessments use it to evaluate organic loading and potential treatment challenges, with comparisons requiring compatible filtration and analytical methods." ] }, "sources": [ { "id": "wikidata", "title": "Wikidata item Q449096: dissolved organic carbon", "url": "https://www.wikidata.org/wiki/Q449096", "url_status": "live", "what_it_supports": "identity and sense of the item", "checked_by": "wikidata-api" }, { "id": "wikipedia-en", "title": "Wikipedia: Dissolved organic carbon", "url": "https://en.wikipedia.org/wiki/Dissolved_organic_carbon", "url_status": "live", "what_it_supports": "general description of the item", "checked_by": "wikidata-api sitelink" } ], "structure": { "bundles": [ { "id": "fraction-identity", "name": "Fraction identity", "description": "Defines which organic carbon is assigned to DOC and distinguishes it from neighbouring carbon and organic-matter quantities.", "rationale": "DOC cannot be recognised reliably from its name alone because its dissolved boundary and reporting basis require explicit interpretation.", "layers": [ { "id": "dissolved-boundary", "name": "Dissolved boundary", "description": "Records the separation procedure that establishes membership in the dissolved fraction.", "findings": [ { "id": "operational-membership", "name": "Operational membership", "description": "Identify the procedure used to assign carbon-bearing material to the dissolved fraction, including unresolved colloidal membership.", "questions": [ { "text": "What separation procedure, filter material and nominal pore size define DOC for this observation?", "kind": "definition", "id": "operational-membership-q01" }, { "text": "How does this procedure allocate colloidal organic material between dissolved and retained fractions?", "kind": "boundary", "id": "operational-membership-q02" } ] } ] }, { "id": "carbon-basis", "name": "Carbon basis", "description": "Distinguishes DOC from total dissolved organic matter and other carbon fractions.", "findings": [ { "id": "quantity-distinction", "name": "Quantity distinction", "description": "Require an explicit carbon basis and a clear relationship to inorganic, particulate and total organic carbon measurements.", "questions": [ { "text": "Does the reported value express organic carbon mass, total organic matter mass or a proxy signal?", "kind": "definition", "id": "quantity-distinction-q01" }, { "text": "How are dissolved inorganic carbon and particulate organic carbon excluded or accounted for?", "kind": "boundary", "id": "quantity-distinction-q02" } ] } ] } ] }, { "id": "measurement-validity", "name": "Measurement validity", "description": "Connects a DOC result to its sample history, analytical coverage and uncertainty.", "rationale": "An apparent DOC difference may reflect collection, preparation or analytical differences rather than a change in the water.", "layers": [ { "id": "sample-history", "name": "Sample history", "description": "Captures handling steps that may change the amount or composition of the sampled fraction.", "findings": [ { "id": "handling-integrity", "name": "Handling integrity", "description": "Establish whether collection, filtration, storage and preservation support the intended interpretation.", "questions": [ { "text": "When and how were collection, filtration, preservation and analysis performed?", "kind": "provenance", "id": "handling-integrity-q01" }, { "text": "What blanks or handling checks assess contamination, sorption or alteration during storage?", "kind": "measurement", "id": "handling-integrity-q02" } ] } ] }, { "id": "analytical-coverage", "name": "Analytical coverage", "description": "Defines what the carbon analysis measures and how confidently it does so.", "findings": [ { "id": "result-interpretability", "name": "Result interpretability", "description": "Associate concentration with the analytical method, carbon-fraction coverage and quality evidence.", "questions": [ { "text": "Which analytical method was used, and how does it handle inorganic carbon and purgeable organic carbon?", "kind": "measurement", "id": "result-interpretability-q01" }, { "text": "What calibration, recovery, replicate precision, reporting limit and uncertainty support the reported concentration?", "kind": "measurement", "id": "result-interpretability-q02" }, { "text": "Which differences in preparation or analytical coverage prevent direct comparison with another DOC result?", "kind": "boundary", "id": "result-interpretability-q03" } ] } ] } ] }, { "id": "composition-and-reactivity", "name": "Composition and reactivity", "description": "Characterises properties of the DOC mixture that concentration alone cannot establish.", "rationale": "Equal DOC concentrations need not imply equal optical behaviour, biological availability or response to treatment.", "layers": [ { "id": "mixture-characterisation", "name": "Mixture characterisation", "description": "Links compositional and optical observations to the portion of DOC they actually characterise.", "findings": [ { "id": "characterisation-coverage", "name": "Characterisation coverage", "description": "Distinguish whole-fraction carbon measurements from selective signals or recovered subfractions.", "questions": [ { "text": "Which optical, molecular or fractionation measurements characterise this DOC, and what portion of the mixture do they represent?", "kind": "measurement", "id": "characterisation-coverage-q01" }, { "text": "What evidence supports interpreting these signals as composition indicators in this aqueous matrix?", "kind": "boundary", "id": "characterisation-coverage-q02" } ] } ] }, { "id": "conditional-reactivity", "name": "Conditional reactivity", "description": "Records biological and photochemical responses under specified conditions.", "findings": [ { "id": "reactivity-evidence", "name": "Reactivity evidence", "description": "Treat lability and persistence as conclusions tied to a test, timescale and environment.", "questions": [ { "text": "What DOC change was measured under specified incubation or irradiation conditions, duration and controls?", "kind": "measurement", "id": "reactivity-evidence-q01" }, { "text": "How far can the observed response be applied to the intended environment or decision timescale?", "kind": "action", "id": "reactivity-evidence-q02" } ] } ] } ] }, { "id": "origin-transport-and-decisions", "name": "Origin, transport and decisions", "description": "Relates DOC observations to source hypotheses, movement, transformations and interventions.", "rationale": "An agent needs evidence connecting DOC measurements to processes before attributing a change or choosing an action.", "layers": [ { "id": "sources-and-movement", "name": "Sources and movement", "description": "Connects source attribution and carbon transport to observations at defined spatial and temporal boundaries.", "findings": [ { "id": "source-and-flux-evidence", "name": "Source and flux evidence", "description": "Keep source hypotheses distinct from measured concentrations and quantify transport only with compatible hydrological evidence.", "questions": [ { "text": "Which candidate sources are supported by tracers, endmember observations or other evidence, and which remain unresolved?", "kind": "provenance", "id": "source-and-flux-evidence-q01" }, { "text": "Are water-flow and DOC measurements sufficiently aligned in time and space to estimate carbon flux across the chosen boundary?", "kind": "measurement", "id": "source-and-flux-evidence-q02" } ] } ] }, { "id": "change-and-intervention", "name": "Change and intervention", "description": "Supports interpretation of DOC changes and evaluation of monitoring or removal actions.", "findings": [ { "id": "change-attribution", "name": "Change attribution", "description": "Require evidence to distinguish dilution, mineralisation, production and transfer to other fractions.", "questions": [ { "text": "What accompanying observations distinguish dilution from DOC transformation or transfer to particulate or sorbed material?", "kind": "measurement", "id": "change-attribution-q01" }, { "text": "Where did carbon leaving the measured DOC fraction go, and is that fate measured or inferred?", "kind": "boundary", "id": "change-attribution-q02" } ] }, { "id": "decision-specific-evidence", "name": "Decision-specific evidence", "description": "Tie monitoring and treatment judgments to a stated objective and evidence beyond bulk concentration where needed.", "questions": [ { "text": "What matrix-specific evidence shows that a proposed action changes DOC in a way relevant to the stated objective?", "kind": "action", "id": "decision-specific-evidence-q01" }, { "text": "Which additional measurements are needed before using DOC as an indicator of treatment performance, oxygen demand or disinfection by-product formation potential?", "kind": "action", "id": "decision-specific-evidence-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-confidence-notes", "name": "Check these first", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "DOC is a heterogeneous analytical fraction with no single molecular formula, CAS number, melting point or universal hazard classification.", "Concentration ranges are approximate context values, not regulatory limits; verify them for the particular water body.", "Confirm the applicable method edition, filtration cutoff, preservation procedure and treatment of volatile organic carbon before comparing measurements." ], "questions": [ { "id": "evidence-confidence-notes-q01", "text": "Which of these check these first hold for the sense of dissolved organic carbon 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": [ "Biodegradable dissolved organic carbon", "Refractory dissolved organic carbon", "Autochthonous DOC, produced within the water body", "Allochthonous DOC, supplied from outside the water body" ], "questions": [ { "id": "evidence-kinds-q01", "text": "Which of these kinds and varieties hold for the sense of dissolved organic carbon this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-standards-and-regulation", "name": "Standards and regulation", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "APHA, AWWA and WEF Standard Methods for the Examination of Water and Wastewater, Method 5310: total organic carbon measurement; dissolved-fraction analysis requires appropriate sample filtration.", "CEN EN 1484: water analysis guidelines for determining total organic carbon and dissolved organic carbon." ], "questions": [ { "id": "evidence-standards-and-regulation-q01", "text": "Which of these standards and regulation hold for the sense of dissolved organic carbon 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": [ "Quantifying organic carbon transport and storage in aquatic carbon cycles.", "Assessing organic matter removal during drinking-water and wastewater treatment.", "Evaluating potential precursors of disinfection by-products.", "Studying microbial carbon availability and aquatic food webs.", "Interpreting metal complexation and organic contaminant transport." ], "questions": [ { "id": "evidence-real-world-use-q01", "text": "Which of these real-world use hold for the sense of dissolved organic carbon 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": "DOC concentration in open-ocean seawater", "typical_range": "Approximately 0.4-1; depth and location affect concentrations", "unit": "mg C/L" }, { "quantity": "DOC concentration in many rivers and lakes", "typical_range": "Approximately 1-20; organic-rich waters can exceed this substantially", "unit": "mg C/L" } ], "questions": [ { "id": "evidence-measurements-q01", "text": "Which of these typical measurements hold for the sense of dissolved organic carbon 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": [ "Filter pore size, material and handling affect the measured fraction; some colloids pass through filters.", "Contamination, microbial activity and unsuitable storage can change DOC concentrations before analysis.", "Incomplete oxidation or inadequate correction for inorganic carbon can bias measurements; purging may remove volatile organic carbon.", "Some DOC components form disinfection by-products during water treatment.", "DOC concentration alone does not establish toxicity, biodegradability or chemical composition." ], "questions": [ { "id": "evidence-failure-modes-and-hazards-q01", "text": "Which of these failure modes and hazards hold for the sense of dissolved organic carbon this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-regional-variation", "name": "Regional variation", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "Peatland and wetland catchments often supply more DOC than catchments with little organic soil.", "Rainfall, snowmelt, drought and seasonal biological activity affect DOC concentration and composition.", "Laboratory filtration and reporting conventions can differ, complicating comparisons between monitoring programmes." ], "questions": [ { "id": "evidence-regional-variation-q01", "text": "Which of these regional variation hold for the sense of dissolved organic carbon 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": "Dissolved organic matter", "difference": "Dissolved organic matter includes the entire organic material, whereas DOC measures only its carbon content." }, { "name": "Total organic carbon", "difference": "Total organic carbon includes dissolved and particulate organic carbon in the sample; DOC is the operationally filtered fraction." }, { "name": "Particulate organic carbon", "difference": "Particulate organic carbon is retained by the specified filter, whereas DOC passes through it." }, { "name": "Dissolved inorganic carbon", "difference": "Dissolved inorganic carbon comprises inorganic carbon species such as dissolved carbon dioxide, bicarbonate and carbonate." } ], "questions": [ { "id": "evidence-neighbours-q01", "text": "Which of these neighbouring kinds and how to tell them apart hold for the sense of dissolved organic carbon this model covers, and on what evidence?", "kind": "provenance" } ] } ] } ] } ] }, "openQuestions": [ "Which operational definitions and analytical standards should be supported for the intended matrices, particularly their handling of colloids and purgeable organic carbon?", "How should aqueous extracts of soils or solids be related to environmental DOC without implying that extraction reproduces an in situ dissolved pool?", "Which compositional or optical indicators have sufficiently validated relationships to DOC behaviour in each intended matrix?", "What evidence and timescale are required before describing a DOC fraction as biodegradable, persistent or effectively removed?", "Which existing Vercy models cover dissolved organic matter, other carbon fractions and aquatic carbon cycling, and where should this model link to them?" ], "statistics": { "bundles": 5, "layers": 9, "findings": 17, "questions": 27 } }