up-cc 0.1.4 → 0.1.5

package/commands/adicionar-testes.md

@@ -0,0 +1,145 @@
+---
+name: up:adicionar-testes
+description: Gerar testes para uma fase completa baseado na implementacao e criterios UAT
+argument-hint: "<fase> [instrucoes adicionais]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - AskUserQuestion
+argument-instructions: |
+  Parse o argumento como numero de fase (inteiro, decimal ou sufixo-letra), mais texto livre opcional.
+  Exemplo: /up:adicionar-testes 3
+  Exemplo: /up:adicionar-testes 3 focar em edge cases no modulo de precos
+---
+
+<objective>
+Gerar testes unitarios e E2E para uma fase completa, usando SUMMARY.md, CONTEXT.md e VERIFICATION.md como especificacoes.
+
+Analisa arquivos de implementacao, classifica em TDD (unitario), E2E (browser) ou Pular, apresenta plano de testes para aprovacao, e gera testes seguindo convencoes RED-GREEN.
+
+Output: Arquivos de teste commitados com mensagem `test(fase-{N}): adicionar testes unitarios e E2E`
+</objective>
+
+<context>
+Fase: $ARGUMENTS
+
+@.plano/STATE.md
+@.plano/ROADMAP.md
+</context>
+
+<process>
+
+## 1. Carregar Contexto da Fase
+
+```bash
+INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init operacao-fase "${FASE_ARG}")
+if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
+```
+
+Extrair: `phase_dir`, `phase_number`, `phase_name`.
+
+Se fase nao existe: erro e sair.
+Se nao ha SUMMARY.md: erro — fase precisa estar completa primeiro.
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ UP > ADICIONAR TESTES — Fase ${phase_number}: ${phase_name}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Ler artefatos da fase:
+1. `${phase_dir}/*-SUMMARY.md` — o que foi implementado, arquivos modificados
+2. `${phase_dir}/CONTEXT.md` — criterios de aceite, decisoes
+3. `${phase_dir}/*-VERIFICATION.md` — cenarios verificados pelo usuario (se UAT feito)
+
+## 2. Analisar e Classificar Arquivos
+
+Para cada arquivo modificado pela fase, classificar:
+
+| Categoria | Criterio | Tipo de Teste |
+|-----------|----------|---------------|
+| **TDD** | Funcoes puras, logica de negocio, validacoes, parsers, transformacoes | Unitario |
+| **E2E** | Interacoes UI, navegacao, formularios, shortcuts, modais | Browser/E2E |
+| **Pular** | Layout/CSS, config, glue code, migrations, tipos sem logica | Nenhum |
+
+Ler cada arquivo para confirmar classificacao — nao classificar so pelo nome.
+
+## 3. Aprovar Classificacao
+
+```
+AskUserQuestion(
+  header: "Classificacao de Testes",
+  question: |
+    ### TDD (Unitarios) — {N} arquivos
+    {lista com motivo breve}
+
+    ### E2E (Browser) — {M} arquivos
+    {lista com motivo breve}
+
+    ### Pular — {K} arquivos
+    {lista com motivo breve}
+
+    Como prosseguir?
+  options:
+    - "Aprovar e gerar plano de testes"
+    - "Ajustar classificacao"
+    - "Cancelar"
+)
+```
+
+## 4. Descobrir Estrutura de Testes do Projeto
+
+Identificar:
+- Diretorios de teste existentes
+- Convencoes de nomeacao (`.test.ts`, `.spec.ts`, etc.)
+- Comandos do test runner
+- Framework de teste
+
+## 5. Gerar Plano de Testes
+
+Para cada arquivo aprovado, criar plano detalhado:
+- **TDD:** funcoes testaveis, cenarios de input, outputs esperados, edge cases
+- **E2E:** cenarios de usuario, acoes, outcomes, assertions
+
+Apresentar plano completo para aprovacao.
+
+## 6. Gerar Testes
+
+**TDD:** Arrange/Act/Assert. Executar cada teste. Flaggar falhas como possiveis bugs (NAO corrigir implementacao).
+
+**E2E:** Criar testes de cenario. Executar. Reportar blockers.
+
+## 7. Resumo e Commit
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ UP > TESTES GERADOS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+| Categoria | Gerados | Passando | Falhando | Bloqueados |
+|-----------|---------|----------|----------|------------|
+| Unitario  | {N}     | {n1}     | {n2}     | {n3}       |
+| E2E       | {M}     | {m1}     | {m2}     | {m3}       |
+
+Arquivos criados: {lista}
+Gaps de cobertura: {areas nao testaveis e motivo}
+Bugs descobertos: {falhas que indicam bugs na implementacao}
+```
+
+Commitar testes passando:
+```bash
+git add {arquivos de teste}
+git commit -m "test(fase-${phase_number}): adicionar testes unitarios e E2E"
+```
+
+Proximos passos:
+- Se bugs: `/up:rapido corrigir {N} falhas de teste na fase ${phase_number}`
+- Se blockers: descrever o que falta
+- Se tudo ok: "Todos os testes passando!"
+
+</process>

package/commands/atualizar.md

@@ -0,0 +1,103 @@
+---
+name: up:atualizar
+description: Atualizar up-cc para ultima versao via npm
+allowed-tools:
+  - Bash
+  - AskUserQuestion
+---
+
+<objective>
+Verificar atualizacoes do up-cc via npm, mostrar mudancas, e instalar se disponivel.
+</objective>
+
+<process>
+
+## 1. Detectar Versao Instalada
+
+```bash
+# Verificar versao local
+for dir in .claude .config/opencode .gemini; do
+  if [ -f "./$dir/up/package.json" ]; then
+    node -e "console.log(require('./$dir/up/package.json').version)" 2>/dev/null
+    echo "LOCAL"
+    break
+  fi
+done
+
+# Verificar versao global
+for dir in .claude .config/opencode .gemini; do
+  if [ -f "$HOME/$dir/up/package.json" ]; then
+    node -e "console.log(require('$HOME/$dir/up/package.json').version)" 2>/dev/null
+    echo "GLOBAL"
+    break
+  fi
+done
+```
+
+Se versao nao encontrada, tratar como 0.0.0.
+
+## 2. Verificar Ultima Versao
+
+```bash
+npm view up-cc version 2>/dev/null
+```
+
+Se falhar: informar que nao foi possivel verificar (offline ou npm indisponivel). Sair.
+
+## 3. Comparar Versoes
+
+**Se instalada == ultima:**
+```
+UP > JA ATUALIZADO
+
+Instalada: X.Y.Z
+Ultima: X.Y.Z
+```
+Sair.
+
+## 4. Confirmar e Atualizar
+
+```
+UP > ATUALIZACAO DISPONIVEL
+
+Instalada: {old}
+Disponivel: {new}
+
+A instalacao limpa substitui:
+- commands/up/ (comandos substituidos)
+- up/ (workflows, agentes, templates substituidos)
+
+Seus arquivos customizados sao preservados:
+- Comandos fora de commands/up/ ✓
+- Agentes sem prefixo up- ✓
+- Hooks customizados ✓
+- Seus CLAUDE.md ✓
+```
+
+Perguntar: "Atualizar agora?" (Sim / Nao)
+
+Se nao: sair.
+
+Se sim:
+
+**Install local:**
+```bash
+npx -y up-cc@latest --local
+```
+
+**Install global:**
+```bash
+npx -y up-cc@latest --global
+```
+
+## 5. Resultado
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ UP > ATUALIZADO: v{old} -> v{new}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Reinicie o Claude Code para usar os novos comandos.
+```
+
+</process>

package/commands/configurar.md

@@ -0,0 +1,106 @@
+---
+name: up:configurar
+description: Configurar opcoes do workflow UP para o projeto atual
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - AskUserQuestion
+---
+
+<objective>
+Configuracao interativa das opcoes do workflow UP. Atualiza .plano/config.json com preferencias do usuario.
+</objective>
+
+<process>
+
+## 1. Carregar Configuracao Atual
+
+```bash
+cat .plano/config.json 2>/dev/null || echo "{}"
+```
+
+Valores default se ausentes:
+- `modo`: "solo"
+- `paralelizacao`: true
+- `commit_docs`: true
+- `auto_advance`: false
+
+## 2. Apresentar Opcoes
+
+Usar AskUserQuestion com valores atuais pre-selecionados:
+
+```
+AskUserQuestion([
+  {
+    question: "Modo de trabalho?",
+    header: "Modo",
+    multiSelect: false,
+    options: [
+      { label: "Solo (Recomendado)", description: "Desenvolvedor unico, commits diretos" },
+      { label: "Time", description: "Multiplos desenvolvedores, branches por fase" }
+    ]
+  },
+  {
+    question: "Paralelizar agentes quando possivel?",
+    header: "Paralelizacao",
+    multiSelect: false,
+    options: [
+      { label: "Sim (Recomendado)", description: "Agentes rodam em paralelo quando independentes" },
+      { label: "Nao", description: "Agentes rodam sequencialmente" }
+    ]
+  },
+  {
+    question: "Commitar documentos de planejamento automaticamente?",
+    header: "Commit Docs",
+    multiSelect: false,
+    options: [
+      { label: "Sim (Recomendado)", description: "STATE.md, ROADMAP.md, PLANs commitados automaticamente" },
+      { label: "Nao", description: "Apenas codigo e commitado, docs ficam unstaged" }
+    ]
+  },
+  {
+    question: "Avancar pipeline automaticamente? (discutir -> planejar -> executar)",
+    header: "Auto-Advance",
+    multiSelect: false,
+    options: [
+      { label: "Nao (Recomendado)", description: "Manual /clear entre estagios" },
+      { label: "Sim", description: "Encadeia estagios via subagentes" }
+    ]
+  }
+])
+```
+
+## 3. Atualizar config.json
+
+Mapear respostas para valores:
+
+```json
+{
+  "modo": "solo" | "time",
+  "paralelizacao": true | false,
+  "commit_docs": true | false,
+  "auto_advance": true | false
+}
+```
+
+Escrever em `.plano/config.json`.
+
+## 4. Confirmar
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ UP > CONFIGURACAO ATUALIZADA
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+| Opcao          | Valor       |
+|----------------|-------------|
+| Modo           | {solo/time} |
+| Paralelizacao  | {Sim/Nao}   |
+| Commit Docs    | {Sim/Nao}   |
+| Auto-Advance   | {Sim/Nao}   |
+
+Estas opcoes se aplicam a futuros /up:planejar-fase e /up:executar-fase.
+```
+
+</process>

package/commands/saude.md

@@ -0,0 +1,103 @@
+---
+name: up:saude
+description: Diagnosticar integridade do diretorio .plano/ e opcionalmente reparar
+argument-hint: [--reparar]
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - AskUserQuestion
+---
+
+<objective>
+Validar integridade do diretorio `.plano/` e reportar problemas acionaveis. Verifica arquivos ausentes, configuracoes invalidas, estado inconsistente e planos orfaos.
+</objective>
+
+<process>
+
+## 1. Verificar Flag
+
+Checar se `--reparar` esta presente nos argumentos.
+
+## 2. Executar Checagens
+
+Executar todas as verificacoes e coletar erros, avisos e informacoes:
+
+**Erros (criticos):**
+- E001: Diretorio `.plano/` nao existe
+- E002: `PROJECT.md` nao encontrado
+- E003: `ROADMAP.md` nao encontrado
+- E004: `STATE.md` nao encontrado (reparavel — regenerar do ROADMAP)
+- E005: `config.json` com erro de parse (reparavel — recriar com defaults)
+
+**Avisos:**
+- W001: `STATE.md` referencia fase que nao existe no disco
+- W002: `config.json` nao encontrado (reparavel — criar com defaults)
+- W003: Diretorio de fase nao segue padrao NN-nome
+- W004: Fase no ROADMAP sem diretorio correspondente
+- W005: Diretorio de fase no disco mas nao no ROADMAP
+
+**Info:**
+- I001: Plano sem SUMMARY (pode estar em progresso)
+
+```bash
+# Verificacoes basicas
+ls -la .plano/ 2>/dev/null
+ls .plano/PROJECT.md .plano/ROADMAP.md .plano/STATE.md .plano/config.json 2>/dev/null
+cat .plano/config.json 2>/dev/null | node -e "JSON.parse(require('fs').readFileSync(0,'utf-8'))" 2>&1
+
+# Fases no disco
+ls -d .plano/fases/*/ 2>/dev/null
+
+# Fases no ROADMAP
+grep -E '#{2,4}\s*Phase\s+\d' .plano/ROADMAP.md 2>/dev/null
+
+# Planos sem SUMMARY
+for plan in .plano/fases/*/*-PLAN.md; do
+  summary="${plan/-PLAN.md/-SUMMARY.md}"
+  [ ! -f "$summary" ] && echo "SEM_SUMMARY: $plan"
+done 2>/dev/null
+```
+
+## 3. Reparar (se --reparar)
+
+| Acao | Efeito |
+|------|--------|
+| Criar config.json | Cria com defaults |
+| Resetar config.json | Deleta e recria |
+| Regenerar STATE.md | Cria do template com dados do ROADMAP |
+
+**Nao reparavel (muito arriscado):**
+- PROJECT.md, ROADMAP.md (conteudo do usuario)
+- Renomear diretorios de fase
+- Limpar planos orfaos
+
+## 4. Exibir Resultado
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ UP > SAUDE DO PROJETO
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Status: SAUDAVEL | DEGRADADO | QUEBRADO
+Erros: N | Avisos: N | Info: N
+```
+
+Se erros: listar com codigo e sugestao de correcao.
+Se avisos: listar com codigo e sugestao.
+Se info: listar.
+
+Se reparos foram feitos: listar acoes executadas.
+
+Se ha problemas reparaveis e `--reparar` NAO foi usado:
+```
+---
+N problemas podem ser reparados automaticamente.
+Executar: /up:saude --reparar
+```
+
+## 5. Verificar Reparos
+
+Se reparos foram feitos, re-executar checagens para confirmar resolucao.
+
+</process>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "up-cc",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Simplified spec-driven development for Claude Code, Gemini and OpenCode.",
   "bin": {
     "up-cc": "bin/install.js"