izanagi-ai 3.10.0 → 3.11.0

package/.github/workflows/polyglot.yml

@@ -5,7 +5,7 @@
 # inteiro => fail-fast global. Pipeline apenas de integracao; sem deploy.
 #
 # Supply chain: TODAS as actions de terceiros fixadas por SHA de commit
-# completo (imutavel), resolvidos ao vivo na GitHub API em 2026-08-22.
+# completo (imutavel), resolvidos ao vivo na GitHub API em 2026-08-23.
 # A tag major fica no comentario acima de cada "uses". Nunca referenciar
 # tags mutaveis (@v4/@main/@latest) diretamente.
 #
@@ -41,11 +41,11 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 15
     steps:
-      # actions/checkout@v5
-      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09
-      # actions/setup-node@v4 - Node 24 por paridade com dev local (v24.18.0);
+      # actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+      # actions/setup-node@v6 - Node 24 por paridade com dev local (v24.18.0);
       # engines: raiz declara >=18, pacotes poliglotas (sdk/cli) declaram >=22.
-      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
+      - uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f
         with:
           node-version: '24'
           cache: npm # usa o package-lock.json commitado na raiz
@@ -77,8 +77,8 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 20
     steps:
-      # actions/checkout@v5
-      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09
+      # actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
       # dtolnay/rust-toolchain@stable (branch mutavel por design do autor;
       # o SHA congela o CODIGO da action, nao a versao do Rust instalada)
       - uses: dtolnay/rust-toolchain@4360b52568e2003a75bf9bc1d59f33a8e3fc893c
@@ -127,8 +127,8 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 20
     steps:
-      # actions/checkout@v5
-      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09
+      # actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
       # dtolnay/rust-toolchain@stable - "targets" instala o target cross junto
       - uses: dtolnay/rust-toolchain@4360b52568e2003a75bf9bc1d59f33a8e3fc893c
         with:
@@ -167,8 +167,8 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
-      # actions/checkout@v5
-      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09
+      # actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
       # actions/setup-go@v5
       - uses: actions/setup-go@40f1582b2485089dde7abd97c1529aa768e1baff
         with:
@@ -200,8 +200,8 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
-      # actions/checkout@v5
-      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09
+      # actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
       # actions/setup-python@v5
       - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065
         with:
@@ -244,10 +244,10 @@ jobs:
           - package: cli
             script: build # npm run build = tsc -p tsconfig.json
     steps:
-      # actions/checkout@v5
-      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09
-      # actions/setup-node@v4 - cache por lockfile do pacote da matriz
-      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
+      # actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+      # actions/setup-node@v6 - cache por lockfile do pacote da matriz
+      - uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f
         with:
           node-version: '24'
           cache: npm

package/.github/workflows/publish.yml

@@ -27,9 +27,9 @@
 #    desta frente.
 #
 # 2) SUPPLY CHAIN: actions fixadas por SHA de commit completo (imutável).
-#    SHAs conferidos nos logs reais de execução deste repo:
-#      - actions/checkout@v4     => 11d5960a326750d5838078e36cf38b85af677262
-#      - actions/setup-node@v4   => 49933ea5288caeca8642d1e84afbd3f7d6820020
+#    SHAs conferidos na GitHub API em 2026-08-23 (tags = commits):
+#      - actions/checkout@v7.0.1   => 3d3c42e5aac5ba805825da76410c181273ba90b1
+#      - actions/setup-node@v6.1.0 => 395ad3262231945c25e8478fd5baf05154b1d79f
 #    Nunca referenciar tags mutáveis (@v4/@main) diretamente.
 #
 # 3) LEAST PRIVILEGE:
@@ -77,10 +77,10 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 15
     steps:
-      # actions/checkout@v4
-      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
-      # actions/setup-node@v4 - SEM registry-url/token: job não publica nada.
-      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
+      # actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+      # actions/setup-node@v6 - SEM registry-url/token: job não publica nada.
+      - uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f
         with:
           node-version: '24'
           cache: npm
@@ -105,11 +105,11 @@ jobs:
       contents: read
       id-token: write
     steps:
-      # actions/checkout@v4
-      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
-      # actions/setup-node@v4 - registry-url apenas aqui: gera o .npmrc com
+      # actions/checkout@v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+      # actions/setup-node@v6 - registry-url apenas aqui: gera o .npmrc com
       # NODE_AUTH_TOKEN injetado pelo setup-node SOMENTE neste job.
-      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
+      - uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f
         with:
           node-version: '24'
           cache: npm

package/.manifest

@@ -1,11 +1,11 @@
 {
   "name": "izanagi-ai",
-  "version": "3.10.0",
+  "version": "3.11.0",
   "description": "Izanagi AI - Modular Skill-Oriented AI Prompt & Agent Framework for Autonomous Software Engineering",
   "author": "Pedro Henrique Sanches Leal",
   "license": "MIT",
   "homepage": "https://github.com/pedrohenriquesanchesleal4-debug/izanagi-ai#readme",
-  "generatedAt": "2026-08-23T18:12:57.777Z",
+  "generatedAt": "2026-08-23T19:30:19.466Z",
   "agents": [
     {
       "id": "adversarial-critic",
@@ -787,7 +787,7 @@
         },
         {
           "id": "economia-tokens",
-          "name": "Context Engineering — Economia de Tokens (v2)",
+          "name": "economia-tokens",
           "version": "1.0.0",
           "path": "skills/economia-tokens/SKILL.md"
         },

package/CHANGELOG.md

@@ -4,6 +4,71 @@
 
 ---
 
+## [3.10.1]: 2026-08-23
+
+### Changed
+- **Documentação auditada para a era poliglota**: README reescrito em torno da topologia poliglota (instalação, variáveis de ambiente e comandos de teste por núcleo), `docs/POLYGLOT.md` sincronizada com as medições atuais, SYSTEM/RULES/CONTRIBUTING/ROADMAP e `core/*.md` revisados contra a realidade do repositório.
+- **Actions do CI unificadas e pinadas por SHA**: `actions/checkout@v7.0.1` e `actions/setup-node@v6.1.0` em todos os workflows, eliminando o warning de deprecação do Node 20 nos runners.
+
+---
+
+## [3.10.0]: 2026-08-23
+
+### Added
+- **Progressive disclosure nas skills v2**: front-matter `references:` declara os arquivos de apoio de cada skill em `.skills/<name>/`; `izanagi-next skill show <name> [--ref <arquivo>]` exibe skill e references sob demanda; `skill-migrator --check` valida a sincronia sem escrever.
+- **Gate anti-racionalização na fase 4 do `izanagi-next run`**: o artefato final passa pelo Anti-Rationalization Engine antes da entrega. Blocker reprova o gate e dispara auto-heal (N=2); Major/Minor são advisory; `rust-core` ausente degrada o gate para advisory com exit 0.
+- **Provenance OIDC no publish npm**: `publish.yml` ganha `id-token: write` escopado ao job e publica com `--provenance` (fail-closed); attestation SLSA v1 verificável no registry.
+
+### Fixed
+- **Rodapé de proveniência determinístico nos exporters**: os adapters gerados por `izanagi export` incluem um rodapé gerado deterministicamente, idempotente byte-a-byte entre máquinas (elimina diffs falsos entre execuções/regenerações).
+
+---
+
+## [3.9.0]: 2026-08-23
+
+### Added
+- **Anti-Rationalization Engine em Rust** (`crates/izanagi_core`): scanner determinístico regex-free de racionalizações (33 padrões / 8 categorias), exposto como operação NDJSON `scan-rationalizations` com subcomandos `--file=<path>`/`--stdin` e flags `--version`/`--help`; exposto nos bindings WASM; 30 testes novos.
+
+### Changed
+- **Consolidação CI/CD (ADR-006)**: `publish.yml` vira CD exclusivo de tag `v*`/release (guard idempotente, least privilege) e o pipeline poliglota (`polyglot.yml`) absorve o teste sandbox do `npm run verify`.
+
+### Fixed
+- Higiene de repositório: `.gitignore` cobre os artefatos de build poliglotas; comentário de `engines` corrigido no workflow legado; removida a negação órfã de `agents/generated/c-systems-engineer.json` (arquivo não existe desde a 2.13.0).
+
+---
+
+## [3.8.0]: 2026-08-23
+
+### Added
+- **`izanagi polyglot status [--json|--strict]`**: auditoria de saúde dos 7 componentes poliglotas (binários Rust, orquestrador Go, engine Python, pacotes TS); `--strict` sai com exit 1 se algo estiver ausente.
+- **`docs/POLYGLOT.md`**: referência canônica da topologia poliglota — contratos IPC, error codes (-32001..-32005), tabela de variáveis de ambiente, gaps conhecidos e resumo dos ADRs.
+
+### Changed
+- **Gates de qualidade Rust ativados no CI**: `cargo fmt` aplicado integralmente + 4 fixes semânticos do clippy (zero `#[allow]`); `fmt-check` e `clippy -D warnings` agora bloqueiam o pipeline; guard de idempotência e least privilege também reforçados no workflow legado.
+
+### Fixed
+- **postinstall tolerante a checkout sem `dist/`** (bug de CI): a auto-ativação do `izanagi-ai` não falha mais quando executada a partir de um checkout recém-clonado sem build prévio.
+
+---
+
+## [3.7.0]: 2026-08-23
+
+### Added
+- **Topologia poliglota ao lado do runtime npm legado** (Strangler Fig, ADR-001):
+  - `crates/izanagi_core` (Rust): quality engine com 7 heurísticas anti-slop sobre TS/Python/Go, protocolo NDJSON stdin/stdout (`validate`/`rules`/`version`) e bindings WASM feature-gated.
+  - `crates/izanagi_mcp` (Rust): cliente MCP JSON-RPC 2.0 sobre stdio (discovery + invocação pontual), agora com subcomando `call --tool=<name>` coberto por testes E2E.
+  - `go-services/swarm_orchestrator` (Go): orquestrador de swarm (Uber Fx) com pipeline architect→engineer→qa→security via JSON-RPC 2.0 sobre UDS e event push.
+  - `python-engine/ast_analyzer` (Python ≥3.10): análise semântica multilíngue (símbolos, complexidade ciclomática, imports) com tree-sitter + fallback estrutural.
+  - `packages/sdk` (`@izanagi/sdk`, clientes tipados strict para os 4 núcleos + catálogo de skills) e `packages/cli` (binário `izanagi-next`, run em 4 fases com auto-heal N=2), mais o `skill-migrator` determinístico (skills v1→v2).
+- **Catálogo de skills v2 (`.skills/<name>/SKILL.md`)**: 106 módulos migrados deterministicamente do legado `skills/` com seções Triggering Criteria / Step-by-Step Workflow / Verification Steps / Common Rationalizations / Red Flags (ADR-004).
+- **CI poliglota GitHub Actions** (`.github/workflows/polyglot.yml`): jobs paralelos para npm legado, Rust+WASM, Go, Python e pacotes TS, com `requirements-dev.txt` pinado.
+- **Topologia `.agents/agents/*.yaml` via `agent-migrator`**: os 22 agentes derivados JSON→YAML por migrador determinístico idempotente (ADR-005); `--check` detecta drift YAML↔JSON.
+
+### Fixed
+- **`doctor`**: a heurística de raiz não confunde mais os YAMLs derivados (`.agents/agents/*.yaml`) com uma instalação completa (que exige agentes em JSON); regressão coberta por testes.
+
+---
+
 ## [3.6.0]: 2026-08-18
 
 ### Fixed

package/README.md

@@ -1,13 +1,15 @@
 # Izanagi AI
 
-Framework **meta**: **Adaptive Agent & Skill Runtime**: para engenharia de software autônoma orientada a agentes: routing → orquestração → avaliação → healing → memória, com 22 agentes especializados, 106 skills, execution graph, evaluation engine, self-healing e CLI executável publicada no npm (`izanagi-ai`).
+> **v3.10.0** · Framework **meta** para engenharia de software autônoma orientada a agentes: routing → orquestração → avaliação → healing → memória, com 22 agentes especializados, catálogo de skills v2, Adaptive Runtime com execution graph e self-healing, CLI publicada no npm (`izanagi-ai`) e **topologia poliglota** (Rust · Go · Python · TypeScript) orquestrada ao lado do runtime legado.
 
-> **Filosofia:** Arquitetura primeiro. Código depois. Qualidade medida. Evolução contínua. Zero "cara de IA".
+**Filosofia:** Arquitetura primeiro. Código depois. Qualidade medida. Evolução contínua. Zero "cara de IA".
 
 ---
 
 ## Instalação
 
+Requisito: Node.js ≥ 18.
+
 ```bash
 npm install -g izanagi-ai    # instalação global
 npx izanagi <comando>        # ou execução direta sem instalar
@@ -18,94 +20,189 @@ izanagi --version
 
 ---
 
+## Quick Start
+
+```bash
+# 1. Inicializa um projeto com .agents/ e seleção interativa de packs de skills
+izanagi init my-project
+#    ou sem interação: izanagi init my-project --packs core,agents,coding,database
+
+# 2. Executa uma tarefa via Adaptive Runtime
+izanagi run "Criar uma landing page de um SaaS de analytics"
+
+# 3. Observabilidade e auditoria
+izanagi trace            # spans, healing, graph, avaliação
+izanagi explain <run-id> # por que o Izanagi decidiu o que decidiu
+izanagi doctor           # integridade da instalação (--deep inclui security scan das skills)
+```
+
+O caminho único de execução é o Adaptive Runtime: graph + adaptive routing + evaluation engine + self-healing + memory. Com `--prompt-only`, apenas compila `izanagi-prompt.md` para colar manualmente em outra ferramenta, sem executar nada. Nós de aprovação (`human-in-the-loop`) pausam a execução até `izanagi approve <run-id>`.
+
+---
+
+## Arquitetura Poliglota
+
+Desde as Waves 1–5, o crescimento novo vive numa topologia poliglota que coexiste com o runtime npm legado em padrão Strangler Fig (ADR-001): contratos IPC, error codes e env vars canônicos em [`docs/POLYGLOT.md`](docs/POLYGLOT.md).
+
+| Componente | Linguagem | O que faz | Como testar |
+|---|---|---|---|
+| `crates/izanagi_core` | Rust | Quality engine: 7 heurísticas anti-slop sobre TS/Python/Go; protocolo NDJSON stdin/stdout (`validate`/`rules`/`version`) + op `scan-rationalizations`; bindings WASM feature-gated | `cargo test --workspace` (111 testes) |
+| `crates/izanagi_mcp` | Rust | Cliente MCP JSON-RPC 2.0 sobre stdio: discovery + invocação pontual (`izanagi-mcp call --tool=<name>`) | incluso no `cargo test --workspace` |
+| `go-services/swarm_orchestrator` | Go | Orquestrador de swarm (Uber Fx): pipeline architect→engineer→qa→security via JSON-RPC 2.0 sobre UDS com event push | `go build ./... && go vet ./... && go test ./...` |
+| `python-engine/ast_analyzer` | Python ≥ 3.10 | Análise semântica multilíngue: símbolos, complexidade ciclomática, imports (tree-sitter + fallback estrutural) | `.venv/bin/python -m pytest tests/ -q` (70 testes) |
+| `packages/sdk` (`@izanagi/sdk`) | TypeScript | Clientes tipados strict para os 4 núcleos + catálogo de skills; zero dependências de runtime | `npm test` dentro de `packages/sdk` (42 testes) |
+| `packages/cli` (`izanagi-next`) | TypeScript | CLI de nova geração: run em 4 fases com auto-heal (N=2) + gate anti-racionalização; `agent list`, `skill list/show --ref`, `gates check` | `npm test` dentro de `packages/cli` (13 testes) |
+
+Diagnóstico rápido de todos os componentes:
+
+```bash
+izanagi polyglot status          # saúde dos núcleos poliglotas (--json | --strict)
+node packages/agent-migrator/cli.mjs --check   # drift YAML ↔ JSON dos agentes
+node packages/skill-migrator/cli.mjs --dry-run # valida migração skills v1 → v2 sem escrever
+```
+
+### Estrutura do Repositório
+
+```text
+izanagi-ai/
+├── bin/                        Executável da CLI legado (bin/izanagi.js → dist/cli)
+├── src/                        Runtime real em TypeScript (orchestrator, evaluation, resolver, scanner, factories, tools, tracer, llm, cli)
+├── core/                       Engines (.md) + skill-resolver.json (aliases → targets + compositions)
+├── agents/                     22 definições de agentes em JSON (fonte da verdade dos comandos)
+├── skills/                     Skills legado v1 (skills/<name>/SKILL.md + references.md opcional)
+├── .skills/                    Catálogo ativo v2 (.skills/<name>/SKILL.md + references/)
+├── crates/                     Rust: izanagi_core (quality engine + WASM) e izanagi_mcp (cliente MCP stdio)
+├── go-services/swarm_orchestrator/  Orquestrador de swarm em Go (Uber Fx, JSON-RPC 2.0 sobre UDS)
+├── python-engine/              Analisador AST multilíngue (tree-sitter + fallback estrutural)
+├── packages/                   sdk (@izanagi/sdk) · cli (izanagi-next) · agent-migrator · skill-migrator
+├── references/                 Curadoria de referências reais por domínio (webgl-3d, scrollytelling, stack-2026...)
+├── .agents/memoria/            Memória persistente anti-repetição (contexto, decisoes, erros-corrigidos, learnings)
+├── .opencode/                  Comandos slash do Opencode (adapters em .claude/, .codex/, .cursor/...)
+├── docs/POLYGLOT.md            Contratos IPC, error codes, env vars e resumo dos ADRs
+├── AGENTS.md                   Instruções de operação do framework
+├── ARCHITECTURE.md             Visão arquitetural
+├── SYSTEM.md                   Fundação do sistema (arquitetura real do runtime)
+└── RULES.md                    Regras operacionais (Anti-Generic High-Craft & Cinematic UI)
+```
+
+---
+
 ## Comandos Principais da CLI
 
+CLI legado (`izanagi`, publicada no npm):
+
 | Comando | Descrição |
 |---|---|
 | `izanagi init [dir] [--packs a,b,c]` | Cria projeto com `.agents/` e seleção de packs de skills. |
 | `izanagi run [agent] --task "<task>"` | Analisa a tarefa, seleciona o agente ideal e executa via Adaptive Runtime (graph + adaptive routing + evaluation + trace + self-healing + memory): caminho único, sem modo estático paralelo. `--prompt-only` só compila `izanagi-prompt.md` para colar manualmente em outra ferramenta, sem executar nada. |
+| `izanagi chat` | REPL interativo da CLI. |
+| `izanagi dashboard [--port N]` | Dashboard local (Run Explorer, Arena, Memory). |
 | `izanagi agent create "<requisito>" [--name=slug] [--skills=a,b]` | Agent Factory: gera agente com genome completo em `agents/generated/` (detecta lacuna vs. 22 core). |
 | `izanagi agent list \| inspect <name>` | Lista/inspeta agentes (inclui `agents/generated/`) com genome. |
 | `izanagi skill create <nome> --gap="<descrição>" [--force]` | Skill Factory: cria skill com frontmatter, security scan pré-escrita e recusa de lacuna já coberta. |
-| `izanagi skill list \| search <q> \| inspect <name>` | Lista, busca e detalha skills. |
-| `izanagi create <agent\|skill> <name>` | Cria scaffold de agente (JSON) ou skill (SKILL.md). |
+| `izanagi skill list \| search <q> \| show <name>` | Lista, busca e detalha skills (catálogo v2, com progressive disclosure). |
+| `izanagi create <agent\|skill> <name>` | Cria scaffold cru de agente (JSON) ou skill (SKILL.md), sem validação. |
 | `izanagi compile <agente> [arquivo]` | Compila um System Prompt completo do agente + fundação do sistema. |
 | `izanagi workflow list \| inspect <template>` | Templates de grafo de execução por categoria (11). |
 | `izanagi eval <file.json> \| --metrics ... \| --report <run-id>` | Evaluation Engine: métricas ponderadas + veredito (PASS/.../UNKNOWN). |
-| `izanagi benchmark [compare]` | 10 benchmarks builtin + comparação de regressões entre builds. |
+| `izanagi benchmark [compare]` | 10 benchmarks builtin + comparação de regressões entre builds. Alias histórico: `arena`. |
 | `izanagi trace [run-id]` | Traces de execução (spans, healing, graph, avaliação). |
 | `izanagi memory inspect \| search <q>` | Estado da memória de execução e busca em `.agents/memoria/`. |
-| `izanagi doctor [--deep]` | Auditoria de integridade; `--deep` adiciona security scan das 106 skills. |
+| `izanagi polyglot status [--json\|--strict]` | Saúde dos núcleos poliglotas (Rust, Go, Python, packages TS): checagens de existência + probes baratos; `--strict` sai com código 1 se algo estiver ausente. |
+| `izanagi doctor [--deep]` | Auditoria de integridade; `--deep` adiciona security scan das skills. |
 | `izanagi diagnose` | Diagnóstico profundo do runtime (state, agent genome, contratos de artifact). |
 | `izanagi resume <run-id>` | Retoma execução interrompida (crash) ou pausada a partir do checkpoint: sem replanejar nem reexecutar nós concluídos. |
 | `izanagi approve <run-id> [node-id]` | Aprova uma ação de alto risco pausada (nó `kind: 'approval'`) e retoma. |
 | `izanagi reject <run-id> [node-id] [--reason]` | Rejeita a ação pausada (o nó falha com o motivo) e retoma: self-healing/abort seguem normalmente. |
 | `izanagi explain <run-id>` | Por que o Izanagi decidiu isso: decisões (Decision Journal) + self-healing + veredito, sem chain-of-thought. |
-| `izanagi export --cli <cli>` | Regenera adapters multi-CLI (opencode, claude, codex, cursor, copilot, kimi, all). |
+| `izanagi export --cli <cli>` | Regenera adapters multi-CLI (opencode, claude, codex, cursor, copilot, kimi, all). Idempotente. |
 | `izanagi --version` | Exibe a versão da CLI. |
 
-### Exemplos
+CLI de nova geração (`izanagi-next`, em `packages/cli`, requer Node ≥ 22): pipeline de agentes sobre os núcleos poliglotas, com gate anti-racionalização via Rust core e auto-heal (N=2 tentativas) no run em 4 fases.
 
 ```bash
-izanagi run "Criar uma landing page de um SaaS de analytics"
-izanagi run architect --task "Design a microservices architecture"
-izanagi run "Deploy em produção" --verbose   # pausa em nós de aprovação (human-in-the-loop)
-izanagi approve <run-id>                     # aprova e retoma
-izanagi explain <run-id>                     # por que o Izanagi decidiu o que decidiu
-izanagi agent create "Especialista em Laravel" --skills=php,api
-izanagi skill create rabbitmq-orchestrator --gap="Orquestração de mensageria RabbitMQ"
-izanagi workflow inspect fullstack
-izanagi eval --metrics correctness=0.9,security=0.8
-izanagi benchmark compare
-izanagi doctor --deep
+cd packages/cli && npm install && npm run build
+node dist/cli/src/index.js run --agent=architect --task="Design a caching layer"
+node dist/cli/src/index.js agent list
+node dist/cli/src/index.js skill list --category=rust   # ou --search=<termo>
+node dist/cli/src/index.js skill show <nome> --ref=<arquivo>
+node dist/cli/src/index.js gates check <file>
 ```
 
 ---
 
-## Estrutura do Repositório
+## Skills & Agentes
 
-```
-izanagi-ai/
-├── bin/             Executável da CLI (bin/izanagi.js → dist/cli)
-├── src/             Runtime real em TypeScript (orchestrator, evaluation, resolver, scanner, factories, tools, tracer, llm, cli)
-├── core/            Engines (.md) + skill-resolver.json (aliases → targets + compositions)
-├── agents/          22 definições de agentes em JSON (fonte da verdade dos comandos)
-├── skills/          106 skills em skills/<name>/SKILL.md (+ references.md opcional)
-├── references/      Curadoria de referências reais por domínio (webgl-3d, scrollytelling, stack-2026...)
-├── .agents/memoria/ Memória persistente anti-repetição (contexto, decisoes, erros-corrigidos, learnings)
-├── .opencode/       Comandos slash do Opencode (adapters em .claude/, .codex/, .cursor/...)
-├── AGENTS.md        Instruções de operação do framework
-├── SYSTEM.md        Fundação do sistema (arquitetura real do runtime)
-└── RULES.md         Regras operacionais (Anti-Generic High-Craft & Cinematic UI)
-```
+**22 agentes especializados** (`agents/*.json`, fonte da verdade): `/discovery`, `/product-reasoner`, `/architect`, `/senior-engineer`, `/ai-engineer`, `/techlead`, `/automation-engineer`, `/security`, `/devops`, `/database`, `/qa`, `/bug-hunter`, `/docs`, `/pm`, `/professor`, `/researcher`, `/evaluator`, `/adversarial-critic`, `/form-engineer`, `/animation`, `/agent-architect`, `/skill-architect`. Cada um carrega um Agent Genome de 13 campos e chains compostas; a tabela completa com papéis está em [`AGENTS.md`](AGENTS.md).
 
----
+**Skills**: 106 módulos legado v1 (`skills/`) e o catálogo ativo **v2** (`.skills/<name>/SKILL.md`), ambos distribuídos no pacote npm. O formato v2 usa front-matter estruturado:
 
-## Agentes e Skills
+```yaml
+---
+name: "anti-ai-slop"
+description: "Detecta e corrige design 'cara de IA'..."
+version: 2.0.0
+category: design
+tools:
+  mcp:
+    - mcp:fs_read
+references:
+  - "references.md"
+---
+```
 
-O framework possui **22 agentes especializados** (`/discovery`, `/product-reasoner`, `/architect`, `/senior-engineer`, `/techlead`, `/automation-engineer`, `/security`, `/devops`, `/database`, `/qa`, `/bug-hunter`, `/docs`, `/pm`, `/professor`, `/researcher`, `/evaluator`, `/adversarial-critic`, `/form-engineer`, `/animation`, `/agent-architect`, `/skill-architect`, `/ai-engineer`) e **106 skills** encadeadas por domínio via `compositions` do `core/skill-resolver.json` (258 aliases, 16 composições). Ver `AGENTS.md` para a tabela completa.
+Seguido de seções fixas: *Triggering Criteria*, *Step-by-Step Workflow*, *Verification Steps*, *Common Rationalizations* e *Red Flags*. O consumo é por **progressive disclosure** (`skill show` carrega só o módulo necessário); skills nunca rodam isoladas — encadeiam via `compositions` do `core/skill-resolver.json` (258 aliases, 16 composições).
 
 ---
 
 ## Desenvolvimento
 
+Ordem importa: `dist/` é gitignored e `bin/izanagi.js` importa de `../dist/cli/index.js` — rode `npm run build` antes de qualquer comando CLI local (`doctor`, `polyglot status`, `export`...), senão roda código obsoleto ou quebra. O mesmo vale para `packages/*/dist`.
+
 ```bash
-npm install       # instala dependências
-npm run build     # tsc && regenera .manifest
-npm run doctor    # auditoria de integridade
-node --test dist/runtime/tests/*.test.js   # 262 testes do runtime
-npm run verify    # build + teste de instalação em sandbox
+# Legado npm (raiz)
+npm install
+npm run build       # tsc && node dist/scripts/generate-manifest.js
+npm test            # build + node --test dist/runtime/tests/*.test.js (288 testes)
+npm run verify      # build + teste de instalação em sandbox (passa todos os pack IDs)
+npm run doctor      # node bin/izanagi.js doctor [--deep]
+
+# Núcleos poliglotas
+cargo test --workspace                                        # Rust: core + mcp (111 testes)
+cargo check -p izanagi_core --features wasm                   # type-check dos bindings WASM
+(cd go-services/swarm_orchestrator && go build ./... && go vet ./... && go test ./...)
+(cd python-engine && .venv/bin/python -m pytest tests/ -q)    # 70 testes
+(cd packages/sdk && npm install && npm test)                  # 42 testes
+(cd packages/cli && npm install && npm test)                  # 13 testes
 ```
 
-> **Gotcha:** `dist/` é gitignored e `bin/izanagi.js` importa de `../dist/cli/index.js`: rode `npm run build` antes de qualquer comando CLI local.
+Requisitos por componente: Node ≥ 18 (raiz) e ≥ 22 nos pacotes novos, Rust stable, Go 1.26, Python ≥ 3.10.
 
 ### Publicando no NPM
 
+CD exclusivo de tag `v*` (`.github/workflows/publish.yml`): bump → commit → tag → push; o workflow publica com provenance OIDC (SLSA v1). Localmente, o fluxo manual permanece:
+
 ```bash
 npm run bump:patch   # ou bump:minor / bump:major
 npm publish          # prepublishOnly roda o build automaticamente
 ```
 
+CI (`.github/workflows/polyglot.yml`): 7 jobs paralelos em push/PR para `main` — legacy-npm, rust (clippy+test+wasm check), wasm-build E2E, go, python, ts-packages.
+
+---
+
+## Documentação
+
+| Documento | Conteúdo |
+|---|---|
+| [`AGENTS.md`](AGENTS.md) | Reference operacional: os 22 agentes, comandos, gotchas de desenvolvimento e release flow. |
+| [`docs/POLYGLOT.md`](docs/POLYGLOT.md) | Contratos IPC entre núcleos, error codes JSON-RPC, tabela de env vars, gaps conhecidos e resumo dos ADRs. |
+| [`ARCHITECTURE.md`](ARCHITECTURE.md) | Visão arquitetural do framework e da topologia poliglota. |
+| [`CONTRIBUTING.md`](CONTRIBUTING.md) | Guia de contribuição: convenções, fluxo de PR e padrões do repo. |
+| [`ROADMAP.md`](ROADMAP.md) | Planejamento de evolução por waves e marcos. |
+| [`SYSTEM.md`](SYSTEM.md) / [`RULES.md`](RULES.md) | Fundação do runtime e regras operacionais (Anti-Generic High-Craft & Cinematic UI). |
+| [`CHANGELOG.md`](CHANGELOG.md) | Histórico de versões. |
+
 ---
 
 ## Licença

package/ROADMAP.md

@@ -1,6 +1,6 @@
 # Roadmap
 
-> Versão atual: **3.6.0**. Estado atual e evolução planejada do **Izanagi AI: Adaptive Agent & Skill Runtime**.
+> Versão atual: **3.10.0**. Estado atual e evolução planejada do **Izanagi AI: Adaptive Agent & Skill Runtime**.
 > Legenda: ✅ Done · 🔧 In progress · 📋 Planned · 💡 Future idea
 > Histórico linha-a-linha de cada release em `CHANGELOG.md`: este arquivo resume por fase, não duplica o changelog.
 
@@ -47,7 +47,7 @@
 - [x] **Skill Security Scanner** (`src/runtime/security/`): prompt injection, instruções perigosas, scripts, permissões, requisitos de rede/fs; LOW/MEDIUM/HIGH/CRITICAL
 - [x] **Benchmarks** (`benchmarks/` + `src/runtime/benchmarks/`): 10 domínios, validators, expectativas de artefatos, `izanagi benchmark run/list/compare` com relatório comparável entre versões
 - [x] **CLI runtime**: `izanagi agent list|inspect`, `skill list|search|inspect|create`, `workflow list|inspect`, `run`, `trace`, `eval`, `benchmark`, `memory inspect|search`, `doctor --deep`, `diagnose`
-- [x] **Docotr expandido**: valida system/agents/skills/resolver/memória/providers/tools/contratos/avaliação/benchmarks
+- [x] **Doctor expandido**: valida system/agents/skills/resolver/memória/providers/tools/contratos/avaliação/benchmarks
 - [x] Testes node:test cobrindo resolver, scoring, contracts, evaluation, graph, parallel, retry, healing, memory, handoff, factories, model routing, CLI, tracer, scanner, tools, benchmarks, orchestrator
 
 ## Fase 4: Evolução v2.11 (🔧 / 📋)

package/RULES.md

@@ -1,6 +1,6 @@
 # IZANAGI AI: Operating Rules
 
-> Version 3.6.0
+> Version 3.10.0
 
 ---
 
@@ -87,6 +87,16 @@ Regras obrigatórias de autonomia e execução:
 - **Autonomia de ponta a ponta:** Execute a tarefa até a conclusão total (planejamento → instalação de deps → código completo → build e verificação), sem parar pela metade ou exigir intervenção manual desnecessária.
 - **Execução proativa de comandos:** Sempre que houver comandos utilitários, de build, teste ou instalação necessários para o sucesso da tarefa, execute-os autonomamente.
 
+### 2.6 Zero-Waste Execution (Tools & Edits)
+
+Diretrizes de desperdício-zero ao executar e editar; detalhamento completo na skill `economia-tokens` (Fluxo Zero-Waste + Pilares 4 e 6):
+
+- **Silenciamento de ferramentas:** prefira flags quiet em comandos cuja saída bruta não será lida integralmente (`--quiet`/`--silent`/`-s`, `pytest -q --tb=short`, `cargo build 2>&1 | tail -n 20`, `git log --oneline -n 5`).
+- **Geração orientada a DIFF:** proibido reescrever arquivo inteiro para mudança pontual; use edição cirúrgica/unified diff ("Edit by diff", seção 2.4). Rewrite integral só quando a maioria do arquivo muda.
+- **Observation hygiene:** resuma outputs longos antes de reportar ou manter em contexto (grep da falha, `--stat`, `| tail`); nunca cole dumps integrais no contexto nem na resposta.
+
+## 3. Skills
+
 ### 3.1 Skill Declaration
 
 Every skill file must contain:

package/SYSTEM.md

@@ -1,6 +1,6 @@
 # IZANAGI AI: System Foundation
 
-> Version 3.6.0
+> Version 3.10.0
 > Codename: "The Architect's Mind"
 
 ---
@@ -63,7 +63,7 @@ User Input / Comando CLI
 └─────────────┬──────────────┘
               ▼
 ┌────────────────────────────┐
-│  Memory & Observability    │ ← MemoryStore (JSON), TraceStore (JSONL),
+│  Memory & Observability    │ ← MemoryStore (JSON), TraceStore (JSON por run),
 │                            │   .agents/memoria/ persistente
 └─────────────┬──────────────┘
               ▼
@@ -87,7 +87,7 @@ User Input / Comando CLI
 | **Healing Engine** | `retry` (transitório), `skill_replacement` (artefato inválido), `fallback`, `abort` (limite de tentativas). |
 | **Failure Memory** (`memory/store.ts`) | `recordFailure` + `findRelevantFailures` por categoria: erros reais registrados são injetados como evidência em runs futuros (anti-repetição). |
 | **Memory Store** (`memory/store.ts`) | Stats por agente, learnings, histórico de runs (JSON em disco). |
-| **Trace Store** (`observability/tracer.ts`) | Traces de execução em JSONL com spans, load/close e retry de escrita. |
+| **Trace Store** (`observability/tracer.ts`) | Traces de execução em JSON (um arquivo por run em `.izanagi/state/traces/`) com spans, load/close e retry de escrita. |
 | **Benchmarks** (`benchmarks/`) | 10 casos builtin (parse, scoring, scanner, genome, composer...) executáveis via `izanagi benchmark` + `compare` entre builds. |
 | **LLM Executor** (`llm/`) | Adapters reais OpenAI/Anthropic/Google com env key, timeout e propagação de erro HTTP. |
 | **Evidence System** (`research/evidence.ts`) | Claims FACT/ASSUMPTION/INFERENCE/UNKNOWN com fonte, confiança e hierarquia de sourceType (official docs > source code > tests > package metadata > reliable tech > community); relatório de claims críticas. ⚠️ Implementado e testado, mas **nenhum caller em produção** hoje: nem `Orchestrator` nem `planner.ts` o invocam; só o próprio teste do módulo o exercita. Roadmap: ligar à execução do agente `researcher`. |
@@ -123,7 +123,7 @@ Não há "compression engine" mágico: a economia de tokens é uma **skill opera
 
 ## Quality Gates: Every Output
 
-Todo output passa por gates reais antes de ser considerado entregue:
+Todo output passa por gates reais antes de ser considerado entregue (os heurísticos anti-slop/anti-racionalização também rodam como engine Rust em `crates/izanagi_core`: contratos e integração em `docs/POLYGLOT.md`):
 
 1. ✅ **Security Gate**: sem segredos no código; `skill-scanner` varre skills por injeção, comandos destrutivos, exfiltração e hardcode (11 regras), ignorando contexto defensivo/educativo.
 2. ✅ **Validation Gate**: artefatos validados contra schema (campos obrigatórios + tamanho mínimo); inválido → healing `skill_replacement`.
@@ -141,7 +141,7 @@ Todo output passa por gates reais antes de ser considerado entregue:
 │  ┌──────────┐  ┌──────────┐  ┌──────────┐ │
 │  │ Agent    │  │Learnings │  │  Runs/   │ │
 │  │ Stats    │  │ (erros   │  │  Trace   │ │
-│  │ (JSON)   │  │  evitados)│  │ (JSONL)  │ │
+│  │ (JSON)   │  │  evitados)│  │ (JSON)   │ │
 │  └──────────┘  └──────────┘  └──────────┘ │
 │       └──────────────┬──────────────────┘ │
 │                      ▼                    │
@@ -153,7 +153,7 @@ Todo output passa por gates reais antes de ser considerado entregue:
 └────────────────────────────────────────────┘
 ```
 
-Memória entre sessões vive em `.agents/memoria/` (markdown curado). Memória de execução (stats, traces, learnings) vive no runtime (JSON/JSONL): consulte `MemoryStore` e `TraceStore`.
+Memória entre sessões vive em `.agents/memoria/` (markdown curado). Memória de execução (stats, traces, learnings) vive no runtime (JSON em disco): consulte `MemoryStore` e `TraceStore`.
 
 ## Evolution Cycle
 

package/core/decision-engine.md

@@ -167,9 +167,6 @@ explain:
   budget: 1200
   quality_gates: [clarity, completeness]
 
-
-  quality_gates: [security, completeness]
-
 plan:
   chain:
     - core/planning-engine

package/core/quality-gates.md

@@ -9,7 +9,7 @@
 
 ## Identity
 
-Quality Gates are the final validation layer before any output is delivered to the user. Every response passes through 5 gates: Security, Style, Clarity, Conciseness, and Completeness. If any gate fails, the output is rejected and reworked.
+Quality Gates are the final validation layer before any output is delivered to the user. Every response passes through 6 gates: Security, Style, Clarity, Conciseness, Completeness, and Masterpiece (Gate 6). If any fatal gate fails, the output is rejected and reworked. Os heurísticos anti-slop/anti-racionalização também existem como engine Rust runtime (`crates/izanagi_core`) — contratos e integração em `docs/POLYGLOT.md`.
 
 ---
 
@@ -210,7 +210,7 @@ quality_result:
 
 ### Always
 
-- ✅ Run all 5 gates on every output.
+- ✅ Run all 6 gates on every output.
 - ✅ Block output on security gate failure.
 - ✅ Log gate results for Reflection Engine.
 - ✅ Fix style issues automatically when possible.

package/dist/cli/commands/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/run.ts"],"names":[],"mappings":"AA0DA,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CA2D7D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAY9E;AAkBD,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8K/E;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,GAAG,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,qGAAqG;IACrG,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,OAAO,CAAC,IAAI,CAAC,CA4Ff;AA8BD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,CAYnE"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/run.ts"],"names":[],"mappings":"AA2DA,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CA2D7D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAY9E;AAmBD,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoL/E;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,GAAG,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,qGAAqG;IACrG,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,OAAO,CAAC,IAAI,CAAC,CA4Ff;AA+BD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,CAYnE"}