oxe-cc 1.14.0 → 1.16.0

package/CHANGELOG.md

@@ -1,779 +1,866 @@
-# Changelog — OXE CLI (`oxe-cc`)
-
-Todas as versões seguem [Semantic Versioning](https://semver.org/). As mudanças mais recentes aparecem primeiro.
-
----
-
-## [1.14.0] — 2026-05-30
-
-### Contratos de integração para hosts — reatividade + dashboard embutível
-
-Aditivo — nenhum contrato existente muda. Complementa o 1.13.0 (`status --json --summary`, `agentSkills`) para hosts como o OXESpace embutirem o oxe-cc de forma reativa e visual.
-
-- **`oxe events --tail [N] --json [--since <evt_id>] [--session <s>]`** — projeção read-only e versionada (`oxeEventsSchema: 1`) do log append-only `.oxe/OXE-EVENTS.ndjson`: `{ summary: { total, byType, lastEvent }, events: [...] }`. `--since` devolve só os eventos novos desde um `event_id` conhecido (leitura incremental). Reusa `operational.readEvents`/`summarizeEvents`. Um host normalmente observa o arquivo e chama `status --json --summary`; este comando é a forma documentada de ler o tail sem reparsear tudo.
-- **`oxe dashboard --json`** — emite **uma linha** estável e versionada (`oxeDashboardSchema: 1`) com `{ url, port, readOnly, projectRoot }` assim que o servidor sobe, e **continua servindo**. Permite a um host capturar URL/porta de forma robusta e embutir o dashboard num webview, em vez de raspar o banner humano. Combine com `--no-open --port 0` para porta efêmera.
-- **`dashboard --port 0`** agora seleciona uma porta efêmera de verdade (antes caía no default `4173`).
-- **`docs/INTEGRATION.md`** — contrato estável para hosts: `status --json --summary`, `agentSkills`, schema do `OXE-EVENTS.ndjson`, `events --json` e `dashboard --json`; marca o que é estável vs experimental.
-
----
-
-## [1.13.0] — 2026-05-29
-
-### Contratos de integração para hosts (IDEs, OXESpace)
-
-Aditivo — nenhum contrato existente muda. Facilita hosts consumirem o oxe-cc.
-
-- **`oxe status --json --summary`** — projeção compacta e versionada (`oxeSummarySchema: 1`) com `workspaceMode, phase, healthStatus, activeSession, nextStep, cursorCmd, reason, eventsCount, warningsCount` + um `agentSkills` compacto. Troca ~150KB do status completo por <1KB para o "glance" que um host precisa.
-- **`agentSkills` no `status --json`** e **`agentSkillsReport(target)` no SDK** (`health.agentSkillsReport`) — status das skills `/oxe-*` por agente no workspace (`copilot-vscode`, `codex`, `copilot-cli`): `detected/skillsInstalled/skillsPath/status/issues`. Permite a um host detectar skills ausentes e oferecer instalação **antes** de lançar o agente (resolve o "Failed to load N skills").
-- **SDK**: `health.buildStatusSummary(report)` e `health.agentSkillsReport(target)` exportados + tipados em `lib/sdk/index.d.ts`.
-
----
-
-## [1.12.0] — 2026-05-12
-
-### Agent Mode, Swarm Mode, Memory Kernel & Learning Kernel
-
-Esta release transforma o OXE em um sistema autônomo orientado a objetivos. O usuário escreve `/oxe <objetivo em linguagem natural>` e o Conductor decide automaticamente o fluxo, os agentes e a estratégia de execução — sem precisar escolher comandos manualmente.
-
-#### Conductor Agent (`oxe/workflows/conduct.md`)
-
-- novo workflow que age como ponto de entrada para objetivos de implementação em linguagem natural
-- classifica complexidade em três scores: simples | médio | complexo
-- recupera memória relevante das 5 camadas (runtime_state, session_memory, project_memory, lessons, observations)
-- seleciona personas aplicáveis por `intent_tags` (backend → executor/architect, frontend → ui-specialist, storage → db-specialist, etc.)
-- decide automaticamente **Agent Mode** (simples/médio) ou **Swarm Mode** (complexo/multi-domínio)
-- `oxe/workflows/oxe.md` e `route.md` atualizados: objetivos de implementação redirecionam para `conduct.md`
-
-#### Agent Mode (`oxe/workflows/agent-mode.md`)
-
-- Conductor age sozinho com a persona selecionada para objetivos de 1–2 domínios e ≤ 8 arquivos
-- grava `AGENT-SESSION.json` em `.oxe/agent/` com intent, skills, tool_calls e reconciliação
-- discovery mínimo antes de mutar: confirma write_set, padrões, riscos
-- se write_set exceder threshold para `intent_score=simples`, eleva automaticamente para Swarm Mode
-- `RECONCILIATION.md` gerado ao final com arquivos alterados e objective_satisfied
-
-#### Swarm Mode (`oxe/workflows/swarm-mode.md`)
-
-- orquestração de 5 papéis em pipeline controlado: Scout → Coordinator → Builder(s) → Reviewer → Verifier
-- **Scout** (`oxe/workflows/swarm/scout.md`): produz CODEBASE-MAP.md, PATTERNS.md, RISK-MAP.md, FILE-CANDIDATES.json e TEST-CANDIDATES.json antes de qualquer mutação
-- **File Ownership** (`FILE-OWNERSHIP.json`): cada Builder declara `write_set`; conflitos → Coordinator serializa em waves sequenciais
-- **Board** (`oxe/workflows/swarm/board.md`): BOARD.md e BOARD.json atualizados em tempo real por fase
-- **Quality Gates** automáticos: arquivo high-risk → gate humano; cobertura abaixo de threshold → gate auto
-- **Reviewer**: produz `.oxe/swarm/reviews/<task_id>-REVIEW.md` por tarefa antes de integração
-- **Verifier/Integrator**: FINAL-INTEGRATION.md com evidências completas e VERIFY.md atualizado
-- novo schema `oxe/schemas/swarm-run.schema.json` (JSON Schema Draft-07) para SWARM-RUN.json
-
-#### Memory Kernel (`oxe/workflows/memory.md` + `bin/lib/oxe-memory-kernel.cjs`)
-
-- ativa o modelo de 4 camadas de memória já definido em `oxe-operational.cjs:2364`
-- `retrieveMemory(projectRoot, intentTags, phase, objective)`: filtra fragmentos por relevância e phase; ranking por score (tag match, impacto, frequência)
-- `saveContextPack()`: grava context pack em `.oxe/agent/MEMORY-INJECTIONS.md` ou `.oxe/swarm/DECISIONS.md` + snapshot auditável em `.oxe/memory/retrieved/<phase>.md`
-- novos templates: `REPO-MEMORY.template.md` (decisões cross-session, pitfalls, preferências, padrões validados) e `MEMORY-INDEX.template.json`
-
-#### Learning Kernel (`oxe/workflows/distill.md` + `bin/lib/oxe-learning-kernel.cjs`)
-
-- detecta padrões automaticamente ao final de cada run: blocker_pattern, success_pattern, anti_pattern, file_conflict_pattern, integration_gap, scope_expansion
-- atualiza `LESSONS.md` com dedup correto (Frequência++ para lições repetidas, não duplicatas)
-- popula `lessons-metrics.json` com `outcomes` e `success_rate` por lição; deprecação automática se `success_rate < 0.5` e `apply_count >= 3`
-- enfileira skill candidatas em `.oxe/learning/PROMOTION-QUEUE.md` quando padrão aparece em 2+ runs
-- atualiza `REPO-MEMORY.md` com decisões arquiteturais e pitfalls novos
-
-#### Skill Runtime (`bin/lib/oxe-skill-loader.cjs`)
-
-- `loadSkill(id, projectRoot)`: resolve por ordem de precedência projeto → capabilities → global
-- `listSkills()`: enumera active/proposed/archived/global por diretório
-- `selectPersonasForIntent(intentTags, projectRoot)`: mapeia intent_tags para personas primárias e secundárias
-- `recordSkillsLoaded()`: grava snapshot das personas ativas em `.oxe/agent/SKILLS-LOADED.json`
-
-#### Event Bus (`bin/lib/oxe-event-bus.cjs`)
-
-- `OXE-EVENTS.ndjson` passa a ser efetivamente populado durante runs (antes: schema definido, nunca emitido)
-- helpers tipados: `emitRunStarted`, `emitWorkItemCompleted`, `emitWorkItemBlocked`, `emitRunCompleted`, `emitGateRequested`, `emitGateResolved`, `emitLessonPromoted`, `emitRetroPublished`
-- `readEvents(projectRoot, filters)`: leitura com filtro por `run_id`, `type`, `since`
-
-#### Runtime contracts
-
-- `workflow-runtime-contracts.json` atualizado com contratos semânticos para todos os 5 novos workflows (conduct, agent-mode, swarm-mode, memory, distill)
-- `help.md` router: nova entrada de prioridade máxima para objetivos de implementação → `/oxe <objetivo>` → Conductor
-
-#### Templates adicionados
-
-- `.oxe/templates/AGENT-SESSION.template.json`
-- `.oxe/templates/swarm/SWARM-RUN.template.json`
-- `.oxe/templates/swarm/FILE-OWNERSHIP.template.json`
-- `.oxe/templates/swarm/BOARD.template.md`
-- `.oxe/templates/swarm/QUALITY-GATES.template.md`
-- `.oxe/templates/REPO-MEMORY.template.md`
-- `.oxe/templates/MEMORY-INDEX.template.json`
-- `.oxe/templates/learning/CANDIDATES.template.ndjson`
-- `.oxe/templates/learning/PROMOTION-QUEUE.template.md`
-
----
-
-## [1.11.0] — 2026-05-06
-
-### Spec Lifecycle Automation & CLI Gaps
-
-Esta release fecha os gaps de adoção identificados na análise de maturidade v1.10.0, com foco em automação do ciclo de vida do SPEC, configuração de provider e tolerância de formato no parser de planos.
-
-#### Automação do ciclo de vida (SPEC.md)
-
-- nova função `applySpecChecklistSync` em `oxe-operational.cjs`: ao executar `runtime project` com um run `completed`, marca automaticamente `**DoD Wave N:**` e seções MVP/v0.x.x do checklist no `SPEC.md` com `[x]`
-- v1.0.0 checklist não é marcado automaticamente — requer sign-off explícito
-- exportada no módulo para testes de integração e uso programático
-
-#### CLI — `runtime execute`
-
-- novo flag `--agents-plan <path>`: override explícito para localização do `plan-agents.json`, com prioridade sobre detecção automática por sessão e raiz do projeto
-- novo flag `--api-key-env <VAR>`: lê API key de variável de ambiente nomeada em vez de `OXE_LLM_API_KEY`
-- novo subcomando `runtime configure`: wizard interativo que persiste `baseUrl`, `model`, `apiKey` em `.oxe/config.json` (seção `runtime.provider`)
-
-#### Provider LLM auto-wired
-
-- `createExecutionContext` passa a instanciar `PolicyEngine.fromConfigFile()` automaticamente quando `.oxe/config.json` contém seção `runtime.policy`
-- `loadRuntimeProviderConfig` / `saveRuntimeProviderConfig` exportados de `oxe-operational.cjs`
-- health checks de `runtime.provider` e `runtime.policy` adicionados ao `oxe-cc status`
-
-#### Parser de planos — tolerância de formato (Gap E)
-
-- `parsePlan` agora aceita `**Verificação:**`, `**Verify command:**` e `**Verification:**` além do formato `Verificação:` sem negrito
-- planos gerados por LLM com markdown bold deixam de silenciosamente omitir verify commands
-
-#### Spec-criteria enrichment (Gap B)
-
-- `compileExecutionGraphFromArtifacts` extrai comandos backtick dos campos `howToVerify` dos critérios de aceite da SPEC e os anexa a `node.verify.command` quando ausente no PLAN
-
-#### Testes e benchmark
-
-- novo `test:runtime-llm` (`scripts/test-runtime-llm.cjs`): valida `LlmTaskExecutor` end-to-end com LLM real; skipa automaticamente quando `OXE_LLM_API_KEY` não está definido
-- novo `benchmark:autonomy` (`scripts/benchmark-autonomy.cjs`): 5 fixtures de referência (simple → medium → parallel), mede taxa de compilação→execução→verify sem intervenção; saída em `.oxe/release/benchmark-autonomy-report.json`
-- novos testes: `gap-spec-enrichment.test.cjs` (5 casos) e `gap-spec-checklist-sync.test.cjs` (4 casos)
-
-## [1.10.0] — 2026-05-05
-
-### Operational Maturity
-
-Esta release amplia a prova operacional do OXE para cenários mais próximos de uso real, sem abrir novos comandos públicos.
-
-- `test:runtime-real` passa a cobrir cenários multi-wave, multi-file, gate pendente, verify parcial e promoção bloqueada por ausência de evidência técnica
-- `workspace-merge-report.json` passa a carregar `evidence_refs`, `diff_summary`, arquivos aplicados, status de verify pós-execução e próxima ação operacional por task
-- `status`, `runtime status` e `runtime agents status` expõem merge readiness, blockers e próxima ação multi-agent de forma mais direta
-- `workspaceMode: product_package` deixa de marcar `contextQuality` como crítico quando não há ciclo OXE ativo no próprio repositório do pacote
-- smoke multi-runtime reforça Codex e Copilot VS Code com validação explícita de prompts/skills, manifesto e referências quebradas
-- `doctor --release` passa a validar o conteúdo mínimo dos relatórios runtime-real e multi-agent-real da linha `1.10.0`
-- `/oxe-spec` passa a ter contrato multimodal: imagens, screenshots e mockups enviados no chat devem virar `VISUAL-INPUTS.md/json`, anchors visuais e readiness bloqueante quando críticos para UI/fluxo
-
-## [1.9.1] — 2026-05-04
-
-### Multi-Agent Real
-
-Esta release endurece a coordenação multi-agent sobre workspaces reais, sem abrir novos comandos públicos.
-
-- multi-agent real passa a exigir workspaces isolados `git_worktree` para modos `parallel`, `competitive` e `cooperative`
-- `runtime execute` valida `plan-agents.json` antes de iniciar agentes e usa `GitWorktreeManager` por padrão no caminho multi-agent
-- novo artefato por run `.oxe/runs/<run_id>/workspace-merge-report.json` com worktrees, ownership, merge blockers e readiness
-- `runtime agents status --json`, `status --json` e recovery passam a expor merge readiness, blockers, arbitration e worktrees órfãos
-- novo `npm run test:multi-agent-real` gera `.oxe/release/multi-agent-real-report.json` usando repositório git temporário com worktrees reais
-- `doctor --release` passa a exigir `multi-agent-real-report.json` em versões `>=1.9.1`
-
-## [1.9.0] — 2026-05-04
-
-### Runtime Real Maturity
-
-Esta release eleva a maturidade prática do OXE com foco em prova determinística do ciclo real `spec -> plan -> execute -> verify -> status/doctor`, sem abrir novos comandos públicos.
-
-#### Runtime real
-
-- nova suíte `test:runtime-real` valida projetos representativos com executor mockado e sem chamada a LLM/API externa
-- `runtime execute` passa a bloquear antes da mutação quando confiança, rationality packs ou gates não estão prontos
-- `runtime verify` continua evidence-first e passa a ser validado dentro do fluxo real de execução
-
-#### Release proof
-
-- novo relatório obrigatório `.oxe/release/runtime-real-report.json`
-- `doctor --release` passa a bloquear publicação quando a prova de runtime real estiver ausente ou falha
-- novo `release:pack-check` valida o tarball npm em dry-run contra artefatos indevidos
-
-## [1.8.3] — 2026-05-04
-
-### Release readiness e higiene de publicação
-
-Esta release consolida a linha `1.8.3` para publicação no npm com foco em consistência de versão, alinhamento documental e pacote distribuído mais limpo.
-
-#### Publicação
-
-- alinhamento da versão `1.8.3` entre manifesto raiz, runtime, extensão VS Code, README e changelog
-- fechamento do gate oficial `doctor --release` para a linha atual
-- preparação do pacote npm para sair sem drift entre versão publicada e documentação principal
-
-#### Higiene do pacote
-
-- exclusão dos arquivos `.vsix` históricos da extensão VS Code do tarball npm
-- manutenção apenas do código-fonte da extensão dentro do pacote, evitando distribuir binários legados desnecessários
-
-## [1.8.2] — 2026-04-30
-
-### Fluxo inicial mais coerente e geração de `spec`/`plan` mais forte
-
-Esta release fecha a linha de robustez do ciclo `install -> status/doctor -> /oxe -> spec -> plan -> execute -> verify` sem abrir nova superfície pública. O foco foi remover ruído operacional em projetos novos e aumentar a densidade executável dos artefatos que o OXE induz.
-
-#### Fluxo operacional
-
-- `install`, `status` e `doctor` passam a convergir em `/oxe` como próximo passo canônico para projetos recém-inicializados
-- `doctor` e `status` deixam de tratar `IMPLEMENTATION-PACK`, `REFERENCE-ANCHORS` e `FIXTURE-PACK` como blocker primário antes de existir `PLAN.md`
-- o relatório racional agora marca o estado sem plano como `não aplicável ainda`, sem contaminar o próximo passo
-- instalações e desinstalações locais por runtime continuam simétricas, com inferência de artefatos locais preservada
-
-#### Indução mais forte de SPEC e PLAN
-
-- `SPEC.template.md` passou a exigir outcome observável, público-alvo, restrições técnicas, setup externo, conteúdo/fluxos obrigatórios e contratos esperados para o plano
-- `PLAN.template.md` ganhou contrato operacional da solução, densidade operacional mínima, `symbols alvo`, `estado/fluxo coberto` e `fixture/anchor obrigatório` por tarefa
-- `oxe/workflows/spec.md` agora força extração explícita de blocos de interface, conteúdo mínimo, interações, responsividade e acessibilidade em demandas de produto/app/UI
-- `oxe/workflows/plan.md` agora endurece o gate de confiança `>90%` para tarefas mutáveis vagas e exige fechamento mais forte de interface, conteúdo, estado persistido, anchors e fixtures em apps/UI estáticos
-
-#### Testes
-
-- novo teste cobrindo o estado racional não bloqueante antes da existência de `PLAN.md`
-- suíte focada de CLI/health atualizada para manter o comportamento novo estável
-
-## [1.8.1] — 2026-04-30
-
-### Hotfix — Gaps implementados no fonte TypeScript (não em arquivos compilados)
-
-A v1.8.0 aplicou as 5 correções críticas diretamente nos arquivos `.js` compilados (`lib/runtime/`), que são sobrescritos a cada `npm run build:runtime`. Esta release porta todas as correções para o fonte TypeScript em `packages/runtime/src/`, tornando-as permanentes.
-
-#### Correções portadas para TypeScript
-
-- **`models/failure.ts`**: `FailureClass` agora inclui `'verify'` e `'llm'` como classes canônicas
-- **`scheduler/scheduler.ts`**: `TaskResult` com campo opcional `completed_by`; `TaskExecutor.execute()` aceita `options?: { previousError? }`; `verifyNode()` importa e chama `verifyRun` da fonte TS; `executeNode()` repassa `options`; `requestGateForNode()` com warning quando manager ausente
-- **`executor/built-in-tools.ts`**: `finishTask` handler + registro em `BUILT_IN_TOOLS`
-- **`executor/action-tool-map.ts`**: `finish_task` injetado universalmente em `selectToolsForActions()`
-- **`executor/node-prompt-builder.ts`**: parâmetro `options`, seção de retry context, instrução `finish_task`
-- **`executor/llm-task-executor.ts`**: detecção de `finish_task`, `completed_by` no retorno, `turn_limit_exhausted` retorna `success: false`
-
-#### Testes
-- 542 testes passando (era 542 na v1.8.0, nenhuma regressão)
-- 36 testes de gaps (gap1–gap5) todos passando contra o código compilado
-
----
-
-## [1.8.0] — 2026-04-29
-
-### Autonomous Execution — 5 Critical Gaps Resolved
-
-Esta release eleva a autonomia do runtime de ~65% para ~85%+ em projetos de baixo a médio risco, tornando o OXE capaz de transformar um input bem estruturado em entrega verificada com mínima intervenção humana.
-
-#### Gap 1 — GateManager Wiring
-- `createExecutionContext()` exportada de `oxe-operational.cjs`: instancia `GateManager` real sempre que o runtime estiver disponível, eliminando o deadlock silencioso de `'gate-missing-manager'`
-- `scheduler.js`: warning explícito quando `ctx.gateManager` ausente em vez de falha silenciosa
-- Novo subcomando `oxe-cc runtime execute` com roteamento automático single-agent / multi-agent
-
-#### Gap 2 — Verificação Inline após cada tarefa
-- `Scheduler.verifyNode()`: executa o `verify.command` do nó logo após execução bem-sucedida, antes de emitir `WorkItemCompleted`
-- Falha de verificação → tarefa reentrada no loop de retry com `failure_class: 'verify'`
-- Falha de infraestrutura de verificação (comando inexistente, timeout) → não bloqueia progresso
-- Eventos `VerificationStarted` / `VerificationCompleted` emitidos por tarefa (reducer já existia)
-
-#### Gap 3 — Retry Inteligente com Contexto do Erro Anterior
-- `node-prompt-builder.js`: seção "Contexto da tentativa anterior" injetada automaticamente nas tentativas 2+ com stderr/output truncado em 2000 chars
-- `llm-task-executor.js`: aceita `options.previousError`; repassado para o prompt builder
-- `scheduler.js`: `lastError` rastreado e propagado entre tentativas via `executeNode(options)`
-
-#### Gap 4 — Sinal Autoritativo de Conclusão (`finish_task`)
-- Nova tool built-in `finish_task` (idempotente) registrada em `BUILT_IN_TOOLS` e `ALL_BUILT_IN_SCHEMAS`
-- `selectToolsForActions()`: `finish_task` injetada universalmente em todos os tipos de ação
-- `node-prompt-builder.js`: instrução explícita de chamar `finish_task` ao concluir
-- `llm-task-executor.js`: detecta chamada de `finish_task` → `completed_by: 'finish_task'`; turns esgotados sem `finish_task` → `success: false, failure_class: 'llm'`
-
-#### Gap 5 — MultiAgentCoordinator Wiring
-- `runRuntimeExecute()` exportada de `oxe-operational.cjs`: detecta `plan-agents.json` (sessão > raiz) e roteia para `MultiAgentCoordinator` (parallel/competitive/cooperative) ou `Scheduler` single-agent
-- `oxe-cc runtime execute`: novo subcomando CLI com output formatado e exit code em falhas
-
-#### Testes
-- 5 novos arquivos de teste cobrindo cada gap: `gap1-gate-manager`, `gap2-inline-verify`, `gap3-retry-context`, `gap4-finish-task`, `gap5-multi-agent`
-- Suite total: **543 testes passando**, 0 falhas
-
-### Validation
-
-- `node --test tests/*.cjs tests/*.test.js`
-- `node bin/oxe-cc.js --version`
-
----
-
-## [1.7.0] — 2026-04-23
-
-### OXE-native Agent Catalog
-
-- adicionada a fonte canónica `oxe/agents/` com agentes especializados para plan, execute, verify, debug, research, codebase mapping, integração, validação e UI
-- o instalador multi-runtime agora distribui agentes OXE para Claude Code (`.claude/agents`) e Codex/Antigravity (`.agents/skills` / skills compatíveis), além dos comandos já existentes
-- uninstall e smoke matrix passaram a validar e remover os agentes gerados pelo OXE
-
-### Rational Execution Artifacts
-
-- templates de `PLAN`, `IMPLEMENTATION-PACK`, `REFERENCE-ANCHORS`, `FIXTURE-PACK` e `SUMMARY` foram endurecidos com contratos goal-backward, write-set, símbolos, sequência mínima, rollback, fixtures e evidência
-- `/oxe-plan`, `/oxe-execute`, `/oxe-verify`, `/oxe-debug`, `/oxe-forensics`, `/oxe-ui-spec` e `/oxe-ui-review` agora referenciam explicitamente os agentes e gates racionais compatíveis com runtime enterprise
-
-### Public Surface Hygiene
-
-- `scan:assets` agora bloqueia referências públicas a namespaces, paths e nomes de origem legada
-- criado `docs/CONTENT-MIGRATION-AUDIT.md` como trilha interna de incorporação, sem exposição nas superfícies instaladas
-
-## [1.6.0] — 2026-04-23
-
-### Product Reconciliation
-
-- a árvore canónica `oxe/` foi restaurada como source of truth da release, incluindo `oxe/workflows/`, `oxe/workflows/references/`, `oxe/templates/` e `commands/oxe/` como superfície derivada sincronizada
-- `workflow-runtime-contracts.json` voltou a ser contrato obrigatório da release; `sync-runtime-metadata` agora falha fechado quando a fonte canónica ou o registry semântico estão ausentes/inválidos
-- `doctor --release` passou a bloquear explicitamente por topologia canónica ausente, contrato semântico inválido e drift entre workflows e wrappers
-
-### Package-vs-Workspace Health
-
-- `status`, `status --full`, dashboard e SDK agora distinguem `workspaceMode: product_package` de `workspaceMode: oxe_project`
-- no repositório do pacote, o próximo passo deixa de cair em `plan/replan` por ruído de manutenção e passa a apontar para `doctor --release --write-manifest`
-- `status --json` passou a expor `workspaceMode` e `releaseReadiness` como contrato estável da linha `1.6.0`
-
-### Multi-runtime Edge Hardening
-
-- a smoke matrix de release passou a validar a instalação do Codex de forma completa: prompts em `.codex/prompts/` e skills em `.agents/skills/oxe/`
-- documentação de instalação foi ajustada para separar `--local` (layout do repo) de `--ide-local` (escopo da integração), eliminando a ambiguidade operacional em runtimes como Codex
-
-### Validation
-
-- `node --test tests/oxe-project-health.test.cjs`
-- `node --test tests/oxe-cli-edge.test.cjs`
-- `npm test`
-- `npm run scan:assets`
-- `npm run release:doctor`
-
-## [1.5.1] — 2026-04-22
-
-### Rational Execution Readiness
-
-- `/oxe-plan` passou a exigir e propagar artefatos racionais de execução: `IMPLEMENTATION-PACK`, `REFERENCE-ANCHORS` e `FIXTURE-PACK`
-- `/oxe-execute` agora é `pack-first` e bloqueia mutação quando confiança `<= 90%`, quando os packs estão incompletos ou quando há `critical_gap` aberto
-- `doctor`, `status --json`, dashboard e SDK passaram a expor `implementationPackReady`, `referenceAnchorsReady`, `fixturePackReady`, `executionRationalityReady` e `criticalExecutionGaps`
-
-### Session Compatibility
-
-- o health report agora faz fallback explícito entre artefatos session-scoped e artefatos ainda materializados na raiz `.oxe/`, evitando falso negativo de readiness em workspaces legados
-- o gate racional foi limitado ao estágio pré-execução; depois de `executing`/`verify_complete`, os packs continuam diagnósticos, mas não reescrevem o próximo passo do ciclo
-
-### Publication Alignment
-
-- versão alinhada para `1.5.1` em pacote raiz, runtime package, extensão VS Code, README e lockfile
-- matriz pública de smoke runtime atualizada para refletir a release `1.5.1`
-
-### Validation
-
-- `npm test`
-- `npm run scan:assets`
-- `npm run release:manifest`
-- `npm run build:vscode-ext`
-
-## [1.5.0] — 2026-04-21
-
-### Release Readiness 5/5
-
-- `doctor --release --write-manifest` virou gate formal de publicação, com verificação bloqueante de versões, topo do `CHANGELOG`, runtime compilado, wrapper sync e relatórios obrigatórios
-- a release agora persiste `release-manifest.json`, `runtime-smoke-report.json`, `recovery-fixture-report.json` e `multi-agent-soak-report.json` em `.oxe/release/`
-- `npm test` passou a incluir smoke matrix multi-runtime, fixtures reproduzíveis de recovery/incidente e soak multi-agent
-
-### Operational Proof
-
-- nova smoke matrix obrigatória para Cursor, Copilot VS Code, Claude Code, Codex, OpenCode, Gemini, Windsurf e Antigravity, cobrindo install, entrypoint `oxe`, resolução de workflow e uninstall granular
-- novo corpus de incidentes em `tests/fixtures/runtime-incidents/` para provar `runtime replay` e `runtime recover` fora do caminho feliz
-- multi-agent passou a gerar e auditar `multi-agent-summary.json`, incluindo timeouts e reassignments
-
-### Publication Contract
-
-- versão alinhada para `1.5.0` em pacote raiz, runtime package, extensão VS Code, README e lockfile
-- README, AGENTS e SDK docs atualizados para refletir o gate de release, os relatórios obrigatórios e o contrato estável desta publicação
-
-### Validation
-
-- `npm test`
-- `npm run scan:assets`
-- `npm run release:doctor`
-
-## [1.4.0] — 2026-04-20
-
-### Runtime Publication Stabilization
-
-- `execute` e `verify` passaram a documentar e propagar o contrato `runtime-first`, com fallback legado explícito quando o runtime enterprise não estiver disponível
-- `runtime gates` ganhou superfície operacional estável com `list`, `show`, `resolve`, filtros (`--run`, `--status`, `--scope`, `--task`) e `--json`
-- `status --json` e `runtime status --json` consolidam `runtimeMode`, `fallbackMode`, `gateQueue`, `policyCoverage`, `promotionReadiness`, `recoveryState`, `multiAgent` e `providerCatalog`
-- dashboard web passou a expor cards operacionais para gates, recovery, promotion e multi-agent, incluindo resolução de gates pela UI
-- replay/recovery ficaram orientados a incidente com saída estruturada, reconciliação de run state e summaries derivados
-- `multi-agent` foi endurecido como GA apenas sobre workspaces isolados reais; modos `parallel`, `competitive` e `cooperative` falham explicitamente em `inplace`
-- SDK ampliado com `GateQueueSnapshot`, `replayRuntimeState`, `readRuntimeMultiAgentStatus` e alias `multiAgentStatus`
-
-### Release Preparation
-
-- alinhamento de versão para `1.4.0` em `package.json`, `package-lock.json`, `packages/runtime/package.json`, `vscode-extension/package.json`, banner e README
-- alinhamento de licença da extensão VS Code com o pacote principal e inclusão de `vscode-extension/LICENSE` para empacotamento limpo do VSIX
-- licença do projeto alterada de `GPL-3.0` para `MIT`, com manifests e documentação pública alinhados
-- README atualizado para refletir o momento atual do produto, o contrato estável de publicação e a superfície enterprise do CLI/runtime
-- `lib/sdk/README.md` e `AGENTS.md` atualizados para refletir os bridges do runtime enterprise e o comportamento `runtime-first`
-
-### Adoção em Times (v1.4.0 final)
-
-- `QUICKSTART.md` — guia de onboarding "primeiros 15 minutos": install, primeiro ciclo (6 comandos), runtime-first, validação dos 5 minutos
-- `docs/ROLES.md` — guia por papel: executor, reviewer, operador de gate, mantenedor do pacote; cada papel com o que lê, decide e pode ignorar
-- `docs/TEAM-ADOPTION.md` — fluxo branch/PR recomendado, ship local vs. promote remoto, sessões e workstreams, governança mínima
-- `docs/WALKTHROUGH.md` — walkthrough completo reproduzível: spec → plan → execute → verify → gate → promotion com outputs esperados
-- `docs/INCIDENT-PLAYBOOK.md` — gate stale, run bloqueada, RECOVERY-SUMMARY, dashboard como painel operacional
-- `docs/RUNTIME-SMOKE-MATRIX.md` — matriz 8 runtimes × 6 operações com pressupostos e comportamentos por runtime
-- `oxe-cc doctor` — health gates para IDEs (Copilot, Cursor, Claude Code), detecção de runtime compilado, readiness gate summary com próximo passo derivado da fase atual
-- `oxe-cc status` — IDE readiness summary inline, gates pendentes no modo padrão (sem `--full`), diagnóstico de bloqueio explícito (SPEC/PLAN/VERIFY ausentes)
-- `runtime gates list` — ícones visuais `⏳ pending` / `⚠ stale (>Nh)` / `✓ resolved`, ação sugerida e impacto no ciclo por gate
-- `runtime gates resolve` — mensagem de impacto pós-resolução: "Run pode avançar" ou "N gates restantes"
-- `.github/workflows/release.yml` — pipeline de publicação: validate → publish-npm (com provenance) → build-vsix → create-release com extração automática do CHANGELOG
-- `.github/workflows/ci.yml` — novos jobs `doctor` (gate de qualidade operacional) e `wrapper-audit` (sync entre wrappers e contrato canônico)
-- `README.md` — seção `## Para times` com links para todos os novos docs; link `→ Guia por papel` na seção "Momento atual do produto"
-
-### Validation
-
-- suíte root + runtime continua verde
-- scanner de assets/markdown continua íntegro
-
----
-
-## [1.3.0] — 2026-04-20
-
-### Reasoning Contracts & Semântica Multi-Runtime
-
-- Contratos de raciocínio v2.0.0 (`oxe_contract_version: 2.0.0`) em todos os workflows e wrappers de runtime
-- Novos campos de metadata: `oxe_reasoning_mode`, `oxe_question_policy`, `oxe_output_contract`, `oxe_tool_profile`, `oxe_confidence_policy`, `oxe_context_tier`
-- `oxe_semantics_hash` (SHA-256 16 chars) para detecção de drift semântico entre IDEs
-- Módulo `bin/lib/oxe-runtime-semantics.cjs` gerencia o contrato canônico: `buildReasoningContractBlock()`, `buildContextTiers()`, `auditRuntimeTargets()`, `computeSemanticsHash()`
-- `auditRuntimeTargets()` varre Copilot prompts, commands e Cursor commands e reporta divergências entre wrappers e o contrato canônico
-- Prompts e commands sincronizados para todos os runtimes: Cursor, GitHub Copilot, Claude Code, OpenCode, Codex, Gemini CLI, Windsurf, Antigravity
-
-### Novos Módulos bin/lib
-
-- **`oxe-dashboard.cjs`** — servidor HTTP local (porta 9000), `loadDashboardContext()`, API REST com `/api/health/status`, `/api/plan/info`, `/api/runtime/gates/{id}/status`, `/api/runtime/gates/resolve`; suporte a PLAN-REVIEW.md com comentários e status de aprovação
-- **`oxe-runtime-semantics.cjs`** — gestão de metadados de workflow e contratos de raciocínio: `getWorkflowContract()`, `getAllWorkflowContracts()`, `validateWorkflowContractsRegistry()`, `buildContextPackPaths()`, `buildReasoningContractBlock()`, `splitFrontmatter()`, `parseFrontmatterMap()`
-- **`oxe-operational.cjs`** expandido — monitoramento de agents, gates, evidências e estado de run com maior granularidade
-- **`oxe-project-health.cjs`** expandido — métricas de saúde: test scores, coverage, violations, integração Copilot
-
-### Comandos e Superfície
-
-- **`oxe-ship`** — cria commit local guiado por `SPEC.md`, `PLAN.md` e `VERIFY.md`; disponível em todos os runtimes suportados
-- **`oxe-skill`** — gestão e composição de skills com roles `@executor` e `@researcher`
-- Contrato de raciocínio declarado em todos os workflows: `discovery`, `planning`, `execution`, `review`, `status`
-- Regra pack-first em todos os wrappers: lê `.oxe/context/packs/<slug>.md` antes de cair para leitura direta
-
-### Testes e Cobertura
-
-- Novos testes unitários para `oxe-runtime-semantics.cjs`: 31 testes cobrindo todas as 19 funções exportadas
-- Novos testes para `oxe-plugins.cjs`: 28 testes para `loadPlugins`, `runHook`, `validatePlugins`, `initPluginsDir`, `resolvePluginSources`
-- Novos testes para `oxe-security.cjs`: `checkPathSafety`, `scanFileForSecrets`, `scanDirForSecretFiles`, `validatePlanPaths`
-- Cobertura de linhas: **80.28% → 82.28%** (superando threshold de 82%)
-- Total: **383 testes** passando (root + runtime)
-
----
-
-## [1.2.1] — 2026-04-18
-
-### Branding, Semântica e Empacotamento
-
-- remove referências remanescentes ao framework legado dos workflows e do diagnóstico de integração Copilot
-- alinha `package.json`, `package-lock.json`, banner CLI e README para `1.2.1`
-- corrige deriva semântica do workflow `ship`, registrando-o no contrato canônico multi-runtime
-- adiciona prompt files de `ship` para Copilot/Cursor
-- remove o comando `auto` da superfície pública do OXE
-- remove o comando `intel` da superfície pública do OXE
-- reposiciona `ship` para fechar o ciclo com commit local guiado por `SPEC.md`, `PLAN.md` e `VERIFY.md`
-
----
-
-## [1.2.0] — 2026-04-18
-
-### Runtime Hardening & Robustez (Fases 1–9)
-
-**Fase 1 — Runtime Hardening**
-
-- `RunJournal` persistido em `.oxe/runs/{runId}/journal.json`: gravado a cada onda, atualizado no pause/cancel
-- `Scheduler.pause()` agora grava journal e retorna `status: 'paused'` em vez de apenas setar flag in-memory
-- `Scheduler.recover(runId, ctx, graph)` — retoma run pausado pelo journal; pula nós já completados
-- `Scheduler.getJournal()` e `Scheduler.loadJournal(projectRoot, runId)` para inspeção
-- `RunState` expandido: `retryCounts`, `policyDecisions`, `pendingGates`, `resolvedGates`, `verificationStatus`, `evidenceRefs`, `toolFailures`
-- Reducer: handlers para `RetryScheduled`, `PolicyEvaluated`, `GateRequested`, `GateResolved`, `VerificationStarted`, `VerificationCompleted`, `ToolFailed`, `EvidenceCollected`
-- Helpers: `getRetryCount`, `getPolicyDecision`, `getVerificationStatus`, `getEvidenceRefs`, `getToolFailures`
-
-**Fase 2 — Policy, Side Effects e Security**
-
-- `SideEffectClass` enum: `read_fs|write_fs|spawn_process|network_call|git_mutation|db_change|secret_access|infra_operation`
-- `AutonomyTier` type: `L0|L1|L2|L3` — tier controla quais side effects são permitidos automaticamente
-- `NodePolicyConfig` com `mutation_budget` e `autonomy_tier`
-- `EnvironmentGuardrail` com `protected_paths`, `protected_branches`, `require_human_gate_on`
-- Guardrails default: paths `.env`, `package.json`, `.oxe/config.json`; gate automático para `infra_operation`, `db_change`, `secret_access`
-- `PolicyEngine.withGuardrail(g)` para customizar guardrails por projeto
-- `side_effect_class` e `autonomy_tier` em `PolicyWhenClause` para regras direcionadas
-
-**Fase 3 — Verify Operational**
-
-- `VerificationManifest` formal: persistido em `.oxe/runs/{runId}/verification-manifest.json`
-- `VerificationProfile`: `quick|standard|critical` — controla quais `FailureClass` geram riscos residuais
-- `FailureClass` taxonomy: `deterministic|flaky|timeout|env_setup|policy_failure|evidence_missing`
-- `classifyFailure(result)` — classifica automaticamente cada `CheckResult`
-- `buildManifest(runId, results, options)` — compila manifest por work item, onda ou run
-- `ResidualRiskLedger` persistido em `.oxe/runs/{runId}/residual-risks.json`
-- `buildRiskLedger(runId, manifest)` — gera ledger de riscos residuais a partir do manifest
-
-**Fase 4 — Delivery Native**
-
-- `MergeGateEvaluator.evaluate(runResult, manifest, ledger)` — avalia se run está pronto para merge
-- Bloqueios: tarefas failed/blocked, verificação falha, riscos `high`/`critical`
-- `PromotionPipeline.promote(runResult, manifest, ledger, opts)` — cria PR draft via `gh`, persiste `RunPRLink`
-- `PromotionPipeline.buildPRBody(...)` — corpo do PR com resumo, verificação e riscos residuais
-- `RunPRLink` persistido em `.oxe/runs/{runId}/pr-link.json`
-
-**Fase 5 — Context Engineering Avançado**
-
-- `ContextPackStore`: `savePack`, `loadPack`, `markStale`, `isStale`, `listPackMeta` — packs persistidos em `.oxe/runs/{runId}/context-pack-{workItemId}.json`
-- `ContextPackMeta` com `estimated_tokens`, `stale`, `stale_reason`
-- `diffPacks(before, after)` — detecta added/removed/score_changed entre versões de pack
-- Índice global por run em `context-packs.index.json`
-
-**Fase 6 — Decision Engine / Seniority**
-
-- `DecisionEngine.evaluate(input)` — avalia policy, gate, retry budget, risk, lesson match e retorna `DecisionRecord` com `type`, `seniority`, `confidence` e `rationale`
-- Tipos de decisão: `proceed|retry|escalate_gate|skip|abort|promote_lesson`
-- `SeniorityLevel`: `junior|standard|senior|expert` derivado da confidence
-- `appendDecision`, `loadDecisionLog`, `queryDecisions` — log persistido em `.oxe/runs/{runId}/decisions.json`
-
-**Fase 7 — Multi-Agent Robusto**
-
-- `AgentRegistry` com heartbeat tracking por agente
-- `registry.beat(id, currentTask)` — atualiza last_seen e status
-- `registry.isAlive(id)` — detecta timeout configurável por instância
-- `registry.timedOut()` / `registry.liveAgents()` — filtragem por liveness
-- `registry.failover(fallbackAgentId)` — reassigna tasks de agentes expirados para fallback
-- `registry.setStatus(id, status)` — transições manuais de estado
-
-**Fase 8 — ABI Estável de Plugins**
-
-- `PluginManifest` com `abi_version`, `capabilities`, declared providers
-- `extractManifest(plugin)` — extrai manifest de qualquer `OxePlugin`
-- `validatePlugin(plugin)` — retorna `{ valid, errors, warnings }` com checagem de nome, semver, providers
-- `isAbiCompatible(version)` — garante compatibilidade de major version
-- `sandboxInvoke(fn, timeoutMs)` — execução com timeout e isolamento de erro para plugins
-
-**Fase 9 — Enterprise Operations**
-
-- `AuditTrail` — registro imutável NDJSON em `.oxe/AUDIT-TRAIL.ndjson`
-- 14 tipos de ação auditáveis: `run_started`, `secret_accessed`, `infra_mutation`, `merge_approved`, etc.
-- Severity automática por ação (`info|warn|critical`)
-- `AuditTrail.query(filter)` — filtra por action/severity/runId/since
-- `RunQuota` — `createQuota`, `consumeQuota`, `checkQuota` para limitar work_items, mutations e retries por run
-
-### Testes
-
-- Runtime: **266 testes** (↑ de 145 pré-robustez)
-- Root: 321 testes (sem regressões)
-- Total: **587 testes** passando
-
----
-
-## [1.1.0] — 2026-04-18
-
-### Mudança de superfície (simplificação estratégica de produto)
-
-**Trilha principal reduzida a 6 comandos**
-
-O OXE agora se comporta como um framework guiado por etapas. A superfície pública foi reorganizada em três níveis:
-
-**Trilha principal (6 comandos):**
-- `/oxe` — entrada universal (absorve ask, next, route, help)
-- `/oxe-quick` — modo nano sem cerimônia
-- `/oxe-spec` — spec com flags: `--refresh`, `--full`, `--research`, `--ui`
-- `/oxe-plan` — planejamento test-first
-- `/oxe-execute` — implementação com flags: `--note`, `--debug`, `--deep-diagnosis`, `--checkpoint`, `--iterative`
-- `/oxe-verify` — validação e fechamento com flags: `--gaps`, `--security`, `--ui`, `--pr`, `--diff`, `--skip-retro`
-
-**Trilha avançada:** `/oxe-session` (absorve project, milestone, workstream), `/oxe-dashboard`
-
-**Administrativa:** `/oxe-capabilities`, `/oxe-skill`, `oxe-cc azure`
-
-### Depreciado (v1.1.0)
-
-Os seguintes comandos foram incorporados por estágios principais e continuam funcionando com aviso de migração:
-
-| Comando | Novo destino |
-|---------|-------------|
-| `/oxe-ask` | `/oxe "pergunta"` |
-| `/oxe-scan` | `/oxe-spec --refresh` |
-| `/oxe-research` | `/oxe-spec --research` |
-| `/oxe-ui-spec` | `/oxe-spec --ui` |
-| `/oxe-obs` | `/oxe-execute --note` |
-| `/oxe-debug` | `/oxe-execute --debug` |
-| `/oxe-forensics` | `/oxe-execute --deep-diagnosis` |
-| `/oxe-checkpoint` | `/oxe-execute --checkpoint` |
-| `/oxe-loop` | `/oxe-execute --iterative` |
-| `/oxe-validate-gaps` | `/oxe-verify --gaps` |
-| `/oxe-security` | `/oxe-verify --security` |
-| `/oxe-ui-review` | `/oxe-verify --ui` |
-| `/oxe-review-pr` | `/oxe-verify --pr` |
-| `/oxe-retro` | `/oxe-verify` (retro automática) |
-| `/oxe-project` | `/oxe-session milestone\|workstream` |
-| `/oxe-compact` | `/oxe-spec --refresh` |
-| `/oxe-next` | `/oxe` (sem argumento) |
-| `/oxe-route` | `/oxe "intenção"` |
-| `/oxe-milestone` | `/oxe-session milestone` |
-| `/oxe-workstream` | `/oxe-session workstream` |
-
-### Novos comportamentos
-
-- **Retro automática:** `/oxe-verify` executa automaticamente retrospectiva ao fechar (`--skip-retro` para desativar)
-- **Pergunta situacional inline:** `/oxe "pergunta"` substitui `/oxe-ask`
-- `/oxe-session` agora suporta `milestone` e `workstream` como subcomandos
-
----
-
-## [0.8.0] — 2026-04-14
-
-### Adicionado
-
-**Session forking + revert**
-- `session fork [nome]` — bifurca a sessão ativa, copiando todos os artefatos para uma nova sessão; rastreia `forked_from` na SESSION.md
-- `session revert <checkpoint-slug>` — restaura STATE.md ao snapshot de um checkpoint, sem apagar artefatos atuais
-
-**Skill system**
-- `/oxe-skill` — workflow para descobrir, invocar e gerenciar skills (unificação de personas e capabilities)
-- `@<skill-id>` no chat resolve persona OU capability OU composite como ponto de entrada único
-- Template `SKILL.template.md` para criação de skills de projeto em `.oxe/skills/`
-- Resolução em 3 camadas: project → capabilities → global (personas do pacote)
-
-**Sistema de permissões com wildcard**
-- `permissions[]` em `.oxe/config.json` — regras glob+ação que controlam acesso a arquivos durante execute e apply
-- Ações: `allow`, `deny`, `ask` — avaliação first-match wins
-- Scopes: `execute`, `apply`, `all`
-- Gate automático no workflow execute antes de cada onda
-
-**Config hierárquico (system → user → project)**
-- `loadOxeConfigMerged()` agora lê 3 níveis: system (`OXE_SYSTEM_CONFIG` ou path OS-default) < user (`~/.oxe/config.json`) < project (`.oxe/config.json`)
-- `status --full` exibe fontes de cada nível de configuração
-- Campo `sources` no retorno do SDK
-
-**Event sourcing com replay**
-- `replayEvents()` no SDK — reconstrói timeline de `OXE-EVENTS.ndjson` com deltas, filtros por run/wave/event
-- `oxe-cc runtime replay [--run <id>] [--from <event-id>] [--wave <n>] [--write]` — visualização de timeline no terminal ou `REPLAY-SESSION.md` em disco
-- Integração com `/oxe-forensics` — replay como ferramenta de investigação
-
-**Plugin system com carregamento remoto**
-- `plugins[]` em `config.json` aceita `{ source: "npm:<pkg>" }` e `{ source: "path:./file.cjs" }`
-- `oxe-cc plugins list` — lista plugins carregados (local + externos)
-- `oxe-cc plugins install npm:<pkg>` — instala plugin npm em `.oxe/plugins/_npm/`
-- `resolvePluginSources()` e `installNpmPlugin()` expostos no SDK
-
-### Tipos TypeScript
-- `OxePermissionRule`, `PermissionCheckResult`, `ReplayReport`, `PluginSource` adicionados
-- `security.checkFilePermission`, `security.checkPermissions`, `security.globToRegex` declarados
-- `operational.replayEvents` declarado
-- `plugins.resolvePluginSources`, `plugins.installNpmPlugin` declarados
-- `health.loadOxeConfigMerged` retorna `sources: { system, user, project }`
-
----
-
-## [0.7.0] — 2026-04-13
-
-### Adicionado
-
-**Provider Azure nativo (`oxe-cc azure`)**
-- `azure status` — estado compacto read-only: CLI, login, subscription, inventário, pendências, alerta VPN
-- `azure operations list` — histórico colorido de operações (planned/applied/pending)
-- `azure find --type <serviço>` — filtro por família de serviço (servicebus, eventgrid, sql)
-- `azure find --filter-rg <rg>` — filtro por resource group
-- `azure sync --diff` — mostra recursos adicionados/removidos em relação ao snapshot anterior
-- `azure apply --dry-run` — pré-visualiza comando `az` sem executar nem criar artefatos
-- `azure auth login --tenant <id>` — suporte a Entra ID corporativo; passa `--tenant` ao `az login`
-- `azure apply --vpn-confirmed` — confirma conexão VPN quando `vpn_required: true` está configurado
-
-**SDK**
-- `azure.diffInventory(previousItems, currentItems)` — compara snapshots de inventário (adicionados/removidos/unchanged)
-- `azure.statusAzure(projectRoot, config?, options?)` — status compacto sem writes
-
-**Workflows (guardrails)**
-- `scan.md`: detecção Azure é informativa — não altera fluxo canônico OXE nem aciona steps Azure automaticamente
-- `plan.md`: pré-check Azure só ativa quando Azure é mencionado **explicitamente** na SPEC ou `.oxe/cloud/azure/` existe
-- `discuss.md`: perguntas Azure só ativam quando SPEC menciona Azure explicitamente — SQL genérico (PostgreSQL, MySQL, on-prem) não aciona o bloco
-
-### Corrigido
-- `loginAzure()` com `inherit: true` não passava mais `inherit` para `getAzureContext`, evitando crash ao tentar ler `account.id` de stdout null
-
-### Tipos TypeScript
-- `azure.searchAzureInventory` inclui parâmetro opcional `filters?: { type?, resourceGroup? }`
-- `azure.diffInventory` declarado
-- `azure.statusAzure` declarado
-
----
-
-## [0.6.3] — 2026-04-04
-
-### Corrigido
-- `security_in_verify` agora é reconhecido como chave válida em `.oxe/config.json` (não mais rejeitado pelo doctor como "unknown key")
-- `plan-agents.schema.json`: enum atualizado de `[1, 2]` para `[2, 3]`; campos `persona` e `model_hint` adicionados ao schema dos agentes
-
-### Adicionado
-- **`/oxe-retro` sugerido automaticamente** pelo `oxe-cc status` quando `phase: verify_complete` e `.oxe/LESSONS.md` ainda não existe
-- **`health.parseLastRetroDate(stateText)`** — parseia campo `last_retro: YYYY-MM-DD` do STATE.md
-- **`health.isStaleLessons(retroDate, maxDays)`** — detecta se LESSONS.md está desatualizado (par de `isStaleScan`)
-- **`health.planAgentsWarnings(target)`** — avisa sobre schema 1 (legado) e `model_hint` inválido em `plan-agents.json`
-- **`parseState()`** retorna novo campo `lastRetroDate: string | null`
-- `OxeHealthReport` inclui `retroDate: Date | null`
-- `config.template.json` inclui `security_in_verify: false` por padrão
-- `plan-agents.template.json` inclui campo `persona` no agente-exemplo
-- Melhorias de workflow: `obs.md` (tabela de classificação de impacto), `verify.md` (success_criteria camadas 5+6), `next.md` (flag de promoção QUICK→spec), `quick.md` (incorporação de OBSERVATIONS), `plan.md` (nota de replan + plan-agents sync)
-- `AGENTS.md` atualizado para v0.6.x
-
-### Tipos TypeScript
-- `ParsedState` inclui `lastRetroDate: string | null`
-- `OxeHealthReport` inclui `retroDate: Date | null`
-- `health.*` expõe `parseLastRetroDate`, `isStaleLessons`, `planAgentsWarnings`
-
----
-
-## [0.6.2] — 2026-04-04
-
-### Adicionado
-- **`/oxe-retro`** — workflow de retrospectiva de ciclo; sintetiza 3–5 lições prescritivas em `.oxe/LESSONS.md`
-- `oxe/templates/LESSONS.template.md`
-- Correções de consistência de schema (plan-agent.md, verify.md): referências atualizadas para schema v3
-
-### Alterado
-- README: tabela "Como cada comando fica mais inteligente" expandida com loop, security, research thinking_depth, model_hint
-- Cadeia de help (`oxe.md`) atualizada para incluir `/oxe-retro` após verify
-
----
-
-## [0.6.1] — 2026-04-04
-
-### Adicionado
-- **`/oxe-security`** — auditoria OWASP Top 10 filtrada pelo stack; produz `.oxe/SECURITY.md` com achados P0/P1/P2
-- **`/oxe-loop`** — execução iterativa de onda com retries automáticos e diagnóstico inline
-- **Model hints** em `plan-agents.json` schema v3: campo `model_hint` (`fast | balanced | powerful`) por agente
-- **Thinking depth** em `/oxe-research`: classificação `surface | standard | deep` com raciocínio estendido para `deep`
-- Integração automática de security no verify via `security_in_verify: true` (Camada 6)
-- `oxe/templates/SECURITY.template.md`
-
----
-
-## [0.6.0] — 2026-04-04
-
-### Adicionado
-- Workflow `/oxe-project` unificando `milestone`, `workstream`, `checkpoint`
-- `/oxe-obs` com propagação automática para R-IDs e Tns afetados
-- Auto-reflexão semântica em `/oxe-spec` (Fase 4b): detecta contradições e escopo creep antes da aprovação
-- Modo de execução A/B/C em `/oxe-execute` (Completo / Por onda / Por tarefa)
-- Debug inline automático em falhas de execute
-- 4 profiles de execução: `balanced`, `strict`, `fast`, `legacy`
-- Sistema de personas para agentes (`oxe/personas/`)
-- Plugin lifecycle (`.oxe/plugins/*.cjs`)
-- `scale_adaptive`: scan sugere profile pelo tamanho do projeto
-
----
-
-## [0.5.0] — anterior
-
-Versões anteriores não documentadas neste arquivo.
+# Changelog — OXE CLI (`oxe-cc`)
+
+Todas as versões seguem [Semantic Versioning](https://semver.org/). As mudanças mais recentes aparecem primeiro.
+
+---
+
+## [1.16.0] — 2026-07-18
+
+### Segurança, pacote verificável e engenharia de release
+
+Esta versão consolida o OXE-BUILD como framework multi-runtime orientado por
+evidências, com foco em segurança de subprocessos, consumo real do pacote,
+qualidade mensurável e releases reproduzíveis.
+
+- **Executor seguro e multiplataforma** — invocações de `npm` e `npx` foram
+  centralizadas com argumentos estruturados e `shell: false`, incluindo
+  resolução explícita de `npm-cli.js`/`npx-cli.js` no Windows e testes contra
+  payloads hostis.
+- **Portabilidade comprovada em Windows e Linux** — resolução de caminhos
+  Windows usa semântica `win32` mesmo quando simulada em outro host; mocks do
+  Azure CLI e instalações globais de agentes passaram a ser herméticos, e o
+  OpenCode recebe também a entrada raiz `oxe.md`.
+- **CLI modular** — dispatch de comandos separado em registry e handlers
+  testáveis, reduzindo o acoplamento do entrypoint sem alterar a interface
+  pública.
+- **Pacote validado como um consumidor real** — o gate cria o tarball, instala
+  em projeto temporário limpo e exercita CLI, SDK, runtime e compilação
+  TypeScript.
+- **npm workspaces e lockfile único** — raiz, runtime e extensão usam a mesma
+  resolução; o lockfile aninhado obsoleto do runtime foi removido.
+- **SDK types gerados pelo TypeScript** — `index.d.ts` passa a ser emissão
+  determinística de `index.types.ts`, com gate de drift e validação da ABI
+  pública.
+- **Coverage ratchet** — pisos globais e de módulos críticos são executáveis e
+  não podem ser reduzidos abaixo do baseline versionado.
+- **Extensão validada no VS Code real** — o Extension Host 1.95.3 comprova a
+  ativação e o registro observável dos 13 participantes OXE; o VSIX é gerado
+  por uma versão fixa do `vsce`.
+- **Supply chain endurecida** — GitHub Actions fixadas por SHA, Dependabot,
+  permissões mínimas, actionlint, tag vinculada à versão e GitHub Release
+  condicionada ao build do VSIX.
+- **Publicação npm manual nesta release** — a criação da tag gera validação e
+  GitHub Release, mas não executa `npm publish`; a promoção ao registry fica
+  sob controle explícito do mantenedor.
+- **Quality telemetry** — relatório JSON/Markdown exige os 10 gates, rejeita
+  gates ausentes, duplicados ou inesperados e invalida evidências antigas.
+- **README redesenhado** — proposta de valor, quickstart, fluxos Nano/Standard/
+  Full, runtime-first, adoção por equipes e métricas verificáveis agora formam
+  uma narrativa única e orientada ao uso.
+
+### Evidência da release
+
+- 10/10 quality gates aprovados.
+- 384/384 testes do runtime e mais de 600 testes raiz.
+- 30/30 cenários smoke, runtime real, recovery e multiagente.
+- Cobertura: 83,06% lines/statements, 92,63% functions e 61,77% branches.
+- `npm audit`: 0 vulnerabilidades.
+- Tarball npm: 506 arquivos; VSIX: 13 participantes ativados em host real.
+
+## [1.15.0] — 2026-06-27
+
+### `.oxe/` enxuto no install + mapa vivo de artefatos
+
+Resposta ao feedback de que a quantidade de pastas criadas no install era grande
+demais e dificultava entender o fluxo versus o que de fato foi/será criado.
+
+- **Lazy scaffolding** — `oxe-cc init-oxe`/`install` agora cria só o núcleo
+  essencial: `.oxe/STATE.md`, `.oxe/config.json` e `.oxe/README.md` (legenda
+  gerada). As ~13 subpastas e os arquivos operacionais (`codebase/`,
+  `capabilities/`, `investigations/`, `global/`, `sessions/`, `memory/`,
+  `runs/`, `EXECUTION-RUNTIME.md`, `ACTIVE-RUN.json`, `OXE-EVENTS.ndjson`,
+  `CHECKPOINTS.md`, `CAPABILITIES.md`, `INVESTIGATIONS.md`, …) passam a nascer
+  **sob demanda**, no primeiro uso do workflow correspondente.
+- **Catálogo único de artefatos** (`bin/lib/oxe-artifact-catalog.cjs`) — fonte
+  da verdade que descreve cada artefato do `.oxe/` (path, propósito, origem,
+  grupo) e da qual derivam legenda, mapa e docs (uma definição, três saídas).
+- **`oxe-cc map`** — mapa vivo anotado do `.oxe/`: o que já existe, o que está
+  disponível sob demanda e o estado de cada item (`✓ ativo · ◦ vazio ·
+  ⚠ desatualizado · · sob demanda`). `oxe-cc map --json` (`oxeMapSchema: 1`)
+  para hosts; exposto no SDK como `artifacts.buildMapModel` / `renderLegend`.
+- **`.oxe/README.md` gerado** — legenda local de todos os artefatos, escrita no
+  init e **re-renderizada por `oxe-cc doctor`** (documentação forte sem pastas
+  vazias).
+- **STATE.md enxuto** — template reduzido de 141 → ~30 linhas (fase, sessão,
+  próximo passo, decisões, bloqueios). As ~15 seções opcionais foram movidas
+  para `oxe/templates/STATE-REFERENCE.md`, anexadas sob demanda.
+- **`doctor`/`status` sem falsos-positivos** — a ausência de artefato lazy agora
+  é estado normal (não gera aviso); inconsistências reais (STATE diz X mas o
+  artefato não existe) continuam detectadas.
+- Novos contratos documentados em `docs/INTEGRATION.md`; testes em
+  `tests/oxe-map.test.cjs` + contrato `map --json` em
+  `tests/oxe-integration-contracts.test.cjs`.
+
+## [1.14.0] — 2026-05-30
+
+### Contratos de integração para hosts — reatividade + dashboard embutível
+
+Aditivo — nenhum contrato existente muda. Complementa o 1.13.0 (`status --json --summary`, `agentSkills`) para hosts como o OXESpace embutirem o oxe-cc de forma reativa e visual.
+
+- **`oxe events --tail [N] --json [--since <evt_id>] [--session <s>]`** — projeção read-only e versionada (`oxeEventsSchema: 1`) do log append-only `.oxe/OXE-EVENTS.ndjson`: `{ summary: { total, byType, lastEvent }, events: [...] }`. `--since` devolve só os eventos novos desde um `event_id` conhecido (leitura incremental). Reusa `operational.readEvents`/`summarizeEvents`. Um host normalmente observa o arquivo e chama `status --json --summary`; este comando é a forma documentada de ler o tail sem reparsear tudo.
+- **`oxe dashboard --json`** — emite **uma linha** estável e versionada (`oxeDashboardSchema: 1`) com `{ url, port, readOnly, projectRoot }` assim que o servidor sobe, e **continua servindo**. Permite a um host capturar URL/porta de forma robusta e embutir o dashboard num webview, em vez de raspar o banner humano. Combine com `--no-open --port 0` para porta efêmera.
+- **`dashboard --port 0`** agora seleciona uma porta efêmera de verdade (antes caía no default `4173`).
+- **`docs/INTEGRATION.md`** — contrato estável para hosts: `status --json --summary`, `agentSkills`, schema do `OXE-EVENTS.ndjson`, `events --json` e `dashboard --json`; marca o que é estável vs experimental.
+
+---
+
+## [1.13.0] — 2026-05-29
+
+### Contratos de integração para hosts (IDEs, OXESpace)
+
+Aditivo — nenhum contrato existente muda. Facilita hosts consumirem o oxe-cc.
+
+- **`oxe status --json --summary`** — projeção compacta e versionada (`oxeSummarySchema: 1`) com `workspaceMode, phase, healthStatus, activeSession, nextStep, cursorCmd, reason, eventsCount, warningsCount` + um `agentSkills` compacto. Troca ~150KB do status completo por <1KB para o "glance" que um host precisa.
+- **`agentSkills` no `status --json`** e **`agentSkillsReport(target)` no SDK** (`health.agentSkillsReport`) — status das skills `/oxe-*` por agente no workspace (`copilot-vscode`, `codex`, `copilot-cli`): `detected/skillsInstalled/skillsPath/status/issues`. Permite a um host detectar skills ausentes e oferecer instalação **antes** de lançar o agente (resolve o "Failed to load N skills").
+- **SDK**: `health.buildStatusSummary(report)` e `health.agentSkillsReport(target)` exportados + tipados em `lib/sdk/index.d.ts`.
+
+---
+
+## [1.12.0] — 2026-05-12
+
+### Agent Mode, Swarm Mode, Memory Kernel & Learning Kernel
+
+Esta release transforma o OXE em um sistema autônomo orientado a objetivos. O usuário escreve `/oxe <objetivo em linguagem natural>` e o Conductor decide automaticamente o fluxo, os agentes e a estratégia de execução — sem precisar escolher comandos manualmente.
+
+#### Conductor Agent (`oxe/workflows/conduct.md`)
+
+- novo workflow que age como ponto de entrada para objetivos de implementação em linguagem natural
+- classifica complexidade em três scores: simples | médio | complexo
+- recupera memória relevante das 5 camadas (runtime_state, session_memory, project_memory, lessons, observations)
+- seleciona personas aplicáveis por `intent_tags` (backend → executor/architect, frontend → ui-specialist, storage → db-specialist, etc.)
+- decide automaticamente **Agent Mode** (simples/médio) ou **Swarm Mode** (complexo/multi-domínio)
+- `oxe/workflows/oxe.md` e `route.md` atualizados: objetivos de implementação redirecionam para `conduct.md`
+
+#### Agent Mode (`oxe/workflows/agent-mode.md`)
+
+- Conductor age sozinho com a persona selecionada para objetivos de 1–2 domínios e ≤ 8 arquivos
+- grava `AGENT-SESSION.json` em `.oxe/agent/` com intent, skills, tool_calls e reconciliação
+- discovery mínimo antes de mutar: confirma write_set, padrões, riscos
+- se write_set exceder threshold para `intent_score=simples`, eleva automaticamente para Swarm Mode
+- `RECONCILIATION.md` gerado ao final com arquivos alterados e objective_satisfied
+
+#### Swarm Mode (`oxe/workflows/swarm-mode.md`)
+
+- orquestração de 5 papéis em pipeline controlado: Scout → Coordinator → Builder(s) → Reviewer → Verifier
+- **Scout** (`oxe/workflows/swarm/scout.md`): produz CODEBASE-MAP.md, PATTERNS.md, RISK-MAP.md, FILE-CANDIDATES.json e TEST-CANDIDATES.json antes de qualquer mutação
+- **File Ownership** (`FILE-OWNERSHIP.json`): cada Builder declara `write_set`; conflitos → Coordinator serializa em waves sequenciais
+- **Board** (`oxe/workflows/swarm/board.md`): BOARD.md e BOARD.json atualizados em tempo real por fase
+- **Quality Gates** automáticos: arquivo high-risk → gate humano; cobertura abaixo de threshold → gate auto
+- **Reviewer**: produz `.oxe/swarm/reviews/<task_id>-REVIEW.md` por tarefa antes de integração
+- **Verifier/Integrator**: FINAL-INTEGRATION.md com evidências completas e VERIFY.md atualizado
+- novo schema `oxe/schemas/swarm-run.schema.json` (JSON Schema Draft-07) para SWARM-RUN.json
+
+#### Memory Kernel (`oxe/workflows/memory.md` + `bin/lib/oxe-memory-kernel.cjs`)
+
+- ativa o modelo de 4 camadas de memória já definido em `oxe-operational.cjs:2364`
+- `retrieveMemory(projectRoot, intentTags, phase, objective)`: filtra fragmentos por relevância e phase; ranking por score (tag match, impacto, frequência)
+- `saveContextPack()`: grava context pack em `.oxe/agent/MEMORY-INJECTIONS.md` ou `.oxe/swarm/DECISIONS.md` + snapshot auditável em `.oxe/memory/retrieved/<phase>.md`
+- novos templates: `REPO-MEMORY.template.md` (decisões cross-session, pitfalls, preferências, padrões validados) e `MEMORY-INDEX.template.json`
+
+#### Learning Kernel (`oxe/workflows/distill.md` + `bin/lib/oxe-learning-kernel.cjs`)
+
+- detecta padrões automaticamente ao final de cada run: blocker_pattern, success_pattern, anti_pattern, file_conflict_pattern, integration_gap, scope_expansion
+- atualiza `LESSONS.md` com dedup correto (Frequência++ para lições repetidas, não duplicatas)
+- popula `lessons-metrics.json` com `outcomes` e `success_rate` por lição; deprecação automática se `success_rate < 0.5` e `apply_count >= 3`
+- enfileira skill candidatas em `.oxe/learning/PROMOTION-QUEUE.md` quando padrão aparece em 2+ runs
+- atualiza `REPO-MEMORY.md` com decisões arquiteturais e pitfalls novos
+
+#### Skill Runtime (`bin/lib/oxe-skill-loader.cjs`)
+
+- `loadSkill(id, projectRoot)`: resolve por ordem de precedência projeto → capabilities → global
+- `listSkills()`: enumera active/proposed/archived/global por diretório
+- `selectPersonasForIntent(intentTags, projectRoot)`: mapeia intent_tags para personas primárias e secundárias
+- `recordSkillsLoaded()`: grava snapshot das personas ativas em `.oxe/agent/SKILLS-LOADED.json`
+
+#### Event Bus (`bin/lib/oxe-event-bus.cjs`)
+
+- `OXE-EVENTS.ndjson` passa a ser efetivamente populado durante runs (antes: schema definido, nunca emitido)
+- helpers tipados: `emitRunStarted`, `emitWorkItemCompleted`, `emitWorkItemBlocked`, `emitRunCompleted`, `emitGateRequested`, `emitGateResolved`, `emitLessonPromoted`, `emitRetroPublished`
+- `readEvents(projectRoot, filters)`: leitura com filtro por `run_id`, `type`, `since`
+
+#### Runtime contracts
+
+- `workflow-runtime-contracts.json` atualizado com contratos semânticos para todos os 5 novos workflows (conduct, agent-mode, swarm-mode, memory, distill)
+- `help.md` router: nova entrada de prioridade máxima para objetivos de implementação → `/oxe <objetivo>` → Conductor
+
+#### Templates adicionados
+
+- `.oxe/templates/AGENT-SESSION.template.json`
+- `.oxe/templates/swarm/SWARM-RUN.template.json`
+- `.oxe/templates/swarm/FILE-OWNERSHIP.template.json`
+- `.oxe/templates/swarm/BOARD.template.md`
+- `.oxe/templates/swarm/QUALITY-GATES.template.md`
+- `.oxe/templates/REPO-MEMORY.template.md`
+- `.oxe/templates/MEMORY-INDEX.template.json`
+- `.oxe/templates/learning/CANDIDATES.template.ndjson`
+- `.oxe/templates/learning/PROMOTION-QUEUE.template.md`
+
+---
+
+## [1.11.0] — 2026-05-06
+
+### Spec Lifecycle Automation & CLI Gaps
+
+Esta release fecha os gaps de adoção identificados na análise de maturidade v1.10.0, com foco em automação do ciclo de vida do SPEC, configuração de provider e tolerância de formato no parser de planos.
+
+#### Automação do ciclo de vida (SPEC.md)
+
+- nova função `applySpecChecklistSync` em `oxe-operational.cjs`: ao executar `runtime project` com um run `completed`, marca automaticamente `**DoD Wave N:**` e seções MVP/v0.x.x do checklist no `SPEC.md` com `[x]`
+- v1.0.0 checklist não é marcado automaticamente — requer sign-off explícito
+- exportada no módulo para testes de integração e uso programático
+
+#### CLI — `runtime execute`
+
+- novo flag `--agents-plan <path>`: override explícito para localização do `plan-agents.json`, com prioridade sobre detecção automática por sessão e raiz do projeto
+- novo flag `--api-key-env <VAR>`: lê API key de variável de ambiente nomeada em vez de `OXE_LLM_API_KEY`
+- novo subcomando `runtime configure`: wizard interativo que persiste `baseUrl`, `model`, `apiKey` em `.oxe/config.json` (seção `runtime.provider`)
+
+#### Provider LLM auto-wired
+
+- `createExecutionContext` passa a instanciar `PolicyEngine.fromConfigFile()` automaticamente quando `.oxe/config.json` contém seção `runtime.policy`
+- `loadRuntimeProviderConfig` / `saveRuntimeProviderConfig` exportados de `oxe-operational.cjs`
+- health checks de `runtime.provider` e `runtime.policy` adicionados ao `oxe-cc status`
+
+#### Parser de planos — tolerância de formato (Gap E)
+
+- `parsePlan` agora aceita `**Verificação:**`, `**Verify command:**` e `**Verification:**` além do formato `Verificação:` sem negrito
+- planos gerados por LLM com markdown bold deixam de silenciosamente omitir verify commands
+
+#### Spec-criteria enrichment (Gap B)
+
+- `compileExecutionGraphFromArtifacts` extrai comandos backtick dos campos `howToVerify` dos critérios de aceite da SPEC e os anexa a `node.verify.command` quando ausente no PLAN
+
+#### Testes e benchmark
+
+- novo `test:runtime-llm` (`scripts/test-runtime-llm.cjs`): valida `LlmTaskExecutor` end-to-end com LLM real; skipa automaticamente quando `OXE_LLM_API_KEY` não está definido
+- novo `benchmark:autonomy` (`scripts/benchmark-autonomy.cjs`): 5 fixtures de referência (simple → medium → parallel), mede taxa de compilação→execução→verify sem intervenção; saída em `.oxe/release/benchmark-autonomy-report.json`
+- novos testes: `gap-spec-enrichment.test.cjs` (5 casos) e `gap-spec-checklist-sync.test.cjs` (4 casos)
+
+## [1.10.0] — 2026-05-05
+
+### Operational Maturity
+
+Esta release amplia a prova operacional do OXE para cenários mais próximos de uso real, sem abrir novos comandos públicos.
+
+- `test:runtime-real` passa a cobrir cenários multi-wave, multi-file, gate pendente, verify parcial e promoção bloqueada por ausência de evidência técnica
+- `workspace-merge-report.json` passa a carregar `evidence_refs`, `diff_summary`, arquivos aplicados, status de verify pós-execução e próxima ação operacional por task
+- `status`, `runtime status` e `runtime agents status` expõem merge readiness, blockers e próxima ação multi-agent de forma mais direta
+- `workspaceMode: product_package` deixa de marcar `contextQuality` como crítico quando não há ciclo OXE ativo no próprio repositório do pacote
+- smoke multi-runtime reforça Codex e Copilot VS Code com validação explícita de prompts/skills, manifesto e referências quebradas
+- `doctor --release` passa a validar o conteúdo mínimo dos relatórios runtime-real e multi-agent-real da linha `1.10.0`
+- `/oxe-spec` passa a ter contrato multimodal: imagens, screenshots e mockups enviados no chat devem virar `VISUAL-INPUTS.md/json`, anchors visuais e readiness bloqueante quando críticos para UI/fluxo
+
+## [1.9.1] — 2026-05-04
+
+### Multi-Agent Real
+
+Esta release endurece a coordenação multi-agent sobre workspaces reais, sem abrir novos comandos públicos.
+
+- multi-agent real passa a exigir workspaces isolados `git_worktree` para modos `parallel`, `competitive` e `cooperative`
+- `runtime execute` valida `plan-agents.json` antes de iniciar agentes e usa `GitWorktreeManager` por padrão no caminho multi-agent
+- novo artefato por run `.oxe/runs/<run_id>/workspace-merge-report.json` com worktrees, ownership, merge blockers e readiness
+- `runtime agents status --json`, `status --json` e recovery passam a expor merge readiness, blockers, arbitration e worktrees órfãos
+- novo `npm run test:multi-agent-real` gera `.oxe/release/multi-agent-real-report.json` usando repositório git temporário com worktrees reais
+- `doctor --release` passa a exigir `multi-agent-real-report.json` em versões `>=1.9.1`
+
+## [1.9.0] — 2026-05-04
+
+### Runtime Real Maturity
+
+Esta release eleva a maturidade prática do OXE com foco em prova determinística do ciclo real `spec -> plan -> execute -> verify -> status/doctor`, sem abrir novos comandos públicos.
+
+#### Runtime real
+
+- nova suíte `test:runtime-real` valida projetos representativos com executor mockado e sem chamada a LLM/API externa
+- `runtime execute` passa a bloquear antes da mutação quando confiança, rationality packs ou gates não estão prontos
+- `runtime verify` continua evidence-first e passa a ser validado dentro do fluxo real de execução
+
+#### Release proof
+
+- novo relatório obrigatório `.oxe/release/runtime-real-report.json`
+- `doctor --release` passa a bloquear publicação quando a prova de runtime real estiver ausente ou falha
+- novo `release:pack-check` valida o tarball npm em dry-run contra artefatos indevidos
+
+## [1.8.3] — 2026-05-04
+
+### Release readiness e higiene de publicação
+
+Esta release consolida a linha `1.8.3` para publicação no npm com foco em consistência de versão, alinhamento documental e pacote distribuído mais limpo.
+
+#### Publicação
+
+- alinhamento da versão `1.8.3` entre manifesto raiz, runtime, extensão VS Code, README e changelog
+- fechamento do gate oficial `doctor --release` para a linha atual
+- preparação do pacote npm para sair sem drift entre versão publicada e documentação principal
+
+#### Higiene do pacote
+
+- exclusão dos arquivos `.vsix` históricos da extensão VS Code do tarball npm
+- manutenção apenas do código-fonte da extensão dentro do pacote, evitando distribuir binários legados desnecessários
+
+## [1.8.2] — 2026-04-30
+
+### Fluxo inicial mais coerente e geração de `spec`/`plan` mais forte
+
+Esta release fecha a linha de robustez do ciclo `install -> status/doctor -> /oxe -> spec -> plan -> execute -> verify` sem abrir nova superfície pública. O foco foi remover ruído operacional em projetos novos e aumentar a densidade executável dos artefatos que o OXE induz.
+
+#### Fluxo operacional
+
+- `install`, `status` e `doctor` passam a convergir em `/oxe` como próximo passo canônico para projetos recém-inicializados
+- `doctor` e `status` deixam de tratar `IMPLEMENTATION-PACK`, `REFERENCE-ANCHORS` e `FIXTURE-PACK` como blocker primário antes de existir `PLAN.md`
+- o relatório racional agora marca o estado sem plano como `não aplicável ainda`, sem contaminar o próximo passo
+- instalações e desinstalações locais por runtime continuam simétricas, com inferência de artefatos locais preservada
+
+#### Indução mais forte de SPEC e PLAN
+
+- `SPEC.template.md` passou a exigir outcome observável, público-alvo, restrições técnicas, setup externo, conteúdo/fluxos obrigatórios e contratos esperados para o plano
+- `PLAN.template.md` ganhou contrato operacional da solução, densidade operacional mínima, `symbols alvo`, `estado/fluxo coberto` e `fixture/anchor obrigatório` por tarefa
+- `oxe/workflows/spec.md` agora força extração explícita de blocos de interface, conteúdo mínimo, interações, responsividade e acessibilidade em demandas de produto/app/UI
+- `oxe/workflows/plan.md` agora endurece o gate de confiança `>90%` para tarefas mutáveis vagas e exige fechamento mais forte de interface, conteúdo, estado persistido, anchors e fixtures em apps/UI estáticos
+
+#### Testes
+
+- novo teste cobrindo o estado racional não bloqueante antes da existência de `PLAN.md`
+- suíte focada de CLI/health atualizada para manter o comportamento novo estável
+
+## [1.8.1] — 2026-04-30
+
+### Hotfix — Gaps implementados no fonte TypeScript (não em arquivos compilados)
+
+A v1.8.0 aplicou as 5 correções críticas diretamente nos arquivos `.js` compilados (`lib/runtime/`), que são sobrescritos a cada `npm run build:runtime`. Esta release porta todas as correções para o fonte TypeScript em `packages/runtime/src/`, tornando-as permanentes.
+
+#### Correções portadas para TypeScript
+
+- **`models/failure.ts`**: `FailureClass` agora inclui `'verify'` e `'llm'` como classes canônicas
+- **`scheduler/scheduler.ts`**: `TaskResult` com campo opcional `completed_by`; `TaskExecutor.execute()` aceita `options?: { previousError? }`; `verifyNode()` importa e chama `verifyRun` da fonte TS; `executeNode()` repassa `options`; `requestGateForNode()` com warning quando manager ausente
+- **`executor/built-in-tools.ts`**: `finishTask` handler + registro em `BUILT_IN_TOOLS`
+- **`executor/action-tool-map.ts`**: `finish_task` injetado universalmente em `selectToolsForActions()`
+- **`executor/node-prompt-builder.ts`**: parâmetro `options`, seção de retry context, instrução `finish_task`
+- **`executor/llm-task-executor.ts`**: detecção de `finish_task`, `completed_by` no retorno, `turn_limit_exhausted` retorna `success: false`
+
+#### Testes
+- 542 testes passando (era 542 na v1.8.0, nenhuma regressão)
+- 36 testes de gaps (gap1–gap5) todos passando contra o código compilado
+
+---
+
+## [1.8.0] — 2026-04-29
+
+### Autonomous Execution — 5 Critical Gaps Resolved
+
+Esta release eleva a autonomia do runtime de ~65% para ~85%+ em projetos de baixo a médio risco, tornando o OXE capaz de transformar um input bem estruturado em entrega verificada com mínima intervenção humana.
+
+#### Gap 1 — GateManager Wiring
+- `createExecutionContext()` exportada de `oxe-operational.cjs`: instancia `GateManager` real sempre que o runtime estiver disponível, eliminando o deadlock silencioso de `'gate-missing-manager'`
+- `scheduler.js`: warning explícito quando `ctx.gateManager` ausente em vez de falha silenciosa
+- Novo subcomando `oxe-cc runtime execute` com roteamento automático single-agent / multi-agent
+
+#### Gap 2 — Verificação Inline após cada tarefa
+- `Scheduler.verifyNode()`: executa o `verify.command` do nó logo após execução bem-sucedida, antes de emitir `WorkItemCompleted`
+- Falha de verificação → tarefa reentrada no loop de retry com `failure_class: 'verify'`
+- Falha de infraestrutura de verificação (comando inexistente, timeout) → não bloqueia progresso
+- Eventos `VerificationStarted` / `VerificationCompleted` emitidos por tarefa (reducer já existia)
+
+#### Gap 3 — Retry Inteligente com Contexto do Erro Anterior
+- `node-prompt-builder.js`: seção "Contexto da tentativa anterior" injetada automaticamente nas tentativas 2+ com stderr/output truncado em 2000 chars
+- `llm-task-executor.js`: aceita `options.previousError`; repassado para o prompt builder
+- `scheduler.js`: `lastError` rastreado e propagado entre tentativas via `executeNode(options)`
+
+#### Gap 4 — Sinal Autoritativo de Conclusão (`finish_task`)
+- Nova tool built-in `finish_task` (idempotente) registrada em `BUILT_IN_TOOLS` e `ALL_BUILT_IN_SCHEMAS`
+- `selectToolsForActions()`: `finish_task` injetada universalmente em todos os tipos de ação
+- `node-prompt-builder.js`: instrução explícita de chamar `finish_task` ao concluir
+- `llm-task-executor.js`: detecta chamada de `finish_task` → `completed_by: 'finish_task'`; turns esgotados sem `finish_task` → `success: false, failure_class: 'llm'`
+
+#### Gap 5 — MultiAgentCoordinator Wiring
+- `runRuntimeExecute()` exportada de `oxe-operational.cjs`: detecta `plan-agents.json` (sessão > raiz) e roteia para `MultiAgentCoordinator` (parallel/competitive/cooperative) ou `Scheduler` single-agent
+- `oxe-cc runtime execute`: novo subcomando CLI com output formatado e exit code em falhas
+
+#### Testes
+- 5 novos arquivos de teste cobrindo cada gap: `gap1-gate-manager`, `gap2-inline-verify`, `gap3-retry-context`, `gap4-finish-task`, `gap5-multi-agent`
+- Suite total: **543 testes passando**, 0 falhas
+
+### Validation
+
+- `node --test tests/*.cjs tests/*.test.js`
+- `node bin/oxe-cc.js --version`
+
+---
+
+## [1.7.0] — 2026-04-23
+
+### OXE-native Agent Catalog
+
+- adicionada a fonte canónica `oxe/agents/` com agentes especializados para plan, execute, verify, debug, research, codebase mapping, integração, validação e UI
+- o instalador multi-runtime agora distribui agentes OXE para Claude Code (`.claude/agents`) e Codex/Antigravity (`.agents/skills` / skills compatíveis), além dos comandos já existentes
+- uninstall e smoke matrix passaram a validar e remover os agentes gerados pelo OXE
+
+### Rational Execution Artifacts
+
+- templates de `PLAN`, `IMPLEMENTATION-PACK`, `REFERENCE-ANCHORS`, `FIXTURE-PACK` e `SUMMARY` foram endurecidos com contratos goal-backward, write-set, símbolos, sequência mínima, rollback, fixtures e evidência
+- `/oxe-plan`, `/oxe-execute`, `/oxe-verify`, `/oxe-debug`, `/oxe-forensics`, `/oxe-ui-spec` e `/oxe-ui-review` agora referenciam explicitamente os agentes e gates racionais compatíveis com runtime enterprise
+
+### Public Surface Hygiene
+
+- `scan:assets` agora bloqueia referências públicas a namespaces, paths e nomes de origem legada
+- criado `docs/CONTENT-MIGRATION-AUDIT.md` como trilha interna de incorporação, sem exposição nas superfícies instaladas
+
+## [1.6.0] — 2026-04-23
+
+### Product Reconciliation
+
+- a árvore canónica `oxe/` foi restaurada como source of truth da release, incluindo `oxe/workflows/`, `oxe/workflows/references/`, `oxe/templates/` e `commands/oxe/` como superfície derivada sincronizada
+- `workflow-runtime-contracts.json` voltou a ser contrato obrigatório da release; `sync-runtime-metadata` agora falha fechado quando a fonte canónica ou o registry semântico estão ausentes/inválidos
+- `doctor --release` passou a bloquear explicitamente por topologia canónica ausente, contrato semântico inválido e drift entre workflows e wrappers
+
+### Package-vs-Workspace Health
+
+- `status`, `status --full`, dashboard e SDK agora distinguem `workspaceMode: product_package` de `workspaceMode: oxe_project`
+- no repositório do pacote, o próximo passo deixa de cair em `plan/replan` por ruído de manutenção e passa a apontar para `doctor --release --write-manifest`
+- `status --json` passou a expor `workspaceMode` e `releaseReadiness` como contrato estável da linha `1.6.0`
+
+### Multi-runtime Edge Hardening
+
+- a smoke matrix de release passou a validar a instalação do Codex de forma completa: prompts em `.codex/prompts/` e skills em `.agents/skills/oxe/`
+- documentação de instalação foi ajustada para separar `--local` (layout do repo) de `--ide-local` (escopo da integração), eliminando a ambiguidade operacional em runtimes como Codex
+
+### Validation
+
+- `node --test tests/oxe-project-health.test.cjs`
+- `node --test tests/oxe-cli-edge.test.cjs`
+- `npm test`
+- `npm run scan:assets`
+- `npm run release:doctor`
+
+## [1.5.1] — 2026-04-22
+
+### Rational Execution Readiness
+
+- `/oxe-plan` passou a exigir e propagar artefatos racionais de execução: `IMPLEMENTATION-PACK`, `REFERENCE-ANCHORS` e `FIXTURE-PACK`
+- `/oxe-execute` agora é `pack-first` e bloqueia mutação quando confiança `<= 90%`, quando os packs estão incompletos ou quando há `critical_gap` aberto
+- `doctor`, `status --json`, dashboard e SDK passaram a expor `implementationPackReady`, `referenceAnchorsReady`, `fixturePackReady`, `executionRationalityReady` e `criticalExecutionGaps`
+
+### Session Compatibility
+
+- o health report agora faz fallback explícito entre artefatos session-scoped e artefatos ainda materializados na raiz `.oxe/`, evitando falso negativo de readiness em workspaces legados
+- o gate racional foi limitado ao estágio pré-execução; depois de `executing`/`verify_complete`, os packs continuam diagnósticos, mas não reescrevem o próximo passo do ciclo
+
+### Publication Alignment
+
+- versão alinhada para `1.5.1` em pacote raiz, runtime package, extensão VS Code, README e lockfile
+- matriz pública de smoke runtime atualizada para refletir a release `1.5.1`
+
+### Validation
+
+- `npm test`
+- `npm run scan:assets`
+- `npm run release:manifest`
+- `npm run build:vscode-ext`
+
+## [1.5.0] — 2026-04-21
+
+### Release Readiness 5/5
+
+- `doctor --release --write-manifest` virou gate formal de publicação, com verificação bloqueante de versões, topo do `CHANGELOG`, runtime compilado, wrapper sync e relatórios obrigatórios
+- a release agora persiste `release-manifest.json`, `runtime-smoke-report.json`, `recovery-fixture-report.json` e `multi-agent-soak-report.json` em `.oxe/release/`
+- `npm test` passou a incluir smoke matrix multi-runtime, fixtures reproduzíveis de recovery/incidente e soak multi-agent
+
+### Operational Proof
+
+- nova smoke matrix obrigatória para Cursor, Copilot VS Code, Claude Code, Codex, OpenCode, Gemini, Windsurf e Antigravity, cobrindo install, entrypoint `oxe`, resolução de workflow e uninstall granular
+- novo corpus de incidentes em `tests/fixtures/runtime-incidents/` para provar `runtime replay` e `runtime recover` fora do caminho feliz
+- multi-agent passou a gerar e auditar `multi-agent-summary.json`, incluindo timeouts e reassignments
+
+### Publication Contract
+
+- versão alinhada para `1.5.0` em pacote raiz, runtime package, extensão VS Code, README e lockfile
+- README, AGENTS e SDK docs atualizados para refletir o gate de release, os relatórios obrigatórios e o contrato estável desta publicação
+
+### Validation
+
+- `npm test`
+- `npm run scan:assets`
+- `npm run release:doctor`
+
+## [1.4.0] — 2026-04-20
+
+### Runtime Publication Stabilization
+
+- `execute` e `verify` passaram a documentar e propagar o contrato `runtime-first`, com fallback legado explícito quando o runtime enterprise não estiver disponível
+- `runtime gates` ganhou superfície operacional estável com `list`, `show`, `resolve`, filtros (`--run`, `--status`, `--scope`, `--task`) e `--json`
+- `status --json` e `runtime status --json` consolidam `runtimeMode`, `fallbackMode`, `gateQueue`, `policyCoverage`, `promotionReadiness`, `recoveryState`, `multiAgent` e `providerCatalog`
+- dashboard web passou a expor cards operacionais para gates, recovery, promotion e multi-agent, incluindo resolução de gates pela UI
+- replay/recovery ficaram orientados a incidente com saída estruturada, reconciliação de run state e summaries derivados
+- `multi-agent` foi endurecido como GA apenas sobre workspaces isolados reais; modos `parallel`, `competitive` e `cooperative` falham explicitamente em `inplace`
+- SDK ampliado com `GateQueueSnapshot`, `replayRuntimeState`, `readRuntimeMultiAgentStatus` e alias `multiAgentStatus`
+
+### Release Preparation
+
+- alinhamento de versão para `1.4.0` em `package.json`, `package-lock.json`, `packages/runtime/package.json`, `vscode-extension/package.json`, banner e README
+- alinhamento de licença da extensão VS Code com o pacote principal e inclusão de `vscode-extension/LICENSE` para empacotamento limpo do VSIX
+- licença do projeto alterada de `GPL-3.0` para `MIT`, com manifests e documentação pública alinhados
+- README atualizado para refletir o momento atual do produto, o contrato estável de publicação e a superfície enterprise do CLI/runtime
+- `lib/sdk/README.md` e `AGENTS.md` atualizados para refletir os bridges do runtime enterprise e o comportamento `runtime-first`
+
+### Adoção em Times (v1.4.0 final)
+
+- `QUICKSTART.md` — guia de onboarding "primeiros 15 minutos": install, primeiro ciclo (6 comandos), runtime-first, validação dos 5 minutos
+- `docs/ROLES.md` — guia por papel: executor, reviewer, operador de gate, mantenedor do pacote; cada papel com o que lê, decide e pode ignorar
+- `docs/TEAM-ADOPTION.md` — fluxo branch/PR recomendado, ship local vs. promote remoto, sessões e workstreams, governança mínima
+- `docs/WALKTHROUGH.md` — walkthrough completo reproduzível: spec → plan → execute → verify → gate → promotion com outputs esperados
+- `docs/INCIDENT-PLAYBOOK.md` — gate stale, run bloqueada, RECOVERY-SUMMARY, dashboard como painel operacional
+- `docs/RUNTIME-SMOKE-MATRIX.md` — matriz 8 runtimes × 6 operações com pressupostos e comportamentos por runtime
+- `oxe-cc doctor` — health gates para IDEs (Copilot, Cursor, Claude Code), detecção de runtime compilado, readiness gate summary com próximo passo derivado da fase atual
+- `oxe-cc status` — IDE readiness summary inline, gates pendentes no modo padrão (sem `--full`), diagnóstico de bloqueio explícito (SPEC/PLAN/VERIFY ausentes)
+- `runtime gates list` — ícones visuais `⏳ pending` / `⚠ stale (>Nh)` / `✓ resolved`, ação sugerida e impacto no ciclo por gate
+- `runtime gates resolve` — mensagem de impacto pós-resolução: "Run pode avançar" ou "N gates restantes"
+- `.github/workflows/release.yml` — pipeline de publicação: validate → publish-npm (com provenance) → build-vsix → create-release com extração automática do CHANGELOG
+- `.github/workflows/ci.yml` — novos jobs `doctor` (gate de qualidade operacional) e `wrapper-audit` (sync entre wrappers e contrato canônico)
+- `README.md` — seção `## Para times` com links para todos os novos docs; link `→ Guia por papel` na seção "Momento atual do produto"
+
+### Validation
+
+- suíte root + runtime continua verde
+- scanner de assets/markdown continua íntegro
+
+---
+
+## [1.3.0] — 2026-04-20
+
+### Reasoning Contracts & Semântica Multi-Runtime
+
+- Contratos de raciocínio v2.0.0 (`oxe_contract_version: 2.0.0`) em todos os workflows e wrappers de runtime
+- Novos campos de metadata: `oxe_reasoning_mode`, `oxe_question_policy`, `oxe_output_contract`, `oxe_tool_profile`, `oxe_confidence_policy`, `oxe_context_tier`
+- `oxe_semantics_hash` (SHA-256 16 chars) para detecção de drift semântico entre IDEs
+- Módulo `bin/lib/oxe-runtime-semantics.cjs` gerencia o contrato canônico: `buildReasoningContractBlock()`, `buildContextTiers()`, `auditRuntimeTargets()`, `computeSemanticsHash()`
+- `auditRuntimeTargets()` varre Copilot prompts, commands e Cursor commands e reporta divergências entre wrappers e o contrato canônico
+- Prompts e commands sincronizados para todos os runtimes: Cursor, GitHub Copilot, Claude Code, OpenCode, Codex, Gemini CLI, Windsurf, Antigravity
+
+### Novos Módulos bin/lib
+
+- **`oxe-dashboard.cjs`** — servidor HTTP local (porta 9000), `loadDashboardContext()`, API REST com `/api/health/status`, `/api/plan/info`, `/api/runtime/gates/{id}/status`, `/api/runtime/gates/resolve`; suporte a PLAN-REVIEW.md com comentários e status de aprovação
+- **`oxe-runtime-semantics.cjs`** — gestão de metadados de workflow e contratos de raciocínio: `getWorkflowContract()`, `getAllWorkflowContracts()`, `validateWorkflowContractsRegistry()`, `buildContextPackPaths()`, `buildReasoningContractBlock()`, `splitFrontmatter()`, `parseFrontmatterMap()`
+- **`oxe-operational.cjs`** expandido — monitoramento de agents, gates, evidências e estado de run com maior granularidade
+- **`oxe-project-health.cjs`** expandido — métricas de saúde: test scores, coverage, violations, integração Copilot
+
+### Comandos e Superfície
+
+- **`oxe-ship`** — cria commit local guiado por `SPEC.md`, `PLAN.md` e `VERIFY.md`; disponível em todos os runtimes suportados
+- **`oxe-skill`** — gestão e composição de skills com roles `@executor` e `@researcher`
+- Contrato de raciocínio declarado em todos os workflows: `discovery`, `planning`, `execution`, `review`, `status`
+- Regra pack-first em todos os wrappers: lê `.oxe/context/packs/<slug>.md` antes de cair para leitura direta
+
+### Testes e Cobertura
+
+- Novos testes unitários para `oxe-runtime-semantics.cjs`: 31 testes cobrindo todas as 19 funções exportadas
+- Novos testes para `oxe-plugins.cjs`: 28 testes para `loadPlugins`, `runHook`, `validatePlugins`, `initPluginsDir`, `resolvePluginSources`
+- Novos testes para `oxe-security.cjs`: `checkPathSafety`, `scanFileForSecrets`, `scanDirForSecretFiles`, `validatePlanPaths`
+- Cobertura de linhas: **80.28% → 82.28%** (superando threshold de 82%)
+- Total: **383 testes** passando (root + runtime)
+
+---
+
+## [1.2.1] — 2026-04-18
+
+### Branding, Semântica e Empacotamento
+
+- remove referências remanescentes ao framework legado dos workflows e do diagnóstico de integração Copilot
+- alinha `package.json`, `package-lock.json`, banner CLI e README para `1.2.1`
+- corrige deriva semântica do workflow `ship`, registrando-o no contrato canônico multi-runtime
+- adiciona prompt files de `ship` para Copilot/Cursor
+- remove o comando `auto` da superfície pública do OXE
+- remove o comando `intel` da superfície pública do OXE
+- reposiciona `ship` para fechar o ciclo com commit local guiado por `SPEC.md`, `PLAN.md` e `VERIFY.md`
+
+---
+
+## [1.2.0] — 2026-04-18
+
+### Runtime Hardening & Robustez (Fases 1–9)
+
+**Fase 1 — Runtime Hardening**
+
+- `RunJournal` persistido em `.oxe/runs/{runId}/journal.json`: gravado a cada onda, atualizado no pause/cancel
+- `Scheduler.pause()` agora grava journal e retorna `status: 'paused'` em vez de apenas setar flag in-memory
+- `Scheduler.recover(runId, ctx, graph)` — retoma run pausado pelo journal; pula nós já completados
+- `Scheduler.getJournal()` e `Scheduler.loadJournal(projectRoot, runId)` para inspeção
+- `RunState` expandido: `retryCounts`, `policyDecisions`, `pendingGates`, `resolvedGates`, `verificationStatus`, `evidenceRefs`, `toolFailures`
+- Reducer: handlers para `RetryScheduled`, `PolicyEvaluated`, `GateRequested`, `GateResolved`, `VerificationStarted`, `VerificationCompleted`, `ToolFailed`, `EvidenceCollected`
+- Helpers: `getRetryCount`, `getPolicyDecision`, `getVerificationStatus`, `getEvidenceRefs`, `getToolFailures`
+
+**Fase 2 — Policy, Side Effects e Security**
+
+- `SideEffectClass` enum: `read_fs|write_fs|spawn_process|network_call|git_mutation|db_change|secret_access|infra_operation`
+- `AutonomyTier` type: `L0|L1|L2|L3` — tier controla quais side effects são permitidos automaticamente
+- `NodePolicyConfig` com `mutation_budget` e `autonomy_tier`
+- `EnvironmentGuardrail` com `protected_paths`, `protected_branches`, `require_human_gate_on`
+- Guardrails default: paths `.env`, `package.json`, `.oxe/config.json`; gate automático para `infra_operation`, `db_change`, `secret_access`
+- `PolicyEngine.withGuardrail(g)` para customizar guardrails por projeto
+- `side_effect_class` e `autonomy_tier` em `PolicyWhenClause` para regras direcionadas
+
+**Fase 3 — Verify Operational**
+
+- `VerificationManifest` formal: persistido em `.oxe/runs/{runId}/verification-manifest.json`
+- `VerificationProfile`: `quick|standard|critical` — controla quais `FailureClass` geram riscos residuais
+- `FailureClass` taxonomy: `deterministic|flaky|timeout|env_setup|policy_failure|evidence_missing`
+- `classifyFailure(result)` — classifica automaticamente cada `CheckResult`
+- `buildManifest(runId, results, options)` — compila manifest por work item, onda ou run
+- `ResidualRiskLedger` persistido em `.oxe/runs/{runId}/residual-risks.json`
+- `buildRiskLedger(runId, manifest)` — gera ledger de riscos residuais a partir do manifest
+
+**Fase 4 — Delivery Native**
+
+- `MergeGateEvaluator.evaluate(runResult, manifest, ledger)` — avalia se run está pronto para merge
+- Bloqueios: tarefas failed/blocked, verificação falha, riscos `high`/`critical`
+- `PromotionPipeline.promote(runResult, manifest, ledger, opts)` — cria PR draft via `gh`, persiste `RunPRLink`
+- `PromotionPipeline.buildPRBody(...)` — corpo do PR com resumo, verificação e riscos residuais
+- `RunPRLink` persistido em `.oxe/runs/{runId}/pr-link.json`
+
+**Fase 5 — Context Engineering Avançado**
+
+- `ContextPackStore`: `savePack`, `loadPack`, `markStale`, `isStale`, `listPackMeta` — packs persistidos em `.oxe/runs/{runId}/context-pack-{workItemId}.json`
+- `ContextPackMeta` com `estimated_tokens`, `stale`, `stale_reason`
+- `diffPacks(before, after)` — detecta added/removed/score_changed entre versões de pack
+- Índice global por run em `context-packs.index.json`
+
+**Fase 6 — Decision Engine / Seniority**
+
+- `DecisionEngine.evaluate(input)` — avalia policy, gate, retry budget, risk, lesson match e retorna `DecisionRecord` com `type`, `seniority`, `confidence` e `rationale`
+- Tipos de decisão: `proceed|retry|escalate_gate|skip|abort|promote_lesson`
+- `SeniorityLevel`: `junior|standard|senior|expert` derivado da confidence
+- `appendDecision`, `loadDecisionLog`, `queryDecisions` — log persistido em `.oxe/runs/{runId}/decisions.json`
+
+**Fase 7 — Multi-Agent Robusto**
+
+- `AgentRegistry` com heartbeat tracking por agente
+- `registry.beat(id, currentTask)` — atualiza last_seen e status
+- `registry.isAlive(id)` — detecta timeout configurável por instância
+- `registry.timedOut()` / `registry.liveAgents()` — filtragem por liveness
+- `registry.failover(fallbackAgentId)` — reassigna tasks de agentes expirados para fallback
+- `registry.setStatus(id, status)` — transições manuais de estado
+
+**Fase 8 — ABI Estável de Plugins**
+
+- `PluginManifest` com `abi_version`, `capabilities`, declared providers
+- `extractManifest(plugin)` — extrai manifest de qualquer `OxePlugin`
+- `validatePlugin(plugin)` — retorna `{ valid, errors, warnings }` com checagem de nome, semver, providers
+- `isAbiCompatible(version)` — garante compatibilidade de major version
+- `sandboxInvoke(fn, timeoutMs)` — execução com timeout e isolamento de erro para plugins
+
+**Fase 9 — Enterprise Operations**
+
+- `AuditTrail` — registro imutável NDJSON em `.oxe/AUDIT-TRAIL.ndjson`
+- 14 tipos de ação auditáveis: `run_started`, `secret_accessed`, `infra_mutation`, `merge_approved`, etc.
+- Severity automática por ação (`info|warn|critical`)
+- `AuditTrail.query(filter)` — filtra por action/severity/runId/since
+- `RunQuota` — `createQuota`, `consumeQuota`, `checkQuota` para limitar work_items, mutations e retries por run
+
+### Testes
+
+- Runtime: **266 testes** (↑ de 145 pré-robustez)
+- Root: 321 testes (sem regressões)
+- Total: **587 testes** passando
+
+---
+
+## [1.1.0] — 2026-04-18
+
+### Mudança de superfície (simplificação estratégica de produto)
+
+**Trilha principal reduzida a 6 comandos**
+
+O OXE agora se comporta como um framework guiado por etapas. A superfície pública foi reorganizada em três níveis:
+
+**Trilha principal (6 comandos):**
+- `/oxe` — entrada universal (absorve ask, next, route, help)
+- `/oxe-quick` — modo nano sem cerimônia
+- `/oxe-spec` — spec com flags: `--refresh`, `--full`, `--research`, `--ui`
+- `/oxe-plan` — planejamento test-first
+- `/oxe-execute` — implementação com flags: `--note`, `--debug`, `--deep-diagnosis`, `--checkpoint`, `--iterative`
+- `/oxe-verify` — validação e fechamento com flags: `--gaps`, `--security`, `--ui`, `--pr`, `--diff`, `--skip-retro`
+
+**Trilha avançada:** `/oxe-session` (absorve project, milestone, workstream), `/oxe-dashboard`
+
+**Administrativa:** `/oxe-capabilities`, `/oxe-skill`, `oxe-cc azure`
+
+### Depreciado (v1.1.0)
+
+Os seguintes comandos foram incorporados por estágios principais e continuam funcionando com aviso de migração:
+
+| Comando | Novo destino |
+|---------|-------------|
+| `/oxe-ask` | `/oxe "pergunta"` |
+| `/oxe-scan` | `/oxe-spec --refresh` |
+| `/oxe-research` | `/oxe-spec --research` |
+| `/oxe-ui-spec` | `/oxe-spec --ui` |
+| `/oxe-obs` | `/oxe-execute --note` |
+| `/oxe-debug` | `/oxe-execute --debug` |
+| `/oxe-forensics` | `/oxe-execute --deep-diagnosis` |
+| `/oxe-checkpoint` | `/oxe-execute --checkpoint` |
+| `/oxe-loop` | `/oxe-execute --iterative` |
+| `/oxe-validate-gaps` | `/oxe-verify --gaps` |
+| `/oxe-security` | `/oxe-verify --security` |
+| `/oxe-ui-review` | `/oxe-verify --ui` |
+| `/oxe-review-pr` | `/oxe-verify --pr` |
+| `/oxe-retro` | `/oxe-verify` (retro automática) |
+| `/oxe-project` | `/oxe-session milestone\|workstream` |
+| `/oxe-compact` | `/oxe-spec --refresh` |
+| `/oxe-next` | `/oxe` (sem argumento) |
+| `/oxe-route` | `/oxe "intenção"` |
+| `/oxe-milestone` | `/oxe-session milestone` |
+| `/oxe-workstream` | `/oxe-session workstream` |
+
+### Novos comportamentos
+
+- **Retro automática:** `/oxe-verify` executa automaticamente retrospectiva ao fechar (`--skip-retro` para desativar)
+- **Pergunta situacional inline:** `/oxe "pergunta"` substitui `/oxe-ask`
+- `/oxe-session` agora suporta `milestone` e `workstream` como subcomandos
+
+---
+
+## [0.8.0] — 2026-04-14
+
+### Adicionado
+
+**Session forking + revert**
+- `session fork [nome]` — bifurca a sessão ativa, copiando todos os artefatos para uma nova sessão; rastreia `forked_from` na SESSION.md
+- `session revert <checkpoint-slug>` — restaura STATE.md ao snapshot de um checkpoint, sem apagar artefatos atuais
+
+**Skill system**
+- `/oxe-skill` — workflow para descobrir, invocar e gerenciar skills (unificação de personas e capabilities)
+- `@<skill-id>` no chat resolve persona OU capability OU composite como ponto de entrada único
+- Template `SKILL.template.md` para criação de skills de projeto em `.oxe/skills/`
+- Resolução em 3 camadas: project → capabilities → global (personas do pacote)
+
+**Sistema de permissões com wildcard**
+- `permissions[]` em `.oxe/config.json` — regras glob+ação que controlam acesso a arquivos durante execute e apply
+- Ações: `allow`, `deny`, `ask` — avaliação first-match wins
+- Scopes: `execute`, `apply`, `all`
+- Gate automático no workflow execute antes de cada onda
+
+**Config hierárquico (system → user → project)**
+- `loadOxeConfigMerged()` agora lê 3 níveis: system (`OXE_SYSTEM_CONFIG` ou path OS-default) < user (`~/.oxe/config.json`) < project (`.oxe/config.json`)
+- `status --full` exibe fontes de cada nível de configuração
+- Campo `sources` no retorno do SDK
+
+**Event sourcing com replay**
+- `replayEvents()` no SDK — reconstrói timeline de `OXE-EVENTS.ndjson` com deltas, filtros por run/wave/event
+- `oxe-cc runtime replay [--run <id>] [--from <event-id>] [--wave <n>] [--write]` — visualização de timeline no terminal ou `REPLAY-SESSION.md` em disco
+- Integração com `/oxe-forensics` — replay como ferramenta de investigação
+
+**Plugin system com carregamento remoto**
+- `plugins[]` em `config.json` aceita `{ source: "npm:<pkg>" }` e `{ source: "path:./file.cjs" }`
+- `oxe-cc plugins list` — lista plugins carregados (local + externos)
+- `oxe-cc plugins install npm:<pkg>` — instala plugin npm em `.oxe/plugins/_npm/`
+- `resolvePluginSources()` e `installNpmPlugin()` expostos no SDK
+
+### Tipos TypeScript
+- `OxePermissionRule`, `PermissionCheckResult`, `ReplayReport`, `PluginSource` adicionados
+- `security.checkFilePermission`, `security.checkPermissions`, `security.globToRegex` declarados
+- `operational.replayEvents` declarado
+- `plugins.resolvePluginSources`, `plugins.installNpmPlugin` declarados
+- `health.loadOxeConfigMerged` retorna `sources: { system, user, project }`
+
+---
+
+## [0.7.0] — 2026-04-13
+
+### Adicionado
+
+**Provider Azure nativo (`oxe-cc azure`)**
+- `azure status` — estado compacto read-only: CLI, login, subscription, inventário, pendências, alerta VPN
+- `azure operations list` — histórico colorido de operações (planned/applied/pending)
+- `azure find --type <serviço>` — filtro por família de serviço (servicebus, eventgrid, sql)
+- `azure find --filter-rg <rg>` — filtro por resource group
+- `azure sync --diff` — mostra recursos adicionados/removidos em relação ao snapshot anterior
+- `azure apply --dry-run` — pré-visualiza comando `az` sem executar nem criar artefatos
+- `azure auth login --tenant <id>` — suporte a Entra ID corporativo; passa `--tenant` ao `az login`
+- `azure apply --vpn-confirmed` — confirma conexão VPN quando `vpn_required: true` está configurado
+
+**SDK**
+- `azure.diffInventory(previousItems, currentItems)` — compara snapshots de inventário (adicionados/removidos/unchanged)
+- `azure.statusAzure(projectRoot, config?, options?)` — status compacto sem writes
+
+**Workflows (guardrails)**
+- `scan.md`: detecção Azure é informativa — não altera fluxo canônico OXE nem aciona steps Azure automaticamente
+- `plan.md`: pré-check Azure só ativa quando Azure é mencionado **explicitamente** na SPEC ou `.oxe/cloud/azure/` existe
+- `discuss.md`: perguntas Azure só ativam quando SPEC menciona Azure explicitamente — SQL genérico (PostgreSQL, MySQL, on-prem) não aciona o bloco
+
+### Corrigido
+- `loginAzure()` com `inherit: true` não passava mais `inherit` para `getAzureContext`, evitando crash ao tentar ler `account.id` de stdout null
+
+### Tipos TypeScript
+- `azure.searchAzureInventory` inclui parâmetro opcional `filters?: { type?, resourceGroup? }`
+- `azure.diffInventory` declarado
+- `azure.statusAzure` declarado
+
+---
+
+## [0.6.3] — 2026-04-04
+
+### Corrigido
+- `security_in_verify` agora é reconhecido como chave válida em `.oxe/config.json` (não mais rejeitado pelo doctor como "unknown key")
+- `plan-agents.schema.json`: enum atualizado de `[1, 2]` para `[2, 3]`; campos `persona` e `model_hint` adicionados ao schema dos agentes
+
+### Adicionado
+- **`/oxe-retro` sugerido automaticamente** pelo `oxe-cc status` quando `phase: verify_complete` e `.oxe/LESSONS.md` ainda não existe
+- **`health.parseLastRetroDate(stateText)`** — parseia campo `last_retro: YYYY-MM-DD` do STATE.md
+- **`health.isStaleLessons(retroDate, maxDays)`** — detecta se LESSONS.md está desatualizado (par de `isStaleScan`)
+- **`health.planAgentsWarnings(target)`** — avisa sobre schema 1 (legado) e `model_hint` inválido em `plan-agents.json`
+- **`parseState()`** retorna novo campo `lastRetroDate: string | null`
+- `OxeHealthReport` inclui `retroDate: Date | null`
+- `config.template.json` inclui `security_in_verify: false` por padrão
+- `plan-agents.template.json` inclui campo `persona` no agente-exemplo
+- Melhorias de workflow: `obs.md` (tabela de classificação de impacto), `verify.md` (success_criteria camadas 5+6), `next.md` (flag de promoção QUICK→spec), `quick.md` (incorporação de OBSERVATIONS), `plan.md` (nota de replan + plan-agents sync)
+- `AGENTS.md` atualizado para v0.6.x
+
+### Tipos TypeScript
+- `ParsedState` inclui `lastRetroDate: string | null`
+- `OxeHealthReport` inclui `retroDate: Date | null`
+- `health.*` expõe `parseLastRetroDate`, `isStaleLessons`, `planAgentsWarnings`
+
+---
+
+## [0.6.2] — 2026-04-04
+
+### Adicionado
+- **`/oxe-retro`** — workflow de retrospectiva de ciclo; sintetiza 3–5 lições prescritivas em `.oxe/LESSONS.md`
+- `oxe/templates/LESSONS.template.md`
+- Correções de consistência de schema (plan-agent.md, verify.md): referências atualizadas para schema v3
+
+### Alterado
+- README: tabela "Como cada comando fica mais inteligente" expandida com loop, security, research thinking_depth, model_hint
+- Cadeia de help (`oxe.md`) atualizada para incluir `/oxe-retro` após verify
+
+---
+
+## [0.6.1] — 2026-04-04
+
+### Adicionado
+- **`/oxe-security`** — auditoria OWASP Top 10 filtrada pelo stack; produz `.oxe/SECURITY.md` com achados P0/P1/P2
+- **`/oxe-loop`** — execução iterativa de onda com retries automáticos e diagnóstico inline
+- **Model hints** em `plan-agents.json` schema v3: campo `model_hint` (`fast | balanced | powerful`) por agente
+- **Thinking depth** em `/oxe-research`: classificação `surface | standard | deep` com raciocínio estendido para `deep`
+- Integração automática de security no verify via `security_in_verify: true` (Camada 6)
+- `oxe/templates/SECURITY.template.md`
+
+---
+
+## [0.6.0] — 2026-04-04
+
+### Adicionado
+- Workflow `/oxe-project` unificando `milestone`, `workstream`, `checkpoint`
+- `/oxe-obs` com propagação automática para R-IDs e Tns afetados
+- Auto-reflexão semântica em `/oxe-spec` (Fase 4b): detecta contradições e escopo creep antes da aprovação
+- Modo de execução A/B/C em `/oxe-execute` (Completo / Por onda / Por tarefa)
+- Debug inline automático em falhas de execute
+- 4 profiles de execução: `balanced`, `strict`, `fast`, `legacy`
+- Sistema de personas para agentes (`oxe/personas/`)
+- Plugin lifecycle (`.oxe/plugins/*.cjs`)
+- `scale_adaptive`: scan sugere profile pelo tamanho do projeto
+
+---
+
+## [0.5.0] — anterior
+
+Versões anteriores não documentadas neste arquivo.