mws-lab 1.0.0__tar.gz

mws_lab-1.0.0/AUTHORS.md

@@ -0,0 +1,134 @@
+# Morocco_Water_Scarcity — Authors and Contributors
+
+## Principal Investigator
+
+**Samir Baladi**
+
+*Role:* Interdisciplinary AI Researcher — Conceptual architecture, study
+design, data curation, formal analysis, methodology, software, validation,
+and manuscript preparation.
+
+*Contact:* gitdeeper@gmail.com
+
+*ORCID:* [0009-0003-8903-0029](https://orcid.org/0009-0003-8903-0029)
+
+*Affiliation:* Ronin Institute / Rite of Renaissance
+
+---
+
+## Manuscript Status
+
+This project is a **completed research release** (`1.0.0`).
+
+The manuscript, seven figures, the World Bank data extract, the analysis
+pipeline, the Python build artifacts, and the project website are all
+included in this release. An external review was completed on 2026-11-02.
+
+The analysis is **exploratory and associational**; no causal claims are made.
+
+---
+
+## Conceptual and Methodological Foundations
+
+The research draws on five intersecting domains:
+
+### 1. Environmental and Earth Sciences
+- Freshwater resource assessment.
+- Water scarcity indicators (Falkenmark, water-stress index).
+- Climate and rainfall variability.
+- Groundwater depletion and dam storage dynamics.
+
+### 2. Agricultural and Water Policy
+- Agricultural water demand.
+- Irrigation efficiency.
+- Water reuse and desalination capacity.
+- National water strategy (Morocco's 2025 State of the Environment Report).
+
+### 3. Statistics and Econometrics
+- Ordinary least squares regression.
+- Multicollinearity diagnostics (VIF, condition number).
+- Confidence intervals and hypothesis testing.
+- Correlation analysis (Pearson matrix).
+
+### 4. Data Science and Reproducibility
+- World Bank WDI data extraction.
+- Reproducible analysis pipeline (Python 3.9+).
+- Versioned datasets and fixed seeds.
+
+### 5. Science Communication and Open Research
+- Open data licensing (CC-BY-4.0 for World Bank data).
+- Open manuscript (CC-BY-4.0).
+- Open code (MIT).
+- Zenodo DOI deposit for permanent citation.
+
+---
+
+## CRediT Contributor Roles
+
+Per the [Contributor Roles Taxonomy (CRediT)](https://credit.niso.org/):
+
+| Role | Contributor |
+|------|-------------|
+| Conceptualization | Samir Baladi |
+| Data curation | Samir Baladi |
+| Formal Analysis | Samir Baladi |
+| Funding acquisition | — (none) |
+| Investigation | Samir Baladi |
+| Methodology | Samir Baladi |
+| Project administration | Samir Baladi |
+| Resources | — (none) |
+| Software | Samir Baladi |
+| Supervision | Samir Baladi |
+| Validation | Samir Baladi |
+| Visualization | Samir Baladi |
+| Writing — original draft | Samir Baladi |
+| Writing — review & editing | Samir Baladi |
+
+---
+
+## Institutional Support
+
+- **Status:** None confirmed.
+- **Pending:** Institutional review board (not required — public data only).
+- **Pending:** Compute resources (analysis runs on commodity hardware).
+
+---
+
+## Funding
+
+**Status:** No external funding confirmed.
+
+**Future funding targets:**
+- Extended analysis across additional MENA countries.
+- Confirmatory study with causal identification.
+- Replication dataset.
+
+---
+
+## How to Contribute
+
+This is a completed research release. Contributions at this stage are limited to:
+
+- Corrections (typos, metadata, references).
+- Reproducibility fixes (dependency issues, script bugs).
+- Packaging improvements.
+- Documentation clarity.
+
+See [`CONTRIBUTING.md`](CONTRIBUTING.md) for guidelines.
+
+---
+
+## Contact
+
+- Scientific inquiries: gitdeeper@gmail.com
+- ORCID: https://orcid.org/0009-0003-8903-0029
+- Zenodo DOI: https://doi.org/10.5281/zenodo.23884236
+- PyPI: https://pypi.org/project/mws-lab/
+- Figshare: https://doi.org/10.6084/m9.figshare.34884417
+- Figshare: https://doi.org/10.6084/m9.figshare.34884417
+- Repository issues: TBD (GitHub repository pending)
+
+---
+
+**Last Updated:** 2026-11-02
+**Current Version:** 1.0.0

mws_lab-1.0.0/CHANGELOG.md

@@ -0,0 +1,148 @@
+# Morocco_Water_Scarcity — Changelog
+
+All notable changes to this research project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [1.0.0] — 2026-11-02
+
+### Initial Research Release
+
+First public research release of **Water Scarcity in Morocco: A Multivariate
+Analysis of Climatic, Agricultural, and Socioeconomic Drivers**.
+
+This release includes the full manuscript, seven figures, the World Bank data
+extract, the analysis pipeline, the Python build artifacts, and the project
+website. The analysis is **exploratory and associational**; no causal claims
+are made.
+
+### Added — Research Manuscript
+
+- `PUBLICATION/water_scarcity_morocco.pdf` — full manuscript (1.3 MB).
+- `PUBLICATION/credit_table.md` — CRediT contributor roles.
+- Abstract, methodology, results, limitations, and policy implications
+  covering Morocco's freshwater trajectory from 2000 to 2025.
+
+### Added — Figures (7)
+
+- `PUBLICATION/figures/Figure_1_Conceptual_Framework.png`
+- `PUBLICATION/figures/Figure_2_Methodology_Flowchart.png`
+- `PUBLICATION/figures/Figure_3_Selected_Water_Indicators.png`
+- `PUBLICATION/figures/Figure_4_Water_Allocation.png`
+- `PUBLICATION/figures/Figure_5_Rainfall_and_Reservoir_Indicators.png`
+- `PUBLICATION/figures/Figure_6_Correlation_Matrix.png`
+- `PUBLICATION/figures/Figure_7_OLS_Regression_Results.png`
+
+### Added — Data
+
+- `DATA/raw/worldbank_data.csv` — World Bank WDI extract (16 KB).
+- `DATA/raw/fetch_worldbank_data.py` — reproducible data-fetch script.
+- `DATA/raw/input.json` — indicator configuration.
+
+### Added — Analysis
+
+- `ANALYSIS/ANALYSIS_REPORT.md` — analysis summary.
+- `ANALYSIS/analysis_insights.json` — structured insights.
+- OLS regression with full diagnostics (VIF, condition number, CIs).
+- Pairwise Pearson correlation matrix.
+- Descriptive statistics and trend summaries.
+
+### Added — Publication Artifacts
+
+- `PUBLICATION/Netlify/` — project website
+  (`index.html`, `dashboard.html`, `documentation.html`, `reports.html`,
+  `assets/style.css`, `project.json`).
+- `PUBLICATION/dist/` — Python package artifacts
+  (`morocco-water-scarcity-1.0.0-py3-none-any.whl`,
+  `morocco-water-scarcity-1.0.0.tar.gz`).
+- `PUBLICATION/manifest.json`, `PUBLICATION/output_summary.txt`.
+- `PUBLICATION/ste_website_steering.json`, `PUBLICATION/netlify.toml`.
+
+### Added — Governance and Audit
+
+- `EXTERNAL_REVIEW/` — external review record (2026-11-02).
+- `REPORTS/dpia_report.md`, `REPORTS/dpia_report.json` — data protection
+  impact assessment.
+- `REPORTS/compliance_audit_report.json`.
+- `REPORTS/citation_report.md`, `REPORTS/reference_alignment_report.json`,
+  `REPORTS/reference_audit_report.json`, `REPORTS/reference_resolver_report.json`.
+- `REPORTS/evaluation_report.json`, `REPORTS/feedback_report.json`.
+- `REPORTS/results_consistency_report.json`, `REPORTS/review_sync_report.json`.
+- `VALIDATION/.lock/language_lock_report.json`.
+
+### Added — Documentation
+
+- `README.md` — full project overview (460 lines, 8 badges).
+- `AUTHORS.md` — author and contributor record.
+- `CITATION.cff` — citation metadata with Zenodo DOI and ORCID.
+- `CHANGELOG.md` — this file.
+- `CONTRIBUTING.md` — contribution guidelines.
+- `LICENSE` — MIT (code) and CC-BY-4.0 (manuscript, figures, documentation).
+- `docs/ITERATION_LOG.md` — iteration history.
+- `docs/comprehensive_audit_report.json` — consolidated audit.
+
+### Added — Project Infrastructure
+
+- `VERSION` — `1.0.0`.
+- `requirements.txt` — Python dependencies.
+- `pyproject.toml` — project metadata.
+- `MANIFEST.in` — distribution manifest.
+- `.gitignore` — standard Python/OS/IDE ignores.
+- `FINAL_REPORT.json` — pipeline execution record (70 agents).
+- `scientific_state.json` — internal scientific state record.
+
+### Status
+
+| Dimension | Status |
+|-----------|--------|
+| Manuscript | Complete (PDF) |
+| Figures | 7 included |
+| Data | World Bank WDI (5 indicators) |
+| Analysis | OLS with diagnostics |
+| Sample | n = 16 (model sample) |
+| Model R² | 0.812 |
+| Package | Built (`dist/`) |
+| Website | Built (Netlify) |
+| Quality gate | PASSED |
+| Causal claims | None (associational) |
+| External review | Completed (2026-11-02) |
+
+---
+
+## Roadmap
+
+### 1.0.1 — Maintenance
+
+- Fix any packaging issues discovered post-release.
+- Correct typos or metadata inconsistencies.
+- Update DOI if re-published on Zenodo.
+
+### 1.1.0 — Extended Analysis (planned)
+
+- Extend the sample beyond 2000–2025 if new data becomes available.
+- Sensitivity analysis across alternative indicator definitions.
+- Supplementary figures for policy scenarios.
+
+### 2.0.0 — Confirmatory Study (planned)
+
+- Pre-registered design.
+- Causal identification strategy (e.g., panel methods or natural experiments).
+- External replication dataset.
+
+---
+
+## Notes on the Changelog
+
+- Substantive changes only.
+- Any change to the analysis protocol after release is recorded as an
+  amendment with explicit rationale.
+- Numeric thresholds and diagnostic cutoffs follow standard practice
+  (e.g., VIF, condition number) and are not tuned to results.
+
+---
+
+**Last Updated:** 2026-11-02
+**Current Version:** 1.0.0

mws_lab-1.0.0/CITATION.cff

@@ -0,0 +1,58 @@
+cff-version: 1.2.0
+title: "Water Scarcity in Morocco: A Multivariate Analysis of Climatic, Agricultural, and Socioeconomic Drivers"
+message: "If you use this research, data, or code, please cite as below."
+type: software
+version: "1.0.0"
+date-released: "2026-11-02"
+license: MIT
+abstract: |
+  An exploratory associational analysis of the climatic, agricultural,
+  and socioeconomic drivers of national freshwater withdrawals in Morocco
+  (2000-2025). The study uses five publicly available World Bank
+  indicators, supplemented by national indicators from Morocco's 2025
+  State of the Environment Report, and applies ordinary least squares
+  regression with full diagnostics (VIF, condition number, confidence
+  intervals).
+
+  Key findings include a model R-squared of 0.812 on a sample of n = 16,
+  with agricultural water demand emerging as the dominant driver of
+  withdrawal trajectories. Morocco's renewable freshwater per capita
+  fell from approximately 2,560 cubic meters per year in 1960 to about
+  620 cubic meters in 2020, well inside the United Nations absolute
+  water-scarcity threshold.
+
+  The analysis is explicitly exploratory and associational. It is not
+  designed to establish causal attribution, and its conclusions should
+  be read as hypothesis-generating rather than confirmatory.
+keywords:
+  - water scarcity
+  - morocco
+  - world bank indicators
+  - OLS regression
+  - environmental science
+  - water policy
+  - agricultural water demand
+  - climate change
+  - freshwater withdrawals
+authors:
+  - family-names: "Baladi"
+    given-names: "Samir"
+    email: "gitdeeper@gmail.com"
+    orcid: "https://orcid.org/0009-0003-8903-0029"
+    affiliation: "Ronin Institute / Rite of Renaissance"
+repository-code: "TBD"
+url: "https://mws-lab.netlify.app"
+url: "https://doi.org/10.5281/zenodo.23884236"
+identifiers:
+  - type: doi
+    value: "10.5281/zenodo.23884236"
+  - type: doi
+    value: "10.6084/m9.figshare.34884417"
+  - type: url
+    value: "https://doi.org/10.5281/zenodo.23884236"
+  - type: url
+    value: "https://doi.org/10.6084/m9.figshare.34884417"
+  - type: url
+    value: "https://mws-lab.netlify.app"
+  - type: url
+    value: "https://pypi.org/project/mws-lab/"

mws_lab-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,105 @@
+# Contributing to Morocco_Water_Scarcity
+
+**Water Scarcity in Morocco: A Multivariate Analysis of Climatic, Agricultural, and Socioeconomic Drivers**
+
+---
+
+## Status
+
+This project is a **completed research release** (`1.0.0`). The manuscript,
+figures, data, and analysis pipeline are published.
+
+Contributions at this stage are limited to:
+
+- **Corrections**: typos, incorrect references, metadata errors.
+- **Reproducibility fixes**: dependency issues, broken scripts.
+- **Packaging fixes**: build artifacts, file structure.
+- **Documentation clarity**: ambiguities in README or methodology.
+
+**Not accepted at this stage:**
+
+- New analyses that change the reported findings.
+- Changes to the OLS specification or indicator definitions.
+- Rewriting the manuscript's conclusions.
+- New dependencies unless justified as a reproducibility fix.
+
+For extensions (new analyses, sensitivity checks, confirmatory studies),
+open an issue first to discuss scope.
+
+---
+
+## Reporting Issues
+
+Open an issue with:
+
+- A one-sentence description.
+- The affected file (e.g., `README.md`, `DATA/raw/fetch_worldbank_data.py`).
+- A minimal reproduction or screenshot.
+- Expected vs. actual behavior.
+
+---
+
+## Submitting Corrections
+
+```bash
+git checkout -b fix/short-description
+# make changes
+git commit -m "fix: short description"
+git push origin fix/short-description
+```
+
+Then open a pull request. Each PR should address one concern.
+
+---
+
+Code Standards
+
+Language Standard
+Python PEP 8, black (88 chars), isort, flake8
+Markdown markdownlint (MD013 disabled)
+YAML yamllint
+
+Reproducibility: every code change must reproduce the results reported in
+PUBLICATION/water_scarcity_morocco.pdf on a clean environment. If a change
+alters any reported number (R², coefficients, p-values), it is not a
+correction — open an issue to discuss.
+
+---
+
+Data Provenance
+
+Data under DATA/raw/ originates from:
+
+· World Bank WDI — public domain (CC-BY-4.0), see
+  .
+· Morocco 2025 State of the Environment Report — cited per source terms.
+
+Do not commit derived data that is not reproducible from the scripts in
+DATA/raw/. Do not commit personal or sensitive data (none exists in the
+current dataset).
+
+---
+
+Review Process
+
+· All changes are reviewed by the maintainer (Samir Baladi).
+· Changes to the manuscript, figures, or reported numbers require explicit
+  documentation in CHANGELOG.md with rationale.
+· After the 1.0.0 release, any change to reported findings would require a
+  new version (e.g., 1.1.0) with a new DOI deposit on Zenodo.
+
+---
+
+Contact
+
+· Email: gitdeeper@gmail.com
+· ORCID: https://orcid.org/0009-0003-8903-0029
+· Zenodo DOI: https://doi.org/10.5281/zenodo.23884236
+· PyPI: https://pypi.org/project/mws-lab/
+· Figshare: https://doi.org/10.6084/m9.figshare.34884417
+· Figshare: https://doi.org/10.6084/m9.figshare.34884417
+· Website: https://mws-lab.netlify.app
+
+---
+
+Thank you for helping improve the reproducibility of this research.

mws_lab-1.0.0/LICENSE

@@ -0,0 +1,110 @@
+MIT License
+
+Copyright (c) 2026 Samir Baladi
+
+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.
+
+---
+
+## Scope of This License
+
+The MIT License above applies to:
+
+- All source code in this repository, including
+  `DATA/raw/fetch_worldbank_data.py` and any auxiliary scripts.
+- The Python package artifacts under `PUBLICATION/dist/`
+  (`morocco-water-scarcity-1.0.0-py3-none-any.whl` and `.tar.gz`).
+- Configuration files such as `PUBLICATION/netlify.toml`,
+  `PUBLICATION/ste_website_steering.json`, and `requirements.txt`.
+- Build and infrastructure files (`VERSION`, `.gitignore`).
+
+## Separate Licensing for Manuscript, Figures, and Documentation
+
+The following are licensed under **Creative Commons Attribution 4.0
+International (CC-BY-4.0)**, not MIT:
+
+- `PUBLICATION/water_scarcity_morocco.pdf` — the research manuscript.
+- `PUBLICATION/figures/` — all seven figures (Figure 1 through Figure 7).
+- `README.md` — repository documentation.
+- `AUTHORS.md`, `CHANGELOG.md`, `CITATION.cff` — project documentation.
+- `ANALYSIS/ANALYSIS_REPORT.md`, `ANALYSIS/analysis_insights.json` — analysis narrative.
+- `docs/` — iteration log and consolidated audit report.
+
+This distinction reflects standard practice:
+
+- **Code** is licensed permissively (MIT) to allow reuse, modification,
+  and redistribution.
+- **Written research artifacts** (manuscript, figures, documentation) are
+  licensed under CC-BY-4.0 to allow sharing and adaptation with attribution.
+
+## Data Licensing
+
+The data files under `DATA/raw/` originate from the World Bank's
+World Development Indicators (WDI) and Morocco's 2025 State of the
+Environment Report. Their original licensing terms are governed by the
+respective data providers:
+
+- World Bank Open Data is available under the
+  [Creative Commons Attribution 4.0 International License (CC-BY-4.0)](https://datacatalog.worldbank.org/public-licenses).
+- Indicators from Morocco's 2025 State of the Environment Report are used
+  for scholarly analysis; users should consult the original source for
+  redistribution terms.
+
+The curated extract `DATA/raw/worldbank_data.csv` is distributed here under
+CC-BY-4.0 with attribution to the World Bank.
+
+## Attribution
+
+For code use:
+
+```
+
+Baladi, S. (2026). Water Scarcity in Morocco: Analysis Pipeline
+(Version 1.0.0) [Computer software].
+
+```
+
+For manuscript or figure citation:
+
+```
+
+Baladi, S. (2026). Water Scarcity in Morocco: A Multivariate Analysis of
+Climatic, Agricultural, and Socioeconomic Drivers [Research manuscript,
+v1.0.0]. https://doi.org/10.5281/zenodo.23884236
+
+```
+
+## Scope of the Research Claims
+
+This work is an **exploratory and associational** analysis of Morocco's
+freshwater trajectory between 2000 and 2025. It is explicitly **not**
+designed to establish causal attribution. Conclusions should be read as
+hypothesis-generating rather than confirmatory.
+
+The manuscript reports an OLS model with an R-squared of 0.812 on a model
+sample of n = 16. These results are conditional on the specific indicator
+definitions, time window, and model specification documented in the
+manuscript. Reuse of the code does not imply endorsement of the empirical
+findings by the author.
+
+---
+
+**Version:** 1.0.0
+**Date:** 2026-11-02
+**Copyright:** 2026 Samir Baladi

mws_lab-1.0.0/MANIFEST.in

@@ -0,0 +1,26 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+include CITATION.cff
+include AUTHORS.md
+include CONTRIBUTING.md
+include requirements.txt
+include VERSION
+
+recursive-include mws_lab/data *.csv *.json
+
+prune .venv
+prune .git
+prune __pycache__
+prune PUBLICATION
+prune DATA
+prune ANALYSIS
+prune REPORTS
+prune EXTERNAL_REVIEW
+prune VALIDATION
+prune docs
+prune dist
+prune build
+
+global-exclude *.pyc
+global-exclude *.pyo