lirantal/npqثبّت حزم npm بأمان من خلال تدقيقها قبل مرحلة التثبيت
يحتوي هذا الدليل على توثيق شامل لأداة التدقيق الأمني NPQ (جودة حزم Node).
optional-features.mdإعداد واستخدام الميزات الأمنية الاختيارية، بما في ذلك التحسينات الأخيرة وإصلاحات الأخطاء.
age.marshall.mdتوثيق تفصيلي لمكوّن Age Marshall الأمني الذي يتحقق من عمر الحزمة ونضجها.
يحتوي دليل feature/ على توثيق تفصيلي لميزات وتنفيذات محددة:
test-coverage-improvements.md - تحسينات شاملة لتغطية الاختبارات رفعت التغطية الإجمالية من 84.4% إلى 93.39%signature-verification-fix.md - إصلاح خطأ حرج في التحقق من التوقيعات مع نطاقات الإصدارات (مثل )@angular/common@^20.2.4auto-continue.md - توثيق ميزة المتابعة التلقائية التي تبسّط سير عمل تثبيت الحزمexit-codes.md - مرجع لسلوك أكواد الخروج لعمليات npq و npq-herojson-output.md - مخرجات تدقيق قابلة للقراءة آليًا ومُرقّمة الإصدارات للـ CI والأتمتةmalicious-package.md - توثيق اكتشاف الحزم المعروفة بأنها خبيثة عبر بيانات Snyk/OSVpacote-dependency-reduction.md - ملخص تنفيذ تقليل الاعتماديات الاختياري لـ pacotefeature/مكوّنات Marshall هي وحدات التحقق الأمني الأساسية في NPQ. يركز كل Marshall على جانب أمني محدد:
age.marshall.md) - التحقق من عمر الحزمة ونضجهاsignature-verification-fix.md)عند إضافة ميزات جديدة أو إجراء تغييرات جوهرية:
feature/| الموضوع | الملف | الغرض |
|---|---|---|
| الميزات الاختيارية | optional-features.md | إعداد الميزات والتحسينات الأخيرة |
| التحقق من العمر | age.marshall.md | فحوصات أمنية لعمر الحزمة ونضجها |
| تغطية الاختبارات | feature/test-coverage-improvements.md | تحسينات حديثة لمجموعة الاختبارات |
| التحقق من التوقيعات | feature/signature-verification-fix.md | إصلاح خطأ نطاق الإصدارات والتحقق |
| المتابعة التلقائية | feature/auto-continue.md | سير عمل التثبيت الآلي |
| مخرجات تدقيق JSON | feature/json-output.md | نتائج تدقيق مُرقّمة الإصدارات وقابلة للقراءة آليًا للـ CI |
| أكواد الخروج | feature/exit-codes.md | سلوك أكواد الخروج للـ CLI وتمرير مدير الحزم |
| الحزم الخبيثة | feature/malicious-package.md | اكتشاف الحزم المعروفة بأنها خبيثة والإبلاغ عنها |
| تقليل الاعتماديات | feature/pacote-dependency-reduction.md | إدارة اختيارية للاعتماديات |
أمان التثبيت غير التفاعلي - تصميم معتمد للتثبيتات غير التفاعلية (non-TTY) مع إغلاق آمن عند الفشل واشتراكات صريحة للأتمتة وعوامل الترميز.
أمان التثبيت غير التفاعلي - خطة تعتمد على الاختبار أولًا لتوجيه التثبيت غير التفاعلي (non-TTY) وتمرير عوامل الترميز.
تشغيل مدير الحزم بدون شل - تصميم معتمد لتمرير وسائط مدير الحزم دون إعادة بناء أوامر الشل.
دعم السجلات المخصصة - تصميم معتمد لدعم Artifactory المتوافق مع npm والسجلات الخاصة.
اكتشاف JSON لعوامل الترميز - تصميم معتمد للاختيار التلقائي لوضع تدقيق JSON في بيئات عوامل الترميز.
مخرجات تدقيق JSON - تصميم معتمد لنتائج تدقيق مُرقّمة الإصدارات وقابلة للقراءة آليًا وغير تفاعلية.
تحذيرات هوية المشرفين ذوي النطاقات منتهية الصلاحية - تصميم معتمد لتحذيرات النطاقات منتهية الصلاحية القابلة للإسناد.
الإصدار المُحلّى للنطاق منتهي الصلاحية - تصميم لحل إصدار الاعتمادية الدقيق لفحوصات النطاقات منتهية الصلاحية.
npq و npq-hero.