oxe-cc 1.4.1 → 1.5.1

package/bin/oxe-cc.js

@@ -24,6 +24,7 @@ const oxeAzure = require(path.join(__dirname, 'lib', 'oxe-azure.cjs'));
 const oxePlugins = require(path.join(__dirname, 'lib', 'oxe-plugins.cjs'));
 const oxeContext = require(path.join(__dirname, 'lib', 'oxe-context-engine.cjs'));
 const oxeRuntimeSemantics = require(path.join(__dirname, 'lib', 'oxe-runtime-semantics.cjs'));
+const oxeRelease = require(path.join(__dirname, 'lib', 'oxe-release.cjs'));
 
 /** Merge markers for ~/.copilot/copilot-instructions.md (bloco OXE). */
 const OXE_INST_BEGIN = '<!-- oxe-cc:install-begin -->';
@@ -247,35 +248,35 @@ function buildInstallSummary(opts, fullLayout) {
 /**
  * @param {UninstallOpts} u
  */
-function buildUninstallFooter(u) {
-  const bullets = [];
-  const p = u.dryRun ? '[simulação] ' : '';
-  const rm = u.dryRun ? 'Seriam removidos' : 'Removidos';
-  const granularAgents = [
-    u.agentOpenCode ? 'OpenCode' : null,
-    u.agentGemini ? 'Gemini' : null,
-    u.agentCodex ? 'Codex' : null,
-    u.agentWindsurf ? 'Windsurf' : null,
-    u.agentAntigravity ? 'Antigravity' : null,
-  ].filter(Boolean);
-  if (u.cursor) bullets.push(`${p}${rm} artefatos OXE em ~/.cursor (comandos e regras).`);
-  if (u.copilot) {
-    bullets.push(`${p}${rm} prompt files OXE em .github/prompts/ e o bloco OXE em .github/copilot-instructions.md.`);
-  }
+function buildUninstallFooter(u) {
+  const bullets = [];
+  const p = u.dryRun ? '[simulação] ' : '';
+  const rm = u.dryRun ? 'Seriam removidos' : 'Removidos';
+  const granularAgents = [
+    u.agentOpenCode ? 'OpenCode' : null,
+    u.agentGemini ? 'Gemini' : null,
+    u.agentCodex ? 'Codex' : null,
+    u.agentWindsurf ? 'Windsurf' : null,
+    u.agentAntigravity ? 'Antigravity' : null,
+  ].filter(Boolean);
+  if (u.cursor) bullets.push(`${p}${rm} artefatos OXE em ~/.cursor (comandos e regras).`);
+  if (u.copilot) {
+    bullets.push(`${p}${rm} prompt files OXE em .github/prompts/ e o bloco OXE em .github/copilot-instructions.md.`);
+  }
   if (u.copilotLegacyClean) {
     bullets.push(`${p}${rm} apenas o legado global do Copilot VS Code em ~/.copilot/ (prompts oxe-* e bloco OXE global).`);
   }
-  if (u.copilotCli) {
-    bullets.push(`${p}${rm} comandos oxe/oxe-* em ~/.claude/commands e ~/.copilot/commands.`);
-    bullets.push(`${p}${rm} skills OXE (marcadas oxe-cc) em ~/.copilot/skills/oxe*/.`);
-  }
-  if (u.allAgents) {
-    bullets.push(
-      `${p}${rm} extensões multi-agente marcadas oxe-cc (OpenCode, Gemini TOML, Windsurf workflows, Codex prompts/skills, Antigravity), se existirem.`
-    );
-  } else if (granularAgents.length) {
-    bullets.push(`${p}${rm} apenas as integrações selecionadas: ${granularAgents.join(', ')}.`);
-  }
+  if (u.copilotCli) {
+    bullets.push(`${p}${rm} comandos oxe/oxe-* em ~/.claude/commands e ~/.copilot/commands.`);
+    bullets.push(`${p}${rm} skills OXE (marcadas oxe-cc) em ~/.copilot/skills/oxe*/.`);
+  }
+  if (u.allAgents) {
+    bullets.push(
+      `${p}${rm} extensões multi-agente marcadas oxe-cc (OpenCode, Gemini TOML, Windsurf workflows, Codex prompts/skills, Antigravity), se existirem.`
+    );
+  } else if (granularAgents.length) {
+    bullets.push(`${p}${rm} apenas as integrações selecionadas: ${granularAgents.join(', ')}.`);
+  }
   if (u.ideLocal) {
     bullets.push(
       `${p}${rm} integrações OXE no repositório (.cursor, .github, .claude, .copilot, .opencode, … conforme flags).`
@@ -296,29 +297,29 @@ function buildUninstallFooter(u) {
   return { bullets, nextSteps, dryRun: u.dryRun };
 }
 
-/** @typedef {{ help: boolean, version: boolean, cursor: boolean, copilot: boolean, copilotCli: boolean, allAgents: boolean, agentOpenCode: boolean, agentGemini: boolean, agentCodex: boolean, agentWindsurf: boolean, agentAntigravity: boolean, vscode: boolean, commands: boolean, agents: boolean, force: boolean, dryRun: boolean, dir: string, all: boolean, noInitOxe: boolean, oxeOnly: boolean, globalCli: boolean, noGlobalCli: boolean, installAssetsGlobal: boolean, explicitScope: boolean, integrationsUnset: boolean, ideLocal: boolean, explicitIdeScope: boolean, explicitConfigDir: string | null, parseError: boolean, unknownFlag: string, conflictFlags: string, ignoreInstallConfig: boolean }} InstallOpts */
-
-/** @param {InstallOpts} o */
-function anyGranularAgent(o) {
-  return !!(o.agentOpenCode || o.agentGemini || o.agentCodex || o.agentWindsurf || o.agentAntigravity);
-}
-
-/** @param {UninstallOpts} o */
-function anyGranularUninstallAgent(o) {
-  return !!(o.agentOpenCode || o.agentGemini || o.agentCodex || o.agentWindsurf || o.agentAntigravity);
-}
-
-/** @param {UninstallOpts} u */
-function buildAgentCleanupTargets(u) {
-  if (u.allAgents || !anyGranularUninstallAgent(u)) return null;
-  return {
-    opencode: Boolean(u.agentOpenCode),
-    gemini: Boolean(u.agentGemini),
-    windsurf: Boolean(u.agentWindsurf),
-    codex: Boolean(u.agentCodex),
-    antigravity: Boolean(u.agentAntigravity),
-  };
-}
+/** @typedef {{ help: boolean, version: boolean, cursor: boolean, copilot: boolean, copilotCli: boolean, allAgents: boolean, agentOpenCode: boolean, agentGemini: boolean, agentCodex: boolean, agentWindsurf: boolean, agentAntigravity: boolean, vscode: boolean, commands: boolean, agents: boolean, force: boolean, dryRun: boolean, dir: string, all: boolean, noInitOxe: boolean, oxeOnly: boolean, globalCli: boolean, noGlobalCli: boolean, installAssetsGlobal: boolean, explicitScope: boolean, integrationsUnset: boolean, ideLocal: boolean, explicitIdeScope: boolean, explicitConfigDir: string | null, parseError: boolean, unknownFlag: string, conflictFlags: string, ignoreInstallConfig: boolean, releaseDoctor: boolean, writeManifest: boolean }} InstallOpts */
+
+/** @param {InstallOpts} o */
+function anyGranularAgent(o) {
+  return !!(o.agentOpenCode || o.agentGemini || o.agentCodex || o.agentWindsurf || o.agentAntigravity);
+}
+
+/** @param {UninstallOpts} o */
+function anyGranularUninstallAgent(o) {
+  return !!(o.agentOpenCode || o.agentGemini || o.agentCodex || o.agentWindsurf || o.agentAntigravity);
+}
+
+/** @param {UninstallOpts} u */
+function buildAgentCleanupTargets(u) {
+  if (u.allAgents || !anyGranularUninstallAgent(u)) return null;
+  return {
+    opencode: Boolean(u.agentOpenCode),
+    gemini: Boolean(u.agentGemini),
+    windsurf: Boolean(u.agentWindsurf),
+    codex: Boolean(u.agentCodex),
+    antigravity: Boolean(u.agentAntigravity),
+  };
+}
 
 /** @param {InstallOpts} o */
 function anyIdeIntegration(o) {
@@ -364,6 +365,8 @@ function parseInstallArgs(argv) {
     unknownFlag: '',
     conflictFlags: '',
     ignoreInstallConfig: false,
+    releaseDoctor: false,
+    writeManifest: false,
     /** Saída JSON em `status` (CI / agentes). */
     jsonOutput: false,
     /** Lembretes agregados scan/compact em `status`. */
@@ -415,6 +418,8 @@ function parseInstallArgs(argv) {
     } else if (a === '--json') out.jsonOutput = true;
     else if (a === '--hints') out.statusHints = true;
     else if (a === '--full') out.statusFull = true;
+    else if (a === '--release') out.releaseDoctor = true;
+    else if (a === '--write-manifest') out.writeManifest = true;
     else if (!a.startsWith('-')) out.restPositional.push(a);
     else {
       out.parseError = true;
@@ -457,6 +462,14 @@ function parseInstallArgs(argv) {
     out.agentWindsurf = true;
     out.agentAntigravity = true;
   }
+  if (!out.conflictFlags && out.oxeOnly) {
+    const IDE_FLAGS = ['--cursor', '--copilot', '--copilot-vscode', '--copilot-cli', '--all-agents',
+      '--opencode', '--gemini', '--codex', '--windsurf', '--antigravity', '--vscode'];
+    const conflicting = IDE_FLAGS.filter((f) => argv.includes(f));
+    if (conflicting.length > 0) {
+      out.conflictFlags = `--oxe-only não combina com flags de IDE (${conflicting.join(', ')})`;
+    }
+  }
   if (out.oxeOnly) {
     out.cursor = false;
     out.copilot = false;
@@ -777,7 +790,11 @@ function writeCopilotVsCodeManifest(opts, info) {
   const promptFiles = fs.existsSync(promptsDir)
     ? fs
         .readdirSync(promptsDir, { withFileTypes: true })
-        .filter((entry) => entry.isFile() && /^oxe-.*\.prompt\.md$/i.test(entry.name))
+        .filter(
+          (entry) =>
+            entry.isFile() &&
+            (entry.name === 'oxe.prompt.md' || /^oxe-.*\.prompt\.md$/i.test(entry.name))
+        )
         .map((entry) => entry.name)
         .sort()
     : [];
@@ -1038,6 +1055,27 @@ async function promptInstallScope(opts) {
   }
 }
 
+/**
+ * Grava a escolha resolvida de ide_scope de volta em .oxe/config.json para que
+ * futuras reinstalações/updates não precisem perguntar novamente.
+ * @param {InstallOpts} opts
+ */
+function persistIdeScope(opts) {
+  if (opts.dryRun || opts.oxeOnly) return;
+  const configPath = path.join(opts.dir, '.oxe', 'config.json');
+  if (!fs.existsSync(configPath)) return;
+  try {
+    const cfg = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    const scope = opts.ideLocal ? 'local' : 'global';
+    if (!cfg.install || typeof cfg.install !== 'object') cfg.install = {};
+    if (cfg.install.ide_scope === scope) return;
+    cfg.install.ide_scope = scope;
+    fs.writeFileSync(configPath, JSON.stringify(cfg, null, 2) + '\n', 'utf8');
+  } catch {
+    /* silêncio — não bloquear instalação por falha ao persistir config */
+  }
+}
+
 /** @param {InstallOpts} opts */
 async function resolveInteractiveInstall(opts) {
   if (!opts.ignoreInstallConfig) {
@@ -1280,7 +1318,13 @@ function bootstrapOxe(target, opts) {
 
   if (fs.existsSync(configSrc)) {
     if (!fs.existsSync(configDest) || opts.force) {
-      copyFile(configSrc, configDest, { dryRun: false });
+      try {
+        const cfgRaw = JSON.parse(fs.readFileSync(configSrc, 'utf8'));
+        delete cfgRaw._comment;
+        fs.writeFileSync(configDest, JSON.stringify(cfgRaw, null, 2) + '\n', 'utf8');
+      } catch {
+        copyFile(configSrc, configDest, { dryRun: false });
+      }
       console.log(`${green}init${reset}  ${configDest}`);
     } else {
       console.log(`${dim}omitido${reset} ${configDest} (já existe — use --force para substituir)`);
@@ -1483,15 +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 (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) {
@@ -1652,17 +1701,24 @@ 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 ready = specExists && planExists && !report.planWarn.length && !report.runtimeWarn.length;
+  const ready = 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 ? '✓ Pronto para executar' : '✗ Não pronto para executar'}${c ? reset : ''}`);
   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 (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) {
@@ -1748,18 +1804,24 @@ function runStatusFull(target) {
   }
 
   // Plan self-evaluation
-  if (report.planSelfEvaluation) {
-    const pse = report.planSelfEvaluation;
-    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 = Number(pse.confidence) >= 70 ? green : Number(pse.confidence) >= 50 ? yellow : red;
-      console.log(`  ${c ? dim : ''}Confiança:${c ? reset : ''} ${c ? confColor : ''}${pse.confidence}%${c ? reset : ''}`);
-    }
-  }
+  if (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 : '—'}`);
@@ -1791,10 +1853,18 @@ function runStatus(target, opts = {}) {
       activeSession: report.activeSession,
       scanDate: report.scanDate,
       staleScan: report.stale,
-      compactDate: report.compactDate,
-        staleCompact: report.staleCompact,
-        planSelfEvaluation: report.planSelfEvaluation,
-        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,
@@ -1926,7 +1996,46 @@ function runStatus(target, opts = {}) {
 }
 
 /** @param {string} target */
-function runDoctor(target) {
+function runDoctor(target, options = {}) {
+    if (options.release) {
+      if (!options.json) printSection('OXE ▸ doctor --release');
+      const c = useAnsiColors();
+      const result = oxeRelease.checkReleaseConsistency(target, {
+        packageRoot: PKG_ROOT,
+        writeManifest: Boolean(options.writeManifest),
+    });
+    if (options.json) {
+      console.log(
+        JSON.stringify(
+          {
+            status: result.ok ? 'ok' : 'blocked',
+            blockers: result.blockers,
+            warnings: result.warnings,
+            manifestPath: result.manifestPath,
+            manifest: result.manifest,
+          },
+          null,
+          2
+        )
+      );
+    } else {
+      console.log(`  ${c ? green : ''}Projeto:${c ? reset : ''} ${c ? cyan : ''}${target}${c ? reset : ''}`);
+      console.log(`  ${c ? green : ''}Versão alvo:${c ? reset : ''} ${result.manifest.versions.rootPackage.version || '—'}`);
+      console.log(`  ${c ? green : ''}Manifest:${c ? reset : ''} ${result.manifestPath}`);
+      if (result.ok) {
+        console.log(`  ${c ? green : ''}✓${c ? reset : ''} release readiness OK`);
+      } else {
+        console.log(`  ${c ? red : ''}✗${c ? reset : ''} release readiness bloqueada`);
+        for (const blocker of result.blockers) {
+          console.log(`    - ${blocker}`);
+        }
+      }
+      for (const warning of result.warnings) {
+        console.log(`  ${c ? yellow : ''}!${c ? reset : ''} ${warning}`);
+      }
+    }
+    process.exit(result.ok ? 0 : 1);
+  }
   printSection('OXE ▸ doctor');
   const v = process.versions.node;
   const major = parseInt(v.split('.')[0], 10);
@@ -2147,6 +2256,12 @@ function installGlobalCliPackage() {
     shell: true,
     env: process.env,
   });
+  if (r.error) {
+    console.log(
+      `\n  ${c ? yellow : ''}⚠${c ? reset : ''} npm install -g falhou (${r.error.message}). Tente manualmente: ${c ? cyan : ''}npm install -g ${spec}${c ? reset : ''}\n`
+    );
+    return false;
+  }
   if (r.status === 0) {
     console.log(
       `\n  ${c ? green : ''}✓${c ? reset : ''} ${c ? cyan : ''}oxe-cc${c ? reset : ''} disponível globalmente (execute ${c ? cyan : ''}oxe-cc --help${c ? reset : ''} em qualquer pasta).\n`
@@ -2328,34 +2443,39 @@ function usage() {
   console.log(`
 ${cyan}oxe-cc${reset} — instala workflows OXE (núcleo .oxe/ + integrações: Cursor, Copilot, Claude, OpenCode, Gemini, Codex, Windsurf, Antigravity, …)
 
-${green}Uso:${reset}
-  npx oxe-cc@latest [opções] [pasta-do-projeto]
-  npx oxe-cc@latest install [opções] [pasta-do-projeto]   ${dim}(equivalente à instalação predefinida)${reset}
-  npx oxe-cc@latest --dir /caminho/do/projeto
-  npx oxe-cc doctor [opções] [pasta-do-projeto]
-  npx oxe-cc status [opções] [pasta-do-projeto]
-  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> [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]
-  npx oxe-cc update [opções] [argumentos extras…]
-
-${green}uninstall${reset} (remove OXE da pasta do usuário + pastas de workflows no repo)
-  --cursor / --copilot / --copilot-cli   só essa integração (omissão = todas)
-  --copilot-vscode                       alias explícito de --copilot
-  --copilot-legacy-clean                 limpa só o legado antigo do Copilot VS Code em ~/.copilot/
-  --all-agents                           também remove ficheiros multi-plataforma (com --copilot-cli implícito)
-  --opencode / --gemini / --codex / --windsurf / --antigravity
-                                         remove só esse agente multi-runtime
-  --ide-local                            remove integrações IDE neste repositório (.cursor, .github, .claude, .copilot, …)
-  --ide-only                             não apagar .oxe/workflows, oxe/, etc. no projeto
-  --global-cli, -g                       também executa npm uninstall -g oxe-cc
-  --config-dir <caminho>                 com exatamente uma flag IDE acima (não combina com --ide-local, --copilot nem agentes granulares)
-  --dry-run
-  --dir <pasta>                          raiz do projeto (padrão: diretório atual)
+  ${green}Uso:${reset}
+    npx oxe-cc@latest [opções] [pasta-do-projeto]
+    npx oxe-cc@latest install [opções] [pasta-do-projeto]   ${dim}(equivalente à instalação predefinida)${reset}
+    npx oxe-cc@latest --dir /caminho/do/projeto
+    npx oxe-cc doctor [--release] [--write-manifest] [opções] [pasta-do-projeto]
+    npx oxe-cc status [opções] [pasta-do-projeto]
+    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 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]
+    npx oxe-cc update [opções] [argumentos extras…]
+  
+  ${green}doctor${reset}
+    --release                             valida release readiness: versões, changelog, wrappers, runtime build e relatórios obrigatórios
+    --write-manifest                      persiste .oxe/release/release-manifest.json durante doctor --release
+    --json                                saída estruturada para CI
+
+  ${green}uninstall${reset} (remove OXE da pasta do usuário + pastas de workflows no repo)
+  --cursor / --copilot / --copilot-cli   só essa integração (omissão = todas)
+  --copilot-vscode                       alias explícito de --copilot
+  --copilot-legacy-clean                 limpa só o legado antigo do Copilot VS Code em ~/.copilot/
+  --all-agents                           também remove ficheiros multi-plataforma (com --copilot-cli implícito)
+  --opencode / --gemini / --codex / --windsurf / --antigravity
+                                         remove só esse agente multi-runtime
+  --ide-local                            remove integrações IDE neste repositório (.cursor, .github, .claude, .copilot, …)
+  --ide-only                             não apagar .oxe/workflows, oxe/, etc. no projeto
+  --global-cli, -g                       também executa npm uninstall -g oxe-cc
+  --config-dir <caminho>                 com exatamente uma flag IDE acima (não combina com --ide-local, --copilot nem agentes granulares)
+  --dry-run
+  --dir <pasta>                          raiz do projeto (padrão: diretório atual)
 
 ${green}update${reset} (executa npx oxe-cc@latest --force na pasta do projeto)
   --check                                só consulta npm: compara versão em execução com latest (saída 0=ok, 1=há mais nova, 2=erro; incompatível com --dry-run)
@@ -2748,11 +2868,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(path.join(cpCliHome, 'commands'), (n) => oxeAgentInstall.isOxeCommandMarkdownName(n));
-      const skRoot = path.join(cpCliHome, 'skills');
+    trackFile(runtimeSemanticsManifestPath(opts));
+    if (opts.copilotCli || opts.allAgents) {
+      addTracked(path.join(installClaudeBase(opts), 'commands'), (n) => oxeAgentInstall.isOxeCommandMarkdownName(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 })) {
           if (!sub.isDirectory() || !/^oxe($|-)/.test(sub.name)) continue;
@@ -2767,11 +2887,11 @@ function runInstall(opts) {
         }
       }
     }
-    if (opts.agentOpenCode || opts.allAgents) {
-      for (const d of agentPaths.opencodeCommandDirs) {
-        addTracked(d, (n) => oxeAgentInstall.isOxeCommandMarkdownName(n));
-      }
-    }
+    if (opts.agentOpenCode || opts.allAgents) {
+      for (const d of agentPaths.opencodeCommandDirs) {
+        addTracked(d, (n) => oxeAgentInstall.isOxeCommandMarkdownName(n));
+      }
+    }
     if (opts.agentGemini || opts.allAgents) {
       const gCmd = agentPaths.geminiCommandsBase;
       trackFile(path.join(gCmd, 'oxe.toml'));
@@ -2785,12 +2905,12 @@ function runInstall(opts) {
     if (opts.agentWindsurf || opts.allAgents) {
       addTracked(agentPaths.windsurfWorkflowsDir, (n) => n === 'oxe.md' || (n.startsWith('oxe-') && n.endsWith('.md')));
     }
-    if (opts.agentCodex || opts.allAgents) {
-      const cxPrompts = agentPaths.codexPromptsDir;
-      if (fs.existsSync(cxPrompts)) {
-        addTracked(cxPrompts, (n) => oxeAgentInstall.isOxeCommandMarkdownName(n));
-      }
-    }
+    if (opts.agentCodex || opts.allAgents) {
+      const cxPrompts = agentPaths.codexPromptsDir;
+      if (fs.existsSync(cxPrompts)) {
+        addTracked(cxPrompts, (n) => oxeAgentInstall.isOxeCommandMarkdownName(n));
+      }
+    }
     if (opts.agentAntigravity || opts.allAgents) {
       const root = agentPaths.antigravitySkillsRoot;
       if (fs.existsSync(root)) {
@@ -2833,26 +2953,26 @@ function runInstall(opts) {
   console.log(`  ${c ? green : ''}✓${c ? reset : ''} Instalação concluída com sucesso.\n`);
 }
 
-/** @typedef {{ help: boolean, dryRun: boolean, cursor: boolean, copilot: boolean, copilotCli: boolean, allAgents: boolean, agentOpenCode: boolean, agentGemini: boolean, agentCodex: boolean, agentWindsurf: boolean, agentAntigravity: boolean, globalCli: boolean, ideLocal: boolean, ideExplicit: boolean, noProject: boolean, copilotLegacyClean: boolean, dir: string, explicitConfigDir: string | null, parseError: boolean, unknownFlag: string, conflictFlags: string }} UninstallOpts */
+/** @typedef {{ help: boolean, dryRun: boolean, cursor: boolean, copilot: boolean, copilotCli: boolean, allAgents: boolean, agentOpenCode: boolean, agentGemini: boolean, agentCodex: boolean, agentWindsurf: boolean, agentAntigravity: boolean, globalCli: boolean, ideLocal: boolean, ideExplicit: boolean, noProject: boolean, copilotLegacyClean: boolean, dir: string, explicitConfigDir: string | null, parseError: boolean, unknownFlag: string, conflictFlags: string }} UninstallOpts */
 
 /**
  * @param {UninstallOpts} u
  * @param {string[]} removedPaths
  */
-function uninstallLocalIdeFromProject(u, removedPaths) {
-  const proj = path.resolve(u.dir);
-  const track = (p) => {
-    if (removedPaths.indexOf(p) === -1) removedPaths.push(p);
-  };
-
-  if (u.cursor) {
-    const cmdDir = path.join(proj, '.cursor', 'commands');
-    if (fs.existsSync(cmdDir)) {
-      for (const name of fs.readdirSync(cmdDir)) {
-        if (oxeAgentInstall.isOxeCommandMarkdownName(name)) {
-          const p = path.join(cmdDir, name);
-          unlinkQuiet(p, u);
-          track(p);
+function uninstallLocalIdeFromProject(u, removedPaths) {
+  const proj = path.resolve(u.dir);
+  const track = (p) => {
+    if (removedPaths.indexOf(p) === -1) removedPaths.push(p);
+  };
+
+  if (u.cursor) {
+    const cmdDir = path.join(proj, '.cursor', 'commands');
+    if (fs.existsSync(cmdDir)) {
+      for (const name of fs.readdirSync(cmdDir)) {
+        if (oxeAgentInstall.isOxeCommandMarkdownName(name)) {
+          const p = path.join(cmdDir, name);
+          unlinkQuiet(p, u);
+          track(p);
         }
       }
     }
@@ -2875,7 +2995,7 @@ function uninstallLocalIdeFromProject(u, removedPaths) {
     const pr = path.join(proj, '.github', 'prompts');
     if (fs.existsSync(pr)) {
       for (const name of fs.readdirSync(pr)) {
-        if (/^oxe-.*\.prompt\.md$/i.test(name)) {
+        if (name === 'oxe.prompt.md' || /^oxe-.*\.prompt\.md$/i.test(name)) {
           const p = path.join(pr, name);
           unlinkQuiet(p, u);
           track(p);
@@ -2887,15 +3007,15 @@ function uninstallLocalIdeFromProject(u, removedPaths) {
     track(manifest);
   }
 
-  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)) {
-        if (oxeAgentInstall.isOxeCommandMarkdownName(name)) {
-          const p = path.join(cmdDir, name);
-          unlinkQuiet(p, u);
-          track(p);
+  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)) {
+        if (oxeAgentInstall.isOxeCommandMarkdownName(name)) {
+          const p = path.join(cmdDir, name);
+          unlinkQuiet(p, u);
+          track(p);
         }
       }
     }
@@ -2923,25 +3043,25 @@ function uninstallLocalIdeFromProject(u, removedPaths) {
     }
   }
 
-  if (u.allAgents || anyGranularUninstallAgent(u)) {
-    const localPaths = oxeAgentInstall.buildAgentInstallPaths(false, proj);
-    const cleanupTargets = buildAgentCleanupTargets(u);
-    if (!u.dryRun) {
-      oxeAgentInstall.cleanupMarkedUnifiedArtifacts({ dryRun: u.dryRun, targets: cleanupTargets }, localPaths);
-    } else {
-      const label = cleanupTargets
-        ? Object.keys(cleanupTargets).filter((key) => cleanupTargets[key]).join(', ')
-        : 'OpenCode, Gemini, Windsurf, Codex, Antigravity';
-      console.log(`${dim}agents${reset}  (dry-run) limparia marcadores oxe-cc em pastas locais do projeto (${label})`);
-    }
-  }
-
-  if (u.cursor || u.copilot || u.copilotCli || u.allAgents || anyGranularUninstallAgent(u)) {
-    const runtimeManifest = path.join(proj, '.oxe', 'install', 'runtime-semantics.json');
-    unlinkQuiet(runtimeManifest, u);
-    track(runtimeManifest);
-  }
-}
+  if (u.allAgents || anyGranularUninstallAgent(u)) {
+    const localPaths = oxeAgentInstall.buildAgentInstallPaths(false, proj);
+    const cleanupTargets = buildAgentCleanupTargets(u);
+    if (!u.dryRun) {
+      oxeAgentInstall.cleanupMarkedUnifiedArtifacts({ dryRun: u.dryRun, targets: cleanupTargets }, localPaths);
+    } else {
+      const label = cleanupTargets
+        ? Object.keys(cleanupTargets).filter((key) => cleanupTargets[key]).join(', ')
+        : 'OpenCode, Gemini, Windsurf, Codex, Antigravity';
+      console.log(`${dim}agents${reset}  (dry-run) limparia marcadores oxe-cc em pastas locais do projeto (${label})`);
+    }
+  }
+
+  if (u.cursor || u.copilot || u.copilotCli || u.allAgents || anyGranularUninstallAgent(u)) {
+    const runtimeManifest = path.join(proj, '.oxe', 'install', 'runtime-semantics.json');
+    unlinkQuiet(runtimeManifest, u);
+    track(runtimeManifest);
+  }
+}
 
 /**
  * @param {string[]} argv
@@ -2949,21 +3069,21 @@ function uninstallLocalIdeFromProject(u, removedPaths) {
  */
 function parseUninstallArgs(argv) {
   /** @type {UninstallOpts} */
-  const out = {
-    help: false,
-    dryRun: false,
-    cursor: false,
-    copilot: false,
-    copilotCli: false,
-    allAgents: false,
-    agentOpenCode: false,
-    agentGemini: false,
-    agentCodex: false,
-    agentWindsurf: false,
-    agentAntigravity: false,
-    globalCli: false,
-    ideLocal: false,
-    ideExplicit: false,
+  const out = {
+    help: false,
+    dryRun: false,
+    cursor: false,
+    copilot: false,
+    copilotCli: false,
+    allAgents: false,
+    agentOpenCode: false,
+    agentGemini: false,
+    agentCodex: false,
+    agentWindsurf: false,
+    agentAntigravity: false,
+    globalCli: false,
+    ideLocal: false,
+    ideExplicit: false,
     noProject: false,
     copilotLegacyClean: false,
     dir: process.cwd(),
@@ -2985,35 +3105,35 @@ function parseUninstallArgs(argv) {
     } else if (a === '--copilot' || a === '--copilot-vscode') {
       out.copilot = true;
       out.ideExplicit = true;
-    } else if (a === '--copilot-cli') {
-      out.copilotCli = true;
-      out.ideExplicit = true;
-    } else if (a === '--opencode') {
-      out.agentOpenCode = true;
-      out.ideExplicit = true;
-    } else if (a === '--gemini') {
-      out.agentGemini = true;
-      out.ideExplicit = true;
-    } else if (a === '--codex') {
-      out.agentCodex = true;
-      out.ideExplicit = true;
-    } else if (a === '--windsurf') {
-      out.agentWindsurf = true;
-      out.ideExplicit = true;
-    } else if (a === '--antigravity') {
-      out.agentAntigravity = true;
-      out.ideExplicit = true;
-    } else if (a === '--copilot-legacy-clean') {
-      out.copilotLegacyClean = true;
-    } else if (a === '--all-agents') {
-      out.allAgents = true;
-      out.copilotCli = true;
-      out.agentOpenCode = true;
-      out.agentGemini = true;
-      out.agentCodex = true;
-      out.agentWindsurf = true;
-      out.agentAntigravity = true;
-      out.ideExplicit = true;
+    } else if (a === '--copilot-cli') {
+      out.copilotCli = true;
+      out.ideExplicit = true;
+    } else if (a === '--opencode') {
+      out.agentOpenCode = true;
+      out.ideExplicit = true;
+    } else if (a === '--gemini') {
+      out.agentGemini = true;
+      out.ideExplicit = true;
+    } else if (a === '--codex') {
+      out.agentCodex = true;
+      out.ideExplicit = true;
+    } else if (a === '--windsurf') {
+      out.agentWindsurf = true;
+      out.ideExplicit = true;
+    } else if (a === '--antigravity') {
+      out.agentAntigravity = true;
+      out.ideExplicit = true;
+    } else if (a === '--copilot-legacy-clean') {
+      out.copilotLegacyClean = true;
+    } else if (a === '--all-agents') {
+      out.allAgents = true;
+      out.copilotCli = true;
+      out.agentOpenCode = true;
+      out.agentGemini = true;
+      out.agentCodex = true;
+      out.agentWindsurf = true;
+      out.agentAntigravity = true;
+      out.ideExplicit = true;
     } else if (a === '--global-cli' || a === '-g') {
       out.globalCli = true;
     } else if (a === '--ide-local') out.ideLocal = true;
@@ -3027,24 +3147,24 @@ function parseUninstallArgs(argv) {
     }
   }
   if (rest.length) out.dir = rest[0];
-  if (!out.ideExplicit && !out.copilotLegacyClean) {
-    out.cursor = true;
-    out.copilot = true;
-    out.copilotCli = true;
-    out.allAgents = true;
-  } else if (out.copilotLegacyClean && !out.ideExplicit && !out.noProject) {
-    out.noProject = true;
-  }
-  if (!out.conflictFlags && out.explicitConfigDir) {
-    if (out.ideLocal) {
-      out.conflictFlags = '--config-dir não combina com --ide-local';
-    } else if (out.allAgents) {
-      out.conflictFlags = '--config-dir não combina com --all-agents';
-    } else if (anyGranularUninstallAgent(out)) {
-      out.conflictFlags = '--config-dir só é suportado com exatamente um entre --cursor, --copilot e --copilot-cli';
-    } else if (out.copilot && !out.cursor && !out.copilotCli) {
-      out.conflictFlags =
-        '--config-dir não combina com --copilot porque o GitHub Copilot no VS Code usa .github/ no workspace';
+  if (!out.ideExplicit && !out.copilotLegacyClean) {
+    out.cursor = true;
+    out.copilot = true;
+    out.copilotCli = true;
+    out.allAgents = true;
+  } else if (out.copilotLegacyClean && !out.ideExplicit && !out.noProject) {
+    out.noProject = true;
+  }
+  if (!out.conflictFlags && out.explicitConfigDir) {
+    if (out.ideLocal) {
+      out.conflictFlags = '--config-dir não combina com --ide-local';
+    } else if (out.allAgents) {
+      out.conflictFlags = '--config-dir não combina com --all-agents';
+    } else if (anyGranularUninstallAgent(out)) {
+      out.conflictFlags = '--config-dir só é suportado com exatamente um entre --cursor, --copilot e --copilot-cli';
+    } else if (out.copilot && !out.cursor && !out.copilotCli) {
+      out.conflictFlags =
+        '--config-dir não combina com --copilot porque o GitHub Copilot no VS Code usa .github/ no workspace';
     } else {
       const n = [out.cursor, out.copilot, out.copilotCli].filter(Boolean).length;
       if (n !== 1) {
@@ -3088,7 +3208,7 @@ function cleanupLegacyCopilotVsCode(ideOpts, opts, removedPaths) {
   const pr = copilotLegacyPromptDir(ideOpts);
   if (!fs.existsSync(pr)) return;
   for (const name of fs.readdirSync(pr)) {
-    if (!/^oxe-.*\.prompt\.md$/i.test(name)) continue;
+    if (name !== 'oxe.prompt.md' && !/^oxe-.*\.prompt\.md$/i.test(name)) continue;
     const promptPath = path.join(pr, name);
     unlinkQuiet(promptPath, opts);
     removedPaths.push(promptPath);
@@ -3133,15 +3253,15 @@ function runUninstall(u) {
     help: false,
     version: false,
     cursor: u.cursor,
-    copilot: u.copilot,
-    copilotCli: u.copilotCli,
-    allAgents: u.allAgents,
-    agentOpenCode: u.agentOpenCode,
-    agentGemini: u.agentGemini,
-    agentCodex: u.agentCodex,
-    agentWindsurf: u.agentWindsurf,
-    agentAntigravity: u.agentAntigravity,
-    vscode: false,
+    copilot: u.copilot,
+    copilotCli: u.copilotCli,
+    allAgents: u.allAgents,
+    agentOpenCode: u.agentOpenCode,
+    agentGemini: u.agentGemini,
+    agentCodex: u.agentCodex,
+    agentWindsurf: u.agentWindsurf,
+    agentAntigravity: u.agentAntigravity,
+    vscode: false,
     commands: false,
     agents: false,
     force: true,
@@ -3175,16 +3295,16 @@ function runUninstall(u) {
 
   const removedPaths = [];
 
-  if (u.cursor) {
+  if (u.cursor) {
     const base = cursorUserDir(ideOpts);
     const cmdDir = path.join(base, 'commands');
     const ruleDir = path.join(base, 'rules');
     if (fs.existsSync(cmdDir)) {
-      for (const name of fs.readdirSync(cmdDir)) {
-        if (oxeAgentInstall.isOxeCommandMarkdownName(name)) {
-          const p = path.join(cmdDir, name);
-          unlinkQuiet(p, u);
-          removedPaths.push(p);
+      for (const name of fs.readdirSync(cmdDir)) {
+        if (oxeAgentInstall.isOxeCommandMarkdownName(name)) {
+          const p = path.join(cmdDir, name);
+          unlinkQuiet(p, u);
+          removedPaths.push(p);
         }
       }
     }
@@ -3206,7 +3326,7 @@ function runUninstall(u) {
     const pr = path.join(u.dir, '.github', 'prompts');
     if (fs.existsSync(pr)) {
       for (const name of fs.readdirSync(pr)) {
-        if (/^oxe-.*\.prompt\.md$/i.test(name)) {
+        if (name === 'oxe.prompt.md' || /^oxe-.*\.prompt\.md$/i.test(name)) {
           const p = path.join(pr, name);
           unlinkQuiet(p, u);
           removedPaths.push(p);
@@ -3222,15 +3342,15 @@ function runUninstall(u) {
     cleanupLegacyCopilotVsCode(ideOpts, u, removedPaths);
   }
 
-  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)) {
-        if (oxeAgentInstall.isOxeCommandMarkdownName(name)) {
-          const p = path.join(cmdDir, name);
-          unlinkQuiet(p, u);
-          removedPaths.push(p);
+  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)) {
+        if (oxeAgentInstall.isOxeCommandMarkdownName(name)) {
+          const p = path.join(cmdDir, name);
+          unlinkQuiet(p, u);
+          removedPaths.push(p);
         }
       }
     }
@@ -3256,68 +3376,68 @@ function runUninstall(u) {
         removedPaths.push(skillFile);
       }
     }
-  }
-
-  if (u.allAgents || anyGranularUninstallAgent(u)) {
-    const cleanupTargets = buildAgentCleanupTargets(u);
-    if (u.dryRun) {
-      const label = cleanupTargets
-        ? Object.keys(cleanupTargets).filter((key) => cleanupTargets[key]).join(', ')
-        : 'OpenCode, Gemini, Windsurf, Codex, Antigravity';
-      console.log(`${dim}agents${reset}  (dry-run) limparia ${label || 'OpenCode, Gemini, Windsurf, Codex, Antigravity'} (marcadores oxe-cc)`);
-    } else {
-      oxeAgentInstall.cleanupMarkedUnifiedArtifacts({ dryRun: u.dryRun, targets: cleanupTargets });
-    }
-    const globalAgentPaths = oxeAgentInstall.buildAgentInstallPaths(true, u.dir);
-    const shouldTrack = (name) => !cleanupTargets || cleanupTargets[name] !== false;
-    const pushRemoved = (filePath) => {
-      if (removedPaths.indexOf(filePath) === -1) removedPaths.push(filePath);
-    };
-    if (shouldTrack('opencode')) {
-      for (const dir of globalAgentPaths.opencodeCommandDirs) {
-        if (!fs.existsSync(dir)) continue;
-        for (const name of fs.readdirSync(dir)) {
-          if (!oxeAgentInstall.isOxeCommandMarkdownName(name)) continue;
-          pushRemoved(path.join(dir, name));
-        }
-      }
-    }
-    if (shouldTrack('gemini')) {
-      pushRemoved(path.join(globalAgentPaths.geminiCommandsBase, 'oxe.toml'));
-      const geminiSub = path.join(globalAgentPaths.geminiCommandsBase, 'oxe');
-      if (fs.existsSync(geminiSub)) {
-        for (const name of fs.readdirSync(geminiSub)) {
-          if (name.endsWith('.toml')) pushRemoved(path.join(geminiSub, name));
-        }
-      }
-    }
-    if (shouldTrack('windsurf') && fs.existsSync(globalAgentPaths.windsurfWorkflowsDir)) {
-      for (const name of fs.readdirSync(globalAgentPaths.windsurfWorkflowsDir)) {
-        if (!oxeAgentInstall.isOxeCommandMarkdownName(name)) continue;
-        pushRemoved(path.join(globalAgentPaths.windsurfWorkflowsDir, name));
-      }
-    }
-    if (shouldTrack('codex')) {
-      if (fs.existsSync(globalAgentPaths.codexPromptsDir)) {
-        for (const name of fs.readdirSync(globalAgentPaths.codexPromptsDir)) {
-          if (!oxeAgentInstall.isOxeCommandMarkdownName(name)) continue;
-          pushRemoved(path.join(globalAgentPaths.codexPromptsDir, name));
-        }
-      }
-      if (fs.existsSync(globalAgentPaths.codexAgentsSkillsRoot)) {
-        for (const entry of fs.readdirSync(globalAgentPaths.codexAgentsSkillsRoot, { withFileTypes: true })) {
-          if (!entry.isDirectory() || !/^oxe($|-)/.test(entry.name)) continue;
-          pushRemoved(path.join(globalAgentPaths.codexAgentsSkillsRoot, entry.name, 'SKILL.md'));
-        }
-      }
-    }
-    if (shouldTrack('antigravity') && fs.existsSync(globalAgentPaths.antigravitySkillsRoot)) {
-      for (const entry of fs.readdirSync(globalAgentPaths.antigravitySkillsRoot, { withFileTypes: true })) {
-        if (!entry.isDirectory() || !/^oxe($|-)/.test(entry.name)) continue;
-        pushRemoved(path.join(globalAgentPaths.antigravitySkillsRoot, entry.name, 'SKILL.md'));
-      }
-    }
-  }
+  }
+
+  if (u.allAgents || anyGranularUninstallAgent(u)) {
+    const cleanupTargets = buildAgentCleanupTargets(u);
+    if (u.dryRun) {
+      const label = cleanupTargets
+        ? Object.keys(cleanupTargets).filter((key) => cleanupTargets[key]).join(', ')
+        : 'OpenCode, Gemini, Windsurf, Codex, Antigravity';
+      console.log(`${dim}agents${reset}  (dry-run) limparia ${label || 'OpenCode, Gemini, Windsurf, Codex, Antigravity'} (marcadores oxe-cc)`);
+    } else {
+      oxeAgentInstall.cleanupMarkedUnifiedArtifacts({ dryRun: u.dryRun, targets: cleanupTargets });
+    }
+    const globalAgentPaths = oxeAgentInstall.buildAgentInstallPaths(true, u.dir);
+    const shouldTrack = (name) => !cleanupTargets || cleanupTargets[name] !== false;
+    const pushRemoved = (filePath) => {
+      if (removedPaths.indexOf(filePath) === -1) removedPaths.push(filePath);
+    };
+    if (shouldTrack('opencode')) {
+      for (const dir of globalAgentPaths.opencodeCommandDirs) {
+        if (!fs.existsSync(dir)) continue;
+        for (const name of fs.readdirSync(dir)) {
+          if (!oxeAgentInstall.isOxeCommandMarkdownName(name)) continue;
+          pushRemoved(path.join(dir, name));
+        }
+      }
+    }
+    if (shouldTrack('gemini')) {
+      pushRemoved(path.join(globalAgentPaths.geminiCommandsBase, 'oxe.toml'));
+      const geminiSub = path.join(globalAgentPaths.geminiCommandsBase, 'oxe');
+      if (fs.existsSync(geminiSub)) {
+        for (const name of fs.readdirSync(geminiSub)) {
+          if (name.endsWith('.toml')) pushRemoved(path.join(geminiSub, name));
+        }
+      }
+    }
+    if (shouldTrack('windsurf') && fs.existsSync(globalAgentPaths.windsurfWorkflowsDir)) {
+      for (const name of fs.readdirSync(globalAgentPaths.windsurfWorkflowsDir)) {
+        if (!oxeAgentInstall.isOxeCommandMarkdownName(name)) continue;
+        pushRemoved(path.join(globalAgentPaths.windsurfWorkflowsDir, name));
+      }
+    }
+    if (shouldTrack('codex')) {
+      if (fs.existsSync(globalAgentPaths.codexPromptsDir)) {
+        for (const name of fs.readdirSync(globalAgentPaths.codexPromptsDir)) {
+          if (!oxeAgentInstall.isOxeCommandMarkdownName(name)) continue;
+          pushRemoved(path.join(globalAgentPaths.codexPromptsDir, name));
+        }
+      }
+      if (fs.existsSync(globalAgentPaths.codexAgentsSkillsRoot)) {
+        for (const entry of fs.readdirSync(globalAgentPaths.codexAgentsSkillsRoot, { withFileTypes: true })) {
+          if (!entry.isDirectory() || !/^oxe($|-)/.test(entry.name)) continue;
+          pushRemoved(path.join(globalAgentPaths.codexAgentsSkillsRoot, entry.name, 'SKILL.md'));
+        }
+      }
+    }
+    if (shouldTrack('antigravity') && fs.existsSync(globalAgentPaths.antigravitySkillsRoot)) {
+      for (const entry of fs.readdirSync(globalAgentPaths.antigravitySkillsRoot, { withFileTypes: true })) {
+        if (!entry.isDirectory() || !/^oxe($|-)/.test(entry.name)) continue;
+        pushRemoved(path.join(globalAgentPaths.antigravitySkillsRoot, entry.name, 'SKILL.md'));
+      }
+    }
+  }
 
   if (u.ideLocal) {
     uninstallLocalIdeFromProject(u, removedPaths);
@@ -3350,7 +3470,7 @@ function runUninstall(u) {
     }
   }
 
-  if (!u.dryRun && (u.cursor || u.copilot || u.copilotCli || u.copilotLegacyClean || anyGranularUninstallAgent(u))) {
+  if (!u.dryRun && (u.cursor || u.copilot || u.copilotCli || u.copilotLegacyClean || anyGranularUninstallAgent(u))) {
     const prev = oxeManifest.loadFileManifest(home);
     const next = { ...prev };
     for (const p of removedPaths) delete next[p];
@@ -3557,7 +3677,7 @@ function runUpdate(u) {
   const r = spawnSync('npx', args, {
     cwd: u.dir,
     stdio: 'inherit',
-    env: { ...process.env },
+    env: { ...process.env, OXE_NO_PROMPT: '1' },
     shell: process.platform === 'win32',
   });
   if (r.error) {
@@ -5271,7 +5391,7 @@ async function main() {
     process.exit(0);
   }
 
-  if (!(command === 'status' && opts.jsonOutput)) {
+  if (!((command === 'status' && opts.jsonOutput) || (command === 'doctor' && opts.jsonOutput))) {
     printBanner();
   }
 
@@ -5281,7 +5401,7 @@ async function main() {
       console.error(`${yellow}Diretório não encontrado: ${target}${reset}`);
       process.exit(1);
     }
-    runDoctor(target);
+    runDoctor(target, { release: opts.releaseDoctor, json: opts.jsonOutput, writeManifest: opts.writeManifest });
     return;
   }
 
@@ -5324,6 +5444,7 @@ async function main() {
   }
 
   await resolveInteractiveInstall(opts);
+  persistIdeScope(opts);
   runInstall(opts);
   await maybePromptGlobalCli(opts);
 }