oxe-cc 1.9.1 → 1.10.0

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

@@ -9,7 +9,7 @@ oxe_tool_profile: read_heavy
 oxe_confidence_policy: explicit
 oxe_context_tier: standard
 oxe_contract_version: 2.0.0
-oxe_semantics_hash: ebb4473c14e5b080
+oxe_semantics_hash: 13daa3c62e0efaa4
 ---
 
 OXE — visualizar runtime, ondas, checkpoints e saúde operacional da trilha
@@ -25,7 +25,7 @@ OXE — visualizar runtime, ondas, checkpoints e saúde operacional da trilha
 - **Política de confiança:** explícita
 - **Tier de contexto padrão:** padrão
 - **Versão do contrato:** 2.0.0
-- **Checksum semântico:** `ebb4473c14e5b080`
+- **Checksum semântico:** `13daa3c62e0efaa4`
 - **Entrada de contexto prioritária:** `.oxe/context/packs/dashboard.md` e `.oxe/context/packs/dashboard.json`
 - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
 - **Inspeção estruturada:** `oxe-cc context inspect --workflow dashboard --json`

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

@@ -9,7 +9,7 @@ oxe_tool_profile: write_bounded
 oxe_confidence_policy: explicit
 oxe_context_tier: standard
 oxe_contract_version: 2.0.0
-oxe_semantics_hash: 7b3446b77aef9353
+oxe_semantics_hash: 0e6003de070d497f
 ---
 
 OXE — Executar plano (solo ou com agentes): escolha Completo (1 sessão) | Por onda | Por tarefa para controlar requisições
@@ -25,7 +25,7 @@ OXE — Executar plano (solo ou com agentes): escolha Completo (1 sessão) | Por
 - **Política de confiança:** explícita
 - **Tier de contexto padrão:** padrão
 - **Versão do contrato:** 2.0.0
-- **Checksum semântico:** `7b3446b77aef9353`
+- **Checksum semântico:** `0e6003de070d497f`
 - **Entrada de contexto prioritária:** `.oxe/context/packs/execute.md` e `.oxe/context/packs/execute.json`
 - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
 - **Inspeção estruturada:** `oxe-cc context inspect --workflow execute --json`

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

@@ -9,7 +9,7 @@ oxe_tool_profile: mixed
 oxe_confidence_policy: rubric
 oxe_context_tier: standard
 oxe_contract_version: 2.0.0
-oxe_semantics_hash: 5c589398cb807029
+oxe_semantics_hash: 210518babb4788d0
 ---
 
 OXE — Gera .oxe/PLAN.md com verificação por tarefa
@@ -25,7 +25,7 @@ OXE — Gera .oxe/PLAN.md com verificação por tarefa
 - **Política de confiança:** rubrica
 - **Tier de contexto padrão:** padrão
 - **Versão do contrato:** 2.0.0
-- **Checksum semântico:** `5c589398cb807029`
+- **Checksum semântico:** `210518babb4788d0`
 - **Entrada de contexto prioritária:** `.oxe/context/packs/plan.md` e `.oxe/context/packs/plan.json`
 - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
 - **Inspeção estruturada:** `oxe-cc context inspect --workflow plan --json`

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

@@ -9,7 +9,7 @@ oxe_tool_profile: mixed
 oxe_confidence_policy: rubric
 oxe_context_tier: standard
 oxe_contract_version: 2.0.0
-oxe_semantics_hash: 2193373eb2691e0d
+oxe_semantics_hash: ea0c06ca7b5c87bb
 ---
 
 OXE — Modo rápido com Plan-Driven Dynamic Agents lean: objetivo → passos → agentes por domínio (opcional) → verificar
@@ -25,7 +25,7 @@ OXE — Modo rápido com Plan-Driven Dynamic Agents lean: objetivo → passos
 - **Política de confiança:** rubrica
 - **Tier de contexto padrão:** padrão
 - **Versão do contrato:** 2.0.0
-- **Checksum semântico:** `2193373eb2691e0d`
+- **Checksum semântico:** `ea0c06ca7b5c87bb`
 - **Entrada de contexto prioritária:** `.oxe/context/packs/quick.md` e `.oxe/context/packs/quick.json`
 - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
 - **Inspeção estruturada:** `oxe-cc context inspect --workflow quick --json`

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

@@ -9,7 +9,7 @@ oxe_tool_profile: read_heavy
 oxe_confidence_policy: explicit
 oxe_context_tier: standard
 oxe_contract_version: 2.0.0
-oxe_semantics_hash: eea8766eab635c97
+oxe_semantics_hash: 4ec66ac1e704fdbf
 ---
 
 OXE — Spec em 5 fases: perguntas → pesquisa → requisitos (R-ID v1/v2/fora) → roteiro (.oxe/ROADMAP.md) → aprovação → plan
@@ -25,7 +25,7 @@ OXE — Spec em 5 fases: perguntas → pesquisa → requisitos (R-ID v1/v2/fora)
 - **Política de confiança:** explícita
 - **Tier de contexto padrão:** padrão
 - **Versão do contrato:** 2.0.0
-- **Checksum semântico:** `eea8766eab635c97`
+- **Checksum semântico:** `4ec66ac1e704fdbf`
 - **Entrada de contexto prioritária:** `.oxe/context/packs/spec.md` e `.oxe/context/packs/spec.json`
 - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
 - **Inspeção estruturada:** `oxe-cc context inspect --workflow spec --json`
@@ -44,4 +44,4 @@ OXE — Spec em 5 fases: perguntas → pesquisa → requisitos (R-ID v1/v2/fora)
 
 <!-- oxe-workflow-resolution:end -->
 
-Usa o resto desta mensagem e ficheiros anexados como entrada do utilizador.
+Usa o resto desta mensagem e ficheiros anexados como entrada do utilizador. Se houver imagem, screenshot ou mockup e o runtime suportar visão, materializar a interpretação em `VISUAL-INPUTS`; se não suportar, declarar a limitação e não inventar detalhes visuais.

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

@@ -11,7 +11,7 @@ oxe_tool_profile: read_heavy
 oxe_confidence_policy: explicit
 oxe_context_tier: standard
 oxe_contract_version: 2.0.0
-oxe_semantics_hash: ebb4473c14e5b080
+oxe_semantics_hash: 13daa3c62e0efaa4
 ---
 
 <!-- oxe-reasoning-contract:start -->
@@ -25,7 +25,7 @@ oxe_semantics_hash: ebb4473c14e5b080
 - **Política de confiança:** explícita
 - **Tier de contexto padrão:** padrão
 - **Versão do contrato:** 2.0.0
-- **Checksum semântico:** `ebb4473c14e5b080`
+- **Checksum semântico:** `13daa3c62e0efaa4`
 - **Entrada de contexto prioritária:** `.oxe/context/packs/dashboard.md` e `.oxe/context/packs/dashboard.json`
 - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
 - **Inspeção estruturada:** `oxe-cc context inspect --workflow dashboard --json`

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

@@ -11,7 +11,7 @@ oxe_tool_profile: write_bounded
 oxe_confidence_policy: explicit
 oxe_context_tier: standard
 oxe_contract_version: 2.0.0
-oxe_semantics_hash: 7b3446b77aef9353
+oxe_semantics_hash: 0e6003de070d497f
 ---
 
 <!-- oxe-reasoning-contract:start -->
@@ -25,7 +25,7 @@ oxe_semantics_hash: 7b3446b77aef9353
 - **Política de confiança:** explícita
 - **Tier de contexto padrão:** padrão
 - **Versão do contrato:** 2.0.0
-- **Checksum semântico:** `7b3446b77aef9353`
+- **Checksum semântico:** `0e6003de070d497f`
 - **Entrada de contexto prioritária:** `.oxe/context/packs/execute.md` e `.oxe/context/packs/execute.json`
 - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
 - **Inspeção estruturada:** `oxe-cc context inspect --workflow execute --json`

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

@@ -11,7 +11,7 @@ oxe_tool_profile: mixed
 oxe_confidence_policy: rubric
 oxe_context_tier: standard
 oxe_contract_version: 2.0.0
-oxe_semantics_hash: 5c589398cb807029
+oxe_semantics_hash: 210518babb4788d0
 ---
 
 <!-- oxe-reasoning-contract:start -->
@@ -25,7 +25,7 @@ oxe_semantics_hash: 5c589398cb807029
 - **Política de confiança:** rubrica
 - **Tier de contexto padrão:** padrão
 - **Versão do contrato:** 2.0.0
-- **Checksum semântico:** `5c589398cb807029`
+- **Checksum semântico:** `210518babb4788d0`
 - **Entrada de contexto prioritária:** `.oxe/context/packs/plan.md` e `.oxe/context/packs/plan.json`
 - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
 - **Inspeção estruturada:** `oxe-cc context inspect --workflow plan --json`

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

@@ -11,7 +11,7 @@ oxe_tool_profile: mixed
 oxe_confidence_policy: rubric
 oxe_context_tier: standard
 oxe_contract_version: 2.0.0
-oxe_semantics_hash: 2193373eb2691e0d
+oxe_semantics_hash: ea0c06ca7b5c87bb
 ---
 
 <!-- oxe-reasoning-contract:start -->
@@ -25,7 +25,7 @@ oxe_semantics_hash: 2193373eb2691e0d
 - **Política de confiança:** rubrica
 - **Tier de contexto padrão:** padrão
 - **Versão do contrato:** 2.0.0
-- **Checksum semântico:** `2193373eb2691e0d`
+- **Checksum semântico:** `ea0c06ca7b5c87bb`
 - **Entrada de contexto prioritária:** `.oxe/context/packs/quick.md` e `.oxe/context/packs/quick.json`
 - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
 - **Inspeção estruturada:** `oxe-cc context inspect --workflow quick --json`

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

@@ -11,7 +11,7 @@ oxe_tool_profile: read_heavy
 oxe_confidence_policy: explicit
 oxe_context_tier: standard
 oxe_contract_version: 2.0.0
-oxe_semantics_hash: eea8766eab635c97
+oxe_semantics_hash: 4ec66ac1e704fdbf
 ---
 
 <!-- oxe-reasoning-contract:start -->
@@ -25,7 +25,7 @@ oxe_semantics_hash: eea8766eab635c97
 - **Política de confiança:** explícita
 - **Tier de contexto padrão:** padrão
 - **Versão do contrato:** 2.0.0
-- **Checksum semântico:** `eea8766eab635c97`
+- **Checksum semântico:** `4ec66ac1e704fdbf`
 - **Entrada de contexto prioritária:** `.oxe/context/packs/spec.md` e `.oxe/context/packs/spec.json`
 - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
 - **Inspeção estruturada:** `oxe-cc context inspect --workflow spec --json`
@@ -44,4 +44,4 @@ oxe_semantics_hash: eea8766eab635c97
 
 <!-- oxe-workflow-resolution:end -->
 
-Usa o resto desta mensagem e ficheiros anexados como entrada do utilizador.
+Usa o resto desta mensagem e ficheiros anexados como entrada do utilizador. Se houver imagem, screenshot ou mockup e o runtime suportar visão, materializar a interpretação em `VISUAL-INPUTS`; se não suportar, declarar a limitação e não inventar detalhes visuais.

package/CHANGELOG.md

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

package/README.md

@@ -7,7 +7,7 @@
 [![npm](https://img.shields.io/npm/v/oxe-cc.svg?style=flat-square)](https://www.npmjs.com/package/oxe-cc)
 [![license](https://img.shields.io/npm/l/oxe-cc.svg?style=flat-square)](LICENSE)
 
-**Versão:** `1.9.1` · [package.json](package.json)
+**Versão:** `1.10.0` · [package.json](package.json)
 
 **Framework OXE — Orchestrated eXperience Engineering**
 
@@ -34,9 +34,10 @@ 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.
-- **Semântica de raciocínio multi-runtime** — discovery, planning, execution, review e status seguem contratos cognitivos explícitos. O mesmo workflow OXE deve gerar respostas exploratórias, decision-complete e auditáveis em Copilot, Cursor, Claude, Codex e demais runtimes suportados.
+- **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.
+- **Semântica de raciocínio multi-runtime** — discovery, planning, execution, review e status seguem contratos cognitivos explícitos. O mesmo workflow OXE deve gerar respostas exploratórias, decision-complete e auditáveis em Copilot, Cursor, Claude, Codex e demais runtimes suportados.
+- **Entradas visuais rastreáveis** — imagens, screenshots e mockups enviados ao chat são interpretados pelo runtime hospedeiro quando ele tem visão, mas o OXE exige que essa interpretação vire `VISUAL-INPUTS.md/json` e anchors antes de alimentar plan/execute.
 
 O resultado: **menos requisições**, **mais coerência**, e uma experiência de engenharia orquestrada que funciona do mesmo jeito em qualquer IDE.
 
@@ -68,15 +69,16 @@ O OXE já não é só um conjunto de prompts e markdowns. Hoje ele combina:
 
 Em termos práticos, o estado operacional real agora passa por:
 
-- `ACTIVE-RUN.json`
-- `.oxe/runs/<run_id>.json`
-- `.oxe/runs/<run_id>/verification-manifest.json`
-- `.oxe/runs/<run_id>/residual-risk-ledger.json`
-- `.oxe/runs/<run_id>/evidence-coverage.json`
-- `.oxe/execution/GATES.json`
-- `OXE-EVENTS.ndjson`
-
-Contrato estável desta release:
+- `ACTIVE-RUN.json`
+- `.oxe/runs/<run_id>.json`
+- `.oxe/runs/<run_id>/verification-manifest.json`
+- `.oxe/runs/<run_id>/residual-risk-ledger.json`
+- `.oxe/runs/<run_id>/evidence-coverage.json`
+- `.oxe/runs/<run_id>/workspace-merge-report.json`
+- `.oxe/execution/GATES.json`
+- `OXE-EVENTS.ndjson`
+
+Contrato estável desta release:
 
 - `execute` e `verify` são `runtime-first` quando `oxe-cc runtime` está disponível
 - `status`, `doctor`, dashboard e CLI de runtime leem o mesmo estado canónico
@@ -250,7 +252,7 @@ Cada passo lê o anterior como contexto e escreve seu artefato no escopo correto
 | Comando | O que entrega |
 |---------|--------------|
 | `/oxe` | Sem input → próximo passo. Com pergunta → situação atual (artefatos reais). Com "help" → trilha principal. |
-| `/oxe-spec` | **5 fases**: perguntas → pesquisa → requisitos R-ID → roteiro → aprovação. `--refresh` / `--full` fazem scan antes. `--research` ativa spike explícito. `--ui` gera UI-SPEC ao final. **Auto-reflexão semântica** automática antes da aprovação. |
+| `/oxe-spec` | **5 fases**: perguntas → pesquisa → requisitos R-ID → roteiro → aprovação. `--refresh` / `--full` fazem scan antes. `--research` ativa spike explícito. `--ui` gera UI-SPEC ao final. Se houver imagem/screenshot/mockup no chat, materializa `VISUAL-INPUTS` quando o runtime suportar visão ou registra limitação explícita. |
 | `/oxe-plan` | **Test-first:** `Verificar` vem antes de `Implementar` em cada tarefa. `PLAN.md` com `## Autoavaliação do Plano` (rubrica fixa + confiança determinística). Usa investigações e capabilities como evidência. |
 | `/oxe-execute` | Execução A/B/C. Valida autoavaliação antes de implementar. `--note` registra observação. `--debug` aciona diagnóstico inline. `--deep-diagnosis` escalona para forensics. `--checkpoint "<nome>"` cria snapshot. `--iterative` ativa loop de retry. Usa `EXECUTION-RUNTIME.md`, `ACTIVE-RUN.json`, `OXE-EVENTS.ndjson`. |
 | `/oxe-verify` | Até 6 camadas: audit + critérios + decisões + coerência operacional + calibração + UAT. `--gaps` ativa Camada 5 (cobertura). `--security` ativa Camada 6 (OWASP). `--ui` inclui UI-REVIEW. `--pr` / `--diff` incluem revisão de PR. Retro automática ao fechar (`--skip-retro` para desativar). |
@@ -283,7 +285,8 @@ Estes comportamentos continuam existindo, mas agora são ativados como flags dos
 |---------------|-------------|
 | Scan / refresh do codebase | `/oxe-spec --refresh` (incremental) ou `--full` (completo) |
 | Research / spike / engenharia reversa | `/oxe-spec --research` |
-| Contrato UI/UX | `/oxe-spec --ui` |
+| Contrato UI/UX | `/oxe-spec --ui` |
+| Imagem, screenshot ou mockup como entrada de spec | anexar no chat junto com `/oxe-spec`; o OXE materializa a interpretação em `.oxe/investigations/visual/VISUAL-INPUTS.*` quando o runtime tiver visão |
 | Registrar observação durante execução | `/oxe-execute --note "texto"` |
 | Diagnóstico técnico inline | `/oxe-execute --debug` |
 | Diagnóstico pós-falha persistente | `/oxe-execute --deep-diagnosis` |

package/bin/lib/oxe-context-engine.cjs

@@ -231,6 +231,8 @@ function resolveArtifactCandidates(projectRoot, activeSession) {
     reference_anchors: withFallback('reference_anchors', 'reference_anchors', scoped.referenceAnchors, base.referenceAnchors),
     fixture_pack_md: withFallback('fixture_pack_md', 'fixtures', scoped.fixturePackMd, base.fixturePackMd),
     fixture_pack_json: withFallback('fixture_pack_json', 'fixtures', scoped.fixturePackJson, base.fixturePackJson),
+    visual_inputs_md: withFallback('visual_inputs_md', 'visual_inputs', scoped.visualInputsMd, base.visualInputsMd),
+    visual_inputs_json: withFallback('visual_inputs_json', 'visual_inputs', scoped.visualInputsJson, base.visualInputsJson),
     plan_agents: withFallback('plan_agents', 'plan_agents', scoped.planAgents, base.planAgents),
     quick: withFallback('quick', 'plan', scoped.quick, base.quick),
     runtime: withFallback('runtime', 'runtime', scoped.runtime, base.runtime),

package/bin/lib/oxe-operational.cjs

@@ -913,9 +913,11 @@ function readRuntimeMultiAgentStatus(projectRoot, activeSession, options = {}) {
       mergeBlockers: [],
       mergeReadiness: null,
       arbitrationRequired: false,
+      health: 'unknown',
+      nextAction: 'Execute ou compile uma run antes de inspecionar status multi-agent.',
       summary: null,
     };
-  }
+  }
   const runDir = path.join(projectRoot, '.oxe', 'runs', runId);
   const statePath = path.join(runDir, 'multi-agent-state.json');
   const summaryPath = path.join(runDir, 'multi-agent-summary.json');
@@ -931,9 +933,21 @@ function readRuntimeMultiAgentStatus(projectRoot, activeSession, options = {}) {
   const workspaceMergeReport = runtime && typeof runtime.loadWorkspaceMergeReport === 'function'
     ? runtime.loadWorkspaceMergeReport(projectRoot, runId)
     : readJsonIfExists(workspaceMergePath);
-  const handoffs = readJsonIfExists(handoffsPath);
-  const arbitrationResults = readJsonIfExists(arbitrationPath);
-  return {
+  const handoffs = readJsonIfExists(handoffsPath);
+  const arbitrationResults = readJsonIfExists(arbitrationPath);
+  const mergeBlockers = workspaceMergeReport && Array.isArray(workspaceMergeReport.blockers) ? workspaceMergeReport.blockers : [];
+  const mergeReadiness = workspaceMergeReport && workspaceMergeReport.merge_readiness ? workspaceMergeReport.merge_readiness : null;
+  let nextAction = null;
+  if (!state) {
+    nextAction = 'Execute runtime com plan-agents.json válido para materializar o estado multi-agent.';
+  } else if (mergeBlockers.length > 0) {
+    nextAction = 'Resolva os merge blockers do workspace antes de promover ou aplicar novos resultados.';
+  } else if (mergeReadiness === 'partial') {
+    nextAction = 'Conclua verify/evidence pós-merge ou aplique os worktrees pendentes antes de fechar a run.';
+  } else if (mergeReadiness === 'ready') {
+    nextAction = 'Multi-agent merge pronto; avance para runtime verify ou promotion conforme o ciclo.';
+  }
+  return {
     path: statePath,
     enabled: Boolean(state),
     runId,
@@ -942,13 +956,15 @@ function readRuntimeMultiAgentStatus(projectRoot, activeSession, options = {}) {
     agents: state && Array.isArray(state.agent_results) ? state.agent_results : [],
     ownership: state && Array.isArray(state.ownership) ? state.ownership : [],
     orphanReassignments: state && Array.isArray(state.orphan_reassignments) ? state.orphan_reassignments : [],
-    handoffs: Array.isArray(handoffs) ? handoffs : [],
+    handoffs: Array.isArray(handoffs) ? handoffs : [],
     arbitrationResults: Array.isArray(arbitrationResults) ? arbitrationResults : [],
     workspaceMergeReport: workspaceMergeReport || null,
     worktrees: workspaceMergeReport && Array.isArray(workspaceMergeReport.records) ? workspaceMergeReport.records : [],
-    mergeBlockers: workspaceMergeReport && Array.isArray(workspaceMergeReport.blockers) ? workspaceMergeReport.blockers : [],
-    mergeReadiness: workspaceMergeReport && workspaceMergeReport.merge_readiness ? workspaceMergeReport.merge_readiness : null,
+    mergeBlockers,
+    mergeReadiness,
     arbitrationRequired: Boolean(workspaceMergeReport && workspaceMergeReport.arbitration_required),
+    health: summary && summary.health ? summary.health : (mergeBlockers.length > 0 ? 'degraded' : 'unknown'),
+    nextAction,
     summary: summary || null,
   };
 }

package/bin/lib/oxe-project-health.cjs

@@ -658,6 +658,8 @@ function oxePaths(target) {
     referenceAnchors: path.join(oxe, 'REFERENCE-ANCHORS.md'),
     fixturePackMd: path.join(oxe, 'FIXTURE-PACK.md'),
     fixturePackJson: path.join(oxe, 'FIXTURE-PACK.json'),
+    visualInputsMd: path.join(oxe, 'investigations', 'visual', 'VISUAL-INPUTS.md'),
+    visualInputsJson: path.join(oxe, 'investigations', 'visual', 'VISUAL-INPUTS.json'),
     quick: path.join(oxe, 'QUICK.md'),
     verify: path.join(oxe, 'VERIFY.md'),
     discuss: path.join(oxe, 'DISCUSS.md'),
@@ -700,6 +702,8 @@ function scopedOxePaths(target, activeSession) {
     referenceAnchors: path.join(sessionRoot, 'plan', 'REFERENCE-ANCHORS.md'),
     fixturePackMd: path.join(sessionRoot, 'plan', 'FIXTURE-PACK.md'),
     fixturePackJson: path.join(sessionRoot, 'plan', 'FIXTURE-PACK.json'),
+    visualInputsMd: path.join(sessionRoot, 'research', 'investigations', 'visual', 'VISUAL-INPUTS.md'),
+    visualInputsJson: path.join(sessionRoot, 'research', 'investigations', 'visual', 'VISUAL-INPUTS.json'),
     quick: path.join(sessionRoot, 'plan', 'QUICK.md'),
     verify: path.join(sessionRoot, 'verification', 'VERIFY.md'),
     summary: path.join(sessionRoot, 'verification', 'SUMMARY.md'),
@@ -741,6 +745,8 @@ function resolvedReadableOxePaths(target, activeSession) {
     referenceAnchors: preferScoped('referenceAnchors'),
     fixturePackMd: preferScoped('fixturePackMd'),
     fixturePackJson: preferScoped('fixturePackJson'),
+    visualInputsMd: preferScoped('visualInputsMd'),
+    visualInputsJson: preferScoped('visualInputsJson'),
     quick: preferScoped('quick'),
     verify: preferScoped('verify'),
     summary: preferScoped('summary'),
@@ -1317,8 +1323,8 @@ function listOxePromptFiles(dir) {
   if (!fs.existsSync(dir)) return [];
   return fs
     .readdirSync(dir, { withFileTypes: true })
-    .filter((entry) => entry.isFile() && /^oxe-.*\.prompt\.md$/i.test(entry.name))
-    .map((entry) => path.join(dir, entry.name))
+    .filter((entry) => entry.isFile() && (entry.name === 'oxe.prompt.md' || /^oxe-.*\.prompt\.md$/i.test(entry.name)))
+    .map((entry) => path.join(dir, entry.name))
     .sort();
 }
 
@@ -1439,9 +1445,9 @@ function copilotIntegrationReport(target) {
   if (legacyHasOxeBlock) {
     warnings.push('Bloco OXE legado detectado em ~/.copilot/copilot-instructions.md');
   }
-  if (legacyHasOtherManagedBlocks) {
-    warnings.push('copilot-instructions global contém blocos geridos por outro framework; isso pode contaminar respostas do Copilot');
-  }
+  if (legacyHasOtherManagedBlocks) {
+    warnings.push('copilot-instructions global contém blocos geridos por outro framework; isso pode contaminar respostas do Copilot — execute `oxe-cc uninstall --copilot-legacy-clean` se quiser limpar o legado global.');
+  }
   if (!manifestRaw.ok && fs.existsSync(workspace.manifest)) {
     warnings.push(`Manifesto Copilot VS Code inválido: ${manifestRaw.error}`);
   } else if (!fs.existsSync(workspace.manifest) && workspacePromptFiles.length > 0) {
@@ -1856,11 +1862,14 @@ function planSelfEvaluationWarnings(planPath, threshold) {
  *   implementationPackReady: boolean,
  *   referenceAnchorsReady: boolean,
  *   fixturePackReady: boolean,
+ *   visualInputReadiness?: string,
+ *   visualInputsReady?: boolean,
  *   executionRationalityReady: boolean,
  *   criticalExecutionGaps: string[],
  *   implementationPack: { path?: string | null, tasks?: unknown[] } | null,
  *   referenceAnchors: { path?: string | null, anchors?: unknown[], missingCriticalCount?: number } | null,
  *   fixturePack: { path?: string | null, fixtures?: unknown[] } | null,
+ *   visualInputs?: { path?: string | null, inputCount?: number, criticalInputCount?: number } | null,
  * }} summary
  * @returns {string[]}
  */
@@ -1877,6 +1886,9 @@ function executionRationalityWarningsFromSummary(summary) {
   if (!summary.fixturePackReady) {
     warns.push(`FIXTURE-PACK não está pronto em ${summary.fixturePack && summary.fixturePack.path ? summary.fixturePack.path : '.oxe/FIXTURE-PACK.json'}`);
   }
+  if (summary.visualInputReadiness === 'blocked') {
+    warns.push(`VISUAL-INPUTS bloqueado em ${summary.visualInputs && summary.visualInputs.path ? summary.visualInputs.path : '.oxe/investigations/visual/VISUAL-INPUTS.json'}`);
+  }
   if (Array.isArray(summary.criticalExecutionGaps) && summary.criticalExecutionGaps.length) {
     warns.push(...summary.criticalExecutionGaps);
   }
@@ -2191,6 +2203,9 @@ function suggestNextStep(target, cfg = {}) {
     referenceAnchors: p.referenceAnchors,
     fixturePackJson: p.fixturePackJson,
     fixturePackMd: p.fixturePackMd,
+    spec: p.spec,
+    visualInputsJson: p.visualInputsJson,
+    visualInputsMd: p.visualInputsMd,
   });
   if (
     shouldEnforceExecutionRationalityGate(phase)
@@ -2368,6 +2383,9 @@ function buildHealthReport(target) {
     referenceAnchors: p.referenceAnchors,
     fixturePackJson: p.fixturePackJson,
     fixturePackMd: p.fixturePackMd,
+    spec: p.spec,
+    visualInputsJson: p.visualInputsJson,
+    visualInputsMd: p.visualInputsMd,
   });
   const suppressExecutionWorkspaceGates = shouldSuppressExecutionWorkspaceGates(
     workspaceInfo.workspaceMode,
@@ -2520,10 +2538,22 @@ function buildHealthReport(target) {
         contextQuality.primaryStatus = contextPacks[firstWorkflow].context_quality.status;
       }
     }
-  } catch (err) {
-    contextWarn.push(`Contexto — falha ao inspecionar context packs: ${err instanceof Error ? err.message : String(err)}`);
-  }
-  const semanticsManifest = readJsonFileSafe(base.runtimeSemanticsManifest);
+  } catch (err) {
+    contextWarn.push(`Contexto — falha ao inspecionar context packs: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  if (suppressExecutionWorkspaceGates) {
+    for (const key of Object.keys(contextPacks)) delete contextPacks[key];
+    for (const key of Object.keys(packFreshness)) delete packFreshness[key];
+    contextWarn.length = 0;
+    activeSummaryRefs = { project: null, session: null, phase: null };
+    contextQuality = {
+      primaryWorkflow: 'release',
+      primaryScore: null,
+      primaryStatus: 'not_applicable',
+      byWorkflow: {},
+    };
+  }
+  const semanticsManifest = readJsonFileSafe(base.runtimeSemanticsManifest);
   const semanticsAudit = runtimeSemantics.auditRuntimeTargets(target);
   /** @type {string[]} */
   const semanticsWarn = [];
@@ -2626,6 +2656,8 @@ function buildHealthReport(target) {
     implementationPackReady: executionRationality.implementationPackReady,
     referenceAnchorsReady: executionRationality.referenceAnchorsReady,
     fixturePackReady: executionRationality.fixturePackReady,
+    visualInputReadiness: executionRationality.visualInputReadiness,
+    visualInputsReady: executionRationality.visualInputsReady,
     executionRationalityReady: executionRationality.executionRationalityReady,
     criticalExecutionGaps: executionRationality.criticalExecutionGaps,
     executionRationality,