Oak Builder GitHub

Scopo e intento utente: lo strumento Oak Builder GitHub fornisce analisi orientate al dominio e scaffolding per repository Oak su GitHub. Gli utenti target sono sviluppatori e team di ingegneria che avviano o ristrutturano progetti che usano Oak (principalmente basato su Deno). L’utensile valuta struttura del repository, uso di middleware, modelli di routing, salute delle dipendenze, test e prontezza CI e considerazioni di deployment. Fornisce piani di scaffolding concreti e linee guida architetturali per accelerare onboarding e manutenibilità.
\n
Cuore logico & funzionalità: lo strumento accetta un URL repo GitHub o percorso locale, rileva modelli Oak e costruisce un grafo di dominio di moduli, rotte, middleware e dipendenze. Funzionalità obbligatorie: ingestion del repository, rilevamento modelli Oak, grafo delle dipendenze e generatore scaffolding/template. Funzionalità opzionali/avanzate: consigli di sicurezza, hotspot di performance, piani di migrazione e scaffolds PR-ready. Differenziatori: modelli middleware specifici Oak, guida di migrazione a versioni Oak più recenti e generazione automatica di scaffolding in linea con modelli di progetto Oak comuni.
\n
Ingressi & uscite: Inserimenti: repo_url (string), analysis_scope (enum: full/modular), oak_version (string, opzionale), include_tests (boolean), target_platform (string: deno/node). Uscite: analysis_report (JSON), recommended_structure (array di cartelle/file), scaffold_plan (oggetto con passi e modelli), risk_score (0-100). Inoltre esporta come PR o patch su GitHub.
\n
Algoritmi & calcoli: utilizza analisi statica, rilevamento modelli basato su AST e un grafo leggero di dipendenze per stimare rischio e prontezza. Calcola un punteggio di qualità basato su lint/coprimento test e salute delle dipendenze, e un punteggio strutturale per scaffolding. Formule: risk_score = w1*missing_tests + w2*outdated_deps + w3*complexity + w4*unverified_middlewares. Tutti i valori sono euristici e spiegabili.
\n
Errori & casi limite: gestisce URL non validi, repository privati o inaccessibili, limiti di richiesta, input mancanti o versioni Oak ambigue con codici di errore espliciti e indicazioni di fallback. Dati esterni non disponibili forniscono raccomandazioni conservative e lacune etichettate.
\n
Industria/Regione & Localizzazione: allineato ai flussi di lavoro GitHub e agli ecosistemi Node/Deno; usa formati data/ora ISO e timestamp UTC nei report; le unità sono riferite al codice. Localizzazione predefinita in inglese.
Assunzioni/esclusioni: presuppone repository pubblici o accessibili; non esegue codice in runtime né scansioni di sicurezza profonde; esclude rendering UI e non è responsabile delle decisioni di distribuzione di produzione.