rootly-graphify

مبني على graphify، وهي أداة مستوحاة من فكرة LLM Wiki لأندريه كارباثي — بدلاً من إعادة اكتشاف المعرفة من الصفر في كل استعلام، قم بجعل LLM يبني رسمًا بيانيًا معرفيًا مستمرًا ومنظمًا يزداد ثراءً بمرور الوقت. يأخذ Graphify أي مجلد من الملفات ويحوله إلى رسم بياني قابل للاستعلام مع مجتمعات واتصالات ودرجات ثقة. هذا التفرع يوجهه نحو واجهة Rootly API.

قم بتوصيل واجهة Rootly API، وجمع الحوادث والتنبيهات والفرق وكتالوج الخدمات لنافذة زمنية محددة، وقم بتصديرها إلى مجموعة محلية (corpus)، ثم حول تلك المجموعة إلى رسم بياني معرفي قابل للاستعلام. استخدم graphify rootly للتجميع و /graphify في Claude Code أو Codex عندما تريد تحليلًا دلاليًا أعمق فوق ذلك.

التثبيت

تثبيت جديد (Graphify + أداة استيراد Rootly):

pip install "graphifyy[rootly]"
graphify install            # Claude Code
graphify install --platform codex  # Codex

إضافة أداة استيراد Rootly إلى إعداد Graphify موجود:

pip install "graphifyy[rootly]" --upgrade

تعيين مفتاح API الخاص بـ Rootly

قم بإنشاء ملف .env في جذر مشروعك:

ROOTLY_API_KEY=rootly_...

تشغيل سير العمل

الخطوة 1: الجلب والبناء (الطرفية)

يجلب الحوادث والتنبيهات المُفعّلة والفرق. يبني الرسم البياني الأولي بألوان الخطورة ومرشحات التنبيه وطبقات الفرق/الخدمات.

graphify rootly

بطريقة غير تفاعلية:

graphify rootly --api-key-env ROOTLY_API_KEY --days 30 --mode standard

المخرجات تُكتب إلى graphify-rootly-data/graphify-out/:

• graph.html — افتح في المتصفح لاستكشاف الرسم البياني
• GRAPH_REPORT.md — العُقد الرئيسية (god nodes)، المجتمعات، الأسئلة المقترحة
• graph.json — الرسم البياني الخام للاستعلام

الخطوة 2: إضافة المعنى الدلالي (الوكيل)

يقوم بوكلاء فرعيين متوازيين على مجموعة الحوادث لاستنتاج الموضوعات المشتركة عبر الحوادث والأنماط المتكررة وعلاقات السبب الجذري.

Claude Code — اكتب في الدردشة:

/graphify graphify-rootly-data --mode deep

Codex — اكتب في الدردشة:

run graphify on graphify-rootly-data --mode deep

ما يمكنك استكشافه

ما يتم جمعه

مرشحات التصور

بمجرد فتح graph.html في المتصفح:

• الفريق — تصفية جميع العقد لحوادث وخدمات فريق معين
• الخطورة — إظهار/إخفاء حسب SEV1–SEV4
• الحوادث — الكل أو المفتوحة فقط
• التنبيهات — المُفعّلة (مفعلة افتراضيًا) / اليتيمة (معطلة افتراضيًا، لم يتم جمعها)
• النطاق الزمني — شريط تمرير لتضييق نافذة الحادث

كيف يعمل

rootly-graphify يحتوي على مرحلة جمع Rootly ومرحلة تحليل الرسم البياني.

1. جمع Rootly الحتمي. التحقق من صحة مفتاح API، اختر نافذة زمنية 7 أو 30 أو 90 يومًا، جلب الحوادث التي يقع started_at الخاص بها داخل تلك النافذة، جلب التنبيهات المُفعّلة لها عبر المورد الفرعي لكل حادث، جلب جميع بيانات الفرق، وكتابة كل شيء إلى دليل مجموعة محلي.

2. بناء الرسم البياني الأولي لـ Rootly. يقوم مشغل Rootly المدمج بإنشاء عقد للحوادث والتنبيهات والفرق والخدمات، ويربطها بحواف مصنفة (triggered، affects، owns، responded_by، targets)، ويجمّع الرسم البياني، ويكتب graph.html و GRAPH_REPORT.md و graph.json. يتضمن HTML ترميز ألوان الخطورة وطبقات الفريق/الخدمة ومرشحات التنبيه.

3. الإثراء العميق الاختياري. قم بتشغيل /graphify ./graphify-rootly-data --mode deep لإرسال وكلاء فرعيين متوازيين على ملفات ماركداون واستنتاج الموضوعات المشتركة عبر الحوادث والمبررات والروابط المفاهيمية.

4. استخدم المخرجات الحالية ذات المستوى الأعلى. بعد الإثراء الدلالي، افتح graphify-out/graph.html. المُصدّر العام الحالي يتضمن بالفعل المرشحات والمرئيات المُحافظة مباشرة، لذا لا حاجة لخطوة إعادة تطبيق منفصلة.

التجميع يعتمد على طوبولوجيا الرسم البياني — لا تضمينات. يجد Leiden المجتمعات بكثافة الحواف. حواف التشابه الدلالي (semantically_similar_to، موسومة بـ INFERRED) تؤثر على اكتشاف المجتمع مباشرة. لا حاجة لخطوة تضمين منفصلة أو قاعدة بيانات متجهات.

كل علاقة موسومة بـ EXTRACTED (موجودة مباشرة في المصدر)، أو INFERRED (استدلال معقول، مع درجة ثقة)، أو AMBIGUOUS (مُعلّمة للمراجعة).

ما تحصل عليه

العُقد الرئيسية (God nodes) — الحوادث أو الخدمات ذات أعلى درجة (ما يتصل به كل شيء)

الروابط المفاجئة — روابط عبر الحوادث مرتبة حسب الدرجة المركبة، كل منها مع شرح بلغة بسيطة

الأسئلة المقترحة — 4-5 أسئلة يكون الرسم البياني في وضع فريد للإجابة عليها حول تاريخ الحوادث لديك

درجات الثقة — كل حافة INFERRED لها confidence_score (0.0–1.0). حواف EXTRACTED دائما 1.0.

حواف التشابه الدلالي — روابط مفاهيمية عبر الحوادث بدون اتصال هيكلي. حادثان ناتجان عن نفس النمط الجذري دون مشاركة الخدمات أو الفرق.

كفاءة الرموز — التشغيل الأول يستخرج ويبني الرسم البياني (يكلف رموزًا). كل استعلام لاحق يقرأ الرسم البياني المضغوط بدلاً من الماركداون الخام — هنا تتراكم التوفيرات. يعني ذاكرة SHA256 التخزينية أن عمليات إعادة التشغيل تعالج فقط الملفات المتغيرة.

الاستخدام

# --- سير عمل Rootly (الطرفية) ---
graphify rootly                                        # تدفق استيراد Rootly تفاعلي
graphify rootly --days 30                              # جمع حوادث آخر 30 يومًا
graphify rootly --api-key-env ROOTLY_API_KEY           # البحث عن المفتاح من البيئة بدون تفاعل
graphify rootly --output ./my-rootly-corpus            # كتابة المجموعة إلى مجلد مخصص

# --- الإثراء الدلالي (الوكيل: Claude Code / Codex) ---
/graphify ./graphify-rootly-data                       # تحليل مجموعة Rootly
/graphify ./graphify-rootly-data --mode deep           # حواف INFERRED أكثر عدوانية
/graphify ./graphify-rootly-data --update              # إعادة استخراج الملفات المتغيرة فقط

# --- الاستعلام عن الرسم البياني (الوكيل) ---
/graphify query "which services have the most recurring incidents?"
/graphify query "what patterns connect the SEV1 incidents?"
/graphify path "payment-api" "auth-service"
/graphify explain "Incident: Database connection pool exhausted"

# --- الصادرات الاختيارية ---
/graphify ./graphify-rootly-data --wiki                # ويكي قابل للتصفح بالوكيل لكل مجتمع
/graphify ./graphify-rootly-data --no-viz              # تخطي HTML، التقرير + JSON فقط
/graphify ./graphify-rootly-data --obsidian            # خزينة Obsidian

# --- تعليمات المساعد الدائمة التشغيل ---
graphify claude install                                # CLAUDE.md + خطاف PreToolUse (Claude Code)
graphify codex install                                 # AGENTS.md (Codex)

إعادة التشغيل على بيانات جديدة

# جلب بيانات جديدة وإعادة البناء
graphify rootly --api-key-env ROOTLY_API_KEY --days 30 --mode standard

# إعادة الإثراء بالخطوة الدلالية (Claude Code)
/graphify graphify-rootly-data --update