oxe-cc 1.4.0 → 1.5.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 (142) hide show
  1. package/.cursor/commands/oxe-ask.md +4 -2
  2. package/.cursor/commands/oxe-capabilities.md +4 -2
  3. package/.cursor/commands/oxe-checkpoint.md +4 -2
  4. package/.cursor/commands/oxe-compact.md +4 -2
  5. package/.cursor/commands/oxe-dashboard.md +4 -2
  6. package/.cursor/commands/oxe-debug.md +4 -2
  7. package/.cursor/commands/oxe-discuss.md +4 -2
  8. package/.cursor/commands/oxe-execute.md +5 -3
  9. package/.cursor/commands/oxe-forensics.md +4 -2
  10. package/.cursor/commands/oxe-help.md +4 -2
  11. package/.cursor/commands/oxe-loop.md +4 -2
  12. package/.cursor/commands/oxe-milestone.md +4 -2
  13. package/.cursor/commands/oxe-next.md +4 -2
  14. package/.cursor/commands/oxe-obs.md +4 -2
  15. package/.cursor/commands/oxe-plan-agent.md +4 -2
  16. package/.cursor/commands/oxe-plan.md +4 -2
  17. package/.cursor/commands/oxe-project.md +4 -2
  18. package/.cursor/commands/oxe-quick.md +4 -2
  19. package/.cursor/commands/oxe-research.md +4 -2
  20. package/.cursor/commands/oxe-retro.md +4 -2
  21. package/.cursor/commands/oxe-review-pr.md +4 -2
  22. package/.cursor/commands/oxe-route.md +4 -2
  23. package/.cursor/commands/oxe-scan.md +4 -2
  24. package/.cursor/commands/oxe-security.md +4 -2
  25. package/.cursor/commands/oxe-session.md +5 -3
  26. package/.cursor/commands/oxe-ship.md +4 -2
  27. package/.cursor/commands/oxe-skill.md +4 -2
  28. package/.cursor/commands/oxe-spec.md +4 -2
  29. package/.cursor/commands/oxe-ui-review.md +4 -2
  30. package/.cursor/commands/oxe-ui-spec.md +4 -2
  31. package/.cursor/commands/oxe-update.md +4 -2
  32. package/.cursor/commands/oxe-validate-gaps.md +4 -2
  33. package/.cursor/commands/oxe-verify-audit.md +46 -0
  34. package/.cursor/commands/oxe-verify.md +4 -2
  35. package/.cursor/commands/oxe-workflow-authoring.md +47 -0
  36. package/.cursor/commands/oxe-workstream.md +4 -2
  37. package/.cursor/commands/oxe.md +6 -2
  38. package/.github/prompts/oxe-ask.prompt.md +4 -2
  39. package/.github/prompts/oxe-capabilities.prompt.md +4 -2
  40. package/.github/prompts/oxe-checkpoint.prompt.md +4 -2
  41. package/.github/prompts/oxe-compact.prompt.md +5 -3
  42. package/.github/prompts/oxe-dashboard.prompt.md +4 -2
  43. package/.github/prompts/oxe-debug.prompt.md +4 -2
  44. package/.github/prompts/oxe-discuss.prompt.md +6 -2
  45. package/.github/prompts/oxe-execute.prompt.md +5 -3
  46. package/.github/prompts/oxe-forensics.prompt.md +4 -2
  47. package/.github/prompts/oxe-help.prompt.md +6 -2
  48. package/.github/prompts/oxe-loop.prompt.md +4 -2
  49. package/.github/prompts/oxe-milestone.prompt.md +4 -2
  50. package/.github/prompts/oxe-next.prompt.md +6 -2
  51. package/.github/prompts/oxe-obs.prompt.md +4 -2
  52. package/.github/prompts/oxe-plan-agent.prompt.md +5 -2
  53. package/.github/prompts/oxe-plan.prompt.md +4 -2
  54. package/.github/prompts/oxe-project.prompt.md +4 -2
  55. package/.github/prompts/oxe-quick.prompt.md +4 -2
  56. package/.github/prompts/oxe-research.prompt.md +4 -2
  57. package/.github/prompts/oxe-retro.prompt.md +4 -2
  58. package/.github/prompts/oxe-review-pr.prompt.md +4 -2
  59. package/.github/prompts/oxe-route.prompt.md +4 -2
  60. package/.github/prompts/oxe-scan.prompt.md +4 -2
  61. package/.github/prompts/oxe-security.prompt.md +4 -2
  62. package/.github/prompts/oxe-session.prompt.md +5 -3
  63. package/.github/prompts/oxe-ship.prompt.md +4 -2
  64. package/.github/prompts/oxe-skill.prompt.md +4 -2
  65. package/.github/prompts/oxe-spec.prompt.md +4 -2
  66. package/.github/prompts/oxe-ui-review.prompt.md +4 -2
  67. package/.github/prompts/oxe-ui-spec.prompt.md +4 -2
  68. package/.github/prompts/oxe-update.prompt.md +4 -2
  69. package/.github/prompts/oxe-validate-gaps.prompt.md +4 -2
  70. package/.github/prompts/oxe-verify-audit.prompt.md +46 -0
  71. package/.github/prompts/oxe-verify.prompt.md +4 -2
  72. package/.github/prompts/oxe-workflow-authoring.prompt.md +47 -0
  73. package/.github/prompts/oxe-workstream.prompt.md +4 -2
  74. package/.github/prompts/oxe.prompt.md +6 -2
  75. package/.github/workflows/ci.yml +57 -20
  76. package/.github/workflows/release.yml +94 -0
  77. package/AGENTS.md +3 -1
  78. package/CHANGELOG.md +383 -342
  79. package/QUICKSTART.md +99 -0
  80. package/README.md +89 -65
  81. package/bin/lib/oxe-agent-install.cjs +127 -107
  82. package/bin/lib/oxe-install-resolve.cjs +10 -0
  83. package/bin/lib/oxe-operational.cjs +34 -28
  84. package/bin/lib/oxe-project-health.cjs +38 -6
  85. package/bin/lib/oxe-release.cjs +423 -0
  86. package/bin/lib/oxe-runtime-semantics.cjs +68 -24
  87. package/bin/oxe-cc.js +388 -55
  88. package/commands/oxe/ask.md +7 -3
  89. package/commands/oxe/capabilities.md +6 -2
  90. package/commands/oxe/checkpoint.md +5 -1
  91. package/commands/oxe/compact.md +6 -2
  92. package/commands/oxe/dashboard.md +6 -2
  93. package/commands/oxe/debug.md +6 -2
  94. package/commands/oxe/discuss.md +6 -2
  95. package/commands/oxe/execute.md +6 -2
  96. package/commands/oxe/forensics.md +6 -2
  97. package/commands/oxe/help.md +6 -2
  98. package/commands/oxe/loop.md +6 -2
  99. package/commands/oxe/milestone.md +6 -2
  100. package/commands/oxe/next.md +6 -2
  101. package/commands/oxe/obs.md +6 -2
  102. package/commands/oxe/oxe.md +6 -2
  103. package/commands/oxe/plan-agent.md +6 -2
  104. package/commands/oxe/plan.md +6 -2
  105. package/commands/oxe/project.md +6 -2
  106. package/commands/oxe/quick.md +6 -2
  107. package/commands/oxe/research.md +6 -2
  108. package/commands/oxe/retro.md +6 -2
  109. package/commands/oxe/review-pr.md +6 -2
  110. package/commands/oxe/route.md +6 -2
  111. package/commands/oxe/scan.md +6 -2
  112. package/commands/oxe/security.md +6 -2
  113. package/commands/oxe/session.md +6 -2
  114. package/commands/oxe/ship.md +6 -2
  115. package/commands/oxe/skill.md +6 -2
  116. package/commands/oxe/spec.md +6 -2
  117. package/commands/oxe/ui-review.md +6 -2
  118. package/commands/oxe/ui-spec.md +6 -2
  119. package/commands/oxe/update.md +6 -2
  120. package/commands/oxe/validate-gaps.md +6 -2
  121. package/commands/oxe/verify-audit.md +50 -0
  122. package/commands/oxe/verify.md +6 -2
  123. package/commands/oxe/workflow-authoring.md +50 -0
  124. package/commands/oxe/workstream.md +6 -2
  125. package/docs/INCIDENT-PLAYBOOK.md +181 -0
  126. package/docs/RELEASE-READINESS.md +46 -0
  127. package/docs/ROLES.md +129 -0
  128. package/docs/RUNTIME-SMOKE-MATRIX.md +128 -0
  129. package/docs/TEAM-ADOPTION.md +153 -0
  130. package/docs/WALKTHROUGH.md +241 -0
  131. package/lib/runtime/scheduler/multi-agent-coordinator.d.ts +28 -0
  132. package/lib/runtime/scheduler/multi-agent-coordinator.js +152 -26
  133. package/lib/sdk/README.md +2 -0
  134. package/lib/sdk/index.cjs +22 -8
  135. package/lib/sdk/index.d.ts +60 -16
  136. package/oxe/templates/config.template.json +1 -0
  137. package/package.json +30 -22
  138. package/packages/runtime/package.json +1 -1
  139. package/packages/runtime/src/scheduler/multi-agent-coordinator.ts +357 -193
  140. package/vscode-extension/oxe-agents-1.4.0.vsix +0 -0
  141. package/vscode-extension/oxe-agents-1.5.0.vsix +0 -0
  142. package/vscode-extension/package.json +1 -1
@@ -38,8 +38,10 @@ oxe_semantics_hash: 35b244a016d5c65c
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE capabilities** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/capabilities.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/capabilities.md ou oxe/workflows/capabilities.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Usa o texto adicional desta mensagem como ação sobre capabilities.
@@ -38,8 +38,10 @@ oxe_semantics_hash: 536e476616b47060
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE checkpoint** no repositório atual. Lê e aplica **integralmente**:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/checkpoint.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/checkpoint.md ou oxe/workflows/checkpoint.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  O **primeiro** argumento deve ser o **slug** (ex. `pre-migracao-api`); o resto é nota livre.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oxe-compact
3
- mode: agent
3
+ agent: agent
4
4
  description: OXE — refresh .oxe/codebase vs repo + CODEBASE-DELTA + RESUME
5
5
  oxe_workflow_slug: compact
6
6
  oxe_reasoning_mode: discovery
@@ -37,8 +37,10 @@ oxe_semantics_hash: ad10e8dc6f83b4fe
37
37
 
38
38
  <!-- oxe-reasoning-contract:end -->
39
39
 
40
- Executa o workflow **OXE compact** no repositório atual. Lê e aplica **integralmente**:
40
+ <!-- oxe-workflow-resolution:start -->
41
41
 
42
- `.oxe/workflows/compact.md`
42
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/compact.md ou oxe/workflows/compact.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
43
+
44
+ <!-- oxe-workflow-resolution:end -->
43
45
 
44
46
  Atualiza os **sete** mapas em **`.oxe/codebase/`** (incremental ou bootstrap como scan), gera **`.oxe/CODEBASE-DELTA.md`** e **`.oxe/RESUME.md`**. Texto extra do utilizador: foco ou decisões/bloqueios a incluir no RESUME.
@@ -38,8 +38,10 @@ oxe_semantics_hash: 37f74d8be3442fe1
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE dashboard** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/dashboard.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/dashboard.md ou oxe/workflows/dashboard.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Usa o texto adicional desta mensagem como foco opcional.
@@ -38,8 +38,10 @@ oxe_semantics_hash: 7912f4caf80c2915
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE debug** no repositório atual. Lê e aplica **integralmente**:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/debug.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/debug.md ou oxe/workflows/debug.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Usa o texto adicional desta mensagem como sintoma, **Tn** do PLAN se souber, ou saída de erro.
@@ -38,6 +38,10 @@ oxe_semantics_hash: 6994c2427094eff3
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE discuss** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
41
+ <!-- oxe-workflow-resolution:start -->
42
+
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/discuss.md ou oxe/workflows/discuss.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
46
+
42
47
 
43
- `.oxe/workflows/discuss.md`
@@ -41,8 +41,10 @@ oxe_semantics_hash: 14ddb483209b28b3
41
41
 
42
42
  <!-- oxe-reasoning-contract:end -->
43
43
 
44
- Executa o workflow **OXE execute** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
44
+ <!-- oxe-workflow-resolution:start -->
45
45
 
46
- `.oxe/workflows/execute.md`
46
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/execute.md ou oxe/workflows/execute.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
47
47
 
48
- Usa o texto adicional desta mensagem como foco: `A` (Completo), `B` (Por onda), `C` (Por tarefa), `onda N`, `Tn`, ou confirmação de progresso. Lê `.oxe/workflows/execute.md` na raiz do projeto atual (CWD).
48
+ <!-- oxe-workflow-resolution:end -->
49
+
50
+ Usa o texto adicional desta mensagem como foco: `A` (Completo), `B` (Por onda), `C` (Por tarefa), `onda N`, `Tn`, ou confirmação de progresso.
@@ -38,8 +38,10 @@ oxe_semantics_hash: a9461a0a5c59fa8d
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE forensics** no repositório atual. Lê e aplica **integralmente**:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/forensics.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/forensics.md ou oxe/workflows/forensics.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Usa o texto adicional desta mensagem como contexto do sintoma (falha de verify, doctor, estado incoerente).
@@ -37,6 +37,10 @@ oxe_semantics_hash: e292f28e042fbaa5
37
37
 
38
38
  <!-- oxe-reasoning-contract:end -->
39
39
 
40
- Executa o workflow **OXE help**. Lê e segue **integralmente**:
40
+ <!-- oxe-workflow-resolution:start -->
41
+
42
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/help.md ou oxe/workflows/help.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
43
+
44
+ <!-- oxe-workflow-resolution:end -->
45
+
41
46
 
42
- `.oxe/workflows/help.md` (na raiz do repositório em contexto)
@@ -38,8 +38,10 @@ oxe_semantics_hash: ebbadaede8629bea
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE loop** no repositório atual. Lê e aplica **integralmente**:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/loop.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/loop.md ou oxe/workflows/loop.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  `$ARGUMENTS` = onda alvo e máximo de tentativas (ex.: `onda 2 max:5`). Pré-requisito: `.oxe/PLAN.md`.
@@ -38,8 +38,10 @@ oxe_semantics_hash: 8a7c3e675d6a4e36
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE milestone** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/milestone.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/milestone.md ou oxe/workflows/milestone.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Usa o texto adicional desta mensagem como subcomando e contexto.
@@ -37,6 +37,10 @@ oxe_semantics_hash: 5767434e94769645
37
37
 
38
38
  <!-- oxe-reasoning-contract:end -->
39
39
 
40
- Executa o workflow **OXE next**. Lê e aplica **integralmente**:
40
+ <!-- oxe-workflow-resolution:start -->
41
+
42
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/next.md ou oxe/workflows/next.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
43
+
44
+ <!-- oxe-workflow-resolution:end -->
45
+
41
46
 
42
- `.oxe/workflows/next.md` (na raiz do repositório em contexto)
@@ -38,8 +38,10 @@ oxe_semantics_hash: ef2faec6af3a4964
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE obs** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/obs.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/obs.md ou oxe/workflows/obs.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Usa o texto adicional desta mensagem como a observação a registrar.
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: oxe-plan-agent
3
+ agent: agent
3
4
  description: "OXE — PLAN.md + plan-agents.json (plano orientado a agentes / ondas)"
4
5
  oxe_workflow_slug: plan-agent
5
6
  oxe_reasoning_mode: planning
@@ -36,8 +37,10 @@ oxe_semantics_hash: a8f516ec17603d26
36
37
 
37
38
  <!-- oxe-reasoning-contract:end -->
38
39
 
39
- Executa o workflow **OXE plan-agent**. Lê e aplica **integralmente**:
40
+ <!-- oxe-workflow-resolution:start -->
40
41
 
41
- `.oxe/workflows/plan-agent.md` (na raiz do repositório em contexto)
42
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/plan-agent.md ou oxe/workflows/plan-agent.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
43
+
44
+ <!-- oxe-workflow-resolution:end -->
42
45
 
43
46
  Se o utilizador pedir replanejamento, trata como **`--replan`** conforme o workflow.
@@ -38,8 +38,10 @@ oxe_semantics_hash: 7809d830a5f5ff4a
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE plan**. Lê e aplica **integralmente**:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/plan.md` (na raiz do repositório em contexto)
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/plan.md ou oxe/workflows/plan.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Se o utilizador pedir replanejamento, trata como `--replan` conforme o workflow.
@@ -38,8 +38,10 @@ oxe_semantics_hash: 7f329aace340b533
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE project** no repositório atual. Lê e aplica **integralmente**:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/project.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/project.md ou oxe/workflows/project.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  `$ARGUMENTS` = subcomando: `milestone new|complete|status|audit`, `workstream new|switch|list|close <nome>`, `checkpoint [slug]`, ou vazio para status atual.
@@ -38,8 +38,10 @@ oxe_semantics_hash: 2193373eb2691e0d
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE quick** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/quick.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/quick.md ou oxe/workflows/quick.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Usa o texto adicional desta mensagem como objetivo e contexto.
@@ -38,8 +38,10 @@ oxe_semantics_hash: 6c3005eec893f1b7
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE research** no repositório atual. Lê e aplica **integralmente**:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/research.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/research.md ou oxe/workflows/research.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Usa o texto adicional desta mensagem como âmbito (paths, perguntas, spike, mapa de sistema, engenharia reversa ou modernização).
@@ -38,8 +38,10 @@ oxe_semantics_hash: 5a2fb7b4988f3de6
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE retro** no repositório atual. Lê e aplica **integralmente**:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/retro.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/retro.md ou oxe/workflows/retro.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Lê VERIFY.md, FORENSICS.md, SUMMARY.md. `$ARGUMENTS` = contexto extra opcional.
@@ -38,8 +38,10 @@ oxe_semantics_hash: 836780b0831671b7
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE review-pr**. Lê e aplica **integralmente**:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/review-pr.md` (na raiz do repositório em contexto)
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/review-pr.md ou oxe/workflows/review-pr.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  **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).
@@ -38,8 +38,10 @@ oxe_semantics_hash: 17b5078ffaad8644
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE route** no repositório atual. Lê e aplica **integralmente**:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/route.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/route.md ou oxe/workflows/route.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Usa o texto adicional desta mensagem como intenção a classificar (tabela Router em `help.md`).
@@ -38,8 +38,10 @@ oxe_semantics_hash: c7c6e28ef92595b1
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE scan** no repositório atual. Lê e aplica **integralmente** o ficheiro:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/scan.md` (na raiz do repositório em contexto)
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/scan.md ou oxe/workflows/scan.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Usa o texto adicional desta mensagem como foco opcional de área (pastas/módulos).
@@ -38,8 +38,10 @@ oxe_semantics_hash: 0addcd00818ddee2
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE security** no repositório atual. Lê e aplica **integralmente**:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/security.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/security.md ou oxe/workflows/security.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Lê `.oxe/codebase/STACK.md` para determinar categorias OWASP aplicáveis. `$ARGUMENTS` = foco opcional.
@@ -38,8 +38,10 @@ oxe_semantics_hash: df52e7982aeabf21
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE session** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/session.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/session.md ou oxe/workflows/session.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
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
+ <!-- oxe-workflow-resolution:end -->
46
+
47
+ Usa o texto adicional desta mensagem como foco do subcomando: `new <nome>`, `list`, `switch <id>`, `resume <id>`, `status`, `close` ou `migrate <nome>`.
@@ -38,8 +38,10 @@ oxe_semantics_hash: 4a5d304e6ca781fc
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE ship**. Lê e aplica **integralmente**:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/ship.md` (na raiz do repositório em contexto)
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/ship.md ou oxe/workflows/ship.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Usa `$ARGUMENTS` como flags de entrega (`--message`, `--amend`, `--verify-first`, `--no-checks`, `--dry-run`).
@@ -38,8 +38,10 @@ oxe_semantics_hash: 3cfb16d4930b8a59
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE skill** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/skill.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/skill.md ou oxe/workflows/skill.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Usa o texto adicional desta mensagem como subcomando ou invocação de skill.
@@ -38,8 +38,10 @@ oxe_semantics_hash: eea8766eab635c97
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE spec**. Lê e aplica **integralmente**:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/spec.md` (na raiz do repositório em contexto)
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/spec.md ou oxe/workflows/spec.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Usa o resto desta mensagem e ficheiros anexados como entrada do utilizador.
@@ -38,8 +38,10 @@ oxe_semantics_hash: 262a73b77bf68d6d
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE ui-review** no repositório atual. Lê e aplica **integralmente**:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/ui-review.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/ui-review.md ou oxe/workflows/ui-review.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Usa o texto adicional desta mensagem como ficheiros ou tarefas a rever.
@@ -38,8 +38,10 @@ oxe_semantics_hash: 5c8a7668f0a9fca1
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE ui-spec** no repositório atual. Lê e aplica **integralmente**:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/ui-spec.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/ui-spec.md ou oxe/workflows/ui-spec.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Usa o texto adicional desta mensagem como foco de ecrãs ou componentes, se houver.
@@ -37,8 +37,10 @@ oxe_semantics_hash: afa0ff72a118df58
37
37
 
38
38
  <!-- oxe-reasoning-contract:end -->
39
39
 
40
- Executa o workflow **OXE update**. Lê e segue **integralmente**:
40
+ <!-- oxe-workflow-resolution:start -->
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
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/update.md ou oxe/workflows/update.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
43
+
44
+ <!-- oxe-workflow-resolution:end -->
43
45
 
44
46
  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`**.
@@ -38,8 +38,10 @@ oxe_semantics_hash: 69e3f79ec51160e1
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE validate-gaps** no repositório atual. Lê e aplica **integralmente**:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/validate-gaps.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/validate-gaps.md ou oxe/workflows/validate-gaps.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Requer `VERIFY.md` e `PLAN.md` já existentes. Texto adicional: foco opcional em tarefa **Tn** ou critério **A***.
@@ -0,0 +1,46 @@
1
+ ---
2
+ name: oxe-verify-audit
3
+ agent: agent
4
+ description: OXE — Auditoria adversarial de VERIFY.md (Verify Auditor)
5
+ oxe_workflow_slug: verify-audit
6
+ oxe_reasoning_mode: review
7
+ oxe_question_policy: none
8
+ oxe_output_contract: findings
9
+ oxe_tool_profile: review_heavy
10
+ oxe_confidence_policy: explicit
11
+ oxe_context_tier: standard
12
+ oxe_contract_version: 2.0.0
13
+ oxe_semantics_hash: da71d7eafdce81aa
14
+ ---
15
+
16
+ <!-- oxe-reasoning-contract:start -->
17
+
18
+ **Contrato de raciocínio OXE deste comando**
19
+ - **Workflow:** verify-audit
20
+ - **Modo:** revisão
21
+ - **Perguntas:** nenhuma
22
+ - **Saída esperada:** achados
23
+ - **Perfil de ferramentas:** revisão intensa
24
+ - **Política de confiança:** explícita
25
+ - **Tier de contexto padrão:** padrão
26
+ - **Versão do contrato:** 2.0.0
27
+ - **Checksum semântico:** `da71d7eafdce81aa`
28
+ - **Entrada de contexto prioritária:** `.oxe/context/packs/verify-audit.md` e `.oxe/context/packs/verify-audit.json`
29
+ - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
30
+ - **Inspeção estruturada:** `oxe-cc context inspect --workflow verify-audit --json`
31
+ - Apresentar findings primeiro, ordenados por severidade e evidência.
32
+ - Separar bug, risco, regressão e lacuna de teste.
33
+ - Se não houver findings, declarar isso explicitamente e listar riscos residuais.
34
+ - **Seções esperadas:** Findings · Perguntas abertas · Riscos residuais · Resumo
35
+ - **Bloqueios formais:** missing:state
36
+ - **Referência canónica:** `oxe/workflows/references/reasoning-review.md`
37
+
38
+ <!-- oxe-reasoning-contract:end -->
39
+
40
+ <!-- oxe-workflow-resolution:start -->
41
+
42
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/verify-audit.md ou oxe/workflows/verify-audit.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
43
+
44
+ <!-- oxe-workflow-resolution:end -->
45
+
46
+ Opera com contexto propositalmente restrito: só `SPEC.md` (critérios A*) e `VERIFY.md`. Escreve a seção `## Auditoria Adversarial` no VERIFY.md com resultado APROVADO / CONDICIONADO / REPROVADO.
@@ -41,8 +41,10 @@ oxe_semantics_hash: 8b47625394eec62a
41
41
 
42
42
  <!-- oxe-reasoning-contract:end -->
43
43
 
44
- Executa o workflow **OXE verify**. Lê e aplica **integralmente**:
44
+ <!-- oxe-workflow-resolution:start -->
45
45
 
46
- `.oxe/workflows/verify.md` (na raiz do repositório em contexto)
46
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/verify.md ou oxe/workflows/verify.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
47
+
48
+ <!-- oxe-workflow-resolution:end -->
47
49
 
48
50
  Se o utilizador indicar uma tarefa `Tn`, restringe a verificação a essa tarefa.
@@ -0,0 +1,47 @@
1
+ ---
2
+ name: oxe-workflow-authoring
3
+ agent: agent
4
+ description: "OXE — Revisa um workflow contra o guia de autoria"
5
+ argument-hint: "<path/to/workflow.md>"
6
+ oxe_workflow_slug: workflow-authoring
7
+ oxe_reasoning_mode: review
8
+ oxe_question_policy: none
9
+ oxe_output_contract: findings
10
+ oxe_tool_profile: review_heavy
11
+ oxe_confidence_policy: explicit
12
+ oxe_context_tier: standard
13
+ oxe_contract_version: 2.0.0
14
+ oxe_semantics_hash: 430a364fe5aa3494
15
+ ---
16
+
17
+ <!-- oxe-reasoning-contract:start -->
18
+
19
+ **Contrato de raciocínio OXE deste comando**
20
+ - **Workflow:** workflow-authoring
21
+ - **Modo:** revisão
22
+ - **Perguntas:** nenhuma
23
+ - **Saída esperada:** achados
24
+ - **Perfil de ferramentas:** revisão intensa
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:** `430a364fe5aa3494`
29
+ - **Entrada de contexto prioritária:** `.oxe/context/packs/workflow-authoring.md` e `.oxe/context/packs/workflow-authoring.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 workflow-authoring --json`
32
+ - Apresentar findings primeiro, ordenados por severidade e evidência.
33
+ - Separar bug, risco, regressão e lacuna de teste.
34
+ - Se não houver findings, declarar isso explicitamente e listar riscos residuais.
35
+ - **Seções esperadas:** Findings · Perguntas abertas · Riscos residuais · Resumo
36
+ - **Bloqueios formais:** missing:state
37
+ - **Referência canónica:** `oxe/workflows/references/reasoning-review.md`
38
+
39
+ <!-- oxe-reasoning-contract:end -->
40
+
41
+ <!-- oxe-workflow-resolution:start -->
42
+
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/workflow-authoring.md ou oxe/workflows/workflow-authoring.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
46
+
47
+ Indica o path do workflow a revisar (ex.: `oxe/workflows/spec.md`). Se omitido, o agente vai pedir.
@@ -38,8 +38,10 @@ oxe_semantics_hash: 380bd0a3f3620845
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE workstream** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
41
+ <!-- oxe-workflow-resolution:start -->
42
42
 
43
- `.oxe/workflows/workstream.md`
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/workstream.md ou oxe/workflows/workstream.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
44
+
45
+ <!-- oxe-workflow-resolution:end -->
44
46
 
45
47
  Usa o texto adicional desta mensagem como subcomando e contexto.
@@ -38,8 +38,12 @@ oxe_semantics_hash: 4a8d0d23c56065a7
38
38
 
39
39
  <!-- oxe-reasoning-contract:end -->
40
40
 
41
- Executa o workflow **OXE** (entrada universal) no repositório atual. Lê e aplica **integralmente**:
41
+ <!-- oxe-workflow-resolution:start -->
42
+
43
+ **Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/oxe.md ou oxe/workflows/oxe.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
42
44
 
43
- `.oxe/workflows/oxe.md`
45
+ <!-- oxe-workflow-resolution:end -->
46
+
47
+ Executa o workflow **OXE** (entrada universal) no repositório atual. Lê e aplica **integralmente**:
44
48
 
45
49
  `$ARGUMENTS`: vazio → próximo passo; texto → roteamento; "help" → trilha principal + trilha avançada.