status

يُبلِّغ عن حالة التثبيت والتحقّق والانحراف لكل مساعد برمجي مُسجَّل.

الموجز

apothem status [--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` لفحصه.

يُبلَّغ عن الانحراف ولا يُعامَل أبدًا كخطأ: يخرج status بالرمز 0 حتى عندما يُبلِّغ مساعد برمجي واحد أو أكثر عن drift. الانحراف حقيقة عن إعدادك، وليس فشلًا في الأمر.

إذا تعذّر تحميل الملف الشخصي المشترك، يتراجع الانحراف إلى absent للمساعدات البرمجية المُثبَّتة (مع استمرار الإبلاغ عن حقائق installed/verified) بدلًا من إجهاض المسح.

الخيارات

الخيار	الوصف
`--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.

{
  "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	جرى الإبلاغ عن الحالة (الانحراف يُبلَّغ عنه، وليس خطأً)
2	أخفق مُحَوِّل واحد على الأقل في الإبلاغ عن حالته

انظر أيضًا

apothem verify — يتحقّق من تثبيت مساعد برمجي واحد
apothem diff — معاينة التغييرات المُعلَّقة لمساعد برمجي
apothem harnesses — يسرد ويفحص المساعدات البرمجية المُسجَّلة