الحفاظ على تحديث التبعيات باستخدام radar

يجمع forge radar تبعياتك في حلقات حداثة (currency rings) بحيث تظهر التبعيات القديمة أو المنحرفة قبل أن تسبب مشكلات.

forge radar يهبط في خط v0.19. يصف هذا الدليل كيف يتناسب مع انضباط تحديث التبعيات القائم؛ شغّل forge --help للتأكد من توفره في نسختك المثبتة.

من قواعد الهندسة في Forge: قبل إضافة تبعية، تحقق من الخيار الأفضل الحالي من مصادر حية، وفضّل ما يستخدمه المشروع بالفعل. يجعل forge radar الحالة القائمة لتبعياتك مرئية بحيث تكون لهذه القاعدة بيانات تدعمها.

​

الفكرة: حلقات الحداثة

يجمع forge radar تبعيات المشروع في حلقات حداثة متمركزة بحسب مدى حداثة كل واحدة — من المحدَّثة في المركز إلى القديمة أو المنحرفة عند الحافة. قراءة الحلقات طريقة سريعة للإجابة عن سؤال “ما الذي تركناه ينحرف؟” دون تدقيق كل حزمة يدويًا.

forge radar

​

من أين تأتي قائمة التبعيات

يبني radar على قراءة البيان (manifest) نفسها التي تدعم forge stack، والذي يكتشف المكدس الحقيقي للمستودع من بيانات تبعياته:

forge stack     # languages, frameworks, package managers, real test commands

ولأن الاكتشاف قائم على البيانات وآمن الفشل عبر الأنظمة البيئية (package.json، pyproject.toml، go.mod، Cargo.toml، Gemfile، composer.json، pom.xml / build.gradle، *.csproj)، يستطيع radar الاستدلال بشأن الحداثة لنفس مجموعة البيانات التي يفهمها stack.

​

استخدامه في الحلقة

1. افحص الحلقات قبل تغيير تبعية

   شغّل forge radar لترى أي التبعيات تنحرف بالفعل قبل أن تضيف واحدة أو ترقّيها.

2. فضّل ما هو حديث بالفعل

   إذا كانت هناك تبعية قادرة وحديثة موجودة بالفعل في حلقة داخلية، فأعد استخدامها بدلًا من إضافة أخرى — أصغر تغيير مناسب هو الفائز.

3. سجّل القرار

   عندما ترقّي تبعية أو تستبدلها، سجّل السبب:

   forge decide "bump <dep> to <version> — <reason>"
   

   حتى تقرأ الجلسات المستقبلية الاختيار بدلًا من إعادة التداول فيه.

يُبلّغ radar عن الحداثة؛ لا يقوم بالترقية نيابةً عنك. عامِل حلقاته كمُدخَل استشاري لقرار بشري — وتحقق من أي ترقية باختبارات المستودع الحقيقية (forge verify) قبل اعتبارها منجزة.

تحقق من التغيير

بعد ترقية تبعية، شغّل بوابات الجودة — forge verify و forge precommit.