distributed-buffer-resilience-utac 1.0.0__tar.gz

distributed_buffer_resilience_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

distributed_buffer_resilience_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.

distributed_buffer_resilience_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

distributed_buffer_resilience_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

distributed_buffer_resilience_utac-1.0.0/.zenodo.json

@@ -0,0 +1,29 @@
+{
+  "title": "distributed-buffer-resilience-utac — P103: Distributed hydrological/ecosystem buffer resilience",
+  "description": "<p>Distributed hydrological/ecosystem buffer resilience for deglacierizing catchments: van Tiel et al. 2026's drought-buffer evidence (the strongest empirical anchor in the P99-P103 series), Farinotti et al. 2016/2019's storage-portfolio figures, Immerzeel/Pritchard water-tower science, and Casallas et al. 2025 ecosystem-service trade-offs, plus a clearly-flagged speculative Glacier Buffer Replacement (GBR) score. Companion to glacier-buffer-utac (P99) and glacier-buffer-replacement-utac (P100). Deliberately has NO UTAC/CREP/AFET bridge. See DISCLAIMER.md. Part of the <strong>GenesisAeon</strong> ecosystem (P103, domain: climate / hydrology / ecosystem services).</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",
+    "P103",
+    "climate",
+    "glacier",
+    "hydrology",
+    "ecosystem-services",
+    "water-towers",
+    "open-science"
+  ],
+  "communities": [
+    {
+      "identifier": "genesisaeon"
+    }
+  ]
+}

distributed_buffer_resilience_utac-1.0.0/CITATION.cff

@@ -0,0 +1,102 @@
+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: "distributed-buffer-resilience-utac"
+version: "1.0.0"
+date-released: "2026-08-14"
+url: "https://github.com/GenesisAeon/distributed-buffer-resilience-utac"
+repository-code: "https://github.com/GenesisAeon/distributed-buffer-resilience-utac"
+license: MIT
+abstract: "Distributed hydrological/ecosystem buffer resilience for deglacierizing catchments: van Tiel et al. 2026's drought-buffer evidence, Farinotti et al. 2016/2019's storage-portfolio figures, Immerzeel/Pritchard water-tower science, Casallas et al. 2025 ecosystem-service trade-offs, plus a clearly-flagged speculative Glacier Buffer Replacement score. Companion to glacier-buffer-utac (P99) and glacier-buffer-replacement-utac (P100). Deliberately no UTAC/CREP/AFET bridge. GenesisAeon P103."
+keywords:
+  - GenesisAeon
+  - P103
+  - climate
+  - glacier
+  - hydrology
+  - ecosystem-services
+  - water-towers
+  - open-science
+references:
+  - type: article
+    title: "Swiss glacier mass loss during the 2022 drought: persistent streamflow contributions amid declining melt water volumes"
+    authors:
+      - name: "van Tiel, M."
+      - name: "Huss, M."
+      - name: "Zappa, M."
+      - name: "Jonas, T."
+      - name: "Farinotti, D."
+    year: 2026
+    journal: "Hydrology and Earth System Sciences"
+    volume: 30
+    start: 23
+    doi: "10.5194/hess-30-23-2026"
+  - type: article
+    title: "From dwindling ice to headwater lakes: could dams replace glaciers in the European Alps?"
+    authors:
+      - name: "Farinotti, D."
+      - name: "Pistocchi, A."
+      - name: "Huss, M."
+    year: 2016
+    journal: "Environmental Research Letters"
+    volume: 11
+    issue: 5
+    doi: "10.1088/1748-9326/11/5/054022"
+  - type: article
+    title: "Large hydropower and water-storage potential in future glacier-free basins"
+    authors:
+      - name: "Farinotti, D."
+      - name: "Round, V."
+      - name: "Huss, M."
+      - name: "Compagno, L."
+      - name: "Zekollari, H."
+    year: 2019
+    journal: "Nature"
+    volume: 575
+    start: 341
+    doi: "10.1038/s41586-019-1740-z"
+  - type: article
+    title: "Global-scale hydrological response to future glacier mass loss"
+    authors:
+      - name: "Huss, M."
+      - name: "Hock, R."
+    year: 2018
+    journal: "Nature Climate Change"
+    volume: 8
+    start: 135
+    doi: "10.1038/s41558-017-0049-x"
+  - type: article
+    title: "Asia's glaciers are a regionally important buffer against drought"
+    authors:
+      - name: "Pritchard, H.D."
+    year: 2017
+    journal: "Nature"
+    volume: 545
+    start: 169
+    doi: "10.1038/nature22062"
+  - type: article
+    title: "Importance and vulnerability of the world's water towers"
+    authors:
+      - name: "Immerzeel, W.W."
+      - name: "Lutz, A.F."
+      - name: "Andrade, M."
+    year: 2020
+    journal: "Nature"
+    volume: 577
+    start: 364
+    doi: "10.1038/s41586-019-1822-y"
+  - type: article
+    title: "Global impacts of glacier retreat on ecosystem services provided by soil and vegetation in mountain regions: A literature review"
+    authors:
+      - name: "Velasquez Casallas, L.M."
+      - name: "Khelidj, N."
+      - name: "Moran-Ordonez, A."
+      - name: "Losapio, G."
+    year: 2025
+    journal: "Ecosystem Services"
+    volume: 73
+    doi: "10.1016/j.ecoser.2025.101730"

distributed_buffer_resilience_utac-1.0.0/DISCLAIMER.md

@@ -0,0 +1,104 @@
+# DISCLAIMER — Two Confidence Tiers, No Framework Bridge
+
+**Status: Core = real, independently re-verified science. Optional =
+this ecosystem's own discretization of a source document's proposed
+formula, not a peer-reviewed metric. NO UTAC/CREP/AFET bridge.**
+
+## Core tier — real, independently re-verified 2026-08-14
+
+Every figure below was checked directly against the paper (DOI lookup
+or publisher/press summary) on 2026-08-14.
+
+- **van Tiel, Huss, Zappa, Jonas & Farinotti (2026)**, *HESS* 30,
+  23-43, DOI: 10.5194/hess-30-23-2026 — the strongest empirical anchor
+  in this package series. 88 glacierized Swiss catchments; 2022 mass
+  loss ~6% of remaining volume; glacier melt still substantially
+  buffered the 2022 drought's precipitation/snowmelt deficits, while
+  absolute summer meltwater volume was already below the comparable
+  2003 extreme in roughly two-thirds of catchments. The buffer works
+  and its capacity is eroding, simultaneously, already observed.
+- **Farinotti, Pistocchi & Huss (2016)**, *ERL* 11(5), 054022, DOI:
+  10.1088/1748-9326/11/5/054022 — the ~65% reservoir-strategy ceiling
+  on Alpine summer-runoff-CHANGE compensation, reused from P100 with
+  the same scoping discipline: a specific regional scenario-bound
+  estimate, not a universal replacement constant. Farinotti et al.
+  explicitly state reservoirs cannot compensate the annual
+  non-renewable runoff share permanently lost as glacier ice
+  disappears.
+- **Farinotti, Round, Huss, Compagno & Zekollari (2019)**, *Nature*
+  575, 341-344, DOI: 10.1038/s41586-019-1740-z — global theoretical
+  ice-free-basin storage potential (875±260 km³ across ~185,000
+  glaciers analyzed), of which only ~40% (355 km³) was judged
+  potentially suitable after a first-pass technical/ecological/
+  economic screen. The paper itself stresses the theoretical character
+  of the 875 km³ figure.
+- **Huss & Hock (2018)**, *Nature Climate Change* 8, 135-140, DOI:
+  10.1038/s41558-017-0049-x — "peak water" (reused from P99).
+- **Pritchard (2017)**, *Nature* 545, 169-174, DOI:
+  10.1038/nature22062 — the origin of the "glaciers as a regionally
+  important drought buffer" framing this entire package series builds
+  on.
+- **Immerzeel, Lutz, Andrade et al. (2020)**, *Nature* 577, 364-369,
+  DOI: 10.1038/s41586-019-1822-y — the Water Tower Index: 1.9 billion
+  people dependent globally; some of the most hydrologically important
+  water towers (Indus, Amu Darya, Tarim) are simultaneously among the
+  most vulnerable.
+- **Velasquez Casallas, Khelidj, Moran-Ordonez & Losapio (2025)**,
+  *Ecosystem Services* 73, 101730, DOI: 10.1016/j.ecoser.2025.101730 —
+  a systematic literature review: postglacial regulating ecosystem
+  services (climate regulation, erosion control) can increase, but
+  heterogeneously, with real trade-offs — not a uniform net benefit.
+
+## Optional tier — this ecosystem's own construction, flagged
+
+- **`gbr.py`'s Glacier Buffer Replacement (GBR) score** is **not a
+  peer-reviewed metric**. It is a discretized implementation of a
+  formula proposed in `P102.md` (Kimi's own synthesis, itself building
+  on this package's real drought/streamflow evidence) — the scoring
+  formula carries no primary citation. This mirrors
+  `glacier-buffer-replacement-utac` (P100)'s Resilience Replacement
+  Factor precedent: every function in `gbr.py` is exported alongside
+  `GBR_NOT_PEER_REVIEWED_WARNING`.
+
+## What this is NOT
+
+- **Not a claim that ecosystem restoration or storage portfolios fully
+  replace lost glacier hydrology.** `theoretical_vs_realistic_gap_fraction()`
+  and `FARINOTTI_2016_SCOPE_NOTE` make the same physical ceiling
+  explicit that P100's `mass_balance` module encodes for reservoirs
+  alone: this package broadens the portfolio, it does not remove the
+  underlying mass-balance limit.
+- **`nbs_effect_is_guaranteed_positive()` always returns `False`** —
+  intentionally. Nature-based Solutions are real and often valuable,
+  but their hydrological effect must be measured locally, never
+  assumed from the "natural" label.
+- **No UTAC/CREP/AFET bridge.** This is a real, standalone hydrology
+  and ecosystem-science topic; the cited papers already provide the
+  relevant quantitative structure without this ecosystem's
+  cross-domain vocabulary.
+
+## References
+
+- van Tiel, M., Huss, M., Zappa, M., Jonas, T., Farinotti, D. (2026).
+  *HESS*, 30, 23-43. DOI: 10.5194/hess-30-23-2026.
+- Farinotti, D., Pistocchi, A., Huss, M. (2016). *ERL*, 11(5), 054022.
+  DOI: 10.1088/1748-9326/11/5/054022.
+- Farinotti, D., Round, V., Huss, M., Compagno, L., Zekollari, H.
+  (2019). *Nature*, 575, 341-344. DOI: 10.1038/s41586-019-1740-z.
+- Huss, M., Hock, R. (2018). *Nature Climate Change*, 8, 135-140. DOI:
+  10.1038/s41558-017-0049-x.
+- Pritchard, H.D. (2017). *Nature*, 545, 169-174. DOI:
+  10.1038/nature22062.
+- Immerzeel, W.W., Lutz, A.F., Andrade, M. et al. (2020). *Nature*,
+  577, 364-369. DOI: 10.1038/s41586-019-1822-y.
+- Velasquez Casallas, L.M., Khelidj, N., Moran-Ordonez, A., Losapio, G.
+  (2025). *Ecosystem Services*, 73, 101730. DOI:
+  10.1016/j.ecoser.2025.101730.
+
+All verified directly (2026-08-14) via WebSearch against the
+publisher/journal record for each paper. Originating dialogue:
+`P 102.txt` (Johann + Kimi) and `P102.md` (Kimi's own deep-research
+audit, which proposed splitting P102 into a paraglacial-hazard package
+[P102, see `paraglacial-hazard-utac`] and this hydrological/ecosystem
+package [P103] rather than one monolithic three-pillar package —
+independently spot-checked before building either).

distributed_buffer_resilience_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.

distributed_buffer_resilience_utac-1.0.0/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.5
+Name: distributed-buffer-resilience-utac
+Version: 1.0.0
+Summary: Distributed hydrological/ecosystem buffer resilience for deglacierizing catchments -- van Tiel et al. 2026's drought-buffer evidence, Farinotti et al. 2016/2019's storage-portfolio figures, Immerzeel/Pritchard water-tower science, Casallas et al. 2025 ecosystem-service trade-offs, plus a clearly-flagged speculative GBR score -- companion to glacier-buffer-utac (P99) and glacier-buffer-replacement-utac (P100), no UTAC/CREP bridge
+Project-URL: Homepage, https://github.com/GenesisAeon/distributed-buffer-resilience-utac
+Project-URL: Repository, https://github.com/GenesisAeon/distributed-buffer-resilience-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
+
+# distributed-buffer-resilience-utac
+
+GenesisAeon Package 103 — distributed hydrological/ecosystem buffer
+resilience for deglacierizing catchments. Companion to
+[glacier-buffer-utac](https://github.com/GenesisAeon/glacier-buffer-utac)
+(P99, the loss) and
+[glacier-buffer-replacement-utac](https://github.com/GenesisAeon/glacier-buffer-replacement-utac)
+(P100, technical replacement). **Deliberately has no UTAC/CREP/AFET
+bridge** — see [DISCLAIMER.md](DISCLAIMER.md).
+
+## The core idea
+
+A single storage type can't replace a glacier. What actually buffers a
+deglacierizing catchment is a **portfolio** of reservoirs, groundwater,
+wetlands, snow, and demand management, each with a different response
+time — not one component sized to do the whole job.
+
+## Two explicit confidence tiers
+
+- **Core** (`drought_buffer`, `storage_portfolio`, `water_towers`,
+  `ecosystem_services`): real, peer-reviewed findings independently
+  re-verified 2026-08-14.
+- **Optional / speculative** (`gbr`): a ratio-style score this
+  ecosystem constructed from a source document's own proposed formula
+  — not a published metric. Always exposed with
+  `GBR_NOT_PEER_REVIEWED_WARNING`.
+
+## What's real here (core)
+
+- **van Tiel et al. (2026, *HESS*)** — the strongest empirical anchor
+  in the whole P99–P103 series: during the extreme 2022 Swiss drought,
+  glacier melt across 88 catchments still substantially buffered
+  precipitation/snowmelt deficits — yet absolute summer meltwater
+  volume was already lower than 2003 in roughly two-thirds of studied
+  catchments. The buffer works AND its capacity is eroding, at the
+  same time, already observed, not projected.
+- **Farinotti et al. (2016, *ERL*)** — the ~65% Alpine reservoir
+  summer-deficit ceiling, correctly scoped as a specific, regional,
+  scenario-bound estimate (not a universal constant — see
+  `FARINOTTI_2016_SCOPE_NOTE`).
+- **Farinotti et al. (2019, *Nature*)** — global theoretical
+  ice-free-basin storage potential (875±260 km³ across ~185,000
+  glaciers), with only ~40% (355 km³) judged realistically suitable
+  after a first-pass screen.
+- **Pritchard (2017, *Nature*)** and **Immerzeel et al. (2020,
+  *Nature*)** — glaciers as a disproportionate drought buffer, and the
+  Water Tower Index ranking mountain water systems by importance AND
+  vulnerability (1.9 billion people dependent globally).
+- **Velasquez Casallas et al. (2025, *Ecosystem Services*)** — a
+  systematic review finding postglacial ecosystem services can
+  increase, but heterogeneously, with real trade-offs — never assume a
+  Nature-based Solution is hydrologically positive purely from its
+  label. `nbs_effect_is_guaranteed_positive()` always returns `False`.
+
+## Quickstart
+
+```bash
+pip install distributed-buffer-resilience-utac
+```
+
+```python
+from distributed_buffer_resilience_utac import (
+    SWISS_2022_DROUGHT,
+    buffer_functions_while_eroding,
+    reservoir_summer_deficit_ceiling_fraction,
+    GLOBAL_STORAGE_POTENTIAL,
+    is_disproportionate_drought_buffer,
+    nbs_effect_is_guaranteed_positive,
+    GBR_NOT_PEER_REVIEWED_WARNING,
+    glacier_buffer_replacement_score,
+)
+
+print(SWISS_2022_DROUGHT.catchment_count)          # 88
+print(buffer_functions_while_eroding())             # True
+print(reservoir_summer_deficit_ceiling_fraction())  # 0.65
+print(GLOBAL_STORAGE_POTENTIAL.realistic_km3)       # 355.0
+print(is_disproportionate_drought_buffer(10.0, 40.0))  # True
+print(nbs_effect_is_guaranteed_positive())          # False
+
+print(GBR_NOT_PEER_REVIEWED_WARNING)
+score = glacier_buffer_replacement_score(
+    deficit_without_adaptation=[10.0, 10.0],
+    flow_gain_from_adaptation=[5.0, 0.0],
+)
+print(score)  # 0.25
+```
+
+## 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).

distributed_buffer_resilience_utac-1.0.0/README.md

@@ -0,0 +1,100 @@
+# distributed-buffer-resilience-utac
+
+GenesisAeon Package 103 — distributed hydrological/ecosystem buffer
+resilience for deglacierizing catchments. Companion to
+[glacier-buffer-utac](https://github.com/GenesisAeon/glacier-buffer-utac)
+(P99, the loss) and
+[glacier-buffer-replacement-utac](https://github.com/GenesisAeon/glacier-buffer-replacement-utac)
+(P100, technical replacement). **Deliberately has no UTAC/CREP/AFET
+bridge** — see [DISCLAIMER.md](DISCLAIMER.md).
+
+## The core idea
+
+A single storage type can't replace a glacier. What actually buffers a
+deglacierizing catchment is a **portfolio** of reservoirs, groundwater,
+wetlands, snow, and demand management, each with a different response
+time — not one component sized to do the whole job.
+
+## Two explicit confidence tiers
+
+- **Core** (`drought_buffer`, `storage_portfolio`, `water_towers`,
+  `ecosystem_services`): real, peer-reviewed findings independently
+  re-verified 2026-08-14.
+- **Optional / speculative** (`gbr`): a ratio-style score this
+  ecosystem constructed from a source document's own proposed formula
+  — not a published metric. Always exposed with
+  `GBR_NOT_PEER_REVIEWED_WARNING`.
+
+## What's real here (core)
+
+- **van Tiel et al. (2026, *HESS*)** — the strongest empirical anchor
+  in the whole P99–P103 series: during the extreme 2022 Swiss drought,
+  glacier melt across 88 catchments still substantially buffered
+  precipitation/snowmelt deficits — yet absolute summer meltwater
+  volume was already lower than 2003 in roughly two-thirds of studied
+  catchments. The buffer works AND its capacity is eroding, at the
+  same time, already observed, not projected.
+- **Farinotti et al. (2016, *ERL*)** — the ~65% Alpine reservoir
+  summer-deficit ceiling, correctly scoped as a specific, regional,
+  scenario-bound estimate (not a universal constant — see
+  `FARINOTTI_2016_SCOPE_NOTE`).
+- **Farinotti et al. (2019, *Nature*)** — global theoretical
+  ice-free-basin storage potential (875±260 km³ across ~185,000
+  glaciers), with only ~40% (355 km³) judged realistically suitable
+  after a first-pass screen.
+- **Pritchard (2017, *Nature*)** and **Immerzeel et al. (2020,
+  *Nature*)** — glaciers as a disproportionate drought buffer, and the
+  Water Tower Index ranking mountain water systems by importance AND
+  vulnerability (1.9 billion people dependent globally).
+- **Velasquez Casallas et al. (2025, *Ecosystem Services*)** — a
+  systematic review finding postglacial ecosystem services can
+  increase, but heterogeneously, with real trade-offs — never assume a
+  Nature-based Solution is hydrologically positive purely from its
+  label. `nbs_effect_is_guaranteed_positive()` always returns `False`.
+
+## Quickstart
+
+```bash
+pip install distributed-buffer-resilience-utac
+```
+
+```python
+from distributed_buffer_resilience_utac import (
+    SWISS_2022_DROUGHT,
+    buffer_functions_while_eroding,
+    reservoir_summer_deficit_ceiling_fraction,
+    GLOBAL_STORAGE_POTENTIAL,
+    is_disproportionate_drought_buffer,
+    nbs_effect_is_guaranteed_positive,
+    GBR_NOT_PEER_REVIEWED_WARNING,
+    glacier_buffer_replacement_score,
+)
+
+print(SWISS_2022_DROUGHT.catchment_count)          # 88
+print(buffer_functions_while_eroding())             # True
+print(reservoir_summer_deficit_ceiling_fraction())  # 0.65
+print(GLOBAL_STORAGE_POTENTIAL.realistic_km3)       # 355.0
+print(is_disproportionate_drought_buffer(10.0, 40.0))  # True
+print(nbs_effect_is_guaranteed_positive())          # False
+
+print(GBR_NOT_PEER_REVIEWED_WARNING)
+score = glacier_buffer_replacement_score(
+    deficit_without_adaptation=[10.0, 10.0],
+    flow_gain_from_adaptation=[5.0, 0.0],
+)
+print(score)  # 0.25
+```
+
+## 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).