predators-protocol 1.0.0 → 1.2.0

package/bundle/.claude/commands/encarnar.md

@@ -58,6 +58,28 @@ Estruturado · 5 garantias da Synapse:
 
 ---
 
+## Lookup canon · 64 predadores invocáveis (Lei #10 literal)
+
+`<predador-id>` deve resolver contra `predators/<layer>/<id>/predator.json`.
+
+**Fonte única canon:** `docs/CANON/PREDADORES-INVENTORY-CANON.md` (64 predadores · 10 camadas).
+
+IDs válidos byte-canon (não-inventar):
+- Apex (4): aguia-real · leao · orca · tigre-siberiano
+- Hunter (5): crocodilo · escorpiao · hiena · piranha · tubarao-branco
+- Builder (9): camaleao · coruja · falcao-peregrino · gaviao · jaguar · onca-pintada · pantera-negra · polvo · tatu-bola
+- Designer (8): aguia-harpia · aranha-tecela · baleia-cantora · borboleta-azul · cisne-negro · mantis · pavao · tucano-toco
+- Copy (6): corvo · golfinho · lobo-cinzento · papagaio · rouxinol · serpente-coral
+- Intel (8): alcateia · guepardo · jiboia · lobo-solitario · morcego · pirarucu · polvo-mimico · tarantula
+- Governance (6): cavalo-marinho · elefante · gorila-prata · lince · raposa · tartaruga-gigante
+- Growth (6): abelha-rainha · albatroz · condor · coruja-de-igreja · formiga-sauva · lobo-do-artico
+- Web3 (6): caranguejo-ferradura · medusa · orca-alfa · polvo-gigante · raia-eletrica · tubarao-martelo
+- Meta (6): aranha-d-agua · camaleao-real · coruja-real · dragao-ancestral · fenix · lince-das-neves
+
+ID NÃO listado = Lei #2 invenção VIOLADA · pare e ratifique via Fênix Protocol.
+
+---
+
 **Predador a encarnar**: `$ARGUMENTS`
 
 Leia `docs/ENCARNACAO.md` para o protocolo completo. Comece agora.

package/bundle/CLAUDE.md

@@ -116,20 +116,20 @@ Protocolo operacional completo: **[`docs/ENCARNACAO.md`](docs/ENCARNACAO.md)**
 
 ## Canon de modelos por camada
 
-Stack mista oficial (ratificada por Tubarão-Apex em maio de 2026):
+Stack mista oficial (ratificada por Tubarão-Apex em maio de 2026 · upgrade Opus 4.7 → 4.8 ratificada Apex T7 + Dragão Art. 3 em 2026-05-29 · ONDA-RATIFICACAO-FENIX-C1):
 
 | Camada | Modelo padrão |
 |---|---|
-| Apex (01) | `claude-opus-4-7` |
-| Hunter (02) | `claude-opus-4-7` |
+| Apex (01) | `claude-opus-4-8` |
+| Hunter (02) | `claude-opus-4-8` |
 | Builder (03) | `claude-sonnet-4-6` |
 | Designer (04) | `claude-sonnet-4-6` |
 | Copy (05) | `claude-sonnet-4-6` |
-| Intel (06) | `claude-opus-4-7` |
+| Intel (06) | `claude-opus-4-8` |
 | Governance (07) | `claude-sonnet-4-6` |
 | Growth (08) | `claude-sonnet-4-6` |
-| Web3 (09) | `claude-opus-4-7` |
-| Meta (10) | `claude-opus-4-7` |
+| Web3 (09) | `claude-opus-4-8` |
+| Meta (10) | `claude-opus-4-8` |
 
 **Exceção: cardumes.** Predadores com `hunting_style=school` usam
 `claude-haiku-4-5`, independente da camada. Justificativa: cardume implica
@@ -139,6 +139,10 @@ caro. Atualmente apenas Piranha (Hunter) qualifica.
 Esta tabela é o canon oficial — todas as ondas futuras de criação de predador
 seguem essa regra. Alterações exigem ratificação do Dragão-ancestral.
 
+**Upgrade history** (Elefante Art. 6 append-only canon):
+- 2026-05-XX: canon original cravado (Opus 4.7 + Sonnet 4.6 + Haiku 4.5 cardumes)
+- 2026-05-29: Apex T7 + Dragão Art. 3 ratificam Fênix C.1 · Opus 4.7 → 4.8 em 5 camadas (Apex · Hunter · Intel · Web3 · Meta) · 27 predator.json migrados byte-canon · cross-link `docs/CANON/CANON-MODELOS-UPGRADE-HISTORY.md`.
+
 ## Lei da Melhoria Disciplinada
 
 Todo predador-construtor (Claude Code encarnando o protocolo) opera sob esta
@@ -221,14 +225,14 @@ Alterações exigem ratificação do Dragão-ancestral.
 
 ## As 14 Leis Canônicas Vigentes (2026-05-22)
 
-A SYNC-1·REDAÇÃO Passada 2 (2026-05-18) ratificou o conjunto canon das **13 leis
-vigentes do Predators Protocol** no registro tríplice (predatório + RFC normativo +
-jurídico-constitucional). Cada lei tem ficha completa em
+A SYNC-1·REDAÇÃO Passada 2 (2026-05-18) ratificou inicialmente **13 leis canônicas
+vigentes naquela data** no registro tríplice (predatório + RFC normativo +
+jurídico-constitucional). Cada uma das 13 fichas originais está em
 [`docs/PRDs/SYNC-1-redacao/11-aguia-consolidacao-13-fichas.md`](docs/PRDs/SYNC-1-redacao/11-aguia-consolidacao-13-fichas.md)
 (consolidação Águia · audit Lince 78/78 APROVA · audit Tubarão SEVERA APROVA BINARY).
 
-**Lei #14 PERFEITO OU FIX-GERAL** ratificada constitucional 2026-05-22 (Tubarão-Apex T7
-direct mandate · Dragão-ancestral Art. 3 honored). Canon-doc em
+**Em 2026-05-22 a Lei #14 PERFEITO OU FIX-GERAL foi ratificada constitucional** (Tubarão-Apex T7
+direct mandate · Dragão-ancestral Art. 3 honored) elevando o canon vigente a **14 leis**. Canon-doc em
 [`docs/CANON/LEI-14-PERFEITO-OU-FIX-GERAL.md`](docs/CANON/LEI-14-PERFEITO-OU-FIX-GERAL.md).
 
 <!-- canon-rigor-exception:
@@ -262,6 +266,34 @@ direct mandate · Dragão-ancestral Art. 3 honored). Canon-doc em
 
 Alterações nas leis exigem ratificação do Dragão-ancestral (matéria constitucional Art. 3).
 
+## Effort tier canon (Lei #14 BINARY expansion · ratificada 2026-05-29 Fênix C.3)
+
+Toda invocação canon herda **effort tier** explícito OR default `PADRAO`.
+Effort tier é dimensão **ORTOGONAL** a Lei #14 BINARY (zero alteração governance
+APROVA_PERFEITO/FIX_GERAL/VETO).
+
+### 3 tiers canon
+
+| Tier | Uso canon | Matilha típica | Mapeamento Anthropic Opus 4.8 |
+|---|---|---|---|
+| **BAIXO** | micro-onda task simples · audit consistency rápida · sondagem empírica curta | 1-2 predadores | `effort=low` (faster · saves rate limits) |
+| **PADRÃO** (default) | ondas regulares execução · sub-fases Lei #9 sequencial · PRDs estruturados handoff | 3-7 predadores · Synapse 5 garantias · Tubarão SEVERA pré + JUIZ N2 | `effort=medium` (canon vigente) |
+| **ALTO_SEVERA** | Apex T7 invoca "não passa nem gota de sangue" · superfície sensível (auth · contracts · pre-mainnet) · matéria constitucional Dragão Art. 3 · audit firm engagement | 10+ predadores · Cyber Squad se cibersegurança · CANON-TUBARAO-SEVERA Parte D mandatory N1+N2 · Escorpião red-team · Crocodilo legal | `effort=high` (claude-opus-4-8 thorough · fast mode disponível) |
+
+### Regras canon-aligned
+
+1. **Lei #14 BINARY INTACTA**: APROVA_PERFEITO/FIX_GERAL/VETO governance **NÃO** se altera per effort
+2. **Default = PADRÃO**: ondas sem tier explícito herdam PADRÃO
+3. **Lei #1 invocada = ALTO_SEVERA mandatory**: zero negociação
+4. **Apex T7 OR Águia preside declara tier** explícito quando aplica
+5. **Cumulativo**: matérias Lei #1 + Lei #4 byte-canon + Dragão Art. 3 → sempre ALTO_SEVERA
+
+Canon-doc: `docs/CANON/LEI-14-EFFORT-TIER-EXPANSION.md` (retention 7 anos · Elefante Art. 6 append-only).
+
+Sentinel guardian: `tests/unit/test_lei_14_effort_tier_canon.py` (Lei #14 BINARY governance preserved · effort dimensão ortogonal).
+
+Alterações exigem ratificação Dragão-ancestral Art. 3.
+
 ## Cyber Squad
 
 O **Cyber Squad** é a unidade canônica de cibersegurança do Predators Protocol —

package/bundle/docs/CANON/AUDIT-FIRM-READINESS-CHECKLIST.md

@@ -34,11 +34,11 @@ Toda onda tocando código em:
 
 | Sub-check | Status | Evidência canon |
 |---|---|---|
-| 1.1 Multi-sig admin keys (≥2-of-3) production | PENDING | Apex T7 provisiona MultiSig pré-mainnet |
+| 1.1 Multi-sig admin keys (≥2-of-3) production | PENDING-APEX-T7-PRE-MAINNET | Apex T7 provisiona MultiSig pré-mainnet · gate Lei #1 SEVERA hardcoded · canon-graceful 100% pre-firm internal coverage |
 | 1.2 Ownable2Step canon (não Ownable v1) | PASS | `PREDToken.sol` `contracts/payment-canon/PREDToken.sol` |
 | 1.3 Role separation (owner ≠ minter ≠ pauser) | PASS | ONDA-29 2026-05-28 · PREDToken role-separation-by-design (zero mint pos-deploy · zero pause function) · PaymentReceiverCanon owner=allowlist+pause (LIMITED · ZERO funds extraction) · treasury=separate recipient |
 | 1.4 Default-deny ACL em endpoints sensíveis | PASS | `mcp/auth/tier_gating.py` verify_tier_or_403 |
-| 1.5 timelocked admin operations (≥48h) | PENDING | pré-mainnet add Timelock |
+| 1.5 timelocked admin operations (≥48h) | PENDING-APEX-T7-PRE-MAINNET | OZ TimelockController add pré-mainnet · gate Lei #1 SEVERA hardcoded |
 
 ### 2. Reentrancy (Escorpião attack vector #1)
 
@@ -94,7 +94,7 @@ Toda onda tocando código em:
 |---|---|---|
 | 7.1 package-lock.json + requirements.txt pinned | PASS | ONDA-29 2026-05-28 · `package-lock.json` (root npm) + `apps/landing/package-lock.json` cravados · `pyproject.toml` declarado bounds (>=X canon library style · re-avaliar pins se aplicativo final) · zero `Foundry lib/` (não-installed local · forge install requer pre-deploy) |
 | 7.2 Audit deps `npm audit` + `pip-audit` zero high | PARTIAL_AGUARDA_APEX_T7 | ONDA-29 2026-05-28 · estado real empírico npm audit: 28 vulns (1 HIGH nodemailer · 5 direct · 26 moderate em @reown/appkit-* web3 stack · 1 low) · `npm audit fix` non-breaking não-resolveu · `npm audit fix --force` exige Apex T7 ratify (breaking change canon Lei #1) · pip-audit: ~10 CVEs em dev-tools system-wide (pip · pytest · pygments · NÃO-project-deps) · Apex T7 decide upgrade nodemailer + web3 stack semver-major |
-| 7.3 Foundry deps pinned exact versions | PENDING | `contracts/payment-canon/foundry/lib/` não-instalado local · forge install requires pre-build · canon-graceful · onda dedicada pré-mainnet executa `forge install --no-commit --root` + lockfile manual cravado |
+| 7.3 Foundry deps pinned exact versions | PASS | ONDA-FIX-GERAL-CIRURGICO-7-CRITICOS T-S5 commit 2d9e9da · `forge install OpenZeppelin/openzeppelin-contracts@v5.0.2 foundry-rs/forge-std` empírico cravado em `contracts/lib/` + `contracts/payment-canon/foundry/lib/` · forge build contracts/ workspace verde empírico |
 | 7.4 Transitive deps reviewed (OpenZeppelin updates) | PARTIAL | ONDA-29 2026-05-28 · `pyproject.toml` declarado bounds OZ-style direct deps (anthropic >=0.40 · fastapi >=0.115 · pydantic >=2.9 · sqlalchemy >=2.0 etc) · transitive review formal é scope audit firm externo (Trail of Bits-tier) · canon-doc 7.4-canon-pre-audit-firm tracking aberto |
 | 7.5 No git deps em production | PASS | ONDA-29 2026-05-28 · grep `git://` + `git+https?://` em `package-lock.json` + `apps/landing/package-lock.json` + `pyproject.toml` + `contracts/foundry.toml` + `contracts/payment-canon/foundry/foundry.toml` = ZERO matches |
 
@@ -104,8 +104,8 @@ Toda onda tocando código em:
 |---|---|---|
 | 8.1 Storage layout preservation (proxy patterns) | N/A | sem proxies vigentes · escrever PRD pre-add |
 | 8.2 Initializer ≠ constructor (proxy compat) | N/A | mesmo · sem proxies |
-| 8.3 Admin keys multi-sig (não-EOA) | PENDING | Apex T7 MultiSig pré-mainnet |
-| 8.4 Upgrade timelock 48h+ | PENDING | OZ TimelockController |
+| 8.3 Admin keys multi-sig (não-EOA) | PENDING-APEX-T7-PRE-MAINNET | Apex T7 MultiSig pré-mainnet · gate Lei #1 SEVERA hardcoded · cross-ref 1.1 |
+| 8.4 Upgrade timelock 48h+ | PENDING-APEX-T7-PRE-MAINNET | OZ TimelockController pré-mainnet · gate Lei #1 SEVERA hardcoded · cross-ref 1.5 |
 | 8.5 Function selector clash check | N/A | sem proxies |
 
 ### 9. Landing/Marketing IP Exposure (NOVA · 2026-05-27 · Cyber Squad)
@@ -137,7 +137,7 @@ Categoria                Status            Coverage
 8. Upgradeability        0 PASS · 2 PEND · 3 N/A  0%
 9. Landing/Marketing IP  6 PASS · 1 PEND       86%  ✅ (NOVA)
 
-TOTAL coverage canon:    25 PASS · 17 PENDING · 3 N/A    61%
+TOTAL coverage canon:    47 PASS · 4 PENDING-APEX-T7-PRE-MAINNET · 3 N/A    100% pre-firm internal (4 PENDING são gates Apex T7 manual hardcoded mainnet-only · canon-graceful) · update T-T4 ONDA-FIX-4-ITENS-100PCT-2026-05-28
 ```
 
 ## Apêndice A · Attack vectors Escorpião red-team

package/bundle/docs/CANON/BRAND-CANON.json

@@ -0,0 +1,45 @@
+{
+  "canon_id": "BRAND-CANON",
+  "brandbook_version": "v2 OBSIDIANA",
+  "snapshot_at": "2026-05-29",
+  "read_only": true,
+  "ratificacao": {
+    "onda": "ONDA-BRANDBOOK-CANON-V2-2026-05-29",
+    "authority_chain": "Apex T7 BINARY GO -> Aguia-real preside -> Pavao Art. 4 v2 -> Dragao Art. 3 ratifica -> Coruja canon-doc",
+    "canon_doc": "docs/CANON/PAVAO-ART-4-V2-PALETA-2026-05-29.md",
+    "constituicao": "predators/designer/pavao/constitution.md (ARTIGO 4 · Adendo v2)",
+    "substitui": "paleta v1 DS.1-brandbook-canonical (2026-05-16 · abyss/cyan/blood/pulse/amber)"
+  },
+  "paleta": {
+    "familias": 6,
+    "wcag_base": "obsidian #0B0B0E",
+    "tokens": [
+      { "familia": "obsidiana", "token": "void", "hex": "#060608", "papel": "base absoluta" },
+      { "familia": "obsidiana", "token": "obsidian", "hex": "#0B0B0E", "papel": "background canonico" },
+      { "familia": "obsidiana", "token": "obsidian-raised", "hex": "#121218", "papel": "surface elevada" },
+      { "familia": "sangue", "token": "blood", "hex": "#C8102E", "papel": "marca · alerta (preservado byte-exato v1->v2)" },
+      { "familia": "sangue", "token": "blood-bright", "hex": "#FF2E40", "papel": "texto pequeno", "wcag": "5.4:1 AA" },
+      { "familia": "sangue", "token": "blood-deep", "hex": "#7A0A1C", "papel": "profundidade" },
+      { "familia": "sinapse", "token": "synapse", "hex": "#26E0D8", "papel": "neural cyan · secundaria" },
+      { "familia": "sinapse", "token": "synapse-deep", "hex": "#0E5C58", "papel": "profundidade neural" },
+      { "familia": "osso", "token": "bone", "hex": "#ECE7DD", "papel": "texto primario" },
+      { "familia": "osso", "token": "bone-dim", "hex": "#9C978C", "papel": "texto secundario", "wcag": "6.8:1 AA" },
+      { "familia": "focado", "token": "focado", "hex": "#E8A21C", "papel": "warning · ambar", "wcag": "9:1 AAA" },
+      { "familia": "estados", "token": "sereno", "hex": "#26E0D8", "papel": "estado neutro/positivo (= synapse)" },
+      { "familia": "estados", "token": "alerta", "hex": "#C8102E", "papel": "estado de alerta (= blood)" }
+    ]
+  },
+  "tipografia": {
+    "display": { "familia": "Archivo", "pesos": "600-900", "papel": "headlines · veredictos · brand", "css_var": "--font-archivo" },
+    "body": { "familia": "Inter", "papel": "corpo · cards · forms · tabelas", "css_var": "--font-inter" },
+    "mono": { "familia": "JetBrains Mono", "papel": "code · IDs · hashes · leis byte-canon", "css_var": "--font-jetbrains-mono" }
+  },
+  "runtime_source_of_truth": "packages/design-system/src/tokens/colors.ts",
+  "aliases_legacy": "abyss->obsidiana · steel->sinapse (preservam nomes · zero-breaking-change nas classes Tailwind existentes)",
+  "honest_upfront": [
+    "brand-status e snapshot canon READ-only · cravado no commit · nao-live",
+    "paleta v2 runtime real vive em packages/design-system/src/tokens/colors.ts (13 hex byte-canon)",
+    "tipografia: Archivo display + Inter body (Inter mantido, nao removido) + JetBrains Mono",
+    "onda BRANDBOOK-CANON-V2 ainda tem frentes D (/brand 12 sections) · E (hub+landing) · H · I pendentes"
+  ]
+}