oxe-cc 1.7.0 → 1.8.3

package/bin/oxe-cc.js

@@ -209,8 +209,8 @@ function buildInstallSummary(opts, fullLayout) {
   if (opts.copilotCli || opts.allAgents || anyGranularAgent(opts)) agentHint.push('CLIs / multi-agente');
   if (agentHint.length) {
     nextSteps.push({
-      desc: `Mapear o código no agente (${agentHint.join(', ')}):`,
-      cmd: '/oxe-scan',
+      desc: `Entrar no fluxo OXE no agente (${agentHint.join(', ')}) e deixar o router indicar o primeiro passo:`,
+      cmd: '/oxe',
     });
   } else if (opts.oxeOnly) {
     nextSteps.push({
@@ -220,7 +220,7 @@ function buildInstallSummary(opts, fullLayout) {
   } else {
     nextSteps.push({
       desc: 'Primeiro passo do fluxo no seu editor:',
-      cmd: '/oxe-scan',
+      cmd: '/oxe',
     });
   }
 
@@ -252,6 +252,7 @@ function buildUninstallFooter(u) {
   const bullets = [];
   const p = u.dryRun ? '[simulação] ' : '';
   const rm = u.dryRun ? 'Seriam removidos' : 'Removidos';
+  const localIdeArtifacts = shouldAlsoRemoveLocalIdeArtifacts(u);
   const granularAgents = [
     u.agentOpenCode ? 'OpenCode' : null,
     u.agentGemini ? 'Gemini' : null,
@@ -277,9 +278,9 @@ function buildUninstallFooter(u) {
   } else if (granularAgents.length) {
     bullets.push(`${p}${rm} apenas as integrações selecionadas: ${granularAgents.join(', ')}.`);
   }
-  if (u.ideLocal) {
+  if (localIdeArtifacts) {
     bullets.push(
-      `${p}${rm} integrações OXE no repositório (.cursor, .github, .claude, .copilot, .opencode, … conforme flags).`
+      `${p}${rm} integrações OXE no repositório (.cursor, .github, .claude, .copilot, .opencode, … conforme flags ou artefatos locais detectados).`
     );
   }
   if (u.globalCli) bullets.push(`${p}${rm} também o pacote npm global oxe-cc do PATH.`);
@@ -1527,20 +1528,22 @@ function printOxeHealthDiagnostics(target, c, diagOpts = {}) {
   if (r.eventsSummary) {
     console.log(`  ${c ? dim : ''}Tracing:${c ? reset : ''} ${r.eventsSummary.total} evento(s)`);
   }
-  if (r.planSelfEvaluation && r.planSelfEvaluation.hasSection) {
-    const best = r.planSelfEvaluation.bestPlan || '—';
-    const conf =
-      typeof r.planSelfEvaluation.confidence === 'number' ? `${r.planSelfEvaluation.confidence}%` : '—';
-    console.log(`  ${c ? dim : ''}Plano (autoavaliação):${c ? reset : ''} melhor=${best} | confiança=${conf}`);
-  }
-  if (typeof r.executionRationalityReady === 'boolean') {
-    console.log(
-      `  ${c ? dim : ''}Prontidão racional:${c ? reset : ''} implementation=${r.implementationPackReady ? 'ok' : 'pendente'} | anchors=${r.referenceAnchorsReady ? 'ok' : 'pendente'} | fixtures=${r.fixturePackReady ? 'ok' : 'pendente'}`
-    );
-  }
-  if (r.contextQuality) {
-    console.log(
-      `  ${c ? dim : ''}Contexto:${c ? reset : ''} score=${r.contextQuality.primaryScore != null ? r.contextQuality.primaryScore : '—'} | workflow=${r.contextQuality.primaryWorkflow || '—'} | status=${r.contextQuality.primaryStatus || '—'}`
+  if (r.planSelfEvaluation && r.planSelfEvaluation.hasSection) {
+    const best = r.planSelfEvaluation.bestPlan || '—';
+    const conf =
+      typeof r.planSelfEvaluation.confidence === 'number' ? `${r.planSelfEvaluation.confidence}%` : '—';
+    console.log(`  ${c ? dim : ''}Plano (autoavaliação):${c ? reset : ''} melhor=${best} | confiança=${conf}`);
+  }
+  if (r.executionRationality && r.executionRationality.applicable === false) {
+    console.log(`  ${c ? dim : ''}Prontidão racional:${c ? reset : ''} não aplicável ainda (PLAN.md ausente)`);
+  } else if (typeof r.executionRationalityReady === 'boolean') {
+    console.log(
+      `  ${c ? dim : ''}Prontidão racional:${c ? reset : ''} implementation=${r.implementationPackReady ? 'ok' : 'pendente'} | anchors=${r.referenceAnchorsReady ? 'ok' : 'pendente'} | fixtures=${r.fixturePackReady ? 'ok' : 'pendente'}`
+    );
+  }
+  if (r.contextQuality) {
+    console.log(
+      `  ${c ? dim : ''}Contexto:${c ? reset : ''} score=${r.contextQuality.primaryScore != null ? r.contextQuality.primaryScore : '—'} | workflow=${r.contextQuality.primaryWorkflow || '—'} | status=${r.contextQuality.primaryStatus || '—'}`
     );
   }
   if (r.semanticsDrift) {
@@ -1668,11 +1671,11 @@ function runStatusFull(target) {
     sp = oxeHealth.scopedOxePaths(target, activeSession);
   }
 
-  printSection('OXE ▸ status --full');
-  console.log(`  ${c ? green : ''}Projeto:${c ? reset : ''} ${c ? cyan : ''}${target}${c ? reset : ''}`);
-  console.log(`  ${c ? green : ''}Sessão:${c ? reset : ''} ${c ? cyan : ''}${activeSession || 'modo legado'}${c ? reset : ''}`);
-  console.log(`  ${c ? green : ''}Workspace mode:${c ? reset : ''} ${report.workspaceMode || 'oxe_project'}`);
-  console.log(`  ${c ? green : ''}Fase:${c ? reset : ''} ${report.phase || '—'}`);
+  printSection('OXE ▸ status --full');
+  console.log(`  ${c ? green : ''}Projeto:${c ? reset : ''} ${c ? cyan : ''}${target}${c ? reset : ''}`);
+  console.log(`  ${c ? green : ''}Sessão:${c ? reset : ''} ${c ? cyan : ''}${activeSession || '— (sem sessão ativa)'}${c ? reset : ''}`);
+  console.log(`  ${c ? green : ''}Workspace mode:${c ? reset : ''} ${report.workspaceMode || 'oxe_project'}`);
+  console.log(`  ${c ? green : ''}Fase:${c ? reset : ''} ${report.phase || '—'}`);
 
   const healthColor = report.healthStatus === 'healthy' ? green : report.healthStatus === 'warning' ? yellow : red;
   console.log(`  ${c ? green : ''}Saúde:${c ? reset : ''} ${c ? healthColor : ''}${report.healthStatus}${c ? reset : ''}`);
@@ -1687,6 +1690,14 @@ function runStatusFull(target) {
       console.log(`  ${c ? yellow : ''}  • ${warning}${c ? reset : ''}`);
     }
   }
+  if (report.codex && (report.codex.detected || report.codex.warnings.length)) {
+    console.log(`\n  ${c ? yellow : ''}Codex${c ? reset : ''}`);
+    console.log(`  ${c ? dim : ''}Prompts:${c ? reset : ''} ${report.codex.commandsReady ? 'ok' : 'pendente'} · ${displayPathForUser(report.codex.promptsDir)}`);
+    console.log(`  ${c ? dim : ''}Skills:${c ? reset : ''} ${report.codex.skillsReady ? 'ok' : 'pendente'} · ${displayPathForUser(report.codex.skillsRoot)}`);
+    for (const warning of report.codexWarn.slice(0, 3)) {
+      console.log(`  ${c ? yellow : ''}  • ${warning}${c ? reset : ''}`);
+    }
+  }
 
   // Coverage matrix
   const specPath = activeSession && sp.spec ? sp.spec : p.spec;
@@ -1702,41 +1713,41 @@ function runStatusFull(target) {
   console.log(`  ${coverageCell(codebaseExists, 'codebase scan')}   ${coverageCell(specExists, 'SPEC.md')}   ${coverageCell(planExists, 'PLAN.md')}   ${coverageCell(verifyExists, 'VERIFY.md')}   ${coverageCell(lessonsExists, 'LESSONS.md')}`);
 
   // Readiness gate
-  const packageMode = report.workspaceMode === 'product_package';
-  const ready = packageMode
-    ? Boolean(report.releaseReadiness && report.releaseReadiness.ok)
-    : specExists
-      && planExists
-      && report.executionRationalityReady
-      && !report.planWarn.length
-      && !report.runtimeWarn.length;
-  const gateColor = ready ? green : yellow;
-  console.log(`\n  ${c ? yellow : ''}Readiness gate${c ? reset : ''}`);
-  console.log(`  ${c ? gateColor : ''}${ready ? (packageMode ? '✓ Pronto para publicar' : '✓ Pronto para executar') : (packageMode ? '✗ Não pronto para publicar' : '✗ Não pronto para executar')}${c ? reset : ''}`);
-  if (packageMode) {
-    const releaseReadiness = report.releaseReadiness || { blockers: [], warnings: [] };
-    if (Array.isArray(releaseReadiness.blockers) && releaseReadiness.blockers.length) {
-      for (const blocker of releaseReadiness.blockers) {
-        console.log(`  ${c ? red : ''}  • ${blocker}${c ? reset : ''}`);
-      }
-    }
-    if (Array.isArray(releaseReadiness.warnings) && releaseReadiness.warnings.length) {
-      for (const warning of releaseReadiness.warnings) {
-        console.log(`  ${c ? yellow : ''}  • ${warning}${c ? reset : ''}`);
-      }
-    }
-  } else {
-    if (!specExists) console.log(`  ${c ? dim : ''}  • SPEC.md ausente — rode /oxe-spec${c ? reset : ''}`);
-    if (!planExists) console.log(`  ${c ? dim : ''}  • PLAN.md ausente — rode /oxe-plan${c ? reset : ''}`);
-    if (report.planWarn.length) {
-      for (const w of report.planWarn) {
-        console.log(`  ${c ? yellow : ''}  • ${w}${c ? reset : ''}`);
-      }
-    }
-    if (planExists) {
-      console.log(`  ${c ? dim : ''}  • Artefatos racionais:${c ? reset : ''} implementation=${report.implementationPackReady ? 'ok' : 'pendente'} · anchors=${report.referenceAnchorsReady ? 'ok' : 'pendente'} · fixtures=${report.fixturePackReady ? 'ok' : 'pendente'}`);
-    }
-  }
+  const packageMode = report.workspaceMode === 'product_package';
+  const ready = packageMode
+    ? Boolean(report.releaseReadiness && report.releaseReadiness.ok)
+    : specExists
+      && planExists
+      && report.executionRationalityReady
+      && !report.planWarn.length
+      && !report.runtimeWarn.length;
+  const gateColor = ready ? green : yellow;
+  console.log(`\n  ${c ? yellow : ''}Readiness gate${c ? reset : ''}`);
+  console.log(`  ${c ? gateColor : ''}${ready ? (packageMode ? '✓ Pronto para publicar' : '✓ Pronto para executar') : (packageMode ? '✗ Não pronto para publicar' : '✗ Não pronto para executar')}${c ? reset : ''}`);
+  if (packageMode) {
+    const releaseReadiness = report.releaseReadiness || { blockers: [], warnings: [] };
+    if (Array.isArray(releaseReadiness.blockers) && releaseReadiness.blockers.length) {
+      for (const blocker of releaseReadiness.blockers) {
+        console.log(`  ${c ? red : ''}  • ${blocker}${c ? reset : ''}`);
+      }
+    }
+    if (Array.isArray(releaseReadiness.warnings) && releaseReadiness.warnings.length) {
+      for (const warning of releaseReadiness.warnings) {
+        console.log(`  ${c ? yellow : ''}  • ${warning}${c ? reset : ''}`);
+      }
+    }
+  } else {
+    if (!specExists) console.log(`  ${c ? dim : ''}  • SPEC.md ausente — rode /oxe-spec${c ? reset : ''}`);
+    if (!planExists) console.log(`  ${c ? dim : ''}  • PLAN.md ausente — rode /oxe-plan${c ? reset : ''}`);
+    if (report.planWarn.length) {
+      for (const w of report.planWarn) {
+        console.log(`  ${c ? yellow : ''}  • ${w}${c ? reset : ''}`);
+      }
+    }
+    if (planExists) {
+      console.log(`  ${c ? dim : ''}  • Artefatos racionais:${c ? reset : ''} implementation=${report.implementationPackReady ? 'ok' : 'pendente'} · anchors=${report.referenceAnchorsReady ? 'ok' : 'pendente'} · fixtures=${report.fixturePackReady ? 'ok' : 'pendente'}`);
+    }
+  }
 
   // Active run summary
   if (report.activeRun) {
@@ -1822,24 +1833,24 @@ function runStatusFull(target) {
   }
 
   // Plan self-evaluation
-  if (!packageMode && report.planSelfEvaluation) {
-    const pse = report.planSelfEvaluation;
-    const threshold = report.planConfidenceThreshold || 90;
-    console.log(`\n  ${c ? yellow : ''}Autoavaliação do plano${c ? reset : ''}`);
-    if (pse.best_plan_current != null) {
-      const bestColor = pse.best_plan_current ? green : red;
-      console.log(`  ${c ? dim : ''}Melhor plano atual:${c ? reset : ''} ${c ? bestColor : ''}${pse.best_plan_current ? 'sim' : 'não'}${c ? reset : ''}`);
-    }
-    if (pse.confidence != null) {
-      const confColor = report.planConfidenceExecutable
-        ? green
-        : Number(pse.confidence) >= Math.max(80, threshold - 10)
-          ? yellow
-          : red;
-      console.log(`  ${c ? dim : ''}Confiança:${c ? reset : ''} ${c ? confColor : ''}${pse.confidence}%${c ? reset : ''}`);
-      console.log(`  ${c ? dim : ''}Gate executável:${c ? reset : ''} > ${threshold}%${pse.executable ? ' (atingido)' : ' (ainda não atingido)'}`);
-    }
-  }
+  if (!packageMode && report.planSelfEvaluation) {
+    const pse = report.planSelfEvaluation;
+    const threshold = report.planConfidenceThreshold || 90;
+    console.log(`\n  ${c ? yellow : ''}Autoavaliação do plano${c ? reset : ''}`);
+    if (pse.best_plan_current != null) {
+      const bestColor = pse.best_plan_current ? green : red;
+      console.log(`  ${c ? dim : ''}Melhor plano atual:${c ? reset : ''} ${c ? bestColor : ''}${pse.best_plan_current ? 'sim' : 'não'}${c ? reset : ''}`);
+    }
+    if (pse.confidence != null) {
+      const confColor = report.planConfidenceExecutable
+        ? green
+        : Number(pse.confidence) >= Math.max(80, threshold - 10)
+          ? yellow
+          : red;
+      console.log(`  ${c ? dim : ''}Confiança:${c ? reset : ''} ${c ? confColor : ''}${pse.confidence}%${c ? reset : ''}`);
+      console.log(`  ${c ? dim : ''}Gate executável:${c ? reset : ''} > ${threshold}%${pse.executable ? ' (atingido)' : ' (ainda não atingido)'}`);
+    }
+  }
 
   console.log(`\n  ${c ? dim : ''}Próximo passo:${c ? reset : ''} ${c ? cyan : ''}${report.next && report.next.cursorCmd ? report.next.cursorCmd : '—'}${c ? reset : ''}`);
   console.log(`  ${c ? dim : ''}Motivo:${c ? reset : ''} ${report.next && report.next.reason ? report.next.reason : '—'}`);
@@ -1858,13 +1869,13 @@ function runStatus(target, opts = {}) {
   const next = report.next;
 
   if (opts.json) {
-    /** @type {Record<string, unknown>} */
-    const payload = {
-      oxeStatusSchema: 5,
-      projectRoot: path.resolve(target),
-      workspaceMode: report.workspaceMode || 'oxe_project',
-      releaseReadiness: report.releaseReadiness || null,
-      nextStep: report.next.step,
+    /** @type {Record<string, unknown>} */
+    const payload = {
+      oxeStatusSchema: 5,
+      projectRoot: path.resolve(target),
+      workspaceMode: report.workspaceMode || 'oxe_project',
+      releaseReadiness: report.releaseReadiness || null,
+      nextStep: report.next.step,
       cursorCmd: report.next.cursorCmd,
       reason: report.next.reason,
       artifacts: report.next.artifacts,
@@ -1873,18 +1884,18 @@ function runStatus(target, opts = {}) {
       activeSession: report.activeSession,
       scanDate: report.scanDate,
       staleScan: report.stale,
-      compactDate: report.compactDate,
-      staleCompact: report.staleCompact,
-      planSelfEvaluation: report.planSelfEvaluation,
-      planConfidenceThreshold: report.planConfidenceThreshold,
-      planConfidenceExecutable: report.planConfidenceExecutable,
-      implementationPackReady: report.implementationPackReady,
-      referenceAnchorsReady: report.referenceAnchorsReady,
-      fixturePackReady: report.fixturePackReady,
-      executionRationalityReady: report.executionRationalityReady,
-      criticalExecutionGaps: report.criticalExecutionGaps,
-      executionRationality: report.executionRationality,
-      planReviewStatus: report.planReviewStatus,
+      compactDate: report.compactDate,
+      staleCompact: report.staleCompact,
+      planSelfEvaluation: report.planSelfEvaluation,
+      planConfidenceThreshold: report.planConfidenceThreshold,
+      planConfidenceExecutable: report.planConfidenceExecutable,
+      implementationPackReady: report.implementationPackReady,
+      referenceAnchorsReady: report.referenceAnchorsReady,
+      fixturePackReady: report.fixturePackReady,
+      executionRationalityReady: report.executionRationalityReady,
+      criticalExecutionGaps: report.criticalExecutionGaps,
+      executionRationality: report.executionRationality,
+      planReviewStatus: report.planReviewStatus,
       activeRun: report.activeRun,
       eventsSummary: report.eventsSummary,
       runtimeMode: report.runtimeMode,
@@ -1909,6 +1920,7 @@ function runStatus(target, opts = {}) {
       azureActive: report.azureActive,
       azure: report.azure,
       copilot: report.copilot,
+      codex: report.codex,
       contextPacks: report.contextPacks,
       contextQuality: report.contextQuality,
       semanticsDrift: report.semanticsDrift,
@@ -1927,6 +1939,7 @@ function runStatus(target, opts = {}) {
         sessionWarnings: report.sessionWarn,
         installWarnings: report.installWarn,
         copilotWarnings: report.copilotWarn,
+        codexWarnings: report.codexWarn,
         contextWarnings: report.contextWarn,
         semanticsWarnings: report.semanticsWarn,
         summaryGapWarning: report.summaryGapWarn,
@@ -1941,10 +1954,10 @@ function runStatus(target, opts = {}) {
     return;
   }
 
-  printSection('OXE ▸ status');
-  const c = useAnsiColors();
-  console.log(`  ${c ? green : ''}Projeto:${c ? reset : ''} ${c ? cyan : ''}${target}${c ? reset : ''}`);
-  console.log(`  ${c ? dim : ''}Workspace mode:${c ? reset : ''} ${report.workspaceMode || 'oxe_project'}`);
+  printSection('OXE ▸ status');
+  const c = useAnsiColors();
+  console.log(`  ${c ? green : ''}Projeto:${c ? reset : ''} ${c ? cyan : ''}${target}${c ? reset : ''}`);
+  console.log(`  ${c ? dim : ''}Workspace mode:${c ? reset : ''} ${report.workspaceMode || 'oxe_project'}`);
 
   const wfTgt = oxeWorkflows.resolveWorkflowsDir(target);
   if (!wfTgt) {
@@ -1962,6 +1975,8 @@ function runStatus(target, opts = {}) {
   const _claudeLocal = path.join(target, 'commands', 'oxe');
   const _claudeGlobal = path.join(require('os').homedir(), '.claude', 'commands');
   ideStatusLines.push(`Claude Code ${fs.existsSync(_claudeLocal) || fs.existsSync(_claudeGlobal) ? (c ? green + '✓' + reset : '✓') : (c ? dim + '✗' + reset : '✗')}`);
+  const _codex = report.codex || oxeHealth.codexIntegrationReport(target);
+  ideStatusLines.push(`Codex ${_codex.commandsReady ? (c ? green + '✓' + reset : '✓') : (c ? dim + '✗' + reset : '✗')}`);
   console.log(`\n  ${c ? dim : ''}IDEs:${c ? reset : ''} ${ideStatusLines.join('  ')}`);
 
   // Gates pending in default view
@@ -1975,24 +1990,24 @@ function runStatus(target, opts = {}) {
   }
 
   // Explicit blockage diagnosis
-  const packageMode = report.workspaceMode === 'product_package';
-  const specMissing = !fs.existsSync(path.join(target, '.oxe', 'SPEC.md'));
-  const planMissing = !fs.existsSync(path.join(target, '.oxe', 'PLAN.md'));
-  const verifyMissing = !fs.existsSync(path.join(target, '.oxe', 'VERIFY.md'));
-  if (packageMode) {
-    const releaseReadiness = report.releaseReadiness || { ok: false, blockers: [], warnings: [] };
-    if (!releaseReadiness.ok && Array.isArray(releaseReadiness.blockers) && releaseReadiness.blockers.length) {
-      console.log(`  ${c ? yellow : ''}⚠ Release blockers:${c ? reset : ''} ${releaseReadiness.blockers[0]}`);
-    } else if (Array.isArray(releaseReadiness.warnings) && releaseReadiness.warnings.length) {
-      console.log(`  ${c ? dim : ''}Obs.:${c ? reset : ''} release warnings ativas — ${releaseReadiness.warnings[0]}`);
-    }
-  } else if (specMissing) {
-    console.log(`  ${c ? yellow : ''}⚠ Bloqueio:${c ? reset : ''} SPEC.md ausente — rode ${c ? cyan : ''}/oxe-spec${c ? reset : ''} antes de planejar`);
-  } else if (planMissing) {
-    console.log(`  ${c ? yellow : ''}⚠ Bloqueio:${c ? reset : ''} PLAN.md ausente — rode ${c ? cyan : ''}/oxe-plan${c ? reset : ''}`);
-  } else if (verifyMissing && !planMissing) {
-    console.log(`  ${c ? dim : ''}Obs.:${c ? reset : ''} VERIFY.md ainda não gerado — rode ${c ? cyan : ''}/oxe-verify${c ? reset : ''} após executar`);
-  }
+  const packageMode = report.workspaceMode === 'product_package';
+  const specMissing = !fs.existsSync(path.join(target, '.oxe', 'SPEC.md'));
+  const planMissing = !fs.existsSync(path.join(target, '.oxe', 'PLAN.md'));
+  const verifyMissing = !fs.existsSync(path.join(target, '.oxe', 'VERIFY.md'));
+  if (packageMode) {
+    const releaseReadiness = report.releaseReadiness || { ok: false, blockers: [], warnings: [] };
+    if (!releaseReadiness.ok && Array.isArray(releaseReadiness.blockers) && releaseReadiness.blockers.length) {
+      console.log(`  ${c ? yellow : ''}⚠ Release blockers:${c ? reset : ''} ${releaseReadiness.blockers[0]}`);
+    } else if (Array.isArray(releaseReadiness.warnings) && releaseReadiness.warnings.length) {
+      console.log(`  ${c ? dim : ''}Obs.:${c ? reset : ''} release warnings ativas — ${releaseReadiness.warnings[0]}`);
+    }
+  } else if (specMissing) {
+    console.log(`  ${c ? yellow : ''}⚠ Bloqueio:${c ? reset : ''} SPEC.md ausente — rode ${c ? cyan : ''}/oxe-spec${c ? reset : ''} antes de planejar`);
+  } else if (planMissing) {
+    console.log(`  ${c ? yellow : ''}⚠ Bloqueio:${c ? reset : ''} PLAN.md ausente — rode ${c ? cyan : ''}/oxe-plan${c ? reset : ''}`);
+  } else if (verifyMissing && !planMissing) {
+    console.log(`  ${c ? dim : ''}Obs.:${c ? reset : ''} VERIFY.md ainda não gerado — rode ${c ? cyan : ''}/oxe-verify${c ? reset : ''} após executar`);
+  }
 
   if (opts.hints) {
     console.log(`\n  ${c ? cyan : ''}Lembretes (rotina OXE)${reset}`);
@@ -2090,10 +2105,18 @@ function runDoctor(target, options = {}) {
     .sort();
 
   if (!wfTgt) {
-    console.log(
-      `${yellow}AVISO${reset} Não há oxe/workflows/ nem .oxe/workflows/ neste projeto — rode ${cyan}npx oxe-cc@latest${reset} para instalar.`
-    );
-    process.exit(1);
+    // If the project has .oxe/runs/ it's a runtime-only project — workflows are optional
+    const hasRuntimeRuns = fs.existsSync(path.join(target, '.oxe', 'runs'));
+    if (hasRuntimeRuns) {
+      console.log(`${green}OK${reset} Runtime-only project (.oxe/runs/ presente) — workflows não obrigatórios.`);
+      console.log(`${c ? dim : ''}  Para instalar workflows completos: ${cyan}npx oxe-cc@latest${reset}`);
+    } else {
+      console.log(
+        `${yellow}AVISO${reset} Não há oxe/workflows/ nem .oxe/workflows/ neste projeto — rode ${cyan}npx oxe-cc@latest${reset} para instalar.`
+      );
+      process.exit(1);
+    }
+    return;
   }
 
   const actual = fs
@@ -2178,6 +2201,8 @@ function runDoctor(target, options = {}) {
     }
   }
 
+  const report = oxeHealth.buildHealthReport(target);
+
   // IDE health gates
   console.log('');
   const ideChecks = [];
@@ -2192,22 +2217,44 @@ function runDoctor(target, options = {}) {
 
   const claudeLocalDir = path.join(target, 'commands', 'oxe');
   const claudeGlobalDir = path.join(require('os').homedir(), '.claude', 'commands');
-  const claudeReady = fs.existsSync(claudeLocalDir) || fs.existsSync(claudeGlobalDir);
-  ideChecks.push({ label: 'Claude Code', ready: claudeReady, hint: 'commands/oxe/ ou ~/.claude/commands/' });
+  const claudeLocalReady = fs.existsSync(claudeLocalDir);
+  const claudeGlobalReady = fs.existsSync(claudeGlobalDir);
+  ideChecks.push({
+    label: 'Claude Code',
+    ready: claudeLocalReady || claudeGlobalReady,
+    hint: claudeLocalReady
+      ? 'commands/oxe/'
+      : claudeGlobalReady
+        ? '~/.claude/commands/ (global do utilizador)'
+        : 'commands/oxe/ ou ~/.claude/commands/',
+    status: claudeLocalReady ? 'local' : claudeGlobalReady ? 'global_only' : 'missing',
+  });
+
+  const codexReport = oxeHealth.codexIntegrationReport(target);
+  ideChecks.push({
+    label: 'Codex',
+    ready: codexReport.commandsReady,
+    hint: codexReport.promptSource === 'workspace'
+      ? '.codex/prompts/oxe.md'
+      : codexReport.promptSource === 'global'
+        ? '~/.codex/prompts/oxe.md (global do utilizador)'
+        : '.codex/prompts/oxe.md ou ~/.codex/prompts/oxe.md',
+    status: codexReport.promptSource,
+  });
 
   for (const ide of ideChecks) {
     if (ide.ready) {
-      console.log(`${c ? green : ''}OK${c ? reset : ''} ${ide.label} pronto (${ide.hint})`);
+      const suffix = ide.status === 'global_only' || ide.status === 'global'
+        ? ' — apenas global'
+        : '';
+      console.log(`${c ? green : ''}OK${c ? reset : ''} ${ide.label} pronto (${ide.hint})${suffix}`);
     } else {
       console.log(`${c ? dim : ''}Obs.:${c ? reset : ''} ${ide.label} não detectado — esperado ${ide.hint}`);
     }
   }
 
   // Runtime compilation check
-  const runtimeCompiledPath = path.join(target, 'lib', 'runtime', 'index.js');
-  const runtimeDistPath = path.join(target, 'packages', 'runtime', 'dist-tests');
-  const runtimeCompiled = fs.existsSync(runtimeCompiledPath) || fs.existsSync(runtimeDistPath);
-  if (runtimeCompiled) {
+  if (report.runtimeMode && report.runtimeMode.enterprise_available) {
     console.log(`${c ? green : ''}OK${c ? reset : ''} Runtime compilado detectado — modo enterprise disponível`);
   } else {
     console.log(`${c ? dim : ''}Obs.:${c ? reset : ''} Runtime não compilado — operando em modo legado (sem perda de UX)`);
@@ -2215,7 +2262,7 @@ function runDoctor(target, options = {}) {
 
   // Readiness gate summary
   const stateFilePath = path.join(target, '.oxe', 'STATE.md');
-  let readinessCmd = '/oxe-scan';
+  let readinessCmd = '/oxe';
   let readinessDesc = 'Nenhum STATE.md encontrado';
   if (fs.existsSync(stateFilePath)) {
     try {
@@ -2223,7 +2270,7 @@ function runDoctor(target, options = {}) {
       const phaseMatch = stateContent.match(/fase[:\s]+([a-z_]+)/i) || stateContent.match(/phase[:\s]+([a-z_]+)/i) || stateContent.match(/status[:\s]+([a-z_]+)/i);
       const phase = phaseMatch ? phaseMatch[1].toLowerCase() : 'init';
       const phaseMap = {
-        init: { cmd: '/oxe-scan', desc: 'Pronto para /oxe-scan' },
+        init: { cmd: '/oxe', desc: 'Pronto para /oxe' },
         scan_complete: { cmd: '/oxe-spec', desc: 'Pronto para /oxe-spec' },
         spec_complete: { cmd: '/oxe-plan', desc: 'Pronto para /oxe-plan' },
         plan_complete: { cmd: '/oxe-execute', desc: 'Pronto para /oxe-execute' },
@@ -2245,7 +2292,6 @@ function runDoctor(target, options = {}) {
   }
 
   printOxeHealthDiagnostics(target, c);
-  const report = oxeHealth.buildHealthReport(target);
   const statusColor = report.healthStatus === 'healthy' ? green : report.healthStatus === 'warning' ? yellow : red;
   console.log(`\n  ${statusColor}Diagnóstico ${report.healthStatus}${reset}`);
   if (report.healthStatus === 'broken') {
@@ -2260,7 +2306,7 @@ function runDoctor(target, options = {}) {
       `Saúde lógica: ${report.healthStatus}`,
     ],
     nextSteps: [
-      { desc: 'Mapear ou atualizar o codebase no agente:', cmd: '/oxe-scan' },
+      { desc: 'Entrar no fluxo OXE e deixar o router apontar o primeiro passo:', cmd: '/oxe' },
       { desc: 'Ver ajuda e ordem dos passos OXE:', cmd: '/oxe-help' },
       { desc: 'Reinstalar ou atualizar arquivos do OXE:', cmd: 'npx oxe-cc@latest --force' },
     ],
@@ -2481,7 +2527,7 @@ ${cyan}oxe-cc${reset} — instala workflows OXE (núcleo .oxe/ + integrações:
     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|compile|verify|project|ci|promote|recover|gates|agents> [opções] [pasta-do-projeto]
+  npx oxe-cc runtime <status|start|pause|resume|replay|compile|verify|project|ci|promote|recover|gates|agents|execute> [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]
@@ -2680,7 +2726,19 @@ function runInstall(opts) {
   assertNotWslWindowsNode();
   const home = os.homedir();
   const prevManifest = oxeManifest.loadFileManifest(home);
-  oxeManifest.backupModifiedFromManifest(home, prevManifest, opts, { yellow, cyan, dim, reset });
+  const backupScopeRoots = [target];
+  const installAgentPaths = oxeAgentInstall.buildAgentInstallPaths(!opts.ideLocal, target);
+  if (opts.cursor) backupScopeRoots.push(installCursorBase(opts));
+  if (opts.copilot) backupScopeRoots.push(path.join(target, '.github'));
+  if (opts.copilotCli || opts.allAgents) {
+    backupScopeRoots.push(installClaudeBase(opts), installCopilotCliHome(opts));
+  }
+  if (opts.agentOpenCode || opts.allAgents) backupScopeRoots.push(...installAgentPaths.opencodeCommandDirs);
+  if (opts.agentGemini || opts.allAgents) backupScopeRoots.push(installAgentPaths.geminiCommandsBase);
+  if (opts.agentCodex || opts.allAgents) backupScopeRoots.push(installAgentPaths.codexPromptsDir, installAgentPaths.codexAgentsSkillsRoot);
+  if (opts.agentWindsurf || opts.allAgents) backupScopeRoots.push(installAgentPaths.windsurfWorkflowsDir);
+  if (opts.agentAntigravity || opts.allAgents) backupScopeRoots.push(installAgentPaths.antigravitySkillsRoot);
+  oxeManifest.backupModifiedFromManifest(home, prevManifest, opts, { yellow, cyan, dim, reset }, { scopeRoots: backupScopeRoots });
 
   printSection('OXE ▸ Instalação no projeto');
   const c = useAnsiColors();
@@ -2720,7 +2778,7 @@ function runInstall(opts) {
   }
 
   const copyOpts = { dryRun: opts.dryRun, force: opts.force };
-  const agentPaths = oxeAgentInstall.buildAgentInstallPaths(!opts.ideLocal, target);
+  const agentPaths = installAgentPaths;
 
   if (fullLayout) {
     copyDir(path.join(PKG_ROOT, 'oxe'), path.join(target, 'oxe'), copyOpts, false);
@@ -2730,14 +2788,14 @@ function runInstall(opts) {
     copyDir(path.join(PKG_ROOT, 'oxe', 'templates'), path.join(nested, 'templates'), copyOpts, true);
     // Personas: copiar para .oxe/personas/ (não sobrescreve personalizações do projeto)
     const personasSrc = path.join(PKG_ROOT, 'oxe', 'personas');
-    if (fs.existsSync(personasSrc)) {
-      copyDir(personasSrc, path.join(nested, 'personas'), copyOpts, false);
-    }
-    const agentsSrc = path.join(PKG_ROOT, 'oxe', 'agents');
-    if (fs.existsSync(agentsSrc)) {
-      copyDir(agentsSrc, path.join(nested, 'agents'), copyOpts, false);
-    }
-    // Schemas: copiar para .oxe/schemas/ (ex.: plan-agents.schema.json para validação local)
+    if (fs.existsSync(personasSrc)) {
+      copyDir(personasSrc, path.join(nested, 'personas'), copyOpts, false);
+    }
+    const agentsSrc = path.join(PKG_ROOT, 'oxe', 'agents');
+    if (fs.existsSync(agentsSrc)) {
+      copyDir(agentsSrc, path.join(nested, 'agents'), copyOpts, false);
+    }
+    // Schemas: copiar para .oxe/schemas/ (ex.: plan-agents.schema.json para validação local)
     const schemasSrc = path.join(PKG_ROOT, 'oxe', 'schemas');
     if (fs.existsSync(schemasSrc)) {
       copyDir(schemasSrc, path.join(nested, 'schemas'), copyOpts, false);
@@ -2752,11 +2810,11 @@ function runInstall(opts) {
     if (fs.existsSync(cRules)) copyDir(cRules, path.join(cursorBase, 'rules'), copyOpts, idePathRewrite);
   }
 
-  const doAgentClis = opts.copilotCli || opts.allAgents;
-  if (doAgentClis) {
-    const cCmd = path.join(PKG_ROOT, '.cursor', 'commands');
-    const canonicalAgents = path.join(PKG_ROOT, 'oxe', 'agents');
-    const clBase = installClaudeBase(opts);
+  const doAgentClis = opts.copilotCli || opts.allAgents;
+  if (doAgentClis) {
+    const cCmd = path.join(PKG_ROOT, '.cursor', 'commands');
+    const canonicalAgents = path.join(PKG_ROOT, 'oxe', 'agents');
+    const clBase = installClaudeBase(opts);
     const cpHome = installCopilotCliHome(opts);
     const clDest = path.join(clBase, 'commands');
     const cpCmdDest = path.join(cpHome, 'commands');
@@ -2765,24 +2823,24 @@ function runInstall(opts) {
       console.log(
         `  ${c ? green : ''}cli${c ? reset : ''}   ${c ? dim : ''}Claude/Copilot: skills em${c ? reset : ''} ${c ? cyan : ''}${cpSkills}${c ? reset : ''} ${c ? dim : ''}(/oxe, /oxe-scan, …); comandos .md:${c ? reset : ''} ${c ? cyan : ''}${clDest}${c ? reset : ''} ${c ? dim : ''}+${c ? reset : ''} ${c ? cyan : ''}${cpCmdDest}${c ? reset : ''}`
       );
-      installOxeCopilotCliSkills(cCmd, cpHome, copyOpts, idePathRewrite);
-      copyDir(cCmd, clDest, copyOpts, idePathRewrite);
-      copyDir(cCmd, cpCmdDest, copyOpts, idePathRewrite);
-      if (fs.existsSync(canonicalAgents)) {
-        oxeAgentInstall.installCanonicalAgentMarkdowns(
-          canonicalAgents,
-          agentPaths.claudeAgentsDir,
-          copyOpts
-        );
-      }
-    } else {
+      installOxeCopilotCliSkills(cCmd, cpHome, copyOpts, idePathRewrite);
+      copyDir(cCmd, clDest, copyOpts, idePathRewrite);
+      copyDir(cCmd, cpCmdDest, copyOpts, idePathRewrite);
+      if (fs.existsSync(canonicalAgents)) {
+        oxeAgentInstall.installCanonicalAgentMarkdowns(
+          canonicalAgents,
+          agentPaths.claudeAgentsDir,
+          copyOpts
+        );
+      }
+    } else {
       console.warn(`${yellow}aviso:${reset} pasta ausente ${cCmd} — ignorando comandos CLI`);
     }
   }
 
-  const cCmdAgents = path.join(PKG_ROOT, '.cursor', 'commands');
-  const canonicalAgents = path.join(PKG_ROOT, 'oxe', 'agents');
-  if (fs.existsSync(cCmdAgents) && (opts.allAgents || anyGranularAgent(opts))) {
+  const cCmdAgents = path.join(PKG_ROOT, '.cursor', 'commands');
+  const canonicalAgents = path.join(PKG_ROOT, 'oxe', 'agents');
+  if (fs.existsSync(cCmdAgents) && (opts.allAgents || anyGranularAgent(opts))) {
     const logO = (d) => console.log(`${dim}omitido${reset} ${d} (já existe — use --force)`);
     const logW = (msg) => console.log(`${dim}agents${reset}  ${msg}`);
     console.log(
@@ -2800,41 +2858,41 @@ function runInstall(opts) {
     if (opts.agentCodex || opts.allAgents) {
       oxeAgentInstall.installCodexPrompts(cCmdAgents, agentPaths, copyOpts, idePathRewrite, logO, logW);
     }
-    if (opts.agentAntigravity || opts.allAgents) {
-      oxeAgentInstall.installSkillTreeFromCursorCommands(
+    if (opts.agentAntigravity || opts.allAgents) {
+      oxeAgentInstall.installSkillTreeFromCursorCommands(
         cCmdAgents,
         agentPaths.antigravitySkillsRoot,
         copyOpts,
         idePathRewrite,
         logO,
-        logW
-      );
-      oxeAgentInstall.installCanonicalAgentSkills(
-        canonicalAgents,
-        agentPaths.antigravitySkillsRoot,
-        copyOpts,
-        logO,
-        logW
-      );
-    }
-    if (opts.agentCodex || opts.allAgents) {
-      oxeAgentInstall.installSkillTreeFromCursorCommands(
+        logW
+      );
+      oxeAgentInstall.installCanonicalAgentSkills(
+        canonicalAgents,
+        agentPaths.antigravitySkillsRoot,
+        copyOpts,
+        logO,
+        logW
+      );
+    }
+    if (opts.agentCodex || opts.allAgents) {
+      oxeAgentInstall.installSkillTreeFromCursorCommands(
         cCmdAgents,
         agentPaths.codexAgentsSkillsRoot,
         copyOpts,
         idePathRewrite,
         logO,
-        logW
-      );
-      oxeAgentInstall.installCanonicalAgentSkills(
-        canonicalAgents,
-        agentPaths.codexAgentsSkillsRoot,
-        copyOpts,
-        logO,
-        logW
-      );
-    }
-  }
+        logW
+      );
+      oxeAgentInstall.installCanonicalAgentSkills(
+        canonicalAgents,
+        agentPaths.codexAgentsSkillsRoot,
+        copyOpts,
+        logO,
+        logW
+      );
+    }
+  }
 
   if (opts.copilot) {
     const gh = path.join(PKG_ROOT, '.github');
@@ -2924,11 +2982,11 @@ function runInstall(opts) {
       addTracked(copilotPromptsDirPath(opts), (n) => n.startsWith('oxe-'));
       trackFile(copilotWorkspaceManifestPath(opts));
     }
-    trackFile(runtimeSemanticsManifestPath(opts));
-    if (opts.copilotCli || opts.allAgents) {
-      addTracked(path.join(installClaudeBase(opts), 'commands'), (n) => oxeAgentInstall.isOxeCommandMarkdownName(n));
-      addTracked(agentPaths.claudeAgentsDir, (n) => oxeAgentInstall.isOxeAgentMarkdownName(n));
-      addTracked(path.join(cpCliHome, 'commands'), (n) => oxeAgentInstall.isOxeCommandMarkdownName(n));
+    trackFile(runtimeSemanticsManifestPath(opts));
+    if (opts.copilotCli || opts.allAgents) {
+      addTracked(path.join(installClaudeBase(opts), 'commands'), (n) => oxeAgentInstall.isOxeCommandMarkdownName(n));
+      addTracked(agentPaths.claudeAgentsDir, (n) => oxeAgentInstall.isOxeAgentMarkdownName(n));
+      addTracked(path.join(cpCliHome, 'commands'), (n) => oxeAgentInstall.isOxeCommandMarkdownName(n));
       const skRoot = path.join(cpCliHome, 'skills');
       if (fs.existsSync(skRoot)) {
         for (const sub of fs.readdirSync(skRoot, { withFileTypes: true })) {
@@ -3064,8 +3122,8 @@ function uninstallLocalIdeFromProject(u, removedPaths) {
     track(manifest);
   }
 
-  if (u.copilotCli || u.allAgents) {
-    for (const base of [path.join(proj, '.claude'), path.join(proj, '.copilot')]) {
+  if (u.copilotCli || u.allAgents) {
+    for (const base of [path.join(proj, '.claude'), path.join(proj, '.copilot')]) {
       const cmdDir = path.join(base, 'commands');
       if (!fs.existsSync(cmdDir)) continue;
       for (const name of fs.readdirSync(cmdDir)) {
@@ -3074,19 +3132,19 @@ function uninstallLocalIdeFromProject(u, removedPaths) {
           unlinkQuiet(p, u);
           track(p);
         }
-      }
-    }
-    const claudeAgentsDir = path.join(proj, '.claude', 'agents');
-    if (fs.existsSync(claudeAgentsDir)) {
-      for (const name of fs.readdirSync(claudeAgentsDir)) {
-        if (oxeAgentInstall.isOxeAgentMarkdownName(name)) {
-          const p = path.join(claudeAgentsDir, name);
-          unlinkQuiet(p, u);
-          track(p);
-        }
-      }
-    }
-    const skillsRoot = path.join(proj, '.copilot', 'skills');
+      }
+    }
+    const claudeAgentsDir = path.join(proj, '.claude', 'agents');
+    if (fs.existsSync(claudeAgentsDir)) {
+      for (const name of fs.readdirSync(claudeAgentsDir)) {
+        if (oxeAgentInstall.isOxeAgentMarkdownName(name)) {
+          const p = path.join(claudeAgentsDir, name);
+          unlinkQuiet(p, u);
+          track(p);
+        }
+      }
+    }
+    const skillsRoot = path.join(proj, '.copilot', 'skills');
     if (fs.existsSync(skillsRoot)) {
       for (const ent of fs.readdirSync(skillsRoot, { withFileTypes: true })) {
         if (!ent.isDirectory() || !/^oxe($|-)/.test(ent.name)) continue;
@@ -3130,6 +3188,31 @@ function uninstallLocalIdeFromProject(u, removedPaths) {
   }
 }
 
+/**
+ * @param {UninstallOpts} u
+ */
+function shouldAlsoRemoveLocalIdeArtifacts(u) {
+  if (u.ideLocal) return true;
+  if (u.noProject) return false;
+  if (!(u.allAgents || anyGranularUninstallAgent(u) || u.cursor || u.copilot || u.copilotCli)) return false;
+  const proj = path.resolve(u.dir);
+  const localAgentPaths = oxeAgentInstall.buildAgentInstallPaths(false, proj);
+  if (u.cursor && fs.existsSync(path.join(proj, '.cursor', 'commands'))) return true;
+  if (u.copilot && (fs.existsSync(path.join(proj, '.github', 'prompts')) || fs.existsSync(path.join(proj, '.github', 'copilot-instructions.md')))) {
+    return true;
+  }
+  if (u.copilotCli && (fs.existsSync(path.join(proj, '.claude', 'commands')) || fs.existsSync(path.join(proj, '.copilot', 'commands')))) {
+    return true;
+  }
+  const selectedAll = u.allAgents || !anyGranularUninstallAgent(u);
+  if ((selectedAll || u.agentOpenCode) && localAgentPaths.opencodeCommandDirs.some((dir) => fs.existsSync(dir))) return true;
+  if ((selectedAll || u.agentGemini) && fs.existsSync(localAgentPaths.geminiCommandsBase)) return true;
+  if ((selectedAll || u.agentCodex) && (fs.existsSync(localAgentPaths.codexPromptsDir) || fs.existsSync(localAgentPaths.codexAgentsSkillsRoot))) return true;
+  if ((selectedAll || u.agentWindsurf) && fs.existsSync(localAgentPaths.windsurfWorkflowsDir)) return true;
+  if ((selectedAll || u.agentAntigravity) && fs.existsSync(localAgentPaths.antigravitySkillsRoot)) return true;
+  return false;
+}
+
 /**
  * @param {string[]} argv
  * @returns {UninstallOpts}
@@ -3361,6 +3444,7 @@ function runUninstall(u) {
   if (u.dryRun) console.log(`  ${c ? yellow : ''}(dry-run)${c ? reset : ''}`);
 
   const removedPaths = [];
+  const removeLocalIdeArtifacts = shouldAlsoRemoveLocalIdeArtifacts(u);
 
   if (u.cursor) {
     const base = cursorUserDir(ideOpts);
@@ -3409,8 +3493,8 @@ function runUninstall(u) {
     cleanupLegacyCopilotVsCode(ideOpts, u, removedPaths);
   }
 
-  if (u.copilotCli) {
-    for (const base of [claudeUserDir(ideOpts), copilotUserDir(ideOpts)]) {
+  if (u.copilotCli) {
+    for (const base of [claudeUserDir(ideOpts), copilotUserDir(ideOpts)]) {
       const cmdDir = path.join(base, 'commands');
       if (!fs.existsSync(cmdDir)) continue;
       for (const name of fs.readdirSync(cmdDir)) {
@@ -3419,19 +3503,19 @@ function runUninstall(u) {
           unlinkQuiet(p, u);
           removedPaths.push(p);
         }
-      }
-    }
-    const claudeAgentsDir = path.join(claudeUserDir(ideOpts), 'agents');
-    if (fs.existsSync(claudeAgentsDir)) {
-      for (const name of fs.readdirSync(claudeAgentsDir)) {
-        if (oxeAgentInstall.isOxeAgentMarkdownName(name)) {
-          const p = path.join(claudeAgentsDir, name);
-          unlinkQuiet(p, u);
-          removedPaths.push(p);
-        }
-      }
-    }
-    const skillsRoot = path.join(copilotUserDir(ideOpts), 'skills');
+      }
+    }
+    const claudeAgentsDir = path.join(claudeUserDir(ideOpts), 'agents');
+    if (fs.existsSync(claudeAgentsDir)) {
+      for (const name of fs.readdirSync(claudeAgentsDir)) {
+        if (oxeAgentInstall.isOxeAgentMarkdownName(name)) {
+          const p = path.join(claudeAgentsDir, name);
+          unlinkQuiet(p, u);
+          removedPaths.push(p);
+        }
+      }
+    }
+    const skillsRoot = path.join(copilotUserDir(ideOpts), 'skills');
     if (fs.existsSync(skillsRoot)) {
       for (const ent of fs.readdirSync(skillsRoot, { withFileTypes: true })) {
         if (!ent.isDirectory() || !/^oxe($|-)/.test(ent.name)) continue;
@@ -3516,7 +3600,7 @@ function runUninstall(u) {
     }
   }
 
-  if (u.ideLocal) {
+  if (removeLocalIdeArtifacts) {
     uninstallLocalIdeFromProject(u, removedPaths);
   }
 
@@ -3961,6 +4045,13 @@ function parseRuntimeArgs(argv) {
     fromEventId: '',
     writeReport: false,
     gateId: '',
+    // execute flags
+    provider: '',
+    apiKey: '',
+    model: '',
+    baseUrl: '',
+    maxTurns: null,
+    recompile: false,
     decision: '',
     actor: '',
     targetKind: '',
@@ -3998,6 +4089,12 @@ function parseRuntimeArgs(argv) {
     else if (a === '--status' && argv[i + 1]) out.gateStatus = String(argv[++i]);
     else if (a === '--scope' && argv[i + 1]) out.gateScope = String(argv[++i]);
     else if (a === '--json') out.jsonOutput = true;
+    else if (a === '--provider' && argv[i + 1]) out.provider = String(argv[++i]);
+    else if (a === '--api-key' && argv[i + 1]) out.apiKey = String(argv[++i]);
+    else if (a === '--model' && argv[i + 1]) out.model = String(argv[++i]);
+    else if (a === '--base-url' && argv[i + 1]) out.baseUrl = String(argv[++i]);
+    else if (a === '--max-turns' && argv[i + 1]) out.maxTurns = Number(argv[++i]);
+    else if (a === '--recompile') out.recompile = true;
     else if (!a.startsWith('-')) positionals.push(a);
     else {
       out.parseError = true;
@@ -4140,7 +4237,7 @@ function runContext(opts) {
       return;
     }
     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 : ''}`);
+    console.log(`  ${c ? green : ''}Sessão:${c ? reset : ''} ${c ? cyan : ''}${activeSession || '— (sem sessão ativa)'}${c ? reset : ''}`);
     console.log(`  ${c ? green : ''}Workflow:${c ? reset : ''} ${selectedWorkflow}`);
     console.log(`  ${c ? green : ''}Tier:${c ? reset : ''} ${pack.context_tier}`);
     console.log(`  ${c ? green : ''}Quality:${c ? reset : ''} ${pack.context_quality.score} (${pack.context_quality.status})`);
@@ -4207,7 +4304,7 @@ function runContext(opts) {
     return;
   }
   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 : ''}`);
+  console.log(`  ${c ? green : ''}Sessão:${c ? reset : ''} ${c ? cyan : ''}${activeSession || '— (sem sessão ativa)'}${c ? reset : ''}`);
   console.log(`  ${c ? green : ''}Packs:${c ? reset : ''} ${packs.length}`);
   for (const pack of packs) {
     const qualityFlag = (pack.context_quality.score < 30 || pack.context_quality.status === 'critical') ? ` ${yellow}[CRÍTICO]${reset}` : '';
@@ -4272,7 +4369,7 @@ async function runRuntime(opts) {
   const activeSession = opts.activeSession || oxeHealth.parseActiveSession(stateText) || null;
   const p = oxeOperational.operationalPaths(opts.dir, activeSession);
   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 : ''}`);
+  console.log(`  ${c ? green : ''}Sessão:${c ? reset : ''} ${c ? cyan : ''}${activeSession || '— (sem sessão ativa)'}${c ? reset : ''}`);
 
   if (opts.action === 'status') {
     const current = oxeOperational.readRunState(opts.dir, activeSession);
@@ -4335,13 +4432,28 @@ async function runRuntime(opts) {
       console.log(`  ${c ? green : ''}Runtime:${c ? reset : ''} ${runtimeMode.runtime_mode || 'legacy'} · fallback=${runtimeMode.fallback_mode || 'none'}`);
     }
     if (report.policyCoverage) {
-      console.log(`  ${c ? green : ''}Policy coverage:${c ? reset : ''} ${report.policyCoverage.coveragePercent}% · uncovered=${report.policyCoverage.uncoveredMutations}`);
+      const pctCov = report.policyCoverage.coveragePercent;
+      const policyLabel = pctCov === 0
+        ? `${c ? dim : ''}não configurada (opcional)${c ? reset : ''}`
+        : `${pctCov}% · uncovered=${report.policyCoverage.uncoveredMutations}`;
+      console.log(`  ${c ? green : ''}Policy coverage:${c ? reset : ''} ${policyLabel}`);
     }
     if (report.promotionReadiness) {
-      console.log(`  ${c ? green : ''}Promotion readiness:${c ? reset : ''} ${report.promotionReadiness.status}${Array.isArray(report.promotionReadiness.blockers) && report.promotionReadiness.blockers.length ? ` · ${report.promotionReadiness.blockers.join(', ')}` : ''}`);
+      const promoStatus = report.promotionReadiness.status;
+      const blockers = Array.isArray(report.promotionReadiness.blockers) ? report.promotionReadiness.blockers : [];
+      // Only show blockers that are not solely due to unconfigured policy
+      const meaningfulBlockers = blockers.filter(b => b !== 'policy_uncovered_mutations' || report.policyCoverage.coveragePercent > 0);
+      const promoLabel = promoStatus === 'blocked' && meaningfulBlockers.length === 0
+        ? `${c ? dim : ''}n/a (execução não concluída)${c ? reset : ''}`
+        : `${promoStatus}${meaningfulBlockers.length ? ` · ${meaningfulBlockers.join(', ')}` : ''}`;
+      console.log(`  ${c ? green : ''}Promotion readiness:${c ? reset : ''} ${promoLabel}`);
     }
     if (report.recoveryState) {
-      console.log(`  ${c ? green : ''}Recovery:${c ? reset : ''} ${report.recoveryState.status} · recoveries=${report.recoveryState.recoverCount ?? 0} · issues=${Array.isArray(report.recoveryState.issues) ? report.recoveryState.issues.length : 0}`);
+      const recIssues = Array.isArray(report.recoveryState.issues) ? report.recoveryState.issues.length : 0;
+      const recLabel = recIssues === 0
+        ? `${report.recoveryState.status} · ok`
+        : `${report.recoveryState.status} · issues=${recIssues} — rode ${c ? cyan : ''}runtime status --verbose${c ? reset : ''} para detalhes`;
+      console.log(`  ${c ? green : ''}Recovery:${c ? reset : ''} ${recLabel} · recoveries=${report.recoveryState.recoverCount ?? 0}`);
     }
     if (multiAgent) {
       console.log(`  ${c ? green : ''}Multi-agent:${c ? reset : ''} ${multiAgent.enabled ? (multiAgent.mode || 'active') : 'disabled'} · agentes=${Array.isArray(multiAgent.agents) ? multiAgent.agents.length : 0} · ownership=${Array.isArray(multiAgent.ownership) ? multiAgent.ownership.length : 0}`);
@@ -4511,6 +4623,17 @@ async function runRuntime(opts) {
 
   if (opts.action === 'compile') {
     try {
+      // --recompile: delete existing run state files so a fresh run_id is generated
+      if (opts.recompile) {
+        const runsDir = path.join(opts.dir, '.oxe', 'runs');
+        if (require('fs').existsSync(runsDir)) {
+          require('fs').readdirSync(runsDir).forEach(f => {
+            if (f.endsWith('.json') && !f.includes('ci-results')) {
+              require('fs').unlinkSync(path.join(runsDir, f));
+            }
+          });
+        }
+      }
       const compiled = oxeOperational.compileExecutionGraphFromArtifacts(opts.dir, activeSession);
       const suite = oxeOperational.compileVerificationSuiteFromArtifacts(opts.dir, activeSession, {
         runState: compiled.run,
@@ -4520,7 +4643,33 @@ async function runRuntime(opts) {
       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(' | ')}`);
+        // Bucket 1: static-analysis hints (HINT(...))
+        const hints = compiled.validationErrors.filter(e => e.startsWith('HINT('));
+        // Bucket 2: mutation-scope overlaps (info-only in single-agent)
+        const mutationWarns = compiled.validationErrors.filter(e => e.includes('mutate the same paths in parallel'));
+        // Bucket 3: structural errors (cycles, missing deps)
+        const blocking = compiled.validationErrors.filter(e =>
+          !e.startsWith('HINT(') && !e.includes('mutate the same paths in parallel')
+        );
+        if (blocking.length) {
+          console.log(`  ${yellow}Validation (erros):${reset} ${blocking.join(' | ')}`);
+        }
+        if (mutationWarns.length) {
+          console.log(`  ${c ? dim : ''}Info (single-agent — tarefas na mesma onda são sequenciais, sobreposição de arquivos não bloqueia):${c ? reset : ''}`);
+          mutationWarns.forEach(w => console.log(`  ${c ? dim : ''}  · ${w}${c ? reset : ''}`));
+        }
+        if (hints.length) {
+          console.log(`  ${yellow}Dicas de spec/plan (detectadas em tempo de compilação):${reset}`);
+          hints.forEach(h => {
+            // Format: HINT(type): message
+            const match = h.match(/^HINT\(([^)]+)\):\s*(.*)/s);
+            if (match) {
+              console.log(`  ${yellow}⚑${reset} [${match[1]}] ${match[2]}`);
+            } else {
+              console.log(`  ${yellow}⚑${reset} ${h}`);
+            }
+          });
+        }
       }
       console.log(`  ${c ? green : ''}Arquivo:${c ? reset : ''} ${path.join(p.runsDir, `${compiled.run.run_id}.json`)}`);
       return;
@@ -4570,7 +4719,7 @@ async function runRuntime(opts) {
       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 : ''}PLAN-STATUS:${c ? reset : ''} ${projected.paths.plan.replace(/PLAN\.md$/, 'PLAN-STATUS.md')}`);
       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}`);
@@ -4581,6 +4730,63 @@ async function runRuntime(opts) {
     }
   }
 
+  if (opts.action === 'execute') {
+    try {
+      // Resolve provider: flag > env vars
+      const apiKey = opts.apiKey || process.env.ANTHROPIC_API_KEY || process.env.OPENAI_API_KEY || '';
+      const model = opts.model || process.env.OXE_MODEL || 'claude-sonnet-4-6';
+      const baseUrl = opts.baseUrl || process.env.OXE_BASE_URL || 'https://api.anthropic.com/v1';
+      if (!apiKey) {
+        console.error(`${red}Erro: executor LLM não configurado.${reset}`);
+        console.error(`  Use: --api-key <chave>  ou  exporte ANTHROPIC_API_KEY`);
+        console.error(`  Exemplo: oxe-cc runtime execute --api-key $ANTHROPIC_API_KEY --model claude-sonnet-4-6`);
+        process.exit(1);
+      }
+      const providerConfig = { baseUrl, apiKey, model, maxTurns: opts.maxTurns || 10 };
+      const result = await oxeOperational.runRuntimeExecute(opts.dir, activeSession, {
+        runId: opts.runId || undefined,
+        heartbeatTimeoutMs: opts.heartbeatTimeoutMs || undefined,
+        providerConfig,
+        onProgress: (event) => {
+          if (event.type === 'turn_start') {
+            const turn = event.detail?.turn ?? 0;
+            if (turn === 0) process.stdout.write(`  → ${event.nodeId} `);
+          } else if (event.type === 'tool_call') {
+            process.stdout.write('.');
+          } else if (event.type === 'VerificationStarted') {
+            process.stdout.write(' [verify]');
+          } else if (event.type === 'WorkItemCompleted') {
+            process.stdout.write(` ✓\n`);
+          } else if (event.type === 'WorkItemBlocked') {
+            process.stdout.write(` ✗\n`);
+          } else if (event.type === 'RetryScheduled') {
+            process.stdout.write(` ↺ retry ${event.payload?.next_attempt}\n  → ${event.work_item_id} `);
+          }
+        },
+      });
+      if (opts.jsonOutput) {
+        console.log(JSON.stringify(result, null, 2));
+        if (result.result && result.result.failed && result.result.failed.length > 0) process.exitCode = 1;
+        return;
+      }
+      const r = result.result || {};
+      const completed = Array.isArray(r.completed) ? r.completed : [];
+      const failed = Array.isArray(r.failed) ? r.failed : [];
+      const blocked = Array.isArray(r.blocked) ? r.blocked : [];
+      console.log(`  ${c ? green : ''}✓${c ? reset : ''} Runtime execute concluído (modo: ${result.mode})`);
+      console.log(`  ${c ? green : ''}Completados:${c ? reset : ''} ${completed.length}`);
+      if (failed.length > 0)
+        console.log(`  ${c ? red : ''}Falhos:${c ? reset : ''} ${failed.length} — ${failed.join(', ')}`);
+      if (blocked.length > 0)
+        console.log(`  ${c ? '\x1b[33m' : ''}Bloqueados:${c ? reset : ''} ${blocked.length} — ${blocked.join(', ')}`);
+      if (failed.length > 0) process.exitCode = 1;
+      return;
+    } catch (err) {
+      console.error(`${red}${err && err.message ? err.message : 'Falha ao executar runtime.'}${reset}`);
+      process.exit(1);
+    }
+  }
+
   if (opts.action === 'ci') {
     try {
       const report = await oxeOperational.runRuntimeCiChecks(opts.dir, activeSession, {
@@ -4750,7 +4956,7 @@ function runAzure(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 : ''}`);
+  console.log(`  ${c ? green : ''}Sessão:${c ? reset : ''} ${c ? cyan : ''}${activeSession || '— (sem sessão ativa)'}${c ? reset : ''}`);
 
   try {
     if (opts.scope === 'status') {
@@ -5074,7 +5280,7 @@ function runPlanVisual(opts) {
   const planPath = sp.plan || oxeHealth.oxePaths(opts.dir).plan;
 
   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 : ''}`);
+  console.log(`  ${c ? green : ''}Sessão:${c ? reset : ''} ${c ? cyan : ''}${activeSession || '— (sem sessão ativa)'}${c ? reset : ''}`);
 
   if (!fs.existsSync(planPath)) {
     console.log(`\n  ${yellow}PLAN.md não encontrado em ${planPath}${reset}`);
@@ -5128,7 +5334,7 @@ function runVerifyMatrix(opts) {
   const verifyPath = sp.verify || oxeHealth.oxePaths(opts.dir).verify;
 
   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 : ''}`);
+  console.log(`  ${c ? green : ''}Sessão:${c ? reset : ''} ${c ? cyan : ''}${activeSession || '— (sem sessão ativa)'}${c ? reset : ''}`);
 
   const specMd = fs.existsSync(specPath) ? fs.readFileSync(specPath, 'utf8') : '';
   const planMd = fs.existsSync(planPath) ? fs.readFileSync(planPath, 'utf8') : '';
@@ -5512,7 +5718,8 @@ async function main() {
       nextSteps: [
         { desc: 'Validar o projeto:', cmd: 'npx oxe-cc doctor' },
         { desc: 'Instalar integrações IDE/CLI (se ainda não fez):', cmd: 'npx oxe-cc@latest' },
-        { desc: 'Começar o fluxo no agente:', cmd: '/oxe-scan' },
+        { desc: 'Fluxo runtime — criar spec (no agente):', cmd: '/oxe-spec  →  /oxe-plan  →  oxe-cc runtime compile  →  oxe-cc runtime execute' },
+        { desc: 'Começar pelo scan do codebase (agente):', cmd: '/oxe-scan' },
       ],
       dryRun: opts.dryRun,
     });