oxe-cc 0.7.0 → 0.9.0

package/commands/oxe/review-pr.md

@@ -1,16 +1,49 @@
----
-name: oxe:review-pr
-description: OXE — Revisão de diff/PR: analisa alterações, riscos, convenções e sugestões acionáveis
-argument-hint: "<URL do PR ou branch:base..head>"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canônico:** `oxe/workflows/review-pr.md`
-
-Execute integralmente esse ficheiro. Recebe URL de PR do GitHub (`org/repo#N`) ou par de branches/SHAs. `$ARGUMENTS` = referência do diff.
+---
+name: oxe:review-pr
+description: OXE — Revisão de diff/PR: analisa alterações, riscos, convenções e sugestões acionáveis
+argument-hint: "<URL do PR ou branch:base..head>"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+oxe_workflow_slug: review-pr
+oxe_reasoning_mode: review
+oxe_question_policy: none
+oxe_output_contract: findings
+oxe_tool_profile: review_heavy
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 1e12e0a92c7d0079
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** review-pr
+- **Modo:** revisão
+- **Perguntas:** nenhuma
+- **Saída esperada:** achados
+- **Perfil de ferramentas:** revisão intensa
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `1e12e0a92c7d0079`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/review-pr.md` e `.oxe/context/packs/review-pr.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow review-pr --json`
+- Apresentar findings primeiro, ordenados por severidade e evidência.
+- Separar bug, risco, regressão e lacuna de teste.
+- Se não houver findings, declarar isso explicitamente e listar riscos residuais.
+- **Seções esperadas:** Findings · Perguntas abertas · Riscos residuais · Resumo
+- **Bloqueios formais:** missing:state
+- **Referência canónica:** `oxe/workflows/references/reasoning-review.md`
+
+<!-- oxe-reasoning-contract:end -->
+
+**Workflow canônico:** `oxe/workflows/review-pr.md`
+
+Execute integralmente esse ficheiro. Recebe URL de PR do GitHub (`org/repo#N`) ou par de branches/SHAs. `$ARGUMENTS` = referência do diff.

package/commands/oxe/route.md

@@ -1,11 +1,44 @@
----
-name: oxe:route
-description: OXE — Router linguagem natural → um comando/workflow
-argument-hint: "[frase do utilizador]"
-allowed-tools:
-  - Read
----
-
-**Workflow canónico:** `oxe/workflows/route.md`
-
-Execute integralmente esse ficheiro. Usa `$ARGUMENTS` como pedido a classificar (ver tabela Router em `help.md`).
+---
+name: oxe:route
+description: OXE — Router linguagem natural → um comando/workflow
+argument-hint: "[frase do utilizador]"
+allowed-tools:
+  - Read
+oxe_workflow_slug: route
+oxe_reasoning_mode: status
+oxe_question_policy: none
+oxe_output_contract: routing
+oxe_tool_profile: read_heavy
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 9d140800451c0ea9
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** route
+- **Modo:** estado / roteamento
+- **Perguntas:** nenhuma
+- **Saída esperada:** roteamento
+- **Perfil de ferramentas:** leitura intensa
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `9d140800451c0ea9`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/route.md` e `.oxe/context/packs/route.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow route --json`
+- Responder com leitura curta e orientada a decisão.
+- Dar uma recomendação única e justificar o motivo.
+- Explicitar a confiança quando o estado estiver incompleto ou ambíguo.
+- **Seções esperadas:** Leitura atual · Recomendação · Motivo · Confiança
+- **Bloqueios formais:** missing:state
+- **Referência canónica:** `oxe/workflows/references/reasoning-status.md`
+
+<!-- oxe-reasoning-contract:end -->
+
+**Workflow canónico:** `oxe/workflows/route.md`
+
+Execute integralmente esse ficheiro. Usa `$ARGUMENTS` como pedido a classificar (ver tabela Router em `help.md`).

package/commands/oxe/scan.md

@@ -1,16 +1,49 @@
----
-name: oxe:scan
-description: Escaneia o repositório e gera mapa em .oxe/codebase/ + STATE.md
-argument-hint: "[área opcional, ex. auth, api]"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canónico:** `oxe/workflows/scan.md`
-
-Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Se o utilizador passar texto em `$ARGUMENTS`, usa-o como **foco opcional** de área (pastas/módulos) no mapeamento.
+---
+name: oxe:scan
+description: Escaneia o repositório e gera mapa em .oxe/codebase/ + STATE.md
+argument-hint: "[área opcional, ex. auth, api]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+oxe_workflow_slug: scan
+oxe_reasoning_mode: discovery
+oxe_question_policy: explore_first
+oxe_output_contract: situational
+oxe_tool_profile: read_heavy
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 899fe6bc3684fc6e
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** scan
+- **Modo:** descoberta
+- **Perguntas:** explorar primeiro
+- **Saída esperada:** situacional
+- **Perfil de ferramentas:** leitura intensa
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `899fe6bc3684fc6e`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/scan.md` e `.oxe/context/packs/scan.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow scan --json`
+- Explorar o repositório e os artefatos antes de perguntar.
+- Separar fatos confirmados, inferências e lacunas.
+- Perguntar apenas ambiguidades que mudem a decisão ou o artefato final.
+- **Seções esperadas:** Fatos · Inferências · Lacunas · Próximo passo
+- **Bloqueios formais:** missing:state
+- **Referência canónica:** `oxe/workflows/references/reasoning-discovery.md`
+
+<!-- oxe-reasoning-contract:end -->
+
+**Workflow canónico:** `oxe/workflows/scan.md`
+
+Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Se o utilizador passar texto em `$ARGUMENTS`, usa-o como **foco opcional** de área (pastas/módulos) no mapeamento.

package/commands/oxe/security.md

@@ -1,16 +1,49 @@
----
-name: oxe:security
-description: OXE — Auditoria de segurança OWASP (.oxe/SECURITY.md): P0 crítico / P1 alto / P2 médio
-argument-hint: "[opcional: categoria OWASP, módulo ou arquivo]"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canônico:** `oxe/workflows/security.md`
-
-Execute integralmente esse ficheiro na raiz do repositório. Lê `STACK.md` para determinar categorias OWASP pertinentes. `$ARGUMENTS` = foco opcional.
+---
+name: oxe:security
+description: OXE — Auditoria de segurança OWASP (.oxe/SECURITY.md): P0 crítico / P1 alto / P2 médio
+argument-hint: "[opcional: categoria OWASP, módulo ou arquivo]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+oxe_workflow_slug: security
+oxe_reasoning_mode: review
+oxe_question_policy: none
+oxe_output_contract: findings
+oxe_tool_profile: review_heavy
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 27ebaddfc7191f76
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** security
+- **Modo:** revisão
+- **Perguntas:** nenhuma
+- **Saída esperada:** achados
+- **Perfil de ferramentas:** revisão intensa
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `27ebaddfc7191f76`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/security.md` e `.oxe/context/packs/security.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow security --json`
+- Apresentar findings primeiro, ordenados por severidade e evidência.
+- Separar bug, risco, regressão e lacuna de teste.
+- Se não houver findings, declarar isso explicitamente e listar riscos residuais.
+- **Seções esperadas:** Findings · Perguntas abertas · Riscos residuais · Resumo
+- **Bloqueios formais:** missing:state
+- **Referência canónica:** `oxe/workflows/references/reasoning-review.md`
+
+<!-- oxe-reasoning-contract:end -->
+
+**Workflow canônico:** `oxe/workflows/security.md`
+
+Execute integralmente esse ficheiro na raiz do repositório. Lê `STACK.md` para determinar categorias OWASP pertinentes. `$ARGUMENTS` = foco opcional.

package/commands/oxe/session.md

@@ -9,8 +9,41 @@ allowed-tools:
   - Grep
   - Write
   - Task
+oxe_workflow_slug: session
+oxe_reasoning_mode: execution
+oxe_question_policy: ask_high_impact_only
+oxe_output_contract: execution
+oxe_tool_profile: write_bounded
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 4a7e893fe47767a3
 ---
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** session
+- **Modo:** execução
+- **Perguntas:** perguntar só alto impacto
+- **Saída esperada:** execução
+- **Perfil de ferramentas:** mutação limitada
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `4a7e893fe47767a3`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/session.md` e `.oxe/context/packs/session.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow session --json`
+- Fazer reconhecimento curto antes de editar ou executar mutações.
+- Trabalhar no menor write set viável e validar após cada fatia relevante.
+- Parar e explicitar o bloqueio quando houver hipótese crítica não verificada.
+- **Seções esperadas:** Contexto lido · Alvo da mudança · Validação executada · Resultado · Próximo passo
+- **Bloqueios formais:** missing:state · missing:plan
+- **Referência canónica:** `oxe/workflows/references/reasoning-execution.md`
+
+<!-- oxe-reasoning-contract:end -->
+
 **Workflow canónico:** `oxe/workflows/session.md`
 
 Executa integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa `$ARGUMENTS` como subcomando e foco da operação da sessão ativa.

package/commands/oxe/skill.md

@@ -0,0 +1,49 @@
+---
+name: oxe:skill
+description: "Descobrir, invocar e gerenciar skills (@executor, @researcher, etc.)"
+argument-hint: "[list | explain <id> | new <id> | @<skill-id>]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+oxe_workflow_slug: skill
+oxe_reasoning_mode: execution
+oxe_question_policy: ask_high_impact_only
+oxe_output_contract: execution
+oxe_tool_profile: write_bounded
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 64cec6f03fc7cfe6
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** skill
+- **Modo:** execução
+- **Perguntas:** perguntar só alto impacto
+- **Saída esperada:** execução
+- **Perfil de ferramentas:** mutação limitada
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `64cec6f03fc7cfe6`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/skill.md` e `.oxe/context/packs/skill.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow skill --json`
+- Fazer reconhecimento curto antes de editar ou executar mutações.
+- Trabalhar no menor write set viável e validar após cada fatia relevante.
+- Parar e explicitar o bloqueio quando houver hipótese crítica não verificada.
+- **Seções esperadas:** Contexto lido · Alvo da mudança · Validação executada · Resultado · Próximo passo
+- **Bloqueios formais:** missing:state · missing:plan
+- **Referência canónica:** `oxe/workflows/references/reasoning-execution.md`
+
+<!-- oxe-reasoning-contract:end -->
+
+**Workflow canónico:** `oxe/workflows/skill.md`
+
+Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa `$ARGUMENTS` como subcomando ou invocação de skill.

package/commands/oxe/spec.md

@@ -1,14 +1,47 @@
----
-name: oxe:spec
-description: "Spec em 5 fases: perguntas → pesquisa → requisitos R-ID (v1/v2/fora) → roteiro ROADMAP.md → aprovação → plan"
-argument-hint: "[descrição da feature, ideia ou @arquivo.md com PRD]"
-allowed-tools:
-  - Read
-  - Write
-  - Glob
-  - Grep
----
-
-**Workflow canónico:** `oxe/workflows/spec.md`
-
-Execute integralmente esse ficheiro. Usa `$ARGUMENTS` e o contexto da conversa como entrada do utilizador (texto ou `@ficheiro`).
+---
+name: oxe:spec
+description: "Spec em 5 fases: perguntas → pesquisa → requisitos R-ID (v1/v2/fora) → roteiro ROADMAP.md → aprovação → plan"
+argument-hint: "[descrição da feature, ideia ou @arquivo.md com PRD]"
+allowed-tools:
+  - Read
+  - Write
+  - Glob
+  - Grep
+oxe_workflow_slug: spec
+oxe_reasoning_mode: discovery
+oxe_question_policy: explore_first
+oxe_output_contract: situational
+oxe_tool_profile: read_heavy
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 482d3eb12fe261ed
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** spec
+- **Modo:** descoberta
+- **Perguntas:** explorar primeiro
+- **Saída esperada:** situacional
+- **Perfil de ferramentas:** leitura intensa
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `482d3eb12fe261ed`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/spec.md` e `.oxe/context/packs/spec.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow spec --json`
+- Explorar o repositório e os artefatos antes de perguntar.
+- Separar fatos confirmados, inferências e lacunas.
+- Perguntar apenas ambiguidades que mudem a decisão ou o artefato final.
+- **Seções esperadas:** Fatos · Inferências · Lacunas · Próximo passo
+- **Bloqueios formais:** missing:state
+- **Referência canónica:** `oxe/workflows/references/reasoning-discovery.md`
+
+<!-- oxe-reasoning-contract:end -->
+
+**Workflow canónico:** `oxe/workflows/spec.md`
+
+Execute integralmente esse ficheiro. Usa `$ARGUMENTS` e o contexto da conversa como entrada do utilizador (texto ou `@ficheiro`).

package/commands/oxe/ui-review.md

@@ -1,16 +1,49 @@
----
-name: oxe:ui-review
-description: OXE — Auditoria UI (.oxe/UI-REVIEW.md)
-argument-hint: "[paths ou Tn opcional]"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canónico:** `oxe/workflows/ui-review.md`
-
-Execute integralmente esse ficheiro na raiz do repositório. Usa `$ARGUMENTS` como âmbito da revisão.
+---
+name: oxe:ui-review
+description: OXE — Auditoria UI (.oxe/UI-REVIEW.md)
+argument-hint: "[paths ou Tn opcional]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+oxe_workflow_slug: ui-review
+oxe_reasoning_mode: review
+oxe_question_policy: none
+oxe_output_contract: findings
+oxe_tool_profile: review_heavy
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 94c1695de8d9ec7d
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** ui-review
+- **Modo:** revisão
+- **Perguntas:** nenhuma
+- **Saída esperada:** achados
+- **Perfil de ferramentas:** revisão intensa
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `94c1695de8d9ec7d`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/ui-review.md` e `.oxe/context/packs/ui-review.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow ui-review --json`
+- Apresentar findings primeiro, ordenados por severidade e evidência.
+- Separar bug, risco, regressão e lacuna de teste.
+- Se não houver findings, declarar isso explicitamente e listar riscos residuais.
+- **Seções esperadas:** Findings · Perguntas abertas · Riscos residuais · Resumo
+- **Bloqueios formais:** missing:state
+- **Referência canónica:** `oxe/workflows/references/reasoning-review.md`
+
+<!-- oxe-reasoning-contract:end -->
+
+**Workflow canónico:** `oxe/workflows/ui-review.md`
+
+Execute integralmente esse ficheiro na raiz do repositório. Usa `$ARGUMENTS` como âmbito da revisão.

package/commands/oxe/ui-spec.md

@@ -1,16 +1,49 @@
----
-name: oxe:ui-spec
-description: OXE — Contrato UI (.oxe/UI-SPEC.md) a partir da SPEC
-argument-hint: "[âmbito UI opcional]"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canónico:** `oxe/workflows/ui-spec.md`
-
-Execute integralmente esse ficheiro na raiz do repositório. Usa `$ARGUMENTS` como foco opcional de UI.
+---
+name: oxe:ui-spec
+description: OXE — Contrato UI (.oxe/UI-SPEC.md) a partir da SPEC
+argument-hint: "[âmbito UI opcional]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+oxe_workflow_slug: ui-spec
+oxe_reasoning_mode: planning
+oxe_question_policy: ask_high_impact_only
+oxe_output_contract: plan
+oxe_tool_profile: mixed
+oxe_confidence_policy: rubric
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 76ba6d1e0e2f02e6
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** ui-spec
+- **Modo:** planejamento
+- **Perguntas:** perguntar só alto impacto
+- **Saída esperada:** plano
+- **Perfil de ferramentas:** misto
+- **Política de confiança:** rubrica
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `76ba6d1e0e2f02e6`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/ui-spec.md` e `.oxe/context/packs/ui-spec.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow ui-spec --json`
+- Fechar interfaces, validação, riscos, rollback e assumptions relevantes.
+- Não deixar decisões importantes para quem implementar depois.
+- Explicitar confiança e condição objetiva para replanejar.
+- **Seções esperadas:** Objetivo · Plano · Validação · Riscos · Assumptions · Confiança
+- **Bloqueios formais:** missing:state · missing:spec
+- **Referência canónica:** `oxe/workflows/references/reasoning-planning.md`
+
+<!-- oxe-reasoning-contract:end -->
+
+**Workflow canónico:** `oxe/workflows/ui-spec.md`
+
+Execute integralmente esse ficheiro na raiz do repositório. Usa `$ARGUMENTS` como foco opcional de UI.

package/commands/oxe/update.md

@@ -1,16 +1,49 @@
----
-name: oxe:update
-description: OXE — Atualiza workflows e integrações para a versão mais recente do oxe-cc no npm
-argument-hint: "[--force] [--check] [--if-newer]"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canônico:** `oxe/workflows/update.md`
-
-Execute integralmente esse ficheiro. Verifica versão no npm, reinstala com --force se necessário e valida com doctor. `$ARGUMENTS` = flags opcionais.
+---
+name: oxe:update
+description: OXE — Atualiza workflows e integrações para a versão mais recente do oxe-cc no npm
+argument-hint: "[--force] [--check] [--if-newer]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+oxe_workflow_slug: update
+oxe_reasoning_mode: execution
+oxe_question_policy: ask_high_impact_only
+oxe_output_contract: execution
+oxe_tool_profile: write_bounded
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 49332cbd409f2ac6
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** update
+- **Modo:** execução
+- **Perguntas:** perguntar só alto impacto
+- **Saída esperada:** execução
+- **Perfil de ferramentas:** mutação limitada
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `49332cbd409f2ac6`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/update.md` e `.oxe/context/packs/update.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow update --json`
+- Fazer reconhecimento curto antes de editar ou executar mutações.
+- Trabalhar no menor write set viável e validar após cada fatia relevante.
+- Parar e explicitar o bloqueio quando houver hipótese crítica não verificada.
+- **Seções esperadas:** Contexto lido · Alvo da mudança · Validação executada · Resultado · Próximo passo
+- **Bloqueios formais:** missing:state · missing:plan
+- **Referência canónica:** `oxe/workflows/references/reasoning-execution.md`
+
+<!-- oxe-reasoning-contract:end -->
+
+**Workflow canônico:** `oxe/workflows/update.md`
+
+Execute integralmente esse ficheiro. Verifica versão no npm, reinstala com --force se necessário e valida com doctor. `$ARGUMENTS` = flags opcionais.

package/commands/oxe/validate-gaps.md

@@ -1,16 +1,49 @@
----
-name: oxe:validate-gaps
-description: OXE — Auditoria Nyquist-lite (.oxe/VALIDATION-GAPS.md) após verify
-argument-hint: "[opcional: Tn ou A*]"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canónico:** `oxe/workflows/validate-gaps.md`
-
-Execute integralmente esse ficheiro na raiz do repositório. Pré-requisito: `VERIFY.md` e `PLAN.md`. `$ARGUMENTS` = foco opcional.
+---
+name: oxe:validate-gaps
+description: OXE — Auditoria Nyquist-lite (.oxe/VALIDATION-GAPS.md) após verify
+argument-hint: "[opcional: Tn ou A*]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+oxe_workflow_slug: validate-gaps
+oxe_reasoning_mode: review
+oxe_question_policy: none
+oxe_output_contract: findings
+oxe_tool_profile: review_heavy
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 27d51ac144da4c1c
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** validate-gaps
+- **Modo:** revisão
+- **Perguntas:** nenhuma
+- **Saída esperada:** achados
+- **Perfil de ferramentas:** revisão intensa
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `27d51ac144da4c1c`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/validate-gaps.md` e `.oxe/context/packs/validate-gaps.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow validate-gaps --json`
+- Apresentar findings primeiro, ordenados por severidade e evidência.
+- Separar bug, risco, regressão e lacuna de teste.
+- Se não houver findings, declarar isso explicitamente e listar riscos residuais.
+- **Seções esperadas:** Findings · Perguntas abertas · Riscos residuais · Resumo
+- **Bloqueios formais:** missing:state
+- **Referência canónica:** `oxe/workflows/references/reasoning-review.md`
+
+<!-- oxe-reasoning-contract:end -->
+
+**Workflow canónico:** `oxe/workflows/validate-gaps.md`
+
+Execute integralmente esse ficheiro na raiz do repositório. Pré-requisito: `VERIFY.md` e `PLAN.md`. `$ARGUMENTS` = foco opcional.