oxe-cc 0.3.2 → 0.3.4

package/oxe/workflows/verify.md

@@ -1,34 +1,37 @@
 # OXE — Workflow: verify
 
 <objective>
-Executar ou orientar verificação pós-implementação: rodar os comandos definidos no **PLAN.md**, confrontar com **SPEC.md**, registrar resultado em **`.oxe/VERIFY.md`** (e atualizar **STATE**).
+Executar ou orientar verificação pós-implementação: rodar os comandos definidos no **PLAN.md**, confrontar **cada critério da SPEC** (IDs **A1**, **A2**, …) com o código e os testes, e registrar o resultado em **`.oxe/VERIFY.md`** (e atualizar **STATE**).
 
-Se o utilizador indicar uma tarefa (ex. `T2`), focar só nela; caso contrário, percorrer todas as tarefas com blocos **Verificar**.
+Se o usuário indicar uma tarefa (ex.: `T2`), focar só nela; caso contrário, percorrer todas as tarefas com blocos **Verificar**.
 </objective>
 
 <context>
-- Preferir rodar comandos reais no terminal quando o ambiente permitir; se sandbox bloquear, marcar como “não executado aqui” e deixar comando para o utilizador.
-- Não destruir `PLAN.md`; anexar achados em `VERIFY.md`.
-- Ler **`.oxe/config.json`** se existir: chaves `after_verify_draft_commit` e `after_verify_suggest_pr` controlam passos opcionais abaixo (omissão = `true` onde o template por defeito as define).
+- 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.
+- Não destruir `PLAN.md`; registrar achados em `VERIFY.md`.
+- Ler **`.oxe/config.json`** se existir: `after_verify_draft_commit` e `after_verify_suggest_pr` controlam passos opcionais (se o arquivo não existir, use o mesmo padrão do `config.template.json`).
+- Os critérios na SPEC devem estar na tabela **Critérios de aceite** com colunas **ID** / **Critério** / **Como verificar**; o verify deve **cruzar cada ID** com evidência (arquivo, comando, trecho).
 </context>
 
 <process>
 1. Ler `.oxe/SPEC.md`, `.oxe/PLAN.md`, `.oxe/STATE.md`.
 2. Para cada tarefa relevante, executar **Verificar: Comando** do PLAN (ou subconjunto se foco Tn).
-3. Checar critérios de aceite da SPEC contra o estado do código (Read/Grep).
+3. Para **cada ID de critério** usado na SPEC (A1, A2, …), registrar se passou, com evidência (Read/Grep, saída de teste resumida).
 4. Escrever **`.oxe/VERIFY.md`** com:
-   - Data, ambiente (OS/node versão se relevante).
-   - Tabela ou lista: Tarefa | Verificação | Passou? | Notas.
-   - **Gaps** — o que falhou e sugestão de correção (pode virar novas entradas no PLAN).
-5. Atualizar **`.oxe/STATE.md`**: `verify_complete` ou `verify_failed` + próximo passo (replan, corrigir, ou ship).
-6. Append curto em **`.oxe/SUMMARY.md`** (sessão) se existir; se não existir, criar a partir de **`oxe/templates/SUMMARY.template.md`** e acrescentar a entrada desta sessão.
-7. **Só se todas as verificações relevantes passarem:** se `after_verify_draft_commit` não for `false` em `.oxe/config.json` (se o ficheiro não existir, assumir `true` como no template): acrescentar a **VERIFY.md** secção **Rascunho de commit** — mensagem convencional (ex. `feat:` / `fix:`) + bullets alinhados aos critérios de aceite; **não** incluir segredos.
-8. **Só se passou:** se `after_verify_suggest_pr` não for `false` (ausência de config = `true`): acrescentar **Checklist PR** — branch base, título sugerido, screenshots se UI, ligações a SPEC/PLAN, testes corridos.
+   - Data, ambiente (SO / versão do Node se relevante).
+   - **Tabela — Tarefas:** Tarefa (Tn) | Verificação (comando/checklist) | Passou? | Notas.
+   - **Tabela — Critérios SPEC:** ID (A1…) | Critério (resumo) | Evidência | Passou? | Notas.
+   - **Gaps** — o que falhou e sugestão de correção (pode virar novas entradas no PLAN); se não houver, escrever explicitamente `Nenhum gap restante` ou equivalente.
+5. Atualizar **`.oxe/STATE.md`**: `verify_complete` ou `verify_failed` + próximo passo (replan, corrigir ou publicar).
+6. Acrescentar entrada em **`.oxe/SUMMARY.md`** (sessão): se não existir, criar a partir de **`oxe/templates/SUMMARY.template.md`**. **Obrigatório** quando `verify_failed` ou quando a seção **Gaps** tiver itens — isso alimenta o replanejamento.
+7. **Só se todas as verificações relevantes passarem:** se `after_verify_draft_commit` não for `false`: acrescentar em **VERIFY.md** a seção **Rascunho de commit** — mensagem convencional (ex.: `feat:` / `fix:`) + bullets alinhados aos critérios **A***; **não** incluir segredos.
+8. **Só se passou:** se `after_verify_suggest_pr` não for `false`: acrescentar **Checklist PR** — branch base, título sugerido, screenshots se UI, links a SPEC/PLAN, testes executados.
 </process>
 
 <success_criteria>
-- [ ] VERIFY.md reflete o que foi de fato verificado.
-- [ ] Falhas têm próximo passo claro (qual tarefa replanejar ou qual ficheiro corrigir); se falhou, próximo passo inclui **plan --replan** ou correção direta.
+- [ ] VERIFY.md reflete o que foi de fato verificado (tarefas **e** critérios SPEC por ID).
+- [ ] Falhas têm próximo passo claro (qual tarefa replanejar ou qual arquivo corrigir); se falhou, próximo passo inclui **plan** com replanejamento ou correção direta.
 - [ ] STATE.md atualizado.
-- [ ] Se passou: secções **Rascunho de commit** e **Checklist PR** presentes em VERIFY.md salvo se desativadas em config.
+- [ ] SUMMARY.md atualizado quando houver falha ou gaps relevantes.
+- [ ] Se passou: seções **Rascunho de commit** e **Checklist PR** presentes em VERIFY.md, salvo se desativadas na config.
 </success_criteria>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oxe-cc",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "OXE — spec-driven workflows for Cursor and GitHub Copilot (install via npx)",
   "license": "GPL-3.0",
   "author": "",
@@ -37,7 +37,7 @@
     "README.md"
   ],
   "scripts": {
-    "test": "node --test tests/install.test.cjs",
+    "test": "node --test tests/install.test.cjs tests/oxe-project-health.test.cjs",
     "scan:assets": "node scripts/oxe-assets-scan.cjs",
     "prepublishOnly": "node --test tests/install.test.cjs && node scripts/oxe-assets-scan.cjs && node bin/oxe-cc.js --version"
   }