عن المشروع

Gruntwork Runbooks هو تطبيق سطح مكتب مفتوح المصدر ومتعدد المنصات مبني على Electron، مصمم لمساعدة خبراء البنية التحتية على توسيع نطاق خبراتهم التشغيلية من خلال توثيق المعرفة في مستندات أدلة تشغيل تفاعلية سهلة المتابعة. يعرض التطبيق مستندات MDX مع مكونات React مدمجة، ويدعم سير عمل تنفيذية موجهة تشمل تشغيل البرامج النصية المحلية، وإدارة مصادقة AWS وGitHub، واستنساخ مستودعات التعليمات البرمجية، وإنشاء ملفات من قوالب، بحيث يمكن للمستخدمين اتباع خطوات تشغيلية موحدة دون حفظ أوامر متناثرة. المشروع حالياً يطوره مؤلف واحد ولم يخضع بعد لمراجعة نظراء شاملة؛ يرحب الصيانة بمساهمات المجتمع بما في ذلك تقارير المشكلات وطلبات السحب للإصلاحات. الأمان هو اعتبار تصميم أساسي للأداة، حيث تنفذ الأوامر مباشرة على جهاز المستخدم المحلي مع مجموعة كاملة من متغيرات البيئة الموجودة عند إطلاق التطبيق. تنص الإرشادات الرسمية صراحةً على أن المستخدمين يجب أن يفتحوا أدلة التشغيل من مصادر موثوقة فقط، لأن أدلة التشغيل غير الموثوقة قد تحتوي على برامج نصية تعسفية. تشمل الحمايات المدمجة سجلاً للملفات القابلة للتنفيذ يقيد الأوامر والبرامج النصية المسموح بها بتلك المعرفة داخل دليل التشغيل، وعملية عرض Electron معزولة تتواصل مع العملية الرئيسية عبر واجهة برمجة تطبيقات contextBridge IPC موثقة، ولا يوجد وصول مباشر إلى Node.js من العرض لتقليل سطح الهجوم. تتوفر حزم التثبيت المبنية مسبقاً لجميع المنصات الرئيسية: يمكن لمستخدمي macOS تنزيل ملف .dmg، ويمكن لمستخدمي Linux الاختيار بين حزم .AppImage أو .deb، ويمكن لمستخدمي Windows تنزيل مثبت .exe، وكلها مستضافة على صفحة إصدارات GitHub للمشروع. للمستخدمين الذين يبنون من المصدر، يتطلب المشروع mise (مدير إصدارات الأدوات) وjust (مشغل أوامر) كمتطلبات أساسية، مع prek (مدير خطافات ما قبل الالتزام) اختياري للمساهمين. يتضمن سير عمل البناء تثبيت إصدارات مثبتة من Node.js وbun عبر mise، وتثبيت التبعيات باستخدام bun install، وبناء تطبيق Electron باستخدام just build، وتعبئته للمنصة الحالية باستخدام just package. يمكن بدء وضع التطوير عبر just dev، الذي يفعل استبدال الوحدات الساخن لـ React وإعادة بناء مراقبة العملية الرئيسية، أو عبر just dev-runbook لتشغيل التطبيق ضد ملف دليل تشغيل محدد. تغطي أوامر just المدمجة دورة حياة التطوير الكاملة، بما في ذلك اختبارات وحدة Vitest، واختبارات نهاية إلى نهاية Playwright، وفحوصات كود oxlint، وفحوصات أنواع tsc. يستخدم المشروع shadcn/ui لمكونات واجهة مستخدم سهلة الوصول ومختبرة جيداً، ويمكن إضافتها عبر واجهة سطر أوامر shadcn الرسمية. تتوفر وثائق إضافية وعروض توضيحية حية على موقع المشروع الرسمي على runbooks.gruntwork.io.