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

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)

# 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:

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

# 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

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 and SECURITY.md.
• Machine-Readable Citation: See CITATION.cff or click Cite / BibTeX on https://maqayis.org.