oxe-cc 1.8.3 → 1.10.0

package/bin/lib/oxe-rationality.cjs

@@ -223,9 +223,14 @@ function summarizeReferenceAnchors(filePath, externalRefs) {
       sourceType: attrs.source_type || null,
       path: attrs.path || null,
       sourceRef: attrs.source_ref || null,
+      visualRef: attrs.visual_ref || null,
+      extractionConfidence: attrs.extraction_confidence || null,
+      reproducibility: attrs.reproducibility || null,
       relevance: (((match[2].match(/<relevance>([\s\S]*?)<\/relevance>/i) || [null, ''])[1]) || '').trim(),
       action: (((match[2].match(/<action>([\s\S]*?)<\/action>/i) || [null, ''])[1]) || '').trim(),
       summary: (((match[2].match(/<summary>([\s\S]*?)<\/summary>/i) || [null, ''])[1]) || '').trim(),
+      limitations: (((match[2].match(/<limitations>([\s\S]*?)<\/limitations>/i) || [null, ''])[1]) || '').trim(),
+      derivedRequirements: (((match[2].match(/<derived_requirements>([\s\S]*?)<\/derived_requirements>/i) || [null, ''])[1]) || '').trim(),
     });
   }
   if (status === 'not_applicable' && externalRefs.length) {
@@ -267,6 +272,136 @@ function summarizeReferenceAnchors(filePath, externalRefs) {
   };
 }
 
+function specRequiresVisualInput(specPath) {
+  const raw = readTextIfExists(specPath);
+  if (!raw) return false;
+  const text = raw.toLowerCase();
+  if (/visualinputreadiness\s*:\s*(ready|partial|blocked)/i.test(raw)) return true;
+  if (/<visual_inputs?\b/i.test(raw)) return true;
+  if (/##+\s*entradas visuais e interpreta[çc][ãa]o/i.test(raw) && !/not_applicable|não aplicável|nao aplicavel/i.test(raw)) {
+    return true;
+  }
+  return /\b(visual-?inputs?|visual attachment|screenshot|mockup|imagem anexada|anexo visual)\b/i.test(text);
+}
+
+function normalizeInspectionStatus(value) {
+  const status = String(value || '').trim().toLowerCase();
+  if (!status) return 'unavailable';
+  return status;
+}
+
+function summarizeVisualInputs(paths = {}) {
+  const specPath = paths.spec || null;
+  const jsonPath = paths.visualInputsJson || null;
+  const mdPath = paths.visualInputsMd || null;
+  const specRequires = specRequiresVisualInput(specPath);
+  const json = readJsonIfExists(jsonPath);
+  const mdExists = Boolean(readTextIfExists(mdPath));
+  const exists = Boolean(json.ok || mdExists);
+  const applicable = specRequires || exists;
+  /** @type {string[]} */
+  const criticalGaps = [];
+  if (!applicable) {
+    return {
+      applicable: false,
+      ready: true,
+      visualInputReadiness: 'not_applicable',
+      path: jsonPath,
+      markdownPath: mdPath,
+      exists,
+      inputCount: 0,
+      criticalInputCount: 0,
+      blockedCount: 0,
+      partialCount: 0,
+      inputs: [],
+      criticalGaps: [],
+    };
+  }
+  if (!json.ok) {
+    criticalGaps.push(`VISUAL-INPUTS.json inválido ou ausente${json.error ? `: ${json.error}` : ''}`);
+    return {
+      applicable: true,
+      ready: false,
+      visualInputReadiness: 'blocked',
+      path: jsonPath,
+      markdownPath: mdPath,
+      exists,
+      inputCount: 0,
+      criticalInputCount: 0,
+      blockedCount: 1,
+      partialCount: 0,
+      inputs: [],
+      criticalGaps,
+    };
+  }
+  const data = json.data && typeof json.data === 'object' ? json.data : {};
+  const inputs = Array.isArray(data.inputs) ? data.inputs : [];
+  const topReady = data.ready !== false;
+  let criticalInputCount = 0;
+  let blockedCount = 0;
+  let partialCount = 0;
+  for (const input of inputs) {
+    const id = String(input && (input.id || input.source_ref || input.sourceRef) || '?');
+    const critical = Boolean(input && input.critical === true);
+    const status = normalizeInspectionStatus(input && input.inspection_status);
+    const confidence = Number(input && input.confidence);
+    const summary = String(input && input.visual_summary || '').trim();
+    const derived = Array.isArray(input && input.derived_requirements)
+      ? input.derived_requirements
+      : [];
+    if (critical) criticalInputCount += 1;
+    if (status === 'partial') partialCount += 1;
+    if (critical && status !== 'inspected') {
+      blockedCount += 1;
+      criticalGaps.push(`VISUAL-INPUTS.json entrada crítica ${id} com inspection_status=${status}`);
+    }
+    if (critical && !summary) {
+      blockedCount += 1;
+      criticalGaps.push(`VISUAL-INPUTS.json entrada crítica ${id} sem visual_summary`);
+    }
+    if (critical && !derived.length) {
+      blockedCount += 1;
+      criticalGaps.push(`VISUAL-INPUTS.json entrada crítica ${id} sem derived_requirements`);
+    }
+    if (critical && Number.isFinite(confidence) && confidence < 0.75) {
+      partialCount += 1;
+      criticalGaps.push(`VISUAL-INPUTS.json entrada crítica ${id} com confidence abaixo de 0.75`);
+    }
+  }
+  if (data.visualInputReadiness === 'blocked') {
+    blockedCount += 1;
+    criticalGaps.push('VISUAL-INPUTS.json declara visualInputReadiness=blocked');
+  }
+  if (Array.isArray(data.critical_gaps) && data.critical_gaps.length) {
+    blockedCount += data.critical_gaps.length;
+    criticalGaps.push(...data.critical_gaps.map((gap) => `VISUAL-INPUTS.json: ${String(gap)}`));
+  }
+  if (!topReady) {
+    blockedCount += 1;
+    criticalGaps.push('VISUAL-INPUTS.json com ready=false');
+  }
+  const uniqueGaps = Array.from(new Set(criticalGaps));
+  const visualInputReadiness = uniqueGaps.length
+    ? 'blocked'
+    : partialCount > 0 || data.visualInputReadiness === 'partial'
+      ? 'partial'
+      : 'ready';
+  return {
+    applicable: true,
+    ready: visualInputReadiness !== 'blocked',
+    visualInputReadiness,
+    path: jsonPath,
+    markdownPath: mdPath,
+    exists,
+    inputCount: inputs.length,
+    criticalInputCount,
+    blockedCount,
+    partialCount,
+    inputs,
+    criticalGaps: uniqueGaps,
+  };
+}
+
 function summarizeFixturePack(filePath, planTasks, implementationPack) {
   const parsed = readJsonIfExists(filePath);
   /** @type {string[]} */
@@ -350,6 +485,11 @@ function buildExecutionRationality(paths = {}) {
   const implementationPack = summarizeImplementationPack(paths.implementationPackJson || null, planTasks);
   const referenceAnchors = summarizeReferenceAnchors(paths.referenceAnchors || null, externalRefs);
   const fixturePack = summarizeFixturePack(paths.fixturePackJson || null, planTasks, implementationPack);
+  const visualInputs = summarizeVisualInputs({
+    spec: paths.spec || null,
+    visualInputsJson: paths.visualInputsJson || null,
+    visualInputsMd: paths.visualInputsMd || null,
+  });
   const applicable = Boolean(paths.plan && fs.existsSync(paths.plan));
   const criticalExecutionGaps = applicable
     ? Array.from(
@@ -357,6 +497,7 @@ function buildExecutionRationality(paths = {}) {
         ...implementationPack.criticalGaps,
         ...referenceAnchors.criticalGaps,
         ...fixturePack.criticalGaps,
+        ...visualInputs.criticalGaps,
       ])
     )
     : [];
@@ -367,13 +508,16 @@ function buildExecutionRationality(paths = {}) {
     implementationPackReady: applicable ? implementationPack.ready : false,
     referenceAnchorsReady: applicable ? referenceAnchors.ready : false,
     fixturePackReady: applicable ? fixturePack.ready : false,
+    visualInputReadiness: applicable ? visualInputs.visualInputReadiness : 'not_applicable',
+    visualInputsReady: applicable ? visualInputs.ready : true,
     executionRationalityReady: applicable
-      ? implementationPack.ready && referenceAnchors.ready && fixturePack.ready && criticalExecutionGaps.length === 0
+      ? implementationPack.ready && referenceAnchors.ready && fixturePack.ready && visualInputs.ready && criticalExecutionGaps.length === 0
       : false,
     criticalExecutionGaps,
     implementationPack,
     referenceAnchors,
     fixturePack,
+    visualInputs,
   };
 }
 
@@ -384,4 +528,5 @@ module.exports = {
   summarizeImplementationPack,
   summarizeReferenceAnchors,
   summarizeFixturePack,
+  summarizeVisualInputs,
 };

package/bin/lib/oxe-release.cjs

@@ -3,6 +3,7 @@
 const fs = require('fs');
 const path = require('path');
 const { spawnSync } = require('child_process');
+const semver = require('semver');
 
 const oxeManifest = require('./oxe-manifest.cjs');
 const runtimeSemantics = require('./oxe-runtime-semantics.cjs');
@@ -18,6 +19,17 @@ const REQUIRED_RUNTIMES = [
   'antigravity',
 ];
 
+const REQUIRED_RUNTIME_REAL_SCENARIOS_1_10 = [
+  'static-html-js',
+  'node-cli-api',
+  'brownfield-docs',
+  'multi_file_mutation',
+  'multi_wave_app',
+  'gate_blocked_execute',
+  'partial_verify_replan',
+  'promotion_blocked_by_risk',
+];
+
 const WRAPPER_TARGETS = [
   {
     key: '.github/prompts',
@@ -42,8 +54,10 @@ function releasePaths(projectRoot) {
     releaseDir,
     manifest: path.join(releaseDir, 'release-manifest.json'),
     smokeReport: path.join(releaseDir, 'runtime-smoke-report.json'),
+    runtimeRealReport: path.join(releaseDir, 'runtime-real-report.json'),
     recoveryFixtureReport: path.join(releaseDir, 'recovery-fixture-report.json'),
     multiAgentSoakReport: path.join(releaseDir, 'multi-agent-soak-report.json'),
+    multiAgentRealReport: path.join(releaseDir, 'multi-agent-real-report.json'),
   };
 }
 
@@ -272,11 +286,21 @@ function loadRuntimeSmokeReport(projectRoot) {
       && item.wrapper_drift_ok !== false
       && item.extra_checks_ok !== false
       && item.agent_checks_ok !== false
+      && item.copilot_manifest_ok !== false
+      && item.codex_discovery_ok !== false
       && item.uninstall_ok
     );
   });
 }
 
+function loadRuntimeRealReport(projectRoot) {
+  return readReportSummary(
+    releasePaths(projectRoot).runtimeRealReport,
+    REQUIRED_RUNTIME_REAL_SCENARIOS_1_10,
+    (item) => Boolean(item && item.ok)
+  );
+}
+
 function loadRecoveryFixtureReport(projectRoot) {
   return readReportSummary(releasePaths(projectRoot).recoveryFixtureReport, null, (item) => Boolean(item && item.ok));
 }
@@ -285,6 +309,21 @@ function loadMultiAgentSoakReport(projectRoot) {
   return readReportSummary(releasePaths(projectRoot).multiAgentSoakReport, null, (item) => Boolean(item && item.ok));
 }
 
+function loadMultiAgentRealReport(projectRoot) {
+  return readReportSummary(releasePaths(projectRoot).multiAgentRealReport, null, (item) => {
+    if (!item || !item.ok) return false;
+    const records = item.report && Array.isArray(item.report.records) ? item.report.records : [];
+    for (const record of records) {
+      if (record.status !== 'merged') continue;
+      if (record.verify_status !== 'pass') return false;
+      if (!Array.isArray(record.evidence_refs) || record.evidence_refs.length === 0) return false;
+      if (!Array.isArray(record.applied_paths) || record.applied_paths.length === 0) return false;
+      if (!record.diff_summary || !Array.isArray(record.diff_summary.paths) || record.diff_summary.paths.length === 0) return false;
+    }
+    return true;
+  });
+}
+
 function readVersionSnapshot(projectRoot) {
   const packageJsonPath = path.join(projectRoot, 'package.json');
   const runtimePackagePath = path.join(projectRoot, 'packages', 'runtime', 'package.json');
@@ -349,8 +388,10 @@ function buildReleaseManifest(projectRoot, options = {}) {
   } : syncWrappers(projectRoot, packageRoot);
   const semanticsAudit = runtimeSemantics.auditRuntimeTargets(projectRoot);
   const smoke = loadRuntimeSmokeReport(projectRoot);
+  const runtimeReal = loadRuntimeRealReport(projectRoot);
   const recovery = loadRecoveryFixtureReport(projectRoot);
   const multiAgent = loadMultiAgentSoakReport(projectRoot);
+  const multiAgentReal = loadMultiAgentRealReport(projectRoot);
   const manifest = {
     schema_version: 1,
     generated_at: new Date().toISOString(),
@@ -384,8 +425,10 @@ function buildReleaseManifest(projectRoot, options = {}) {
     },
     reports: {
       runtime_smoke: smoke,
+      runtime_real: runtimeReal,
       recovery_fixtures: recovery,
       multi_agent_soak: multiAgent,
+      multi_agent_real: multiAgentReal,
     },
   };
   if (options.writeManifest) {
@@ -449,12 +492,21 @@ function evaluateReleaseManifest(manifest, options = {}) {
   if (!manifest.reports.runtime_smoke.present || !manifest.reports.runtime_smoke.ok) {
     blockers.push('runtime smoke matrix incompleta ou com falhas');
   }
+  if (!manifest.reports.runtime_real.present || !manifest.reports.runtime_real.ok) {
+    blockers.push('runtime real report incompleto ou com falhas');
+  }
   if (!manifest.reports.recovery_fixtures.present || !manifest.reports.recovery_fixtures.ok) {
     blockers.push('recovery fixture report incompleto ou com falhas');
   }
   if (!manifest.reports.multi_agent_soak.present || !manifest.reports.multi_agent_soak.ok) {
     blockers.push('multi-agent soak report incompleto ou com falhas');
   }
+  const releaseVersion = semver.valid(versions.root) ? versions.root : null;
+  if (releaseVersion && semver.gte(releaseVersion, '1.9.1')) {
+    if (!manifest.reports.multi_agent_real.present || !manifest.reports.multi_agent_real.ok) {
+      blockers.push('multi-agent real report incompleto ou com falhas');
+    }
+  }
   if (versions.banner.mode === 'unknown') {
     warnings.push('banner.txt sem placeholder v{version} nem versão fixa detectável');
   }
@@ -482,12 +534,15 @@ function inspectReleaseReadiness(projectRoot, options = {}) {
 
 module.exports = {
   REQUIRED_RUNTIMES,
+  REQUIRED_RUNTIME_REAL_SCENARIOS_1_10,
   WRAPPER_TARGETS,
   releasePaths,
   collectWrapperHashes,
   loadRuntimeSmokeReport,
+  loadRuntimeRealReport,
   loadRecoveryFixtureReport,
   loadMultiAgentSoakReport,
+  loadMultiAgentRealReport,
   buildReleaseManifest,
   inspectCanonicalSource,
   evaluateReleaseManifest,

package/bin/oxe-cc.js

@@ -1537,10 +1537,13 @@ function printOxeHealthDiagnostics(target, c, diagOpts = {}) {
   if (r.executionRationality && r.executionRationality.applicable === false) {
     console.log(`  ${c ? dim : ''}Prontidão racional:${c ? reset : ''} não aplicável ainda (PLAN.md ausente)`);
   } else if (typeof r.executionRationalityReady === 'boolean') {
-    console.log(
-      `  ${c ? dim : ''}Prontidão racional:${c ? reset : ''} implementation=${r.implementationPackReady ? 'ok' : 'pendente'} | anchors=${r.referenceAnchorsReady ? 'ok' : 'pendente'} | fixtures=${r.fixturePackReady ? 'ok' : 'pendente'}`
-    );
-  }
+    console.log(
+      `  ${c ? dim : ''}Prontidão racional:${c ? reset : ''} implementation=${r.implementationPackReady ? 'ok' : 'pendente'} | anchors=${r.referenceAnchorsReady ? 'ok' : 'pendente'} | fixtures=${r.fixturePackReady ? 'ok' : 'pendente'}`
+    );
+    if (r.visualInputReadiness && r.visualInputReadiness !== 'not_applicable') {
+      console.log(`  ${c ? dim : ''}Entradas visuais:${c ? reset : ''} ${r.visualInputReadiness}`);
+    }
+  }
   if (r.contextQuality) {
     console.log(
       `  ${c ? dim : ''}Contexto:${c ? reset : ''} score=${r.contextQuality.primaryScore != null ? r.contextQuality.primaryScore : '—'} | workflow=${r.contextQuality.primaryWorkflow || '—'} | status=${r.contextQuality.primaryStatus || '—'}`
@@ -1744,10 +1747,13 @@ function runStatusFull(target) {
         console.log(`  ${c ? yellow : ''}  • ${w}${c ? reset : ''}`);
       }
     }
-    if (planExists) {
-      console.log(`  ${c ? dim : ''}  • Artefatos racionais:${c ? reset : ''} implementation=${report.implementationPackReady ? 'ok' : 'pendente'} · anchors=${report.referenceAnchorsReady ? 'ok' : 'pendente'} · fixtures=${report.fixturePackReady ? 'ok' : 'pendente'}`);
-    }
-  }
+    if (planExists) {
+      console.log(`  ${c ? dim : ''}  • Artefatos racionais:${c ? reset : ''} implementation=${report.implementationPackReady ? 'ok' : 'pendente'} · anchors=${report.referenceAnchorsReady ? 'ok' : 'pendente'} · fixtures=${report.fixturePackReady ? 'ok' : 'pendente'}`);
+      if (report.visualInputReadiness && report.visualInputReadiness !== 'not_applicable') {
+        console.log(`  ${c ? dim : ''}  • Entradas visuais:${c ? reset : ''} ${report.visualInputReadiness}`);
+      }
+    }
+  }
 
   // Active run summary
   if (report.activeRun) {
@@ -1804,12 +1810,14 @@ function runStatusFull(target) {
     if (report.recoveryState) {
       console.log(`  ${c ? dim : ''}Recovery:${c ? reset : ''} ${report.recoveryState.status || 'unknown'} · recoveries ${report.recoveryState.recoverCount ?? 0} · issues ${Array.isArray(report.recoveryState.issues) ? report.recoveryState.issues.length : 0}`);
     }
-    if (report.multiAgent) {
-      const agents = Array.isArray(report.multiAgent.agents) ? report.multiAgent.agents.length : 0;
-      const handoffs = Array.isArray(report.multiAgent.handoffs) ? report.multiAgent.handoffs.length : 0;
-      const ownership = Array.isArray(report.multiAgent.ownership) ? report.multiAgent.ownership.length : 0;
-      console.log(`  ${c ? dim : ''}Multi-agent:${c ? reset : ''} ${report.multiAgent.enabled ? (report.multiAgent.mode || 'active') : 'disabled'} · agentes ${agents} · ownership ${ownership} · handoffs ${handoffs}`);
-    }
+    if (report.multiAgent) {
+      const agents = Array.isArray(report.multiAgent.agents) ? report.multiAgent.agents.length : 0;
+      const handoffs = Array.isArray(report.multiAgent.handoffs) ? report.multiAgent.handoffs.length : 0;
+      const ownership = Array.isArray(report.multiAgent.ownership) ? report.multiAgent.ownership.length : 0;
+      const blockers = Array.isArray(report.multiAgent.mergeBlockers) ? report.multiAgent.mergeBlockers.length : 0;
+      console.log(`  ${c ? dim : ''}Multi-agent:${c ? reset : ''} ${report.multiAgent.enabled ? (report.multiAgent.mode || 'active') : 'disabled'} · agentes ${agents} · ownership ${ownership} · handoffs ${handoffs} · merge ${report.multiAgent.mergeReadiness || 'n/a'} · blockers ${blockers}`);
+      if (report.multiAgent.nextAction) console.log(`  ${c ? dim : ''}Multi-agent next:${c ? reset : ''} ${report.multiAgent.nextAction}`);
+    }
     if (report.providerCatalog) {
       const summary = report.providerCatalog.summary || {};
       const pluginsCount = summary.pluginsCount ?? summary.total_plugins ?? (Array.isArray(summary.plugins) ? summary.plugins.length : 0);
@@ -1891,8 +1899,10 @@ function runStatus(target, opts = {}) {
       planConfidenceExecutable: report.planConfidenceExecutable,
       implementationPackReady: report.implementationPackReady,
       referenceAnchorsReady: report.referenceAnchorsReady,
-      fixturePackReady: report.fixturePackReady,
-      executionRationalityReady: report.executionRationalityReady,
+      fixturePackReady: report.fixturePackReady,
+      visualInputReadiness: report.visualInputReadiness,
+      visualInputsReady: report.visualInputsReady,
+      executionRationalityReady: report.executionRationalityReady,
       criticalExecutionGaps: report.criticalExecutionGaps,
       executionRationality: report.executionRationality,
       planReviewStatus: report.planReviewStatus,
@@ -4455,9 +4465,11 @@ async function runRuntime(opts) {
         : `${report.recoveryState.status} · issues=${recIssues} — rode ${c ? cyan : ''}runtime status --verbose${c ? reset : ''} para detalhes`;
       console.log(`  ${c ? green : ''}Recovery:${c ? reset : ''} ${recLabel} · recoveries=${report.recoveryState.recoverCount ?? 0}`);
     }
-    if (multiAgent) {
-      console.log(`  ${c ? green : ''}Multi-agent:${c ? reset : ''} ${multiAgent.enabled ? (multiAgent.mode || 'active') : 'disabled'} · agentes=${Array.isArray(multiAgent.agents) ? multiAgent.agents.length : 0} · ownership=${Array.isArray(multiAgent.ownership) ? multiAgent.ownership.length : 0}`);
-    }
+    if (multiAgent) {
+      const blockers = Array.isArray(multiAgent.mergeBlockers) ? multiAgent.mergeBlockers.length : 0;
+      console.log(`  ${c ? green : ''}Multi-agent:${c ? reset : ''} ${multiAgent.enabled ? (multiAgent.mode || 'active') : 'disabled'} · agentes=${Array.isArray(multiAgent.agents) ? multiAgent.agents.length : 0} · ownership=${Array.isArray(multiAgent.ownership) ? multiAgent.ownership.length : 0} · merge=${multiAgent.mergeReadiness || 'n/a'} · blockers=${blockers}`);
+      if (multiAgent.nextAction) console.log(`  ${c ? cyan : ''}Próxima ação:${c ? reset : ''} ${multiAgent.nextAction}`);
+    }
     if (report.providerCatalog && report.providerCatalog.summary) {
       const summary = report.providerCatalog.summary;
       const pluginsCount = summary.pluginsCount ?? summary.total_plugins ?? (Array.isArray(summary.plugins) ? summary.plugins.length : 0);
@@ -4764,23 +4776,32 @@ async function runRuntime(opts) {
           }
         },
       });
-      if (opts.jsonOutput) {
-        console.log(JSON.stringify(result, null, 2));
-        if (result.result && result.result.failed && result.result.failed.length > 0) process.exitCode = 1;
-        return;
-      }
-      const r = result.result || {};
-      const completed = Array.isArray(r.completed) ? r.completed : [];
-      const failed = Array.isArray(r.failed) ? r.failed : [];
-      const blocked = Array.isArray(r.blocked) ? r.blocked : [];
-      console.log(`  ${c ? green : ''}✓${c ? reset : ''} Runtime execute concluído (modo: ${result.mode})`);
-      console.log(`  ${c ? green : ''}Completados:${c ? reset : ''} ${completed.length}`);
+      if (opts.jsonOutput) {
+        console.log(JSON.stringify(result, null, 2));
+        if (result.result && ((result.result.failed && result.result.failed.length > 0) || result.result.status === 'blocked')) process.exitCode = 1;
+        return;
+      }
+      const r = result.result || {};
+      const completed = Array.isArray(r.completed) ? r.completed : [];
+      const failed = Array.isArray(r.failed) ? r.failed : [];
+      const blocked = Array.isArray(r.blocked) ? r.blocked : [];
+      const okColor = r.status === 'blocked' ? yellow : green;
+      console.log(`  ${c ? okColor : ''}${r.status === 'blocked' ? '!' : '✓'}${c ? reset : ''} Runtime execute concluído (modo: ${result.mode})`);
+      if (result.preflight) {
+        console.log(`  ${c ? green : ''}Preflight:${c ? reset : ''} ${result.preflight.ok ? 'ready' : 'blocked'}`);
+        if (Array.isArray(result.preflight.blockers) && result.preflight.blockers.length) {
+          for (const blocker of result.preflight.blockers) {
+            console.log(`  ${yellow}BLOCKER${reset} ${blocker}`);
+          }
+        }
+      }
+      console.log(`  ${c ? green : ''}Completados:${c ? reset : ''} ${completed.length}`);
       if (failed.length > 0)
         console.log(`  ${c ? red : ''}Falhos:${c ? reset : ''} ${failed.length} — ${failed.join(', ')}`);
       if (blocked.length > 0)
         console.log(`  ${c ? '\x1b[33m' : ''}Bloqueados:${c ? reset : ''} ${blocked.length} — ${blocked.join(', ')}`);
-      if (failed.length > 0) process.exitCode = 1;
-      return;
+      if (failed.length > 0 || r.status === 'blocked') process.exitCode = 1;
+      return;
     } catch (err) {
       console.error(`${red}${err && err.message ? err.message : 'Falha ao executar runtime.'}${reset}`);
       process.exit(1);
@@ -4889,11 +4910,13 @@ async function runRuntime(opts) {
       return;
     }
     console.log(`  ${c ? green : ''}Run:${c ? reset : ''} ${multiAgent.runId || '—'}`);
-    console.log(`  ${c ? green : ''}Modo:${c ? reset : ''} ${multiAgent.enabled ? (multiAgent.mode || 'active') : 'disabled'}`);
-    console.log(`  ${c ? green : ''}Isolamento:${c ? reset : ''} ${multiAgent.workspaceIsolationEnforced ? 'enforced' : 'shared/disabled'}`);
-    console.log(`  ${c ? green : ''}Agentes:${c ? reset : ''} ${Array.isArray(multiAgent.agents) ? multiAgent.agents.length : 0} · ownership=${Array.isArray(multiAgent.ownership) ? multiAgent.ownership.length : 0} · handoffs=${Array.isArray(multiAgent.handoffs) ? multiAgent.handoffs.length : 0}`);
-    return;
-  }
+    console.log(`  ${c ? green : ''}Modo:${c ? reset : ''} ${multiAgent.enabled ? (multiAgent.mode || 'active') : 'disabled'}`);
+    console.log(`  ${c ? green : ''}Isolamento:${c ? reset : ''} ${multiAgent.workspaceIsolationEnforced ? 'enforced' : 'shared/disabled'}`);
+    console.log(`  ${c ? green : ''}Agentes:${c ? reset : ''} ${Array.isArray(multiAgent.agents) ? multiAgent.agents.length : 0} · ownership=${Array.isArray(multiAgent.ownership) ? multiAgent.ownership.length : 0} · handoffs=${Array.isArray(multiAgent.handoffs) ? multiAgent.handoffs.length : 0}`);
+    console.log(`  ${c ? green : ''}Merge:${c ? reset : ''} ${multiAgent.mergeReadiness || 'n/a'} · blockers=${Array.isArray(multiAgent.mergeBlockers) ? multiAgent.mergeBlockers.length : 0} · arbitration=${multiAgent.arbitrationRequired ? 'required' : 'no'}`);
+    if (multiAgent.nextAction) console.log(`  ${c ? cyan : ''}Próxima ação:${c ? reset : ''} ${multiAgent.nextAction}`);
+    return;
+  }
 
   try {
     const next = oxeOperational.applyRuntimeAction(opts.dir, activeSession, {

package/commands/oxe/dashboard.md

@@ -15,7 +15,7 @@ oxe_tool_profile: read_heavy
 oxe_confidence_policy: explicit
 oxe_context_tier: standard
 oxe_contract_version: 2.0.0
-oxe_semantics_hash: ebb4473c14e5b080
+oxe_semantics_hash: 13daa3c62e0efaa4
 ---
 
 <!-- oxe-reasoning-contract:start -->
@@ -29,7 +29,7 @@ oxe_semantics_hash: ebb4473c14e5b080
 - **Política de confiança:** explícita
 - **Tier de contexto padrão:** padrão
 - **Versão do contrato:** 2.0.0
-- **Checksum semântico:** `ebb4473c14e5b080`
+- **Checksum semântico:** `13daa3c62e0efaa4`
 - **Entrada de contexto prioritária:** `.oxe/context/packs/dashboard.md` e `.oxe/context/packs/dashboard.json`
 - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
 - **Inspeção estruturada:** `oxe-cc context inspect --workflow dashboard --json`

package/commands/oxe/execute.md

@@ -22,7 +22,7 @@ oxe_tool_profile: write_bounded
 oxe_confidence_policy: explicit
 oxe_context_tier: standard
 oxe_contract_version: 2.0.0
-oxe_semantics_hash: 7b3446b77aef9353
+oxe_semantics_hash: 0e6003de070d497f
 ---
 
 <!-- oxe-reasoning-contract:start -->
@@ -36,7 +36,7 @@ oxe_semantics_hash: 7b3446b77aef9353
 - **Política de confiança:** explícita
 - **Tier de contexto padrão:** padrão
 - **Versão do contrato:** 2.0.0
-- **Checksum semântico:** `7b3446b77aef9353`
+- **Checksum semântico:** `0e6003de070d497f`
 - **Entrada de contexto prioritária:** `.oxe/context/packs/execute.md` e `.oxe/context/packs/execute.json`
 - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
 - **Inspeção estruturada:** `oxe-cc context inspect --workflow execute --json`

package/commands/oxe/plan.md

@@ -21,7 +21,7 @@ oxe_tool_profile: mixed
 oxe_confidence_policy: rubric
 oxe_context_tier: standard
 oxe_contract_version: 2.0.0
-oxe_semantics_hash: 5c589398cb807029
+oxe_semantics_hash: 210518babb4788d0
 ---
 
 <!-- oxe-reasoning-contract:start -->
@@ -35,7 +35,7 @@ oxe_semantics_hash: 5c589398cb807029
 - **Política de confiança:** rubrica
 - **Tier de contexto padrão:** padrão
 - **Versão do contrato:** 2.0.0
-- **Checksum semântico:** `5c589398cb807029`
+- **Checksum semântico:** `210518babb4788d0`
 - **Entrada de contexto prioritária:** `.oxe/context/packs/plan.md` e `.oxe/context/packs/plan.json`
 - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
 - **Inspeção estruturada:** `oxe-cc context inspect --workflow plan --json`

package/commands/oxe/quick.md

@@ -17,7 +17,7 @@ oxe_tool_profile: mixed
 oxe_confidence_policy: rubric
 oxe_context_tier: standard
 oxe_contract_version: 2.0.0
-oxe_semantics_hash: 2193373eb2691e0d
+oxe_semantics_hash: ea0c06ca7b5c87bb
 ---
 
 <!-- oxe-reasoning-contract:start -->
@@ -31,7 +31,7 @@ oxe_semantics_hash: 2193373eb2691e0d
 - **Política de confiança:** rubrica
 - **Tier de contexto padrão:** padrão
 - **Versão do contrato:** 2.0.0
-- **Checksum semântico:** `2193373eb2691e0d`
+- **Checksum semântico:** `ea0c06ca7b5c87bb`
 - **Entrada de contexto prioritária:** `.oxe/context/packs/quick.md` e `.oxe/context/packs/quick.json`
 - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
 - **Inspeção estruturada:** `oxe-cc context inspect --workflow quick --json`

package/commands/oxe/spec.md

@@ -20,7 +20,7 @@ oxe_tool_profile: read_heavy
 oxe_confidence_policy: explicit
 oxe_context_tier: standard
 oxe_contract_version: 2.0.0
-oxe_semantics_hash: eea8766eab635c97
+oxe_semantics_hash: 4ec66ac1e704fdbf
 ---
 
 <!-- oxe-reasoning-contract:start -->
@@ -34,7 +34,7 @@ oxe_semantics_hash: eea8766eab635c97
 - **Política de confiança:** explícita
 - **Tier de contexto padrão:** padrão
 - **Versão do contrato:** 2.0.0
-- **Checksum semântico:** `eea8766eab635c97`
+- **Checksum semântico:** `4ec66ac1e704fdbf`
 - **Entrada de contexto prioritária:** `.oxe/context/packs/spec.md` e `.oxe/context/packs/spec.json`
 - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
 - **Inspeção estruturada:** `oxe-cc context inspect --workflow spec --json`
@@ -53,4 +53,4 @@ oxe_semantics_hash: eea8766eab635c97
 
 <!-- oxe-workflow-resolution:end -->
 
-Usa `$ARGUMENTS` e o contexto da conversa como entrada do utilizador (texto ou `@ficheiro`).
+Usa `$ARGUMENTS`, contexto da conversa e anexos como entrada do utilizador. Se houver imagem, screenshot ou mockup e o runtime suportar visão, materializar a interpretação em `VISUAL-INPUTS`; se não suportar, declarar a limitação e não inventar detalhes visuais.

package/docs/RELEASE-READINESS.md

@@ -8,6 +8,7 @@ Este é o contrato mínimo para publicar uma versão estável do OXE sem drift e
 npm test
 npm run scan:assets
 npm run build:vscode-ext
+npm run release:pack-check
 npx oxe-cc doctor --release --write-manifest
 ```
 
@@ -21,6 +22,7 @@ O `doctor --release` deve bloquear a publicação quando encontrar:
 - wrappers dirty após `sync-runtime-metadata` e `sync:cursor`
 - drift semântico entre workflows canónicos e superfícies geradas
 - ausência ou falha dos relatórios obrigatórios da release
+- tarball npm contendo `.tgz`, `.vsix`, `.oxe/` ou sem arquivos obrigatórios do pacote
 
 ## Relatórios obrigatórios
 
@@ -28,8 +30,12 @@ Todos os artefatos abaixo devem existir em `.oxe/release/`:
 
 - `release-manifest.json`
 - `runtime-smoke-report.json`
+- `runtime-real-report.json`
 - `recovery-fixture-report.json`
 - `multi-agent-soak-report.json`
+- `multi-agent-real-report.json` para versões `>=1.9.1`
+
+Na linha `>=1.10.0`, `runtime-real-report.json` deve cobrir cenários representativos além do happy path simples: multi-wave, multi-file, verify parcial, gate pendente e promoção bloqueada. O `multi-agent-real-report.json` deve provar merge com evidência, diff summary, arquivos aplicados e verify status por task; o release doctor valida esse conteúdo, não apenas a presença do arquivo.
 
 ## Defaults estáveis desta publicação
 
@@ -44,7 +50,8 @@ O pipeline de CI e o pipeline de release devem rodar o mesmo gate:
 
 1. `npm test`
 2. `npm run scan:assets`
-3. `npm run release:doctor`
+3. `npm run release:pack-check`
+4. `npm run release:doctor`
 
 Se qualquer etapa falhar, a release não está pronta.