# Vercy AI instruction - YAML 1.2 (JSON-compatible) { "vercy": "1.0-draft", "publication": { "status": "published", "adjudicationStatus": "reviewable-draft", "publishableCanonical": false, "generatedAt": "2026-10-06T22:49:37Z", "synthesisSha256": "11fd89e40ef99b7ce65c4f8b06bf57c843b1f9ac48466f4f5b089c261fec9580", "providerMode": "single-provider-waiver", "providers": [ "Codex" ], "waivedProviders": [ "Claude", "Grok" ] }, "metaModel": { "id": "WM-PLC-003", "registryId": "vr.wm-plc-003", "name": "Water Body", "version": "0.3.0-reviewable-draft", "previousVersions": [], "entryKind": "entity", "family": "World Models", "category": "Physical world and living systems", "industry": [ "Cross-industry" ], "domain": [ "PHY.PLC.WAT" ], "tags": [ "water", "body", "phy.plc.wat" ], "status": "published" }, "canonicalUrl": "https://ver.cy/models/wm-plc-003-water-body/", "sourceUrl": "https://github.com/ver-cy/world-models/tree/feat/mega-model-registry/research/runs/wm-plc-003", "model": { "registry_id": "vr.wm-plc-003", "model_id": "WM-PLC-003", "name": "Water Body", "entry_kind": "entity", "purpose": "Describe one identified body or reach of water and its time-qualified geometry, hydrological relationships, regime and quality evidence.", "scope_statement": "The root is a persistent water-body entity, including a surface feature or delineated groundwater volume. Different mapping or management realizations are explicitly linked, not assumed identical. The structure is a proposed reviewable research draft; it does not operate water infrastructure, classify official status or issue warnings.", "in_scope": [ "Identity, physical extent, properties, continuity and hydrological links", "Body-specific observation bindings, groundwater context, levels, regime estimates and water balance", "Sample and assessment references, evidence lineage, stewardship and exchange requirements" ], "out_of_scope": [ "Aquifer rock, catchment terrain, stations, sensors, samples and generic observation masters", "Water ownership or use-right adjudication, supply and treatment, permits and operating dams or pumps", "Official hazard warnings, executable hydrodynamic forecasts and automatic regulatory classifications" ], "boundary_notes": [ { "neighbor": "WM-PLC-001 Terrain / Landform", "distinction": "Catchment and elevation surfaces remain external representations; record their lineage and body-specific links.", "source_refs": [ "SRC-001" ] }, { "neighbor": "WM-EAR-004 Geology / Mineral Resource", "distinction": "Aquifer host material and geological-unit properties remain external; this root describes water and its qualified host links.", "source_refs": [ "SRC-002", "SRC-008" ] }, { "neighbor": "WM-MAT-008 Observation / Measurement Record", "distinction": "Generic observation identity, procedure and result lifecycle are referenced; this model adds water-body support and interpretation.", "source_refs": [ "SRC-003", "SRC-004", "SRC-007" ] }, { "neighbor": "WM-DAT-010 Time Series / Observation Collection", "distinction": "Time-series storage, generic aggregation lifecycle and delivery mechanics remain external.", "source_refs": [ "SRC-003" ] }, { "neighbor": "WM-FLW-002 Water Supply", "distinction": "Abstraction rights, treatment, distribution and supply operations are external; record only body context and reported balance terms.", "source_refs": [ "SRC-006", "SRC-008" ] }, { "neighbor": "WM-EAR-005 Natural Hazard", "distinction": "Hazard occurrence and official warning authority remain external; this model links threshold and regime evidence.", "source_refs": [ "SRC-010" ] }, { "neighbor": "WM-BLT-003 Infrastructure Network", "distinction": "Dams, canals and control structures are external assets; a canal water body is distinct from its engineered channel.", "source_refs": [ "SRC-001", "SRC-004" ] }, { "neighbor": "WM-LIV-006 Ecosystem / Biome", "distinction": "Biotic communities and ecosystem lifecycle remain external; only assessment references concerning this body are admitted.", "source_refs": [ "SRC-008" ] }, { "neighbor": "WM-EAR-001 Weather", "distinction": "Weather observations and prediction systems remain external inputs to period balances.", "source_refs": [ "SRC-006" ] }, { "neighbor": "WM-EAR-003 Soil", "distinction": "Soil and infiltration properties remain external input evidence, not local soil records.", "source_refs": [ "SRC-006" ] }, { "neighbor": "WM-FLW-006 Emission", "distinction": "Discharge and environmental flux records are referenced as evidence; no emission permitting or control operations.", "source_refs": [ "SRC-006", "SRC-008" ] } ] }, "sources": [ { "id": "SRC-001", "title": "Surface Hydrology Features (HY_Features) - Conceptual Model", "organization": "Open Geospatial Consortium", "url": "https://docs.ogc.org/is/14-111r6/14-111r6.html", "version_or_date": "1.0; 14-111r6; 2018-01-08", "source_type": "standard", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T22:48:28Z", "relevance": "Sections 7.3 and 7.4: feature identity, catchment realizations, network, water bodies and strata. Conceptual alignment only." }, { "id": "SRC-002", "title": "WaterML 2 Part 4 - GroundWaterML 2", "organization": "Open Geospatial Consortium", "url": "https://docs.ogc.org/is/16-032r2/16-032r2.html", "version_or_date": "2.2; 16-032r2; 2017", "source_type": "standard", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T22:48:28Z", "relevance": "Sections 7.6.18-7.6.20 distinguish fluid bodies, hydrogeological units, surfaces and properties. Groundwater is not its geological host." }, { "id": "SRC-003", "title": "WaterML standards catalogue", "organization": "Open Geospatial Consortium", "url": "https://www.ogc.org/standards/waterml/", "version_or_date": "Catalogue read 2026-10-07; Part 1 listed as 2.0.1, 10-126r4", "source_type": "first-party-doc", "primary_source": true, "authority_tier": 2, "accessed_at": "2026-10-06T22:48:28Z", "relevance": "Catalogue and overview support observation and time-series exchange alignment. Full Part 1 conformance requirements were not reviewed." }, { "id": "SRC-004", "title": "WaterML 2.0 Part 2 - Ratings, Gaugings and Sections", "organization": "Open Geospatial Consortium", "url": "https://docs.ogc.org/is/15-018r2/15-018r2.html", "version_or_date": "1.0; 15-018r2; 2016-02-03", "source_type": "standard", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T22:48:28Z", "relevance": "Scope and definitions distinguish stage, discharge, monitoring point, gauging, rating conversions and surveyed sections." }, { "id": "SRC-005", "title": "CO-OPS Data Retrieval API", "organization": "National Oceanic and Atmospheric Administration", "url": "https://api.tidesandcurrents.noaa.gov/api/dev", "version_or_date": "Unversioned documentation read 2026-10-07", "source_type": "first-party-doc", "primary_source": true, "authority_tier": 2, "accessed_at": "2026-10-06T22:48:28Z", "relevance": "Products, datum, units, time zone and depth-bin sections distinguish preliminary, verified and prediction products. US service example only." }, { "id": "SRC-006", "title": "Water-budget methods", "organization": "U.S. Geological Survey", "url": "https://www.usgs.gov/publications/water-budget-methods", "version_or_date": "2010; DOI 10.1017/CBO9780511780745.003", "source_type": "scientific", "primary_source": true, "authority_tier": 2, "accessed_at": "2026-10-06T22:48:28Z", "relevance": "Official indexed abstract describes control-volume accounting, storage change and residual estimates. Full chapter was not accessed; no detailed algorithm admitted." }, { "id": "SRC-007", "title": "Water Quality Portal User Guide", "organization": "National Water Quality Monitoring Council", "url": "https://www.waterqualitydata.us/portal_userguide/", "version_or_date": "Unversioned guide read 2026-10-07", "source_type": "first-party-doc", "primary_source": true, "authority_tier": 2, "accessed_at": "2026-10-06T22:48:28Z", "relevance": "Activity, result and detection-quantitation metadata tables support sample and result identity, methods, depth, censoring and limit units. No universal water-quality threshold implied." }, { "id": "SRC-008", "title": "Directive 2000/60/EC - Water Framework Directive", "organization": "European Union", "url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32000L0060", "version_or_date": "Original act dated 2000-10-23; not a verified current consolidation", "source_type": "legislation", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T22:48:28Z", "relevance": "Article 2 and selected Annex V text distinguish surface and groundwater bodies, aquifers, status and potential. EU profile example; tabular material and current amendments remain unverified." }, { "id": "SRC-009", "title": "PROV-O: The PROV Ontology", "organization": "World Wide Web Consortium", "url": "https://www.w3.org/TR/prov-o/", "version_or_date": "W3C Recommendation 2013-04-30", "source_type": "ontology", "primary_source": true, "authority_tier": 1, "accessed_at": "2026-10-06T22:48:28Z", "relevance": "Entity, activity, agent, derivation, attribution and revision support evidence lineage. Access, authority and retention are local proposed policies, not PROV requirements." }, { "id": "SRC-010", "title": "Floods and Recurrence Intervals", "organization": "U.S. Geological Survey", "url": "https://www.usgs.gov/water-science-school/science/floods-and-recurrence-intervals", "version_or_date": "Water Science School page read 2026-10-07", "source_type": "public-authority", "primary_source": true, "authority_tier": 2, "accessed_at": "2026-10-06T22:48:28Z", "relevance": "Annual exceedance probability and estimate uncertainty support qualified regime summaries. Return period is not a schedule or an operational warning." } ], "structure": { "bundles": [ { "id": "b-identity", "name": "Identity and continuity", "description": "Persistent body identity and its classification through revision.", "rationale": "Separate persistent body identity and its classification through revision. Each local grouping is a proposed research structure, not a prescribed standard hierarchy.", "source_refs": [ "SRC-001", "SRC-002", "SRC-008", "SRC-009" ], "layers": [ { "id": "l-identity", "name": "Body identity and reference frame context", "description": "One identified body or reach of surface water, or delineated groundwater volume. Names, map representations and regulatory reporting units are separately qualified; a dry interval need not terminate identity.", "source_refs": [ "SRC-001", "SRC-002", "SRC-008" ], "findings": [ { "id": "f-identity", "name": "Body identity and reference frame", "description": "One identified body or reach of surface water, or delineated groundwater volume. Names, map representations and regulatory reporting units are separately qualified; a dry interval need not terminate identity.", "source_refs": [ "SRC-001", "SRC-002", "SRC-008" ], "questions": [ { "id": "f-identity-q01", "kind": "identity", "text": "Which authoritative identifier, namespace and aliases identify this water body?", "answer_data": [ "bodyIdentifier", "namespace", "aliases", "authorityReference" ] }, { "id": "f-identity-q02", "kind": "classification", "text": "Which feature class and delineation purpose apply, including natural or artificial origin?", "answer_data": [ "classCode", "classificationSchemeVersion", "origin", "delineationPurpose" ] }, { "id": "f-identity-q03", "kind": "definition", "text": "Does this record describe water, a channel or aquifer host, or a regulatory reporting unit?", "answer_data": [ "subjectDefinition", "hostReferences", "reportingUnitMappings", "mappingLimits" ] } ], "data_elements": [ { "id": "f-identity-data01", "name": "Body identifier", "value_kind": "identifier", "description": "Stable body identifier qualified by its issuing namespace; never derived solely from mutable geometry.", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-008" ] }, { "id": "f-identity-data02", "name": "Class and mapping", "value_kind": "object", "description": "Class scheme, version, origin and mapping between physical feature and reporting unit; not automatic equivalence.", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-008" ] } ], "artifacts": [ { "id": "f-identity-artifact", "name": "Body identity statement", "description": "Versioned evidence for body identity and reference frame. Carries source and body references, effective extent, reviewer state and uncertainty; does not acquire the identity of its subject.", "media_or_form": [ "Structured record", "Human-readable evidence report" ], "serial": true, "identity_strategy": "Use authoritative master-system record identifier first; otherwise a namespaced local stable identifier. Body ID plus artifact role and revision distinguishes repeated records; a content digest verifies bytes, not identity.", "source_refs": [ "SRC-001", "SRC-002", "SRC-008" ] } ], "inline_only_rationale": null } ] }, { "id": "l-continuity", "name": "Delineation and identity continuity context", "description": "Geometry correction, physical change, reclassification, split, merge and retirement have different meanings. Record explicit lineage without assuming that all course changes preserve identity.", "source_refs": [ "SRC-001", "SRC-009" ], "findings": [ { "id": "f-continuity", "name": "Delineation and identity continuity", "description": "Geometry correction, physical change, reclassification, split, merge and retirement have different meanings. Record explicit lineage without assuming that all course changes preserve identity.", "source_refs": [ "SRC-001", "SRC-009" ], "questions": [ { "id": "f-continuity-q01", "kind": "lifecycle", "text": "Is this change a representation correction, physical change, split, merge or retirement?", "answer_data": [ "changeKind", "reason", "predecessorReferences", "successorReferences" ] }, { "id": "f-continuity-q02", "kind": "temporal", "text": "When was the change effective, observed and entered into the register?", "answer_data": [ "effectiveInterval", "observationTime", "recordedTime", "timePrecision" ] }, { "id": "f-continuity-q03", "kind": "authority", "text": "Who approved the continuity decision and which contested interpretations remain?", "answer_data": [ "reviewerRole", "approvalEvidence", "competingAssertions", "reviewStatus" ] } ], "data_elements": [ { "id": "f-continuity-data01", "name": "Change assertion", "value_kind": "object", "description": "Typed change with effective and recorded time and a reason.", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-001", "SRC-009" ] }, { "id": "f-continuity-data02", "name": "Lineage references", "value_kind": "reference", "description": "Prior and successor body identities, not destructive ID replacement.", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-009" ] } ], "artifacts": [ { "id": "f-continuity-artifact", "name": "Delineation revision record", "description": "Versioned evidence for delineation and identity continuity. Carries source and body references, effective extent, reviewer state and uncertainty; does not acquire the identity of its subject.", "media_or_form": [ "Structured record", "Human-readable evidence report" ], "serial": true, "identity_strategy": "Use authoritative master-system record identifier first; otherwise a namespaced local stable identifier. Body ID plus artifact role and revision distinguishes repeated records; a content digest verifies bytes, not identity.", "source_refs": [ "SRC-001", "SRC-009" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "b-spatial", "name": "Extent and hydrological relationships", "description": "Spatial realizations, network context and subsurface boundaries.", "rationale": "Separate spatial realizations, network context and subsurface boundaries. Each local grouping is a proposed research structure, not a prescribed standard hierarchy.", "source_refs": [ "SRC-001", "SRC-002", "SRC-004", "SRC-005" ], "layers": [ { "id": "l-extent", "name": "Geometry and physical properties context", "description": "Geometry, area, depth, volume, section and stratum are time- and method-dependent assertions. Preserve horizontal and vertical reference systems, scale and uncertainty. Sea and wetland profiles need an explicit segmentation purpose.", "source_refs": [ "SRC-001", "SRC-002", "SRC-004", "SRC-005" ], "findings": [ { "id": "f-extent", "name": "Geometry and physical properties", "description": "Geometry, area, depth, volume, section and stratum are time- and method-dependent assertions. Preserve horizontal and vertical reference systems, scale and uncertainty. Sea and wetland profiles need an explicit segmentation purpose.", "source_refs": [ "SRC-001", "SRC-002", "SRC-004", "SRC-005" ], "questions": [ { "id": "f-extent-q01", "kind": "spatial", "text": "Which geometry, coordinate reference system, vertical datum and scale describe this representation?", "answer_data": [ "geometryReference", "horizontalCRS", "verticalDatum", "scale", "validInterval" ] }, { "id": "f-extent-q02", "kind": "measurement", "text": "Which area, depth, volume or stratum properties were observed and under what conditions?", "answer_data": [ "propertyCode", "value", "unit", "method", "uncertainty", "conditions", "observationTime" ] }, { "id": "f-extent-q03", "kind": "evidence", "text": "What survey, imagery or other evidence supports the extent and its limits of recognition?", "answer_data": [ "evidenceReferences", "surveyMethod", "resolution", "dryOrIceConditions", "limitations" ] } ], "data_elements": [ { "id": "f-extent-data01", "name": "Extent realization", "value_kind": "geometry", "description": "Geometry with CRS and effective interval; not an immutable identity key.", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-004", "SRC-005" ] }, { "id": "f-extent-data02", "name": "Physical property assertions", "value_kind": "collection", "description": "Value, unit, method, datum where relevant, observation time, uncertainty and conditions; unknown is not zero.", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-004", "SRC-005" ] } ], "artifacts": [ { "id": "f-extent-artifact", "name": "Extent and property survey", "description": "Versioned evidence for geometry and physical properties. Carries source and body references, effective extent, reviewer state and uncertainty; does not acquire the identity of its subject.", "media_or_form": [ "Structured record", "Human-readable evidence report" ], "serial": true, "identity_strategy": "Use authoritative master-system record identifier first; otherwise a namespaced local stable identifier. Body ID plus artifact role and revision distinguishes repeated records; a content digest verifies bytes, not identity.", "source_refs": [ "SRC-001", "SRC-002", "SRC-004", "SRC-005" ] } ], "inline_only_rationale": null } ] }, { "id": "l-network", "name": "Catchment and network context context", "description": "Keep catchment, outlet, channel and connected-body references separate. Proposed local links allow multiple or unknown neighbors; distinguish nominal topology from time-dependent flow, including tidal or managed reversals.", "source_refs": [ "SRC-001", "SRC-002", "SRC-005" ], "findings": [ { "id": "f-network", "name": "Catchment and network context", "description": "Keep catchment, outlet, channel and connected-body references separate. Proposed local links allow multiple or unknown neighbors; distinguish nominal topology from time-dependent flow, including tidal or managed reversals.", "source_refs": [ "SRC-001", "SRC-002", "SRC-005" ], "questions": [ { "id": "f-network-q01", "kind": "relationship", "text": "Which catchments, outlets, channels and neighboring bodies are linked at the declared scale?", "answer_data": [ "catchmentReferences", "outletReferences", "channelReferences", "neighborReferences", "scale" ] }, { "id": "f-network-q02", "kind": "state", "text": "Is the recorded direction nominal, observed, reversible, interrupted or unknown?", "answer_data": [ "directionState", "effectiveInterval", "observationEvidence", "controlStructureReference" ] }, { "id": "f-network-q03", "kind": "constraint", "text": "Which lineage and boundary rules prevent double counting across nested or overlapping realizations?", "answer_data": [ "realizationIdentifiers", "nestingRule", "overlapRule", "mappingEvidence" ] } ], "data_elements": [ { "id": "f-network-data01", "name": "Hydrological links", "value_kind": "collection", "description": "Typed, versioned links with source and target IDs, role, scale, interval and uncertainty; no universal n:1 rule.", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-005" ] }, { "id": "f-network-data02", "name": "Catchment realization", "value_kind": "reference", "description": "External delineation and outlet evidence; catchment is not equated with water-body geometry.", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-001", "SRC-002", "SRC-005" ] } ], "artifacts": [ { "id": "f-network-artifact", "name": "Connectivity assertion set", "description": "Versioned evidence for catchment and network context. Carries source and body references, effective extent, reviewer state and uncertainty; does not acquire the identity of its subject.", "media_or_form": [ "Structured record", "Human-readable evidence report" ], "serial": true, "identity_strategy": "Use authoritative master-system record identifier first; otherwise a namespaced local stable identifier. Body ID plus artifact role and revision distinguishes repeated records; a content digest verifies bytes, not identity.", "source_refs": [ "SRC-001", "SRC-002", "SRC-005" ] } ], "inline_only_rationale": null } ] }, { "id": "l-groundwater", "name": "Groundwater body and host context", "description": "Describe the groundwater volume and reference its hydrogeological hosts. Host confinement and storage parameters must carry their host and method; neither aquifer rock nor management-area boundary is the body itself.", "source_refs": [ "SRC-002", "SRC-008" ], "findings": [ { "id": "f-groundwater", "name": "Groundwater body and host", "description": "Describe the groundwater volume and reference its hydrogeological hosts. Host confinement and storage parameters must carry their host and method; neither aquifer rock nor management-area boundary is the body itself.", "source_refs": [ "SRC-002", "SRC-008" ], "questions": [ { "id": "f-groundwater-q01", "kind": "composition", "text": "Which hydrogeological units and void or host representations contain this groundwater body?", "answer_data": [ "hostUnitReferences", "containmentEvidence", "bodyParts", "mappingScale" ] }, { "id": "f-groundwater-q02", "kind": "spatial", "text": "Which water-table or potentiometric surfaces delimit the body and for which times?", "answer_data": [ "surfaceType", "surfaceGeometryReference", "verticalDatum", "observationInterval", "uncertainty" ] }, { "id": "f-groundwater-q03", "kind": "measurement", "text": "Which recharge or exchange estimates characterize this body without transferring host properties to the water?", "answer_data": [ "exchangeEstimateReference", "quantity", "unit", "period", "method", "hostParameterReferences" ] } ], "data_elements": [ { "id": "f-groundwater-data01", "name": "Host links", "value_kind": "reference", "description": "Hydrogeological unit IDs mastered externally; link assertions preserve their scope.", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-002", "SRC-008" ] }, { "id": "f-groundwater-data02", "name": "Groundwater characterization", "value_kind": "object", "description": "Body surfaces, period-qualified recharge and exchange evidence; geotechnical property records remain external.", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-002", "SRC-008" ] } ], "artifacts": [ { "id": "f-groundwater-artifact", "name": "Groundwater boundary assessment", "description": "Versioned evidence for groundwater body and host. Carries source and body references, effective extent, reviewer state and uncertainty; does not acquire the identity of its subject.", "media_or_form": [ "Structured record", "Human-readable evidence report" ], "serial": true, "identity_strategy": "Use authoritative master-system record identifier first; otherwise a namespaced local stable identifier. Body ID plus artifact role and revision distinguishes repeated records; a content digest verifies bytes, not identity.", "source_refs": [ "SRC-002", "SRC-008" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "b-observations", "name": "Observation and recognition", "description": "Body-specific bindings for observations, conversions and coastal records.", "rationale": "Separate body-specific bindings for observations, conversions and coastal records. Each local grouping is a proposed research structure, not a prescribed standard hierarchy.", "source_refs": [ "SRC-003", "SRC-004", "SRC-005", "SRC-007", "SRC-009" ], "layers": [ { "id": "l-observations", "name": "Observation binding and quality context", "description": "Link observations to the body and the actual sampling feature, monitoring location or remote footprint. Generic observation and station lifecycles remain external. Preserve provisional, validated, missing, modeled and measured distinctions.", "source_refs": [ "SRC-003", "SRC-004", "SRC-007", "SRC-009" ], "findings": [ { "id": "f-observations", "name": "Observation binding and quality", "description": "Link observations to the body and the actual sampling feature, monitoring location or remote footprint. Generic observation and station lifecycles remain external. Preserve provisional, validated, missing, modeled and measured distinctions.", "source_refs": [ "SRC-003", "SRC-004", "SRC-007", "SRC-009" ], "questions": [ { "id": "f-observations-q01", "kind": "measurement", "text": "What phenomenon, result, unit, procedure and spatial support does the observation represent?", "answer_data": [ "observationReference", "observedProperty", "value", "unit", "procedureReference", "spatialSupport" ] }, { "id": "f-observations-q02", "kind": "quality", "text": "Which quality flags, uncertainty, missing-value reasons and validation state accompany the result?", "answer_data": [ "qualityCodes", "uncertainty", "missingReason", "validationState", "reviewEvidence" ] }, { "id": "f-observations-q03", "kind": "temporal", "text": "What are the phenomenon interval, result time, ingestion time and feed freshness?", "answer_data": [ "phenomenonInterval", "resultTime", "ingestedAt", "latency", "freshnessLimit" ] } ], "data_elements": [ { "id": "f-observations-data01", "name": "Observation references", "value_kind": "reference", "description": "Body-to-observation bindings with sampling support; stationless and remote observations allowed.", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-003", "SRC-004", "SRC-007", "SRC-009" ] }, { "id": "f-observations-data02", "name": "Quality context", "value_kind": "object", "description": "Source flags, uncertainty, time precision, missing reasons and validation provenance; never silently upgraded.", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-003", "SRC-004", "SRC-007", "SRC-009" ] } ], "artifacts": [ { "id": "f-observations-artifact", "name": "Observation binding register", "description": "Versioned evidence for observation binding and quality. Carries source and body references, effective extent, reviewer state and uncertainty; does not acquire the identity of its subject.", "media_or_form": [ "Structured record", "Human-readable evidence report" ], "serial": true, "identity_strategy": "Use authoritative master-system record identifier first; otherwise a namespaced local stable identifier. Body ID plus artifact role and revision distinguishes repeated records; a content digest verifies bytes, not identity.", "source_refs": [ "SRC-003", "SRC-004", "SRC-007", "SRC-009" ] } ], "inline_only_rationale": null } ] }, { "id": "l-rating", "name": "Stage and discharge conversion context", "description": "A stage value is not discharge. Link locally used rating versions, gaugings and sections with applicability intervals and declared limitations; conversion algorithms and station calibration execution remain external.", "source_refs": [ "SRC-004" ], "findings": [ { "id": "f-rating", "name": "Stage and discharge conversion", "description": "A stage value is not discharge. Link locally used rating versions, gaugings and sections with applicability intervals and declared limitations; conversion algorithms and station calibration execution remain external.", "source_refs": [ "SRC-004" ], "questions": [ { "id": "f-rating-q01", "kind": "provenance", "text": "Which rating version, gaugings and section evidence support the reported discharge?", "answer_data": [ "ratingReference", "gaugingReferences", "sectionReference", "derivationReference" ] }, { "id": "f-rating-q02", "kind": "constraint", "text": "Does the observation fall within the rating time interval, valid range and stated conditions?", "answer_data": [ "ratingInterval", "inputRange", "conditions", "extrapolationFlag", "applicabilityDecision" ] }, { "id": "f-rating-q03", "kind": "exception", "text": "How are backwater, altered controls, ice or unavailable ratings represented without inventing discharge?", "answer_data": [ "exceptionCode", "uncertainty", "reviewState", "missingDerivedResultReason" ] } ], "data_elements": [ { "id": "f-rating-data01", "name": "Rating binding", "value_kind": "reference", "description": "Pinned externally mastered rating and section versions.", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-004" ] }, { "id": "f-rating-data02", "name": "Conversion applicability", "value_kind": "object", "description": "Input and output units, valid interval and range, exception and extrapolation state; no unqualified inferred value.", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-004" ] } ], "artifacts": [ { "id": "f-rating-artifact", "name": "Rating applicability record", "description": "Versioned evidence for stage and discharge conversion. Carries source and body references, effective extent, reviewer state and uncertainty; does not acquire the identity of its subject.", "media_or_form": [ "Structured record", "Human-readable evidence report" ], "serial": true, "identity_strategy": "Use authoritative master-system record identifier first; otherwise a namespaced local stable identifier. Body ID plus artifact role and revision distinguishes repeated records; a content digest verifies bytes, not identity.", "source_refs": [ "SRC-004" ] } ], "inline_only_rationale": null } ] }, { "id": "l-coastal", "name": "Coastal level and profile context context", "description": "Represent tidal and coastal level or current observations with local datum, time basis and depth support. Measured values, harmonic predictions and model guidance remain distinct.", "source_refs": [ "SRC-005" ], "findings": [ { "id": "f-coastal", "name": "Coastal level and profile context", "description": "Represent tidal and coastal level or current observations with local datum, time basis and depth support. Measured values, harmonic predictions and model guidance remain distinct.", "source_refs": [ "SRC-005" ], "questions": [ { "id": "f-coastal-q01", "kind": "measurement", "text": "Which local datum, station, depth or bin and units qualify the coastal value?", "answer_data": [ "stationReference", "datum", "datumEpochIfKnown", "depthOrBin", "units", "value" ] }, { "id": "f-coastal-q02", "kind": "classification", "text": "Is the product an observation, prediction or model guidance, and what processing state applies?", "answer_data": [ "productType", "processingState", "sourceProductReference", "issueTime" ] }, { "id": "f-coastal-q03", "kind": "interoperability", "text": "Which time-zone and datum transformations were applied and what prevents unsupported comparisons?", "answer_data": [ "sourceTimeBasis", "timeTransform", "datumTransformReference", "uncertainty", "comparisonLimit" ] } ], "data_elements": [ { "id": "f-coastal-data01", "name": "Coastal product binding", "value_kind": "object", "description": "Product type, observation or prediction status, station, depth support and source.", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-005" ] }, { "id": "f-coastal-data02", "name": "Reference-frame transformation", "value_kind": "object", "description": "Original and target datum/time basis, documented transformation and limitations; no implicit offset.", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-005" ] } ], "artifacts": [ { "id": "f-coastal-artifact", "name": "Coastal reference-frame record", "description": "Versioned evidence for coastal level and profile context. Carries source and body references, effective extent, reviewer state and uncertainty; does not acquire the identity of its subject.", "media_or_form": [ "Structured record", "Human-readable evidence report" ], "serial": true, "identity_strategy": "Use authoritative master-system record identifier first; otherwise a namespaced local stable identifier. Body ID plus artifact role and revision distinguishes repeated records; a content digest verifies bytes, not identity.", "source_refs": [ "SRC-005" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "b-regime", "name": "Regime and estimated balance", "description": "Period-bounded water accounting and qualified regime summaries.", "rationale": "Separate period-bounded water accounting and qualified regime summaries. Each local grouping is a proposed research structure, not a prescribed standard hierarchy.", "source_refs": [ "SRC-006", "SRC-010", "SRC-009" ], "layers": [ { "id": "l-balance", "name": "Control-volume water balance context", "description": "Keep the selected body or linked catchment control volume explicit. Record inputs, outputs, storage change and unresolved terms over compatible periods; a residual is an estimate, not automatically measured recharge.", "source_refs": [ "SRC-006", "SRC-009" ], "findings": [ { "id": "f-balance", "name": "Control-volume water balance", "description": "Keep the selected body or linked catchment control volume explicit. Record inputs, outputs, storage change and unresolved terms over compatible periods; a residual is an estimate, not automatically measured recharge.", "source_refs": [ "SRC-006", "SRC-009" ], "questions": [ { "id": "f-balance-q01", "kind": "definition", "text": "Which control volume, accounting period and sign convention define this balance?", "answer_data": [ "controlVolumeReference", "period", "signConvention", "boundaryAssumptions" ] }, { "id": "f-balance-q02", "kind": "measurement", "text": "Which inflow, outflow, storage and exchange terms are measured, estimated or missing?", "answer_data": [ "termValues", "units", "termMethods", "uncertainties", "missingTerms" ] }, { "id": "f-balance-q03", "kind": "validation", "text": "What residual and uncertainty remain after compatible units and periods are reconciled?", "answer_data": [ "residual", "uncertaintyMethodReference", "compatibilityChecks", "unresolvedTerms" ] } ], "data_elements": [ { "id": "f-balance-data01", "name": "Balance terms", "value_kind": "collection", "description": "Term role, value, unit, integration period, evidence and estimation state.", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-006", "SRC-009" ] }, { "id": "f-balance-data02", "name": "Balance assessment", "value_kind": "object", "description": "Control volume, assumptions, residual and uncertainty with double-counting exclusions.", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-006", "SRC-009" ] } ], "artifacts": [ { "id": "f-balance-artifact", "name": "Period water-balance assessment", "description": "Versioned evidence for control-volume water balance. Carries source and body references, effective extent, reviewer state and uncertainty; does not acquire the identity of its subject.", "media_or_form": [ "Structured record", "Human-readable evidence report" ], "serial": true, "identity_strategy": "Use authoritative master-system record identifier first; otherwise a namespaced local stable identifier. Body ID plus artifact role and revision distinguishes repeated records; a content digest verifies bytes, not identity.", "source_refs": [ "SRC-006", "SRC-009" ] } ], "inline_only_rationale": null } ] }, { "id": "l-regime", "name": "Regime summaries and extreme estimates context", "description": "Summaries carry reference period, sample coverage, method and uncertainty. A flood return-period estimate expresses probability under assumptions, not the date of the next event. Detailed low-flow and nonstationary methods need further profiling.", "source_refs": [ "SRC-010", "SRC-003", "SRC-009" ], "findings": [ { "id": "f-regime", "name": "Regime summaries and extreme estimates", "description": "Summaries carry reference period, sample coverage, method and uncertainty. A flood return-period estimate expresses probability under assumptions, not the date of the next event. Detailed low-flow and nonstationary methods need further profiling.", "source_refs": [ "SRC-010", "SRC-003", "SRC-009" ], "questions": [ { "id": "f-regime-q01", "kind": "temporal", "text": "Which reference period, sampling gaps and aggregation method support the seasonal or flow summary?", "answer_data": [ "referencePeriod", "coverage", "gapTreatment", "aggregationMethod", "summaryValues" ] }, { "id": "f-regime-q02", "kind": "quality", "text": "What exceedance probability, fitted method, record length and uncertainty qualify the extreme estimate?", "answer_data": [ "probability", "methodReference", "recordLength", "uncertainty", "stationarityAssumptions" ] }, { "id": "f-regime-q03", "kind": "event", "text": "Which threshold comparison or hazard record is linked and who owns any official warning?", "answer_data": [ "thresholdReference", "comparisonTime", "hazardReference", "warningAuthorityReference", "advisoryStatus" ] } ], "data_elements": [ { "id": "f-regime-data01", "name": "Regime estimate", "value_kind": "object", "description": "Summary or probability estimate with period, evidence and assumptions.", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-010", "SRC-003", "SRC-009" ] }, { "id": "f-regime-data02", "name": "Hazard context", "value_kind": "reference", "description": "External flood or drought occurrence and warning records; local threshold evidence does not issue a warning.", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-010", "SRC-003", "SRC-009" ] } ], "artifacts": [ { "id": "f-regime-artifact", "name": "Regime and uncertainty report", "description": "Versioned evidence for regime summaries and extreme estimates. Carries source and body references, effective extent, reviewer state and uncertainty; does not acquire the identity of its subject.", "media_or_form": [ "Structured record", "Human-readable evidence report" ], "serial": true, "identity_strategy": "Use authoritative master-system record identifier first; otherwise a namespaced local stable identifier. Body ID plus artifact role and revision distinguishes repeated records; a content digest verifies bytes, not identity.", "source_refs": [ "SRC-010", "SRC-003", "SRC-009" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "b-quality", "name": "Water quality and assessment", "description": "Sample context and qualified body-level assessments.", "rationale": "Separate sample context and qualified body-level assessments. Each local grouping is a proposed research structure, not a prescribed standard hierarchy.", "source_refs": [ "SRC-007", "SRC-008", "SRC-002" ], "layers": [ { "id": "l-sample", "name": "Sample and analytical evidence context", "description": "Body-specific result links preserve activity, sample medium, depth, analyte, fraction, method, unit and detection or quantitation information. A nondetect is not numerical zero and a point sample is not automatically body-wide.", "source_refs": [ "SRC-007", "SRC-002" ], "findings": [ { "id": "f-sample", "name": "Sample and analytical evidence", "description": "Body-specific result links preserve activity, sample medium, depth, analyte, fraction, method, unit and detection or quantitation information. A nondetect is not numerical zero and a point sample is not automatically body-wide.", "source_refs": [ "SRC-007", "SRC-002" ], "questions": [ { "id": "f-sample-q01", "kind": "provenance", "text": "Which sampling activity, location, medium, depth and analysis method produced this result?", "answer_data": [ "activityIdentifier", "sampleReference", "locationReference", "medium", "depth", "methodReference" ] }, { "id": "f-sample-q02", "kind": "measurement", "text": "Which characteristic, fraction, value or censoring qualifier, unit and detection limits were reported?", "answer_data": [ "characteristic", "fraction", "resultValue", "qualifier", "unit", "limitType", "limitValue", "limitUnit" ] }, { "id": "f-sample-q03", "kind": "quality", "text": "What quality controls and representativeness limits constrain use of this result for the body?", "answer_data": [ "qualityEvidence", "representativeness", "reanalysisReference", "reviewState", "excludedUses" ] } ], "data_elements": [ { "id": "f-sample-data01", "name": "Analytical result link", "value_kind": "reference", "description": "Pinned external sample and result IDs, including organization namespace.", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-007", "SRC-002" ] }, { "id": "f-sample-data02", "name": "Interpretation context", "value_kind": "object", "description": "Censoring, detection and quantitation limits, units, fraction, method and body-level inference limits.", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-007", "SRC-002" ] } ], "artifacts": [ { "id": "f-sample-artifact", "name": "Sample result interpretation", "description": "Versioned evidence for sample and analytical evidence. Carries source and body references, effective extent, reviewer state and uncertainty; does not acquire the identity of its subject.", "media_or_form": [ "Structured record", "Human-readable evidence report" ], "serial": true, "identity_strategy": "Use authoritative master-system record identifier first; otherwise a namespaced local stable identifier. Body ID plus artifact role and revision distinguishes repeated records; a content digest verifies bytes, not identity.", "source_refs": [ "SRC-007", "SRC-002" ] } ], "inline_only_rationale": null } ] }, { "id": "l-status", "name": "Profile-specific status assessment context", "description": "Record an attributed assessment with authority, jurisdiction, body category and cycle. EU ecological status or potential, chemical status and groundwater quantitative status are distinct profile concepts, not a universal good-water flag.", "source_refs": [ "SRC-008", "SRC-007" ], "findings": [ { "id": "f-status", "name": "Profile-specific status assessment", "description": "Record an attributed assessment with authority, jurisdiction, body category and cycle. EU ecological status or potential, chemical status and groundwater quantitative status are distinct profile concepts, not a universal good-water flag.", "source_refs": [ "SRC-008", "SRC-007" ], "questions": [ { "id": "f-status-q01", "kind": "classification", "text": "Which assessment scheme, body category, metric and version define the reported status or potential?", "answer_data": [ "schemeVersion", "jurisdiction", "bodyCategory", "metric", "classCode" ] }, { "id": "f-status-q02", "kind": "evidence", "text": "Which observations, biological indicators, reference conditions and coverage gaps support the assessment?", "answer_data": [ "evidenceReferences", "indicatorSet", "referenceConditions", "coverageGaps", "assessmentInterval" ] }, { "id": "f-status-q03", "kind": "authority", "text": "Who issued the assessment and what effective cycle, review or appeal qualification applies?", "answer_data": [ "issuerReference", "authorityBasis", "cycle", "effectiveInterval", "reviewStatus" ] } ], "data_elements": [ { "id": "f-status-data01", "name": "Status assertion", "value_kind": "object", "description": "Attributed class with scheme, version, metric, cycle and authority; unknown or unassessed is preserved.", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-008", "SRC-007" ] }, { "id": "f-status-data02", "name": "Assessment evidence", "value_kind": "reference", "description": "Evidence and official assessment references, separate from laboratory results and water-use permission.", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-008", "SRC-007" ] } ], "artifacts": [ { "id": "f-status-artifact", "name": "Body status assessment reference", "description": "Versioned evidence for profile-specific status assessment. Carries source and body references, effective extent, reviewer state and uncertainty; does not acquire the identity of its subject.", "media_or_form": [ "Structured record", "Human-readable evidence report" ], "serial": true, "identity_strategy": "Use authoritative master-system record identifier first; otherwise a namespaced local stable identifier. Body ID plus artifact role and revision distinguishes repeated records; a content digest verifies bytes, not identity.", "source_refs": [ "SRC-008", "SRC-007" ] } ], "inline_only_rationale": null } ] } ] }, { "id": "b-stewardship", "name": "Stewardship and exchange", "description": "Evidence accountability and controlled local representation.", "rationale": "Separate evidence accountability and controlled local representation. Each local grouping is a proposed research structure, not a prescribed standard hierarchy.", "source_refs": [ "SRC-009", "SRC-001", "SRC-003", "SRC-008" ], "layers": [ { "id": "l-authority", "name": "Stewardship, rights and access context context", "description": "Record roles for maintaining the data separately from ownership or use rights over water. Disclosure and retention are proposed local policy requirements; neither a source standard nor a registry link grants authority.", "source_refs": [ "SRC-009", "SRC-008" ], "findings": [ { "id": "f-authority", "name": "Stewardship, rights and access context", "description": "Record roles for maintaining the data separately from ownership or use rights over water. Disclosure and retention are proposed local policy requirements; neither a source standard nor a registry link grants authority.", "source_refs": [ "SRC-009", "SRC-008" ], "questions": [ { "id": "f-authority-q01", "kind": "ownership", "text": "Which role maintains the data and which separately evidenced rights or jurisdiction claims concern the water?", "answer_data": [ "dataStewardRole", "rightsRecordReferences", "jurisdictionClaims", "disputes" ] }, { "id": "f-authority-q02", "kind": "access", "text": "Which artifact or location details require restricted or generalized views under the adopting policy?", "answer_data": [ "policyReference", "accessScope", "sensitivityReason", "generalizationRule", "recipientPurpose" ] }, { "id": "f-authority-q03", "kind": "retention", "text": "Which retention periods, holds and disposition authority govern local records and restricted payloads?", "answer_data": [ "retentionPolicy", "holdReferences", "dispositionAuthority", "tombstoneRule", "payloadScope" ] } ], "data_elements": [ { "id": "f-authority-data01", "name": "Stewardship context", "value_kind": "object", "description": "Role references, policy versions and contested authority; no corporate owner default.", "cardinality": "0..1", "required": false, "source_refs": [ "SRC-009", "SRC-008" ] }, { "id": "f-authority-data02", "name": "Access and retention bindings", "value_kind": "reference", "description": "Adopting Dimension policies govern enforcement; body semantics do not implement identity or access engines.", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-009", "SRC-008" ] } ], "artifacts": [ { "id": "f-authority-artifact", "name": "Stewardship policy binding", "description": "Versioned evidence for stewardship, rights and access context. Carries source and body references, effective extent, reviewer state and uncertainty; does not acquire the identity of its subject.", "media_or_form": [ "Structured record", "Human-readable evidence report" ], "serial": true, "identity_strategy": "Use authoritative master-system record identifier first; otherwise a namespaced local stable identifier. Body ID plus artifact role and revision distinguishes repeated records; a content digest verifies bytes, not identity.", "source_refs": [ "SRC-009", "SRC-008" ] } ], "inline_only_rationale": null } ] }, { "id": "l-lineage", "name": "Evidence lineage and exchange context", "description": "Trace local assertions to source entities, derivations and responsible roles. Standard mappings are candidate crosswalks until tested; stable references and explicit information loss take priority over matching labels.", "source_refs": [ "SRC-009", "SRC-001", "SRC-002", "SRC-003" ], "findings": [ { "id": "f-lineage", "name": "Evidence lineage and exchange", "description": "Trace local assertions to source entities, derivations and responsible roles. Standard mappings are candidate crosswalks until tested; stable references and explicit information loss take priority over matching labels.", "source_refs": [ "SRC-009", "SRC-001", "SRC-002", "SRC-003" ], "questions": [ { "id": "f-lineage-q01", "kind": "provenance", "text": "Which source revision, activity and responsible role support each derived assertion?", "answer_data": [ "sourceRevision", "derivationActivity", "responsibleRole", "recordedTime", "integrityDigest" ] }, { "id": "f-lineage-q02", "kind": "interoperability", "text": "Which pinned exchange profile and code mappings preserve body identity, units and unknown values?", "answer_data": [ "profileVersion", "identifierMapping", "unitMapping", "codeMapping", "unknownEncoding" ] }, { "id": "f-lineage-q03", "kind": "validation", "text": "Which round-trip losses, unresolved references and conformance tests remain before exchange?", "answer_data": [ "mappingLosses", "unresolvedReferences", "testEvidence", "conformanceState" ] } ], "data_elements": [ { "id": "f-lineage-data01", "name": "Assertion lineage", "value_kind": "collection", "description": "Source entity, activity, role, revision and digest; provenance is not proof of accuracy.", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-009", "SRC-001", "SRC-002", "SRC-003" ] }, { "id": "f-lineage-data02", "name": "Mapping profile", "value_kind": "reference", "description": "Versioned external exchange schema and local crosswalk; no wildcard conformance assertion.", "cardinality": "0..n", "required": false, "source_refs": [ "SRC-009", "SRC-001", "SRC-002", "SRC-003" ] } ], "artifacts": [ { "id": "f-lineage-artifact", "name": "Lineage and mapping register", "description": "Versioned evidence for evidence lineage and exchange. Carries source and body references, effective extent, reviewer state and uncertainty; does not acquire the identity of its subject.", "media_or_form": [ "Structured record", "Human-readable evidence report" ], "serial": true, "identity_strategy": "Use authoritative master-system record identifier first; otherwise a namespaced local stable identifier. Body ID plus artifact role and revision distinguishes repeated records; a content digest verifies bytes, not identity.", "source_refs": [ "SRC-009", "SRC-001", "SRC-002", "SRC-003" ] } ], "inline_only_rationale": null } ] } ] } ] }, "functions": [ { "id": "fn-register", "name": "Register body assertion", "description": "Proposed, unimplemented local operation. Record a proposed body identity and classification without conferring water rights.", "inputs": [ "namespace-qualified ID", "class and delineation evidence" ], "outputs": [ "draft body assertion", "duplicate or ambiguity refusal" ], "preconditions": [ "Steward role and namespace authority established", "Duplicate and reporting-unit mappings reviewed" ], "effects": [ "Append local assertion; do not create external master records" ], "source_refs": [ "SRC-001", "SRC-002", "SRC-009" ] }, { "id": "fn-revise", "name": "Propose delineation revision", "description": "Proposed, unimplemented local operation. Preserve explicit lineage for geometry change, split or merge.", "inputs": [ "current revision", "change reason and evidence", "effective interval" ], "outputs": [ "proposed successor revision", "conflict report" ], "preconditions": [ "Expected revision matches", "Continuity authority and prior references resolved" ], "effects": [ "Append a proposal and preserve predecessors; no official redelineation" ], "source_refs": [ "SRC-001", "SRC-009" ] }, { "id": "fn-bind", "name": "Bind observation evidence", "description": "Proposed, unimplemented local operation. Link a result to its water-body support and preserve source quality.", "inputs": [ "body reference", "observation reference", "spatial and temporal support" ], "outputs": [ "qualified evidence link", "missing-support refusal" ], "preconditions": [ "Read access to source evidence", "Units, time basis and source status available or explicitly unknown" ], "effects": [ "Append local link; never upgrade provisional source status" ], "source_refs": [ "SRC-003", "SRC-004", "SRC-005", "SRC-007" ] }, { "id": "fn-balance", "name": "Record balance assessment", "description": "Proposed, unimplemented local operation. Store a reviewed control-volume calculation with its unresolved residual.", "inputs": [ "body or catchment control volume", "terms and periods", "calculation evidence" ], "outputs": [ "balance assessment", "incompatible-term rejection" ], "preconditions": [ "Compatible units and periods", "Method and uncertainty supplied by qualified reviewer" ], "effects": [ "Record supplied calculation and lineage; no abstraction or recharge authorization" ], "source_refs": [ "SRC-006", "SRC-009" ] }, { "id": "fn-assessment", "name": "Attach attributed status", "description": "Proposed, unimplemented local operation. Associate a profile-qualified external assessment without making an official determination.", "inputs": [ "assessment reference", "scheme and cycle", "issuer evidence" ], "outputs": [ "status assertion link", "unverified-authority flag" ], "preconditions": [ "Metric and body category are compatible", "Issuer and scheme version are retained" ], "effects": [ "Append qualified assertion; no status certification or automatic warning" ], "source_refs": [ "SRC-008", "SRC-009" ] }, { "id": "fn-project", "name": "Prepare scoped exchange view", "description": "Proposed, unimplemented local operation. Prepare a local projection with declared mapping losses and source status.", "inputs": [ "authorized recipient scope", "pinned mapping", "selected revision" ], "outputs": [ "scoped projection", "loss and restriction report" ], "preconditions": [ "Access and retention policy resolved", "Sensitive geometry generalization approved", "Required source licenses reviewed" ], "effects": [ "Generate local artifact only; no external transmission" ], "source_refs": [ "SRC-001", "SRC-002", "SRC-003", "SRC-009" ] } ], "composition": [ { "target": "WM-PLC-001 Terrain / Landform", "relation": "REFERENCE", "purpose": "Catchment and elevation surfaces remain external representations; record their lineage and body-specific links. Candidate binding requires a pinned target version before implementation.", "required": false, "source_refs": [ "SRC-001" ] }, { "target": "WM-EAR-004 Geology / Mineral Resource", "relation": "REFERENCE", "purpose": "Aquifer host material and geological-unit properties remain external; this root describes water and its qualified host links. Candidate binding requires a pinned target version before implementation.", "required": false, "source_refs": [ "SRC-002", "SRC-008" ] }, { "target": "WM-MAT-008 Observation / Measurement Record", "relation": "REFERENCE", "purpose": "Generic observation identity, procedure and result lifecycle are referenced; this model adds water-body support and interpretation. Candidate binding requires a pinned target version before implementation.", "required": false, "source_refs": [ "SRC-003", "SRC-004", "SRC-007" ] }, { "target": "WM-DAT-010 Time Series / Observation Collection", "relation": "REFERENCE", "purpose": "Time-series storage, generic aggregation lifecycle and delivery mechanics remain external. Candidate binding requires a pinned target version before implementation.", "required": false, "source_refs": [ "SRC-003" ] }, { "target": "WM-FLW-002 Water Supply", "relation": "REFERENCE", "purpose": "Abstraction rights, treatment, distribution and supply operations are external; record only body context and reported balance terms. Candidate binding requires a pinned target version before implementation.", "required": false, "source_refs": [ "SRC-006", "SRC-008" ] }, { "target": "WM-EAR-005 Natural Hazard", "relation": "REFERENCE", "purpose": "Hazard occurrence and official warning authority remain external; this model links threshold and regime evidence. Candidate binding requires a pinned target version before implementation.", "required": false, "source_refs": [ "SRC-010" ] }, { "target": "WM-BLT-003 Infrastructure Network", "relation": "REFERENCE", "purpose": "Dams, canals and control structures are external assets; a canal water body is distinct from its engineered channel. Candidate binding requires a pinned target version before implementation.", "required": false, "source_refs": [ "SRC-001", "SRC-004" ] }, { "target": "WM-LIV-006 Ecosystem / Biome", "relation": "REFERENCE", "purpose": "Biotic communities and ecosystem lifecycle remain external; only assessment references concerning this body are admitted. Candidate binding requires a pinned target version before implementation.", "required": false, "source_refs": [ "SRC-008" ] }, { "target": "WM-EAR-001 Weather", "relation": "REFERENCE", "purpose": "Weather observations and prediction systems remain external inputs to period balances. Candidate binding requires a pinned target version before implementation.", "required": false, "source_refs": [ "SRC-006" ] }, { "target": "WM-EAR-003 Soil", "relation": "REFERENCE", "purpose": "Soil and infiltration properties remain external input evidence, not local soil records. Candidate binding requires a pinned target version before implementation.", "required": false, "source_refs": [ "SRC-006" ] }, { "target": "WM-FLW-006 Emission", "relation": "REFERENCE", "purpose": "Discharge and environmental flux records are referenced as evidence; no emission permitting or control operations. Candidate binding requires a pinned target version before implementation.", "required": false, "source_refs": [ "SRC-006", "SRC-008" ] }, { "target": "OGC HY_Features 1.0", "relation": "ALIGN", "purpose": "Conceptual mapping candidate only; selected source concepts do not establish implementation conformance.", "required": false, "source_refs": [ "SRC-001" ] }, { "target": "OGC GroundWaterML 2.2", "relation": "ALIGN", "purpose": "Conceptual mapping candidate only; selected source concepts do not establish implementation conformance.", "required": false, "source_refs": [ "SRC-002" ] }, { "target": "OGC WaterML Part 1 2.0.1 and Part 2 1.0", "relation": "ALIGN", "purpose": "Conceptual mapping candidate only; selected source concepts do not establish implementation conformance.", "required": false, "source_refs": [ "SRC-003", "SRC-004" ] }, { "target": "W3C PROV-O 2013", "relation": "ALIGN", "purpose": "Conceptual mapping candidate only; selected source concepts do not establish implementation conformance.", "required": false, "source_refs": [ "SRC-009" ] } ], "serviceLayers": { "dimension": { "owner_package_requirements": [ "Declare a role-based data steward and namespace authority, separately from water ownership or use rights.", "Pin applicable jurisdiction, hydrological profile, coordinate systems, source licenses and evidence-review policy.", "Provide access, retention, incident, dispute and change-approval policies before instance operations." ], "namespace_guidance": "Use a steward-controlled namespace and stable body IDs. Body, observation, sample, geometry realization and reporting unit need distinct IDs; local IDs carry no dates.", "registry_links": [ "vr.wm-plc-003", "WM-PLC-003", "Legacy alias P3 is migration context only; not a conformance or identity assertion." ] }, "canon_and_patch": { "canonicalization_rules": [ "Retain source units, datum, method, uncertainty, valid time and processing state alongside normalized views.", "Resolve physical feature versus regulatory unit and host versus water before matching; preserve competing assertions." ], "patch_rules": [ "Apply expected-revision checks and append attributed corrections; never silently overwrite observations.", "Record split, merge, reclassification and retirement separately from representation edits." ], "compatibility_rules": [ "Version changes to segmentation, quantities, code meanings or profile rules; preserve resolvable old references.", "A mapping with lost censoring, datum, uncertainty or source quality cannot be declared lossless." ] }, "artifact_rules": { "identity_priority": [ "Authoritative master-system identifier qualified by issuing namespace", "Stable namespaced local identifier when no authoritative identifier exists", "Body reference plus artifact role and revision; digest used for integrity only" ], "timestamp_rule": "Use RFC 3339 timestamps with seconds and explicit UTC offset. Keep effective or phenomenon time, observation/result time and ingestion time distinct. Preserve original date-only or uncertain time precision instead of inventing seconds.", "serial_naming_rule": "Keep artifact identity stable; use revision or sequence metadata for serial surveys, assessments and time slices, with timestamps as metadata rather than entity keys.", "integrity_rule": "Store digest, media type, source revision and attribution where authorized; byte integrity and lineage do not prove truth, license or current legal applicability." }, "policies": [ "These service requirements are proposed local governance rules; cited standards do not establish the adopting authority.", "Keep water ownership, jurisdiction and abstraction-right assertions separate from data stewardship.", "Preserve provisional, censored, missing, modeled and observed states and their interpretation limits in every authorized view.", "Use purpose-limited views for sensitive sampling sites, habitat locations and personal contact details; scope withholding and generalization to an evidenced policy.", "Record hazards at evidence and policy level; operational warnings and physical controls require separate competent systems." ], "crud": { "read": [ "Resolve requested body revision, effective interval and recipient scope; expose stale or restricted evidence flags." ], "create": [ "Require identity namespace and steward role; preserve unverified and contested states as draft assertions." ], "update": [ "Require expected revision, evidence and responsible role; append correction and reassess dependent summaries." ], "delete": [ "Retire erroneous or superseded local assertions with an approved disposition and minimal tombstone where lawful.", "Retention holds block disposal; the adopting Dimension records policy and storage executor own deletion of local payloads, including restricted coordinates or personal details.", "Do not delete referenced master observations or imply that retiring a record removes the physical water body. Historical lineage does not require indefinite restricted-payload retention." ] }, "roles": [ { "name": "Data steward", "responsibilities": [ "Maintain identities and body-specific links under delegated authority." ] }, { "name": "Hydrological reviewer", "responsibilities": [ "Review geometry, datum, measurements and estimate assumptions." ] }, { "name": "Assessment reviewer", "responsibilities": [ "Verify scheme, cycle and issuer of status assertions." ] }, { "name": "Access custodian", "responsibilities": [ "Apply recipient scope and retention policy without changing scientific results." ] }, { "name": "Evidence contributor", "responsibilities": [ "Supply attributed source records and quality flags; cannot certify their own official authority." ] } ], "access": { "default_rule": "Deny writes and sensitive payload disclosure until role, purpose and policy are resolved; allow public views only when explicitly designated.", "scopes": [ "bundle", "layer", "finding", "artifact" ], "exceptions": [ "Emergency or statutory disclosures require recorded authority and a minimum necessary view; this model grants no emergency powers.", "Published provisional data may be shown with clear quality and freshness labels when the source and local policy permit; do not silently omit or certify them." ], "audit_requirements": [ "Record actor role, purpose, source revision, policy decision and changed references through the adopting audit service.", "Log generalized or withheld geometry and derived summaries without duplicating restricted payloads in logs." ] }, "agents_bootstrap": { "filename": "AGENTS.md", "required_fields": [ "Name", "Type", "Specification URL", "Storage type URL", "Interface URL", "Processes URL" ], "read_order": [ "Read AGENTS.md and the adopting Dimension policies.", "Read spec.yaml, review state and every publication hold.", "Resolve body identity, reference frames, evidence revisions and external bindings before operations." ] } }, "coverage": { "claim": "Source-grounded proposed structure for one persistent water-body entity, with qualified surface, groundwater and limited coastal contexts. A separate local no-tools self-audit found no critical conflict. Independent review, source/version verification, specialist profiles and executable conformance remain holds. This is a reviewable draft, not a complete hydrological system or operational certification.", "confidence": "medium", "checklist": [ { "dimension": "identity", "status": "covered", "notes": "Namespace, class, reporting-unit distinction and aliases." }, { "dimension": "lifecycle", "status": "covered", "notes": "Version, split, merge, physical change and retirement assertions." }, { "dimension": "relationships", "status": "covered", "notes": "Catchment, host, network and observation bindings; no fixed single outlet requirement." }, { "dimension": "temporal", "status": "covered", "notes": "Phenomenon, effective, result and ingestion times, precision and assessment periods." }, { "dimension": "provenance", "status": "covered", "notes": "Attribution, derivation, revisions, evidence limitations and integrity." }, { "dimension": "ownership", "status": "covered", "notes": "Data stewardship distinct from rights, jurisdiction and use authority." }, { "dimension": "validation", "status": "gap", "notes": "Research structure validates; nested instance schemas and hydrological fixture tests remain incomplete." }, { "dimension": "access", "status": "covered", "notes": "Purpose-scoped views, sensitive geometry and source-quality preservation." }, { "dimension": "retention and deletion", "status": "covered", "notes": "Local dispositions, holds, payload minimization and external execution ownership." }, { "dimension": "interoperability", "status": "gap", "notes": "Conceptual mappings only; pinned code lists and tested standard mappings remain to be built." }, { "dimension": "physical properties", "status": "covered", "notes": "Geometry, depth, volume, strata, water quality, datum, unit and uncertainty context." }, { "dimension": "recognition", "status": "covered", "notes": "Survey, observation and remote evidence with dry, ice and spatial-support limits." }, { "dimension": "capabilities and behavior", "status": "covered", "notes": "Flow, storage, exchange and regime evidence distinguished from proposed record operations." }, { "dimension": "source verification", "status": "gap", "notes": "Browser readings and indexed evidence are documented; direct HTTP, current versions and full legal tables remain unverified." } ], "known_omissions": [ "No executable nested instance schemas, standard conformance mappings or adversarial fixtures.", "Detailed marine, wetland, cryosphere, karst, low-flow and nonstationary profiles need further specialist evidence.", "Current consolidated law, complete Annex V tables, local rights and indigenous or transboundary governance require qualified review.", "Full WaterML Part 1 and full water-budget chapter were not inspected; only selected catalogue and indexed abstract support admitted.", "Source HTTP status and version verification and independent external review remain open." ], "conflicts": [], "regional_assumptions": [ "EU Directive definitions and assessment distinctions are profile examples, not global law or verified current legal advice.", "US coastal, water-quality and flood documentation supplies examples, not universal thresholds, datum choices or schemas." ], "adversarial_checks": [ "Dry state does not imply deletion; course changes require an explicit identity decision.", "Aquifer host and water volume cannot be deduplicated by shared geometry.", "Branching, unknown and time-dependent connections cannot be forced into a universal n:1 chain.", "Nondetect, missing result and measured zero remain distinct.", "Datum mismatch, stale rating or provisional flag cannot be erased by normalization.", "Return period is not a schedule; local threshold comparisons do not issue official warnings.", "Data steward is not automatically water owner or regulator." ] }, "researchAdjudication": { "providerMode": "single-provider-waiver", "activeProviders": [ "codex" ], "waivedProviders": [ "claude", "grok" ], "providerPolicy": { "contract_version": "1.0.0", "mode": "single-provider-waiver", "effective_at": "2026-09-06T00:00:00Z", "scope": "Canonical single-stream subject-model research after the six-workstream consolidation", "active_providers": [ "codex" ], "waived_providers": [ { "provider": "claude", "authorized_by": "repository owner", "authorized_at": "2026-09-06T00:00:00Z", "reason": "Claude produced no result on prior 1800-second and 900-second attempts and again timed out on bounded 600-second Sonnet and 300-second Haiku passes. The owner prioritized completion over provider availability." }, { "provider": "grok", "authorized_by": "repository owner", "authorized_at": "2026-09-06T00:00:00Z", "reason": "The repository owner authorized completion without Grok when Grok is unavailable, slow or schema-invalid. Grok may still be attempted as a bounded supplemental reviewer, but its failure never blocks a valid Claude plus no-tools result." } ], "review_rule": "Codex may complete source-grounded fallback research after bounded Claude and Grok attempts fail. It requires a separate no-tools adversarial audit and remains reviewable-draft with a visible absence-of-external-review hold.", "supplemental_provider_attempts": [ { "provider": "claude", "required": false, "maximum_attempts": 1, "failure_policy": "record-and-continue", "admission_rule": "Use only a locally schema-valid result whose sources and boundaries survive adjudication." }, { "provider": "grok", "required": false, "maximum_attempts": 1, "failure_policy": "record-and-continue", "admission_rule": "Use only a locally schema-valid result whose sources and boundaries survive adjudication." } ] }, "boundaryDecision": { "entry_kind": "entity", "status": "accepted", "rationale": "The root identifies one body or reach of water, including a delineated groundwater volume, through qualified states and representations. It does not absorb catchment, geological host or observation masters. The registry standalone-mm value classifies the record plane; entity is the subject-model kind." }, "decisions": [ { "concept": "Persistent water-body root", "disposition": "accepted", "rationale": "Identity is independent of mutable geometry or the water parcel present at a moment; reporting units and physical features retain qualified mappings." }, { "concept": "Aquifer and groundwater identity", "disposition": "corrected legacy premise", "rationale": "The admitted groundwater volume references geological host units and their parameters. It does not treat aquifer rock as the water-body root." }, { "concept": "Unconditional continuity", "disposition": "rejected", "rationale": "Dry or seasonal state need not retire a body, but redelineation, split and merge require attributed identity decisions and predecessor references." }, { "concept": "Universal single downstream relationship", "disposition": "rejected", "rationale": "The local candidate links admit multiple or unknown neighbors and distinguish nominal topology from observed direction, interval and engineered control context." }, { "concept": "Catchment and neighbor ownership", "disposition": "qualified", "rationale": "No registry relationship rows are present for this model. The optional links preserve separate terrain, host, supply, observation, ecosystem and hazard masters and need pinned versions." }, { "concept": "Measurement and recognition context", "disposition": "accepted", "rationale": "Extent, observation, rating and coastal findings preserve evidence, scale, datum, units, time, quality and applicability instead of asserting one timeless physical value." }, { "concept": "Missing and censored results", "disposition": "separated", "rationale": "The model preserves quality flags, detection limits and missing reasons. Neither nondetect nor absent observation is silently converted into a measured zero." }, { "concept": "Balance and extreme estimates", "disposition": "qualified", "rationale": "The balance requires an explicit control volume and supplied method evidence. Return-period framing retains probability and uncertainty without becoming a schedule or warning." }, { "concept": "Sample versus official status", "disposition": "separated", "rationale": "Point samples carry representativeness limits. Body assessment requires a scheme, category, cycle and issuer, and EU profile concepts are not universal classifications." }, { "concept": "Local functions and authority", "disposition": "accepted as proposed only", "rationale": "Six local record operations carry inputs, conditions, results and refusals. They neither operate infrastructure nor issue warnings, water rights or official classifications." }, { "concept": "Stewardship, access and retention", "disposition": "accepted with policy dependency", "rationale": "Steward roles are separate from water ownership. Access and disposition are proposed local policies with external execution ownership and lawful minimal tombstones." }, { "concept": "Legacy and supplement conformance claims", "disposition": "not inherited", "rationale": "Legacy wildcard imports, universal cardinalities and unreviewed assertions are reconciled explicitly. Conceptual mappings do not establish conformance or independent source evidence." }, { "concept": "Source coverage and version verification", "disposition": "limited", "rationale": "Selected browser readings and one indexed abstract support bounded concepts. Zero direct HTTP attempts, incomplete legal tables, current versions and complete technical requirements remain disclosed limits." }, { "concept": "Executable coverage and independent review", "disposition": "deferred", "rationale": "Candidate fields do not define executable instance schemas and specialist profiles remain incomplete. The separate Codex self-audit cannot substitute for an independent second provider." } ], "publicationHolds": [ "Independent external review is absent under the owner-authorized single-provider waiver. Claude and Grok were skipped; this separate local Codex no-tools self-audit is not a second-provider review.", "Live source and version verification remains incomplete. Direct HTTP checks were not attempted because the owner reports sandbox blocking: zero attempts, zero measured HTTP 200 responses and null statuses. Browser readings and indexed evidence are documented separately; full WaterML Part 1, the water-budget chapter, complete legal tables and current consolidated law remain unverified. The coordinator must run check_sources.py outside the sandbox and complete substantive version/claim review.", "Jurisdiction, water rights, transboundary and indigenous governance, source licensing, datum and code profiles, official assessment authority and specialist marine, wetland, cryosphere, karst, low-flow and nonstationary cases require qualified review before operational use.", "Nested instance schemas, pinned neighbor bindings, tested exchange mappings, standard conformance and adversarial fixtures remain incomplete. No hydrological solver, warning capability or regulatory compliance certification is implemented.", "Independent external review was explicitly waived by the repository owner; this codex-only result remains a reviewable draft." ], "deferredResearch": [ "Verify direct source responses, actual versions, full technical requirements and current legal texts with complete tables and applicable local authority.", "Build pinned schemas and mappings with fixtures for dry reaches, split/merge, branching and reverse flow, groundwater host mismatch, datum changes, stale ratings, censored samples and authorized disposal.", "Restore independent external review and deepen specialist profiles before any canonical or publishable-draft promotion." ] }, "statistics": { "sources": 10, "bundles": 6, "layers": 14, "findings": 14, "questions": 42, "artifacts": 14, "functions": 6 } }