المسرد

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

المحوّل (Adapter)

صنف ينفّذ بروتوكول HarnessAdapter يترجم الملف التعريفي المشترك إلى صيغة إعداد خاصّة بإطار العمل. تعيش المحوّلات بواقع محوّل لكل حزمة فرعية تحت src/apothem/harnesses/<name>/. راجع تجريد محوّل إطار العمل.

تسلسل مراجعة التدقيق (Audit review sequence)

مسح التدقيق ذو الأحد عشر أمرًا الذي يغطّي الشيفرة، ومراجعة الشيفرة، والأمن، والأداء، والمعمارية، وتجربة المستخدم، وإمكانية الوصول، والوثائق، والاعتماديات، وسلسلة التوريد، ونموذج التهديد. يقوده خط تحصين /fortress. راجع تسلسل مراجعة التدقيق.

اللقطة الذهبية لفارق السلوك (Behavior-diff golden)

لقطة مُودَعة في tests/fixtures/behavior-diff/ تُقارَن بالبايت مع أوراكلات التثبيت وواجهة سطر الأوامر الحتمية، بحيث يُلتقَط أي تغيير غير مقصود في خطة تثبيت، أو حزمة مُجسَّدة، أو مخرجات واجهة سطر الأوامر بوصفه انحرافًا بدلًا من شحنه بصمت. تُوحِّد المقارنةُ البايتات المتباينة بين المنصّات ليبقى المتن محمولًا عبر أنظمة التشغيل.

الحزمة (Cohort)

مجموعة مُجمَّعة من المُخرَجات المُزامَنة من نوع واحد — قواعد، أو أوامر، أو مهارات، أو عوامل، أو خطّافات، أو أنماط إخراج، أو مخططات، أو قوالب — يُجسِّدها المحرّك في كل إطار عمل من الملف التعريفي المشترك الواحد. يحمل ملف تعريف واحد كل حزمة؛ ويُسقِط كل محوّل الحزمَ في السطح الأصلي لإطار عمله.

بوابة المطابقة (Conformity gate)

الجزء الميكانيكي من بوابة ما قبل الإصدار ذات الخمسة عشر شريطًا — أدوات التحقّق القابلة للفحص الآلي في src/apothem/conformity/gate.py. تعمل قبل كل إصدار مُنتَج؛ وتُقيَّم الأشرطة الاستدلالية في المراجعة.

نقطة الدخول (Entry point)

مجموعة نقاط دخول apothem.harnesses الخاصة بـ setuptools المُعلَنة في pyproject.toml. تعكس سجلّ أُطُر العمل تمامًا؛ ويؤكّد اختبارٌ أن نقاط الدخول المُعلَنة تساوي المحوّلات المُسجَّلة، بحيث يظهر أيّ محوّل صحيح الاصطلاح لكنه غير مُسجَّل بوصفه تراجعًا في التغطية.

إطار العمل (Harness)

منصّة مساعد برمجي يدعمها Apothem عبر محوّل مخصّص. المنصّات المدعومة:

Antigravity
Claude Code
CodeBuddy
Codex
Cursor
Gemini CLI
GitHub Copilot
GLM (Z.ai)
Hermes
Kimi Code
Kiro
Open-Claw
OpenCode
Qwen Code
Trae
Windsurf
Zed

راجع أُطُر العمل.

سجلّ أُطُر العمل (Harness registry)

الفهرس في src/apothem/lib/harness_registry.py (والبيانات في harness_registry_data.py) الذي يسرد كل محوّل وهو مرجعي وقت التشغيل — يَحُلّ المحرّك كل محوّل منه، فيُحمَّل من نسخة مسحوبة عادية. أما اكتشاف اصطلاح نظام الملفات تحت src/apothem/harnesses/ فهو فحص تكافؤ للمطابقة، لا مُحلِّل زمن التشغيل.

الخطّاف (Hook)

أمر مُسجَّل على حدث في دورة حياة إطار العمل (PreToolUse, PostToolUse, SessionStart, Stop). يتباين سطح التسجيل الأصلي من إطار عمل إلى آخر — ملف إعدادات، أو بيان خطّافات مخصّص، أو، حيث لا يكشف إطار العمل عن سطح خطّاف أصلي، مادة دعم من Apothem مُشار إليها من مرساة التعليمات. تعيش برامج الخطّافات النصّية وسياقات رسائلها تحت src/apothem/hooks/.

المُجسِّد (Materializer)

دالّة materialize_native_config(profile) -> str الاختيارية للمحوّل، التي تُجسِّد إعدادًا أصليًا في ملف واحد من الملف التعريفي المشترك، لأُطُر العمل التي تكون تهيئتها سطحًا مُهيكَلًا واحدًا (مثل ملف إعدادات JSON أو YAML). أما محوّلات انتشار القوالب فتُغفِل المُجسِّد وتنسخ الحزمَ أو تحوّلها بدلًا من ذلك وفق بيان الانتشار.

نمط الإخراج (Output-style)

تعريف Markdown تحت output-styles/ يشكّل صيغة استجابة المساعد وصوته (مثل نمط المهندس المُوجَز أو المدقّق الجنائي). إحدى الحزم المُزامَنة التي يثبّتها المحوّل.

حزمة الخطّة (Plan suite)

مجموعة مُهيكَلة من مُنتَجات التخطيط (PREAMBLE.md, MASTER-PLAN.md, PROGRESS.md, PLAN-NOTES.md, وملفات PHASE.md لكل مرحلة) يُنتِجها /plan-generate وينفّذها /plan-execute، تحت دليل .apothem/plans/ محلّي للمشروع (وتُرقَّى شجرة .plans/ القديمة عبر apothem migrate-workspace).

بوابة ما قبل الإصدار (Pre-emission gate)

كتلة الموافقة ذات الخمسة عشر شريطًا المُسجَّلة قبل إصدار مُخرَج أو اعتبار مُخرَج المرحلة مكتملًا. تعمل الأشرطة الميكانيكية بوصفها بوابة المطابقة؛ وتُقيَّم الأشرطة الاستدلالية في المراجعة. راجع بوابة ما قبل الإصدار.

بيان الانتشار (Propagation manifest)

src/apothem/lib/propagation-manifest.yaml — يُعلِن، لكل محوّل انتشار قوالب، أيّ الحزم يثبّتها وأيّ تحويلات إلى الصيغة الأصلية لإطار العمل (مثل تحويل الأوامر إلى صيغة TOML الخاصة بإطار عمل).

بوابات الجاهزية للإصدار (Release-readiness gates)

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

زمن التشغيل المكتفي ذاتيًا (Self-contained runtime)

يُضمِّن Apothem اعتماديّات Python الخاصة بزمن تشغيله (مثل pyyaml وjsonschema) تحت src/apothem/_vendor/، بحيث يعمل المحرّك من نسخة مسحوبة عادية. ولا يُحَلّ إلا click وrich وقت التثبيت. راجع زمن التشغيل المكتفي ذاتيًا.

مستوى الجدّية (Seriousness tier)

أحد مستويات الحوكمة الأربعة (EXPLORING, PERSONAL_USE, SHARED, PUBLIC_LAUNCH) الذي يحدّد ضوابط الجودة المُطبَّقة. راجع مستويات الجدّية.

الملف التعريفي المشترك (Shared profile)

ملف YAML مُتحقَّق منه عبر مخطط في ~/.config/apothem/profile.yaml أو --profile PATH. تدمجه محوّلات أُطُر العمل مع مجموعات Apothem المُحزَّمة وتشتقّ إعدادًا أصليًا لكل إطار عمل مدعوم.

STANDARD-CONVENTION-PIN

ملف STANDARD-CONVENTION-PIN.md الخاص بكل محوّل، الذي يُسجِّل عنوان URL لوثائق المورّد، وبصمة الإيداع (commit SHA)، وتاريخ اللقطة، والاسم القانوني للملف والمخطط اللذين تُثبَّت عليهما اصطلاحات المحوّل. يُعاد التحقّق منه على وتيرة دورية بحيث لا ينحرف المحوّل بصمت أبدًا عن سطح المورّد الذي يستهدفه.

شجرة الدعم الفرعية (Support subtree)

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