synapos 2.5.0 → 2.6.1

package/.synapos/.manifest.json

@@ -1,7 +1,7 @@
 {
   "framework": {
     "name": "synapos",
-    "version": "2.5.0",
+    "version": "2.6.1",
     "released_at": "2026-04-03"
   },
   "best_practices": {
@@ -24,7 +24,7 @@
     }
   },
   "core": {
-    "orchestrator": "1.5.0",
+    "orchestrator": "1.6.1",
     "pipeline_runner": "2.3.0",
     "gate_system": "1.5.0",
     "model_adapter": "1.1.0",

package/.synapos/VERSION

@@ -1 +1 @@
-2.5.0
+2.6.1

package/.synapos/core/orchestrator.md

@@ -1,6 +1,6 @@
 ---
 name: synapos-orchestrator
-version: 1.5.0
+version: 1.6.1
 description: Meta-orquestrador do Synapos Framework — ponto de entrada universal multi-IDE
 ---
 
@@ -311,17 +311,42 @@ Construa a lista interna de squads ativos.
 
 ---
 
+## PASSO 3.5 — VERIFICAR SQUAD TEMPLATES
+
+Verifique se existem subdiretórios em `.synapos/squad-templates/` (ignorar `.gitkeep`).
+
+Armazene como `[HAS_TEMPLATES]` (true / false).
+
+**Se `[HAS_TEMPLATES]` = false:**
+
+```
+AskUserQuestion({
+  question: "⚠️ Nenhum squad template instalado.\n\nSem templates não é possível criar squads.\n\nInstale templates com:\n  npx synapos add <template>",
+  options: [
+    { label: "Encerrar", description: "Fechar o orquestrador" }
+  ]
+})
+```
+
+**Pare a execução.** Não continue para PASSO 4.
+
+---
+
 ## PASSO 4 — MENU PRINCIPAL
 
-**Se existem squads**, use AskUserQuestion:
+**Se existem squads**, monte o menu com AskUserQuestion.
+
+Regra para a opção "Criar novo squad":
+- **Inclua** `{ label: "✨ Criar novo squad", description: "Montar um novo squad do zero" }` **apenas se** `[HAS_TEMPLATES]` = true.
+- **Se** `[HAS_TEMPLATES]` = false, **não inclua** essa opção e adicione um aviso no `question`: `"\n\n⚠️ Criação de squads indisponível — nenhum template instalado. Execute: npx synapos add <template>"`.
 
 ```
 AskUserQuestion({
-  question: "Olá, {nome do usuário}! Qual squad você quer trabalhar?",
+  question: "Olá, {nome do usuário}! Qual squad você quer trabalhar?{aviso se sem templates}",
   options: [
     { label: "🟢 {slug}", description: "{domain} · {description} (ativo)" },
     { label: "🟡 {slug}", description: "{domain} · {description} (pausado)" },
-    { label: "✨ Criar novo squad", description: "Montar um novo squad do zero" }
+    // ✨ Criar novo squad — incluir SOMENTE se [HAS_TEMPLATES] = true
   ]
 })
 ```
@@ -331,12 +356,16 @@ AskUserQuestion({
 - 🟡 paused — pausado, pode retomar
 - ✅ completed — entregue
 
-**Se não existem squads** → vá direto para PASSO 5.
+**Se não existem squads e `[HAS_TEMPLATES]` = true** → vá direto para PASSO 5.
+
+**Se não existem squads e `[HAS_TEMPLATES]` = false** → já foi tratado no PASSO 3.5. Este passo nunca será alcançado nesse estado.
 
 ---
 
 ## PASSO 5 — SELEÇÃO DE DOMÍNIO
 
+> **Pré-condição:** `[HAS_TEMPLATES]` = true (garantido pelo PASSO 3.5).
+
 Liste os subdiretórios em `.synapos/squad-templates/` e leia `template.yaml` para cada um.
 
 Monte as opções para AskUserQuestion:
@@ -352,16 +381,10 @@ AskUserQuestion({
 })
 ```
 
-**Se nenhum template for encontrado:** use AskUserQuestion para informar:
+**Roteamento obrigatório — execute apenas UM dos caminhos abaixo:**
 
-```
-AskUserQuestion({
-  question: "Nenhum squad template instalado.\n\nInstale templates com: npx synapos",
-  options: [
-    { label: "Voltar", description: "Voltar ao menu" }
-  ]
-})
-```
+- Se o usuário selecionou um template existente → **vá para PASSO 6**. Não execute SQUAD CUSTOMIZADO.
+- Se o usuário selecionou "✨ Customizado" → **vá para SQUAD CUSTOMIZADO**. Não execute PASSO 6.
 
 ---
 
@@ -464,46 +487,6 @@ AskUserQuestion({
 })
 ```
 
-Seção 6.5 — Feature Session (SELEÇÃO INTERATIVA)
-
-**Use AskUserQuestion:**
-
-```
-AskUserQuestion({
-  question: "Este squad trabalha em qual feature?",
-  options: [
-    { label: "📂 Session existente", description: "Selecionar feature já criada" },
-    { label: "✨ Nova feature", description: "Criar nova feature session" }
-  ]
-})
-```
-
-**Se "Session existente":**
-Liste as pastas em `docs/.squads/sessions/` com AskUserQuestion:
-
-```
-AskUserQuestion({
-  question: "Selecione a feature session:",
-  options: [
-    { label: "{feature-slug}", description: "{descrição do state.json}" },
-    { label: "{feature-slug}", description: "{descrição}" }
-  ]
-})
-```
-
-**Se "Nova feature":**
-
-```
-AskUserQuestion({
-  question: "Qual é o nome/slug da nova feature?",
-  options: [
-    { label: "Vou informar", description: "Ex: auth-module, feat/pagamentos" }
-  ]
-})
-```
-
-`{feature-slug}` = lowercase, espaços → hífens, sem caracteres especiais.
-
 ---
 
 ## PASSO 7 — CRIAR SQUAD
@@ -544,8 +527,8 @@ mode: {alta | economico | solo}
 execution_mode: {bootstrap | standard | strict}   # determinado pelo Mode Decision System no PASSO 2
 doc_score: {0-100}                                # score de documentação no momento da criação
 created_at: {YYYY-MM-DD}
-feature: {feature-slug}
-session: docs/.squads/sessions/{feature-slug}/
+feature: ""        # preenchido no PASSO 7.5
+session: ""        # preenchido no PASSO 7.5
 agents:
   - {id do agent 1}
   - {id do agent 2}
@@ -558,7 +541,7 @@ project_context:
   docs_business: docs/business/
   docs_tech: docs/tech/
   docs_context: docs/tech-context/
-  session: docs/.squads/sessions/{feature-slug}/
+  session: ""      # preenchido no PASSO 7.5
 ```
 
 ### 7.3 — Inicializar project-learnings.md (se não existir)
@@ -576,6 +559,57 @@ Verifique se `docs/_memory/project-learnings.md` existe. Se não existir, crie:
 
 ---
 
+## PASSO 7.5 — FEATURE SESSION
+
+> **Executar apenas após o squad ter sido criado (arquivos do PASSO 7 já gravados).**
+
+**Use AskUserQuestion:**
+
+```
+AskUserQuestion({
+  question: "Squad {squad-slug} criado! 🎉\n\nAgora, em qual feature este squad vai trabalhar?",
+  options: [
+    { label: "📂 Session existente", description: "Selecionar feature já criada" },
+    { label: "✨ Nova feature", description: "Criar nova feature session" }
+  ]
+})
+```
+
+**Se "Session existente":**
+Liste as pastas em `docs/.squads/sessions/` com AskUserQuestion:
+
+```
+AskUserQuestion({
+  question: "Selecione a feature session:",
+  options: [
+    { label: "{feature-slug}", description: "{descrição do state.json}" },
+    { label: "{feature-slug}", description: "{descrição}" }
+  ]
+})
+```
+
+**Se "Nova feature":**
+
+```
+AskUserQuestion({
+  question: "Qual é o nome/slug da nova feature?",
+  options: [
+    { label: "Vou informar", description: "Ex: auth-module, feat/pagamentos" }
+  ]
+})
+```
+
+`{feature-slug}` = lowercase, espaços → hífens, sem caracteres especiais.
+
+Após obter o `{feature-slug}`, atualize o campo `feature` e `session` no `squad.yaml` já criado:
+
+```yaml
+feature: {feature-slug}
+session: docs/.squads/sessions/{feature-slug}/
+```
+
+---
+
 ## PASSO 8 — ATIVAR SQUAD
 
 ### 8.1 — Resumo e Confirmação
@@ -716,51 +750,17 @@ AskUserQuestion({
 
 Aguarde a seleção do usuário.
 
-**Se `status` é `"completed"`, `"discarded"` ou não existe entrada para este squad** → menu padrão:
-
-```
-Squad {squad-slug} carregado.
-Feature: {feature-slug}
-Session: docs/.squads/sessions/{feature-slug}/
-
-Squads que já trabalharam nesta feature:
-  {lista de state.squads com status e completed_at}
-
-O que você quer fazer?
-
-- 🔄 Nova execução deste squad (manter contexto da session)
-- 🧠 Ver memória da feature
-- 📂 Ver arquivos da session
-- ⏸️ Pausar / arquivar squad
-```
-
-Aguarde a seleção do usuário.
-
 5. Siga a escolha do usuário e execute via `.synapos/core/pipeline-runner.md`.
 
 ---
 
 ## SQUAD CUSTOMIZADO
 
-Quando o usuário escolhe squad customizado:
+Quando o usuário escolhe "✨ Customizado" no PASSO 5.
 
-1. **Pergunte o domínio/objetivo com AskUserQuestion:**
-
-```
-AskUserQuestion({
-  question: "Qual é o objetivo deste squad customizado?",
-  options: [
-    { label: "Backend API", description: "Foco em endpoints e lógica de servidor" },
-    { label: "Frontend Web", description: "Foco em UI e experiência do usuário" },
-    { label: "Fullstack", description: "Frontend + Backend juntos" },
-    { label: "Mobile", description: "App iOS/Android" },
-    { label: "DevOps/Infra", description: "Infraestrutura e pipelines" },
-    { label: "Outro", description: "Vou descrever o objetivo" }
-  ]
-})
-```
+> O domínio já foi identificado como "customizado" — não pergunte novamente. Siga diretamente para a configuração abaixo.
 
-2. Leia `.synapos/squad-templates/` e liste todos os agents disponíveis com AskUserQuestion (multi-select)
+1. Leia `.synapos/squad-templates/` e liste todos os agents disponíveis com AskUserQuestion (multi-select)
 
 3. **Seleção de pipeline:**
 

package/bin/synapos.js

@@ -31,7 +31,7 @@ const PACKAGE_DIR = path.join(__dirname, '..');
 const VERSION = (() => {
   try {
     return JSON.parse(fs.readFileSync(path.join(PACKAGE_DIR, 'package.json'), 'utf8')).version;
-  } catch { return '2.5.0'; }
+  } catch { return '2.6.1'; }
 })();
 
 // Squad definitions — value = folder name in squad-templates/
@@ -162,8 +162,8 @@ ${bold('OPÇÕES')}
   -h, --help         Exibe esta ajuda
 
 ${bold('EXEMPLOS')}
-  npx synapos                     Seleção interativa de squads
-  npx synapos front               Instala squad Frontend
+  npx synapos                     Instala todos os squads + seleciona IDE
+  npx synapos front               Instala só o squad Frontend
   npx synapos front back          Instala Frontend + Backend
   npx synapos front back devops   Instala múltiplos squads
 `);
@@ -180,7 +180,7 @@ ${bold('EXEMPLOS')}
     process.exit(1);
   }
 
-  // ── 1. Resolver squads via args ou seleção interativa ────────────────────────
+  // ── 1. Resolver squads via args ou instalar todos por padrão ─────────────────
   let selectedSquadIds = [];
 
   if (args.length > 0) {
@@ -194,24 +194,9 @@ ${bold('EXEMPLOS')}
     info(`Squads selecionados via argumento: ${selectedSquadIds.join(', ')}`);
     nl();
   } else {
-    // Seleção interativa
-    const { selected } = await prompts({
-      type:         'multiselect',
-      name:         'selected',
-      message:      'Quais squads você quer instalar?',
-      choices:      SQUADS.map(s => ({
-        title:       s.title,
-        value:       s.value,
-        description: s.description,
-        selected:    false,
-      })),
-      hint:         '- Espaço para selecionar, Enter para confirmar',
-      instructions: false,
-      min:          1,
-    }, { onCancel: () => { nl(); process.exit(0); } });
-
-    if (!selected || selected.length === 0) process.exit(0);
-    selectedSquadIds = selected;
+    // Instalar todos os squads disponíveis
+    selectedSquadIds = SQUADS.map(s => s.value);
+    info(`Instalando todos os squads disponíveis (${selectedSquadIds.length})`);
     nl();
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synapos",
-  "version": "2.5.0",
+  "version": "2.6.1",
   "description": "Synapos Framework — AI agent orchestration for multi-IDE development",
   "keywords": ["ai", "agents", "claude", "cursor", "framework", "orchestration", "llm"],
   "author": "",