oxe-cc 1.4.0 → 1.4.1

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

@@ -41,8 +41,10 @@ oxe_semantics_hash: 14ddb483209b28b3
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE execute** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/execute.md`
+**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.
 
-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).
+<!-- oxe-workflow-resolution:end -->
+
+Usa o texto adicional desta mensagem como foco: `A` (Completo), `B` (Por onda), `C` (Por tarefa), `onda N`, `Tn`, ou confirmação de progresso.

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: a9461a0a5c59fa8d
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE forensics** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/forensics.md`
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como contexto do sintoma (falha de verify, doctor, estado incoerente).

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

@@ -37,6 +37,10 @@ oxe_semantics_hash: e292f28e042fbaa5
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE help**. Lê e segue **integralmente**:
+<!-- oxe-workflow-resolution:start -->
+
+**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.
+
+<!-- oxe-workflow-resolution:end -->
+
 
-`.oxe/workflows/help.md` (na raiz do repositório em contexto)

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: ebbadaede8629bea
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE loop** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/loop.md`
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 `$ARGUMENTS` = onda alvo e máximo de tentativas (ex.: `onda 2 max:5`). Pré-requisito: `.oxe/PLAN.md`.

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: 8a7c3e675d6a4e36
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE milestone** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/milestone.md`
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como subcomando e contexto.

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

@@ -37,6 +37,10 @@ oxe_semantics_hash: 5767434e94769645
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE next**. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
+
+**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.
+
+<!-- oxe-workflow-resolution:end -->
+
 
-`.oxe/workflows/next.md` (na raiz do repositório em contexto)

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: ef2faec6af3a4964
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE obs** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/obs.md`
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como a observação a registrar.

package/.github/prompts/oxe-plan-agent.prompt.md

@@ -36,8 +36,10 @@ oxe_semantics_hash: a8f516ec17603d26
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE plan-agent**. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/plan-agent.md` (na raiz do repositório em contexto)
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Se o utilizador pedir replanejamento, trata como **`--replan`** conforme o workflow.

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: 7809d830a5f5ff4a
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE plan**. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/plan.md` (na raiz do repositório em contexto)
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Se o utilizador pedir replanejamento, trata como `--replan` conforme o workflow.

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: 7f329aace340b533
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE project** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/project.md`
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 `$ARGUMENTS` = subcomando: `milestone new|complete|status|audit`, `workstream new|switch|list|close <nome>`, `checkpoint [slug]`, ou vazio para status atual.

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: 2193373eb2691e0d
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE quick** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/quick.md`
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como objetivo e contexto.

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: 6c3005eec893f1b7
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE research** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/research.md`
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como âmbito (paths, perguntas, spike, mapa de sistema, engenharia reversa ou modernização).

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: 5a2fb7b4988f3de6
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE retro** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/retro.md`
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Lê VERIFY.md, FORENSICS.md, SUMMARY.md. `$ARGUMENTS` = contexto extra opcional.

package/.github/prompts/oxe-review-pr.prompt.md

@@ -38,8 +38,10 @@ oxe_semantics_hash: 836780b0831671b7
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE review-pr**. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/review-pr.md` (na raiz do repositório em contexto)
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 **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/.github/prompts/oxe-route.prompt.md

@@ -38,8 +38,10 @@ oxe_semantics_hash: 17b5078ffaad8644
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE route** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/route.md`
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como intenção a classificar (tabela Router em `help.md`).

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: c7c6e28ef92595b1
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE scan** no repositório atual. Lê e aplica **integralmente** o ficheiro:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/scan.md` (na raiz do repositório em contexto)
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como foco opcional de área (pastas/módulos).

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: 0addcd00818ddee2
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE security** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/security.md`
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Lê `.oxe/codebase/STACK.md` para determinar categorias OWASP aplicáveis. `$ARGUMENTS` = foco opcional.

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: df52e7982aeabf21
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE session** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/session.md`
+**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.
 
-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).
+<!-- oxe-workflow-resolution:end -->
+
+Usa o texto adicional desta mensagem como foco do subcomando: `new <nome>`, `list`, `switch <id>`, `resume <id>`, `status`, `close` ou `migrate <nome>`.

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: 4a5d304e6ca781fc
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE ship**. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/ship.md` (na raiz do repositório em contexto)
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa `$ARGUMENTS` como flags de entrega (`--message`, `--amend`, `--verify-first`, `--no-checks`, `--dry-run`).

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: 3cfb16d4930b8a59
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE skill** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/skill.md`
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como subcomando ou invocação de skill.

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: eea8766eab635c97
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE spec**. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/spec.md` (na raiz do repositório em contexto)
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o resto desta mensagem e ficheiros anexados como entrada do utilizador.

package/.github/prompts/oxe-ui-review.prompt.md

@@ -38,8 +38,10 @@ oxe_semantics_hash: 262a73b77bf68d6d
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE ui-review** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/ui-review.md`
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como ficheiros ou tarefas a rever.

package/.github/prompts/oxe-ui-spec.prompt.md

@@ -38,8 +38,10 @@ oxe_semantics_hash: 5c8a7668f0a9fca1
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE ui-spec** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/ui-spec.md`
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como foco de ecrãs ou componentes, se houver.

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

@@ -37,8 +37,10 @@ oxe_semantics_hash: afa0ff72a118df58
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE update**. Lê e segue **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/update.md` (na raiz do repositório em contexto; ou `..oxe/workflows/update.md` se a instalação aninhou os workflows)
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 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/prompts/oxe-validate-gaps.prompt.md

@@ -38,8 +38,10 @@ oxe_semantics_hash: 69e3f79ec51160e1
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE validate-gaps** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/validate-gaps.md`
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Requer `VERIFY.md` e `PLAN.md` já existentes. Texto adicional: foco opcional em tarefa **Tn** ou critério **A***.

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

@@ -41,8 +41,10 @@ oxe_semantics_hash: 8b47625394eec62a
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE verify**. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/verify.md` (na raiz do repositório em contexto)
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Se o utilizador indicar uma tarefa `Tn`, restringe a verificação a essa tarefa.

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: 380bd0a3f3620845
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE workstream** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/workstream.md`
+**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.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como subcomando e contexto.

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

@@ -38,8 +38,12 @@ oxe_semantics_hash: 4a8d0d23c56065a7
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE** (entrada universal) no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
+
+**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.
 
-`.oxe/workflows/oxe.md`
+<!-- oxe-workflow-resolution:end -->
+
+Executa o workflow **OXE** (entrada universal) no repositório atual. Lê e aplica **integralmente**:
 
 `$ARGUMENTS`: vazio → próximo passo; texto → roteamento; "help" → trilha principal + trilha avançada.

package/.github/workflows/ci.yml

@@ -1,20 +1,56 @@
-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
+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
+
+  doctor:
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+      - run: npm ci
+      - name: OXE Doctor
+        run: node bin/oxe-cc.js doctor
+
+  wrapper-audit:
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+      - run: npm ci
+      - name: Audit runtime wrappers
+        run: |
+          node -e "
+            const rs = require('./bin/lib/oxe-runtime-semantics.cjs');
+            const r = rs.auditRuntimeTargets('.');
+            if (!r.ok) {
+              console.error('Wrapper audit failed:');
+              console.error(JSON.stringify(r.mismatches, null, 2));
+              process.exit(1);
+            }
+            console.log('Wrapper audit passed — all targets in sync');
+          "

package/.github/workflows/release.yml

@@ -0,0 +1,93 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+
+jobs:
+  validate:
+    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
+      - run: node bin/oxe-cc.js --version
+
+  publish-npm:
+    needs: validate
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+          registry-url: 'https://registry.npmjs.org'
+      - run: npm ci
+      - run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+  build-vsix:
+    needs: validate
+    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 run build:vscode-ext
+      - uses: actions/upload-artifact@v4
+        with:
+          name: oxe-agents-vsix
+          path: '*.vsix'
+          if-no-files-found: warn
+
+  create-release:
+    needs: [publish-npm, build-vsix]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: Extract changelog entry
+        id: changelog
+        run: |
+          TAG="${{ github.ref_name }}"
+          VERSION="${TAG#v}"
+          # Extract the block for this version from CHANGELOG.md
+          awk "/^## \[${VERSION}\]/{found=1; next} found && /^## \[/{exit} found{print}" CHANGELOG.md > CHANGELOG_EXTRACT.md
+          echo "Extracted changelog for ${VERSION}"
+          cat CHANGELOG_EXTRACT.md
+      - uses: actions/download-artifact@v4
+        with:
+          name: oxe-agents-vsix
+          path: dist/
+        continue-on-error: true
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          TAG="${{ github.ref_name }}"
+          VSIX_FILES=$(find dist/ -name "*.vsix" 2>/dev/null || true)
+          if [ -n "$VSIX_FILES" ]; then
+            gh release create "$TAG" \
+              --title "oxe-cc $TAG" \
+              --notes-file CHANGELOG_EXTRACT.md \
+              $VSIX_FILES
+          else
+            gh release create "$TAG" \
+              --title "oxe-cc $TAG" \
+              --notes-file CHANGELOG_EXTRACT.md
+          fi