oxe-cc 0.3.8 → 0.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 (78) hide show
  1. package/.cursor/commands/oxe-checkpoint.md +2 -0
  2. package/.cursor/commands/oxe-compact.md +2 -0
  3. package/.cursor/commands/oxe-debug.md +2 -0
  4. package/.cursor/commands/oxe-discuss.md +2 -0
  5. package/.cursor/commands/oxe-execute.md +3 -1
  6. package/.cursor/commands/oxe-forensics.md +2 -0
  7. package/.cursor/commands/oxe-help.md +2 -0
  8. package/.cursor/commands/oxe-milestone.md +11 -0
  9. package/.cursor/commands/oxe-next.md +2 -0
  10. package/.cursor/commands/oxe-obs.md +11 -0
  11. package/.cursor/commands/oxe-plan-agent.md +2 -0
  12. package/.cursor/commands/oxe-plan.md +2 -0
  13. package/.cursor/commands/oxe-quick.md +3 -1
  14. package/.cursor/commands/oxe-research.md +2 -0
  15. package/.cursor/commands/oxe-review-pr.md +2 -0
  16. package/.cursor/commands/oxe-route.md +2 -0
  17. package/.cursor/commands/oxe-scan.md +2 -0
  18. package/.cursor/commands/oxe-spec.md +3 -1
  19. package/.cursor/commands/oxe-ui-review.md +2 -0
  20. package/.cursor/commands/oxe-ui-spec.md +2 -0
  21. package/.cursor/commands/oxe-update.md +2 -0
  22. package/.cursor/commands/oxe-validate-gaps.md +2 -0
  23. package/.cursor/commands/oxe-verify.md +2 -0
  24. package/.cursor/commands/oxe-workstream.md +11 -0
  25. package/.github/prompts/oxe-execute.prompt.md +12 -12
  26. package/.github/prompts/oxe-milestone.prompt.md +12 -0
  27. package/.github/prompts/oxe-obs.prompt.md +12 -0
  28. package/.github/prompts/oxe-quick.prompt.md +12 -12
  29. package/.github/prompts/oxe-spec.prompt.md +2 -2
  30. package/.github/prompts/oxe-workstream.prompt.md +12 -0
  31. package/README.md +205 -442
  32. package/bin/banner.txt +1 -1
  33. package/bin/lib/oxe-plugins.cjs +226 -0
  34. package/bin/lib/oxe-project-health.cjs +97 -1
  35. package/bin/lib/oxe-security.cjs +225 -0
  36. package/bin/oxe-cc.js +29 -0
  37. package/commands/oxe/execute.md +16 -16
  38. package/commands/oxe/milestone.md +16 -0
  39. package/commands/oxe/obs.md +16 -0
  40. package/commands/oxe/quick.md +16 -16
  41. package/commands/oxe/spec.md +2 -2
  42. package/commands/oxe/workstream.md +16 -0
  43. package/lib/sdk/index.cjs +284 -0
  44. package/lib/sdk/index.d.ts +148 -1
  45. package/oxe/personas/README.md +39 -0
  46. package/oxe/personas/architect.md +37 -0
  47. package/oxe/personas/db-specialist.md +36 -0
  48. package/oxe/personas/debugger.md +38 -0
  49. package/oxe/personas/executor.md +38 -0
  50. package/oxe/personas/planner.md +36 -0
  51. package/oxe/personas/researcher.md +35 -0
  52. package/oxe/personas/ui-specialist.md +36 -0
  53. package/oxe/personas/verifier.md +39 -0
  54. package/oxe/templates/CONFIG.md +58 -4
  55. package/oxe/templates/DISCUSS.template.md +44 -0
  56. package/oxe/templates/MEMORY.template.md +49 -0
  57. package/oxe/templates/MILESTONES.template.md +17 -0
  58. package/oxe/templates/OBSERVATIONS.template.md +18 -0
  59. package/oxe/templates/PLUGINS.md +101 -0
  60. package/oxe/templates/ROADMAP.template.md +44 -0
  61. package/oxe/templates/STATE.md +29 -2
  62. package/oxe/templates/config.template.json +5 -0
  63. package/oxe/templates/plan-agent-messages-README.template.md +1 -1
  64. package/oxe/templates/quick-agents.template.json +24 -0
  65. package/oxe/workflows/discuss.md +48 -5
  66. package/oxe/workflows/execute.md +111 -28
  67. package/oxe/workflows/help.md +80 -15
  68. package/oxe/workflows/milestone.md +96 -0
  69. package/oxe/workflows/obs.md +95 -0
  70. package/oxe/workflows/plan-agent.md +31 -1
  71. package/oxe/workflows/plan.md +5 -1
  72. package/oxe/workflows/quick.md +120 -10
  73. package/oxe/workflows/references/plan-agent-chat-protocol.md +14 -0
  74. package/oxe/workflows/scan.md +9 -1
  75. package/oxe/workflows/spec.md +172 -23
  76. package/oxe/workflows/verify.md +77 -17
  77. package/oxe/workflows/workstream.md +96 -0
  78. package/package.json +3 -2
@@ -2,6 +2,8 @@
2
2
  description: "OXE — Checkpoint nomeado (.oxe/checkpoints/ + índice)"
3
3
  ---
4
4
 
5
+ OXE — Checkpoint nomeado (.oxe/checkpoints/ + índice)
6
+
5
7
  Executa o workflow **OXE checkpoint** no repositório atual. Lê e aplica **integralmente**:
6
8
 
7
9
  `oxe/workflows/checkpoint.md`
@@ -2,6 +2,8 @@
2
2
  description: "OXE — refresh .oxe/codebase vs repo + CODEBASE-DELTA + RESUME"
3
3
  ---
4
4
 
5
+ OXE — refresh .oxe/codebase vs repo + CODEBASE-DELTA + RESUME
6
+
5
7
  Executa o workflow **OXE compact** no repositório atual. Lê e aplica **integralmente**:
6
8
 
7
9
  `oxe/workflows/compact.md`
@@ -2,6 +2,8 @@
2
2
  description: "OXE — Debug técnico durante execute (DEBUG.md, hipótese/evidência)"
3
3
  ---
4
4
 
5
+ OXE — Debug técnico durante execute (DEBUG.md, hipótese/evidência)
6
+
5
7
  Executa o workflow **OXE debug** no repositório atual. Lê e aplica **integralmente**:
6
8
 
7
9
  `oxe/workflows/debug.md`
@@ -2,6 +2,8 @@
2
2
  description: "OXE — Discussão antes do plano"
3
3
  ---
4
4
 
5
+ OXE — Discussão antes do plano
6
+
5
7
  Executa o workflow **OXE discuss** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
6
8
 
7
9
  `oxe/workflows/discuss.md`
@@ -1,7 +1,9 @@
1
1
  ---
2
- description: "OXE — Executar onda do PLAN ou passos do QUICK"
2
+ description: "OXE — Executar plano (solo ou com agentes): escolha Completo (1 sessão) | Por onda | Por tarefa para controlar requisições"
3
3
  ---
4
4
 
5
+ OXE — Executar plano (solo ou com agentes): escolha Completo (1 sessão) | Por onda | Por tarefa para controlar requisições
6
+
5
7
  Executa o workflow **OXE execute** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
6
8
 
7
9
  `oxe/workflows/execute.md`
@@ -2,6 +2,8 @@
2
2
  description: "OXE — Diagnóstico pós-falha (FORENSICS.md + reingresso scan/plan/execute)"
3
3
  ---
4
4
 
5
+ OXE — Diagnóstico pós-falha (FORENSICS.md + reingresso scan/plan/execute)
6
+
5
7
  Executa o workflow **OXE forensics** no repositório atual. Lê e aplica **integralmente**:
6
8
 
7
9
  `oxe/workflows/forensics.md`
@@ -2,6 +2,8 @@
2
2
  description: "OXE — Ajuda (fluxo .oxe/, várias IDEs e CLIs, artefatos)"
3
3
  ---
4
4
 
5
+ OXE — Ajuda (fluxo .oxe/, várias IDEs e CLIs, artefatos)
6
+
5
7
  Executa o workflow **OXE help**. Lê e segue **integralmente**:
6
8
 
7
9
  `oxe/workflows/help.md` (na raiz do repositório em contexto)
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "OXE — Marcos de entrega (M-NN): new, complete (arquiva em .oxe/milestones/M-NN/), status, audit"
3
+ ---
4
+
5
+ OXE — Marcos de entrega (M-NN): new, complete (arquiva em .oxe/milestones/M-NN/), status, audit
6
+
7
+ Executa o workflow **OXE milestone** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
8
+
9
+ `oxe/workflows/milestone.md`
10
+
11
+ Usa o texto adicional desta mensagem como subcomando e contexto.
@@ -2,6 +2,8 @@
2
2
  description: "OXE — Próximo passo (lê STATE.md)"
3
3
  ---
4
4
 
5
+ OXE — Próximo passo (lê STATE.md)
6
+
5
7
  Executa o workflow **OXE next**. Lê e aplica **integralmente**:
6
8
 
7
9
  `oxe/workflows/next.md` (na raiz do repositório em contexto)
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "OXE — Observação contextual: registra em .oxe/OBSERVATIONS.md e é incorporada automaticamente no próximo spec/plan/execute (sem re-explicar)"
3
+ ---
4
+
5
+ OXE — Observação contextual: registra em .oxe/OBSERVATIONS.md e é incorporada automaticamente no próximo spec/plan/execute (sem re-explicar)
6
+
7
+ Executa o workflow **OXE obs** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
8
+
9
+ `oxe/workflows/obs.md`
10
+
11
+ Usa o texto adicional desta mensagem como a observação a registrar.
@@ -2,6 +2,8 @@
2
2
  description: "OXE — PLAN.md + plan-agents.json (plano orientado a agentes / ondas)"
3
3
  ---
4
4
 
5
+ OXE — PLAN.md + plan-agents.json (plano orientado a agentes / ondas)
6
+
5
7
  Executa o workflow **OXE plan-agent**. Lê e aplica **integralmente**:
6
8
 
7
9
  `oxe/workflows/plan-agent.md` (na raiz do repositório em contexto)
@@ -2,6 +2,8 @@
2
2
  description: "OXE — Gera .oxe/PLAN.md com verificação por tarefa"
3
3
  ---
4
4
 
5
+ OXE — Gera .oxe/PLAN.md com verificação por tarefa
6
+
5
7
  Executa o workflow **OXE plan**. Lê e aplica **integralmente**:
6
8
 
7
9
  `oxe/workflows/plan.md` (na raiz do repositório em contexto)
@@ -1,7 +1,9 @@
1
1
  ---
2
- description: "OXE — Modo rápido (.oxe/QUICK.md)"
2
+ description: "OXE — Modo rápido com Plan-Driven Dynamic Agents lean: objetivo → passos → agentes por domínio (opcional) → verificar"
3
3
  ---
4
4
 
5
+ OXE — Modo rápido com Plan-Driven Dynamic Agents lean: objetivo → passos → agentes por domínio (opcional) → verificar
6
+
5
7
  Executa o workflow **OXE quick** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
6
8
 
7
9
  `oxe/workflows/quick.md`
@@ -2,6 +2,8 @@
2
2
  description: "OXE — Pesquisa exploratória (.oxe/research/ + índice RESEARCH.md)"
3
3
  ---
4
4
 
5
+ OXE — Pesquisa exploratória (.oxe/research/ + índice RESEARCH.md)
6
+
5
7
  Executa o workflow **OXE research** no repositório atual. Lê e aplica **integralmente**:
6
8
 
7
9
  `oxe/workflows/research.md`
@@ -2,6 +2,8 @@
2
2
  description: "OXE — Revisão de PR (link GitHub, branches ou SHAs)"
3
3
  ---
4
4
 
5
+ OXE — Revisão de PR (link GitHub, branches ou SHAs)
6
+
5
7
  Executa o workflow **OXE review-pr**. Lê e aplica **integralmente**:
6
8
 
7
9
  `oxe/workflows/review-pr.md` (na raiz do repositório em contexto)
@@ -2,6 +2,8 @@
2
2
  description: "OXE — Router: um pedido em linguagem natural → um comando/workflow"
3
3
  ---
4
4
 
5
+ OXE — Router: um pedido em linguagem natural → um comando/workflow
6
+
5
7
  Executa o workflow **OXE route** no repositório atual. Lê e aplica **integralmente**:
6
8
 
7
9
  `oxe/workflows/route.md`
@@ -2,6 +2,8 @@
2
2
  description: "OXE — Scan do repositório (.oxe/codebase/)"
3
3
  ---
4
4
 
5
+ OXE — Scan do repositório (.oxe/codebase/)
6
+
5
7
  Executa o workflow **OXE scan** no repositório atual. Lê e aplica **integralmente** o ficheiro:
6
8
 
7
9
  `oxe/workflows/scan.md` (na raiz do repositório em contexto)
@@ -1,7 +1,9 @@
1
1
  ---
2
- description: "OXE — Cria ou atualiza .oxe/SPEC.md"
2
+ description: "OXE — Spec em 5 fases: perguntas → pesquisa → requisitos (R-ID v1/v2/fora) → roteiro (.oxe/ROADMAP.md) → aprovação → plan"
3
3
  ---
4
4
 
5
+ OXE — Spec em 5 fases: perguntas → pesquisa → requisitos (R-ID v1/v2/fora) → roteiro (.oxe/ROADMAP.md) → aprovação → plan
6
+
5
7
  Executa o workflow **OXE spec**. Lê e aplica **integralmente**:
6
8
 
7
9
  `oxe/workflows/spec.md` (na raiz do repositório em contexto)
@@ -2,6 +2,8 @@
2
2
  description: "OXE — Auditoria UI (UI-REVIEW.md) face ao UI-SPEC"
3
3
  ---
4
4
 
5
+ OXE — Auditoria UI (UI-REVIEW.md) face ao UI-SPEC
6
+
5
7
  Executa o workflow **OXE ui-review** no repositório atual. Lê e aplica **integralmente**:
6
8
 
7
9
  `oxe/workflows/ui-review.md`
@@ -2,6 +2,8 @@
2
2
  description: "OXE — Contrato UI (UI-SPEC.md) a partir da SPEC"
3
3
  ---
4
4
 
5
+ OXE — Contrato UI (UI-SPEC.md) a partir da SPEC
6
+
5
7
  Executa o workflow **OXE ui-spec** no repositório atual. Lê e aplica **integralmente**:
6
8
 
7
9
  `oxe/workflows/ui-spec.md`
@@ -2,6 +2,8 @@
2
2
  description: "Atualizar oxe-cc no projeto — verificar versão no npm, alinhar ficheiros OXE e validar com doctor"
3
3
  ---
4
4
 
5
+ Atualizar oxe-cc no projeto — verificar versão no npm, alinhar ficheiros OXE e validar com doctor
6
+
5
7
  Executa o workflow **OXE update**. Lê e segue **integralmente**:
6
8
 
7
9
  `oxe/workflows/update.md` (na raiz do repositório em contexto; ou `.oxe/workflows/update.md` se a instalação aninhou os workflows)
@@ -2,6 +2,8 @@
2
2
  description: "OXE — Gaps de cobertura pós-verify (VALIDATION-GAPS.md)"
3
3
  ---
4
4
 
5
+ OXE — Gaps de cobertura pós-verify (VALIDATION-GAPS.md)
6
+
5
7
  Executa o workflow **OXE validate-gaps** no repositório atual. Lê e aplica **integralmente**:
6
8
 
7
9
  `oxe/workflows/validate-gaps.md`
@@ -2,6 +2,8 @@
2
2
  description: "OXE — Valida implementação (.oxe/VERIFY.md)"
3
3
  ---
4
4
 
5
+ OXE — Valida implementação (.oxe/VERIFY.md)
6
+
5
7
  Executa o workflow **OXE verify**. Lê e aplica **integralmente**:
6
8
 
7
9
  `oxe/workflows/verify.md` (na raiz do repositório em contexto)
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "OXE — Trilhas paralelas: list, new <nome>, switch <nome>, status, close <nome> — cada trilha tem artefatos independentes em .oxe/workstreams/<nome>/"
3
+ ---
4
+
5
+ OXE — Trilhas paralelas: list, new <nome>, switch <nome>, status, close <nome> — cada trilha tem artefatos independentes em .oxe/workstreams/<nome>/
6
+
7
+ Executa o workflow **OXE workstream** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
8
+
9
+ `oxe/workflows/workstream.md`
10
+
11
+ Usa o texto adicional desta mensagem como subcomando e contexto.
@@ -1,12 +1,12 @@
1
- ---
2
- name: oxe-execute
3
- agent: agent
4
- description: OXE — Executar onda do PLAN ou passos do QUICK
5
- argument-hint: "[opcional: onda N ou Tn]"
6
- ---
7
-
8
- Executa o workflow **OXE execute** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
9
-
10
- `oxe/workflows/execute.md`
11
-
12
- Usa o texto adicional desta mensagem como foco (onda, tarefa Tn, ou confirmação de progresso).
1
+ ---
2
+ name: oxe-execute
3
+ agent: agent
4
+ description: "OXE — Executar plano (solo ou com agentes): escolha Completo (1 sessão) | Por onda | Por tarefa para controlar requisições"
5
+ argument-hint: "[opcional: A/B/C para modo, onda N, ou Tn]"
6
+ ---
7
+
8
+ Executa o workflow **OXE execute** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
9
+
10
+ `oxe/workflows/execute.md`
11
+
12
+ Usa o texto adicional desta mensagem como foco (onda, tarefa Tn, ou confirmação de progresso).
@@ -0,0 +1,12 @@
1
+ ---
2
+ name: oxe-milestone
3
+ agent: agent
4
+ description: "OXE — Marcos de entrega (M-NN): new, complete (arquiva em .oxe/milestones/M-NN/), status, audit"
5
+ argument-hint: "new <nome> | complete | status | audit"
6
+ ---
7
+
8
+ Executa o workflow **OXE milestone** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
9
+
10
+ `oxe/workflows/milestone.md`
11
+
12
+ Usa o texto adicional desta mensagem como subcomando e contexto.
@@ -0,0 +1,12 @@
1
+ ---
2
+ name: oxe-obs
3
+ agent: agent
4
+ description: "OXE — Observação contextual: registra em .oxe/OBSERVATIONS.md e é incorporada automaticamente no próximo spec/plan/execute (sem re-explicar)"
5
+ argument-hint: "[observação em texto livre]"
6
+ ---
7
+
8
+ Executa o workflow **OXE obs** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
9
+
10
+ `oxe/workflows/obs.md`
11
+
12
+ Usa o texto adicional desta mensagem como a observação a registrar.
@@ -1,12 +1,12 @@
1
- ---
2
- name: oxe-quick
3
- agent: agent
4
- description: OXE — Modo rápido (.oxe/QUICK.md)
5
- argument-hint: "[objetivo em texto livre]"
6
- ---
7
-
8
- Executa o workflow **OXE quick** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
9
-
10
- `oxe/workflows/quick.md`
11
-
12
- Usa o texto adicional desta mensagem como objetivo e contexto.
1
+ ---
2
+ name: oxe-quick
3
+ agent: agent
4
+ description: "OXE — Modo rápido com Plan-Driven Dynamic Agents lean: objetivo → passos → agentes por domínio (opcional) → verificar"
5
+ argument-hint: "[objetivo em texto livre] [--agents para forçar PDDA]"
6
+ ---
7
+
8
+ Executa o workflow **OXE quick** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
9
+
10
+ `oxe/workflows/quick.md`
11
+
12
+ Usa o texto adicional desta mensagem como objetivo e contexto.
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: oxe-spec
3
3
  agent: agent
4
- description: OXE — Cria ou atualiza .oxe/SPEC.md
5
- argument-hint: "[pedido ou contexto da feature]"
4
+ description: "OXE — Spec em 5 fases: perguntas → pesquisa → requisitos (R-ID v1/v2/fora) → roteiro (.oxe/ROADMAP.md) → aprovação → plan"
5
+ argument-hint: "[descrição da feature ou ideia]"
6
6
  ---
7
7
 
8
8
  Executa o workflow **OXE spec**. Lê e aplica **integralmente**:
@@ -0,0 +1,12 @@
1
+ ---
2
+ name: oxe-workstream
3
+ agent: agent
4
+ description: "OXE — Trilhas paralelas: list, new <nome>, switch <nome>, status, close <nome> — cada trilha tem artefatos independentes em .oxe/workstreams/<nome>/"
5
+ argument-hint: "list | new <nome> | switch <nome> | status | close <nome>"
6
+ ---
7
+
8
+ Executa o workflow **OXE workstream** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
9
+
10
+ `oxe/workflows/workstream.md`
11
+
12
+ Usa o texto adicional desta mensagem como subcomando e contexto.