oxe-cc 0.3.3 → 0.3.5

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,13 @@
+---
+description: "Comando OXE"
+---
+
 ---
-description: OXE — Ajuda (Cursor, Copilot, fluxo e artefatos)
+name: oxe-help
+agent: agent
+description: OXE — Ajuda (Cursor, Copilot, artefatos)
 ---
 
-Lê e executa **integralmente** o workflow em `oxe/workflows/help.md`.
+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,13 @@
+---
+description: "Comando OXE"
+---
+
 ---
-description: OXE — Indica o próximo passo (lê .oxe/STATE.md)
+name: oxe-next
+agent: agent
+description: OXE — Próximo passo (lê STATE.md)
 ---
 
-Lê e executa **integralmente** o workflow em `oxe/workflows/next.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,16 @@
+---
+description: "Comando OXE"
+---
+
 ---
-description: OXE — Gera .oxe/PLAN.md com tarefas e verificação por item
+name: oxe-plan
+agent: agent
+description: OXE — Gera .oxe/PLAN.md com verificação por tarefa
+argument-hint: "[opcional: --replan]"
 ---
 
-Lê e executa **integralmente** o workflow em `oxe/workflows/plan.md`. Se o utilizador pedir replanejamento, inclui `--replan` na intenção.
+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,16 @@
+---
+description: "Comando OXE"
+---
+
+---
+name: oxe-review-pr
+agent: agent
+description: OXE — Revisão de PR (link GitHub, branches ou SHAs)
+argument-hint: "URL ou refs: https://github.com/org/repo/pull/10 | main feature/foo"
+---
+
+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,16 @@
+---
+description: "Comando OXE"
+---
+
 ---
-description: OXE — Escaneia o repo e gera .oxe/codebase/ + STATE.md
+name: oxe-scan
+agent: agent
+description: OXE — Scan do repositório (.oxe/codebase/)
+argument-hint: "[área opcional, ex. api]"
 ---
 
-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`).
+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,16 @@
+---
+description: "Comando OXE"
+---
+
 ---
-description: OXE — Cria ou atualiza .oxe/SPEC.md a partir do pedido
+name: oxe-spec
+agent: agent
+description: OXE — Cria ou atualiza .oxe/SPEC.md
+argument-hint: "[pedido ou contexto da feature]"
 ---
 
-Lê e executa **integralmente** o workflow em `oxe/workflows/spec.md`. Entrada: mensagem do utilizador e ficheiros anexados.
+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-verify.md

@@ -1,5 +1,16 @@
+---
+description: "Comando OXE"
+---
+
 ---
-description: OXE — Valida contra SPEC/PLAN e grava .oxe/VERIFY.md
+name: oxe-verify
+agent: agent
+description: OXE — Valida implementação (.oxe/VERIFY.md)
+argument-hint: "[opcional: Tn]"
 ---
 
-Lê e executa **integralmente** o workflow em `oxe/workflows/verify.md`. Se o utilizador indicar `Tn`, focar essa tarefa.
+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,15 +1,15 @@
 # OXE — fluxo spec-driven (Cursor + Copilot)
 
-Este repositório define o **OXE**: artefatos em `.oxe/` na raiz do projeto alvo e workflows em `oxe/workflows/*.md`.
+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).
 
 ## Quando aplicar
 
-Se o utilizador mencionar **OXE**, **oxe**, **/oxe-**, ou pedidos como “mapear o projeto”, “criar spec OXE”, “plano OXE com testes”, “verificar OXE”, trata como fluxo OXE e segue o ficheiro de workflow correspondente abaixo.
+Se o usuário mencionar **OXE**, **oxe**, **/oxe-**, ou pedidos como “mapear o projeto”, “criar spec OXE”, “plano OXE com testes”, “verificar OXE”, trate como fluxo OXE e siga o arquivo de workflow correspondente abaixo.
 
 ## Workflows (fonte única)
 
-| Passo | Ficheiro | Gatilhos naturais (exemplos) |
-|-------|----------|----------------------------|
+| Passo | Arquivo | Gatilhos naturais (exemplos) |
+|-------|---------|-------------------------------|
 | Scan | `oxe/workflows/scan.md` | “oxe scan”, “mapear o repo”, “atualizar codebase OXE” |
 | Spec | `oxe/workflows/spec.md` | “oxe spec”, “escrever SPEC.md”, “requisitos OXE” |
 | Discuss | `oxe/workflows/discuss.md` | “oxe discuss”, “perguntas antes do plano”, “DISCUSS.md” |
@@ -18,22 +18,43 @@ Se o utilizador mencionar **OXE**, **oxe**, **/oxe-**, ou pedidos como “mapear
 | 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”, “code review OXE” *(prompt: `/oxe-review-pr`)* |
+| 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” |
+| 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:** lê o Markdown indicado e executa **todos** os passos e critérios de sucesso descritos nesse ficheiro. Não atalhes: cria ou atualiza os ficheiros em `.oxe/` conforme o workflow.
+**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 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-*`). 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`**.
+- 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`
-- Templates: `oxe/templates/`
+- `.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 e SDK
+
+- **`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`).
+- **`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`).
 
-## Cursor vs Copilot
+**WSL:** usar Node **nativo do WSL**; o `oxe-cc` recusa Node do Windows dentro do WSL (caminhos incorretos).
 
-- **Cursor:** slash commands em `.cursor/commands/oxe-*.md` apontam para os mesmos workflows.
-- **Copilot (VS Code Chat):** prompt files em `.github/prompts/oxe-*.prompt.md`; cada um indica o workflow em `oxe/workflows/<passo>.md` na raiz do repo. **`oxe-review-pr`** existe só como prompt Copilot (não há slash command Cursor correspondente).
-- **Copilot CLI (terminal, experimental):** com `oxe-cc --copilot-cli`, os mesmos textos são copiados para **`.claude/commands/oxe-*.md`** — versões recentes do CLI podem expor **`/oxe-scan`**, etc. Isto depende da versão do `copilot`; não faz parte do contrato estável do OXE.
+## Manutenção do pacote oxe-build
 
-## Manutenção deste 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, edita primeiro `oxe/workflows/*.md`; mantém comandos Cursor e prompts Copilot alinhados com essa pasta.
+**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/AGENTS.md

@@ -5,8 +5,10 @@ Este repositório empacota o fluxo **OXE** (spec-driven, artefatos em `.oxe/`).
 - **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`).
-- **CLI:** `oxe-cc` instala assets e bootstrap (`.oxe/STATE.md`, `config.json`, `codebase/`); `oxe-cc doctor` valida workflows, JSON de config e mapa scan; `oxe-cc init-oxe` só inicializa `.oxe/`.
+- **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/`.
+- **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-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.
+- **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.