sinapse-ai 9.3.0 → 9.5.0

package/docs/ide-integration.md

@@ -0,0 +1,36 @@
+# IDE Integration — Compatibility Matrix
+
+## Supported IDEs
+
+| IDE | Status | Instructions File | Delegation | Skills |
+|-----|--------|------------------|------------|--------|
+| Claude Code | Works | `.claude/CLAUDE.md` | `.claude/rules/mandatory-delegation.md` | `.claude/commands/` |
+| Codex CLI | Limited | `.codex/instructions.md` | `.codex/delegation-matrix.json` | `.codex/skills/` |
+
+## Parity Requirements
+
+### Claude Code
+- CLAUDE.md with full agent activation rules
+- Rules in `.claude/rules/` for governance
+- Hooks in `.claude/hooks/` for enforcement
+- Skills in `.claude/commands/` for slash commands
+
+### Codex
+- instructions.md with agent activation rules
+- Delegation matrix in `.codex/delegation-matrix.json`
+- Delegation parity in `.codex/delegation-parity.json`
+- Skills in `.codex/skills/`
+- Agents in `.codex/agents/`
+
+## Cross-IDE Contracts
+
+Both IDEs must maintain:
+1. Same agent roster (19 orchestrators + framework agents)
+2. Same delegation routes
+3. Same skill coverage
+4. Handoff packet schema compatibility
+
+## Release Contract
+
+Current release: 9.3.0
+Contract path: `.sinapse-ai/infrastructure/compatibility-contract.yaml`

package/docs/installation/chrome-brain.md

@@ -5,13 +5,23 @@ Chrome Brain is a **cross-squad capability** that gives ALL SINAPSE agents the p
 ## Quick Install
 
 ```bash
-# Option 1: Via SINAPSE CLI (recommended)
-sinapse chrome-brain install
-
-# Option 2: Via npx
 npx sinapse-ai chrome-brain install
+```
+
+That is the only command you need. Chrome Brain is a sub-capability of the
+canonical installer, so it follows the same rule as every other SINAPSE
+install/update/uninstall path: `npx sinapse-ai <cmd>` is the single public
+entry point.
 
-# Option 3: Standalone script (macOS/Linux)
+### Internal (developer-only)
+
+> The snippets in this section are for framework contributors working inside
+> the repository clone. They are NOT instructions for end users — the
+> `npx sinapse-ai chrome-brain install` command above invokes the same script
+> under the hood.
+
+```bash
+# Run the installer script directly from a repo checkout
 chmod +x scripts/install-chrome-brain.sh
 ./scripts/install-chrome-brain.sh
 ```
@@ -44,13 +54,13 @@ chmod +x scripts/install-chrome-brain.sh
 ## Verify Installation
 
 ```bash
-sinapse chrome-brain status
+npx sinapse-ai chrome-brain status
 ```
 
 ## Uninstall
 
 ```bash
-sinapse chrome-brain uninstall
+npx sinapse-ai chrome-brain uninstall
 ```
 
 ## Supported Platforms

package/docs/mega-upgrade-orchestration-plan.md

@@ -0,0 +1,71 @@
+# SINAPSE Mega-Upgrade — Plano de Orquestracao Final
+
+> **Data:** 2026-04-11
+> **Objetivo:** Upgrade definitivo — zero brechas, zero pontas soltas
+> **Modo:** YOLO + NSN
+> **Baseline:** v9.4.0 (PR #28 + #30 merged, PR #31 open)
+
+---
+
+## Estado Atual vs Target
+
+| Area | Atual | Target | Gap |
+|------|-------|--------|-----|
+| Rules | 19 (9 com paths) | 19 (todas com paths ou always-load justificado) | 0 |
+| Agents | 12 (5 enriched) | 12 (todos enriched + anti-hallucination) | 1 falta (data-engineer hallucination) |
+| Tasks | 207 | 211+ (4 novas infra) | DONE (PR #30) |
+| Skills | 5 | 10+ | 5 novas necessarias |
+| Checklists | 8 | 10+ | 2 novas |
+| Workflows | 15 + 1 (fast-track) | 16 | DONE |
+| KBs (framework) | 6 | 8+ | DONE |
+| KBs (squads) | 11 master refs | 11 | DONE |
+| Hooks | 19 + 1 (verify-packages) | 20 | DONE |
+| Templates | 40 + 3 (legal) | 43 | DONE |
+| AGENTS.md | 159 lines | 159 | DONE |
+| Chrome Brain | v3.0 autoConnect | v3.0 + CAPTCHA | Em progresso |
+
+## Waves de Execucao
+
+### Wave A: Chrome Brain Definitivo (PRIORIDADE 1)
+1. Testar autoConnect no Chrome do usuario
+2. Criar skill `chrome-brain` para sessoes inteligentes
+3. Implementar auto-learning (extrair dados estruturados de paginas)
+4. Criar memory KB para padroes de navegacao
+
+### Wave B: Skills System Expansion
+1. Criar 5 novas skills:
+   - `captcha-handler` — detectar e resolver CAPTCHAs
+   - `deploy-readiness` — checklist dos 25 blockers automatizado
+   - `story-fast-track` — auto-create+validate story para fixes triviais
+   - `model-router` — decidir Opus/Sonnet/Haiku por complexidade
+   - `sinapse-methodology` — meta-skill standalone (H9)
+
+### Wave C: Seguranca End-to-End
+1. Validar todos os 25 deployment blockers como hooks/checks
+2. LGPD compliance automatizada (templates + checklist)
+3. Supply chain security (npm audit + gitleaks + slopsquatting)
+4. Secret rotation procedure
+
+### Wave D: Token Economy Max
+1. Compaction strategy (60% trigger)
+2. Model routing automatico em sub-agents
+3. Validar que rules com paths: nao carregam fora de contexto
+4. Memory relevance scoring
+
+### Wave E: Agent Ecosystem Polish
+1. Todos os agents com anti-hallucination
+2. Agent communication protocol (scratchpad enforcement)
+3. Handoff protocol v2 (structured reports)
+4. Auto-learning de erros no Gotchas KB
+
+### Wave F: Squad Creator Turbinado
+1. 4-layer persona model no template
+2. Auto-generate KB skeleton com pesquisas relevantes
+3. Auto-wire tasks/checklists/workflows
+4. Validation checklist para squads criadas
+
+### Wave G: CI/CD & Distribution
+1. Changesets para versioning automatico
+2. OIDC publishing (ja configurado)
+3. Gitleaks no CI
+4. PR size bot (warn > 400 lines)

package/docs/pt/contributing.md

@@ -146,6 +146,26 @@ Agents sao personas de IA com expertise e comandos especificos.
 .sinapse-ai/development/agents/seu-agent.md
 ```
 
+> **Cross-IDE parity (Story 10.18)**
+>
+> O diretorio `.sinapse-ai/development/agents/` e a fonte unica de verdade.
+> Ele se espelha automaticamente para `.claude/commands/SINAPSE/agents/` e
+> `.codex/agents/` via `npm run sync:ide`. O hook `lint-staged` ja roda o
+> sync quando voce comita um arquivo de agent, mas se voce editar um agent
+> e empurrar sem deixar o lint-staged rodar, o hook `pre-push` BLOQUEIA o
+> push.
+>
+> **Como destravar um push bloqueado por drift de IDE:**
+>
+> ```bash
+> npm run sync:ide
+> git add .claude .codex
+> git commit --amend --no-edit
+> git push
+> ```
+>
+> Em emergencia: `git push --no-verify` (mas o CI vai reprovar a PR).
+
 ### Estrutura Obrigatoria
 
 ```yaml