Oak Builder GitHub

Propósito y intención del usuario: la herramienta Oak Builder GitHub ofrece análisis por dominio y scaffolding para repositorios Oak en GitHub. Usuarios objetivo: desarrolladores y equipos de ingeniería que inician o reestructuran proyectos que utilizan el framework Oak (principalmente basado en Deno). Evalúa la estructura del repositorio, el uso de middleware, patrones de enrutamiento, salud de dependencias, pruebas y preparación de CI, y consideraciones de despliegue. Genera planes de scaffolding concretos y guías de arquitectura para acelerar la incorporación y el mantenimiento.
\n
Núcleo y características: la herramienta toma una URL de repositorio GitHub o una ruta local, detecta patrones relacionados con Oak y construye un grafo de dominio de módulos, rutas, middleware y dependencias. Funciones requeridas: ingestión de repos, detección de patrones Oak, grafo de dependencias y generador de scaffolding/modelos. Funciones opcionales/avanzadas: indicaciones de seguridad, hotspots de rendimiento, planes de migración y scaffolds listos para PR. Diferenciadores únicos: patrones de middleware específicos de Oak, guía de migración a versiones más recientes de Oak y generación automática de scaffolding alineada con plantillas de proyectos Oak comunes.
\n
Entradas y salidas: Entradas: repo_url (cadena), analysis_scope (enum: full/modular), oak_version (cadena, opcional), include_tests (boolean), target_platform (cadena: deno/node). Salidas: analysis_report (JSON), recommended_structure (matriz de carpetas/archivos), scaffold_plan (objeto con pasos y plantillas), y risk_score (0-100). También ofrece exportaciones a GitHub como plantilla PR o parche.
\n
Algoritmos y cálculos: utiliza análisis estático, detección de patrones basada en AST y un grafo ligero de dependencias para estimar riesgo y preparación. Calcula un puntaje de calidad a partir de lint y cobertura de pruebas, salud de dependencias y un puntaje estructural para scaffolding. Fórmulas: risk_score = w1*missing_tests + w2*outdated_deps + w3*complexity + w4*unverified_middlewares. Todos los números son heurísticos y explicables.
\n
Errores y casos límite: maneja URL no válidas, repos privados o inaccesibles, límites de tasa, entradas faltantes o versiones de Oak ambiguas con códigos de error explícitos y guías de fallback. Datos externos no disponibles generan recomendaciones conservadoras y brechas etiquetadas.
\n
Industria/región y localización: se alinea con flujos de GitHub y ecosistemas Node/Deno; utiliza formato ISO para fechas/horas y sellos de tiempo UTC en los informes; las unidades se relacionan con código. Localización predeterminada en inglés.
Supuestos y exclusiones: asume repos públicos o con acceso autorizado; no ejecuta código en tiempo real ni escaneos profundos de seguridad; excluye renderizado de UI y no es responsable de decisiones de despliegue de producción.