حِزَم الأدلّة

حزمة الأدلّة دليلٌ ذاتي الوصف من جداول إحصائية، وأشكال SVG ميسورة الوصول، وملحق من الصفوف المستبعَدة أو المحجوبة، كلها مشتقّة من حملة واحدة مكتملة ومُرشَّحة إلى طبقة أدلّة واحدة. يُنظّم DispatchAtlas الأدلّة المُصدَّرة في هذه الحِزَم المُدرَّجة بحيث تكشف كل حزمة فقط البيانات التي تسمح بها طبقة أدلّتها.

🪜 طبقات الحزمة

تأتي معرّفات الطبقات الأربعة من مفردات ثابتة آمنة للعموم. كل طبقة سياسة إفصاح قابلة للتنفيذ، لا وسمًا تحريريًّا:

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

📁 محتوى الحزمة

تحتوي الحزمة على:

• جداول إحصائية (ملخّصات الحلّالات، والمقارنات الزوجية، والترتيبات، وتغطية النسخ المرجعية، والصفوف غير المجدية)،
• أشكال SVG ميسورة الوصول مع بيان أشكال يُسجّل دور كل شكل وأصله وملاحظة وصوله،
• ملحق يُسجّل الصفوف المستبعَدة أو المحجوبة وكل طريقة وُجِّهت إلى القيود،
• bundle.json، البيان الذي يَسرد كل ملف مُولَّد ويُجزّئ حمولة البيان المعيارية.

راجع صادرات التحليل للتخطيط الكامل للحزمة وللطرائق الإحصائية وراء كل جدول وشكل.

⚙️ كيف تُنتَج الحِزَم

تُصدِّر حملة واحدة إلى حزمة واحدة لكل طبقة عبر أمر التصدير:

uv run dispatchatlas export `
  --campaign-dir .\experiments\results\smoke-pilot `
  --target-dir .\experiments `
  --authorized-output-root .\experiments `
  --tier core

تَحُطّ الحزمة في evidence-bundles/{campaign_id}-{tier}/ تحت مساحة العمل الهدف — طبقة التنسيق في مساحة عمل التجارب. وعلى نطاق واسع، يبني tools/build_campaign_evidence.py كتالوجات نسخ مرجعية مرشَّحة، ويشغّل الحملات المُهيّأة، ويُجري التحليل، ويكتب الحِزَم لكل طبقة إضافةً إلى مجموعة بيانات بوابة من تهيئة واحدة مُسجَّلة:

uv run python tools/build_campaign_evidence.py `
  --output-root .\experiments `
  --problem-count-per-profile 30 `
  --stochastic-seeds 10 `
  --campaign-suffix local

يُصدِر الباني تقدّم المراحل إلى stderr لتجسيد الكتالوج، وتخطيط الحملة، والتنفيذ، والتحليل، وتصدير الحزمة، وكتابة التقرير، ويكتب الأدلّة المولَّدة عمدًا خارج أشجار المصدر المتعقَّبة بـ Git.

✅ كيف تُتحقَّق الحِزَم

• تجزئة البيان. يَسرد bundle.json كل ملف مُولَّد ويُجزّئ حمولة البيان المعيارية، فيكون محتوى الحزمة قابلًا للفحص إزاء بيانها الخاص.
• الحتمية. تُنتِج إعادةُ تشغيل التصدير نفسه إزاء المدخلات نفسها حمولات JSON وجداول وأشكال متطابقة.
• اشتقاق لا سلطة. تُشتقّ الحزمة دائمًا من سجلّات مستوى التشغيل في طبقة قابلية إعادة الإنتاج — لا مصدر حقيقة مستقلًّا أبدًا — وتلك السجلّات نفسها مُجزَّأة بالمحتوى وقابلة للتحقّق بإعادة التشغيل عبر محرّك الحملات.
• ترقية مُبوَّبة. لا تصل الحِزَم إلى الأسطح العامة إلّا عبر بوّابات الإصدار والإفصاح الموصوفة في جاهزية الإصدار.

تنعكس طبقاتُ الأدلّة على مفردات ACM Artifact Review and Badging، الإصدار 1.1 (2020)، مقروءةً إلى جانب إرشاد التحسين العشوائي لـ López-Ibáñez وBranke وPaquete (2021). فأيُّ حزمة طبقة مع bundle.json المُجزَّأ بالمحتوى وبيان الأشكال جاهزةٌ لوسم Artifacts Evaluated — Functional؛ وحزمةٌ منشورة عبر البوابة العامة جاهزةٌ لـ Artifacts Available؛ وحزمة حملة كاملة يُثبِّت بيانُ قابلية إعادة إنتاجها البذورَ والبيئةَ وحدَّ التشغيل وتكافؤ الميزانية والضبط جاهزةٌ لـ Results Reproduced. أما Results Replicated فيستدعي تطبيقًا مستقلًّا مبنيًّا من أوصاف الطريقة المكتوبة وحدها، وهو ما لا تستطيع أي منصّة منحه عن نفسها — مذكورٌ هنا كي يبقى الانعكاسُ أمينًا.

🌐 ما الذي تستهلكه البوابة

تستهلك بوابة النتائج مجموعة بيانات البوابة التي يُنتِجها مسار التصدير نفسه (portal-results.json إضافةً إلى فهرس CSV) — وسوم قابلة للبحث، ووسوم إفصاح، وقيم أهداف، ومعرّفات تشغيل، وبيانات حملة وصفية مرتبطة بالتجزئة — مُحوَّلةً إلى أصول موقع ساكنة بواسطة tools/build_site_assets.py. لا تقرأ البوابة مساحة عمل التجارب ولا تشغّل الحملات أبدًا؛ وإنما تعرض الصادرات المُلتزَمة والمُرشَّحة وفق الإفصاح فقط.