izanagi-ai 3.9.0 → 3.10.1

package/.codex/instructions.md

@@ -47,4 +47,4 @@
 - `.opencode/agent/*.md`: integração com opencode (compatível com Kimi CLI)
 
 ---
-Gerado pelo Izanagi AI em `C:\Users\pedro.leal\Documents\NexusAI`: `izanagi export --cli codex`
+Gerado pelo Izanagi AI: `izanagi export --cli codex`

package/.github/copilot-instructions.md

@@ -47,4 +47,4 @@
 Definições completas em `agents/*.json` e skills em `skills/<name>/SKILL.md`.
 
 ---
-Gerado pelo Izanagi AI em `C:\Users\pedro.leal\Documents\NexusAI`: `izanagi export --cli copilot`
+Gerado pelo Izanagi AI: `izanagi export --cli copilot`

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:
@@ -42,6 +42,21 @@
 #
 # 4) PARIDADE DE RUNTIME: Node 24 (igual dev local e igual Polyglot CI,
 #    onde o job legacy-npm validou ci/build/test no 24). O 20.x era drift.
+#
+# 5) PROVENANCE OIDC DO NPM (Wave 5 - frente C, 2026-08-23):
+#    `npm publish --provenance` anexa uma declaração de proveniência SLSA
+#    assinada via keyless Sigstore ao pacote, provando que o artefato foi
+#    construído NESTE workflow, NESTE repo, a partir da tag publicada.
+#    - Permissão `id-token: write` declarada APENAS no job publish (least
+#      privilege): build-and-verify não publica e não deve mintar OIDC.
+#      Bloco de permissions de job SOBRESCREVE o global, por isso
+#      contents:read é redeclarado nele.
+#    - Direção de falha segura (fail-closed): se o token OIDC/provenance
+#      falhar, o npm ABORTA o publish antes do upload - nunca há pacote
+#      publicado sem provenance silenciosamente.
+#    Pré-requisitos conferidos: npm >=9.5 (Node 24 => npm 11.x), registry
+#      npmjs.org, campo repository do package.json = este repo, evento
+#      push tag/release suportado.
 # =============================================================================
 
 name: Publish to NPM
@@ -62,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
@@ -81,12 +96,20 @@ jobs:
     needs: build-and-verify
     runs-on: ubuntu-latest
     timeout-minutes: 10
+    # Least privilege no nível de JOB (não global): id-token:write é exigido
+    # pelo provenance OIDC do npm e vale só aqui. Este bloco SOBRESCREVE o
+    # permissions do topo do workflow para este job - por isso contents:read
+    # é redeclarado (checkout continua funcionando). build-and-verify segue
+    # herdando apenas contents:read do escopo global.
+    permissions:
+      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
@@ -112,6 +135,8 @@ jobs:
           fi
       - name: Publish (only if version is new)
         if: steps.version_guard.outputs.already_published == 'false'
-        run: npm publish --access public
+        # --provenance: exige id-token:write (acima). Fail-closed: sem OIDC
+        # válido o npm aborta ANTES do upload - nunca publica sem assinatura.
+        run: npm publish --access public --provenance
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.kimi/README.md

@@ -23,4 +23,4 @@ O **Kimi CLI** é compatível com a convenção do opencode: ele lê `AGENTS.md`
 - **Sempre**: IaC versionado; monitoramento desde o dia 1; secrets por ferramenta própria.
 - **Nunca**: commit `.env`; container root; deploy sem CI; hardcode de config de ambiente.
 
-> Gerado pelo Izanagi AI em `C:\Users\pedro.leal\Documents\NexusAI`: `izanagi export --cli kimi`
+> Gerado pelo Izanagi AI: `izanagi export --cli kimi`

package/.manifest

@@ -1,11 +1,11 @@
 {
   "name": "izanagi-ai",
-  "version": "3.9.0",
+  "version": "3.10.1",
   "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-23T05:32:21.270Z",
+  "generatedAt": "2026-08-23T18:46:09.377Z",
   "agents": [
     {
       "id": "adversarial-critic",

package/AGENTS.md

@@ -1,6 +1,6 @@
 # AGENTS.md: Izanagi AI Framework Reference
 
-> Version 3.6.0
+> Version 3.9.0
 > Modular Skill-Oriented AI Prompt & Agent Framework for Autonomous Software Engineering
 > Multi-CLI: Opencode · Claude Code · Codex · Cursor · Copilot · Kimi (Smart Auto-Detection & Selective Generation)
 
@@ -8,7 +8,7 @@
 
 ## 1. Visão Geral do Framework
 
-Izanagi AI é um **framework meta** para engenharia de software autônoma orientada a agentes: arquitetura em camadas (Routing → Orchestration → Evaluation → Healing → Memory), biblioteca de skills especializadas, **Skill Composer** (16 composições de skills encadeadas por domínio), **22 agentes especializados core + gerados**, **Memória Persistente Anti-Repetição** (`.agents/memoria/`), **Curadoria de Referências** (`references/`), **Checkpoint & Self-Healing Swarm Engine**, e uma **CLI executável (`izanagi`)** publicada no npm (`izanagi-ai`). Este repositório É o framework (não um app que o usa).
+Izanagi AI é um **framework meta** para engenharia de software autônoma orientada a agentes: arquitetura em camadas (Routing → Orchestration → Evaluation → Healing → Memory), biblioteca de skills especializadas (catálogo v2 em `.skills/` convivendo com o legado `skills/`), **Skill Composer** (16 composições de skills encadeadas por domínio), **22 agentes especializados core + gerados**, **Memória Persistente Anti-Repetição** (`.agents/memoria/`), **Curadoria de Referências** (`references/`), **Checkpoint & Self-Healing Swarm Engine**, uma **CLI executável (`izanagi`)** publicada no npm (`izanagi-ai`) e uma **topologia poliglota** (Rust · Go · Python · TS — seção 3). Este repositório É o framework (não um app que o usa).
 
 ---
 
@@ -46,40 +46,84 @@ O framework conta com **22 agentes especializados** em `agents/*.json` + orquest
 
 ---
 
-## 3. Comandos de Desenvolvimento (ordem importa)
+## 3. Arquitetura Poliglota (Waves 1–4)
+
+Coexistência **Strangler Fig** (ADR-001): o legado npm (`src/`, CLI `izanagi`) permanece intocado e publicável; o crescimento novo vive num SDK TypeScript + 4 núcleos nativos, orquestrados pela CLI de nova geração (`packages/cli`, binário `izanagi-next`). Referência canônica de contratos IPC, error codes (`-32001..-32005`), env vars e ADRs: **`docs/POLYGLOT.md`** (ADRs integrais em `.agents/memoria/decisoes.md`, gitignored).
+
+| Componente | Linguagem | Responsabilidade | 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` (`--file=<path>` / `--stdin`, exit 0/1/2); bindings WASM feature-gated (`--features wasm`, subcomandos `--version`/`--help`) | `cargo test --workspace` (111 testes) · `cargo check -p izanagi_core --features wasm` |
+| `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 | `(cd go-services/swarm_orchestrator && 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) | `(cd python-engine && .venv/bin/python -m pytest tests/ -q)` (70 testes) |
+| `packages/sdk` | TypeScript | `@izanagi/sdk`: clientes tipados strict para os 4 núcleos + catálogo de skills; zero deps runtime | `(cd packages/sdk && npm install && npm test)` |
+| `packages/cli` | TypeScript | Binário `izanagi-next`: run em 4 fases com auto-heal (N=2), `agent list`, `skill list`, `gates check`; exit codes próprios (0 ok · 1 gate/falha · 2 uso · 3 ambiente) | smoke manual (`help`, `agent list`) — suíte própria pendente |
+| `packages/skill-migrator` · `agent-migrator` | Node ESM | Migradores determinísticos idempotentes: skills v1→v2 (106 módulos) e agents JSON→YAML (22) — ADR-004/005 | `node packages/agent-migrator/cli.mjs --check` · `node packages/skill-migrator/cli.mjs --dry-run` |
+
+**Gotchas poliglotas:**
+- Socket do orquestrador tem defaults divergentes por lado: servidor Go `/tmp/izanagi-orch.sock` (env `IZANAGI_ORCHESTRATOR_SOCK`) × SDK TS `/tmp/izanagi-swarm.sock` (env `IZANAGI_ORCHESTRATOR_SOCKET`). Case os dois via env antes de integrar (tabela completa em `docs/POLYGLOT.md`).
+- Testes do SDK/CLI NUNCA via strip-types direto sobre `.ts`: use o build próprio de cada pacote (`npm test` dentro de `packages/sdk`).
+- `Cargo.lock` é commitado (pins exatos, ex.: wasm-bindgen); build `.wasm` real só existe no job CI `wasm-build`.
+
+---
+
+## 4. Comandos de Desenvolvimento (ordem importa)
 
 ```
+# Legado npm (raiz)
 npm install          # instala deps
 npm run build        # tsc && node dist/scripts/generate-manifest.js
-npm test             # build + node --test dist/runtime/tests/*.test.js (262 testes)
+npm test             # build + node --test dist/runtime/tests/*.test.js (284 testes)
 npm run verify       # build + teste de instalação em sandbox (passa todos os pack IDs)
-npm run doctor       # node bin/izanagi.js doctor: auditoria de integridade
+npm run doctor       # node bin/izanagi.js doctor [--deep]: auditoria de integridade
 npm run bump:patch   # npm version patch --no-git-tag-version (também minor/major)
 npm publish          # prepublishOnly roda build; depois: git push
+
+# Núcleos poliglotas
+cargo build --workspace                       # Rust: bins izanagi-core / izanagi-mcp em target/debug/
+cargo test --workspace                        # 111 testes (core + mcp)
+cargo check -p izanagi_core --features wasm   # type-check dos bindings WASM (ADR-003)
+(cd go-services/swarm_orchestrator && go build ./... && go vet ./... && go test ./...)
+(cd python-engine && .venv/bin/python -m pip install -r requirements-dev.txt && .venv/bin/python -m pytest tests/ -q)
+(cd packages/sdk && npm install && npm test)
+(cd packages/cli && npm install && npm run build)
+
+# Diagnóstico & catálogos v2
+node bin/izanagi.js polyglot status [--json|--strict]   # saúde dos 7 componentes poliglotas (--strict sai 1 se algo ausente)
+node packages/agent-migrator/cli.mjs --check            # drift YAML ↔ JSON (exit 0 sincronia / 1 drift / 2 uso)
+node packages/skill-migrator/cli.mjs --dry-run          # valida migração skills v2 sem escrever
 ```
 
 **Gotchas críticos:**
-- `dist/` é gitignored e `bin/izanagi.js` importa de `../dist/cli/index.js`: **rode `npm run build` antes de qualquer comando CLI local**, senão roda código obsoleto ou quebra.
-- `doctor` valida: SYSTEM.md/RULES.md, JSONs de agentes e aliases do resolver → targets.
-- Há test runner real (`node:test`, 165 testes em `src/runtime/tests/`). Verificação = `npm test` + `npm run verify` + `npm run doctor`.
+- `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`: rode o build do package antes de consumir SDK/CLI-next.
+- `doctor`: instalação completa do usuário = `.agents/agents/` contendo agentes em **JSON** (formato distribuído); os YAMLs derivados do repo-fonte não caracterizam instalação.
+- Há test runner real (`node:test`, 284 testes em `src/runtime/tests/`). Verificação = `npm test` + `npm run verify` + `npm run doctor` + suítes poliglotas da seção 3.
 - Padrão de commit do repo: `chore: bump to vX.Y.Z` para bumps e `feat:`/`fix:`/`docs:` descritivos em PT-BR para mudanças.
 
 ---
 
-## 4. Estrutura do Framework
+## 5. Estrutura do Framework
 
+**Legado (fonte canônica de agentes e skills):**
 - `core/`: 14 engines (.md, incluindo `skill-composer.md`, `checkpoint-healing-engine.md`, `quality-gates.md`) + **`skill-resolver.json`** (mapa alias → target, 258 aliases, 16 `compositions`)
-- `agents/`: Definições de agentes em JSON (fonte da verdade para os comandos) com `chains` compostas e Agent Genome (13 campos)
-- `skills/`: 106 skills em `skills/<name>/SKILL.md` (+ `references.md` opcional), incluindo `design-directions` (Style Selector por indústria), `ui-ux-pro-max` (design system com motor BM25 offline em Node) e `anti-ai-slop` (auditoria zero "cara de IA")
+- `agents/`: 22 definições de agentes em JSON (fonte da verdade para os comandos) com `chains` compostas e Agent Genome (13 campos); derivados YAML em `.agents/agents/*.yaml` gerados pelo agent-migrator — proibido editar YAML à mão
+- `skills/`: legado histórico v1 (fonte do migrador). Catálogo ativo **v2**: `.skills/<name>/SKILL.md` (106 módulos; front-matter `name/description/version/category/tools.mcp` + seções Triggering Criteria / Step-by-Step Workflow / Verification Steps / Common Rationalizations / Red Flags; subpastas `references/`)
 - `references/`: curadoria de referências reais por domínio (webgl-3d, scrollytelling, ui-design-systems, stack-2026, performance-seo)
-- `.agents/memoria/`: memória persistente anti-repetição: `contexto.md`, `decisoes.md`, `erros-corrigidos.md`, `learnings.md`
+- `.agents/memoria/`: memória persistente anti-repetição (**gitignored**, só existe local): `contexto.md`, `decisoes.md` (ADRs), `erros-corrigidos.md`, `learnings.md`
 - `.opencode/agent/`: comandos slash do Opencode/Kimi CLI, gerados sob demanda a partir de `agents/*.json` (`izanagi export --cli opencode`), junto dos adapters de `.claude/`, `.codex/`, `.cursor/`, `.github/`, `.kimi/`
-- `src/`: CLI TypeScript (entrypoint: `src/cli/index.ts` → `runCLI`; multi-CLI export: `src/exporters.ts`)
+- `src/`: CLI TypeScript (entrypoint: `src/cli/index.ts` → `runCLI`; multi-CLI export: `src/exporters.ts`; diagnóstico poliglota: `src/cli/commands/polyglot.ts`)
 - `SYSTEM.md` & `RULES.md`: fundação e regras operacionais (Anti-Generic High-Craft, Masterpiece Gate & Cinematic UI)
 
+**Poliglota (crescimento novo):**
+- `crates/`: workspace Rust na raiz — `izanagi_core` (quality engine + bindings WASM feature-gated), `izanagi_mcp` (cliente MCP stdio); `Cargo.lock` commitado
+- `go-services/swarm_orchestrator/`: orquestrador Go (Uber Fx, JSON-RPC 2.0 sobre UDS, event push, artefatos por estágio)
+- `python-engine/`: analisador AST multilíngue (tree-sitter + fallback, ~70 testes, venv em `.venv/`)
+- `packages/`: `sdk` (`@izanagi/sdk`), `cli` (binário `izanagi-next`), `skill-migrator`, `agent-migrator` — todos `private`
+- `docs/POLYGLOT.md`: referência canônica da topologia poliglota (contratos IPC, tabela de env vars, gaps conhecidos, resumo dos ADRs)
+
 ---
 
-## 5. Regras de Execução, Autonomia & Masterpiece Gate
+## 6. Regras de Execução, Autonomia & Masterpiece Gate
 
 - **Estudo Antes de Codar (Study-First):** toda tarefa começa (1) carregando `.agents/memoria/contexto.md` (sempre) + só os arquivos de `.agents/memoria/` (`decisoes.md`, `erros-corrigidos.md`, `learnings.md`) do domínio da tarefa (cada agente nativo em `.claude/agents/*.md` já aponta pra sua fatia relevante, não é preciso reler os quatro por hábito), (2) consultando `references/` e/ou `deep-research` quando a tarefa exigir informação externa, e só então (3) arquitetar e implementar. Nunca programe no escuro, mas também nunca recarregue contexto irrelevante.
 - **Lei da Fidelidade Absoluta a Referências (Anti-Rush):** Quando solicitado clonagem, inspiração ou replicação de uma referência visual/técnica (ex: `igloo.inc`), os agentes têm **estritamente proibido** retornar respostas apressadas ou fingir estudo superficial. É obrigatório decompor rigorosamente a estrutura, tipografia, grid, animações e micro-interações da referência e entregar uma obra de excelência artesanal (*High-Craft*) idêntica ou superior.
@@ -97,7 +141,7 @@ npm publish          # prepublishOnly roda build; depois: git push
 
 ---
 
-## 6. Padrão Anti-Generic / High-Craft & Cinematic UI
+## 7. Padrão Anti-Generic / High-Craft & Cinematic UI
 
 Proibido entregar código/design genérico "cara de IA" (templates óbvios, fundos cinzas chapados, cards repetitivos, sem animação).
 - **Obrigatório:** Estética Apple-like / Awwwards-grade (`bg-zinc-950`, glassmorphism, bento grids, tipografia precisa, scrollytelling e micro-interações).
@@ -105,7 +149,7 @@ Proibido entregar código/design genérico "cara de IA" (templates óbvios, fund
 
 ---
 
-## 7. Multi-CLI Compatibility & Smart Detection
+## 8. Multi-CLI Compatibility & Smart Detection
 
 O framework funciona em qualquer CLI de IA que leia `AGENTS.md` e possui adapters gerados:
 
@@ -123,7 +167,11 @@ O framework funciona em qualquer CLI de IA que leia `AGENTS.md` e possui adapter
 
 ---
 
-## 8. Release Flow (resumo)
+## 9. Release Flow & CI/CD (resumo)
+
+**CI — `.github/workflows/polyglot.yml`** (push/PR em `main`; jobs 100% paralelos, fail-fast global, actions fixadas por SHA): `legacy-npm` (build+test) · `rust` (clippy + test + check wasm) · `wasm-build` (`.wasm` E2E, ADR-003) · `go` (build/vet/test) · `python` (pytest com pins) · `ts-packages` (sdk test + cli build).
+
+**CD — `.github/workflows/publish.yml`**: exclusivo de tag `v*`/release; guard idempotente; least privilege. Pacotes poliglotas (`@izanagi/sdk`, `@izanagi/cli-next`) são `private` — só o legado npm publica (whitelist `files` não inclui `crates/`, `go-services/`, `python-engine/`, `packages/`, por decisão deliberada).
 
 1. `npm run bump:patch` (ou minor/major): bumpa `package.json`/`package-lock.json`
 2. `npm run build`: recompila + regenera `.manifest`

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/CLAUDE.md

@@ -78,4 +78,4 @@ Todas as 106 skills da biblioteca (`skills/<name>/SKILL.md`) foram exportadas fi
 > Regras específicas de cada agente (always/never) vivem em `.claude/agents/<slug>.md`: lidas sob demanda só quando aquele agente é ativado, não duplicadas aqui.
 
 ---
-Gerado pelo Izanagi AI em `C:\Users\pedro.leal\Documents\NexusAI`: `izanagi export --cli claude`
+Gerado pelo Izanagi AI: `izanagi export --cli claude`