Metadata-Version: 2.5
Name: mountain-governance-adaptation-utac
Version: 1.0.0
Summary: Mountain water governance and adaptation science -- real transboundary treaty status (Indus Waters Treaty, Colorado River Compact, Mekong Agreement), the mountain-specific adaptation finance gap, and Loss & Damage institutions (FRLD, WIM ExCom NEL framework) -- no simulated governance dynamics, no personal testimony as data, no UTAC/CREP bridge
Project-URL: Homepage, https://github.com/GenesisAeon/mountain-governance-adaptation-utac
Project-URL: Repository, https://github.com/GenesisAeon/mountain-governance-adaptation-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

# mountain-governance-adaptation-utac

GenesisAeon Package 104 — the governance/institutional closing chapter
of the P99–P103 series. **Deliberately has no UTAC/CREP/AFET bridge**
— see [DISCLAIMER.md](DISCLAIMER.md).

## What this is, and what it deliberately is not

This package documents **real, dated institutional facts** — treaties,
funds, negotiation status — as citable data. It does **not** simulate
governance dynamics (no actor-network models, no allocation-rule
solvers, no predicted outcomes). That distinction was a deliberate
scope decision: P99–P103's whole methodology works because a stress
value or a sedimentation rate can be independently verified against a
paper. Political process can't be reduced to that kind of code
honestly — so this package sticks to documenting what is real and
dated, not modeling how governance "works."

It also **deliberately excludes personal and indigenous testimony**
about non-economic losses (e.g. statements made at COP29 by affected
community members) from its data. Encoding grief and lived experience
as a Python constant next to a funding figure would be a category
error, not a simplification. If you want that testimony, go to its
original source — the COP29 proceedings and UNFCCC WIM ExCom
documentation — where it is properly attributed and contextualized,
not flattened into a citation string.

## Two confidence tiers

- **Core** (`transboundary_governance`, `loss_and_damage`, most of
  `national_adaptation`): real, dated institutional facts independently
  re-verified 2026-08-14/15.
- **Documented** (two NDC/NAP percentages in `national_adaptation`):
  carried over from the source dialogue without the same independent
  re-verification this session — flagged via `DOCUMENTED_TIER_WARNING`.

## What's real here

- **Indus Waters Treaty** (1960) — suspended by India on 2025-04-23,
  still suspended as of mid-2026. A 65-year, war-surviving treaty,
  suspended for non-hydrological reasons.
- **Colorado River Compact** (1922) — 16.5 MAF/yr nominal allocation
  against a real natural flow that's declined ~19% from the
  20th-century average, with Upper Basin, Lower Basin and (for the
  first time) Tribal Nations in active 2025 renegotiation.
- **Mekong Agreement** (1995) — Cambodia/Laos/Thailand/Vietnam bound by
  real obligations; China and Myanmar (the two upper-basin states) are
  only dialogue partners, not bound — a real structural asymmetry.
- **The mountain-specific adaptation finance gap**, corrected from the
  source dialogue's generalized global figure: mountainous developing
  countries need an estimated ~$187bn/yr but received only ~$13.8bn in
  2022 — about 7% coverage.
- **The Fund for responding to Loss and Damage (FRLD)** — real,
  operational since COP29 (2025), hosted by the World Bank, Philippines
  as host country, $822.06M pledged by 27 partners as of 2026-03-15
  (24 of whom have actually signed contribution agreements).
- **UNFCCC WIM ExCom's second Non-Economic Losses Plan of Action**
  (Oct 2025–Oct 2027) and its real institutional NEL categories (loss
  of life, health, mobility, territory, cultural heritage, local/
  indigenous knowledge) — corroborated by Islar et al. (2025)'s
  socio-glaciology framework, already cited in this ecosystem's P103.

## Quickstart

```bash
pip install mountain-governance-adaptation-utac
```

```python
from mountain_governance_adaptation_utac import (
    INDUS_WATERS_TREATY,
    colorado_river_current_deficit_maf,
    mountain_adaptation_finance_gap_usd_billions_per_yr,
    FRLD_CURRENT_STATUS,
    nel_categories,
    TESTIMONY_EXCLUSION_NOTE,
)

print(INDUS_WATERS_TREATY.status_note)
print(colorado_river_current_deficit_maf())              # ~5.7 MAF/yr
print(mountain_adaptation_finance_gap_usd_billions_per_yr())  # ~173.2
print(FRLD_CURRENT_STATUS.pledged_usd_millions)            # 822.06
print(nel_categories())

print(TESTIMONY_EXCLUSION_NOTE)
```

## 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).
