roninforge-angularjs-migration

Source-of-truth-Repository für das AngularJS zu Angular 18 GitHub Copilot-Anweisungspaket, das an github/awesome-copilot unter instructions/angularjs-to-angular-18.instructions.md ausgeliefert wird. Das erste einer geplanten Reihe von unternehmensorientierten Copilot-Produkten von RoninForge (geplant: .NET Framework zu .NET 9 Migration, HIPAA PHI Redaktion, T-SQL Anti-Patterns, Charakterisierungstests für Legacy-Code).

Das Problem

• AngularJS 1.x beendete den Long-Term Support am 31. Dezember 2021. Seit Januar 2022 hat Google aufgehört, Sicherheits-, Browser-Kompatibilitäts- und jQuery-Kompatibilitäts-Fixes auszuliefern.
• Die endgültige Veröffentlichung ist v1.8.3 (7. April 2022) - ein reines README-"ultimate-farewell"-Tag. Der tatsächliche Code-Freeze ist v1.8.2 (Oktober 2020).
• CVE-2024-21490 (Regular Expression Denial of Service in ng-srcset, alle Versionen 1.3.0 bis 1.8.3) hat keinen Upstream-Patch. Kommerzielle Extended-Support-Forks (HeroDevs NES, OpenLogic) sind die einzigen gepatchten Builds.
• Banken, Gesundheitssysteme und Regierungsbehörden sind immer noch auf 1.x: Compliance-Einfrierungen, Talentlücke, ngUpgrade-Komplexität und die XLTS-Migrations-Matheformel (TTM = (LOC/LPW) * 1.4), die die Kalenderkosten sichtbar macht.
• GitHub Copilot's eigener Issue-Tracker (#1019, #1128) dokumentiert die Unkenntnis von Angular 17+-Syntax; HeroDevs berichtet, dass 73% der KI-gestützten AngularJS-Migrationen hinter dem Zeitplan zurückbleiben, weil LLMs Muster vor 2025 ausgeben.

Was dieses Paket Copilot beibringt

Eine große .instructions.md-Datei (1.971 Zeilen), die Folgendes abdeckt:

• Den AngularJS-EOL-Status + CVE-2024-21490-Nachweis (warum eine Migration zwingend erforderlich ist, sofern kein kommerzieller Support besteht)
• 17 kanonische Angular-18-Muster (Standalone-Standard, Signals, Control Flow @if/@for/@switch, deferrable Views @defer, funktionsbasierte Interceptors/Guards/Resolvers, provideHttpClient, provideRouter + withComponentInputBinding, inject(), typisierte reaktive Formulare, OnPush + zoneless Dev Preview, DestroyRef + takeUntilDestroyed, toSignal/toObservable, signal-basiertes viewChild/viewChildren, , Vitest, Application Builder)

Repository-Layout

~/development/roninforge-angularjs-migration/
.
.cm  README.md                       Diese Datei
.cm  LICENSE                         MIT
.cm  CHANGELOG.md                    semver-Einträge
.cm  META.yml                        slug / type / version / target_paths, die vom Submit-Skript verwendet werden
.cm  .editorconfig / .gitattributes  LF-only-Normalisierung (awesome-copilot blockiert CRLF)
.cm  .codespellrc                    spiegelt die upstream-Zulassungsliste wider
.cm  scripts/
.cm    validate-awesome-copilot-submission.sh   wiederverwendbarer Validator, spiegelt alle blockierenden CI-Gates
.cm    submit-to-awesome-copilot.sh             wiederverwendbares Submit-Skript (Fork, Branch von staged, Kopie, Regeneration, PR)
.cm  src/                            (Platzhalter für Authoring-Partials, wenn zukünftige Pakete Quellen aufteilen)
.cm  dist/
.cm    angularjs-to-angular-18.instructions.md  genaue Datei, die in das upstream-Verzeichnis instructions/ rsynced wird
.cm  tests/golden/                   (Platzhalter für Diff-against-frozen-output-Tests)
.cm  .github/workflows/validate.yml  führt den Validator bei jedem Push aus

research/ ist gitignoriert; es enthält interne Notizen, die den Inhalt der Anweisungen beeinflusst haben, aber nicht Teil des öffentlichen Artefakts sind.

Pipeline-Skripte (wiederverwendbar für alle RoninForge awesome-copilot-Pakete)

scripts/validate-awesome-copilot-submission.sh

Wird innerhalb eines Klons von github/awesome-copilot ausgeführt. Spiegelt jedes blockierende CI-Gate:

1. Preflight (node 20+, npm, jq, git, codespell)
2. npm ci falls nötig
3. Artefakttyp aus Pfad erkennen
4. Namenskonventionsprüfung (lowercase-kebab; dateinamen-regex pro Typ)
5. Frontmatter-Schema-Prüfung (erforderliche Felder pro Typ, einfache Anführungszeichen)
6. Inhaltsprüfung (Anweisungen müssen mit # beginnen)
7. CRLF-Zeilenendeprüfung (blockiert, falls gefunden)
8. codespell --check-filenames --config .codespellrc
9. 5MB-Asset-Obergrenze für Skills
10. gh aw compile --validate für Workflows
11. npm run plugin:validate für Plugins
12. npm run skill:validate für Skills/Agents (nur Warnung)
13. npm start + git diff --exit-code (der #1 mechanische Bounce - validate-readme.yml schlägt fehl, wenn README/Marketplace veraltet sind)

scripts/submit-to-awesome-copilot.sh

End-to-End-Pipeline:

1. Lies META.yml (slug, type, version)
2. gh auth status
3. Forke github/awesome-copilot nach RoninForge, falls noch nicht geforkt
4. Klone den Fork nach .upstream-clone/
5. Fetch + Reset auf upstream/staged (NIEMALS main)
6. Erstelle einen Feature-Branch von upstream/staged
7. Kopiere dist/-Artefakte in den upstream-Baum an die richtigen Pfade pro Typ
8. Führe den Validator (oben) aus - bricht bei jedem Fehler ab
9. npm start um README + Marketplace neu zu generieren
10. Commit mit 🤖🤖🤖 AI-Author-Fast-Track-Marker
11. Push in den Fork
12. Öffne PR mit base: staged (NIEMALS ) - der -Job lehnt PRs an main automatisch ab

Unterstützt --dry-run (stoppt vor dem Push) und --no-pr (pusht den Branch, überspringt aber die PR-Erstellung).

Versionierung

Mindestversionen festlegen:

• AngularJS final stable: 1.8.2 (Oktober 2020, letzte Code-Veröffentlichung); 1.8.3 (April 2022, reines README-Farewell). LTS endete am 31. Dezember 2021.
• Angular 18: 22. Mai 2024. Neuester 18.x-Patch für ng update-Schematic-Stabilität empfohlen.
• Node 20 LTS Minimum für den Angular 18-Entwicklungsserver.
• RxJS 7.5+ Minimum für Angular 18 Peer.
• TypeScript 5.4+ Minimum für Angular 18 Peer.

Vermeiden: Nicht mehr gewartete AngularJS-Ära-Pakete (angular-ui-bootstrap, ng-storage, ng-flow, angular-translate-loader-static-files); Karma + Jasmine für neue Testdateien (Vitest via ng add @analogjs/vitest-angular).

Lizenz

MIT - siehe LICENSE.

Links

• Angular 18 Release-Beitrag
• Angular llms.txt für KI-gestützte Entwicklung
• ngUpgrade-Dokumentation
• HeroDevs CVE-2024-21490 Advisory
• endoflife.date / AngularJS
• github/awesome-copilot
• RoninForge

Mehr von RoninForge

RoninForge entwickelt kostenlose Werkzeuge für Entwickler, die mit KI-Coding-Assistenten arbeiten:

• LLM-API-Preisvergleich - Claude, GPT, Gemini, DeepSeek, Mistral und Grok Token-Preise nebeneinander, verifiziert anhand offizieller Preisseiten
• GitHub Copilot AI Credits-Rechner - Schätzen Sie Ihren monatlichen Credit-Verbrauch unter nutzungsbasierter Abrechnung
• Alle Cursor Plugins