oxe-cc 0.6.4 → 0.6.6

package/bin/oxe-cc.js

@@ -254,12 +254,13 @@ function buildUninstallFooter(u) {
       `${p}${rm} extensões multi-agente marcadas oxe-cc (OpenCode, Gemini TOML, Windsurf workflows, Codex prompts/skills, Antigravity), se existirem.`
     );
   }
-  if (u.ideLocal) {
-    bullets.push(
-      `${p}${rm} integrações OXE no repositório (.cursor, .github, .claude, .copilot, .opencode, … conforme flags).`
-    );
-  }
-  if (!u.noProject) {
+  if (u.ideLocal) {
+    bullets.push(
+      `${p}${rm} integrações OXE no repositório (.cursor, .github, .claude, .copilot, .opencode, … conforme flags).`
+    );
+  }
+  if (u.globalCli) bullets.push(`${p}${rm} também o pacote npm global oxe-cc do PATH.`);
+  if (!u.noProject) {
     bullets.push(
       `${p}${u.dryRun ? 'Seriam removidas' : 'Removidas'} no repositório: .oxe/workflows, .oxe/templates, oxe/ e commands/oxe (o que existir).`
     );
@@ -1049,9 +1050,9 @@ function bootstrapOxe(target, opts) {
   }
 
   // Criar estruturas opcionais: plugins/, workstreams/, memory/
-  const pluginsDir = path.join(oxeDir, 'plugins');
-  if (!fs.existsSync(pluginsDir)) {
-    ensureDir(pluginsDir);
+  const pluginsDir = path.join(oxeDir, 'plugins');
+  if (!fs.existsSync(pluginsDir)) {
+    ensureDir(pluginsDir);
     const pluginsReadme = path.join(PKG_ROOT, 'oxe', 'templates', 'PLUGINS.md');
     if (fs.existsSync(pluginsReadme)) {
       const destPluginsReadme = path.join(pluginsDir, 'README.md');
@@ -1062,15 +1063,44 @@ function bootstrapOxe(target, opts) {
     }
   }
 
-  const workstreamsDir = path.join(oxeDir, 'workstreams');
-  if (!fs.existsSync(workstreamsDir)) {
-    ensureDir(workstreamsDir);
-  }
-
-  const memoryDir = path.join(oxeDir, 'memory');
-  if (!fs.existsSync(memoryDir)) {
-    ensureDir(memoryDir);
-  }
+  const workstreamsDir = path.join(oxeDir, 'workstreams');
+  if (!fs.existsSync(workstreamsDir)) {
+    ensureDir(workstreamsDir);
+  }
+
+  const sessionsDir = path.join(oxeDir, 'sessions');
+  if (!fs.existsSync(sessionsDir)) {
+    ensureDir(sessionsDir);
+  }
+
+  const globalDir = path.join(oxeDir, 'global');
+  if (!fs.existsSync(globalDir)) {
+    ensureDir(globalDir);
+  }
+
+  const globalMilestonesDir = path.join(globalDir, 'milestones');
+  if (!fs.existsSync(globalMilestonesDir)) {
+    ensureDir(globalMilestonesDir);
+  }
+
+  const lessonsSrc = path.join(PKG_ROOT, 'oxe', 'templates', 'LESSONS.template.md');
+  const lessonsDest = path.join(globalDir, 'LESSONS.md');
+  if (fs.existsSync(lessonsSrc) && !fs.existsSync(lessonsDest)) {
+    copyFile(lessonsSrc, lessonsDest, { dryRun: false });
+    console.log(`${green}init${reset}  ${lessonsDest}`);
+  }
+
+  const milestonesSrc = path.join(PKG_ROOT, 'oxe', 'templates', 'MILESTONES.template.md');
+  const milestonesDest = path.join(globalDir, 'MILESTONES.md');
+  if (fs.existsSync(milestonesSrc) && !fs.existsSync(milestonesDest)) {
+    copyFile(milestonesSrc, milestonesDest, { dryRun: false });
+    console.log(`${green}init${reset}  ${milestonesDest}`);
+  }
+
+  const memoryDir = path.join(oxeDir, 'memory');
+  if (!fs.existsSync(memoryDir)) {
+    ensureDir(memoryDir);
+  }
 
   ensureGitignoreIgnoresOxeDir(target, { dryRun: false });
 }
@@ -1114,12 +1144,13 @@ function collectOxeRoutineHints(target, r, config) {
  * @param {boolean} c
  * @param {{ skipScanCompactAgeWarnings?: boolean }} [diagOpts]
  */
-function printOxeHealthDiagnostics(target, c, diagOpts = {}) {
-  const skipAge = Boolean(diagOpts.skipScanCompactAgeWarnings);
-  const r = oxeHealth.buildHealthReport(target);
-  const { config } = oxeHealth.loadOxeConfigMerged(target);
-
-  console.log(`\n  ${c ? cyan : ''}▸ Coerência .oxe/ e config${reset}`);
+function printOxeHealthDiagnostics(target, c, diagOpts = {}) {
+  const skipAge = Boolean(diagOpts.skipScanCompactAgeWarnings);
+  const r = oxeHealth.buildHealthReport(target);
+  const { config } = oxeHealth.loadOxeConfigMerged(target);
+
+  console.log(`\n  ${c ? cyan : ''}▸ Coerência .oxe/ e config${reset}`);
+  console.log(`  ${c ? dim : ''}Saúde lógica:${c ? reset : ''} ${r.healthStatus}`);
 
   if (r.configParseError) {
     console.log(`  ${red}FALHA${reset} config.json: ${r.configParseError}`);
@@ -1135,9 +1166,18 @@ function printOxeHealthDiagnostics(target, c, diagOpts = {}) {
     );
   }
 
-  if (r.phase) {
-    console.log(`  ${c ? dim : ''}Fase (STATE.md):${c ? reset : ''} ${r.phase}`);
-  }
+  if (r.phase) {
+    console.log(`  ${c ? dim : ''}Fase (STATE.md):${c ? reset : ''} ${r.phase}`);
+  }
+  if (r.activeSession) {
+    console.log(`  ${c ? dim : ''}Sessão ativa:${c ? reset : ''} ${r.activeSession}`);
+  }
+  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 (!skipAge) {
     if (config.scan_max_age_days > 0 && r.scanDate && r.stale.stale) {
@@ -1172,12 +1212,18 @@ function printOxeHealthDiagnostics(target, c, diagOpts = {}) {
     console.log(`  ${c ? dim : ''}Scan (ignorar):${c ? reset : ''} ${config.scan_ignore_globs.join(', ')}`);
   }
 
-  for (const w of r.phaseWarn) {
-    console.log(`  ${yellow}AVISO${reset} ${w}`);
-  }
-  if (r.summaryGapWarn) {
-    console.log(`  ${yellow}AVISO${reset} ${r.summaryGapWarn}`);
-  }
+  for (const w of r.phaseWarn) {
+    console.log(`  ${yellow}AVISO${reset} ${w}`);
+  }
+  for (const w of r.sessionWarn) {
+    console.log(`  ${yellow}AVISO${reset} ${w}`);
+  }
+  for (const w of r.installWarn) {
+    console.log(`  ${yellow}AVISO${reset} ${w}`);
+  }
+  if (r.summaryGapWarn) {
+    console.log(`  ${yellow}AVISO${reset} ${r.summaryGapWarn}`);
+  }
   for (const w of r.specWarn) {
     console.log(`  ${yellow}AVISO${reset} ${w}`);
   }
@@ -1204,20 +1250,25 @@ function runStatus(target, opts = {}) {
       nextStep: report.next.step,
       cursorCmd: report.next.cursorCmd,
       reason: report.next.reason,
-      artifacts: report.next.artifacts,
-      phase: report.phase,
-      scanDate: report.scanDate,
-      staleScan: report.stale,
-      compactDate: report.compactDate,
-      staleCompact: report.staleCompact,
-      diagnostics: {
-        configParseError: report.configParseError,
-        typeErrors: report.typeErrors,
-        unknownConfigKeys: report.unknownConfigKeys,
-        phaseWarnings: report.phaseWarn,
-        summaryGapWarning: report.summaryGapWarn,
-        specWarnings: report.specWarn,
-        planWarnings: report.planWarn,
+      artifacts: report.next.artifacts,
+      phase: report.phase,
+      healthStatus: report.healthStatus,
+      activeSession: report.activeSession,
+      scanDate: report.scanDate,
+      staleScan: report.stale,
+      compactDate: report.compactDate,
+      staleCompact: report.staleCompact,
+      planSelfEvaluation: report.planSelfEvaluation,
+      diagnostics: {
+        configParseError: report.configParseError,
+        typeErrors: report.typeErrors,
+        unknownConfigKeys: report.unknownConfigKeys,
+        phaseWarnings: report.phaseWarn,
+        sessionWarnings: report.sessionWarn,
+        installWarnings: report.installWarn,
+        summaryGapWarning: report.summaryGapWarn,
+        specWarnings: report.specWarn,
+        planWarnings: report.planWarn,
       },
     };
     if (opts.hints) {
@@ -1254,9 +1305,12 @@ function runStatus(target, opts = {}) {
   console.log(`  ${c ? dim : ''}No Cursor (referência):${c ? reset : ''} ${c ? cyan : ''}${next.cursorCmd}${reset}`);
   console.log(`  ${c ? dim : ''}Motivo:${c ? reset : ''} ${next.reason}`);
 
-  printSummaryAndNextSteps(c, {
-    bullets: [`Artefatos em jogo: ${next.artifacts.join(', ')}`],
-    nextSteps: [
+  printSummaryAndNextSteps(c, {
+    bullets: [
+      `Saúde lógica: ${report.healthStatus}`,
+      `Artefatos em jogo: ${next.artifacts.join(', ')}`,
+    ],
+    nextSteps: [
       { desc: 'Diagnóstico completo (inclui pacote de workflows):', cmd: 'npx oxe-cc doctor' },
       { desc: 'Ação sugerida no agente:', cmd: next.cursorCmd },
     ],
@@ -1355,7 +1409,7 @@ function runDoctor(target) {
     'CONVENTIONS.md',
     'CONCERNS.md',
   ];
-  if (fs.existsSync(cbDir)) {
+  if (fs.existsSync(cbDir)) {
     const missingMaps = expectedMaps.filter((f) => !fs.existsSync(path.join(cbDir, f)));
     if (missingMaps.length) {
       console.log(
@@ -1364,17 +1418,21 @@ function runDoctor(target) {
     } else {
       console.log(`${green}OK${reset} .oxe/codebase/ com os ${expectedMaps.length} mapas esperados`);
     }
-  }
-
-  printOxeHealthDiagnostics(target, c);
-
-  console.log(`\n  ${green}Diagnóstico OK — nenhum bloqueio crítico encontrado.${reset}`);
-  printSummaryAndNextSteps(c, {
-    bullets: [
-      `Projeto em ${target}`,
-      `Workflows conferidos em ${wfLabel}`,
-      'Node.js e (quando existir) config.json validados',
-    ],
+  }
+
+  printOxeHealthDiagnostics(target, c);
+  const report = oxeHealth.buildHealthReport(target);
+  const statusColor = report.healthStatus === 'healthy' ? green : report.healthStatus === 'warning' ? yellow : red;
+  console.log(`\n  ${statusColor}Diagnóstico ${report.healthStatus}${reset}`);
+  if (report.healthStatus === 'broken') {
+    process.exitCode = 1;
+  }
+  printSummaryAndNextSteps(c, {
+    bullets: [
+      `Projeto em ${target}`,
+      `Workflows conferidos em ${wfLabel}`,
+      `Saúde lógica: ${report.healthStatus}`,
+    ],
     nextSteps: [
       { desc: 'Mapear ou atualizar o codebase no agente:', cmd: '/oxe-scan' },
       { desc: 'Ver ajuda e ordem dos passos OXE:', cmd: '/oxe-help' },
@@ -1388,7 +1446,7 @@ function runDoctor(target) {
  * npm install -g oxe-cc@version (same version as this running CLI).
  * @returns {boolean}
  */
-function installGlobalCliPackage() {
+function installGlobalCliPackage() {
   const name = readPkgName();
   const ver = readPkgVersion();
   const spec = `${name}@${ver}`;
@@ -1411,7 +1469,99 @@ function installGlobalCliPackage() {
     `\n  ${c ? yellow : ''}⚠${c ? reset : ''} npm install -g falhou. Tente manualmente: ${c ? cyan : ''}npm install -g ${spec}${c ? reset : ''}\n`
   );
   return false;
-}
+}
+
+/**
+ * `npm uninstall -g oxe-cc` com a mesma semântica cross-platform do instalador.
+ * @returns {boolean}
+ */
+function uninstallGlobalCliPackage() {
+  const name = readPkgName();
+  const c = useAnsiColors();
+  const dimOrEmpty = c ? dim : '';
+  const resetOrEmpty = c ? reset : '';
+  console.log(`\n  ${dimOrEmpty}npm uninstall -g ${name}${resetOrEmpty}\n`);
+  const r = spawnSync('npm', ['uninstall', '-g', name], {
+    stdio: 'inherit',
+    shell: true,
+    env: process.env,
+  });
+  if (r.status === 0) {
+    console.log(
+      `\n  ${c ? green : ''}✓${c ? reset : ''} pacote global ${c ? cyan : ''}${name}${c ? reset : ''} removido do npm global.\n`
+    );
+    return true;
+  }
+  console.log(
+    `\n  ${c ? yellow : ''}⚠${c ? reset : ''} npm uninstall -g falhou. Remova manualmente: ${c ? cyan : ''}npm uninstall -g ${name}${c ? reset : ''}\n`
+  );
+  return false;
+}
+
+/**
+ * Best-effort: detecta se esta execução vem de uma instalação global do npm.
+ * Usa `npm root -g` para evitar confundir execução local do repositório com pacote global.
+ * @returns {boolean}
+ */
+function isRunningFromGlobalNpmInstall() {
+  try {
+    const r = spawnSync('npm', ['root', '-g'], {
+      encoding: 'utf8',
+      shell: true,
+      env: process.env,
+    });
+    if (r.status !== 0) return false;
+    const root = String(r.stdout || '').trim();
+    if (!root) return false;
+    const rel = path.relative(path.resolve(root), PKG_ROOT);
+    return rel && !rel.startsWith('..') && !path.isAbsolute(rel);
+  } catch {
+    return false;
+  }
+}
+
+/** @returns {string[]} */
+function updateForwardedInstallFlags() {
+  return [
+    '--cursor',
+    '--copilot',
+    '--copilot-cli',
+    '--all-agents',
+    '--opencode',
+    '--gemini',
+    '--codex',
+    '--windsurf',
+    '--antigravity',
+    '--vscode',
+    '--no-commands',
+    '--no-agents',
+    '--no-init-oxe',
+    '--oxe-only',
+    '--global',
+    '--local',
+    '--ide-global',
+    '--ide-local',
+    '--global-cli',
+    '-g',
+    '--no-global-cli',
+    '-l',
+    '--no-install-config',
+    '--force',
+    '-f',
+    '--all',
+    '-a',
+    '--config-dir',
+    '-c',
+  ];
+}
+
+/**
+ * @param {string[]} rest
+ * @returns {boolean}
+ */
+function updateArgsExplicitlyControlGlobalCli(rest) {
+  return rest.includes('--global-cli') || rest.includes('-g') || rest.includes('--no-global-cli') || rest.includes('-l');
+}
 
 /**
  * After copying OXE into the project: optionally install the CLI globally (pergunta interativa ou flags).
@@ -1499,21 +1649,22 @@ ${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)
-  --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
-  --config-dir <caminho>                 com exatamente uma flag IDE acima (não combina com --ide-local)
-  --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)
+  --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)
+  --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)
   --if-newer                             só executa o npx se existir versão mais nova no npm (falha de rede/registry: saída 2, sem npx)
   --dir <pasta>                          pasta em que o npx roda (padrão: atual; ignorada com --check)
   --dry-run                              mostra o comando sem executar
-  [argumentos extras…]                   repassados ao oxe-cc (ex.: --cursor --global)
+  [argumentos extras…]                   repassados ao oxe-cc (ex.: --cursor --global, --ide-local, --global-cli)
   ${dim}CI / sem rede:${reset} OXE_UPDATE_SKIP_REGISTRY=1 desativa consultas (--check sai 2; --if-newer sai 2 sem npx)
 
 ${green}Opções da instalação:${reset}
@@ -1856,7 +2007,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, ideLocal: boolean, ideExplicit: boolean, noProject: 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, globalCli: boolean, ideLocal: boolean, ideExplicit: boolean, noProject: boolean, dir: string, explicitConfigDir: string | null, parseError: boolean, unknownFlag: string, conflictFlags: string }} UninstallOpts */
 
 /**
  * @param {UninstallOpts} u
@@ -1953,10 +2104,10 @@ function uninstallLocalIdeFromProject(u, removedPaths) {
 }
 
 /**
- * @param {string[]} argv
- * @returns {UninstallOpts}
- */
-function parseUninstallArgs(argv) {
+ * @param {string[]} argv
+ * @returns {UninstallOpts}
+ */
+function parseUninstallArgs(argv) {
   /** @type {UninstallOpts} */
   const out = {
     help: false,
@@ -1964,10 +2115,11 @@ function parseUninstallArgs(argv) {
     cursor: false,
     copilot: false,
     copilotCli: false,
-    allAgents: false,
-    ideLocal: false,
-    ideExplicit: false,
-    noProject: false,
+    allAgents: false,
+    globalCli: false,
+    ideLocal: false,
+    ideExplicit: false,
+    noProject: false,
     dir: process.cwd(),
     explicitConfigDir: null,
     parseError: false,
@@ -1990,13 +2142,15 @@ function parseUninstallArgs(argv) {
     } else if (a === '--copilot-cli') {
       out.copilotCli = true;
       out.ideExplicit = true;
-    } else if (a === '--all-agents') {
-      out.allAgents = true;
-      out.copilotCli = true;
-      out.ideExplicit = true;
-    } else if (a === '--ide-local') out.ideLocal = true;
-    else if (a === '--ide-only') out.noProject = true;
-    else if (a === '--dir' && argv[i + 1]) out.dir = path.resolve(argv[++i]);
+    } else if (a === '--all-agents') {
+      out.allAgents = true;
+      out.copilotCli = true;
+      out.ideExplicit = true;
+    } else if (a === '--global-cli' || a === '-g') {
+      out.globalCli = true;
+    } else if (a === '--ide-local') out.ideLocal = true;
+    else if (a === '--ide-only') out.noProject = true;
+    else if (a === '--dir' && argv[i + 1]) out.dir = path.resolve(argv[++i]);
     else if (!a.startsWith('-')) rest.push(path.resolve(a));
     else {
       out.parseError = true;
@@ -2076,7 +2230,7 @@ function rmDirIfEmpty(dirPath, opts) {
 /**
  * @param {UninstallOpts} u
  */
-function runUninstall(u) {
+function runUninstall(u) {
   assertNotWslWindowsNode();
   const c = useAnsiColors();
   const home = os.homedir();
@@ -2233,7 +2387,7 @@ function runUninstall(u) {
     }
   }
 
-  if (!u.dryRun && (u.cursor || u.copilot || u.copilotCli)) {
+  if (!u.dryRun && (u.cursor || u.copilot || u.copilotCli)) {
     const prev = oxeManifest.loadFileManifest(home);
     const next = { ...prev };
     for (const p of removedPaths) delete next[p];
@@ -2249,20 +2403,31 @@ function runUninstall(u) {
         delete next[instPath];
       }
     }
-    oxeManifest.writeFileManifest(home, next, readPkgVersion());
-  }
-
-  printSummaryAndNextSteps(c, buildUninstallFooter(u));
-  console.log(`  ${c ? green : ''}✓${c ? reset : ''} Desinstalação concluída com sucesso.\n`);
-}
-
-/** @typedef {{ help: boolean, dryRun: boolean, check: boolean, ifNewer: boolean, dir: string, rest: string[], parseError: boolean, unknownFlag: string, conflictFlags: string|null }} UpdateOpts */
+    oxeManifest.writeFileManifest(home, next, readPkgVersion());
+  }
+
+  if (u.globalCli && !u.dryRun) {
+    uninstallGlobalCliPackage();
+  } else if (u.globalCli && u.dryRun) {
+    console.log(`${dim}npm${reset}    npm uninstall -g ${readPkgName()}`);
+  }
+
+  printSummaryAndNextSteps(c, buildUninstallFooter(u));
+  if (!u.globalCli) {
+    console.log(
+      `  ${c ? yellow : ''}Nota:${c ? reset : ''} o pacote npm global ${c ? cyan : ''}${readPkgName()}${c ? reset : ''} não é removido por padrão. Use ${c ? cyan : ''}oxe-cc uninstall --global-cli${c ? reset : ''} ou ${c ? cyan : ''}npm uninstall -g ${readPkgName()}${c ? reset : ''}.\n`
+    );
+  }
+  console.log(`  ${c ? green : ''}✓${c ? reset : ''} Desinstalação concluída com sucesso.\n`);
+}
+
+/** @typedef {{ help: boolean, dryRun: boolean, check: boolean, ifNewer: boolean, dir: string, rest: string[], parseError: boolean, unknownFlag: string, conflictFlags: string|null }} UpdateOpts */
 
 /**
  * @param {string[]} argv
  * @returns {UpdateOpts}
  */
-function parseUpdateArgs(argv) {
+function parseUpdateArgs(argv) {
   /** @type {UpdateOpts} */
   const out = {
     help: false,
@@ -2275,25 +2440,31 @@ function parseUpdateArgs(argv) {
     unknownFlag: '',
     conflictFlags: null,
   };
-  let dirExplicit = false;
-  let firstPositionalConsumed = false;
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (a === '-h' || a === '--help') out.help = true;
+  let dirExplicit = false;
+  let firstPositionalConsumed = false;
+  const passthroughFlags = new Set(updateForwardedInstallFlags());
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '-h' || a === '--help') out.help = true;
     else if (a === '--dry-run') out.dryRun = true;
     else if (a === '--check') out.check = true;
     else if (a === '--if-newer') out.ifNewer = true;
     else if (a === '--dir' && argv[i + 1]) {
       out.dir = path.resolve(argv[++i]);
       dirExplicit = true;
-    } else if (!a.startsWith('-')) {
-      if (!dirExplicit && !firstPositionalConsumed) {
-        out.dir = path.resolve(a);
-        firstPositionalConsumed = true;
-      } else out.rest.push(a);
-    } else {
-      out.parseError = true;
-      out.unknownFlag = a;
+    } else if (!a.startsWith('-')) {
+      if (!dirExplicit && !firstPositionalConsumed) {
+        out.dir = path.resolve(a);
+        firstPositionalConsumed = true;
+      } else out.rest.push(a);
+    } else if (passthroughFlags.has(a)) {
+      out.rest.push(a);
+      if ((a === '--config-dir' || a === '-c') && argv[i + 1]) {
+        out.rest.push(argv[++i]);
+      }
+    } else {
+      out.parseError = true;
+      out.unknownFlag = a;
       break;
     }
   }
@@ -2348,7 +2519,7 @@ function runUpdateVersionCheck(u) {
 /**
  * @param {UpdateOpts} u
  */
-function runUpdate(u) {
+function runUpdate(u) {
   assertNotWslWindowsNode();
   const c = useAnsiColors();
   if (u.dryRun) {
@@ -2359,8 +2530,12 @@ function runUpdate(u) {
       );
     }
     console.log(`  ${dim}Comando que seria executado (instalação):${reset}`);
-    console.log(`  ${cyan}npx -y oxe-cc@latest --force --no-global-cli -l${reset} ${u.rest.join(' ')}`);
-    console.log(`  ${dim}Diretório:${reset} ${u.dir}`);
+    const dryRunArgs = ['-y', 'oxe-cc@latest', '--force'];
+    if (updateArgsExplicitlyControlGlobalCli(u.rest)) dryRunArgs.push(...u.rest);
+    else if (isRunningFromGlobalNpmInstall()) dryRunArgs.push('--global-cli');
+    else dryRunArgs.push('--no-global-cli', '-l');
+    console.log(`  ${cyan}npx ${dryRunArgs.join(' ')}${reset}`);
+    console.log(`  ${dim}Diretório:${reset} ${u.dir}`);
     printSummaryAndNextSteps(c, {
       bullets: [
         '[simulação] O npx baixaria o pacote oxe-cc@latest e rodaria a instalação com --force.',
@@ -2405,13 +2580,20 @@ function runUpdate(u) {
     console.log(
       `  ${dim}Há versão mais nova no npm (${res.version} > ${current}); a executar npx…${reset}\n`
     );
-  }
-
-  printSection('OXE ▸ update');
-  const args = ['-y', 'oxe-cc@latest', '--force', '--no-global-cli', '-l', ...u.rest];
-  const r = spawnSync('npx', args, {
-    cwd: u.dir,
-    stdio: 'inherit',
+  }
+
+  printSection('OXE ▸ update');
+  const args = ['-y', 'oxe-cc@latest', '--force'];
+  if (updateArgsExplicitlyControlGlobalCli(u.rest)) {
+    args.push(...u.rest);
+  } else if (isRunningFromGlobalNpmInstall()) {
+    args.push('--global-cli', ...u.rest);
+  } else {
+    args.push('--no-global-cli', '-l', ...u.rest);
+  }
+  const r = spawnSync('npx', args, {
+    cwd: u.dir,
+    stdio: 'inherit',
     env: { ...process.env },
     shell: process.platform === 'win32',
   });

package/commands/oxe/ask.md

@@ -0,0 +1,14 @@
+---
+name: oxe:ask
+description: "Perguntar ao OXE sobre a situação atual com leitura robusta de STATE, sessão ativa e artefatos da trilha"
+argument-hint: "[pergunta em texto livre]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+---
+
+**Workflow canónico:** `oxe/workflows/ask.md`
+
+Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa o texto em `$ARGUMENTS` como pergunta e foco.

package/commands/oxe/session.md

@@ -0,0 +1,16 @@
+---
+name: oxe:session
+description: "Gerir sessões OXE: new, list, switch, resume, status, close, migrate"
+argument-hint: "[new <nome> | list | switch <id> | resume <id> | status | close | migrate <nome>]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+---
+
+**Workflow canónico:** `oxe/workflows/session.md`
+
+Executa integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa `$ARGUMENTS` como subcomando e foco da operação da sessão ativa.

package/oxe/templates/CONFIG.md

@@ -8,8 +8,9 @@ Copie `oxe/templates/config.template.json` para **`.oxe/config.json`** no seu pr
 |-------|------|-------------|
 | `profile` | string | Profile de execução: `balanced` (padrão) \| `strict` \| `fast` \| `legacy`. Expande automaticamente outras keys — keys explícitas prevalecem. Ver tabela abaixo. |
 | `discuss_before_plan` | boolean | Se `true`, o fluxo recomenda **`oxe:discuss`** entre spec e plan. |
-| `verification_depth` | string | Profundidade da verificação: `standard` (padrão) \| `thorough` (ativa Camada 5 — validate-gaps automático) \| `quick` (skip camadas 3–4 e UAT). |
-| `security_in_verify` | boolean | Se `true`, executa auditoria OWASP automaticamente no **verify** como **Camada 6** (produz `.oxe/SECURITY.md`). Achados P0 bloqueiam `verify_complete`. Padrão: `false`. |
+| `verification_depth` | string | Profundidade da verificação: `standard` (padrão) \| `thorough` (ativa Camada 5 — validate-gaps automático) \| `quick` (skip camadas 3–4 e UAT). |
+| `plan_confidence_threshold` | number | Limiar mínimo de confiança para o `execute` aceitar um `PLAN.md`. Padrão: `70`. Abaixo disso, o fluxo deve reduzir incerteza antes de implementar. |
+| `security_in_verify` | boolean | Se `true`, executa auditoria OWASP automaticamente no **verify** como **Camada 6** (produz `.oxe/SECURITY.md`). Achados P0 bloqueiam `verify_complete`. Padrão: `false`. |
 | `after_verify_suggest_pr` | boolean | Se `true`, o workflow **verify** inclui checklist de PR no fim. |
 | `after_verify_draft_commit` | boolean | Se `true`, o **verify** propõe rascunho de mensagem de commit alinhado aos critérios de aceite. |
 | `after_verify_suggest_uat` | boolean | Se `true`, o **verify** gera checklist UAT (Camada 4). Ativo automaticamente com `profile: strict`. |