oxe-cc 1.9.1 → 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

@@ -19,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',
@@ -275,13 +286,19 @@ 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, null, (item) => Boolean(item && item.ok));
+  return readReportSummary(
+    releasePaths(projectRoot).runtimeRealReport,
+    REQUIRED_RUNTIME_REAL_SCENARIOS_1_10,
+    (item) => Boolean(item && item.ok)
+  );
 }
 
 function loadRecoveryFixtureReport(projectRoot) {
@@ -293,7 +310,18 @@ function loadMultiAgentSoakReport(projectRoot) {
 }
 
 function loadMultiAgentRealReport(projectRoot) {
-  return readReportSummary(releasePaths(projectRoot).multiAgentRealReport, null, (item) => Boolean(item && item.ok));
+  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) {
@@ -506,6 +534,7 @@ function inspectReleaseReadiness(projectRoot, options = {}) {
 
 module.exports = {
   REQUIRED_RUNTIMES,
+  REQUIRED_RUNTIME_REAL_SCENARIOS_1_10,
   WRAPPER_TARGETS,
   releasePaths,
   collectWrapperHashes,

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);
@@ -4898,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

@@ -35,6 +35,8 @@ Todos os artefatos abaixo devem existir em `.oxe/release/`:
 - `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
 
 - `execute` e `verify`: `runtime-first`

package/lib/runtime/scheduler/multi-agent-coordinator.d.ts

@@ -45,10 +45,19 @@ export interface WorkspaceMergeRecord {
     root_path: string | null;
     mutation_scope: string[];
     diff_paths: string[];
+    evidence_refs: string[];
     evidence_count: number;
     verify_status: 'pass' | 'fail' | 'partial';
     status: 'ready' | 'merged' | 'blocked' | 'skipped';
     blocker: string | null;
+    applied_paths: string[];
+    diff_summary: {
+        added: number;
+        modified: number;
+        missing: number;
+        paths: string[];
+    };
+    next_action: string | null;
     recorded_at: string;
 }
 export interface WorkspaceMergeReport {

package/lib/runtime/scheduler/multi-agent-coordinator.js

@@ -122,7 +122,8 @@ function mutationScopeOf(node) {
     return Array.isArray(node?.mutation_scope) ? node.mutation_scope.map(String).filter(Boolean) : [];
 }
 function createMergeRecord(agent, node, lease, result) {
-    const evidenceCount = Array.isArray(result?.evidence) ? result.evidence.length : 0;
+    const evidenceRefs = Array.isArray(result?.evidence) ? result.evidence.map(String).filter(Boolean) : [];
+    const scope = mutationScopeOf(node);
     return {
         work_item_id: node.id,
         agent_id: agent.id,
@@ -132,12 +133,31 @@ function createMergeRecord(agent, node, lease, result) {
         branch: lease.branch ?? null,
         base_commit: lease.base_commit ?? null,
         root_path: lease.root_path ?? null,
-        mutation_scope: mutationScopeOf(node),
-        diff_paths: mutationScopeOf(node),
-        evidence_count: evidenceCount,
+        mutation_scope: scope,
+        diff_paths: scope,
+        evidence_refs: evidenceRefs,
+        evidence_count: evidenceRefs.length,
         verify_status: result ? (result.success ? 'pass' : 'fail') : 'partial',
         status: result ? (result.success ? 'ready' : 'blocked') : 'ready',
         blocker: result && !result.success ? `verify_failed:${result.failure_class}` : null,
+        applied_paths: [],
+        diff_summary: { added: 0, modified: 0, missing: 0, paths: scope },
+        next_action: result && !result.success ? 'Corrija a falha de verify/evidence antes de aplicar merge do workspace.' : null,
+        recorded_at: new Date().toISOString(),
+    };
+}
+function enrichMergeRecordWithResult(record, result) {
+    if (!result)
+        return record;
+    const evidenceRefs = Array.isArray(result.evidence) ? result.evidence.map(String).filter(Boolean) : [];
+    return {
+        ...record,
+        evidence_refs: evidenceRefs,
+        evidence_count: evidenceRefs.length,
+        verify_status: result.success ? 'pass' : 'fail',
+        status: result.success ? 'ready' : 'blocked',
+        blocker: result.success ? null : `verify_failed:${result.failure_class}`,
+        next_action: result.success ? null : 'Corrija a falha de verify/evidence antes de aplicar merge do workspace.',
         recorded_at: new Date().toISOString(),
     };
 }
@@ -179,16 +199,37 @@ function detectMutationConflicts(graph, agents, partitions) {
 function applyWorkspaceRecord(projectRoot, record) {
     if (!record.root_path || record.status !== 'ready')
         return record;
+    const appliedPaths = [];
+    const summary = { added: 0, modified: 0, missing: 0, paths: [...record.mutation_scope] };
     for (const relativePath of record.mutation_scope) {
         const source = path_1.default.join(record.root_path, relativePath);
         const target = path_1.default.join(projectRoot, relativePath);
         if (!fs_1.default.existsSync(source) || fs_1.default.statSync(source).isDirectory()) {
-            return { ...record, status: 'blocked', blocker: `missing_output:${relativePath}` };
+            summary.missing += 1;
+            return {
+                ...record,
+                status: 'blocked',
+                blocker: `missing_output:${relativePath}`,
+                diff_summary: summary,
+                next_action: `Materialize o arquivo esperado ${relativePath} no worktree do agente antes do merge.`,
+            };
         }
+        if (fs_1.default.existsSync(target))
+            summary.modified += 1;
+        else
+            summary.added += 1;
         fs_1.default.mkdirSync(path_1.default.dirname(target), { recursive: true });
         fs_1.default.copyFileSync(source, target);
+        appliedPaths.push(relativePath);
     }
-    return { ...record, status: 'merged', blocker: null };
+    return {
+        ...record,
+        status: 'merged',
+        blocker: null,
+        applied_paths: appliedPaths,
+        diff_summary: summary,
+        next_action: null,
+    };
 }
 function createTrackingWorkspaceManager(base, agent, graph, records) {
     const leases = new Map();
@@ -231,11 +272,19 @@ async function runGraphForAgent(graph, nodeIds, agent, idx, opts, heartbeatTimeo
         };
     }
     const trackingWorkspaceManager = createTrackingWorkspaceManager(agent.workspaceManager, agent, graph, workspaceRecords);
+    const taskResults = new Map();
+    const trackingExecutor = {
+        execute: async (node, lease, runId, attemptNumber) => {
+            const result = await agent.executor.execute(node, lease, runId, attemptNumber);
+            taskResults.set(node.id, result);
+            return result;
+        },
+    };
     const ctx = {
         projectRoot: opts.projectRoot,
         sessionId: opts.sessionId,
         runId: `${opts.runId}-agent${idx}`,
-        executor: agent.executor,
+        executor: trackingExecutor,
         workspaceManager: trackingWorkspaceManager,
         onEvent: opts.onEvent,
     };
@@ -243,6 +292,7 @@ async function runGraphForAgent(graph, nodeIds, agent, idx, opts, heartbeatTimeo
     const work = scheduler.run(subGraph, ctx);
     if (!heartbeatTimeoutMs || heartbeatTimeoutMs <= 0) {
         const result = await work;
+        const reconciledRecords = workspaceRecords.map((record) => enrichMergeRecordWithResult(record, taskResults.get(record.work_item_id)));
         return {
             agent_id: agent.id,
             completed: result.completed,
@@ -250,7 +300,7 @@ async function runGraphForAgent(graph, nodeIds, agent, idx, opts, heartbeatTimeo
             timed_out: false,
             assigned_task_ids: nodeIds,
             reassigned_task_ids: [],
-            workspace_records: workspaceRecords,
+            workspace_records: reconciledRecords,
             cleanup: () => trackingWorkspaceManager.disposeDeferred(),
         };
     }
@@ -276,6 +326,7 @@ async function runGraphForAgent(graph, nodeIds, agent, idx, opts, heartbeatTimeo
         };
     }
     const result = raced.result;
+    const reconciledRecords = workspaceRecords.map((record) => enrichMergeRecordWithResult(record, taskResults.get(record.work_item_id)));
     return {
         agent_id: agent.id,
         completed: result.completed,
@@ -283,7 +334,7 @@ async function runGraphForAgent(graph, nodeIds, agent, idx, opts, heartbeatTimeo
         timed_out: false,
         assigned_task_ids: nodeIds,
         reassigned_task_ids: [],
-        workspace_records: workspaceRecords,
+        workspace_records: reconciledRecords,
         cleanup: () => trackingWorkspaceManager.disposeDeferred(),
     };
 }