عن المشروع

HEE (Human Execution Engine) هو إطار عمل تنفيذي مفتوح المصدر يعتمد على المبادئ المسبقة لتنسيق العمل البشري الحتمي. ينسق بين التفكير البشري والمساعدة الآلية والأتمتة بدون غموض، مع إعطاء الأولوية للصحة على الإجماع، والهيكل على الانطباعات، والحتمية على الراحة. يعالج المشروع مشكلة ابتعاد السجلات عن الواقع — حيث تصبح المطالبات قديمة أو غير صحيحة بدون أن يكذب أحد عمداً. ونظراً لأن أنظمة الوكلاء تقرأ السجلات وتتصرف بسرعات آلية، فإن البيانات القديمة أو الخاطئة تنتشر أسرع مما يمكن للبشر اكتشافه. ويوفّر HEE الأدوات اللازمة للكشف عن التناقضات عمداً بدلاً من الاعتماد على الحظ. المفاهيم الأساسية: - الكائنات المُعرَّفة بالأنواع: كل سجل حوكمة (بطاقة، دعامة، عقد، مخطط blueprint، خطة، سجل) هو ملف YAML يحتوي على النوع (kind)، وكتلة الأوصاف (metadata)، وهوية مُشتقة من التجزئة محسوبة كـ sha256(seed). تُتحقَّق من صحتها باستخدام أمر hee lint. - فحوصات التحقق: يتوافق أمر hee check المطالبات مع القياسات الحقيقية — مثل التحقق من أدخالة السجلات against الحسابات النشطة على GitHub، والتحقق من التواقيع GPG المنفصلة مقابل ملفات المصدر، وإثبات تكرار هويات التجزئة من البذور، واكتشاف الأسرار في المستودعات العامة. - سلاسل التواقيع: العقود تُصدق بتواقيع GPG فوق ملفات YAML. يُعتبر ملف .asc المجاور لملف YAML هو الدليل؛ بينما السطر الخاص بالحالة (status) ليس سوى مطالبة بشأنه. - الفرضية مقابل الثنائيات (Thesis vs Duople): الفرضية (Thesis) هي مطالبة لاختبارها. والثنائية (Duople) هي ما يُختزَل إلى شكل قابِل للتحقّق ومدعوم بالأدلة. تصنيف شيء ما كفرضية يمثل تقرير حالة صادق، وليس خفضاً للمكانة. - فصل العقيدة: تحدد المجلدان blueprints/ وhee/ ما يجب أن يكون صحيحاً. بينما tfرض ci/ وأدوات tooling/ والسكريبتات إنفاذ ذلك لكنها لا تُعتبَر مصدراً للواقع. يقدّم مترميز hee CLI أوامر مثل hee check وhee lint وhee list. يُوصى باستخدامه في دليل مؤقت نظيف حيث لا يلزم أي تثبيت. تشمل المجلدات الرئيسية: - blueprints/ للعقودschemas العقيدة وعقود المدقِّق. - hee/ للبطاقات والدعامات والعقود والسجلات والمهارات. - mib/ لوحدات المصطلحات الخاصة بـ HEE-MIB. - docs/doctrine/ لوثيقة HEE_POLICY. - tooling/bin/ لأدوات hee. يُعرِّف HEE ما يجب أن يكون صحيحاً، وليس كيف نجعله صحيحاً. إنه ليس أداة سير عمل، ولا مكتبة عبارات (prompts)، ولا إطار عمل للوكلاء، ولا يبدي رأياً في لغة التنفيذ.