تطوير الخطّافات

الخطّافات هي أوامر shell تُطلَق عند أحداث الـharness. وهي تفرض المطابقة، وتحقن السياق، وتُشغِّل بوابات الجودة دون تدخّل المُشغِّل.

أحداث الخطّاف

ملفّات رسائل الخطّاف

لكلّ خطّاف ملفّ رسالة مقابِل في src/apothem/hooks/messages/<event>-<name>.md يوفّر السياق للمساعد في اللحظة التي يُطلَق فيها الخطّاف.

تسجيل خطّاف

أضف أمر الخطّاف إلى settings.json:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "python src/apothem/hooks/my-check.py"
          }
        ]
      }
    ]
  }
}

موزِّع الخطّافات

تُوجَّه كلّ الخطّافات عبر src/apothem/hooks/dispatch.py، الذي يحوّل أيّ خطأ في الخطّاف إلى مغلّف fail-open كي لا تحجب الخطّافات الـharness أبدًا.