synapos 2.6.0 → 2.7.0

package/.github/copilot-instructions.md

@@ -10,7 +10,7 @@
 Estas regras são ativas em **toda** interação, sem exceção:
 
 1. **Nunca execute sem contexto mínimo** — leia `docs/_memory/company.md` antes de qualquer ação significativa. Se não existir, inicie o onboarding (veja `.synapos/copilot.md`).
-2. **Nunca tome decisões autônomas** — escolhas de biblioteca, arquitetura, padrão ou framework que não estejam especificadas devem ser sinalizadas como `[DECISÃO PENDENTE]` e aguardar aprovação do usuário.
+2. **Nunca tome decisões autônomas** — escolhas de biblioteca, arquitetura, padrão ou framework que não estejam especificadas devem ser sinalizadas com `[?]` no output e aguardar aprovação do usuário antes de continuar.
 3. **Respeite ADRs existentes** — antes de implementar, verifique arquivos com `ADR`, `adr` ou `decisions` no nome em `docs/`. Conflito com ADR = bloqueio obrigatório.
 4. **Use os arquivos como memória** — estado e contexto vivem em `docs/.squads/sessions/{feature-slug}/`. Sempre leia antes de executar.
 5. **Nunca escreva dentro de `.synapos/`** — essa pasta é somente do framework.
@@ -24,19 +24,22 @@ Ative via comentário no código ou mensagem no chat:
 | Comando | Ação |
 |---------|------|
 | `synapos:init` | Iniciar ou retomar o orquestrador Synapos |
-| `synapos:squad squad:{domínio} mode:{modo} pipeline:{pipeline}` | Criar e ativar um squad |
+| `synapos:session` | Listar sessions ativas e navegar contexto de features |
+| `synapos:session slug:{feature}` | Abrir session específica com resumo de context.md |
+| `synapos:session consolidate` | Consolidar memories.md e review-notes.md manualmente |
+| `synapos:squad squad:{domínio} mode:{modo} pipeline:{pipeline}` | Criar e ativar um role |
 | `synapos:step step:{id}` | Executar um step específico do pipeline ativo |
 | `synapos:gate gate:{GATE-N}` | Executar validação de um gate |
-| `synapos:status` | Exibir estado do squad e session ativos |
-| `synapos:decision id:{N} choice:{A\|B}` | Resolver uma decisão pendente |
+| `synapos:status` | Exibir estado do role e session ativos |
 | `synapos:memory` | Exibir memória da feature ativa |
 
 **Exemplos:**
 ```
 // synapos:init
-// synapos:squad squad:frontend mode:bootstrap pipeline:bug-fix
+// synapos:session
+// synapos:session slug:auth-module
+// synapos:squad squad:frontend mode:quick pipeline:bug-fix
 // synapos:step step:01-gate-integridade
-// synapos:decision id:1 choice:A
 ```
 
 ---
@@ -45,11 +48,10 @@ Ative via comentário no código ou mensagem no chat:
 
 | Modo | Quando usar | Comportamento |
 |------|-------------|---------------|
-| `bootstrap` | Projeto novo ou quick fix | Contexto mínimo, sem bloquear execução |
-| `standard` | Feature com docs parciais | Gates essenciais, validação de decisões |
-| `strict` | Feature crítica com docs completas | Todos os gates, máxima qualidade |
+| `quick` | Bug fix, ajuste, quick change | Contexto mínimo — session files apenas |
+| `complete` | Feature nova, refactor, arquitetura | docs/, ADRs e session files completos |
 
-O modo é determinado automaticamente com base no score de documentação + complexidade da tarefa. Veja `.synapos/copilot.md` para a lógica completa.
+O modo é inferido automaticamente por palavras-chave da mensagem. Veja `.synapos/copilot.md` para a lógica completa.
 
 ---
 

package/.synapos/.manifest.json

@@ -1,7 +1,7 @@
 {
   "framework": {
     "name": "synapos",
-    "version": "2.6.0",
+    "version": "2.6.1",
     "released_at": "2026-04-03"
   },
   "best_practices": {
@@ -24,7 +24,7 @@
     }
   },
   "core": {
-    "orchestrator": "1.6.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.6.0
+2.6.1

package/.synapos/copilot.md

@@ -25,6 +25,7 @@ Antes de executar qualquer protocolo, tenha em mente:
 | `execution: checkpoint` | Apresente checklist `[ ]` e aguarde `ok` ou número |
 | Gates automáticos | Checklist ao final do output — falhas listadas explicitamente |
 | `/init`, `/setup:*` | `synapos:init`, `synapos:squad` via comentário ou mensagem |
+| `/session` | `synapos:session` — lista sessions, abre contexto, consolida memórias |
 
 Protocolo completo de adaptação: `.synapos/core/copilot-adapter.md`
 
@@ -60,65 +61,22 @@ Enquanto isso, você pode criar novos squads normalmente.
 
 ### PROTOCOLO DE ONBOARDING (primeira vez)
 
-Apresente as perguntas uma por vez. Aguarde resposta antes de prosseguir.
+**1 pergunta. Nada mais.**
 
-**Pergunta 1:**
 ```
-Olá! Sou o Synapos — framework de orquestração de agents.
+Olá! Sou o Synapos.
 
-Antes de começar, qual é o nome da empresa ou projeto?
-(Digite o nome)
-```
-
-**Pergunta 2:**
-```
-Qual é o setor ou tipo de projeto?
+Duas coisas rápidas para começar:
+  1. Qual é o nome do projeto?
+  2. O que você quer fazer agora?
 
-1) SaaS / Software
-2) E-commerce
-3) Aplicativo Mobile
-4) API / Backend
-5) Ferramenta Interna
-6) Open Source
-7) Outro — vou especificar
+Responda as duas juntas. Ex: "Meu SaaS — corrigir bug no login"
 ```
 
-**Pergunta 3:**
-```
-Qual linguagem de saída preferida?
-
-1) Português (PT-BR)
-2) English (EN-US)
-3) Outro
-```
-
-**Pergunta 4:**
-```
-Qual task tracker você usa?
-
-1) GitHub Issues
-2) Linear
-3) Jira
-4) Não uso
-```
-
-**Pergunta 5:**
-```
-Qual modelo de IA você está usando?
-
-1) GPT-4o (GitHub Copilot padrão)
-2) Claude Opus/Sonnet
-3) Gemini Pro
-4) Outro
-```
-
-Após as respostas, mapeie o modelo para `model_capability`:
-
-| Modelo | model_capability |
-|---|---|
-| GPT-4o, Claude Opus/Sonnet, Gemini 1.5 Pro+ | `high` |
-| GPT-4o-mini, Claude Haiku, Gemini Flash | `standard` |
-| Modelos locais, outros | `lite` |
+Com a resposta, extraia nome do projeto e contexto da tarefa. Defaults silenciosos:
+- Task tracker: `none`
+- model_capability: `high`
+- Linguagem: detectada na resposta, padrão `pt-BR`
 
 Crie os arquivos:
 
@@ -129,9 +87,9 @@ atualizado: {YYYY-MM-DD}
 ---
 # Perfil
 
-**Nome:** {resposta}
-**Setor:** {resposta}
-**Linguagem de saída:** {resposta}
+**Nome:** {nome inferido}
+**Setor:** não informado
+**Linguagem de saída:** {pt-BR | en-US}
 ```
 
 **`docs/_memory/preferences.md`:**
@@ -143,86 +101,42 @@ atualizado: {YYYY-MM-DD}
 
 **IDE Principal:** Copilot
 **Formato de data:** YYYY-MM-DD
-**Task Tracker:** {github | linear | jira | none}
-**model_capability:** {high | standard | lite}
-**model_name:** {nome do modelo informado}
+**Task Tracker:** none
+**model_capability:** high
+**model_name:** não informado
 ```
 
----
-
-## PASSO 2 — MODE DECISION SYSTEM
-
-Calcule o score de documentação e a complexidade da tarefa para determinar o modo de execução.
-
-### 2.1 — Score de Documentação
+> Setor, task tracker e modelo podem ser ajustados depois diretamente nos arquivos.
 
-| Item | Pontos |
-|------|--------|
-| `docs/_memory/company.md` existe | +30 |
-| `docs/tech/` existe com ≥ 1 arquivo `.md` | +20 |
-| `docs/business/` existe com ≥ 1 arquivo `.md` | +20 |
-| `docs/tech-context/` existe com ≥ 1 arquivo `.md` | +15 |
-| Total de arquivos `.md` em `docs/` ≥ 5 | +15 |
-
-Armazene como `[DOC_SCORE]` (0–100).
+---
 
-### 2.2 — Inferir Complexidade
+## PASSO 2 — ESCOLHA DE MODO
 
-Se o usuário não informou a tarefa ainda, pergunte:
-```
-O que você quer fazer?
-(Descreva em 1-2 frases — ex: corrigir bug no login, criar endpoint de pagamento)
-```
+**Tente inferir o modo automaticamente pela mensagem do usuário.**
 
-| Complexidade | Sinais |
+| Sinal na mensagem | Modo inferido |
 |---|---|
-| **LOW** | fix, typo, ajuste, quick, bug simples, texto, cor, label |
-| **MEDIUM** | feature, endpoint, component, tela, módulo, integração, CRUD |
-| **HIGH** | arquitetura, refactor, sistema, infra, migração, redesign, segurança |
-
-### 2.3 — Execution Mode
+| "fix", "bug", "typo", "quick", "ajuste", "cor", "texto" | `quick` |
+| "feature", "arquitetura", "refactor", "sistema", "integração" | `complete` |
+| Nenhum sinal claro | perguntar |
 
-| Condição | Modo |
-|---|---|
-| `company.md` não existe OU `[DOC_SCORE]` = 0 | **BOOTSTRAP** |
-| `[COMPLEXITY]` = LOW | **BOOTSTRAP** |
-| `[COMPLEXITY]` = MEDIUM e `[DOC_SCORE]` < 40 | **BOOTSTRAP** |
-| `[COMPLEXITY]` = MEDIUM e `[DOC_SCORE]` ≥ 40 | **STANDARD** |
-| `[COMPLEXITY]` = HIGH e `[DOC_SCORE]` < 70 | **STANDARD** |
-| `[COMPLEXITY]` = HIGH e `[DOC_SCORE]` ≥ 70 | **STRICT** |
-
-### 2.4 — Informar o Modo
-
-**BOOTSTRAP:**
+**Se não for possível inferir, pergunte:**
 ```
-⚡ Bootstrap Mode
-   Score de documentação: {DOC_SCORE}/100
-   Complexidade detectada: {COMPLEXITY}
-
-   Executando com contexto mínimo.
-   Pipelines disponíveis: quick-fix, bug-fix
+Como você quer executar?
 
-   Para desbloquear mais pipelines:
-   → Crie docs/tech/ com documentação técnica     (+20 pts)
-   → Crie docs/business/ com contexto de negócio  (+20 pts)
+1) ⚡ Rápido — executa direto, sem ler documentação do projeto
+2) 🔵 Completo — lê docs/, injeta ADRs e contexto completo
 ```
 
-**STANDARD:**
-```
-🟡 Standard Mode
-   Score de documentação: {DOC_SCORE}/100
-   Complexidade detectada: {COMPLEXITY}
+Armazene como `[EXECUTION_MODE]` (`quick` / `complete`).
 
-   Contexto parcial disponível. Gates ativos: GATE-0, GATE-ADR, GATE-DECISION.
+**Informe o modo escolhido:**
 ```
-
-**STRICT:**
+⚡ Modo Rápido — executando sem documentação de projeto.
 ```
-🔴 Strict Mode
-   Score de documentação: {DOC_SCORE}/100
-   Complexidade detectada: {COMPLEXITY}
-
-   Contexto completo disponível. Todos os gates ativos. Máxima qualidade.
+ou
+```
+🔵 Modo Completo — contexto completo disponível.
 ```
 
 ---
@@ -238,16 +152,16 @@ Para cada squad encontrado, leia `.synapos/squads/{squad}/squad.yaml` e extraia:
 
 ## PASSO 4 — MENU PRINCIPAL
 
-**Se existem squads**, apresente:
+**Se existem roles ativos (squads)**, apresente:
 ```
-Squads ativos:
+Roles ativos:
 
 1) 🟢 {slug} — {domain} · {description}
 2) 🟡 {slug} — {domain} · {description} (pausado)
-3) ✨ Criar novo squad
+3) ✨ Ativar novo role
 ```
 
-**Se não existem squads** → vá para PASSO 5.
+**Se não existem roles** → vá para PASSO 5.
 
 ---
 
@@ -397,17 +311,28 @@ Após confirmação, execute conforme `.synapos/core/pipeline-runner.md` com as
 Quando o usuário usa `synapos:squad` com parâmetros, pule direto para PASSO 6:
 
 ```
-// synapos:squad squad:frontend mode:bootstrap pipeline:bug-fix feature:fix-login
+// synapos:squad squad:frontend mode:quick pipeline:bug-fix feature:fix-login
 ```
 
 Parse os parâmetros:
-- `squad:` → domínio do squad
-- `mode:` → forçar execution mode (bootstrap/standard/strict)
+- `squad:` → domínio do role
+- `mode:` → forçar execution mode (`quick` / `complete`)
 - `pipeline:` → pipeline a usar
 - `feature:` → slug da feature session
 
 ---
 
+## COMANDO `synapos:session`
+
+Quando o usuário usa `synapos:session`, siga o protocolo de `.synapos/core/commands/session.md` com as adaptações Copilot ativas:
+
+- Sem AskUserQuestion → apresente lista numerada e aguarde resposta
+- `synapos:session` → lista todas as sessions
+- `synapos:session slug:{feature}` → abre session específica com resumo de context.md
+- `synapos:session consolidate` → consolida memories.md e review-notes.md da session ativa
+
+---
+
 ## COMANDO `synapos:status`
 
 Exiba o estado atual:
@@ -416,25 +341,29 @@ Exiba o estado atual:
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Synapos Status
 
-Squad ativo: {slug} ({domain})
+Role ativo:  {slug} ({domain})
 Feature:     {feature-slug}
 Pipeline:    {nome}
 Step atual:  {step-id} ({N}/{total})
-Modo:        {BOOTSTRAP | STANDARD | STRICT}
+Modo:        {Rápido | Completo}
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
 ---
 
-## PROTOCOLO DE ESCALATION
+## DECISÕES NO OUTPUT
+
+Quando precisar tomar uma decisão fora do escopo do step, sinalize com `[?]` no output:
 
-Mesmo mecanismo do Claude Code — quando uma decisão não pode ser resolvida:
+```
+[?] Decisão necessária: {descrição curta}
+Opções: A) {opção A}  B) {opção B}
+Recomendação: {opção preferida e motivo}
+```
 
-1. Registre `[DECISÃO PENDENTE] {feature-slug}-{N}` em `docs/.squads/sessions/{feature-slug}/open-decisions.md`
-2. Bloqueie o squad: `status → "blocked"`
-3. Informe o usuário
+Aguarde a resposta do usuário antes de continuar. Nunca decida autonomamente.
 
-Para resolver: `// synapos:decision id:{N} choice:{A|B}`
+Para responder: o usuário digita a opção escolhida na conversa.
 
 ---
 

package/.synapos/core/commands/bump.md

@@ -1,59 +1,39 @@
 ## PROTOCOLO DE BUMP
 
+Versiona o **pacote npm** do Synapos. Não versiona arquivos markdown internos.
+
 ### 1 — Ler estado atual
-- Leia `.synapos/VERSION` → versão atual do framework
-- Leia `.synapos/.manifest.json` → inventário completo
-- Leia `.synapos/CHANGELOG.md` → histórico de mudanças
+- Leia `package.json` → versão atual
+
+### 2 — Detectar tipo de bump
 
-### 2 — Identificar o que mudou
-Pergunte ao usuário (se não informado nos argumentos):
+**Se argumento fornecido** (ex: `/bump minor`): use diretamente.
+
+**Se sem argumento:**
 ```
-O que foi alterado?
-  [1] Agent (qual?)
-  [2] Template de squad (qual?)
-  [3] Core (orchestrator / pipeline-runner / gate-system / skills-engine)
-  [4] Múltiplos
-
-Tipo de mudança:
-  [M] MAJOR — quebra compatibilidade
-  [m] MINOR — adiciona sem quebrar
-  [p] PATCH — corrige sem quebrar
+AskUserQuestion({
+  question: "Versão atual: {versão}\n\nQual tipo de bump?",
+  options: [
+    { label: "PATCH", description: "Correção sem quebrar (~1.0.1)" },
+    { label: "MINOR", description: "Feature sem quebrar (~1.1.0)" },
+    { label: "MAJOR", description: "Breaking change (~2.0.0)" }
+  ]
+})
 ```
 
 ### 3 — Calcular nova versão
 Use semver: `MAJOR.MINOR.PATCH`
-- PATCH: Z+1 (ex: 1.0.0 → 1.0.1)
-- MINOR: Y+1, Z=0 (ex: 1.0.3 → 1.1.0)
-- MAJOR: X+1, Y=0, Z=0 (ex: 1.2.1 → 2.0.0)
+- PATCH: Z+1
+- MINOR: Y+1, Z=0
+- MAJOR: X+1, Y=0, Z=0
 
 ### 4 — Executar o bump
-Execute em ordem:
-
-**4a.** Atualizar `version:` no frontmatter do(s) arquivo(s) modificado(s)
 
-**4b.** Atualizar `.synapos/.manifest.json`:
-- Versão do componente alterado
-- Versão do framework (`framework.version` e `framework.released_at`)
+**4a.** Atualizar `version` em `package.json`
 
-**4c.** Atualizar `.synapos/VERSION` com a nova versão do framework
-
-**4d.** Adicionar entrada no `.synapos/CHANGELOG.md`:
-```markdown
-## [{nova_versão}] — {YYYY-MM-DD}
-
-### {Adicionado | Modificado | Corrigido | Removido}
-- `{componente}` v{versão} — {descrição da mudança}
-```
+**4b.** Adicionar entrada no `CHANGELOG.md` na raiz do projeto
 
-### 5 — Confirmar
-Apresente um resumo do bump realizado:
+### 5 — Resumo
 ```
-Bump concluído!
-
-Versão: {anterior} → {nova}
-Arquivos atualizados:
-  ✅ .synapos/VERSION
-  ✅ .synapos/.manifest.json
-  ✅ .synapos/CHANGELOG.md
-  ✅ {arquivo do componente alterado}
+✅ Bump: {anterior} → {nova}
 ```

package/.synapos/core/commands/session.md

@@ -0,0 +1,152 @@
+---
+name: synapos-session
+version: 1.0.0
+description: Gerenciamento de feature sessions — listar, visualizar, retomar e consolidar
+---
+
+# COMANDO /session
+
+> Ponto de acesso direto às sessions do projeto.
+> Use quando quiser ver o estado das features sem passar pelo /init completo.
+
+---
+
+## USO
+
+```
+/session              → lista todas as sessions ativas
+/session {slug}       → abre a session de uma feature específica
+/session consolidate  → consolida memories.md e review-notes.md da session ativa
+```
+
+---
+
+## PROTOCOLO
+
+### Sem argumento — listar sessions
+
+1. Liste todos os subdiretórios em `docs/.squads/sessions/`
+2. Para cada session, leia `state.json` e extraia:
+   - `feature` (slug)
+   - `squads` — lista de roles que trabalharam + status de cada um
+   - `updated_at` — data da última atividade
+
+Exiba com AskUserQuestion:
+
+```
+AskUserQuestion({
+  question: "Sessions ativas neste projeto:",
+  options: [
+    {
+      label: "📂 {feature-slug}",
+      description: "Roles: {lista} · Última atividade: {updated_at}"
+    },
+    // uma por session encontrada
+    { label: "↩ Voltar ao menu", description: "Ir para /init" }
+  ]
+})
+```
+
+Ao selecionar uma session → execute o protocolo **Com argumento** abaixo.
+
+---
+
+### Com argumento `{slug}` — abrir session
+
+1. Leia `docs/.squads/sessions/{slug}/context.md`
+2. Leia `docs/.squads/sessions/{slug}/memories.md`
+3. Leia `docs/.squads/sessions/{slug}/state.json`
+
+Exiba resumo e menu de ações:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Session: {feature-slug}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+O que é: {primeira linha de context.md ## O que é}
+Decisões: {contagem de itens em ## Decisões tomadas}
+Memórias: {contagem de ## em memories.md} entradas
+Roles que trabalharam: {lista do state.json}
+
+Última atividade: {updated_at do state.json}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+```
+AskUserQuestion({
+  question: "Session {feature-slug} — o que você quer fazer?",
+  options: [
+    { label: "▶️ Retomar com role ativo", description: "Continuar de onde parou" },
+    { label: "📄 Ver context.md", description: "Ler contexto completo da feature" },
+    { label: "🧠 Ver memories.md", description: "Ver aprendizados acumulados" },
+    { label: "🗜 Consolidar", description: "Compactar memories e review-notes" },
+    { label: "↩ Voltar", description: "Voltar à lista de sessions" }
+  ]
+})
+```
+
+- **Retomar com role ativo** → redirecione para o `/init` passando o slug da session como contexto
+- **Ver context.md** → exiba o conteúdo do arquivo inline
+- **Ver memories.md** → exiba o conteúdo do arquivo inline
+- **Consolidar** → execute o protocolo de consolidação abaixo
+
+---
+
+### Com argumento `consolidate` — consolidar session ativa
+
+> Use quando memories.md ou review-notes.md estiverem grandes e difíceis de ler.
+> Consolidar não deleta informação — apenas reorganiza.
+
+**Pré-condição:** deve haver uma session ativa no contexto (slug conhecido).
+Se não houver, liste as sessions e peça ao usuário para escolher.
+
+**Protocolo de consolidação de `memories.md`:**
+
+1. Leia o arquivo completo
+2. Identifique entradas antigas (mais de 7 dias ou mais de 10 entradas)
+3. Crie nova seção no topo:
+   ```markdown
+   ## Consolidado até {YYYY-MM-DD}
+
+   ### Aprendizados principais
+   {resumo estruturado preservando todas as informações relevantes}
+
+   ### Armadilhas identificadas
+   {lista das armadilhas mais importantes}
+
+   ### Decisões registradas
+   {decisões que não estão em context.md}
+   ```
+4. Marque entradas consolidadas com `<!-- consolidado {data} -->`
+5. Não delete nenhuma entrada
+
+**Protocolo de consolidação de `review-notes.md`:**
+
+1. Leia o arquivo completo
+2. Crie nova seção no topo:
+   ```markdown
+   ## Revisões Consolidadas até {YYYY-MM-DD}
+
+   {resumo estruturado das revisões antigas, agrupado por tema}
+   ```
+3. Marque entradas consolidadas com `<!-- consolidado {data} -->`
+
+**Log ao concluir:**
+```
+✅ Consolidação concluída
+   memories.md: {N} entradas → 1 bloco consolidado
+   review-notes.md: {N} entradas → 1 bloco consolidado
+   Session: docs/.squads/sessions/{feature-slug}/
+```
+
+---
+
+## REGRAS
+
+| Regra | Descrição |
+|-------|-----------|
+| **Leitura apenas** | `/session` nunca modifica arquivos — exceto `/session consolidate` |
+| **Consolidar é manual** | Nunca consolide automaticamente — só quando o usuário executar `/session consolidate` |
+| **context.md é a estrela** | Sempre exiba o resumo de context.md no cabeçalho da session |
+| **Sem pipeline** | `/session` não inicia pipeline — apenas navega e organiza |