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.
- 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/AGENTS.md +1 -1
- package/CHANGELOG.md +45 -0
- package/README.md +32 -26
- package/bin/lib/oxe-context-engine.cjs +2 -0
- package/bin/lib/oxe-operational.cjs +230 -74
- package/bin/lib/oxe-project-health.cjs +43 -9
- package/bin/lib/oxe-rationality.cjs +146 -1
- package/bin/lib/oxe-release.cjs +55 -0
- package/bin/oxe-cc.js +60 -37
- 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 +8 -1
- package/lib/runtime/scheduler/multi-agent-coordinator.d.ts +48 -0
- package/lib/runtime/scheduler/multi-agent-coordinator.js +274 -14
- package/lib/runtime/workspace/strategies/git-worktree.js +18 -9
- 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 +6 -3
- package/packages/runtime/package.json +1 -1
- package/packages/runtime/src/scheduler/multi-agent-coordinator.ts +379 -47
- package/packages/runtime/src/workspace/strategies/git-worktree.ts +24 -16
- 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/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
|
[](https://www.npmjs.com/package/oxe-cc)
|
|
8
8
|
[](LICENSE)
|
|
9
9
|
|
|
10
|
-
**Versão:** `1.
|
|
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/
|
|
77
|
-
-
|
|
78
|
-
|
|
79
|
-
|
|
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.
|
|
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
|
-
- `
|
|
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/
|
|
473
|
-
- `.oxe/release/
|
|
474
|
-
|
|
475
|
-
|
|
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),
|