oxe-cc 1.5.0 → 1.6.0

package/bin/oxe-cc.js

@@ -1527,15 +1527,20 @@ function printOxeHealthDiagnostics(target, c, diagOpts = {}) {
   if (r.eventsSummary) {
     console.log(`  ${c ? dim : ''}Tracing:${c ? reset : ''} ${r.eventsSummary.total} evento(s)`);
   }
-  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 (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 || '—'}`
+  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 (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'}`
+    );
+  }
+  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 || '—'}`
     );
   }
   if (r.semanticsDrift) {
@@ -1663,10 +1668,11 @@ function runStatusFull(target) {
     sp = oxeHealth.scopedOxePaths(target, activeSession);
   }
 
-  printSection('OXE ▸ status --full');
-  console.log(`  ${c ? green : ''}Projeto:${c ? reset : ''} ${c ? cyan : ''}${target}${c ? reset : ''}`);
-  console.log(`  ${c ? green : ''}Sessão:${c ? reset : ''} ${c ? cyan : ''}${activeSession || 'modo legado'}${c ? reset : ''}`);
-  console.log(`  ${c ? green : ''}Fase:${c ? reset : ''} ${report.phase || '—'}`);
+  printSection('OXE ▸ status --full');
+  console.log(`  ${c ? green : ''}Projeto:${c ? reset : ''} ${c ? cyan : ''}${target}${c ? reset : ''}`);
+  console.log(`  ${c ? green : ''}Sessão:${c ? reset : ''} ${c ? cyan : ''}${activeSession || 'modo legado'}${c ? reset : ''}`);
+  console.log(`  ${c ? green : ''}Workspace mode:${c ? reset : ''} ${report.workspaceMode || 'oxe_project'}`);
+  console.log(`  ${c ? green : ''}Fase:${c ? reset : ''} ${report.phase || '—'}`);
 
   const healthColor = report.healthStatus === 'healthy' ? green : report.healthStatus === 'warning' ? yellow : red;
   console.log(`  ${c ? green : ''}Saúde:${c ? reset : ''} ${c ? healthColor : ''}${report.healthStatus}${c ? reset : ''}`);
@@ -1696,17 +1702,41 @@ function runStatusFull(target) {
   console.log(`  ${coverageCell(codebaseExists, 'codebase scan')}   ${coverageCell(specExists, 'SPEC.md')}   ${coverageCell(planExists, 'PLAN.md')}   ${coverageCell(verifyExists, 'VERIFY.md')}   ${coverageCell(lessonsExists, 'LESSONS.md')}`);
 
   // Readiness gate
-  const ready = specExists && planExists && !report.planWarn.length && !report.runtimeWarn.length;
-  const gateColor = ready ? green : yellow;
-  console.log(`\n  ${c ? yellow : ''}Readiness gate${c ? reset : ''}`);
-  console.log(`  ${c ? gateColor : ''}${ready ? '✓ Pronto para executar' : '✗ Não pronto para executar'}${c ? reset : ''}`);
-  if (!specExists) console.log(`  ${c ? dim : ''}  • SPEC.md ausente — rode /oxe-spec${c ? reset : ''}`);
-  if (!planExists) console.log(`  ${c ? dim : ''}  • PLAN.md ausente — rode /oxe-plan${c ? reset : ''}`);
-  if (report.planWarn.length) {
-    for (const w of report.planWarn) {
-      console.log(`  ${c ? yellow : ''}  • ${w}${c ? reset : ''}`);
-    }
-  }
+  const packageMode = report.workspaceMode === 'product_package';
+  const ready = packageMode
+    ? Boolean(report.releaseReadiness && report.releaseReadiness.ok)
+    : specExists
+      && planExists
+      && report.executionRationalityReady
+      && !report.planWarn.length
+      && !report.runtimeWarn.length;
+  const gateColor = ready ? green : yellow;
+  console.log(`\n  ${c ? yellow : ''}Readiness gate${c ? reset : ''}`);
+  console.log(`  ${c ? gateColor : ''}${ready ? (packageMode ? '✓ Pronto para publicar' : '✓ Pronto para executar') : (packageMode ? '✗ Não pronto para publicar' : '✗ Não pronto para executar')}${c ? reset : ''}`);
+  if (packageMode) {
+    const releaseReadiness = report.releaseReadiness || { blockers: [], warnings: [] };
+    if (Array.isArray(releaseReadiness.blockers) && releaseReadiness.blockers.length) {
+      for (const blocker of releaseReadiness.blockers) {
+        console.log(`  ${c ? red : ''}  • ${blocker}${c ? reset : ''}`);
+      }
+    }
+    if (Array.isArray(releaseReadiness.warnings) && releaseReadiness.warnings.length) {
+      for (const warning of releaseReadiness.warnings) {
+        console.log(`  ${c ? yellow : ''}  • ${warning}${c ? reset : ''}`);
+      }
+    }
+  } else {
+    if (!specExists) console.log(`  ${c ? dim : ''}  • SPEC.md ausente — rode /oxe-spec${c ? reset : ''}`);
+    if (!planExists) console.log(`  ${c ? dim : ''}  • PLAN.md ausente — rode /oxe-plan${c ? reset : ''}`);
+    if (report.planWarn.length) {
+      for (const w of report.planWarn) {
+        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'}`);
+    }
+  }
 
   // Active run summary
   if (report.activeRun) {
@@ -1792,18 +1822,24 @@ function runStatusFull(target) {
   }
 
   // Plan self-evaluation
-  if (report.planSelfEvaluation) {
-    const pse = report.planSelfEvaluation;
-    console.log(`\n  ${c ? yellow : ''}Autoavaliação do plano${c ? reset : ''}`);
-    if (pse.best_plan_current != null) {
-      const bestColor = pse.best_plan_current ? green : red;
-      console.log(`  ${c ? dim : ''}Melhor plano atual:${c ? reset : ''} ${c ? bestColor : ''}${pse.best_plan_current ? 'sim' : 'não'}${c ? reset : ''}`);
-    }
-    if (pse.confidence != null) {
-      const confColor = Number(pse.confidence) >= 70 ? green : Number(pse.confidence) >= 50 ? yellow : red;
-      console.log(`  ${c ? dim : ''}Confiança:${c ? reset : ''} ${c ? confColor : ''}${pse.confidence}%${c ? reset : ''}`);
-    }
-  }
+  if (!packageMode && report.planSelfEvaluation) {
+    const pse = report.planSelfEvaluation;
+    const threshold = report.planConfidenceThreshold || 90;
+    console.log(`\n  ${c ? yellow : ''}Autoavaliação do plano${c ? reset : ''}`);
+    if (pse.best_plan_current != null) {
+      const bestColor = pse.best_plan_current ? green : red;
+      console.log(`  ${c ? dim : ''}Melhor plano atual:${c ? reset : ''} ${c ? bestColor : ''}${pse.best_plan_current ? 'sim' : 'não'}${c ? reset : ''}`);
+    }
+    if (pse.confidence != null) {
+      const confColor = report.planConfidenceExecutable
+        ? green
+        : Number(pse.confidence) >= Math.max(80, threshold - 10)
+          ? yellow
+          : red;
+      console.log(`  ${c ? dim : ''}Confiança:${c ? reset : ''} ${c ? confColor : ''}${pse.confidence}%${c ? reset : ''}`);
+      console.log(`  ${c ? dim : ''}Gate executável:${c ? reset : ''} > ${threshold}%${pse.executable ? ' (atingido)' : ' (ainda não atingido)'}`);
+    }
+  }
 
   console.log(`\n  ${c ? dim : ''}Próximo passo:${c ? reset : ''} ${c ? cyan : ''}${report.next && report.next.cursorCmd ? report.next.cursorCmd : '—'}${c ? reset : ''}`);
   console.log(`  ${c ? dim : ''}Motivo:${c ? reset : ''} ${report.next && report.next.reason ? report.next.reason : '—'}`);
@@ -1822,11 +1858,13 @@ function runStatus(target, opts = {}) {
   const next = report.next;
 
   if (opts.json) {
-    /** @type {Record<string, unknown>} */
-    const payload = {
-      oxeStatusSchema: 5,
-      projectRoot: path.resolve(target),
-      nextStep: report.next.step,
+    /** @type {Record<string, unknown>} */
+    const payload = {
+      oxeStatusSchema: 5,
+      projectRoot: path.resolve(target),
+      workspaceMode: report.workspaceMode || 'oxe_project',
+      releaseReadiness: report.releaseReadiness || null,
+      nextStep: report.next.step,
       cursorCmd: report.next.cursorCmd,
       reason: report.next.reason,
       artifacts: report.next.artifacts,
@@ -1835,10 +1873,18 @@ function runStatus(target, opts = {}) {
       activeSession: report.activeSession,
       scanDate: report.scanDate,
       staleScan: report.stale,
-      compactDate: report.compactDate,
-        staleCompact: report.staleCompact,
-        planSelfEvaluation: report.planSelfEvaluation,
-        planReviewStatus: report.planReviewStatus,
+      compactDate: report.compactDate,
+      staleCompact: report.staleCompact,
+      planSelfEvaluation: report.planSelfEvaluation,
+      planConfidenceThreshold: report.planConfidenceThreshold,
+      planConfidenceExecutable: report.planConfidenceExecutable,
+      implementationPackReady: report.implementationPackReady,
+      referenceAnchorsReady: report.referenceAnchorsReady,
+      fixturePackReady: report.fixturePackReady,
+      executionRationalityReady: report.executionRationalityReady,
+      criticalExecutionGaps: report.criticalExecutionGaps,
+      executionRationality: report.executionRationality,
+      planReviewStatus: report.planReviewStatus,
       activeRun: report.activeRun,
       eventsSummary: report.eventsSummary,
       runtimeMode: report.runtimeMode,
@@ -1895,9 +1941,10 @@ function runStatus(target, opts = {}) {
     return;
   }
 
-  printSection('OXE ▸ status');
-  const c = useAnsiColors();
-  console.log(`  ${c ? green : ''}Projeto:${c ? reset : ''} ${c ? cyan : ''}${target}${c ? reset : ''}`);
+  printSection('OXE ▸ status');
+  const c = useAnsiColors();
+  console.log(`  ${c ? green : ''}Projeto:${c ? reset : ''} ${c ? cyan : ''}${target}${c ? reset : ''}`);
+  console.log(`  ${c ? dim : ''}Workspace mode:${c ? reset : ''} ${report.workspaceMode || 'oxe_project'}`);
 
   const wfTgt = oxeWorkflows.resolveWorkflowsDir(target);
   if (!wfTgt) {
@@ -1928,16 +1975,24 @@ function runStatus(target, opts = {}) {
   }
 
   // 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`);
-  }
+  const packageMode = report.workspaceMode === 'product_package';
+  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 (packageMode) {
+    const releaseReadiness = report.releaseReadiness || { ok: false, blockers: [], warnings: [] };
+    if (!releaseReadiness.ok && Array.isArray(releaseReadiness.blockers) && releaseReadiness.blockers.length) {
+      console.log(`  ${c ? yellow : ''}⚠ Release blockers:${c ? reset : ''} ${releaseReadiness.blockers[0]}`);
+    } else if (Array.isArray(releaseReadiness.warnings) && releaseReadiness.warnings.length) {
+      console.log(`  ${c ? dim : ''}Obs.:${c ? reset : ''} release warnings ativas — ${releaseReadiness.warnings[0]}`);
+    }
+  } else 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}`);

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: 37f74d8be3442fe1
+oxe_semantics_hash: ebb4473c14e5b080
 ---
 
 <!-- oxe-reasoning-contract:start -->
@@ -29,7 +29,7 @@ oxe_semantics_hash: 37f74d8be3442fe1
 - **Política de confiança:** explícita
 - **Tier de contexto padrão:** padrão
 - **Versão do contrato:** 2.0.0
-- **Checksum semântico:** `37f74d8be3442fe1`
+- **Checksum semântico:** `ebb4473c14e5b080`
 - **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

@@ -17,7 +17,7 @@ oxe_tool_profile: write_bounded
 oxe_confidence_policy: explicit
 oxe_context_tier: standard
 oxe_contract_version: 2.0.0
-oxe_semantics_hash: 14ddb483209b28b3
+oxe_semantics_hash: 7b3446b77aef9353
 ---
 
 <!-- oxe-reasoning-contract:start -->
@@ -31,7 +31,7 @@ oxe_semantics_hash: 14ddb483209b28b3
 - **Política de confiança:** explícita
 - **Tier de contexto padrão:** padrão
 - **Versão do contrato:** 2.0.0
-- **Checksum semântico:** `14ddb483209b28b3`
+- **Checksum semântico:** `7b3446b77aef9353`
 - **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

@@ -16,7 +16,7 @@ oxe_tool_profile: mixed
 oxe_confidence_policy: rubric
 oxe_context_tier: standard
 oxe_contract_version: 2.0.0
-oxe_semantics_hash: 7809d830a5f5ff4a
+oxe_semantics_hash: 5c589398cb807029
 ---
 
 <!-- oxe-reasoning-contract:start -->
@@ -30,7 +30,7 @@ oxe_semantics_hash: 7809d830a5f5ff4a
 - **Política de confiança:** rubrica
 - **Tier de contexto padrão:** padrão
 - **Versão do contrato:** 2.0.0
-- **Checksum semântico:** `7809d830a5f5ff4a`
+- **Checksum semântico:** `5c589398cb807029`
 - **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/docs/RELEASE-READINESS.md

@@ -13,10 +13,13 @@ npx oxe-cc doctor --release --write-manifest
 
 O `doctor --release` deve bloquear a publicação quando encontrar:
 
+- árvore canónica `oxe/workflows/`, `oxe/workflows/references/` ou `commands/oxe/` ausente
+- `workflow-runtime-contracts.json` ausente ou inválido
 - drift de versão entre `package.json`, `packages/runtime/package.json`, `vscode-extension/package.json`, `README.md`, `CHANGELOG.md` e banner
 - topo do `CHANGELOG` ausente, sem data ou sem highlights
 - runtime não compilado em `lib/runtime/index.js`
 - 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
 
 ## Relatórios obrigatórios
@@ -44,3 +47,8 @@ O pipeline de CI e o pipeline de release devem rodar o mesmo gate:
 3. `npm run release:doctor`
 
 Se qualquer etapa falhar, a release não está pronta.
+
+## Observações operacionais
+
+- `status` e `status --full` distinguem agora `workspaceMode: product_package` de `workspaceMode: oxe_project`.
+- No repositório do pacote, readiness passa a ser de publicação; o CLI deixa de bloquear por ausência de `PLAN.md` executável quando não há ciclo ativo declarado.

package/docs/RUNTIME-SMOKE-MATRIX.md

@@ -1,6 +1,6 @@
 # OXE — Runtime Smoke Matrix
 
-> Estado de suporte por runtime de IA. Atualizado em v1.5.0.
+> Estado de suporte por runtime de IA. Atualizado em v1.6.0.
 >
 > `✓` = suportado e testado | `~` = suportado parcialmente | `✗` = não suportado | `?` = não testado
 
@@ -60,11 +60,18 @@ Este documento descreve a matrix estável da release. O artefato operacional con
 
 ### Codex CLI
 
-- Lê `.github/prompts/` via `--instructions` flag
+- Lê `.codex/prompts/` como entrypoint e depende também de skills em `.agents/skills/oxe/`
+- A smoke matrix desta release valida **prompts e skills**; falha se um dos dois lados estiver ausente ou sem a política de resolução de workflow
 - `verify` parcial: gera VERIFY.md mas evidências são menos detalhadas (sem análise de AST)
 - `runtime-first` não suportado: Codex CLI não tem acesso a subprocessos Node
 - **Limitação:** não suporta contexto multi-arquivo simultâneo em tasks longas
 
+### Escopo de instalação
+
+- `--local` define o layout do repositório (`oxe/` + `.oxe/` vs só `.oxe/`)
+- `--ide-local` define que a integração do runtime deve ser instalada no próprio projeto
+- Para Codex, `install --codex --ide-local` é o fluxo correto quando a intenção é materializar `.codex/` e `.agents/` no repositório atual
+
 ### Gemini CLI
 
 - `plan` e `execute` parciais: segue o fluxo mas pode divergir dos critérios A* do SPEC

package/lib/sdk/index.cjs

@@ -20,6 +20,7 @@ const azure = require('../../bin/lib/oxe-azure.cjs');
 const context = require('../../bin/lib/oxe-context-engine.cjs');
 const runtimeSemantics = require('../../bin/lib/oxe-runtime-semantics.cjs');
 const release = require('../../bin/lib/oxe-release.cjs');
+const rationality = require('../../bin/lib/oxe-rationality.cjs');
 
 const PACKAGE_ROOT = path.join(__dirname, '..', '..');
 
@@ -541,20 +542,23 @@ module.exports = {
   /** Parsing de artefatos OXE (PLAN, SPEC, STATE, hypotheses, confidence, lessons). */
   parsePlan,
   parseSpec,
-  parseHypotheses: context.parseHypotheses,
-  parseConfidenceVector: context.parseConfidenceVector,
-  parseState,
+  parseHypotheses: context.parseHypotheses,
+  parseConfidenceVector: context.parseConfidenceVector,
+  parseExecutionPlanTasks: rationality.parsePlanTasks,
+  parseState,
   validateDecisionFidelity,
   parseLessonsMetrics,
   updateLessonMetric,
   deprecateLowEffectiveness,
 
   /** Estado do projeto, SPEC/PLAN, fase, config. */
-  health: {
-    loadOxeConfigMerged: health.loadOxeConfigMerged,
-    validateConfigShape: health.validateConfigShape,
-    buildHealthReport: health.buildHealthReport,
-    suggestNextStep: health.suggestNextStep,
+  health: {
+    loadOxeConfigMerged: health.loadOxeConfigMerged,
+    validateConfigShape: health.validateConfigShape,
+    buildHealthReport: health.buildHealthReport,
+    detectWorkspaceMode: health.detectWorkspaceMode,
+    shouldSuppressExecutionWorkspaceGates: health.shouldSuppressExecutionWorkspaceGates,
+    suggestNextStep: health.suggestNextStep,
     oxePaths: health.oxePaths,
     parseStatePhase: health.parseStatePhase,
     parseLastScanDate: health.parseLastScanDate,
@@ -568,9 +572,11 @@ module.exports = {
     planAgentsWarnings: health.planAgentsWarnings,
     phaseCoherenceWarnings: health.phaseCoherenceWarnings,
     specSectionWarnings: health.specSectionWarnings,
-    planWaveWarningsFixed: health.planWaveWarningsFixed,
-    planTaskAceiteWarnings: health.planTaskAceiteWarnings,
-    verifyGapsWithoutSummaryWarning: health.verifyGapsWithoutSummaryWarning,
+    planWaveWarningsFixed: health.planWaveWarningsFixed,
+    planTaskAceiteWarnings: health.planTaskAceiteWarnings,
+    buildExecutionRationality: health.buildExecutionRationality,
+    executionRationalityWarningsFromSummary: health.executionRationalityWarningsFromSummary,
+    verifyGapsWithoutSummaryWarning: health.verifyGapsWithoutSummaryWarning,
     expandExecutionProfile: health.expandExecutionProfile,
     ALLOWED_CONFIG_KEYS: health.ALLOWED_CONFIG_KEYS,
     EXECUTION_PROFILES: health.EXECUTION_PROFILES,
@@ -654,6 +660,9 @@ module.exports = {
     loadRecoveryFixtureReport: release.loadRecoveryFixtureReport,
     loadMultiAgentSoakReport: release.loadMultiAgentSoakReport,
     buildReleaseManifest: release.buildReleaseManifest,
+    inspectCanonicalSource: release.inspectCanonicalSource,
+    evaluateReleaseManifest: release.evaluateReleaseManifest,
+    inspectReleaseReadiness: release.inspectReleaseReadiness,
     checkReleaseConsistency: release.checkReleaseConsistency,
   },
 

package/lib/sdk/index.d.ts

@@ -160,6 +160,8 @@ export interface MultiAgentStatusSummary {
   summary?: Record<string, unknown> | null;
 }
 
+export type WorkspaceMode = 'product_package' | 'oxe_project';
+
 export interface ReleaseManifest {
   schema_version: number;
   generated_at: string;
@@ -168,6 +170,8 @@ export interface ReleaseManifest {
   release_contract: Record<string, unknown>;
   versions: Record<string, unknown>;
   runtime_compiled: { path: string; ok: boolean };
+  canonical_source?: Record<string, unknown>;
+  semantics?: Record<string, unknown>;
   wrappers: Record<string, unknown>;
   reports: Record<string, unknown>;
 }
@@ -225,21 +229,67 @@ export interface AuditSummary {
   actions: Record<string, number>;
 }
 
-export interface PromotionSummary {
-  status: string | null;
-  targetKind: string | null;
-  remote: string | null;
-  targetRef: string | null;
-  prUrl: string | null;
-  prNumber: number | null;
-  coveragePercent: number | null;
-  reasons: string[];
-  path: string;
-}
+export interface PromotionSummary {
+  status: string | null;
+  targetKind: string | null;
+  remote: string | null;
+  targetRef: string | null;
+  prUrl: string | null;
+  prNumber: number | null;
+  coveragePercent: number | null;
+  reasons: string[];
+  path: string;
+}
+
+export interface ExecutionImplementationPackSummary {
+  path: string | null;
+  exists: boolean;
+  parseError: string | null;
+  ready: boolean;
+  tasks: Array<Record<string, unknown>>;
+  taskCount: number;
+  mutatingTasks: number;
+  criticalGaps: string[];
+}
+
+export interface ExecutionReferenceAnchorsSummary {
+  path: string | null;
+  exists: boolean;
+  ready: boolean;
+  anchors: Array<Record<string, unknown>>;
+  missingCriticalCount: number;
+  staleCount: number;
+  criticalGaps: string[];
+}
+
+export interface ExecutionFixturePackSummary {
+  path: string | null;
+  exists: boolean;
+  parseError: string | null;
+  ready: boolean;
+  fixtures: Array<Record<string, unknown>>;
+  fixtureCount: number;
+  criticalGaps: string[];
+}
+
+export interface ExecutionRationalitySummary {
+  applicable: boolean;
+  planTaskCount: number;
+  externalReferenceCount: number;
+  implementationPackReady: boolean;
+  referenceAnchorsReady: boolean;
+  fixturePackReady: boolean;
+  executionRationalityReady: boolean;
+  criticalExecutionGaps: string[];
+  implementationPack: ExecutionImplementationPackSummary;
+  referenceAnchors: ExecutionReferenceAnchorsSummary;
+  fixturePack: ExecutionFixturePackSummary;
+}
 
 /** Relatório retornado por `health.buildHealthReport` e incluído em `runDoctorChecks`.healthReport. */
-export interface OxeHealthReport {
-  configPath: string | null;
+export interface OxeHealthReport {
+  workspaceMode?: WorkspaceMode;
+  configPath: string | null;
   configParseError: string | null;
   unknownConfigKeys: string[];
   typeErrors: string[];
@@ -260,10 +310,16 @@ export interface OxeHealthReport {
   copilotWarn?: string[];
   copilot?: CopilotIntegrationReport | null;
   summaryGapWarn: string | null;
-  specWarn: string[];
-  planWarn: string[];
-  planSelfEvaluation?: Record<string, unknown> | null;
-  planReviewStatus?: string | null;
+  specWarn: string[];
+  planWarn: string[];
+  planSelfEvaluation?: Record<string, unknown> | null;
+  implementationPackReady?: boolean;
+  referenceAnchorsReady?: boolean;
+  fixturePackReady?: boolean;
+  executionRationalityReady?: boolean;
+  criticalExecutionGaps?: string[];
+  executionRationality?: ExecutionRationalitySummary | null;
+  planReviewStatus?: string | null;
   activeRun?: Record<string, unknown> | null;
   eventsSummary?: Record<string, unknown> | null;
   memoryLayers?: Record<string, unknown> | null;
@@ -283,9 +339,10 @@ export interface OxeHealthReport {
   contextWarn?: string[];
   semanticsWarn?: string[];
   contextPacks?: Record<string, ContextPackSummary>;
-  contextQuality?: ContextQualitySummary;
-  semanticsDrift?: SemanticsDriftSummary;
-  packFreshness?: Record<string, PackFreshness>;
+  contextQuality?: ContextQualitySummary;
+  semanticsDrift?: SemanticsDriftSummary;
+  releaseReadiness?: ReleaseConsistencyResult | null;
+  packFreshness?: Record<string, PackFreshness>;
   activeSummaryRefs?: { project: string | null; session: string | null; phase: string | null };
   scanFocusGlobs?: unknown;
   scanIgnoreGlobs?: unknown;
@@ -616,11 +673,12 @@ export interface OxeSdk {
   readMinNode: (packageRoot: string) => number;
 
   /** Parsing de artefatos OXE. */
-  parsePlan: (planMd: string) => ParsedPlan;
-  parseHypotheses: (planText: string) => CriticalHypothesis[];
-  parseConfidenceVector: (planText: string) => ConfidenceVector | null;
-  parseSpec: (specMd: string) => ParsedSpec;
-  parseState: (stateMd: string) => ParsedState;
+  parsePlan: (planMd: string) => ParsedPlan;
+  parseHypotheses: (planText: string) => CriticalHypothesis[];
+  parseConfidenceVector: (planText: string) => ConfidenceVector | null;
+  parseExecutionPlanTasks: (planPath: string | null) => Array<Record<string, unknown>>;
+  parseSpec: (specMd: string) => ParsedSpec;
+  parseState: (stateMd: string) => ParsedState;
   validateDecisionFidelity: (discussMd: string, planMd: string) => DecisionFidelityResult;
   parseLessonsMetrics: (metricsJson: string) => LessonMetric[];
   updateLessonMetric: (metrics: LessonMetric[], lessonId: string, outcome: LessonOutcome) => LessonMetric[];
@@ -637,11 +695,13 @@ export interface OxeSdk {
     timeoutMs?: number;
   }) => Promise<Record<string, unknown>>;
 
-  health: {
-    loadOxeConfigMerged: (targetProject: string) => { config: Record<string, unknown>; path: string | null; parseError: string | null; sources: { system: string | null; user: string | null; project: string | null } };
-    validateConfigShape: (cfg: Record<string, unknown>) => { unknownKeys: string[]; typeErrors: string[] };
-    buildHealthReport: (target: string) => OxeHealthReport;
-    suggestNextStep: (target: string, cfg?: { discuss_before_plan?: boolean }) => OxeNextSuggestion;
+  health: {
+    loadOxeConfigMerged: (targetProject: string) => { config: Record<string, unknown>; path: string | null; parseError: string | null; sources: { system: string | null; user: string | null; project: string | null } };
+    validateConfigShape: (cfg: Record<string, unknown>) => { unknownKeys: string[]; typeErrors: string[] };
+    buildHealthReport: (target: string) => OxeHealthReport;
+    detectWorkspaceMode: (target: string) => { workspaceMode: WorkspaceMode; packageName: string | null; canonicalTreePresent: boolean; commandsTreePresent: boolean };
+    shouldSuppressExecutionWorkspaceGates: (workspaceMode: WorkspaceMode, phase?: string | null, activeSession?: string | null, activeRun?: Record<string, unknown> | null) => boolean;
+    suggestNextStep: (target: string, cfg?: { discuss_before_plan?: boolean }) => OxeNextSuggestion;
     oxePaths: (target: string) => Record<string, string>;
     parseStatePhase: (stateText: string) => string | null;
     parseLastScanDate: (stateText: string) => Date | null;
@@ -654,10 +714,12 @@ export interface OxeSdk {
     copilotIntegrationReport: (target: string) => CopilotIntegrationReport;
     planAgentsWarnings: (target: string) => string[];
     phaseCoherenceWarnings: (phase: string, paths: Record<string, string>) => string[];
-    specSectionWarnings: (specPath: string, requiredHeadings: string[]) => string[];
-    planWaveWarningsFixed: (planPath: string, maxPerWave: number) => string[];
-    planTaskAceiteWarnings: (planPath: string) => string[];
-    verifyGapsWithoutSummaryWarning: (verifyPath: string, summaryPath: string) => string | null;
+    specSectionWarnings: (specPath: string, requiredHeadings: string[]) => string[];
+    planWaveWarningsFixed: (planPath: string, maxPerWave: number) => string[];
+    planTaskAceiteWarnings: (planPath: string) => string[];
+    buildExecutionRationality: (paths?: Record<string, string | null | undefined>) => ExecutionRationalitySummary;
+    executionRationalityWarningsFromSummary: (summary: ExecutionRationalitySummary) => string[];
+    verifyGapsWithoutSummaryWarning: (verifyPath: string, summaryPath: string) => string | null;
     expandExecutionProfile: (profile: string) => Record<string, unknown>;
     ALLOWED_CONFIG_KEYS: string[];
     EXECUTION_PROFILES: string[];
@@ -733,6 +795,9 @@ export interface OxeSdk {
     loadRecoveryFixtureReport: (projectRoot: string) => RuntimeSmokeReport;
     loadMultiAgentSoakReport: (projectRoot: string) => RuntimeSmokeReport;
     buildReleaseManifest: (projectRoot: string, options?: Record<string, unknown>) => ReleaseManifest;
+    inspectCanonicalSource: (projectRoot: string) => Record<string, unknown>;
+    evaluateReleaseManifest: (manifest: ReleaseManifest, options?: Record<string, unknown>) => ReleaseConsistencyResult;
+    inspectReleaseReadiness: (projectRoot: string, options?: Record<string, unknown>) => ReleaseConsistencyResult;
     checkReleaseConsistency: (projectRoot: string, options?: Record<string, unknown>) => ReleaseConsistencyResult;
   };
 

package/oxe/templates/CONFIG.md

@@ -8,9 +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). |
-| `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`. |
+| `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 canónico: `90`, com gate estrito (`Confiança` precisa ser **maior que** o limiar). Valores menores que 90 não reduzem esse gate. |
+| `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`. |

package/oxe/templates/EXECUTION-RUNTIME.template.md

@@ -16,7 +16,7 @@ updated: YYYY-MM-DD
 - **Active run:** `.oxe/ACTIVE-RUN.json` ou artefato equivalente de sessão
 - **Trace log:** `.oxe/OXE-EVENTS.ndjson` ou artefato equivalente de sessão
 - **Autoavaliação do plano:** melhor=`sim|não` | confiança=`NN%`
-- **Limiar de execução:** `70%`
+- **Limiar de execução:** `>90%`
 
 ## Onda atual