roninforge-angularjs-migration

مستودع المصدر الأساسي لحزمة تعليمات GitHub Copilot من AngularJS إلى Angular 18 المرسلة إلى github/awesome-copilot في instructions/angularjs-to-angular-18.instructions.md. الأول في سلسلة مخطط لها من منتجات Copilot الموجهة للمؤسسات من RoninForge (مخطط: ترحيل .NET Framework إلى .NET 9، تنقيح معلومات PHI الخاصة بـ HIPAA، أنماط T-SQL المضادة، اختبارات التوصيف للكود القديم).

المشكلة

• خرج AngularJS 1.x من الدعم طويل الأمد في 31 ديسمبر 2021. منذ يناير 2022، توقفت Google عن إصدار إصلاحات الأمان والتوافق مع المتصفحات والتوافق مع jQuery.
• الإصدار النهائي هو v1.8.3 (7 أبريل 2022) - علامة "الوداع الأخير" التي تحتوي على README فقط. تجميد الكود الجوهري هو v1.8.2 (أكتوبر 2020).
• CVE-2024-21490 (هجوم رفض الخدمة بالتعبير العادي في ng-srcset، جميع الإصدارات من 1.3.0 إلى 1.8.3) لا يوجد له تصحيح من المنبع. التفرعات التجارية ذات الدعم الممتد (HeroDevs NES, OpenLogic) هي الإصدارات المصححة الوحيدة.
• البنوك وأنظمة الرعاية الصحية والوكالات الحكومية لا تزال على 1.x: تجميد الامتثال، فجوة المواهب، تعقيد ngUpgrade، وصيغة رياضيات الترحيل XLTS (TTM = (LOC/LPW) * 1.4) التي تجعل التكلفة الزمنية مرئية.
• متعقب المشكلات الخاص بـ GitHub Copilot (#1019, #1128) يوثق عدم الوعي بصيغة Angular 17+؛ تذكر HeroDevs أن 73% من عمليات ترحيل AngularJS المدعومة بالذكاء الاصطناعي تتخلف عن الجدول الزمني لأن نماذج اللغة الكبيرة (LLMs) تُصدر أنماط ما قبل 2025.

ما تعلمه هذه الحزمة لـ Copilot

ملف .instructions.md واحد كبير (1,971 سطرًا) يغطي:

• حالة نهاية عمر AngularJS + دليل CVE-2024-21490 (لماذا الترحيل إلزامي إلا في حالة الدعم التجاري)
• 17 نمطًا قانونيًا لـ Angular 18 (الوضع المستقل الافتراضي، الإشارات (signals)، تدفق التحكم @if/@for/@switch، العروض القابلة للتأجيل @defer، المعترضات/الحُراس/الحالّات المبنية على الدوال، provideHttpClient، provideRouter + withComponentInputBinding، inject()، النماذج التفاعلية المقيدة، OnPush + معاينة مطور بدون مناطق، DestroyRef + takeUntilDestroyed، toSignal/toObservable، viewChild/viewChildren القائم على الإشارات، ، Vitest، منشئ التطبيقات)

تخطيط المستودع

~/development/roninforge-angularjs-migration/
.
.cm  README.md                       This file
.cm  LICENSE                         MIT
.cm  CHANGELOG.md                    semver entries
.cm  META.yml                        slug / type / version / target_paths consumed by submit script
.cm  .editorconfig / .gitattributes  LF-only normalization (awesome-copilot blocks CRLF)
.cm  .codespellrc                    mirrors upstream allowlist
.cm  scripts/
.cm    validate-awesome-copilot-submission.sh   reusable validator, mirrors every blocking CI gate
.cm    submit-to-awesome-copilot.sh             reusable submitter (fork, branch from staged, copy, regen, PR)
.cm  src/                            (placeholder for authoring partials when future packages split sources)
.cm  dist/
.cm    angularjs-to-angular-18.instructions.md  exact file that gets rsynced into upstream instructions/
.cm  tests/golden/                   (placeholder for diff-against-frozen-output tests)
.cm  .github/workflows/validate.yml  runs the validator on every push

research/ مستبعد بواسطة gitignore؛ يحتوي على ملاحظات داخلية شكلت محتوى التعليمات ولكنها ليست جزءًا من الأداة العامة.

نصوص خط الأنابيب (قابلة لإعادة الاستخدام عبر جميع حزم RoninForge awesome-copilot)

scripts/validate-awesome-copilot-submission.sh

يتم تشغيله داخل نسخة من github/awesome-copilot. يعكس كل بوابة CI مانعة:

1. الفحص الأولي (node 20+, npm, jq, git, codespell)
2. npm ci إذا لزم الأمر
3. اكتشاف نوع الأداة من المسار
4. التحقق من اصطلاح التسمية (lowercase-kebab; تعبير عادي لاسم الملف حسب النوع)
5. التحقق من مخطط frontmatter (حقول مطلوبة حسب النوع، سلاسل مقتبسة بمفردة)
6. التحقق من محتوى الجسم (يجب أن تبدأ التعليمات بـ # )
7. التحقق من نهاية السطر CRLF (يمنع إذا وجد)
8. codespell --check-filenames --config .codespellrc
9. حد 5 ميجابايت للأصول الخاصة بالمهارات
10. gh aw compile --validate for workflows
11. npm run plugin:validate for plugins
12. npm run skill:validate for skills/agents (تحذير فقط)
13. npm start + git diff --exit-code (الارتداد الميكانيكي رقم 1 - فشل validate-readme.yml إذا كانت README/السوق قديمة)

scripts/submit-to-awesome-copilot.sh

خط أنابيب من البداية إلى النهاية:

1. قراءة META.yml (slug, type, version)
2. gh auth status
3. عمل fork لـ github/awesome-copilot إلى RoninForge إذا لم يكن قد تم fork بالفعل
4. استنساخ fork إلى .upstream-clone/
5. جلب + إعادة تعيين إلى upstream/staged (أبدًا main)
6. قص فرع الميزات من upstream/staged
7. نسخ الأصول من dist/ إلى شجرة upstream في المسارات الصحيحة حسب النوع
8. تشغيل المدقق (أعلاه) - يتوقف عند أي فشل
9. npm start to regenerate README + marketplace
10. الالتزام بعلامة 🤖🤖🤖 للمؤلف الذكي السريع
11. دفع إلى fork
12. فتح PR مع base: staged (أبدًا main) - وظيفة ترفض تلقائيًا PRs إلى main

يدعم --dry-run (يتوقف قبل الدفع) و --no-pr (يدفع الفرع لكن يتجاوز إنشاء PR).

إدارة الإصدارات

• الإصدار المستقر النهائي لـ AngularJS: 1.8.2 (أكتوبر 2020، آخر إصدار كود)؛ 1.8.3 (أبريل 2022، وداع README فقط). انتهى LTS في 31 ديسمبر 2021.
• Angular 18: 22 مايو 2024. يُوصى بأحدث تصحيح 18.x لاستقرار مخطط ng update.
• الحد الأدنى Node 20 LTS لخادم التطوير Angular 18.
• الحد الأدنى RxJS 7.5+ للصاحب Angular 18.
• الحد الأدنى TypeScript 5.4+ للصاحب Angular 18.

تجنب: حزم عصر AngularJS غير المدعومة بعد الآن (angular-ui-bootstrap, ng-storage, ng-flow, angular-translate-loader-static-files)؛ Karma + Jasmine لملفات الاختبار الجديدة (Vitest عبر ng add @analogjs/vitest-angular).

الترخيص

MIT - انظر LICENSE.

روابط

• منشور إصدار Angular 18
• Angular llms.txt للتطوير المدعوم بالذكاء الاصطناعي
• وثائق ngUpgrade
• نشرة HeroDevs لـ CVE-2024-21490
• endoflife.date / AngularJS
• github/awesome-copilot
• RoninForge

المزيد من RoninForge

RoninForge يبني أدوات مجانية للمطورين الذين يعملون مع مساعدي البرمجة بالذكاء الاصطناعي:

• مقارنة أسعار واجهة برمجة تطبيقات LLM - أسعار رموز Claude, GPT, Gemini, DeepSeek, Mistral, وGrok جنبًا إلى جنب، تم التحقق منها مقابل صفحات التسعير الرسمية
• حاسبة أرصدة GitHub Copilot AI - تقدير استهلاك رصيدك الشهري بموجب الفوترة القائمة على الاستخدام
• جميع إضافات Cursor