oxe-cc 0.6.5 → 0.6.6

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.
@@ -15,6 +15,7 @@ Se o usuário indicar uma tarefa (ex.: `T2`), focar só nela nas camadas 1–2;
15
15
 
16
16
  <context>
17
17
  - Resolver `active_session` conforme `oxe/workflows/references/session-path-resolution.md`. Com sessão ativa, `VERIFY.md`, `VALIDATION-GAPS.md`, `SECURITY.md`, `UI-REVIEW.md` e `SUMMARY.md` vivem no escopo da sessão; `.oxe/STATE.md` continua global.
18
+ - Seguir `oxe/workflows/references/flow-robustness-contract.md`. O verify não valida só se passou; valida também se o plano estava bem calibrado para começar.
18
19
  - Preferir rodar comandos reais no terminal quando o ambiente permitir; se o sandbox bloquear, marcar como "não executado aqui" e deixar o comando para o usuário.
19
20
  - Não destruir `PLAN.md`; registrar achados em `VERIFY.md`.
20
21
  - Ler **`.oxe/config.json`** se existir: `after_verify_draft_commit`, `after_verify_suggest_pr`, e `verification_depth` (`"standard"` por padrão; `"thorough"` ativa camadas 3–4 completas; `"quick"` pula camadas 3–4 e UAT).
@@ -34,10 +35,11 @@ Verificar que o PLAN.md está apto para verificação:
34
35
  1. Toda tarefa `### Tn` tem bloco **Verificar** com pelo menos Comando ou Manual.
35
36
  2. Todo **Aceite vinculado** referencia IDs que existem na tabela de SPEC.md (`A1`, `A2`, …).
36
37
  3. Se houver `DISCUSS.md` no escopo resolvido, toda decisão técnica com ID **D-NN** aparece em **Decisão vinculada:** de alguma tarefa (ou nota explícita de gap no PLAN).
37
- 4. Não há dependências `Tk` inválidas (ID inexistente no PLAN).
38
-
39
- Se auditoria falhar: registrar na seção **Auditoria de pré-execução** do VERIFY.md os itens com problema e **pausar** — pedir correção do PLAN antes de continuar. Se o usuário forçar continuar com `--skip-audit`, documentar e prosseguir com aviso.
40
- </camada_1_pre_exec_audit>
38
+ 4. Não há dependências `Tk` inválidas (ID inexistente no PLAN).
39
+ 5. `PLAN.md` contém a seção **Autoavaliação do Plano** com `Melhor plano atual`, `Confiança` e rubrica preenchida.
40
+
41
+ Se auditoria falhar: registrar na seção **Auditoria de pré-execução** do VERIFY.md os itens com problema e **pausar** — pedir correção do PLAN antes de continuar. Se o usuário forçar continuar com `--skip-audit`, documentar e prosseguir com aviso.
42
+ </camada_1_pre_exec_audit>
41
43
 
42
44
  <camada_2_tarefas_e_criterios>
43
45
  **Camada 2 — Verificação de tarefas e critérios SPEC**
@@ -56,7 +58,7 @@ Para cada decisão na tabela de DISCUSS.md:
56
58
  Se uma decisão D-NN não tem tarefa vinculada **e** não há nota de gap no PLAN: marcar como `divergência` e adicionar ao bloco **Gaps**.
57
59
  </camada_3_fidelidade_decisoes>
58
60
 
59
- <camada_4_uat>
61
+ <camada_4_uat>
60
62
  **Camada 4 — UAT (User Acceptance Testing)** (ativa se `after_verify_suggest_uat` não for `false` na config)
61
63
 
62
64
  Gerar uma **Checklist UAT** no VERIFY.md com passos manuais derivados dos critérios de aceite. Formato:
@@ -72,10 +74,22 @@ Para cada critério da SPEC que exige validação manual:
72
74
  ```
73
75
 
74
76
  O preenchimento da checklist é responsabilidade do **usuário** (não do agente de IA).
75
- </camada_4_uat>
76
-
77
- <process>
78
- 1. **Camada 1 Auditoria de pré-execução:** checar integridade do PLAN.md e DISCUSS.md conforme `<camada_1_pre_exec_audit>`. Documentar resultado.
77
+ </camada_4_uat>
78
+
79
+ <calibracao_do_plano>
80
+ **Calibração do plano** (obrigatória quando existir `PLAN.md`)
81
+
82
+ Ler a `## Autoavaliação do Plano` e comparar com o resultado real:
83
+ 1. Se `Confiança >= 85%` e houver falha precoce em critérios centrais ou tarefas iniciais, marcar **erro de calibração do plano**.
84
+ 2. Se `Confiança < 70%` e as falhas ocorrerem nas incertezas previstas, marcar **autoavaliação aderente**.
85
+ 3. Se `Confiança >= 70%` e os critérios/tarefas passarem de forma consistente, marcar **plano calibrado**.
86
+ 4. Se `Confiança < 70%` e o ciclo passar amplamente, marcar **plano conservador demais**.
87
+
88
+ Registrar em `VERIFY.md`: `Resultado de calibração | Confiança declarada | Resultado observado | Notas`.
89
+ </calibracao_do_plano>
90
+
91
+ <process>
92
+ 1. **Camada 1 — Auditoria de pré-execução:** checar integridade do PLAN.md e DISCUSS.md conforme `<camada_1_pre_exec_audit>`. Documentar resultado.
79
93
  2. Ler `SPEC.md`, `PLAN.md` e `DISCUSS.md` do escopo resolvido, além de `.oxe/STATE.md` global.
80
94
  3. **Camada 2:** Para cada tarefa relevante, executar **Verificar: Comando** do PLAN (ou subconjunto se foco Tn). Para **cada ID de critério** da SPEC (A1, A2, …), registrar se passou com evidência.
81
95
  4. **Camada 3:** Se existir `.oxe/DISCUSS.md` com IDs D-NN, executar **Fidelidade de decisões** conforme `<camada_3_fidelidade_decisoes>`.
@@ -83,9 +97,10 @@ O preenchimento da checklist é responsabilidade do **usuário** (não do agente
83
97
  - Data, ambiente (SO / versão do Node se relevante).
84
98
  - **Seção — Auditoria de pré-execução:** resultado da Camada 1.
85
99
  - **Tabela — Tarefas:** Tarefa (Tn) | Verificação (comando/checklist) | Passou? | Notas.
86
- - **Tabela — Critérios SPEC:** ID (A1…) | Critério (resumo) | Evidência | Passou? | Notas.
87
- - **Tabela — Fidelidade de decisões** (se DISCUSS.md existir): ID | Decisão | Tarefa(s) | Implementado? | Evidência.
88
- - **Checklist UAT** (Camada 4).
100
+ - **Tabela — Critérios SPEC:** ID (A1…) | Critério (resumo) | Evidência | Passou? | Notas.
101
+ - **Tabela — Fidelidade de decisões** (se DISCUSS.md existir): ID | Decisão | Tarefa(s) | Implementado? | Evidência.
102
+ - **Seção Calibração do plano:** resultado conforme `<calibracao_do_plano>`.
103
+ - **Checklist UAT** (Camada 4).
89
104
  - **Gaps** — o que falhou e sugestão de correção; se não houver, escrever `Nenhum gap restante`.
90
105
  6. Atualizar **`.oxe/STATE.md`** global: `verify_complete` ou `verify_failed` + próximo passo (replan, corrigir ou publicar).
91
106
  6b. **Blueprint plan-agent:** se **todas** as verificações relevantes **passaram**, existir **`.oxe/plan-agents.json`** com `oxePlanAgentsSchema >= 2` e `lifecycle.status === "executing"` (ou `pending_execute`), actualizar o JSON: `lifecycle: { "status": "closed", "since": "<ISO>" }` e espelhar em **`STATE.md`** (**lifecycle_status** → `closed`). Não fechar como `closed` se `verify_failed` ou gaps por resolver.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "oxe-cc",
3
- "version": "0.6.5",
3
+ "version": "0.6.6",
4
4
  "description": "OXE — spec-driven workflows in .oxe/; integrates with Cursor, GitHub Copilot, Claude, OpenCode, Gemini, Codex, Windsurf, Antigravity (npx)",
5
5
  "license": "GPL-3.0",
6
6
  "author": "",