oxe-cc 1.5.0 → 1.6.0

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.
Files changed (50) hide show
  1. package/.cursor/commands/oxe-dashboard.md +2 -2
  2. package/.cursor/commands/oxe-execute.md +2 -2
  3. package/.cursor/commands/oxe-plan.md +2 -2
  4. package/.github/prompts/oxe-dashboard.prompt.md +2 -2
  5. package/.github/prompts/oxe-execute.prompt.md +2 -2
  6. package/.github/prompts/oxe-plan.prompt.md +2 -2
  7. package/AGENTS.md +1 -1
  8. package/CHANGELOG.md +52 -0
  9. package/README.md +17 -15
  10. package/bin/lib/oxe-context-engine.cjs +9 -4
  11. package/bin/lib/oxe-dashboard.cjs +140 -58
  12. package/bin/lib/oxe-project-health.cjs +486 -151
  13. package/bin/lib/oxe-rationality.cjs +385 -0
  14. package/bin/lib/oxe-release.cjs +76 -4
  15. package/bin/oxe-cc.js +113 -58
  16. package/commands/oxe/dashboard.md +2 -2
  17. package/commands/oxe/execute.md +2 -2
  18. package/commands/oxe/plan.md +2 -2
  19. package/docs/RELEASE-READINESS.md +8 -0
  20. package/docs/RUNTIME-SMOKE-MATRIX.md +9 -2
  21. package/lib/sdk/index.cjs +20 -11
  22. package/lib/sdk/index.d.ts +99 -34
  23. package/oxe/templates/CONFIG.md +3 -3
  24. package/oxe/templates/EXECUTION-RUNTIME.template.md +1 -1
  25. package/oxe/templates/FIXTURE-PACK.template.json +34 -0
  26. package/oxe/templates/FIXTURE-PACK.template.md +21 -0
  27. package/oxe/templates/IMPLEMENTATION-PACK.template.json +52 -0
  28. package/oxe/templates/IMPLEMENTATION-PACK.template.md +36 -0
  29. package/oxe/templates/INVESTIGATION.template.md +38 -38
  30. package/oxe/templates/PLAN.template.md +23 -14
  31. package/oxe/templates/REFERENCE-ANCHORS.template.md +24 -0
  32. package/oxe/templates/RESEARCH.template.md +11 -11
  33. package/oxe/templates/SPEC.template.md +6 -6
  34. package/oxe/templates/SUMMARY.template.md +20 -20
  35. package/oxe/templates/config.template.json +1 -1
  36. package/oxe/workflows/execute.md +18 -2
  37. package/oxe/workflows/milestone.md +12 -12
  38. package/oxe/workflows/next.md +1 -1
  39. package/oxe/workflows/plan.md +115 -57
  40. package/oxe/workflows/references/adaptive-discovery.md +27 -27
  41. package/oxe/workflows/references/flow-robustness-contract.md +80 -80
  42. package/oxe/workflows/references/session-path-resolution.md +71 -71
  43. package/oxe/workflows/references/workflow-runtime-contracts.json +36 -4
  44. package/oxe/workflows/verify.md +4 -4
  45. package/oxe/workflows/workstream.md +16 -16
  46. package/package.json +1 -1
  47. package/packages/runtime/package.json +1 -1
  48. package/vscode-extension/oxe-agents-1.5.1.vsix +0 -0
  49. package/vscode-extension/oxe-agents-1.6.0.vsix +0 -0
  50. package/vscode-extension/package.json +1 -1
@@ -0,0 +1,34 @@
1
+ {
2
+ "schema_version": "1",
3
+ "generated_at": "YYYY-MM-DDTHH:MM:SSZ",
4
+ "ready": false,
5
+ "critical_gaps": [],
6
+ "fixtures": [
7
+ {
8
+ "id": "FX-01",
9
+ "task_id": "T1",
10
+ "status": "ready",
11
+ "inputs": [
12
+ {
13
+ "kind": "payload",
14
+ "ref": ".oxe/investigations/fixtures/example-input.json",
15
+ "summary": "payload base para validar o fluxo"
16
+ }
17
+ ],
18
+ "expected_outputs": [
19
+ {
20
+ "kind": "status",
21
+ "summary": "deve concluir sem erro e persistir o artefato esperado"
22
+ }
23
+ ],
24
+ "expected_checks": [
25
+ "npm test -- example"
26
+ ],
27
+ "critical_fields": [
28
+ "id",
29
+ "status"
30
+ ],
31
+ "critical_gaps": []
32
+ }
33
+ ]
34
+ }
@@ -0,0 +1,21 @@
1
+ # OXE — Fixture Pack
2
+
3
+ > Fixtures mínimos para reduzir improviso em parsing, integração, transformação, migração e builders.
4
+
5
+ ## Status
6
+
7
+ - **Status:** ready | not_ready | not_applicable
8
+ - **Critical gaps abertos:** nenhum | listar
9
+
10
+ ## Fixtures
11
+
12
+ ### FX-01 — T1
13
+
14
+ - **Task:** T1
15
+ - **Status:** ready | missing | not_applicable
16
+ - **Inputs:** payload, arquivo exemplo, query, blob ou mensagem
17
+ - **Expected outputs:** linha, evento, arquivo, rowset, status etc.
18
+ - **Expected checks:** `...`
19
+ - **Campos críticos / offsets:** ...
20
+ - **Smoke command:** `...`
21
+ - **Critical gaps:** nenhum | listar
@@ -0,0 +1,52 @@
1
+ {
2
+ "schema_version": "1",
3
+ "generated_at": "YYYY-MM-DDTHH:MM:SSZ",
4
+ "ready": false,
5
+ "critical_gaps": [],
6
+ "tasks": [
7
+ {
8
+ "id": "T1",
9
+ "title": "substituir pelo título da tarefa",
10
+ "mode": "mutating",
11
+ "ready": false,
12
+ "exact_paths": [
13
+ "src/example.ts"
14
+ ],
15
+ "write_set": "closed",
16
+ "symbols": [
17
+ {
18
+ "kind": "function",
19
+ "name": "exampleHandler",
20
+ "path": "src/example.ts",
21
+ "signature": "(input: ExampleInput) => ExampleOutput"
22
+ }
23
+ ],
24
+ "contracts": [
25
+ {
26
+ "name": "example-contract",
27
+ "input_shape": "ExampleInput",
28
+ "output_shape": "ExampleOutput",
29
+ "invariants": [
30
+ "não perder campos obrigatórios"
31
+ ],
32
+ "not_allowed": [
33
+ "mutar schema fora do write set"
34
+ ]
35
+ }
36
+ ],
37
+ "snippets": [
38
+ {
39
+ "source_ref": "not_applicable",
40
+ "path": "not_applicable",
41
+ "summary": "not_applicable",
42
+ "status": "not_applicable"
43
+ }
44
+ ],
45
+ "expected_checks": [
46
+ "npm test -- example"
47
+ ],
48
+ "requires_fixture": false,
49
+ "critical_gaps": []
50
+ }
51
+ ]
52
+ }
@@ -0,0 +1,36 @@
1
+ # OXE — Implementation Pack
2
+
3
+ > Contrato racional de implementação por tarefa. Este arquivo complementa o `PLAN.md` e fecha write-set, symbols, contracts e checks esperados antes do `/oxe-execute`.
4
+
5
+ ## Status
6
+
7
+ - **Status:** ready | not_ready | not_applicable
8
+ - **Critical gaps abertos:** nenhum | listar
9
+ - **Fonte:** `PLAN.md` + código real + anchors locais
10
+
11
+ ## Tarefas
12
+
13
+ ### T1 — (título)
14
+
15
+ - **Mode:** mutating | docs_only | external | not_applicable
16
+ - **Ready:** true | false
17
+ - **Exact paths:** `src/...`, `config/...`
18
+ - **Write set:** closed | external | not_applicable
19
+ - **Symbols alvo:**
20
+ - `kind:name(path)` — assinatura ou shape esperado
21
+ - **Contracts:**
22
+ - **Nome:** (ex.: payload parser)
23
+ - **Entrada:** ...
24
+ - **Saída:** ...
25
+ - **Invariants:** ...
26
+ - **Not allowed:** ...
27
+ - **Expected checks:**
28
+ - `...`
29
+ - **Requires fixture:** true | false
30
+ - **Snippet/base local:** path ou `not_applicable`
31
+ - **Critical gaps:** nenhum | listar
32
+
33
+ ## Observações
34
+
35
+ - Use caminhos exatos; não usar `...`.
36
+ - Tarefa mutável sem `symbols`, `contracts`, `write_set: closed` e `expected_checks` não deve sustentar confiança `> 90%`.
@@ -1,38 +1,38 @@
1
- ---
2
- oxe_doc: investigation
3
- status: draft
4
- updated: YYYY-MM-DD
5
- objective: ""
6
- mode: surface
7
- sources: []
8
- ---
9
-
10
- # OXE — Investigação Estruturada
11
-
12
- ## Objetivo
13
-
14
- - Pergunta principal a responder.
15
-
16
- ## Fontes
17
-
18
- - Fonte / path / sistema
19
-
20
- ## Método
21
-
22
- - Como a investigação foi conduzida.
23
-
24
- ## Evidências
25
-
26
- - Evidência 1
27
-
28
- ## Conclusões
29
-
30
- - Conclusão 1
31
-
32
- ## Impacto em spec/plan
33
-
34
- - Como isto altera a SPEC, o plano ou a confiança.
35
-
36
- ## Próximo passo
37
-
38
- - O que ainda falta validar.
1
+ ---
2
+ oxe_doc: investigation
3
+ status: draft
4
+ updated: YYYY-MM-DD
5
+ objective: ""
6
+ mode: surface
7
+ sources: []
8
+ ---
9
+
10
+ # OXE — Investigação Estruturada
11
+
12
+ ## Objetivo
13
+
14
+ - Pergunta principal a responder.
15
+
16
+ ## Fontes
17
+
18
+ - Fonte / path / sistema
19
+
20
+ ## Método
21
+
22
+ - Como a investigação foi conduzida.
23
+
24
+ ## Evidências
25
+
26
+ - Evidência 1
27
+
28
+ ## Conclusões
29
+
30
+ - Conclusão 1
31
+
32
+ ## Impacto em spec/plan
33
+
34
+ - Como isto altera a SPEC, o plano ou a confiança.
35
+
36
+ ## Próximo passo
37
+
38
+ - O que ainda falta validar.
@@ -19,30 +19,31 @@ inputs: []
19
19
  - **Spec vinculada:** (data ou versão informal)
20
20
  - **Ondas:** (número)
21
21
  - **Tarefas:** (número)
22
+ - **Artefatos racionais:** `IMPLEMENTATION-PACK`, `REFERENCE-ANCHORS`, `FIXTURE-PACK`
22
23
 
23
24
  ## Autoavaliação do Plano
24
25
 
25
26
  - **Melhor plano atual:** sim
26
- - **Confiança:** 80%
27
+ - **Confiança:** 92%
27
28
  - **Base da confiança:**
28
- - Completude dos requisitos: 20/25
29
- - Dependências conhecidas: 12/15
30
- - Risco técnico: 15/20
31
- - Impacto no código existente: 12/15
32
- - Clareza da validação / testes: 13/15
33
- - Lacunas externas / decisões pendentes: 8/10
29
+ - Completude dos requisitos: 23/25
30
+ - Dependências conhecidas: 14/15
31
+ - Risco técnico: 18/20
32
+ - Impacto no código existente: 14/15
33
+ - Clareza da validação / testes: 14/15
34
+ - Lacunas externas / decisões pendentes: 9/10
34
35
  - **Principais incertezas:** (0–3 bullets)
35
36
  - **Alternativas descartadas:** (1–2 linhas)
36
37
  - **Condição para replanejar:** (critério objetivo)
37
38
 
38
39
  <confidence_vector cycle="C-NN" generated_at="YYYY-MM-DDTHH:MM:SSZ">
39
- <dim name="requirements" score="0.80" weight="25" note="completude dos requisitos" />
40
- <dim name="dependencies" score="0.80" weight="15" note="dependências conhecidas" />
41
- <dim name="technical_risk" score="0.75" weight="20" note="risco técnico — ajustar se H* pendentes" />
42
- <dim name="code_impact" score="0.80" weight="15" note="impacto no código existente" />
43
- <dim name="validation" score="0.87" weight="15" note="clareza da validação / testes" />
44
- <dim name="open_gaps" score="0.80" weight="10" note="lacunas externas / decisões pendentes" />
45
- <global score="0.80" gate="proceed_with_risk" />
40
+ <dim name="requirements" score="0.92" weight="25" note="completude dos requisitos" />
41
+ <dim name="dependencies" score="0.93" weight="15" note="dependências conhecidas" />
42
+ <dim name="technical_risk" score="0.90" weight="20" note="risco técnico — ajustar se H* pendentes" />
43
+ <dim name="code_impact" score="0.93" weight="15" note="impacto no código existente" />
44
+ <dim name="validation" score="0.93" weight="15" note="clareza da validação / testes" />
45
+ <dim name="open_gaps" score="0.90" weight="10" note="lacunas externas / decisões pendentes" />
46
+ <global score="0.92" gate="proceed" />
46
47
  </confidence_vector>
47
48
 
48
49
  <!--
@@ -70,6 +71,13 @@ inputs: []
70
71
 
71
72
  - (ex.: branch base, feature flags, migrations)
72
73
 
74
+ ## Artefatos racionais de execução
75
+
76
+ - **IMPLEMENTATION-PACK:** `ready | not_ready | not_applicable`
77
+ - **REFERENCE-ANCHORS:** `ready | not_ready | not_applicable`
78
+ - **FIXTURE-PACK:** `ready | not_ready | not_applicable`
79
+ - **Critical gaps abertos:** (nenhum | listar IDs/causas)
80
+
73
81
  ## Replanejamento
74
82
 
75
83
  > Preencher apenas em **--replan** ou após verify falhado. Manter histórico legível.
@@ -91,6 +99,7 @@ inputs: []
91
99
  - Manual: (opcional) …
92
100
  - **Implementar:** o mínimo para fazer a verificação acima passar.
93
101
  - **Aceite vinculado:** A1, A2 (IDs da tabela de critérios em SPEC.md)
102
+ - **Contrato racional:** ver `IMPLEMENTATION-PACK.json` (task `T1`)
94
103
 
95
104
  ---
96
105
 
@@ -0,0 +1,24 @@
1
+ # OXE — Reference Anchors
2
+
3
+ > 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.
4
+
5
+ <reference_anchors version="1" ready="false" status="not_ready">
6
+ <anchor
7
+ id="RA-01"
8
+ task="T1"
9
+ critical="true"
10
+ status="resolved"
11
+ source_type="local"
12
+ path=".oxe/investigations/externals/exemplo.txt"
13
+ source_ref="external-ref: exemplo">
14
+ <relevance>Por que esta referência sustenta a tarefa.</relevance>
15
+ <action>copy | adapt | consult</action>
16
+ <summary>Resumo semântico curto do trecho relevante ou do contrato.</summary>
17
+ </anchor>
18
+ </reference_anchors>
19
+
20
+ ## Regras
21
+
22
+ - Se não houver referência aplicável, usar `<reference_anchors ... status="not_applicable" ready="true">`.
23
+ - `critical="true"` exige `status="resolved"` antes do execute.
24
+ - `path` deve ser reproduzível no workspace ou materializado em `.oxe/investigations/externals/`.
@@ -1,4 +1,4 @@
1
- # OXE — Nota de pesquisa
1
+ # OXE — Nota de pesquisa
2
2
 
3
3
  > Um ficheiro por sessão: copie para `.oxe/research/YYYY-MM-DD-<slug-kebab>.md` (data ISO; slug curto e único).
4
4
 
@@ -7,16 +7,16 @@
7
7
  - Ligação à SPEC: objetivo, IDs **A*** tocados (ou *N/A — SPEC ainda não existe* + recomendação de `oxe:spec`).
8
8
  - Entrada do utilizador / âmbito (paths, módulos, perguntas).
9
9
 
10
- ## Perguntas em aberto
11
-
12
- 1. … (critério para considerar “fechado”)
13
-
14
- ## Investigação estruturada
15
-
16
- - **Objetivo:** …
17
- - **Modo:** `surface` | `standard` | `deep`
18
- - **Fontes:** …
19
- - **Profundidade:** …
10
+ ## Perguntas em aberto
11
+
12
+ 1. … (critério para considerar “fechado”)
13
+
14
+ ## Investigação estruturada
15
+
16
+ - **Objetivo:** …
17
+ - **Modo:** `surface` | `standard` | `deep`
18
+ - **Fontes:** …
19
+ - **Profundidade:** …
20
20
 
21
21
  ## Evidência
22
22
 
@@ -19,12 +19,12 @@ inputs: []
19
19
 
20
20
  (Uma frase: o que entregar.)
21
21
 
22
- ## Contexto
23
-
24
- - Repositório / produto: …
25
- - Links úteis: …
26
- - Tipo de demanda: feature | bugfix | refactor | research | ops | mixed
27
- - Incertezas estruturadas: …
22
+ ## Contexto
23
+
24
+ - Repositório / produto: …
25
+ - Links úteis: …
26
+ - Tipo de demanda: feature | bugfix | refactor | research | ops | mixed
27
+ - Incertezas estruturadas: …
28
28
 
29
29
  ## Escopo
30
30
 
@@ -1,20 +1,20 @@
1
- # OXE — Resumo de sessão
2
-
3
- > Usado por **verify** (append) e por **plan --replan** para contexto incremental. Podes criar manualmente a partir deste template.
4
-
5
- ## Sessão
6
-
7
- - **Data:** (ISO ou legível)
8
- - **Spec / plano:** (referência breve a `.oxe/SPEC.md` / `.oxe/PLAN.md`)
9
-
10
- ## Feito nesta sessão
11
-
12
- - …
13
-
14
- ## Decisões / notas
15
-
16
- - …
17
-
18
- ## Pendente ou follow-up
19
-
20
- - …
1
+ # OXE — Resumo de sessão
2
+
3
+ > Usado por **verify** (append) e por **plan --replan** para contexto incremental. Podes criar manualmente a partir deste template.
4
+
5
+ ## Sessão
6
+
7
+ - **Data:** (ISO ou legível)
8
+ - **Spec / plano:** (referência breve a `.oxe/SPEC.md` / `.oxe/PLAN.md`)
9
+
10
+ ## Feito nesta sessão
11
+
12
+ - …
13
+
14
+ ## Decisões / notas
15
+
16
+ - …
17
+
18
+ ## Pendente ou follow-up
19
+
20
+ - …
@@ -3,7 +3,7 @@
3
3
  "profile": "balanced",
4
4
  "discuss_before_plan": false,
5
5
  "verification_depth": "standard",
6
- "plan_confidence_threshold": 70,
6
+ "plan_confidence_threshold": 90,
7
7
  "security_in_verify": false,
8
8
  "adversarial_verify": false,
9
9
  "after_verify_suggest_pr": true,
@@ -124,6 +124,13 @@ Quando o comando `**Verificar:**` de uma tarefa `Tn` falha, **não parar silenci
124
124
 
125
125
  **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.
126
126
 
127
+ **Artefatos racionais obrigatórios:** quando a execução vier de `PLAN.md`, ler antes da primeira mutação:
128
+ - `IMPLEMENTATION-PACK.md` / `IMPLEMENTATION-PACK.json`
129
+ - `REFERENCE-ANCHORS.md`
130
+ - `FIXTURE-PACK.md` / `FIXTURE-PACK.json`
131
+
132
+ 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.
133
+
127
134
  **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.
128
135
 
129
136
  **Runtime enterprise como caminho padrão:** quando `oxe-cc runtime` estiver disponível no ambiente, preferir o caminho formal deste passo:
@@ -185,8 +192,14 @@ Se condições não atendidas: responder sem persona; sugerir `/oxe-plan-agent`
185
192
  2. Se existir `PLAN.md`, validar a seção `## Autoavaliação do Plano` antes de qualquer implementação:
186
193
  - `Melhor plano atual` deve ser `sim`;
187
194
  - `Confiança` deve existir em `0–100%`;
188
- - se `.oxe/config.json` definir `plan_confidence_threshold`, usar esse limiar; senão, usar `70%`;
189
- - se a confiança estiver abaixo do limiar, **não executar**. Registrar o bloqueio e orientar redução de incerteza (`/oxe-discuss`, `/oxe-research` ou `/oxe-plan --replan`).
195
+ - o bloco `<confidence_vector>` deve existir e ser coerente com a confiança declarada;
196
+ - se `.oxe/config.json` definir `plan_confidence_threshold`, usar esse limiar respeitando o piso canónico de `90%`; senão, usar `90%`;
197
+ - 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`).
198
+ 2a. Antes da primeira mutação, validar os artefatos racionais do plano:
199
+ - `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`;
200
+ - `REFERENCE-ANCHORS.md` deve existir e manter todas as âncoras críticas em `status: resolved`;
201
+ - `FIXTURE-PACK.json` deve existir, estar `ready` e cobrir tarefas de parser/layout/integração/transformação/fila/migração/builder;
202
+ - 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`.
190
203
  3. Antes da primeira mudança, verificar `CHECKPOINTS.md` e `EXECUTION-RUNTIME.md` do escopo resolvido:
191
204
  - se houver checkpoint `pending_approval` que se aplique à onda atual, **não avançar**;
192
205
  - inicializar ou atualizar o runtime com onda atual, status, agentes ativos, handoffs e evidências esperadas.
@@ -212,6 +225,7 @@ Se condições não atendidas: responder sem persona; sugerir `/oxe-plan-agent`
212
225
  8. Listar no chat: tarefas/passos desta onda, arquivos prováveis, comando **Verificar** de cada tarefa.
213
226
  8a. Antes de implementar, explicitar no chat:
214
227
  - **Contexto lido** (incluindo se veio de pack fresco ou de fallback)
228
+ - **Artefatos racionais lidos** (implementation/anchors/fixtures e eventuais gaps)
215
229
  - **Alvo da mudança**
216
230
  - **Validação prevista**
217
231
  9. **Implementar** conforme o modo escolhido:
@@ -240,6 +254,8 @@ Se condições não atendidas: responder sem persona; sugerir `/oxe-plan-agent`
240
254
  - [ ] Checklist da onda apresentado ou refletido no STATE.md.
241
255
  - [ ] STATE.md registra progresso (Tn ou passos) e próximo passo.
242
256
  - [ ] Verificação alinhada ao bloco **Verificar** do PLAN ou QUICK.
257
+ - [ ] Com `PLAN.md`, `IMPLEMENTATION-PACK`, `REFERENCE-ANCHORS` e `FIXTURE-PACK` foram lidos e validados antes da primeira mutação.
258
+ - [ ] Se qualquer artefato racional estiver ausente ou inconsistente, a execução bloqueia explicitamente e recomenda `/oxe-plan --replan`.
243
259
  - [ ] OBS pendentes verificadas antes de cada onda: `blocking` resolvidos antes de avançar, `adjustment` incorporados como restrições, `info`/legado incorporados normalmente.
244
260
  - [ ] Com quick-agents ativos: cada agente trabalha só em seus `steps[]`; ao concluir, `quick-agents.json` → `done`.
245
261
  - [ ] 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.
@@ -10,10 +10,10 @@ Subcomandos:
10
10
  - `/oxe-milestone audit` — verificar se o milestone atingiu sua definição de pronto.
11
11
  </objective>
12
12
 
13
- <context>
14
- - 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.
15
- - Nesta versão, milestones são **globais**: usar `.oxe/global/MILESTONES.md` e `.oxe/global/milestones/`, ignorando `active_session` para escrita do índice global.
16
- - Milestones são rastreados em **`.oxe/global/MILESTONES.md`** (índice) e cada entrega tem uma entrada com status, data e links aos artefatos.
13
+ <context>
14
+ - 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.
15
+ - Nesta versão, milestones são **globais**: usar `.oxe/global/MILESTONES.md` e `.oxe/global/milestones/`, ignorando `active_session` para escrita do índice global.
16
+ - Milestones são rastreados em **`.oxe/global/MILESTONES.md`** (índice) e cada entrega tem uma entrada com status, data e links aos artefatos.
17
17
  - O milestone ativo é registrado no **STATE.md** na seção **Milestone ativo**.
18
18
  - Um milestone é considerado **pronto** quando:
19
19
  1. Todos os critérios A* da SPEC estão com `verify_complete` no STATE.
@@ -27,7 +27,7 @@ Subcomandos:
27
27
 
28
28
  1. Verificar se há milestone ativo em STATE.md. Se houver, alertar e pedir confirmação antes de criar novo.
29
29
  2. Gerar ID sequencial: **M-01**, **M-02**, …
30
- 3. Criar entrada em **`.oxe/global/MILESTONES.md`**:
30
+ 3. Criar entrada em **`.oxe/global/MILESTONES.md`**:
31
31
  ```markdown
32
32
  ## M-01 — [nome] (ativo)
33
33
  - **Status:** ativo
@@ -51,11 +51,11 @@ Pré-requisitos (verificar antes de executar):
51
51
  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.
52
52
 
53
53
  Passos:
54
- 1. Arquivar artefatos do milestone:
55
- - Copiar os artefatos do escopo ativo da sessão, se houver, para `.oxe/global/milestones/M-NN/`
56
- - Sem sessão ativa, copiar da raiz `.oxe/`
57
- - Criar `.oxe/global/milestones/M-NN/MILESTONE.md` com resumo da entrega.
58
- 2. Atualizar **`.oxe/global/MILESTONES.md`**: marcar milestone como `entregue`, adicionar data de encerramento e links aos artefatos arquivados.
54
+ 1. Arquivar artefatos do milestone:
55
+ - Copiar os artefatos do escopo ativo da sessão, se houver, para `.oxe/global/milestones/M-NN/`
56
+ - Sem sessão ativa, copiar da raiz `.oxe/`
57
+ - Criar `.oxe/global/milestones/M-NN/MILESTONE.md` com resumo da entrega.
58
+ 2. Atualizar **`.oxe/global/MILESTONES.md`**: marcar milestone como `entregue`, adicionar data de encerramento e links aos artefatos arquivados.
59
59
  3. Atualizar **STATE.md**: limpar seção **Milestone ativo**, registrar **Último milestone** com ID e data.
60
60
  4. Sugerir próximo milestone ou nova spec: `Milestone M-NN concluído. Próximos passos: /oxe-milestone new v2 | /oxe-spec | /oxe-checkpoint`.
61
61
  </process_complete>
@@ -64,7 +64,7 @@ Passos:
64
64
  **`/oxe-milestone status`**
65
65
 
66
66
  1. Ler STATE.md para identificar milestone ativo (ID e nome).
67
- 2. Ler `.oxe/global/MILESTONES.md` para detalhes.
67
+ 2. Ler `.oxe/global/MILESTONES.md` para detalhes.
68
68
  3. Ler SPEC.md para listar critérios A* e seu status (verificado / pendente).
69
69
  4. Ler VERIFY.md (se existir) para gaps abertos.
70
70
  5. Exibir no chat:
@@ -88,7 +88,7 @@ Resultado: `Milestone M-NN: PRONTO` ou lista de itens pendentes.
88
88
  </process_audit>
89
89
 
90
90
  <success_criteria>
91
- - [ ] `.oxe/global/MILESTONES.md` existe e tem entrada para o milestone ativo.
91
+ - [ ] `.oxe/global/MILESTONES.md` existe e tem entrada para o milestone ativo.
92
92
  - [ ] STATE.md indica milestone ativo (ID e nome).
93
93
  - [ ] Ao completar: artefatos arquivados em `.oxe/milestones/M-NN/`.
94
94
  - [ ] Ao completar: MILESTONES.md atualizado com status `entregue` e data.
@@ -22,7 +22,7 @@ Inspecionar `.oxe/STATE.md` global, a sessão ativa quando existir, e a existên
22
22
  - Senão → **execute** (há passos curtos a implementar).
23
23
  4. Se não houver `SPEC.md` no escopo resolvido e não for quick intencional declarado → **spec** (passo único).
24
24
  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**.
25
- 6. Se PLAN existe mas a seção **Autoavaliação do Plano** disser `Melhor plano atual: não`, ou a `Confiança` estiver abaixo do limiar configurado (padrão 70%), o próximo passo deve ser **plan** (replanejar) ou **discuss/research** se a própria autoavaliação indicar isso.
25
+ 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.
26
26
  7. Se PLAN existe, **VERIFY.md** ainda **não** existe ou está claramente antes da implementação atual → **execute** (onda atual).
27
27
  8. Se PLAN existe e VERIFY falta após implementação declarada → **verify**.
28
28
  9. Se VERIFY indica falha ou gaps não resolvidos → **plan** (replanejamento) como passo único, com referência a `SUMMARY.md`.