oxe-cc 0.6.5 → 0.7.0

package/.cursor/commands/oxe-ask.md

@@ -0,0 +1,11 @@
+---
+description: "OXE — Perguntar pela situação atual com leitura robusta de STATE, sessão ativa e artefatos relevantes"
+---
+
+OXE — Perguntar pela situação atual com leitura robusta de STATE, sessão ativa e artefatos relevantes
+
+Executa o workflow **OXE ask** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+
+`oxe/workflows/ask.md`
+
+Usa o texto adicional desta mensagem como pergunta e foco.

package/.cursor/commands/oxe-capabilities.md

@@ -0,0 +1,11 @@
+---
+description: "OXE — gerir capabilities nativas do projeto"
+---
+
+OXE — gerir capabilities nativas do projeto
+
+Executa o workflow **OXE capabilities** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+
+`oxe/workflows/capabilities.md`
+
+Usa o texto adicional desta mensagem como ação sobre capabilities.

package/.cursor/commands/oxe-dashboard.md

@@ -0,0 +1,11 @@
+---
+description: "OXE — visualizar runtime, ondas, checkpoints e saúde operacional da trilha"
+---
+
+OXE — visualizar runtime, ondas, checkpoints e saúde operacional da trilha
+
+Executa o workflow **OXE dashboard** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+
+`oxe/workflows/dashboard.md`
+
+Usa o texto adicional desta mensagem como foco opcional.

package/.github/prompts/oxe-ask.prompt.md

@@ -0,0 +1,12 @@
+---
+name: oxe-ask
+agent: agent
+description: "OXE — Perguntar pela situação atual com leitura robusta de STATE, sessão ativa e artefatos relevantes"
+argument-hint: "[pergunta em texto livre]"
+---
+
+Executa o workflow **OXE ask** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+
+`oxe/workflows/ask.md`
+
+Usa o texto adicional desta mensagem como pergunta e foco.

package/.github/prompts/oxe-capabilities.prompt.md

@@ -0,0 +1,12 @@
+---
+name: oxe-capabilities
+agent: agent
+description: "OXE — gerir capabilities nativas do projeto"
+argument-hint: "[list|install <id>|remove <id>|update]"
+---
+
+Executa o workflow **OXE capabilities** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+
+`oxe/workflows/capabilities.md`
+
+Usa o texto adicional desta mensagem como ação sobre capabilities.

package/.github/prompts/oxe-dashboard.prompt.md

@@ -0,0 +1,12 @@
+---
+name: oxe-dashboard
+agent: agent
+description: "OXE — visualizar runtime, ondas, checkpoints e saúde operacional da trilha"
+argument-hint: "[foco opcional]"
+---
+
+Executa o workflow **OXE dashboard** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+
+`oxe/workflows/dashboard.md`
+
+Usa o texto adicional desta mensagem como foco opcional.

package/CHANGELOG.md

@@ -4,6 +4,39 @@ Todas as versões seguem [Semantic Versioning](https://semver.org/). As mudança
 
 ---
 
+## [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

package/README.md

@@ -9,6 +9,8 @@
 
 **Versão:** `0.6.4` · [package.json](package.json)
 
+**Framework OXE — Orchestrated eXperience Engineering**
+
 ```bash
 npx oxe-cc@latest
 ```
@@ -19,27 +21,65 @@ npx oxe-cc@latest
 
 ## O que é o OXE
 
-OXE é um **framework de desenvolvimento assistido por IA** baseado em três princípios:
+> **OXE é a camada de disciplina entre você e seu agente de IA. Qualquer agente, qualquer IDE, qualquer projeto — o mesmo ciclo estruturado, com histórico persistente que melhora a cada entrega.**
+
+OXE é o **Framework OXE — Orchestrated eXperience Engineering**: um framework de desenvolvimento assistido por IA orientado por artefatos, contexto em disco e execução verificável. Funciona identicamente em Cursor, GitHub Copilot, Claude Code, Gemini CLI, Windsurf e qualquer outro agente — o estado fica em `.oxe/` no seu projeto, não preso a nenhuma IDE.
+
+Ele se apoia em três princípios:
 
 - **Spec-driven design** — antes de escrever código, você define *o que* construir e *como saber que está pronto*. Essa especificação restringe e guia tudo o que vem depois.
 - **Context engineering** — o estado do trabalho fica em arquivos pequenos dentro de `.oxe/`, não na memória do chat. O agente lê o que precisa, quando precisa — sem sobrecarregar o contexto com decisões já tomadas.
+- **Lessons loop** — ao fim de cada ciclo, `/oxe-retro` extrai 3–5 lições prescritivas que o próximo spec/plan lê automaticamente. Depois de alguns ciclos, os planos ficam dramaticamente melhores porque os erros anteriores não se repetem.
 - **Plan-Driven Dynamic Agents** — quando há múltiplos domínios, o plano cria agentes específicos para *aquela demanda*. Agentes não são reaproveitados entre projetos ou demandas.
 
-O resultado: **menos requisições**, **mais coerência**, e um fluxo que funciona do mesmo jeito em qualquer IDE.
+O resultado: **menos requisições**, **mais coerência**, e uma experiência de engenharia orquestrada que funciona do mesmo jeito em qualquer IDE.
 
 ---
 
-## Os 8 comandos que você precisa conhecer
+## Modos de uso
+
+Escolha a complexidade certa para sua tarefa. Você sempre começa simples e adiciona estrutura quando precisar.
+
+### Nano — 1 comando
+Para tarefas pequenas e pontuais, sem overhead:
+```
+/oxe-quick → objetivo → passos → verify
+```
+
+### Standard — ciclo completo
+Para features, refatorações ou qualquer trabalho com múltiplos arquivos:
+```
+/oxe-scan → /oxe-spec → /oxe-plan → /oxe-execute → /oxe-verify → /oxe-retro
+```
+
+### Full — orquestração avançada
+Para projetos longos, multi-domínio, múltiplos agentes ou times:
+```
+/oxe-session new <nome>   ← isola o ciclo numa sessão
+/oxe-plan --agents        ← blueprint multi-agente
+/oxe-execute              ← com runtime tracking, checkpoints e eventos
+/oxe-dashboard            ← visão web opcional para revisão de equipe
+```
+
+> O README apresenta o modo Standard na maior parte da documentação. O modo Full está descrito em detalhes em cada seção específica.
+
+---
+
+## Comandos principais
 
 ```
 /oxe              → onde estou / o que faço / help
+/oxe-ask          → entender a situação atual com leitura robusta de STATE + sessão + artefatos
+/oxe-capabilities → listar, instalar, remover ou atualizar capabilities nativas do projeto
+/oxe-cc azure     → autenticar, sincronizar inventário e operar Azure com checkpoint formal
 /oxe-obs          → registrei algo importante (incorporado automaticamente)
 /oxe-quick        → tarefa pequena, sem cerimônia
 /oxe-scan         → mapeia o projeto (ou atualiza se já mapeado)
 /oxe-spec         → nova feature: perguntas → requisitos → roteiro
 /oxe-plan         → tarefas por onda (--agents para multi-agente)
-/oxe-execute      → implementar (A: 1 sessão | B: por onda | C: por tarefa)
+/oxe-execute      → implementar (A: completo | B: por onda | C: por tarefa)
 /oxe-verify       → validar que está pronto
+/oxe-dashboard    → visualizar runtime, active run, tracing, ondas, checkpoints e estado operacional
 ```
 
 Tudo o mais é ativado automaticamente por contexto ou chamado só quando necessário.
@@ -48,7 +88,7 @@ Tudo o mais é ativado automaticamente por contexto ou chamado só quando necess
 
 ## Sessões OXE
 
-Sessões organizam um ciclo completo em `.oxe/sessions/sNNN-slug/` sem misturar artefatos de entregas diferentes na raiz. Nesta versão, o suporte fica no layer de **workflows Markdown**: `spec`, `plan`, `execute`, `verify`, `checkpoint`, `research` e afins passam a respeitar `active_session` em `.oxe/STATE.md`, enquanto `oxe-cc status` e `oxe-cc doctor` continuam legados.
+Sessões organizam um ciclo completo em `.oxe/sessions/sNNN-slug/` sem misturar artefatos de entregas diferentes na raiz. `spec`, `plan`, `execute`, `verify`, `checkpoint`, `research` e afins respeitam `active_session` em `.oxe/STATE.md`. `oxe-cc status` e `oxe-cc doctor` também devem refletir a sessão ativa, a autoavaliação do plano e a saúde lógica do fluxo.
 
 ```text
 .oxe/
@@ -91,6 +131,15 @@ Exemplo de ciclo:
 /oxe-session close
 ```
 
+Com sessão ativa:
+
+- `spec/` contém `SPEC.md`, `ROADMAP.md`, `DISCUSS.md`, `UI-SPEC.md`
+- `plan/` contém `PLAN.md`, `QUICK.md`, `plan-agents.json`, `quick-agents.json`
+- `execution/` contém o `STATE.md` operacional da trilha, `EXECUTION-RUNTIME.md`, `CHECKPOINTS.md`, `ACTIVE-RUN.json`, `OXE-EVENTS.ndjson`, `runs/`, `OBSERVATIONS.md`, `DEBUG.md`, `FORENSICS.md`
+- `research/` também pode conter `INVESTIGATIONS.md` e `investigations/` para evidência estruturada
+- `verification/` contém `VERIFY.md`, `VALIDATION-GAPS.md`, `SECURITY.md`, `UI-REVIEW.md`
+- `LESSONS.md`, `MILESTONES.md`, `codebase/`, `SESSIONS.md`, `CAPABILITIES.md`, `capabilities/` e o `STATE.md` global permanecem fora da sessão
+
 ---
 
 ## A cadeia
@@ -100,12 +149,12 @@ Exemplo de ciclo:
      ↓
 /oxe-scan → /oxe-spec → /oxe-plan ──────────→ /oxe-execute → /oxe-verify → /oxe-retro
                               ↓                                                  ↓
-                         /oxe-quick (trabalho pequeno)                    .oxe/LESSONS.md
+                         /oxe-quick (trabalho pequeno)             .oxe/global/LESSONS.md
                                                                                ↓
                                                                     (alimenta o próximo ciclo)
 ```
 
-Cada passo lê o anterior como contexto e escreve seu artefato em `.oxe/`. Nenhum passo depende de você re-explicar o que já foi decidido. Os erros do ciclo anterior não se repetem.
+Cada passo lê o anterior como contexto e escreve seu artefato no escopo correto: raiz `.oxe/` em modo legado, ou `.oxe/sessions/sNNN-slug/` quando `active_session` está definido. Nenhum passo depende de você re-explicar o que já foi decidido.
 
 ---
 
@@ -115,23 +164,28 @@ Cada passo lê o anterior como contexto e escreve seu artefato em `.oxe/`. Nenhu
 |---------|--------------|
 | `/oxe` | Sem input → próximo passo. Com texto → roteamento. Com "help" → 8 comandos. |
 | `/oxe-scan` | Se `.oxe/codebase/` já existe → modo refresh automático. `--full` força scan completo. |
-| `/oxe-spec` | **Auto-reflexão semântica** antes da aprovação: detecta contradições, critérios vagos, escopo creep e conflitos com stack — sem requisição extra. Lê `LESSONS.md` para não repetir erros do ciclo anterior. |
-| `/oxe-plan` | **Test-first:** `Verificar` vem antes de `Implementar` em cada tarefa. `Complexidade: S/M/L/XL` — tarefas XL bloqueiam o gate sem sub-tarefas. Com `--agents`: `model_hint` por agente orienta qual tier de modelo usar (schema v3). |
-| `/oxe-execute` | Execução A/B/C. Se uma tarefa falha: **diagnóstico inline automático** (2-3 hipóteses + fix + retry) — sem precisar de comando separado. Exibe `model_hint` ao iniciar cada agente do blueprint. |
-| `/oxe-verify` | Até 6 camadas por config: audit + critérios + decisões + UAT + gaps (`verification_depth: thorough`) + OWASP (`security_in_verify: true`). Sugere `/oxe-retro` ao concluir. |
-| `/oxe-retro` | Sintetiza 3–5 lições prescritivas em `.oxe/LESSONS.md` — consumidas automaticamente pelo próximo spec/plan. |
+| `/oxe-spec` | **Auto-reflexão semântica** antes da aprovação: detecta contradições, critérios vagos, escopo creep e conflitos com stack — sem requisição extra. Também aplica discovery adaptativo: classifica a demanda, limita rodadas e regista incertezas estruturadas para alimentar a confiança do plano. |
+| `/oxe-plan` | **Test-first:** `Verificar` vem antes de `Implementar` em cada tarefa. Agora o `PLAN.md` também exige `## Autoavaliação do Plano` com rubrica fixa, `Melhor plano atual` e percentual de confiança determinístico. Usa investigações e capabilities conhecidas como evidência de apoio. |
+| `/oxe-execute` | Execução A/B/C. Antes de implementar, valida a autoavaliação do plano e bloqueia execução abaixo do limiar de confiança. Usa `EXECUTION-RUNTIME.md`, `ACTIVE-RUN.json`, `OXE-EVENTS.ndjson` e `CHECKPOINTS.md` para runtime tático, tracing e gates humanos formais. |
+| `/oxe-verify` | Até 6 camadas por config: audit + critérios + decisões + **coerência operacional** (runtime/checkpoints) + **calibração do plano** + UAT + gaps (`verification_depth: thorough`) + OWASP (`security_in_verify: true`). Sugere `/oxe-retro` ao concluir. |
+| `/oxe-retro` | Sintetiza 3–5 lições prescritivas em `.oxe/global/LESSONS.md` — consumidas automaticamente pelo próximo spec/plan. |
 | `/oxe-obs` | Registra observação → propaga automaticamente para R-IDs e Tns afetados no próximo plan/spec/execute. |
 | `/oxe-quick` | Objetivo → passos → agentes opcionais (PDDA lean) → verify. Para correções pontuais e features pequenas. |
 | `/oxe-project` | `milestone` + `workstream` + `checkpoint` em um único comando. |
+| `/oxe-session` | Cria, alterna, retoma, fecha e migra sessões OXE sem misturar artefatos de ciclos diferentes. |
+| `/oxe-ask` | Lê `STATE`, resolve a sessão ativa e responde perguntas situacionais com base nos artefatos reais. |
+| `/oxe-capabilities` | Gera e mantém o catálogo nativo de capabilities do projeto em `.oxe/CAPABILITIES.md` e `.oxe/capabilities/`, com política, side effects e evidência esperada. |
+| `oxe-cc azure` | Provider Azure nativo via Azure CLI: autenticação corporativa com MFA, inventário via Resource Graph e operações guiadas para Service Bus, Event Grid e Azure SQL, sempre com evidência em `.oxe/cloud/azure/`. |
+| `/oxe-dashboard` | Consolida `STATE`, `PLAN`, `ACTIVE-RUN`, trace log, runtime, checkpoints e verify numa visão visual de ciclo, artefatos, ondas, handoffs e aprovação antes do execute. |
 
 ---
 
 ## Quando usar cada modo do execute
 
 ```
-A) Completo   → todas as ondas em 1 sessão  (ideal: Claude, Copilot, Gemini)
-B) Por onda   → onda 1, você verifica, chama de novo  (N sessões)
-C) Por tarefa → máximo controle  (N tarefas = N sessões)
+A) Completo   → todas as ondas numa só execução  (ideal: Claude, Copilot, Gemini)
+B) Por onda   → onda 1, você verifica, chama de novo  (1 rodada por onda)
+C) Por tarefa → máximo controle  (1 rodada por tarefa)
 ```
 
 Se uma tarefa falha: diagnóstico inline automático (2-3 hipóteses → fix → retry). O Modo B inclui loop iterativo com escalada automática para diagnóstico profundo quando necessário.
@@ -153,33 +207,100 @@ Estes não precisam ser decorados — aparecem quando o contexto pede ou quando
 
 ---
 
+## Azure no OXE
+
+O OXE agora tem um provider Azure nativo, local-first, orientado a Azure CLI no Windows. Ele não guarda segredos no repositório: usa a sessão oficial da Azure CLI, materializa contexto em `.oxe/cloud/azure/` e integra esse contexto com `ask`, `spec`, `plan`, `execute`, `verify`, `status`, `doctor`, runtime e dashboard.
+
+Artefatos principais:
+
+- `.oxe/cloud/azure/profile.json`
+- `.oxe/cloud/azure/auth-status.json`
+- `.oxe/cloud/azure/inventory.json`
+- `.oxe/cloud/azure/INVENTORY.md`
+- `.oxe/cloud/azure/SERVICEBUS.md`
+- `.oxe/cloud/azure/EVENTGRID.md`
+- `.oxe/cloud/azure/SQL.md`
+- `.oxe/cloud/azure/operations/`
+
+Comandos principais:
+
+```bash
+# Autenticação (Entra ID corporativo: use --tenant)
+npx oxe-cc azure auth login [--tenant <entra-tenant-id>]
+npx oxe-cc azure auth set-subscription --subscription "<dev-sub-id>"
+npx oxe-cc azure auth whoami
+
+# Diagnóstico e estado compacto
+npx oxe-cc azure doctor
+npx oxe-cc azure status
+
+# Inventário
+npx oxe-cc azure sync [--diff]
+npx oxe-cc azure find servicebus [--type servicebus] [--filter-rg rg-app]
+
+# Histórico de operações
+npx oxe-cc azure operations list
+
+# Service Bus, Event Grid e Azure SQL
+npx oxe-cc azure servicebus plan --kind namespace --name sb-core --resource-group rg-app --location brazilsouth
+npx oxe-cc azure servicebus apply --kind namespace --name sb-core --resource-group rg-app --location brazilsouth --approve
+npx oxe-cc azure servicebus apply --kind namespace --name sb-preview --resource-group rg-app --dry-run
+```
+
+Princípios:
+
+- opt-in: ativado apenas quando a SPEC ou o codebase menciona Azure explicitamente
+- discovery via Azure Resource Graph, não heurística por serviço
+- mutação só com checkpoint formal
+- `--dry-run` em qualquer apply: pré-visualiza o comando `az` sem executar
+- `--vpn-confirmed` para projetos com `vpn_required: true` na config
+- evidência operacional persistida e redacted em `.oxe/cloud/azure/operations/`
+
+---
+
 ## Conceitos-chave
 
 ### Context engineering — estado em disco, não no chat
 
 ```
 .oxe/
-├── STATE.md          ← fase atual, próximo passo, decisões ativas
-├── SPEC.md           ← contrato: critérios A1, A2, …
-├── ROADMAP.md        ← fases de entrega mapeadas a requisitos
-├── PLAN.md           ← tarefas Tn com verificação por item
-├── VERIFY.md         ← resultado da verificação em até 6 camadas
-├── OBSERVATIONS.md   ← observações incorporadas automaticamente
-├── codebase/         ← mapa do repo (stack, estrutura, testes, …)
-├── milestones/       ← arquivo de entregas M-NN
-└── workstreams/      ← trilhas paralelas de desenvolvimento
+├── STATE.md              ← índice global: fase resumida, sessão ativa, próximo passo
+├── SESSIONS.md           ← índice de sessões
+├── CAPABILITIES.md       ← catálogo nativo de capabilities instaladas
+├── INVESTIGATIONS.md     ← índice global de investigações estruturadas
+├── EXECUTION-RUNTIME.md  ← runtime operacional legado / fallback global
+├── ACTIVE-RUN.json       ← cursor e estado durável do run atual
+├── OXE-EVENTS.ndjson     ← tracing append-only local-first
+├── cloud/azure/          ← profile, auth-status, inventory e operações Azure
+├── CHECKPOINTS.md        ← índice de aprovações e gates
+├── global/
+│   ├── LESSONS.md        ← lições prescritivas cumulativas
+│   └── MILESTONES.md     ← marcos globais de entrega
+├── capabilities/
+├── investigations/
+├── dashboard/
+├── codebase/             ← mapa do repo (stack, estrutura, testes, …)
+└── sessions/
+    └── sNNN-slug/
+        ├── spec/         ← SPEC.md, ROADMAP.md, DISCUSS.md, UI-SPEC.md
+        ├── plan/         ← PLAN.md, QUICK.md, blueprints de agentes
+        ├── execution/    ← STATE.md local, OBSERVATIONS.md, DEBUG.md, FORENSICS.md
+        ├── verification/ ← VERIFY.md, VALIDATION-GAPS.md, SECURITY.md, UI-REVIEW.md
+        ├── checkpoints/
+        ├── research/
+        └── workstreams/
 ```
 
-### `/oxe-spec` — spec em 5 fases com auto-reflexão semântica
+### `/oxe-spec` — spec em 5 fases com discovery adaptativo e auto-reflexão semântica
 
 1. **Perguntas** — blocos de 3-5 por rodada, máximo 3 rodadas
-2. **Pesquisa** — proposta inline na Fase 2 (sem sair do spec)
+2. **Pesquisa** — proposta inline na Fase 2 (sem sair do spec), com investigações estruturadas quando houver incerteza relevante
 3. **Requisitos** — tabela R-ID com v1/v2/fora e critérios A*
 4. **Roteiro** — fases de entrega → `.oxe/ROADMAP.md`
-5. **Auto-reflexão** *(automática, sem requisição extra)* — detecta contradições, critérios vagos, escopo creep, conflitos com stack. Corrige antes de apresentar ao usuário.
+5. **Auto-reflexão** *(automática, sem requisição extra)* — detecta contradições, critérios vagos, escopo creep, conflitos com stack e lacunas de evidência. Corrige antes de apresentar ao usuário.
 6. **Aprovação** → instrui `/oxe-plan` ou `/oxe-plan --agents`
 
-A spec lê `.oxe/LESSONS.md` antes de iniciar — lições do ciclo anterior informam as perguntas e os critérios.
+A spec lê `.oxe/global/LESSONS.md` antes de iniciar — lições do ciclo anterior informam as perguntas e os critérios.
 
 ### `/oxe-plan` — test-first com complexidade explícita
 
@@ -192,12 +313,40 @@ Complexidade: S | M | L | XL
 
 Tarefas `XL` bloqueiam o gate sem sub-tarefas ou justificativa. `/oxe-obs` propaga automaticamente constraints para os R-IDs e Tns afetados.
 
+### Runtime operacional e checkpoints
+
+- `PLAN.md` continua estratégico.
+- `EXECUTION-RUNTIME.md` regista a operação real: onda atual, agentes ativos, handoffs, evidências, retries e bloqueios.
+- `ACTIVE-RUN.json` formaliza o run atual: `run_id`, cursor, estado, retries, checkpoints pendentes, evidências e grafo operacional.
+- `OXE-EVENTS.ndjson` regista tracing append-only por evento, local-first.
+- `CHECKPOINTS.md` formaliza gates humanos com política, status `pending_approval`, `approved`, `rejected` e `overridden`.
+- `status`, `doctor` e `verify` usam esses artefatos para auditar se a execução real continua coerente com o plano.
+
+### Runtime tracking e inspeção no terminal
+
+O caminho padrão de inspeção é CLI-first:
+
+```bash
+oxe-cc status --full    # health + coverage matrix + readiness gate no terminal
+oxe-cc runtime status   # run ativo, cursor, onda atual
+```
+
+O `status --full` mostra em ANSI: se SPEC.md, PLAN.md, VERIFY.md e LESSONS.md existem; se o projeto está pronto para executar; autoavaliação do plano; e o próximo passo.
+
+### Dashboard web — opt-in para revisões de equipe
+
+- `oxe-cc dashboard` sobe uma interface web local em `localhost` para revisar o plano antes da execução — indicado para apresentações ou revisões em equipe, não para uso diário.
+- A UI lê os artefatos OXE reais; ela não substitui `PLAN.md`, `STATE.md` ou `VERIFY.md`.
+- A visão inclui ciclo principal, mapa de artefatos, active run, trace log, trilha de ondas, handoffs, checkpoints, agentes, evidências e bloqueios sem criar uma segunda fonte de verdade.
+- `oxe-cc runtime <start|pause|resume|replay|status>` controla explicitamente `ACTIVE-RUN.json`, `runs/` e `OXE-EVENTS.ndjson` no mesmo contrato consumido pelo dashboard.
+- A aprovação visual persiste em `plan_review_status` no `STATE.md`, em `PLAN-REVIEW.md` e em `plan-review-comments.json`.
+
 ### `/oxe-retro` — loop de aprendizado
 
 ```
 /oxe-verify completo
      ↓
-/oxe-retro → 3–5 lições prescritivas → .oxe/LESSONS.md
+/oxe-retro → 3–5 lições prescritivas → .oxe/global/LESSONS.md
                                               ↓
                               /oxe-spec (próximo ciclo lê LESSONS)
                               /oxe-plan (próximo ciclo lê LESSONS)
@@ -281,12 +430,17 @@ node bin/oxe-cc.js --help
 | Comando | O que faz |
 |---------|-----------|
 | `oxe-cc` / `oxe-cc install` | Instala workflows e integrações |
-| `oxe-cc doctor` | Diagnóstico completo: Node, workflows, config, STATE, scan antigo |
-| `oxe-cc status` | Próximo passo sugerido |
-| `oxe-cc status --json` | Mesmo, em JSON (para pipelines) |
+| `oxe-cc doctor` | Diagnóstico completo: Node, workflows, config, bootstrap `.oxe/`, sessão ativa, autoavaliação do plano e saúde lógica (`healthy` \| `warning` \| `broken`) |
+| `oxe-cc status` | Próximo passo sugerido + saúde lógica do fluxo |
+| `oxe-cc status --full` | Coverage matrix + readiness gate + active run no terminal (ANSI) |
+| `oxe-cc status --json` | Mesmo, em JSON, com `healthStatus`, `activeSession` e `planSelfEvaluation` |
 | `oxe-cc update` | Atualiza workflows para a versão mais recente |
 | `oxe-cc init-oxe` | Bootstrap do `.oxe/` (STATE, config, codebase/) |
+| `oxe-cc dashboard` | Interface web local para revisão, comentários e aprovação do plano |
+| `oxe-cc runtime <status\|start\|pause\|resume\|replay>` | Controla o run ativo, cursor, replay e tracing operacional |
+| `oxe-cc capabilities <list\|install\|remove\|update>` | Mantém o catálogo nativo de capabilities em `.oxe/` |
 | `oxe-cc uninstall` | Remove integrações OXE do HOME e do repo |
+| `oxe-cc uninstall --global-cli` | Também remove o pacote npm global do PATH |
 
 ---
 
@@ -298,6 +452,7 @@ Arquivo `.oxe/config.json`. Principais opções:
 |-------|--------|-----------|
 | `profile` | `"balanced"` | `strict` / `balanced` / `fast` / `legacy` |
 | `verification_depth` | `"standard"` | `"thorough"` ativa gaps automático no verify (Camada 5) |
+| `plan_confidence_threshold` | `70` | Limiar mínimo para `execute` aceitar um `PLAN.md` |
 | `security_in_verify` | `false` | `true` ativa OWASP automático no verify (Camada 6) |
 | `discuss_before_plan` | `false` | Exige aprovação de decisões antes do plano |
 | `scale_adaptive` | `true` | Scan sugere o profile pelo tamanho do projeto |
@@ -312,8 +467,8 @@ Arquivo `.oxe/config.json`. Principais opções:
 ```js
 const oxe = require('oxe-cc');
 
-const plan  = oxe.parsePlan(fs.readFileSync('.oxe/PLAN.md', 'utf8'));
-const spec  = oxe.parseSpec(fs.readFileSync('.oxe/SPEC.md', 'utf8'));
+const plan  = oxe.parsePlan(fs.readFileSync('.oxe/PLAN.md', 'utf8')); // ou .oxe/sessions/<id>/plan/PLAN.md
+const spec  = oxe.parseSpec(fs.readFileSync('.oxe/SPEC.md', 'utf8')); // ou .oxe/sessions/<id>/spec/SPEC.md
 const state = oxe.parseState(fs.readFileSync('.oxe/STATE.md', 'utf8'));
 
 const fidelity = oxe.validateDecisionFidelity(discussMd, planMd);

package/bin/banner.txt

@@ -15,4 +15,4 @@
 
 ══════════════════════════════════════════════════════
 
-                      v0.6.5
+                      v0.7.0