oxe-cc 1.5.1 → 1.6.0

package/oxe/workflows/references/session-path-resolution.md

@@ -1,71 +1,71 @@
-# OXE — Referência: Session Path Resolution
-
-<objective>
-Padronizar a resolução de caminhos quando o projeto usa **sessões OXE** em `.oxe/sessions/`, preservando o modo legado quando **`.oxe/STATE.md`** não tiver `active_session`.
-</objective>
-
-<resolution_rule>
-## Regra de resolução
-
-1. Ler **`.oxe/STATE.md`** global.
-2. Procurar o campo **`active_session`** na secção **Sessão ativa**.
-3. Se existir e tiver valor diferente de `—`, usar:
-   - `session_path = .oxe/<active_session>/`
-   - `active_session` deve guardar sempre o path relativo completo, por exemplo: `sessions/s001-auth-redesign`
-4. Se não existir:
-   - `session_path = .oxe/`
-   - O workflow opera em **modo legado**
-
-## Convenções auxiliares
-
-- **global_state_path** = `.oxe/STATE.md`
-- **global_config_path** = `.oxe/config.json`
-- **global_codebase_path** = `.oxe/codebase/`
-- **global_sessions_index_path** = `.oxe/SESSIONS.md`
-- **global_lessons_path** = `.oxe/global/LESSONS.md`
-- **global_milestones_index_path** = `.oxe/global/MILESTONES.md`
-- **global_milestones_dir** = `.oxe/global/milestones/`
-</resolution_rule>
-
-<artifact_matrix>
-## Matriz de artefatos
-
-| Tipo | Escopo | Caminho com sessão ativa | Caminho legado |
-|------|--------|--------------------------|----------------|
-| STATE global | global | `.oxe/STATE.md` | `.oxe/STATE.md` |
-| Config | global | `.oxe/config.json` | `.oxe/config.json` |
-| Codebase | global | `.oxe/codebase/*` | `.oxe/codebase/*` |
-| SESSIONS | global | `.oxe/SESSIONS.md` | `.oxe/SESSIONS.md` |
-| LESSONS | global | `.oxe/global/LESSONS.md` | `.oxe/LESSONS.md` |
-| MILESTONES | global | `.oxe/global/MILESTONES.md` | `.oxe/MILESTONES.md` |
-| SPEC / ROADMAP / DISCUSS / UI-SPEC | sessão | `.oxe/<active_session>/spec/` | `.oxe/` |
-| PLAN / QUICK / plan-agents / quick-agents | sessão | `.oxe/<active_session>/plan/` | `.oxe/` |
-| STATE local / OBS / DEBUG / FORENSICS | sessão | `.oxe/<active_session>/execution/` | `.oxe/` |
-| VERIFY / VALIDATION-GAPS / SECURITY / UI-REVIEW | sessão | `.oxe/<active_session>/verification/` | `.oxe/` |
-| CHECKPOINTS | sessão | `.oxe/<active_session>/checkpoints/` | `.oxe/checkpoints/` |
-| RESEARCH | sessão | `.oxe/<active_session>/research/` | `.oxe/research/` |
-| WORKSTREAMS | sessão | `.oxe/<active_session>/workstreams/` | `.oxe/workstreams/` |
-</artifact_matrix>
-
-<reading_rule>
-## Regra de leitura
-
-- Quando um workflow ler um artefato da sua trilha, deve tentar primeiro o caminho da sessão ativa.
-- Se não houver sessão ativa, usar o caminho legado.
-- Se houver sessão ativa mas o artefato ainda não existir, o workflow pode:
-  - criar no caminho da sessão, se for writer da fase
-  - ou fazer fallback de leitura para o legado, quando isso preservar retrocompatibilidade e ajudar numa migração
-
-Exemplos:
-- `plan` lê `spec/SPEC.md` da sessão antes de cair para `.oxe/SPEC.md`
-- `verify` lê `plan/PLAN.md` e `spec/SPEC.md` da sessão antes do legado
-- `execute` lê sempre `.oxe/STATE.md` global **antes** de tudo, só para resolver `active_session`
-</reading_rule>
-
-<cross_session_refs>
-## Referências cruzadas
-
-- Em `SESSION.md`, referências a outras sessões usam o formato **`@sNNN`**
-- O texto pode complementar com o path, por exemplo: `@s003 ver sessions/s003-auth-hardening/SESSION.md`
-- Não existe sessão múltipla ativa: o formato `@sNNN` é apenas referência documental
-</cross_session_refs>
+# OXE — Referência: Session Path Resolution
+
+<objective>
+Padronizar a resolução de caminhos quando o projeto usa **sessões OXE** em `.oxe/sessions/`, preservando o modo legado quando **`.oxe/STATE.md`** não tiver `active_session`.
+</objective>
+
+<resolution_rule>
+## Regra de resolução
+
+1. Ler **`.oxe/STATE.md`** global.
+2. Procurar o campo **`active_session`** na secção **Sessão ativa**.
+3. Se existir e tiver valor diferente de `—`, usar:
+   - `session_path = .oxe/<active_session>/`
+   - `active_session` deve guardar sempre o path relativo completo, por exemplo: `sessions/s001-auth-redesign`
+4. Se não existir:
+   - `session_path = .oxe/`
+   - O workflow opera em **modo legado**
+
+## Convenções auxiliares
+
+- **global_state_path** = `.oxe/STATE.md`
+- **global_config_path** = `.oxe/config.json`
+- **global_codebase_path** = `.oxe/codebase/`
+- **global_sessions_index_path** = `.oxe/SESSIONS.md`
+- **global_lessons_path** = `.oxe/global/LESSONS.md`
+- **global_milestones_index_path** = `.oxe/global/MILESTONES.md`
+- **global_milestones_dir** = `.oxe/global/milestones/`
+</resolution_rule>
+
+<artifact_matrix>
+## Matriz de artefatos
+
+| Tipo | Escopo | Caminho com sessão ativa | Caminho legado |
+|------|--------|--------------------------|----------------|
+| STATE global | global | `.oxe/STATE.md` | `.oxe/STATE.md` |
+| Config | global | `.oxe/config.json` | `.oxe/config.json` |
+| Codebase | global | `.oxe/codebase/*` | `.oxe/codebase/*` |
+| SESSIONS | global | `.oxe/SESSIONS.md` | `.oxe/SESSIONS.md` |
+| LESSONS | global | `.oxe/global/LESSONS.md` | `.oxe/LESSONS.md` |
+| MILESTONES | global | `.oxe/global/MILESTONES.md` | `.oxe/MILESTONES.md` |
+| SPEC / ROADMAP / DISCUSS / UI-SPEC | sessão | `.oxe/<active_session>/spec/` | `.oxe/` |
+| PLAN / QUICK / plan-agents / quick-agents | sessão | `.oxe/<active_session>/plan/` | `.oxe/` |
+| STATE local / OBS / DEBUG / FORENSICS | sessão | `.oxe/<active_session>/execution/` | `.oxe/` |
+| VERIFY / VALIDATION-GAPS / SECURITY / UI-REVIEW | sessão | `.oxe/<active_session>/verification/` | `.oxe/` |
+| CHECKPOINTS | sessão | `.oxe/<active_session>/checkpoints/` | `.oxe/checkpoints/` |
+| RESEARCH | sessão | `.oxe/<active_session>/research/` | `.oxe/research/` |
+| WORKSTREAMS | sessão | `.oxe/<active_session>/workstreams/` | `.oxe/workstreams/` |
+</artifact_matrix>
+
+<reading_rule>
+## Regra de leitura
+
+- Quando um workflow ler um artefato da sua trilha, deve tentar primeiro o caminho da sessão ativa.
+- Se não houver sessão ativa, usar o caminho legado.
+- Se houver sessão ativa mas o artefato ainda não existir, o workflow pode:
+  - criar no caminho da sessão, se for writer da fase
+  - ou fazer fallback de leitura para o legado, quando isso preservar retrocompatibilidade e ajudar numa migração
+
+Exemplos:
+- `plan` lê `spec/SPEC.md` da sessão antes de cair para `.oxe/SPEC.md`
+- `verify` lê `plan/PLAN.md` e `spec/SPEC.md` da sessão antes do legado
+- `execute` lê sempre `.oxe/STATE.md` global **antes** de tudo, só para resolver `active_session`
+</reading_rule>
+
+<cross_session_refs>
+## Referências cruzadas
+
+- Em `SESSION.md`, referências a outras sessões usam o formato **`@sNNN`**
+- O texto pode complementar com o path, por exemplo: `@s003 ver sessions/s003-auth-hardening/SESSION.md`
+- Não existe sessão múltipla ativa: o formato `@sNNN` é apenas referência documental
+</cross_session_refs>

package/oxe/workflows/references/workflow-runtime-contracts.json

@@ -254,25 +254,25 @@
       ],
       "extraction_intent": "status_read"
     },
-    "dashboard": {
-      "reasoning_mode": "status",
-      "output_contract": "situational",
-      "required_artifacts": [
-        "state",
-        "phase_summary",
-        "project_summary"
-      ],
-      "optional_artifacts": [
-        "session_summary",
-        "plan",
-        "implementation_pack_json",
-        "reference_anchors",
-        "fixture_pack_json",
-        "runtime",
-        "verify",
-        "active_run",
-        "events",
-        "context_pack_dashboard"
+    "dashboard": {
+      "reasoning_mode": "status",
+      "output_contract": "situational",
+      "required_artifacts": [
+        "state",
+        "phase_summary",
+        "project_summary"
+      ],
+      "optional_artifacts": [
+        "session_summary",
+        "plan",
+        "implementation_pack_json",
+        "reference_anchors",
+        "fixture_pack_json",
+        "runtime",
+        "verify",
+        "active_run",
+        "events",
+        "context_pack_dashboard"
       ],
       "extraction_intent": "critical_check"
     },
@@ -322,72 +322,72 @@
         "canonical_state"
       ],
       "runtime_fallback_note": "Se o runtime não estiver compilado ou falhar por indisponibilidade do pacote, declarar fallback explícito para o fluxo legado antes de mutar.",
-      "required_artifacts": [
-        "state",
-        "runtime",
-        "checkpoints",
-        "implementation_pack_json",
-        "reference_anchors",
-        "fixture_pack_json"
-      ],
-      "optional_artifacts": [
-        "plan",
-        "quick",
-        "implementation_pack_md",
-        "fixture_pack_md",
-        "active_run",
-        "events",
-        "verify",
-        "summary",
-        "session_summary",
+      "required_artifacts": [
+        "state",
+        "runtime",
+        "checkpoints",
+        "implementation_pack_json",
+        "reference_anchors",
+        "fixture_pack_json"
+      ],
+      "optional_artifacts": [
+        "plan",
+        "quick",
+        "implementation_pack_md",
+        "fixture_pack_md",
+        "active_run",
+        "events",
+        "verify",
+        "summary",
+        "session_summary",
         "phase_summary",
         "project_summary",
         "capabilities_index",
         "azure_inventory"
       ],
-      "context_tiers": {
-        "minimal": [
-          "state",
-          "runtime",
-          "checkpoints",
-          "plan",
-          "implementation_pack_json",
-          "reference_anchors",
-          "fixture_pack_json",
-          "quick",
-          "phase_summary"
-        ],
-        "standard": [
-          "state",
-          "runtime",
-          "checkpoints",
-          "plan",
-          "implementation_pack_json",
-          "reference_anchors",
-          "fixture_pack_json",
-          "quick",
-          "phase_summary",
-          "session_summary",
-          "active_run",
-          "events",
+      "context_tiers": {
+        "minimal": [
+          "state",
+          "runtime",
+          "checkpoints",
+          "plan",
+          "implementation_pack_json",
+          "reference_anchors",
+          "fixture_pack_json",
+          "quick",
+          "phase_summary"
+        ],
+        "standard": [
+          "state",
+          "runtime",
+          "checkpoints",
+          "plan",
+          "implementation_pack_json",
+          "reference_anchors",
+          "fixture_pack_json",
+          "quick",
+          "phase_summary",
+          "session_summary",
+          "active_run",
+          "events",
           "verify",
           "summary"
         ],
         "full": [
-          "state",
-          "runtime",
-          "checkpoints",
-          "plan",
-          "implementation_pack_md",
-          "implementation_pack_json",
-          "reference_anchors",
-          "fixture_pack_md",
-          "fixture_pack_json",
-          "quick",
-          "active_run",
-          "events",
-          "verify",
-          "summary",
+          "state",
+          "runtime",
+          "checkpoints",
+          "plan",
+          "implementation_pack_md",
+          "implementation_pack_json",
+          "reference_anchors",
+          "fixture_pack_md",
+          "fixture_pack_json",
+          "quick",
+          "active_run",
+          "events",
+          "verify",
+          "summary",
           "session_summary",
           "phase_summary",
           "project_summary",
@@ -530,65 +530,65 @@
         "state",
         "spec"
       ],
-      "optional_artifacts": [
-        "discuss",
-        "investigations_index",
-        "project_summary",
-        "session_summary",
-        "phase_summary",
-        "global_lessons",
-        "capabilities_index",
-        "azure_inventory",
-        "checkpoints",
-        "calibration",
-        "implementation_pack_md",
-        "implementation_pack_json",
-        "reference_anchors",
-        "fixture_pack_md",
-        "fixture_pack_json"
-      ],
-      "context_tiers": {
-        "minimal": [
-          "state",
-          "spec",
+      "optional_artifacts": [
+        "discuss",
+        "investigations_index",
+        "project_summary",
+        "session_summary",
+        "phase_summary",
+        "global_lessons",
+        "capabilities_index",
+        "azure_inventory",
+        "checkpoints",
+        "calibration",
+        "implementation_pack_md",
+        "implementation_pack_json",
+        "reference_anchors",
+        "fixture_pack_md",
+        "fixture_pack_json"
+      ],
+      "context_tiers": {
+        "minimal": [
+          "state",
+          "spec",
           "session_summary",
           "phase_summary"
         ],
         "standard": [
-          "state",
-          "spec",
-          "session_summary",
-          "phase_summary",
-          "discuss",
-          "investigations_index",
-          "project_summary",
-          "global_lessons",
-          "capabilities_index",
-          "checkpoints",
-          "implementation_pack_json",
-          "reference_anchors",
-          "fixture_pack_json"
-        ],
-        "full": [
-          "state",
-          "spec",
-          "discuss",
+          "state",
+          "spec",
+          "session_summary",
+          "phase_summary",
+          "discuss",
+          "investigations_index",
+          "project_summary",
+          "global_lessons",
+          "capabilities_index",
+          "checkpoints",
+          "implementation_pack_json",
+          "reference_anchors",
+          "fixture_pack_json"
+        ],
+        "full": [
+          "state",
+          "spec",
+          "discuss",
           "investigations_index",
           "project_summary",
           "session_summary",
           "phase_summary",
-          "global_lessons",
-          "capabilities_index",
-          "azure_inventory",
-          "checkpoints",
-          "calibration",
-          "implementation_pack_md",
-          "implementation_pack_json",
-          "reference_anchors",
-          "fixture_pack_md",
-          "fixture_pack_json"
-        ]
-      },
+          "global_lessons",
+          "capabilities_index",
+          "azure_inventory",
+          "checkpoints",
+          "calibration",
+          "implementation_pack_md",
+          "implementation_pack_json",
+          "reference_anchors",
+          "fixture_pack_md",
+          "fixture_pack_json"
+        ]
+      },
       "extraction_intent": "planning_input"
     },
     "project": {

package/oxe/workflows/verify.md

@@ -122,10 +122,10 @@ O preenchimento da checklist é responsabilidade do **usuário** (não do agente
 **Calibração do plano** (obrigatória quando existir `PLAN.md`)
 
 Ler a `## Autoavaliação do Plano` e comparar com o resultado real:
-1. Se `Confiança > limiar executável` (padrão canónico `90%`) e houver falha precoce em critérios centrais ou tarefas iniciais, marcar **erro de calibração do plano**.
-2. Se `Confiança <= limiar executável` e as falhas ocorrerem nas incertezas previstas, marcar **autoavaliação aderente**.
-3. Se `Confiança > limiar executável` e os critérios/tarefas passarem de forma consistente, marcar **plano calibrado**.
-4. Se `Confiança <= limiar executável` e o ciclo passar amplamente, marcar **plano conservador demais**.
+1. Se `Confiança > limiar executável` (padrão canónico `90%`) e houver falha precoce em critérios centrais ou tarefas iniciais, marcar **erro de calibração do plano**.
+2. Se `Confiança <= limiar executável` e as falhas ocorrerem nas incertezas previstas, marcar **autoavaliação aderente**.
+3. Se `Confiança > limiar executável` e os critérios/tarefas passarem de forma consistente, marcar **plano calibrado**.
+4. Se `Confiança <= limiar executável` e o ciclo passar amplamente, marcar **plano conservador demais**.
 
 Registrar em `VERIFY.md`: `Resultado de calibração | Confiança declarada | Resultado observado | Notas`.
 </calibracao_do_plano>

package/oxe/workflows/workstream.md

@@ -11,7 +11,7 @@ Subcomandos:
 - `/oxe-workstream close <nome>` — fechar workstream e mesclar contexto ao pipeline principal.
 </objective>
 
-<context>
+<context>
 **Por que workstreams?**
 
 O pipeline OXE padrão (`.oxe/SPEC.md`, `PLAN.md`, etc.) é linear — uma entrega por vez. Workstreams permitem:
@@ -19,7 +19,7 @@ O pipeline OXE padrão (`.oxe/SPEC.md`, `PLAN.md`, etc.) é linear — uma entre
 - Trabalho em `bugfix/auth` e `feature/billing` simultaneamente.
 - Times menores trabalhando em trilhas independentes com contextos separados.
 
-**Estrutura no disco:**
+**Estrutura no disco:**
 ```
 .oxe/
   workstreams/
@@ -32,18 +32,18 @@ O pipeline OXE padrão (`.oxe/SPEC.md`, `PLAN.md`, etc.) é linear — uma entre
       config.json     (herda do config principal; pode sobrescrever keys)
 ```
 
-**Compatibilidade:**
-- O pipeline principal (`.oxe/SPEC.md`, `.oxe/PLAN.md`, etc.) continua funcionando normalmente.
-- Workstreams **não** substituem o pipeline principal — são adicionais.
-- `oxe-cc doctor` e `oxe-cc status` reportam cada workstream separadamente quando `--workstream=<nome>` for passado.
-- A seção **Workstreams ativos** do STATE.md principal lista os workstreams em andamento.
-- Resolver `active_session` conforme `oxe/workflows/references/session-path-resolution.md`. Com sessão ativa, workstreams vivem em `.oxe/<active_session>/workstreams/`; sem sessão ativa, usam `.oxe/workstreams/`.
-</context>
+**Compatibilidade:**
+- O pipeline principal (`.oxe/SPEC.md`, `.oxe/PLAN.md`, etc.) continua funcionando normalmente.
+- Workstreams **não** substituem o pipeline principal — são adicionais.
+- `oxe-cc doctor` e `oxe-cc status` reportam cada workstream separadamente quando `--workstream=<nome>` for passado.
+- A seção **Workstreams ativos** do STATE.md principal lista os workstreams em andamento.
+- Resolver `active_session` conforme `oxe/workflows/references/session-path-resolution.md`. Com sessão ativa, workstreams vivem em `.oxe/<active_session>/workstreams/`; sem sessão ativa, usam `.oxe/workstreams/`.
+</context>
 
 <process_list>
 **`/oxe-workstream list`**
 
-1. Ler `workstreams/` do escopo resolvido — listar subpastas.
+1. Ler `workstreams/` do escopo resolvido — listar subpastas.
 2. Para cada workstream, ler seu `STATE.md` local (fase e próximo passo).
 3. Exibir tabela no chat: Nome | Fase | Próximo passo | Última atividade.
 </process_list>
@@ -52,8 +52,8 @@ O pipeline OXE padrão (`.oxe/SPEC.md`, `PLAN.md`, etc.) é linear — uma entre
 **`/oxe-workstream new <nome>`**
 
 1. Validar que `<nome>` é um slug seguro (letras, números, hífens — sem espaços ou caracteres especiais).
-2. Criar `workstreams/<nome>/STATE.md` no escopo resolvido a partir de `oxe/templates/STATE.md`.
-3. Criar `workstreams/<nome>/config.json` vazio (herda do config principal).
+2. Criar `workstreams/<nome>/STATE.md` no escopo resolvido a partir de `oxe/templates/STATE.md`.
+3. Criar `workstreams/<nome>/config.json` vazio (herda do config principal).
 4. Atualizar **STATE.md principal**: adicionar `<nome>` na seção **Workstreams ativos**.
 5. Confirmar no chat: `Workstream '<nome>' criado. Próximo passo: /oxe-spec (no contexto do workstream)`.
 
@@ -63,9 +63,9 @@ O pipeline OXE padrão (`.oxe/SPEC.md`, `PLAN.md`, etc.) é linear — uma entre
 <process_switch>
 **`/oxe-workstream switch <nome>`**
 
-1. Verificar que `workstreams/<nome>/` do escopo resolvido existe.
+1. Verificar que `workstreams/<nome>/` do escopo resolvido existe.
 2. Atualizar STATE.md principal: seção **Workstream ativo** com nome.
-3. Confirmar no chat: `Workstream ativo: <nome>. Artefatos em workstreams/<nome>/ do escopo atual`.
+3. Confirmar no chat: `Workstream ativo: <nome>. Artefatos em workstreams/<nome>/ do escopo atual`.
 
 Após ativar, os workflows `/oxe-spec`, `/oxe-plan`, `/oxe-execute`, `/oxe-verify` operam nos artefatos do workstream ativo em vez dos artefatos raiz.
 </process_switch>
@@ -74,7 +74,7 @@ Após ativar, os workflows `/oxe-spec`, `/oxe-plan`, `/oxe-execute`, `/oxe-verif
 **`/oxe-workstream status [nome]`**
 
 1. Se `nome` omitido: usar workstream ativo do STATE.md.
-2. Ler `workstreams/<nome>/STATE.md` do escopo resolvido — fase e próximo passo.
+2. Ler `workstreams/<nome>/STATE.md` do escopo resolvido — fase e próximo passo.
 3. Ler SPEC, PLAN, VERIFY do workstream (se existirem).
 4. Exibir resumo: fase, critérios, gaps, próximo passo.
 </process_status>
@@ -84,7 +84,7 @@ Após ativar, os workflows `/oxe-spec`, `/oxe-plan`, `/oxe-execute`, `/oxe-verif
 
 1. Verificar que o workstream está com `verify_complete` no seu STATE.md local.
 2. Se não estiver: alertar e pedir confirmação com `--force`.
-3. Mover (ou arquivar) `workstreams/<nome>/` do escopo resolvido → `workstreams/closed/<nome>-YYYY-MM-DD/`.
+3. Mover (ou arquivar) `workstreams/<nome>/` do escopo resolvido → `workstreams/closed/<nome>-YYYY-MM-DD/`.
 4. Atualizar STATE.md principal: remover `<nome>` de **Workstreams ativos**, registrar em **Workstreams encerrados**.
 5. Confirmar no chat: `Workstream '<nome>' encerrado. Artefatos em .oxe/workstreams/closed/`.
 </process_close>

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "oxe-cc",
-	"version": "1.5.1",
+	"version": "1.6.0",
 	"description": "OXE — spec-driven workflows in .oxe/ with runtime enterprise, evidence-first verification and multi-runtime integrations (npx)",
 	"license": "MIT",
 	"author": "",

package/packages/runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxe/runtime",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "private": true,
   "license": "MIT",
   "description": "OXE agentic execution engine — enterprise runtime core",

package/vscode-extension/package.json

@@ -2,7 +2,7 @@
   "name": "oxe-agents",
   "displayName": "OXE Agents",
   "description": "Agentes OXE para GitHub Copilot Chat — cada fase do ciclo como um @agente no VS Code",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "publisher": "oxe-cc",
   "license": "MIT",
   "engines": {