oxe-cc 1.4.0 → 1.5.0

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 -->';
@@ -251,6 +252,13 @@ 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.`);
@@ -258,12 +266,16 @@ function buildUninstallFooter(u) {
   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 || u.allAgents) {
-    bullets.push(`${p}${rm} comandos oxe-* em ~/.claude/commands e ~/.copilot/commands.`);
+  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(
@@ -285,13 +297,30 @@ 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 */
+/** @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) {
   return !!(o.cursor || o.copilot || o.copilotCli || o.allAgents || anyGranularAgent(o));
@@ -336,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`. */
@@ -387,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;
@@ -429,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;
@@ -749,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()
     : [];
@@ -1010,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) {
@@ -1252,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)`);
@@ -1834,6 +1906,39 @@ function runStatus(target, opts = {}) {
 
   printOxeHealthDiagnostics(target, c, { skipScanCompactAgeWarnings: Boolean(opts.hints) });
 
+  // IDE readiness summary
+  const ideStatusLines = [];
+  const _copilotPromptsDir = path.join(target, '.github', 'prompts');
+  const _copilotInstructions = path.join(target, '.github', 'copilot-instructions.md');
+  ideStatusLines.push(`Copilot ${fs.existsSync(_copilotPromptsDir) || fs.existsSync(_copilotInstructions) ? (c ? green + '✓' + reset : '✓') : (c ? dim + '✗' + reset : '✗')}`);
+  ideStatusLines.push(`Cursor ${fs.existsSync(path.join(target, '.cursor', 'commands')) ? (c ? green + '✓' + reset : '✓') : (c ? dim + '✗' + reset : '✗')}`);
+  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 : '✗')}`);
+  console.log(`\n  ${c ? dim : ''}IDEs:${c ? reset : ''} ${ideStatusLines.join('  ')}`);
+
+  // Gates pending in default view
+  const pendingGateCount = report.pendingGates ? (report.pendingGates.pendingCount || 0) : 0;
+  const staleGateCount = report.pendingGates ? (report.pendingGates.staleGateCount || 0) : 0;
+  if (pendingGateCount > 0 || staleGateCount > 0) {
+    const gateMsg = [];
+    if (pendingGateCount > 0) gateMsg.push(`${pendingGateCount} pendente(s)`);
+    if (staleGateCount > 0) gateMsg.push(`${staleGateCount} stale`);
+    console.log(`  ${c ? yellow : ''}⚠ Gates:${c ? reset : ''} ${gateMsg.join(', ')} — ${c ? cyan : ''}npx oxe-cc runtime gates list --dir .${c ? reset : ''}`);
+  }
+
+  // Explicit blockage diagnosis
+  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 (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}`);
     if (routineHints.length) {
@@ -1865,7 +1970,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);
@@ -1979,6 +2123,72 @@ function runDoctor(target) {
     }
   }
 
+  // IDE health gates
+  console.log('');
+  const ideChecks = [];
+  const copilotPromptsDir = path.join(target, '.github', 'prompts');
+  const copilotInstructions = path.join(target, '.github', 'copilot-instructions.md');
+  const copilotReady = fs.existsSync(copilotPromptsDir) || fs.existsSync(copilotInstructions);
+  ideChecks.push({ label: 'Copilot', ready: copilotReady, hint: '.github/prompts/ ou copilot-instructions.md' });
+
+  const cursorDir = path.join(target, '.cursor', 'commands');
+  const cursorReady = fs.existsSync(cursorDir);
+  ideChecks.push({ label: 'Cursor', ready: cursorReady, hint: '.cursor/commands/' });
+
+  const claudeLocalDir = path.join(target, 'commands', 'oxe');
+  const claudeGlobalDir = path.join(require('os').homedir(), '.claude', 'commands');
+  const claudeReady = fs.existsSync(claudeLocalDir) || fs.existsSync(claudeGlobalDir);
+  ideChecks.push({ label: 'Claude Code', ready: claudeReady, hint: 'commands/oxe/ ou ~/.claude/commands/' });
+
+  for (const ide of ideChecks) {
+    if (ide.ready) {
+      console.log(`${c ? green : ''}OK${c ? reset : ''} ${ide.label} pronto (${ide.hint})`);
+    } else {
+      console.log(`${c ? dim : ''}Obs.:${c ? reset : ''} ${ide.label} não detectado — esperado ${ide.hint}`);
+    }
+  }
+
+  // Runtime compilation check
+  const runtimeCompiledPath = path.join(target, 'lib', 'runtime', 'index.js');
+  const runtimeDistPath = path.join(target, 'packages', 'runtime', 'dist-tests');
+  const runtimeCompiled = fs.existsSync(runtimeCompiledPath) || fs.existsSync(runtimeDistPath);
+  if (runtimeCompiled) {
+    console.log(`${c ? green : ''}OK${c ? reset : ''} Runtime compilado detectado — modo enterprise disponível`);
+  } else {
+    console.log(`${c ? dim : ''}Obs.:${c ? reset : ''} Runtime não compilado — operando em modo legado (sem perda de UX)`);
+  }
+
+  // Readiness gate summary
+  const stateFilePath = path.join(target, '.oxe', 'STATE.md');
+  let readinessCmd = '/oxe-scan';
+  let readinessDesc = 'Nenhum STATE.md encontrado';
+  if (fs.existsSync(stateFilePath)) {
+    try {
+      const stateContent = fs.readFileSync(stateFilePath, 'utf8');
+      const phaseMatch = stateContent.match(/fase[:\s]+([a-z_]+)/i) || stateContent.match(/phase[:\s]+([a-z_]+)/i) || stateContent.match(/status[:\s]+([a-z_]+)/i);
+      const phase = phaseMatch ? phaseMatch[1].toLowerCase() : 'init';
+      const phaseMap = {
+        init: { cmd: '/oxe-scan', desc: 'Pronto para /oxe-scan' },
+        scan_complete: { cmd: '/oxe-spec', desc: 'Pronto para /oxe-spec' },
+        spec_complete: { cmd: '/oxe-plan', desc: 'Pronto para /oxe-plan' },
+        plan_complete: { cmd: '/oxe-execute', desc: 'Pronto para /oxe-execute' },
+        execute_complete: { cmd: '/oxe-verify', desc: 'Pronto para /oxe-verify' },
+        verify_complete: { cmd: 'runtime promote --target pr_draft', desc: 'Pronto para promoção' },
+      };
+      const next = phaseMap[phase] || { cmd: '/oxe', desc: `Fase detectada: ${phase}` };
+      readinessCmd = next.cmd;
+      readinessDesc = next.desc;
+    } catch (_) { /* ignore */ }
+  }
+  const specPath = path.join(target, '.oxe', 'SPEC.md');
+  const specExists = fs.existsSync(specPath);
+  console.log('');
+  if (specExists) {
+    console.log(`  ${c ? green : ''}✓ ${readinessDesc}${c ? reset : ''} — próximo: ${c ? cyan : ''}${readinessCmd}${c ? reset : ''}`);
+  } else {
+    console.log(`  ${c ? yellow : ''}⚠ Falta SPEC — rode ${c ? cyan : ''}${readinessCmd}${c ? reset : ''}`);
+  }
+
   printOxeHealthDiagnostics(target, c);
   const report = oxeHealth.buildHealthReport(target);
   const statusColor = report.healthStatus === 'healthy' ? green : report.healthStatus === 'warning' ? yellow : red;
@@ -1986,10 +2196,12 @@ function runDoctor(target) {
   if (report.healthStatus === 'broken') {
     process.exitCode = 1;
   }
+  const ideReadySummary = ideChecks.filter((i) => i.ready).map((i) => i.label).join(', ') || 'nenhuma IDE detectada';
   printSummaryAndNextSteps(c, {
     bullets: [
       `Projeto em ${target}`,
       `Workflows conferidos em ${wfLabel}`,
+      `IDEs prontas: ${ideReadySummary}`,
       `Saúde lógica: ${report.healthStatus}`,
     ],
     nextSteps: [
@@ -2018,6 +2230,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`
@@ -2199,30 +2417,37 @@ 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)
+  ${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 nem com --copilot)
+  --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)
 
@@ -2260,7 +2485,7 @@ ${green}runtime${reset} (controle operacional explícito do ACTIVE-RUN)
   verify                                 executa a suite enterprise, coleta evidência e projeta VERIFY.md
   project                                projeta markdowns derivados do estado canônico
   ci                                     executa checks do runtime e persiste o resultado na run
-  promote                                promove remotamente a run ativa (estável: pr_draft)
+  promote                                promove remotamente a run ativa (estável: pr_draft)
   recover                                reidrata estado canônico/journal/gates/policy da run ativa
   gates <list|show|resolve>              fila operacional de gates pendentes e resoluções auditáveis
   --session <sessions/sNNN-slug>         força sessão específica
@@ -2274,7 +2499,7 @@ ${green}runtime${reset} (controle operacional explícito do ACTIVE-RUN)
   --gate <gate_id>                       (gates show|resolve) gate alvo
   --decision <approve|reject|waive>      (gates resolve) decisão aplicada
   --actor <id>                           (gates resolve) ator responsável
-  --target <pr_draft|branch_push>        (promote) alvo remoto; padrão pr_draft, branch_push é avançado
+  --target <pr_draft|branch_push>        (promote) alvo remoto; padrão pr_draft, branch_push é avançado
   --remote <nome>                        (promote) remote git; padrão origin
   --base <branch>                        (promote) branch/ref base; padrão main
   --minimum-coverage <0-100>             (promote) cobertura mínima exigida; padrão 100
@@ -2619,8 +2844,8 @@ function runInstall(opts) {
     }
     trackFile(runtimeSemanticsManifestPath(opts));
     if (opts.copilotCli || opts.allAgents) {
-      addTracked(path.join(installClaudeBase(opts), 'commands'), (n) => n.startsWith('oxe-') && n.endsWith('.md'));
-      addTracked(path.join(cpCliHome, 'commands'), (n) => n.startsWith('oxe-') && n.endsWith('.md'));
+      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 })) {
@@ -2638,7 +2863,7 @@ function runInstall(opts) {
     }
     if (opts.agentOpenCode || opts.allAgents) {
       for (const d of agentPaths.opencodeCommandDirs) {
-        addTracked(d, (n) => n.startsWith('oxe-') && n.endsWith('.md'));
+        addTracked(d, (n) => oxeAgentInstall.isOxeCommandMarkdownName(n));
       }
     }
     if (opts.agentGemini || opts.allAgents) {
@@ -2657,7 +2882,7 @@ function runInstall(opts) {
     if (opts.agentCodex || opts.allAgents) {
       const cxPrompts = agentPaths.codexPromptsDir;
       if (fs.existsSync(cxPrompts)) {
-        addTracked(cxPrompts, (n) => n.startsWith('oxe-') && n.endsWith('.md'));
+        addTracked(cxPrompts, (n) => oxeAgentInstall.isOxeCommandMarkdownName(n));
       }
     }
     if (opts.agentAntigravity || opts.allAgents) {
@@ -2702,7 +2927,7 @@ 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, 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
@@ -2718,7 +2943,7 @@ function uninstallLocalIdeFromProject(u, removedPaths) {
     const cmdDir = path.join(proj, '.cursor', 'commands');
     if (fs.existsSync(cmdDir)) {
       for (const name of fs.readdirSync(cmdDir)) {
-        if (name.startsWith('oxe-') && name.endsWith('.md')) {
+        if (oxeAgentInstall.isOxeCommandMarkdownName(name)) {
           const p = path.join(cmdDir, name);
           unlinkQuiet(p, u);
           track(p);
@@ -2744,7 +2969,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);
@@ -2761,7 +2986,7 @@ function uninstallLocalIdeFromProject(u, removedPaths) {
       const cmdDir = path.join(base, 'commands');
       if (!fs.existsSync(cmdDir)) continue;
       for (const name of fs.readdirSync(cmdDir)) {
-        if (name.startsWith('oxe-') && name.endsWith('.md')) {
+        if (oxeAgentInstall.isOxeCommandMarkdownName(name)) {
           const p = path.join(cmdDir, name);
           unlinkQuiet(p, u);
           track(p);
@@ -2792,16 +3017,20 @@ function uninstallLocalIdeFromProject(u, removedPaths) {
     }
   }
 
-  if (u.copilotCli || u.allAgents) {
+  if (u.allAgents || anyGranularUninstallAgent(u)) {
     const localPaths = oxeAgentInstall.buildAgentInstallPaths(false, proj);
+    const cleanupTargets = buildAgentCleanupTargets(u);
     if (!u.dryRun) {
-      oxeAgentInstall.cleanupMarkedUnifiedArtifacts(u, localPaths);
+      oxeAgentInstall.cleanupMarkedUnifiedArtifacts({ dryRun: u.dryRun, targets: cleanupTargets }, localPaths);
     } else {
-      console.log(`${dim}agents${reset}  (dry-run) limparia marcadores oxe-cc em pastas locais do projeto (OpenCode, Gemini, …)`);
+      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) {
+  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);
@@ -2821,6 +3050,11 @@ function parseUninstallArgs(argv) {
     copilot: false,
     copilotCli: false,
     allAgents: false,
+    agentOpenCode: false,
+    agentGemini: false,
+    agentCodex: false,
+    agentWindsurf: false,
+    agentAntigravity: false,
     globalCli: false,
     ideLocal: false,
     ideExplicit: false,
@@ -2848,11 +3082,31 @@ function parseUninstallArgs(argv) {
     } 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;
@@ -2871,6 +3125,7 @@ function parseUninstallArgs(argv) {
     out.cursor = true;
     out.copilot = true;
     out.copilotCli = true;
+    out.allAgents = true;
   } else if (out.copilotLegacyClean && !out.ideExplicit && !out.noProject) {
     out.noProject = true;
   }
@@ -2879,6 +3134,8 @@ function parseUninstallArgs(argv) {
       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';
@@ -2925,7 +3182,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);
@@ -2973,6 +3230,11 @@ function runUninstall(u) {
     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,
@@ -3013,7 +3275,7 @@ function runUninstall(u) {
     const ruleDir = path.join(base, 'rules');
     if (fs.existsSync(cmdDir)) {
       for (const name of fs.readdirSync(cmdDir)) {
-        if (name.startsWith('oxe-') && name.endsWith('.md')) {
+        if (oxeAgentInstall.isOxeCommandMarkdownName(name)) {
           const p = path.join(cmdDir, name);
           unlinkQuiet(p, u);
           removedPaths.push(p);
@@ -3038,7 +3300,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);
@@ -3059,7 +3321,7 @@ function runUninstall(u) {
       const cmdDir = path.join(base, 'commands');
       if (!fs.existsSync(cmdDir)) continue;
       for (const name of fs.readdirSync(cmdDir)) {
-        if (name.startsWith('oxe-') && name.endsWith('.md')) {
+        if (oxeAgentInstall.isOxeCommandMarkdownName(name)) {
           const p = path.join(cmdDir, name);
           unlinkQuiet(p, u);
           removedPaths.push(p);
@@ -3088,10 +3350,66 @@ function runUninstall(u) {
         removedPaths.push(skillFile);
       }
     }
+  }
+
+  if (u.allAgents || anyGranularUninstallAgent(u)) {
+    const cleanupTargets = buildAgentCleanupTargets(u);
     if (u.dryRun) {
-      console.log(`${dim}agents${reset}  (dry-run) limparia OpenCode, Gemini TOML, Windsurf, Codex, Antigravity (marcadores oxe-cc)`);
+      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(u);
+      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'));
+      }
     }
   }
 
@@ -3126,7 +3444,7 @@ function runUninstall(u) {
     }
   }
 
-  if (!u.dryRun && (u.cursor || u.copilot || u.copilotCli || u.copilotLegacyClean)) {
+  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];
@@ -3333,7 +3651,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) {
@@ -3951,15 +4269,24 @@ async function runRuntime(opts) {
         console.log(JSON.stringify(gates, null, 2));
         return;
       }
+      const slaHours = gates.gateSlaHours || 24;
       console.log(`  ${c ? green : ''}Run:${c ? reset : ''} ${runId || '—'}`);
-      console.log(`  ${c ? green : ''}Gates:${c ? reset : ''} total=${gates.total} pendentes=${gates.pending.length} stale=${gates.stalePending.length} resolvidos<24h=${gates.resolvedRecent.length} SLA=${gates.gateSlaHours || 24}h`);
+      console.log(`  ${c ? green : ''}Gates:${c ? reset : ''} total=${gates.total} pendentes=${gates.pending.length} stale=${gates.stalePending.length} resolvidos<24h=${gates.resolvedRecent.length} SLA=${slaHours}h`);
       console.log(`  ${c ? green : ''}Filtros:${c ? reset : ''} status=${gates.filters.status || 'all'} scope=${gates.filters.scope || '—'} task=${gates.filters.workItemId || '—'}`);
-      for (const gate of gates.pending) {
+      const allPending = [...gates.pending];
+      for (const gate of allPending) {
         const ageHours = gate.requested_at ? Math.max(0, Math.round((Date.now() - Date.parse(gate.requested_at)) / 36e5)) : null;
-        console.log(`  ${yellow}PENDING${reset} ${gate.gate_id} · ${gate.scope} · ${gate.work_item_id || 'run'} · ${gate.action || '—'}${ageHours != null ? ` · age ${ageHours}h` : ''}`);
+        const isStale = ageHours != null && ageHours > slaHours;
+        const icon = isStale ? `${c ? yellow : ''}⚠ stale (>${slaHours}h)${c ? reset : ''}` : `${c ? yellow : ''}⏳ pending${c ? reset : ''}`;
+        const suggested = gate.action === 'approve' ? 'approve' : 'approve|reject|waive';
+        console.log(`  ${icon}  ${gate.gate_id} · ${gate.scope || '—'} · ${gate.work_item_id || 'run'}${ageHours != null ? ` · ${ageHours}h aberto` : ''}`);
+        console.log(`    ${c ? dim : ''}ação sugerida: --decision ${suggested} · impacto: bloqueia promoção${c ? reset : ''}`);
       }
       for (const gate of gates.resolvedRecent) {
-        console.log(`  ${green}RESOLVED${reset} ${gate.gate_id} · ${gate.scope} · ${gate.decision || '—'} · ${gate.actor || '—'}`);
+        console.log(`  ${c ? green : ''}✓ resolved${c ? reset : ''}  ${gate.gate_id} · ${gate.scope || '—'} · ${gate.decision || '—'} · ${gate.actor || '—'}`);
+      }
+      if (gates.pending.length === 0 && gates.resolvedRecent.length === 0) {
+        console.log(`  ${c ? dim : ''}Nenhum gate pendente.${c ? reset : ''}`);
       }
       return;
     }
@@ -4012,11 +4339,16 @@ async function runRuntime(opts) {
           console.log(JSON.stringify(resolved, null, 2));
           return;
         }
-        console.log(`  ${c ? green : ''}✓${c ? reset : ''} Gate resolvido.`);
-        console.log(`  ${c ? green : ''}Gate:${c ? reset : ''} ${resolved.gate.gate_id}`);
-        console.log(`  ${c ? green : ''}Decisão:${c ? reset : ''} ${resolved.gate.decision}`);
+        const remaining = resolved.impact ? (resolved.impact.pendingRemaining || 0) : 0;
+        const staleRemaining = resolved.impact ? (resolved.impact.staleRemaining || 0) : 0;
+        const canPromote = remaining === 0 && staleRemaining === 0;
+        console.log(`  ${c ? green : ''}✓${c ? reset : ''} Gate ${resolved.gate.gate_id} resolvido (${resolved.gate.decision}).`);
         console.log(`  ${c ? green : ''}Ator:${c ? reset : ''} ${resolved.gate.actor}`);
-        console.log(`  ${c ? green : ''}Impacto:${c ? reset : ''} pendentes=${resolved.impact.pendingRemaining} stale=${resolved.impact.staleRemaining}`);
+        if (canPromote) {
+          console.log(`  ${c ? green : ''}✓ Run pode avançar para promoção — nenhum gate restante.${c ? reset : ''}`);
+        } else {
+          console.log(`  ${c ? yellow : ''}⚠ Run ainda bloqueada por ${remaining} gate(s) restante(s)${staleRemaining > 0 ? ` (${staleRemaining} stale)` : ''}.${c ? reset : ''}`);
+        }
         return;
       } catch (err) {
         console.error(`${red}${err && err.message ? err.message : 'Falha ao resolver gate.'}${reset}`);
@@ -5033,7 +5365,7 @@ async function main() {
     process.exit(0);
   }
 
-  if (!(command === 'status' && opts.jsonOutput)) {
+  if (!((command === 'status' && opts.jsonOutput) || (command === 'doctor' && opts.jsonOutput))) {
     printBanner();
   }
 
@@ -5043,7 +5375,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;
   }
 
@@ -5086,6 +5418,7 @@ async function main() {
   }
 
   await resolveInteractiveInstall(opts);
+  persistIdeScope(opts);
   runInstall(opts);
   await maybePromptGlobalCli(opts);
 }