roninforge-angularjs-migration

Repositorio de referencia para el paquete de instrucciones de GitHub Copilot de AngularJS a Angular 18 enviado a github/awesome-copilot en instructions/angularjs-to-angular-18.instructions.md. Primero de una serie planificada de productos Copilot orientados a empresas de RoninForge (planeados: migración de .NET Framework a .NET 9, redacción de PHI de HIPAA, antipatrones de T-SQL, pruebas de caracterización para código heredado).

El Problema

• AngularJS 1.x salió del Soporte a Largo Plazo el 31 de diciembre de 2021. Desde enero de 2022 Google ha dejado de enviar correcciones de seguridad, compatibilidad con navegadores y compatibilidad con jQuery.
• La versión final es v1.8.3 (7 de abril de 2022), una etiqueta "última despedida" solo de README. El congelamiento de código sustantivo es v1.8.2 (octubre de 2020).
• CVE-2024-21490 (Denegación de Servicio por Expresión Regular en ng-srcset, todas las versiones 1.3.0 a 1.8.3) no tiene parche oficial. Las bifurcaciones comerciales de soporte extendido (HeroDevs NES, OpenLogic) son las únicas versiones parcheadas.
• Bancos, sistemas de salud y agencias gubernamentales todavía están en 1.x: congelamientos de cumplimiento, brecha de talento, complejidad de ngUpgrade y la fórmula matemática de migración XLTS (TTM = (LOC/LPW) * 1.4) que hace visible el costo en el calendario.
• El propio rastreador de problemas de GitHub Copilot (#1019, #1128) documenta el desconocimiento de la sintaxis de Angular 17+; HeroDevs informa que el 73% de las migraciones asistidas por IA de AngularJS se retrasan porque los LLM emiten patrones anteriores a 2025.

Lo que este paquete enseña a Copilot

Un archivo grande .instructions.md (1,971 líneas) que cubre:

• El estado del fin de vida útil de AngularJS + evidencia de CVE-2024-21490 (por qué una migración no es opcional a menos que se tenga soporte comercial)
• 17 patrones canónicos de Angular 18 (predeterminado standalone, signals, flujo de control @if/@for/@switch, vistas diferibles @defer, interceptores/guardias/resolvedores basados en funciones, provideHttpClient, provideRouter + withComponentInputBinding, inject(), formularios reactivos tipados, OnPush + vista previa de desarrollo sin zonas, DestroyRef + takeUntilDestroyed, toSignal/toObservable, viewChild/viewChildren basados en signals, NgOptimizedImage, Vitest, constructor de aplicaciones)
• Tres rutas de migración con dimensionamiento del esfuerzo y casos de estudio: big-bang (3-9 meses), híbrido ngUpgrade (6-18 meses, recomendado), strangler-fig (6-24 meses)
• 62 antipatrones con pares MALO/CORRECTO y citas de fuentes, en tres modos de fallo:
  • Modo A (15): Patrones de AngularJS 1.x emitidos para solicitudes simples de "Angular" ($scope.$apply, ng-controller, $compile, $http, $q, ng-app, ng-bind-html, ng-click, angular.module, | filter, $resource, $cookies, $location, envoltura IIFE 'use strict')
  • Modo B (35): Modismos heredados de Angular 2-17 emitidos en lugar de Angular 18 (*ngIf / *ngFor / *ngSwitch, NgModules, decoradores @Input() / @Output(), DI de constructor, interceptores/guardias/resolvedores basados en clases, HttpClientModule, RouterModule.forRoot, Promise.all vs forkJoin, fugas de subscribe, estado de BehaviorSubject, detección de cambios predeterminada, @ViewChild static, formularios sin tipo, importaciones obsoletas de rxjs/operators, constructor de navegador)
  • Modo C (12): Errores específicos de migración (consejo de big-bang sin ngUpgrade, paquetes no mantenidos, importaciones mixtas, falta de downgradeInjectable / downgradeComponent, orden de arranque incorrecto, tratar ng update como una migración de framework, puertos literales de $rootScope.$broadcast, BrowserAnimationsModule en standalone, fuga de polyfill zoneless + zone.js)
• Árbol de decisión (mapeo de cubo de LoC a calendario; condición a ruta)
• Ocho trampas de ngUpgrade con fragmentos de corrección
• Referencias (documentos oficiales de Angular 18, avisos de fin de vida útil + CVE, soporte comercial, casos de estudio, obsolecencias)

Diseño del repositorio

~/development/roninforge-angularjs-migration/
.
.cm  README.md                       Este archivo
.cm  LICENSE                         MIT
.cm  CHANGELOG.md                    entradas semver
.cm  META.yml                        slug / type / version / target_paths consumido por el script de envío
.cm  .editorconfig / .gitattributes  normalización LF-only (awesome-copilot bloquea CRLF)
.cm  .codespellrc                    refleja la lista blanca ascendente
.cm  scripts/
.cm    validate-awesome-copilot-submission.sh   validador reutilizable, refleja cada puerta de CI bloqueante
.cm    submit-to-awesome-copilot.sh             remitente reutilizable (fork, rama desde staged, copia, regenera, PR)
.cm  src/                            (marcador de posición para crear parciales cuando paquetes futuros dividan fuentes)
.cm  dist/
.cm    angularjs-to-angular-18.instructions.md  archivo exacto que se sincroniza en upstream instructions/
.cm  tests/golden/                   (marcador de posición para pruebas de diff contra salida congelada)
.cm  .github/workflows/validate.yml  ejecuta el validador en cada push

research/ está en gitignore; contiene notas internas que informaron el contenido de las instrucciones pero no forma parte del artefacto público.

Scripts de tubería (reutilizables en todos los paquetes awesome-copilot de RoninForge)

scripts/validate-awesome-copilot-submission.sh

Ejecutar dentro de un clon de github/awesome-copilot. Refleja cada puerta de CI bloqueante:

1. Prevuelo (node 20+, npm, jq, git, codespell)
2. npm ci si es necesario
3. Detectar tipo de artefacto desde la ruta
4. Verificación de convención de nombres (lowercase-kebab; regex de nombre de archivo por tipo)
5. Verificación de esquema de Frontmatter (campos requeridos por tipo, cadenas entre comillas simples)
6. Verificación de contenido del cuerpo (las instrucciones deben comenzar con # )
7. Verificación de final de línea CRLF (bloquea si se encuentra)
8. codespell --check-filenames --config .codespellrc
9. Límite de activos de 5MB para skills
10. gh aw compile --validate para workflows
11. npm run plugin:validate para plugins
12. npm run skill:validate para skills/agents (warn-only)
13. npm start + git diff --exit-code (el rebote mecánico #1 - validate-readme.yml falla si README/marketplace están desactualizados)

scripts/submit-to-awesome-copilot.sh

Tubería de extremo a extremo:

1. Leer META.yml (slug, type, version)
2. gh auth status
3. Hacer fork de github/awesome-copilot a RoninForge si aún no se ha bifurcado
4. Clonar el fork a .upstream-clone/
5. Obtener + restablecer a upstream/staged (NUNCA main)
6. Crear rama de características desde upstream/staged
7. Copiar artefactos de dist/ al árbol upstream en las rutas correctas por tipo
8. Ejecutar el validador (arriba) - aborta en cualquier fallo
9. npm start para regenerar README + marketplace
10. Hacer commit con el marcador de vía rápida de autor IA 🤖🤖🤖
11. Empujar al fork
12. Abrir PR con base: staged (NUNCA main) - el trabajo check-pr-target.yml rechaza automáticamente los PRs a main

Soporta --dry-run (se detiene antes del push) y --no-pr (empuja la rama pero omite la creación del PR).

Versionado