sinapse-ai 1.16.0 → 1.19.0

package/.sinapse-ai/lib/build.json

@@ -0,0 +1 @@
+{"built": true}

package/.sinapse-ai/product/templates/personalized-task-template-v2.md

@@ -417,12 +417,14 @@ acceptance-criteria:
 
 ```yaml
 **Scripts:**
-- .sinapse-ai/scripts/dev-specific/test-runner.js:
+# Replace the placeholder paths below with the REAL path to each script that
+# actually exists in the repo. If the task has no agent-specific script, use `- N/A`.
+- {path/to/agent-specific-script.js}:
     description: Runs tests with coverage reporting specific to dev agent
     language: javascript
     version: 1.2.0
 
-- .sinapse-ai/scripts/qa-specific/regression-validator.js:
+- {path/to/another-agent-script.js}:
     description: QA-specific regression validation logic
     language: javascript
     version: 2.0.0

package/.sinapse-ai/product/templates/prd-tmpl.yaml

@@ -126,7 +126,9 @@ sections:
     title: Epic List
     instruction: |
       Present a high-level list of all epics for user approval. Each epic should have a title and a short (1 sentence) goal statement. This allows the user to review the overall structure before diving into details.
-      
+
+      PRESENTATION: Render the epic list as a scannable approval table per `.sinapse-ai/development/templates/approval-table.md` (Epic list schema: `| # | Epic | Goal (1 line) | Stories |`) BEFORE the 1-9 elicitation menu. Do not present epics as a count or plain prose.
+
       CRITICAL: Epics MUST be logically sequential following agile best practices:
       
       - Each epic should deliver a significant, end-to-end, fully deployable increment of testable functionality
@@ -147,7 +149,9 @@ sections:
     repeatable: true
     instruction: |
       After the epic list is approved, present each epic with all its stories and acceptance criteria as a complete review unit.
-      
+
+      PRESENTATION: For each epic, render its stories as a scannable approval table per `.sinapse-ai/development/templates/approval-table.md` (Epic detail schema: `| Story | As a … / I want … | ACs | Depends on |`) BEFORE the 1-9 elicitation menu, then the expanded goal and per-story detail.
+
       For each epic provide expanded goal (2-3 sentences describing the objective and value all the stories will achieve).
       
       CRITICAL STORY SEQUENCING REQUIREMENTS:

package/.sinapse-ai/product/templates/statusline/statusline-script.js

@@ -215,11 +215,15 @@ function simpleHash(str) {
 
 function getGitInfo() {
   const result = { project: '', branch: '', filesChanged: 0 };
+  // stderr is suppressed via stdio, NOT `2>/dev/null` — on Windows cmd.exe treats
+  // /dev/null as a literal path and fails the redirect before git runs, so the
+  // statusline would lose project/branch/dirty-count on every refresh.
+  const gitOpts = { encoding: 'utf8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'] };
   try {
-    const toplevel = execSync('git rev-parse --show-toplevel 2>/dev/null', { encoding: 'utf8', timeout: 3000 }).trim();
+    const toplevel = execSync('git rev-parse --show-toplevel', gitOpts).trim();
     result.project = path.basename(toplevel);
-    result.branch = execSync('git rev-parse --abbrev-ref HEAD 2>/dev/null', { encoding: 'utf8', timeout: 3000 }).trim();
-    const status = execSync('git status --porcelain 2>/dev/null', { encoding: 'utf8', timeout: 3000 }).trim();
+    result.branch = execSync('git rev-parse --abbrev-ref HEAD', gitOpts).trim();
+    const status = execSync('git status --porcelain', gitOpts).trim();
     if (status) {
       result.filesChanged = status.split('\n').filter(l => l.trim()).length;
     }

package/CHANGELOG.md

@@ -1,10 +1,4 @@
-## [1.16.0](https://github.com/caioimori/sinapse-ai/compare/1.15.0...1.16.0) (2026-06-25)
-
-### Features
-
-* add clarify and analyze gates to Spec Pipeline ([#280](https://github.com/caioimori/sinapse-ai/issues/280)) ([18b643f](https://github.com/caioimori/sinapse-ai/commit/18b643fe6d4038bb5a9967dccdd7b34bf3b9f6cc))
-
-# Changelog
+# Changelog
 
 All notable changes to SINAPSE will be documented in this file.
 
@@ -13,6 +7,90 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.19.0] — 2026-06-30 — ⚙️ Motor de orquestração real (do teatro ao código)
+
+> Minor release. Atualização segura via `npx sinapse-ai update`.
+
+### Features
+
+- **orchestration** — `generatePlan` agora planeja via `claude` real sobre a story completa, em vez do stub anterior; quando o agente não está disponível, o fallback é honestamente marcado como `degraded`/`stub` (sem fabricar sucesso) (#307).
+- **orchestration** — o gate `epic4_to_epic6` ganha o check `plan_is_real`, que BLOQUEIA plano degradado ou ausente; o score do gate ficou honesto — gate sem checks não recebe mais nota máxima (#308).
+
+### Bug Fixes
+
+- **cross-platform** — hardening Windows/macOS: exec bits, spawn de `.cmd` shims, shell pipelines e gate de CI pré-merge (#294).
+- **cross-platform** — hardening Windows/macOS (ondas 2+3): statusline git, normalização de paths, BOM em config e EPERM por file-locking (#295).
+- **cross-platform** — hardening onda 3: retry de file-locking no install/migração de MCP, BOM no config global e CRLF no doctor (#296).
+- **orchestration** — `BrownfieldHandler` chamava um método inexistente no `WorkflowExecutor`, fazendo a discovery brownfield falhar em silêncio; `executeWorkflow()` implementado e coberto por teste de contrato.
+- **installer** — falha de `install` agora exibe mensagem de erro classificada e acionável (permissão, disco, rede, etc.) em vez de texto genérico.
+- **orchestration** — terminal-spawner em ambiente headless (CI/SSH/Docker/VSCode) não tenta mais `spawn(bash, pm.sh)`: guard consciente de capacidade que cai no fallback de "manual execution", eliminando ruído de teste e workers lentos — a suíte do motor caiu de timeout (2min) para ~5s (#309).
+- **installer** — rollback transacional em upgrades: se o upgrade falha no meio, o estado anterior é restaurado por inteiro (#306).
+- **perf** — perf-tests do squad tolerantes a carga: o orçamento de tempo deixa de gerar falsos negativos sob carga de CI (#303).
+- **tasks** — paths fabricados removidos dos rodapés de tasks (Tools/Scripts), com guard no validador para impedir reincidência (#304).
+- **orchestration** — espelho do orquestrador master sincronizado + invariante de contagem honesto (#305).
+
+### Documentation
+
+- **readme** — corrige a nota de `npm install`: o setup roda explicitamente via `npx sinapse-ai install` (ou `npm run setup`), não mais por um postinstall automático.
+
+### Maintenance
+
+- **ci** — release notes do workflow de publish apontam para o repositório correto (`caioimori/sinapse-ai`).
+- **audit** — auditoria clínica pré-divulgação em andamento: correções de runtime, instalador, documentação e precisão de métricas.
+
+## [1.17.0] — 2026-06-27 — 🗺️ Atlas auto-documentado + motor doc-first religado + sweep de segurança
+
+> Minor release. Atualização segura via `npx sinapse-ai update`.
+
+### Features
+
+- **doc-first** — tabelas de aprovação escaneáveis para PRD/épico/story/spec (#281).
+- **doc-first** — motor de roteamento + gate de enforcement (Camadas 1+2) (#282).
+- **atlas** — Framework Operating Atlas: mapa auto-documentado do framework (LLM + visual) (#283).
+- **atlas** — fluxos operacionais visuais de como o framework funciona (#284).
+- **orchestration** — `sinapse build` religa o motor BobOrchestrator ao CLI (#286).
+- **atlas** — fluxos completos do framework: 6 → 12 meta-workflows (#287).
+- **atlas** — research card PT-BR: SINAPSE como estudo de caso + LOOPS (#288).
+
+### Bug Fixes
+
+- **atlas** — headings do research-card no formato do parser do site (MF1 — …) (#289).
+- **atlas** — remove vazamento de vault pessoal do framework público + endurece guard (#290).
+- **security** — sweep profundo: remove leaks pessoais/cliente residuais + endurece guard (#291).
+
+### Documentation
+
+- **orqx** — alinha a prosa de bootstrap do Imperator ao motor doc-first resolver (#285).
+
+## [1.16.0] — 2026-06-25 — 🚦 Gates de clarify + analyze no Spec Pipeline
+
+> Minor release. Atualização segura via `npx sinapse-ai update`.
+
+### Features
+
+- Adiciona gates de clarify e analyze ao Spec Pipeline (#280).
+
+## [1.15.0] — 2026-06-24 — 🌐 Chrome Brain nativo + selos de identidade na statusline
+
+> Minor release. Atualização segura via `npx sinapse-ai update`.
+
+### Features
+
+- **chrome-brain** — scripts nativos em Node; não mata mais a janela boa; janela fixa + login.
+- **statusline** — selos de identidade de agente + banner de install.
+
+## [1.14.0] — 2026-06-24 — ⚙️ Munição de engenharia em 170 agentes
+
+> Minor release. Atualização segura via `npx sinapse-ai update`.
+
+### Features
+
+- **agents** — potencializa 170 agentes com a base de engenharia de software (#278).
+
+### Maintenance
+
+- **release** — sincroniza main com a v1.13.0 publicada (package.json + CHANGELOG) (#277).
+
 ## [1.13.0] — 2026-06-22 — 🧹 Limpeza profunda (varredura de 6 ondas) + munição de engenharia nos agents
 
 > Minor release. Atualização segura via `npx sinapse-ai update`.

package/README.en.md

@@ -19,7 +19,7 @@
 
 ## What is SINAPSE?
 
-SINAPSE is an open-source meta-framework that organizes **172 AI agents into 17 specialized squads**, operating directly in the terminal via Claude Code or Codex CLI. Each agent has a defined role, each squad masters a discipline, and the entire system is governed by a **Constitution with real enforcement** -- 19 active hooks that block violations at runtime.
+SINAPSE is an open-source meta-framework that organizes **172 AI agents into 17 specialized squads**, operating directly in the terminal via Claude Code or Codex CLI. Each agent has a defined role, each squad masters a discipline, and the entire system is governed by a **Constitution with real enforcement** -- 17 active hooks that block violations at runtime.
 
 The core concept is simple: instead of a single AI assistant trying to do everything, SINAPSE structures work into specialized teams. A branding squad handles visual identity. A cybersecurity squad handles compliance and pentesting. A copywriting squad handles persuasion and conversion. Each with its own knowledge base, workflows, and tasks -- totaling **1,200 executable tasks** ready to use.
 
@@ -33,7 +33,7 @@ Generative AI has a known problem: the more you ask of it, the worse it gets. A
 
 SINAPSE solves this the way human teams solve it: **coordinated specialization**. Instead of one tired generalist, you have 172 agents in 17 squads, each with a defined role, its own knowledge base, and executable tasks. An orchestrator routes your request to whoever actually knows how to solve it -- automatically, without you needing to memorize agent names or commands.
 
-The differential isn't just the quantity of agents. It's **real governance**: 19 active hooks intercept operations at runtime, a Constitution with 11 articles governs the framework, and 7 of those articles are NON-NEGOTIABLE -- violations are blocked before execution, not detected afterwards. **Speed with rigor, without choosing between the two.**
+The differential isn't just the quantity of agents. It's **real governance**: 17 active hooks intercept operations at runtime, a Constitution with 11 articles governs the framework, and 7 of those articles are NON-NEGOTIABLE -- violations are blocked before execution, not detected afterwards. **Speed with rigor, without choosing between the two.**
 
 ---
 
@@ -174,7 +174,7 @@ Deny rules in `.claude/settings.json` enforce this deterministically. **Framewor
 
 ### Constitution
 
-SINAPSE is governed by a formal Constitution with 11 articles and 19 enforcement hooks:
+SINAPSE is governed by a formal Constitution with 11 articles and 17 enforcement hooks:
 
 | Article | Principle | Severity |
 |---------|-----------|----------|
@@ -294,7 +294,7 @@ Both IDEs have access to all 17 squads, 172 agents, workflows, and knowledge bas
 | Feature | Claude Code | Codex CLI |
 |---------|:-----------:|:---------:|
 | Agent activation (@agent) | Full | Full |
-| Constitutional hooks (19) | Full | Partial (5) |
+| Constitutional hooks (17) | Full | Partial (5) |
 | Story-driven development | Full | Full |
 | Quality gates | Full | Full |
 | Delegation enforcement | Full | Partial |
@@ -335,7 +335,7 @@ If you identify with the first group, you're in the right place.
 
 ### Constitutional Enforcement
 
-SINAPSE doesn't just document rules -- it enforces them with **19 active hooks**:
+SINAPSE doesn't just document rules -- it enforces them with **17 active hooks**:
 
 - `enforce-git-push-authority.sh` -- blocks push by unauthorized agents
 - `enforce-story-gate.cjs` -- blocks code without a validated story

package/README.md

@@ -21,7 +21,7 @@
 
 ## O que é o SINAPSE?
 
-SINAPSE é um meta-framework open source que organiza **172 agentes de IA em 17 squads especializados**, operando direto no terminal via Claude Code ou Codex CLI. Cada agente tem um papel definido, cada squad domina uma disciplina, e o sistema inteiro é governado por uma **Constitution com enforcement real** — 19 hooks ativos que bloqueiam violações em tempo de execução.
+SINAPSE é um meta-framework open source que organiza **172 agentes de IA em 17 squads especializados**, operando direto no terminal via Claude Code ou Codex CLI. Cada agente tem um papel definido, cada squad domina uma disciplina, e o sistema inteiro é governado por uma **Constitution com enforcement real** — 17 hooks ativos que bloqueiam violações em tempo de execução.
 
 O conceito central é simples: em vez de um único assistente de IA tentando fazer tudo, o SINAPSE estrutura o trabalho em equipes especializadas. Um squad de branding cuida da identidade visual. Um squad de cybersecurity cuida de compliance e pentest. Um squad de copywriting cuida de persuasão e conversão. Cada um com sua própria knowledge base, workflows e tasks — totalizando **1.200 tasks executáveis** prontas para uso, distribuídas pelos 17 squads.
 
@@ -35,7 +35,7 @@ IA generativa tem um problema conhecido: quanto mais você pede, pior fica. Um
 
 O SINAPSE resolve isso do jeito que times humanos resolvem: **especialização coordenada**. Em vez de um generalista cansado, você tem 172 agentes em 17 squads, cada um com papel definido, knowledge base própria e tasks executáveis. Um orquestrador roteia seu pedido para quem realmente sabe resolver — automaticamente, sem você precisar decorar nomes de agentes ou comandos.
 
-O diferencial não é apenas a quantidade de agentes. É **governança real**: 19 hooks ativos interceptam operações em tempo de execução, uma Constitution com 11 artigos rege o framework, e 7 desses artigos são NON-NEGOTIABLE — violações são bloqueadas antes de executar, não detectadas depois. **Velocidade com rigor, sem escolher entre os dois.**
+O diferencial não é apenas a quantidade de agentes. É **governança real**: 17 hooks ativos interceptam operações em tempo de execução, uma Constitution com 11 artigos rege o framework, e 7 desses artigos são NON-NEGOTIABLE — violações são bloqueadas antes de executar, não detectadas depois. **Velocidade com rigor, sem escolher entre os dois.**
 
 ---
 
@@ -67,7 +67,7 @@ Se algo estiver fora do lugar, `doctor --fix` corrige automaticamente.
 
 Pronto. Você tem 17 squads operando no seu terminal.
 
-> **Nota sobre `npm install`:** O SINAPSE roda um postinstall automático que sincroniza agents para o Claude Code, cria os diretórios de runtime (`.sinapse/handoffs/`, `.sinapse/scratchpad/`) e executa um health check rápido. Para desabilitar (CI, pipelines avançadas), defina `SINAPSE_SKIP_POSTINSTALL=1` antes do `npm install`, ou rode `npm install --ignore-scripts` (comportamento nativo do npm — nenhum postinstall é executado). Nesse caso, rode `sinapse doctor --fix` após a instalação para garantir que o ambiente esteja pronto.
+> **Nota sobre `npm install`:** o SINAPSE **não** roda um postinstall automático. Por segurança de cadeia de suprimentos, nada é executado sozinho ao instalar o pacote via `npm install`. O setup — sincronizar agents para o Claude Code, criar os diretórios de runtime (`.sinapse/handoffs/`, `.sinapse/scratchpad/`) e rodar um health check rápido — acontece **explicitamente** quando você roda `npx sinapse-ai install` (ou `npm run setup`). Para pular o setup nessas execuções explícitas (CI, pipelines avançadas), defina `SINAPSE_SKIP_POSTINSTALL=1` — em CI ele já é pulado automaticamente. Depois, `npx sinapse-ai doctor --fix` garante que o ambiente esteja pronto.
 
 ---
 
@@ -193,7 +193,7 @@ Deny rules em `.claude/settings.json` reforçam isso deterministicamente. **O up
 
 ### Constitution
 
-O SINAPSE é governado por uma Constitution formal com 11 artigos e 19 hooks de enforcement:
+O SINAPSE é governado por uma Constitution formal com 11 artigos e 17 hooks de enforcement:
 
 | Artigo | Princípio | Severidade |
 |--------|-----------|------------|
@@ -354,7 +354,7 @@ Se você se identifica com o primeiro grupo, você está no lugar certo.
 
 ### Enforcement Constitucional
 
-O SINAPSE não apenas documenta regras — ele as impõe com **19 hooks ativos**:
+O SINAPSE não apenas documenta regras — ele as impõe com **17 hooks ativos**:
 
 - `enforce-git-push-authority.sh` — bloqueia push por agentes não autorizados
 - `enforce-story-gate.cjs` — bloqueia código sem story validada

package/bin/cli.js

@@ -102,7 +102,7 @@ function runRouter() {
   const isReconfigure = args.includes('--reconfigure');
 
   switch (command) {
-    case 'install':  isLocal ? cmdInstallLocal() : cmdInstallGlobal({ force: isForce, reconfigure: isReconfigure }).catch(e => { logger.error(`${RED}Erro ao instalar:${NC} ${e.message}`); logger.error(`Tente: ${CYAN}npx sinapse-ai doctor${NC}`); process.exit(1); }); break;
+    case 'install':  isLocal ? cmdInstallLocal() : cmdInstallGlobal({ force: isForce, reconfigure: isReconfigure }).catch(e => { const { formatErrorMessage } = require('./utils/install-errors'); logger.error(formatErrorMessage(e)); logger.error(`Tente: ${CYAN}npx sinapse-ai doctor${NC}`); process.exit(1); }); break;
     case 'update':   isLocal ? cmdUpdateLocal()  : cmdUpdateGlobal().catch(e => { logger.error(`${RED}Erro ao atualizar:${NC} ${e.message}`); logger.error(`Tente: ${CYAN}npx sinapse-ai doctor${NC}`); process.exit(1); });  break;
     case 'uninstall': {
       const isYes = args.includes('--yes') || args.includes('-y');