snowpack-elevation-warming-utac 1.0.0__tar.gz

snowpack_elevation_warming_utac-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  push:
+    branches: ["main", "master", "claude/**"]
+  pull_request:
+    branches: ["main", "master"]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint (ruff + mypy)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install dev dependencies
+        run: pip install -e ".[dev]"
+      - name: Run ruff
+        run: ruff check src tests
+      - name: Run mypy
+        run: mypy src
+
+  test:
+    name: Tests (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+      - name: Run pytest with coverage
+        run: pytest --cov=src --cov-report=xml

snowpack_elevation_warming_utac-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,118 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+      - "v*.*.*-rc*"
+      - "v*.*.*-alpha*"
+      - "v*.*.*-beta*"
+
+permissions:
+  contents: write
+  id-token: write   # for PyPI trusted publishing, if configured
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tooling
+        run: python -m pip install --upgrade pip build
+
+      - name: Build sdist and wheel
+        run: python -m build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  test:
+    name: Run test suite
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install package with dev/test extras
+        run: |
+          python -m pip install --upgrade pip
+          if python -c "import tomllib" 2>/dev/null; then :; fi
+          pip install -e ".[dev]" 2>/dev/null || pip install -e ".[test]" 2>/dev/null || pip install -e "."
+          pip install pytest pytest-cov
+
+      - name: Run tests
+        run: pytest -q || pytest -q --no-header
+
+  publish-canary:
+    name: Publish canary (TestPyPI + pre-release)
+    needs: [build, test]
+    if: contains(github.ref_name, '-rc') || contains(github.ref_name, '-alpha') || contains(github.ref_name, '-beta')
+    runs-on: ubuntu-latest
+    environment: testpypi
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          password: ${{ secrets.TEST_PYPI_API_TOKEN }}
+          skip-existing: true
+
+      - name: Create GitHub pre-release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          prerelease: true
+          generate_release_notes: true
+
+  publish-production:
+    name: Publish production (PyPI + release + Zenodo archive)
+    needs: [build, test]
+    if: ${{ !contains(github.ref_name, '-rc') && !contains(github.ref_name, '-alpha') && !contains(github.ref_name, '-beta') }}
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          skip-existing: true
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          prerelease: false
+          generate_release_notes: true
+
+      # NOTE: Zenodo archival of this GitHub Release happens automatically
+      # IF this repo has Zenodo-GitHub integration enabled at
+      # https://zenodo.org/account/settings/github/ (a per-repo, per-owner
+      # OAuth toggle on zenodo.org — cannot be set from a workflow file).
+      # Once enabled, every GitHub Release like this one mints/updates a
+      # Zenodo DOI automatically using the .zenodo.json metadata in this repo.

snowpack_elevation_warming_utac-1.0.0/.gitignore

@@ -0,0 +1,22 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+dist/
+build/
+.venv/
+.uv/
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+
+# Docs
+site/
+
+# Editors
+.vscode/
+.idea/
+*.swp

snowpack_elevation_warming_utac-1.0.0/.pre-commit-config.yaml

@@ -0,0 +1,14 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml

snowpack_elevation_warming_utac-1.0.0/.zenodo.json

@@ -0,0 +1,28 @@
+{
+  "title": "snowpack-elevation-warming-utac — P110: The seasonal snow buffer is eroding",
+  "description": "<p>Pepin et al. 2015's elevation-dependent-warming mechanism review, Matiu et al. 2021's European Alps snow depth trends (1971-2019, 2000+ stations), Notarnicola 2022's global mountain snow cover trends (1982-2020, incl. the Karakoram anomaly and winter/spring divergence), and Mote et al. 2018's western US snowpack decline (since 1915, 1766 sites). Quantifies distributed-buffer-resilience-utac's (P103) unquantified 'snow (seasonal)' buffer category and extends glacier-buffer-utac's (P99) peak-water framing. Deliberately not one-sided. Deliberately has NO UTAC/CREP/AFET bridge. See DISCLAIMER.md. Part of the <strong>GenesisAeon</strong> ecosystem (P110, domain: climate / cryosphere / mountain hydrology).</p>",
+  "creators": [
+    {
+      "name": "Römer, Johann",
+      "affiliation": "Independent Researcher / MOR Research Collective"
+    }
+  ],
+  "license": "MIT",
+  "upload_type": "software",
+  "access_right": "open",
+  "version": "1.0.0",
+  "keywords": [
+    "GenesisAeon",
+    "P110",
+    "climate",
+    "snowpack",
+    "cryosphere",
+    "elevation-dependent-warming",
+    "open-science"
+  ],
+  "communities": [
+    {
+      "identifier": "genesisaeon"
+    }
+  ]
+}

snowpack_elevation_warming_utac-1.0.0/CITATION.cff

@@ -0,0 +1,73 @@
+cff-version: 1.2.0
+message: "If you use this software, please cite it as below."
+type: software
+authors:
+  - family-names: Römer
+    given-names: Johann
+    affiliation: "MOR Research Collective"
+title: "snowpack-elevation-warming-utac"
+version: "1.0.0"
+date-released: "2026-08-17"
+url: "https://github.com/GenesisAeon/snowpack-elevation-warming-utac"
+repository-code: "https://github.com/GenesisAeon/snowpack-elevation-warming-utac"
+license: MIT
+abstract: "The seasonal snow buffer is eroding: Pepin et al. 2015's elevation-dependent-warming mechanism review, Matiu et al. 2021's European Alps snow depth trends (1971-2019), Notarnicola 2022's global mountain snow cover trends (1982-2020, incl. the Karakoram anomaly and winter/spring divergence), and Mote et al. 2018's western US snowpack decline (since 1915). Quantifies distributed-buffer-resilience-utac's (P103) unquantified 'snow (seasonal)' buffer category and extends glacier-buffer-utac's (P99) peak-water framing. Deliberately includes findings that complicate its own headline narrative. Deliberately no UTAC/CREP/AFET bridge. GenesisAeon P110."
+keywords:
+  - GenesisAeon
+  - P110
+  - climate
+  - snowpack
+  - cryosphere
+  - elevation-dependent-warming
+  - open-science
+references:
+  - type: article
+    title: "Elevation-dependent warming in mountain regions of the world"
+    authors:
+      - name: "Pepin, N."
+      - name: "Bradley, R.S."
+      - name: "Diaz, H.F."
+      - name: "Baraer, M."
+      - name: "Caceres, E.B."
+      - name: "Forsythe, N."
+    year: 2015
+    journal: "Nature Climate Change"
+    volume: 5
+    start: 424
+    doi: "10.1038/nclimate2563"
+  - type: article
+    title: "Observed snow depth trends in the European Alps: 1971 to 2019"
+    authors:
+      - name: "Matiu, M."
+      - name: "Crespi, A."
+      - name: "Bertoldi, G."
+      - name: "Carmagnola, C.M."
+      - name: "Marty, C."
+      - name: "Morin, S."
+    year: 2021
+    journal: "The Cryosphere"
+    volume: 15
+    start: 1343
+    doi: "10.5194/tc-15-1343-2021"
+  - type: article
+    title: "Overall negative trends for snow cover extent and duration in global mountain regions over 1982-2020"
+    authors:
+      - name: "Notarnicola, C."
+    year: 2022
+    journal: "Scientific Reports"
+    volume: 12
+    start: 13731
+    doi: "10.1038/s41598-022-16743-w"
+  - type: article
+    title: "Dramatic declines in snowpack in the western US"
+    authors:
+      - name: "Mote, P.W."
+      - name: "Li, S."
+      - name: "Lettenmaier, D.P."
+      - name: "Xiao, M."
+      - name: "Engel, R."
+    year: 2018
+    journal: "npj Climate and Atmospheric Science"
+    volume: 1
+    start: 2
+    doi: "10.1038/s41612-018-0012-1"

snowpack_elevation_warming_utac-1.0.0/DISCLAIMER.md

@@ -0,0 +1,87 @@
+# DISCLAIMER — Real Science, Deliberately Includes a Complication, No Framework Bridge
+
+**Status: Real, independently verified science, including findings
+that complicate the package's own headline narrative. NO UTAC/CREP/
+AFET bridge.**
+
+## What this is
+
+Every citation was checked directly against the paper (DOI lookup or
+publisher page) on 2026-08-16.
+
+- **Pepin, N., Bradley, R.S., Diaz, H.F., Baraer, M., Caceres, E.B.,
+  Forsythe, N., et al. (2015)**, *Nature Climate Change*, 5, 424-430,
+  DOI: 10.1038/nclimate2563 — a real synthesis review of
+  elevation-dependent warming (EDW) mechanisms. Deliberately NOT used
+  to claim a single global warming-amplification rate: the paper
+  itself frames EDW as producing contrasting regional patterns from
+  up to five candidate mechanisms, not one number.
+- **Matiu, M., Crespi, A., Bertoldi, G., Carmagnola, C.M., Marty, C.,
+  Morin, S., et al. (2021)**, *The Cryosphere*, 15, 1343-1382,
+  DOI: 10.5194/tc-15-1343-2021 — a real, large station-network study
+  (2,000+ stations, 800+ used for trend assessment, six Alpine
+  countries, 1971-2019).
+- **Notarnicola, C. (2022)**, *Scientific Reports*, 12, 13731,
+  DOI: 10.1038/s41598-022-16743-w — a real satellite-based global
+  mountain snow cover analysis (1982-2020), deliberately included
+  because it complicates rather than only confirms the "snow is
+  disappearing everywhere" narrative.
+- **Mote, P.W., Li, S., Lettenmaier, D.P., Xiao, M., Engel, R.
+  (2018)**, *npj Climate and Atmospheric Science*, 1, 2,
+  DOI: 10.1038/s41612-018-0012-1 — a real, large western US
+  snow-course/SNOTEL network analysis (1,766 sites, since 1915).
+
+## Why the complications are included on purpose
+
+It would have been easy to build this package from only the
+Alps-wide and western-US decline figures — both real, both show a
+clear, large-sample decline. But Notarnicola (2022) found that
+global-mean decline hides two real internal contradictions: spring
+(MAM) snow cover extent trends *positive* even as winter (DJF)
+declines steeply, and northern High Mountain Asia (Karakoram, Kunlun
+Shan, Pamir) shows a *positive* snow cover extent trend while
+southern High Mountain Asia declines — consistent with the
+independently documented "Karakoram anomaly" in glacier mass balance.
+
+This is not a contradiction to hide; it is the responsible way to
+present the science. A single global percentage would misrepresent
+regions and seasons where the pattern runs the other way. Presenting
+only the confirming Alps/western-US cases while omitting the global
+satellite record's own internal nuance would have been a one-sided
+picture of a genuinely more heterogeneous real literature.
+
+## What this is NOT
+
+- **Not a claim of a single global warming-amplification rate.**
+  Pepin et al. (2015) is a mechanism review, not a global measurement
+  — this package does not invent a number the paper itself does not
+  report.
+- **Not a claim that every mountain range or season is declining.**
+  Karakoram/Kunlun Shan/Pamir and boreal spring are real,
+  independently documented exceptions.
+- **No UTAC/CREP/AFET bridge.** This is a real, standalone
+  cryosphere-climatology topic; the cited papers already provide the
+  relevant quantitative structure without this ecosystem's
+  cross-domain vocabulary.
+
+## References
+
+- Pepin, N., Bradley, R.S., Diaz, H.F., Baraer, M., Caceres, E.B.,
+  Forsythe, N., et al. (2015). *Nature Climate Change*, 5, 424-430.
+  DOI: 10.1038/nclimate2563.
+- Matiu, M., Crespi, A., Bertoldi, G., Carmagnola, C.M., Marty, C.,
+  Morin, S., et al. (2021). *The Cryosphere*, 15, 1343-1382.
+  DOI: 10.5194/tc-15-1343-2021.
+- Notarnicola, C. (2022). *Scientific Reports*, 12, 13731.
+  DOI: 10.1038/s41598-022-16743-w.
+- Mote, P.W., Li, S., Lettenmaier, D.P., Xiao, M., Engel, R. (2018).
+  *npj Climate and Atmospheric Science*, 1, 2.
+  DOI: 10.1038/s41612-018-0012-1.
+
+All verified directly (2026-08-16) via WebSearch/WebFetch against
+publisher pages and DOI records. Originating context: identified
+2026-08-15 as the runner-up candidate during the P109 selection
+research ("snowpack/elevation-dependent warming ... a real structural
+gap, P103's storage_portfolio.py even has an unquantified 'snow
+(seasonal)' placeholder"), formally researched and built 2026-08-16
+alongside P111 at Johann's request.

snowpack_elevation_warming_utac-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JohannRömer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

snowpack_elevation_warming_utac-1.0.0/PKG-INFO

@@ -0,0 +1,116 @@
+Metadata-Version: 2.5
+Name: snowpack-elevation-warming-utac
+Version: 1.0.0
+Summary: The seasonal snow buffer is eroding -- Pepin et al. 2015's elevation-dependent-warming mechanism review, Matiu et al. 2021's European Alps snow depth trends, Notarnicola 2022's global mountain snow cover trends (incl. the Karakoram anomaly), and Mote et al. 2018's western US snowpack decline -- quantifies P103's unquantified 'snow (seasonal)' buffer category, no UTAC/CREP bridge
+Project-URL: Homepage, https://github.com/GenesisAeon/snowpack-elevation-warming-utac
+Project-URL: Repository, https://github.com/GenesisAeon/snowpack-elevation-warming-utac
+Author: Römer, Johann
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.6.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# snowpack-elevation-warming-utac
+
+GenesisAeon Package 110 — the seasonal snow buffer is eroding.
+Quantifies a buffer type that
+[distributed-buffer-resilience-utac](https://github.com/GenesisAeon/distributed-buffer-resilience-utac)
+(P103) names but leaves unquantified: "snow (seasonal)" as one of
+five hydrological buffer types. Also extends
+[glacier-buffer-utac](https://github.com/GenesisAeon/glacier-buffer-utac)
+(P99)'s "peak water" framing to the faster, annually-recurring
+seasonal snowpack. **Deliberately has no UTAC/CREP/AFET bridge** —
+see [DISCLAIMER.md](DISCLAIMER.md).
+
+## Deliberately not one-sided
+
+This package includes a real, important **complication** of the
+"snow is disappearing everywhere, in every season" narrative, not
+just confirmation of it. `is_snow_decline_spatially_universal()`
+returns `False` on purpose — northern High Mountain Asia (Karakoram,
+Kunlun Shan, Pamir) shows a *positive* snow cover extent trend, and
+global spring (MAM) snow cover extent trends positive even as winter
+(DJF) declines steeply.
+
+## What's real here
+
+- **Pepin, Bradley, Diaz, Baraer, Caceres, Forsythe et al. (2015,
+  *Nature Climate Change*)** — a real synthesis review: warming is
+  amplified with elevation in many mountain regions, via up to five
+  candidate mechanisms (snow-albedo feedback, water vapor/latent
+  heat, radiative flux, surface heat loss, aerosols) that produce
+  **contrasting regional patterns**, not one uniform global rate —
+  this package deliberately does not attribute a single global
+  degrees-per-decade figure to this citation, because the paper
+  itself does not report one.
+- **Matiu, Crespi, Bertoldi, Carmagnola, Marty, Morin et al. (2021,
+  *The Cryosphere*)** — a real, large European Alps station network
+  (2,000+ stations, 800+ used for trend assessment, six countries,
+  1971–2019): seasonal mean snow depth declined **-8.4%/decade**,
+  maximum snow depth and snow cover duration each declined
+  **-5.6%/decade**, with southern Alpine regions declining measurably
+  faster than northern ones.
+- **Notarnicola (2022, *Scientific Reports*)** — the honesty check: a
+  real satellite-based global mountain analysis (1982–2020) found
+  overall snow cover extent down **-3.6%±2.7%** and duration down
+  **-15.1±11.6 days**, but winter (DJF) declined steeply
+  (**-11.5%±6.9%**) while spring (MAM) trended **positive**
+  (**+10.0%±5.9%**), and northern High Mountain Asia (Karakoram,
+  Kunlun Shan, Pamir) shows a positive trend — consistent with the
+  independently documented "Karakoram anomaly" in glacier mass
+  balance — while southern High Mountain Asia declines.
+- **Mote, Li, Lettenmaier, Xiao, Engel (2018, *npj Climate and
+  Atmospheric Science*)** — a real, large western US snow-course/
+  SNOTEL network (1,766 sites, since 1915): more than 90% of sites
+  show a decline, about a third of those declines are individually
+  statistically significant, and the average decline is 15–30% since
+  the start of record.
+
+## Quickstart
+
+```bash
+pip install snowpack-elevation-warming-utac
+```
+
+```python
+from snowpack_elevation_warming_utac import (
+    edw_candidate_mechanisms,
+    is_globally_uniform_pattern,
+    ALPINE_SNOW_TREND,
+    is_decline_spatially_uniform,
+    GLOBAL_SNOW_TREND,
+    winter_vs_spring_extent_trend_pct,
+    is_snow_decline_spatially_universal,
+    WEST_US_SNOWPACK_TREND,
+    majority_of_sites_declining,
+)
+
+print(edw_candidate_mechanisms())
+print(is_globally_uniform_pattern())            # False
+print(ALPINE_SNOW_TREND.seasonal_mean_depth_pct_per_decade)  # -8.4
+print(GLOBAL_SNOW_TREND.extent_pct)              # -3.6
+print(winter_vs_spring_extent_trend_pct())       # {"winter_djf": -11.5, "spring_mam": 10.0}
+print(is_snow_decline_spatially_universal())     # False
+print(WEST_US_SNOWPACK_TREND.pct_sites_declining)  # 90
+print(majority_of_sites_declining())             # True
+```
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pre-commit install
+ruff check src tests
+mypy src
+pytest
+```
+
+## Citation
+
+See [CITATION.cff](CITATION.cff) and [.zenodo.json](.zenodo.json).

snowpack_elevation_warming_utac-1.0.0/README.md

@@ -0,0 +1,98 @@
+# snowpack-elevation-warming-utac
+
+GenesisAeon Package 110 — the seasonal snow buffer is eroding.
+Quantifies a buffer type that
+[distributed-buffer-resilience-utac](https://github.com/GenesisAeon/distributed-buffer-resilience-utac)
+(P103) names but leaves unquantified: "snow (seasonal)" as one of
+five hydrological buffer types. Also extends
+[glacier-buffer-utac](https://github.com/GenesisAeon/glacier-buffer-utac)
+(P99)'s "peak water" framing to the faster, annually-recurring
+seasonal snowpack. **Deliberately has no UTAC/CREP/AFET bridge** —
+see [DISCLAIMER.md](DISCLAIMER.md).
+
+## Deliberately not one-sided
+
+This package includes a real, important **complication** of the
+"snow is disappearing everywhere, in every season" narrative, not
+just confirmation of it. `is_snow_decline_spatially_universal()`
+returns `False` on purpose — northern High Mountain Asia (Karakoram,
+Kunlun Shan, Pamir) shows a *positive* snow cover extent trend, and
+global spring (MAM) snow cover extent trends positive even as winter
+(DJF) declines steeply.
+
+## What's real here
+
+- **Pepin, Bradley, Diaz, Baraer, Caceres, Forsythe et al. (2015,
+  *Nature Climate Change*)** — a real synthesis review: warming is
+  amplified with elevation in many mountain regions, via up to five
+  candidate mechanisms (snow-albedo feedback, water vapor/latent
+  heat, radiative flux, surface heat loss, aerosols) that produce
+  **contrasting regional patterns**, not one uniform global rate —
+  this package deliberately does not attribute a single global
+  degrees-per-decade figure to this citation, because the paper
+  itself does not report one.
+- **Matiu, Crespi, Bertoldi, Carmagnola, Marty, Morin et al. (2021,
+  *The Cryosphere*)** — a real, large European Alps station network
+  (2,000+ stations, 800+ used for trend assessment, six countries,
+  1971–2019): seasonal mean snow depth declined **-8.4%/decade**,
+  maximum snow depth and snow cover duration each declined
+  **-5.6%/decade**, with southern Alpine regions declining measurably
+  faster than northern ones.
+- **Notarnicola (2022, *Scientific Reports*)** — the honesty check: a
+  real satellite-based global mountain analysis (1982–2020) found
+  overall snow cover extent down **-3.6%±2.7%** and duration down
+  **-15.1±11.6 days**, but winter (DJF) declined steeply
+  (**-11.5%±6.9%**) while spring (MAM) trended **positive**
+  (**+10.0%±5.9%**), and northern High Mountain Asia (Karakoram,
+  Kunlun Shan, Pamir) shows a positive trend — consistent with the
+  independently documented "Karakoram anomaly" in glacier mass
+  balance — while southern High Mountain Asia declines.
+- **Mote, Li, Lettenmaier, Xiao, Engel (2018, *npj Climate and
+  Atmospheric Science*)** — a real, large western US snow-course/
+  SNOTEL network (1,766 sites, since 1915): more than 90% of sites
+  show a decline, about a third of those declines are individually
+  statistically significant, and the average decline is 15–30% since
+  the start of record.
+
+## Quickstart
+
+```bash
+pip install snowpack-elevation-warming-utac
+```
+
+```python
+from snowpack_elevation_warming_utac import (
+    edw_candidate_mechanisms,
+    is_globally_uniform_pattern,
+    ALPINE_SNOW_TREND,
+    is_decline_spatially_uniform,
+    GLOBAL_SNOW_TREND,
+    winter_vs_spring_extent_trend_pct,
+    is_snow_decline_spatially_universal,
+    WEST_US_SNOWPACK_TREND,
+    majority_of_sites_declining,
+)
+
+print(edw_candidate_mechanisms())
+print(is_globally_uniform_pattern())            # False
+print(ALPINE_SNOW_TREND.seasonal_mean_depth_pct_per_decade)  # -8.4
+print(GLOBAL_SNOW_TREND.extent_pct)              # -3.6
+print(winter_vs_spring_extent_trend_pct())       # {"winter_djf": -11.5, "spring_mam": 10.0}
+print(is_snow_decline_spatially_universal())     # False
+print(WEST_US_SNOWPACK_TREND.pct_sites_declining)  # 90
+print(majority_of_sites_declining())             # True
+```
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pre-commit install
+ruff check src tests
+mypy src
+pytest
+```
+
+## Citation
+
+See [CITATION.cff](CITATION.cff) and [.zenodo.json](.zenodo.json).

snowpack_elevation_warming_utac-1.0.0/pyproject.toml

@@ -0,0 +1,47 @@
+[project]
+name = "snowpack-elevation-warming-utac"
+version = "1.0.0"
+description = "The seasonal snow buffer is eroding -- Pepin et al. 2015's elevation-dependent-warming mechanism review, Matiu et al. 2021's European Alps snow depth trends, Notarnicola 2022's global mountain snow cover trends (incl. the Karakoram anomaly), and Mote et al. 2018's western US snowpack decline -- quantifies P103's unquantified 'snow (seasonal)' buffer category, no UTAC/CREP bridge"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "Römer, Johann" }]
+requires-python = ">=3.11"
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/GenesisAeon/snowpack-elevation-warming-utac"
+Repository = "https://github.com/GenesisAeon/snowpack-elevation-warming-utac"
+
+[project.optional-dependencies]
+dev = [
+    "ruff>=0.6.0",
+    "mypy>=1.10.0",
+    "pre-commit>=3.7.0",
+    "pytest>=8.0.0",
+    "pytest-cov>=5.0.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/snowpack_elevation_warming_utac"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "B", "I", "W", "UP"]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--cov=snowpack_elevation_warming_utac --cov-report=term-missing -v"

snowpack_elevation_warming_utac-1.0.0/src/snowpack_elevation_warming_utac/__init__.py

@@ -0,0 +1,66 @@
+"""snowpack-elevation-warming-utac -- the seasonal snow buffer is eroding.
+
+GenesisAeon Package 110. Quantifies a buffer type that P103
+(distributed-buffer-resilience-utac) names but leaves unquantified:
+"snow (seasonal)". Also extends P99 (glacier-buffer-utac)'s "peak
+water" framing to the faster, annually-recurring seasonal snowpack.
+Deliberately no UTAC/CREP/AFET bridge -- see DISCLAIMER.md.
+
+Deliberately NOT one-sided: includes a real complication of the "snow
+is declining everywhere" narrative (Notarnicola et al. 2022's winter/
+spring divergence and the Karakoram anomaly), not just confirmation.
+
+All citations independently verified 2026-08-16.
+"""
+
+from .alpine_snow_decline import (
+    ALPINE_SNOW_TREND,
+    AlpineSnowTrend,
+    is_decline_spatially_uniform,
+)
+from .constants import (
+    BRIDGE_NOTE,
+    MATIU_2021_CITATION,
+    MOTE_2018_CITATION,
+    NOTARNICOLA_2022_CITATION,
+    PACKAGE_ID,
+    PEPIN_2015_CITATION,
+)
+from .elevation_dependent_warming import (
+    edw_candidate_mechanisms,
+    is_globally_uniform_pattern,
+)
+from .global_snow_trends import (
+    GLOBAL_SNOW_TREND,
+    GlobalSnowTrend,
+    is_snow_decline_spatially_universal,
+    winter_vs_spring_extent_trend_pct,
+)
+from .west_us_snowpack import (
+    WEST_US_SNOWPACK_TREND,
+    WestUsSnowpackTrend,
+    majority_of_sites_declining,
+)
+
+__version__ = "1.0.0"
+
+__all__ = [
+    "ALPINE_SNOW_TREND",
+    "BRIDGE_NOTE",
+    "GLOBAL_SNOW_TREND",
+    "MATIU_2021_CITATION",
+    "MOTE_2018_CITATION",
+    "NOTARNICOLA_2022_CITATION",
+    "PACKAGE_ID",
+    "PEPIN_2015_CITATION",
+    "WEST_US_SNOWPACK_TREND",
+    "AlpineSnowTrend",
+    "GlobalSnowTrend",
+    "WestUsSnowpackTrend",
+    "edw_candidate_mechanisms",
+    "is_decline_spatially_uniform",
+    "is_globally_uniform_pattern",
+    "is_snow_decline_spatially_universal",
+    "majority_of_sites_declining",
+    "winter_vs_spring_extent_trend_pct",
+]

snowpack_elevation_warming_utac-1.0.0/src/snowpack_elevation_warming_utac/alpine_snow_decline.py

@@ -0,0 +1,58 @@
+"""European Alps snow depth trends, 1971-2019 (Matiu et al. 2021).
+
+Core module -- a real, large station network (2000+ stations, 800+
+used for trend assessment across six Alpine countries).
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from .constants import (
+    ALPS_DURATION_PCT_PER_DECADE,
+    ALPS_MAX_DEPTH_PCT_PER_DECADE,
+    ALPS_REGIONAL_ASYMMETRY_NOTE,
+    ALPS_SEASONAL_MEAN_DEPTH_PCT_PER_DECADE,
+    ALPS_STATION_COUNT,
+    ALPS_TREND_PERIOD,
+    ALPS_TREND_STATION_COUNT,
+    MATIU_2021_CITATION,
+)
+
+
+@dataclass(frozen=True)
+class AlpineSnowTrend:
+    """Matiu et al. (2021)'s observed European Alps snow depth trend."""
+
+    period: str
+    station_count: int
+    trend_station_count: int
+    seasonal_mean_depth_pct_per_decade: float
+    max_depth_pct_per_decade: float
+    duration_pct_per_decade: float
+    citation: str
+
+
+ALPINE_SNOW_TREND = AlpineSnowTrend(
+    period=ALPS_TREND_PERIOD,
+    station_count=ALPS_STATION_COUNT,
+    trend_station_count=ALPS_TREND_STATION_COUNT,
+    seasonal_mean_depth_pct_per_decade=ALPS_SEASONAL_MEAN_DEPTH_PCT_PER_DECADE,
+    max_depth_pct_per_decade=ALPS_MAX_DEPTH_PCT_PER_DECADE,
+    duration_pct_per_decade=ALPS_DURATION_PCT_PER_DECADE,
+    citation=MATIU_2021_CITATION,
+)
+
+
+def is_decline_spatially_uniform() -> bool:
+    """Whether the Alps-wide snow decline is spatially uniform.
+
+    Always False. Southern Alpine (south-facing) regions decline
+    measurably faster than northern regions -- see
+    ALPS_REGIONAL_ASYMMETRY_NOTE.
+    """
+    return False
+
+
+REGIONAL_ASYMMETRY_NOTE = ALPS_REGIONAL_ASYMMETRY_NOTE
+CITATION = MATIU_2021_CITATION

snowpack_elevation_warming_utac-1.0.0/src/snowpack_elevation_warming_utac/constants.py

@@ -0,0 +1,163 @@
+"""Verified constants for elevation-dependent warming and mountain snowpack decline.
+
+Quantifies a buffer type that P103's storage_portfolio.py names but
+leaves unquantified: "snow (seasonal)" as one of five hydrological
+buffer types (alongside reservoirs, soil moisture, wetlands,
+groundwater). This package documents that the snow buffer itself is
+measurably eroding -- and that the erosion is not spatially uniform,
+which is the deliberate honesty check for this package (see
+global_snow_trends.py). Deliberately no UTAC/CREP/AFET bridge.
+
+All citations independently verified via direct source lookup on
+2026-08-16.
+"""
+
+PACKAGE_ID = 110
+
+# =====================================================================
+# Pepin et al. 2015: elevation-dependent warming (EDW), mechanism review
+# =====================================================================
+
+PEPIN_2015_CITATION = (
+    "Pepin, N., Bradley, R.S., Diaz, H.F., Baraer, M., Caceres, E.B., "
+    "Forsythe, N., et al. (2015). Elevation-dependent warming in "
+    "mountain regions of the world. Nature Climate Change, 5, "
+    "424-430. DOI: 10.1038/nclimate2563"
+)
+PEPIN_2015_DOI = "10.1038/nclimate2563"
+
+EDW_CANDIDATE_MECHANISMS = (
+    "snow albedo and surface-based feedbacks",
+    "water vapor changes and latent heat release",
+    "radiative flux changes related to surface moisture",
+    "surface heat loss and temperature change",
+    "aerosol effects",
+)
+
+EDW_NOTE = (
+    "Pepin et al. (2015) is a synthesis review, not a single global "
+    "measurement: it establishes that the rate of warming is "
+    "amplified with elevation in many mountain regions, driven by up "
+    "to five candidate mechanisms, but explicitly frames these "
+    "mechanisms as producing CONTRASTING REGIONAL PATTERNS rather "
+    "than one uniform global amplification rate. This package does "
+    "not attribute a single global degrees-per-decade EDW figure to "
+    "this citation, because the paper itself does not report one -- "
+    "doing so would overclaim past the paper's own scope."
+)
+
+# =====================================================================
+# Matiu et al. 2021: European Alps snow depth trends, 1971-2019
+# =====================================================================
+
+MATIU_2021_CITATION = (
+    "Matiu, M., Crespi, A., Bertoldi, G., Carmagnola, C.M., Marty, C., "
+    "Morin, S., et al. (2021). Observed snow depth trends in the "
+    "European Alps: 1971 to 2019. The Cryosphere, 15, 1343-1382. "
+    "DOI: 10.5194/tc-15-1343-2021"
+)
+MATIU_2021_DOI = "10.5194/tc-15-1343-2021"
+
+ALPS_STATION_COUNT = 2000
+ALPS_TREND_STATION_COUNT = 800
+ALPS_TREND_PERIOD = "1971-2019"
+ALPS_SEASONAL_MEAN_DEPTH_PCT_PER_DECADE = -8.4
+ALPS_MAX_DEPTH_PCT_PER_DECADE = -5.6
+ALPS_DURATION_PCT_PER_DECADE = -5.6
+
+ALPS_REGIONAL_ASYMMETRY_NOTE = (
+    "Southern Alpine regions show stronger declines than northern "
+    "regions -- e.g. mid-elevation (1000-2000 m) March snow depth "
+    "declined ~-7.0 cm/decade on south-facing/southern slopes vs. "
+    "~-3.9 cm/decade in northern regions. The decline is real and "
+    "widespread (~85% of station-months show a declining trend, ~26% "
+    "statistically significant at p<0.05) but not spatially uniform."
+)
+
+# =====================================================================
+# Notarnicola 2022: global mountain snow cover extent/duration, 1982-2020
+# (satellite-based; the deliberate honesty-check citation for this package)
+# =====================================================================
+
+NOTARNICOLA_2022_CITATION = (
+    "Notarnicola, C. (2022). Overall negative trends for snow cover "
+    "extent and duration in global mountain regions over 1982-2020. "
+    "Scientific Reports, 12, 13731. "
+    "DOI: 10.1038/s41598-022-16743-w"
+)
+NOTARNICOLA_2022_DOI = "10.1038/s41598-022-16743-w"
+
+GLOBAL_TREND_PERIOD = "1982-2020"
+GLOBAL_SNOW_EXTENT_PCT = -3.6
+GLOBAL_SNOW_EXTENT_PCT_UNCERTAINTY = 2.7
+GLOBAL_SNOW_DURATION_DAYS = -15.1
+GLOBAL_SNOW_DURATION_DAYS_UNCERTAINTY = 11.6
+
+WINTER_EXTENT_PCT = -11.5
+WINTER_EXTENT_PCT_UNCERTAINTY = 6.9
+SPRING_EXTENT_PCT = 10.0
+SPRING_EXTENT_PCT_UNCERTAINTY = 5.9
+
+KARAKORAM_ANOMALY_NOTE = (
+    "The decline is real at the global-mean level but NOT spatially "
+    "or seasonally uniform -- the deliberate honesty check for this "
+    "package. Two real complications: (1) spring (MAM) snow cover "
+    "extent shows a positive trend on average (+10.0%+/-5.9%) even as "
+    "winter (DJF) shows the steepest decline (-11.5%+/-6.9%); (2) the "
+    "northern High Mountain Asia ranges -- Karakoram, Kunlun Shan, "
+    "Pamir -- show POSITIVE snow cover extent trends, consistent with "
+    "the independently documented 'Karakoram anomaly' in glacier mass "
+    "balance, while southern High Mountain Asia declines. The trend "
+    "also decelerated after ~2000 relative to 1982-1999. A single "
+    "global percentage does not describe every region or season."
+)
+
+# =====================================================================
+# Mote et al. 2018: western US snowpack decline, since 1915
+# =====================================================================
+
+MOTE_2018_CITATION = (
+    "Mote, P.W., Li, S., Lettenmaier, D.P., Xiao, M., Engel, R. "
+    "(2018). Dramatic declines in snowpack in the western US. npj "
+    "Climate and Atmospheric Science, 1, 2. "
+    "DOI: 10.1038/s41612-018-0012-1"
+)
+MOTE_2018_DOI = "10.1038/s41612-018-0012-1"
+
+WEST_US_SITE_COUNT = 1766
+WEST_US_TREND_START_YEAR = 1915
+WEST_US_PCT_SITES_DECLINING = 90
+WEST_US_PCT_DECLINES_SIGNIFICANT = 33
+WEST_US_DECLINE_RANGE_PCT = (15, 30)
+
+WEST_US_NOTE = (
+    "A real, independently large station network (1,766 sites, "
+    "primarily April 1 snow water equivalent measurements since "
+    "1915): more than 90% of sites show a decline, about one-third of "
+    "those declines are statistically significant, and the average "
+    "decline across sites is 15-30% since the start of record. "
+    "Impacts were largest in spring, in Pacific-coast states, and in "
+    "locations with mild winter climates."
+)
+
+# =====================================================================
+# Bridge note: connects to P99 (glacier peak water) and P103
+# (distributed-buffer-resilience-utac's unquantified "snow (seasonal)"
+# buffer category in storage_portfolio.py)
+# =====================================================================
+
+BRIDGE_NOTE = (
+    "distributed-buffer-resilience-utac (P103) names snow (seasonal) "
+    "as one of five hydrological buffer types in its "
+    "STORAGE_PORTFOLIO_NOTE, alongside reservoirs, soil moisture, "
+    "wetlands and groundwater, but leaves it unquantified. This "
+    "package fills that gap: the seasonal snow buffer itself is "
+    "measurably eroding, in both mountain snow depth/duration "
+    "(Matiu et al. 2021, European Alps; Notarnicola 2022, global) "
+    "and in the driving warming pattern (Pepin et al. 2015). It also "
+    "extends glacier-buffer-utac (P99)'s 'peak water' framing: while "
+    "P99 documents the transient glacier-melt buffer, this package "
+    "documents the shorter, annually-recurring snowpack buffer that "
+    "operates on a faster (seasonal, not multi-decadal) timescale but "
+    "is eroding by the same underlying warming."
+)

snowpack_elevation_warming_utac-1.0.0/src/snowpack_elevation_warming_utac/elevation_dependent_warming.py

@@ -0,0 +1,35 @@
+"""Elevation-dependent warming (EDW) mechanism review (Pepin et al. 2015).
+
+Core module -- a synthesis of candidate mechanisms, not a single
+global measurement. See EDW_NOTE for why this package does not
+attribute one global degrees-per-decade figure to this citation.
+"""
+
+from __future__ import annotations
+
+from .constants import (
+    EDW_CANDIDATE_MECHANISMS,
+    EDW_NOTE,
+    PEPIN_2015_CITATION,
+)
+
+
+def edw_candidate_mechanisms() -> tuple[str, ...]:
+    """The five candidate mechanisms Pepin et al. (2015) identify for EDW."""
+    return EDW_CANDIDATE_MECHANISMS
+
+
+def is_globally_uniform_pattern() -> bool:
+    """Whether elevation-dependent warming follows one uniform global rate.
+
+    Always False. Pepin et al. (2015) explicitly frame EDW as arising
+    from combinations of mechanisms that vary by region, producing
+    contrasting regional patterns -- not a single global amplification
+    rate. Treating EDW as spatially uniform would overclaim past what
+    the review itself supports.
+    """
+    return False
+
+
+CITATION = PEPIN_2015_CITATION
+MECHANISM_NOTE = EDW_NOTE

snowpack_elevation_warming_utac-1.0.0/src/snowpack_elevation_warming_utac/global_snow_trends.py

@@ -0,0 +1,72 @@
+"""Global mountain snow cover extent/duration, 1982-2020 (Notarnicola 2022).
+
+Core module -- the deliberate honesty check for this package. The
+global-mean decline is real, but this module exists specifically to
+prevent the package from becoming a one-sided "snow is disappearing
+everywhere, in every season" narrative. See KARAKORAM_ANOMALY_NOTE.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from .constants import (
+    GLOBAL_SNOW_DURATION_DAYS,
+    GLOBAL_SNOW_DURATION_DAYS_UNCERTAINTY,
+    GLOBAL_SNOW_EXTENT_PCT,
+    GLOBAL_SNOW_EXTENT_PCT_UNCERTAINTY,
+    GLOBAL_TREND_PERIOD,
+    KARAKORAM_ANOMALY_NOTE,
+    NOTARNICOLA_2022_CITATION,
+    SPRING_EXTENT_PCT,
+    WINTER_EXTENT_PCT,
+)
+
+
+@dataclass(frozen=True)
+class GlobalSnowTrend:
+    """Notarnicola (2022)'s satellite-based global mountain snow cover trend."""
+
+    period: str
+    extent_pct: float
+    extent_pct_uncertainty: float
+    duration_days: float
+    duration_days_uncertainty: float
+    citation: str
+
+
+GLOBAL_SNOW_TREND = GlobalSnowTrend(
+    period=GLOBAL_TREND_PERIOD,
+    extent_pct=GLOBAL_SNOW_EXTENT_PCT,
+    extent_pct_uncertainty=GLOBAL_SNOW_EXTENT_PCT_UNCERTAINTY,
+    duration_days=GLOBAL_SNOW_DURATION_DAYS,
+    duration_days_uncertainty=GLOBAL_SNOW_DURATION_DAYS_UNCERTAINTY,
+    citation=NOTARNICOLA_2022_CITATION,
+)
+
+
+def winter_vs_spring_extent_trend_pct() -> dict[str, float]:
+    """Seasonal split of global mountain snow cover extent trend.
+
+    Winter (DJF) shows the steepest decline; spring (MAM) shows a
+    positive trend on average -- the two seasons move in opposite
+    directions, which is why a single annual-mean percentage does not
+    describe every season.
+    """
+    return {"winter_djf": WINTER_EXTENT_PCT, "spring_mam": SPRING_EXTENT_PCT}
+
+
+def is_snow_decline_spatially_universal() -> bool:
+    """Whether every mountain range shows a snow cover decline.
+
+    Always False. Northern High Mountain Asia (Karakoram, Kunlun Shan,
+    Pamir) shows a POSITIVE snow cover extent trend, consistent with
+    the independently documented "Karakoram anomaly" in glacier mass
+    balance -- while southern High Mountain Asia declines. See
+    KARAKORAM_ANOMALY_NOTE.
+    """
+    return False
+
+
+NUANCE_NOTE = KARAKORAM_ANOMALY_NOTE
+CITATION = NOTARNICOLA_2022_CITATION

snowpack_elevation_warming_utac-1.0.0/src/snowpack_elevation_warming_utac/west_us_snowpack.py

@@ -0,0 +1,55 @@
+"""Western US snowpack decline since 1915 (Mote et al. 2018).
+
+Core module -- a real, large (1,766-site) long-term snow-course/SNOTEL
+station network analysis, independent of the two European studies.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from .constants import (
+    MOTE_2018_CITATION,
+    WEST_US_DECLINE_RANGE_PCT,
+    WEST_US_NOTE,
+    WEST_US_PCT_DECLINES_SIGNIFICANT,
+    WEST_US_PCT_SITES_DECLINING,
+    WEST_US_SITE_COUNT,
+    WEST_US_TREND_START_YEAR,
+)
+
+
+@dataclass(frozen=True)
+class WestUsSnowpackTrend:
+    """Mote et al. (2018)'s observed western US snowpack decline."""
+
+    trend_start_year: int
+    site_count: int
+    pct_sites_declining: float
+    pct_declines_significant: float
+    decline_range_pct: tuple[int, int]
+    citation: str
+
+
+WEST_US_SNOWPACK_TREND = WestUsSnowpackTrend(
+    trend_start_year=WEST_US_TREND_START_YEAR,
+    site_count=WEST_US_SITE_COUNT,
+    pct_sites_declining=WEST_US_PCT_SITES_DECLINING,
+    pct_declines_significant=WEST_US_PCT_DECLINES_SIGNIFICANT,
+    decline_range_pct=WEST_US_DECLINE_RANGE_PCT,
+    citation=MOTE_2018_CITATION,
+)
+
+
+def majority_of_sites_declining() -> bool:
+    """Whether more than half of the 1,766 monitored sites show a decline.
+
+    Always True -- more than 90% of sites decline, though only about
+    a third of those declines are individually statistically
+    significant (see pct_declines_significant on the dataclass).
+    """
+    return WEST_US_SNOWPACK_TREND.pct_sites_declining > 50.0
+
+
+CITATION = MOTE_2018_CITATION
+NOTE = WEST_US_NOTE

snowpack_elevation_warming_utac-1.0.0/tests/test_main.py

@@ -0,0 +1,101 @@
+"""Tests for snowpack-elevation-warming-utac."""
+
+from snowpack_elevation_warming_utac import (
+    ALPINE_SNOW_TREND,
+    GLOBAL_SNOW_TREND,
+    PACKAGE_ID,
+    WEST_US_SNOWPACK_TREND,
+    __version__,
+    edw_candidate_mechanisms,
+    is_decline_spatially_uniform,
+    is_globally_uniform_pattern,
+    is_snow_decline_spatially_universal,
+    majority_of_sites_declining,
+    winter_vs_spring_extent_trend_pct,
+)
+
+
+def test_version():
+    assert __version__ == "1.0.0"
+
+
+def test_package_id():
+    assert PACKAGE_ID == 110
+
+
+# --- elevation_dependent_warming.py (core) --------------------------------
+
+
+def test_edw_candidate_mechanisms_count_and_content():
+    mechanisms = edw_candidate_mechanisms()
+    assert len(mechanisms) == 5
+    assert any("albedo" in m for m in mechanisms)
+    assert any("aerosol" in m for m in mechanisms)
+
+
+def test_is_globally_uniform_pattern_always_false():
+    assert is_globally_uniform_pattern() is False
+
+
+# --- alpine_snow_decline.py (core) -----------------------------------------
+
+
+def test_alpine_snow_trend_values():
+    assert ALPINE_SNOW_TREND.period == "1971-2019"
+    assert ALPINE_SNOW_TREND.station_count == 2000
+    assert ALPINE_SNOW_TREND.trend_station_count == 800
+    assert ALPINE_SNOW_TREND.seasonal_mean_depth_pct_per_decade == -8.4
+    assert ALPINE_SNOW_TREND.max_depth_pct_per_decade == -5.6
+    assert ALPINE_SNOW_TREND.duration_pct_per_decade == -5.6
+    assert ALPINE_SNOW_TREND.citation
+
+
+def test_is_decline_spatially_uniform_always_false():
+    assert is_decline_spatially_uniform() is False
+
+
+# --- global_snow_trends.py (core, honesty-check module) --------------------
+
+
+def test_global_snow_trend_values():
+    assert GLOBAL_SNOW_TREND.period == "1982-2020"
+    assert GLOBAL_SNOW_TREND.extent_pct == -3.6
+    assert GLOBAL_SNOW_TREND.duration_days == -15.1
+    assert GLOBAL_SNOW_TREND.citation
+
+
+def test_winter_vs_spring_extent_trend_opposite_signs():
+    trend = winter_vs_spring_extent_trend_pct()
+    assert trend["winter_djf"] < 0
+    assert trend["spring_mam"] > 0
+
+
+def test_is_snow_decline_spatially_universal_always_false():
+    # The key honesty check: not every mountain range declines --
+    # northern High Mountain Asia shows a positive trend.
+    assert is_snow_decline_spatially_universal() is False
+
+
+# --- west_us_snowpack.py (core) ---------------------------------------------
+
+
+def test_west_us_snowpack_trend_values():
+    assert WEST_US_SNOWPACK_TREND.trend_start_year == 1915
+    assert WEST_US_SNOWPACK_TREND.site_count == 1766
+    assert WEST_US_SNOWPACK_TREND.pct_sites_declining == 90
+    assert WEST_US_SNOWPACK_TREND.pct_declines_significant == 33
+    assert WEST_US_SNOWPACK_TREND.decline_range_pct == (15, 30)
+    assert WEST_US_SNOWPACK_TREND.citation
+
+
+def test_majority_of_sites_declining_true():
+    assert majority_of_sites_declining() is True
+
+
+def test_nuance_does_not_contradict_measured_decline():
+    # Both can be true at once: the global-mean decline is real
+    # (measured across three independent datasets), AND it is not
+    # spatially/seasonally universal (Karakoram anomaly, spring uptick).
+    assert majority_of_sites_declining() is True
+    assert is_decline_spatially_uniform() is False
+    assert is_snow_decline_spatially_universal() is False