oxe-cc 0.3.8 → 0.3.9
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.
- package/.cursor/commands/oxe-checkpoint.md +2 -0
- package/.cursor/commands/oxe-compact.md +2 -0
- package/.cursor/commands/oxe-debug.md +2 -0
- package/.cursor/commands/oxe-discuss.md +2 -0
- package/.cursor/commands/oxe-execute.md +2 -0
- package/.cursor/commands/oxe-forensics.md +2 -0
- package/.cursor/commands/oxe-help.md +2 -0
- package/.cursor/commands/oxe-next.md +2 -0
- package/.cursor/commands/oxe-plan-agent.md +2 -0
- package/.cursor/commands/oxe-plan.md +2 -0
- package/.cursor/commands/oxe-quick.md +2 -0
- package/.cursor/commands/oxe-research.md +2 -0
- package/.cursor/commands/oxe-review-pr.md +2 -0
- package/.cursor/commands/oxe-route.md +2 -0
- package/.cursor/commands/oxe-scan.md +2 -0
- package/.cursor/commands/oxe-spec.md +2 -0
- package/.cursor/commands/oxe-ui-review.md +2 -0
- package/.cursor/commands/oxe-ui-spec.md +2 -0
- package/.cursor/commands/oxe-update.md +2 -0
- package/.cursor/commands/oxe-validate-gaps.md +2 -0
- package/.cursor/commands/oxe-verify.md +2 -0
- package/bin/banner.txt +1 -1
- package/oxe/templates/CONFIG.md +4 -0
- package/oxe/templates/plan-agent-messages-README.template.md +1 -1
- package/oxe/workflows/plan-agent.md +1 -1
- package/oxe/workflows/references/plan-agent-chat-protocol.md +14 -0
- package/oxe/workflows/verify.md +1 -0
- package/package.json +1 -1
|
@@ -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 — 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)
|
|
@@ -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 — 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)
|
|
@@ -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`
|
package/bin/banner.txt
CHANGED
package/oxe/templates/CONFIG.md
CHANGED
|
@@ -28,6 +28,10 @@ Copie `oxe/templates/config.template.json` para **`.oxe/config.json`** no seu pr
|
|
|
28
28
|
|
|
29
29
|
Use `npx oxe-cc --no-install-config` para ignorar este bloco numa instalação.
|
|
30
30
|
|
|
31
|
+
### Plan-agent, arquivo e Git
|
|
32
|
+
|
|
33
|
+
**`.oxe/plan-agents.json`** e **`.oxe/plan-agent-messages/`** são artefactos de trabalho durante a trilha **plan → execute → verify**. Após verify com sucesso, o fluxo OXE **recomenda** arquivar em **`.oxe/archive/plan-agent-runs/<runId>/`** (mensagens + cópia do JSON) para limpar a raiz de `.oxe/` — ver **`oxe/workflows/references/plan-agent-chat-protocol.md`**. Não há chave em `config.json` para isto; é passo manual ou proposto pelo agente em **`verify`**. Se não quiser versionar handoffs, pode adicionar **`.oxe/archive/plan-agent-runs/`** ou **`.oxe/plan-agent-messages/`** ao **`.gitignore`** do projeto (perde histórico no Git).
|
|
34
|
+
|
|
31
35
|
Chaves desconhecidas são listadas como aviso no `doctor` / `status`. Valores em falta usam o mesmo significado que no template (omissões seguras).
|
|
32
36
|
|
|
33
37
|
### Exemplo: repositório legado (COBOL / JCL / copybooks / VB6 / SQL)
|
|
@@ -6,4 +6,4 @@ Esta pasta guarda handoffs entre agentes do blueprint **`.oxe/plan-agents.json`*
|
|
|
6
6
|
- O campo **`runId`** no frontmatter deve coincidir com o de `plan-agents.json`
|
|
7
7
|
- Não editar mensagens depois de criadas; invalidação do blueprint (`lifecycle.invalidated`) encerra novos envios
|
|
8
8
|
|
|
9
|
-
Gerado por **`/oxe-plan-agent`**.
|
|
9
|
+
Gerado por **`/oxe-plan-agent`**. Após **`/oxe-verify`** com sucesso e blueprint **`closed`**, o fluxo OXE **recomenda** mover este conteúdo para **`.oxe/archive/plan-agent-runs/<runId>/messages/`** (ver **`oxe/workflows/references/plan-agent-chat-protocol.md`**). Antes de um **replan** com novo `runId`, arquivar o run anterior se quiser preservar handoffs.
|
|
@@ -10,7 +10,7 @@ O plano **não** é só uma lista de tarefas: cada agente é um **pacote de cont
|
|
|
10
10
|
|
|
11
11
|
**Exclusividade:** os papéis definidos no JSON são **efémeros** e **exclusivos** da trilha PLAN + **`/oxe-execute`** com este `runId`. **`/oxe-quick`** ou trabalho fora do `PLAN.md` **não** reutilizam estes agentes (ver **`quick.md`**, **`execute.md`**, referência **`references/plan-agent-chat-protocol.md`**).
|
|
12
12
|
|
|
13
|
-
Se o utilizador pedir **`--replan`**: aplicar a mesma lógica de replanejamento descrita em **`plan.md`** (VERIFY, SUMMARY, secção Replanejamento) e **atualizar ou recriar** `plan-agents.json` em coerência com o novo `PLAN.md`; gerar **novo** `runId` e repor `lifecycle.status` → `pending_execute
|
|
13
|
+
Se o utilizador pedir **`--replan`**: aplicar a mesma lógica de replanejamento descrita em **`plan.md`** (VERIFY, SUMMARY, secção Replanejamento) e **atualizar ou recriar** `plan-agents.json` em coerência com o novo `PLAN.md`; gerar **novo** `runId` e repor `lifecycle.status` → `pending_execute`. Se ainda existir pasta **`.oxe/plan-agent-messages/`** cheia do **run** anterior e o utilizador não precisar dela na raiz, **arquivar** primeiro em **`.oxe/archive/plan-agent-runs/<runId-antigo>/`** (ver **`references/plan-agent-chat-protocol.md`**) ou pedir confirmação antes de sobrescrever; depois recriar **`.oxe/plan-agent-messages/README.md`** para o novo `runId`.
|
|
14
14
|
</objective>
|
|
15
15
|
|
|
16
16
|
<context>
|
|
@@ -78,6 +78,20 @@ Opcional: **`taskIds`** — subset das tarefas que esta mensagem cobre.
|
|
|
78
78
|
- **`/oxe-quick`** invalida o blueprint (`invalidatedBy: quick`); não reutilizar papéis do JSON no fluxo quick.
|
|
79
79
|
- Trabalho **fora** do conjunto de `Tn` do `PLAN.md`: não assumir persona do blueprint; opcionalmente pedir confirmação para invalidar (`invalidatedBy: out_of_scope`).
|
|
80
80
|
|
|
81
|
+
## Artefactos no repositório após fecho (recomendação OXE)
|
|
82
|
+
|
|
83
|
+
Durante a trilha ativa, **`plan-agents.json`** e **`.oxe/plan-agent-messages/`** na raiz de `.oxe/` são práticos (caminhos estáveis para **`/oxe-execute`**). Depois de **`lifecycle.closed`** (tipicamente após **`/oxe-verify`** com sucesso), estes ficheiros **deixam de ser necessários** para o dia a dia e **poluem** o explorador e o `git status` se ficarem sempre na raiz.
|
|
84
|
+
|
|
85
|
+
**Recomendação (equilíbrio entre limpeza e auditoria):**
|
|
86
|
+
|
|
87
|
+
1. **Arquivar por sessão (`runId`), não apagar** — Move-se o histórico para **`.oxe/archive/plan-agent-runs/<runId>/`**:
|
|
88
|
+
- **`messages/`** — todo o conteúdo actual de **`.oxe/plan-agent-messages/`** excepto um `README.md` de índice opcional (ou mover também o README antigo para dentro do arquivo).
|
|
89
|
+
- **`plan-agents.json`** — cópia final do blueprint **no momento do fecho** (o JSON na raiz `.oxe/` pode ser **removido** após cópia, ou substituído por um stub mínimo só se outra ferramenta exigir o path; o normal é remover da raiz após arquivo).
|
|
90
|
+
2. **Não commitar ruído sem querer** — Quem preferir **não** versionar handoffs: adicionar **`.oxe/archive/plan-agent-runs/`** ou **`.oxe/plan-agent-messages/`** ao **`.gitignore`** do projeto (trade-off: perde-se histórico no Git).
|
|
91
|
+
3. **Pastas por sessão desde o primeiro dia** (alternativa maior) — **`.oxe/plan-agent-runs/<runId>/messages/`** + **`plan-agents.json`** dentro da mesma pasta, com um **`plan-agents.active`** ou entrada em **STATE** a apontar o `runId` corrente. Exige alterar todos os workflows e o mental model dos agentes; reserve-se para uma evolução do pacote se a raiz `.oxe/` tiver de ficar sempre mínima.
|
|
92
|
+
|
|
93
|
+
**Resumo:** para o fluxo OXE actual, **arquivar em `.oxe/archive/plan-agent-runs/<runId>/` após verify OK** é a forma mais simples de “não precisarem mais existir na raiz” sem perder rastreabilidade. Apagar em massa só com **confirmação explícita** do utilizador.
|
|
94
|
+
|
|
81
95
|
## Ver também
|
|
82
96
|
|
|
83
97
|
- [`oxe/workflows/plan-agent.md`](../plan-agent.md)
|
package/oxe/workflows/verify.md
CHANGED
|
@@ -29,6 +29,7 @@ Se o usuário indicar uma tarefa (ex.: `T2`), focar só nela; caso contrário, p
|
|
|
29
29
|
- **Gaps** — o que falhou e sugestão de correção (pode virar novas entradas no PLAN); se não houver, escrever explicitamente `Nenhum gap restante` ou equivalente.
|
|
30
30
|
5. Atualizar **`.oxe/STATE.md`**: `verify_complete` ou `verify_failed` + próximo passo (replan, corrigir ou publicar).
|
|
31
31
|
5b. **Blueprint plan-agent:** se **todas** as verificações relevantes **passaram**, existir **`.oxe/plan-agents.json`** com `oxePlanAgentsSchema === 2` e `lifecycle.status === "executing"` (ou `pending_execute` se ainda não houve execute formal mas a trilha fechou aqui), actualizar o JSON: `lifecycle: { "status": "closed", "since": "<ISO>" }` e espelhar em **`STATE.md`** (**lifecycle_status** → `closed`). Não fechar como `closed` se `verify_failed` ou gaps por resolver.
|
|
32
|
+
5c. **Arquivo plan-agent (opcional, recomendado após fecho com sucesso):** se o passo **5b** marcou o blueprint como **`closed`** e existem **`.oxe/plan-agent-messages/`** (com mensagens) ou **`plan-agents.json`** na raiz `.oxe/`, propor ao utilizador **arquivar** em **`.oxe/archive/plan-agent-runs/<runId>/`** conforme **`oxe/workflows/references/plan-agent-chat-protocol.md`** (secção *Artefactos no repositório após fecho*): subpasta **`messages/`** com os handoffs, cópia de **`plan-agents.json`**, depois **esvaziar** **`.oxe/plan-agent-messages/`** (ou recriar só `README.md` a partir do template) e **remover** **`.oxe/plan-agents.json`** da raiz se já estiver copiado no arquivo. Se o utilizador preferir **manter** tudo na raiz para um PR único, respeitar — o protocolo trata o arquivo como **recomendação**, não obrigatório do gate de verify.
|
|
32
33
|
6. Acrescentar entrada em **`.oxe/SUMMARY.md`** (sessão): se não existir, criar a partir de **`oxe/templates/SUMMARY.template.md`**. **Obrigatório** quando `verify_failed` ou quando a seção **Gaps** tiver itens — isso alimenta o replanejamento.
|
|
33
34
|
7. **Só se todas as verificações relevantes passarem:** se `after_verify_draft_commit` não for `false`: acrescentar em **VERIFY.md** a seção **Rascunho de commit** — mensagem convencional (ex.: `feat:` / `fix:`) + bullets alinhados aos critérios **A***; **não** incluir segredos.
|
|
34
35
|
8. **Só se passou:** se `after_verify_suggest_pr` não for `false`: acrescentar **Checklist PR** — branch base, título sugerido, screenshots se UI, links a SPEC/PLAN, testes executados.
|
package/package.json
CHANGED