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
@@ -265,6 +265,9 @@
265
265
  "optional_artifacts": [
266
266
  "session_summary",
267
267
  "plan",
268
+ "implementation_pack_json",
269
+ "reference_anchors",
270
+ "fixture_pack_json",
268
271
  "runtime",
269
272
  "verify",
270
273
  "active_run",
@@ -322,11 +325,16 @@
322
325
  "required_artifacts": [
323
326
  "state",
324
327
  "runtime",
325
- "checkpoints"
328
+ "checkpoints",
329
+ "implementation_pack_json",
330
+ "reference_anchors",
331
+ "fixture_pack_json"
326
332
  ],
327
333
  "optional_artifacts": [
328
334
  "plan",
329
335
  "quick",
336
+ "implementation_pack_md",
337
+ "fixture_pack_md",
330
338
  "active_run",
331
339
  "events",
332
340
  "verify",
@@ -343,6 +351,9 @@
343
351
  "runtime",
344
352
  "checkpoints",
345
353
  "plan",
354
+ "implementation_pack_json",
355
+ "reference_anchors",
356
+ "fixture_pack_json",
346
357
  "quick",
347
358
  "phase_summary"
348
359
  ],
@@ -351,6 +362,9 @@
351
362
  "runtime",
352
363
  "checkpoints",
353
364
  "plan",
365
+ "implementation_pack_json",
366
+ "reference_anchors",
367
+ "fixture_pack_json",
354
368
  "quick",
355
369
  "phase_summary",
356
370
  "session_summary",
@@ -364,6 +378,11 @@
364
378
  "runtime",
365
379
  "checkpoints",
366
380
  "plan",
381
+ "implementation_pack_md",
382
+ "implementation_pack_json",
383
+ "reference_anchors",
384
+ "fixture_pack_md",
385
+ "fixture_pack_json",
367
386
  "quick",
368
387
  "active_run",
369
388
  "events",
@@ -521,7 +540,12 @@
521
540
  "capabilities_index",
522
541
  "azure_inventory",
523
542
  "checkpoints",
524
- "calibration"
543
+ "calibration",
544
+ "implementation_pack_md",
545
+ "implementation_pack_json",
546
+ "reference_anchors",
547
+ "fixture_pack_md",
548
+ "fixture_pack_json"
525
549
  ],
526
550
  "context_tiers": {
527
551
  "minimal": [
@@ -540,7 +564,10 @@
540
564
  "project_summary",
541
565
  "global_lessons",
542
566
  "capabilities_index",
543
- "checkpoints"
567
+ "checkpoints",
568
+ "implementation_pack_json",
569
+ "reference_anchors",
570
+ "fixture_pack_json"
544
571
  ],
545
572
  "full": [
546
573
  "state",
@@ -554,7 +581,12 @@
554
581
  "capabilities_index",
555
582
  "azure_inventory",
556
583
  "checkpoints",
557
- "calibration"
584
+ "calibration",
585
+ "implementation_pack_md",
586
+ "implementation_pack_json",
587
+ "reference_anchors",
588
+ "fixture_pack_md",
589
+ "fixture_pack_json"
558
590
  ]
559
591
  },
560
592
  "extraction_intent": "planning_input"
@@ -122,10 +122,10 @@ O preenchimento da checklist é responsabilidade do **usuário** (não do agente
122
122
  **Calibração do plano** (obrigatória quando existir `PLAN.md`)
123
123
 
124
124
  Ler a `## Autoavaliação do Plano` e comparar com o resultado real:
125
- 1. Se `Confiança >= 85%` e houver falha precoce em critérios centrais ou tarefas iniciais, marcar **erro de calibração do plano**.
126
- 2. Se `Confiança < 70%` e as falhas ocorrerem nas incertezas previstas, marcar **autoavaliação aderente**.
127
- 3. Se `Confiança >= 70%` e os critérios/tarefas passarem de forma consistente, marcar **plano calibrado**.
128
- 4. Se `Confiança < 70%` e o ciclo passar amplamente, marcar **plano conservador demais**.
125
+ 1. Se `Confiança > limiar executável` (padrão canónico `90%`) e houver falha precoce em critérios centrais ou tarefas iniciais, marcar **erro de calibração do plano**.
126
+ 2. Se `Confiança <= limiar executável` e as falhas ocorrerem nas incertezas previstas, marcar **autoavaliação aderente**.
127
+ 3. Se `Confiança > limiar executável` e os critérios/tarefas passarem de forma consistente, marcar **plano calibrado**.
128
+ 4. Se `Confiança <= limiar executável` e o ciclo passar amplamente, marcar **plano conservador demais**.
129
129
 
130
130
  Registrar em `VERIFY.md`: `Resultado de calibração | Confiança declarada | Resultado observado | Notas`.
131
131
  </calibracao_do_plano>
@@ -11,7 +11,7 @@ Subcomandos:
11
11
  - `/oxe-workstream close <nome>` — fechar workstream e mesclar contexto ao pipeline principal.
12
12
  </objective>
13
13
 
14
- <context>
14
+ <context>
15
15
  **Por que workstreams?**
16
16
 
17
17
  O pipeline OXE padrão (`.oxe/SPEC.md`, `PLAN.md`, etc.) é linear — uma entrega por vez. Workstreams permitem:
@@ -19,7 +19,7 @@ O pipeline OXE padrão (`.oxe/SPEC.md`, `PLAN.md`, etc.) é linear — uma entre
19
19
  - Trabalho em `bugfix/auth` e `feature/billing` simultaneamente.
20
20
  - Times menores trabalhando em trilhas independentes com contextos separados.
21
21
 
22
- **Estrutura no disco:**
22
+ **Estrutura no disco:**
23
23
  ```
24
24
  .oxe/
25
25
  workstreams/
@@ -32,18 +32,18 @@ O pipeline OXE padrão (`.oxe/SPEC.md`, `PLAN.md`, etc.) é linear — uma entre
32
32
  config.json (herda do config principal; pode sobrescrever keys)
33
33
  ```
34
34
 
35
- **Compatibilidade:**
36
- - O pipeline principal (`.oxe/SPEC.md`, `.oxe/PLAN.md`, etc.) continua funcionando normalmente.
37
- - Workstreams **não** substituem o pipeline principal — são adicionais.
38
- - `oxe-cc doctor` e `oxe-cc status` reportam cada workstream separadamente quando `--workstream=<nome>` for passado.
39
- - A seção **Workstreams ativos** do STATE.md principal lista os workstreams em andamento.
40
- - Resolver `active_session` conforme `oxe/workflows/references/session-path-resolution.md`. Com sessão ativa, workstreams vivem em `.oxe/<active_session>/workstreams/`; sem sessão ativa, usam `.oxe/workstreams/`.
41
- </context>
35
+ **Compatibilidade:**
36
+ - O pipeline principal (`.oxe/SPEC.md`, `.oxe/PLAN.md`, etc.) continua funcionando normalmente.
37
+ - Workstreams **não** substituem o pipeline principal — são adicionais.
38
+ - `oxe-cc doctor` e `oxe-cc status` reportam cada workstream separadamente quando `--workstream=<nome>` for passado.
39
+ - A seção **Workstreams ativos** do STATE.md principal lista os workstreams em andamento.
40
+ - Resolver `active_session` conforme `oxe/workflows/references/session-path-resolution.md`. Com sessão ativa, workstreams vivem em `.oxe/<active_session>/workstreams/`; sem sessão ativa, usam `.oxe/workstreams/`.
41
+ </context>
42
42
 
43
43
  <process_list>
44
44
  **`/oxe-workstream list`**
45
45
 
46
- 1. Ler `workstreams/` do escopo resolvido — listar subpastas.
46
+ 1. Ler `workstreams/` do escopo resolvido — listar subpastas.
47
47
  2. Para cada workstream, ler seu `STATE.md` local (fase e próximo passo).
48
48
  3. Exibir tabela no chat: Nome | Fase | Próximo passo | Última atividade.
49
49
  </process_list>
@@ -52,8 +52,8 @@ O pipeline OXE padrão (`.oxe/SPEC.md`, `PLAN.md`, etc.) é linear — uma entre
52
52
  **`/oxe-workstream new <nome>`**
53
53
 
54
54
  1. Validar que `<nome>` é um slug seguro (letras, números, hífens — sem espaços ou caracteres especiais).
55
- 2. Criar `workstreams/<nome>/STATE.md` no escopo resolvido a partir de `oxe/templates/STATE.md`.
56
- 3. Criar `workstreams/<nome>/config.json` vazio (herda do config principal).
55
+ 2. Criar `workstreams/<nome>/STATE.md` no escopo resolvido a partir de `oxe/templates/STATE.md`.
56
+ 3. Criar `workstreams/<nome>/config.json` vazio (herda do config principal).
57
57
  4. Atualizar **STATE.md principal**: adicionar `<nome>` na seção **Workstreams ativos**.
58
58
  5. Confirmar no chat: `Workstream '<nome>' criado. Próximo passo: /oxe-spec (no contexto do workstream)`.
59
59
 
@@ -63,9 +63,9 @@ O pipeline OXE padrão (`.oxe/SPEC.md`, `PLAN.md`, etc.) é linear — uma entre
63
63
  <process_switch>
64
64
  **`/oxe-workstream switch <nome>`**
65
65
 
66
- 1. Verificar que `workstreams/<nome>/` do escopo resolvido existe.
66
+ 1. Verificar que `workstreams/<nome>/` do escopo resolvido existe.
67
67
  2. Atualizar STATE.md principal: seção **Workstream ativo** com nome.
68
- 3. Confirmar no chat: `Workstream ativo: <nome>. Artefatos em workstreams/<nome>/ do escopo atual`.
68
+ 3. Confirmar no chat: `Workstream ativo: <nome>. Artefatos em workstreams/<nome>/ do escopo atual`.
69
69
 
70
70
  Após ativar, os workflows `/oxe-spec`, `/oxe-plan`, `/oxe-execute`, `/oxe-verify` operam nos artefatos do workstream ativo em vez dos artefatos raiz.
71
71
  </process_switch>
@@ -74,7 +74,7 @@ Após ativar, os workflows `/oxe-spec`, `/oxe-plan`, `/oxe-execute`, `/oxe-verif
74
74
  **`/oxe-workstream status [nome]`**
75
75
 
76
76
  1. Se `nome` omitido: usar workstream ativo do STATE.md.
77
- 2. Ler `workstreams/<nome>/STATE.md` do escopo resolvido — fase e próximo passo.
77
+ 2. Ler `workstreams/<nome>/STATE.md` do escopo resolvido — fase e próximo passo.
78
78
  3. Ler SPEC, PLAN, VERIFY do workstream (se existirem).
79
79
  4. Exibir resumo: fase, critérios, gaps, próximo passo.
80
80
  </process_status>
@@ -84,7 +84,7 @@ Após ativar, os workflows `/oxe-spec`, `/oxe-plan`, `/oxe-execute`, `/oxe-verif
84
84
 
85
85
  1. Verificar que o workstream está com `verify_complete` no seu STATE.md local.
86
86
  2. Se não estiver: alertar e pedir confirmação com `--force`.
87
- 3. Mover (ou arquivar) `workstreams/<nome>/` do escopo resolvido → `workstreams/closed/<nome>-YYYY-MM-DD/`.
87
+ 3. Mover (ou arquivar) `workstreams/<nome>/` do escopo resolvido → `workstreams/closed/<nome>-YYYY-MM-DD/`.
88
88
  4. Atualizar STATE.md principal: remover `<nome>` de **Workstreams ativos**, registrar em **Workstreams encerrados**.
89
89
  5. Confirmar no chat: `Workstream '<nome>' encerrado. Artefatos em .oxe/workstreams/closed/`.
90
90
  </process_close>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "oxe-cc",
3
- "version": "1.5.0",
3
+ "version": "1.6.0",
4
4
  "description": "OXE — spec-driven workflows in .oxe/ with runtime enterprise, evidence-first verification and multi-runtime integrations (npx)",
5
5
  "license": "MIT",
6
6
  "author": "",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@oxe/runtime",
3
- "version": "1.5.0",
3
+ "version": "1.6.0",
4
4
  "private": true,
5
5
  "license": "MIT",
6
6
  "description": "OXE agentic execution engine — enterprise runtime core",
@@ -2,7 +2,7 @@
2
2
  "name": "oxe-agents",
3
3
  "displayName": "OXE Agents",
4
4
  "description": "Agentes OXE para GitHub Copilot Chat — cada fase do ciclo como um @agente no VS Code",
5
- "version": "1.5.0",
5
+ "version": "1.6.0",
6
6
  "publisher": "oxe-cc",
7
7
  "license": "MIT",
8
8
  "engines": {