oxe-cc 1.9.1 → 1.11.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 (40) 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/CHANGELOG.md +53 -0
  12. package/README.md +19 -16
  13. package/bin/lib/oxe-context-engine.cjs +2 -0
  14. package/bin/lib/oxe-operational.cjs +408 -215
  15. package/bin/lib/oxe-project-health.cjs +2113 -2063
  16. package/bin/lib/oxe-rationality.cjs +146 -1
  17. package/bin/lib/oxe-release.cjs +31 -2
  18. package/bin/oxe-cc.js +111 -48
  19. package/commands/oxe/dashboard.md +2 -2
  20. package/commands/oxe/execute.md +2 -2
  21. package/commands/oxe/plan.md +2 -2
  22. package/commands/oxe/quick.md +2 -2
  23. package/commands/oxe/spec.md +3 -3
  24. package/docs/RELEASE-READINESS.md +2 -0
  25. package/lib/runtime/scheduler/multi-agent-coordinator.d.ts +9 -0
  26. package/lib/runtime/scheduler/multi-agent-coordinator.js +60 -9
  27. package/lib/sdk/index.cjs +3 -3
  28. package/oxe/templates/REFERENCE-ANCHORS.template.md +12 -5
  29. package/oxe/templates/SPEC.template.md +10 -0
  30. package/oxe/templates/VISUAL-INPUTS.template.json +27 -0
  31. package/oxe/templates/VISUAL-INPUTS.template.md +36 -0
  32. package/oxe/workflows/execute.md +3 -0
  33. package/oxe/workflows/plan.md +13 -9
  34. package/oxe/workflows/references/workflow-runtime-contracts.json +44 -29
  35. package/oxe/workflows/spec.md +19 -8
  36. package/oxe/workflows/ui-spec.md +3 -2
  37. package/package.json +3 -1
  38. package/packages/runtime/package.json +1 -1
  39. package/packages/runtime/src/scheduler/multi-agent-coordinator.ts +67 -9
  40. 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/CHANGELOG.md CHANGED
@@ -4,6 +4,59 @@ Todas as versões seguem [Semantic Versioning](https://semver.org/). As mudança
4
4
 
5
5
  ---
6
6
 
7
+ ## [1.11.0] — 2026-05-06
8
+
9
+ ### Spec Lifecycle Automation & CLI Gaps
10
+
11
+ 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.
12
+
13
+ #### Automação do ciclo de vida (SPEC.md)
14
+
15
+ - 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]`
16
+ - v1.0.0 checklist não é marcado automaticamente — requer sign-off explícito
17
+ - exportada no módulo para testes de integração e uso programático
18
+
19
+ #### CLI — `runtime execute`
20
+
21
+ - 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
22
+ - novo flag `--api-key-env <VAR>`: lê API key de variável de ambiente nomeada em vez de `OXE_LLM_API_KEY`
23
+ - novo subcomando `runtime configure`: wizard interativo que persiste `baseUrl`, `model`, `apiKey` em `.oxe/config.json` (seção `runtime.provider`)
24
+
25
+ #### Provider LLM auto-wired
26
+
27
+ - `createExecutionContext` passa a instanciar `PolicyEngine.fromConfigFile()` automaticamente quando `.oxe/config.json` contém seção `runtime.policy`
28
+ - `loadRuntimeProviderConfig` / `saveRuntimeProviderConfig` exportados de `oxe-operational.cjs`
29
+ - health checks de `runtime.provider` e `runtime.policy` adicionados ao `oxe-cc status`
30
+
31
+ #### Parser de planos — tolerância de formato (Gap E)
32
+
33
+ - `parsePlan` agora aceita `**Verificação:**`, `**Verify command:**` e `**Verification:**` além do formato `Verificação:` sem negrito
34
+ - planos gerados por LLM com markdown bold deixam de silenciosamente omitir verify commands
35
+
36
+ #### Spec-criteria enrichment (Gap B)
37
+
38
+ - `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
39
+
40
+ #### Testes e benchmark
41
+
42
+ - 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
43
+ - 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`
44
+ - novos testes: `gap-spec-enrichment.test.cjs` (5 casos) e `gap-spec-checklist-sync.test.cjs` (4 casos)
45
+
46
+ ## [1.10.0] — 2026-05-05
47
+
48
+ ### Operational Maturity
49
+
50
+ Esta release amplia a prova operacional do OXE para cenários mais próximos de uso real, sem abrir novos comandos públicos.
51
+
52
+ - `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
53
+ - `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
54
+ - `status`, `runtime status` e `runtime agents status` expõem merge readiness, blockers e próxima ação multi-agent de forma mais direta
55
+ - `workspaceMode: product_package` deixa de marcar `contextQuality` como crítico quando não há ciclo OXE ativo no próprio repositório do pacote
56
+ - smoke multi-runtime reforça Codex e Copilot VS Code com validação explícita de prompts/skills, manifesto e referências quebradas
57
+ - `doctor --release` passa a validar o conteúdo mínimo dos relatórios runtime-real e multi-agent-real da linha `1.10.0`
58
+ - `/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
59
+
7
60
  ## [1.9.1] — 2026-05-04
8
61
 
9
62
  ### Multi-Agent Real
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.9.1` · [package.json](package.json)
10
+ **Versão:** `1.11.0` · [package.json](package.json)
11
11
 
12
12
  **Framework OXE — Orchestrated eXperience Engineering**
13
13
 
@@ -37,6 +37,7 @@ Ele se apoia em três princípios:
37
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
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
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
 
@@ -73,6 +74,7 @@ Em termos práticos, o estado operacional real agora passa por:
73
74
  - `.oxe/runs/<run_id>/verification-manifest.json`
74
75
  - `.oxe/runs/<run_id>/residual-risk-ledger.json`
75
76
  - `.oxe/runs/<run_id>/evidence-coverage.json`
77
+ - `.oxe/runs/<run_id>/workspace-merge-report.json`
76
78
  - `.oxe/execution/GATES.json`
77
79
  - `OXE-EVENTS.ndjson`
78
80
 
@@ -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). |
@@ -284,6 +286,7 @@ Estes comportamentos continuam existindo, mas agora são ativados como flags dos
284
286
  | Scan / refresh do codebase | `/oxe-spec --refresh` (incremental) ou `--full` (completo) |
285
287
  | Research / spike / engenharia reversa | `/oxe-spec --research` |
286
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,23 +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
- - `npm run release:pack-check`
467
- - `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`
468
471
 
469
472
  Artefatos obrigatórios desta fase:
470
473
 
471
- - `.oxe/release/release-manifest.json`
472
- - `.oxe/release/runtime-smoke-report.json`
473
- - `.oxe/release/runtime-real-report.json`
474
- - `.oxe/release/recovery-fixture-report.json`
475
- - `.oxe/release/multi-agent-soak-report.json`
476
- - `.oxe/release/multi-agent-real-report.json`
477
-
478
- 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.
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.
479
482
 
480
483
  ### `/oxe-retro` — loop de aprendizado
481
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),