synapos 2.6.1 → 2.7.2

package/.synapos/core/commands/set-model.md

@@ -1,7 +1,7 @@
 ---
 name: synapos-set-model
-version: 1.0.0
-description: Altera model_capability e model_name em docs/_memory/preferences.md de forma interativa
+version: 1.1.0
+description: Altera model_capability e model_name em docs/_memory/preferences.md
 ---
 
 # PROTOCOLO SET-MODEL
@@ -9,17 +9,17 @@ description: Altera model_capability e model_name em docs/_memory/preferences.md
 > Atualiza as configurações de modelo usadas pelo pipeline-runner e model-adapter.
 > Afeta: injeção de contexto, model_tier routing e nível de adaptação de prompts.
 
+**Suporta dois modos:**
+- **Non-interactive:** `/set-model high claude-opus-4-6` → aplica direto
+- **Interactive:** `/set-model` → fluxo guiado com AskUserQuestion
+
 ---
 
 ## PASSO 1 — Ler estado atual
 
-Leia `docs/_memory/preferences.md` e extraia:
-- `model_capability` (atual)
-- `model_name` (atual)
-- `model_fast` (atual, se existir)
-- `model_powerful` (atual, se existir)
+Leia `docs/_memory/preferences.md` e extraia valores atuais.
 
-Se o arquivo não existir, informe:
+Se o arquivo não existir:
 ```
 ⚠️  docs/_memory/preferences.md não encontrado.
 Execute /init primeiro para criar o onboarding.
@@ -28,25 +28,118 @@ E encerre.
 
 ---
 
-## PASSO 2 — Exibir estado atual
+## PASSO 2 — Modo non-interactive (se argumentos fornecidos)
+
+Se o comando vier com argumentos (ex: `/set-model high claude-opus-4-6`):
 
-Exiba um resumo antes de qualquer pergunta:
+1. Parseie: `{capability} {model_name}` (model_fast e model_powerful são opcionais)
+2. Valide `capability`: deve ser `high`, `standard` ou `lite`
+3. Valide `model_name`: não vazio
+4. Se válido: vá para PASSO 6 (confirmar e salvar)
+5. Se inválido: informe erro e sugira interactive mode
 
+**Formatos aceitos:**
 ```
-⚙️  Configuração de modelo atual
-────────────────────────────────
-model_capability : {valor ou "não definido"}
-model_name       : {valor ou "não definido"}
-model_fast       : {valor ou "não definido"}
-model_powerful   : {valor ou "não definido"}
-────────────────────────────────
+/set-model high claude-opus-4-6
+/set-model standard gpt-4o-mini
+/set-model lite kimi
+/set-model high opus — fast haiku — powerful opus   # com multi-model
 ```
 
 ---
 
-## PASSO 3 — Escolher model_capability
+## PASSO 3 — Modo interativo (se sem argumentos)
 
-Use AskUserQuestion:
+Exiba estado atual e use **no máximo 2 AskUserQuestion**:
+
+```
+⚙️  Configuração atual
+model_capability: {valor}
+model_name: {valor}
+model_fast: {valor ou "—"}
+model_powerful: {valor ou "—"}
+```
+
+```
+AskUserQuestion({
+  question: "Qual capability do modelo?",
+  options: [
+    { label: "high", description: "Claude Opus/Sonnet, GPT-4o, Gemini Pro — contexto completo" },
+    { label: "standard", description: "Claude Haiku, GPT-4o-mini, Gemini Flash — CoT prefix" },
+    { label: "lite", description: "Kimi, MiniMax, Llama — context pruning" }
+  ]
+})
+```
+
+```
+AskUserQuestion({
+  question: "Modelo principal?",
+  options: [
+    { label: "claude-opus-4-6", description: "Anthropic" },
+    { label: "claude-sonnet-4-6", description: "Anthropic" },
+    { label: "gpt-4o", description: "OpenAI" },
+    { label: "gpt-4o-mini", description: "OpenAI" },
+    { label: "gemini-1.5-pro", description: "Google" },
+    { label: "Outro", description: "Vou informar" }
+  ]
+})
+```
+
+Se "Outro": peça input livre.
+
+---
+
+## PASSO 4 — Multi-model routing (opcional)
+
+```
+AskUserQuestion({
+  question: "Deseja configurar model_fast e model_powerful separados?",
+  options: [
+    { label: "Não — usar um modelo só", description: "Mais simples" },
+    { label: "Sim — diferenciar por tier", description: "Fast + Powerful" }
+  ]
+})
+```
+
+Se Sim: perguntefast e powerful (máximo 2 AskUserQuestion adicionais).
+
+---
+
+## PASSO 5 — Resumo e confirmação
+
+Exiba resumo:
+```
+model_capability: {valor}
+model_name: {valor}
+model_fast: {valor ou "—"}
+model_powerful: {valor ou "—"}
+```
+
+```
+AskUserQuestion({
+  question: "Aplicar esta configuração?",
+  options: [
+    { label: "✅ Confirmar", description: "Salvar em preferences.md" },
+    { label: "↩️ Cancelar", description: "Não alterar" }
+  ]
+})
+```
+
+---
+
+## PASSO 6 — Salvar
+
+Atualize `docs/_memory/preferences.md` com os novos valores.
+
+---
+
+## PASSO 7 — Efeito por capability
+
+| model_capability | O que muda |
+|---|---|
+| `high` | Contexto completo — sem adaptação |
+| `standard` | CoT prefix + templates |
+| `lite` | Context pruning (~70%) + scope forcing |
 
 ```
 AskUserQuestion({

package/.synapos/core/commands/setup/discover.md

@@ -12,9 +12,10 @@ Este comando analisa automaticamente o projeto e gera um briefing técnico compl
 
 # REGRAS ABSOLUTAS
 
-## Regra 1: JANELAS INTERATIVAS são OBRIGATÓRIAS
+## Regra 1: ESCANEAR SILENCIOSAMENTE, VALIDAR UMA VEZ
 
-Após cada fase de detecção, você DEVE usar `AskUserQuestion` para validar os resultados.
+Detecte tudo silenciosamente. Valide apenas no final (Fase 5).
+Não pergunte após cada fase — isso cria fricção desnecessária.
 
 ## Regra 2: NUNCA INVENTE
 
@@ -78,29 +79,7 @@ Para cada arquivo `.md` encontrado na pasta de ADRs:
 1. Ler o arquivo
 2. Extrair: número, título, status, contexto, decisão, consequências
 
-### 1.3 VALIDAR ADRs Detectadas
-
-```
-AskUserQuestion({
-  question: "Encontrei as seguintes ADRs. Todas estão ativas e corretas?",
-  options: [
-    { label: "Sim, corretas", description: "Prosseguir" },
-    { label: "ADRs incorretas", description: "Vou informar quais estão erradas" },
-    { label: "Faltam ADRs", description: "Vou informar as que faltam" }
-  ]
-})
-```
-
-Se "ADRs incorretas" ou "Faltam ADRs":
-```
-AskUserQuestion({
-  question: "Quais ADRs devem ser incluidas ou corrigidas?",
-  options: [
-    { label: "Vou listar", description: "Informar ADRs manualmente" },
-    { label: "Pular ADRs", description: "Gerar sem esta ADR" }
-  ]
-})
-```
+> Armazene os resultados em `[ADRs_DETECTED]` para exibir na Fase 5.
 
 ---
 
@@ -128,47 +107,13 @@ Padrões que indicam Lovable:
 - shadcn/ui (`components/ui/`)
 - Vite config
 
-### 2.3 VALIDAR Frontend Detectado
-
-```
-AskUserQuestion({
-  question: "Encontrei um frontend. É Lovable?",
-  options: [
-    { label: "É Lovable", description: "Prosseguir com mapeamento" },
-    { label: "É customizado", description: "Frontend manual, não Lovable" },
-    { label: "Não é frontend", description: "Não existe frontend" }
-  ]
-})
-```
-
-Se "É Lovable", perguntar sobre mocks:
-```
-AskUserQuestion({
-  question: "O frontend Lovable tem mocks de dados? (hardcoded no código)",
-  options: [
-    { label: "Sim, tem mocks", description: "Vou identificar os mocks" },
-    { label: "Não tem mocks", description: "Frontend já integrado" },
-    { label: "Não sei", description: "Preciso verificar" }
-  ]
-})
-```
+### 2.3 Detectar Mocks (se Lovable)
 
-Se "Sim, tem mocks":
-- Escaneie componentes .tsx/.jsx em `src/`
+Se for Lovable, escaneie componentes .tsx/.jsx em `src/`:
 - Identifique: useState com arrays/objetos hardcoded, arquivos mock*.ts, fake*.ts
 - NÃO invente — liste apenas o que encontrar
 
-### 2.4 VALIDAR Mocks Encontrados
-
-```
-AskUserQuestion({
-  question: "Encontrei os seguintes mocks pendentes de integração. Confirmar?",
-  options: [
-    { label: "Corretos", description: "Prosseguir" },
-    { label: "Corrigir lista", description: "Vou informar quais estão errados" }
-  ]
-})
-```
+> Armazene resultados em `[FRONTEND_DETECTED]` e `[MOCKS_DETECTED]` para Fase 5.
 
 ---
 
@@ -205,82 +150,28 @@ Escanear e detectar:
 - Service Layer? (existe pasta services/)
 - MVC? (existe controllers/, models/)
 
-### 3.4 VALIDAR Backend Detectado
-
-```
-AskUserQuestion({
-  question: "Detectei backend em [caminho]. Estrutura está correta?",
-  options: [
-    { label: "Correto", description: "Prosseguir" },
-    { label: "Corrigir estrutura", description: "Vou informar a estrutura correta" }
-  ]
-})
-```
-
-```
-AskUserQuestion({
-  question: "Detected as seguintes pastas. Confirmar convenções?",
-  options: [
-    { label: "Corretas", description: "Prosseguir" },
-    { label: "Corrigir", description: "Vou informar as correções" }
-  ]
-})
-```
-
-### 3.5 NÃO Assuma, Pergunte
-
-Se não conseguir detectar padrão claramente:
+**Se não detectar claramente:** marcar como "não detectado" — não perguntar.
 
-```
-AskUserQuestion({
-  question: "Não consegui detectar o padrão arquitetural claramente. Qual é?",
-  options: [
-    { label: "MVC", description: "Model-View-Controller" },
-    { label: "Service Layer", description: "Services + Repositories" },
-    { label: "Clean Architecture", description: "Camadas separadas" },
-    { label: "Domain-Driven", description: "DDD com aggregates" },
-    { label: "Outro", description: "Vou especificar" }
-  ]
-})
-```
+> Armazene resultados em `[BACKEND_DETECTED]` para Fase 5.
 
 ---
 
 ## Fase 4: Detectar Stack Tecnológico (Silencioso)
 
-Ler `package.json` do backend:
-
-**Extrair:**
-- Framework web: express, fastify, nest, koa, hapi
-- Database/ORM: prisma, typeorm, drizzle, sequelize, mongoose
-- Validação: zod, joi, yup, class-validator
-- Testes: jest, vitest, mocha
-- Runtime: engines.node
-
-### 4.1 VALIDAR Stack
-
-```
-AskUserQuestion({
-  question: "Detectei a seguinte stack. Confirmar?",
-  options: [
-    { label: "Stack Correta", description: "Prosseguir" },
-    { label: "Corrigir stack", description: "Vou informar a stack correta" }
-  ]
-})
-```
-
-Se "Corrigir", perguntar cada item separadamente.
+> Armazene em `[STACK_DETECTED]` para Fase 5.
 
 ---
 
-## Fase 5: VALIDAR TUDO ANTES DE GERAR
+## Fase 5: VALIDAR TUDO (UMA vez só)
+
+Apresente o resumo consolidado de tudo que foi detectado:
 
 ```
 AskUserQuestion({
-  question: "Análise completa. Resumo do que foi detectado:",
+  question: "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nAnálise completa!\n\nADRs: {N} encontradas {ou "nenhuma"}\nFrontend: {[tipo] ou "não detectado"}\nBackend: {[caminho] ou "não detectado"}\nStack: {[lista] ou "não detectada"}\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\nTudo correto para gerar o briefing?",
   options: [
-    { label: "Está tudo correto", description: "Gerar briefing completo" },
-    { label: "Preciso corrigir", description: "Vou informar o que está errado" }
+    { label: "✅ Gerar briefing", description: "Prosseguir com geração" },
+    { label: "✏️ Corrigir algo", description: "Vou informar o que está errado" }
   ]
 })
 ```

package/.synapos/core/commands/setup/start.md

@@ -12,71 +12,20 @@ Você é o orquestrador de documentação do Synapos. Ao ser ativado, analise o
 
 Execute todas as verificações abaixo silenciosamente antes de apresentar qualquer output.
 
-### 1.1 — Ler contexto do framework
+### 1.1 — Verificar onboarding
 
 Verifique se os arquivos existem e leia-os:
 - `docs/_memory/company.md` → nome, setor, linguagem de saída
 - `docs/_memory/preferences.md` → IDE principal, preferências
 
 Se `docs/_memory/company.md` **não existir**:
-- Execute o **PROTOCOLO DE ONBOARDING** abaixo para criar os arquivos
-- Depois continue para a verificação da documentação
-
-### PROTOCOLO DE ONBOARDING (primeira vez)
-
-Apresente ao usuário:
-
-```
-Olá! Sou o Synapos — framework de orquestração de agents.
-Antes de começar, preciso de algumas informações rápidas:
-
-1. Seu nome ou nome da empresa:
-2. Setor / tipo de projeto principal:
-3. Linguagem de saída preferida: [PT-BR / EN-US / outro]
-4. IDE principal: [Claude Code / outro]
-5. Você usa algum task tracker? [GitHub Issues / Linear / Jira / Não uso]
-6. Qual modelo de IA você está usando? [Claude Sonnet/Opus / GPT-4o / Gemini Pro / Kimi / MiniMax / Outro]
-```
-
-Após as respostas, mapeie o modelo informado para o perfil de capacidade:
-
-| Modelo | model_capability |
-|---|---|
-| Claude Opus/Sonnet, GPT-4o, Gemini 1.5 Pro+ | `high` |
-| GPT-4o-mini, Gemini Flash, Claude Haiku | `standard` |
-| Kimi, MiniMax, Llama 3.x, modelos locais, outros não listados | `lite` |
-
-Se o usuário não souber ou pular a pergunta, assuma `high`.
-
-Crie os arquivos abaixo e continue para verificação da documentação:
-
-**`docs/_memory/company.md`:**
-```markdown
----
-atualizado: {YYYY-MM-DD}
----
-# Perfil
-
-**Nome:** {resposta}
-**Setor:** {resposta}
-**Linguagem de saída:** {resposta}
 ```
+⚠️ Onboarding não realizado.
 
-**`docs/_memory/preferences.md`:**
-```markdown
----
-atualizado: {YYYY-MM-DD}
----
-# Preferências
-
-**IDE Principal:** {resposta}
-**Formato de data:** YYYY-MM-DD
-**Task Tracker:** {github | linear | jira | none}
-**model_capability:** {high | standard | lite}
-**model_name:** {nome do modelo informado}
+Execute /init primeiro para configurar o projeto.
+O setup de documentação será retomado após o onboarding.
 ```
-
-**Pare aqui até que o onboarding esteja completo.**
+**Pare aqui e redirecione para /init.** O orchestrator handles the onboarding.
 
 ### 1.2 — Verificar documentação existente