Metadata-Version: 2.5
Name: maqayis
Version: 1.0.0
Summary: Maqayis — Umbrella meta-package for Open Arabic Computational Philology, Sub-Lexical Algebra, Zero-LLM Retrieval, and Governed Scientific MT
Project-URL: Homepage, https://maqayis.org
Project-URL: Repository, https://github.com/maqayis/maqayis
Project-URL: Issues, https://github.com/maqayis/maqayis/issues
Author-email: Salah Abdo <Salah.Abdo.Tech@gmail.com>
License: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: arabic,computational-philology,diwan,maqayis,misbar,nlp,sarfchat,tarkib,tayf
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: Arabic
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: maqayis-diwan>=1.0.0
Requires-Dist: misbar>=1.0.0
Requires-Dist: sarfchat>=2.0.0
Requires-Dist: tarkib>=2.0.0
Requires-Dist: tayf>=1.0.0
Description-Content-Type: text/markdown

<div align="center">
  <img src="logo.png" width="140" height="140" alt="Maqāyīs Emblem" />
</div>

# مَقاييس · Maqāyīs — Umbrella Specification, Unified Web Portal & Edge Observatory

[![Portal: maqayis.org](https://img.shields.io/badge/Portal-maqayis.org-D4AF37)](https://maqayis.org)
[![Code License: Apache-2.0](https://img.shields.io/badge/Code-Apache--2.0-2563EB)](LICENSE)
[![Atlases & Book: CC BY 4.0](https://img.shields.io/badge/Book%20%26%20Atlases-CC%20BY%204.0-14B8A6)](NOTICE)

**Maqāyīs (`مَقاييس`)** is the open-source umbrella repository and unified web portal (`https://maqayis.org`) integrating six interconnected pillars of Arabic computational philology, sub-lexical linear algebra, Zero-LLM geometric retrieval, governed scientific machine translation, and open bilingual pedagogy.

---

## 1. Ecosystem Architecture

```
                         https://maqayis.org (Cloudflare Pages · $0/mo)
  ┌──────────────────┬──────────────────┬──────────────────┬──────────────────┐
  │ Book v2.0 & 10   │ Unified Lexicon  │ Zero-LLM Browser │ Governed MT      │
  │ Monographs       │ Al-Jadwal (28³)  │ Tarkīb + Tayf    │ X-Ray Reader +   │
  │ + 140 Concepts   │ Iqtirān (66)     │ 5-Law Switchboard│ Zero-Custody     │
  │ + 75 Claims      │ Dīwān + AWN4     │ (<5 ms JS)       │ BYOK Studio      │
  └────────┬─────────┴────────┬─────────┴────────┬─────────┴────────┬─────────┘
           │                  │                  │                  │
           ▼                  ▼                  ▼                  ▼
  ┌───────────────────────────────────────────────────────────────────────────┐
  │ Clean-Room Open-Source Packages & Datasets (github.com/maqayis/*)         │
  │ • maqayis/tarkib (v2.0.0)   • maqayis/tayf (v1.0.0)                       │
  │ • maqayis/diwan  (v1.0.0)   • maqayis/misbar (v1.0.0)  • maqayis/manhaj   │
  └───────────────────────────────────────────────────────────────────────────┘
```

---

## 2. Quickstart Across Packages

### Python SDKs (`tarkib`, `tayf`, `misbar`, `diwan`)

```bash
# Sub-lexical root algebra, OCP phonotactics, rasm Viterbi & Iqtirān 66-atom engine
pip install tarkib

# Zero-LLM Grassmannian, Ontological & Metaphor-Aware Arabic RAG Arena
pip install tayf

# Deterministic workflow tracing & blind RTL/LTR review queues
pip install misbar
```

### Unified Web Portal (`portal/`)

Zero external npm bundler bloat is required — the portal uses native ES modules, modular CSS tokens, and static JSON shards:

```bash
# Assemble and validate portal/dist/ (checks HTML links, UTF-8 JSON & Cloudflare Pages quotas)
python3 portal/build_portal.py

# Serve locally on http://localhost:8788
python3 -m http.server 8788 --directory portal/dist
```

### Zero-Cost Edge Observatory (`edge-worker/`)

```bash
# Run full Node.js WinterCG test suite (in-memory SQLite D1 harness)
node --test edge-worker/tests/worker.test.mjs
```

---

## 3. Licensing & Clean-Room Provenance Matrix

| Asset Class | Scope | License |
| :--- | :--- | :--- |
| **Software & Runtime Code** | `tarkib`, `tayf`, `diwan`, `misbar`, `manhaj` runtimes, `portal/`, `edge-worker/`, `scripts/` | **Apache License 2.0** (`Apache-2.0`) |
| **Scholarly Book & Monographs** | *Handasat al-Lisān al-ʿArabī* (`v2.0`) & 10 companion monographs | **CC BY 4.0** |
| **Public Lexical-Geometric Atlases** | `Al-Jadwal` (`11,249` roots), `Iqtirān` (`66` operators), `Dīwān` (`diwan_public.db`), `AWN4` (`120,630` synsets), `Tayf` arena | **CC BY 4.0** |
| **Public Academy Curriculum** | `Manhaj` computational linguistics & mathematical foundations tracks | **CC BY 4.0** |

All lexical statistics and classical root *uṣūl* in Maqāyīs public releases are derived strictly from open pre-modern Arabic corpora (**OpenITI**, including Ibn Fāris's *Maqāyīs al-Lugha*, al-Khalīl's *Kitāb al-ʿAyn*, al-Jawharī's *al-Ṣiḥāḥ*, Ibn Manẓūr's *Lisān al-ʿArab*, and al-Zabīdī's *Tāj al-ʿArūs*) with zero verbatim copyrighted modern dictionary prose.

---

## 4. Citation & Stewardship

- **Author:** Salah Abdo (`<Salah.Abdo.Tech@gmail.com>`)
- **Governance & Security:** See [`GOVERNANCE.md`](GOVERNANCE.md) and [`SECURITY.md`](SECURITY.md).
- **Machine-Readable Citation:** See [`CITATION.cff`](CITATION.cff) or click **Cite / BibTeX** on [https://maqayis.org](https://maqayis.org).
