Oak Builder GitHub

Propósito e intenções do usuário: A ferramenta Oak Builder GitHub oferece análise orientada ao domínio e scaffolding para repositórios Oak no GitHub. Usuários-alvo são desenvolvedores e equipes de engenharia iniciando ou reestruturando projetos que utilizam o framework Oak (principalmente baseado em Deno). A ferramenta avalia a estrutura do repositório, uso de middleware, padrões de roteamento, saúde das dependências, testes e preparação de CI, além de considerações de implantação. Fornece planos de scaffolding concretos e diretrizes de arquitetura para acelerar a integração e a manutenibilidade.
\n
Núcleo e recursos: a ferramenta aceita uma URL de repositório GitHub ou caminho local, detecta padrões Oak e constrói um grafo de domínio de módulos, rotas, middleware e dependências. Funcionalidades obrigatórias: ingestão de repositório, detecção de padrões Oak, grafo de dependências e gerador de scaffolding/modelos. Funcionalidades opcionais/avançadas: recomendações de segurança, hotspots de performance, planos de migração e scaffolds PR-ready. Diferenciadores: padrões de middleware específicos de Oak, guia de migração para versões Oak mais novas e geração automática de scaffolding alinhada com templates de projetos Oak comuns.
\n
Entradas e saídas: Entradas: repo_url (string), analysis_scope (enum: full/modular), oak_version (string, opcional), include_tests (boolean), target_platform (string: deno/node). Saídas: analysis_report (JSON), recommended_structure (array de pastas/arquivos), scaffold_plan (objeto com etapas e templates), risk_score (0-100). Saídas também permitem exportação para GitHub como modelo PR ou patch.
\n
Algoritmos e cálculos: usa análise estática, detecção de padrões baseada em AST e um grafo leve de dependências para estimar risco e prontidão. Calcula punten de qualidade com base em lint/ cobertura de testes e saúde de dependências, além de um score estrutural para scaffolding. Fórmulas: risk_score = w1*missing_tests + w2*outdated_deps + w3*complexity + w4*unverified_middlewares. Valores são heurísticos e explicáveis.
\n
Erros e casos limites: lida com URLs inválidas, repositórios privados ou inacessíveis, limites de taxa, entradas ausentes ou versões Oak ambíguas com códigos de erro explícitos e orientações de fallback. Dados externos indisponíveis geram recomendações conservadoras e lacunas sinalizadas.
\n
Indústria/Região e Localização: alinhado aos fluxos de trabalho GitHub e ecossistemas Node/Deno; usa datas/hora ISO e carimbos de tempo UTC em relatórios; unidades referem-se a código. Localização padrão em inglês.
Suposições e Exclusões: assume repositórios públicos ou com acesso autorizado; não executa código em tempo real nem varreduras profundas de segurança; exclui renderização de UI e não é responsável por decisões de implantação de produção.