oxe-cc 1.8.3 → 1.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/.cursor/commands/oxe-dashboard.md +2 -2
  2. package/.cursor/commands/oxe-execute.md +2 -2
  3. package/.cursor/commands/oxe-plan.md +2 -2
  4. package/.cursor/commands/oxe-quick.md +2 -2
  5. package/.cursor/commands/oxe-spec.md +3 -3
  6. package/.github/prompts/oxe-dashboard.prompt.md +2 -2
  7. package/.github/prompts/oxe-execute.prompt.md +2 -2
  8. package/.github/prompts/oxe-plan.prompt.md +2 -2
  9. package/.github/prompts/oxe-quick.prompt.md +2 -2
  10. package/.github/prompts/oxe-spec.prompt.md +3 -3
  11. package/AGENTS.md +1 -1
  12. package/CHANGELOG.md +45 -0
  13. package/README.md +32 -26
  14. package/bin/lib/oxe-context-engine.cjs +2 -0
  15. package/bin/lib/oxe-operational.cjs +230 -74
  16. package/bin/lib/oxe-project-health.cjs +43 -9
  17. package/bin/lib/oxe-rationality.cjs +146 -1
  18. package/bin/lib/oxe-release.cjs +55 -0
  19. package/bin/oxe-cc.js +60 -37
  20. package/commands/oxe/dashboard.md +2 -2
  21. package/commands/oxe/execute.md +2 -2
  22. package/commands/oxe/plan.md +2 -2
  23. package/commands/oxe/quick.md +2 -2
  24. package/commands/oxe/spec.md +3 -3
  25. package/docs/RELEASE-READINESS.md +8 -1
  26. package/lib/runtime/scheduler/multi-agent-coordinator.d.ts +48 -0
  27. package/lib/runtime/scheduler/multi-agent-coordinator.js +274 -14
  28. package/lib/runtime/workspace/strategies/git-worktree.js +18 -9
  29. package/oxe/templates/REFERENCE-ANCHORS.template.md +12 -5
  30. package/oxe/templates/SPEC.template.md +10 -0
  31. package/oxe/templates/VISUAL-INPUTS.template.json +27 -0
  32. package/oxe/templates/VISUAL-INPUTS.template.md +36 -0
  33. package/oxe/workflows/execute.md +3 -0
  34. package/oxe/workflows/plan.md +13 -9
  35. package/oxe/workflows/references/workflow-runtime-contracts.json +44 -29
  36. package/oxe/workflows/spec.md +19 -8
  37. package/oxe/workflows/ui-spec.md +3 -2
  38. package/package.json +6 -3
  39. package/packages/runtime/package.json +1 -1
  40. package/packages/runtime/src/scheduler/multi-agent-coordinator.ts +379 -47
  41. package/packages/runtime/src/workspace/strategies/git-worktree.ts +24 -16
  42. package/vscode-extension/package.json +1 -1
@@ -9,7 +9,7 @@ oxe_tool_profile: read_heavy
9
9
  oxe_confidence_policy: explicit
10
10
  oxe_context_tier: standard
11
11
  oxe_contract_version: 2.0.0
12
- oxe_semantics_hash: ebb4473c14e5b080
12
+ oxe_semantics_hash: 13daa3c62e0efaa4
13
13
  ---
14
14
 
15
15
  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
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `ebb4473c14e5b080`
28
+ - **Checksum semântico:** `13daa3c62e0efaa4`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/dashboard.md` e `.oxe/context/packs/dashboard.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow dashboard --json`
@@ -9,7 +9,7 @@ oxe_tool_profile: write_bounded
9
9
  oxe_confidence_policy: explicit
10
10
  oxe_context_tier: standard
11
11
  oxe_contract_version: 2.0.0
12
- oxe_semantics_hash: 7b3446b77aef9353
12
+ oxe_semantics_hash: 0e6003de070d497f
13
13
  ---
14
14
 
15
15
  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
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `7b3446b77aef9353`
28
+ - **Checksum semântico:** `0e6003de070d497f`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/execute.md` e `.oxe/context/packs/execute.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow execute --json`
@@ -9,7 +9,7 @@ oxe_tool_profile: mixed
9
9
  oxe_confidence_policy: rubric
10
10
  oxe_context_tier: standard
11
11
  oxe_contract_version: 2.0.0
12
- oxe_semantics_hash: 5c589398cb807029
12
+ oxe_semantics_hash: 210518babb4788d0
13
13
  ---
14
14
 
15
15
  OXE — Gera .oxe/PLAN.md com verificação por tarefa
@@ -25,7 +25,7 @@ OXE — Gera .oxe/PLAN.md com verificação por tarefa
25
25
  - **Política de confiança:** rubrica
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `5c589398cb807029`
28
+ - **Checksum semântico:** `210518babb4788d0`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/plan.md` e `.oxe/context/packs/plan.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow plan --json`
@@ -9,7 +9,7 @@ oxe_tool_profile: mixed
9
9
  oxe_confidence_policy: rubric
10
10
  oxe_context_tier: standard
11
11
  oxe_contract_version: 2.0.0
12
- oxe_semantics_hash: 2193373eb2691e0d
12
+ oxe_semantics_hash: ea0c06ca7b5c87bb
13
13
  ---
14
14
 
15
15
  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
25
25
  - **Política de confiança:** rubrica
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `2193373eb2691e0d`
28
+ - **Checksum semântico:** `ea0c06ca7b5c87bb`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/quick.md` e `.oxe/context/packs/quick.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow quick --json`
@@ -9,7 +9,7 @@ oxe_tool_profile: read_heavy
9
9
  oxe_confidence_policy: explicit
10
10
  oxe_context_tier: standard
11
11
  oxe_contract_version: 2.0.0
12
- oxe_semantics_hash: eea8766eab635c97
12
+ oxe_semantics_hash: 4ec66ac1e704fdbf
13
13
  ---
14
14
 
15
15
  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)
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `eea8766eab635c97`
28
+ - **Checksum semântico:** `4ec66ac1e704fdbf`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/spec.md` e `.oxe/context/packs/spec.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **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)
44
44
 
45
45
  <!-- oxe-workflow-resolution:end -->
46
46
 
47
- Usa o resto desta mensagem e ficheiros anexados como entrada do utilizador.
47
+ 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.
@@ -11,7 +11,7 @@ oxe_tool_profile: read_heavy
11
11
  oxe_confidence_policy: explicit
12
12
  oxe_context_tier: standard
13
13
  oxe_contract_version: 2.0.0
14
- oxe_semantics_hash: ebb4473c14e5b080
14
+ oxe_semantics_hash: 13daa3c62e0efaa4
15
15
  ---
16
16
 
17
17
  <!-- oxe-reasoning-contract:start -->
@@ -25,7 +25,7 @@ oxe_semantics_hash: ebb4473c14e5b080
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `ebb4473c14e5b080`
28
+ - **Checksum semântico:** `13daa3c62e0efaa4`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/dashboard.md` e `.oxe/context/packs/dashboard.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow dashboard --json`
@@ -11,7 +11,7 @@ oxe_tool_profile: write_bounded
11
11
  oxe_confidence_policy: explicit
12
12
  oxe_context_tier: standard
13
13
  oxe_contract_version: 2.0.0
14
- oxe_semantics_hash: 7b3446b77aef9353
14
+ oxe_semantics_hash: 0e6003de070d497f
15
15
  ---
16
16
 
17
17
  <!-- oxe-reasoning-contract:start -->
@@ -25,7 +25,7 @@ oxe_semantics_hash: 7b3446b77aef9353
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `7b3446b77aef9353`
28
+ - **Checksum semântico:** `0e6003de070d497f`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/execute.md` e `.oxe/context/packs/execute.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow execute --json`
@@ -11,7 +11,7 @@ oxe_tool_profile: mixed
11
11
  oxe_confidence_policy: rubric
12
12
  oxe_context_tier: standard
13
13
  oxe_contract_version: 2.0.0
14
- oxe_semantics_hash: 5c589398cb807029
14
+ oxe_semantics_hash: 210518babb4788d0
15
15
  ---
16
16
 
17
17
  <!-- oxe-reasoning-contract:start -->
@@ -25,7 +25,7 @@ oxe_semantics_hash: 5c589398cb807029
25
25
  - **Política de confiança:** rubrica
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `5c589398cb807029`
28
+ - **Checksum semântico:** `210518babb4788d0`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/plan.md` e `.oxe/context/packs/plan.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow plan --json`
@@ -11,7 +11,7 @@ oxe_tool_profile: mixed
11
11
  oxe_confidence_policy: rubric
12
12
  oxe_context_tier: standard
13
13
  oxe_contract_version: 2.0.0
14
- oxe_semantics_hash: 2193373eb2691e0d
14
+ oxe_semantics_hash: ea0c06ca7b5c87bb
15
15
  ---
16
16
 
17
17
  <!-- oxe-reasoning-contract:start -->
@@ -25,7 +25,7 @@ oxe_semantics_hash: 2193373eb2691e0d
25
25
  - **Política de confiança:** rubrica
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `2193373eb2691e0d`
28
+ - **Checksum semântico:** `ea0c06ca7b5c87bb`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/quick.md` e `.oxe/context/packs/quick.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow quick --json`
@@ -11,7 +11,7 @@ oxe_tool_profile: read_heavy
11
11
  oxe_confidence_policy: explicit
12
12
  oxe_context_tier: standard
13
13
  oxe_contract_version: 2.0.0
14
- oxe_semantics_hash: eea8766eab635c97
14
+ oxe_semantics_hash: 4ec66ac1e704fdbf
15
15
  ---
16
16
 
17
17
  <!-- oxe-reasoning-contract:start -->
@@ -25,7 +25,7 @@ oxe_semantics_hash: eea8766eab635c97
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `eea8766eab635c97`
28
+ - **Checksum semântico:** `4ec66ac1e704fdbf`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/spec.md` e `.oxe/context/packs/spec.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow spec --json`
@@ -44,4 +44,4 @@ oxe_semantics_hash: eea8766eab635c97
44
44
 
45
45
  <!-- oxe-workflow-resolution:end -->
46
46
 
47
- Usa o resto desta mensagem e ficheiros anexados como entrada do utilizador.
47
+ 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/AGENTS.md CHANGED
@@ -99,4 +99,4 @@ Os wrappers por runtime podem carregar metadata cognitiva (`oxe_reasoning_mode`,
99
99
 
100
100
  Para `execute` e `verify`, o comportamento atual esperado é **runtime-first**: se `oxe-cc runtime` estiver disponível, preferir `runtime compile/project/verify/gates` e tratar markdown como projeção derivada; se o runtime não puder ser executado, declarar `fallback legado` explicitamente.
101
101
 
102
- Para publicação, o gate local esperado passa por `oxe-cc doctor --release --write-manifest`. Essa verificação deve falhar se houver drift de versão, topo inválido no `CHANGELOG`, ausência da árvore canónica `oxe/`, `workflow-runtime-contracts.json` inválido, wrapper dirty após sync, runtime não compilado ou ausência dos relatórios `.oxe/release/*.json` exigidos pela release.
102
+ Para publicação, o gate local esperado passa por `npm test`, `npm run release:pack-check` e `oxe-cc doctor --release --write-manifest`. Essa verificação deve falhar se houver drift de versão, topo inválido no `CHANGELOG`, ausência da árvore canónica `oxe/`, `workflow-runtime-contracts.json` inválido, wrapper dirty após sync, runtime não compilado, pacote npm com artefatos indevidos ou ausência dos relatórios `.oxe/release/*.json` exigidos pela release, incluindo `runtime-real-report.json` e, a partir da `1.9.1`, `multi-agent-real-report.json`.
package/CHANGELOG.md CHANGED
@@ -4,6 +4,51 @@ Todas as versões seguem [Semantic Versioning](https://semver.org/). As mudança
4
4
 
5
5
  ---
6
6
 
7
+ ## [1.10.0] — 2026-05-05
8
+
9
+ ### Operational Maturity
10
+
11
+ Esta release amplia a prova operacional do OXE para cenários mais próximos de uso real, sem abrir novos comandos públicos.
12
+
13
+ - `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
14
+ - `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
15
+ - `status`, `runtime status` e `runtime agents status` expõem merge readiness, blockers e próxima ação multi-agent de forma mais direta
16
+ - `workspaceMode: product_package` deixa de marcar `contextQuality` como crítico quando não há ciclo OXE ativo no próprio repositório do pacote
17
+ - smoke multi-runtime reforça Codex e Copilot VS Code com validação explícita de prompts/skills, manifesto e referências quebradas
18
+ - `doctor --release` passa a validar o conteúdo mínimo dos relatórios runtime-real e multi-agent-real da linha `1.10.0`
19
+ - `/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
20
+
21
+ ## [1.9.1] — 2026-05-04
22
+
23
+ ### Multi-Agent Real
24
+
25
+ Esta release endurece a coordenação multi-agent sobre workspaces reais, sem abrir novos comandos públicos.
26
+
27
+ - multi-agent real passa a exigir workspaces isolados `git_worktree` para modos `parallel`, `competitive` e `cooperative`
28
+ - `runtime execute` valida `plan-agents.json` antes de iniciar agentes e usa `GitWorktreeManager` por padrão no caminho multi-agent
29
+ - novo artefato por run `.oxe/runs/<run_id>/workspace-merge-report.json` com worktrees, ownership, merge blockers e readiness
30
+ - `runtime agents status --json`, `status --json` e recovery passam a expor merge readiness, blockers, arbitration e worktrees órfãos
31
+ - novo `npm run test:multi-agent-real` gera `.oxe/release/multi-agent-real-report.json` usando repositório git temporário com worktrees reais
32
+ - `doctor --release` passa a exigir `multi-agent-real-report.json` em versões `>=1.9.1`
33
+
34
+ ## [1.9.0] — 2026-05-04
35
+
36
+ ### Runtime Real Maturity
37
+
38
+ 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.
39
+
40
+ #### Runtime real
41
+
42
+ - nova suíte `test:runtime-real` valida projetos representativos com executor mockado e sem chamada a LLM/API externa
43
+ - `runtime execute` passa a bloquear antes da mutação quando confiança, rationality packs ou gates não estão prontos
44
+ - `runtime verify` continua evidence-first e passa a ser validado dentro do fluxo real de execução
45
+
46
+ #### Release proof
47
+
48
+ - novo relatório obrigatório `.oxe/release/runtime-real-report.json`
49
+ - `doctor --release` passa a bloquear publicação quando a prova de runtime real estiver ausente ou falha
50
+ - novo `release:pack-check` valida o tarball npm em dry-run contra artefatos indevidos
51
+
7
52
  ## [1.8.3] — 2026-05-04
8
53
 
9
54
  ### Release readiness e higiene de publicação
package/README.md CHANGED
@@ -7,7 +7,7 @@
7
7
  [![npm](https://img.shields.io/npm/v/oxe-cc.svg?style=flat-square)](https://www.npmjs.com/package/oxe-cc)
8
8
  [![license](https://img.shields.io/npm/l/oxe-cc.svg?style=flat-square)](LICENSE)
9
9
 
10
- **Versão:** `1.8.3` · [package.json](package.json)
10
+ **Versão:** `1.10.0` · [package.json](package.json)
11
11
 
12
12
  **Framework OXE — Orchestrated eXperience Engineering**
13
13
 
@@ -34,9 +34,10 @@ Ele se apoia em três princípios:
34
34
 
35
35
  - **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.
36
36
  - **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.
37
- - **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.
38
- - **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.
39
- - **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.
37
+ - **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.
38
+ - **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.
39
+ - **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.
40
+ - **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.
40
41
 
41
42
  O resultado: **menos requisições**, **mais coerência**, e uma experiência de engenharia orquestrada que funciona do mesmo jeito em qualquer IDE.
42
43
 
@@ -68,15 +69,16 @@ O OXE já não é só um conjunto de prompts e markdowns. Hoje ele combina:
68
69
 
69
70
  Em termos práticos, o estado operacional real agora passa por:
70
71
 
71
- - `ACTIVE-RUN.json`
72
- - `.oxe/runs/<run_id>.json`
73
- - `.oxe/runs/<run_id>/verification-manifest.json`
74
- - `.oxe/runs/<run_id>/residual-risk-ledger.json`
75
- - `.oxe/runs/<run_id>/evidence-coverage.json`
76
- - `.oxe/execution/GATES.json`
77
- - `OXE-EVENTS.ndjson`
78
-
79
- Contrato estável desta release:
72
+ - `ACTIVE-RUN.json`
73
+ - `.oxe/runs/<run_id>.json`
74
+ - `.oxe/runs/<run_id>/verification-manifest.json`
75
+ - `.oxe/runs/<run_id>/residual-risk-ledger.json`
76
+ - `.oxe/runs/<run_id>/evidence-coverage.json`
77
+ - `.oxe/runs/<run_id>/workspace-merge-report.json`
78
+ - `.oxe/execution/GATES.json`
79
+ - `OXE-EVENTS.ndjson`
80
+
81
+ Contrato estável desta release:
80
82
 
81
83
  - `execute` e `verify` são `runtime-first` quando `oxe-cc runtime` está disponível
82
84
  - `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
250
252
  | Comando | O que entrega |
251
253
  |---------|--------------|
252
254
  | `/oxe` | Sem input → próximo passo. Com pergunta → situação atual (artefatos reais). Com "help" → trilha principal. |
253
- | `/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. |
255
+ | `/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. |
254
256
  | `/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. |
255
257
  | `/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`. |
256
258
  | `/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
283
285
  |---------------|-------------|
284
286
  | Scan / refresh do codebase | `/oxe-spec --refresh` (incremental) ou `--full` (completo) |
285
287
  | Research / spike / engenharia reversa | `/oxe-spec --research` |
286
- | Contrato UI/UX | `/oxe-spec --ui` |
288
+ | Contrato UI/UX | `/oxe-spec --ui` |
289
+ | 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 |
287
290
  | Registrar observação durante execução | `/oxe-execute --note "texto"` |
288
291
  | Diagnóstico técnico inline | `/oxe-execute --debug` |
289
292
  | Diagnóstico pós-falha persistente | `/oxe-execute --deep-diagnosis` |
@@ -459,20 +462,23 @@ O `status --full` mostra em ANSI: readiness do ciclo, autoavaliação do plano,
459
462
 
460
463
  O pacote está pronto para uma publicação robusta quando estes sinais estiverem verdes no repositório da release:
461
464
 
462
- - `npm test`
463
- - `npm run scan:assets`
464
- - `npm run build:vscode-ext`
465
- - `node bin/oxe-cc.js doctor --release --write-manifest`
466
- - `node bin/oxe-cc.js status --full`
465
+ - `npm test`
466
+ - `npm run scan:assets`
467
+ - `npm run build:vscode-ext`
468
+ - `node bin/oxe-cc.js doctor --release --write-manifest`
469
+ - `npm run release:pack-check`
470
+ - `node bin/oxe-cc.js status --full`
467
471
 
468
472
  Artefatos obrigatórios desta fase:
469
473
 
470
- - `.oxe/release/release-manifest.json`
471
- - `.oxe/release/runtime-smoke-report.json`
472
- - `.oxe/release/recovery-fixture-report.json`
473
- - `.oxe/release/multi-agent-soak-report.json`
474
-
475
- Não há outro bloqueador funcional do plano runtime core para esta publicação. O que sobra depois dela é evolução de ergonomia e expansão de targets, não correção estrutural do contrato atual.
474
+ - `.oxe/release/release-manifest.json`
475
+ - `.oxe/release/runtime-smoke-report.json`
476
+ - `.oxe/release/runtime-real-report.json`
477
+ - `.oxe/release/recovery-fixture-report.json`
478
+ - `.oxe/release/multi-agent-soak-report.json`
479
+ - `.oxe/release/multi-agent-real-report.json`
480
+
481
+ Na linha `1.9.1`, `runtime-real-report.json` prova o ciclo real `compile -> execute mockado -> verify -> project -> status --json`, e `multi-agent-real-report.json` prova coordenação com `git_worktree`, ownership, arbitragem e merge readiness antes da publicação.
476
482
 
477
483
  ### `/oxe-retro` — loop de aprendizado
478
484
 
@@ -231,6 +231,8 @@ function resolveArtifactCandidates(projectRoot, activeSession) {
231
231
  reference_anchors: withFallback('reference_anchors', 'reference_anchors', scoped.referenceAnchors, base.referenceAnchors),
232
232
  fixture_pack_md: withFallback('fixture_pack_md', 'fixtures', scoped.fixturePackMd, base.fixturePackMd),
233
233
  fixture_pack_json: withFallback('fixture_pack_json', 'fixtures', scoped.fixturePackJson, base.fixturePackJson),
234
+ visual_inputs_md: withFallback('visual_inputs_md', 'visual_inputs', scoped.visualInputsMd, base.visualInputsMd),
235
+ visual_inputs_json: withFallback('visual_inputs_json', 'visual_inputs', scoped.visualInputsJson, base.visualInputsJson),
234
236
  plan_agents: withFallback('plan_agents', 'plan_agents', scoped.planAgents, base.planAgents),
235
237
  quick: withFallback('quick', 'plan', scoped.quick, base.quick),
236
238
  runtime: withFallback('runtime', 'runtime', scoped.runtime, base.runtime),