oxe-cc 0.9.3 → 1.2.1

package/bin/oxe-cc.js

@@ -2125,7 +2125,7 @@ ${green}Uso:${reset}
   npx oxe-cc init-oxe [opções] [pasta-do-projeto]
   npx oxe-cc context <build|inspect> [opções] [pasta-do-projeto]
   npx oxe-cc dashboard [opções] [pasta-do-projeto]
-  npx oxe-cc runtime <status|start|pause|resume|replay> [opções] [pasta-do-projeto]
+  npx oxe-cc runtime <status|start|pause|resume|replay|compile|project|ci> [opções] [pasta-do-projeto]
   npx oxe-cc azure <status|doctor|auth|sync|find|servicebus|eventgrid|sql|operations> [opções] [pasta-do-projeto]
   npx oxe-cc capabilities <list|install|remove|update> [opções] [id]
   npx oxe-cc uninstall [opções] [pasta-do-projeto]
@@ -2167,18 +2167,24 @@ ${green}context${reset} (Context Engine V2: seleção, compressão e inspeção
   --json                                 saída estruturada em JSON
   --dir <pasta>                          raiz do projeto (padrão: diretório atual)
 
-${green}runtime${reset} (controle operacional explícito do ACTIVE-RUN)
-  status                                 mostra o run ativo resolvido para a sessão atual
-  start                                  cria um novo run com tracing inicial
-  pause                                  pausa o run ativo e preserva o cursor
-  resume                                 retoma o run ativo
-  replay                                 marca replay parcial por onda ou tarefa
-  --session <sessions/sNNN-slug>         força sessão específica
-  --wave <número>                        fixa onda atual/cursor
-  --task <Tn>                            fixa tarefa atual/cursor
-  --mode <complete|wave|task>            modo operacional do cursor
-  --reason <texto>                       motivo explícito da transição
-  --dir <pasta>                          raiz do projeto (padrão: diretório atual)
+${green}runtime${reset} (controle operacional explícito do ACTIVE-RUN)
+  status                                 mostra o run ativo resolvido para a sessão atual
+  start                                  cria um novo run com tracing inicial
+  pause                                  pausa o run ativo e preserva o cursor
+  resume                                 retoma o run ativo
+  replay                                 marca replay parcial por onda ou tarefa
+  compile                                compila PLAN/SPEC em ExecutionGraph formal + verification suite
+  project                                projeta markdowns derivados do estado canônico
+  ci                                     executa checks do runtime e persiste o resultado na run
+  --session <sessions/sNNN-slug>         força sessão específica
+  --wave <número>                        fixa onda atual/cursor
+  --task <Tn>                            fixa tarefa atual/cursor
+  --mode <complete|wave|task>            modo operacional do cursor
+  --reason <texto>                       motivo explícito da transição
+  --run <run_id>                         (replay|ci) filtra um run específico
+  --from <event_id>                      (replay) começa em um event_id específico
+  --write                                (replay) gera REPLAY-SESSION.md
+  --dir <pasta>                          raiz do projeto (padrão: diretório atual)
 
 ${green}azure${reset} (provider Azure nativo via Azure CLI no Windows)
   status                                 estado compacto: CLI, login, subscription, inventário, pendências
@@ -3707,11 +3713,11 @@ async function runDashboard(opts) {
 /**
  * @param {RuntimeOpts} opts
  */
-function runRuntime(opts) {
-  const c = useAnsiColors();
-  printSection('OXE ▸ runtime');
-  if (!fs.existsSync(opts.dir)) {
-    console.error(`${yellow}Diretório não encontrado: ${opts.dir}${reset}`);
+async function runRuntime(opts) {
+  const c = useAnsiColors();
+  printSection('OXE ▸ runtime');
+  if (!fs.existsSync(opts.dir)) {
+    console.error(`${yellow}Diretório não encontrado: ${opts.dir}${reset}`);
     process.exit(1);
   }
   bootstrapOxe(opts.dir, { dryRun: false, force: false });
@@ -3722,20 +3728,32 @@ function runRuntime(opts) {
   console.log(`  ${c ? green : ''}Projeto:${c ? reset : ''} ${c ? cyan : ''}${opts.dir}${c ? reset : ''}`);
   console.log(`  ${c ? green : ''}Sessão:${c ? reset : ''} ${c ? cyan : ''}${activeSession || 'modo legado'}${c ? reset : ''}`);
 
-  if (opts.action === 'status') {
-    const current = oxeOperational.readRunState(opts.dir, activeSession);
-    if (!current) {
-      console.log(`  ${yellow}Nenhum ACTIVE-RUN encontrado.${reset}`);
-      return;
-    }
-    console.log(`  ${c ? green : ''}Run:${c ? reset : ''} ${current.run_id}`);
-    console.log(`  ${c ? green : ''}Estado:${c ? reset : ''} ${current.status}`);
-    console.log(`  ${c ? green : ''}Cursor:${c ? reset : ''} onda=${current.cursor && current.cursor.wave != null ? current.cursor.wave : '—'} tarefa=${current.cursor && current.cursor.task ? current.cursor.task : '—'} modo=${current.cursor && current.cursor.mode ? current.cursor.mode : '—'}`);
-    console.log(`  ${c ? green : ''}Arquivo:${c ? reset : ''} ${path.join(p.runsDir, `${current.run_id}.json`)}`);
-    return;
-  }
-
-  if (opts.action === 'replay' && !opts.task) {
+  if (opts.action === 'status') {
+    const current = oxeOperational.readRunState(opts.dir, activeSession);
+    if (!current) {
+      console.log(`  ${yellow}Nenhum ACTIVE-RUN encontrado.${reset}`);
+      return;
+    }
+    console.log(`  ${c ? green : ''}Run:${c ? reset : ''} ${current.run_id}`);
+    console.log(`  ${c ? green : ''}Estado:${c ? reset : ''} ${current.status}`);
+    console.log(`  ${c ? green : ''}Cursor:${c ? reset : ''} onda=${current.cursor && current.cursor.wave != null ? current.cursor.wave : '—'} tarefa=${current.cursor && current.cursor.task ? current.cursor.task : '—'} modo=${current.cursor && current.cursor.mode ? current.cursor.mode : '—'}`);
+    console.log(`  ${c ? green : ''}Arquivo:${c ? reset : ''} ${path.join(p.runsDir, `${current.run_id}.json`)}`);
+    if (current.compiled_graph && current.compiled_graph.metadata) {
+      console.log(`  ${c ? green : ''}Graph:${c ? reset : ''} ${current.compiled_graph.metadata.node_count || 0} nós · ${current.compiled_graph.metadata.wave_count || 0} ondas`);
+    }
+    if (current.canonical_state && current.canonical_state.summary) {
+      console.log(`  ${c ? green : ''}Canonical:${c ? reset : ''} work_items=${current.canonical_state.summary.work_item_count || 0} · attempts=${current.canonical_state.summary.attempt_count || 0}`);
+    }
+    if (current.ci_checks && current.ci_checks.summary) {
+      console.log(`  ${c ? green : ''}CI:${c ? reset : ''} pass=${current.ci_checks.summary.pass || 0} fail=${current.ci_checks.summary.fail || 0} skip=${current.ci_checks.summary.skip || 0} error=${current.ci_checks.summary.error || 0}`);
+    }
+    if (current.projections && current.projections.generated_at) {
+      console.log(`  ${c ? green : ''}Projection:${c ? reset : ''} ${current.projections.generated_at}`);
+    }
+    return;
+  }
+
+  if (opts.action === 'replay' && !opts.task) {
     const report = oxeOperational.replayEvents(opts.dir, activeSession, {
       runId: opts.runId || undefined,
       fromEventId: opts.fromEventId || undefined,
@@ -3747,34 +3765,97 @@ function runRuntime(opts) {
     console.log(`  ${c ? green : ''}Ondas:${c ? reset : ''} ${report.waveIds.join(', ') || '—'}`);
     console.log(`  ${c ? green : ''}Tarefas:${c ? reset : ''} ${report.taskSequence.join(', ') || '—'}`);
     console.log(`  ${c ? green : ''}Falhas:${c ? reset : ''} ${report.failureEvents.length}`);
-    if (report.totalEvents > 0) {
-      console.log('');
-      const dim = c ? '\x1b[2m' : '';
-      console.log(`  ${dim}#   Tipo                    Wave    Task    Delta      Timestamp${c ? reset : ''}`);
-      for (let i = 0; i < Math.min(report.events.length, 50); i++) {
-        const e = report.events[i];
-        const delta = i > 0 ? `+${(e._delta_ms / 1000).toFixed(1)}s` : '—';
-        const num = String(i + 1).padStart(3);
-        const type = String(e.type).padEnd(22).slice(0, 22);
-        const wave = String(e.wave_id || '—').padEnd(7).slice(0, 7);
-        const task = String(e.task_id || '—').padEnd(7).slice(0, 7);
-        const deltaStr = delta.padStart(10);
-        console.log(`  ${num} ${type} ${wave} ${task} ${deltaStr}  ${e.timestamp}`);
-      }
+    if (report.totalEvents > 0) {
+      console.log('');
+      const dim = c ? '\x1b[2m' : '';
+      console.log(`  ${dim}#   Tipo                    Wave    Task    Delta      Timestamp${c ? reset : ''}`);
+      for (let i = 0; i < Math.min(report.events.length, 50); i++) {
+        const e = report.events[i];
+        const delta = i > 0 ? `+${(e._delta_ms / 1000).toFixed(1)}s` : '—';
+        const num = String(i + 1).padStart(3);
+        const type = String(e.type).padEnd(22).slice(0, 22);
+        const wave = String(e.wave_id || '—').padEnd(7).slice(0, 7);
+        const task = String(e.task_id || e.work_item_id || '—').padEnd(7).slice(0, 7);
+        const deltaStr = delta.padStart(10);
+        console.log(`  ${num} ${type} ${wave} ${task} ${deltaStr}  ${e.timestamp}`);
+      }
       if (report.events.length > 50) {
         console.log(`  … (${report.events.length - 50} mais)`);
       }
     }
     if (report._reportPath) {
       console.log(`\n  ${c ? green : ''}Relatório:${c ? reset : ''} ${report._reportPath}`);
-    }
-    return;
-  }
-
-  try {
-    const next = oxeOperational.applyRuntimeAction(opts.dir, activeSession, {
-      action: opts.action,
-      wave: opts.wave,
+    }
+    return;
+  }
+
+  if (opts.action === 'compile') {
+    try {
+      const compiled = oxeOperational.compileExecutionGraphFromArtifacts(opts.dir, activeSession);
+      const suite = oxeOperational.compileVerificationSuiteFromArtifacts(opts.dir, activeSession, {
+        runState: compiled.run,
+      });
+      console.log(`  ${c ? green : ''}✓${c ? reset : ''} Runtime compilado.`);
+      console.log(`  ${c ? green : ''}Run:${c ? reset : ''} ${compiled.run.run_id}`);
+      console.log(`  ${c ? green : ''}Graph:${c ? reset : ''} ${compiled.graph.metadata.node_count} nó(s) · ${compiled.graph.metadata.wave_count} onda(s)`);
+      console.log(`  ${c ? green : ''}Checks:${c ? reset : ''} ${Array.isArray(suite.suite.checks) ? suite.suite.checks.length : 0}`);
+      if (compiled.validationErrors.length) {
+        console.log(`  ${yellow}Validation:${reset} ${compiled.validationErrors.join(' | ')}`);
+      }
+      console.log(`  ${c ? green : ''}Arquivo:${c ? reset : ''} ${path.join(p.runsDir, `${compiled.run.run_id}.json`)}`);
+      return;
+    } catch (err) {
+      console.error(`${red}${err && err.message ? err.message : 'Falha ao compilar o runtime.'}${reset}`);
+      process.exit(1);
+    }
+  }
+
+  if (opts.action === 'project') {
+    try {
+      const projected = oxeOperational.projectRuntimeArtifacts(opts.dir, activeSession, { write: true });
+      console.log(`  ${c ? green : ''}✓${c ? reset : ''} Projeções geradas a partir do estado canônico.`);
+      console.log(`  ${c ? green : ''}Run:${c ? reset : ''} ${projected.run.run_id}`);
+      console.log(`  ${c ? green : ''}STATE:${c ? reset : ''} ${projected.paths.state}`);
+      console.log(`  ${c ? green : ''}PLAN:${c ? reset : ''} ${projected.paths.plan}`);
+      console.log(`  ${c ? green : ''}VERIFY:${c ? reset : ''} ${projected.paths.verify}`);
+      console.log(`  ${c ? green : ''}RUN-SUMMARY:${c ? reset : ''} ${projected.paths.runSummary}`);
+      console.log(`  ${c ? green : ''}PR-SUMMARY:${c ? reset : ''} ${projected.paths.prSummary}`);
+      return;
+    } catch (err) {
+      console.error(`${red}${err && err.message ? err.message : 'Falha ao projetar artefatos do runtime.'}${reset}`);
+      process.exit(1);
+    }
+  }
+
+  if (opts.action === 'ci') {
+    try {
+      const report = await oxeOperational.runRuntimeCiChecks(opts.dir, activeSession, {
+        runId: opts.runId || undefined,
+      });
+      console.log(`  ${c ? green : ''}Run:${c ? reset : ''} ${report.runId || '—'}`);
+      for (const result of report.results) {
+        const color = result.status === 'pass'
+          ? green
+          : result.status === 'skip'
+            ? dim
+            : red;
+        console.log(`  ${c ? color : ''}${result.status.toUpperCase()}${c ? reset : ''} ${result.check} · ${result.message}`);
+      }
+      console.log(`  ${c ? green : ''}Resumo:${c ? reset : ''} pass=${report.summary.pass} fail=${report.summary.fail} skip=${report.summary.skip} error=${report.summary.error}`);
+      if (!report.summary.allPassed) {
+        process.exitCode = 1;
+      }
+      return;
+    } catch (err) {
+      console.error(`${red}${err && err.message ? err.message : 'Falha ao executar checks do runtime.'}${reset}`);
+      process.exit(1);
+    }
+  }
+
+  try {
+    const next = oxeOperational.applyRuntimeAction(opts.dir, activeSession, {
+      action: opts.action,
+      wave: opts.wave,
       task: opts.task || null,
       mode: opts.mode || null,
       reason: opts.reason || '',
@@ -4427,9 +4508,12 @@ async function main() {
       console.error(`${yellow}Diretório não encontrado: ${runtime.dir}${reset}`);
       process.exit(1);
     }
-    runRuntime(runtime);
-    return;
-  }
+    runRuntime(runtime).catch((err) => {
+      console.error(`${red}${err && err.message ? err.message : 'Falha ao executar runtime.'}${reset}`);
+      process.exit(1);
+    });
+    return;
+  }
 
   if (command === 'plugins') {
     printBanner();

package/commands/oxe/ask.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:ask
-description: "Perguntar ao OXE sobre a situação atual com leitura robusta de STATE, sessão ativa e artefatos da trilha"
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe. Use: /oxe 'sua pergunta' — Perguntar ao OXE sobre a situação atual"
 argument-hint: "[pergunta em texto livre]"
 allowed-tools:
   - Read
@@ -42,6 +42,10 @@ oxe_semantics_hash: b3f89121879267f9
 
 <!-- oxe-reasoning-contract:end -->
 
+> **[DEPRECATED v1.1.0]** Este comando foi incorporado por `/oxe`.
+> Use: `/oxe "sua pergunta"` para perguntas situacionais.
+> Este alias continuará funcionando nesta versão por compatibilidade.
+
 **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/checkpoint.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:checkpoint
-description: OXE — Marco em .oxe/checkpoints/ + CHECKPOINTS.md
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe-execute. Use: /oxe-execute --checkpoint '<nome>'"
 argument-hint: "<slug> [nota]"
 allowed-tools:
   - Read

package/commands/oxe/compact.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:compact
-description: OXE — refresh codebase vs repo + CODEBASE-DELTA + RESUME (rotina de projeto)
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe-spec. Use: /oxe-spec --refresh para refresh incremental do codebase"
 oxe_workflow_slug: compact
 oxe_reasoning_mode: discovery
 oxe_question_policy: explore_first

package/commands/oxe/debug.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:debug
-description: OXE — Debug técnico durante execute (.oxe/DEBUG.md)
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe-execute. Use: /oxe-execute --debug"
 argument-hint: "[Tn ou erro/stack]"
 allowed-tools:
   - Read

package/commands/oxe/execute.md

@@ -1,7 +1,7 @@
 ---
 name: oxe:execute
-description: "Executar plano (solo ou com agentes): escolha Completo (1 sessão) | Por onda | Por tarefa — controle explícito de requisições"
-argument-hint: "[A=completo | B=por-onda | C=por-tarefa | onda N | Tn]"
+description: "Executar plano A/B/C. Flags: --note (obs), --debug, --deep-diagnosis, --checkpoint '<nome>', --iterative"
+argument-hint: "[A|B|C | --note 'texto' | --debug | --deep-diagnosis | --checkpoint '<nome>' | --iterative]"
 allowed-tools:
   - Read
   - Bash

package/commands/oxe/forensics.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:forensics
-description: OXE — Forensics pós-falha (.oxe/FORENSICS.md + próximo passo scan/plan/execute)
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe-execute. Use: /oxe-execute --deep-diagnosis"
 argument-hint: "[sintoma opcional]"
 allowed-tools:
   - Read

package/commands/oxe/loop.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:loop
-description: OXE — Execução iterativa de onda com retries automáticos e diagnóstico inline
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe-execute. Use: /oxe-execute --iterative"
 argument-hint: "onda <N> [max:<tentativas>]"
 allowed-tools:
   - Read

package/commands/oxe/milestone.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:milestone
-description: "Marcos de entrega (M-NN) — new, complete (arquiva SPEC/PLAN/VERIFY em .oxe/milestones/M-NN/), status, audit"
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe-session. Use: /oxe-session milestone new|complete|status|audit"
 argument-hint: "new <nome> | complete | status | audit"
 allowed-tools:
   - Read

package/commands/oxe/next.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:next
-description: Lê STATE.md e indica o próximo comando OXE lógico
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe. Use: /oxe (sem argumento) para o próximo passo"
 argument-hint: ""
 allowed-tools:
   - Read

package/commands/oxe/obs.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:obs
-description: "Observação contextual — registra em .oxe/OBSERVATIONS.md, incorporada automaticamente no próximo spec/plan/execute sem re-explicar"
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe-execute. Use: /oxe-execute --note 'sua observação'"
 argument-hint: "[observação: restrição, descoberta, preferência, risco ou decisão]"
 allowed-tools:
   - Read

package/commands/oxe/oxe.md

@@ -1,7 +1,7 @@
 ---
 name: oxe
-description: OXE — Entrada universal: próximo passo, roteamento de linguagem natural ou help dos 8 comandos essenciais
-argument-hint: "[contexto | 'help' | vazio]"
+description: OXE — Entrada universal: próximo passo, perguntas situacionais, roteamento ou help da trilha principal (6 comandos)
+argument-hint: "[contexto | 'help' | 'sua pergunta' | vazio]"
 allowed-tools:
   - Read
   - Bash
@@ -46,4 +46,4 @@ oxe_semantics_hash: d7f65cd3f77b0abc
 
 **Workflow canônico:** `oxe/workflows/oxe.md`
 
-Execute integralmente esse ficheiro. `$ARGUMENTS`: vazio → próximo passo; texto → roteamento inteligente; "help" → 8 comandos essenciais.
+Execute integralmente esse ficheiro. `$ARGUMENTS`: vazio → próximo passo; "help" → trilha principal (6 comandos + 2 avançados); pergunta situacional → situação atual com base nos artefatos; texto de ação → roteamento inteligente para o workflow correto.

package/commands/oxe/project.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:project
-description: OXE — Gestão de projeto: milestone (M-NN), workstream (trilhas paralelas), checkpoint (snapshot)
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe-session. Use: /oxe-session milestone|workstream. Checkpoint via /oxe-execute --checkpoint"
 argument-hint: "milestone new|complete|status|audit | workstream new|switch|list|close <nome> | checkpoint [slug]"
 allowed-tools:
   - Read

package/commands/oxe/research.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:research
-description: OXE — Pesquisa exploratória (notas datadas em .oxe/research/ + RESEARCH.md)
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe-spec. Use: /oxe-spec --research ou /oxe-spec --deep"
 argument-hint: "[âmbito: spike, mapa sistema, reversa, modernização, …]"
 allowed-tools:
   - Read

package/commands/oxe/retro.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:retro
-description: OXE — Retrospectiva de ciclo: sintetiza lições prescritivas em .oxe/LESSONS.md (alimenta ciclos futuros automaticamente)
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe-verify (retro automática). Use: /oxe-verify (ou --skip-retro para desativar)"
 argument-hint: "[opcional: contexto sobre o ciclo]"
 allowed-tools:
   - Read

package/commands/oxe/review-pr.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:review-pr
-description: OXE — Revisão de diff/PR: analisa alterações, riscos, convenções e sugestões acionáveis
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe-verify. Use: /oxe-verify --pr ou /oxe-verify --diff branchA...branchB"
 argument-hint: "<URL do PR ou branch:base..head>"
 allowed-tools:
   - Read

package/commands/oxe/route.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:route
-description: OXE — Router linguagem natural → um comando/workflow
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe. Use: /oxe 'sua intenção em linguagem natural'"
 argument-hint: "[frase do utilizador]"
 allowed-tools:
   - Read

package/commands/oxe/scan.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:scan
-description: Escaneia o repositório e gera mapa em .oxe/codebase/ + STATE.md
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe-spec. Use: /oxe-spec --refresh (incremental) ou /oxe-spec --full (completo)"
 argument-hint: "[área opcional, ex. auth, api]"
 allowed-tools:
   - Read

package/commands/oxe/security.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:security
-description: OXE — Auditoria de segurança OWASP (.oxe/SECURITY.md): P0 crítico / P1 alto / P2 médio
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe-verify. Use: /oxe-verify --security"
 argument-hint: "[opcional: categoria OWASP, módulo ou arquivo]"
 allowed-tools:
   - Read

package/commands/oxe/session.md

@@ -1,7 +1,7 @@
 ---
 name: oxe:session
-description: "Gerir sessões OXE: new, list, switch, resume, status, close, migrate"
-argument-hint: "[new <nome> | list | switch <id> | resume <id> | status | close | migrate <nome>]"
+description: "Gerir sessões, milestones e workstreams OXE (absorve /oxe-project, /oxe-milestone, /oxe-workstream)"
+argument-hint: "[new <nome> | list | switch <id> | close | migrate <nome> | milestone new|status|audit | workstream new|switch|list]"
 allowed-tools:
   - Read
   - Bash

package/commands/oxe/ship.md

@@ -0,0 +1,49 @@
+---
+name: oxe:ship
+description: "OXE — Entregar: cria commit local com mensagem gerada de SPEC+PLAN+VERIFY. Flags: --message, --amend, --verify-first, --dry-run"
+argument-hint: "[--message 'mensagem'] [--amend] [--verify-first] [--no-checks] [--dry-run]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+oxe_workflow_slug: ship
+oxe_reasoning_mode: execution
+oxe_question_policy: ask_high_impact_only
+oxe_output_contract: execution
+oxe_tool_profile: write_bounded
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 3893740934e4f82b
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** ship
+- **Modo:** execução
+- **Perguntas:** perguntar só alto impacto
+- **Saída esperada:** execução
+- **Perfil de ferramentas:** mutação limitada
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `3893740934e4f82b`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/ship.md` e `.oxe/context/packs/ship.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow ship --json`
+- Fazer reconhecimento curto antes de editar ou executar mutações.
+- Trabalhar no menor write set viável e validar após cada fatia relevante.
+- Parar e explicitar o bloqueio quando houver hipótese crítica não verificada.
+- **Seções esperadas:** Contexto lido · Alvo da mudança · Validação executada · Resultado · Próximo passo
+- **Bloqueios formais:** missing:verify_without_override · missing:tracked_changes
+- **Referência canónica:** `oxe/workflows/references/reasoning-execution.md`
+
+<!-- oxe-reasoning-contract:end -->
+
+**Workflow canônico:** `oxe/workflows/ship.md`
+
+Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa `$ARGUMENTS` como flags de entrega (`--message`, `--amend`, `--verify-first`, `--no-checks`, `--dry-run`).

package/commands/oxe/spec.md

@@ -1,7 +1,7 @@
 ---
 name: oxe:spec
-description: "Spec em 5 fases: perguntas → pesquisa → requisitos R-ID (v1/v2/fora) → roteiro ROADMAP.md → aprovação → plan"
-argument-hint: "[descrição da feature, ideia ou @arquivo.md com PRD]"
+description: "Spec em 5 fases. Flags: --refresh (scan incremental), --full (scan completo), --research (spike), --ui (gera UI-SPEC)"
+argument-hint: "[descrição da feature | --refresh | --full | --research | --ui]"
 allowed-tools:
   - Read
   - Write

package/commands/oxe/ui-review.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:ui-review
-description: OXE — Auditoria UI (.oxe/UI-REVIEW.md)
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe-verify. Use: /oxe-verify --ui"
 argument-hint: "[paths ou Tn opcional]"
 allowed-tools:
   - Read

package/commands/oxe/ui-spec.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:ui-spec
-description: OXE — Contrato UI (.oxe/UI-SPEC.md) a partir da SPEC
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe-spec. Use: /oxe-spec --ui para gerar contrato UI/UX"
 argument-hint: "[âmbito UI opcional]"
 allowed-tools:
   - Read

package/commands/oxe/validate-gaps.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:validate-gaps
-description: OXE — Auditoria Nyquist-lite (.oxe/VALIDATION-GAPS.md) após verify
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe-verify. Use: /oxe-verify --gaps"
 argument-hint: "[opcional: Tn ou A*]"
 allowed-tools:
   - Read

package/commands/oxe/verify.md

@@ -1,7 +1,7 @@
 ---
 name: oxe:verify
-description: Valida implementação contra SPEC e PLAN; produz checklist e gaps
-argument-hint: "[Tn opcional — focar uma tarefa]"
+description: "Valida e fecha o ciclo (retro automática). Flags: --gaps, --security, --ui, --pr, --diff, --skip-retro"
+argument-hint: "[Tn | --gaps | --security | --ui | --pr | --diff branchA...branchB | --skip-retro]"
 allowed-tools:
   - Read
   - Write

package/commands/oxe/workstream.md

@@ -1,6 +1,6 @@
 ---
 name: oxe:workstream
-description: "Trilhas paralelas — list, new <nome>, switch <nome>, status, close <nome> — artefatos independentes em .oxe/workstreams/<nome>/"
+description: "[DEPRECATED v1.1.0] Incorporado por /oxe-session. Use: /oxe-session workstream list|new|switch|close"
 argument-hint: "list | new <nome> | switch <nome> | status | close <nome>"
 allowed-tools:
   - Read

package/lib/runtime/audit/audit-trail.d.ts

@@ -0,0 +1,71 @@
+export interface AuditQueryFilter {
+    action?: AuditAction;
+    severity?: AuditSeverity;
+    runId?: string;
+    since?: string;
+}
+export interface RemoteAuditSink {
+    write(entry: AuditEntry): Promise<void>;
+    query(filter: AuditQueryFilter): Promise<AuditEntry[]>;
+}
+export interface AuditMetrics {
+    total_entries: number;
+    critical_count: number;
+    warn_count: number;
+    by_action: Partial<Record<AuditAction, number>>;
+    actors: string[];
+    oldest: string | null;
+    newest: string | null;
+}
+export type AuditAction = 'run_started' | 'run_completed' | 'run_paused' | 'run_recovered' | 'gate_requested' | 'gate_resolved' | 'policy_denied' | 'plugin_registered' | 'plugin_invoked' | 'secret_accessed' | 'infra_mutation' | 'pr_created' | 'merge_approved' | 'merge_blocked';
+export type AuditSeverity = 'info' | 'warn' | 'critical';
+export interface AuditEntry {
+    audit_id: string;
+    action: AuditAction;
+    severity: AuditSeverity;
+    run_id: string | null;
+    work_item_id: string | null;
+    actor: string;
+    resource: string | null;
+    detail: Record<string, unknown>;
+    timestamp: string;
+}
+export interface RunQuota {
+    run_id: string;
+    max_work_items: number;
+    max_mutations: number;
+    max_retries_total: number;
+    consumed_work_items: number;
+    consumed_mutations: number;
+    consumed_retries: number;
+}
+export interface QuotaViolation {
+    quota_type: 'work_items' | 'mutations' | 'retries';
+    limit: number;
+    consumed: number;
+}
+export declare class AuditTrail {
+    private readonly projectRoot;
+    private readonly remoteSink?;
+    constructor(projectRoot: string, remoteSink?: RemoteAuditSink | undefined);
+    record(action: AuditAction, actor: string, options?: {
+        runId?: string;
+        workItemId?: string;
+        resource?: string;
+        detail?: Record<string, unknown>;
+    }): AuditEntry;
+    query(filter?: {
+        action?: AuditAction;
+        severity?: AuditSeverity;
+        runId?: string;
+        since?: string;
+    }): AuditEntry[];
+    critical(): AuditEntry[];
+    metrics(): AuditMetrics;
+    private append;
+    private load;
+    private trailPath;
+}
+export declare function createQuota(runId: string, limits?: Partial<Omit<RunQuota, 'run_id' | 'consumed_work_items' | 'consumed_mutations' | 'consumed_retries'>>): RunQuota;
+export declare function checkQuota(quota: RunQuota): QuotaViolation | null;
+export declare function consumeQuota(quota: RunQuota, type: QuotaViolation['quota_type'], amount?: number): RunQuota;