Skip to content

research: publish Quranic parser v4 independent handoff - #1

Open
sultanAalyami wants to merge 2 commits into
mainfrom
research/quranic-parser-v4-handoff
Open

research: publish Quranic parser v4 independent handoff#1
sultanAalyami wants to merge 2 commits into
mainfrom
research/quranic-parser-v4-handoff

Conversation

@sultanAalyami

Copy link
Copy Markdown
Member

Purpose

Publish a sanitized, buildable handoff of the ADG-Lang Quranic parser for independent research evaluation.

Included

  • Quranic parser, corpus importer, grammar contracts, runtime API, bounded diacritic tooling, and non-normative corpus/knowledge-root generators
  • historical v1-v4 release dossiers and the immutable v4 61-artifact Merkle manifest
  • authoritative researcher handoff, reproduction guide, claim matrix, known limitations, approval gates, evidence register, and Kanban
  • pinned GitHub Actions, Dependabot configuration, private vulnerability reporting guidance, and a disclosure audit
  • upstream attribution/provenance templates without raw QAC or UD data

Reproduced before publication

  • both .NET 10 solutions: 0 warnings, 0 errors
  • bounded causal corpus: 16/16
  • syntax property suite: 325/325
  • morphology score policy: 63 factors
  • v4 release root: 5c4a24c81c9e5154f435c72f47e5dca7f8ebf60341b96105e5b3bec38b60c026
  • regenerated v4 manifest: no diff
  • public disclosure audit: PASS; no raw corpora, JSONL artifacts, symbolic links, oversized files, local paths, credentials, or private reviewer identifiers

Binding claim boundary

This is an ordinary deterministic Tool plus separate non-normative Data artifacts. The software release is reproducible, but the Quranic research lane remains NOT APPROVED. No CNS Model, CGN, Genius, normative-training, unrestricted Quranic correctness, or natural-Arabic readiness claim is authorized.

The v4 source retains a historical Arabic-PUD role label because it is Merkle-bound. The current classification and the reason it cannot be silently rewritten are explicit in KNOWN-LIMITATIONS.md and THIRD_PARTY/ud-arabic-padt/CURRENT-EVALUATION-BOUNDARY.md.

Start review here

  1. docs/research/quranic-core-v1/INDEPENDENT-RESEARCHER-HANDOFF.md
  2. docs/research/quranic-core-v1/REPRODUCTION-GUIDE.md
  3. docs/research/quranic-core-v1/CLAIM-BOUNDARIES.md
  4. docs/research/quranic-core-v1/KNOWN-LIMITATIONS.md
  5. docs/research/quranic-core-v1/INDEPENDENT-REVIEW-CHECKLIST.md

Gates intentionally still open

  • official email-gated QAC v0.4 hash comparison
  • independent scholarly authority for each rule
  • normative leakage-safe split materialization
  • explicit repository software license and complete derived-data rights review
  • signed/tagged or third-party archival snapshot
  • external evaluator attestation
  • separate audited CNS Model/CGN/Genius lanes

This PR is intentionally draft and must not be treated as research approval merely because CI passes.

Add the buildable Quranic parser source, immutable release evidence,
independent-researcher documentation, disclosure gates, and reproducible CI.
Preserve the NOT APPROVED research boundary and exclude raw corpora and
private review artifacts.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@sultanAalyami sultanAalyami added the research Research evidence, review, and reproducibility label Aug 5, 2026
Bind the public draft PR and successful reproduction and CodeQL checks into
the canonical Quranic research Kanban while keeping merge and external review
open.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@sultanAalyami
sultanAalyami marked this pull request as ready for review August 13, 2026 08:34
@sultanAalyami

Copy link
Copy Markdown
Member Author

دعوة مفتوحة لمعلمي اللغة العربية وخبرائها

أصبحت واجهة التحكيم العربية المستقلة متاحة الآن على:

https://adg.sbay.sa

لا تتطلب الواجهة حساب GitHub أو خبرة تقنية. تشرح المهمة بالأمثلة، وتخفي نتائج البارسر حفاظًا على استقلال الحكم، وتسمح بحفظ العمل والعودة إليه باستخدام مفتاح المرور Passkey (الوجه أو البصمة أو رمز الجهاز أو مفتاح أمان).

ما توفره للمحكّم:

  • خطوات عربية واضحة لتحليل الجمل والكلمات والعلاقات النحوية والإعرابية.
  • تصميم متوافق مع الهاتف المحمول.
  • حفظ مشفر للمسودة وإكمالها لاحقًا.
  • عدم طلب رقم هاتف؛ يمكن إضافة أسماء مستخدم اختيارية مثل واتساب وX وتيك توك، وتبقى مشفرة وخارج GitHub.
  • زر مشاركة جاهز للدعوة عبر واتساب وX/تويتر أو نسخ النص.

تُرسل النتيجة اللغوية فقط باسم مستعار إلى قناة فحص ومراجعة، بينما تبقى هوية المحكّم منفصلة ومشفرة. العينة الأولى تختبر وضوح حالة الاستخدام والبروتوكول، ولا تتحول وحدها إلى ادعاء بجاهزية البارسر.

نرحب بمشاركة الرابط مع أساتذة النحو والصرف وتعليم العربية واللسانيات والعربية القرآنية.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

research Research evidence, review, and reproducibility

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant