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.
- package/.cursor/commands/oxe-dashboard.md +2 -2
- package/.cursor/commands/oxe-execute.md +2 -2
- package/.cursor/commands/oxe-plan.md +2 -2
- package/.cursor/commands/oxe-quick.md +2 -2
- package/.cursor/commands/oxe-spec.md +3 -3
- package/.github/prompts/oxe-dashboard.prompt.md +2 -2
- package/.github/prompts/oxe-execute.prompt.md +2 -2
- package/.github/prompts/oxe-plan.prompt.md +2 -2
- package/.github/prompts/oxe-quick.prompt.md +2 -2
- package/.github/prompts/oxe-spec.prompt.md +3 -3
- package/CHANGELOG.md +53 -0
- package/README.md +19 -16
- package/bin/lib/oxe-context-engine.cjs +2 -0
- package/bin/lib/oxe-operational.cjs +408 -215
- package/bin/lib/oxe-project-health.cjs +2113 -2063
- package/bin/lib/oxe-rationality.cjs +146 -1
- package/bin/lib/oxe-release.cjs +31 -2
- package/bin/oxe-cc.js +111 -48
- package/commands/oxe/dashboard.md +2 -2
- package/commands/oxe/execute.md +2 -2
- package/commands/oxe/plan.md +2 -2
- package/commands/oxe/quick.md +2 -2
- package/commands/oxe/spec.md +3 -3
- package/docs/RELEASE-READINESS.md +2 -0
- package/lib/runtime/scheduler/multi-agent-coordinator.d.ts +9 -0
- package/lib/runtime/scheduler/multi-agent-coordinator.js +60 -9
- package/lib/sdk/index.cjs +3 -3
- package/oxe/templates/REFERENCE-ANCHORS.template.md +12 -5
- package/oxe/templates/SPEC.template.md +10 -0
- package/oxe/templates/VISUAL-INPUTS.template.json +27 -0
- package/oxe/templates/VISUAL-INPUTS.template.md +36 -0
- package/oxe/workflows/execute.md +3 -0
- package/oxe/workflows/plan.md +13 -9
- package/oxe/workflows/references/workflow-runtime-contracts.json +44 -29
- package/oxe/workflows/spec.md +19 -8
- package/oxe/workflows/ui-spec.md +3 -2
- package/package.json +3 -1
- package/packages/runtime/package.json +1 -1
- package/packages/runtime/src/scheduler/multi-agent-coordinator.ts +67 -9
- 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:
|
|
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:** `
|
|
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:
|
|
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:** `
|
|
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:
|
|
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:** `
|
|
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:
|
|
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:** `
|
|
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:
|
|
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:** `
|
|
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:
|
|
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:** `
|
|
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:
|
|
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:** `
|
|
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:
|
|
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:** `
|
|
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:
|
|
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:** `
|
|
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:
|
|
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:** `
|
|
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
|
[](https://www.npmjs.com/package/oxe-cc)
|
|
8
8
|
[](LICENSE)
|
|
9
9
|
|
|
10
|
-
**Versão:** `1.
|
|
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.
|
|
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),
|