oxe-cc 0.6.5 → 0.7.0

package/commands/oxe/ask.md

@@ -0,0 +1,14 @@
+---
+name: oxe:ask
+description: "Perguntar ao OXE sobre a situação atual com leitura robusta de STATE, sessão ativa e artefatos da trilha"
+argument-hint: "[pergunta em texto livre]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+---
+
+**Workflow canónico:** `oxe/workflows/ask.md`
+
+Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa o texto em `$ARGUMENTS` como pergunta e foco.

package/commands/oxe/capabilities.md

@@ -0,0 +1,13 @@
+---
+name: oxe:capabilities
+description: "Gerir capabilities nativas do projeto OXE"
+argument-hint: "[list|install <id>|remove <id>|update]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+---
+
+**Workflow canónico:** `oxe/workflows/capabilities.md`
+
+Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa o texto em `$ARGUMENTS` como ação sobre capabilities.

package/commands/oxe/dashboard.md

@@ -0,0 +1,14 @@
+---
+name: oxe:dashboard
+description: "Visualizar o runtime operacional, ondas, checkpoints e sinais principais da trilha OXE"
+argument-hint: "[foco opcional]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+---
+
+**Workflow canónico:** `oxe/workflows/dashboard.md`
+
+Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa o texto em `$ARGUMENTS` como foco opcional.

package/lib/sdk/README.md

@@ -47,19 +47,21 @@ const { options, warnings: w } = oxe.install.resolveOptionsFromConfig(dir, {
 | **health** | `loadOxeConfigMerged`, `validateConfigShape`, `buildHealthReport`, `suggestNextStep`, `oxePaths`, constantes de config |
 | **workflows** | `resolveWorkflowsDir`, `listWorkflowMdFiles`, `diffWorkflows`, `validateWorkflowShapes` (avisos `WORKFLOW_SHAPE`) |
 | **install** | `resolveOptionsFromConfig` |
-| **manifest** | `loadFileManifest`, `writeFileManifest`, `sha256File`, `collectFilesRecursive` |
-| **agents** | `adjustWorkflowPathsForNestedLayout`, `parseCursorCommandFrontmatter` |
-| **doctor** | `runDoctorChecks` — resultado estruturado (erros + avisos + diff de workflows + `workflowShape` com lint leve dos `.md`) |
+| **manifest** | `loadFileManifest`, `writeFileManifest`, `sha256File`, `collectFilesRecursive` |
+| **agents** | `adjustWorkflowPathsForNestedLayout`, `parseCursorCommandFrontmatter` |
+| **azure** | `azurePaths`, `detectAzureCli`, `loadAzureProfile`, `syncAzureInventory`, `planAzureOperation`, `applyAzureOperation`, `azureDoctor` |
+| **doctor** | `runDoctorChecks` — resultado estruturado (erros + avisos + diff de workflows + `workflowShape` com lint leve dos `.md`) |
 
 TypeScript: ver `index.d.ts` junto deste ficheiro.
 
 ## `health.buildHealthReport` e `parseLastCompactDate`
 
 - **`parseLastCompactDate(stateText)`** — lê a data em **`.oxe/STATE.md`** na secção **Último compact** (mesma convenção que **Último scan**). Devolve `Date | null` se a linha for placeholder ou ilegível.
-- **`buildHealthReport(projectRoot)`** — agrega fase, datas, avisos de SPEC/PLAN/VERIFY e o próximo passo sugerido. Campos usados em CI e em `oxe-cc status --json`:
-  - **`scanDate`**, **`stale`** — último scan e idade face a `scan_max_age_days` (`stale: { stale, days }`).
-  - **`compactDate`**, **`staleCompact`** — último compact e idade face a `compact_max_age_days`.
-  - **`next`** — `{ step, cursorCmd, reason, artifacts }` (espelha a lógica de `suggestNextStep`).
+- **`buildHealthReport(projectRoot)`** — agrega fase, datas, avisos de SPEC/PLAN/VERIFY e o próximo passo sugerido. Campos usados em CI e em `oxe-cc status --json`:
+  - **`scanDate`**, **`stale`** — último scan e idade face a `scan_max_age_days` (`stale: { stale, days }`).
+  - **`compactDate`**, **`staleCompact`** — último compact e idade face a `compact_max_age_days`.
+  - **`azureActive`**, **`azure`** — contexto Azure resolvido, inventário materializado, warnings e pendências do provider.
+  - **`next`** — `{ step, cursorCmd, reason, artifacts }` (espelha a lógica de `suggestNextStep`).
 
 ## `runDoctorChecks` e relatório de saúde
 

package/lib/sdk/index.cjs

@@ -14,6 +14,9 @@ const installResolve = require('../../bin/lib/oxe-install-resolve.cjs');
 const agentInstall = require('../../bin/lib/oxe-agent-install.cjs');
 const security = require('../../bin/lib/oxe-security.cjs');
 const plugins = require('../../bin/lib/oxe-plugins.cjs');
+const dashboard = require('../../bin/lib/oxe-dashboard.cjs');
+const operational = require('../../bin/lib/oxe-operational.cjs');
+const azure = require('../../bin/lib/oxe-azure.cjs');
 
 const PACKAGE_ROOT = path.join(__dirname, '..', '..');
 
@@ -543,6 +546,59 @@ module.exports = {
     initPluginsDir: plugins.initPluginsDir,
   },
 
+  /** Dashboard local: contexto consolidado e persistência de revisão do plano. */
+  dashboard: {
+    loadDashboardContext: dashboard.loadDashboardContext,
+    savePlanReviewStatus: dashboard.savePlanReviewStatus,
+    addPlanReviewComment: dashboard.addPlanReviewComment,
+    updatePlanReviewCommentStatus: dashboard.updatePlanReviewCommentStatus,
+  },
+
+  /** Runtime operacional: tracing, active run, catálogo de capabilities e memória em camadas. */
+  operational: {
+    operationalPaths: operational.operationalPaths,
+    appendEvent: operational.appendEvent,
+    readEvents: operational.readEvents,
+    summarizeEvents: operational.summarizeEvents,
+    writeRunState: operational.writeRunState,
+    readRunState: operational.readRunState,
+    buildOperationalGraph: operational.buildOperationalGraph,
+    applyRuntimeAction: operational.applyRuntimeAction,
+    parseCapabilityManifest: operational.parseCapabilityManifest,
+    readCapabilityCatalog: operational.readCapabilityCatalog,
+    buildMemoryLayers: operational.buildMemoryLayers,
+  },
+
+  /** Provider Azure nativo via Azure CLI. */
+  azure: {
+    MIN_AZURE_CLI_MAJOR: azure.MIN_AZURE_CLI_MAJOR,
+    AZURE_CAPABILITY_IDS: azure.AZURE_CAPABILITY_IDS,
+    RESOURCE_GRAPH_QUERY: azure.RESOURCE_GRAPH_QUERY,
+    DEFAULT_AZURE_PROFILE: azure.DEFAULT_AZURE_PROFILE,
+    azurePaths: azure.azurePaths,
+    ensureAzureArtifacts: azure.ensureAzureArtifacts,
+    isAzureContextEnabled: azure.isAzureContextEnabled,
+    detectAzureCli: azure.detectAzureCli,
+    loadAzureProfile: azure.loadAzureProfile,
+    loadAzureAuthStatus: azure.loadAzureAuthStatus,
+    loadAzureInventory: azure.loadAzureInventory,
+    listAzureOperations: azure.listAzureOperations,
+    summarizeInventory: azure.summarizeInventory,
+    searchAzureInventory: azure.searchAzureInventory,
+    diffInventory: azure.diffInventory,
+    statusAzure: azure.statusAzure,
+    ensureAzureCapabilities: azure.ensureAzureCapabilities,
+    getAzureContext: azure.getAzureContext,
+    loginAzure: azure.loginAzure,
+    setAzureSubscription: azure.setAzureSubscription,
+    syncAzureInventory: azure.syncAzureInventory,
+    executeAzureRead: azure.executeAzureRead,
+    planAzureOperation: azure.planAzureOperation,
+    applyAzureOperation: azure.applyAzureOperation,
+    azureDoctor: azure.azureDoctor,
+    redactObject: azure.redactObject,
+  },
+
   /** Um único objeto com verificações tipo `doctor` + relatório de saúde. */
   runDoctorChecks,
 };

package/lib/sdk/index.d.ts

@@ -45,6 +45,27 @@ export interface OxeNextSuggestion {
   artifacts: string[];
 }
 
+export interface AzureInventorySummary {
+  total: number;
+  servicebus: number;
+  eventgrid: number;
+  sql: number;
+  other: number;
+}
+
+export interface AzureHealthContext {
+  profile: Record<string, unknown> | null;
+  authStatus: Record<string, unknown> | null;
+  inventorySummary: AzureInventorySummary | null;
+  inventoryPath: string;
+  operationsPath: string;
+  inventorySyncedAt: string | null;
+  inventoryStale: { stale: boolean; hours: number | null };
+  pendingOperations: number;
+  lastOperation: Record<string, unknown> | null;
+  warnings: string[];
+}
+
 /** Relatório retornado por `health.buildHealthReport` e incluído em `runDoctorChecks`.healthReport. */
 export interface OxeHealthReport {
   configPath: string | null;
@@ -63,6 +84,8 @@ export interface OxeHealthReport {
   specWarn: string[];
   planWarn: string[];
   next: OxeNextSuggestion;
+  azureActive?: boolean;
+  azure?: AzureHealthContext | null;
   scanFocusGlobs?: unknown;
   scanIgnoreGlobs?: unknown;
 }
@@ -281,6 +304,56 @@ export interface OxeSdk {
     initPluginsDir: (projectRoot: string) => void;
   };
 
+  dashboard: {
+    loadDashboardContext: (projectRoot: string, opts?: { activeSession?: string | null }) => Record<string, unknown>;
+    savePlanReviewStatus: (projectRoot: string, input?: Record<string, unknown>) => Record<string, unknown>;
+    addPlanReviewComment: (projectRoot: string, input?: Record<string, unknown>) => Record<string, unknown>;
+    updatePlanReviewCommentStatus: (projectRoot: string, input?: Record<string, unknown>) => Record<string, unknown> | null;
+  };
+
+  operational: {
+    operationalPaths: (projectRoot: string, activeSession: string | null) => Record<string, string | null>;
+    appendEvent: (projectRoot: string, activeSession: string | null, event?: Record<string, unknown>) => Record<string, unknown>;
+    readEvents: (projectRoot: string, activeSession: string | null) => Array<Record<string, unknown>>;
+    summarizeEvents: (events: Array<Record<string, unknown>>) => Record<string, unknown>;
+    writeRunState: (projectRoot: string, activeSession: string | null, runState?: Record<string, unknown>) => Record<string, unknown>;
+    readRunState: (projectRoot: string, activeSession: string | null) => Record<string, unknown> | null;
+    buildOperationalGraph: (runState?: Record<string, unknown>) => { nodes: Array<Record<string, unknown>>; edges: Array<Record<string, unknown>> };
+    applyRuntimeAction: (projectRoot: string, activeSession: string | null, input?: Record<string, unknown>) => Record<string, unknown>;
+    parseCapabilityManifest: (text: string) => Record<string, unknown>;
+    readCapabilityCatalog: (projectRoot: string) => Array<Record<string, unknown>>;
+    buildMemoryLayers: (projectRoot: string, activeSession: string | null) => Record<string, unknown>;
+  };
+
+  azure: {
+    MIN_AZURE_CLI_MAJOR: number;
+    AZURE_CAPABILITY_IDS: string[];
+    RESOURCE_GRAPH_QUERY: string;
+    DEFAULT_AZURE_PROFILE: Record<string, unknown>;
+    azurePaths: (projectRoot: string) => Record<string, string>;
+    ensureAzureArtifacts: (projectRoot: string) => Record<string, string>;
+    isAzureContextEnabled: (projectRoot: string, config?: Record<string, unknown>) => boolean;
+    detectAzureCli: (projectRoot: string, options?: Record<string, unknown>) => Record<string, unknown>;
+    loadAzureProfile: (projectRoot: string) => Record<string, unknown>;
+    loadAzureAuthStatus: (projectRoot: string) => Record<string, unknown> | null;
+    loadAzureInventory: (projectRoot: string) => Record<string, unknown> | null;
+    listAzureOperations: (projectRoot: string) => Array<Record<string, unknown>>;
+    summarizeInventory: (items: Array<Record<string, unknown>>) => AzureInventorySummary;
+    searchAzureInventory: (projectRoot: string, query: string, filters?: { type?: string; resourceGroup?: string }) => Array<Record<string, unknown>>;
+    diffInventory: (previousItems: Array<Record<string, unknown>>, currentItems: Array<Record<string, unknown>>) => { added: Array<Record<string, unknown>>; removed: Array<Record<string, unknown>>; unchanged: number };
+    statusAzure: (projectRoot: string, config?: Record<string, unknown>, options?: Record<string, unknown>) => Record<string, unknown>;
+    ensureAzureCapabilities: (projectRoot: string) => string[];
+    getAzureContext: (projectRoot: string, options?: Record<string, unknown>) => Record<string, unknown>;
+    loginAzure: (projectRoot: string, options?: Record<string, unknown>) => Record<string, unknown>;
+    setAzureSubscription: (projectRoot: string, subscription: string, options?: Record<string, unknown>) => Record<string, unknown>;
+    syncAzureInventory: (projectRoot: string, options?: Record<string, unknown>) => Record<string, unknown>;
+    executeAzureRead: (projectRoot: string, activeSession: string | null, domain: string, verb: string, input: Record<string, unknown>, options?: Record<string, unknown>) => unknown;
+    planAzureOperation: (projectRoot: string, activeSession: string | null, domain: string, input: Record<string, unknown>, options?: Record<string, unknown>) => Record<string, unknown>;
+    applyAzureOperation: (projectRoot: string, activeSession: string | null, domain: string, input: Record<string, unknown>, options?: Record<string, unknown>) => Record<string, unknown>;
+    azureDoctor: (projectRoot: string, config?: Record<string, unknown>, options?: Record<string, unknown>) => Record<string, unknown>;
+    redactObject: (value: unknown) => unknown;
+  };
+
   runDoctorChecks: (args: {
     projectRoot: string;
     packageRoot?: string;

package/oxe/templates/ACTIVE-RUN.template.json

@@ -0,0 +1,32 @@
+{
+  "run_id": "oxe-run-YYYYMMDD-001",
+  "status": "planned",
+  "created_at": "YYYY-MM-DDTHH:mm:ssZ",
+  "updated_at": "YYYY-MM-DDTHH:mm:ssZ",
+  "plan_ref": "PLAN.md",
+  "session_id": null,
+  "current_wave": null,
+  "cursor": {
+    "wave": null,
+    "task": null,
+    "mode": null
+  },
+  "active_tasks": [],
+  "pending_checkpoints": [],
+  "retries": [],
+  "failures": [],
+  "evidence": [],
+  "provider_context": {
+    "azure": null
+  },
+  "graph": {
+    "nodes": [],
+    "edges": []
+  },
+  "metrics": {
+    "predicted_confidence": null,
+    "coverage_ratio": null,
+    "retry_count": 0,
+    "checkpoint_count": 0
+  }
+}

package/oxe/templates/CAPABILITIES.template.md

@@ -0,0 +1,7 @@
+# OXE — Capabilities Instaladas
+
+> Catálogo local de capabilities do projeto. Cada capability vive em `.oxe/capabilities/<id>/`.
+
+| ID | Tipo | Status | Escopo | Política | Side effects | Requer env | Evidência | Resumo |
+|----|------|--------|--------|-----------|--------------|------------|-----------|--------|
+| (vazio) | — | — | — | — | — | — | — | Nenhuma capability instalada |

package/oxe/templates/CAPABILITY.template.md

@@ -0,0 +1,45 @@
+---
+oxe_capability: true
+id: sample-capability
+version: 1
+type: script
+status: active
+scope: execute
+requires_env: []
+entrypoint: ""
+approval_policy: require_approval_if_external_side_effect
+side_effects: []
+evidence_outputs: []
+session_compatibility: [legacy, session]
+---
+
+# OXE — Capability
+
+## Objetivo
+
+- O que esta capability faz.
+
+## Escopo OXE
+
+- `scan` | `ask` | `research` | `spec` | `plan` | `execute` | `verify`
+
+## Operações
+
+- Operação 1
+
+## Entradas e saídas
+
+- Entradas esperadas
+- Saídas produzidas
+
+## Requisitos
+
+- Variáveis de ambiente
+- Dependências externas
+- Aprovação necessária ou bypass permitido
+
+## Evidência e segurança
+
+- Como a capability produz evidência útil.
+- Limites e riscos.
+- Side effects possíveis e como são governados.

package/oxe/templates/CHECKPOINTS.template.md

@@ -0,0 +1,7 @@
+# OXE — Checkpoints
+
+> Índice de checkpoints formais do ciclo atual. Usado para aprovações humanas e gates sensíveis.
+
+| ID | Tipo | Fase | Escopo | Estado | Política | Decisão | Override | Criado em | Resolvido em | Notas |
+|----|------|------|--------|--------|----------|---------|----------|-----------|--------------|-------|
+| CP-01 | approval | spec | definição de escopo | pending_approval | require_approval | — | — | YYYY-MM-DD | — | — |

package/oxe/templates/CONFIG.md

@@ -8,8 +8,9 @@ Copie `oxe/templates/config.template.json` para **`.oxe/config.json`** no seu pr
 |-------|------|-------------|
 | `profile` | string | Profile de execução: `balanced` (padrão) \| `strict` \| `fast` \| `legacy`. Expande automaticamente outras keys — keys explícitas prevalecem. Ver tabela abaixo. |
 | `discuss_before_plan` | boolean | Se `true`, o fluxo recomenda **`oxe:discuss`** entre spec e plan. |
-| `verification_depth` | string | Profundidade da verificação: `standard` (padrão) \| `thorough` (ativa Camada 5 — validate-gaps automático) \| `quick` (skip camadas 3–4 e UAT). |
-| `security_in_verify` | boolean | Se `true`, executa auditoria OWASP automaticamente no **verify** como **Camada 6** (produz `.oxe/SECURITY.md`). Achados P0 bloqueiam `verify_complete`. Padrão: `false`. |
+| `verification_depth` | string | Profundidade da verificação: `standard` (padrão) \| `thorough` (ativa Camada 5 — validate-gaps automático) \| `quick` (skip camadas 3–4 e UAT). |
+| `plan_confidence_threshold` | number | Limiar mínimo de confiança para o `execute` aceitar um `PLAN.md`. Padrão: `70`. Abaixo disso, o fluxo deve reduzir incerteza antes de implementar. |
+| `security_in_verify` | boolean | Se `true`, executa auditoria OWASP automaticamente no **verify** como **Camada 6** (produz `.oxe/SECURITY.md`). Achados P0 bloqueiam `verify_complete`. Padrão: `false`. |
 | `after_verify_suggest_pr` | boolean | Se `true`, o workflow **verify** inclui checklist de PR no fim. |
 | `after_verify_draft_commit` | boolean | Se `true`, o **verify** propõe rascunho de mensagem de commit alinhado aos critérios de aceite. |
 | `after_verify_suggest_uat` | boolean | Se `true`, o **verify** gera checklist UAT (Camada 4). Ativo automaticamente com `profile: strict`. |

package/oxe/templates/EXECUTION-RUNTIME.template.md

@@ -0,0 +1,68 @@
+---
+oxe_doc: execution_runtime
+status: active
+updated: YYYY-MM-DD
+---
+
+# OXE — Runtime Operacional
+
+> Estado tático da execução. Este ficheiro complementa `PLAN.md` e `STATE.md`, mas não os substitui.
+
+## Contexto
+
+- **Sessão / escopo:** …
+- **Plano vinculado:** `PLAN.md`
+- **Run ID:** `oxe-run-YYYYMMDD-001`
+- **Active run:** `.oxe/ACTIVE-RUN.json` ou artefato equivalente de sessão
+- **Trace log:** `.oxe/OXE-EVENTS.ndjson` ou artefato equivalente de sessão
+- **Autoavaliação do plano:** melhor=`sim|não` | confiança=`NN%`
+- **Limiar de execução:** `70%`
+
+## Onda atual
+
+- **Onda:** —
+- **Estado:** planned | running | paused | waiting_approval | failed | completed | replaying | aborted
+- **Tarefas ativas:** —
+- **Última atualização:** YYYY-MM-DD
+
+## Agentes ativos
+
+| ID | Papel | Tarefas | Estado | Último handoff |
+|----|-------|---------|--------|----------------|
+| … | … | T1, T2 | active | — |
+
+## Checkpoints
+
+| ID | Tipo | Escopo | Estado | Política | Decisão | Evidência |
+|----|------|--------|--------|----------|---------|-----------|
+| CP-01 | approval | Onda 1 | pending_approval | require_approval | — | — |
+
+## Handoffs
+
+- W1 · `agent-a -> agent-b`: …
+
+## Grafo operacional
+
+- **Nós:** agent-a, capability-x, checkpoint-CP-01
+- **Arestas:** handoff, dependency, blocked_by
+
+## Evidências produzidas
+
+- `path/ou/artefato`: resumo curto
+
+## Bloqueios
+
+- (nenhum ou lista)
+
+## Iterações / retries
+
+- Tarefa/onda | Tentativa | Resultado | Nota
+
+## Tracing operacional
+
+- `run_started` → `phase_entered` → `handoff` → `checkpoint_opened` → `checkpoint_resolved` → `verification_completed`
+
+## Próximo movimento operacional
+
+- **Ação:** …
+- **Motivo:** …

package/oxe/templates/INVESTIGATION.template.md

@@ -0,0 +1,38 @@
+---
+oxe_doc: investigation
+status: draft
+updated: YYYY-MM-DD
+objective: ""
+mode: surface
+sources: []
+---
+
+# OXE — Investigação Estruturada
+
+## Objetivo
+
+- Pergunta principal a responder.
+
+## Fontes
+
+- Fonte / path / sistema
+
+## Método
+
+- Como a investigação foi conduzida.
+
+## Evidências
+
+- Evidência 1
+
+## Conclusões
+
+- Conclusão 1
+
+## Impacto em spec/plan
+
+- Como isto altera a SPEC, o plano ou a confiança.
+
+## Próximo passo
+
+- O que ainda falta validar.

package/oxe/templates/NOTES.template.md

@@ -0,0 +1,16 @@
+---
+oxe_doc: notes
+updated: YYYY-MM-DD
+---
+
+# OXE — Notes
+
+Fila leve de anotações do projeto. Cada bullet é consumido em `/oxe-discuss` ou `/oxe-plan` e depois movido para **Notas incorporadas**.
+
+## Notas em aberto
+
+- YYYY-MM-DD — (nota aqui)
+
+## Notas incorporadas
+
+<!-- Notas movidas automaticamente após consumidas pelo discuss ou plan -->

package/oxe/templates/PLAN-REVIEW.template.md

@@ -0,0 +1,31 @@
+---
+oxe_doc: plan_review
+status: draft
+updated: YYYY-MM-DD
+plan_ref: PLAN.md
+---
+
+# OXE — Revisão do Plano
+
+## Estado
+
+- **Status:** draft
+- **Atualizado em:** YYYY-MM-DDTHH:mm:ssZ
+- **Origem:** dashboard local ou revisão textual
+
+## Decisão
+
+- **Resultado:** pendente
+- **Justificativa:** —
+
+## Comentários abertos
+
+- Nenhum
+
+## Comentários resolvidos
+
+- Nenhum
+
+## Próxima ação recomendada
+
+- `/oxe-dashboard` para revisar visualmente, ou `/oxe-plan --replan` se houver ajustes estruturais.

package/oxe/templates/PLAN.template.md

@@ -14,13 +14,28 @@ inputs: []
 
 > Gerado a partir de `.oxe/SPEC.md`. Cada tarefa deve ter bloco **Verificar**.
 
-## Resumo
-
-- **Spec vinculada:** (data ou versão informal)
-- **Ondas:** (número)
-- **Tarefas:** (número)
-
-## Dependências globais
+## Resumo
+
+- **Spec vinculada:** (data ou versão informal)
+- **Ondas:** (número)
+- **Tarefas:** (número)
+
+## Autoavaliação do Plano
+
+- **Melhor plano atual:** sim
+- **Confiança:** 80%
+- **Base da confiança:**
+  - Completude dos requisitos: 20/25
+  - Dependências conhecidas: 12/15
+  - Risco técnico: 15/20
+  - Impacto no código existente: 12/15
+  - Clareza da validação / testes: 13/15
+  - Lacunas externas / decisões pendentes: 8/10
+- **Principais incertezas:** (0–3 bullets)
+- **Alternativas descartadas:** (1–2 linhas)
+- **Condição para replanejar:** (critério objetivo)
+
+## Dependências globais
 
 - (ex.: branch base, feature flags, migrations)
 

package/oxe/templates/RESEARCH.template.md

@@ -1,4 +1,4 @@
-# OXE — Nota de pesquisa
+# OXE — Nota de pesquisa
 
 > Um ficheiro por sessão: copie para `.oxe/research/YYYY-MM-DD-<slug-kebab>.md` (data ISO; slug curto e único).
 
@@ -7,9 +7,16 @@
 - Ligação à SPEC: objetivo, IDs **A*** tocados (ou *N/A — SPEC ainda não existe* + recomendação de `oxe:spec`).
 - Entrada do utilizador / âmbito (paths, módulos, perguntas).
 
-## Perguntas em aberto
-
-1. … (critério para considerar “fechado”)
+## Perguntas em aberto
+
+1. … (critério para considerar “fechado”)
+
+## Investigação estruturada
+
+- **Objetivo:** …
+- **Modo:** `surface` | `standard` | `deep`
+- **Fontes:** …
+- **Profundidade:** …
 
 ## Evidência
 

package/oxe/templates/SPEC.template.md

@@ -19,10 +19,12 @@ inputs: []
 
 (Uma frase: o que entregar.)
 
-## Contexto
-
-- Repositório / produto: …
-- Links úteis: …
+## Contexto
+
+- Repositório / produto: …
+- Links úteis: …
+- Tipo de demanda: feature | bugfix | refactor | research | ops | mixed
+- Incertezas estruturadas: …
 
 ## Escopo
 

package/oxe/templates/STATE.md

@@ -20,11 +20,32 @@
 - **Notas:** (opcional; ex.: "só STRUCTURE e TESTING")
 - **last_retro:** (YYYY-MM-DD — preenchido por **`/oxe-retro`** ao concluir retrospectiva; lido por `oxe-cc doctor` para rastrear ciclos sem lições)
 
-## Contexto do plano / quick (opcional)
-
-- **Spec / plano:** (revisão informal ou data de `.oxe/SPEC.md` / `.oxe/PLAN.md`)
-- **Última onda executada:** (número ou —)
-- **Tarefas concluídas:** (ex.: T1, T2 ou passos 1–3 do QUICK.md)
+## Contexto do plano / quick (opcional)
+
+- **Spec / plano:** (revisão informal ou data de `.oxe/SPEC.md` / `.oxe/PLAN.md`)
+- **Última onda executada:** (número ou —)
+- **Tarefas concluídas:** (ex.: T1, T2 ou passos 1–3 do QUICK.md)
+
+## Checkpoints de aprovação (opcional)
+
+- **checkpoint_status:** `pending_approval` | `approved` | `rejected` | `overridden` | —
+- **checkpoint_ref:** `.oxe/CHECKPOINTS.md` ou artefato de sessão correspondente
+- **Notas:** (ex.: aguardando aprovação para Onda 2)
+
+## Runtime operacional (opcional)
+
+- **runtime_status:** `planned` | `running` | `paused` | `waiting_approval` | `failed` | `completed` | `replaying` | `aborted` | —
+- **runtime_ref:** `.oxe/EXECUTION-RUNTIME.md` ou artefato de sessão correspondente
+- **active_run_ref:** `.oxe/ACTIVE-RUN.json` ou artefato de sessão correspondente
+- **events_ref:** `.oxe/OXE-EVENTS.ndjson` ou artefato de sessão correspondente
+- **Notas:** (agentes ativos, bloqueio principal, handoff pendente)
+
+## Revisão do plano (opcional — dashboard / aprovação)
+
+- **plan_review_status:** `draft` | `in_review` | `approved` | `rejected` | `needs_revision` | —
+- **plan_review_updated:** (ISO legível — ex.: `2026-04-10T14:22:00-03:00`)
+- **plan_review_ref:** `.oxe/PLAN-REVIEW.md` ou artefato de sessão correspondente
+- **Notas:** (ex.: aprovado para execute; revisão pendente da onda 2)
 
 ## Blueprint de agentes (sessão) (opcional — `/oxe-plan-agent`)
 
@@ -81,11 +102,28 @@ _(O agente pode preencher após cada onda.)_
 
 - (nome do workstream ativo — ou — para pipeline principal)
 
-## Memory (sidecars de sessão) (opcional — `/oxe-memory`)
+## Memory (sidecars de sessão) (opcional — `/oxe-memory`)
 
 Sidecars de memória persistente por agente/sessão. Armazenados em `.oxe/memory/`.
 
-- (nenhum ou lista: ex.: `architect-2025-01-15.md`, `researcher-auth-2025-01-14.md`)
+- (nenhum ou lista: ex.: `architect-2025-01-15.md`, `researcher-auth-2025-01-14.md`)
+
+## Camadas de memória (contrato)
+
+- **memory_read_order:** `runtime_state -> session_memory -> project_memory -> evidence`
+- **session_memory_ref:** `SESSION.md` ou —
+- **project_memory_ref:** `.oxe/global/LESSONS.md`
+- **evidence_ref:** `INVESTIGATIONS.md`, `VERIFY.md` e derivados
+
+## Capabilities nativas (opcional)
+
+- **capabilities_ref:** `.oxe/CAPABILITIES.md`
+- **Capabilities ativas:** (IDs ou —)
+
+## Investigações estruturadas (opcional)
+
+- **investigations_ref:** `.oxe/INVESTIGATIONS.md` ou índice de sessão
+- **Última investigação:** (path ou —)
 
 ## Decisões persistentes