Skip to main content

Command menu

Jump to a page or search the catalog

AI Tools & Scripts

Upgrade Impact Report: What Breaks If You Update, from Your Lockfiles

For developers: point your agent at your project and get a dependency upgrade plan ordered by risk, from your own lockfiles and imports, with where each package is used, what to test and how to roll back, every point with its file and line. خطة تحديث المكتبات مرتبة بالمخاطر من ملفات مشروعك.

$6.00

What you get: 1 file · 104.78 KB · ZIP

See purchase options

Product description

English

For developers who need to update dependencies without breaking the build.

Point your agent at your project. You get back an upgrade plan ordered by risk, built from your own lockfiles and source: where each package is used, what to test, and how to go back, every point with its file and line.

What you get each run

  • upgrade-plan.md: a summary, the risk rule, then the steps: one batch step for low-risk patch and minor updates, then careful steps one package at a time. Each step lists the packages with from and to versions, where they are used, what could break, what to test and how to roll back.
  • upgrade-plan.html: the same as one printable page with the order of work at the top.
  • facts.json: what the scan found, every fact with its file and line.

Read from your files

A bundled Python script (standard library, read-only, no network calls) reads package.json with package-lock.json (v2 and v3), yarn.lock v1 or pnpm-lock.yaml, and requirements*.txt or pyproject.toml with poetry.lock or uv.lock. It records each package's locked version and range with their lines, direct or transitive, runtime or dev, and every place the code imports it. Other lockfiles it finds are listed as not read.

Nothing from memory

Target versions come from the list your package manager writes with its own outdated command, or from you, and the plan names the list. A "what could break" line cites release notes that someone actually read, with the link; otherwise it is a question for the team.

Every step can be undone

Each step has the project's real test commands, with the line of the script they come from, and a rollback: restore the manifest and lockfile from git, run the clean install, and how to confirm it worked.

Checked, not just written

A checker confirms that every package and version matches the lockfile, every cited line holds the import, every step has a test and a rollback, and no destructive command appears. The agent fixes and checks again until no FIX is left.

Honest about its limits

The plan shows where the risk is; only running each step's tests on a branch shows whether an update is safe. Import sites are found by matching the source text, so imports built at runtime may be missed. Nothing is installed or run to make the plan.

Arabic

The plan can be written in Arabic with a right-to-left page; package names, versions and commands stay as they are.

In the download: SKILL.md, the scripts, references (the plan format, the inputs each parser reads and the outdated commands per package manager), and a complete example so you can see the output before you buy: a Node API with a Python service, 14 packages in 7 steps, in English and Arabic.

بالعربي

للمبرمجين الذين يحتاجون تحديث المكتبات بدون أن ينكسر المشروع.

وجّه وكيلك إلى مشروعك. تستلم خطة تحديث مرتبة بالمخاطر، مبنية من ملفات القفل والكود عندك: أين تُستعمل كل مكتبة، وماذا تختبر، وكيف ترجع، وكل نقطة مع ملفها وسطرها.

ماذا تستلم في كل مرة

  • ملف upgrade-plan.md: ملخص، وقاعدة ترتيب المخاطر، ثم الخطوات: خطوة واحدة مجمّعة لتحديثات patch وminor قليلة الخطر، ثم خطوات حذرة لكل مكتبة وحدها. كل خطوة فيها المكتبات مع الإصدار الحالي والجديد، وأين تُستعمل، وما قد ينكسر، وماذا تختبر، وكيف ترجع.
  • صفحة upgrade-plan.html: الشيء نفسه كصفحة واحدة قابلة للطباعة، وترتيب العمل في أعلاها.
  • ملف facts.json: ما وجده الفحص، وكل معلومة مع ملفها وسطرها.

من ملفاتك أنت

سكربت بايثون مرفق (يقرأ فقط، بلا اتصال بالشبكة) يقرأ package.json مع package-lock.json أو yarn.lock أو pnpm-lock.yaml، وrequirements*.txt أو pyproject.toml مع poetry.lock أو uv.lock. يسجّل الإصدار المقفل لكل مكتبة ونطاقها مع أسطرهما، ومباشرة أم غير مباشرة، وللتشغيل أم للتطوير، وكل مكان يستوردها فيه الكود.

لا شيء من الذاكرة

الإصدارات الجديدة تأتي من القائمة التي يكتبها مدير الحزم بأمر outdated، أو منك، والخطة تذكر مصدرها. وسطر "ما قد ينكسر" يذكر ملاحظات إصدار قرأها أحد فعلًا مع رابطها، وإلا صار سؤالًا للفريق.

كل خطوة يمكن الرجوع عنها

لكل خطوة أوامر الاختبار الحقيقية في المشروع مع سطرها، وطريقة رجوع: استرجاع ملف التعريف وملف القفل من git، ثم التثبيت النظيف، وكيف تتأكد أن الرجوع نجح.

مدقَّقة، لا مكتوبة فقط

أداة فحص تتأكد أن كل مكتبة وإصدار يطابق ملف القفل، وكل سطر مذكور فيه الاستيراد فعلًا، ولكل خطوة اختبار وطريقة رجوع، ولا يوجد أمر خطِر. يصلح الوكيل ويعيد الفحص حتى لا يبقى أي FIX.

صادقة في حدودها

الخطة تبيّن أين الخطر؛ وتشغيل اختبارات كل خطوة على فرع منفصل هو ما يبيّن هل التحديث آمن. والاستيرادات تُكتشف بمطابقة نص الكود، فالاستيراد الذي يُبنى وقت التشغيل قد يفوت.

العربية

تُكتب الخطة بالعربي في صفحة من اليمين إلى اليسار، وأسماء المكتبات والإصدارات والأوامر تبقى كما هي.

داخل الملف: ملف SKILL.md، والسكربتات، والمراجع، ومثال كامل لترى النتيجة قبل الشراء: واجهة Node مع خدمة بايثون، 14 مكتبة في 7 خطوات، بالإنجليزي والعربي.

Questions / أسئلة

Does it install or update anything? / هل يثبّت أو يحدّث شيئًا؟

No. The scripts read files only. The plan's commands are for you to run on a branch, one step at a time. لا، السكربتات تقرأ فقط، والأوامر لك لتشغّلها على فرع.

Where do the new versions come from? / من أين تأتي الإصدارات الجديدة؟

From the list your package manager writes with its own outdated command (the agent runs it after telling you), or from you. The plan names the list. Never from memory. من قائمة outdated لمدير الحزم أو منك، لا من الذاكرة.

Does it know the breaking changes? / هل يعرف التغييرات التي تكسر الكود؟

Only from release notes someone actually read, cited with the link. Anything else is a question for the team. فقط من ملاحظات إصدار قُرئت فعلًا، وإلا صار سؤالًا.

Which package managers does it read? / أي مديري حزم يقرأ؟

npm (package-lock v2 and v3), Yarn 1, pnpm, pip requirements, Poetry and uv. Other lockfiles are listed as found, not read. npm وYarn 1 وpnpm وpip وPoetry وuv.

How is risk ranked? / كيف تُرتب المخاطر؟

By a rule printed in the plan: major bumps, packages imported in many files and build or test tools get careful steps one at a time; other patch and minor updates share one batch step. بقاعدة مكتوبة في الخطة.

Can I trust that the plan is safe? / هل الخطة آمنة؟

The plan shows where the risk is and how to roll back. Only running each step's tests on a branch shows whether an update is safe. الخطة تبيّن الخطر وطريقة الرجوع، والاختبارات هي الحكم.

Can it be in Arabic? / هل تكون بالعربي؟

Yes, as an added option: a right-to-left page. Package names, versions and commands stay as they are. نعم، والأوامر والإصدارات تبقى كما هي.

What you get

1 file · 104.78 KB

  • upgrade-impact-report-1.0.0.zipZIP · 104.78 KB
LicenseCommercial use allowed
Package checkPassed

Getly opened the uploaded files and found nothing that would stop them opening. It is not a virus scan or a quality rating.

PublishedNov 13, 2026
File size104.78 KB
File formatZIP
Versionv1.0

Tags

dependency upgradenpmpythonlockfilepackage updatesrelease planningdeveloper toolsarabicai agent skill
R
RR HH

Frequently asked questions

Do I get access instantly?

Yes. This is a digital product - you can download it right after checkout, straight from your library.

Can I use it for commercial projects?

Yes. Commercial use is allowed: use it in your own business and in things you sell. You may not resell or redistribute the file itself.

What's your refund policy?

You can request a refund within 30 days. If something isn't right, request it from your order and the Getly team reviews it.

What file formats and sizes will I get?

You'll download 1 file - ZIP - 104.78 KB in total.

Do I get free updates?

Yes - when the seller ships a new version, you can re-download the latest files from your library at no extra cost. Check the changelog for recent updates.

Price

$6.00