oxe-cc 1.7.0 → 1.8.0

package/bin/oxe-cc.js

@@ -1527,20 +1527,20 @@ 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 (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 +1668,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 || '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 || '—'}`);
 
   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 +1687,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 +1710,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 +1830,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 +1866,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 +1881,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 +1917,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 +1936,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 +1951,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 +1972,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 +1987,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}`);
@@ -2195,6 +2207,9 @@ function runDoctor(target, options = {}) {
   const claudeReady = fs.existsSync(claudeLocalDir) || fs.existsSync(claudeGlobalDir);
   ideChecks.push({ label: 'Claude Code', ready: claudeReady, hint: 'commands/oxe/ ou ~/.claude/commands/' });
 
+  const codexReport = oxeHealth.codexIntegrationReport(target);
+  ideChecks.push({ label: 'Codex', ready: codexReport.commandsReady, hint: '~/.codex/prompts/oxe.md' });
+
   for (const ide of ideChecks) {
     if (ide.ready) {
       console.log(`${c ? green : ''}OK${c ? reset : ''} ${ide.label} pronto (${ide.hint})`);
@@ -2730,14 +2745,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 +2767,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 +2780,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 +2815,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 +2939,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 +3079,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 +3089,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;
@@ -3409,8 +3424,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 +3434,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;
@@ -4581,6 +4596,35 @@ async function runRuntime(opts) {
     }
   }
 
+  if (opts.action === 'execute') {
+    try {
+      const result = await oxeOperational.runRuntimeExecute(opts.dir, activeSession, {
+        runId: opts.runId || undefined,
+        heartbeatTimeoutMs: opts.heartbeatTimeoutMs || undefined,
+      });
+      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, {