predators-protocol 1.0.0 → 1.2.0

package/bundle/docs/ENCARNACAO.md

@@ -248,11 +248,22 @@ Antes de entregar output, confirme:
 - [ ] **(0j) 4 DIRETRIZES COMUNICAÇÃO vigentes (2026-05-24 · meta-constitucional)** — comunicação direta Apex T7 segue **Diretriz 1 Lei do Tom Conversacional** (30%+ menos sintaxe repetitiva · zero "cumulativo cravado" · resposta 3-5 linhas). Matilha auto-prossegue ondas sequenciais óbvias Lei #9 conforme **Diretriz 2 Autonomia Sequencial** (sub-etapas · fechamentos · sentinels · não-pausa-desnecessariamente). Toda onda nova começa Águia-real Lei #8 PASSO 0 verificação empírica conforme **Diretriz 3 PASSO 0 EVERY ONDA** (md5 + pytest + git status + scope check · sem-exceção). Canon-doc retention 7 anos vs comunicação direta separados conforme **Diretriz 4 Separação canon-doc vs comunicação direta** (canon-doc sintaxe completa permitida · comunicação direta referencia · não duplica). Canon-docs vinculantes: `docs/CANON/DIRETRIZ-1-LEI-DO-TOM-CONVERSACIONAL.md` · `DIRETRIZ-2-AUTONOMIA-SEQUENCIAL-LEI-9.md` · `DIRETRIZ-3-LEI-8-PASSO-0-EVERY-ONDA.md` · `DIRETRIZ-4-SEPARACAO-CANON-DOC-COMUNICACAO-DIRETA.md`. Hiena sentinel anti-regressão automatic detection. Apex T7 BINARY direct ratificação 2026-05-24.
 - [ ] **(0k) MEMORY POINTER SAVE MANDATORY · Lei #1 SEVERA + Lei #14 S7 (2026-05-27)** — toda onda fechada (Tubarão JUIZ N2 APROVA_PERFEITO + Leão git push) **EXIGE memory pointer cravado** em `~/.claude/projects/<repo-slug>/memory/MEMORY.md` mencionando commit hash da onda. Sem pointer = **Lei #14 FIX_GERAL automatic** · NÃO declarar fechamento canon. Self-aferição visual: cada Skill encarnar termina output com `✓ memory pointer status: CRAVADO|PENDING|N/A`. Defesa em profundidade 6 camadas L1-L6 hardcoded (pre-commit hook · daemon consolidator · SessionStart awareness · BINARY criterion · este checklist · integrity hash). Canon doc: [`CANON/LEI-14-PERFEITO-OU-FIX-GERAL.md`](CANON/LEI-14-PERFEITO-OU-FIX-GERAL.md) S7. Ratificação Dragão-ancestral 2026-05-27 sob mandate Apex T7 "NÃO PASSA NENHUMA GOTA DE SANGUE" aplicado à memória institucional.
 - [ ] **(0l) TRACE NEURAL FRESH MANDATORY · Lei #14 S8 (2026-05-27)** — toda onda fechada exige `.synapse/onda-<slug>/neural-trace.json` existente E fresh (≤2h). Trace ausente OR stale = **Lei #14 FIX_GERAL automatic**. Self-aferição visual: cada Skill encarnar termina output com `✓ trace neural status: FRESH|STALE|MISSING`. Daemon L2 `trace-neural-consolidator` (registry `daemon_runner.py`) auto-cria skeleton para PRDs <24h sem trace. Canon doc: [`CANON/LEI-14-PERFEITO-OU-FIX-GERAL.md`](CANON/LEI-14-PERFEITO-OU-FIX-GERAL.md) S8. Ratificação Dragão-ancestral 2026-05-27 · onda `ONDA-NUNCAA-TRACE-PRD-2-GAPS-2026-05-27`.
-- [ ] **(0m) CORUJA CANON-DOC WORKFLOW MANDATORY · Lei #14 S10 (2026-05-27)** — toda onda tocando canon-doc (`docs/CANON/*.md` OR `docs/*.md` non-PRD) EXIGE 🦉 Coruja-real (Builder T3 · Art. 2 documentação técnica) encarnada explícita com `Skill encarnar coruja-real` literal · signature presente em commit message + body. Workflow canon: **Coruja-real escreve → Dragão-ancestral ratifica Art. 3 → Leão deploys Art. 1**. Skip Coruja = violação **Lei #10 + Lei #2 Authority cross-predator** + FIX_GERAL automatic. Self-aferição visual: cada Skill encarnar tocando canon-doc termina output com `✓ coruja signature: PRESENT|MISSING|N/A`. Daemon L2 `coruja-workflow-detector` (registry `daemon_runner.py`) cataloga gaps em `.synapse/coruja-workflow-gaps.json`. Canon doc: [`CANON/LEI-14-PERFEITO-OU-FIX-GERAL.md`](CANON/LEI-14-PERFEITO-OU-FIX-GERAL.md) S10. Ratificação Dragão-ancestral Art. 3 · 2026-05-27 · onda `ONDA-NUNCAA-R7-R6-CORUJA-TRACE-FIX-2026-05-27` · gap detectado direto pelo Apex T7 mid-execução prévia.
+- [ ] **(0m) CORUJA CANON-DOC WORKFLOW MANDATORY · Lei #14 S10 (2026-05-27)** — toda onda tocando canon-doc (`docs/CANON/*.md` OR `docs/*.md` non-PRD) EXIGE 🦉 **Coruja** (Builder T3 · Art. 2 documentação técnica · `predators/builder/coruja/`) encarnada explícita com `Skill encarnar coruja` literal · signature presente em commit message + body. **Disambiguação canon runtime (corrigida 2026-05-28 sub-T2):** 3 Corujas distintas no protocolo: `coruja` (Builder T3 sonnet · documentação técnica + ADRs + docstrings) · `coruja-real` (Meta T3 opus · protocol-observability + runtime-telemetry + SLO tracking) · `coruja-de-igreja` (Growth T3 sonnet ambush · growth-analytics + A/B testing). Para canon-doc workflow, encarnar **`coruja`** (Builder). Para observability runtime, encarnar **`coruja-real`** (Meta). Workflow canon-doc: **Coruja escreve → Dragão-ancestral ratifica Art. 3 → Leão deploys Art. 1**. Skip Coruja = violação **Lei #10 + Lei #2 Authority cross-predator** + FIX_GERAL automatic. Self-aferição visual: cada Skill encarnar tocando canon-doc termina output com `✓ coruja signature: PRESENT|MISSING|N/A`. Daemon L2 `coruja-workflow-detector` (registry `daemon_runner.py`) cataloga gaps em `.synapse/coruja-workflow-gaps.json`. Canon doc: [`CANON/LEI-14-PERFEITO-OU-FIX-GERAL.md`](CANON/LEI-14-PERFEITO-OU-FIX-GERAL.md) S10. Ratificação Dragão-ancestral Art. 3 · 2026-05-27 · onda `ONDA-NUNCAA-R7-R6-CORUJA-TRACE-FIX-2026-05-27` · gap detectado direto pelo Apex T7 mid-execução prévia. Drift "Coruja-real Builder T3 documentação técnica" corrigido sub-T2 ONDA-FIX-GERAL-CIRURGICO-7-CRITICOS 2026-05-28 (Lince N1 + Tubarão N2 BINARY ratificaram disambiguação canon empírica runtime).
 - [ ] **(0n) SELF-HEALING LOG CATALOG MANDATORY · Lei #14 S11 (2026-05-27)** — toda onda OU commit que mencione `SH #N` OR `SH-N` OR "self-healing" EXIGE entry estruturado em `docs/CANON/SELF-HEALING-LOG-CANON.json`. Ausência = **Lei #14 FIX_GERAL automatic** + **Lei #11 NUNCA MINTA enfraquecida** (catálogo é prova viva CANON-TUBARAO-SEVERA Parte D). Self-aferição visual: cada Skill encarnar mencionando self-healing termina output com `✓ self-healing status: CATALOGED|PENDING|N/A`. Daemon L2 `self-healing-consolidator` (registry `daemon_runner.py`) auto-detect SH ids via regex + auto-fill skeleton entry. Backfill histórico Hiena forense cobre SH-44 + SH-68 a SH-82. Canon doc: [`CANON/LEI-14-PERFEITO-OU-FIX-GERAL.md`](CANON/LEI-14-PERFEITO-OU-FIX-GERAL.md) S11. Schema source-of-truth: [`CANON/SELF-HEALING-LOG-CANON.json`](CANON/SELF-HEALING-LOG-CANON.json). Ratificação Dragão-ancestral Art. 3 · 2026-05-27 · onda `ONDA-NUNCAA-RANK-3-SELF-HEALING-LOG-CANON-2026-05-27`.
 - [ ] **(0o) ENV VARS SNAPSHOT SYNCED MANDATORY · Lei #14 S12 (2026-05-27)** — se onda tocou `.env*` files OR mudou versão npm OR alterou DNS OR adicionou/removeu Vercel env var, snapshot canon `.synapse/env-vars-snapshot.json` DEVE estar fresh (≤60min) E zero drift unacknowledged. Self-aferição visual: `env vars status: SYNCED|DRIFT|N/A`. Daemon L2 `env-vars-drift` (registry `daemon_runner.py`) poll 300s · 3 fontes (npm Registry público · Vercel API auth `VERCEL_TOKEN` · DNS resolution). **Lei #1 imutável:** snapshot armazena APENAS keys/versions/expiries · NUNCA env var values · zero leak credenciais. Canon doc: [`CANON/LEI-14-PERFEITO-OU-FIX-GERAL.md`](CANON/LEI-14-PERFEITO-OU-FIX-GERAL.md) S12. Ratificação Dragão-ancestral Art. 3 · 2026-05-27 · onda `ONDA-NUNCAA-RANK-4-ENV-VARS-DRIFT-2026-05-27`.
 - [ ] **(0p) AUDIT FIRM READINESS SIGNED MANDATORY · Lei #14 S13 (2026-05-27)** — se onda tocou `contracts/*.sol` OR `mcp/auth/*.py` OR superfícies Lei #1 SEVERA cripto, checklist canon [`CANON/AUDIT-FIRM-READINESS-CHECKLIST.md`](CANON/AUDIT-FIRM-READINESS-CHECKLIST.md) 8 categorias DEVE estar com coverage **≥85% PASS** empírico (ou exceções ratificadas Apex T7). Self-aferição visual: `audit-firm readiness: SIGNED|PENDING|N/A`. 🪼 Medusa Art. 5 imutável byte-canon "NUNCA APROVA VULNERÁVEL" supervisiona · 🦂 Escorpião red-team 8 attack vectors enumerate. Daemon L2 `audit-firm-readiness` (registry · poll 600s) scan estático contracts + mcp/auth. **Lei #1 SEVERA:** pre-firm internal audit NÃO substitui firm externo · prepara terreno · economia ~$5-10k findings óbvios. Ratificação Dragão-ancestral Art. 3 · 2026-05-27 · onda `ONDA-NUNCAA-RANK-5-AUDIT-FIRM-READINESS-2026-05-27`.
 - [ ] **(0q) LANDING/PUBLIC NO-CANON-LEAK MANDATORY · Lei #14 S14 (2026-05-27)** — se onda tocou `dashboard/app/(public)/**` OR `dashboard/components/landing/**`, audit Cat. 9 IP exposure DEVE PASSAR empírico: zero exposição pública de (a) nomes canônicos internos · (b) frases byte-canon literais · (c) contagens architectural específicas · (d) MD5 hashes · (e) "Cyber Squad" · (f) Apex T7 real name + role-canon juntos. Detecção: grep -rE em `dashboard/app/(public)/` + components referenciados. Exposição detectada = **Lei #14 FIX_GERAL automatic**. Self-aferição visual: `landing exposure: SANITIZED|LEAK|N/A`. 🦈 Tubarão-branco Lei #1 SEVERA + 🦂 Escorpião red-team supervisionam. Canon doc: [`CANON/LEI-14-PERFEITO-OU-FIX-GERAL.md`](CANON/LEI-14-PERFEITO-OU-FIX-GERAL.md) S14 + [`CANON/AUDIT-FIRM-READINESS-CHECKLIST.md`](CANON/AUDIT-FIRM-READINESS-CHECKLIST.md) Cat. 9. Ratificação Dragão-ancestral Art. 3 · 2026-05-27 · onda `ONDA-CYBER-LANDING-DUAL-TIER-2026-05-27` · self-healing SH-85 catalogada.
+- [ ] **(0r) CANON-DOC PRE-CRAVAMENTO VOCABULARY FILTER · Lei #13 + Lei #11 + SH-95 (2026-05-29)** — ANTES de cravar QUALQUER novo arquivo em `docs/CANON/*.md` OR `docs/PRDs/**/*.md`, matilha encarnada DEVE responder explicitamente 2 perguntas no output:
+  - **P1 · Lei #13 Pureza:** o filename + content contém jargão composto SaaS/corporativo external? (lista byte-canon ratificada em `tests/unit/test_canon_doc_no_jargon_lei_13.py`): `SaaS Matrix · Autonomous SaaS · Provisioning Matrix · best-in-class · best-of-breed · cutting-edge · industry-leading · enterprise-grade · world-class · next-gen · future-proof · synergy · robust solution · scalable platform`. Se SIM → **PARE · refactor vocabulário Predators (cadeia · veto · canon · matilha · invocação) ANTES de cravar**.
+  - **P2 · Lei #11 honest:** este canon-doc preserva decisão constitucional IRREPETÍVEL (ratificação Lei nova · self-healing não-óbvio · ADR arquitetura imutável · ratificação Apex T7 byte-canon)? OR é re-statement do commit message? Se RE-STATEMENT → **SKIP cravamento · commit message basta**.
+  
+  Self-aferição visual: Skill encarnar que crava canon-doc termina output com `✓ canon-doc check: PASS-LEI-13 · IRREPETÍVEL` (ambos confirmados) OR `SKIP cravamento canon-doc`. Camadas runtime forçadas:
+  - L1 hook pre-commit invoca `python -m pytest tests/unit/test_canon_doc_no_jargon_lei_13.py -q` quando staged inclui `docs/CANON/*.md` OR `docs/PRDs/**.md` · BLOCK commit se FAIL · zero `--no-verify` aceitável neste vetor (Lei #1 SEVERA reign)
+  - L2 daemon `claude_memory_consolidator` alerta Apex T7 quando canon-doc novo cravado sem PASSO 0r self-aferição
+  - L3 sentinel pytest test cobre filename + 17 regex compostos byte-canon
+  - L6 grandfathering: docs anteriores 2026-05-29 isentos (Art. 6 append-only Elefante)
+  
+  Self-healing source: SH-95 catalog · trigger: matilha cravou `MATILHA-100PCT-AUTONOMOUS-SAAS-MATRIX-2026-05-29.md` 30 min pós Beija-flor Lei #13 Copy audit · 5 camadas falharam · Apex T7 indignação direct ratificada esta camada 6 runtime-enforced. Canon doc: este checklist 0r + `tests/unit/test_canon_doc_no_jargon_lei_13.py` + hook pre-commit. Ratificação Apex T7 BINARY direct 2026-05-29.
 - [ ] Li `constitution.md` do predador-alvo **completa** (não só excerto)
 - [ ] Identifiquei a AgentAuthority do invocador (user · system · predador)
 - [ ] Confirmei que a hierarquia trófica permite esta invocação

package/bundle/docs/SYNAPSE.md

@@ -199,17 +199,29 @@ ponte entre predadores. Realiza 5 responsabilidades canônicas:
 Erros estruturais (target inexistente) levantam exception. Erros de regra
 (hierarchy, veto) viram `Feedback` negativo — fluxo controlado e auditável.
 
-#### O que ainda falta (pós-Onda 11)
-
-- **Integração com `orchestrator.py`**: hoje o orchestrator constrói
-  `InvocationContext`; ainda não constrói `Synapse` nem chama
-  `SynapseDispatcher.dispatch()`. A ponte está pronta para o orchestrator
-  encaixar como ato de motor de execução.
-- **Persistência do `NeuralTrace`**: hoje em memória; persistência canônica
-  via Elefante (Governance) é trabalho futuro.
-- **Wrapper do runtime LLM como Handler**: hoje os handlers do Dispatcher
-  são registrados externamente (em tests, stubs). Em produção, o runtime
-  router será adaptado para expor cada predador como handler.
+#### O que foi cravado · canon-aligned 2026-05-28 (ratificação Dragão-ancestral T-S3)
+
+**Status atualizado canon-aligned · runtime empírico cravado** (ONDA-FIX-SYNAPSE-MEMORY-100PCT-2026-05-28):
+
+- ✓ **Integração com `orchestrator.py`** · CRAVADA EVO-1 + EVO-2 (F.checkpoint opção C ratificado 2026-05-17). `core/orchestrator.py` agora:
+  - Importa as 6 classes canon Synapse (L28-43)
+  - Constructor injeta `synapse_dispatcher` + `neural_trace_store` (L74-145)
+  - `_auto_register_handlers` 3 modos canon: stub | hybrid | real (L146-196)
+  - `invoke_via_synapse()` complete 6 steps (L410-496): constrói IC → Authority → Synapse → dispatch → Feedback → publica NeuralEvent
+- ✓ **Persistência do `NeuralTrace`** · CRAVADA EVO-2 canon. Factory `default_neural_trace_store()` escolhe Postgres se `DATABASE_URL` set · InMemory default · canon Art. 6 Elefante IMUTÁVEL append-only · falha persistência NÃO bloqueia operação (canon graceful Lei #11)
+- ✓ **Wrapper runtime LLM como Handler** · CRAVADO `runtimes/runtime_handler.py` com 3 funções canon: `auto_register_stub_handlers` · `auto_register_hybrid` · `auto_register_runtime_handlers`. Modo `real` em produção exige API keys env (canon Lei #1 reign)
+
+**Decisão canon FINAL · Ratificada Dragão Art. 3 constitucional · 2026-05-28:**
+
+`invoke_via_synapse()` permanece **opt-in canon FINAL** (não substitui `invoke()` default). Coexistência canon é design intencional cravado:
+
+- **Razão 1:** Lei #3 regra 2 honored (coexistência declarada upfront orchestrator.py L66-72)
+- **Razão 2:** Zero regressão risk (12+ test files antigos preservados intactos)
+- **Razão 3:** M2 evidence empírica cumprida (5 sentinels BINARY equivalência cross-path · `tests/unit/test_invoke_via_synapse_equivalencia_funcional.py` PASS · canon-doc `docs/CANON/SYNAPSE-INTEGRADA-RUNTIME-M2-EVIDENCE-2026-05-28.md`)
+- **Razão 4:** Substituição β (default = `invoke_via_synapse()`) é onda M-posterior · exige nova ratificação dupla Apex T7 + Dragão · refactor estrutural sub_invocations + tokens cumulative
+
+**Ratificadores canon:** Tubarão-Apex T7 (BINARY direct "GO LETRA A") + Dragão-ancestral (Art. 3 constitucional T-S3)
+**Aferição:** Tubarão JUIZ N2 BINARY PARTE D (T-FINAL)
 
 ---