feat: extract orm internals

[brianvarskonst]

Summary

Extracts ORM connection/DQL collaborators, fixes optimistic version updates after flush success, clarifies query safety docs, and adopts PHP 8.5 QA tooling.

Checklist

• The change is focused and scoped to one concern.
• Tests or verification notes are included for behavior changes.
• Documentation was added or updated where needed.
• Public APIs, configuration keys, and contracts are described clearly.
• Backward compatibility impact is noted.

Type of Change

• Bug fix
• Feature
• Documentation
• Refactoring
• Maintenance
• Breaking change

Verification

• git diff --check origin/main...HEAD
• Not run locally: PHP/composer are not available in this shell; package CI should run the PHP QA commands.

Notes

Breaking change: the 0.x development line now targets PHP 8.5 or newer.

[brianvarskonst]

Reviewed the package-level diff and CI result. The entity-manager extraction, optimistic-version fix, docs update, PHP 8.5/QA adoption, and wpdb adapter hardening are split into conventional commits, and GitHub Actions is green. No blocking findings.