oxe-cc 1.6.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})`);
@@ -2733,6 +2748,10 @@ function runInstall(opts) {
     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)) {
@@ -2751,6 +2770,7 @@ function runInstall(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');
@@ -2763,12 +2783,20 @@ function runInstall(opts) {
       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 logO = (d) => console.log(`${dim}omitido${reset} ${d} (já existe — use --force)`);
     const logW = (msg) => console.log(`${dim}agents${reset}  ${msg}`);
@@ -2796,6 +2824,13 @@ function runInstall(opts) {
         logO,
         logW
       );
+      oxeAgentInstall.installCanonicalAgentSkills(
+        canonicalAgents,
+        agentPaths.antigravitySkillsRoot,
+        copyOpts,
+        logO,
+        logW
+      );
     }
     if (opts.agentCodex || opts.allAgents) {
       oxeAgentInstall.installSkillTreeFromCursorCommands(
@@ -2806,6 +2841,13 @@ function runInstall(opts) {
         logO,
         logW
       );
+      oxeAgentInstall.installCanonicalAgentSkills(
+        canonicalAgents,
+        agentPaths.codexAgentsSkillsRoot,
+        copyOpts,
+        logO,
+        logW
+      );
     }
   }
 
@@ -2900,6 +2942,7 @@ function runInstall(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));
       const skRoot = path.join(cpCliHome, 'skills');
       if (fs.existsSync(skRoot)) {
@@ -3048,6 +3091,16 @@ function uninstallLocalIdeFromProject(u, removedPaths) {
         }
       }
     }
+    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 })) {
@@ -3383,6 +3436,16 @@ function runUninstall(u) {
         }
       }
     }
+    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 })) {
@@ -4533,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, {

package/commands/oxe/debug.md

@@ -1,6 +1,11 @@
 ---
 name: oxe:debug
-description: "[DEPRECATED v1.1.0] Incorporado por /oxe-execute. Use: /oxe-execute --debug"
+description: >
+  Diagnóstica falhas com metodologia RCA: hipóteses explícitas → evidência → reprodução controlada
+  → causa raiz → hotfix mínimo. Não corrige sintomas — rasteia até a causa raiz antes de propor
+  qualquer mudança. Documenta o diagnóstico completo em DEBUG.md (sintoma, hipóteses testadas,
+  root cause, hotfix aplicado, evidência de resolução). Após o hotfix, orienta execução de
+  /oxe-verify para confirmar que os critérios A* afetados ainda passam.
 argument-hint: "[Tn ou erro/stack]"
 allowed-tools:
   - Read

package/commands/oxe/discuss.md

@@ -1,7 +1,12 @@
 ---
 name: oxe:discuss
-description: Perguntas objetivas antes do plano — .oxe/DISCUSS.md
-argument-hint: "[contexto ou respostas]"
+description: >
+  Conduz sessão estruturada de resolução de decisões técnicas antes do planejamento. Identifica
+  trade-offs relevantes, apresenta alternativas com critérios objetivos, registra a decisão
+  escolhida com motivo e impacto em DISCUSS.md como D-NN. Cada D-NN fechado aqui é vinculado a
+  tarefas Tn no PLAN.md e verificado pelo Verificador após execução. Usar quando: `discuss_before_plan`
+  está ativo no config, há decisão arquitetural aberta, ou o Arquiteto sinalizou bloqueio.
+argument-hint: "[decisão a tomar | contexto do trade-off | D-NN a reabrir]"
 allowed-tools:
   - Read
   - Bash

package/commands/oxe/execute.md

@@ -1,7 +1,12 @@
 ---
 name: oxe:execute
-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]"
+description: >
+  Executa as tarefas do PLAN.md onda por onda, com write set mínimo e verificação obrigatória
+  antes de avançar. Compila o grafo de execução via LlmTaskExecutor, respeita dependências entre
+  tarefas, particiona tools idempotentes (paralelas) e mutáveis (seriais), e registra evidência
+  auditável por Tn. Modo --debug ativa diagnóstico de falha inline. --checkpoint '<nome>' cria
+  ponto de restauração antes de ondas de alto risco.
+argument-hint: "[onda|Tn | --debug | --deep-diagnosis | --checkpoint '<nome>' | --note 'texto' | --iterative]"
 allowed-tools:
   - Read
   - Bash

package/commands/oxe/plan-agent.md

@@ -1,7 +1,12 @@
 ---
 name: oxe:plan-agent
-description: Gera PLAN.md e plan-agents.json (blueprint de agentes e ondas)
-argument-hint: "[--replan se já existe PLAN.md]"
+description: >
+  Gera PLAN.md e plan-agents.json — blueprint de execução multi-agente com ondas paralelas.
+  Cada agente recebe persona (executor, db-specialist, ui-specialist, etc.), escopo de tarefas,
+  dependências entre agentes e lifecycle state rastreável. Ideal para planos com 3+ domínios
+  distintos (backend, frontend, banco) onde paralelismo real de agentes é possível. --replan
+  regenera o runId, preserva tarefas concluídas e alinha STATE.md.
+argument-hint: "[--replan | <contexto adicional de domínios>]"
 allowed-tools:
   - Read
   - Write

package/commands/oxe/plan.md

@@ -1,7 +1,12 @@
 ---
 name: oxe:plan
-description: Gera PLAN.md a partir da SPEC com tarefas atômicas e verificação por item
-argument-hint: "[--replan se já existe PLAN.md]"
+description: >
+  Decompõe os critérios A* da SPEC em tarefas GraphNode com mutation_scope explícito, action_type
+  correto e verify command determinístico. Projeta ondas que maximizam paralelismo respeitando
+  dependências e mutation_scope disjunto. Aplica rubrica de confiança em 6 dimensões e quality gate
+  de 19 itens. Gera IMPLEMENTATION-PACK, REFERENCE-ANCHORS e FIXTURE-PACK junto com o PLAN.md.
+  --replan preserva histórico e atualiza tarefas sem apagar o trabalho anterior.
+argument-hint: "[--replan | --agents (gera blueprint de agentes junto)]"
 allowed-tools:
   - Read
   - Write

package/commands/oxe/scan.md

@@ -1,6 +1,11 @@
 ---
 name: oxe:scan
-description: "[DEPRECATED v1.1.0] Incorporado por /oxe-spec. Use: /oxe-spec --refresh (incremental) ou /oxe-spec --full (completo)"
+description: >
+  Analisa o codebase e produz os sete documentos em .oxe/codebase/ (OVERVIEW, STACK, STRUCTURE,
+  TESTING, INTEGRATIONS, CONVENTIONS, CONCERNS). Detecta padrão arquitetural dominante, domínios
+  funcionais e sugere profile scale-adaptive. Modo bootstrap (do zero) ou refresh (incremental).
+  Cada documento passa por gate de qualidade com critérios e anti-padrões por tipo. O mapa
+  resultante alimenta spec, plan e o contexto do LlmTaskExecutor.
 argument-hint: "[área opcional, ex. auth, api]"
 allowed-tools:
   - Read

package/commands/oxe/spec.md

@@ -1,6 +1,11 @@
 ---
 name: oxe:spec
-description: "Spec em 5 fases. Flags: --refresh (scan incremental), --full (scan completo), --research (spike), --ui (gera UI-SPEC)"
+description: >
+  Conduz as 5 fases do processo de especificação: perguntas (blocos coesos por domínio), pesquisa
+  (investigação de incertezas técnicas), requisitos (tabela R-ID com v1/v2/fora e critérios A*
+  verificáveis), elevação de robustez (checklist de segurança por domínio AUTH/API/DB/FRONTEND/FILE),
+  e aprovação com roteiro ROADMAP.md. Flags: --refresh (atualiza codebase/ antes), --full (scan
+  completo), --research (Fase 2 explícita), --ui (gera UI-SPEC.md ao final).
 argument-hint: "[descrição da feature | --refresh | --full | --research | --ui]"
 allowed-tools:
   - Read

package/commands/oxe/verify.md

@@ -1,6 +1,11 @@
 ---
 name: oxe:verify
-description: "Valida e fecha o ciclo (retro automática). Flags: --gaps, --security, --ui, --pr, --diff, --skip-retro"
+description: >
+  Audita a implementação em quatro camadas: pré-execução (ambiente e commits), por tarefa Tn
+  (verify command de cada task), por critério A* (cobertura completa da SPEC), e fidelidade de
+  decisões D-NN. Produz VERIFY.md com evidência observável por critério, classifica findings por
+  severidade, gera checklist UAT para validação humana, e fecha o ciclo com retro automática.
+  --security adiciona auditoria de segurança baseline. --gaps foca em A* sem cobertura.
 argument-hint: "[Tn | --gaps | --security | --ui | --pr | --diff branchA...branchB | --skip-retro]"
 allowed-tools:
   - Read

package/docs/CONTENT-MIGRATION-AUDIT.md

@@ -0,0 +1,49 @@
+# Content Migration Audit
+
+Este documento registra a triagem interna de conteúdo usado como insumo para fortalecer o OXE. Ele não é instalado em projetos de usuário e não deve ser referenciado por templates, workflows, comandos, README ou agentes finais.
+
+## Rules
+
+- Public artifacts must use OXE naming, paths, commands and runtime contracts only.
+- No public template/workflow/command/agent may reference legacy product names, paths, tool commands or command namespaces.
+- Source material is reauthored, not copied literally.
+
+## Templates
+
+| Source theme | Decision | OXE target |
+|--------------|----------|------------|
+| Detailed phase plan contract | merge | `PLAN.template.md`, `IMPLEMENTATION-PACK.*`, `/oxe-plan` |
+| Context and discovery templates | merge | context packs, `RESEARCH.template.md`, `INVESTIGATION.template.md`, `REFERENCE-ANCHORS.template.md` |
+| Requirements, project, roadmap, state | merge | `SPEC.template.md`, `ROADMAP.template.md`, `STATE.md` |
+| Validation, verification and UAT | merge | `/oxe-verify`, runtime evidence, `VERIFY.md` projection |
+| UI contract | merge | `/oxe-spec --ui`, `/oxe-ui-spec`, `/oxe-ui-review` |
+| Debug templates | merge | `/oxe-debug`, `/oxe-forensics`, `oxe-debugger` |
+| Session summaries and setup | merge | `SUMMARY.template.md`, `RESUME.template.md`, checkpoints |
+| Runtime-specific instruction files | inspiration_only | OXE multi-runtime generators |
+| Developer profile/preferences | reject | future consented profile feature only |
+
+## Workflows
+
+| Source theme | Decision | OXE target |
+|--------------|----------|------------|
+| New project and milestone discovery | merge | `/oxe-spec`, `/oxe-plan` |
+| Phase planning and review loop | merge | `/oxe-plan`, rationality gate |
+| Plan execution by wave/task | merge | `/oxe-execute` |
+| Verification, validation gaps and UAT | merge | `/oxe-verify` |
+| Codebase mapping and research | merge | `/oxe-scan`, `/oxe-spec --research` |
+| Debug and incident diagnosis | merge | `/oxe-debug`, `/oxe-forensics` |
+| UI design and review | merge | `/oxe-spec --ui`, `/oxe-ui-review` |
+| Progress, next, pause and resume | merge | `/oxe`, `/oxe-next`, `/oxe-session` |
+| Workstreams and isolated workspace concepts | merge | `/oxe-workstream`, runtime agents |
+| Autonomous workflow | reject | OXE keeps governed execution |
+| PR branch/ship workflow | inspiration_only | OXE keeps local commit and separate `runtime promote` |
+| Community/settings/update flows | reject | OXE already has administrative UX |
+
+## Commands
+
+Legacy command wrappers are not copied. They are used only as intent inventory and mapped into canonical OXE workflows before generated surfaces are regenerated.
+
+## Agents
+
+Specialized agents were reauthored as OXE-native contracts in `oxe/agents/`. They use `.oxe/`, OXE workflows, runtime enterprise, evidence store, personas and `plan-agents.json` only.
+