ai-maestro 1.0.0

package/src/smart-planner.mjs

@@ -0,0 +1,249 @@
+export const SMART_PLANNER_VERSION = 'smart-heuristic-v1';
+
+export function stripAccents(text) {
+  return text.normalize('NFD').replace(/[̀-ͯ]/g, '');
+}
+
+const ANALYSIS_ONLY_PATTERN = /\b(analisar|entender estrutura|apontar melhorias|nao alterar|sem alterar|sem modificar)\b/;
+const UI_APP_PATTERN = /\b(botao|botoes|button|click|clique|painel|interface|tela|app|frontend|arquivo|arquivos)\b/;
+const BUGFIX_PATTERN = /\b(bug|erro|falha|quebrado|travando)\b|nao funciona/;
+
+export function detectRequestKind(request) {
+  const text = stripAccents(String(request || '').toLowerCase());
+  if (ANALYSIS_ONLY_PATTERN.test(text)) {
+    return 'analysis-only';
+  }
+  if (UI_APP_PATTERN.test(text)) {
+    return 'ui-app';
+  }
+  if (BUGFIX_PATTERN.test(text)) {
+    return 'bugfix';
+  }
+  return 'default';
+}
+
+export function inferEngine(text) {
+  const lower = text.toLowerCase();
+  if (lower.includes('readme') || lower.includes('checkpoint') || lower.includes('handoff')) {
+    return 'memory';
+  }
+  if (lower.includes('arquitetura critica') || lower.includes('critical architecture') || lower.includes('final review')) {
+    return 'premium-review';
+  }
+  return 'codex9';
+}
+
+export function buildUiAppTasks(request) {
+  return [
+    {
+      title: 'Mapear stack e estrutura real do app',
+      description: 'Identificar tecnologia usada, arquivos principais, ponto de entrada, scripts disponiveis e forma correta de rodar o app.',
+      priority: 'high',
+      files: [],
+      acceptance: ['Stack identificada', 'Arquivos principais listados', 'Comando de execucao identificado, se existir', 'Nenhuma alteracao de codigo feita nessa tarefa']
+    },
+    {
+      title: 'Localizar UI, botoes e handlers',
+      description: 'Encontrar arquivos responsaveis pela interface, botoes, eventos, callbacks, rotas ou bindings.',
+      priority: 'high',
+      files: [],
+      acceptance: ['Arquivos de UI identificados', 'Botoes existentes listados', 'Handlers/callbacks relacionados encontrados ou ausencia documentada']
+    },
+    {
+      title: 'Diagnosticar por que os botoes nao funcionam',
+      description: 'Investigar causas provaveis dos botoes quebrados, incluindo seletores, IDs, listeners, rotas, backend, APIs locais e erros de console/log.',
+      priority: 'high',
+      files: [],
+      acceptance: ['Causa provavel documentada', 'Arquivos afetados definidos', 'Plano de correcao objetivo']
+    },
+    {
+      title: 'Corrigir interacoes dos botoes',
+      description: 'Implementar correcoes nos eventos/callbacks/rotas dos botoes sem alterar .env e sem deploy.',
+      priority: 'high',
+      files: [],
+      acceptance: ['Botoes clicaveis', 'Cada botao dispara acao esperada', 'Erros tratados', 'Arquivos alterados listados']
+    },
+    {
+      title: 'Implementar ou corrigir painel de acesso a arquivos',
+      description: 'Criar ou corrigir area do app que lista arquivos baixados/disponiveis.',
+      priority: 'high',
+      files: [],
+      acceptance: ['Painel lista arquivos relevantes', 'Estado vazio tratado', 'Erros de leitura tratados']
+    },
+    {
+      title: 'Implementar abrir arquivo e abrir pasta',
+      description: 'Adicionar acoes seguras para abrir arquivo e/ou pasta no sistema, respeitando a stack do projeto.',
+      priority: 'high',
+      files: [],
+      acceptance: ['Abrir arquivo funciona quando suportado', 'Abrir pasta funciona quando suportado', 'Falha mostra mensagem clara']
+    },
+    {
+      title: 'Validar fluxo completo',
+      description: 'Executar testes manuais ou automatizados possiveis.',
+      priority: 'medium',
+      files: [],
+      acceptance: ['Comando de validacao executado', 'Fluxo principal testado', 'Falhas documentadas']
+    },
+    {
+      title: 'Atualizar memoria, handoff e resumo',
+      description: 'Registrar mudancas reais, arquivos alterados, validacoes e pendencias.',
+      priority: 'medium',
+      files: ['.memory/handoff.md', '.maestro/CHECKPOINT.md'],
+      acceptance: ['Handoff atualizado', 'Checkpoint atualizado', 'Proximos passos documentados']
+    }
+  ];
+}
+
+export function buildAnalysisOnlyTasks(request) {
+  return [
+    {
+      title: 'Mapear estrutura do projeto',
+      description: 'Mapear a estrutura de pastas e arquivos do projeto sem alterar nenhum arquivo.',
+      priority: 'medium',
+      files: [],
+      acceptance: ['Estrutura de pastas documentada', 'Nao alterar codigo']
+    },
+    {
+      title: 'Identificar stack e comandos',
+      description: 'Identificar a stack tecnologica e os comandos disponiveis (build, test, run) sem alterar codigo.',
+      priority: 'medium',
+      files: [],
+      acceptance: ['Stack identificada', 'Comandos documentados', 'Nao alterar codigo']
+    },
+    {
+      title: 'Identificar pontos de entrada',
+      description: 'Identificar os pontos de entrada principais da aplicacao sem alterar codigo.',
+      priority: 'medium',
+      files: [],
+      acceptance: ['Pontos de entrada listados', 'Nao alterar codigo']
+    },
+    {
+      title: 'Listar riscos, problemas e melhorias',
+      description: 'Listar riscos, problemas e possiveis melhorias observados, sem implementar nenhuma mudanca.',
+      priority: 'medium',
+      files: [],
+      acceptance: ['Riscos e problemas listados', 'Melhorias sugeridas sem implementar', 'Nao alterar codigo']
+    },
+    {
+      title: 'Gerar relatorio sem alterar codigo',
+      description: 'Gerar um relatorio com os achados das tarefas anteriores sem alterar codigo.',
+      priority: 'medium',
+      files: [],
+      acceptance: ['Relatorio gerado', 'Nao alterar codigo']
+    },
+    {
+      title: 'Atualizar memoria e handoff',
+      description: 'Atualizar memoria e handoff com o resumo da analise, sem alterar codigo do projeto analisado.',
+      priority: 'low',
+      files: ['.memory/handoff.md'],
+      acceptance: ['Handoff atualizado', 'Memoria registrada', 'Nao alterar codigo']
+    }
+  ];
+}
+
+export function buildBugfixTasks(request) {
+  return [
+    {
+      title: 'Reproduzir ou entender bug',
+      description: 'Reproduzir o bug relatado ou, se nao for possivel reproduzir, documentar evidencias e hipoteses.',
+      priority: 'high',
+      files: [],
+      acceptance: ['Bug reproduzido ou hipotese documentada', 'Passos de reproducao registrados quando possivel']
+    },
+    {
+      title: 'Mapear arquivos relacionados',
+      description: 'Identificar os arquivos e componentes relacionados ao bug relatado.',
+      priority: 'high',
+      files: [],
+      acceptance: ['Arquivos relacionados identificados', 'Escopo do problema definido']
+    },
+    {
+      title: 'Corrigir causa provavel',
+      description: 'Implementar a correcao para a causa provavel do bug, sem alterar .env e sem deploy.',
+      priority: 'high',
+      files: [],
+      acceptance: ['Causa corrigida', 'Arquivos alterados listados', 'Sem alteracao em .env']
+    },
+    {
+      title: 'Validar correcao',
+      description: 'Executar validacoes que confirmem que o bug foi corrigido.',
+      priority: 'medium',
+      files: [],
+      acceptance: ['Comando de validacao executado', 'Bug nao reproduzido apos a correcao', 'Falhas documentadas se existirem']
+    },
+    {
+      title: 'Atualizar memoria',
+      description: 'Registrar a causa, a correcao e as validacoes no handoff e na memoria do projeto.',
+      priority: 'medium',
+      files: ['.memory/handoff.md'],
+      acceptance: ['Handoff atualizado', 'Memoria registrada']
+    }
+  ];
+}
+
+export function buildDefaultTasks(request) {
+  return [
+    {
+      title: 'Definir escopo e criterios de aceite',
+      description: 'Definir o escopo do pedido e registrar criterios de aceite objetivos para a entrega.',
+      priority: 'high',
+      files: ['.maestro/PLAN.md'],
+      acceptance: ['Escopo resumido no plano', 'Criterios de aceite listados']
+    },
+    {
+      title: 'Mapear arquivos e estrutura necessaria',
+      description: 'Identificar arquivos existentes e estrutura necessaria antes de implementar a mudanca.',
+      priority: 'high',
+      files: [],
+      acceptance: ['Arquivos relevantes identificados', 'Mudanca limitada ao escopo']
+    },
+    {
+      title: 'Implementar funcionalidade principal',
+      description: 'Implementar a funcionalidade solicitada.',
+      priority: 'high',
+      files: [],
+      acceptance: ['Funcionalidade principal implementada', 'Sem alteracao em .env', 'Sem deploy']
+    },
+    {
+      title: 'Adicionar validacoes ou testes manuais',
+      description: 'Executar validacoes locais e registrar os comandos testados.',
+      priority: 'medium',
+      files: [],
+      acceptance: ['Comandos de validacao executados', 'Falhas documentadas se existirem']
+    },
+    {
+      title: 'Atualizar documentacao e memoria',
+      description: 'Atualizar README ou memoria do projeto quando a mudanca alterar uso, comandos ou decisoes.',
+      priority: 'medium',
+      files: ['README.md', '.memory/'],
+      acceptance: ['Documentacao atualizada quando necessario', 'Memoria registrada']
+    },
+    {
+      title: 'Revisao final de seguranca',
+      description: 'Revisar se a entrega respeita as restricoes do projeto e nao exige worker premium.',
+      priority: 'medium',
+      files: [],
+      acceptance: ['Sem comandos destrutivos', 'Sem Claude como padrao', 'Sem dependencia do AI-Router antigo']
+    }
+  ];
+}
+
+const BUILDERS = {
+  'analysis-only': buildAnalysisOnlyTasks,
+  'ui-app': buildUiAppTasks,
+  bugfix: buildBugfixTasks,
+  default: buildDefaultTasks
+};
+
+export function buildSmartTasks(request, context = {}) {
+  const kind = detectRequestKind(request);
+  const builder = BUILDERS[kind] || buildDefaultTasks;
+  const tasks = builder(request, context).map(task => ({
+    ...task,
+    engine: inferEngine(task.title + ' ' + task.description),
+    requestKind: kind,
+    sourceRequest: request
+  }));
+  const plannerKind = kind === 'default' ? SMART_PLANNER_VERSION + ':fallback' : SMART_PLANNER_VERSION;
+  return { kind, plannerKind, tasks };
+}