oxe-cc 1.4.0 → 1.4.1

package/bin/oxe-cc.js

@@ -247,24 +247,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';
-  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 || u.allAgents) {
-    bullets.push(`${p}${rm} comandos oxe-* em ~/.claude/commands e ~/.copilot/commands.`);
-    bullets.push(`${p}${rm} skills OXE (marcadas oxe-cc) em ~/.copilot/skills/oxe*/.`);
-    bullets.push(
-      `${p}${rm} extensões multi-agente marcadas oxe-cc (OpenCode, Gemini TOML, Windsurf workflows, Codex prompts/skills, Antigravity), se existirem.`
-    );
-  }
+  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).`
@@ -287,10 +298,27 @@ function buildUninstallFooter(u) {
 
 /** @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 {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) {
@@ -1834,6 +1862,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) {
@@ -1979,6 +2040,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 +2113,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: [
@@ -2214,17 +2343,19 @@ ${green}Uso:${reset}
   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)
-  --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)
-  --dry-run
-  --dir <pasta>                          raiz do projeto (padrão: diretório atual)
+${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)
@@ -2260,7 +2391,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 +2405,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
@@ -2617,11 +2748,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) => n.startsWith('oxe-') && n.endsWith('.md'));
-      addTracked(path.join(cpCliHome, 'commands'), (n) => n.startsWith('oxe-') && n.endsWith('.md'));
-      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;
@@ -2636,11 +2767,11 @@ function runInstall(opts) {
         }
       }
     }
-    if (opts.agentOpenCode || opts.allAgents) {
-      for (const d of agentPaths.opencodeCommandDirs) {
-        addTracked(d, (n) => n.startsWith('oxe-') && n.endsWith('.md'));
-      }
-    }
+    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'));
@@ -2654,12 +2785,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) => 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.agentAntigravity || opts.allAgents) {
       const root = agentPaths.antigravitySkillsRoot;
       if (fs.existsSync(root)) {
@@ -2702,26 +2833,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, 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 (name.startsWith('oxe-') && name.endsWith('.md')) {
-          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);
         }
       }
     }
@@ -2756,15 +2887,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 (name.startsWith('oxe-') && name.endsWith('.md')) {
-          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);
         }
       }
     }
@@ -2792,21 +2923,25 @@ function uninstallLocalIdeFromProject(u, removedPaths) {
     }
   }
 
-  if (u.copilotCli || u.allAgents) {
-    const localPaths = oxeAgentInstall.buildAgentInstallPaths(false, proj);
-    if (!u.dryRun) {
-      oxeAgentInstall.cleanupMarkedUnifiedArtifacts(u, localPaths);
-    } else {
-      console.log(`${dim}agents${reset}  (dry-run) limparia marcadores oxe-cc em pastas locais do projeto (OpenCode, Gemini, …)`);
-    }
-  }
-
-  if (u.cursor || u.copilot || u.copilotCli || u.allAgents) {
-    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
@@ -2814,16 +2949,21 @@ function uninstallLocalIdeFromProject(u, removedPaths) {
  */
 function parseUninstallArgs(argv) {
   /** @type {UninstallOpts} */
-  const out = {
-    help: false,
-    dryRun: false,
-    cursor: false,
-    copilot: false,
-    copilotCli: false,
-    allAgents: 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(),
@@ -2845,15 +2985,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 === '--copilot-legacy-clean') {
-      out.copilotLegacyClean = true;
-    } else if (a === '--all-agents') {
-      out.allAgents = true;
-      out.copilotCli = 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;
@@ -2867,21 +3027,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;
-  } 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 (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) {
@@ -2970,10 +3133,15 @@ function runUninstall(u) {
     help: false,
     version: false,
     cursor: u.cursor,
-    copilot: u.copilot,
-    copilotCli: u.copilotCli,
-    allAgents: u.allAgents,
-    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,
@@ -3007,16 +3175,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 (name.startsWith('oxe-') && name.endsWith('.md')) {
-          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);
         }
       }
     }
@@ -3054,15 +3222,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 (name.startsWith('oxe-') && name.endsWith('.md')) {
-          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);
         }
       }
     }
@@ -3088,12 +3256,68 @@ function runUninstall(u) {
         removedPaths.push(skillFile);
       }
     }
-    if (u.dryRun) {
-      console.log(`${dim}agents${reset}  (dry-run) limparia OpenCode, Gemini TOML, Windsurf, Codex, Antigravity (marcadores oxe-cc)`);
-    } else {
-      oxeAgentInstall.cleanupMarkedUnifiedArtifacts(u);
-    }
-  }
+  }
+
+  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);
@@ -3126,7 +3350,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];
@@ -3951,15 +4175,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 +4245,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}`);