oxe-cc 1.5.1 → 1.6.0

package/oxe/templates/INVESTIGATION.template.md

@@ -1,38 +1,38 @@
----
-oxe_doc: investigation
-status: draft
-updated: YYYY-MM-DD
-objective: ""
-mode: surface
-sources: []
----
-
-# OXE — Investigação Estruturada
-
-## Objetivo
-
-- Pergunta principal a responder.
-
-## Fontes
-
-- Fonte / path / sistema
-
-## Método
-
-- Como a investigação foi conduzida.
-
-## Evidências
-
-- Evidência 1
-
-## Conclusões
-
-- Conclusão 1
-
-## Impacto em spec/plan
-
-- Como isto altera a SPEC, o plano ou a confiança.
-
-## Próximo passo
-
-- O que ainda falta validar.
+---
+oxe_doc: investigation
+status: draft
+updated: YYYY-MM-DD
+objective: ""
+mode: surface
+sources: []
+---
+
+# OXE — Investigação Estruturada
+
+## Objetivo
+
+- Pergunta principal a responder.
+
+## Fontes
+
+- Fonte / path / sistema
+
+## Método
+
+- Como a investigação foi conduzida.
+
+## Evidências
+
+- Evidência 1
+
+## Conclusões
+
+- Conclusão 1
+
+## Impacto em spec/plan
+
+- Como isto altera a SPEC, o plano ou a confiança.
+
+## Próximo passo
+
+- O que ainda falta validar.

package/oxe/templates/PLAN.template.md

@@ -14,36 +14,36 @@ inputs: []
 
 > Gerado a partir de `.oxe/SPEC.md`. Cada tarefa deve ter bloco **Verificar**.
 
-## Resumo
-
-- **Spec vinculada:** (data ou versão informal)
-- **Ondas:** (número)
-- **Tarefas:** (número)
-- **Artefatos racionais:** `IMPLEMENTATION-PACK`, `REFERENCE-ANCHORS`, `FIXTURE-PACK`
+## Resumo
+
+- **Spec vinculada:** (data ou versão informal)
+- **Ondas:** (número)
+- **Tarefas:** (número)
+- **Artefatos racionais:** `IMPLEMENTATION-PACK`, `REFERENCE-ANCHORS`, `FIXTURE-PACK`
 
 ## Autoavaliação do Plano
 
 - **Melhor plano atual:** sim
-- **Confiança:** 92%
+- **Confiança:** 92%
 - **Base da confiança:**
-  - Completude dos requisitos: 23/25
-  - Dependências conhecidas: 14/15
-  - Risco técnico: 18/20
-  - Impacto no código existente: 14/15
-  - Clareza da validação / testes: 14/15
-  - Lacunas externas / decisões pendentes: 9/10
+  - Completude dos requisitos: 23/25
+  - Dependências conhecidas: 14/15
+  - Risco técnico: 18/20
+  - Impacto no código existente: 14/15
+  - Clareza da validação / testes: 14/15
+  - Lacunas externas / decisões pendentes: 9/10
 - **Principais incertezas:** (0–3 bullets)
 - **Alternativas descartadas:** (1–2 linhas)
 - **Condição para replanejar:** (critério objetivo)
 
 <confidence_vector cycle="C-NN" generated_at="YYYY-MM-DDTHH:MM:SSZ">
-  <dim name="requirements"   score="0.92" weight="25" note="completude dos requisitos" />
-  <dim name="dependencies"   score="0.93" weight="15" note="dependências conhecidas" />
-  <dim name="technical_risk" score="0.90" weight="20" note="risco técnico — ajustar se H* pendentes" />
-  <dim name="code_impact"    score="0.93" weight="15" note="impacto no código existente" />
-  <dim name="validation"     score="0.93" weight="15" note="clareza da validação / testes" />
-  <dim name="open_gaps"      score="0.90" weight="10" note="lacunas externas / decisões pendentes" />
-  <global score="0.92" gate="proceed" />
+  <dim name="requirements"   score="0.92" weight="25" note="completude dos requisitos" />
+  <dim name="dependencies"   score="0.93" weight="15" note="dependências conhecidas" />
+  <dim name="technical_risk" score="0.90" weight="20" note="risco técnico — ajustar se H* pendentes" />
+  <dim name="code_impact"    score="0.93" weight="15" note="impacto no código existente" />
+  <dim name="validation"     score="0.93" weight="15" note="clareza da validação / testes" />
+  <dim name="open_gaps"      score="0.90" weight="10" note="lacunas externas / decisões pendentes" />
+  <global score="0.92" gate="proceed" />
 </confidence_vector>
 
 <!--
@@ -67,18 +67,18 @@ inputs: []
 </hypothesis>
 -->
 
-## Dependências globais
-
-- (ex.: branch base, feature flags, migrations)
-
-## Artefatos racionais de execução
-
-- **IMPLEMENTATION-PACK:** `ready | not_ready | not_applicable`
-- **REFERENCE-ANCHORS:** `ready | not_ready | not_applicable`
-- **FIXTURE-PACK:** `ready | not_ready | not_applicable`
-- **Critical gaps abertos:** (nenhum | listar IDs/causas)
-
-## Replanejamento
+## Dependências globais
+
+- (ex.: branch base, feature flags, migrations)
+
+## Artefatos racionais de execução
+
+- **IMPLEMENTATION-PACK:** `ready | not_ready | not_applicable`
+- **REFERENCE-ANCHORS:** `ready | not_ready | not_applicable`
+- **FIXTURE-PACK:** `ready | not_ready | not_applicable`
+- **Critical gaps abertos:** (nenhum | listar IDs/causas)
+
+## Replanejamento
 
 > Preencher apenas em **--replan** ou após verify falhado. Manter histórico legível.
 
@@ -88,19 +88,19 @@ inputs: []
 
 ## Tarefas
 
-### T1 — (título)
-
-- **Arquivos prováveis:** `…`
-- **Depende de:** —
-- **Onda:** 1
-- **Complexidade:** S
-- **Verificar:**
-  - Comando: `…`
-  - Manual: (opcional) …
-- **Implementar:** o mínimo para fazer a verificação acima passar.
-- **Aceite vinculado:** A1, A2 (IDs da tabela de critérios em SPEC.md)
-- **Contrato racional:** ver `IMPLEMENTATION-PACK.json` (task `T1`)
-
----
+### T1 — (título)
+
+- **Arquivos prováveis:** `…`
+- **Depende de:** —
+- **Onda:** 1
+- **Complexidade:** S
+- **Verificar:**
+  - Comando: `…`
+  - Manual: (opcional) …
+- **Implementar:** o mínimo para fazer a verificação acima passar.
+- **Aceite vinculado:** A1, A2 (IDs da tabela de critérios em SPEC.md)
+- **Contrato racional:** ver `IMPLEMENTATION-PACK.json` (task `T1`)
+
+---
 
 _(Adicione T2, T3, … conforme o comando oxe:plan.)_

package/oxe/templates/REFERENCE-ANCHORS.template.md

@@ -1,24 +1,24 @@
-# OXE — Reference Anchors
-
-> Materialização de referências críticas usadas pelo plano. Toda referência externa, predecessor, layout ou contrato que sustente uma tarefa deve virar âncora reproduzível aqui.
-
-<reference_anchors version="1" ready="false" status="not_ready">
-  <anchor
-    id="RA-01"
-    task="T1"
-    critical="true"
-    status="resolved"
-    source_type="local"
-    path=".oxe/investigations/externals/exemplo.txt"
-    source_ref="external-ref: exemplo">
-    <relevance>Por que esta referência sustenta a tarefa.</relevance>
-    <action>copy | adapt | consult</action>
-    <summary>Resumo semântico curto do trecho relevante ou do contrato.</summary>
-  </anchor>
-</reference_anchors>
-
-## Regras
-
-- Se não houver referência aplicável, usar `<reference_anchors ... status="not_applicable" ready="true">`.
-- `critical="true"` exige `status="resolved"` antes do execute.
-- `path` deve ser reproduzível no workspace ou materializado em `.oxe/investigations/externals/`.
+# OXE — Reference Anchors
+
+> Materialização de referências críticas usadas pelo plano. Toda referência externa, predecessor, layout ou contrato que sustente uma tarefa deve virar âncora reproduzível aqui.
+
+<reference_anchors version="1" ready="false" status="not_ready">
+  <anchor
+    id="RA-01"
+    task="T1"
+    critical="true"
+    status="resolved"
+    source_type="local"
+    path=".oxe/investigations/externals/exemplo.txt"
+    source_ref="external-ref: exemplo">
+    <relevance>Por que esta referência sustenta a tarefa.</relevance>
+    <action>copy | adapt | consult</action>
+    <summary>Resumo semântico curto do trecho relevante ou do contrato.</summary>
+  </anchor>
+</reference_anchors>
+
+## Regras
+
+- Se não houver referência aplicável, usar `<reference_anchors ... status="not_applicable" ready="true">`.
+- `critical="true"` exige `status="resolved"` antes do execute.
+- `path` deve ser reproduzível no workspace ou materializado em `.oxe/investigations/externals/`.

package/oxe/templates/RESEARCH.template.md

@@ -1,4 +1,4 @@
-# OXE — Nota de pesquisa
+# OXE — Nota de pesquisa
 
 > Um ficheiro por sessão: copie para `.oxe/research/YYYY-MM-DD-<slug-kebab>.md` (data ISO; slug curto e único).
 
@@ -7,16 +7,16 @@
 - Ligação à SPEC: objetivo, IDs **A*** tocados (ou *N/A — SPEC ainda não existe* + recomendação de `oxe:spec`).
 - Entrada do utilizador / âmbito (paths, módulos, perguntas).
 
-## Perguntas em aberto
-
-1. … (critério para considerar “fechado”)
-
-## Investigação estruturada
-
-- **Objetivo:** …
-- **Modo:** `surface` | `standard` | `deep`
-- **Fontes:** …
-- **Profundidade:** …
+## Perguntas em aberto
+
+1. … (critério para considerar “fechado”)
+
+## Investigação estruturada
+
+- **Objetivo:** …
+- **Modo:** `surface` | `standard` | `deep`
+- **Fontes:** …
+- **Profundidade:** …
 
 ## Evidência
 

package/oxe/templates/SPEC.template.md

@@ -19,12 +19,12 @@ inputs: []
 
 (Uma frase: o que entregar.)
 
-## Contexto
-
-- Repositório / produto: …
-- Links úteis: …
-- Tipo de demanda: feature | bugfix | refactor | research | ops | mixed
-- Incertezas estruturadas: …
+## Contexto
+
+- Repositório / produto: …
+- Links úteis: …
+- Tipo de demanda: feature | bugfix | refactor | research | ops | mixed
+- Incertezas estruturadas: …
 
 ## Escopo
 

package/oxe/templates/SUMMARY.template.md

@@ -1,20 +1,20 @@
-# OXE — Resumo de sessão
-
-> Usado por **verify** (append) e por **plan --replan** para contexto incremental. Podes criar manualmente a partir deste template.
-
-## Sessão
-
-- **Data:** (ISO ou legível)
-- **Spec / plano:** (referência breve a `.oxe/SPEC.md` / `.oxe/PLAN.md`)
-
-## Feito nesta sessão
-
-- …
-
-## Decisões / notas
-
-- …
-
-## Pendente ou follow-up
-
-- …
+# OXE — Resumo de sessão
+
+> Usado por **verify** (append) e por **plan --replan** para contexto incremental. Podes criar manualmente a partir deste template.
+
+## Sessão
+
+- **Data:** (ISO ou legível)
+- **Spec / plano:** (referência breve a `.oxe/SPEC.md` / `.oxe/PLAN.md`)
+
+## Feito nesta sessão
+
+- …
+
+## Decisões / notas
+
+- …
+
+## Pendente ou follow-up
+
+- …

package/oxe/templates/config.template.json

@@ -3,7 +3,7 @@
   "profile": "balanced",
   "discuss_before_plan": false,
   "verification_depth": "standard",
-  "plan_confidence_threshold": 90,
+  "plan_confidence_threshold": 90,
   "security_in_verify": false,
   "adversarial_verify": false,
   "after_verify_suggest_pr": true,

package/oxe/workflows/execute.md

@@ -120,16 +120,16 @@ Quando o comando `**Verificar:**` de uma tarefa `Tn` falha, **não parar silenci
 <context>
 **Contrato de raciocínio:** aplicar `oxe/workflows/references/reasoning-execution.md`. Antes de mutar, fazer reconhecimento curto; durante a execução, operar no menor write set viável e validar após cada fatia relevante.
 
-**Contrato de robustez:** seguir `oxe/workflows/references/flow-robustness-contract.md`. Antes de executar, validar os artefatos obrigatórios e o gate do plano.
-
-**Context pack prioritário:** antes de abrir o conjunto amplo de artefatos, resolver `.oxe/context/packs/execute.md` e `.oxe/context/packs/execute.json` como entrada principal do passo. Se o pack estiver fresco/coerente, usar `read_order` e `selected_artifacts` para limitar o reconhecimento inicial à onda/tarefa atual. Se estiver stale, ausente ou com lacunas críticas, fazer fallback explícito para leitura direta e registrar isso no runtime ou no resumo da execução.
-
-**Artefatos racionais obrigatórios:** quando a execução vier de `PLAN.md`, ler antes da primeira mutação:
-- `IMPLEMENTATION-PACK.md` / `IMPLEMENTATION-PACK.json`
-- `REFERENCE-ANCHORS.md`
-- `FIXTURE-PACK.md` / `FIXTURE-PACK.json`
-
-O `execute` é **pack-first**, não apenas `plan-first`. Esses artefatos existem para impedir improviso de paths, interfaces, referências externas e fixtures. Se estiverem ausentes, inconsistentes ou com `critical_gap`, a execução deve bloquear e devolver para replanejamento.
+**Contrato de robustez:** seguir `oxe/workflows/references/flow-robustness-contract.md`. Antes de executar, validar os artefatos obrigatórios e o gate do plano.
+
+**Context pack prioritário:** antes de abrir o conjunto amplo de artefatos, resolver `.oxe/context/packs/execute.md` e `.oxe/context/packs/execute.json` como entrada principal do passo. Se o pack estiver fresco/coerente, usar `read_order` e `selected_artifacts` para limitar o reconhecimento inicial à onda/tarefa atual. Se estiver stale, ausente ou com lacunas críticas, fazer fallback explícito para leitura direta e registrar isso no runtime ou no resumo da execução.
+
+**Artefatos racionais obrigatórios:** quando a execução vier de `PLAN.md`, ler antes da primeira mutação:
+- `IMPLEMENTATION-PACK.md` / `IMPLEMENTATION-PACK.json`
+- `REFERENCE-ANCHORS.md`
+- `FIXTURE-PACK.md` / `FIXTURE-PACK.json`
+
+O `execute` é **pack-first**, não apenas `plan-first`. Esses artefatos existem para impedir improviso de paths, interfaces, referências externas e fixtures. Se estiverem ausentes, inconsistentes ou com `critical_gap`, a execução deve bloquear e devolver para replanejamento.
 
 **Runtime operacional:** usar `EXECUTION-RUNTIME.md` do escopo resolvido como artefato tático da execução. Ele deve refletir agentes ativos, onda atual, handoffs, evidências, retries, checkpoints pendentes e tarefas bloqueadas. O `PLAN.md` continua estratégico; o runtime regista a operação do ciclo.
 
@@ -189,20 +189,20 @@ Se condições não atendidas: responder sem persona; sugerir `/oxe-plan-agent`
    - se estiver stale, incompleto ou ausente, declarar `fallback para leitura direta` antes de seguir.
 1b. **Verificação de hipóteses críticas:** se o context pack contiver o campo `hypotheses` com entradas `status: pending` cujo `checkpoint` coincide com a onda atual — validar cada uma antes de iniciar qualquer mutação. Se a hipótese for refutada, registrar bloqueio explícito em `EXECUTION-RUNTIME.md` e não editar código antes de resolver. Se for validada, atualizar `status: validated` no `PLAN.md`.
 1c. Fazer reconhecimento curto dos artefatos e arquivos prováveis da onda atual antes da primeira mudança. Com pack válido, limitar essa leitura aos artefatos de `read_order` e aos arquivos prováveis da onda; sem pack válido, expandir só o necessário.
-2. Se existir `PLAN.md`, validar a seção `## Autoavaliação do Plano` antes de qualquer implementação:
-   - `Melhor plano atual` deve ser `sim`;
-   - `Confiança` deve existir em `0–100%`;
-   - o bloco `<confidence_vector>` deve existir e ser coerente com a confiança declarada;
-   - se `.oxe/config.json` definir `plan_confidence_threshold`, usar esse limiar respeitando o piso canónico de `90%`; senão, usar `90%`;
-   - se a confiança não superar o limiar (`<=`) ou se a autoavaliação estiver incompleta, **não executar**. Registrar o bloqueio e orientar redução de incerteza (`/oxe-discuss`, `/oxe-research` ou `/oxe-plan --replan`).
-2a. Antes da primeira mutação, validar os artefatos racionais do plano:
-   - `IMPLEMENTATION-PACK.json` deve existir, estar `ready`, cobrir cada `Tn` mutável e usar `exact_paths` sem `...`, `symbols`, `contracts`, `write_set: "closed"` e `expected_checks`;
-   - `REFERENCE-ANCHORS.md` deve existir e manter todas as âncoras críticas em `status: resolved`;
-   - `FIXTURE-PACK.json` deve existir, estar `ready` e cobrir tarefas de parser/layout/integração/transformação/fila/migração/builder;
-   - se algum pack tiver `critical_gap`, **não executar**. Registrar o bloqueio explicitamente em `EXECUTION-RUNTIME.md` / `STATE.md` e recomendar um único próximo passo: normalmente `/oxe-plan --replan`.
-3. Antes da primeira mudança, verificar `CHECKPOINTS.md` e `EXECUTION-RUNTIME.md` do escopo resolvido:
-   - se houver checkpoint `pending_approval` que se aplique à onda atual, **não avançar**;
-   - inicializar ou atualizar o runtime com onda atual, status, agentes ativos, handoffs e evidências esperadas.
+2. Se existir `PLAN.md`, validar a seção `## Autoavaliação do Plano` antes de qualquer implementação:
+   - `Melhor plano atual` deve ser `sim`;
+   - `Confiança` deve existir em `0–100%`;
+   - o bloco `<confidence_vector>` deve existir e ser coerente com a confiança declarada;
+   - se `.oxe/config.json` definir `plan_confidence_threshold`, usar esse limiar respeitando o piso canónico de `90%`; senão, usar `90%`;
+   - se a confiança não superar o limiar (`<=`) ou se a autoavaliação estiver incompleta, **não executar**. Registrar o bloqueio e orientar redução de incerteza (`/oxe-discuss`, `/oxe-research` ou `/oxe-plan --replan`).
+2a. Antes da primeira mutação, validar os artefatos racionais do plano:
+   - `IMPLEMENTATION-PACK.json` deve existir, estar `ready`, cobrir cada `Tn` mutável e usar `exact_paths` sem `...`, `symbols`, `contracts`, `write_set: "closed"` e `expected_checks`;
+   - `REFERENCE-ANCHORS.md` deve existir e manter todas as âncoras críticas em `status: resolved`;
+   - `FIXTURE-PACK.json` deve existir, estar `ready` e cobrir tarefas de parser/layout/integração/transformação/fila/migração/builder;
+   - se algum pack tiver `critical_gap`, **não executar**. Registrar o bloqueio explicitamente em `EXECUTION-RUNTIME.md` / `STATE.md` e recomendar um único próximo passo: normalmente `/oxe-plan --replan`.
+3. Antes da primeira mudança, verificar `CHECKPOINTS.md` e `EXECUTION-RUNTIME.md` do escopo resolvido:
+   - se houver checkpoint `pending_approval` que se aplique à onda atual, **não avançar**;
+   - inicializar ou atualizar o runtime com onda atual, status, agentes ativos, handoffs e evidências esperadas.
 3a. **Caminho padrão do runtime enterprise:** se `oxe-cc runtime` estiver disponível:
    - executar ou solicitar `oxe-cc runtime compile --dir <projeto>` antes da primeira mutação;
    - se compilar com sucesso, tratar `ACTIVE-RUN.json`, `.oxe/runs/<run_id>.json`, `compiled_graph` e `canonical_state` como estado operacional primário da execução;
@@ -222,12 +222,12 @@ Se condições não atendidas: responder sem persona; sugerir `/oxe-plan-agent`
    - O mesmo gate aplica-se em Azure `apply` quando `scope: apply` ou `all`
 6. **Seleção de modo** (apenas se PLAN.md com 2+ ondas e `execute_mode` não definido em STATE): se o argumento já for `A`, `B` ou `C`, usá-lo diretamente; senão apresentar opções A/B/C e aguardar escolha; registrar em STATE.md.
 7. Identificar **onda ou bloco atual**: no PLAN, todas as tarefas da mesma onda sem dependências pendentes; no QUICK, passos ainda não marcados como feitos.
-8. Listar no chat: tarefas/passos desta onda, arquivos prováveis, comando **Verificar** de cada tarefa.
-8a. Antes de implementar, explicitar no chat:
-   - **Contexto lido** (incluindo se veio de pack fresco ou de fallback)
-   - **Artefatos racionais lidos** (implementation/anchors/fixtures e eventuais gaps)
-   - **Alvo da mudança**
-   - **Validação prevista**
+8. Listar no chat: tarefas/passos desta onda, arquivos prováveis, comando **Verificar** de cada tarefa.
+8a. Antes de implementar, explicitar no chat:
+   - **Contexto lido** (incluindo se veio de pack fresco ou de fallback)
+   - **Artefatos racionais lidos** (implementation/anchors/fixtures e eventuais gaps)
+   - **Alvo da mudança**
+   - **Validação prevista**
 9. **Implementar** conforme o modo escolhido:
    - **Modo Completo:** executar todas as ondas em sequência com verificação inline entre ondas; sumarizar ao final.
    - **Modo Por onda:** executar onda atual, apresentar checklist, parar.
@@ -253,11 +253,11 @@ Se condições não atendidas: responder sem persona; sugerir `/oxe-plan-agent`
 - [ ] Onda ou bloco de passos explicitado antes de "implementar".
 - [ ] Checklist da onda apresentado ou refletido no STATE.md.
 - [ ] STATE.md registra progresso (Tn ou passos) e próximo passo.
-- [ ] Verificação alinhada ao bloco **Verificar** do PLAN ou QUICK.
-- [ ] Com `PLAN.md`, `IMPLEMENTATION-PACK`, `REFERENCE-ANCHORS` e `FIXTURE-PACK` foram lidos e validados antes da primeira mutação.
-- [ ] Se qualquer artefato racional estiver ausente ou inconsistente, a execução bloqueia explicitamente e recomenda `/oxe-plan --replan`.
-- [ ] OBS pendentes verificadas antes de cada onda: `blocking` resolvidos antes de avançar, `adjustment` incorporados como restrições, `info`/legado incorporados normalmente.
-- [ ] Com quick-agents ativos: cada agente trabalha só em seus `steps[]`; ao concluir, `quick-agents.json` → `done`.
-- [ ] Com blueprint schema 2 válido: não adotar persona para pedidos fora das `Tn`; `runId` alinhado entre JSON e STATE; handoffs escritos quando protocolo exige.
+- [ ] Verificação alinhada ao bloco **Verificar** do PLAN ou QUICK.
+- [ ] Com `PLAN.md`, `IMPLEMENTATION-PACK`, `REFERENCE-ANCHORS` e `FIXTURE-PACK` foram lidos e validados antes da primeira mutação.
+- [ ] Se qualquer artefato racional estiver ausente ou inconsistente, a execução bloqueia explicitamente e recomenda `/oxe-plan --replan`.
+- [ ] OBS pendentes verificadas antes de cada onda: `blocking` resolvidos antes de avançar, `adjustment` incorporados como restrições, `info`/legado incorporados normalmente.
+- [ ] Com quick-agents ativos: cada agente trabalha só em seus `steps[]`; ao concluir, `quick-agents.json` → `done`.
+- [ ] Com blueprint schema 2 válido: não adotar persona para pedidos fora das `Tn`; `runId` alinhado entre JSON e STATE; handoffs escritos quando protocolo exige.
 - [ ] Quando `oxe-cc runtime` estiver disponível, `runtime compile` foi tentado antes da primeira mutação e `runtime project` foi usado para reprojetar artefatos após a onda/bloco.
 </success_criteria>

package/oxe/workflows/milestone.md

@@ -10,10 +10,10 @@ Subcomandos:
 - `/oxe-milestone audit` — verificar se o milestone atingiu sua definição de pronto.
 </objective>
 
-<context>
-- Milestone ≠ Checkpoint. **Checkpoint** (`/oxe-checkpoint`) é um snapshot de sessão — restaurável a qualquer momento. **Milestone** é uma entrega — marcador de versão com artefatos arquivados e critérios de pronto validados.
-- Nesta versão, milestones são **globais**: usar `.oxe/global/MILESTONES.md` e `.oxe/global/milestones/`, ignorando `active_session` para escrita do índice global.
-- Milestones são rastreados em **`.oxe/global/MILESTONES.md`** (índice) e cada entrega tem uma entrada com status, data e links aos artefatos.
+<context>
+- Milestone ≠ Checkpoint. **Checkpoint** (`/oxe-checkpoint`) é um snapshot de sessão — restaurável a qualquer momento. **Milestone** é uma entrega — marcador de versão com artefatos arquivados e critérios de pronto validados.
+- Nesta versão, milestones são **globais**: usar `.oxe/global/MILESTONES.md` e `.oxe/global/milestones/`, ignorando `active_session` para escrita do índice global.
+- Milestones são rastreados em **`.oxe/global/MILESTONES.md`** (índice) e cada entrega tem uma entrada com status, data e links aos artefatos.
 - O milestone ativo é registrado no **STATE.md** na seção **Milestone ativo**.
 - Um milestone é considerado **pronto** quando:
   1. Todos os critérios A* da SPEC estão com `verify_complete` no STATE.
@@ -27,7 +27,7 @@ Subcomandos:
 
 1. Verificar se há milestone ativo em STATE.md. Se houver, alertar e pedir confirmação antes de criar novo.
 2. Gerar ID sequencial: **M-01**, **M-02**, …
-3. Criar entrada em **`.oxe/global/MILESTONES.md`**:
+3. Criar entrada em **`.oxe/global/MILESTONES.md`**:
    ```markdown
    ## M-01 — [nome] (ativo)
    - **Status:** ativo
@@ -51,11 +51,11 @@ Pré-requisitos (verificar antes de executar):
 Se pré-requisitos não forem satisfeitos: listar os que faltam e pausar. Com `--force`: documentar pré-requisitos não satisfeitos e continuar com aviso.
 
 Passos:
-1. Arquivar artefatos do milestone:
-   - Copiar os artefatos do escopo ativo da sessão, se houver, para `.oxe/global/milestones/M-NN/`
-   - Sem sessão ativa, copiar da raiz `.oxe/`
-   - Criar `.oxe/global/milestones/M-NN/MILESTONE.md` com resumo da entrega.
-2. Atualizar **`.oxe/global/MILESTONES.md`**: marcar milestone como `entregue`, adicionar data de encerramento e links aos artefatos arquivados.
+1. Arquivar artefatos do milestone:
+   - Copiar os artefatos do escopo ativo da sessão, se houver, para `.oxe/global/milestones/M-NN/`
+   - Sem sessão ativa, copiar da raiz `.oxe/`
+   - Criar `.oxe/global/milestones/M-NN/MILESTONE.md` com resumo da entrega.
+2. Atualizar **`.oxe/global/MILESTONES.md`**: marcar milestone como `entregue`, adicionar data de encerramento e links aos artefatos arquivados.
 3. Atualizar **STATE.md**: limpar seção **Milestone ativo**, registrar **Último milestone** com ID e data.
 4. Sugerir próximo milestone ou nova spec: `Milestone M-NN concluído. Próximos passos: /oxe-milestone new v2 | /oxe-spec | /oxe-checkpoint`.
 </process_complete>
@@ -64,7 +64,7 @@ Passos:
 **`/oxe-milestone status`**
 
 1. Ler STATE.md para identificar milestone ativo (ID e nome).
-2. Ler `.oxe/global/MILESTONES.md` para detalhes.
+2. Ler `.oxe/global/MILESTONES.md` para detalhes.
 3. Ler SPEC.md para listar critérios A* e seu status (verificado / pendente).
 4. Ler VERIFY.md (se existir) para gaps abertos.
 5. Exibir no chat:
@@ -88,7 +88,7 @@ Resultado: `Milestone M-NN: PRONTO` ou lista de itens pendentes.
 </process_audit>
 
 <success_criteria>
-- [ ] `.oxe/global/MILESTONES.md` existe e tem entrada para o milestone ativo.
+- [ ] `.oxe/global/MILESTONES.md` existe e tem entrada para o milestone ativo.
 - [ ] STATE.md indica milestone ativo (ID e nome).
 - [ ] Ao completar: artefatos arquivados em `.oxe/milestones/M-NN/`.
 - [ ] Ao completar: MILESTONES.md atualizado com status `entregue` e data.

package/oxe/workflows/next.md

@@ -22,7 +22,7 @@ Inspecionar `.oxe/STATE.md` global, a sessão ativa quando existir, e a existên
    - Senão → **execute** (há passos curtos a implementar).
 4. Se não houver `SPEC.md` no escopo resolvido e não for quick intencional declarado → **spec** (passo único).
 5. Se houver SPEC no escopo resolvido mas não PLAN → se `.oxe/config.json` tiver `discuss_before_plan: true` e faltar **`DISCUSS.md`** com decisões → **discuss**; senão → **plan**.
-6. Se PLAN existe mas a seção **Autoavaliação do Plano** estiver incompleta, disser `Melhor plano atual: não`, ou a `Confiança` não superar o limiar configurado (padrão canónico `>90%`), o próximo passo deve ser **plan** (replanejar) ou **discuss/research** se a própria autoavaliação indicar isso.
+6. Se PLAN existe mas a seção **Autoavaliação do Plano** estiver incompleta, disser `Melhor plano atual: não`, ou a `Confiança` não superar o limiar configurado (padrão canónico `>90%`), o próximo passo deve ser **plan** (replanejar) ou **discuss/research** se a própria autoavaliação indicar isso.
 7. Se PLAN existe, **VERIFY.md** ainda **não** existe ou está claramente antes da implementação atual → **execute** (onda atual).
 8. Se PLAN existe e VERIFY falta após implementação declarada → **verify**.
 9. Se VERIFY indica falha ou gaps não resolvidos → **plan** (replanejamento) como passo único, com referência a `SUMMARY.md`.