Back to News

Oracle Engine Update: Unified Axis Contract & Benchmark Safety

January 8, 2026
3 min read
changelog

Internal Changelog — Technical

Oracle Engine Update

This update introduces a major internal consolidation of the Oracle engine, ensuring strict consistency between engine logic, verdicts, insights, and UI rendering across all comparison modes.


🔑 Highlights

  • Unified contract across all axes
    Damage, Survivability, Speed, and Combat now follow the same typed contract and resolution flow.

  • Normalization leaks removed in Benchmark Mode
    Raw deltas are preserved where required, preventing semantic contradictions in verdicts and insights.

  • Sustain marked as UNKNOWN is now neutral
    When sustain data cannot be evaluated for either build:

    • No score penalty is applied
    • No verdict downgrade occurs
    • No implicit risk narrative is injected

🧠 Insights

  • Renderer now consumes pillar.classification directly
  • No implicit tier, severity, or impact recalculation in the UI layer
  • Explicit N/A is rendered whenever data is unavailable or undefined
  • Insight tone and summary are strictly derived from engine output

⚖️ Verdict

  • Independent rule sets for:

    • Migration Mode (relative comparison)
    • Benchmark Mode (absolute playability check)
  • Benchmark Speed gate now relies on classification, not normalized score

  • Significant gains or losses can never be classified as NEUTRAL

  • Safety locks and verdict states now fully align with engine intent


⚙️ Engine

  • Introduction of OracleAxisResult as the single source of truth per axis
  • Guard clauses added for:
    • Speed (benchmark raw delta enforcement)
    • Survivability (no silent normalization downgrade)
  • Removal of all legacy heuristic fallbacks
  • Defensive assertions added to surface contract violations early

✅ Outcome

  • Full consistency between engine, insights, and UI
  • Comparisons are now:
    • Predictable
    • Auditable
    • Safer against silent misclassification

This update formalizes Oracle behavior as a strict contract, reducing ambiguity and eliminating hidden logic paths.

  • Internal Changelog — Technical

  • Oracle Engine Update

  • This update introduces a major internal consolidation of the Oracle engine, ensuring strict consistency between engine logic, verdicts, insights, and UI rendering across all comparison modes.

  • 🔑 Highlights

    • Unified contract across all axes
  • Damage, Survivability, Speed, and Combat now follow the same typed contract and resolution flow.
    • Normalization leaks removed in Benchmark Mode
  • Raw deltas are preserved where required, preventing semantic contradictions in verdicts and insights.
    • Sustain marked as UNKNOWN is now neutral
  • When sustain data cannot be evaluated for either build:
    • No score penalty is applied
    • No verdict downgrade occurs
    • No implicit risk narrative is injected

  • 🧠 Insights

    • Renderer now consumes pillar.classification directly
    • No implicit tier, severity, or impact recalculation in the UI layer
    • Explicit N/A is rendered whenever data is unavailable or undefined
    • Insight tone and summary are strictly derived from engine output

  • ⚖️ Verdict

    • Independent rule sets for:
    • Migration Mode (relative comparison)
    • Benchmark Mode (absolute playability check)
    • Benchmark Speed gate now relies on classification, not normalized score
    • Significant gains or losses can never be classified as NEUTRAL
    • Safety locks and verdict states now fully align with engine intent

  • ⚙️ Engine

    • Introduction of OracleAxisResult as the single source of truth per axis
    • Guard clauses added for:
    • Speed (benchmark raw delta enforcement)
    • Survivability (no silent normalization downgrade)
    • Removal of all legacy heuristic fallbacks
    • Defensive assertions added to surface contract violations early

  • ✅ Outcome

    • Full consistency between engine, insights, and UI
    • Comparisons are now:
    • Predictable
    • Auditable
    • Safer against silent misclassification
  • This update formalizes Oracle behavior as a strict contract, reducing ambiguity and eliminating hidden logic paths.
Oracle Engine Update: Unified Axis Contract & Benchmark Safety | Path of Codex