status
مرجع واجهة سطر الأوامر لأمر apothem status.
الإبلاغ عن حالة التثبيت والتحقّق والانحراف لكل إطار عمل مُسجَّل.
الموجز
apothem status [--profile PATH] [--project PATH]
[--quiet|-q] [--verbose|-v]
[--format plain|json] [--json] [--no-color]status أمر فحص للقراءة فقط. يمرّ على كل محوّل إطار عمل مُسجَّل ويُبلِغ عن
ثلاث حقائق لكل إطار عمل: هل هو مُثبَّت، وهل تجتاز أهدافه المُدارة التحقّق، وهل انحرف
الإعداد المُثبَّت عن الملف التعريفي المشترك. ولا يكتب أي شيء على القرص.
لكل إطار عمل، يُبلِغ status عن:
| العمود | المعنى |
|---|---|
installed | إعداد المحوّل المُدار موجود في مسار هدفه. |
verified | أهداف المحوّل المُدارة موجودة وصالحة. |
drift | حكم الأمانة للملف التعريفي (انظر أدناه). |
قيمة drift واحدة مما يلي:
| القيمة | المعنى |
|---|---|
in-sync | يحمل الإعداد المُثبَّت الملف التعريفي المشترك المُسقَط حديثًا حرفيًا. |
drift | إطار العمل مُثبَّت لكن محتوى ملفه التعريفي المُسقَط لم يعد يطابق الملف التعريفي المشترك الحالي. أعِد تشغيل apothem install لإعادة الإسقاط. |
absent | إطار العمل غير مُثبَّت، فلا يوجد ما يُقارَن. |
needs-project | جرى الإبلاغ عن إطار عمل ذي نطاق مشروع دون --project، لذا يتعذّر تحليل هدفه. مرِّر --project PATH لفحصه. |
unknown | تعذّر تحميل الملف التعريفي الافتراضي، لذا لا يملك إطار العمل المُثبَّت خطَّ أساس يُقارَن به. أصلِح الملف التعريفي لاستعادة حكم الانحراف. |
يُبلَّغ عن الانحراف ولا يُعامَل أبدًا بوصفه خطأً: يخرج status بالرمز 0 حتى
عندما يُبلِغ إطار عمل واحد أو أكثر عن drift. الانحراف حقيقة عن إعدادك، لا
إخفاق للأمر.
إذا تعذّر تحميل الملف التعريفي المشترك الافتراضي، يتراجع الانحراف إلى
unknown لأُطُر العمل المُثبَّتة (مع استمرار الإبلاغ عن حقيقتَي
installed/verified) بدلًا من إجهاض المسح. أما --profile الصريح
الذي يتعذّر تحميله فهو خطأ من المستخدم، فيُجهَض الأمر بخطأ مُهيكَل بدلًا من ذلك.
ويُبلَّغ عن هذا التراجع دائمًا: يطبع status تنبيهًا يُسمّي الملف التعريفي
والإصلاح، ويحمل غلاف --json مُدخَلًا مطابقًا
drift_baseline_unavailable في warnings. ويكتسب هذا أهمية
قصوى عندما لا يكون أي إطار عمل مُثبَّتًا — إذ يظهر كل صف عندئذٍ بالقيمة
absent ولا توجد أي خلية unknown، فيكون التنبيه الإشارة
الوحيدة إلى أن خط الأساس لم يُحمَّل قطّ.
الخيارات
| الخيار | الوصف |
|---|---|
--profile PATH | ملف YAML للملف التعريفي المشترك الذي يحدّد خط أساس الانحراف. ومن دونه، يُستخدَم الملف التعريفي الافتراضي (~/.config/apothem/profile.yaml). |
--project PATH | جذر المشروع لأُطُر العمل ذات نطاق المشروع. ومن دونه، تُبلِغ أُطُر العمل ذات نطاق المشروع عن needs-project. |
--quiet، -q | يُخمِد المخرجات المعلوماتية؛ لا تُصدَر إلا الأخطاء. |
--verbose، -v | يُصدِر مخرجات تشخيصية إضافية. |
--format plain|json | صيغة المخرجات (الافتراضي: plain). |
--json | اختصار لـ --format json. |
--no-color | يُعطِّل رموز ألوان ANSI في المخرجات. |
-h، --help | يعرض المساعدة ويخرج. |
مخرجات JSON
يحمل غلاف --json صفّ نتيجة واحدًا لكل إطار عمل مُسجَّل. ويحمل كل صف
المفاتيح المُوثَّقة harness، وinstalled، وverified،
وdrift. وتكون warnings فارغة في المسح النظيف؛ وعندما يتعذّر
تحميل الملف التعريفي الافتراضي تحمل مُدخَلًا واحدًا
drift_baseline_unavailable مع path، وcode،
وreason، وfix.
{
"schema_version": 1,
"status": "success",
"command": "status",
"action": "status",
"harness": "all",
"files_written": [],
"results": [
{
"harness": "claude-code",
"installed": true,
"verified": true,
"drift": "in-sync"
},
{
"harness": "cursor",
"installed": false,
"verified": false,
"drift": "needs-project"
}
],
"warnings": [],
"error": null
}عزل الإخفاق لكل محوّل: إذا رفع محوّل واحد استثناءً أثناء الإبلاغ عن حالته، يحمل صفّ
إطار العمل ذاك outcome: "error" وmessage، وتظلّ بقية أُطُر
العمل تُبلِغ على نحو طبيعي، وتخرج العملية بالرمز 2.
أمثلة
apothem status
apothem status --project .
apothem status --jsonرموز الخروج
| الرمز | المعنى |
|---|---|
| 0 | جرى الإبلاغ عن الحالة (يُبلَّغ عن الانحراف، وليس خطأً) |
| 1 | خطأ تحقّق متوقَّع (--profile غير صالح، أو مسار --project غير موجود) |
| 2 | أخفق محوّل واحد على الأقل في الإبلاغ عن حالته |
| 64 | خطأ في الاستخدام: خيار أو أمر غير معروف، أو قيمة خيار مفقودة أو غير صالحة. مع --json يكون الخطأ غلاف JSON بالرمز cli.usage. |
انظر أيضًا
- apothem verify — يتحقّق من تثبيت محوّل إطار عمل
- apothem diff — يعاين التغييرات المُعلَّقة لإطار عمل
- apothem harnesses — يسرد أُطُر العمل المُسجَّلة ويفحصها