flyee 0.1.0

package/core/workflows/extract-template.md

@@ -0,0 +1,278 @@
+---
+description: Extrair Design System de projeto finalizado e salvar como template reutilizável em .agent/templates/design-system/. Gera template + paleta de cores automaticamente.
+skills: frontend-design, ui-ux-discovery
+---
+
+# /extract-template - Extrair Template de Projeto
+
+---
+
+## 🎯 PROPÓSITO
+
+Transforma o Design System de um projeto **finalizado e aprovado** em um template reutilizável, para que futuros projetos similares não precisem recriar o Design System do zero.
+
+**Gera:**
+- Template genérico em `.agent/templates/design-system/{TEMPLATE-NAME}.md`
+- Paleta de cores extraída, adicionada ao `COLOR-PALETTES.md`
+- Registro no workflow `/new-project` (Phase 2.5)
+
+---
+
+## 📊 QUANDO USAR
+
+| Situação | Usar? |
+|----------|-------|
+| Projeto finalizado com Design System aprovado | ✅ Sim |
+| Design System foi refinado manualmente durante implementação | ✅ Sim (melhor resultado) |
+| Projeto ainda em andamento | ❌ Não — finalizar primeiro |
+| Template já existe para esse tipo | ⚠️ Perguntar se quer substituir ou criar variante |
+
+---
+
+## 🧩 SUBCOMMANDS
+
+| Comando | Ação |
+|---------|------|
+| `/extract-template` | Extrai do projeto atual (detecta MASTER.md automaticamente) |
+| `/extract-template [caminho]` | Extrai de um caminho específico |
+| `/extract-template --list` | Lista templates existentes |
+| `/extract-template --preview` | Mostra o que seria extraído sem salvar |
+
+---
+
+## 🔴 FLUXO
+
+```
+┌──────────────┐    ┌──────────────┐    ┌──────────────┐    ┌──────────────┐    ┌──────────────┐
+│  DETECTAR    │───▶│   ANALISAR   │───▶│  ABSTRAIR    │───▶│   PALETA     │───▶│  REGISTRAR   │
+│  (MASTER.md) │    │  (Padrões)   │    │  (Template)  │    │  (Cores)     │    │  (Workflow)  │
+└──────────────┘    └──────────────┘    └──────────────┘    └──────────────┘    └──────────────┘
+      ✅                  ✅                  ✋                  ✋                  ✅
+   Automático          Automático          Aprovação           Aprovação          Automático
+```
+
+---
+
+### Step 1: DETECTAR — Localizar Design System do Projeto
+
+**Ações:**
+1. Buscar `design-system/MASTER.md` no projeto
+2. Se não encontrado: buscar `design-system/*/MASTER.md`
+3. Se não encontrado: perguntar caminho ao usuário
+4. Ler também: `src/styles/tokens.css`, `src/app/globals.css` (para padrões reais)
+
+```markdown
+## 📂 Design System Detectado
+
+| Arquivo | Caminho | Status |
+|---------|---------|--------|
+| MASTER.md | `design-system/MASTER.md` | ✅ Encontrado |
+| tokens.css | `src/styles/tokens.css` | ✅ / ❌ |
+| globals.css | `src/app/globals.css` | ✅ / ❌ |
+
+Confirma que este é o Design System finalizado? (sim/não)
+```
+
+**AGUARDAR** confirmação.
+
+---
+
+### Step 2: ANALISAR — Extrair Padrões
+
+**Ler e catalogar:**
+
+| Aspecto | O que extrair | Fonte |
+|---------|--------------|-------|
+| **Cores** | Paleta primária completa (5 variações) | MASTER.md / tokens.css |
+| **Tipografia** | Font families, escala tipográfica, weights | MASTER.md |
+| **Espaçamento** | Escala de spacing | MASTER.md / tokens.css |
+| **Radius** | Escala de border-radius | MASTER.md |
+| **Shadows** | Todos os níveis + brand shadow | MASTER.md |
+| **Efeitos** | Transições, gradients, hover patterns | MASTER.md |
+| **Breakpoints** | Escala responsiva | MASTER.md |
+| **Componentes** | Lista de componentes implementados | MASTER.md |
+| **Anti-patterns** | O que NÃO fazer | MASTER.md |
+| **Direção Visual** | Pattern, style, mood | MASTER.md |
+
+**Apresentar análise ao usuário:**
+
+```markdown
+## 📊 Análise do Design System
+
+### Identificação
+- **Projeto:** {nome}
+- **Direção Visual:** {pattern} — {style}
+- **Mood:** {mood}
+
+### Paleta Extraída
+| Token | Hex | Nome sugerido |
+|-------|-----|---------------|
+| primary | {hex} | — |
+| primary-light | {hex} | — |
+| primary-dark | {hex} | — |
+| primary-accent | {hex} | — |
+| primary-muted | {hex} | — |
+
+### Tipografia
+- Heading: {font}
+- Body: {font}
+
+### Componentes ({N} total)
+{lista}
+
+### Tipo de Template Sugerido
+**{tipo}** — Baseado na direção visual e componentes identificados.
+
+Segmentos recomendados para reutilização: {segmentos}
+```
+
+---
+
+### Step 3: ABSTRAIR — Gerar Template
+
+**Perguntas ao usuário:**
+
+```markdown
+## ✏️ Configuração do Template
+
+1. **Nome do template:**
+   Sugestão: `{sugestão baseada na direção visual}`
+   (ex: "Corporate Landing", "SaaS Dashboard", "Minimal Portfolio")
+
+2. **Para quais tipos de projeto?**
+   - [ ] Site Institucional / LP
+   - [ ] Web App / SaaS
+   - [ ] Mobile App
+   - [ ] E-commerce
+   - [ ] Portfólio
+   - [ ] Blog
+   - [ ] Outro: ___
+
+3. **Segmentos-alvo:**
+   Sugestão: {segmentos detectados}
+   (ex: "Financeiro, jurídico, imobiliário, seguros")
+
+4. **Manter tipografia atual ou torná-la configurável?**
+   A) Manter (Inter + Plus Jakarta Sans) — recomendado para consistência
+   B) Tornar configurável — mais flexível mas menos testado
+```
+
+**AGUARDAR** respostas.
+
+**Gerar template:**
+1. Copiar estrutura do MASTER.md
+2. Substituir cores específicas por placeholders `{PALETTE.*}`
+3. Substituir `--shadow-gold` (ou brand shadow) por `{PALETTE.shadow-rgba}`
+4. Substituir gradient específico por `{PALETTE.primary}` + `{PALETTE.primary-accent}`
+5. Manter todos os outros tokens como valores concretos
+6. Adicionar header com metadados do template
+7. Salvar em `.agent/templates/design-system/{TEMPLATE-NAME}.md`
+
+**Apresentar template gerado para aprovação.**
+
+**AGUARDAR** aprovação.
+
+---
+
+### Step 4: PALETA — Registrar Cores na Biblioteca
+
+**Gerar entrada para `COLOR-PALETTES.md`:**
+
+```markdown
+## {emoji} {N+1}. {Nome da Paleta}
+
+> **Segmentos:** {segmentos do projeto original}
+> **Mood:** {mood extraído}
+
+| Token | Hex | Preview |
+|-------|-----|---------|
+| `primary` | `{hex}` | {emoji} {descrição} |
+| `primary-light` | `{hex}` | {descrição} |
+| `primary-dark` | `{hex}` | {descrição} |
+| `primary-accent` | `{hex}` | {descrição} |
+| `primary-muted` | `{hex}` | {descrição} |
+| `shadow-rgba` | `rgba({r}, {g}, {b}, 0.{opacidade})` | Sombra {cor} |
+```
+
+**Perguntar ao usuário:**
+
+```markdown
+## 🎨 Registrar Paleta de Cores
+
+As cores deste projeto serão adicionadas como nova paleta em `COLOR-PALETTES.md`.
+
+**Nome sugerido:** {nome baseado no projeto}
+**Emoji sugerido:** {emoji baseado na cor}
+
+Quer ajustar o nome, emoji ou segmentos? (ou aprovar)
+```
+
+**AGUARDAR** aprovação. Adicionar ao final de `COLOR-PALETTES.md`.
+
+---
+
+### Step 5: REGISTRAR — Atualizar Workflow
+
+**Ações automáticas:**
+
+1. Atualizar a tabela de templates na Phase 2.5 do `/new-project`:
+
+```markdown
+| {Template Name} | `{TEMPLATE-FILE}.md` | {tipos compatíveis} |
+```
+
+2. Atualizar a tabela de paletas na Phase 2.5 do `/new-project` (se a tabela de preview existir)
+
+3. Gerar relatório final:
+
+```markdown
+## ✅ Template Extraído com Sucesso
+
+### Arquivos Criados/Atualizados
+
+| Arquivo | Ação |
+|---------|------|
+| `.agent/templates/design-system/{TEMPLATE}.md` | ✅ Criado |
+| `.agent/templates/design-system/COLOR-PALETTES.md` | ✅ Paleta adicionada |
+| `.agent/workflows/new-project.md` | ✅ Tabela de templates atualizada |
+
+### Como Usar
+
+No próximo projeto:
+```bash
+/new-project meu-site
+```
+
+O agente oferecerá automaticamente:
+> "Encontrei o template **{nome}**. Escolha a paleta de cores..."
+
+### Templates Disponíveis ({N} total)
+
+| # | Template | Tipos | Paletas |
+|---|----------|-------|---------|
+{tabela atualizada de todos os templates}
+```
+
+---
+
+## 📋 GATES DE SAÍDA
+
+```
+[ ] MASTER.md do projeto-fonte localizado e confirmado
+[ ] Padrões analisados e apresentados ao usuário
+[ ] Template gerado com placeholders de cor
+[ ] Template aprovado pelo usuário
+[ ] Paleta extraída e adicionada ao COLOR-PALETTES.md
+[ ] Tabela de templates no /new-project atualizada
+[ ] Relatório final apresentado
+```
+
+---
+
+## ⚠️ REGRAS
+
+1. **Nunca extrair de projeto incompleto** — o MASTER.md deve ser a versão final
+2. **Preferir o que foi REALMENTE implementado** — se houve divergência entre MASTER.md e o CSS real, usar os valores do CSS (tokens.css / globals.css)
+3. **Não substituir templates existentes** sem permissão — perguntar se quer criar variante
+4. **Nomes descritivos** — evitar nomes genéricos como "Template 1"
+5. **Testar contraste** — verificar que as cores extraídas passam WCAG AA

package/core/workflows/fix-failed-tests.md

@@ -0,0 +1,160 @@
+---
+description: Workflow para corrigir testes falhados. O agente lê falhas, analisa código, aplica fixes e re-testa em loop (máx 3 tentativas automáticas).
+---
+
+# /fix-tests
+
+> Corrigir testes falhados de uma task. Loop automático com limite de tentativas.
+
+## Uso
+
+```bash
+/fix-tests <task_id>
+```
+
+**Exemplo:**
+```bash
+/fix-tests abc-123-uuid
+```
+
+---
+
+## Pré-requisitos
+
+1. A task DEVE ter `meta.test_checklist` preenchido
+2. Pelo menos 1 teste com `status: failed` ou `status: pending`
+3. Bridge configurado (fallback: usar API diretamente)
+
+---
+
+## Fluxo de Execução
+
+### Step 1: Ler Testes Pendentes/Falhados
+
+```bash
+python3 .agent/flyee-bridge/bridge.py --pending-tests <task_id>
+```
+
+Separar em dois grupos:
+- **Auto tests** (`type: auto`) → agente corrige e re-roda
+- **Manual tests** (`type: manual`) → listar para o dev
+
+> Se nenhum teste failing/pending → informar "✅ All tests passed" e encerrar.
+
+### Step 2: Loop de Auto-Fix (máx 3 iterações)
+
+Para cada teste `auto` com status `failed`:
+
+```
+2.1: Ler result_comment → entender o que falhou
+2.2: Identificar arquivo(s) relacionado(s) ao teste
+2.3: Analisar código e aplicar correção
+2.4: Re-rodar teste:
+     - tsc --noEmit (para testes unit/sdk)
+     - vitest run (se configurado)
+     - Playwright (se configurado)
+2.5: Reportar resultado:
+     python3 .agent/flyee-bridge/bridge.py --report-test <task_id> <step_id> passed|failed ["novo comentário"]
+```
+
+**Controle de loop:**
+```
+iteration = 0
+MAX_ITERATIONS = 3
+
+while iteration < MAX_ITERATIONS:
+    pending = get_pending_auto_tests()
+    if len(pending) == 0: break
+    
+    for test in pending:
+        analyze_and_fix(test)
+        report_result(test)
+    
+    iteration += 1
+
+if iteration >= MAX_ITERATIONS:
+    ESCALATE → informar dev
+```
+
+### Step 3: Regression Detection
+
+Antes de aplicar fix, verificar se mesmo cenário falhou antes:
+
+```bash
+python3 .agent/flyee-bridge/bridge.py --search-context "<description do teste falhado>"
+```
+
+Se encontrar task anterior com mesmo padrão de falha → consultar solução aplicada anteriormente.
+
+### Step 4: Listar Testes Manuais
+
+Para testes com `type: manual`:
+
+```markdown
+## 🔍 Testes Manuais Pendentes
+
+Os seguintes testes requerem validação manual:
+
+| # | Teste | Categoria |
+|---|-------|-----------|
+| ts-3 | Responsivo no mobile (≤640px) | visual |
+| ts-7 | Hover states match DS | visual |
+
+Por favor, teste e marque como passed/failed na UI (TaskDetail → tab "tests").
+```
+
+### Step 5: Verificar Resultado Final
+
+```bash
+python3 .agent/flyee-bridge/bridge.py --test-summary <task_id>
+```
+
+| Resultado | Ação |
+|-----------|------|
+| `all_passed: true` | ✅ "Todos os testes passando. Task pode ser concluída." |
+| `all_passed: false` (só manual) | ⏳ "Testes auto OK. Aguardando validação manual do dev." |
+| `all_passed: false` (auto failed after 3 loops) | ❌ Escalar ao dev com detalhes |
+
+### Step 6: Emitir Eventos (se bridge configurado)
+
+```bash
+# Para cada teste que passou:
+python3 .agent/flyee-bridge/bridge.py emit "qa.test_passed" '{"task_id": "<id>", "step_id": "<step>", "tested_by": "agent"}'
+
+# Para cada teste que falhou (após 3 tentativas):
+python3 .agent/flyee-bridge/bridge.py emit "qa.test_failed" '{"task_id": "<id>", "step_id": "<step>", "attempts": 3, "last_error": "<comment>"}'
+```
+
+---
+
+## Mensagem Final
+
+```markdown
+## 🧪 Fix-Tests Summary — Task {id}
+
+| Métrica | Valor |
+|---------|-------|
+| Total de testes | {total} |
+| ✅ Passed | {passed} |
+| ❌ Failed | {failed} |
+| ⏭️ Skipped | {skipped} |
+| ⏳ Pending (manual) | {pending} |
+| 🔄 Auto-fix loops | {iterations}/3 |
+| All passed | {yes/no} |
+
+{Se all_passed: "✅ Task pronta para /task-complete"}
+{Se não: "❌ Testes ainda falhando. Intervenção manual necessária."}
+```
+
+---
+
+## Gatilhos
+
+Este workflow é acionado quando:
+
+- O usuário invoca `/fix-tests <task_id>`
+- O usuário solicita "corrigir testes" ou "fix failing tests"
+- Etapa 1.7 do `/task-complete` sugere e o dev aceita
+- Agent detecta `all_passed == false` durante verificação
+
+> 🔴 **REGRA:** O agente NÃO pode marcar `all_passed` manualmente. Somente o endpoint `PUT /tasks/{id}/test-results` pode alterar o status.