oxe-cc 1.0.0 → 1.2.1

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 (207) hide show
  1. package/.cursor/commands/oxe-ask.md +1 -1
  2. package/.cursor/commands/oxe-capabilities.md +1 -1
  3. package/.cursor/commands/oxe-checkpoint.md +1 -1
  4. package/.cursor/commands/oxe-compact.md +1 -1
  5. package/.cursor/commands/oxe-dashboard.md +1 -1
  6. package/.cursor/commands/oxe-debug.md +1 -1
  7. package/.cursor/commands/oxe-discuss.md +1 -1
  8. package/.cursor/commands/oxe-execute.md +2 -2
  9. package/.cursor/commands/oxe-forensics.md +1 -1
  10. package/.cursor/commands/oxe-help.md +1 -1
  11. package/.cursor/commands/oxe-loop.md +1 -1
  12. package/.cursor/commands/oxe-milestone.md +1 -1
  13. package/.cursor/commands/oxe-next.md +1 -1
  14. package/.cursor/commands/oxe-obs.md +1 -1
  15. package/.cursor/commands/oxe-plan-agent.md +1 -1
  16. package/.cursor/commands/oxe-plan.md +1 -1
  17. package/.cursor/commands/oxe-project.md +1 -1
  18. package/.cursor/commands/oxe-quick.md +1 -1
  19. package/.cursor/commands/oxe-research.md +1 -1
  20. package/.cursor/commands/oxe-retro.md +1 -1
  21. package/.cursor/commands/oxe-review-pr.md +1 -1
  22. package/.cursor/commands/oxe-route.md +1 -1
  23. package/.cursor/commands/oxe-scan.md +1 -1
  24. package/.cursor/commands/oxe-security.md +1 -1
  25. package/.cursor/commands/oxe-session.md +2 -2
  26. package/.cursor/commands/oxe-ship.md +45 -0
  27. package/.cursor/commands/oxe-skill.md +1 -1
  28. package/.cursor/commands/oxe-spec.md +1 -1
  29. package/.cursor/commands/oxe-ui-review.md +1 -1
  30. package/.cursor/commands/oxe-ui-spec.md +1 -1
  31. package/.cursor/commands/oxe-update.md +1 -1
  32. package/.cursor/commands/oxe-validate-gaps.md +1 -1
  33. package/.cursor/commands/oxe-verify.md +1 -1
  34. package/.cursor/commands/oxe-workstream.md +1 -1
  35. package/.cursor/commands/oxe.md +4 -4
  36. package/.github/copilot-instructions.md +91 -1
  37. package/.github/prompts/oxe-ask.prompt.md +1 -1
  38. package/.github/prompts/oxe-capabilities.prompt.md +1 -1
  39. package/.github/prompts/oxe-checkpoint.prompt.md +1 -1
  40. package/.github/prompts/oxe-compact.prompt.md +1 -1
  41. package/.github/prompts/oxe-dashboard.prompt.md +1 -1
  42. package/.github/prompts/oxe-debug.prompt.md +1 -1
  43. package/.github/prompts/oxe-discuss.prompt.md +1 -1
  44. package/.github/prompts/oxe-execute.prompt.md +2 -2
  45. package/.github/prompts/oxe-forensics.prompt.md +1 -1
  46. package/.github/prompts/oxe-help.prompt.md +1 -1
  47. package/.github/prompts/oxe-loop.prompt.md +1 -1
  48. package/.github/prompts/oxe-milestone.prompt.md +1 -1
  49. package/.github/prompts/oxe-next.prompt.md +1 -1
  50. package/.github/prompts/oxe-obs.prompt.md +1 -1
  51. package/.github/prompts/oxe-plan-agent.prompt.md +1 -1
  52. package/.github/prompts/oxe-plan.prompt.md +1 -1
  53. package/.github/prompts/oxe-project.prompt.md +1 -1
  54. package/.github/prompts/oxe-quick.prompt.md +1 -1
  55. package/.github/prompts/oxe-research.prompt.md +1 -1
  56. package/.github/prompts/oxe-retro.prompt.md +1 -1
  57. package/.github/prompts/oxe-review-pr.prompt.md +1 -1
  58. package/.github/prompts/oxe-route.prompt.md +1 -1
  59. package/.github/prompts/oxe-scan.prompt.md +1 -1
  60. package/.github/prompts/oxe-security.prompt.md +1 -1
  61. package/.github/prompts/oxe-session.prompt.md +2 -2
  62. package/.github/prompts/oxe-ship.prompt.md +45 -0
  63. package/.github/prompts/oxe-skill.prompt.md +1 -1
  64. package/.github/prompts/oxe-spec.prompt.md +1 -1
  65. package/.github/prompts/oxe-ui-review.prompt.md +1 -1
  66. package/.github/prompts/oxe-ui-spec.prompt.md +1 -1
  67. package/.github/prompts/oxe-update.prompt.md +1 -1
  68. package/.github/prompts/oxe-validate-gaps.prompt.md +1 -1
  69. package/.github/prompts/oxe-verify.prompt.md +1 -1
  70. package/.github/prompts/oxe-workstream.prompt.md +1 -1
  71. package/.github/prompts/oxe.prompt.md +3 -3
  72. package/AGENTS.md +43 -28
  73. package/CHANGELOG.md +158 -0
  74. package/README.md +72 -50
  75. package/bin/banner.txt +1 -1
  76. package/bin/lib/oxe-project-health.cjs +1 -1
  77. package/commands/oxe/ask.md +5 -1
  78. package/commands/oxe/checkpoint.md +1 -1
  79. package/commands/oxe/compact.md +1 -1
  80. package/commands/oxe/debug.md +1 -1
  81. package/commands/oxe/execute.md +2 -2
  82. package/commands/oxe/forensics.md +1 -1
  83. package/commands/oxe/loop.md +1 -1
  84. package/commands/oxe/milestone.md +1 -1
  85. package/commands/oxe/next.md +1 -1
  86. package/commands/oxe/obs.md +1 -1
  87. package/commands/oxe/oxe.md +3 -3
  88. package/commands/oxe/project.md +1 -1
  89. package/commands/oxe/research.md +1 -1
  90. package/commands/oxe/retro.md +1 -1
  91. package/commands/oxe/review-pr.md +1 -1
  92. package/commands/oxe/route.md +1 -1
  93. package/commands/oxe/scan.md +1 -1
  94. package/commands/oxe/security.md +1 -1
  95. package/commands/oxe/session.md +2 -2
  96. package/commands/oxe/ship.md +49 -0
  97. package/commands/oxe/spec.md +2 -2
  98. package/commands/oxe/ui-review.md +1 -1
  99. package/commands/oxe/ui-spec.md +1 -1
  100. package/commands/oxe/validate-gaps.md +1 -1
  101. package/commands/oxe/verify.md +2 -2
  102. package/commands/oxe/workstream.md +1 -1
  103. package/lib/runtime/audit/audit-trail.d.ts +71 -0
  104. package/lib/runtime/audit/audit-trail.js +154 -0
  105. package/lib/runtime/audit/index.d.ts +2 -0
  106. package/lib/runtime/audit/index.js +18 -0
  107. package/lib/runtime/audit/policy-pack.d.ts +15 -0
  108. package/lib/runtime/audit/policy-pack.js +57 -0
  109. package/lib/runtime/context/context-pack-builder.d.ts +15 -0
  110. package/lib/runtime/context/context-pack-builder.js +42 -0
  111. package/lib/runtime/context/context-pack-store.d.ts +38 -0
  112. package/lib/runtime/context/context-pack-store.js +142 -0
  113. package/lib/runtime/context/context-profiles.d.ts +11 -0
  114. package/lib/runtime/context/context-profiles.js +51 -0
  115. package/lib/runtime/context/index.d.ts +2 -0
  116. package/lib/runtime/context/index.js +2 -0
  117. package/lib/runtime/decision/decision-engine.d.ts +43 -0
  118. package/lib/runtime/decision/decision-engine.js +127 -0
  119. package/lib/runtime/decision/decision-memo.d.ts +53 -0
  120. package/lib/runtime/decision/decision-memo.js +173 -0
  121. package/lib/runtime/decision/index.d.ts +2 -0
  122. package/lib/runtime/decision/index.js +18 -0
  123. package/lib/runtime/delivery/index.d.ts +1 -0
  124. package/lib/runtime/delivery/index.js +1 -0
  125. package/lib/runtime/delivery/promotion-pipeline.d.ts +39 -0
  126. package/lib/runtime/delivery/promotion-pipeline.js +127 -0
  127. package/lib/runtime/index.d.ts +3 -0
  128. package/lib/runtime/index.js +4 -0
  129. package/lib/runtime/plugins/capability-matrix.d.ts +20 -0
  130. package/lib/runtime/plugins/capability-matrix.js +59 -0
  131. package/lib/runtime/plugins/index.d.ts +2 -0
  132. package/lib/runtime/plugins/index.js +2 -0
  133. package/lib/runtime/plugins/plugin-manifest.d.ts +22 -0
  134. package/lib/runtime/plugins/plugin-manifest.js +91 -0
  135. package/lib/runtime/plugins/plugin-registry.js +5 -0
  136. package/lib/runtime/policy/policy-engine.d.ts +28 -1
  137. package/lib/runtime/policy/policy-engine.js +96 -5
  138. package/lib/runtime/reducers/run-state-reducer.d.ts +26 -0
  139. package/lib/runtime/reducers/run-state-reducer.js +117 -1
  140. package/lib/runtime/scheduler/agent-registry.d.ts +44 -0
  141. package/lib/runtime/scheduler/agent-registry.js +96 -0
  142. package/lib/runtime/scheduler/agent-roles.d.ts +54 -0
  143. package/lib/runtime/scheduler/agent-roles.js +62 -0
  144. package/lib/runtime/scheduler/index.d.ts +3 -0
  145. package/lib/runtime/scheduler/index.js +3 -0
  146. package/lib/runtime/scheduler/multi-agent-coordinator.d.ts +2 -0
  147. package/lib/runtime/scheduler/multi-agent-coordinator.js +91 -4
  148. package/lib/runtime/scheduler/run-journal.d.ts +18 -0
  149. package/lib/runtime/scheduler/run-journal.js +54 -0
  150. package/lib/runtime/scheduler/scheduler.d.ts +11 -1
  151. package/lib/runtime/scheduler/scheduler.js +135 -7
  152. package/lib/runtime/verification/index.d.ts +1 -0
  153. package/lib/runtime/verification/index.js +1 -0
  154. package/lib/runtime/verification/verification-manifest.d.ts +58 -0
  155. package/lib/runtime/verification/verification-manifest.js +129 -0
  156. package/oxe/workflows/ask.md +4 -0
  157. package/oxe/workflows/checkpoint.md +14 -10
  158. package/oxe/workflows/debug.md +19 -15
  159. package/oxe/workflows/execute.md +30 -2
  160. package/oxe/workflows/forensics.md +13 -9
  161. package/oxe/workflows/help.md +97 -49
  162. package/oxe/workflows/loop.md +17 -13
  163. package/oxe/workflows/obs.md +4 -0
  164. package/oxe/workflows/oxe.md +64 -31
  165. package/oxe/workflows/project.md +6 -1
  166. package/oxe/workflows/references/workflow-runtime-contracts.json +23 -0
  167. package/oxe/workflows/research.md +32 -28
  168. package/oxe/workflows/retro.md +4 -0
  169. package/oxe/workflows/review-pr.md +15 -11
  170. package/oxe/workflows/scan.md +4 -0
  171. package/oxe/workflows/security.md +14 -10
  172. package/oxe/workflows/session.md +17 -1
  173. package/oxe/workflows/ship.md +142 -0
  174. package/oxe/workflows/spec.md +15 -0
  175. package/oxe/workflows/ui-review.md +20 -16
  176. package/oxe/workflows/ui-spec.md +7 -3
  177. package/oxe/workflows/validate-gaps.md +13 -9
  178. package/oxe/workflows/verify.md +42 -3
  179. package/package.json +1 -1
  180. package/packages/runtime/src/audit/audit-trail.ts +243 -0
  181. package/packages/runtime/src/audit/index.ts +2 -0
  182. package/packages/runtime/src/audit/policy-pack.ts +62 -0
  183. package/packages/runtime/src/context/context-pack-builder.ts +66 -0
  184. package/packages/runtime/src/context/context-pack-store.ts +197 -0
  185. package/packages/runtime/src/context/context-profiles.ts +60 -0
  186. package/packages/runtime/src/context/index.ts +2 -0
  187. package/packages/runtime/src/decision/decision-engine.ts +174 -0
  188. package/packages/runtime/src/decision/decision-memo.ts +211 -0
  189. package/packages/runtime/src/decision/index.ts +2 -0
  190. package/packages/runtime/src/delivery/index.ts +1 -0
  191. package/packages/runtime/src/delivery/promotion-pipeline.ts +180 -0
  192. package/packages/runtime/src/index.ts +5 -0
  193. package/packages/runtime/src/plugins/capability-matrix.ts +83 -0
  194. package/packages/runtime/src/plugins/index.ts +2 -0
  195. package/packages/runtime/src/plugins/plugin-manifest.ts +113 -0
  196. package/packages/runtime/src/plugins/plugin-registry.ts +5 -0
  197. package/packages/runtime/src/policy/policy-engine.ts +138 -7
  198. package/packages/runtime/src/reducers/run-state-reducer.ts +143 -1
  199. package/packages/runtime/src/scheduler/agent-registry.ts +132 -0
  200. package/packages/runtime/src/scheduler/agent-roles.ts +109 -0
  201. package/packages/runtime/src/scheduler/index.ts +3 -0
  202. package/packages/runtime/src/scheduler/multi-agent-coordinator.ts +106 -4
  203. package/packages/runtime/src/scheduler/run-journal.ts +62 -0
  204. package/packages/runtime/src/scheduler/scheduler.ts +168 -8
  205. package/packages/runtime/src/verification/index.ts +1 -0
  206. package/packages/runtime/src/verification/verification-manifest.ts +192 -0
  207. package/vscode-extension/oxe-agents-1.0.0.vsix +0 -0
@@ -40,6 +40,6 @@ oxe_semantics_hash: db8d30e9106386d1
40
40
 
41
41
  Executa o workflow **OXE plan**. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/plan.md` (na raiz do repositório em contexto)
43
+ `.oxe/workflows/plan.md` (na raiz do repositório em contexto)
44
44
 
45
45
  Se o utilizador pedir replanejamento, trata como `--replan` conforme o workflow.
@@ -40,6 +40,6 @@ oxe_semantics_hash: 88b279f22bfd77ae
40
40
 
41
41
  Executa o workflow **OXE project** no repositório atual. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/project.md`
43
+ `.oxe/workflows/project.md`
44
44
 
45
45
  `$ARGUMENTS` = subcomando: `milestone new|complete|status|audit`, `workstream new|switch|list|close <nome>`, `checkpoint [slug]`, ou vazio para status atual.
@@ -40,6 +40,6 @@ oxe_semantics_hash: e3eac1b1bc15a71b
40
40
 
41
41
  Executa o workflow **OXE quick** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
42
42
 
43
- `oxe/workflows/quick.md`
43
+ `.oxe/workflows/quick.md`
44
44
 
45
45
  Usa o texto adicional desta mensagem como objetivo e contexto.
@@ -40,6 +40,6 @@ oxe_semantics_hash: b697e0409d229d47
40
40
 
41
41
  Executa o workflow **OXE research** no repositório atual. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/research.md`
43
+ `.oxe/workflows/research.md`
44
44
 
45
45
  Usa o texto adicional desta mensagem como âmbito (paths, perguntas, spike, mapa de sistema, engenharia reversa ou modernização).
@@ -40,6 +40,6 @@ oxe_semantics_hash: 8f2925a220ed9bc2
40
40
 
41
41
  Executa o workflow **OXE retro** no repositório atual. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/retro.md`
43
+ `.oxe/workflows/retro.md`
44
44
 
45
45
  Lê VERIFY.md, FORENSICS.md, SUMMARY.md. `$ARGUMENTS` = contexto extra opcional.
@@ -40,6 +40,6 @@ oxe_semantics_hash: 1e12e0a92c7d0079
40
40
 
41
41
  Executa o workflow **OXE review-pr**. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/review-pr.md` (na raiz do repositório em contexto)
43
+ `.oxe/workflows/review-pr.md` (na raiz do repositório em contexto)
44
44
 
45
45
  **Exemplos de entrada:** cola o URL da PR (`https://github.com/org/repo/pull/10`, com ou sem `/files`); ou `org/repo#10`; ou **base** e **head** (branches/tags/SHAs). Sem refs, o agente infere (ex.: `main` vs branch atual).
@@ -40,6 +40,6 @@ oxe_semantics_hash: 9d140800451c0ea9
40
40
 
41
41
  Executa o workflow **OXE route** no repositório atual. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/route.md`
43
+ `.oxe/workflows/route.md`
44
44
 
45
45
  Usa o texto adicional desta mensagem como intenção a classificar (tabela Router em `help.md`).
@@ -40,6 +40,6 @@ oxe_semantics_hash: 899fe6bc3684fc6e
40
40
 
41
41
  Executa o workflow **OXE scan** no repositório atual. Lê e aplica **integralmente** o ficheiro:
42
42
 
43
- `oxe/workflows/scan.md` (na raiz do repositório em contexto)
43
+ `.oxe/workflows/scan.md` (na raiz do repositório em contexto)
44
44
 
45
45
  Usa o texto adicional desta mensagem como foco opcional de área (pastas/módulos).
@@ -40,6 +40,6 @@ oxe_semantics_hash: 27ebaddfc7191f76
40
40
 
41
41
  Executa o workflow **OXE security** no repositório atual. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/security.md`
43
+ `.oxe/workflows/security.md`
44
44
 
45
45
  Lê `.oxe/codebase/STACK.md` para determinar categorias OWASP aplicáveis. `$ARGUMENTS` = foco opcional.
@@ -40,6 +40,6 @@ oxe_semantics_hash: 4a7e893fe47767a3
40
40
 
41
41
  Executa o workflow **OXE session** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
42
42
 
43
- `oxe/workflows/session.md`
43
+ `.oxe/workflows/session.md`
44
44
 
45
- Usa o texto adicional desta mensagem como foco do subcomando: `new <nome>`, `list`, `switch <id>`, `resume <id>`, `status`, `close` ou `migrate <nome>`. Lê `oxe/workflows/session.md` na raiz do projeto atual (CWD).
45
+ Usa o texto adicional desta mensagem como foco do subcomando: `new <nome>`, `list`, `switch <id>`, `resume <id>`, `status`, `close` ou `migrate <nome>`. Lê `.oxe/workflows/session.md` na raiz do projeto atual (CWD).
@@ -0,0 +1,45 @@
1
+ ---
2
+ name: oxe-ship
3
+ agent: agent
4
+ description: OXE — Entregar: cria commit local com mensagem gerada de SPEC+PLAN+VERIFY. Flags: --message, --amend, --verify-first, --dry-run
5
+ argument-hint: "[--message 'mensagem'] [--amend] [--verify-first] [--no-checks] [--dry-run]"
6
+ oxe_workflow_slug: ship
7
+ oxe_reasoning_mode: execution
8
+ oxe_question_policy: ask_high_impact_only
9
+ oxe_output_contract: execution
10
+ oxe_tool_profile: write_bounded
11
+ oxe_confidence_policy: explicit
12
+ oxe_context_tier: standard
13
+ oxe_contract_version: 2.0.0
14
+ oxe_semantics_hash: 3893740934e4f82b
15
+ ---
16
+
17
+ <!-- oxe-reasoning-contract:start -->
18
+
19
+ **Contrato de raciocínio OXE deste comando**
20
+ - **Workflow:** ship
21
+ - **Modo:** execução
22
+ - **Perguntas:** perguntar só alto impacto
23
+ - **Saída esperada:** execução
24
+ - **Perfil de ferramentas:** mutação limitada
25
+ - **Política de confiança:** explícita
26
+ - **Tier de contexto padrão:** padrão
27
+ - **Versão do contrato:** 2.0.0
28
+ - **Checksum semântico:** `3893740934e4f82b`
29
+ - **Entrada de contexto prioritária:** `.oxe/context/packs/ship.md` e `.oxe/context/packs/ship.json`
30
+ - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
+ - **Inspeção estruturada:** `oxe-cc context inspect --workflow ship --json`
32
+ - Fazer reconhecimento curto antes de editar ou executar mutações.
33
+ - Trabalhar no menor write set viável e validar após cada fatia relevante.
34
+ - Parar e explicitar o bloqueio quando houver hipótese crítica não verificada.
35
+ - **Seções esperadas:** Contexto lido · Alvo da mudança · Validação executada · Resultado · Próximo passo
36
+ - **Bloqueios formais:** missing:verify_without_override · missing:tracked_changes
37
+ - **Referência canónica:** `oxe/workflows/references/reasoning-execution.md`
38
+
39
+ <!-- oxe-reasoning-contract:end -->
40
+
41
+ Executa o workflow **OXE ship**. Lê e aplica **integralmente**:
42
+
43
+ `.oxe/workflows/ship.md` (na raiz do repositório em contexto)
44
+
45
+ Usa `$ARGUMENTS` como flags de entrega (`--message`, `--amend`, `--verify-first`, `--no-checks`, `--dry-run`).
@@ -40,6 +40,6 @@ oxe_semantics_hash: 64cec6f03fc7cfe6
40
40
 
41
41
  Executa o workflow **OXE skill** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
42
42
 
43
- `oxe/workflows/skill.md`
43
+ `.oxe/workflows/skill.md`
44
44
 
45
45
  Usa o texto adicional desta mensagem como subcomando ou invocação de skill.
@@ -40,6 +40,6 @@ oxe_semantics_hash: 598fcdce72e894c8
40
40
 
41
41
  Executa o workflow **OXE spec**. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/spec.md` (na raiz do repositório em contexto)
43
+ `.oxe/workflows/spec.md` (na raiz do repositório em contexto)
44
44
 
45
45
  Usa o resto desta mensagem e ficheiros anexados como entrada do utilizador.
@@ -40,6 +40,6 @@ oxe_semantics_hash: 94c1695de8d9ec7d
40
40
 
41
41
  Executa o workflow **OXE ui-review** no repositório atual. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/ui-review.md`
43
+ `.oxe/workflows/ui-review.md`
44
44
 
45
45
  Usa o texto adicional desta mensagem como ficheiros ou tarefas a rever.
@@ -40,6 +40,6 @@ oxe_semantics_hash: 76ba6d1e0e2f02e6
40
40
 
41
41
  Executa o workflow **OXE ui-spec** no repositório atual. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/ui-spec.md`
43
+ `.oxe/workflows/ui-spec.md`
44
44
 
45
45
  Usa o texto adicional desta mensagem como foco de ecrãs ou componentes, se houver.
@@ -39,6 +39,6 @@ oxe_semantics_hash: 49332cbd409f2ac6
39
39
 
40
40
  Executa o workflow **OXE update**. Lê e segue **integralmente**:
41
41
 
42
- `oxe/workflows/update.md` (na raiz do repositório em contexto; ou `.oxe/workflows/update.md` se a instalação aninhou os workflows)
42
+ `.oxe/workflows/update.md` (na raiz do repositório em contexto; ou `..oxe/workflows/update.md` se a instalação aninhou os workflows)
43
43
 
44
44
  Na prática: na raiz do projeto, correr **`npx oxe-cc update --check`**, depois (se aplicável) **`npx oxe-cc update`** ou **`npx oxe-cc update --if-newer`**, e por fim **`npx oxe-cc doctor`**.
@@ -40,6 +40,6 @@ oxe_semantics_hash: 27d51ac144da4c1c
40
40
 
41
41
  Executa o workflow **OXE validate-gaps** no repositório atual. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/validate-gaps.md`
43
+ `.oxe/workflows/validate-gaps.md`
44
44
 
45
45
  Requer `VERIFY.md` e `PLAN.md` já existentes. Texto adicional: foco opcional em tarefa **Tn** ou critério **A***.
@@ -40,6 +40,6 @@ oxe_semantics_hash: 442bb4594208d058
40
40
 
41
41
  Executa o workflow **OXE verify**. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/verify.md` (na raiz do repositório em contexto)
43
+ `.oxe/workflows/verify.md` (na raiz do repositório em contexto)
44
44
 
45
45
  Se o utilizador indicar uma tarefa `Tn`, restringe a verificação a essa tarefa.
@@ -40,6 +40,6 @@ oxe_semantics_hash: 82d171363381cc0d
40
40
 
41
41
  Executa o workflow **OXE workstream** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
42
42
 
43
- `oxe/workflows/workstream.md`
43
+ `.oxe/workflows/workstream.md`
44
44
 
45
45
  Usa o texto adicional desta mensagem como subcomando e contexto.
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: oxe
3
3
  agent: agent
4
- description: OXE — Entrada universal: próximo passo / roteamento / help dos 8 comandos essenciais
4
+ description: OXE — Entrada universal: próximo passo / roteamento / help da trilha OXE
5
5
  argument-hint: "[contexto em linguagem natural | 'help' | vazio para próximo passo]"
6
6
  oxe_workflow_slug: oxe
7
7
  oxe_reasoning_mode: status
@@ -40,6 +40,6 @@ oxe_semantics_hash: d7f65cd3f77b0abc
40
40
 
41
41
  Executa o workflow **OXE** (entrada universal) no repositório atual. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/oxe.md`
43
+ `.oxe/workflows/oxe.md`
44
44
 
45
- `$ARGUMENTS`: vazio → próximo passo; texto → roteamento; "help" → 8 comandos essenciais.
45
+ `$ARGUMENTS`: vazio → próximo passo; texto → roteamento; "help" → trilha principal + trilha avançada.
package/AGENTS.md CHANGED
@@ -9,38 +9,53 @@ Este repositório empacota o fluxo **OXE** (spec-driven, artefatos em `.oxe/`).
9
9
 
10
10
  ---
11
11
 
12
- ## Os 8 comandos essenciais
12
+ ## Trilha principal (6 comandos)
13
13
 
14
14
  ```
15
- /oxe → onde estou / o que faço / help
16
- /oxe-obs → registrei algo importante (incorporado automaticamente)
15
+ /oxe → onde estou / o que faço / help / perguntas situacionais
17
16
  /oxe-quick → tarefa pequena, sem cerimônia
18
- /oxe-scan → mapeia o projeto (ou atualiza se já mapeado)
19
17
  /oxe-spec → nova feature: perguntas → requisitos → roteiro
18
+ flags: --refresh, --full, --research, --deep, --ui
20
19
  /oxe-plan → tarefas por onda (--agents para multi-agente)
21
20
  /oxe-execute → implementar (A: 1 sessão | B: por onda | C: por tarefa)
22
- /oxe-verify → validar (camadas 5+6 opcionais via config)
21
+ flags: --note, --debug, --deep-diagnosis, --checkpoint, --iterative
22
+ /oxe-verify → validar e fechar o ciclo (retro automática)
23
+ flags: --gaps, --security, --ui, --pr, --diff, --skip-retro
23
24
  ```
24
25
 
25
- ## Escape hatches (aparecem quando necessários)
26
+ ## Trilha avançada
26
27
 
27
28
  ```
28
- /oxe-retro retrospectiva: 3–5 lições .oxe/LESSONS.md
29
- /oxe-forensicsdiagnóstico de falha persistente ou estado corrompido
30
- /oxe-debug → diagnóstico técnico inline (integrado ao execute)
31
- /oxe-loop → retry iterativo de onda até verify passar
32
- /oxe-security → auditoria OWASP Top 10 filtrada pelo stack
33
- /oxe-research → spike, mapa de sistema, engenharia reversa
34
- /oxe-validate-gaps → auditoria de cobertura de testes
35
- /oxe-discuss decisões D-NN antes do plano (discuss_before_plan: true)
36
- /oxe-routetraduz linguagem natural → comando OXE
37
- /oxe-compactrefresh do mapa de codebase
38
- /oxe-checkpoint → snapshot nomeado de sessão
39
- /oxe-ui-spec → contrato UI/UX derivado da SPEC
40
- /oxe-ui-review → auditoria de implementação UI
41
- /oxe-review-pr → revisão de PR/diff
42
- /oxe-project → milestone + workstream + checkpoint em um comando
43
- /oxe-update atualiza workflows para a versão mais recente
29
+ /oxe-session criar, alternar, retomar, fechar ou migrar sessões OXE
30
+ /oxe-dashboardvisão web para revisão de equipe e aprovação do plano
31
+ ```
32
+
33
+ ## Administrativa / plataforma
34
+
35
+ ```
36
+ /oxe-capabilities catálogo nativo de capabilities
37
+ /oxe-skillskills OXE via @<id>
38
+ oxe-cc azureprovider Azure local-first
39
+ ```
40
+
41
+ ## Comandos legados (v1.1.0 — funcionam com aviso de migração)
42
+
43
+ ```
44
+ /oxe-ask incorporado por /oxe "pergunta"
45
+ /oxe-scan → incorporado por /oxe-spec --refresh / --full
46
+ /oxe-research → incorporado por /oxe-spec --research
47
+ /oxe-ui-spec → incorporado por /oxe-spec --ui
48
+ /oxe-obs → incorporado por /oxe-execute --note
49
+ /oxe-debug → incorporado por /oxe-execute --debug
50
+ /oxe-forensics → incorporado por /oxe-execute --deep-diagnosis
51
+ /oxe-checkpoint → incorporado por /oxe-execute --checkpoint
52
+ /oxe-loop → incorporado por /oxe-execute --iterative
53
+ /oxe-validate-gaps → incorporado por /oxe-verify --gaps
54
+ /oxe-security → incorporado por /oxe-verify --security
55
+ /oxe-ui-review → incorporado por /oxe-verify --ui
56
+ /oxe-review-pr → incorporado por /oxe-verify --pr
57
+ /oxe-retro → incorporado por /oxe-verify (retro automática)
58
+ /oxe-project → incorporado por /oxe-session milestone|workstream
44
59
  ```
45
60
 
46
61
  ## Profiles de execução (`profile` em `.oxe/config.json`)
@@ -72,12 +87,12 @@ Blueprints em `.oxe/plan-agents.json` (schema 3). Protocolo inter-agente: `oxe/w
72
87
  ## Integrações IDE
73
88
 
74
89
  - **Cursor:** slash commands em `~/.cursor/commands/` (gerados por `npm run sync:cursor`)
75
- - **GitHub Copilot (VS Code):** prompt files em `.github/prompts/` + `.github/copilot-instructions.md`
90
+ - **GitHub Copilot (VS Code):** prompt files em `.github/prompts/` + `.github/copilot-instructions.md`
76
91
  - **Claude Code:** commands em `~/.claude/commands/`
77
92
  - **OpenCode / Gemini / Codex / Windsurf / Antigravity:** via `oxe-cc --all-agents`
78
93
 
79
- ## Instruções para agentes de IA
80
-
81
- Quando o utilizador pedir uma etapa OXE por linguagem natural, seguir o ficheiro `oxe/workflows/<passo>.md` correspondente **sem atalhar passos**. Ler os artefatos em `.oxe/` antes de qualquer ação — nunca partir de suposições sobre o estado do projeto.
82
-
83
- Os wrappers por runtime podem carregar metadata cognitiva (`oxe_reasoning_mode`, `oxe_question_policy`, `oxe_output_contract`, `oxe_tool_profile`, `oxe_confidence_policy`), mas o comportamento canónico continua no workflow. Use essa metadata para adaptar a postura do agente sem bifurcar a lógica do OXE por ferramenta.
94
+ ## Instruções para agentes de IA
95
+
96
+ Quando o utilizador pedir uma etapa OXE por linguagem natural, seguir o ficheiro `oxe/workflows/<passo>.md` correspondente **sem atalhar passos**. Ler os artefatos em `.oxe/` antes de qualquer ação — nunca partir de suposições sobre o estado do projeto.
97
+
98
+ Os wrappers por runtime podem carregar metadata cognitiva (`oxe_reasoning_mode`, `oxe_question_policy`, `oxe_output_contract`, `oxe_tool_profile`, `oxe_confidence_policy`), mas o comportamento canónico continua no workflow. Use essa metadata para adaptar a postura do agente sem bifurcar a lógica do OXE por ferramenta.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,164 @@
2
2
 
3
3
  Todas as versões seguem [Semantic Versioning](https://semver.org/). As mudanças mais recentes aparecem primeiro.
4
4
 
5
+ ---
6
+
7
+ ## [1.2.1] — 2026-04-18
8
+
9
+ ### Branding, Semântica e Empacotamento
10
+
11
+ - remove referências remanescentes ao framework legado dos workflows e do diagnóstico de integração Copilot
12
+ - alinha `package.json`, `package-lock.json`, banner CLI e README para `1.2.1`
13
+ - corrige deriva semântica do workflow `ship`, registrando-o no contrato canônico multi-runtime
14
+ - adiciona prompt files de `ship` para Copilot/Cursor
15
+ - remove o comando `auto` da superfície pública do OXE
16
+ - remove o comando `intel` da superfície pública do OXE
17
+ - reposiciona `ship` para fechar o ciclo com commit local guiado por `SPEC.md`, `PLAN.md` e `VERIFY.md`
18
+
19
+ ---
20
+
21
+ ## [1.2.0] — 2026-04-18
22
+
23
+ ### Runtime Hardening & Robustez (Fases 1–9)
24
+
25
+ **Fase 1 — Runtime Hardening**
26
+
27
+ - `RunJournal` persistido em `.oxe/runs/{runId}/journal.json`: gravado a cada onda, atualizado no pause/cancel
28
+ - `Scheduler.pause()` agora grava journal e retorna `status: 'paused'` em vez de apenas setar flag in-memory
29
+ - `Scheduler.recover(runId, ctx, graph)` — retoma run pausado pelo journal; pula nós já completados
30
+ - `Scheduler.getJournal()` e `Scheduler.loadJournal(projectRoot, runId)` para inspeção
31
+ - `RunState` expandido: `retryCounts`, `policyDecisions`, `pendingGates`, `resolvedGates`, `verificationStatus`, `evidenceRefs`, `toolFailures`
32
+ - Reducer: handlers para `RetryScheduled`, `PolicyEvaluated`, `GateRequested`, `GateResolved`, `VerificationStarted`, `VerificationCompleted`, `ToolFailed`, `EvidenceCollected`
33
+ - Helpers: `getRetryCount`, `getPolicyDecision`, `getVerificationStatus`, `getEvidenceRefs`, `getToolFailures`
34
+
35
+ **Fase 2 — Policy, Side Effects e Security**
36
+
37
+ - `SideEffectClass` enum: `read_fs|write_fs|spawn_process|network_call|git_mutation|db_change|secret_access|infra_operation`
38
+ - `AutonomyTier` type: `L0|L1|L2|L3` — tier controla quais side effects são permitidos automaticamente
39
+ - `NodePolicyConfig` com `mutation_budget` e `autonomy_tier`
40
+ - `EnvironmentGuardrail` com `protected_paths`, `protected_branches`, `require_human_gate_on`
41
+ - Guardrails default: paths `.env`, `package.json`, `.oxe/config.json`; gate automático para `infra_operation`, `db_change`, `secret_access`
42
+ - `PolicyEngine.withGuardrail(g)` para customizar guardrails por projeto
43
+ - `side_effect_class` e `autonomy_tier` em `PolicyWhenClause` para regras direcionadas
44
+
45
+ **Fase 3 — Verify Operational**
46
+
47
+ - `VerificationManifest` formal: persistido em `.oxe/runs/{runId}/verification-manifest.json`
48
+ - `VerificationProfile`: `quick|standard|critical` — controla quais `FailureClass` geram riscos residuais
49
+ - `FailureClass` taxonomy: `deterministic|flaky|timeout|env_setup|policy_failure|evidence_missing`
50
+ - `classifyFailure(result)` — classifica automaticamente cada `CheckResult`
51
+ - `buildManifest(runId, results, options)` — compila manifest por work item, onda ou run
52
+ - `ResidualRiskLedger` persistido em `.oxe/runs/{runId}/residual-risks.json`
53
+ - `buildRiskLedger(runId, manifest)` — gera ledger de riscos residuais a partir do manifest
54
+
55
+ **Fase 4 — Delivery Native**
56
+
57
+ - `MergeGateEvaluator.evaluate(runResult, manifest, ledger)` — avalia se run está pronto para merge
58
+ - Bloqueios: tarefas failed/blocked, verificação falha, riscos `high`/`critical`
59
+ - `PromotionPipeline.promote(runResult, manifest, ledger, opts)` — cria PR draft via `gh`, persiste `RunPRLink`
60
+ - `PromotionPipeline.buildPRBody(...)` — corpo do PR com resumo, verificação e riscos residuais
61
+ - `RunPRLink` persistido em `.oxe/runs/{runId}/pr-link.json`
62
+
63
+ **Fase 5 — Context Engineering Avançado**
64
+
65
+ - `ContextPackStore`: `savePack`, `loadPack`, `markStale`, `isStale`, `listPackMeta` — packs persistidos em `.oxe/runs/{runId}/context-pack-{workItemId}.json`
66
+ - `ContextPackMeta` com `estimated_tokens`, `stale`, `stale_reason`
67
+ - `diffPacks(before, after)` — detecta added/removed/score_changed entre versões de pack
68
+ - Índice global por run em `context-packs.index.json`
69
+
70
+ **Fase 6 — Decision Engine / Seniority**
71
+
72
+ - `DecisionEngine.evaluate(input)` — avalia policy, gate, retry budget, risk, lesson match e retorna `DecisionRecord` com `type`, `seniority`, `confidence` e `rationale`
73
+ - Tipos de decisão: `proceed|retry|escalate_gate|skip|abort|promote_lesson`
74
+ - `SeniorityLevel`: `junior|standard|senior|expert` derivado da confidence
75
+ - `appendDecision`, `loadDecisionLog`, `queryDecisions` — log persistido em `.oxe/runs/{runId}/decisions.json`
76
+
77
+ **Fase 7 — Multi-Agent Robusto**
78
+
79
+ - `AgentRegistry` com heartbeat tracking por agente
80
+ - `registry.beat(id, currentTask)` — atualiza last_seen e status
81
+ - `registry.isAlive(id)` — detecta timeout configurável por instância
82
+ - `registry.timedOut()` / `registry.liveAgents()` — filtragem por liveness
83
+ - `registry.failover(fallbackAgentId)` — reassigna tasks de agentes expirados para fallback
84
+ - `registry.setStatus(id, status)` — transições manuais de estado
85
+
86
+ **Fase 8 — ABI Estável de Plugins**
87
+
88
+ - `PluginManifest` com `abi_version`, `capabilities`, declared providers
89
+ - `extractManifest(plugin)` — extrai manifest de qualquer `OxePlugin`
90
+ - `validatePlugin(plugin)` — retorna `{ valid, errors, warnings }` com checagem de nome, semver, providers
91
+ - `isAbiCompatible(version)` — garante compatibilidade de major version
92
+ - `sandboxInvoke(fn, timeoutMs)` — execução com timeout e isolamento de erro para plugins
93
+
94
+ **Fase 9 — Enterprise Operations**
95
+
96
+ - `AuditTrail` — registro imutável NDJSON em `.oxe/AUDIT-TRAIL.ndjson`
97
+ - 14 tipos de ação auditáveis: `run_started`, `secret_accessed`, `infra_mutation`, `merge_approved`, etc.
98
+ - Severity automática por ação (`info|warn|critical`)
99
+ - `AuditTrail.query(filter)` — filtra por action/severity/runId/since
100
+ - `RunQuota` — `createQuota`, `consumeQuota`, `checkQuota` para limitar work_items, mutations e retries por run
101
+
102
+ ### Testes
103
+
104
+ - Runtime: **266 testes** (↑ de 145 pré-robustez)
105
+ - Root: 321 testes (sem regressões)
106
+ - Total: **587 testes** passando
107
+
108
+ ---
109
+
110
+ ## [1.1.0] — 2026-04-18
111
+
112
+ ### Mudança de superfície (simplificação estratégica de produto)
113
+
114
+ **Trilha principal reduzida a 6 comandos**
115
+
116
+ O OXE agora se comporta como um framework guiado por etapas. A superfície pública foi reorganizada em três níveis:
117
+
118
+ **Trilha principal (6 comandos):**
119
+ - `/oxe` — entrada universal (absorve ask, next, route, help)
120
+ - `/oxe-quick` — modo nano sem cerimônia
121
+ - `/oxe-spec` — spec com flags: `--refresh`, `--full`, `--research`, `--ui`
122
+ - `/oxe-plan` — planejamento test-first
123
+ - `/oxe-execute` — implementação com flags: `--note`, `--debug`, `--deep-diagnosis`, `--checkpoint`, `--iterative`
124
+ - `/oxe-verify` — validação e fechamento com flags: `--gaps`, `--security`, `--ui`, `--pr`, `--diff`, `--skip-retro`
125
+
126
+ **Trilha avançada:** `/oxe-session` (absorve project, milestone, workstream), `/oxe-dashboard`
127
+
128
+ **Administrativa:** `/oxe-capabilities`, `/oxe-skill`, `oxe-cc azure`
129
+
130
+ ### Depreciado (v1.1.0)
131
+
132
+ Os seguintes comandos foram incorporados por estágios principais e continuam funcionando com aviso de migração:
133
+
134
+ | Comando | Novo destino |
135
+ |---------|-------------|
136
+ | `/oxe-ask` | `/oxe "pergunta"` |
137
+ | `/oxe-scan` | `/oxe-spec --refresh` |
138
+ | `/oxe-research` | `/oxe-spec --research` |
139
+ | `/oxe-ui-spec` | `/oxe-spec --ui` |
140
+ | `/oxe-obs` | `/oxe-execute --note` |
141
+ | `/oxe-debug` | `/oxe-execute --debug` |
142
+ | `/oxe-forensics` | `/oxe-execute --deep-diagnosis` |
143
+ | `/oxe-checkpoint` | `/oxe-execute --checkpoint` |
144
+ | `/oxe-loop` | `/oxe-execute --iterative` |
145
+ | `/oxe-validate-gaps` | `/oxe-verify --gaps` |
146
+ | `/oxe-security` | `/oxe-verify --security` |
147
+ | `/oxe-ui-review` | `/oxe-verify --ui` |
148
+ | `/oxe-review-pr` | `/oxe-verify --pr` |
149
+ | `/oxe-retro` | `/oxe-verify` (retro automática) |
150
+ | `/oxe-project` | `/oxe-session milestone\|workstream` |
151
+ | `/oxe-compact` | `/oxe-spec --refresh` |
152
+ | `/oxe-next` | `/oxe` (sem argumento) |
153
+ | `/oxe-route` | `/oxe "intenção"` |
154
+ | `/oxe-milestone` | `/oxe-session milestone` |
155
+ | `/oxe-workstream` | `/oxe-session workstream` |
156
+
157
+ ### Novos comportamentos
158
+
159
+ - **Retro automática:** `/oxe-verify` executa automaticamente retrospectiva ao fechar (`--skip-retro` para desativar)
160
+ - **Pergunta situacional inline:** `/oxe "pergunta"` substitui `/oxe-ask`
161
+ - `/oxe-session` agora suporta `milestone` e `workstream` como subcomandos
162
+
5
163
  ---
6
164
 
7
165
  ## [0.8.0] — 2026-04-14