[general]
name=HydroSovereign AI Engine
qgisMinimumVersion=3.16
qgisMaximumVersion=3.99
description=HSAE v6.0.12: Transboundary water sovereignty. 26 basins, 17 tools, 6 Processing Algorithms, 6 original indices (ATDI/AHIFD/AFSF/AHLB/ASI/ATCI), Add Custom Basin, GeoAgent AI, WebGIS Map v2, UNWC 1997, SHA-256 chain
version=6.0.12
author=Seifeldin M.G. Alkhedir
email=saifeldinkhedir@gmail.com
about=HydroSovereign AI Engine (HSAE) v6.0.12 automates the full pipeline from live satellite observation to international water law compliance in under 2 minutes per basin. Free, open-source, GPL-3.0.
    Covers 26 globally contested basins using 9 GEE satellite sensors (GPM IMERG, GRACE-FO, SMAP, Sentinel-1/2, ERA5, Open-Meteo, MODIS, VIIRS).
    NEW in v6.0.10+: Add Custom Basin tool — analyse any worldwide basin by lat/lon, dam capacity, and dispute level using all 6 AWSI indices.
    NEW in v6.0.10+: Unified AWSI formula engine (core/indices.py) — ATDI calibrated to 43.6%% across all systems.
    Key results for Blue Nile (GERD): ATDI = 43.6%% (HIGH, Art.7 UNWC triggered), AHIFD = 19.7%%, NSE = 0.63, KGE = 0.74, CI = 0.48, P(Negotiation) = 55%%, ATCI = 70/100.
    17 tools plus 6 Processing Algorithms. Plugin ID: 5040. Approved by QGIS PSC (0 Critical, 0 Warnings). 456+ downloads, 20 countries.
    Peer-reviewed publication: Elsevier SoftwareX SOFTX-D-26-00442 (under review). Preprint: https://papers.ssrn.com/sol3/papers.cfm?abstract_id=6661396
    Archive DOI: https://doi.org/10.5281/zenodo.19180160
    Manual v6 (15 chapters): https://github.com/saifeldinkhedir-coder/HydroSovereign-AI-Engine-HSAE-v601/raw/main/hsae_qgis/HSAE_v601_QGIS_Plugin_Manual_v6.docx
tracker=https://github.com/saifeldinkhedir-coder/HydroSovereign-AI-Engine-HSAE-v601/issues
repository=https://github.com/saifeldinkhedir-coder/HydroSovereign-AI-Engine-HSAE-v601
hasProcessingProvider=yes
tags=hydrology,water,transboundary,ATDI,AHIFD,AFSF,ATCI,ASI,AHLB,UNWC,GEE,satellite,HBV,legal,Nile,Mekong,Euphrates,ICJ,PCA,negotiation,conflict,WebGIS,sovereignty,AI,machine-learning,custom-basin,open-source,uncertainty,treaty
homepage=https://plugins.qgis.org/plugins/hsae_qgis/
category=Vector
icon=icon.png
experimental=False
deprecated=False
changelog=
    v6.0.12 (June 2026) -- Strict scanner compliance:
    Flake8 now passes under the strict ruleset that ignores setup.cfg
    (isolated mode, inline noqa disabled): resolved E226, E241, E704,
    W503/W504, and E501 by restructuring formulas into intermediate
    variables and wrapping long HTML/JS builder strings -- 0 issues.
    Also unified remaining MEDIUM labels to MODERATE in plugin tables.

    v6.0.11 (June 2026) -- Code quality release:
    Flake8: 436 style issues resolved (now 0). Imports tailored per file,
    unused variables removed, long lines wrapped, PEP8 throughout.
    FIX: hifd_algorithm.py was still using the legacy AHIFD formula in
    its Processing Algorithm body -- now uses calibrated compute_ahifd().

    v6.0.10 (June 2026) -- Unified values hotfix:
    FIX: Risk Summary formula text updated to calibrated v6.0.10 formula
    (was showing legacy formula text while computing with new engine).
    FIX: Risk tiers unified across ALL tools to legal thresholds:
    CRITICAL >=60%% (Art.33) | HIGH >=40%% (Art.7 triggered) |
    MODERATE >=25%% (Art.5) | LOW <25%%.
    FIX: About tab tool count corrected to 17 tools + 6 Processing Algorithms.
    FIX: Corrected dispute levels for all 26 basins (GERD=4 Critical,
    Rhine=1 Low) and country counts (Danube 9, Mekong 6).
    All values now identical in Dashboard, WebGIS, Risk Map, Treaty Panel,
    Uncertainty Panel, 26-Basins Dialog, and Custom Basin tool.

    v6.0.9 (June 2026) -- Add Custom Basin + Unified Formula Engine:
    NEW Tool 17: Add Custom Basin — analyse any worldwide transboundary basin by lat/lon,
    dam capacity (BCM), riparian country count, and dispute intensity level.
    Auto-estimates runoff coefficient from lat/lon using Koppen-Geiger climate zones.
    Outputs all 6 AWSI indices + CI + Risk + triggered UNWC articles.
    Option to add result as QGIS vector point layer or session basin registry.
    NEW: core/indices.py — single source of truth for all AWSI formulas across 11 modules.
    FIX: ATDI calibrated to 43.6%% (was incorrectly 95%%) — now consistent across all systems.
    NEW: 6th Processing Algorithm: Custom Basin AWSI Analyser (QGIS Processing Toolbox).
    Updated to 17 tools + 6 Processing Algorithms.

    v6.0.8 (May 2026) -- GeoAgent integration + AHIFD name fix:
    Added Tool 16: GeoAgent Natural Language Query (opengeos/GeoAgent PR #79, merged by Prof. Qiusheng Wu).
    HSAE tools (9 @geo_tool functions) now part of opengeos/GeoAgent ecosystem.
    Fixed index name: HIFD -> AHIFD (Alkhedir Human-Induced Flow Deficit) throughout.

    v6.0.7 (May 2026) -- Publication links and name correction:
    Updated preprint link to SSRN: https://papers.ssrn.com/sol3/papers.cfm?abstract_id=6661396
    SoftwareX SOFTX-D-26-00442 confirmed under peer review.

    v6.0.6 (May 2026) -- Name correction plus metadata update:
    Corrected author name spelling to Alkhedir throughout all files.
    Added SSRN preprint and Zenodo archive DOI: https://doi.org/10.5281/zenodo.19180160

    v6.0.4 (April 2026) -- WebGIS Map v2:
    Added WebGIS Map v2 with Search, Layer Toggle, Basemap Switcher, Risk Filter, Chart.js popups.

    v6.0.3 (April 2026) -- Tools 14 15 16 plus Manual v6:
    Added Leaflet map inside QGIS Desktop, Bayesian Uncertainty Panel, Treaty Compliance Panel.

    v6.0.1 (April 2026) -- Official QGIS publication:
    Plugin ID 5040 approved. Security scan: 0 Critical, 0 Warnings.
