oxe-cc 0.3.4 → 0.3.6

package/.cursor/commands/oxe-discuss.md

@@ -1,5 +1,7 @@
 ---
-description: OXE — Discussão antes do plano (.oxe/DISCUSS.md)
+description: "OXE — Discussão antes do plano"
 ---
 
-Lê e executa **integralmente** o workflow em `oxe/workflows/discuss.md` na raiz do workspace. Usa o texto extra do utilizador como contexto ou respostas a perguntas pendentes.
+Executa o workflow **OXE discuss** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+
+`oxe/workflows/discuss.md`

package/.cursor/commands/oxe-execute.md

@@ -1,5 +1,9 @@
 ---
-description: OXE — Executar onda do PLAN ou passos do QUICK
+description: "OXE — Executar onda do PLAN ou passos do QUICK"
 ---
 
-Lê e executa **integralmente** o workflow em `oxe/workflows/execute.md` na raiz do workspace. Se o utilizador indicar uma onda ou tarefas (ex. “onda 2”, “T3”), usa esse foco.
+Executa o workflow **OXE execute** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+
+`oxe/workflows/execute.md`
+
+Usa o texto adicional desta mensagem como foco (onda, tarefa Tn, ou confirmação de progresso).

package/.cursor/commands/oxe-help.md

@@ -1,5 +1,7 @@
----
-description: OXE — Ajuda (Cursor, Copilot, fluxo e artefatos)
----
-
-Lê e executa **integralmente** o workflow em `oxe/workflows/help.md`.
+---
+description: "OXE — Ajuda (fluxo .oxe/, várias IDEs e CLIs, artefatos)"
+---
+
+Executa o workflow **OXE help**. Lê e segue **integralmente**:
+
+`oxe/workflows/help.md` (na raiz do repositório em contexto)

package/.cursor/commands/oxe-next.md

@@ -1,5 +1,7 @@
----
-description: OXE — Indica o próximo passo (lê .oxe/STATE.md)
----
-
-Lê e executa **integralmente** o workflow em `oxe/workflows/next.md`.
+---
+description: "OXE — Próximo passo (lê STATE.md)"
+---
+
+Executa o workflow **OXE next**. Lê e aplica **integralmente**:
+
+`oxe/workflows/next.md` (na raiz do repositório em contexto)

package/.cursor/commands/oxe-plan.md

@@ -1,5 +1,9 @@
----
-description: OXE — Gera .oxe/PLAN.md com tarefas e verificação por item
----
-
-Lê e executa **integralmente** o workflow em `oxe/workflows/plan.md`. Se o utilizador pedir replanejamento, inclui `--replan` na intenção.
+---
+description: "OXE — Gera .oxe/PLAN.md com verificação por tarefa"
+---
+
+Executa o workflow **OXE plan**. Lê e aplica **integralmente**:
+
+`oxe/workflows/plan.md` (na raiz do repositório em contexto)
+
+Se o utilizador pedir replanejamento, trata como `--replan` conforme o workflow.

package/.cursor/commands/oxe-quick.md

@@ -1,5 +1,9 @@
 ---
-description: OXE — Modo rápido (.oxe/QUICK.md + STATE)
+description: "OXE — Modo rápido (.oxe/QUICK.md)"
 ---
 
-Lê e executa **integralmente** o workflow em `oxe/workflows/quick.md` na raiz do workspace. Usa qualquer texto extra do utilizador como objetivo e contexto.
+Executa o workflow **OXE quick** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+
+`oxe/workflows/quick.md`
+
+Usa o texto adicional desta mensagem como objetivo e contexto.

package/.cursor/commands/oxe-review-pr.md

@@ -0,0 +1,9 @@
+---
+description: "OXE — Revisão de PR (link GitHub, branches ou SHAs)"
+---
+
+Executa o workflow **OXE review-pr**. Lê e aplica **integralmente**:
+
+`oxe/workflows/review-pr.md` (na raiz do repositório em contexto)
+
+**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).

package/.cursor/commands/oxe-scan.md

@@ -1,5 +1,9 @@
----
-description: OXE — Escaneia o repo e gera .oxe/codebase/ + STATE.md
----
-
-Lê e executa **integralmente** o workflow em `oxe/workflows/scan.md` na raiz do workspace. Usa qualquer texto extra do utilizador como foco opcional de área (ex. `api`).
+---
+description: "OXE — Scan do repositório (.oxe/codebase/)"
+---
+
+Executa o workflow **OXE scan** no repositório atual. Lê e aplica **integralmente** o ficheiro:
+
+`oxe/workflows/scan.md` (na raiz do repositório em contexto)
+
+Usa o texto adicional desta mensagem como foco opcional de área (pastas/módulos).

package/.cursor/commands/oxe-spec.md

@@ -1,5 +1,9 @@
----
-description: OXE — Cria ou atualiza .oxe/SPEC.md a partir do pedido
----
-
-Lê e executa **integralmente** o workflow em `oxe/workflows/spec.md`. Entrada: mensagem do utilizador e ficheiros anexados.
+---
+description: "OXE — Cria ou atualiza .oxe/SPEC.md"
+---
+
+Executa o workflow **OXE spec**. Lê e aplica **integralmente**:
+
+`oxe/workflows/spec.md` (na raiz do repositório em contexto)
+
+Usa o resto desta mensagem e ficheiros anexados como entrada do utilizador.

package/.cursor/commands/oxe-update.md

@@ -0,0 +1,9 @@
+---
+description: "Atualizar oxe-cc no projeto — verificar versão no npm, alinhar ficheiros OXE e validar com doctor"
+---
+
+Executa o workflow **OXE update**. Lê e segue **integralmente**:
+
+`oxe/workflows/update.md` (na raiz do repositório em contexto; ou `.oxe/workflows/update.md` se a instalação aninhou os workflows)
+
+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`**.

package/.cursor/commands/oxe-verify.md

@@ -1,5 +1,9 @@
----
-description: OXE — Valida contra SPEC/PLAN e grava .oxe/VERIFY.md
----
-
-Lê e executa **integralmente** o workflow em `oxe/workflows/verify.md`. Se o utilizador indicar `Tn`, focar essa tarefa.
+---
+description: "OXE — Valida implementação (.oxe/VERIFY.md)"
+---
+
+Executa o workflow **OXE verify**. Lê e aplica **integralmente**:
+
+`oxe/workflows/verify.md` (na raiz do repositório em contexto)
+
+Se o utilizador indicar uma tarefa `Tn`, restringe a verificação a essa tarefa.

package/.github/copilot-instructions.md

@@ -1,6 +1,6 @@
-# OXE — fluxo spec-driven (Cursor + Copilot)
+# OXE — fluxo spec-driven (multi-IDE / multi-CLI)
 
-Este repositório (ou o pacote **oxe-cc** instalado) define o **OXE**: artefatos em **`.oxe/`** na raiz do projeto alvo e workflows em **`oxe/workflows/*.md`** ou **`.oxe/workflows/*.md`**, conforme a instalação.
+Este repositório (ou o pacote **oxe-cc** instalado) define o **OXE**: artefatos em **`.oxe/`** na raiz do projeto alvo e workflows em **`oxe/workflows/*.md`** (no pacote) ou **`.oxe/workflows/*.md`** / **`oxe/workflows/*.md`** no projeto, conforme a instalação (layout mínimo vs clássico). O fluxo é **agnóstico de ferramenta**; **Cursor** e **GitHub Copilot** são o caminho padrão mais conhecido, mas o mesmo OXE pode ser instalado em **Claude Code, OpenCode, Gemini CLI, Codex, Windsurf, Antigravity** e outras integrações via `oxe-cc --all-agents` (ou flags por runtime).
 
 ## Quando aplicar
 
@@ -18,27 +18,45 @@ Se o usuário mencionar **OXE**, **oxe**, **/oxe-**, ou pedidos como “mapear o
 | Execute | `oxe/workflows/execute.md` | “oxe execute”, “executar onda”, “onda 2 OXE” |
 | Verify | `oxe/workflows/verify.md` | “oxe verify”, “validar plano OXE”, “VERIFY.md” |
 | Next | `oxe/workflows/next.md` | “oxe next”, “próximo passo OXE” |
-| Review PR | `oxe/workflows/review-pr.md` | “revisar PR”, link `…/pull/10`, “diff entre branches” *(prompt: `/oxe-review-pr` no Copilot)* |
+| Review PR | `oxe/workflows/review-pr.md` | “revisar PR”, link `…/pull/10`, “diff entre branches” *(prompt Copilot: `/oxe-review-pr`)* |
 | Help | `oxe/workflows/help.md` | “oxe help”, “como usar OXE” |
+| Update | `oxe/workflows/update.md` | “oxe update”, “atualizar oxe-cc”, “há versão nova no npm” *(prompt: `/oxe-update`)* |
+| Autoria de workflow | `oxe/workflows/workflow-authoring.md` | “rever workflow OXE”, “revisar `oxe/workflows/foo.md` contra o guia”, alinhar passo ao `WORKFLOW_AUTHORING.md` |
 
 **Regra:** leia o Markdown indicado e execute **todos** os passos e critérios de sucesso descritos nesse arquivo. Não atalhe: crie ou atualize os arquivos em `.oxe/` conforme o workflow.
 
+**Cursor:** há slash `/oxe-*` para scan…help e **`/oxe-update`** em `~/.cursor/commands/`; **não** há comando slash dedicado a review-pr no Cursor — use linguagem natural + `oxe/workflows/review-pr.md` em contexto.
+
 ## Onde ficam as integrações (após `npx oxe-cc`)
 
-- **Cursor:** comandos em **`~/.cursor/commands/`** (slash `/oxe-*`).
-- **GitHub Copilot (VS Code):** instruções mescladas em **`~/.copilot/copilot-instructions.md`** (bloco OXE) e **prompt files** em **`~/.copilot/prompts/`** (`oxe-*.prompt.md`). **Não** espere `.github/prompts/` no repositório do projeto para o Copilot — o instalador usa a pasta do **usuário**, alinhado ao GSD.
-- **Copilot CLI (experimental):** com `oxe-cc --copilot-cli`, textos também em **`~/.claude/commands/`** e **`~/.copilot/commands/`** — depende da versão do CLI.
+- **Cursor:** comandos em **`~/.cursor/commands/`** (slash `/oxe-*`). Diretório alternativo: variável **`CURSOR_CONFIG_DIR`**.
+- **GitHub Copilot (VS Code):** instruções mescladas em **`~/.copilot/copilot-instructions.md`** (bloco OXE) e **prompt files** em **`~/.copilot/prompts/`** (`oxe-*.prompt.md`). **Não** espere `.github/prompts/` no repositório do projeto para o Copilot — o instalador usa **`~/.copilot/`** (`COPILOT_CONFIG_DIR` / `COPILOT_HOME` se definidos).
+- **Copilot CLI:** com `oxe-cc --copilot-cli`, use **agent skills** em **`~/.copilot/skills/`** (`/oxe`, `/oxe-scan`, …). Depois de instalar: **`/skills reload`**. Pastas **`~/.claude/commands/`** e **`~/.copilot/commands/`** são cópia legado; **`CLAUDE_CONFIG_DIR`** altera o home Claude.
+- **Multi-agente:** `oxe-cc --all-agents` (menu **6**) replica fluxos para **OpenCode**, **Gemini CLI** (`/commands reload`), **Codex**, **Windsurf**, **Antigravity**, além de Cursor/Copilot/Claude. **`XDG_CONFIG_HOME`** / **`CODEX_HOME`** afetam caminhos canónicos desses destinos. O núcleo no repo continua **`.oxe/`** (SPEC/PLAN/VERIFY em Markdown).
+
+## Configuração do projeto
+
+- **`.oxe/config.json`**: fluxo (`discuss_before_plan`, `scan_max_age_days`, `spec_required_sections`, …) e opcionalmente **`install`** (perfil e layout quando o utilizador corre o instalador **sem** flags IDE explícitas). Referência: `oxe/templates/CONFIG.md`. Para ignorar o bloco `install` numa corrida: **`--no-install-config`**.
+- **Legado / brownfield** (COBOL, JCL, copybooks, VB6, SQL procedures): seguir também `oxe/workflows/references/legacy-brownfield.md` quando o repo ou o pedido indicar mainframe ou desktop legado — scan preenche os sete ficheiros sem assumir Node; plan/verify aceitam evidência por Grep/leitura/checklist.
+- Sem TTY (CI): **`OXE_NO_PROMPT=1`** — padrões de layout/integração; o ficheiro `install` em `config.json` aplica-se se existir e as flags não sobrepuserem.
 
 ## Artefatos
 
-- `.oxe/STATE.md`, `.oxe/config.json` (opcional), `.oxe/codebase/*.md`, `.oxe/SPEC.md`, `.oxe/DISCUSS.md` (opcional), `.oxe/PLAN.md`, `.oxe/VERIFY.md`, `.oxe/QUICK.md`, `.oxe/SUMMARY.md`
+- `.oxe/STATE.md`, `.oxe/config.json` (opcional), `.oxe/codebase/*.md`, `.oxe/SPEC.md`, `.oxe/DISCUSS.md` (opcional), `.oxe/PLAN.md`, `.oxe/VERIFY.md`, `.oxe/QUICK.md`, `.oxe/SUMMARY.md` (opcional)
 - Templates: `oxe/templates/` (ou `.oxe/templates/` em layout aninhado)
 
-## CLI útil
+## CLI e SDK
 
-- **`npx oxe-cc doctor`** — validação completa (workflows do pacote, `config.json`, mapas, coerência STATE).
-- **`npx oxe-cc status`** — um único próximo passo sugerido + coerência `.oxe/`.
+- **`npx oxe-cc`** ou **`npx oxe-cc install`** — instalação (equivalentes).
+- **`npx oxe-cc doctor`** — validação completa (Node, workflows do pacote vs projeto, JSON, coerência STATE, regras SPEC/PLAN, **avisos** não bloqueantes sobre estrutura dos `.md` de workflow quando aplicável).
+- **`npx oxe-cc status`** — mais leve: coerência `.oxe/` + **um** próximo passo (não exige o mesmo rigor de workflows que o `doctor`). **`status --json`**: saída máquina-legível para CI (`nextStep`, `diagnostics`, …).
+- **`npx oxe-cc init-oxe`**, **`uninstall`**, **`update`** — ver `oxe-cc --help` ou README do pacote.
+- **SDK (Node):** `require('oxe-cc')` expõe `runDoctorChecks`, `health`, `workflows`, `install`, `manifest`, `agents` — útil para CI (`lib/sdk/README.md`, `lib/sdk/index.d.ts`).
+
+**WSL:** usar Node **nativo do WSL**; o `oxe-cc` recusa Node do Windows dentro do WSL (caminhos incorretos).
 
 ## Manutenção do pacote oxe-build
 
-Ao alterar comportamento OXE, edite primeiro **`oxe/workflows/*.md`**; mantenha comandos Cursor e prompts Copilot alinhados a essa pasta.
+Ao alterar comportamento OXE, edite primeiro **`oxe/workflows/*.md`**; mantenha prompts em **`.github/prompts/`** e comandos Cursor gerados pelo sync alinhados a essa pasta (e as integrações multi-agente coerentes com `oxe-agent-install.cjs`).
+
+**Autoria de workflows:** guia em **`oxe/templates/WORKFLOW_AUTHORING.md`**. Para rever um `.md` de passo contra o guia, use o workflow **`oxe/workflows/workflow-authoring.md`** (ou `.oxe/workflows/` no projeto alvo).

package/.github/prompts/oxe-help.prompt.md

@@ -1,7 +1,7 @@
 ---
 name: oxe-help
 agent: agent
-description: OXE — Ajuda (Cursor, Copilot, artefatos)
+description: OXE — Ajuda (fluxo .oxe/, várias IDEs e CLIs, artefatos)
 ---
 
 Executa o workflow **OXE help**. Lê e segue **integralmente**:

package/.github/prompts/oxe-update.prompt.md

@@ -0,0 +1,11 @@
+---
+name: oxe-update
+agent: agent
+description: Atualizar oxe-cc no projeto — verificar versão no npm, alinhar ficheiros OXE e validar com doctor
+---
+
+Executa o workflow **OXE update**. Lê e segue **integralmente**:
+
+`oxe/workflows/update.md` (na raiz do repositório em contexto; ou `.oxe/workflows/update.md` se a instalação aninhou os workflows)
+
+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`**.

package/.github/workflows/ci.yml

@@ -1,18 +1,20 @@
-name: CI
-
-on:
-  push:
-    branches: [main, master]
-  pull_request:
-    branches: [main, master]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-      - run: npm test
-      - run: npm run scan:assets
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+      - run: npm ci
+      - run: npm test
+      - run: npm run scan:assets

package/AGENTS.md

@@ -1,12 +1,14 @@
-# OXE — agentes (GitHub Copilot / compatível)
+# OXE — agentes (multi-IDE / multi-CLI)
 
-Este repositório empacota o fluxo **OXE** (spec-driven, artefatos em `.oxe/`).
+Este repositório empacota o fluxo **OXE** (spec-driven, artefatos em `.oxe/`). O núcleo é agnóstico; o **`oxe-cc`** integra com **várias IDEs e CLIs** (Cursor e GitHub Copilot como caminho padrão conhecido, mais Claude, OpenCode, Gemini, Codex, Windsurf, Antigravity quando instalado com **`--all-agents`** ou flags granulares).
 
 - **npm:** o nome do pacote é **`oxe-cc`** (`npx oxe-cc@latest` quando estiver publicado; se `npm view oxe-cc` der 404, usar `npm link` a partir deste repo ou `node bin/oxe-cc.js`).
-- **Instruções do repositório:** [.github/copilot-instructions.md](.github/copilot-instructions.md) — aplicadas automaticamente no Copilot Chat quando o repo está em contexto.
-- **Workflows canónicos:** [oxe/workflows/](oxe/workflows/) — editar aqui primeiro; Cursor e Copilot apontam para estes ficheiros (inclui `quick.md`, `execute.md`).
+- **Workflows canónicos:** [oxe/workflows/](oxe/workflows/) — editar aqui primeiro; todas as integrações apontam para estes ficheiros (inclui `quick.md`, `execute.md`). Referência **legado / brownfield:** [oxe/workflows/references/legacy-brownfield.md](oxe/workflows/references/legacy-brownfield.md) (COBOL, JCL, copybooks, VB6, SP).
+- **Instruções do repositório:** [.github/copilot-instructions.md](.github/copilot-instructions.md) — aplicadas automaticamente no **GitHub Copilot Chat** quando o repo está em contexto (outras ferramentas usam os seus próprios homes após `oxe-cc install`).
 - **CLI:** `oxe-cc` instala assets e bootstrap (`.oxe/STATE.md`, `config.json`, `codebase/`); `oxe-cc doctor` valida workflows, JSON de config, coerência STATE vs artefatos e regras opcionais de SPEC/PLAN; `oxe-cc status` mostra coerência `.oxe/` e **um** próximo passo; `oxe-cc init-oxe` só inicializa `.oxe/`.
-- **Prompt files (Copilot / VS Code):** [.github/prompts/*.prompt.md](.github/prompts/) — invocar com `/` no chat (ex. `/oxe-scan`, `/oxe-review-pr` para diff tipo PR) após `chat.promptFiles` estar ativo.
-- **Copilot CLI (experimental):** `oxe-cc --copilot-cli` → `.claude/commands/oxe-*.md` para testar `/oxe-scan` no terminal.
+- **SDK:** `require('oxe-cc')` expõe `runDoctorChecks`, `health`, `workflows`, `install`, `manifest`, `agents` — ver [lib/sdk/README.md](lib/sdk/README.md).
+- **Prompt files (Copilot / VS Code):** [.github/prompts/*.prompt.md](.github/prompts/) — invocar com `/` no chat (ex. `/oxe-scan`, `/oxe-update`, `/oxe-review-pr` para diff tipo PR) após `chat.promptFiles` estar ativo.
+- **Copilot CLI:** `oxe-cc --copilot-cli` → skills em **`~/.copilot/skills/`** (`/oxe`, `/oxe-scan`, …); após instalar use **`/skills reload`**. Cópia extra em `~/.claude/commands/` para compatibilidade.
+- **Multi-agente:** `oxe-cc --all-agents` replica comandos/skills nos homes de **OpenCode**, **Gemini**, **Codex**, **Windsurf**, **Antigravity** (além de Cursor, Copilot, Claude); ver `README.md` e `bin/lib/oxe-agent-install.cjs`.
 
 Quando o utilizador pedir uma etapa OXE por linguagem natural, segue o ficheiro `oxe/workflows/<passo>.md` correspondente sem atalhar passos.