Public document · July 14, 2026 · This paper governs every report the engine emits. It is versioned; each report bundle records the methodology version it was generated under.
An AquaVein report is a compilation of sourced public records about groundwater conditions relevant to a geographic point, organized, computed, and graded under the fixed rules below. It documents conditions and margins as recorded on the issue date. It is not a prediction that any well will or will not fail, not a hydrogeologic study, and not engineering, legal, or investment advice. Where the data cannot support a statement, the report says so instead of estimating.
| Layer | Source of record | What we take |
|---|---|---|
| Well inventory | State well-completion records | Completed depths, use class, completion dates within the report envelope |
| Water levels | State groundwater-level monitoring network | Full per-station depth-to-water time series |
| Plan criteria | State groundwater sustainability plan data | Adopted minimum thresholds / objectives, converted to depth-below-ground per site |
| Governance | Same source | GSP-managed vs. court-adjudicated vs. other |
| Regional context | Satellite gravimetric monitoring, weekly percentile | Shallow-groundwater percentile vs. long-term climatology, at a regional scale |
| Wells and levels (AZ) | Arizona state well-data layer | Well depth and latest depth-to-water per site |
Every figure in a report carries its layer; every layer carries its source; the bundle's data.json preserves the raw values used.
· Station selection (CA): nearby monitoring stations are evaluated for sufficient measurement history and recency; qualifying stations are reported with distance, station depth, decade medians, and latest dated reading.
· Threshold conversion: the adopted minimum threshold at each qualifying site is converted to a depth-below-ground figure for that site. Reported per site with distance; never averaged across sites.
· Margins (AZ): the margin between well construction depth and latest measured depth to water is computed per site; summarized as a median and as counts of sites with limited or exhausted margin.
· Well statistics: domestic-well completed depths within the report envelope, reported as count and distribution.
· GRACE: single-cell sample at the point; reported with its week; regional context only.
Confidence reflects how much qualifying monitoring history exists near the parcel. HIGH requires a strong local record; MEDIUM requires a moderate one. Below a fixed floor, the result is LOW — FLAGGED, NOT SCORED: data is displayed but no grade is issued, and purchase flows disclose LOW status before payment.
Grade (CA) is ELEVATED RISK when the local adopted minimum threshold sits deeper than the area's typical domestic well, or when nearby long-record stations show a sustained multi-decade decline. It is STABLE / MANAGED when stations are flat-to-improving inside an adjudicated area, and NO ELEVATED SIGNALS otherwise.
Grade (AZ) is ELEVATED RISK when a material share of margin-computable sites hold little remaining margin, or any site sits at or below its own datum; otherwise NO ELEVATED SIGNALS.
The exact radii, measurement-count floors, and numeric cutoffs behind these grades are held as the confidential rubric, not published here. A SHA-256 hash of the current rubric version is available to counsel, lenders, and auditors on request, so the rubric's integrity can be verified without disclosing its contents.
Grades describe documented conditions and direction. The words "will" and "safe" do not appear in grades.
1. Sourced facts only — nothing modeled, nothing estimated, nothing filled in.
2. Aquifer-zone rule — a station reads the zone its screen reaches; station depth accompanies every trend row; deep-well readings are never presented as the level facing shallow domestic wells.
3. Vintage caveat (AZ) — latest-per-site readings span dates; dates ride with values; vintages are never pooled silently.
4. Low data = flagged, never scored — false comfort and false alarm are equal defects.
5. Both directions — stable findings are published with the same prominence as elevated ones.
Every report ships as a .dvnr signed bundle: a manifest binding the SHA-256 of every payload, signed Ed25519 by the issuer key; verification is offline and permanent. Reports are versioned; if a defect is found post-issue, a corrected bundle is issued as rid-r2 with a correction note, the original is preserved unaltered in the archive, and the customer is notified. Methodology changes increment this document's version; a report is always interpreted under the version stamped in its manifest.
Monitoring wells measure their own locations; parcel-scale conditions vary between sites. Screening margins are not well tests — pump setting, screen interval, yield decline, and seasonal drawdown all matter. Rural coverage varies; unmonitored areas produce LOW-confidence outputs by design. GRACE cells blend terrain. Source datasets carry their agencies' own errors; we transmit, cite, and date them — we do not adjudicate them.
