oxe-cc 1.2.1 → 1.4.0

package/oxe/templates/CAPABILITY.template.md

@@ -1,45 +1,45 @@
----
-oxe_capability: true
-id: sample-capability
-version: 1
-type: script
-status: active
-scope: execute
-requires_env: []
-entrypoint: ""
-approval_policy: require_approval_if_external_side_effect
-side_effects: []
-evidence_outputs: []
-session_compatibility: [legacy, session]
----
-
-# OXE — Capability
-
-## Objetivo
-
-- O que esta capability faz.
-
-## Escopo OXE
-
-- `scan` | `ask` | `research` | `spec` | `plan` | `execute` | `verify`
-
-## Operações
-
-- Operação 1
-
-## Entradas e saídas
-
-- Entradas esperadas
-- Saídas produzidas
-
-## Requisitos
-
-- Variáveis de ambiente
-- Dependências externas
-- Aprovação necessária ou bypass permitido
-
-## Evidência e segurança
-
-- Como a capability produz evidência útil.
-- Limites e riscos.
-- Side effects possíveis e como são governados.
+---
+oxe_capability: true
+id: sample-capability
+version: 1
+type: script
+status: active
+scope: execute
+requires_env: []
+entrypoint: ""
+approval_policy: require_approval_if_external_side_effect
+side_effects: []
+evidence_outputs: []
+session_compatibility: [legacy, session]
+---
+
+# OXE — Capability
+
+## Objetivo
+
+- O que esta capability faz.
+
+## Escopo OXE
+
+- `scan` | `ask` | `research` | `spec` | `plan` | `execute` | `verify`
+
+## Operações
+
+- Operação 1
+
+## Entradas e saídas
+
+- Entradas esperadas
+- Saídas produzidas
+
+## Requisitos
+
+- Variáveis de ambiente
+- Dependências externas
+- Aprovação necessária ou bypass permitido
+
+## Evidência e segurança
+
+- Como a capability produz evidência útil.
+- Limites e riscos.
+- Side effects possíveis e como são governados.

package/oxe/templates/CHECKPOINTS.template.md

@@ -1,7 +1,7 @@
-# OXE — Checkpoints
-
-> Índice de checkpoints formais do ciclo atual. Usado para aprovações humanas e gates sensíveis.
-
-| ID | Tipo | Fase | Escopo | Estado | Política | Decisão | Override | Criado em | Resolvido em | Notas |
-|----|------|------|--------|--------|----------|---------|----------|-----------|--------------|-------|
-| CP-01 | approval | spec | definição de escopo | pending_approval | require_approval | — | — | YYYY-MM-DD | — | — |
+# OXE — Checkpoints
+
+> Índice de checkpoints formais do ciclo atual. Usado para aprovações humanas e gates sensíveis.
+
+| ID | Tipo | Fase | Escopo | Estado | Política | Decisão | Override | Criado em | Resolvido em | Notas |
+|----|------|------|--------|--------|----------|---------|----------|-----------|--------------|-------|
+| CP-01 | approval | spec | definição de escopo | pending_approval | require_approval | — | — | YYYY-MM-DD | — | — |

package/oxe/templates/EXECUTION-RUNTIME.template.md

@@ -1,68 +1,68 @@
----
-oxe_doc: execution_runtime
-status: active
-updated: YYYY-MM-DD
----
-
-# OXE — Runtime Operacional
-
-> Estado tático da execução. Este ficheiro complementa `PLAN.md` e `STATE.md`, mas não os substitui.
-
-## Contexto
-
-- **Sessão / escopo:** …
-- **Plano vinculado:** `PLAN.md`
-- **Run ID:** `oxe-run-YYYYMMDD-001`
-- **Active run:** `.oxe/ACTIVE-RUN.json` ou artefato equivalente de sessão
-- **Trace log:** `.oxe/OXE-EVENTS.ndjson` ou artefato equivalente de sessão
-- **Autoavaliação do plano:** melhor=`sim|não` | confiança=`NN%`
-- **Limiar de execução:** `70%`
-
-## Onda atual
-
-- **Onda:** —
-- **Estado:** planned | running | paused | waiting_approval | failed | completed | replaying | aborted
-- **Tarefas ativas:** —
-- **Última atualização:** YYYY-MM-DD
-
-## Agentes ativos
-
-| ID | Papel | Tarefas | Estado | Último handoff |
-|----|-------|---------|--------|----------------|
-| … | … | T1, T2 | active | — |
-
-## Checkpoints
-
-| ID | Tipo | Escopo | Estado | Política | Decisão | Evidência |
-|----|------|--------|--------|----------|---------|-----------|
-| CP-01 | approval | Onda 1 | pending_approval | require_approval | — | — |
-
-## Handoffs
-
-- W1 · `agent-a -> agent-b`: …
-
-## Grafo operacional
-
-- **Nós:** agent-a, capability-x, checkpoint-CP-01
-- **Arestas:** handoff, dependency, blocked_by
-
-## Evidências produzidas
-
-- `path/ou/artefato`: resumo curto
-
-## Bloqueios
-
-- (nenhum ou lista)
-
-## Iterações / retries
-
-- Tarefa/onda | Tentativa | Resultado | Nota
-
-## Tracing operacional
-
-- `run_started` → `phase_entered` → `handoff` → `checkpoint_opened` → `checkpoint_resolved` → `verification_completed`
-
-## Próximo movimento operacional
-
-- **Ação:** …
-- **Motivo:** …
+---
+oxe_doc: execution_runtime
+status: active
+updated: YYYY-MM-DD
+---
+
+# OXE — Runtime Operacional
+
+> Estado tático da execução. Este ficheiro complementa `PLAN.md` e `STATE.md`, mas não os substitui.
+
+## Contexto
+
+- **Sessão / escopo:** …
+- **Plano vinculado:** `PLAN.md`
+- **Run ID:** `oxe-run-YYYYMMDD-001`
+- **Active run:** `.oxe/ACTIVE-RUN.json` ou artefato equivalente de sessão
+- **Trace log:** `.oxe/OXE-EVENTS.ndjson` ou artefato equivalente de sessão
+- **Autoavaliação do plano:** melhor=`sim|não` | confiança=`NN%`
+- **Limiar de execução:** `70%`
+
+## Onda atual
+
+- **Onda:** —
+- **Estado:** planned | running | paused | waiting_approval | failed | completed | replaying | aborted
+- **Tarefas ativas:** —
+- **Última atualização:** YYYY-MM-DD
+
+## Agentes ativos
+
+| ID | Papel | Tarefas | Estado | Último handoff |
+|----|-------|---------|--------|----------------|
+| … | … | T1, T2 | active | — |
+
+## Checkpoints
+
+| ID | Tipo | Escopo | Estado | Política | Decisão | Evidência |
+|----|------|--------|--------|----------|---------|-----------|
+| CP-01 | approval | Onda 1 | pending_approval | require_approval | — | — |
+
+## Handoffs
+
+- W1 · `agent-a -> agent-b`: …
+
+## Grafo operacional
+
+- **Nós:** agent-a, capability-x, checkpoint-CP-01
+- **Arestas:** handoff, dependency, blocked_by
+
+## Evidências produzidas
+
+- `path/ou/artefato`: resumo curto
+
+## Bloqueios
+
+- (nenhum ou lista)
+
+## Iterações / retries
+
+- Tarefa/onda | Tentativa | Resultado | Nota
+
+## Tracing operacional
+
+- `run_started` → `phase_entered` → `handoff` → `checkpoint_opened` → `checkpoint_resolved` → `verification_completed`
+
+## Próximo movimento operacional
+
+- **Ação:** …
+- **Motivo:** …

package/oxe/templates/HYPOTHESES.template.md

@@ -1,33 +1,33 @@
----
-oxe_doc: hypotheses
-status: draft
-updated: YYYY-MM-DD
----
-
-<!--
-  Hipóteses Críticas OXE — seção opcional do PLAN.md para tarefas L/XL ou
-  com dependências externas. Cada hipótese deve ser validada antes do
-  checkpoint declarado; se refutada, registrar bloqueio explícito antes de
-  qualquer mutação.
-
-  Formato recomendado: tags XML dentro do MD (para extração pelo context engine)
-  com tabela resumida abaixo para leitura humana.
-
-  Status possíveis: pending | validated | refuted | skipped
--->
-
-## Hipóteses Críticas
-
-<hypothesis id="H1" checkpoint="T2" status="pending">
-  <condition>Descrever a premissa que precisa ser verdadeira para avançar</condition>
-  <validation>Comando ou inspeção que prova/refuta a hipótese (ex: npm install && node test/auth.cjs)</validation>
-  <on_failure>O que fazer se refutada (ex: bloquear T2, abrir pesquisa de alternativa, replanejar)</on_failure>
-</hypothesis>
-
-<!-- Adicionar mais blocos <hypothesis> conforme necessário -->
-
-### Tabela resumida
-
-| ID  | Hipótese               | Checkpoint | Status  |
-|-----|------------------------|------------|---------|
-| H1  | (descrição da premissa)| antes de T?| pending |
+---
+oxe_doc: hypotheses
+status: draft
+updated: YYYY-MM-DD
+---
+
+<!--
+  Hipóteses Críticas OXE — seção opcional do PLAN.md para tarefas L/XL ou
+  com dependências externas. Cada hipótese deve ser validada antes do
+  checkpoint declarado; se refutada, registrar bloqueio explícito antes de
+  qualquer mutação.
+
+  Formato recomendado: tags XML dentro do MD (para extração pelo context engine)
+  com tabela resumida abaixo para leitura humana.
+
+  Status possíveis: pending | validated | refuted | skipped
+-->
+
+## Hipóteses Críticas
+
+<hypothesis id="H1" checkpoint="T2" status="pending">
+  <condition>Descrever a premissa que precisa ser verdadeira para avançar</condition>
+  <validation>Comando ou inspeção que prova/refuta a hipótese (ex: npm install && node test/auth.cjs)</validation>
+  <on_failure>O que fazer se refutada (ex: bloquear T2, abrir pesquisa de alternativa, replanejar)</on_failure>
+</hypothesis>
+
+<!-- Adicionar mais blocos <hypothesis> conforme necessário -->
+
+### Tabela resumida
+
+| ID  | Hipótese               | Checkpoint | Status  |
+|-----|------------------------|------------|---------|
+| H1  | (descrição da premissa)| antes de T?| pending |

package/oxe/templates/LESSONS-METRICS.template.json

@@ -1,13 +1,13 @@
-{
-  "schema_version": "1.0.0",
-  "updated": "{{date}}",
-  "lessons": [],
-  "quality_contracts": [],
-  "summary": {
-    "total_lessons": 0,
-    "active": 0,
-    "deprecated": 0,
-    "high_impact": 0,
-    "avg_success_rate": null
-  }
-}
+{
+  "schema_version": "1.0.0",
+  "updated": "{{date}}",
+  "lessons": [],
+  "quality_contracts": [],
+  "summary": {
+    "total_lessons": 0,
+    "active": 0,
+    "deprecated": 0,
+    "high_impact": 0,
+    "avg_success_rate": null
+  }
+}

package/oxe/templates/NOTES.template.md

@@ -1,16 +1,16 @@
----
-oxe_doc: notes
-updated: YYYY-MM-DD
----
-
-# OXE — Notes
-
-Fila leve de anotações do projeto. Cada bullet é consumido em `/oxe-discuss` ou `/oxe-plan` e depois movido para **Notas incorporadas**.
-
-## Notas em aberto
-
-- YYYY-MM-DD — (nota aqui)
-
-## Notas incorporadas
-
-<!-- Notas movidas automaticamente após consumidas pelo discuss ou plan -->
+---
+oxe_doc: notes
+updated: YYYY-MM-DD
+---
+
+# OXE — Notes
+
+Fila leve de anotações do projeto. Cada bullet é consumido em `/oxe-discuss` ou `/oxe-plan` e depois movido para **Notas incorporadas**.
+
+## Notas em aberto
+
+- YYYY-MM-DD — (nota aqui)
+
+## Notas incorporadas
+
+<!-- Notas movidas automaticamente após consumidas pelo discuss ou plan -->

package/oxe/templates/PLAN-REVIEW.template.md

@@ -1,31 +1,31 @@
----
-oxe_doc: plan_review
-status: draft
-updated: YYYY-MM-DD
-plan_ref: PLAN.md
----
-
-# OXE — Revisão do Plano
-
-## Estado
-
-- **Status:** draft
-- **Atualizado em:** YYYY-MM-DDTHH:mm:ssZ
-- **Origem:** dashboard local ou revisão textual
-
-## Decisão
-
-- **Resultado:** pendente
-- **Justificativa:** —
-
-## Comentários abertos
-
-- Nenhum
-
-## Comentários resolvidos
-
-- Nenhum
-
-## Próxima ação recomendada
-
-- `/oxe-dashboard` para revisar visualmente, ou `/oxe-plan --replan` se houver ajustes estruturais.
+---
+oxe_doc: plan_review
+status: draft
+updated: YYYY-MM-DD
+plan_ref: PLAN.md
+---
+
+# OXE — Revisão do Plano
+
+## Estado
+
+- **Status:** draft
+- **Atualizado em:** YYYY-MM-DDTHH:mm:ssZ
+- **Origem:** dashboard local ou revisão textual
+
+## Decisão
+
+- **Resultado:** pendente
+- **Justificativa:** —
+
+## Comentários abertos
+
+- Nenhum
+
+## Comentários resolvidos
+
+- Nenhum
+
+## Próxima ação recomendada
+
+- `/oxe-dashboard` para revisar visualmente, ou `/oxe-plan --replan` se houver ajustes estruturais.

package/oxe/templates/SESSION.template.md

@@ -1,34 +1,34 @@
-# Session sNNN — <nome>
-
-## Metadados
-
-- **ID:** sNNN
-- **Nome:** <nome>
-- **Status:** active
-- **Criada:** YYYY-MM-DD
-- **Última atividade:** YYYY-MM-DD
-- **Resumo:** <uma linha>
-- **Forked from:** —
-- **Forked at:** —
-
-## Índice de artefatos
-
-| Artefato | Caminho | Status |
-|----------|---------|--------|
-| SESSION | `sessions/sNNN-<slug>/SESSION.md` | ativo |
-
-## Dependências cruzadas
-
-- **Estende:** —
-- **Referenciada por:** —
-- **Decisões globais:** `.oxe/STATE.md`, `.oxe/SESSIONS.md`
-
-## Tags
-
-- `<tag>`
-
-## Histórico
-
-| Data | Evento |
-|------|--------|
-| YYYY-MM-DD | Sessão criada |
+# Session sNNN — <nome>
+
+## Metadados
+
+- **ID:** sNNN
+- **Nome:** <nome>
+- **Status:** active
+- **Criada:** YYYY-MM-DD
+- **Última atividade:** YYYY-MM-DD
+- **Resumo:** <uma linha>
+- **Forked from:** —
+- **Forked at:** —
+
+## Índice de artefatos
+
+| Artefato | Caminho | Status |
+|----------|---------|--------|
+| SESSION | `sessions/sNNN-<slug>/SESSION.md` | ativo |
+
+## Dependências cruzadas
+
+- **Estende:** —
+- **Referenciada por:** —
+- **Decisões globais:** `.oxe/STATE.md`, `.oxe/SESSIONS.md`
+
+## Tags
+
+- `<tag>`
+
+## Histórico
+
+| Data | Evento |
+|------|--------|
+| YYYY-MM-DD | Sessão criada |

package/oxe/templates/SKILL.template.md

@@ -1,26 +1,26 @@
----
-oxe_skill: true
-id: <skill-id>
-name: <Human Readable Name>
-version: 1.0.0
-type: persona | capability | composite
-scope: global | project
-description: <one-line description>
-invoke: "@<skill-id>"
-references: []
-tags: []
----
-
-# Skill: <name>
-
-## Descrição
-
-(Quando e como usar este skill. Uma ou duas frases.)
-
-## Ativação
-
-Mencionar `@<skill-id>` no chat ou incluir na atribuição de agente em plan-agents.json (`"persona": "<skill-id>"`).
-
-## Saída esperada
-
-(O que o agente faz ao adotar este skill.)
+---
+oxe_skill: true
+id: <skill-id>
+name: <Human Readable Name>
+version: 1.0.0
+type: persona | capability | composite
+scope: global | project
+description: <one-line description>
+invoke: "@<skill-id>"
+references: []
+tags: []
+---
+
+# Skill: <name>
+
+## Descrição
+
+(Quando e como usar este skill. Uma ou duas frases.)
+
+## Ativação
+
+Mencionar `@<skill-id>` no chat ou incluir na atribuição de agente em plan-agents.json (`"persona": "<skill-id>"`).
+
+## Saída esperada
+
+(O que o agente faz ao adotar este skill.)