Skip to content

RELEASE_REVIEW_CHECKLIST.md

Latest commit

 

History

History
114 lines (100 loc) · 7.18 KB

RELEASE_REVIEW_CHECKLIST.md

File metadata and controls

114 lines (100 loc) · 7.18 KB
Raw

قائمة مراجعة الإصدار

استخدم هذه القائمة قبل وضع tag أو نشر إصدار جديد.

التحقق المطلوب

python scripts/project_health.py

يشغل أمر الصحة الفحوص القياسية التالية:

python -m pytest -q -p no:cacheprovider
python scripts/generate_dictionary_docs.py --check
python scripts/generate_cli_docs.py --check
python scripts/generate_examples_index.py --check
python scripts/generate_standards_inventory_docs.py --check
python scripts/check_standards_inventory.py
python scripts/check_markup_completion.py --dictionary ar-web-v1.29
python scripts/check_web_development_completion.py
python scripts/check_tsjsx_completion.py
python scripts/check_ecosystem_readiness.py
python scripts/check_downstream_adapters.py
python scripts/check_framework_plugins.py
python scripts/check_final_product_gate.py
python scripts/generate_v1_3_release_review.py --check
python scripts/generate_v1_8_release_review.py --check
python scripts/generate_v1_13_release_review.py --check
python scripts/generate_v1_16_release_review.py --check
python scripts/generate_v1_19_release_review.py --check
python scripts/generate_v1_22_release_review.py --check
python scripts/check_project_status.py
python scripts/check_release.py
python -m arweb --version

يشغل CI أمر الصحة نفسه على Python 3.11 و3.12 و3.13.

التغليف

  • تأكد أن القواميس المرفقة داخل الحزمة تطابق مصادر القواميس في الجذر.
  • تأكد أن فحص التثبيت المؤقت في target نظيف ينجح.
  • تأكد أن فحص تثبيت source distribution ينجح.
  • تأكد أن MANIFEST.in يتضمن الوثائق، والأمثلة، والاختبارات، والسكربتات، والمواصفات، والقرارات، وملفات قواميس الحزمة.

الوثائق والأمثلة

  • تأكد أن docs/CLI.md مولد من parser.
  • تأكد أن docs/dictionaries/ مولد من قواميس JSON.
  • تأكد أن docs/STANDARDS_INVENTORY.md وdocs/coverage/ مولدة من manifests جرد المعايير.
  • تأكد أن بوابة اكتمال ترميز Phase F تنجح مع ar-web-v1.29.
  • تأكد أن بوابة اكتمال تطوير الويب في Phase I تنجح.
  • تأكد أن بوابة اكتمال TypeScript/JSX في Phase K تنجح مع ar-web-v1.31.
  • تأكد أن بوابة جاهزية منظومة Phase L تنجح.
  • تأكد أن بوابة جاهزية محولات Phase M downstream تنجح.
  • تأكد أن بوابة جاهزية framework plugin في Phase N تنجح.
  • تأكد أن بوابة المنتج النهائي تنجح من target install نظيف وأمثلة CLI حقيقية لمسارات .arhtml و.arts و.arjsx و.artsx.
  • تأكد أن docs/V1_3_RELEASE_REVIEW.md مولد من حقائق المشروع الحالية.
  • تأكد أن docs/V1_8_RELEASE_REVIEW.md مولد من حقائق المشروع الحالية.
  • تأكد أن docs/V1_13_RELEASE_REVIEW.md مولد من حقائق المشروع الحالية.
  • تأكد أن docs/V1_16_RELEASE_REVIEW.md مولد من حقائق المشروع الحالية.
  • تأكد أن docs/V1_19_RELEASE_REVIEW.md مولد من حقائق المشروع الحالية.
  • تأكد أن docs/V1_22_RELEASE_REVIEW.md مولد من حقائق المشروع الحالية.
  • تأكد أن docs/PHASE_G_RELEASE_REVIEW.md يسجل دليل اكتمال parser لـ CSS والقيود المعروفة ونقطة المتابعة التالية.
  • تأكد أن docs/PHASE_H_RELEASE_REVIEW.md يسجل دليل اكتمال parser لـ JavaScript والقيود المعروفة ونقطة المتابعة التالية.
  • تأكد أن docs/WEB_DEVELOPMENT_COMPLETION_REVIEW.md يسجل قرار النطاق الحالي النهائي، والبوابات النهائية، وأعداد المعايير المتتبعة، والقيود.
  • تأكد أن docs/PHASE_J_RELEASE_REVIEW.md يسجل دليل ترجمة TypeScript/JSX source-to-source والقيود المعروفة ونقطة المتابعة التالية.
  • تأكد أن docs/PHASE_K_RELEASE_REVIEW.md يسجل دليل اكتمال TypeScript/JSX والقيود المعروفة ونقطة المتابعة التالية.
  • تأكد أن docs/ECOSYSTEM_READINESS.md يسجل بيانات الحزمة، وconsole scripts، وحدود المصدر/الخرج، وتسليم toolchain، وما هو خارج النطاق.
  • تأكد أن docs/FRAMEWORK_PLUGIN_PACKAGES.md يسجل حدود local-preview ومعرفات plugin وتوافق المصدر/الخرج وما هو خارج النطاق.
  • تأكد أن docs/PHASE_N_RELEASE_REVIEW.md يسجل دليل framework plugin والقيود المعروفة ونقطة المتابعة التالية.
  • تأكد أن docs/PHASE_Q_RELEASE_REVIEW.md يسجل دليل حوكمة plugin plan والقيود المعروفة ونقطة المتابعة التالية.
  • تأكد أن docs/PHASE_T_RELEASE_REVIEW.md يسجل دليل جاهزية إصدار plugin execution attestation والقيود المعروفة ونقطة المتابعة التالية.
  • تأكد أن الأمثلة الذهبية تطابق خرج المترجم الحالي.
  • تأكد أن أمثلة الفشل ما زالت تصدر التشخيصات الموثقة.

الرؤية العامة والخصوصية

  • تأكد أن README.md محدث ويربط إلى الوثائق العامة.
  • تأكد أن docs/PUBLICATION_PRIVACY_REVIEW.md يعكس شجرة المرشح العام الحالية.
  • تأكد أنه لا توجد ملفات .env* أو مفاتيح خاصة أو شهادات أو رموز وصول أو مسارات جهاز محلي أو metadata خاصة بالـ agent/runner داخل شجرة المرشح العام.
  • تأكد أن أي assets ثنائية عامة أو مولدة للمشروع وآمنة للنشر.
  • تأكد أن LICENSE موجود وأن pyproject.toml ما زال يعلن ترخيص MIT.
  • إذا تغيرت رؤية المستودع، راجع سجل Git بحثا عن metadata محلية قديمة أو أسماء ملفات حساسة قبل تحويل remote إلى public.

ملاحظات الإصدار

  • حدّث RELEASE_NOTES.md.
  • حدّث PROJECT_STATUS.md.
  • سجل أي قيود معروفة باقية بعد الإصدار.
  • أبق L0-ECOSYSTEM-READINESS ظاهرا كنقطة متابعة حتى تتجاوزه خارطة أحدث.
  • أبق N0-FRAMEWORK-PLUGIN-PACKAGES ظاهرا كنقطة متابعة حتى تتجاوزه خارطة أحدث.
  • تأكد أن python scripts/check_plugin_execution_audit.py ينجح وأن دليل deterministic plugin audit automation يبقى plan-only/local-preview.
  • تأكد أن docs/PHASE_W_RELEASE_REVIEW.md يسجل دليل audit automation والقيود المعروفة ونقطة المتابعة التالية.
  • تأكد أن docs/PHASE_X_RELEASE_REVIEW.md يسجل إغلاق مراجعة إصدار audit automation والقيود المعروفة ونقطة المتابعة التالية.