npm - sinapse-ai - Versions diffs - 1.12.0 → 1.12.1 - Mend

sinapse-ai 1.12.0 → 1.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/.sinapse-ai/infrastructure/scripts/validate-agents.js +46 -16
package/.sinapse-ai/install-manifest.yaml +3 -3
package/CHANGELOG.md +37 -30
package/README.md +132 -132
package/package.json +1 -1
package/scripts/validate-no-external-refs.js +2 -2

package/.sinapse-ai/infrastructure/scripts/validate-agents.js CHANGED Viewed

@@ -35,6 +35,18 @@ const DATA_DIR = path.join(ROOT_DIR, 'development', 'data');
 const UTILS_DIR = path.join(ROOT_DIR, 'development', 'utils');
 const WORKFLOWS_DIR = path.join(ROOT_DIR, 'development', 'workflows');
 const SCRIPTS_DIR = path.join(ROOT_DIR, 'development', 'scripts');
+// Additional canonical homes — the framework stores agent artifacts across
+// development/, product/, data/ and infrastructure/, not only development/.
+const KNOWLEDGE_BASE_DIR = path.join(ROOT_DIR, 'development', 'knowledge-base');
+const PRODUCT_TEMPLATES_DIR = path.join(ROOT_DIR, 'product', 'templates');
+const PRODUCT_CHECKLISTS_DIR = path.join(ROOT_DIR, 'product', 'checklists');
+const PRODUCT_DATA_DIR = path.join(ROOT_DIR, 'product', 'data');
+const ROOT_DATA_DIR = path.join(ROOT_DIR, 'data');
+const INFRA_SCRIPTS_DIR = path.join(ROOT_DIR, 'infrastructure', 'scripts');
+const INFRA_SCHEMAS_DIR = path.join(ROOT_DIR, 'infrastructure', 'schemas');
+const SCHEMAS_DIR = path.join(ROOT_DIR, 'schemas');
+const CORE_EXECUTION_DIR = path.join(ROOT_DIR, 'core', 'execution');
+const CORE_MEMORY_DIR = path.join(ROOT_DIR, 'core', 'memory');
 // Commands that are allowed to be shared by multiple agents
 // These are utility/infrastructure commands, not domain-specific
@@ -187,14 +199,18 @@ async function validateDependencies(agents) {
   const errors = [];
   const warnings = [];
+  // Each dependency type resolves against one or more candidate directories —
+  // an artifact is considered present if it exists in ANY of them.
   const depDirs = {
-    tasks: TASKS_DIR,
-    templates: TEMPLATES_DIR,
-    checklists: CHECKLISTS_DIR,
-    data: DATA_DIR,
-    utils: UTILS_DIR,
-    workflows: WORKFLOWS_DIR,
-    scripts: SCRIPTS_DIR,
+    tasks: [TASKS_DIR],
+    templates: [TEMPLATES_DIR, PRODUCT_TEMPLATES_DIR],
+    checklists: [CHECKLISTS_DIR, PRODUCT_CHECKLISTS_DIR],
+    data: [DATA_DIR, ROOT_DATA_DIR, PRODUCT_DATA_DIR],
+    utils: [UTILS_DIR, SCRIPTS_DIR, INFRA_SCRIPTS_DIR, CORE_EXECUTION_DIR, CORE_MEMORY_DIR],
+    workflows: [WORKFLOWS_DIR],
+    scripts: [SCRIPTS_DIR, INFRA_SCRIPTS_DIR, CORE_EXECUTION_DIR, CORE_MEMORY_DIR],
+    knowledge_bases: [KNOWLEDGE_BASE_DIR],
+    schemas: [SCHEMAS_DIR, INFRA_SCHEMAS_DIR],
   };
   // Dependency types that are not file-based (external tools, integrations)
@@ -208,8 +224,8 @@ async function validateDependencies(agents) {
       if (skipDepTypes.has(depType)) continue;
       if (!Array.isArray(depList)) continue;
-      const depDir = depDirs[depType];
-      if (!depDir) {
+      const candidateDirs = depDirs[depType];
+      if (!candidateDirs) {
         warnings.push({
           type: 'UNKNOWN_DEP_TYPE',
           agent: agent.id,
@@ -219,9 +235,23 @@ async function validateDependencies(agents) {
         continue;
       }
-      for (const depFile of depList) {
-        const depPath = path.join(depDir, depFile);
-        const exists = await fileExists(depPath);
+      for (const depFile2 of depList) {
+        // Bare references (no extension) may be listed without their suffix —
+        // try the common framework extensions before declaring them missing.
+        const extCandidates = path.extname(depFile2)
+          ? ['']
+          : ['', '.js', '.cjs', '.md', '.yaml', '.yml'];
+        let exists = false;
+        for (const dir of candidateDirs) {
+          for (const ext of extCandidates) {
+            if (await fileExists(path.join(dir, depFile2 + ext))) {
+              exists = true;
+              break;
+            }
+          }
+          if (exists) break;
+        }
         if (!exists) {
           // Missing dependencies are warnings, not errors (pre-existing technical debt)
@@ -229,10 +259,10 @@ async function validateDependencies(agents) {
             type: 'MISSING_DEPENDENCY',
             agent: agent.id,
             depType,
-            depFile,
-            expectedPath: depPath,
-            message: `Missing dependency: @${agent.id} → ${depType}/${depFile}`,
-            suggestion: `Create the file at ${depPath} or remove from agent dependencies.`,
+            depFile: depFile2,
+            expectedPath: path.join(candidateDirs[0], depFile2),
+            message: `Missing dependency: @${agent.id} → ${depType}/${depFile2}`,
+            suggestion: `Create the file under one of [${candidateDirs.join(', ')}] or remove from agent dependencies.`,
           });
         }
       }

package/.sinapse-ai/install-manifest.yaml CHANGED Viewed

@@ -7,7 +7,7 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 1.12.0
+version: 1.12.1
 generator: scripts/generate-install-manifest.js
 file_count: 1181
 files:
@@ -3684,9 +3684,9 @@ files:
     type: script
     size: 18249
   - path: infrastructure/scripts/validate-agents.js
-    hash: sha256:f2717bb95c65e2ce061c311a44853ae209c1d10034696a38cffd3bc08bd061c6
+    hash: sha256:1fb818950cfa60c572cdc63b5f822ffe9b0a11d351d136f2373bffb24eef99e8
     type: script
-    size: 14910
+    size: 16777
   - path: infrastructure/scripts/validate-claude-integration.js
     hash: sha256:fe5e85f257724ec86178d4ed0a4cc6ce4d98b5b093f707851852ae0d2469abad
     type: script

package/CHANGELOG.md CHANGED Viewed

@@ -1,37 +1,13 @@
-## [1.12.0](https://github.com/caioimori/sinapse-ai/compare/1.11.3...1.12.0) (2026-06-20)
+## [1.12.1](https://github.com/caioimori/sinapse-ai/compare/1.12.0...1.12.1) (2026-06-20)
-### Features
+### Bug Fixes
-* **git-hooks:** protected-files guard recusa deleção/untrack de arquivos críticos [Story feat-protected-files-commit-guard] ([#257](https://github.com/caioimori/sinapse-ai/issues/257)) ([ee50168](https://github.com/caioimori/sinapse-ai/commit/ee501688d945591e0759c0f84963c6d44ff34f0e))
+* **validate-agents:** resolve artefatos em todos os homes canonicos (98→3 warnings) ([#261](https://github.com/caioimori/sinapse-ai/issues/261)) ([e96a955](https://github.com/caioimori/sinapse-ai/commit/e96a9557b25f9f731a59e1441d374bcbd891a775))
-### Bug Fixes
+### Documentation
-* **activation:** resolve alias de agent id pro arquivo canonico (greeting degradado em 6/12) [Story fix-agent-activation-alias-resolution] ([#256](https://github.com/caioimori/sinapse-ai/issues/256)) ([dffae0c](https://github.com/caioimori/sinapse-ai/commit/dffae0c1680b7ded166a44185a02be1fbb3bedcc))
-* **doctor:** git-hooks usa WARN p/ hook system proprio (era FAIL) ([#240](https://github.com/caioimori/sinapse-ai/issues/240)) ([d112326](https://github.com/caioimori/sinapse-ai/commit/d1123269cbbe12d14fbedd116a1d92f9c2a86925))
-* **ide-sync:** resync mirror .claude + conserta YAML do swarm-orqx ([#244](https://github.com/caioimori/sinapse-ai/issues/244)) ([bdc93b6](https://github.com/caioimori/sinapse-ai/commit/bdc93b6118389a979289505d37a8eec9752d51b1))
-* **registry:** dedup robusto de IDs + ressync service-registry stale [Story fix-registry-dedup-stale] ([#251](https://github.com/caioimori/sinapse-ai/issues/251)) ([e53eac3](https://github.com/caioimori/sinapse-ai/commit/e53eac3e70a53efdda9102399c90c68bb0c6b425))
-* **squad-commercial:** religa roteamento do orqx aos 9 especialistas reais ([#238](https://github.com/caioimori/sinapse-ai/issues/238)) ([6469883](https://github.com/caioimori/sinapse-ai/commit/64698839ad08ee0a045f90257a1b2fafbc2a5ade))
-* **squad-council:** enumera as 56 tasks no squad.yaml (eram nao-descobriveis) ([#242](https://github.com/caioimori/sinapse-ai/issues/242)) ([20320fd](https://github.com/caioimori/sinapse-ai/commit/20320fd2b21312f64de7faa91a8f3a6e7c54d988))
-* **squads:** religa 16 especialistas orfaos nos orqx de 5 squads ([#241](https://github.com/caioimori/sinapse-ai/issues/241)) ([ac7283b](https://github.com/caioimori/sinapse-ai/commit/ac7283bc03a672fbb9568918b80734cd50ca62f0))
-* **test:** corrige semantica do coverageThreshold + sobe piso real do core/ [Story test-coverage-threshold-semantics] ([#255](https://github.com/caioimori/sinapse-ai/issues/255)) ([e9f80ee](https://github.com/caioimori/sinapse-ai/commit/e9f80eeb57758fdb3f5c408e6459ba8b89f59407)), closes [#254](https://github.com/caioimori/sinapse-ai/issues/254) [#254](https://github.com/caioimori/sinapse-ai/issues/254)
-### Maintenance
-* **ci:** renomeia workflow 'Test' -> 'Post-Merge Smoke & Build Checks' ([#249](https://github.com/caioimori/sinapse-ai/issues/249)) ([a40b0c7](https://github.com/caioimori/sinapse-ai/commit/a40b0c7ca9355a715424858813c02f416e4e87de))
-* **conformance:** assisted-mode default + rebrand instalador legado + remove residuo ES [Story chore-sinapse-conformance] ([#258](https://github.com/caioimori/sinapse-ai/issues/258)) ([3fb88a3](https://github.com/caioimori/sinapse-ai/commit/3fb88a3712d0e44fa53fdc3e984a8c0cf30d265f))
-* **deps:** bump undici dev (6.27.0/7.28.0) p/ corrigir HIGH dev-only ([#243](https://github.com/caioimori/sinapse-ai/issues/243)) ([9940576](https://github.com/caioimori/sinapse-ai/commit/99405767012b5cd06d942a1ed47148e4b9fd93c0))
-* ignora colaborator/ (pasta local de referencia, fora do git e do npm) ([34bc1bc](https://github.com/caioimori/sinapse-ai/commit/34bc1bc07fa9f44df9c8259ace099f5f5a5aedf0))
-* **lint:** autofix triviais (392->44 warns, 0 errors) + ignora colaborator/ ([#245](https://github.com/caioimori/sinapse-ai/issues/245)) ([70c54ae](https://github.com/caioimori/sinapse-ai/commit/70c54ae01403825724f3987e72ce70978c41b074))
-* **lint:** zera os 33 warnings remanescentes (0 errors, 0 warnings) ([#250](https://github.com/caioimori/sinapse-ai/issues/250)) ([0ac779a](https://github.com/caioimori/sinapse-ai/commit/0ac779a7855166e3ab6cae7b74f163a9f2fa5efc))
-* **packaging:** corta node_modules do tarball + higiene de deps runtime ([#239](https://github.com/caioimori/sinapse-ai/issues/239)) ([d36afb0](https://github.com/caioimori/sinapse-ai/commit/d36afb09da96c946ab9f06743306513ff6aa55ce))
-* **pkg:** expoe API programatica (main/module/types/exports) + index.d.ts honesto ([#253](https://github.com/caioimori/sinapse-ai/issues/253)) ([4971413](https://github.com/caioimori/sinapse-ai/commit/4971413b419fe41000c0fbfffe668eaec39cc013))
-* **test:** deleta 22 testes mortos do tools-system (codigo removido v4.31->v2.1) ([#252](https://github.com/caioimori/sinapse-ai/issues/252)) ([8ed5bd6](https://github.com/caioimori/sinapse-ai/commit/8ed5bd61c150e4c25f04fef70d8d60dc9325aeb1))
-* **test:** exclui colaborator/ do jest (local test passa a espelhar CI) ([#248](https://github.com/caioimori/sinapse-ai/issues/248)) ([3eae775](https://github.com/caioimori/sinapse-ai/commit/3eae775298d2686f679fcadbb80994044d974874)), closes [#245](https://github.com/caioimori/sinapse-ai/issues/245)
-### Refactoring
-* **identity:** SINAPSE canonico — remove dir SNPS/ stale + corrige help ([#246](https://github.com/caioimori/sinapse-ai/issues/246)) ([3a805fa](https://github.com/caioimori/sinapse-ai/commit/3a805fa5366dce9881125521a41e90d6eb4a0e80))
-* **identity:** unifica conteudo do Imperator (snps-orqx desatualizado) ([#247](https://github.com/caioimori/sinapse-ai/issues/247)) ([f52376d](https://github.com/caioimori/sinapse-ai/commit/f52376d040fdfc2c3f3c4f95789249d5cae6f8ef))
+* **changelog:** adiciona entrada da v1.12.0 (hardening + conformidade) ([#259](https://github.com/caioimori/sinapse-ai/issues/259)) ([e679da4](https://github.com/caioimori/sinapse-ai/commit/e679da421d1fa3909791e4d0197f4f4759d12fc3))
+* **readme:** ortografia PT-BR completa + contagem de hooks consistente; chore: genericiza ref interna no guarda de refs externas ([#260](https://github.com/caioimori/sinapse-ai/issues/260)) ([14c6995](https://github.com/caioimori/sinapse-ai/commit/14c69959332ee6161ca49023995b385d96a82882))
 # Changelog
@@ -42,6 +18,37 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
+## [1.12.0] — 2026-06-20 — 🛡️ Hardening + Conformidade
+> Maior release de robustez do framework até aqui: ~1 mês de hardening (auditoria clínica de 8 frentes + conformidade às diretrizes) entregue de uma vez. Sem breaking changes — atualização segura via `npx sinapse-ai update`.
+### Added
+- **Guard anti-deleção de arquivos críticos** no pre-commit — bloqueia commits que removam/untrackeiem arquivos protegidos (ex.: `service-registry.json`). Sempre ativo, independe do modo contribuidor; bypass intencional via `--no-verify`.
+- **API programática** no root `package.json` (`main`/`module`/`types`/`exports`) + `index.d.ts` — o framework pode ser usado como biblioteca, não só CLI.
+### Fixed
+- **Ativação de agents**: 6 dos 12 agents core caíam num greeting degradado por falta de resolução de alias (`dev`→`developer`, `sinapse-orqx`→`snps-orqx`, etc.). Todos ativam 100% agora (papel + status + comandos).
+- **Instalação em Modo Assistido por padrão**: o instalador defaultava silenciosamente para avançado; agora entra assistido (para leigos), com o avançado disponível como toggle opt-in.
+- **Roteamento de squads**: religados ~16 especialistas órfãos em 5 squads, o squad comercial e as 56 tasks do conselho — nenhum agent perdido no roteamento.
+- **Identidade SINAPSE canônica**: Imperator unificado (3 fontes divergentes) + remoção de diretório de comandos stale.
+- **Integridade do registro**: dedup robusto de IDs + ressync do `service-registry` + detector de drift em CI.
+- **`doctor` honesto**: git-hooks reporta WARN (não FAIL) para quem tem hook system próprio.
+- **ide-sync**: resync de mirror `.claude` + conserto de YAML malformado.
+### Changed
+- **Pacote 23MB menor**: `node_modules` removidos do tarball + higiene de dependências de runtime.
+- **Cobertura de testes honesta**: suíte `workflow-intelligence` religada (+204 testes), semântica do `coverageThreshold` corrigida (o `global` do jest exclui chaves de path) e piso real do `core/` (~80%).
+- **Branding**: instalador legado rebrandado para o banner branco "SNPS AI" (sem resquícios off-brand).
+- **Qualidade**: lint 0 erros / 0 warnings; testes mortos do tools-system removidos; `colaborator/` fora do jest.
+- **Escopo**: idiomas apenas **PT + EN** (resíduo de espanhol removido); CLIs apenas **Claude Code + Codex**.
+### Security
+- `undici` (dev) atualizado para corrigir vulnerabilidade HIGH dev-only. **0 vulnerabilidades em produção.**
 ## [1.9.0] — 2026-06-17 — 🧭 Refino Macro (E1–E9) + Paridade Codex
 > **Refino macro do framework em 9 etapas.** Invocação unificada `@sinapse`/`@snps`; remoção dos editores extras (foco Claude + Codex); medidor de tasks honesto; instalação/update reais; fusão `squad-artdir`→`squad-design` + aposentadoria de 7 chiefs (→ 17 squads · 172 agentes · 1200 tasks); feedback visual de orquestração na statusline; trava de git reativada; paridade Codex de fachada para real; pente-fino de segurança.

package/README.md CHANGED Viewed

@@ -13,48 +13,48 @@
 |____/ \___/|_| \_/_/   \_\_|   |____/|_____|
 ```
-> **Squads de IA que constroem com voce, nao para voce.**
+> **Squads de IA que constroem com você, não para você.**
-[**Portugues**] | [English](README.en.md)
+[**Português**] | [English](README.en.md)
 ---
-## O que e o SINAPSE?
+## O que é o SINAPSE?
-SINAPSE e 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 e governado por uma **Constitution com enforcement real** — 13 hooks ativos que bloqueiam violacoes em tempo de execucao.
+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.
-O conceito central e simples: em vez de um unico 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 persuasao e conversao. Cada um com sua propria knowledge base, workflows e tasks — totalizando **1.200 tasks executaveis** prontas para uso, distribuidas pelos 17 squads.
+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.
-Diferente de ferramentas que apenas conversam com IA, o SINAPSE impoe disciplina. O pipeline **Documentation-First** exige que uma story seja criada e validada antes de qualquer linha de codigo. Quality gates rodam automaticamente antes de merge. Agentes nao autorizados sao bloqueados de fazer push. Tudo isso via hooks que interceptam operacoes em tempo real — nao depois.
+Diferente de ferramentas que apenas conversam com IA, o SINAPSE impõe disciplina. O pipeline **Documentation-First** exige que uma story seja criada e validada antes de qualquer linha de código. Quality gates rodam automaticamente antes de merge. Agentes não autorizados são bloqueados de fazer push. Tudo isso via hooks que interceptam operações em tempo real — não depois.
 ---
-## Por que SINAPSE existe?
+## Por que o SINAPSE existe?
-IA generativa tem um problema conhecido: quanto mais voce pede, pior fica. Um unico assistente tentando fazer tudo — codigo, copy, branding, testes, deploy — perde contexto, inventa features e sofre de context amnesia depois de poucas iteracoes longas.
+IA generativa tem um problema conhecido: quanto mais você pede, pior fica. Um único assistente tentando fazer tudo — código, copy, branding, testes, deploy — perde contexto, inventa features e sofre de context amnesia depois de poucas iterações longas.
-SINAPSE resolve isso do jeito que times humanos resolvem: **especializacao coordenada**. Em vez de um generalista cansado, voce tem 172 agentes em 17 squads, cada um com papel definido, knowledge base propria e tasks executaveis. Um orquestrador roteia seu pedido para quem realmente sabe resolver — automaticamente, sem voce precisar decorar agent names ou comandos.
+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 nao e apenas quantidade de agentes. E **governanca real**: 13 hooks ativos interceptam operacoes em tempo de execucao, uma Constitution com 11 artigos rege o framework, e 7 desses artigos sao NON-NEGOTIABLE — violacoes sao bloqueadas antes de executar, nao detectadas depois. **Velocidade com rigor, sem escolher entre os dois.**
+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.**
 ---
 <!-- BEGIN GROUNDING (Story 10.47) -->
-## Grounding semantico (opt-in, foundation pre-GA)
+## Grounding semântico (opt-in, foundation pré-GA)
-Frameworks de agente assumem que o LLM ja sabe o que importa no seu projeto. SINAPSE-AI inverte: oferece **tres canais opcionais** para ancorar o agente no seu contexto real — vault de notas, design system, brandbook. Configuracao zero-overhead agora; injecao semantica completa entra nas proximas releases da linha 1.x.
+Frameworks de agente assumem que o LLM já sabe o que importa no seu projeto. O SINAPSE-AI inverte: oferece **três canais opcionais** para ancorar o agente no seu contexto real — vault de notas, design system, brandbook. Configuração zero-overhead agora; injeção semântica completa entra nas próximas releases da linha 1.x.
-| Canal | Funcao na release atual | Injecao semantica |
+| Canal | Função na release atual | Injeção semântica |
 |-------|------------------------|-------------------|
-| **Vault** | Detecta `~/.claude/sinapse-ai-config.yaml`, valida schema e expoe o path do seu vault aos hooks shipados | Roadmap — proxima minor 1.x |
-| **Design System** | Mesma foundation: detecta DS configurado, expoe path. Quando ausente, agentes seguem defaults de alta qualidade | Roadmap — proxima minor 1.x |
-| **Brand** | Mesma foundation: detecta brandbook, expoe path. Quando ausente, agentes seguem tom neutro | Roadmap — proxima minor 1.x |
+| **Vault** | Detecta `~/.claude/sinapse-ai-config.yaml`, valida schema e expõe o path do seu vault aos hooks shipados | Roadmap — próxima minor 1.x |
+| **Design System** | Mesma foundation: detecta DS configurado, expõe path. Quando ausente, agentes seguem defaults de alta qualidade | Roadmap — próxima minor 1.x |
+| **Brand** | Mesma foundation: detecta brandbook, expõe path. Quando ausente, agentes seguem tom neutro | Roadmap — próxima minor 1.x |
-**Por que configurar agora:** os 3 hooks ja sao shipados zero-overhead — sem config, `no-op` completo, zero ruido. Voce define os paths uma vez via `npx sinapse-ai install`, e quando a injecao semantica entrar, ativa automaticamente. Nada de reconfigurar, nada de migrar.
+**Por que configurar agora:** os 3 hooks já são shipados zero-overhead — sem config, `no-op` completo, zero ruído. Você define os paths uma vez via `npx sinapse-ai install`, e quando a injeção semântica entrar, ativa automaticamente. Nada de reconfigurar, nada de migrar.
-**Por que isso e diferencial:** outros frameworks de agente acoplam grounding ao runtime do framework (te forcam a entrar no ecossistema deles). SINAPSE-AI mantem grounding como **camada opt-in declarativa** — voce escolhe quando e o que ativar, em arquivo proprio, sem lock-in.
+**Por que isso é diferencial:** outros frameworks de agente acoplam o grounding ao runtime do framework (te forçam a entrar no ecossistema deles). O SINAPSE-AI mantém o grounding como **camada opt-in declarativa** — você escolhe quando e o que ativar, em arquivo próprio, sem lock-in.
-Configuracao detalhada: [`docs/guides/grounding-setup.md`](docs/guides/grounding-setup.md).
+Configuração detalhada: [`docs/guides/grounding-setup.md`](docs/guides/grounding-setup.md).
 <!-- END GROUNDING (Story 10.47) -->
 ---
@@ -67,7 +67,7 @@ Configuracao detalhada: [`docs/guides/grounding-setup.md`](docs/guides/grounding
 npx sinapse-ai install
 ```
-O wizard detecta seu ambiente, escolhe a IDE (Claude Code ou Codex), e instala os 17 squads automaticamente. Re-rodar o comando faz upsert idempotente — preserva suas customizacoes e so atualiza o que mudou.
+O wizard detecta seu ambiente, escolhe a IDE (Claude Code ou Codex) e instala os 17 squads automaticamente. Re-rodar o comando faz upsert idempotente — preserva suas customizações e só atualiza o que mudou.
 ### 2. Verifique
@@ -82,76 +82,76 @@ Se algo estiver fora do lugar, `doctor --fix` corrige automaticamente.
 ```
 @developer          # Ativa o agente de desenvolvimento
-*help               # Lista comandos disponiveis
+*help               # Lista comandos disponíveis
 ```
-Pronto. Voce tem 17 squads operando no seu terminal.
+Pronto. Você tem 17 squads operando no seu terminal.
-> **Nota sobre `npm install`:** A partir da v10.0.0-rc.4, o SINAPSE roda um postinstall automatico que sincroniza agents para o Claude Code, cria os diretorios de runtime (`.sinapse/handoffs/`, `.sinapse/scratchpad/`) e executa um health check rapido. Para desabilitar (CI, pipelines avancadas), defina `SINAPSE_SKIP_POSTINSTALL=1` antes do `npm install`, ou rode `npm install --ignore-scripts` (comportamento nativo do npm — nenhum postinstall eh executado). Nesse caso, rode `sinapse doctor --fix` apos a instalacao para garantir que o ambiente esteja pronto.
+> **Nota sobre `npm install`:** A partir da v10.0.0-rc.4, 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.
 ---
 ## Por que instalar em cada projeto?
-Toda primeira instalacao levanta objecoes. Todas legitimas. Respondidas aqui, no espirito da cultura SINAPSE — direto, sem defensivo.
+Toda primeira instalação levanta objeções. Todas legítimas. Respondidas aqui, no espírito da cultura SINAPSE — direto, sem defensivo.
-### "Vou ter multiplas copias no computador. Nao e desperdicio?"
+### "Vou ter múltiplas cópias no computador. Não é desperdício?"
-Nao. Cada projeto tem seu proprio `.sinapse-ai/` — assim como tem seu proprio `package.json` ou `node_modules/`. E isso **nao e desperdicio, e isolamento**.
+Não. Cada projeto tem seu próprio `.sinapse-ai/` — assim como tem seu próprio `package.json` ou `node_modules/`. E isso **não é desperdício, é isolamento**.
-Tamanho real: `.sinapse-ai/` pesa ~500KB. Vinte projetos = 10MB. Menor que um unico `node_modules/` de um projeto Next.js tipico (300MB+). O custo de espaco e marginal. O ganho de isolamento e essencial.
+Tamanho real: `.sinapse-ai/` pesa ~500KB. Vinte projetos = 10MB. Menor que um único `node_modules/` de um projeto Next.js típico (300MB+). O custo de espaço é marginal. O ganho de isolamento é essencial.
-### "Por que nao instalar uma vez global e pronto?"
+### "Por que não instalar uma vez global e pronto?"
-Porque projetos open source precisam ser **auto-contidos**. Quando voce compartilha um projeto (ou alguem clona o seu), o framework precisa viajar junto.
+Porque projetos open source precisam ser **autocontidos**. Quando você compartilha um projeto (ou alguém clona o seu), o framework precisa viajar junto.
-**Com instalacao local:** `git clone` e pronto. Framework, rules, agentes, Constitution, contexto — tudo ja vem no projeto. Qualquer pessoa, qualquer maquina, qualquer horario: funciona igual.
+**Com instalação local:** `git clone` e pronto. Framework, rules, agentes, Constitution, contexto — tudo já vem no projeto. Qualquer pessoa, qualquer máquina, qualquer horário: funciona igual.
-**Com instalacao global:** quem clona o projeto precisa instalar SINAPSE separado, garantir a mesma versao, copiar rules manualmente, torcer pra nao ter drift entre maquinas. Open source morre assim.
+**Com instalação global:** quem clona o projeto precisa instalar o SINAPSE separado, garantir a mesma versão, copiar rules manualmente, torcer pra não ter drift entre máquinas. Open source morre assim.
-### "Qual a diferenca real entre global e local?"
+### "Qual a diferença real entre global e local?"
 | Aspecto | Global | Local (recomendado) |
 |---------|:------:|:-------------------:|
-| Espaco em disco | Menor (1 copia) | Maior (~500KB/projeto) |
-| Versionamento per-project | Nao | Sim |
-| Clone e funcionando | Nao | Sim |
-| Rules customizadas por projeto | Nao | Sim |
-| Colaboracao em time | Quebrada | Perfeita |
-| Atualizar sem quebrar outros projetos | Nao | Sim |
-| Open source compativel | Nao | Sim |
+| Espaço em disco | Menor (1 cópia) | Maior (~500KB/projeto) |
+| Versionamento per-project | Não | Sim |
+| Clone e funcionando | Não | Sim |
+| Rules customizadas por projeto | Não | Sim |
+| Colaboração em time | Quebrada | Perfeita |
+| Atualizar sem quebrar outros projetos | Não | Sim |
+| Open source compatível | Não | Sim |
 ### "Funciona no Windows?"
-Sim. Testado em Windows 11, macOS e Linux. O instalador detecta o OS automaticamente. WSL nao e obrigatorio (mas recomendado para algumas features avancadas como review automatizado via CodeRabbit).
+Sim. Testado em Windows 11, macOS e Linux. O instalador detecta o OS automaticamente. WSL não é obrigatório (mas recomendado para algumas features avançadas como review automatizado via CodeRabbit).
 ### Matriz de plataformas suportadas
-Cada release passa por uma matriz de instalacao de 27 combinacoes (3 OSes x 3 package managers x 3 metodos) executada em CI. A tabela abaixo resume os caminhos oficialmente suportados:
+Cada release passa por uma matriz de instalação de 27 combinações (3 OSes × 3 package managers × 3 métodos) executada em CI. A tabela abaixo resume os caminhos oficialmente suportados:
 | OS | npm | pnpm | Yarn v2+ (Berry) | Yarn v1 (Classic) |
 |----|:---:|:----:|:----------------:|:-----------------:|
-| Windows 11 | Sim | Sim | Sim | **Nao** |
+| Windows 11 | Sim | Sim | Sim | **Não** |
 | macOS (latest) | Sim | Sim | Sim | Sim |
 | Linux (Ubuntu 22.04) | Sim | Sim | Sim | Sim |
-**Sobre Yarn v1 no Windows:** Yarn v1 (Classic) esta em modo manutencao desde 2020, com Yarn v2+ (Berry) como sucessor oficial. A combinacao Windows + Yarn v1 apresenta falhas de resolucao de wrapper que nao compensam investigar por ser ecossistema em declinio. Usuarios Windows em Yarn v1 devem migrar para Yarn v2+ (recomendado) ou usar npm/pnpm. macOS e Linux em Yarn v1 continuam suportados.
+**Sobre Yarn v1 no Windows:** Yarn v1 (Classic) está em modo manutenção desde 2020, com Yarn v2+ (Berry) como sucessor oficial. A combinação Windows + Yarn v1 apresenta falhas de resolução de wrapper que não compensam investigar por ser ecossistema em declínio. Usuários Windows em Yarn v1 devem migrar para Yarn v2+ (recomendado) ou usar npm/pnpm. macOS e Linux em Yarn v1 continuam suportados.
-### "Como atualizar sem perder minhas customizacoes?"
+### "Como atualizar sem perder minhas customizações?"
 ```bash
 npx sinapse-ai update
 ```
-O update e **idempotente por design**. L1 (framework core) e L2 (templates) sao atualizados. L3 (configuracao) e L4 (suas stories, packages, customizacoes) **nunca sao tocados**. Voce pode rodar `update` quantas vezes quiser, inclusive apos customizar rules localmente. Nada se perde.
+O update é **idempotente por design**. L1 (framework core) e L2 (templates) são atualizados. L3 (configuração) e L4 (suas stories, packages, customizações) **nunca são tocados**. Você pode rodar `update` quantas vezes quiser, inclusive após customizar rules localmente. Nada se perde.
 ### TL;DR
-Instalacao local = um pouco mais de disco, muito mais robustez.
+Instalação local = um pouco mais de disco, muito mais robustez.
-Se voce trabalha sozinho e nunca compartilha projetos, global ate funciona — mas assim que voce entra em time, publica open source ou precisa de multiplas versoes em paralelo, local vira imprescindivel.
+Se você trabalha sozinho e nunca compartilha projetos, global até funciona — mas assim que você entra em time, publica open source ou precisa de múltiplas versões em paralelo, local vira imprescindível.
-O SINAPSE otimiza para o caso generico: **seu projeto deve funcionar para qualquer pessoa que clone ele, em qualquer maquina, a qualquer hora**.
+O SINAPSE otimiza para o caso genérico: **seu projeto deve funcionar para qualquer pessoa que clone ele, em qualquer máquina, a qualquer hora**.
 ---
@@ -163,32 +163,32 @@ O SINAPSE otimiza para o caso generico: **seu projeto deve funcionar para qualqu
 CLI First  >  Observability Second  >  UI Third
 ```
-Toda inteligencia vive no terminal. Dashboards observam. A UI nunca e requisito para operar o sistema. Esse e o Artigo I da Constitution — inegociavel.
+Toda inteligência vive no terminal. Dashboards observam. A UI nunca é requisito para operar o sistema. Esse é o Artigo I da Constitution — inegociável.
 ### Modelo de 4 Camadas
-O SINAPSE separa artefatos do framework e do projeto em 4 camadas com protecao automatica:
+O SINAPSE separa artefatos do framework e do projeto em 4 camadas com proteção automática:
 ```mermaid
 graph TB
-    subgraph L4["L4 - PROJETO (sempre mutavel)"]
+    subgraph L4["L4 - PROJETO (sempre mutável)"]
         L4A[Stories]
         L4B[Packages]
         L4C[Squads]
         L4D[Tests]
     end
-    subgraph L3["L3 - CONFIGURACAO (com restricoes)"]
+    subgraph L3["L3 - CONFIGURACAO (com restrições)"]
         L3A[Entity Registry]
         L3B[Agent Memory]
         L3C[Config files]
     end
-    subgraph L2["L2 - TEMPLATES (imutavel)"]
+    subgraph L2["L2 - TEMPLATES (imutável)"]
         L2A[Tasks]
         L2B[Templates]
         L2C[Checklists]
         L2D[Workflows]
     end
-    subgraph L1["L1 - FRAMEWORK CORE (imutavel)"]
+    subgraph L1["L1 - FRAMEWORK CORE (imutável)"]
         L1A[.sinapse-ai/core]
         L1B[bin/]
         L1C[Constitution]
@@ -202,20 +202,20 @@ graph TB
     style L4 fill:#1e293b,stroke:#10b981,color:#fff
 ```
-| Camada | Mutabilidade | Conteudo |
+| Camada | Mutabilidade | Conteúdo |
 |--------|-------------|----------|
 | **L1** Framework Core | Nunca | `.sinapse-ai/core/`, `bin/`, Constitution |
 | **L2** Templates | Nunca | Tasks, templates, checklists, workflows |
-| **L3** Configuracao | Com restricoes | Entity registry, agent memory, config |
+| **L3** Configuração | Com restrições | Entity registry, agent memory, config |
 | **L4** Projeto | Sempre | Stories, packages, squads, testes |
-Deny rules em `.claude/settings.json` reforcam isso deterministicamente. **Update do framework atualiza L1+L2, nunca L3+L4** — suas customizacoes sao preservadas.
+Deny rules em `.claude/settings.json` reforçam isso deterministicamente. **O update do framework atualiza L1+L2, nunca L3+L4** — suas customizações são preservadas.
 ### Constitution
-O SINAPSE e governado por uma Constitution formal com 11 artigos e 13 hooks de enforcement:
+O SINAPSE é governado por uma Constitution formal com 11 artigos e 19 hooks de enforcement:
-| Artigo | Principio | Severidade |
+| Artigo | Princípio | Severidade |
 |--------|-----------|------------|
 | I | CLI First | NON-NEGOTIABLE |
 | II | Agent Authority | NON-NEGOTIABLE |
@@ -229,7 +229,7 @@ O SINAPSE e governado por uma Constitution formal com 11 artigos e 13 hooks de e
 | X | Security & Data Protection | NON-NEGOTIABLE |
 | XI | Conservative Default | MUST |
-7 artigos sao NON-NEGOTIABLE — violacoes sao bloqueadas automaticamente antes de executar.
+7 artigos são NON-NEGOTIABLE — violações são bloqueadas automaticamente antes de executar.
 ---
@@ -239,18 +239,18 @@ O SINAPSE inclui 12 agentes core que cobrem o ciclo completo de desenvolvimento:
 | Agente | Persona | Papel |
 |--------|---------|-------|
-| `sinapse-orqx` | **Imperator** | Orquestrador principal — routing e coordenacao cross-squad |
-| `developer` | **Pixel** | Implementacao de codigo e story development |
+| `sinapse-orqx` | **Imperator** | Orquestrador principal — routing e coordenação cross-squad |
+| `developer` | **Pixel** | Implementação de código e story development |
 | `quality-gate` | **Litmus** | Testes, QA e quality gates |
-| `architect` | **Stratum** | Arquitetura e decisoes de tecnologia |
+| `architect` | **Stratum** | Arquitetura e decisões de tecnologia |
 | `project-lead` | **Beacon** | Product management e epics |
-| `product-lead` | **Axis** | Validacao de stories e priorizacao |
-| `sprint-lead` | **Sync** | Criacao de stories e sprints |
-| `analyst` | **Scope** | Pesquisa e analise de negocios |
+| `product-lead` | **Axis** | Validação de stories e priorização |
+| `sprint-lead` | **Sync** | Criação de stories e sprints |
+| `analyst` | **Scope** | Pesquisa e análise de negócios |
 | `data-engineer` | **Tensor** | Database design, migrations e RLS |
 | `ux-design-expert` | **Mosaic** | UX/UI design |
 | `devops` | **Pipeline** | CI/CD, git push (exclusivo), releases |
-| `squad-creator` | **Loom** | Criacao de novos squads |
+| `squad-creator` | **Loom** | Criação de novos squads |
 Ative qualquer agente com `@agent-name` e use `*help` para ver seus comandos.
@@ -274,37 +274,37 @@ flowchart LR
     style F fill:#1e293b,stroke:#ef4444,color:#fff
 ```
-O framework garante que nenhuma etapa seja pulada. Cada gate bloqueia automaticamente se a anterior nao foi cumprida.
+O framework garante que nenhuma etapa seja pulada. Cada gate bloqueia automaticamente se a anterior não foi cumprida.
 ---
 ## 17 Squads Especializados
-Cada squad e uma equipe autonoma com orquestrador, agentes especialistas, knowledge base, tasks e workflows proprios.
+Cada squad é uma equipe autônoma com orquestrador, agentes especialistas, knowledge base, tasks e workflows próprios.
-| Squad | Dominio | Agentes |
+| Squad | Domínio | Agentes |
 |-------|---------|---------|
-| **squad-brand** | Estrategia de marca, arquetipos, auditoria visual | 15 |
+| **squad-brand** | Estratégia de marca, arquétipos, auditoria visual | 15 |
 | **squad-design** | Design systems, componentes, tokens, UI, art direction, LP premium | 14 |
-| **squad-copy** | Copywriting persuasivo, headlines, conversao | 13 |
-| **squad-council** | Advisors estrategicos (Munger, Dalio, Thiel, ...) | 11 |
-| **squad-storytelling** | Narrativa, roteiros, frameworks de historia | 10 |
+| **squad-copy** | Copywriting persuasivo, headlines, conversão | 13 |
+| **squad-council** | Advisors estratégicos (Munger, Dalio, Thiel, ...) | 11 |
+| **squad-storytelling** | Narrativa, roteiros, frameworks de história | 10 |
 | **squad-commercial** | Vendas, funil, revenue, pipeline comercial | 10 |
-| **squad-paidmedia** | Meta Ads, Google Ads, campanhas, otimizacao | 9 |
-| **squad-animations** | Motion design, CSS, particulas, 3D | 9 |
+| **squad-paidmedia** | Meta Ads, Google Ads, campanhas, otimização | 9 |
+| **squad-animations** | Motion design, CSS, partículas, 3D | 9 |
 | **squad-cloning** | Clonagem cognitiva, mind synthesis, digital twins | 9 |
 | **squad-cybersecurity** | Threat intel, pentest, compliance, LGPD | 8 |
-| **squad-courses** | Cursos, curriculos, assessments, launch educacional | 8 |
-| **squad-research** | Market analysis, inteligencia competitiva | 7 |
-| **claude-code-mastery** | Claude Code avancado, MCP, integracao profunda | 8 |
-| **squad-content** | Governanca editorial, estrategia de conteudo | 7 |
-| **squad-product** | Product discovery, estrategia, operacoes | 7 |
+| **squad-courses** | Cursos, currículos, assessments, launch educacional | 8 |
+| **squad-research** | Market analysis, inteligência competitiva | 7 |
+| **claude-code-mastery** | Claude Code avançado, MCP, integração profunda | 8 |
+| **squad-content** | Governança editorial, estratégia de conteúdo | 7 |
+| **squad-product** | Product discovery, estratégia, operações | 7 |
 | **squad-growth** | Analytics, CRO, SEO, growth hacking | 7 |
 | **squad-finance** | Budget, pricing, profitability analysis | 8 |
 **Total: 17 squads, 172 agentes especializados, 1.200 tasks**
-Cada squad e ativado via seu orquestrador:
+Cada squad é ativado via seu orquestrador:
 ```
 @brand-orqx         # Squad de brand
@@ -319,75 +319,75 @@ O orquestrador recebe seu pedido e delega automaticamente ao especialista corret
 ## IDE Support
-O SINAPSE suporta duas IDEs com integracoes profundas:
+O SINAPSE suporta duas IDEs com integrações profundas:
-| IDE | Ativacao | Destaques |
+| IDE | Ativação | Destaques |
 |-----|----------|-----------|
 | **Claude Code** | `@agent-name` | Hooks, rules contextuais, deny/allow, Chrome Brain |
 | **Codex CLI** | `/skills` ou `$skill-name` | Skills nativas, multi-model, `codex exec` para CI/CD |
-Ambas as IDEs tem acesso a todos os 17 squads, 172 agentes, workflows e knowledge bases. O installer detecta e configura automaticamente.
+Ambas as IDEs têm acesso a todos os 17 squads, 172 agentes, workflows e knowledge bases. O installer detecta e configura automaticamente.
 ### Tabela de Paridade
 | Funcionalidade | Claude Code | Codex CLI |
 |---------------|:-----------:|:---------:|
-| Ativacao de agentes (@agent) | Completo | Completo |
+| Ativação de agentes (@agent) | Completo | Completo |
 | Hooks constitucionais (19) | Completo | Parcial (5) |
 | Story-driven development | Completo | Completo |
 | Quality gates | Completo | Completo |
-| Enforcement de delegacao | Completo | Parcial |
+| Enforcement de delegação | Completo | Parcial |
 | Secret scanning | Completo | Manual |
-| Integracao CodeRabbit | Completo | N/A |
+| Integração CodeRabbit | Completo | N/A |
 | Sistema de skills | Completo | Comandos |
 | MCP servers | Completo | N/A |
 | Terminal Bus | Completo | N/A |
-**Claude Code** para a experiencia mais integrada e automatizada.
-**Codex CLI** para flexibilidade de modelo e automacao CI/CD.
+**Claude Code** para a experiência mais integrada e automatizada.
+**Codex CLI** para flexibilidade de modelo e automação CI/CD.
 ---
-## Para quem e o SINAPSE?
+## Para quem é o SINAPSE?
-O SINAPSE nao e para todo mundo. Ele e opinativo, rigoroso e exige disciplina. Mas para quem precisa de velocidade **com rigor**, ele transforma IA generativa de brinquedo em infraestrutura real.
+O SINAPSE não é para todo mundo. Ele é opinativo, rigoroso e exige disciplina. Mas para quem precisa de velocidade **com rigor**, ele transforma IA generativa de brinquedo em infraestrutura real.
 ### Ideal para
-- **Founders tecnicos** que constroem SaaS sozinho ou em times pequenos e precisam operar como um time grande
-- **Consultores e agencias** que entregam projetos completos (brand + copy + dev + deploy) e precisam de qualidade consistente entre clientes
-- **Teams de produto** que querem eliminar inconsistencia entre requisitos, design, implementacao e QA
+- **Founders técnicos** que constroem SaaS sozinho ou em times pequenos e precisam operar como um time grande
+- **Consultores e agências** que entregam projetos completos (brand + copy + dev + deploy) e precisam de qualidade consistente entre clientes
+- **Teams de produto** que querem eliminar inconsistência entre requisitos, design, implementação e QA
 - **Educadores** que ensinam IA aplicada e precisam de um framework real para demonstrar em aula
-- **Builders independentes** que tratam IA como infraestrutura, nao como brinquedo
+- **Builders independentes** que tratam IA como infraestrutura, não como brinquedo
-### Nao e para
+### Não é para
 - Projetos one-shot sem continuidade ou disciplina processual
-- Equipes que preferem flexibilidade total sobre governanca
-- Usuarios que esperam "IA magica" sem metodologia
+- Equipes que preferem flexibilidade total sobre governança
+- Usuários que esperam "IA mágica" sem metodologia
-Se voce se identifica com o primeiro grupo, voce esta no lugar certo.
+Se você se identifica com o primeiro grupo, você está no lugar certo.
 ---
-## Qualidade e Seguranca
+## Qualidade e Segurança
 ### Enforcement Constitucional
-O SINAPSE nao apenas documenta regras — ele as impoe com **13 hooks ativos**:
+O SINAPSE não apenas documenta regras — ele as impõe com **19 hooks ativos**:
-- `enforce-git-push-authority.sh` — bloqueia push por agentes nao autorizados
-- `enforce-story-gate.cjs` — bloqueia codigo sem story validada
+- `enforce-git-push-authority.sh` — bloqueia push por agentes não autorizados
+- `enforce-story-gate.cjs` — bloqueia código sem story validada
 - `sql-governance.py` — bloqueia SQL perigoso (injection patterns)
-- `enforce-delegation.cjs` — bloqueia orquestradores executando trabalho de dominio
-- `enforce-architecture-first.cjs` — bloqueia codigo em paths protegidos sem documentacao
+- `enforce-delegation.cjs` — bloqueia orquestradores executando trabalho de domínio
+- `enforce-architecture-first.cjs` — bloqueia código em paths protegidos sem documentação
 ### 25 Deployment Blockers (3 Tiers)
-Nenhum projeto vai para producao sem passar por todos:
+Nenhum projeto vai para produção sem passar por todos:
 - **Tier 1** — 10 blockers absolutos: RLS, zero hardcoded keys, service_role protegido, MFA, APIs autenticadas, SQL parametrizado
-- **Tier 2** — 7 blockers de compliance: DPO, consentimento, direitos do titular, notificacao de breach (LGPD)
+- **Tier 2** — 7 blockers de compliance: DPO, consentimento, direitos do titular, notificação de breach (LGPD)
 - **Tier 3** — 8 blockers operacionais: logging, backup, vulnerability scanning, incident response
 ### Quality Gates
@@ -399,11 +399,11 @@ npm test               # Testes
 npm run test:coverage  # Cobertura
 ```
-Pre-commit e pre-push hooks validam automaticamente antes de cada operacao.
+Pre-commit e pre-push hooks validam automaticamente antes de cada operação.
 ---
-## Documentacao
+## Documentação
 | Recurso | Link |
 |---------|------|
@@ -412,36 +412,36 @@ Pre-commit e pre-push hooks validam automaticamente antes de cada operacao.
 | Erros do CLI (troubleshooting) | [docs/guides/cli-errors.md](docs/guides/cli-errors.md) |
 | Arquitetura | [docs/framework/core-architecture.md](docs/framework/core-architecture.md) |
 | Guia de Squads | [docs/guides/squads-guide.md](docs/guides/squads-guide.md) |
-| Referencia de Agentes | [docs/guides/agent-reference.md](docs/guides/agent-reference.md) |
+| Referência de Agentes | [docs/guides/agent-reference.md](docs/guides/agent-reference.md) |
 | Workflows | [docs/guides/workflows-guide.md](docs/guides/workflows-guide.md) |
-| Seguranca | [SECURITY.md](SECURITY.md) |
-| Contribuicao | [CONTRIBUTING.md](CONTRIBUTING.md) |
+| Segurança | [SECURITY.md](SECURITY.md) |
+| Contribuição | [CONTRIBUTING.md](CONTRIBUTING.md) |
 ---
 ## CLI Reference
-A superficie publica e proposital — quatro comandos canonicos de lifecycle, dois diagnosticos, um sub-comando avancado.
+A superfície pública é proposital — quatro comandos canônicos de lifecycle, dois diagnósticos, um sub-comando avançado.
 ```bash
 # Lifecycle
-npx sinapse-ai install           # Instala (idempotente — re-runs sao upserts)
+npx sinapse-ai install           # Instala (idempotente — re-runs são upserts)
 npx sinapse-ai install --force   # Reinstala do zero, ignorando estado existente
-npx sinapse-ai update            # Atualiza para a versao mais recente
+npx sinapse-ai update            # Atualiza para a versão mais recente
 npx sinapse-ai uninstall         # Remove o framework do projeto
-# Diagnostico
-npx sinapse-ai status            # Estado da instalacao + lista de squads
+# Diagnóstico
+npx sinapse-ai status            # Estado da instalação + lista de squads
 npx sinapse-ai doctor            # 12 health checks contra o ambiente
 npx sinapse-ai doctor --fix      # Auto-corrige problemas detectados
-npx sinapse-ai doctor --json     # Saida machine-readable para CI
+npx sinapse-ai doctor --json     # Saída machine-readable para CI
 npx sinapse-ai doctor --dry-run  # Mostra o que `--fix` faria sem aplicar
-# Avancado
+# Avançado
 npx sinapse-ai chrome-brain install   # Instala browser automation
 ```
-Todos os comandos sao seguros para re-rodar. Para listar agentes ativos depois de instalar, abra Claude Code ou Codex CLI e digite `@` para autocompletar.
+Todos os comandos são seguros para re-rodar. Para listar agentes ativos depois de instalar, abra o Claude Code ou o Codex CLI e digite `@` para autocompletar.
 ---
@@ -452,9 +452,9 @@ git clone https://github.com/caioimori/sinapse-ai.git
 cd sinapse-ai && npm install
 ```
-1. Fork o repositorio
+1. Faça um fork do repositório
 2. Crie sua branch (`git checkout -b feat/minha-feature`)
-3. Commit (`git commit -m 'feat: descricao'`)
+3. Commit (`git commit -m 'feat: descrição'`)
 4. Push (`git push origin feat/minha-feature`)
 5. Abra um Pull Request
@@ -466,10 +466,10 @@ Veja [CONTRIBUTING.md](CONTRIBUTING.md) para detalhes completos.
 | Documento | Link |
 |-----------|------|
-| Licenca | [MIT](LICENSE) |
-| Seguranca | [SECURITY.md](SECURITY.md) |
-| Codigo de Conduta | [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) |
-| Contribuicao | [CONTRIBUTING.md](CONTRIBUTING.md) |
+| Licença | [MIT](LICENSE) |
+| Segurança | [SECURITY.md](SECURITY.md) |
+| Código de Conduta | [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) |
+| Contribuição | [CONTRIBUTING.md](CONTRIBUTING.md) |
 ---
@@ -480,18 +480,18 @@ Veja [CONTRIBUTING.md](CONTRIBUTING.md) para detalhes completos.
 ---
-## Pronto para comecar?
+## Pronto para começar?
 ```bash
 npx sinapse-ai install
 ```
-Um comando. 17 squads. 172 agentes. Governanca constitucional. Tudo operando direto no terminal.
+Um comando. 17 squads. 172 agentes. Governança constitucional. Tudo operando direto no terminal.
-**[Documentacao completa](docs/guides/getting-started.md)** • **[Reportar issue](https://github.com/caioimori/sinapse-ai/issues)** • **[Discussions](https://github.com/caioimori/sinapse-ai/discussions)**
+**[Documentação completa](docs/guides/getting-started.md)** • **[Reportar issue](https://github.com/caioimori/sinapse-ai/issues)** • **[Discussions](https://github.com/caioimori/sinapse-ai/discussions)**
 ---
-**Construido para quem constroi. Governado por uma Constitution. Operando 100% no terminal.**
+**Construído para quem constrói. Governado por uma Constitution. Operando 100% no terminal.**
-**[Voltar ao topo](#sinapse-ai)**
+**[Voltar ao topo](#o-que-é-o-sinapse)**

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "sinapse-ai",
-  "version": "1.12.0",
+  "version": "1.12.1",
   "description": "SINAPSE AI: Framework de orquestracao de IA — 17 squads, 172 agentes especializados",
   "bin": {
     "sinapse": "bin/sinapse.js",

package/scripts/validate-no-external-refs.js CHANGED Viewed

@@ -13,8 +13,8 @@
  * the MIT `LICENSE` file (legal attribution requirement), the historical
  * process document `docs/research-synthesis-for-upgrade.md`, and a small set
  * of pre-existing upstream-attribution files inherited from the BMAD fork
- * lineage (flagged for future per-file review — see follow-up backlog in
- * `.sinapse-ai/internal/aiox-feature-map.md`).
+ * lineage (flagged for future per-file review — see the internal
+ * upstream-attribution follow-up backlog).
  *
  * === Source of truth: `git ls-files` (QA v1.1 fix) ===
  *